@elaraai/e3-ui-cli 1.0.28 → 1.0.29

package/dist/detect.js

@@ -0,0 +1,187 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * IR-level renderability detection (#225): decide what an export IS from its
+ * East IR, never by duck-typed try-render-and-see.
+ *
+ * A render candidate is a **zero-input** East function whose declared output
+ * type is a subtype of `UIComponentType`, established with east's own type
+ * machinery (`isSubtypeValue` / `toEastTypeValue`). The function body is then
+ * walked (`walkIR`) for platform calls: workspace-backed calls (`data_*`,
+ * `func_*`, `record_*` — reads that need a deployed e3 workspace) make the
+ * export NOT standalone-renderable, while browser-local platforms (`state_*`,
+ * nav, overlays, …) render at initial state.
+ *
+ * Both `@elaraai/east` and `@elaraai/east-ui` are resolved **from the target
+ * project** (the swept source file), not from this CLI: the loaded module
+ * already runs against the project's own east instance (see
+ * `load-source.ts`'s externalize plugin), so the IR, the type values, and the
+ * comparison machinery all share one origin. Structural type comparison makes
+ * this safe even across duplicated east installs.
+ *
+ * @packageDocumentation
+ */
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import * as path from 'node:path';
+import { shapeOfExport } from './load-source.js';
+/** Render a {@link SkipReason} as one human line (shared by sweep + shot). */
+export function describeSkip(skip) {
+    switch (skip.kind) {
+        case 'not-a-component': return skip.detail;
+        case 'has-inputs': return `takes ${skip.count} input(s) — only zero-input functions render standalone`;
+        case 'wrong-output': return `output type is ${skip.output}, not UIComponentType`;
+        case 'parameterized-ui-task': return 'a ui() task with compute-time inputs — render it from a deployed workspace: e3-ui shot --from-task <ws.task> --repo <path>';
+        case 'workspace-bound': return `reads e3 workspace data (${skip.platforms.join(', ')}) — use --from-task against a deployed repo`;
+        case 'ir-error': return `could not analyze IR: ${skip.detail}`;
+    }
+}
+/** e3-ui platform-name prefixes that require a live e3 workspace. Everything
+ *  else (`state_*`, `nav_*`, overlay/slice/clipboard/…) is browser-local and
+ *  renders standalone at initial state. */
+const WORKSPACE_PLATFORM_PREFIXES = ['data_', 'func_', 'record_'];
+/** Import a package **from the target project's resolution scope** (the same
+ *  single-instance trick `load-source.ts` plays for the loaded module). */
+async function importFromProject(sourceFile, spec) {
+    try {
+        const req = createRequire(path.resolve(sourceFile));
+        const resolved = req.resolve(spec);
+        return await import(pathToFileURL(resolved).href);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the detection context for a source file, resolving `@elaraai/east` and
+ * `@elaraai/east-ui` from the project.
+ *
+ * @param sourceFile - A file inside the target project (resolution anchor)
+ * @returns The context, or null when the project has no resolvable `@elaraai/east`
+ */
+export async function detectContextFor(sourceFile) {
+    const east = await importFromProject(sourceFile, '@elaraai/east');
+    if (east === null)
+        return null;
+    const eastUi = await importFromProject(sourceFile, '@elaraai/east-ui');
+    const uiComponentType = eastUi?.['UIComponentType'];
+    const eastModule = east;
+    return {
+        east: eastModule,
+        uiComponentTypeValue: uiComponentType === undefined ? null : eastModule.toEastTypeValue(uiComponentType),
+    };
+}
+/** The `Function` IR node's payload, extracted defensively (IR nodes are East
+ *  variant containers: `{ type: tag, value }`). */
+function functionIrPayload(ir) {
+    if (typeof ir !== 'object' || ir === null)
+        return null;
+    const node = ir;
+    if (node.type !== 'Function')
+        return null;
+    const value = node.value;
+    if (value === undefined || !Array.isArray(value.parameters))
+        return null;
+    return { parameters: value.parameters, typeValue: value.type };
+}
+/** The declared output `EastTypeValue` of a `Function` IR's `FunctionType`. */
+function outputTypeValue(fnTypeValue) {
+    if (typeof fnTypeValue !== 'object' || fnTypeValue === null)
+        return undefined;
+    const t = fnTypeValue;
+    if (t.type !== 'Function')
+        return undefined;
+    return t.value?.output;
+}
+/** A short printable name for an `EastTypeValue` (its variant tag). */
+function typeTag(typeValue) {
+    if (typeof typeValue === 'string')
+        return typeValue;
+    if (typeof typeValue === 'object' && typeValue !== null) {
+        const tag = typeValue.type;
+        if (typeof tag === 'string')
+            return tag;
+    }
+    return 'unknown';
+}
+/** Collect the platform-call names in a function IR via the project's `walkIR`. */
+function platformCallNames(east, ir) {
+    const names = new Set();
+    east.walkIR(ir, (node) => {
+        const n = node;
+        if (n.type === 'Platform') {
+            const name = n.value?.name;
+            if (typeof name === 'string')
+                names.add(name);
+        }
+    });
+    return [...names].sort();
+}
+/**
+ * Classify ONE export value: shape, renderability, and (when renderable) its
+ * East function.
+ *
+ * @param name - The export name (for reporting)
+ * @param value - The exported value
+ * @param ctx - The project-resolved detection context
+ * @returns The classification (never throws — IR problems become `ir-error` skips)
+ */
+export function classifyExport(name, value, ctx) {
+    const shaped = shapeOfExport(value);
+    if (shaped === null) {
+        return { name, shape: null, renderable: false, skip: { kind: 'not-a-component', detail: 'not an East function, example(), or ui() task' } };
+    }
+    if (shaped.fn === null) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'parameterized-ui-task' } };
+    }
+    let ir;
+    try {
+        const bundle = shaped.fn.toIR();
+        // `toIR()` yields an `EastIR` wrapper (its `.ir` is the Function node) —
+        // except the ui() task unwrap, whose stored bundle IS the wrapper too.
+        ir = typeof bundle === 'object' && bundle !== null && 'ir' in bundle ? bundle.ir : bundle;
+    }
+    catch (err) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'ir-error', detail: err instanceof Error ? err.message : String(err) } };
+    }
+    const fnIr = functionIrPayload(ir);
+    if (fnIr === null) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'ir-error', detail: 'toIR() did not yield a (sync) Function IR' } };
+    }
+    if (fnIr.parameters.length > 0) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'has-inputs', count: fnIr.parameters.length } };
+    }
+    const output = outputTypeValue(fnIr.typeValue);
+    if (ctx.uiComponentTypeValue === null) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'wrong-output', output: `${typeTag(output)} (and the project does not depend on @elaraai/east-ui)` } };
+    }
+    let isUi;
+    try {
+        isUi = output !== undefined && ctx.east.isSubtypeValue(output, ctx.uiComponentTypeValue);
+    }
+    catch (err) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'ir-error', detail: err instanceof Error ? err.message : String(err) } };
+    }
+    if (!isUi) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'wrong-output', output: typeTag(output) } };
+    }
+    const workspaceBound = platformCallNames(ctx.east, ir)
+        .filter(n => WORKSPACE_PLATFORM_PREFIXES.some(p => n.startsWith(p)));
+    if (workspaceBound.length > 0) {
+        return { name, shape: shaped.shape, renderable: false, skip: { kind: 'workspace-bound', platforms: workspaceBound } };
+    }
+    return { name, shape: shaped.shape, renderable: true, fn: shaped.fn };
+}
+/**
+ * Classify every export of a loaded module.
+ *
+ * @param moduleExports - The module's exports (from `loadSourceExports`)
+ * @param ctx - The project-resolved detection context
+ * @returns One classification per export, in export order
+ */
+export function classifyExports(moduleExports, ctx) {
+    return Object.entries(moduleExports).map(([name, value]) => classifyExport(name, value, ctx));
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/index.d.ts

@@ -10,8 +10,10 @@
  */
 export { renderToPng, renderTaskToPng, defaultAppDir, type RenderToPngOptions, type RenderTaskOptions } from './render.js';
 export { buildPayload, detectFormat, type ShotInput, type ShotPayload, type ComponentPayload, type TaskPayload, type InputFormat, } from './payload.js';
-export { capture, type CaptureOptions, type CaptureMode } from './capture.js';
-export { loadComponentFromSource, type EastFunctionLike } from './load-source.js';
+export { capture, openCaptureSession, type CaptureSession, type SessionCaptureOptions, type CaptureOptions, type CaptureMode } from './capture.js';
+export { sweep, isSweepableSource, outputStemFor, type SweepOptions, type SweepResult, type SweepRendered, type SweepSkipped, type SweepFailed } from './sweep.js';
+export { classifyExport, classifyExports, detectContextFor, describeSkip, type DetectContext, type ExportClassification, type SkipReason } from './detect.js';
+export { loadComponentFromSource, loadSourceExports, shapeOfExport, type ExportShape, type EastFunctionLike } from './load-source.js';
 export { startRepoServer, type RepoServerHandle } from './e3-server.js';
 export { launchBrowser, installBrowser, doctor, type BrowserSource } from './browser.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3H,OAAO,EACH,YAAY,EAAE,YAAY,EAC1B,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,GAC9F,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3H,OAAO,EACH,YAAY,EAAE,YAAY,EAC1B,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,GAC9F,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACnJ,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACnK,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9J,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtI,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -10,8 +10,10 @@
  */
 export { renderToPng, renderTaskToPng, defaultAppDir } from './render.js';
 export { buildPayload, detectFormat, } from './payload.js';
-export { capture } from './capture.js';
-export { loadComponentFromSource } from './load-source.js';
+export { capture, openCaptureSession } from './capture.js';
+export { sweep, isSweepableSource, outputStemFor } from './sweep.js';
+export { classifyExport, classifyExports, detectContextFor, describeSkip } from './detect.js';
+export { loadComponentFromSource, loadSourceExports, shapeOfExport } from './load-source.js';
 export { startRepoServer } from './e3-server.js';
 export { launchBrowser, installBrowser, doctor } from './browser.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAmD,MAAM,aAAa,CAAC;AAC3H,OAAO,EACH,YAAY,EAAE,YAAY,GAE7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAyC,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAyB,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAsB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAmD,MAAM,aAAa,CAAC;AAC3H,OAAO,EACH,YAAY,EAAE,YAAY,GAE7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAA0F,MAAM,cAAc,CAAC;AACnJ,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAgG,MAAM,YAAY,CAAC;AACnK,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAkE,MAAM,aAAa,CAAC;AAC9J,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAA2C,MAAM,kBAAkB,CAAC;AACtI,OAAO,EAAE,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAsB,MAAM,cAAc,CAAC"}

package/dist/load-source.d.ts

@@ -7,6 +7,50 @@
 export interface EastFunctionLike {
     toIR(): unknown;
 }
+/** An exported `example({ fn })` definition wrapping an East function. */
+interface ExampleDefLike {
+    fn: EastFunctionLike;
+}
+/** Does `x` carry a `toIR()` (the minimal East-function contract)? */
+export declare function hasToIR(x: unknown): x is EastFunctionLike;
+/** Is `x` an `example({ fn })` definition wrapping an East function? */
+export declare function isExampleDef(x: unknown): x is ExampleDefLike;
+/** Structural shape of an e3 `ui()` task definition. The original East
+ *  function is not retained on the TaskDef — `task()` eagerly stores
+ *  `fn.toIR()` (the full EastIR bundle, source map included) as the default of
+ *  its first input dataset, named `function_ir`. Purely structural so this
+ *  package needs no runtime dependency on `@elaraai/e3` / `@elaraai/e3-ui`.
+ *  `TaskDef.command` is ALSO an EastIR (the argv builder) — never unwrap that. */
+interface UiTaskDefLike {
+    kind: 'task';
+    taskKind: 'ui';
+    inputs: Array<{
+        name?: unknown;
+        default?: unknown;
+    }>;
+}
+/** Is `x` (structurally) an e3 `ui()` task definition? */
+export declare function isUiTaskDef(x: unknown): x is UiTaskDefLike;
+/** How an export carries its East function — the three renderable shapes. */
+export type ExportShape = 'function' | 'example' | 'ui-task';
+/** Identify an export's shape and pull out its East function, without judging
+ *  renderability (that is `classifyExports`' job — IR-level, in `detect.ts`).
+ *  A parameterized `ui()` task reports its shape with `fn: null`. */
+export declare function shapeOfExport(value: unknown): {
+    shape: ExportShape;
+    fn: EastFunctionLike | null;
+} | null;
+/**
+ * Transpile and execute a `.ts`/`.tsx` source in memory, returning its module
+ * exports. **Runs the file and its imports as Node code** — only point it at
+ * code you trust. The building block under {@link loadComponentFromSource}
+ * (single export) and the `shots` sweep (all exports).
+ *
+ * @param filePath - Path to the source file
+ * @returns The executed module's exports
+ * @throws If the file does not exist, esbuild fails, or executing the module throws
+ */
+export declare function loadSourceExports(filePath: string): Promise<Record<string, unknown>>;
 /**
  * Transpile, execute, and extract an East UI function from a `.ts`/`.tsx` source.
  *
@@ -18,4 +62,5 @@ export interface EastFunctionLike {
  *   or not renderable
  */
 export declare function loadComponentFromSource(filePath: string, exportName?: string): Promise<EastFunctionLike>;
+export {};
 //# sourceMappingURL=load-source.d.ts.map

package/dist/load-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-source.d.ts","sourceRoot":"","sources":["../src/load-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;iFACiF;AACjF,MAAM,WAAW,gBAAgB;IAC7B,IAAI,IAAI,OAAO,CAAC;CACnB;AAoFD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAsE3B"}
+{"version":3,"file":"load-source.d.ts","sourceRoot":"","sources":["../src/load-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;iFACiF;AACjF,MAAM,WAAW,gBAAgB;IAC7B,IAAI,IAAI,OAAO,CAAC;CACnB;AAED,0EAA0E;AAC1E,UAAU,cAAc;IACpB,EAAE,EAAE,gBAAgB,CAAC;CACxB;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB,CAGzD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAE5D;AAED;;;;;kFAKkF;AAClF,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAQ1D;AAED,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D;;qEAEqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAWxG;AAgDD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+B1F;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAwC3B"}

package/dist/load-source.js

@@ -21,14 +21,17 @@ import { pathToFileURL } from 'node:url';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import * as esbuild from 'esbuild';
-function hasToIR(x) {
+/** Does `x` carry a `toIR()` (the minimal East-function contract)? */
+export function hasToIR(x) {
     return (typeof x === 'function' || (typeof x === 'object' && x !== null))
         && typeof x.toIR === 'function';
 }
-function isExampleDef(x) {
+/** Is `x` an `example({ fn })` definition wrapping an East function? */
+export function isExampleDef(x) {
     return typeof x === 'object' && x !== null && hasToIR(x.fn);
 }
-function isUiTaskDef(x) {
+/** Is `x` (structurally) an e3 `ui()` task definition? */
+export function isUiTaskDef(x) {
     if (typeof x !== 'object' || x === null)
         return false;
     const t = x;
@@ -38,6 +41,23 @@ function isUiTaskDef(x) {
         && t.inputs[0]?.name === 'function_ir'
         && t.inputs[0].default != null;
 }
+/** Identify an export's shape and pull out its East function, without judging
+ *  renderability (that is `classifyExports`' job — IR-level, in `detect.ts`).
+ *  A parameterized `ui()` task reports its shape with `fn: null`. */
+export function shapeOfExport(value) {
+    if (hasToIR(value))
+        return { shape: 'function', fn: value };
+    if (isExampleDef(value))
+        return { shape: 'example', fn: value.fn };
+    if (isUiTaskDef(value)) {
+        if (value.inputs.length === 1) {
+            const bundle = value.inputs[0].default;
+            return { shape: 'ui-task', fn: { toIR: () => bundle } };
+        }
+        return { shape: 'ui-task', fn: null };
+    }
+    return null;
+}
 const PARAMETERIZED_UI_TASK_MESSAGE = `it is a ui() task with compute-time inputs, which a standalone render cannot supply — ` +
     `render it from a deployed workspace instead: e3-ui shot --from-task <workspace>.<task> --repo <path>`;
 /**
@@ -87,16 +107,16 @@ const externalizeBareImports = {
     },
 };
 /**
- * Transpile, execute, and extract an East UI function from a `.ts`/`.tsx` source.
+ * Transpile and execute a `.ts`/`.tsx` source in memory, returning its module
+ * exports. **Runs the file and its imports as Node code** — only point it at
+ * code you trust. The building block under {@link loadComponentFromSource}
+ * (single export) and the `shots` sweep (all exports).
  *
  * @param filePath - Path to the source file
- * @param exportName - Named export to render; when omitted, falls back to the
- *   `default` export, then to the sole renderable export
- * @returns The East function (carrying `toIR()`)
- * @throws If the file produces no renderable export, or `exportName` is absent
- *   or not renderable
+ * @returns The executed module's exports
+ * @throws If the file does not exist, esbuild fails, or executing the module throws
  */
-export async function loadComponentFromSource(filePath, exportName) {
+export async function loadSourceExports(filePath) {
     const absolutePath = path.resolve(filePath);
     if (!fs.existsSync(absolutePath)) {
         throw new Error(`Source file not found: ${absolutePath}`);
@@ -116,14 +136,26 @@ export async function loadComponentFromSource(filePath, exportName) {
     if (!code) {
         throw new Error(`esbuild produced no output for ${filePath}`);
     }
-    let moduleExports;
     try {
         const dataUrl = `data:text/javascript;base64,${Buffer.from(code).toString('base64')}`;
-        moduleExports = await import(dataUrl);
+        return await import(dataUrl);
     }
     catch (err) {
         throw new Error(`Failed to execute ${path.basename(filePath)}: ${err instanceof Error ? err.message : String(err)}`);
     }
+}
+/**
+ * Transpile, execute, and extract an East UI function from a `.ts`/`.tsx` source.
+ *
+ * @param filePath - Path to the source file
+ * @param exportName - Named export to render; when omitted, falls back to the
+ *   `default` export, then to the sole renderable export
+ * @returns The East function (carrying `toIR()`)
+ * @throws If the file produces no renderable export, or `exportName` is absent
+ *   or not renderable
+ */
+export async function loadComponentFromSource(filePath, exportName) {
+    const moduleExports = await loadSourceExports(filePath);
     if (exportName !== undefined) {
         const fn = asEastFunction(moduleExports[exportName]);
         if (!fn) {

package/dist/load-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-source.js","sourceRoot":"","sources":["../src/load-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAanC,SAAS,OAAO,CAAC,CAAU;IACvB,OAAO,CAAC,OAAO,CAAC,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;WAClE,OAAQ,CAAwB,CAAC,IAAI,KAAK,UAAU,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAE,CAAsB,CAAC,EAAE,CAAC,CAAC;AACtF,CAAC;AAcD,SAAS,WAAW,CAAC,CAAU;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA6D,CAAC;IACxE,OAAO,CAAC,CAAC,IAAI,KAAK,MAAM;WACjB,CAAC,CAAC,QAAQ,KAAK,IAAI;WACnB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;WACtB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAoC,EAAE,IAAI,KAAK,aAAa;WACtE,CAAC,CAAC,MAAM,CAAC,CAAC,CAA2B,CAAC,OAAO,IAAI,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,6BAA6B,GAC/B,wFAAwF;IACxF,sGAAsG,CAAC;AAE3G;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,KAAc;IAClC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,EAAE,CAAC;IACzC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,sBAAsB,GAAmB;IAC3C,IAAI,EAAE,0BAA0B;IAChC,KAAK,CAAC,KAAK;QACP,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE;YACrC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,sBAAsB;YACtF,gEAAgE;YAChE,IAAI,CAAC;gBACD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC5D,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAClE,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,IAAI,CAAC,CAAC,2CAA2C;YAC5D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,QAAgB,EAChB,UAAmB;IAEnB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;QAC/B,WAAW,EAAE,CAAC,YAAY,CAAC;QAC3B,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,WAAW;QAChB,eAAe,EAAE,kBAAkB;QACnC,OAAO,EAAE,CAAC,sBAAsB,CAAC;QACjC,QAAQ,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,aAAsC,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,+BAA+B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtF,aAAa,GAAG,MAAM,MAAM,CAAC,OAAO,CAA4B,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACX,qBAAqB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtG,CAAC;IACN,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,cAAc,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,EAAE,CAAC;YACN,IAAI,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,6BAA6B,EAAE,CAAC,CAAC;YAC5H,CAAC;YACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,IAAI,KAAK,CACX,WAAW,UAAU,6CAA6C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;gBAC5F,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAC/F,CAAC;QACN,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7D,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,CAAU,CAAC;SAC9D,MAAM,CAAC,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAE5E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,aAAa,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,6BAA6B,EAAE,CAAC,CAAC;QAClI,CAAC;QACD,MAAM,IAAI,KAAK,CACX,2CAA2C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI;YACtE,qFAAqF,CACxF,CAAC;IACN,CAAC;IACD,MAAM,IAAI,KAAK,CACX,kCAAkC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,2BAA2B;QACpF,cAAc,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxD,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,aAAsC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"load-source.js","sourceRoot":"","sources":["../src/load-source.ts"],"names":[],"mappings":"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"}

package/dist/render.d.ts

@@ -29,6 +29,8 @@ export interface RenderToPngOptions {
     timeoutMs?: number | undefined;
     /** Storage key prefix for persisted component state. */
     storageKey?: string | undefined;
+    /** Component-frame mount width ('full' or a CSS width) — see CaptureOptions. */
+    frameWidth?: string | undefined;
 }
 /** Resolve the shipped prebuilt app directory (`dist/app`, sibling of this module). */
 export declare function defaultAppDir(): string;

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAgB,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGzD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,SAAS,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,eAAe;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,uFAAuF;AACvF,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAczE;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAC9B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,eAAe;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5E"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAgB,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGzD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,SAAS,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,eAAe;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,uFAAuF;AACvF,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAC9B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,eAAe;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5E"}

package/dist/render.js

@@ -35,6 +35,7 @@ export async function renderToPng(opts) {
         viewport: opts.viewport,
         deviceScaleFactor: opts.deviceScaleFactor,
         mode: opts.mode,
+        frameWidth: opts.frameWidth,
         settleMs: opts.settleMs,
         timeoutMs: opts.timeoutMs,
     });

package/dist/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAoC,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA0BjD,uFAAuF;AACvF,MAAM,UAAU,aAAa;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAwB;IACtD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE;QACtC,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC5B,CAAC,CAAC;AACP,CAAC;AA4BD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IACzD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,MAAM,OAAO,GAAgB;YACzB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;QACF,MAAM,OAAO,CAAC;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE;YACtC,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,mEAAmE;YACnE,gEAAgE;YAChE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;YAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;AACL,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAoC,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4BjD,uFAAuF;AACvF,MAAM,UAAU,aAAa;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAwB;IACtD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE;QACtC,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC5B,CAAC,CAAC;AACP,CAAC;AA4BD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IACzD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC;QACD,MAAM,OAAO,GAAgB;YACzB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;QACF,MAAM,OAAO,CAAC;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE;YACtC,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,mEAAmE;YACnE,gEAAgE;YAChE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;YAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/sweep.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { type SessionCaptureOptions } from './capture.js';
+/** One rendered export. */
+export interface SweepRendered {
+    file: string;
+    exportName: string;
+    png: string;
+    html?: string | undefined;
+}
+/** One skipped export (or a whole file that failed to load/classify). */
+export interface SweepSkipped {
+    file: string;
+    /** Absent for file-level skips (load errors, no detect context). */
+    exportName?: string | undefined;
+    reason: string;
+}
+/** One render FAILURE (a classified-renderable export whose capture threw). */
+export interface SweepFailed {
+    file: string;
+    exportName: string;
+    error: string;
+}
+/** The sweep outcome. `failed.length > 0` should exit non-zero. */
+export interface SweepResult {
+    rendered: SweepRendered[];
+    skipped: SweepSkipped[];
+    failed: SweepFailed[];
+}
+/** Options for {@link sweep}. */
+export interface SweepOptions {
+    /** Files or directories to sweep (directories recurse). Default: `src`. */
+    paths?: string[];
+    /** Base directory for discovery + relative output layout. Default: cwd. */
+    cwd?: string;
+    /** Output directory. Default: `.shots`. */
+    outDir?: string;
+    /** Also write a standalone HTML beside each PNG. */
+    html?: boolean;
+    /** Also write `<outDir>/manifest.json` describing the sweep. */
+    json?: boolean;
+    /** Component-frame mount width. Default `'full'` — width-flexible
+     *  components render faithfully; pass `undefined` explicitly via the CLI's
+     *  `--frame-width none` for the historical shrink-to-fit crop. */
+    frameWidth?: string | undefined;
+    /** Chromium viewport. */
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    /** Device scale factor. */
+    deviceScaleFactor?: number | undefined;
+    /** Settle time after skeletons clear (ms). */
+    settleMs?: number | undefined;
+    /** Per-capture timeout (ms). */
+    timeoutMs?: number | undefined;
+    /** Override the prebuilt app directory. */
+    appDir?: string | undefined;
+    /** Progress/summary sink. Default `console.log`. */
+    log?: (line: string) => void;
+    /** Render override for tests: receives each candidate's capture options.
+     *  When set, no browser session is opened. */
+    render?: (opts: SessionCaptureOptions) => Promise<void>;
+}
+/** Is `file` a sweepable TS/TSX source (not a spec, not a declaration)? */
+export declare function isSweepableSource(file: string): boolean;
+/** The output basename (no extension) for a swept file, relative to `cwd` —
+ *  `src/ui/index.tsx` → `src/ui/index`. Paths outside `cwd` fall back to a
+ *  flattened basename. */
+export declare function outputStemFor(file: string, cwd: string): string;
+/**
+ * Sweep `paths` and render every renderable UI export.
+ *
+ * @param opts - Sweep options
+ * @returns The sweep outcome (rendered / skipped / failed)
+ * @throws If the browser session cannot be opened (no browser installed)
+ */
+export declare function sweep(opts?: SweepOptions): Promise<SweepResult>;
+//# sourceMappingURL=sweep.d.ts.map

package/dist/sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../src/sweep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAI9E,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IACzB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;sEAEkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oDAAoD;IACpD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;kDAC8C;IAC9C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AA0BD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED;;0BAE0B;AAC1B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiGzE"}