@scenar/cli 0.1.20 → 0.2.1

package/src/commands/render.js

@@ -1,10 +1,4 @@
-import { resolve, join } from "node:path";
-import { stat, mkdir, access, writeFile, rm } from "node:fs/promises";
-import { pathToFileURL } from "node:url";
-import { loadBundle } from "../util/load-bundle.js";
-import { generateRemotionEntry } from "../render/generate-entry.js";
-import { resolveProvidersPath } from "../render/resolve-providers.js";
-import { detectRenderExport } from "../render/detect-render-export.js";
+import { runRender } from "../render/run-render.js";
 export function registerRenderCommand(program) {
     program
         .command("render")
@@ -25,201 +19,25 @@ export function registerRenderCommand(program) {
         .option("--entry <path>", "path to a custom Remotion entry file")
         .option("--webpack-override <path>", "path to a module that default-exports a Remotion WebpackOverrideFn")
         .action(async (dir, options) => {
-        const resolved = resolve(dir);
-        let info;
         try {
-            info = await stat(resolved);
-        }
-        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 render command requires a scenario directory (with steps.ts).\n");
-            process.exitCode = 1;
-            return;
-        }
-        const fps = Number(options.fps) || 30;
-        const width = Number(options.width) || 1920;
-        const height = Number(options.height) || 1080;
-        let tempDir;
-        try {
-            const bundle = await loadBundle(resolved);
-            const scenarioId = bundle.id;
-            const compositionId = options.compositionId ?? scenarioId;
-            const outputPath = resolveOutputPath(options.out, scenarioId);
-            const { entryPoint, generated } = await resolveEntryPoint({
-                entryOption: options.entry,
-                scenarioDir: resolved,
-                scenarioId,
-                compositionId,
-                hasNarration: !!bundle.narrationManifest,
-                fps,
-                width,
-                height,
-            });
-            tempDir = generated?.tempDir;
-            const webpackOverride = options.webpackOverride
-                ? await loadWebpackOverride(options.webpackOverride)
-                : undefined;
-            process.stderr.write(`Scenario: ${scenarioId}\n`);
-            process.stderr.write(`Steps:    ${bundle.steps.length}\n`);
-            process.stderr.write(`Audio:    ${bundle.narrationManifest ? "yes (manifest found)" : "none"}\n`);
-            process.stderr.write(`Entry:    ${generated ? "(auto-generated)" : entryPoint}\n`);
-            if (generated?.providersPath) {
-                process.stderr.write(`Providers: ${generated.providersPath}\n`);
-            }
-            if (webpackOverride) {
-                process.stderr.write(`Webpack:  custom override loaded\n`);
-            }
-            process.stderr.write(`Output:   ${outputPath}\n`);
-            process.stderr.write(`Config:   ${width}x${height} @ ${fps}fps\n\n`);
-            await renderScenario({
-                bundle,
-                entryPoint,
-                compositionId,
-                outputPath,
-                fps,
-                width,
-                height,
-                webpackOverride,
+            const result = await runRender({
+                scenarioDir: dir,
+                out: options.out,
+                fps: Number(options.fps) || 30,
+                width: Number(options.width) || 1920,
+                height: Number(options.height) || 1080,
+                compositionId: options.compositionId,
+                entry: options.entry,
+                webpackOverride: options.webpackOverride,
+                onLog: (message) => process.stderr.write(`${message}\n`),
             });
-            process.stderr.write(`\n\x1b[32m✓\x1b[0m Video saved to ${outputPath}\n`);
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m Video saved to ${result.outputPath}\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 (tempDir) {
-                await rm(tempDir, { recursive: true, force: true }).catch(() => { });
-            }
-        }
-    });
-}
-// ---------------------------------------------------------------------------
-// Output path resolution
-// ---------------------------------------------------------------------------
-function resolveOutputPath(outOption, scenarioId) {
-    if (!outOption) {
-        return resolve(`./${scenarioId}.mp4`);
-    }
-    if (outOption.endsWith(".mp4")) {
-        return resolve(outOption);
-    }
-    return resolve(join(outOption, `${scenarioId}.mp4`));
-}
-async function resolveEntryPoint(input) {
-    // Explicit --entry: use as-is, no generation.
-    if (input.entryOption) {
-        const resolved = resolve(input.entryOption);
-        try {
-            await access(resolved);
-        }
-        catch {
-            throw new Error(`Remotion entry point not found: ${input.entryOption}`);
-        }
-        return { entryPoint: resolved };
-    }
-    // Auto-generate: detect renderStep export, find providers, write temp entry.
-    const renderFilePath = await detectRenderExport(input.scenarioDir);
-    const providersPath = await resolveProvidersPath(input.scenarioDir);
-    const entrySource = generateRemotionEntry({
-        scenarioDir: input.scenarioDir,
-        renderFilePath,
-        scenarioId: input.scenarioId,
-        hasNarration: input.hasNarration,
-        providersPath,
-        fps: input.fps,
-        width: input.width,
-        height: input.height,
-        compositionId: input.compositionId,
-    });
-    // Write the entry inside the scenario directory so webpack's standard
-    // node_modules resolution walks up from here into the consumer project.
-    // A /tmp/ location would fail because no node_modules exist there.
-    const tempDir = join(input.scenarioDir, ".scenar-render");
-    await mkdir(tempDir, { recursive: true });
-    const entryPath = join(tempDir, "index.tsx");
-    await writeFile(entryPath, entrySource, "utf-8");
-    return {
-        entryPoint: entryPath,
-        generated: { tempDir, providersPath },
-    };
-}
-// ---------------------------------------------------------------------------
-// Webpack override loading
-// ---------------------------------------------------------------------------
-async function loadWebpackOverride(overridePath) {
-    const resolved = resolve(overridePath);
-    try {
-        await access(resolved);
-    }
-    catch {
-        throw new Error(`Webpack override file not found: ${overridePath}`);
-    }
-    let mod;
-    try {
-        mod = await import(pathToFileURL(resolved).href);
-    }
-    catch (err) {
-        const detail = err instanceof Error ? err.message : String(err);
-        throw new Error(`Failed to import webpack override from ${overridePath}:\n${detail}`);
-    }
-    const override = (mod.default ?? mod.webpackOverride);
-    if (typeof override !== "function") {
-        throw new Error(`${overridePath} does not export a webpack override function.\n\n` +
-            "Expected a default export or named 'webpackOverride' export:\n\n" +
-            '  import type { WebpackOverrideFn } from "@remotion/bundler";\n\n' +
-            "  const webpackOverride: WebpackOverrideFn = (config) => ({\n" +
-            "    ...config,\n" +
-            "    // your overrides\n" +
-            "  });\n\n" +
-            "  export default webpackOverride;\n");
-    }
-    return override;
-}
-async function renderScenario(config) {
-    const bundler = await import("@remotion/bundler").catch(() => {
-        throw new Error("Could not load @remotion/bundler.\n" +
-            "Install it: pnpm add @remotion/bundler@4.0.448");
-    });
-    const renderer = await import("@remotion/renderer").catch(() => {
-        throw new Error("Could not load @remotion/renderer.\n" +
-            "Install it: pnpm add @remotion/renderer@4.0.448");
-    });
-    process.stderr.write("Bundling Remotion project...\n");
-    const bundleOptions = {
-        entryPoint: config.entryPoint,
-    };
-    if (config.webpackOverride) {
-        bundleOptions.webpackOverride = config.webpackOverride;
-    }
-    const serveUrl = await bundler.bundle(bundleOptions);
-    process.stderr.write(`Selecting composition: ${config.compositionId}\n`);
-    const composition = await renderer.selectComposition({
-        serveUrl,
-        id: config.compositionId,
-    });
-    process.stderr.write(`Composition: ${composition.width}x${composition.height} @ ${composition.fps}fps, ` +
-        `${composition.durationInFrames} frames ` +
-        `(${(composition.durationInFrames / composition.fps).toFixed(1)}s)\n`);
-    const outDir = resolve(config.outputPath, "..");
-    await mkdir(outDir, { recursive: true });
-    process.stderr.write("Rendering...\n");
-    await renderer.renderMedia({
-        composition,
-        serveUrl,
-        codec: "h264",
-        outputLocation: config.outputPath,
-        onProgress: ({ progress }) => {
-            const pct = Math.round(progress * 100);
-            process.stderr.write(`\r  Progress: ${pct}%`);
-        },
     });
-    process.stderr.write("\n");
 }
 //# sourceMappingURL=render.js.map

package/src/commands/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/commands/render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/commands/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAYpD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,uDAAuD;QACrD,oEAAoE;QACpE,4DAA4D;QAC5D,oEAAoE;QACpE,kEAAkE;QAClE,yDAAyD;QACzD,iEAAiE;QACjE,oDAAoD,CACvD;SACA,QAAQ,CAAC,OAAO,EAAE,sDAAsD,CAAC;SACzE,MAAM,CAAC,cAAc,EAAE,2CAA2C,CAAC;SACnE,MAAM,CAAC,gBAAgB,EAAE,iCAAiC,EAAE,IAAI,CAAC;SACjE,MAAM,CAAC,kBAAkB,EAAE,uCAAuC,EAAE,MAAM,CAAC;SAC3E,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,EAAE,MAAM,CAAC;SAC7E,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,CAAC;SACpE,MAAM,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;SAChE,MAAM,CACL,2BAA2B,EAC3B,oEAAoE,CACrE;SACA,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAsB,EAAE,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;gBAC7B,WAAW,EAAE,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE;gBAC9B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI;gBACpC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI;gBACtC,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,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,CAAC,qCAAqC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACnF,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/render.ts

@@ -1,11 +1,5 @@
-import { resolve, join } from "node:path";
-import { stat, mkdir, access, writeFile, rm } from "node:fs/promises";
-import { pathToFileURL } from "node:url";
 import { Command } from "commander";
-import { loadBundle, type CliBundle } from "../util/load-bundle.js";
-import { generateRemotionEntry } from "../render/generate-entry.js";
-import { resolveProvidersPath } from "../render/resolve-providers.js";
-import { detectRenderExport } from "../render/detect-render-export.js";
+import { runRender } from "../render/run-render.js";
 
 interface RenderOptions {
   out?: string;
@@ -22,13 +16,13 @@ export function registerRenderCommand(program: Command): void {
     .command("render")
     .description(
       "Render a scenario as an MP4 video using Remotion.\n\n" +
-      "Accepts a scenario directory containing steps.ts and an optional\n" +
-      "narration/ subfolder with manifest.json + audio clips.\n\n" +
-      "When the scenario directory contains an index.tsx that exports a\n" +
-      "renderStep function, the CLI auto-generates the Remotion entry\n" +
-      "point — no remotion/ directory or bundle.ts needed.\n\n" +
-      "Output defaults to ./<scenario-id>.mp4 in the current working\n" +
-      "directory. Use --out to write to a different path.",
+        "Accepts a scenario directory containing steps.ts and an optional\n" +
+        "narration/ subfolder with manifest.json + audio clips.\n\n" +
+        "When the scenario directory contains an index.tsx that exports a\n" +
+        "renderStep function, the CLI auto-generates the Remotion entry\n" +
+        "point — no remotion/ directory or bundle.ts needed.\n\n" +
+        "Output defaults to ./<scenario-id>.mp4 in the current working\n" +
+        "directory. Use --out to write to a different path.",
     )
     .argument("<dir>", "path to a scenario directory (must contain steps.ts)")
     .option("--out <path>", "output file path or directory for the MP4")
@@ -42,285 +36,24 @@ export function registerRenderCommand(program: Command): void {
       "path to a module that default-exports a Remotion WebpackOverrideFn",
     )
     .action(async (dir: string, options: RenderOptions) => {
-      const resolved = resolve(dir);
-
-      let info;
       try {
-        info = await stat(resolved);
-      } 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 render command requires a scenario directory (with steps.ts).\n",
-        );
-        process.exitCode = 1;
-        return;
-      }
-
-      const fps = Number(options.fps) || 30;
-      const width = Number(options.width) || 1920;
-      const height = Number(options.height) || 1080;
-
-      let tempDir: string | undefined;
-
-      try {
-        const bundle = await loadBundle(resolved);
-        const scenarioId = bundle.id;
-        const compositionId = options.compositionId ?? scenarioId;
-        const outputPath = resolveOutputPath(options.out, scenarioId);
-
-        const { entryPoint, generated } = await resolveEntryPoint({
-          entryOption: options.entry,
-          scenarioDir: resolved,
-          scenarioId,
-          compositionId,
-          hasNarration: !!bundle.narrationManifest,
-          fps,
-          width,
-          height,
+        const result = await runRender({
+          scenarioDir: dir,
+          out: options.out,
+          fps: Number(options.fps) || 30,
+          width: Number(options.width) || 1920,
+          height: Number(options.height) || 1080,
+          compositionId: options.compositionId,
+          entry: options.entry,
+          webpackOverride: options.webpackOverride,
+          onLog: (message) => process.stderr.write(`${message}\n`),
         });
-        tempDir = generated?.tempDir;
-
-        const webpackOverride = options.webpackOverride
-          ? await loadWebpackOverride(options.webpackOverride)
-          : undefined;
-
-        process.stderr.write(`Scenario: ${scenarioId}\n`);
-        process.stderr.write(`Steps:    ${bundle.steps.length}\n`);
-        process.stderr.write(
-          `Audio:    ${bundle.narrationManifest ? "yes (manifest found)" : "none"}\n`,
-        );
-        process.stderr.write(`Entry:    ${generated ? "(auto-generated)" : entryPoint}\n`);
-        if (generated?.providersPath) {
-          process.stderr.write(`Providers: ${generated.providersPath}\n`);
-        }
-        if (webpackOverride) {
-          process.stderr.write(`Webpack:  custom override loaded\n`);
-        }
-        process.stderr.write(`Output:   ${outputPath}\n`);
-        process.stderr.write(`Config:   ${width}x${height} @ ${fps}fps\n\n`);
 
-        await renderScenario({
-          bundle,
-          entryPoint,
-          compositionId,
-          outputPath,
-          fps,
-          width,
-          height,
-          webpackOverride,
-        });
-
-        process.stderr.write(`\n\x1b[32m✓\x1b[0m Video saved to ${outputPath}\n`);
+        process.stderr.write(`\n\x1b[32m✓\x1b[0m Video saved to ${result.outputPath}\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 (tempDir) {
-          await rm(tempDir, { recursive: true, force: true }).catch(() => {});
-        }
       }
     });
 }
-
-// ---------------------------------------------------------------------------
-// Output path resolution
-// ---------------------------------------------------------------------------
-
-function resolveOutputPath(outOption: string | undefined, scenarioId: string): string {
-  if (!outOption) {
-    return resolve(`./${scenarioId}.mp4`);
-  }
-  if (outOption.endsWith(".mp4")) {
-    return resolve(outOption);
-  }
-  return resolve(join(outOption, `${scenarioId}.mp4`));
-}
-
-// ---------------------------------------------------------------------------
-// Entry point resolution
-// ---------------------------------------------------------------------------
-
-interface EntryResolutionInput {
-  entryOption: string | undefined;
-  scenarioDir: string;
-  scenarioId: string;
-  compositionId: string;
-  hasNarration: boolean;
-  fps: number;
-  width: number;
-  height: number;
-}
-
-interface EntryResolutionResult {
-  entryPoint: string;
-  generated?: {
-    tempDir: string;
-    providersPath: string | null;
-  };
-}
-
-async function resolveEntryPoint(
-  input: EntryResolutionInput,
-): Promise<EntryResolutionResult> {
-  // Explicit --entry: use as-is, no generation.
-  if (input.entryOption) {
-    const resolved = resolve(input.entryOption);
-    try {
-      await access(resolved);
-    } catch {
-      throw new Error(`Remotion entry point not found: ${input.entryOption}`);
-    }
-    return { entryPoint: resolved };
-  }
-
-  // Auto-generate: detect renderStep export, find providers, write temp entry.
-  const renderFilePath = await detectRenderExport(input.scenarioDir);
-  const providersPath = await resolveProvidersPath(input.scenarioDir);
-
-  const entrySource = generateRemotionEntry({
-    scenarioDir: input.scenarioDir,
-    renderFilePath,
-    scenarioId: input.scenarioId,
-    hasNarration: input.hasNarration,
-    providersPath,
-    fps: input.fps,
-    width: input.width,
-    height: input.height,
-    compositionId: input.compositionId,
-  });
-
-  // Write the entry inside the scenario directory so webpack's standard
-  // node_modules resolution walks up from here into the consumer project.
-  // A /tmp/ location would fail because no node_modules exist there.
-  const tempDir = join(input.scenarioDir, ".scenar-render");
-  await mkdir(tempDir, { recursive: true });
-
-  const entryPath = join(tempDir, "index.tsx");
-  await writeFile(entryPath, entrySource, "utf-8");
-
-  return {
-    entryPoint: entryPath,
-    generated: { tempDir, providersPath },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Webpack override loading
-// ---------------------------------------------------------------------------
-
-async function loadWebpackOverride(
-  overridePath: string,
-): Promise<(config: unknown) => unknown> {
-  const resolved = resolve(overridePath);
-
-  try {
-    await access(resolved);
-  } catch {
-    throw new Error(`Webpack override file not found: ${overridePath}`);
-  }
-
-  let mod: Record<string, unknown>;
-  try {
-    mod = await import(pathToFileURL(resolved).href) as Record<string, unknown>;
-  } catch (err) {
-    const detail = err instanceof Error ? err.message : String(err);
-    throw new Error(
-      `Failed to import webpack override from ${overridePath}:\n${detail}`,
-    );
-  }
-
-  const override = (mod.default ?? mod.webpackOverride) as unknown;
-  if (typeof override !== "function") {
-    throw new Error(
-      `${overridePath} does not export a webpack override function.\n\n` +
-      "Expected a default export or named 'webpackOverride' export:\n\n" +
-      '  import type { WebpackOverrideFn } from "@remotion/bundler";\n\n' +
-      "  const webpackOverride: WebpackOverrideFn = (config) => ({\n" +
-      "    ...config,\n" +
-      "    // your overrides\n" +
-      "  });\n\n" +
-      "  export default webpackOverride;\n",
-    );
-  }
-
-  return override as (config: unknown) => unknown;
-}
-
-// ---------------------------------------------------------------------------
-// Render orchestration
-// ---------------------------------------------------------------------------
-
-interface RenderConfig {
-  bundle: CliBundle;
-  entryPoint: string;
-  compositionId: string;
-  outputPath: string;
-  fps: number;
-  width: number;
-  height: number;
-  webpackOverride?: (config: unknown) => unknown;
-}
-
-async function renderScenario(config: RenderConfig): Promise<void> {
-  const bundler = await import("@remotion/bundler").catch(() => {
-    throw new Error(
-      "Could not load @remotion/bundler.\n" +
-      "Install it: pnpm add @remotion/bundler@4.0.448",
-    );
-  });
-
-  const renderer = await import("@remotion/renderer").catch(() => {
-    throw new Error(
-      "Could not load @remotion/renderer.\n" +
-      "Install it: pnpm add @remotion/renderer@4.0.448",
-    );
-  });
-
-  process.stderr.write("Bundling Remotion project...\n");
-
-  const bundleOptions: Record<string, unknown> = {
-    entryPoint: config.entryPoint,
-  };
-  if (config.webpackOverride) {
-    bundleOptions.webpackOverride = config.webpackOverride;
-  }
-  const serveUrl = await (bundler.bundle as (opts: Record<string, unknown>) => Promise<string>)(
-    bundleOptions,
-  );
-
-  process.stderr.write(`Selecting composition: ${config.compositionId}\n`);
-  const composition = await renderer.selectComposition({
-    serveUrl,
-    id: config.compositionId,
-  });
-
-  process.stderr.write(
-    `Composition: ${composition.width}x${composition.height} @ ${composition.fps}fps, ` +
-    `${composition.durationInFrames} frames ` +
-    `(${(composition.durationInFrames / composition.fps).toFixed(1)}s)\n`,
-  );
-
-  const outDir = resolve(config.outputPath, "..");
-  await mkdir(outDir, { recursive: true });
-
-  process.stderr.write("Rendering...\n");
-  await renderer.renderMedia({
-    composition,
-    serveUrl,
-    codec: "h264" as const,
-    outputLocation: config.outputPath,
-    onProgress: ({ progress }) => {
-      const pct = Math.round(progress * 100);
-      process.stderr.write(`\r  Progress: ${pct}%`);
-    },
-  });
-
-  process.stderr.write("\n");
-}

package/src/commands/serve.d.ts

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

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

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

package/src/commands/serve.js

@@ -0,0 +1,91 @@
+import { spawn } from "node:child_process";
+import { platform } from "node:process";
+import { runServe } from "../serve/run-serve.js";
+/** Vite's preview port — the conventional "serve a built site" port. */
+const DEFAULT_PORT = 4173;
+/** Bind to loopback by default; a preview is a single-developer tool. */
+const DEFAULT_HOST = "localhost";
+export function registerServeCommand(program) {
+    program
+        .command("serve")
+        .description("Serve a packed bundle locally and print its embed URL.\n\n" +
+        "Takes a bundle directory produced by `scenar pack` and serves it as a\n" +
+        "static site on http://localhost:4173 (override with --port/--host).\n" +
+        "Prints the URL plus a ready-to-paste responsive <iframe> snippet, then\n" +
+        "stays running until you press Ctrl+C.\n\n" +
+        "This is the zero-infrastructure way to view an embed: no backend, no\n" +
+        "account. For a permanent public URL, use `scenar publish` (GitHub\n" +
+        "Pages) or `scenar deploy` (Scenar Cloud).")
+        .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
+        .option("--port <number>", `port to listen on (default: ${DEFAULT_PORT})`, String(DEFAULT_PORT))
+        .option("--host <host>", `host/interface to bind (default: ${DEFAULT_HOST})`, DEFAULT_HOST)
+        .option("--open", "open the embed in your default browser")
+        .action(async (bundleDir, options) => {
+        try {
+            const port = Number(options.port);
+            if (!Number.isInteger(port) || port < 0 || port > 65535) {
+                throw new Error(`invalid --port "${options.port}"; expected an integer between 0 and 65535.`);
+            }
+            const host = options.host ?? DEFAULT_HOST;
+            let result;
+            try {
+                result = await runServe({ bundleDir, port, host });
+            }
+            catch (error) {
+                if (isAddrInUse(error)) {
+                    throw new Error(`port ${port} is already in use. Stop the other process or pass --port <number>.`);
+                }
+                throw error;
+            }
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m Serving at ${result.url}\n`);
+            if (!result.recordedViewport) {
+                process.stderr.write("  Note: no recorded viewport; snippet uses the default " +
+                    `${result.viewport.width}x${result.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(result.snippet)}\n`);
+            process.stderr.write("\n  Press Ctrl+C to stop.\n");
+            if (options.open) {
+                openInBrowser(result.url);
+            }
+            await runUntilInterrupted(result.handle);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+/** Block until SIGINT/SIGTERM, then close the server cleanly. */
+function runUntilInterrupted(handle) {
+    return new Promise((resolvePromise) => {
+        const shutdown = () => {
+            process.stderr.write("\nStopping...\n");
+            void handle.close().finally(() => resolvePromise());
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    });
+}
+/** Best-effort: launch the OS default browser. Failures are silent (non-fatal). */
+function openInBrowser(url) {
+    const command = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+    try {
+        const child = spawn(command, [url], { stdio: "ignore", detached: true, shell: platform === "win32" });
+        child.on("error", () => { });
+        child.unref();
+    }
+    catch {
+        // Opening a browser is a convenience; never fail the command over it.
+    }
+}
+function isAddrInUse(error) {
+    return typeof error === "object" && error !== null && error.code === "EADDRINUSE";
+}
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block) {
+    return block.replace(/^/gm, "  ");
+}
+//# sourceMappingURL=serve.js.map