npm - @scenar/cli - Versions diffs - 0.8.0 → 0.9.1 - Mend

@scenar/cli 0.8.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/example-bundle/assets/index-DlmG1Uh7.js +388 -0
package/example-bundle/assets/style-BjquDnTE.css +1 -0
package/example-bundle/index.html +2 -2
package/example-bundle/pack-manifest.json +9 -9
package/example-bundle/scenario.json +6 -2
package/package.json +9 -5
package/src/__tests__/collect-pack-shots.test.ts +97 -0
package/src/__tests__/pack-generate-embed-entry.test.ts +68 -3
package/src/__tests__/pack-manifest.test.ts +17 -0
package/src/__tests__/read-shots.test.ts +57 -0
package/src/__tests__/run-shoot.test.ts +319 -0
package/src/api.d.ts +3 -0
package/src/api.d.ts.map +1 -1
package/src/api.js +2 -0
package/src/api.js.map +1 -1
package/src/api.ts +5 -0
package/src/bundle/read-shots.d.ts +28 -0
package/src/bundle/read-shots.d.ts.map +1 -0
package/src/bundle/read-shots.js +28 -0
package/src/bundle/read-shots.js.map +1 -0
package/src/bundle/read-shots.ts +38 -0
package/src/commands/shoot.d.ts +3 -0
package/src/commands/shoot.d.ts.map +1 -0
package/src/commands/shoot.js +52 -0
package/src/commands/shoot.js.map +1 -0
package/src/commands/shoot.ts +72 -0
package/src/index.d.ts.map +1 -1
package/src/index.js +2 -0
package/src/index.js.map +1 -1
package/src/index.ts +2 -0
package/src/pack/build.d.ts +33 -1
package/src/pack/build.d.ts.map +1 -1
package/src/pack/build.js +35 -10
package/src/pack/build.js.map +1 -1
package/src/pack/build.ts +63 -17
package/src/pack/collect-pack-shots.d.ts +40 -0
package/src/pack/collect-pack-shots.d.ts.map +1 -0
package/src/pack/collect-pack-shots.js +59 -0
package/src/pack/collect-pack-shots.js.map +1 -0
package/src/pack/collect-pack-shots.ts +76 -0
package/src/pack/generate-embed-entry.d.ts +18 -0
package/src/pack/generate-embed-entry.d.ts.map +1 -1
package/src/pack/generate-embed-entry.js +92 -3
package/src/pack/generate-embed-entry.js.map +1 -1
package/src/pack/generate-embed-entry.ts +94 -3
package/src/pack/pack-manifest.d.ts +12 -3
package/src/pack/pack-manifest.d.ts.map +1 -1
package/src/pack/pack-manifest.js +13 -3
package/src/pack/pack-manifest.js.map +1 -1
package/src/pack/pack-manifest.ts +13 -2
package/src/pack/run-pack.d.ts +6 -0
package/src/pack/run-pack.d.ts.map +1 -1
package/src/pack/run-pack.js +41 -14
package/src/pack/run-pack.js.map +1 -1
package/src/pack/run-pack.ts +55 -14
package/src/shoot/playwright-browser.d.ts +9 -0
package/src/shoot/playwright-browser.d.ts.map +1 -0
package/src/shoot/playwright-browser.js +92 -0
package/src/shoot/playwright-browser.js.map +1 -0
package/src/shoot/playwright-browser.ts +121 -0
package/src/shoot/run-shoot.d.ts +58 -0
package/src/shoot/run-shoot.d.ts.map +1 -0
package/src/shoot/run-shoot.js +190 -0
package/src/shoot/run-shoot.js.map +1 -0
package/src/shoot/run-shoot.ts +270 -0
package/src/shoot/types.d.ts +40 -0
package/src/shoot/types.d.ts.map +1 -0
package/src/shoot/types.js +2 -0
package/src/shoot/types.js.map +1 -0
package/src/shoot/types.ts +40 -0
package/src/util/load-ts.d.ts +12 -2
package/src/util/load-ts.d.ts.map +1 -1
package/src/util/load-ts.js +25 -10
package/src/util/load-ts.js.map +1 -1
package/src/util/load-ts.ts +25 -11
package/tsconfig.tsbuildinfo +1 -1
package/example-bundle/assets/index-CBaiZ4ek.js +0 -147
package/example-bundle/assets/style-Ci-h7jik.css +0 -1

package/src/__tests__/run-shoot.test.ts ADDED Viewed

@@ -0,0 +1,319 @@
+import { createHash } from "node:crypto";
+import { mkdtemp, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import type { ScenarioShot } from "@scenar/core";
+import { STILLS_DIR, runShoot } from "../shoot/run-shoot.js";
+import type { PackManifest } from "../pack/pack-manifest.js";
+import type { ShotBrowser, ShotTheme } from "../shoot/types.js";
+const SHOTS: ScenarioShot[] = [
+  { name: "opening", timeMs: 2999, stepIndex: 0 },
+  { name: "detail-open", timeMs: 6999, stepIndex: 2 },
+];
+/**
+ * Write the minimal three files that make a directory a shootable bundle.
+ * By default scenario.json carries no `shots` key (a pre-0.0.2 bundle:
+ * shots unknown, so runShoot must boot the capture page); pass
+ * `recordedShots` to emulate a bundle whose pack recorded the list.
+ */
+async function makeBundle(recordedShots?: readonly string[]): Promise<string> {
+  const dir = await mkdtemp(join(tmpdir(), "scenar-shoot-"));
+  await writeFile(join(dir, "index.html"), "<!doctype html><div id='root'></div>", "utf-8");
+  await writeFile(
+    join(dir, "scenario.json"),
+    JSON.stringify({
+      schemaVersion: "1",
+      id: "lab-tour",
+      generator: "@scenar/cli pack 0.0.1",
+      viewport: { width: 896, height: 480 },
+      ...(recordedShots !== undefined ? { shots: recordedShots } : {}),
+    }),
+    "utf-8",
+  );
+  await writeFile(
+    join(dir, "pack-manifest.json"),
+    JSON.stringify({ schemaVersion: 1, scenarioId: "lab-tour", files: [] }),
+    "utf-8",
+  );
+  return dir;
+}
+interface FakeKnobs {
+  /** Shot list every session reports (default {@link SHOTS}). */
+  shots?: ScenarioShot[];
+  /** Shot list per theme — for the cross-theme divergence test. */
+  shotsFor?: (theme: ShotTheme) => ScenarioShot[];
+  /** Error thrown from open() — simulates window.__scenarShotError. */
+  openError?: string;
+  /** Image bytes per (theme, shot, per-theme session number). */
+  imageFor?: (theme: ShotTheme, shotName: string, sessionIndex: number) => Buffer;
+}
+interface SessionLog {
+  theme: ShotTheme;
+  url: string;
+  walks: number[];
+  closed: boolean;
+}
+/** A ShotBrowser fake that records every interaction for assertions. */
+function makeFakeBrowser(knobs: FakeKnobs = {}) {
+  const sessions: SessionLog[] = [];
+  const perThemeCount = new Map<ShotTheme, number>();
+  let browserClosed = false;
+  const imageFor =
+    knobs.imageFor ??
+    ((theme: ShotTheme, shotName: string) => Buffer.from(`png:${theme}:${shotName}`));
+  const browser: ShotBrowser = {
+    async newSession({ theme }) {
+      const sessionIndex = perThemeCount.get(theme) ?? 0;
+      perThemeCount.set(theme, sessionIndex + 1);
+      const log: SessionLog = { theme, url: "", walks: [], closed: false };
+      sessions.push(log);
+      const shots = knobs.shotsFor?.(theme) ?? knobs.shots ?? SHOTS;
+      let lastWalkedShot = "";
+      return {
+        async open(url) {
+          log.url = url;
+          if (knobs.openError) throw new Error(`the capture page reported: ${knobs.openError}`);
+          return { shots, frameSelector: "[data-scenar-shot-frame]" };
+        },
+        async walkTo(timeMs) {
+          log.walks.push(timeMs);
+          lastWalkedShot = shots.find((s) => s.timeMs === timeMs)?.name ?? "unknown";
+        },
+        async screenshotFrame() {
+          return imageFor(theme, lastWalkedShot, sessionIndex);
+        },
+        async close() {
+          log.closed = true;
+        },
+      };
+    },
+    async close() {
+      browserClosed = true;
+    },
+  };
+  return { browser, sessions, isClosed: () => browserClosed };
+}
+async function readManifest(bundleDir: string): Promise<PackManifest> {
+  return JSON.parse(await readFile(join(bundleDir, "pack-manifest.json"), "utf-8"));
+}
+describe("runShoot", () => {
+  it("captures every shot per theme, in timeline order, into stills/", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser();
+    const result = await runShoot({ bundleDir, browserFactory: async () => fake.browser });
+    expect(result.scenarioId).toBe("lab-tour");
+    expect(result.shots).toEqual(SHOTS);
+    expect(result.files).toEqual([
+      "stills/opening.light.png",
+      "stills/detail-open.light.png",
+      "stills/opening.dark.png",
+      "stills/detail-open.dark.png",
+    ]);
+    // One session per theme, each walking the timeline in order.
+    expect(fake.sessions.map((s) => s.theme)).toEqual(["light", "dark"]);
+    for (const session of fake.sessions) {
+      expect(session.walks).toEqual([2999, 6999]);
+      expect(session.closed).toBe(true);
+    }
+    expect(fake.isClosed()).toBe(true);
+    // The written bytes are the session's screenshots.
+    const opening = await readFile(join(bundleDir, STILLS_DIR, "opening.light.png"));
+    expect(opening.toString()).toBe("png:light:opening");
+  });
+  it("passes ?shot to every session and adds ?theme=dark only for dark", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser();
+    await runShoot({ bundleDir, browserFactory: async () => fake.browser });
+    const [light, dark] = fake.sessions;
+    expect(light!.url).toMatch(/\?shot$/);
+    expect(dark!.url).toMatch(/\?shot&theme=dark$/);
+  });
+  it("rebuilds the pack manifest so deploys ship the stills", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser();
+    await runShoot({ bundleDir, browserFactory: async () => fake.browser });
+    const manifest = await readManifest(bundleDir);
+    const stillEntries = manifest.files.filter((f) => f.path.startsWith("stills/"));
+    expect(stillEntries.map((f) => f.path).sort()).toEqual([
+      "stills/detail-open.dark.png",
+      "stills/detail-open.light.png",
+      "stills/opening.dark.png",
+      "stills/opening.light.png",
+    ]);
+    for (const entry of stillEntries) {
+      expect(entry.contentType).toBe("image/png");
+    }
+    // Declared-then-verified: the recorded sha256 is the file's real hash.
+    const opening = stillEntries.find((f) => f.path === "stills/opening.light.png")!;
+    expect(opening.sha256).toBe(
+      createHash("sha256").update(Buffer.from("png:light:opening")).digest("hex"),
+    );
+    // The bundle's own files are (re)listed too.
+    expect(manifest.files.some((f) => f.path === "index.html")).toBe(true);
+  });
+  it("clears stale stills and rebuilds the manifest even when no shots are declared", async () => {
+    const bundleDir = await makeBundle();
+    await mkdir(join(bundleDir, STILLS_DIR), { recursive: true });
+    await writeFile(join(bundleDir, STILLS_DIR, "removed-shot.light.png"), "stale");
+    const fake = makeFakeBrowser({ shots: [] });
+    const result = await runShoot({ bundleDir, browserFactory: async () => fake.browser });
+    expect(result.shots).toEqual([]);
+    expect(result.files).toEqual([]);
+    // The stale still is gone from disk AND from the manifest — a manifest
+    // listing a deleted file would fail its existence check at publish.
+    expect(await stat(join(bundleDir, STILLS_DIR)).catch(() => null)).toBeNull();
+    const manifest = await readManifest(bundleDir);
+    expect(manifest.files.some((f) => f.path.startsWith("stills/"))).toBe(false);
+  });
+  it("skips the browser entirely when scenario.json records an empty shot list", async () => {
+    const bundleDir = await makeBundle([]);
+    await mkdir(join(bundleDir, STILLS_DIR), { recursive: true });
+    await writeFile(join(bundleDir, STILLS_DIR, "removed-shot.light.png"), "stale");
+    let browserRequested = false;
+    const result = await runShoot({
+      bundleDir,
+      browserFactory: async () => {
+        browserRequested = true;
+        throw new Error("the short-circuit must return before the browser factory");
+      },
+    });
+    // Pack's record is authoritative: no session, no browser, same outcome.
+    expect(browserRequested).toBe(false);
+    expect(result).toEqual({
+      scenarioId: "lab-tour",
+      bundleDir,
+      shots: [],
+      files: [],
+      themes: ["light", "dark"],
+      verified: false,
+    });
+    // Both invariants hold on the short-circuit path too: stale stills are
+    // cleared, and the manifest is rebuilt so it never lists deleted files.
+    expect(await stat(join(bundleDir, STILLS_DIR)).catch(() => null)).toBeNull();
+    const manifest = await readManifest(bundleDir);
+    expect(manifest.files.some((f) => f.path.startsWith("stills/"))).toBe(false);
+  });
+  it("still boots the capture page when scenario.json records a non-empty list", async () => {
+    // The record proves there is something to shoot; the running bundle
+    // remains the runtime truth for what actually gets captured.
+    const bundleDir = await makeBundle(SHOTS.map((s) => s.name));
+    const fake = makeFakeBrowser();
+    const result = await runShoot({ bundleDir, browserFactory: async () => fake.browser });
+    expect(fake.sessions.length).toBeGreaterThan(0);
+    expect(result.shots).toEqual(SHOTS);
+  });
+  it("captures a single theme when asked", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser();
+    const result = await runShoot({
+      bundleDir,
+      themes: ["light"],
+      browserFactory: async () => fake.browser,
+    });
+    expect(result.files).toEqual(["stills/opening.light.png", "stills/detail-open.light.png"]);
+    expect(fake.sessions).toHaveLength(1);
+  });
+  it("surfaces the capture page's own error (e.g. invalid shot declarations)", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser({
+      openError: 'steps 0 and 2 both declare shot "opening"; shot names must be unique within a scenario',
+    });
+    await expect(
+      runShoot({ bundleDir, browserFactory: async () => fake.browser }),
+    ).rejects.toThrow(/steps 0 and 2 both declare shot "opening"/);
+    // The browser is still torn down on the failure path.
+    expect(fake.isClosed()).toBe(true);
+  });
+  it("verify: passes when a second fresh session reproduces every byte", async () => {
+    const bundleDir = await makeBundle();
+    // Image content ignores the session index — deterministic.
+    const fake = makeFakeBrowser();
+    const result = await runShoot({
+      bundleDir,
+      verify: true,
+      browserFactory: async () => fake.browser,
+    });
+    expect(result.verified).toBe(true);
+    // Two sessions per theme: capture + verify, all fresh.
+    expect(fake.sessions.map((s) => s.theme)).toEqual(["light", "dark", "light", "dark"]);
+  });
+  it("verify: fails naming the differing shot when sessions disagree", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser({
+      imageFor: (theme, shotName, sessionIndex) =>
+        // "detail-open" renders differently on every session — the exact
+        // nondeterminism --verify exists to catch.
+        Buffer.from(
+          shotName === "detail-open"
+            ? `png:${theme}:${shotName}:${sessionIndex}`
+            : `png:${theme}:${shotName}`,
+        ),
+    });
+    await expect(
+      runShoot({ bundleDir, verify: true, browserFactory: async () => fake.browser }),
+    ).rejects.toThrow(/determinism check failed \(light\): shot\(s\) detail-open differed/);
+    // Nothing was written: a failed verify must not leave untrusted stills.
+    expect(await stat(join(bundleDir, STILLS_DIR)).catch(() => null)).toBeNull();
+  });
+  it("fails when themes disagree on the shot list (bundle nondeterminism)", async () => {
+    const bundleDir = await makeBundle();
+    const fake = makeFakeBrowser({
+      shotsFor: (theme) => (theme === "dark" ? SHOTS.slice(0, 1) : SHOTS),
+    });
+    await expect(
+      runShoot({ bundleDir, browserFactory: async () => fake.browser }),
+    ).rejects.toThrow(/different shot list/);
+  });
+  it("rejects a directory that is not a packed bundle, with the fix named", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scenar-shoot-notbundle-"));
+    await writeFile(join(dir, "index.html"), "<!doctype html>", "utf-8");
+    const fake = makeFakeBrowser();
+    await expect(
+      runShoot({ bundleDir: dir, browserFactory: async () => fake.browser }),
+    ).rejects.toThrow(/no scenario\.json in .*Run `scenar pack`/);
+    // Validation fails before any browser work.
+    expect(fake.sessions).toHaveLength(0);
+  });
+});

package/src/api.d.ts CHANGED Viewed

@@ -12,6 +12,9 @@ export { runNarrate } from "./narrate/run-narrate.js";
 export type { RunNarrateOptions, NarrateResult, NarratedScenario } from "./narrate/run-narrate.js";
 export { runRender } from "./render/run-render.js";
 export type { RunRenderOptions, RenderResult } from "./render/run-render.js";
+export { runShoot, STILLS_DIR } from "./shoot/run-shoot.js";
+export type { RunShootOptions, ShootResult } from "./shoot/run-shoot.js";
+export type { ShotBrowser, ShotSession, ShotCaptureInfo, ShotTheme } from "./shoot/types.js";
 export { runServe } from "./serve/run-serve.js";
 export type { RunServeOptions, ServeResult } from "./serve/run-serve.js";
 export { startBundleServer, createBundleServer } from "./serve/static-server.js";

package/src/api.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}
1	+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7F,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/src/api.js CHANGED Viewed

@@ -11,6 +11,8 @@ export { runPack } from "./pack/run-pack.js";
 export { runNarrate } from "./narrate/run-narrate.js";
 // Render
 export { runRender } from "./render/run-render.js";
+// Shoot (render a bundle's declared shots to stills)
+export { runShoot, STILLS_DIR } from "./shoot/run-shoot.js";
 // Serve
 export { runServe } from "./serve/run-serve.js";
 export { startBundleServer, createBundleServer } from "./serve/static-server.js";

package/src/api.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGjF,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qFAAqF;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,4CAA4C;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
1	+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,qDAAqD;AACrD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI5D,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGjF,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qFAAqF;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,4CAA4C;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/src/api.ts CHANGED Viewed

@@ -19,6 +19,11 @@ export type { RunNarrateOptions, NarrateResult, NarratedScenario } from "./narra
 export { runRender } from "./render/run-render.js";
 export type { RunRenderOptions, RenderResult } from "./render/run-render.js";
+// Shoot (render a bundle's declared shots to stills)
+export { runShoot, STILLS_DIR } from "./shoot/run-shoot.js";
+export type { RunShootOptions, ShootResult } from "./shoot/run-shoot.js";
+export type { ShotBrowser, ShotSession, ShotCaptureInfo, ShotTheme } from "./shoot/types.js";
 // Serve
 export { runServe } from "./serve/run-serve.js";
 export type { RunServeOptions, ServeResult } from "./serve/run-serve.js";

package/src/bundle/read-shots.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+/** The outcome of reading a bundle's recorded shot names. */
+export type BundleShots =
+/** scenario.json carries an authoritative list (possibly empty). */
+{
+    readonly recorded: true;
+    readonly shots: readonly string[];
+}
+/**
+ * No usable `shots` record — the bundle predates the key, pack could not
+ * load the steps module, or the file is missing/malformed. The shots are
+ * unknown; only booting the capture page can answer.
+ */
+ | {
+    readonly recorded: false;
+};
+/**
+ * Read the declared shot names recorded in a bundle's scenario.json.
+ *
+ * The sibling of {@link readBundleViewport}, with the same forgiving posture:
+ * any missing/unreadable/malformed state degrades to `recorded: false` rather
+ * than throwing, because an absent record only costs the caller a browser
+ * boot — it must never fail an operation that a pre-`shots` bundle could
+ * complete. Present-and-empty is meaningfully different: it is pack's
+ * authoritative statement that the scenario declares no shots, which is what
+ * lets `runShoot` skip the browser entirely.
+ */
+export declare function readBundleShots(bundleDir: string): Promise<BundleShots>;
+//# sourceMappingURL=read-shots.d.ts.map

package/src/bundle/read-shots.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"read-shots.d.ts","sourceRoot":"","sources":["../../../src/bundle/read-shots.ts"],"names":[],"mappings":"AAIA,6DAA6D;AAC7D,MAAM,MAAM,WAAW;AACrB,oEAAoE;AAClE;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AAChE;;;;GAIG;GACD;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7E"}

package/src/bundle/read-shots.js ADDED Viewed

@@ -0,0 +1,28 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { SCENARIO_JSON_FILE } from "../pack/pack-manifest.js";
+/**
+ * Read the declared shot names recorded in a bundle's scenario.json.
+ *
+ * The sibling of {@link readBundleViewport}, with the same forgiving posture:
+ * any missing/unreadable/malformed state degrades to `recorded: false` rather
+ * than throwing, because an absent record only costs the caller a browser
+ * boot — it must never fail an operation that a pre-`shots` bundle could
+ * complete. Present-and-empty is meaningfully different: it is pack's
+ * authoritative statement that the scenario declares no shots, which is what
+ * lets `runShoot` skip the browser entirely.
+ */
+export async function readBundleShots(bundleDir) {
+    try {
+        const raw = await readFile(join(bundleDir, SCENARIO_JSON_FILE), "utf-8");
+        const shots = JSON.parse(raw).shots;
+        if (Array.isArray(shots) && shots.every((name) => typeof name === "string")) {
+            return { recorded: true, shots };
+        }
+    }
+    catch {
+        // Missing/unreadable/invalid scenario.json — the shots are unknown.
+    }
+    return { recorded: false };
+}
+//# sourceMappingURL=read-shots.js.map

package/src/bundle/read-shots.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"read-shots.js","sourceRoot":"","sources":["../../../src/bundle/read-shots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAa9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,KAAK,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC,KAAK,CAAC;QAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/src/bundle/read-shots.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { SCENARIO_JSON_FILE } from "../pack/pack-manifest.js";
+/** The outcome of reading a bundle's recorded shot names. */
+export type BundleShots =
+  /** scenario.json carries an authoritative list (possibly empty). */
+  | { readonly recorded: true; readonly shots: readonly string[] }
+  /**
+   * No usable `shots` record — the bundle predates the key, pack could not
+   * load the steps module, or the file is missing/malformed. The shots are
+   * unknown; only booting the capture page can answer.
+   */
+  | { readonly recorded: false };
+/**
+ * Read the declared shot names recorded in a bundle's scenario.json.
+ *
+ * The sibling of {@link readBundleViewport}, with the same forgiving posture:
+ * any missing/unreadable/malformed state degrades to `recorded: false` rather
+ * than throwing, because an absent record only costs the caller a browser
+ * boot — it must never fail an operation that a pre-`shots` bundle could
+ * complete. Present-and-empty is meaningfully different: it is pack's
+ * authoritative statement that the scenario declares no shots, which is what
+ * lets `runShoot` skip the browser entirely.
+ */
+export async function readBundleShots(bundleDir: string): Promise<BundleShots> {
+  try {
+    const raw = await readFile(join(bundleDir, SCENARIO_JSON_FILE), "utf-8");
+    const shots = (JSON.parse(raw) as { shots?: unknown }).shots;
+    if (Array.isArray(shots) && shots.every((name) => typeof name === "string")) {
+      return { recorded: true, shots };
+    }
+  } catch {
+    // Missing/unreadable/invalid scenario.json — the shots are unknown.
+  }
+  return { recorded: false };
+}

package/src/commands/shoot.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerShootCommand(program: Command): void;
+//# sourceMappingURL=shoot.d.ts.map

package/src/commands/shoot.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"shoot.d.ts","sourceRoot":"","sources":["../../../src/commands/shoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D3D"}

package/src/commands/shoot.js ADDED Viewed

@@ -0,0 +1,52 @@
+import { runShoot } from "../shoot/run-shoot.js";
+const THEME_CHOICES = ["light", "dark", "both"];
+export function registerShootCommand(program) {
+    program
+        .command("shoot")
+        .description("Render a packed bundle's declared shots to still images.\n\n" +
+        "Reads the steps' `shot` names from the running bundle, walks the\n" +
+        "timeline sequentially (a deterministic TimeSource walk — the same\n" +
+        "model as video export), and screenshots each shot's settled\n" +
+        "end-of-step frame into <bundle>/stills/<shot>.<theme>.png, one\n" +
+        "image per theme. The pack manifest is rebuilt afterwards, so\n" +
+        "`scenar publish` and deploys ship the stills with the bundle.\n\n" +
+        "Requires Playwright (optional peer): npm install -D playwright,\n" +
+        "then npx playwright install chromium. The bundle must be packed by\n" +
+        "the same CLI version (all @scenar packages release in lockstep).\n\n" +
+        "Tip: open <bundle-url>?shot=<name> in a browser to eyeball any\n" +
+        "declared shot without capturing.")
+        .argument("<dir>", "a packed bundle directory (from scenar pack)")
+        .option("--theme <theme>", `themes to capture: ${THEME_CHOICES.join(" | ")} (default: both)`, "both")
+        .option("--verify", "capture everything twice in fresh browser sessions and fail unless every still is byte-identical")
+        .option("--timeout <ms>", "per-page readiness timeout in milliseconds (default: 30000)", "30000")
+        .action(async (dir, options) => {
+        try {
+            if (!THEME_CHOICES.includes(options.theme)) {
+                throw new Error(`--theme must be one of: ${THEME_CHOICES.join(", ")}`);
+            }
+            const themes = options.theme === "both" ? ["light", "dark"] : [options.theme];
+            const result = await runShoot({
+                bundleDir: dir,
+                themes,
+                verify: options.verify ?? false,
+                timeoutMs: Number(options.timeout) || undefined,
+                onLog: (message) => process.stderr.write(`${message}\n`),
+            });
+            if (result.shots.length === 0) {
+                process.stderr.write(`\n\x1b[32m✓\x1b[0m No shots declared in ${result.scenarioId} — nothing captured.\n` +
+                    `  Name a capture point by setting \`shot: "<kebab-name>"\` on a step.\n`);
+                return;
+            }
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m Shot ${result.files.length} stills ` +
+                `(${result.shots.length} shots x ${result.themes.length} themes)` +
+                `${result.verified ? ", byte-identical across sessions" : ""} ` +
+                `to ${result.bundleDir}/stills\n`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=shoot.js.map

package/src/commands/shoot.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"shoot.js","sourceRoot":"","sources":["../../../src/commands/shoot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AASjD,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CACV,8DAA8D;QAC5D,oEAAoE;QACpE,qEAAqE;QACrE,+DAA+D;QAC/D,kEAAkE;QAClE,gEAAgE;QAChE,mEAAmE;QACnE,mEAAmE;QACnE,sEAAsE;QACtE,sEAAsE;QACtE,kEAAkE;QAClE,kCAAkC,CACrC;SACA,QAAQ,CAAC,OAAO,EAAE,8CAA8C,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC;SACpG,MAAM,CACL,UAAU,EACV,kGAAkG,CACnG;SACA,MAAM,CAAC,gBAAgB,EAAE,6DAA6D,EAAE,OAAO,CAAC;SAChG,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAqB,EAAE,EAAE;QACnD,IAAI,CAAC;YACH,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,2BAA2B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,MAAM,GACV,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAkB,CAAC,CAAC;YAE9E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;gBAC5B,SAAS,EAAE,GAAG;gBACd,MAAM;gBACN,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;gBAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,SAAS;gBAC/C,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC;aACzD,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C,MAAM,CAAC,UAAU,wBAAwB;oBAClF,yEAAyE,CAC5E,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,MAAM,CAAC,KAAK,CAAC,MAAM,UAAU;gBACtD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU;gBACjE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,EAAE,GAAG;gBAC/D,MAAM,MAAM,CAAC,SAAS,WAAW,CACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;YACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/src/commands/shoot.ts ADDED Viewed

@@ -0,0 +1,72 @@
+import { Command } from "commander";
+import { runShoot } from "../shoot/run-shoot.js";
+import type { ShotTheme } from "../shoot/types.js";
+interface ShootOptions {
+  theme: string;
+  verify?: boolean;
+  timeout: string;
+}
+const THEME_CHOICES = ["light", "dark", "both"] as const;
+export function registerShootCommand(program: Command): void {
+  program
+    .command("shoot")
+    .description(
+      "Render a packed bundle's declared shots to still images.\n\n" +
+        "Reads the steps' `shot` names from the running bundle, walks the\n" +
+        "timeline sequentially (a deterministic TimeSource walk — the same\n" +
+        "model as video export), and screenshots each shot's settled\n" +
+        "end-of-step frame into <bundle>/stills/<shot>.<theme>.png, one\n" +
+        "image per theme. The pack manifest is rebuilt afterwards, so\n" +
+        "`scenar publish` and deploys ship the stills with the bundle.\n\n" +
+        "Requires Playwright (optional peer): npm install -D playwright,\n" +
+        "then npx playwright install chromium. The bundle must be packed by\n" +
+        "the same CLI version (all @scenar packages release in lockstep).\n\n" +
+        "Tip: open <bundle-url>?shot=<name> in a browser to eyeball any\n" +
+        "declared shot without capturing.",
+    )
+    .argument("<dir>", "a packed bundle directory (from scenar pack)")
+    .option("--theme <theme>", `themes to capture: ${THEME_CHOICES.join(" | ")} (default: both)`, "both")
+    .option(
+      "--verify",
+      "capture everything twice in fresh browser sessions and fail unless every still is byte-identical",
+    )
+    .option("--timeout <ms>", "per-page readiness timeout in milliseconds (default: 30000)", "30000")
+    .action(async (dir: string, options: ShootOptions) => {
+      try {
+        if (!(THEME_CHOICES as readonly string[]).includes(options.theme)) {
+          throw new Error(`--theme must be one of: ${THEME_CHOICES.join(", ")}`);
+        }
+        const themes: readonly ShotTheme[] =
+          options.theme === "both" ? ["light", "dark"] : [options.theme as ShotTheme];
+        const result = await runShoot({
+          bundleDir: dir,
+          themes,
+          verify: options.verify ?? false,
+          timeoutMs: Number(options.timeout) || undefined,
+          onLog: (message) => process.stderr.write(`${message}\n`),
+        });
+        if (result.shots.length === 0) {
+          process.stderr.write(
+            `\n\x1b[32m✓\x1b[0m No shots declared in ${result.scenarioId} — nothing captured.\n` +
+              `  Name a capture point by setting \`shot: "<kebab-name>"\` on a step.\n`,
+          );
+          return;
+        }
+        process.stderr.write(
+          `\n\x1b[32m✓\x1b[0m Shot ${result.files.length} stills ` +
+            `(${result.shots.length} shots x ${result.themes.length} themes)` +
+            `${result.verified ? ", byte-identical across sessions" : ""} ` +
+            `to ${result.bundleDir}/stills\n`,
+        );
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+        process.exitCode = 1;
+      }
+    });
+}

package/src/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;~~AAUpC~~,wBAAgB,aAAa,IAAI,OAAO,~~CAkBvC~~;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGxC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,aAAa,IAAI,OAAO,CAmBvC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGxC"}

package/src/index.js CHANGED Viewed

@@ -4,6 +4,7 @@ import { registerNarrateCommand } from "./commands/narrate.js";
 import { registerInstallCommand } from "./commands/install.js";
 import { registerRenderCommand } from "./commands/render.js";
 import { registerPackCommand } from "./commands/pack.js";
+import { registerShootCommand } from "./commands/shoot.js";
 import { registerServeCommand } from "./commands/serve.js";
 import { registerTryCommand } from "./commands/try.js";
 import { registerPublishCommand } from "./commands/publish.js";
@@ -18,6 +19,7 @@ export function createProgram() {
     registerRenderCommand(program);
     registerInstallCommand(program);
     registerPackCommand(program);
+    registerShootCommand(program);
     registerServeCommand(program);
     registerTryCommand(program);
     registerPublishCommand(program);

package/src/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,+FAA+F,CAAC;SAC5G,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAc;IAChC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,+FAA+F,CAAC;SAC5G,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAc;IAChC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}