@elaraai/e3-ui-cli 1.0.28

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Programmatic API for `@elaraai/e3-ui-cli` — render east-ui / e3-ui components
+ * to PNG without the CLI. The command-line entry lives in `cli.ts`.
+ *
+ * @packageDocumentation
+ */
+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 { 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

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Programmatic API for `@elaraai/e3-ui-cli` — render east-ui / e3-ui components
+ * to PNG without the CLI. The command-line entry lives in `cli.ts`.
+ *
+ * @packageDocumentation
+ */
+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 { startRepoServer } from './e3-server.js';
+export { launchBrowser, installBrowser, doctor } from './browser.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/load-source.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Minimal shape of an East function — anything carrying a `toIR()`. East
+ *  functions are callable, so they are `typeof === 'function'`, not 'object'. */
+export interface EastFunctionLike {
+    toIR(): unknown;
+}
+/**
+ * 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 declare function loadComponentFromSource(filePath: string, exportName?: string): Promise<EastFunctionLike>;
+//# sourceMappingURL=load-source.d.ts.map

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

@@ -0,0 +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"}

package/dist/load-source.js

@@ -0,0 +1,163 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Load an East UI function from a TypeScript/TSX source file — without writing
+ * any temp files.
+ *
+ * esbuild transpiles + bundles the entry IN MEMORY, then it is executed via a
+ * `data:` URL `import()`. Bare `@elaraai/*` (and other package) imports are
+ * resolved from the source file to absolute `file://` URLs and kept external,
+ * so the East runtime the source imports is the SAME instance this CLI encodes
+ * with (single-instance type identity matters for IR serialization) and nothing
+ * is ever written to disk. JSX is forced to the automatic `@elaraai/east-ui`
+ * runtime, matching how east-ui components are authored.
+ *
+ * @packageDocumentation
+ */
+import { createRequire } from 'node:module';
+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) {
+    return (typeof x === 'function' || (typeof x === 'object' && x !== null))
+        && typeof x.toIR === 'function';
+}
+function isExampleDef(x) {
+    return typeof x === 'object' && x !== null && hasToIR(x.fn);
+}
+function isUiTaskDef(x) {
+    if (typeof x !== 'object' || x === null)
+        return false;
+    const t = x;
+    return t.kind === 'task'
+        && t.taskKind === 'ui'
+        && Array.isArray(t.inputs)
+        && t.inputs[0]?.name === 'function_ir'
+        && t.inputs[0].default != 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>`;
+/**
+ * Pull the East function out of an export: a bare fn, an `example()` def, or a
+ * zero-input e3 `ui()` task (unwrapped to its stored `fn.toIR()` bundle). A
+ * ui() task WITH compute-time inputs (`inputs.length > 1` — inputs[0] is
+ * always the function_ir dataset) is not renderable standalone; callers
+ * surface {@link PARAMETERIZED_UI_TASK_MESSAGE} for those.
+ */
+function asEastFunction(value) {
+    if (hasToIR(value))
+        return value;
+    if (isExampleDef(value))
+        return value.fn;
+    if (isUiTaskDef(value) && value.inputs.length === 1) {
+        const bundle = value.inputs[0].default;
+        return { toIR: () => bundle };
+    }
+    return null;
+}
+/**
+ * esbuild plugin: keep every bare (package) import external, resolved from its
+ * importer to an absolute `file://` URL so the `data:`-URL bundle can load it
+ * with Node's own resolver (preserving a single `@elaraai/east` instance).
+ * Relative/absolute source imports are bundled normally.
+ */
+const externalizeBareImports = {
+    name: 'externalize-bare-imports',
+    setup(build) {
+        build.onResolve({ filter: /.*/ }, args => {
+            if (args.kind === 'entry-point')
+                return null;
+            const spec = args.path;
+            if (spec.startsWith('node:'))
+                return { path: spec, external: true };
+            if (spec.startsWith('.') || path.isAbsolute(spec))
+                return null; // bundle source files
+            // Bare package import → resolve from the importer, externalize.
+            try {
+                const resolved = createRequire(args.importer).resolve(spec);
+                return { path: pathToFileURL(resolved).href, external: true };
+            }
+            catch {
+                return null; // let esbuild surface the resolution error
+            }
+        });
+    },
+};
+/**
+ * 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 absolutePath = path.resolve(filePath);
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`Source file not found: ${absolutePath}`);
+    }
+    const result = await esbuild.build({
+        entryPoints: [absolutePath],
+        bundle: true,
+        platform: 'node',
+        format: 'esm',
+        write: false,
+        jsx: 'automatic',
+        jsxImportSource: '@elaraai/east-ui',
+        plugins: [externalizeBareImports],
+        logLevel: 'silent',
+    });
+    const code = result.outputFiles?.[0]?.text;
+    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);
+    }
+    catch (err) {
+        throw new Error(`Failed to execute ${path.basename(filePath)}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (exportName !== undefined) {
+        const fn = asEastFunction(moduleExports[exportName]);
+        if (!fn) {
+            if (isUiTaskDef(moduleExports[exportName])) {
+                throw new Error(`Cannot render export "${exportName}" in ${path.basename(filePath)}: ${PARAMETERIZED_UI_TASK_MESSAGE}`);
+            }
+            const available = renderableExportNames(moduleExports);
+            throw new Error(`Export "${exportName}" is not a renderable East UI function in ${path.basename(filePath)}.` +
+                (available.length ? ` Available: ${available.join(', ')}` : ' No renderable exports found.'));
+        }
+        return fn;
+    }
+    const fromDefault = asEastFunction(moduleExports['default']);
+    if (fromDefault)
+        return fromDefault;
+    const renderable = Object.entries(moduleExports)
+        .map(([name, value]) => [name, asEastFunction(value)])
+        .filter((e) => e[1] !== null);
+    if (renderable.length === 1)
+        return renderable[0][1];
+    if (renderable.length === 0) {
+        const parameterized = Object.entries(moduleExports).find(([, v]) => isUiTaskDef(v));
+        if (parameterized) {
+            throw new Error(`Cannot render export "${parameterized[0]}" in ${path.basename(filePath)}: ${PARAMETERIZED_UI_TASK_MESSAGE}`);
+        }
+        throw new Error(`No renderable East UI function found in ${path.basename(filePath)}. ` +
+            `Export a default East function returning a UIComponentType (or an example({ fn })).`);
+    }
+    throw new Error(`Multiple renderable exports in ${path.basename(filePath)} — pass --export <name>. ` +
+        `Available: ${renderable.map(([n]) => n).join(', ')}`);
+}
+function renderableExportNames(moduleExports) {
+    return Object.entries(moduleExports)
+        .filter(([, value]) => asEastFunction(value) !== null)
+        .map(([name]) => name);
+}
+//# sourceMappingURL=load-source.js.map

package/dist/load-source.js.map

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

package/dist/payload.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export type { ComponentPayload, TaskPayload, ShotPayload } from './shot-payload.js';
+import type { ComponentPayload } from './shot-payload.js';
+/** Recognised input formats. `ts` covers `.ts` and `.tsx`. */
+export type InputFormat = 'ts' | 'beast2' | 'json';
+/** A resolved component input. `path: null` reads from stdin. */
+export interface ShotInput {
+    path: string | null;
+    from?: InputFormat | undefined;
+    exportName?: string | undefined;
+}
+/** Detect the input format from a file extension. */
+export declare function detectFormat(filePath: string): InputFormat;
+/**
+ * Build the render payload from a component input.
+ *
+ * @param input - The resolved input (path/format/export)
+ * @returns The base64 IR payload for the browser app
+ * @throws If a `.ts`/`.tsx` source is read from stdin, on JSON/IR decode
+ *   failure, or when the input is not a renderable East UI function
+ */
+export declare function buildPayload(input: ShotInput): Promise<ComponentPayload>;
+//# sourceMappingURL=payload.d.ts.map

package/dist/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ1D;AASD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyC9E"}

package/dist/payload.js

@@ -0,0 +1,87 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Normalise a component input into the render payload the browser app consumes.
+ *
+ * Every accepted input is reduced to Beast2-encoded **function IR** (base64) —
+ * the exact form `EncodedEastFunction` (`@elaraai/east-ui-components`) decodes
+ * via `decodeBeast2For(IRType)` and compiles in-browser. The Node→browser
+ * serialization boundary decouples the two `@elaraai/east` instances.
+ *
+ * Format is auto-detected from the file extension (mirroring `e3 convert` /
+ * `e3 dataset set`), with an explicit `--from` override.
+ *
+ * @packageDocumentation
+ */
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { encodeEastIR, fromJSONFor, decodeEastIR, encodeBeast2For } from '@elaraai/east';
+import { IRType } from '@elaraai/east/internal';
+import { loadComponentFromSource } from './load-source.js';
+/** Detect the input format from a file extension. */
+export function detectFormat(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (ext === '.ts' || ext === '.tsx')
+        return 'ts';
+    if (ext === '.beast2')
+        return 'beast2';
+    if (ext === '.json')
+        return 'json';
+    throw new Error(`Cannot detect format from extension "${ext}" (expected .ts/.tsx, .beast2, or .json) — pass --from`);
+}
+/** Read all of stdin as bytes. */
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return new Uint8Array(Buffer.concat(chunks));
+}
+/**
+ * Build the render payload from a component input.
+ *
+ * @param input - The resolved input (path/format/export)
+ * @returns The base64 IR payload for the browser app
+ * @throws If a `.ts`/`.tsx` source is read from stdin, on JSON/IR decode
+ *   failure, or when the input is not a renderable East UI function
+ */
+export async function buildPayload(input) {
+    const format = input.from ?? (input.path ? detectFormat(input.path) : 'beast2');
+    let bytes;
+    switch (format) {
+        case 'ts': {
+            if (!input.path) {
+                throw new Error('A TypeScript source cannot be read from stdin — pass a file path.');
+            }
+            const fn = await loadComponentFromSource(input.path, input.exportName);
+            bytes = encodeEastIR(fn.toIR());
+            break;
+        }
+        case 'beast2': {
+            bytes = input.path ? new Uint8Array(await readFile(input.path)) : await readStdin();
+            break;
+        }
+        case 'json': {
+            const text = input.path
+                ? await readFile(input.path, 'utf8')
+                : Buffer.from(await readStdin()).toString('utf8');
+            bytes = encodeBeast2For(IRType)(fromJSONFor(IRType)(JSON.parse(text)));
+            break;
+        }
+    }
+    // Uniform validation across all three formats: decodeEastIR throws unless the
+    // root IR is a (sync) Function — catching an async function, non-function IR
+    // JSON, and an evaluated-value / corrupt .beast2 alike, with one clear Node-side
+    // message instead of a confusing in-browser compile failure.
+    try {
+        decodeEastIR(bytes);
+    }
+    catch (err) {
+        throw new Error(`Input is not a renderable component — expected a Beast2/JSON-encoded zero-argument East UI function. ` +
+            `(Async functions, non-function IR, and evaluated values are not supported.) ` +
+            `Cause: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { kind: 'component', b64: Buffer.from(bytes).toString('base64') };
+}
+//# sourceMappingURL=payload.js.map

package/dist/payload.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { type ShotInput } from './payload.js';
+import { type CaptureMode } from './capture.js';
+/** Options for {@link renderToPng}. */
+export interface RenderToPngOptions {
+    /** The component input (source/serialized + format/export). */
+    input: ShotInput;
+    /** Output PNG path. */
+    output: string;
+    /** Also write a self-contained HTML here. */
+    html?: string | undefined;
+    /** Override the prebuilt app directory (defaults to the shipped `dist/app`). */
+    appDir?: string | undefined;
+    /** Chromium viewport. */
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    /** Device scale factor. */
+    deviceScaleFactor?: number | undefined;
+    /** Framing. */
+    mode?: CaptureMode | undefined;
+    /** Settle time after skeletons clear. */
+    settleMs?: number | undefined;
+    /** Max time to wait for the render to complete. */
+    timeoutMs?: number | undefined;
+    /** Storage key prefix for persisted component state. */
+    storageKey?: string | undefined;
+}
+/** Resolve the shipped prebuilt app directory (`dist/app`, sibling of this module). */
+export declare function defaultAppDir(): string;
+/**
+ * Render a component input to a PNG (and optionally a standalone HTML).
+ *
+ * @param opts - Render options
+ * @throws If the input cannot be decoded, or the component fails to render
+ */
+export declare function renderToPng(opts: RenderToPngOptions): Promise<void>;
+/** Options for {@link renderTaskToPng}. */
+export interface RenderTaskOptions {
+    /** Local e3 repository directory. */
+    repo: string;
+    /** Workspace name. */
+    workspace: string;
+    /** Task name within the workspace. */
+    task: string;
+    /** Output PNG path. */
+    output: string;
+    /** Also write a self-contained HTML here. */
+    html?: string | undefined;
+    /** Override the prebuilt app directory. */
+    appDir?: string | undefined;
+    /** Chromium viewport. */
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    /** Device scale factor. */
+    deviceScaleFactor?: number | undefined;
+    /** Framing. */
+    mode?: CaptureMode | undefined;
+    /** Settle time (defaults higher than component mode — the task must fetch). */
+    settleMs?: number | undefined;
+    /** Max time to wait for the task to render (drives the in-app hard-stop too). */
+    timeoutMs?: number | undefined;
+}
+/**
+ * Render a LIVE e3 task's output to a PNG. Starts a local e3 API server over
+ * the repo, lets the browser app fetch the already-computed task output + bound
+ * datasets, screenshots, and stops the server. The workspace dataflow must have
+ * already produced the task's output.
+ *
+ * @param opts - Render options
+ * @throws If the server cannot start, the task fails to render, or capture times out
+ */
+export declare function renderTaskToPng(opts: RenderTaskOptions): Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +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"}

package/dist/render.js

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Programmatic entry point: normalise an input into a payload and capture it to
+ * a PNG. The CLI's `shot` command is a thin wrapper over {@link renderToPng}.
+ *
+ * @packageDocumentation
+ */
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildPayload } from './payload.js';
+import { capture } from './capture.js';
+import { startRepoServer } from './e3-server.js';
+/** Resolve the shipped prebuilt app directory (`dist/app`, sibling of this module). */
+export function defaultAppDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, 'app');
+}
+/**
+ * Render a component input to a PNG (and optionally a standalone HTML).
+ *
+ * @param opts - Render options
+ * @throws If the input cannot be decoded, or the component fails to render
+ */
+export async function renderToPng(opts) {
+    const payload = await buildPayload(opts.input);
+    await capture({
+        appDir: opts.appDir ?? defaultAppDir(),
+        payload,
+        outPng: opts.output,
+        outHtml: opts.html,
+        storageKey: opts.storageKey,
+        viewport: opts.viewport,
+        deviceScaleFactor: opts.deviceScaleFactor,
+        mode: opts.mode,
+        settleMs: opts.settleMs,
+        timeoutMs: opts.timeoutMs,
+    });
+}
+/**
+ * Render a LIVE e3 task's output to a PNG. Starts a local e3 API server over
+ * the repo, lets the browser app fetch the already-computed task output + bound
+ * datasets, screenshots, and stops the server. The workspace dataflow must have
+ * already produced the task's output.
+ *
+ * @param opts - Render options
+ * @throws If the server cannot start, the task fails to render, or capture times out
+ */
+export async function renderTaskToPng(opts) {
+    const server = await startRepoServer(opts.repo);
+    try {
+        const payload = {
+            kind: 'task',
+            apiUrl: server.apiUrl,
+            repo: server.repo,
+            workspace: opts.workspace,
+            task: opts.task,
+        };
+        await capture({
+            appDir: opts.appDir ?? defaultAppDir(),
+            payload,
+            outPng: opts.output,
+            outHtml: opts.html,
+            viewport: opts.viewport,
+            deviceScaleFactor: opts.deviceScaleFactor,
+            mode: opts.mode,
+            // Extra grace after the app reports ready (the task render settles
+            // its own async fetches first via the data-shot-status marker).
+            settleMs: opts.settleMs ?? 800,
+            timeoutMs: opts.timeoutMs,
+        });
+    }
+    finally {
+        await server.stop();
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +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"}

package/dist/shot-payload.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The render payload injected into the browser app as `window.__E3_UI_SHOT__`.
+ *
+ * This module has NO runtime imports so it can be shared by both the Node CLI
+ * (`payload.ts`) and the browser app (`app/main.tsx`) — keeping the Node→browser
+ * contract type-checked rather than duplicated.
+ *
+ * @packageDocumentation
+ */
+/** A standalone component to render: base64 Beast2-encoded function IR
+ *  (consumed in-browser by `EncodedEastFunction`). */
+export interface ComponentPayload {
+    kind: 'component';
+    b64: string;
+}
+/** A live e3 task to render: the browser fetches its already-computed output +
+ *  bound datasets from the server (consumed by `TaskPreview`). */
+export interface TaskPayload {
+    kind: 'task';
+    apiUrl: string;
+    repo: string;
+    workspace: string;
+    task: string;
+}
+/** The render payload — a component or a live task. */
+export type ShotPayload = ComponentPayload | TaskPayload;
+//# sourceMappingURL=shot-payload.d.ts.map

package/dist/shot-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-payload.d.ts","sourceRoot":"","sources":["../src/shot-payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH;sDACsD;AACtD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED;kEACkE;AAClE,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAC"}

package/dist/shot-payload.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=shot-payload.js.map

package/dist/shot-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-payload.js","sourceRoot":"","sources":["../src/shot-payload.ts"],"names":[],"mappings":"AAAA;;;GAGG"}