@couch-kit/cli 0.3.5 → 0.3.6

package/README.md

@@ -14,7 +14,7 @@ bun add -d @couch-kit/cli
 
 ### `init`
 
-Scaffolds a new web controller project (Vite + React + TypeScript) configured to work with Couch Kit.
+Scaffolds a web controller project (Vite + React + TypeScript) to add to an existing host app. This creates only the phone/tablet side — for a full game project (host + client + shared), clone the [Buzz starter](https://github.com/faluciano/buzz-tv-party-game).
 
 ```bash
 bunx couch-kit init web-controller
@@ -22,7 +22,7 @@ bunx couch-kit init web-controller
 
 ### `bundle`
 
-Builds the web controller and copies the assets into your Android project's `assets/www` folder. This is used when preparing your TV app for release.
+Builds the web controller and copies the assets into your Android project's `assets/www` folder, along with a `manifest.json` listing all files. This manifest is used by `useExtractAssets()` on the host to extract assets at runtime.
 
 ```bash
 # Default (looks for ./web-controller and copies to android/app/src/main/assets/www)
@@ -32,6 +32,16 @@ bunx couch-kit bundle
 bunx couch-kit bundle --source ./my-web-app --output ./android/app/src/main/assets/www
 ```
 
+Output structure:
+
+```
+android/app/src/main/assets/www/
+├── manifest.json       ← import this in your host app
+├── index.html
+├── assets/
+│   └── ...
+```
+
 ### `simulate`
 
 Spawns headless WebSocket bots to simulate players (useful for load testing and quick iteration).
@@ -46,3 +56,39 @@ bunx couch-kit simulate --url ws://192.168.1.99:8082 --count 8
 # Action interval (ms)
 bunx couch-kit simulate --interval 250
 ```
+
+### `replay`
+
+Replays a recorded game session against a reducer, validating state transitions. Useful for debugging, regression testing, and reproducing bugs from recordings captured with `useActionRecorder`.
+
+```bash
+# Replay a recording against your reducer
+bunx couch-kit replay ./session.json ./shared/reducer.ts
+
+# With intermediate state snapshots
+bunx couch-kit replay ./session.json ./shared/reducer.ts --snapshots
+
+# JSON output (for piping to other tools)
+bunx couch-kit replay ./session.json ./shared/reducer.ts --json
+```
+
+The reducer module must export a `default` or a named `reducer` function. If your shared file exports `gameReducer`, add a re-export:
+
+```ts
+// shared/reducer.ts (or any entry point for replay)
+export { gameReducer as default } from "./types";
+```
+
+### `dev`
+
+Starts a Vite dev server on the LAN so phones can load the controller from your laptop during development.
+
+```bash
+# Default: port 5173, exposed to LAN
+bunx couch-kit dev
+
+# Custom port
+bunx couch-kit dev --port 3000
+```
+
+Prints the LAN URL (e.g., `http://192.168.1.50:5173`) so you can pass it as `devServerUrl` to `GameHostProvider`. Requires `vite` as a dev dependency in your web controller project.

package/dist/index.js

@@ -2160,16 +2160,16 @@ var init_init = __esm(() => {
           preview: "vite preview"
         },
         dependencies: {
-          react: "^18.2.0",
-          "react-dom": "^18.2.0",
-          "@couch-kit/client": "^0.4.3"
+          react: "^19.0.0",
+          "react-dom": "^19.0.0",
+          "@couch-kit/client": "^0.8.0"
         },
         devDependencies: {
-          "@types/react": "^18.2.66",
-          "@types/react-dom": "^18.2.22",
-          "@vitejs/plugin-react": "^4.2.1",
-          typescript: "^5.2.2",
-          vite: "^5.2.0"
+          "@types/react": "^19.0.0",
+          "@types/react-dom": "^19.0.0",
+          "@vitejs/plugin-react": "^6.0.0",
+          typescript: "^5.7.0",
+          vite: "^6.0.0"
         }
       };
       fs2.writeFileSync(path2.join(targetDir, "package.json"), JSON.stringify(packageJson, null, 2) + `
@@ -2248,11 +2248,12 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
 `);
       fs2.writeFileSync(path2.join(targetDir, "src/App.tsx"), `
 import { useGameClient } from '@couch-kit/client';
+import { gameReducer, initialState } from './reducer';
 
 function App() {
   const { status, playerId, sendAction } = useGameClient({
-    initialState: { count: 0 },
-    reducer: (state, action) => state // Dummy reducer
+    initialState,
+    reducer: gameReducer,
   });
 
   return (
@@ -2260,7 +2261,7 @@ function App() {
         <h1>Controller</h1>
         <p>Status: {status}</p>
         <p>ID: {playerId || 'Connecting...'}</p>
-        <button onClick={() => sendAction({ type: 'BUZZ' })} 
+        <button onClick={() => sendAction({ type: 'SCORE' })} 
                 style={{ fontSize: 24, padding: '20px 40px', width: '100%' }}>
             BUZZ!
         </button>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/cli",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -43,6 +43,6 @@
     "commander": "^12.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.4.0"
+    "typescript": "^6.0.0"
   }
 }