@archastro/astroshot 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,7 @@
 # `@archastro/astroshot`
 
-One command for deterministic React, Ink, and arbitrary terminal screenshots.
+One command for deterministic React, Ink, and arbitrary terminal screenshots —
+plus **journey movies** into `.astroshot/`.
 
 ```bash
 npx --@archastro:registry=https://registry.npmjs.org \
@@ -18,6 +19,30 @@ npx --@archastro:registry=https://registry.npmjs.org \
   @archastro/astroshot pty ./pty.shot.yaml -o ./terminal.png
 ```
 
+## Movies (`astroshot movie`)
+
+Same binary. Agents: **run `astroshot movie which-source "…"` first**.
+
+| You need to record… | `--source` |
+|---------------------|------------|
+| Web / SPA / agent-browser | `browser` |
+| TUI / CLI / truecolor terminal | `pty` (never desktop of Terminal.app) |
+| Native macOS app window | `desktop.window` |
+| Your own PNG sequence | `frames` |
+
+```bash
+astroshot movie --help
+astroshot movie which-source "ratatui truecolor dashboard"
+astroshot movie run --source browser --feature web --slug home --url https://example.com
+astroshot movie run --source desktop.window --feature app --slug onboard \
+  --bundle-id com.example.App --duration-ms 4000
+astroshot movie list-windows   # macOS
+```
+
+`desktop.window` uses macOS `/usr/sbin/screencapture` (already on the system)
+plus a Swift window list shipped in the package — no separate capture binary
+download. Requires Screen Recording permission for your terminal/IDE.
+
 Use `react` for isolated browser components, `ink` for in-process Ink fixture
 trees, and `pty` for executable terminal applications such as Ratatui, Bubble
 Tea, Textual, and curses programs. `tui` remains an alias for `ink` for

package/bin/astroshot.mjs

@@ -8,7 +8,7 @@ import path from "node:path";
 import { writeFixtureTemplate } from "./templates.mjs";
 
 function help() {
-  console.log(`astroshot — one CLI for React, Ink, and PTY screenshots
+  console.log(`astroshot — one CLI for React, Ink, PTY stills, and movies
 
 Usage:
   astroshot init react [fixture.tsx] [--force]
@@ -20,15 +20,23 @@ Usage:
   astroshot ink <fixture.tsx> -o <out.png> [options]
   astroshot ink batch <manifest.yaml|json> [options]
   astroshot pty <fixture.yaml|json> -o <out.png> [options]
+  astroshot movie <command> [options]
   astroshot install-browser [--with-deps]
 
 Commands:
-  react              Capture an isolated React component
-  ink                Capture an Ink component fixture
-  pty                Capture any executable in a pseudoterminal
+  react              Capture an isolated React component (still PNG)
+  ink                Capture an Ink component fixture (still PNG)
+  pty                Capture any executable in a pseudoterminal (still PNG)
+  movie              Record a journey movie into .astroshot/ (poster + video)
   init               Generate a React, Ink, or PTY fixture template
   install-browser    Install the shared Chromium runtime
 
+Movie sources (see "astroshot movie which-source"):
+  browser            Web / agent-browser / Playwright viewport
+  pty                Truecolor TUI/CLI (never screenshot Terminal.app)
+  desktop.window     Native macOS app window (uses OS screencapture)
+  frames             Push your own PNG/JPEG sequence
+
 Compatibility: "astroshot tui" remains an alias for "astroshot ink".
 Run "astroshot <mode> --help" for mode options.`);
 }
@@ -88,6 +96,12 @@ Options:
 }
 
 function engineBin(mode) {
+  if (mode === "movie") {
+    const entry = fileURLToPath(import.meta.resolve("@archastro/movie-harness"));
+    // package exports "." → dist/index.js → package root is two levels up from dist
+    const packageRoot = path.dirname(path.dirname(entry));
+    return path.join(packageRoot, "bin", "astroshot-movie.mjs");
+  }
   const packageName =
     mode === "react" ? "@archastro/react-shot" : "@archastro/tui-shot";
   const executable = mode === "react" ? "react-shot.mjs" : "tui-shot.mjs";
@@ -210,6 +224,23 @@ if (command === "react" || command === "ink" || command === "tui" || command ===
   runEngine(canonicalMode, arguments_);
 }
 
+if (command === "movie") {
+  // Always forward to movie-harness (including --help / which-source).
+  const result = spawnSync(
+    process.execPath,
+    [engineBin("movie"), ...arguments_],
+    { stdio: "inherit" },
+  );
+  if (result.error) {
+    console.error(
+      `astroshot could not start movie harness: ${result.error.message}`,
+    );
+    process.exit(1);
+  }
+  if (result.signal) process.kill(process.pid, result.signal);
+  process.exit(result.status ?? 1);
+}
+
 console.error(`Unknown command: ${command}`);
 help();
 process.exit(1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@archastro/astroshot",
-  "version": "0.1.0",
-  "description": "One CLI for deterministic React and terminal UI screenshots",
+  "version": "0.2.0",
+  "description": "One CLI for deterministic React, terminal, and movie UI captures",
   "keywords": [
     "react",
     "ink",
@@ -9,6 +9,8 @@
     "ratatui",
     "terminal",
     "screenshot",
+    "movie",
+    "screencast",
     "visual-testing"
   ],
   "license": "MIT",
@@ -56,7 +58,7 @@
     "README.md"
   ],
   "scripts": {
-    "pretest": "npm run build --workspace @archastro/react-shot && npm run build --workspace @archastro/tui-shot",
+    "pretest": "npm run build --workspace @archastro/react-shot && npm run build --workspace @archastro/tui-shot && npm run build --workspace @archastro/movie-harness",
     "test": "node --test test/*.test.mjs"
   },
   "engines": {
@@ -68,7 +70,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@archastro/react-shot": "0.1.0",
-    "@archastro/tui-shot": "0.1.0"
+    "@archastro/movie-harness": "0.2.0",
+    "@archastro/react-shot": "0.2.0",
+    "@archastro/tui-shot": "0.2.0"
   }
 }