ci(release): support scoped prerelease package

Author: crup

.github/ISSUE_TEMPLATE/bug_report.md

@@ -26,7 +26,7 @@ Link a reproduction or paste the smallest possible code sample.
 
 ## Environment
 
-- `react-timer-hook` version:
+- `@crup/react-timer-hook` version:
 - React version:
 - React Strict Mode enabled: yes/no
 - Browser or runtime:

.github/workflows/prerelease.yml

@@ -50,7 +50,11 @@ jobs:
           pnpm test
 
       - name: Set prerelease version
-        run: pnpm version "${{ inputs.version_base }}-${{ inputs.tag }}.${{ github.run_number }}" --no-git-tag-version
+        env:
+          PACKAGE_VERSION: ${{ inputs.version_base }}-${{ inputs.tag }}.${{ github.run_number }}
+        run: |
+          node -e "const fs = require('node:fs'); const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8')); pkg.version = process.env.PACKAGE_VERSION; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');"
+          node -e "const pkg = require('./package.json'); console.log(`${pkg.name}@${pkg.version}`);"
 
       - name: Build package
         run: |

README.md

@@ -1,17 +1,24 @@
-# react-timer-hook
+# @crup/react-timer-hook
 
 A small React hook library for deterministic timer lifecycles.
 
 This package is planned as a replacement for the previous `react-timer-hook` API. It intentionally does not ship formatting, timezone conversion, `ampm` fields, or countdown/stopwatch/clock mode enums. It gives you raw time data and lifecycle controls so your app can decide what the timer means.
 
 ## Status
 
-Planning and implementation spec stage. Hook implementation is not present yet.
+Alpha-ready v1 implementation. The package is intended to be published under the `@crup` npm scope.
+
+## Install
+
+```sh
+pnpm add @crup/react-timer-hook
+npm install @crup/react-timer-hook
+```
 
 ## Planned Public API
 
 ```ts
-import { useTimer, useTimerGroup, durationParts } from 'react-timer-hook';
+import { useTimer, useTimerGroup, durationParts } from '@crup/react-timer-hook';
 ```
 
 V1 should expose only:

docs/BRANCHING_AND_COMMITS.md

@@ -44,8 +44,8 @@ Example versions:
 Install test builds with:
 
 ```sh
-npm install react-timer-hook@alpha
-pnpm add react-timer-hook@alpha
+npm install @crup/react-timer-hook@alpha
+pnpm add @crup/react-timer-hook@alpha
 ```
 
 ## Local Changesets Prerelease Flow

docs/OSS_GTM.md

@@ -180,7 +180,7 @@ For the first installable test versions, publish:
 Consumers test with:
 
 ```sh
-npm install react-timer-hook@alpha
+npm install @crup/react-timer-hook@alpha
 ```
 
 Keep prerelease publishing manual at first with `workflow_dispatch`, so every push to `next` does not automatically publish to npm.

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "react-timer-hook",
+  "name": "@crup/react-timer-hook",
   "version": "0.0.0",
   "description": "Deterministic React timer lifecycle hooks for timers, schedules, and many independent timers.",
   "main": "./dist/index.cjs",
@@ -18,6 +18,9 @@
     "LICENSE"
   ],
   "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=25.0.0"
   },