@elaraai/e3-ui-cli 1.0.28

package/dist/app/assets/index-CYR-0Grb.css

@@ -0,0 +1 @@
+@font-face{font-family:DM Sans Variable;font-style:normal;font-display:swap;font-weight:100 1000;src:url(./dm-sans-latin-ext-wght-normal-BOFOeGcA.woff2) format("woff2-variations");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:DM Sans Variable;font-style:normal;font-display:swap;font-weight:100 1000;src:url(./dm-sans-latin-wght-normal-Xz1IZZA0.woff2) format("woff2-variations");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-cyrillic-ext-wght-normal-okcGN4Nq.woff2) format("woff2-variations");unicode-range:U+0460-052F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-cyrillic-wght-normal-BS41q_Tv.woff2) format("woff2-variations");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-greek-ext-wght-normal-DQgQPNk4.woff2) format("woff2-variations");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-greek-wght-normal-sS1B39LI.woff2) format("woff2-variations");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-vietnamese-wght-normal-TKKdAiBA.woff2) format("woff2-variations");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-latin-ext-wght-normal-B4u9PlvR.woff2) format("woff2-variations");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter Tight Variable;font-style:normal;font-display:swap;font-weight:100 900;src:url(./inter-tight-latin-wght-normal-DX-nOvPD.woff2) format("woff2-variations");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(data:font/woff2;base64,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) format("woff2-variations");unicode-range:U+0460-052F,U+1C80-1C8A,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(./jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2) format("woff2-variations");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(./jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2) format("woff2-variations");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(./jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2) format("woff2-variations");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(./jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2) format("woff2-variations");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:JetBrains Mono Variable;font-style:normal;font-display:swap;font-weight:100 800;src:url(./jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2) format("woff2-variations");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}

package/dist/app/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>e3-ui shot</title>
+  <script type="module" crossorigin src="./assets/index-30g1JIHt.js"></script>
+  <link rel="stylesheet" crossorigin href="./assets/index-CYR-0Grb.css">
+</head>
+<body>
+    <div id="root"></div>
+</body>
+</html>

package/dist/browser.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { type Browser } from 'playwright-core';
+/** The env vars honored as an explicit browser override, in precedence order. */
+export declare const BROWSER_ENV_VARS: readonly ["E3_UI_CHROMIUM_PATH", "PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH"];
+/**
+ * Return the explicit browser override from the environment, if any.
+ *
+ * @param env - Environment to read (injectable for tests)
+ * @returns The overriding executable path, or `null` when unset
+ */
+export declare function envBrowserPath(env?: NodeJS.ProcessEnv): string | null;
+/**
+ * Candidate system-browser executables for a platform, most-preferred first.
+ *
+ * @param platform - `process.platform` value (injectable for tests)
+ * @param env - Environment for Windows `%ProgramFiles%`-style roots
+ * @returns Absolute candidate paths (existence NOT yet checked)
+ */
+export declare function systemBrowserCandidates(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string[];
+/**
+ * Whether a candidate is a real browser binary rather than Ubuntu's snap shim.
+ * Rejects a path whose realpath resolves under `/snap/`, or whose file starts
+ * with `#!` (`/usr/bin/chromium-browser` on Ubuntu is a `#!/bin/sh` script
+ * that execs the confined snap — useless for automation).
+ *
+ * @param executablePath - Existing candidate path to vet
+ * @returns True when the candidate is launchable
+ */
+export declare function isRealBrowserBinary(executablePath: string): boolean;
+/**
+ * Find the first usable system browser.
+ *
+ * @param platform - `process.platform` value (injectable for tests)
+ * @param env - Environment for Windows roots
+ * @returns The executable path, or `null` when none is usable
+ */
+export declare function findSystemBrowser(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string | null;
+/** How the launched browser was obtained (surfaced by `doctor` and errors). */
+export type BrowserSource = {
+    kind: 'env';
+    executablePath: string;
+} | {
+    kind: 'managed';
+} | {
+    kind: 'system';
+    executablePath: string;
+};
+/** One-line remediation block shared by the launch error and `doctor`. */
+export declare function launchRemediation(): string;
+/**
+ * Launch headless Chromium via the acquisition cascade.
+ *
+ * @param env - Environment to read overrides from (injectable for tests)
+ * @returns The browser plus which source of the cascade provided it
+ * @throws When no browser can be launched; the message carries the full
+ *   remediation (install-browser / E3_UI_CHROMIUM_PATH / doctor)
+ */
+export declare function launchBrowser(env?: NodeJS.ProcessEnv): Promise<{
+    browser: Browser;
+    source: BrowserSource;
+}>;
+/**
+ * Download the version-matched `chromium-headless-shell` into playwright's
+ * managed cache (honors `PLAYWRIGHT_BROWSERS_PATH`), by spawning the bundled
+ * playwright-core CLI: `install --only-shell chromium`. The shell build is the
+ * one a bare headless launch selects, and is ~100 MB lighter than full
+ * Chromium with no X11/D-Bus system libraries.
+ *
+ * @param opts - `withDeps` also installs OS packages (Linux only; skipped with
+ *   a note elsewhere — Windows/macOS need no system libraries)
+ * @returns The spawned process exit code
+ */
+export declare function installBrowser(opts?: {
+    withDeps?: boolean;
+}): Promise<number>;
+/**
+ * Diagnose the browser setup: report env overrides, run the real launch
+ * cascade against `about:blank`, and print what worked — or per-OS remediation
+ * for what didn't.
+ *
+ * @param env - Environment to diagnose (injectable for tests)
+ * @returns Process exit code (0 healthy, 1 not)
+ */
+export declare function doctor(env?: NodeJS.ProcessEnv): Promise<number>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAMzD,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,yEAA0E,CAAC;AAExG;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAMlF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,EAAE,CA8BV;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAcnE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,GAAG,IAAI,CAKf;AAED,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,0EAA0E;AAC1E,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAsCtD;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAevF;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlF"}

package/dist/browser.js

@@ -0,0 +1,249 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Browser acquisition and launch for headless capture.
+ *
+ * The launch cascade (in order):
+ *   1. `E3_UI_CHROMIUM_PATH` / `PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH` — an
+ *      explicit executable wins outright.
+ *   2. A bare `chromium.launch({ headless: true })` — playwright-core resolves
+ *      its own managed cache (the `chromium-headless-shell` build installed by
+ *      `e3-ui install-browser`, or a full build; honors
+ *      `PLAYWRIGHT_BROWSERS_PATH`). `chromium.executablePath()` must NEVER be
+ *      fed back into `launch()` here: it always names the FULL chromium
+ *      binary, which does not exist after an `--only-shell` install.
+ *   3. A system-installed Chromium-family browser, per platform — skipping
+ *      Ubuntu's snap shims (`/usr/bin/chromium-browser` is a shell script that
+ *      execs the confined snap, which breaks automation).
+ *
+ * Sandboxing: playwright launches Chromium with `--no-sandbox` by default
+ * (`chromiumSandbox` defaults to false) — correct for rendering trusted local
+ * components, and why running as root just works.
+ *
+ * @packageDocumentation
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { existsSync, openSync, readSync, closeSync, realpathSync } from 'node:fs';
+import * as path from 'node:path';
+import { chromium } from 'playwright-core';
+/** Chromium args shared by every launch — `--disable-gpu` matches the in-repo
+ *  snapshot pipeline so CLI captures are pixel-comparable with it. */
+const LAUNCH_ARGS = ['--disable-gpu'];
+/** The env vars honored as an explicit browser override, in precedence order. */
+export const BROWSER_ENV_VARS = ['E3_UI_CHROMIUM_PATH', 'PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH'];
+/**
+ * Return the explicit browser override from the environment, if any.
+ *
+ * @param env - Environment to read (injectable for tests)
+ * @returns The overriding executable path, or `null` when unset
+ */
+export function envBrowserPath(env = process.env) {
+    for (const name of BROWSER_ENV_VARS) {
+        const value = env[name];
+        if (value)
+            return value;
+    }
+    return null;
+}
+/**
+ * Candidate system-browser executables for a platform, most-preferred first.
+ *
+ * @param platform - `process.platform` value (injectable for tests)
+ * @param env - Environment for Windows `%ProgramFiles%`-style roots
+ * @returns Absolute candidate paths (existence NOT yet checked)
+ */
+export function systemBrowserCandidates(platform = process.platform, env = process.env) {
+    switch (platform) {
+        case 'linux':
+            return [
+                '/opt/google/chrome/chrome',
+                '/usr/bin/google-chrome-stable',
+                '/usr/bin/google-chrome',
+                '/usr/bin/chromium',
+                '/usr/bin/chromium-browser',
+            ];
+        case 'darwin':
+            return [
+                '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+                '/Applications/Chromium.app/Contents/MacOS/Chromium',
+                '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+            ];
+        case 'win32': {
+            const roots = [
+                env['ProgramFiles'],
+                env['ProgramFiles(x86)'],
+                env['LocalAppData'],
+            ].filter((r) => !!r);
+            return [
+                ...roots.map(r => path.join(r, 'Google', 'Chrome', 'Application', 'chrome.exe')),
+                ...roots.map(r => path.join(r, 'Microsoft', 'Edge', 'Application', 'msedge.exe')),
+            ];
+        }
+        default:
+            return [];
+    }
+}
+/**
+ * Whether a candidate is a real browser binary rather than Ubuntu's snap shim.
+ * Rejects a path whose realpath resolves under `/snap/`, or whose file starts
+ * with `#!` (`/usr/bin/chromium-browser` on Ubuntu is a `#!/bin/sh` script
+ * that execs the confined snap — useless for automation).
+ *
+ * @param executablePath - Existing candidate path to vet
+ * @returns True when the candidate is launchable
+ */
+export function isRealBrowserBinary(executablePath) {
+    try {
+        if (realpathSync(executablePath).split(path.sep).includes('snap'))
+            return false;
+        const fd = openSync(executablePath, 'r');
+        try {
+            const head = Buffer.alloc(2);
+            const n = readSync(fd, head, 0, 2, 0);
+            return !(n === 2 && head[0] === 0x23 && head[1] === 0x21); // "#!"
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find the first usable system browser.
+ *
+ * @param platform - `process.platform` value (injectable for tests)
+ * @param env - Environment for Windows roots
+ * @returns The executable path, or `null` when none is usable
+ */
+export function findSystemBrowser(platform = process.platform, env = process.env) {
+    for (const candidate of systemBrowserCandidates(platform, env)) {
+        if (existsSync(candidate) && isRealBrowserBinary(candidate))
+            return candidate;
+    }
+    return null;
+}
+/** One-line remediation block shared by the launch error and `doctor`. */
+export function launchRemediation() {
+    return (`  - Run \`e3-ui install-browser\` to download a version-matched headless Chromium` +
+        ` (add --with-deps on a fresh Linux server to also install system libraries).\n` +
+        `  - Or set E3_UI_CHROMIUM_PATH to a Chrome/Chromium/Edge executable` +
+        ` (not Ubuntu's snap chromium — its confinement breaks automation).\n` +
+        `  - Run \`e3-ui doctor\` for a full diagnosis.`);
+}
+/**
+ * Launch headless Chromium via the acquisition cascade.
+ *
+ * @param env - Environment to read overrides from (injectable for tests)
+ * @returns The browser plus which source of the cascade provided it
+ * @throws When no browser can be launched; the message carries the full
+ *   remediation (install-browser / E3_UI_CHROMIUM_PATH / doctor)
+ */
+export async function launchBrowser(env = process.env) {
+    const override = envBrowserPath(env);
+    if (override) {
+        try {
+            const browser = await chromium.launch({ headless: true, executablePath: override, args: LAUNCH_ARGS });
+            return { browser, source: { kind: 'env', executablePath: override } };
+        }
+        catch (err) {
+            throw new Error(`Could not launch the browser set by ${BROWSER_ENV_VARS.find(v => env[v]) ?? BROWSER_ENV_VARS[0]} ` +
+                `(${override}): ${firstLine(err)}\n${launchRemediation()}`);
+        }
+    }
+    let managedError;
+    try {
+        const browser = await chromium.launch({ headless: true, args: LAUNCH_ARGS });
+        return { browser, source: { kind: 'managed' } };
+    }
+    catch (err) {
+        managedError = err;
+    }
+    const system = findSystemBrowser();
+    if (system) {
+        try {
+            const browser = await chromium.launch({ headless: true, executablePath: system, args: LAUNCH_ARGS });
+            return { browser, source: { kind: 'system', executablePath: system } };
+        }
+        catch (err) {
+            throw new Error(`No managed browser (${firstLine(managedError)}), and the system browser at ${system} ` +
+                `failed to launch: ${firstLine(err)}\n${launchRemediation()}`);
+        }
+    }
+    throw new Error(`Could not launch headless Chromium: ${firstLine(managedError)}\n${launchRemediation()}`);
+}
+function firstLine(err) {
+    return (err instanceof Error ? err.message : String(err)).split('\n')[0] ?? 'unknown error';
+}
+/**
+ * Download the version-matched `chromium-headless-shell` into playwright's
+ * managed cache (honors `PLAYWRIGHT_BROWSERS_PATH`), by spawning the bundled
+ * playwright-core CLI: `install --only-shell chromium`. The shell build is the
+ * one a bare headless launch selects, and is ~100 MB lighter than full
+ * Chromium with no X11/D-Bus system libraries.
+ *
+ * @param opts - `withDeps` also installs OS packages (Linux only; skipped with
+ *   a note elsewhere — Windows/macOS need no system libraries)
+ * @returns The spawned process exit code
+ */
+export async function installBrowser(opts = {}) {
+    // playwright-core exports no `./cli` subpath — resolve cli.js at the
+    // package root via the always-exported package.json.
+    const require = createRequire(import.meta.url);
+    const cliJs = path.join(path.dirname(require.resolve('playwright-core/package.json')), 'cli.js');
+    const withDeps = (opts.withDeps ?? false) && process.platform === 'linux';
+    if (opts.withDeps && !withDeps) {
+        console.log('(--with-deps is only needed on Linux — skipped.)');
+    }
+    const args = [cliJs, 'install', '--only-shell', ...(withDeps ? ['--with-deps'] : []), 'chromium'];
+    const child = spawn(process.execPath, args, { stdio: 'inherit' });
+    return await new Promise((resolve, reject) => {
+        child.on('error', reject);
+        child.on('exit', code => resolve(code ?? 1));
+    });
+}
+/**
+ * Diagnose the browser setup: report env overrides, run the real launch
+ * cascade against `about:blank`, and print what worked — or per-OS remediation
+ * for what didn't.
+ *
+ * @param env - Environment to diagnose (injectable for tests)
+ * @returns Process exit code (0 healthy, 1 not)
+ */
+export async function doctor(env = process.env) {
+    for (const name of BROWSER_ENV_VARS) {
+        console.log(`${name}: ${env[name] ?? '(unset)'}`);
+    }
+    console.log(`PLAYWRIGHT_BROWSERS_PATH: ${env['PLAYWRIGHT_BROWSERS_PATH'] ?? '(default cache)'}`);
+    let result;
+    try {
+        result = await launchBrowser(env);
+    }
+    catch (err) {
+        console.error(`\nBrowser launch: FAILED\n${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    try {
+        const page = await result.browser.newPage();
+        await page.goto('about:blank');
+        const version = result.browser.version();
+        const source = result.source.kind === 'managed'
+            ? 'playwright-managed cache'
+            : `${result.source.kind === 'env' ? 'env override' : 'system browser'} at ${result.source.executablePath}`;
+        console.log(`\nBrowser launch: OK (Chromium ${version}, ${source})`);
+        console.log('e3-ui shot is ready to render.');
+        return 0;
+    }
+    catch (err) {
+        console.error(`\nBrowser launched but failed to open a page: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    finally {
+        await result.browser.close();
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAEzD;sEACsE;AACtE,MAAM,WAAW,GAAG,CAAC,eAAe,CAAC,CAAC;AAEtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,qBAAqB,EAAE,qCAAqC,CAAU,CAAC;AAExG;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC/D,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACnC,WAA4B,OAAO,CAAC,QAAQ,EAC5C,MAAyB,OAAO,CAAC,GAAG;IAEpC,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,OAAO;YACR,OAAO;gBACH,2BAA2B;gBAC3B,+BAA+B;gBAC/B,wBAAwB;gBACxB,mBAAmB;gBACnB,2BAA2B;aAC9B,CAAC;QACN,KAAK,QAAQ;YACT,OAAO;gBACH,8DAA8D;gBAC9D,oDAAoD;gBACpD,gEAAgE;aACnE,CAAC;QACN,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,KAAK,GAAG;gBACV,GAAG,CAAC,cAAc,CAAC;gBACnB,GAAG,CAAC,mBAAmB,CAAC;gBACxB,GAAG,CAAC,cAAc,CAAC;aACtB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,OAAO;gBACH,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;gBAChF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;aACpF,CAAC;QACN,CAAC;QACD;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,cAAsB;IACtD,IAAI,CAAC;QACD,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAChF,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO;QACtE,CAAC;gBAAS,CAAC;YACP,SAAS,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC7B,WAA4B,OAAO,CAAC,QAAQ,EAC5C,MAAyB,OAAO,CAAC,GAAG;IAEpC,KAAK,MAAM,SAAS,IAAI,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7D,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,mBAAmB,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAQD,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB;IAC7B,OAAO,CACH,mFAAmF;QACnF,gFAAgF;QAChF,qEAAqE;QACrE,sEAAsE;QACtE,gDAAgD,CACnD,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,QAAQ,EAAE,CAAC;QACX,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACvG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACX,uCAAuC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG;gBACnG,IAAI,QAAQ,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,iBAAiB,EAAE,EAAE,CAC7D,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,YAAqB,CAAC;IAC1B,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,YAAY,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACrG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACX,uBAAuB,SAAS,CAAC,YAAY,CAAC,gCAAgC,MAAM,GAAG;gBACvF,qBAAqB,SAAS,CAAC,GAAG,CAAC,KAAK,iBAAiB,EAAE,EAAE,CAChE,CAAC;QACN,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CACX,uCAAuC,SAAS,CAAC,YAAY,CAAC,KAAK,iBAAiB,EAAE,EAAE,CAC3F,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC3B,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC;AAChG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA+B,EAAE;IAClE,qEAAqE;IACrE,qDAAqD;IACrD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC1E,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,6BAA6B,GAAG,CAAC,0BAA0B,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAEjG,IAAI,MAAmD,CAAC;IACxD,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACb,CAAC;IACD,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;YAC3C,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC/G,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,iDAAiD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnH,OAAO,CAAC,CAAC;IACb,CAAC;YAAS,CAAC;QACP,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;AACL,CAAC"}

package/dist/capture.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 { ShotPayload } from './payload.js';
+/** Default capture parameters — single source of truth (CLI help text in
+ *  `cli.ts` documents these values; keep them in sync). */
+export declare const CAPTURE_DEFAULTS: {
+    readonly viewport: {
+        readonly width: 1280;
+        readonly height: 900;
+    };
+    readonly deviceScaleFactor: 2;
+    readonly settleMs: 300;
+    readonly timeoutMs: 30000;
+    readonly storageKey: "shot";
+    readonly statusPollMs: 100;
+    readonly skeletonPollMs: 200;
+    readonly errorTextLimit: 600;
+};
+/** How the screenshot is framed. */
+export type CaptureMode = {
+    kind: 'frame';
+} | {
+    kind: 'full-page';
+} | {
+    kind: 'element';
+    selector: string;
+};
+/** Options for a single capture. */
+export interface CaptureOptions {
+    /** Directory of the prebuilt app bundle (the built `dist/app`). */
+    appDir: string;
+    /** The render payload (base64 IR). */
+    payload: ShotPayload;
+    /** Output PNG path. */
+    outPng: string;
+    /** When set, also write a self-contained HTML snapshot here. */
+    outHtml?: string | undefined;
+    /** Storage key prefix for persisted component state. */
+    storageKey?: string;
+    /** Chromium viewport. Default 1280×900. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Device scale factor (DPR). Default 2. */
+    deviceScaleFactor?: number;
+    /** Framing. Default `{ kind: 'frame' }`. */
+    mode?: CaptureMode;
+    /** Grace period (ms) after skeletons clear before capture. Default 300. */
+    settleMs?: number;
+    /** Per-navigation timeout (ms). Default 30000. */
+    timeoutMs?: number;
+}
+/** Serve the prebuilt app directory over a random localhost port. */
+/**
+ * Resolve a URL pathname to a file within `root`, or `null` if it would escape
+ * (path traversal). Uses a separator-boundary check so a sibling dir sharing the
+ * root's prefix cannot pass. Exported for unit tests.
+ */
+export declare function resolveWithinRoot(root: string, urlPathname: string): string | null;
+/** Escape text for safe inclusion in HTML. Exported for unit tests. */
+export declare function escapeHtml(s: string): string;
+/**
+ * Inline `url(...woff2)` font references in CSS as base64 data URIs (read from
+ * the app's built `assets/`), so the standalone HTML renders with the brand
+ * fonts over `file://` with no server. A font that cannot be read is left as its
+ * original (server-relative) URL and a warning is emitted — a silently broken
+ * `--html` is worse than a visible warning. Exported for unit tests.
+ */
+export declare function inlineFonts(css: string, appDir: string): Promise<string>;
+/**
+ * Render a component payload to a PNG (and optionally a standalone HTML).
+ *
+ * @param opts - Capture options
+ * @throws If the app reports a compile/render error, or capture times out
+ */
+export declare function capture(opts: CaptureOptions): Promise<void>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;2DAC2D;AAC3D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CASnB,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,WAAW,GACjB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC3B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAgBD,qEAAqE;AACrE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlF;AA8BD,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB9E;AA4CD;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqHjE"}