@scenar/cli 0.3.0 → 0.4.0

package/src/install/scaffold.js

@@ -0,0 +1,233 @@
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Base dependencies every Scenar demos project needs to author tours. The
+ * starter tour is built from `@scenar/react` shells, so `@scenar/react` is
+ * recorded as `"*"` (resolves to the latest published — pin it once you know
+ * the version you want). React is constrained to the major the `@scenar/*`
+ * packages target so the embed and the user's real components (added later)
+ * share a single React.
+ */
+export const BASE_DEPENDENCIES = {
+    "@scenar/react": "*",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+};
+/**
+ * Scaffold a fresh Scenar demos project in `dir`.
+ *
+ * Creates a minimal `package.json`, a `tsconfig.json` tuned for JSX, a
+ * `.gitignore` that ignores build output, and a runnable **starter tour** under
+ * `tours/example-tour/` (a `steps.ts` timeline, an `index.tsx` that exports
+ * `renderStep`, and a `.scenar/providers.tsx`). The starter is built from
+ * `@scenar/react` shells so `scenar pack` works immediately; the author then
+ * swaps in their real components and wires data in `providers.tsx`.
+ *
+ * Existing files are never overwritten — this only fills in what is missing, so
+ * it is safe to re-run.
+ */
+export function scaffoldProject(dir) {
+    const created = [];
+    writeIfMissing(dir, "package.json", renderPackageJson(path.basename(dir)), created);
+    writeIfMissing(dir, "tsconfig.json", TSCONFIG, created);
+    writeIfMissing(dir, ".gitignore", GITIGNORE, created);
+    writeIfMissing(dir, path.join(TOUR_DIR, "steps.ts"), TOUR_STEPS, created);
+    writeIfMissing(dir, path.join(TOUR_DIR, "index.tsx"), TOUR_INDEX, created);
+    writeIfMissing(dir, path.join(TOUR_DIR, ".scenar", "providers.tsx"), TOUR_PROVIDERS, created);
+    return { created };
+}
+function writeIfMissing(dir, relPath, content, created) {
+    const target = path.join(dir, relPath);
+    if (fs.existsSync(target))
+        return;
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, content, "utf-8");
+    created.push(relPath);
+}
+function renderPackageJson(name) {
+    const pkg = {
+        name: toPackageName(name),
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        scripts: {
+            pack: `scenar pack ${TOUR_DIR}`,
+        },
+        dependencies: { ...BASE_DEPENDENCIES },
+    };
+    return JSON.stringify(pkg, null, 2) + "\n";
+}
+/** Coerce a directory name into a valid npm package name. */
+function toPackageName(dirName) {
+    const slug = dirName
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug.length > 0 ? slug : "scenar-demos";
+}
+/** Where the starter tour is scaffolded (also the default `pack` target). */
+const TOUR_DIR = "tours/example-tour";
+const TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"]
+  },
+  "include": ["tours"]
+}
+`;
+const GITIGNORE = `node_modules/
+
+# Packed embeds — regenerate with \`scenar pack\`
+*-bundle/
+`;
+const TOUR_STEPS = `import type { ScenarioStep } from "@scenar/core";
+
+/** The screen shown at a given step (maps to a view in index.tsx). */
+export type ExampleScreen = "login" | "dashboard";
+
+/** Data snapshot for one step of the tour. */
+export interface ExampleStepData {
+  /** Address-bar URL shown in the browser chrome (no scheme). */
+  readonly url: string;
+  /** Which screen is shown at this step. */
+  readonly screen: ExampleScreen;
+}
+
+/**
+ * The tour timeline. \`delayMs\` is the dwell before each step (the first is
+ * shown immediately); \`caption\` renders under the player; \`narration\` is the
+ * spoken script synthesized by \`scenar narrate\`.
+ */
+export const steps: ScenarioStep<ExampleStepData>[] = [
+  {
+    delayMs: 0,
+    caption: "Sign in",
+    narration: "Sign in to your workspace.",
+    data: { url: "app.example.com/login", screen: "login" },
+  },
+  {
+    delayMs: 2400,
+    caption: "Your dashboard",
+    narration: "And you land on your dashboard.",
+    data: { url: "app.example.com/home", screen: "dashboard" },
+  },
+];
+`;
+const TOUR_INDEX = `import type { ReactNode } from "react";
+import {
+  BrowserView,
+  DashboardPage,
+  LoginCardPage,
+  type SideNavItem,
+} from "@scenar/react";
+import type { ExampleStepData } from "./steps";
+
+/**
+ * renderStep: a pure (data, stepIndex) -> ReactNode. Both \`scenar pack\` (embed)
+ * and \`scenar render\` (video) consume this contract.
+ *
+ * This starter draws CSS-only @scenar/react shells so it packs with no extra
+ * setup. To show your REAL product UI, install your components
+ * (\`scenar install <your-pkg>\`), import and render them here, and wire any data
+ * they fetch in .scenar/providers.tsx.
+ */
+export function renderStep(data: ExampleStepData, stepIndex: number): ReactNode {
+  return (
+    <BrowserView url={"https://" + data.url} contentKey={String(stepIndex)}>
+      {data.screen === "login" ? <LoginScreen /> : <DashboardScreen />}
+    </BrowserView>
+  );
+}
+
+function LoginScreen(): ReactNode {
+  return (
+    <LoginCardPage
+      appName="Example"
+      subtitle="Sign in to your workspace"
+      fields={[
+        { label: "Email", value: "you@example.com", type: "email" },
+        { label: "Password", type: "password" },
+      ]}
+      submitLabel="Sign in"
+    />
+  );
+}
+
+const SIDEBAR: SideNavItem[] = [
+  { label: "Workspace", isSection: true },
+  { label: "Overview", active: true },
+  { label: "Projects" },
+];
+
+function DashboardScreen(): ReactNode {
+  return (
+    <DashboardPage
+      appName="Example"
+      userName="You"
+      navLinks={[{ label: "Home", active: true }]}
+      sidebarItems={SIDEBAR}
+    >
+      <div style={{ padding: 20 }}>
+        <h2
+          style={{
+            margin: 0,
+            fontSize: 15,
+            fontWeight: 600,
+            color: "var(--scenar-foreground)",
+          }}
+        >
+          Welcome back
+        </h2>
+      </div>
+    </DashboardPage>
+  );
+}
+`;
+const TOUR_PROVIDERS = `/**
+ * .scenar/providers.tsx — wraps every step of THIS tour in \`scenar pack\` (embed)
+ * and \`scenar render\` (video).
+ *
+ * You only need this when your tour renders real, data-fetching components that
+ * need a client/provider to render in isolation (no backend). A tour built only
+ * from @scenar/react shells (like the starter) can leave this as a pass-through
+ * or delete it.
+ *
+ * Recommended pattern for Connect-RPC SDKs (e.g. @stigmer/react): mock data with
+ * an in-process router transport — no network, no service worker — and resolve
+ * the embed's light/dark mode from \`getEmbedColorMode()\`. Fill in your client,
+ * provider, and fixtures, then return the provider instead of the fragment:
+ *
+ *   import "@your-org/react/styles.css";
+ *   import { createRouterTransport } from "@connectrpc/connect";
+ *   import { getEmbedColorMode } from "@scenar/react";
+ *   import { YourClient } from "@your-org/sdk";
+ *   import { YourProvider } from "@your-org/react";
+ *   import { YourController } from "@your-org/protos/...";
+ *
+ *   const transport = createRouterTransport((router) => {
+ *     router.service(YourController, { get: () => yourFixtureObject });
+ *   });
+ *   const client = new YourClient({ baseUrl: "/", customTransport: transport });
+ *
+ *   export function PreviewProviders({ children }: { readonly children: ReactNode }) {
+ *     return (
+ *       <YourProvider client={client} colorMode={getEmbedColorMode()}>
+ *         {children}
+ *       </YourProvider>
+ *     );
+ *   }
+ */
+import type { ReactNode } from "react";
+
+export function PreviewProviders({ children }: { readonly children: ReactNode }) {
+  return <>{children}</>;
+}
+`;
+//# sourceMappingURL=scaffold.js.map

package/src/install/scaffold.js.map

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

package/src/install/scaffold.ts

@@ -0,0 +1,255 @@
+import * as fs from "fs";
+import * as path from "path";
+
+/**
+ * Base dependencies every Scenar demos project needs to author tours. The
+ * starter tour is built from `@scenar/react` shells, so `@scenar/react` is
+ * recorded as `"*"` (resolves to the latest published — pin it once you know
+ * the version you want). React is constrained to the major the `@scenar/*`
+ * packages target so the embed and the user's real components (added later)
+ * share a single React.
+ */
+export const BASE_DEPENDENCIES: Readonly<Record<string, string>> = {
+  "@scenar/react": "*",
+  react: "^19.0.0",
+  "react-dom": "^19.0.0",
+};
+
+/** Result of scaffolding a fresh demos project. */
+export interface ScaffoldResult {
+  /** Files created, relative to the project directory. */
+  readonly created: readonly string[];
+}
+
+/**
+ * Scaffold a fresh Scenar demos project in `dir`.
+ *
+ * Creates a minimal `package.json`, a `tsconfig.json` tuned for JSX, a
+ * `.gitignore` that ignores build output, and a runnable **starter tour** under
+ * `tours/example-tour/` (a `steps.ts` timeline, an `index.tsx` that exports
+ * `renderStep`, and a `.scenar/providers.tsx`). The starter is built from
+ * `@scenar/react` shells so `scenar pack` works immediately; the author then
+ * swaps in their real components and wires data in `providers.tsx`.
+ *
+ * Existing files are never overwritten — this only fills in what is missing, so
+ * it is safe to re-run.
+ */
+export function scaffoldProject(dir: string): ScaffoldResult {
+  const created: string[] = [];
+
+  writeIfMissing(dir, "package.json", renderPackageJson(path.basename(dir)), created);
+  writeIfMissing(dir, "tsconfig.json", TSCONFIG, created);
+  writeIfMissing(dir, ".gitignore", GITIGNORE, created);
+  writeIfMissing(dir, path.join(TOUR_DIR, "steps.ts"), TOUR_STEPS, created);
+  writeIfMissing(dir, path.join(TOUR_DIR, "index.tsx"), TOUR_INDEX, created);
+  writeIfMissing(dir, path.join(TOUR_DIR, ".scenar", "providers.tsx"), TOUR_PROVIDERS, created);
+
+  return { created };
+}
+
+function writeIfMissing(
+  dir: string,
+  relPath: string,
+  content: string,
+  created: string[],
+): void {
+  const target = path.join(dir, relPath);
+  if (fs.existsSync(target)) return;
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(target, content, "utf-8");
+  created.push(relPath);
+}
+
+function renderPackageJson(name: string): string {
+  const pkg = {
+    name: toPackageName(name),
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    scripts: {
+      pack: `scenar pack ${TOUR_DIR}`,
+    },
+    dependencies: { ...BASE_DEPENDENCIES },
+  };
+  return JSON.stringify(pkg, null, 2) + "\n";
+}
+
+/** Coerce a directory name into a valid npm package name. */
+function toPackageName(dirName: string): string {
+  const slug = dirName
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  return slug.length > 0 ? slug : "scenar-demos";
+}
+
+/** Where the starter tour is scaffolded (also the default `pack` target). */
+const TOUR_DIR = "tours/example-tour";
+
+const TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"]
+  },
+  "include": ["tours"]
+}
+`;
+
+const GITIGNORE = `node_modules/
+
+# Packed embeds — regenerate with \`scenar pack\`
+*-bundle/
+`;
+
+const TOUR_STEPS = `import type { ScenarioStep } from "@scenar/core";
+
+/** The screen shown at a given step (maps to a view in index.tsx). */
+export type ExampleScreen = "login" | "dashboard";
+
+/** Data snapshot for one step of the tour. */
+export interface ExampleStepData {
+  /** Address-bar URL shown in the browser chrome (no scheme). */
+  readonly url: string;
+  /** Which screen is shown at this step. */
+  readonly screen: ExampleScreen;
+}
+
+/**
+ * The tour timeline. \`delayMs\` is the dwell before each step (the first is
+ * shown immediately); \`caption\` renders under the player; \`narration\` is the
+ * spoken script synthesized by \`scenar narrate\`.
+ */
+export const steps: ScenarioStep<ExampleStepData>[] = [
+  {
+    delayMs: 0,
+    caption: "Sign in",
+    narration: "Sign in to your workspace.",
+    data: { url: "app.example.com/login", screen: "login" },
+  },
+  {
+    delayMs: 2400,
+    caption: "Your dashboard",
+    narration: "And you land on your dashboard.",
+    data: { url: "app.example.com/home", screen: "dashboard" },
+  },
+];
+`;
+
+const TOUR_INDEX = `import type { ReactNode } from "react";
+import {
+  BrowserView,
+  DashboardPage,
+  LoginCardPage,
+  type SideNavItem,
+} from "@scenar/react";
+import type { ExampleStepData } from "./steps";
+
+/**
+ * renderStep: a pure (data, stepIndex) -> ReactNode. Both \`scenar pack\` (embed)
+ * and \`scenar render\` (video) consume this contract.
+ *
+ * This starter draws CSS-only @scenar/react shells so it packs with no extra
+ * setup. To show your REAL product UI, install your components
+ * (\`scenar install <your-pkg>\`), import and render them here, and wire any data
+ * they fetch in .scenar/providers.tsx.
+ */
+export function renderStep(data: ExampleStepData, stepIndex: number): ReactNode {
+  return (
+    <BrowserView url={"https://" + data.url} contentKey={String(stepIndex)}>
+      {data.screen === "login" ? <LoginScreen /> : <DashboardScreen />}
+    </BrowserView>
+  );
+}
+
+function LoginScreen(): ReactNode {
+  return (
+    <LoginCardPage
+      appName="Example"
+      subtitle="Sign in to your workspace"
+      fields={[
+        { label: "Email", value: "you@example.com", type: "email" },
+        { label: "Password", type: "password" },
+      ]}
+      submitLabel="Sign in"
+    />
+  );
+}
+
+const SIDEBAR: SideNavItem[] = [
+  { label: "Workspace", isSection: true },
+  { label: "Overview", active: true },
+  { label: "Projects" },
+];
+
+function DashboardScreen(): ReactNode {
+  return (
+    <DashboardPage
+      appName="Example"
+      userName="You"
+      navLinks={[{ label: "Home", active: true }]}
+      sidebarItems={SIDEBAR}
+    >
+      <div style={{ padding: 20 }}>
+        <h2
+          style={{
+            margin: 0,
+            fontSize: 15,
+            fontWeight: 600,
+            color: "var(--scenar-foreground)",
+          }}
+        >
+          Welcome back
+        </h2>
+      </div>
+    </DashboardPage>
+  );
+}
+`;
+
+const TOUR_PROVIDERS = `/**
+ * .scenar/providers.tsx — wraps every step of THIS tour in \`scenar pack\` (embed)
+ * and \`scenar render\` (video).
+ *
+ * You only need this when your tour renders real, data-fetching components that
+ * need a client/provider to render in isolation (no backend). A tour built only
+ * from @scenar/react shells (like the starter) can leave this as a pass-through
+ * or delete it.
+ *
+ * Recommended pattern for Connect-RPC SDKs (e.g. @stigmer/react): mock data with
+ * an in-process router transport — no network, no service worker — and resolve
+ * the embed's light/dark mode from \`getEmbedColorMode()\`. Fill in your client,
+ * provider, and fixtures, then return the provider instead of the fragment:
+ *
+ *   import "@your-org/react/styles.css";
+ *   import { createRouterTransport } from "@connectrpc/connect";
+ *   import { getEmbedColorMode } from "@scenar/react";
+ *   import { YourClient } from "@your-org/sdk";
+ *   import { YourProvider } from "@your-org/react";
+ *   import { YourController } from "@your-org/protos/...";
+ *
+ *   const transport = createRouterTransport((router) => {
+ *     router.service(YourController, { get: () => yourFixtureObject });
+ *   });
+ *   const client = new YourClient({ baseUrl: "/", customTransport: transport });
+ *
+ *   export function PreviewProviders({ children }: { readonly children: ReactNode }) {
+ *     return (
+ *       <YourProvider client={client} colorMode={getEmbedColorMode()}>
+ *         {children}
+ *       </YourProvider>
+ *     );
+ *   }
+ */
+import type { ReactNode } from "react";
+
+export function PreviewProviders({ children }: { readonly children: ReactNode }) {
+  return <>{children}</>;
+}
+`;

package/src/pack/pack-manifest.d.ts

@@ -10,7 +10,7 @@ export interface PackFile {
     /** Content type the server binds into the presign and the edge serves. */
     readonly contentType: string;
 }
-/** The deploy instruction file `scenar deploy` consumes. */
+/** The deploy instruction file the upload backend consumes. */
 export interface PackManifest {
     readonly schemaVersion: number;
     readonly scenarioId: string;

package/src/pack/pack-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../../../src/pack/pack-manifest.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;CAC5B;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+BjG;AAED,mDAAmD;AACnD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F;AAiBD,oFAAoF;AACpF,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpG"}
+{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../../../src/pack/pack-manifest.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;CAC5B;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+BjG;AAED,mDAAmD;AACnD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F;AAiBD,oFAAoF;AACpF,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpG"}

package/src/pack/pack-manifest.ts

@@ -21,7 +21,7 @@ export interface PackFile {
   readonly contentType: string;
 }
 
-/** The deploy instruction file `scenar deploy` consumes. */
+/** The deploy instruction file the upload backend consumes. */
 export interface PackManifest {
   readonly schemaVersion: number;
   readonly scenarioId: string;

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.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, buildEnhancedEmbedSnippet } 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";

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, buildEnhancedEmbedSnippet } 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";

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"}