@scenar/cli 0.1.12 → 0.1.13

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

@@ -0,0 +1,62 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+/** File names checked in priority order for the renderStep export. */
+const RENDER_FILE_CANDIDATES = ["render.tsx", "render.ts", "index.tsx", "index.ts"];
+/**
+ * Locate the file that exports `renderStep` in the scenario directory.
+ *
+ * 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.
+ *
+ * Uses a lightweight source-text scan rather than a dynamic import.
+ * The actual module resolution and type checking happens later when
+ * Remotion's webpack bundler compiles the generated entry — which has
+ * the full project dependency graph available. Importing the file
+ * here at CLI time would pull in React, MUI, and other view-layer
+ * dependencies that are not available in the Node CLI context.
+ *
+ * Returns the absolute path to the file containing renderStep.
+ * Throws with a descriptive message if no suitable file is found.
+ */
+export async function detectRenderExport(scenarioDir) {
+    for (const filename of RENDER_FILE_CANDIDATES) {
+        const candidate = join(scenarioDir, filename);
+        try {
+            await access(candidate);
+        }
+        catch {
+            continue;
+        }
+        const source = await readFile(candidate, "utf-8");
+        if (hasRenderStepExport(source)) {
+            return candidate;
+        }
+    }
+    throw new Error(`No renderStep export found in ${scenarioDir}.\n\n` +
+        "The render command expects the scenario directory to contain a\n" +
+        "render.tsx (or index.tsx) that exports a renderStep function:\n\n" +
+        "  // render.tsx (recommended — keeps video export deps minimal)\n" +
+        "  export function renderStep(data: YourStepType, stepIndex: number): ReactNode {\n" +
+        "    // map step data to view elements\n" +
+        "  }\n\n" +
+        "Using a dedicated render.tsx avoids pulling browser-only preview\n" +
+        "dependencies into the Remotion webpack bundle.\n\n" +
+        "Alternatively, use --entry to provide a custom Remotion entry point.");
+}
+/**
+ * Heuristic check for `renderStep` being exported from the source.
+ *
+ * Matches patterns like:
+ *   export function renderStep(
+ *   export const renderStep =
+ *   export { renderStep }
+ *   export { renderStep as renderStep }
+ *   export { foo as renderStep }
+ */
+function hasRenderStepExport(source) {
+    return /export\s+(function|const|let|var)\s+renderStep[\s(<]/.test(source) ||
+        /export\s*\{[^}]*\brenderStep\b[^}]*\}/.test(source);
+}
+//# sourceMappingURL=detect-render-export.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect-render-export.js","sourceRoot":"","sources":["../../../src/render/detect-render-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sEAAsE;AACtE,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,KAAK,MAAM,QAAQ,IAAI,sBAAsB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,iCAAiC,WAAW,OAAO;QACnD,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,oFAAoF;QACpF,yCAAyC;QACzC,SAAS;QACT,oEAAoE;QACpE,oDAAoD;QACpD,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO,sDAAsD,CAAC,IAAI,CAAC,MAAM,CAAC;QACxE,uCAAuC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,68 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+
+/** File names checked in priority order for the renderStep export. */
+const RENDER_FILE_CANDIDATES = ["render.tsx", "render.ts", "index.tsx", "index.ts"] as const;
+
+/**
+ * Locate the file that exports `renderStep` in the scenario directory.
+ *
+ * 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.
+ *
+ * Uses a lightweight source-text scan rather than a dynamic import.
+ * The actual module resolution and type checking happens later when
+ * Remotion's webpack bundler compiles the generated entry — which has
+ * the full project dependency graph available. Importing the file
+ * here at CLI time would pull in React, MUI, and other view-layer
+ * dependencies that are not available in the Node CLI context.
+ *
+ * Returns the absolute path to the file containing renderStep.
+ * Throws with a descriptive message if no suitable file is found.
+ */
+export async function detectRenderExport(scenarioDir: string): Promise<string> {
+  for (const filename of RENDER_FILE_CANDIDATES) {
+    const candidate = join(scenarioDir, filename);
+
+    try {
+      await access(candidate);
+    } catch {
+      continue;
+    }
+
+    const source = await readFile(candidate, "utf-8");
+    if (hasRenderStepExport(source)) {
+      return candidate;
+    }
+  }
+
+  throw new Error(
+    `No renderStep export found in ${scenarioDir}.\n\n` +
+    "The render command expects the scenario directory to contain a\n" +
+    "render.tsx (or index.tsx) that exports a renderStep function:\n\n" +
+    "  // render.tsx (recommended — keeps video export deps minimal)\n" +
+    "  export function renderStep(data: YourStepType, stepIndex: number): ReactNode {\n" +
+    "    // map step data to view elements\n" +
+    "  }\n\n" +
+    "Using a dedicated render.tsx avoids pulling browser-only preview\n" +
+    "dependencies into the Remotion webpack bundle.\n\n" +
+    "Alternatively, use --entry to provide a custom Remotion entry point.",
+  );
+}
+
+/**
+ * Heuristic check for `renderStep` being exported from the source.
+ *
+ * Matches patterns like:
+ *   export function renderStep(
+ *   export const renderStep =
+ *   export { renderStep }
+ *   export { renderStep as renderStep }
+ *   export { foo as renderStep }
+ */
+function hasRenderStepExport(source: string): boolean {
+  return /export\s+(function|const|let|var)\s+renderStep[\s(<]/.test(source) ||
+    /export\s*\{[^}]*\brenderStep\b[^}]*\}/.test(source);
+}

package/src/render/generate-entry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Inputs required to generate a Remotion entry file for a scenario.
+ *
+ * All paths are absolute filesystem paths. The generator converts them
+ * to posix-style forward-slash paths suitable for webpack imports.
+ */
+export interface EntryGeneratorInput {
+    /** Absolute path to the scenario directory (e.g. /proj/scenarios/my-tour). */
+    scenarioDir: string;
+    /** Absolute path to the file that exports renderStep. */
+    renderFilePath: string;
+    /** Scenario ID derived from the directory basename. */
+    scenarioId: string;
+    /** Whether the scenario has a narration manifest. */
+    hasNarration: boolean;
+    /** Absolute path to the providers file, or null if none found. */
+    providersPath: string | null;
+    fps: number;
+    width: number;
+    height: number;
+    compositionId: string;
+}
+/**
+ * Produce the TypeScript source for a Remotion entry file that renders
+ * a single scenario.
+ *
+ * The output is a self-contained `index.tsx` that can be passed to
+ * `@remotion/bundler.bundle({ entryPoint })`. All imports use absolute
+ * paths so the file works from any temp directory.
+ *
+ * The steps file may export the steps array under any name (e.g.
+ * `awsConnectionTourSteps`). Rather than guessing the export name,
+ * the generated entry uses a namespace import and duck-types the array
+ * at module-evaluation time — the same heuristic the CLI's own
+ * `loadStepsFromTs` uses.
+ *
+ * This is a pure function with no side effects — callers write the
+ * result to disk and manage cleanup.
+ */
+export declare function generateRemotionEntry(input: EntryGeneratorInput): string;
+//# sourceMappingURL=generate-entry.d.ts.map

package/src/render/generate-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-entry.d.ts","sourceRoot":"","sources":["../../../src/render/generate-entry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA2GxE"}

package/src/render/generate-entry.js

@@ -0,0 +1,111 @@
+import { posix } from "node:path";
+/**
+ * Produce the TypeScript source for a Remotion entry file that renders
+ * a single scenario.
+ *
+ * The output is a self-contained `index.tsx` that can be passed to
+ * `@remotion/bundler.bundle({ entryPoint })`. All imports use absolute
+ * paths so the file works from any temp directory.
+ *
+ * The steps file may export the steps array under any name (e.g.
+ * `awsConnectionTourSteps`). Rather than guessing the export name,
+ * the generated entry uses a namespace import and duck-types the array
+ * at module-evaluation time — the same heuristic the CLI's own
+ * `loadStepsFromTs` uses.
+ *
+ * This is a pure function with no side effects — callers write the
+ * result to disk and manage cleanup.
+ */
+export function generateRemotionEntry(input) {
+    const scenarioPath = toPosix(input.scenarioDir);
+    const stepsImport = `${scenarioPath}/steps`;
+    const renderImport = toPosix(input.renderFilePath).replace(/\.[^.]+$/, "");
+    const lines = [];
+    // --- Imports ---
+    lines.push(`import { registerRoot } from "remotion";`);
+    lines.push(`import { Composition, AbsoluteFill } from "remotion";`);
+    lines.push(`import { ScenarioComposition, calculateScenarioTimeline } from "@scenar/remotion";`);
+    lines.push(`import { renderStep } from ${JSON.stringify(renderImport)};`);
+    lines.push(`import * as _stepsModule from ${JSON.stringify(stepsImport)};`);
+    if (input.hasNarration) {
+        const manifestPath = `${scenarioPath}/narration/manifest.json`;
+        lines.push(`import _manifest from ${JSON.stringify(manifestPath)};`);
+    }
+    else {
+        lines.push(`const _manifest = undefined;`);
+    }
+    if (input.providersPath) {
+        const providersImport = toPosix(input.providersPath).replace(/\.[^.]+$/, "");
+        lines.push(`import { PreviewProviders as _Providers } from ${JSON.stringify(providersImport)};`);
+    }
+    // --- Steps resolution (duck-type the first array with delayMs) ---
+    lines.push(``);
+    lines.push(`function _findSteps(mod: Record<string, unknown>): unknown[] {`);
+    lines.push(`  for (const val of Object.values(mod)) {`);
+    lines.push(`    if (`);
+    lines.push(`      Array.isArray(val) &&`);
+    lines.push(`      val.length > 0 &&`);
+    lines.push(`      typeof val[0] === "object" &&`);
+    lines.push(`      val[0] !== null &&`);
+    lines.push(`      "delayMs" in val[0]`);
+    lines.push(`    ) return val;`);
+    lines.push(`  }`);
+    lines.push(`  throw new Error("No steps array found in ${stepsImport.replace(/"/g, '\\"')}");`);
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`const _steps: any = _findSteps(_stepsModule as unknown as Record<string, unknown>);`);
+    // --- Bundle + timeline ---
+    lines.push(``);
+    lines.push(`const _bundle = {`);
+    lines.push(`  id: ${JSON.stringify(input.scenarioId)},`);
+    lines.push(`  steps: _steps,`);
+    lines.push(`  narrationManifest: _manifest,`);
+    lines.push(`};`);
+    lines.push(``);
+    lines.push(`const _timeline = calculateScenarioTimeline(_bundle.steps, _bundle.narrationManifest, ${input.fps});`);
+    // --- Video root component ---
+    lines.push(``);
+    lines.push(`function _VideoRoot() {`);
+    if (input.providersPath) {
+        lines.push(`  return (`);
+        lines.push(`    <AbsoluteFill>`);
+        lines.push(`      <_Providers>`);
+        lines.push(`        <ScenarioComposition bundle={_bundle}>`);
+        lines.push(`          {(data: any, stepIndex: number) => renderStep(data, stepIndex)}`);
+        lines.push(`        </ScenarioComposition>`);
+        lines.push(`      </_Providers>`);
+        lines.push(`    </AbsoluteFill>`);
+        lines.push(`  );`);
+    }
+    else {
+        lines.push(`  return (`);
+        lines.push(`    <AbsoluteFill>`);
+        lines.push(`      <ScenarioComposition bundle={_bundle}>`);
+        lines.push(`        {(data: any, stepIndex: number) => renderStep(data, stepIndex)}`);
+        lines.push(`      </ScenarioComposition>`);
+        lines.push(`    </AbsoluteFill>`);
+        lines.push(`  );`);
+    }
+    lines.push(`}`);
+    // --- Composition registration ---
+    lines.push(``);
+    lines.push(`const _RemotionRoot = () => (`);
+    lines.push(`  <Composition`);
+    lines.push(`    id=${JSON.stringify(input.compositionId)}`);
+    lines.push(`    component={_VideoRoot}`);
+    lines.push(`    fps={${input.fps}}`);
+    lines.push(`    width={${input.width}}`);
+    lines.push(`    height={${input.height}}`);
+    lines.push(`    durationInFrames={_timeline.durationInFrames}`);
+    lines.push(`  />`);
+    lines.push(`);`);
+    lines.push(``);
+    lines.push(`registerRoot(_RemotionRoot);`);
+    lines.push(``);
+    return lines.join("\n");
+}
+/** Convert a filesystem path to posix separators (for webpack imports). */
+function toPosix(fsPath) {
+    return fsPath.split(posix.sep === "/" ? /\\/ : /[\\/]/).join("/");
+}
+//# sourceMappingURL=generate-entry.js.map

package/src/render/generate-entry.js.map

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

package/src/render/generate-entry.ts

@@ -0,0 +1,155 @@
+import { posix } from "node:path";
+
+/**
+ * Inputs required to generate a Remotion entry file for a scenario.
+ *
+ * All paths are absolute filesystem paths. The generator converts them
+ * to posix-style forward-slash paths suitable for webpack imports.
+ */
+export interface EntryGeneratorInput {
+  /** Absolute path to the scenario directory (e.g. /proj/scenarios/my-tour). */
+  scenarioDir: string;
+  /** Absolute path to the file that exports renderStep. */
+  renderFilePath: string;
+  /** Scenario ID derived from the directory basename. */
+  scenarioId: string;
+  /** Whether the scenario has a narration manifest. */
+  hasNarration: boolean;
+  /** Absolute path to the providers file, or null if none found. */
+  providersPath: string | null;
+  fps: number;
+  width: number;
+  height: number;
+  compositionId: string;
+}
+
+/**
+ * Produce the TypeScript source for a Remotion entry file that renders
+ * a single scenario.
+ *
+ * The output is a self-contained `index.tsx` that can be passed to
+ * `@remotion/bundler.bundle({ entryPoint })`. All imports use absolute
+ * paths so the file works from any temp directory.
+ *
+ * The steps file may export the steps array under any name (e.g.
+ * `awsConnectionTourSteps`). Rather than guessing the export name,
+ * the generated entry uses a namespace import and duck-types the array
+ * at module-evaluation time — the same heuristic the CLI's own
+ * `loadStepsFromTs` uses.
+ *
+ * This is a pure function with no side effects — callers write the
+ * result to disk and manage cleanup.
+ */
+export function generateRemotionEntry(input: EntryGeneratorInput): string {
+  const scenarioPath = toPosix(input.scenarioDir);
+  const stepsImport = `${scenarioPath}/steps`;
+  const renderImport = toPosix(input.renderFilePath).replace(/\.[^.]+$/, "");
+
+  const lines: string[] = [];
+
+  // --- Imports ---
+
+  lines.push(`import { registerRoot } from "remotion";`);
+  lines.push(`import { Composition, AbsoluteFill } from "remotion";`);
+  lines.push(
+    `import { ScenarioComposition, calculateScenarioTimeline } from "@scenar/remotion";`,
+  );
+  lines.push(`import { renderStep } from ${JSON.stringify(renderImport)};`);
+  lines.push(`import * as _stepsModule from ${JSON.stringify(stepsImport)};`);
+
+  if (input.hasNarration) {
+    const manifestPath = `${scenarioPath}/narration/manifest.json`;
+    lines.push(`import _manifest from ${JSON.stringify(manifestPath)};`);
+  } else {
+    lines.push(`const _manifest = undefined;`);
+  }
+
+  if (input.providersPath) {
+    const providersImport = toPosix(input.providersPath).replace(/\.[^.]+$/, "");
+    lines.push(
+      `import { PreviewProviders as _Providers } from ${JSON.stringify(providersImport)};`,
+    );
+  }
+
+  // --- Steps resolution (duck-type the first array with delayMs) ---
+
+  lines.push(``);
+  lines.push(`function _findSteps(mod: Record<string, unknown>): unknown[] {`);
+  lines.push(`  for (const val of Object.values(mod)) {`);
+  lines.push(`    if (`);
+  lines.push(`      Array.isArray(val) &&`);
+  lines.push(`      val.length > 0 &&`);
+  lines.push(`      typeof val[0] === "object" &&`);
+  lines.push(`      val[0] !== null &&`);
+  lines.push(`      "delayMs" in val[0]`);
+  lines.push(`    ) return val;`);
+  lines.push(`  }`);
+  lines.push(`  throw new Error("No steps array found in ${stepsImport.replace(/"/g, '\\"')}");`);
+  lines.push(`}`);
+  lines.push(``);
+  lines.push(`const _steps: any = _findSteps(_stepsModule as unknown as Record<string, unknown>);`);
+
+  // --- Bundle + timeline ---
+
+  lines.push(``);
+  lines.push(`const _bundle = {`);
+  lines.push(`  id: ${JSON.stringify(input.scenarioId)},`);
+  lines.push(`  steps: _steps,`);
+  lines.push(`  narrationManifest: _manifest,`);
+  lines.push(`};`);
+  lines.push(``);
+  lines.push(
+    `const _timeline = calculateScenarioTimeline(_bundle.steps, _bundle.narrationManifest, ${input.fps});`,
+  );
+
+  // --- Video root component ---
+
+  lines.push(``);
+  lines.push(`function _VideoRoot() {`);
+
+  if (input.providersPath) {
+    lines.push(`  return (`);
+    lines.push(`    <AbsoluteFill>`);
+    lines.push(`      <_Providers>`);
+    lines.push(`        <ScenarioComposition bundle={_bundle}>`);
+    lines.push(`          {(data: any, stepIndex: number) => renderStep(data, stepIndex)}`);
+    lines.push(`        </ScenarioComposition>`);
+    lines.push(`      </_Providers>`);
+    lines.push(`    </AbsoluteFill>`);
+    lines.push(`  );`);
+  } else {
+    lines.push(`  return (`);
+    lines.push(`    <AbsoluteFill>`);
+    lines.push(`      <ScenarioComposition bundle={_bundle}>`);
+    lines.push(`        {(data: any, stepIndex: number) => renderStep(data, stepIndex)}`);
+    lines.push(`      </ScenarioComposition>`);
+    lines.push(`    </AbsoluteFill>`);
+    lines.push(`  );`);
+  }
+
+  lines.push(`}`);
+
+  // --- Composition registration ---
+
+  lines.push(``);
+  lines.push(`const _RemotionRoot = () => (`);
+  lines.push(`  <Composition`);
+  lines.push(`    id=${JSON.stringify(input.compositionId)}`);
+  lines.push(`    component={_VideoRoot}`);
+  lines.push(`    fps={${input.fps}}`);
+  lines.push(`    width={${input.width}}`);
+  lines.push(`    height={${input.height}}`);
+  lines.push(`    durationInFrames={_timeline.durationInFrames}`);
+  lines.push(`  />`);
+  lines.push(`);`);
+  lines.push(``);
+  lines.push(`registerRoot(_RemotionRoot);`);
+  lines.push(``);
+
+  return lines.join("\n");
+}
+
+/** Convert a filesystem path to posix separators (for webpack imports). */
+function toPosix(fsPath: string): string {
+  return fsPath.split(posix.sep === "/" ? /\\/ : /[\\/]/).join("/");
+}

package/src/render/resolve-providers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Walk up from `startDir` looking for `.scenar/providers.tsx`.
+ *
+ * Returns the absolute path if found, or `null` if the filesystem
+ * root is reached without finding it. Stops at the filesystem root
+ * to avoid scanning outside the project.
+ */
+export declare function resolveProvidersPath(startDir: string): Promise<string | null>;
+//# sourceMappingURL=resolve-providers.d.ts.map

package/src/render/resolve-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-providers.d.ts","sourceRoot":"","sources":["../../../src/render/resolve-providers.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB"}

package/src/render/resolve-providers.js

@@ -0,0 +1,32 @@
+import { access } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+const PROVIDERS_FILENAME = "providers.tsx";
+const SCENAR_DIR = ".scenar";
+/**
+ * Walk up from `startDir` looking for `.scenar/providers.tsx`.
+ *
+ * Returns the absolute path if found, or `null` if the filesystem
+ * root is reached without finding it. Stops at the filesystem root
+ * to avoid scanning outside the project.
+ */
+export async function resolveProvidersPath(startDir) {
+    let current = resolve(startDir);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const candidate = join(current, SCENAR_DIR, PROVIDERS_FILENAME);
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Not found at this level — move up.
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            // Reached filesystem root.
+            return null;
+        }
+        current = parent;
+    }
+}
+//# sourceMappingURL=resolve-providers.js.map

package/src/render/resolve-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-providers.js","sourceRoot":"","sources":["../../../src/render/resolve-providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAC3C,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB;IAEhB,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhC,iDAAiD;IACjD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,2BAA2B;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC"}

package/src/render/resolve-providers.ts

@@ -0,0 +1,36 @@
+import { access } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+
+const PROVIDERS_FILENAME = "providers.tsx";
+const SCENAR_DIR = ".scenar";
+
+/**
+ * Walk up from `startDir` looking for `.scenar/providers.tsx`.
+ *
+ * Returns the absolute path if found, or `null` if the filesystem
+ * root is reached without finding it. Stops at the filesystem root
+ * to avoid scanning outside the project.
+ */
+export async function resolveProvidersPath(
+  startDir: string,
+): Promise<string | null> {
+  let current = resolve(startDir);
+
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    const candidate = join(current, SCENAR_DIR, PROVIDERS_FILENAME);
+    try {
+      await access(candidate);
+      return candidate;
+    } catch {
+      // Not found at this level — move up.
+    }
+
+    const parent = dirname(current);
+    if (parent === current) {
+      // Reached filesystem root.
+      return null;
+    }
+    current = parent;
+  }
+}