Inital commit

Author: crup

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "react-timer-hook",
+  "interface": {
+    "displayName": "React Timer Hook"
+  },
+  "plugins": [
+    {
+      "name": "caveman",
+      "source": {
+        "source": "local",
+        "path": "./plugins/caveman"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

.github/ISSUE_TEMPLATE/api_design.md

@@ -0,0 +1,50 @@
+---
+name: API design discussion
+about: Discuss lifecycle semantics before proposing implementation
+title: ''
+labels: api-design
+assignees: ''
+---
+
+# API Design Discussion
+
+## Use Case
+
+Describe the use case.
+
+## Current Workaround
+
+How would you solve this today?
+
+## Proposed API
+
+```tsx
+// proposed usage
+```
+
+## Lifecycle Semantics
+
+How should this interact with:
+
+- `start`
+- `pause`
+- `resume`
+- `reset`
+- `restart`
+- `cancel`
+- `onEnd`
+- schedules
+- `useTimerGroup`
+
+## Async Behavior
+
+Does this involve async callbacks?
+
+- [ ] no
+- [ ] yes, with overlap allowed
+- [ ] yes, with overlap skipped
+- [ ] yes, unsure
+
+## Non-Goals
+
+What should the library not do?

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Report incorrect timer behavior, cleanup issues, or callback problems
+title: ''
+labels: bug
+assignees: ''
+---
+
+# Bug Report
+
+## Description
+
+Describe the bug.
+
+## Expected Behavior
+
+What did you expect to happen?
+
+## Actual Behavior
+
+What happened instead?
+
+## Minimal Reproduction
+
+Link a reproduction or paste the smallest possible code sample.
+
+## Environment
+
+- `react-timer-hook` version:
+- React version:
+- React Strict Mode enabled: yes/no
+- Browser or runtime:
+- Test runner if relevant:
+- Fake timers if relevant: yes/no
+
+## Timer Usage
+
+- [ ] `useTimer`
+- [ ] `useTimerGroup`
+- [ ] schedules
+- [ ] debug logging
+- [ ] async `onEnd`
+- [ ] async schedule callback
+
+## Debug Logs
+
+If possible, enable debug logging and paste the relevant semantic events.
+
+Do not paste secrets, access tokens, or private API responses.
+
+## Additional Context
+
+Anything else that helps explain the issue.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,47 @@
+---
+name: Feature request
+about: Propose a new capability or public API addition
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+# Feature Request
+
+## Problem
+
+What problem are you trying to solve?
+
+## Proposed API
+
+Show the API you would like to use.
+
+```tsx
+// example
+```
+
+## Why App Code Cannot Solve This
+
+Explain why this cannot be built from `now`, `elapsedMilliseconds`, controls, schedules, or `useTimerGroup`.
+
+## Boundaries
+
+Does this request add any of the following?
+
+- [ ] formatting
+- [ ] timezone conversion
+- [ ] localization
+- [ ] data fetching lifecycle
+- [ ] retries/backoff/cache
+- [ ] audio/sound behavior
+- [ ] business-specific state
+
+If yes, explain why it belongs in this library.
+
+## Alternatives Considered
+
+What alternatives did you consider?
+
+## Additional Context
+
+Anything else that helps explain the request.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,36 @@
+# Summary
+
+Describe the change and why it is needed.
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation
+- [ ] Test-only change
+- [ ] Build/release automation
+- [ ] Refactor with no behavior change
+
+## Checklist
+
+- [ ] Tests added or updated
+- [ ] Docs added or updated for public behavior
+- [ ] No formatting/timezone/localization behavior added to core
+- [ ] No raw timeout handles exposed
+- [ ] Debug logs are opt-in if touched
+- [ ] `useTimerGroup` still uses one scheduler if touched
+- [ ] Changeset added when release automation requires it
+
+## Validation
+
+Paste the commands run:
+
+```sh
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+## Notes
+
+Add any follow-up work, known tradeoffs, or compatibility notes.