rsc-kit 0.24.1 → 0.24.3

package/README.md

@@ -1,10 +1,10 @@
 # rsc-kit
 
 The command line for [rsc-kit](https://rsc-kit.dev) — React Server Components
-as a Vite plugin, on any JavaScript server.
+as a Vite plugin, deployed wherever Nitro deploys.
 
 ```sh
-bunx rsc-kit@latest init        # add it to a project you already have
+bunx rsc-kit@latest init        # add it to the project in this directory
 ```
 
 Starting from nothing instead:
@@ -13,10 +13,27 @@ Starting from nothing instead:
 bun create rsc-kit@latest my-app
 ```
 
-`init` never rewrites anything that exists. It writes the files you do not have,
-adds the dependencies you are missing, and for your vite config and your server
-— the two files most likely to hold work that took a while to get right — it
-prints the exact edit for you to make.
+## Commands
+
+**`rsc-kit init`** adds rsc-kit to the project in this directory, or starts
+one there if it is empty. Nothing existing is rewritten: it writes the files
+you do not have, adds the dependencies you are missing, adds its entry to
+list-like files (`.mcp.json`, `AGENTS.md`, `tsconfig.json`'s `include`,
+`.env`) with yours left as written, and for anything else already there, such
+as your vite config, prints the exact edit for you to make. In a Go module it does the JavaScript half — `package.json`, the
+route tree, `vite.config.ts`, `.env` with `RSC_BACKEND` and a generated
+secret — and prints the Go half ([Go](https://docs.rsc-kit.dev/hosts/go)). A
+Laravel app runs it through `php artisan rsc:install`
+([Laravel](https://docs.rsc-kit.dev/hosts/laravel)). `rsc-kit init --help`
+lists its flags.
+
+**`rsc-kit typegen`** writes the route types without starting Vite, for a
+typecheck after a route was added. `--check` writes nothing and exits
+non-zero when the committed `rsc-host.json` or route types are no longer what
+the backend and the routes produce — a CI step.
+
+Name the tag: `bunx rsc-kit init` reuses whatever copy bunx downloaded first,
+while `bunx rsc-kit@latest init` fetches the current one.
 
 Installing this package also gives you [`@rsc-kit/core`](https://www.npmjs.com/package/@rsc-kit/core),
 so `import { rscKit } from '@rsc-kit/core/vite'` works after `bun add rsc-kit`.

package/dist/index.js

@@ -12,8 +12,9 @@ const HELP = `
   Usage
     rsc-kit init [options]        add it to the project in this directory,
                                   or start one here if the directory is empty
-    rsc-kit typegen               write the route types without starting Vite,
-                                  for a typecheck after a route was added
+    rsc-kit typegen [--check]     write the route types without starting Vite,
+                                  for a typecheck after a route was added;
+                                  --check fails if committed ones are stale
 
   Run \`rsc-kit init --help\` for what it takes. Freezing pages is part of
   \`vite build\` and has no command: it needs the bundle the build just wrote,
@@ -42,8 +43,20 @@ else if (command === 'typegen') {
     // Loads the app's vite.config through the app's own Vite, so the types come
     // from the plugin version and options the app builds with.
     const { typegen } = await import('@rsc-kit/core/typegen');
-    await typegen();
-    stdout.write('rsc-kit: route types written\n');
+    const check = rest.includes('--check');
+    const stale = await typegen(process.cwd(), check);
+    if (!check) {
+        stdout.write('rsc-kit: route types written\n');
+    }
+    else if (stale.length === 0) {
+        stdout.write('rsc-kit: generated files are current\n');
+    }
+    else {
+        stdout.write('rsc-kit typegen --check: these are committed and no longer what the backend and the routes produce:\n' +
+            stale.map((f) => '  ' + f).join('\n') +
+            '\nRun rsc-kit typegen and commit the result.\n');
+        exit(1);
+    }
 }
 else {
     stdout.write(`\n  Not an rsc-kit command: ${command}\n${HELP}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rsc-kit",
-  "version": "0.24.1",
+  "version": "0.24.3",
   "type": "module",
   "description": "The rsc-kit command line: add it to a project, and freeze what can be frozen.",
   "bin": {
@@ -27,8 +27,8 @@
   },
   "homepage": "https://rsc-kit.dev",
   "dependencies": {
-    "@rsc-kit/core": "^0.24.1",
-    "create-rsc-kit": "^0.24.1"
+    "@rsc-kit/core": "^0.24.3",
+    "create-rsc-kit": "^0.24.3"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",