@scenar/cli 0.1.20 → 0.2.1

package/src/commands/pack.js

@@ -1,13 +1,5 @@
-import { resolve, join, basename } from "node:path";
-import { stat, mkdir, writeFile, rm, readdir, copyFile, access } from "node:fs/promises";
-import { detectRenderExport } from "../render/detect-render-export.js";
-import { resolveProvidersPath } from "../render/resolve-providers.js";
-import { generateEmbedEntry, generateEmbedHtml } from "../pack/generate-embed-entry.js";
-import { runViteBuild } from "../pack/build.js";
-import { buildPackManifest, writePackManifest, writeScenarioJson, verifyManifestFilesExist, } from "../pack/pack-manifest.js";
 import { DEFAULT_VIEWPORT } from "../pack/viewport.js";
-/** Generator version stamped into scenario.json (kept in sync with the CLI). */
-const PACK_GENERATOR_VERSION = "0.0.1";
+import { runPack } from "../pack/run-pack.js";
 /** Default canonical viewport width (matches DemoViewport's default). */
 const DEFAULT_WIDTH = DEFAULT_VIEWPORT.width;
 /** Default shell height for the embed. */
@@ -20,7 +12,7 @@ export function registerPackCommand(program) {
         "(steps.ts + an index.tsx that exports renderStep, plus an\n" +
         "optional .scenar/providers.tsx and narration/). Produces a static\n" +
         "bundle that boots ScenarioPlayer in the browser, ready for\n" +
-        "`scenar deploy`.\n\n" +
+        "`scenar serve`, `scenar publish`, or `scenar deploy`.\n\n" +
         "The bundle contains index.html, hashed JS/CSS, a scenario.json\n" +
         "descriptor, and a pack-manifest.json listing every file with its\n" +
         "lowercase-hex sha256 and content type. Output stays within the\n" +
@@ -34,118 +26,26 @@ export function registerPackCommand(program) {
         .option("--shell-height <number>", `shell height in px (default: ${DEFAULT_SHELL_HEIGHT})`, String(DEFAULT_SHELL_HEIGHT))
         .option("--keep-temp", "keep the generated entry directory for debugging")
         .action(async (dir, options) => {
-        const scenarioDir = resolve(dir);
-        let info;
         try {
-            info = await stat(scenarioDir);
-        }
-        catch {
-            process.stderr.write(`\x1b[31mError:\x1b[0m ${dir} does not exist.\n`);
-            process.exitCode = 1;
-            return;
-        }
-        if (!info.isDirectory()) {
-            process.stderr.write(`\x1b[31mError:\x1b[0m ${dir} is not a directory.\n` +
-                "The pack command requires a scenario directory (with steps.ts).\n");
-            process.exitCode = 1;
-            return;
-        }
-        const scenarioId = basename(scenarioDir);
-        const outDir = options.out ? resolve(options.out) : resolve(`./${scenarioId}-bundle`);
-        const width = Number(options.width) || DEFAULT_WIDTH;
-        const shellHeight = Number(options.shellHeight) || DEFAULT_SHELL_HEIGHT;
-        // The entry must live inside the scenario directory so the bundler's
-        // node_modules resolution walks up into the consumer project.
-        const tempDir = join(scenarioDir, ".scenar-pack");
-        try {
-            const renderFilePath = await detectRenderExport(scenarioDir);
-            const providersPath = await resolveProvidersPath(scenarioDir);
-            const hasNarration = await fileExists(join(scenarioDir, "narration", "manifest.json"));
-            process.stderr.write(`Scenario:  ${scenarioId}\n`);
-            process.stderr.write(`Render:    ${renderFilePath}\n`);
-            process.stderr.write(`Providers: ${providersPath ?? "none"}\n`);
-            process.stderr.write(`Narration: ${hasNarration ? "yes (manifest found)" : "none"}\n`);
-            process.stderr.write(`Output:    ${outDir}\n\n`);
-            // 1. Generate the browser entry + index.html into the temp dir.
-            const entrySource = generateEmbedEntry({
-                scenarioDir,
-                renderFilePath,
-                scenarioId,
-                hasNarration,
-                providersPath,
-                canonicalWidth: width,
-                shellHeight,
+            const result = await runPack({
+                scenarioDir: dir,
+                outDir: options.out,
+                width: Number(options.width) || DEFAULT_WIDTH,
+                shellHeight: Number(options.shellHeight) || DEFAULT_SHELL_HEIGHT,
+                keepTemp: options.keepTemp,
+                onLog: (message) => process.stderr.write(`${message}\n`),
             });
-            await mkdir(tempDir, { recursive: true });
-            const entryFileName = "entry.tsx";
-            const entryHtmlPath = join(tempDir, "index.html");
-            await writeFile(join(tempDir, entryFileName), entrySource, "utf-8");
-            await writeFile(entryHtmlPath, generateEmbedHtml(scenarioId, entryFileName), "utf-8");
-            // 2. Build the static bundle with Vite.
-            process.stderr.write("Bundling embed with Vite...\n");
-            await runViteBuild({ root: tempDir, outDir, entryHtmlPath });
-            // 3. Copy the narration manifest + audio. The embed fetches
-            //    ./narration/manifest.json at runtime and resolves each clip's
-            //    relative src against it, so both must ship in the bundle.
-            if (hasNarration) {
-                await copyNarration(scenarioDir, outDir);
-            }
-            // 4. Write the required scenario.json descriptor at the bundle root,
-            //    recording the canonical viewport baked into the bundle so `deploy`
-            //    can derive a correctly-proportioned embed snippet (DD-004).
-            await writeScenarioJson(outDir, scenarioId, PACK_GENERATOR_VERSION, {
-                width,
-                height: shellHeight,
-            });
-            // 5. Compute + write the deploy-facing pack manifest (validates the
-            //    bundle against the backend allowlist; throws on any violation).
-            const manifest = await buildPackManifest(outDir, scenarioId);
-            await verifyManifestFilesExist(outDir, manifest);
-            await writePackManifest(outDir, manifest);
-            const totalBytes = manifest.files.reduce((sum, f) => sum + f.sizeBytes, 0);
-            process.stderr.write(`\n\x1b[32m✓\x1b[0m Packed ${manifest.files.length} files (${formatBytes(totalBytes)}) to ${outDir}\n`);
-            process.stderr.write(`  Next: scenar deploy ${outDir}\n`);
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m Packed ${result.manifest.files.length} files ` +
+                `(${formatBytes(result.totalBytes)}) to ${result.outDir}\n`);
+            process.stderr.write(`  Next: scenar serve ${result.outDir}\n`);
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
             process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
             process.exitCode = 1;
         }
-        finally {
-            if (!options.keepTemp) {
-                await rm(tempDir, { recursive: true, force: true }).catch(() => { });
-            }
-        }
     });
 }
-/**
- * Copy the narration manifest and every *.mp3 from <scenarioDir>/narration
- * into <outDir>/narration. The manifest is the runtime index the embed fetches;
- * the mp3s are the clips it references by relative src.
- */
-async function copyNarration(scenarioDir, outDir) {
-    const srcDir = join(scenarioDir, "narration");
-    const destDir = join(outDir, "narration");
-    await mkdir(destDir, { recursive: true });
-    const entries = await readdir(srcDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (!entry.isFile())
-            continue;
-        const name = entry.name.toLowerCase();
-        if (name === "manifest.json" || name.endsWith(".mp3")) {
-            await copyFile(join(srcDir, entry.name), join(destDir, entry.name));
-        }
-    }
-}
-async function fileExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 function formatBytes(bytes) {
     if (bytes < 1024)
         return `${bytes} B`;

package/src/commands/pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../src/commands/pack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,yEAAyE;AACzE,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC;AAE7C,0CAA0C;AAC1C,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC;AASrD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,4DAA4D;QAC1D,6DAA6D;QAC7D,6DAA6D;QAC7D,qEAAqE;QACrE,8DAA8D;QAC9D,2DAA2D;QAC3D,kEAAkE;QAClE,oEAAoE;QACpE,kEAAkE;QAClE,oEAAoE;QACpE,oEAAoE;QACpE,yDAAyD;QACzD,mEAAmE,CACtE;SACA,QAAQ,CAAC,OAAO,EAAE,sDAAsD,CAAC;SACzE,MAAM,CAAC,cAAc,EAAE,iCAAiC,CAAC;SACzD,MAAM,CAAC,kBAAkB,EAAE,4CAA4C,aAAa,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;SAC/G,MAAM,CACL,yBAAyB,EACzB,gCAAgC,oBAAoB,GAAG,EACvD,MAAM,CAAC,oBAAoB,CAAC,CAC7B;SACA,MAAM,CAAC,aAAa,EAAE,kDAAkD,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAoB,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;gBAC3B,WAAW,EAAE,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,GAAG;gBACnB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,aAAa;gBAC7C,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,oBAAoB;gBAChE,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC;aACzD,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,SAAS;gBAChE,IAAI,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,MAAM,CAAC,MAAM,IAAI,CAC9D,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClE,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;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC"}

package/src/commands/pack.ts

@@ -1,20 +1,6 @@
-import { resolve, join, basename } from "node:path";
-import { stat, mkdir, writeFile, rm, readdir, copyFile, access } from "node:fs/promises";
 import { Command } from "commander";
-import { detectRenderExport } from "../render/detect-render-export.js";
-import { resolveProvidersPath } from "../render/resolve-providers.js";
-import { generateEmbedEntry, generateEmbedHtml } from "../pack/generate-embed-entry.js";
-import { runViteBuild } from "../pack/build.js";
-import {
-  buildPackManifest,
-  writePackManifest,
-  writeScenarioJson,
-  verifyManifestFilesExist,
-} from "../pack/pack-manifest.js";
 import { DEFAULT_VIEWPORT } from "../pack/viewport.js";
-
-/** Generator version stamped into scenario.json (kept in sync with the CLI). */
-const PACK_GENERATOR_VERSION = "0.0.1";
+import { runPack } from "../pack/run-pack.js";
 
 /** Default canonical viewport width (matches DemoViewport's default). */
 const DEFAULT_WIDTH = DEFAULT_VIEWPORT.width;
@@ -38,7 +24,7 @@ export function registerPackCommand(program: Command): void {
         "(steps.ts + an index.tsx that exports renderStep, plus an\n" +
         "optional .scenar/providers.tsx and narration/). Produces a static\n" +
         "bundle that boots ScenarioPlayer in the browser, ready for\n" +
-        "`scenar deploy`.\n\n" +
+        "`scenar serve`, `scenar publish`, or `scenar deploy`.\n\n" +
         "The bundle contains index.html, hashed JS/CSS, a scenario.json\n" +
         "descriptor, and a pack-manifest.json listing every file with its\n" +
         "lowercase-hex sha256 and content type. Output stays within the\n" +
@@ -57,131 +43,29 @@ export function registerPackCommand(program: Command): void {
     )
     .option("--keep-temp", "keep the generated entry directory for debugging")
     .action(async (dir: string, options: PackOptions) => {
-      const scenarioDir = resolve(dir);
-
-      let info;
-      try {
-        info = await stat(scenarioDir);
-      } catch {
-        process.stderr.write(`\x1b[31mError:\x1b[0m ${dir} does not exist.\n`);
-        process.exitCode = 1;
-        return;
-      }
-      if (!info.isDirectory()) {
-        process.stderr.write(
-          `\x1b[31mError:\x1b[0m ${dir} is not a directory.\n` +
-            "The pack command requires a scenario directory (with steps.ts).\n",
-        );
-        process.exitCode = 1;
-        return;
-      }
-
-      const scenarioId = basename(scenarioDir);
-      const outDir = options.out ? resolve(options.out) : resolve(`./${scenarioId}-bundle`);
-      const width = Number(options.width) || DEFAULT_WIDTH;
-      const shellHeight = Number(options.shellHeight) || DEFAULT_SHELL_HEIGHT;
-
-      // The entry must live inside the scenario directory so the bundler's
-      // node_modules resolution walks up into the consumer project.
-      const tempDir = join(scenarioDir, ".scenar-pack");
-
       try {
-        const renderFilePath = await detectRenderExport(scenarioDir);
-        const providersPath = await resolveProvidersPath(scenarioDir);
-        const hasNarration = await fileExists(join(scenarioDir, "narration", "manifest.json"));
-
-        process.stderr.write(`Scenario:  ${scenarioId}\n`);
-        process.stderr.write(`Render:    ${renderFilePath}\n`);
-        process.stderr.write(`Providers: ${providersPath ?? "none"}\n`);
-        process.stderr.write(`Narration: ${hasNarration ? "yes (manifest found)" : "none"}\n`);
-        process.stderr.write(`Output:    ${outDir}\n\n`);
-
-        // 1. Generate the browser entry + index.html into the temp dir.
-        const entrySource = generateEmbedEntry({
-          scenarioDir,
-          renderFilePath,
-          scenarioId,
-          hasNarration,
-          providersPath,
-          canonicalWidth: width,
-          shellHeight,
-        });
-        await mkdir(tempDir, { recursive: true });
-        const entryFileName = "entry.tsx";
-        const entryHtmlPath = join(tempDir, "index.html");
-        await writeFile(join(tempDir, entryFileName), entrySource, "utf-8");
-        await writeFile(entryHtmlPath, generateEmbedHtml(scenarioId, entryFileName), "utf-8");
-
-        // 2. Build the static bundle with Vite.
-        process.stderr.write("Bundling embed with Vite...\n");
-        await runViteBuild({ root: tempDir, outDir, entryHtmlPath });
-
-        // 3. Copy the narration manifest + audio. The embed fetches
-        //    ./narration/manifest.json at runtime and resolves each clip's
-        //    relative src against it, so both must ship in the bundle.
-        if (hasNarration) {
-          await copyNarration(scenarioDir, outDir);
-        }
-
-        // 4. Write the required scenario.json descriptor at the bundle root,
-        //    recording the canonical viewport baked into the bundle so `deploy`
-        //    can derive a correctly-proportioned embed snippet (DD-004).
-        await writeScenarioJson(outDir, scenarioId, PACK_GENERATOR_VERSION, {
-          width,
-          height: shellHeight,
+        const result = await runPack({
+          scenarioDir: dir,
+          outDir: options.out,
+          width: Number(options.width) || DEFAULT_WIDTH,
+          shellHeight: Number(options.shellHeight) || DEFAULT_SHELL_HEIGHT,
+          keepTemp: options.keepTemp,
+          onLog: (message) => process.stderr.write(`${message}\n`),
         });
 
-        // 5. Compute + write the deploy-facing pack manifest (validates the
-        //    bundle against the backend allowlist; throws on any violation).
-        const manifest = await buildPackManifest(outDir, scenarioId);
-        await verifyManifestFilesExist(outDir, manifest);
-        await writePackManifest(outDir, manifest);
-
-        const totalBytes = manifest.files.reduce((sum, f) => sum + f.sizeBytes, 0);
         process.stderr.write(
-          `\n\x1b[32m✓\x1b[0m Packed ${manifest.files.length} files (${formatBytes(totalBytes)}) to ${outDir}\n`,
+          `\n\x1b[32m✓\x1b[0m Packed ${result.manifest.files.length} files ` +
+            `(${formatBytes(result.totalBytes)}) to ${result.outDir}\n`,
         );
-        process.stderr.write(`  Next: scenar deploy ${outDir}\n`);
+        process.stderr.write(`  Next: scenar serve ${result.outDir}\n`);
       } catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
         process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
         process.exitCode = 1;
-      } finally {
-        if (!options.keepTemp) {
-          await rm(tempDir, { recursive: true, force: true }).catch(() => {});
-        }
       }
     });
 }
 
-/**
- * Copy the narration manifest and every *.mp3 from <scenarioDir>/narration
- * into <outDir>/narration. The manifest is the runtime index the embed fetches;
- * the mp3s are the clips it references by relative src.
- */
-async function copyNarration(scenarioDir: string, outDir: string): Promise<void> {
-  const srcDir = join(scenarioDir, "narration");
-  const destDir = join(outDir, "narration");
-  await mkdir(destDir, { recursive: true });
-  const entries = await readdir(srcDir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isFile()) continue;
-    const name = entry.name.toLowerCase();
-    if (name === "manifest.json" || name.endsWith(".mp3")) {
-      await copyFile(join(srcDir, entry.name), join(destDir, entry.name));
-    }
-  }
-}
-
-async function fileExists(path: string): Promise<boolean> {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 function formatBytes(bytes: number): string {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KiB`;

package/src/commands/publish.d.ts

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

package/src/commands/publish.d.ts.map

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

package/src/commands/publish.js

@@ -0,0 +1,64 @@
+import { runPublish } from "../publish/run-publish.js";
+export function registerPublishCommand(program) {
+    program
+        .command("publish")
+        .description("Publish a packed bundle to GitHub Pages and print its public embed URL.\n\n" +
+        "Takes a bundle directory produced by `scenar pack`. Creates (or reuses)\n" +
+        "a GitHub repo, publishes the bundle to its gh-pages branch, enables\n" +
+        "GitHub Pages, and prints the public URL plus a ready-to-paste <iframe>\n" +
+        "snippet.\n\n" +
+        "By default many tours share one repo: --repo defaults to `scenar-embeds`\n" +
+        "and --path to the packed scenario slug, so the embed serves at\n" +
+        "https://<you>.github.io/scenar-embeds/<slug>/ and re-publishing one tour\n" +
+        "preserves the others. Pass --path / to publish at the repo root\n" +
+        "(a dedicated single-tour repo). Target an org with --org.\n\n" +
+        "Requires the GitHub CLI (gh) installed and authenticated (`gh auth\n" +
+        "login`). Repos are public by default (GitHub Pages needs Pro for private\n" +
+        "repos); pass --private if your plan supports it.\n\n" +
+        "For an ephemeral local preview instead, use `scenar serve`.")
+        .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
+        .option("--repo <name>", "target repository name (default: scenar-embeds)")
+        .option("--path <subpath>", "subdirectory within the repo (default: the scenario slug; use / for the root)")
+        .option("--org <org>", "publish under a GitHub organization instead of your user account")
+        .option("--private", "create the repo private (GitHub Pages requires a paid plan for this)")
+        .option("--message <msg>", "commit message for the published snapshot", "Publish Scenar embed")
+        .action(async (bundleDir, options) => {
+        try {
+            process.stderr.write(`Bundle:   ${bundleDir}\n`);
+            process.stderr.write(`Target:   ${options.org ? `${options.org}/` : ""}${options.repo ?? "scenar-embeds"}` +
+                `/${options.path ?? "(scenario slug)"} (GitHub Pages)\n\n`);
+            const { result, viewport, recordedViewport, snippet } = await runPublish({
+                bundleDir,
+                repo: options.repo,
+                path: options.path,
+                org: options.org,
+                private: Boolean(options.private),
+                message: options.message,
+                onLog: (message) => process.stderr.write(`${message}\n`),
+            });
+            const location = result.path ? `${result.owner}/${result.repo}/${result.path}` : `${result.owner}/${result.repo}`;
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m ${result.created ? "Created" : "Updated"} ${location}\n`);
+            process.stderr.write(`  Repo: ${result.repoUrl}\n`);
+            // Bare public URL to stdout (pipeable); everything else to stderr.
+            process.stdout.write(`${result.pagesUrl}\n`);
+            process.stderr.write("\n  GitHub Pages builds asynchronously; the URL goes live in ~1 minute on the first publish.\n");
+            if (!recordedViewport) {
+                process.stderr.write("  Note: no recorded viewport; snippet uses the default " +
+                    `${viewport.width}x${viewport.height}. Re-pack with the current CLI ` +
+                    "to embed at the exact aspect ratio.\n");
+            }
+            process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
+            process.stderr.write(`${indent(snippet)}\n`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block) {
+    return block.replace(/^/gm, "  ");
+}
+//# sourceMappingURL=publish.js.map

package/src/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/commands/publish.ts"],"names":[],"mappings":"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"}

package/src/commands/publish.ts

@@ -0,0 +1,86 @@
+import { Command } from "commander";
+import { runPublish } from "../publish/run-publish.js";
+
+interface PublishCommandOptions {
+  repo?: string;
+  path?: string;
+  org?: string;
+  private?: boolean;
+  message?: string;
+}
+
+export function registerPublishCommand(program: Command): void {
+  program
+    .command("publish")
+    .description(
+      "Publish a packed bundle to GitHub Pages and print its public embed URL.\n\n" +
+        "Takes a bundle directory produced by `scenar pack`. Creates (or reuses)\n" +
+        "a GitHub repo, publishes the bundle to its gh-pages branch, enables\n" +
+        "GitHub Pages, and prints the public URL plus a ready-to-paste <iframe>\n" +
+        "snippet.\n\n" +
+        "By default many tours share one repo: --repo defaults to `scenar-embeds`\n" +
+        "and --path to the packed scenario slug, so the embed serves at\n" +
+        "https://<you>.github.io/scenar-embeds/<slug>/ and re-publishing one tour\n" +
+        "preserves the others. Pass --path / to publish at the repo root\n" +
+        "(a dedicated single-tour repo). Target an org with --org.\n\n" +
+        "Requires the GitHub CLI (gh) installed and authenticated (`gh auth\n" +
+        "login`). Repos are public by default (GitHub Pages needs Pro for private\n" +
+        "repos); pass --private if your plan supports it.\n\n" +
+        "For an ephemeral local preview instead, use `scenar serve`.",
+    )
+    .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
+    .option("--repo <name>", "target repository name (default: scenar-embeds)")
+    .option("--path <subpath>", "subdirectory within the repo (default: the scenario slug; use / for the root)")
+    .option("--org <org>", "publish under a GitHub organization instead of your user account")
+    .option("--private", "create the repo private (GitHub Pages requires a paid plan for this)")
+    .option("--message <msg>", "commit message for the published snapshot", "Publish Scenar embed")
+    .action(async (bundleDir: string, options: PublishCommandOptions) => {
+      try {
+        process.stderr.write(`Bundle:   ${bundleDir}\n`);
+        process.stderr.write(
+          `Target:   ${options.org ? `${options.org}/` : ""}${options.repo ?? "scenar-embeds"}` +
+            `/${options.path ?? "(scenario slug)"} (GitHub Pages)\n\n`,
+        );
+
+        const { result, viewport, recordedViewport, snippet } = await runPublish({
+          bundleDir,
+          repo: options.repo,
+          path: options.path,
+          org: options.org,
+          private: Boolean(options.private),
+          message: options.message,
+          onLog: (message) => process.stderr.write(`${message}\n`),
+        });
+
+        const location = result.path ? `${result.owner}/${result.repo}/${result.path}` : `${result.owner}/${result.repo}`;
+        process.stderr.write(
+          `\n\x1b[32m✓\x1b[0m ${result.created ? "Created" : "Updated"} ${location}\n`,
+        );
+        process.stderr.write(`  Repo: ${result.repoUrl}\n`);
+        // Bare public URL to stdout (pipeable); everything else to stderr.
+        process.stdout.write(`${result.pagesUrl}\n`);
+        process.stderr.write(
+          "\n  GitHub Pages builds asynchronously; the URL goes live in ~1 minute on the first publish.\n",
+        );
+
+        if (!recordedViewport) {
+          process.stderr.write(
+            "  Note: no recorded viewport; snippet uses the default " +
+              `${viewport.width}x${viewport.height}. Re-pack with the current CLI ` +
+              "to embed at the exact aspect ratio.\n",
+          );
+        }
+        process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
+        process.stderr.write(`${indent(snippet)}\n`);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+        process.exitCode = 1;
+      }
+    });
+}
+
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block: string): string {
+  return block.replace(/^/gm, "  ");
+}

package/src/commands/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/commands/render.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8G5D"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/commands/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6C5D"}