@scenar/cli 0.2.1 → 0.4.0

package/src/pack/run-pack.ts

@@ -4,6 +4,7 @@ import { detectRenderExport } from "../render/detect-render-export.js";
 import { resolveProvidersPath } from "../render/resolve-providers.js";
 import { generateEmbedEntry, generateEmbedHtml } from "./generate-embed-entry.js";
 import { runViteBuild } from "./build.js";
+import { copyEmbedLoader } from "./embed-loader.js";
 import {
   buildPackManifest,
   writePackManifest,
@@ -119,6 +120,12 @@ export async function runPack(options: RunPackOptions): Promise<PackResult> {
       height: shellHeight,
     });
 
+    // 4b. Copy the optional <scenar-embed> loader into the bundle as embed.js
+    //     (sibling of index.html), so the enhanced snippet works on any static
+    //     host (GitHub Pages, `serve`, the edge) with no extra setup. It lands
+    //     before the manifest pass below so it ships as a first-class bundle file.
+    await copyEmbedLoader(outDir);
+
     // 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);

package/src/publish/publish-flow.d.ts

@@ -1,9 +1,9 @@
 /**
  * GitHub Pages publishing — the OSS "permanent public URL" path of Phase 1.
  *
- * The flow is dependency-injected (mirroring deploy-flow.ts) so its ordering and
- * payloads are unit-testable against fakes, with zero live GitHub calls in the
- * test suite. The real `gh`/`git` implementations live in ./github.ts.
+ * The flow is dependency-injected so its ordering and payloads are unit-testable
+ * against fakes, with zero live GitHub calls in the test suite. The real
+ * `gh`/`git` implementations live in ./github.ts.
  */
 /** Identity for the target GitHub repository + how to write to it. */
 export interface PublishOptions {

package/src/publish/publish-flow.js

@@ -1,9 +1,9 @@
 /**
  * GitHub Pages publishing — the OSS "permanent public URL" path of Phase 1.
  *
- * The flow is dependency-injected (mirroring deploy-flow.ts) so its ordering and
- * payloads are unit-testable against fakes, with zero live GitHub calls in the
- * test suite. The real `gh`/`git` implementations live in ./github.ts.
+ * The flow is dependency-injected so its ordering and payloads are unit-testable
+ * against fakes, with zero live GitHub calls in the test suite. The real
+ * `gh`/`git` implementations live in ./github.ts.
  */
 /** A repo name's allowed characters (GitHub: alphanumerics, ., _, -). */
 const REPO_NAME_PATTERN = /^[A-Za-z0-9._-]+$/;

package/src/publish/publish-flow.ts

@@ -1,9 +1,9 @@
 /**
  * GitHub Pages publishing — the OSS "permanent public URL" path of Phase 1.
  *
- * The flow is dependency-injected (mirroring deploy-flow.ts) so its ordering and
- * payloads are unit-testable against fakes, with zero live GitHub calls in the
- * test suite. The real `gh`/`git` implementations live in ./github.ts.
+ * The flow is dependency-injected so its ordering and payloads are unit-testable
+ * against fakes, with zero live GitHub calls in the test suite. The real
+ * `gh`/`git` implementations live in ./github.ts.
  */
 
 /** A repo name's allowed characters (GitHub: alphanumerics, ., _, -). */

package/src/publish/run-publish.d.ts

@@ -30,6 +30,8 @@ export interface PublishRunResult {
     readonly viewport: Viewport;
     readonly recordedViewport: boolean;
     readonly snippet: string;
+    /** The optional <scenar-embed> loader snippet (auto-fit + theme sync). */
+    readonly enhancedSnippet: string;
 }
 /**
  * Validate a packed bundle and publish it to GitHub Pages — the orchestration

package/src/publish/run-publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-publish.d.ts","sourceRoot":"","sources":["../../../src/publish/run-publish.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAc3B,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CAC9C;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+CtF"}
+{"version":3,"file":"run-publish.d.ts","sourceRoot":"","sources":["../../../src/publish/run-publish.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAc3B,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CAC9C;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgDtF"}

package/src/publish/run-publish.js

@@ -1,7 +1,7 @@
 import { resolve, join, basename } from "node:path";
 import { stat, readFile } from "node:fs/promises";
 import { PACK_MANIFEST_FILE } from "../pack/pack-manifest.js";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
+import { buildEmbedSnippet, buildEnhancedEmbedSnippet } from "../embed/embed-snippet.js";
 import { readBundleViewport } from "../bundle/read-viewport.js";
 import { createGithubPublisher } from "./github.js";
 import { runPublishFlow, validateRepoName, validatePublishPath, normalizePath, } from "./publish-flow.js";
@@ -55,7 +55,8 @@ export async function runPublish(options) {
     });
     const { viewport, recorded } = await readBundleViewport(resolvedDir);
     const snippet = buildEmbedSnippet({ embedUrl: result.pagesUrl, viewport });
-    return { result, viewport, recordedViewport: recorded, snippet };
+    const enhancedSnippet = buildEnhancedEmbedSnippet({ embedUrl: result.pagesUrl, viewport });
+    return { result, viewport, recordedViewport: recorded, snippet, enhancedSnippet };
 }
 /**
  * The packed scenario slug (from pack-manifest.json), falling back to the bundle

package/src/publish/run-publish.js.map

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

package/src/publish/run-publish.ts

@@ -1,7 +1,7 @@
 import { resolve, join, basename } from "node:path";
 import { stat, readFile } from "node:fs/promises";
 import { PACK_MANIFEST_FILE } from "../pack/pack-manifest.js";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
+import { buildEmbedSnippet, buildEnhancedEmbedSnippet } from "../embed/embed-snippet.js";
 import { readBundleViewport } from "../bundle/read-viewport.js";
 import type { Viewport } from "../pack/viewport.js";
 import { createGithubPublisher } from "./github.js";
@@ -57,6 +57,8 @@ export interface PublishRunResult {
   readonly viewport: Viewport;
   readonly recordedViewport: boolean;
   readonly snippet: string;
+  /** The optional <scenar-embed> loader snippet (auto-fit + theme sync). */
+  readonly enhancedSnippet: string;
 }
 
 /**
@@ -110,8 +112,9 @@ export async function runPublish(options: RunPublishOptions): Promise<PublishRun
 
   const { viewport, recorded } = await readBundleViewport(resolvedDir);
   const snippet = buildEmbedSnippet({ embedUrl: result.pagesUrl, viewport });
+  const enhancedSnippet = buildEnhancedEmbedSnippet({ embedUrl: result.pagesUrl, viewport });
 
-  return { result, viewport, recordedViewport: recorded, snippet };
+  return { result, viewport, recordedViewport: recorded, snippet, enhancedSnippet };
 }
 
 /**

package/src/render/detect-render-export.d.ts

@@ -3,8 +3,8 @@
  *
  * Checks `render.tsx` first (recommended — a lean file that only imports
  * view components), then falls back to `index.tsx`. Using a dedicated
- * `render.tsx` avoids pulling browser-only dependencies (preview
- * runtime, MSW, etc.) into the Remotion webpack bundle.
+ * `render.tsx` avoids pulling browser-only dependencies (a product SDK
+ * client, data-mock wiring, etc.) into the Remotion webpack bundle.
  *
  * Uses a lightweight source-text scan rather than a dynamic import.
  * The actual module resolution and type checking happens later when

package/src/render/detect-render-export.js

@@ -7,8 +7,8 @@ const RENDER_FILE_CANDIDATES = ["render.tsx", "render.ts", "index.tsx", "index.t
  *
  * Checks `render.tsx` first (recommended — a lean file that only imports
  * view components), then falls back to `index.tsx`. Using a dedicated
- * `render.tsx` avoids pulling browser-only dependencies (preview
- * runtime, MSW, etc.) into the Remotion webpack bundle.
+ * `render.tsx` avoids pulling browser-only dependencies (a product SDK
+ * client, data-mock wiring, etc.) into the Remotion webpack bundle.
  *
  * Uses a lightweight source-text scan rather than a dynamic import.
  * The actual module resolution and type checking happens later when

package/src/render/detect-render-export.ts

@@ -9,8 +9,8 @@ const RENDER_FILE_CANDIDATES = ["render.tsx", "render.ts", "index.tsx", "index.t
  *
  * Checks `render.tsx` first (recommended — a lean file that only imports
  * view components), then falls back to `index.tsx`. Using a dedicated
- * `render.tsx` avoids pulling browser-only dependencies (preview
- * runtime, MSW, etc.) into the Remotion webpack bundle.
+ * `render.tsx` avoids pulling browser-only dependencies (a product SDK
+ * client, data-mock wiring, etc.) into the Remotion webpack bundle.
  *
  * Uses a lightweight source-text scan rather than a dynamic import.
  * The actual module resolution and type checking happens later when

package/src/serve/local-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Derive a locally-viewable URL from an embed URL. Some local edges serve over
+ * http on `*.localhost` even when the URL is emitted as https; for those hosts
+ * we downgrade the scheme so the printed link is clickable. Production https
+ * URLs and non-URL input are returned unchanged.
+ */
+export declare function localViewUrl(embedUrl: string): string;
+//# sourceMappingURL=local-url.d.ts.map

package/src/serve/local-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-url.d.ts","sourceRoot":"","sources":["../../../src/serve/local-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarD"}

package/src/serve/local-url.js

@@ -0,0 +1,21 @@
+/**
+ * Derive a locally-viewable URL from an embed URL. Some local edges serve over
+ * http on `*.localhost` even when the URL is emitted as https; for those hosts
+ * we downgrade the scheme so the printed link is clickable. Production https
+ * URLs and non-URL input are returned unchanged.
+ */
+export function localViewUrl(embedUrl) {
+    try {
+        const url = new URL(embedUrl);
+        const isLocal = url.hostname === "localhost" || url.hostname.endsWith(".localhost");
+        if (isLocal && url.protocol === "https:") {
+            url.protocol = "http:";
+            return url.toString();
+        }
+    }
+    catch {
+        // Not a parseable URL — return as-is.
+    }
+    return embedUrl;
+}
+//# sourceMappingURL=local-url.js.map

package/src/serve/local-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-url.js","sourceRoot":"","sources":["../../../src/serve/local-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,OAAO,GACX,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtE,IAAI,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACzC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;YACvB,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/src/serve/local-url.ts

@@ -0,0 +1,20 @@
+/**
+ * Derive a locally-viewable URL from an embed URL. Some local edges serve over
+ * http on `*.localhost` even when the URL is emitted as https; for those hosts
+ * we downgrade the scheme so the printed link is clickable. Production https
+ * URLs and non-URL input are returned unchanged.
+ */
+export function localViewUrl(embedUrl: string): string {
+  try {
+    const url = new URL(embedUrl);
+    const isLocal =
+      url.hostname === "localhost" || url.hostname.endsWith(".localhost");
+    if (isLocal && url.protocol === "https:") {
+      url.protocol = "http:";
+      return url.toString();
+    }
+  } catch {
+    // Not a parseable URL — return as-is.
+  }
+  return embedUrl;
+}

package/src/serve/run-serve.d.ts

@@ -16,6 +16,8 @@ export interface ServeResult {
     readonly url: string;
     /** A ready-to-paste responsive <iframe> snippet for this URL. */
     readonly snippet: string;
+    /** The optional <scenar-embed> loader snippet (auto-fit + theme sync). */
+    readonly enhancedSnippet: string;
     /** The viewport used for the snippet (recorded, or the default). */
     readonly viewport: Viewport;
     /** Whether the snippet's viewport came from the bundle (vs. the default). */

package/src/serve/run-serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-serve.d.ts","sourceRoot":"","sources":["../../../src/serve/run-serve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKhF,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B7E"}
+{"version":3,"file":"run-serve.d.ts","sourceRoot":"","sources":["../../../src/serve/run-serve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKhF,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CA4B7E"}

package/src/serve/run-serve.js

@@ -1,7 +1,7 @@
 import { resolve, join } from "node:path";
 import { stat } from "node:fs/promises";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
-import { localViewUrl } from "../deploy/deploy-flow.js";
+import { buildEmbedSnippet, buildEnhancedEmbedSnippet } from "../embed/embed-snippet.js";
+import { localViewUrl } from "./local-url.js";
 import { readBundleViewport } from "../bundle/read-viewport.js";
 import { startBundleServer } from "./static-server.js";
 /** The servable entry every packed bundle contains at its root. */
@@ -30,6 +30,7 @@ export async function runServe(options) {
     const url = localViewUrl(handle.url);
     const { viewport, recorded } = await readBundleViewport(resolvedDir);
     const snippet = buildEmbedSnippet({ embedUrl: url, viewport });
-    return { handle, url, snippet, viewport, recordedViewport: recorded };
+    const enhancedSnippet = buildEnhancedEmbedSnippet({ embedUrl: url, viewport });
+    return { handle, url, snippet, enhancedSnippet, viewport, recordedViewport: recorded };
 }
 //# sourceMappingURL=run-serve.js.map

package/src/serve/run-serve.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-serve.js","sourceRoot":"","sources":["../../../src/serve/run-serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAEhF,mEAAmE;AACnE,MAAM,UAAU,GAAG,YAAY,CAAC;AAyBhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,SAAS,iEAAiE,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,OAAO,OAAO,CAAC,SAAS,2DAA2D,CACpG,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE/D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AACxE,CAAC"}
+{"version":3,"file":"run-serve.js","sourceRoot":"","sources":["../../../src/serve/run-serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAEhF,mEAAmE;AACnE,MAAM,UAAU,GAAG,YAAY,CAAC;AA2BhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,SAAS,iEAAiE,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,OAAO,OAAO,CAAC,SAAS,2DAA2D,CACpG,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,yBAAyB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE/E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AACzF,CAAC"}

package/src/serve/run-serve.ts

@@ -1,7 +1,7 @@
 import { resolve, join } from "node:path";
 import { stat } from "node:fs/promises";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
-import { localViewUrl } from "../deploy/deploy-flow.js";
+import { buildEmbedSnippet, buildEnhancedEmbedSnippet } from "../embed/embed-snippet.js";
+import { localViewUrl } from "./local-url.js";
 import { readBundleViewport } from "../bundle/read-viewport.js";
 import type { Viewport } from "../pack/viewport.js";
 import { startBundleServer, type BundleServerHandle } from "./static-server.js";
@@ -26,6 +26,8 @@ export interface ServeResult {
   readonly url: string;
   /** A ready-to-paste responsive <iframe> snippet for this URL. */
   readonly snippet: string;
+  /** The optional <scenar-embed> loader snippet (auto-fit + theme sync). */
+  readonly enhancedSnippet: string;
   /** The viewport used for the snippet (recorded, or the default). */
   readonly viewport: Viewport;
   /** Whether the snippet's viewport came from the bundle (vs. the default). */
@@ -63,6 +65,7 @@ export async function runServe(options: RunServeOptions): Promise<ServeResult> {
   const url = localViewUrl(handle.url);
   const { viewport, recorded } = await readBundleViewport(resolvedDir);
   const snippet = buildEmbedSnippet({ embedUrl: url, viewport });
+  const enhancedSnippet = buildEnhancedEmbedSnippet({ embedUrl: url, viewport });
 
-  return { handle, url, snippet, viewport, recordedViewport: recorded };
+  return { handle, url, snippet, enhancedSnippet, viewport, recordedViewport: recorded };
 }