@yali-engine/cli 0.0.0-stage → 0.4.0

package/bin/yali.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// The `yali` command. Workspace packages export TypeScript sources, which Node 22 loads only
+// with --experimental-strip-types (ADR-0027), so this re-runs the CLI under that flag.
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+// In the workspace: the TypeScript source; published (no src): the built JS.
+const source = fileURLToPath(new URL('../src/main.ts', import.meta.url));
+const main = existsSync(source) ? source : fileURLToPath(new URL('../dist/main.js', import.meta.url));
+const r = spawnSync(process.execPath, ['--experimental-strip-types', '--no-warnings', main, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(r.status ?? 1);

package/dist/budgets.d.ts

@@ -0,0 +1,25 @@
+/** The budgets the CLI checks (a subset of the engine's `budgets.json`). */
+export interface Budgets {
+    readonly size_brotli_kb: {
+        /** What a single-threaded page loads (ADR-0106: in this repo, the engine's reference page). */
+        readonly core_runtime_total: number;
+        /** What a threaded page loads (ADR-0106; default: `core_runtime_total`). */
+        readonly core_runtime_threaded?: number;
+        readonly core_wasm: number;
+        /**
+         * Capability fallbacks (ADR-0106): a JS chunk whose file name starts with a key is one only
+         * some devices load (the WebGL2 backend), gated against its own KB and left out of the totals.
+         */
+        readonly fallback_chunks?: Readonly<Record<string, number>>;
+    };
+    readonly frame_ms: {
+        readonly desktop: number;
+    };
+}
+/** The engine's own budgets (DESIGN.md §21), used when a project has no `budgets.json`. */
+export declare const DEFAULT_BUDGETS: Budgets;
+/** The nearest `budgets.json` at or above `root`, merged over the defaults. */
+export declare function loadBudgets(root: string): {
+    budgets: Budgets;
+    file: string | null;
+};

package/dist/budgets.js

@@ -0,0 +1,27 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** The engine's own budgets (DESIGN.md §21), used when a project has no `budgets.json`. */
+export const DEFAULT_BUDGETS = {
+    // ADR-0106: the threaded page and the WebGL2 fallback have budgets of their own.
+    size_brotli_kb: { core_runtime_total: 200, core_runtime_threaded: 210, core_wasm: 100, fallback_chunks: { webgl2: 22 } },
+    frame_ms: { desktop: 16.6 },
+};
+/** The nearest `budgets.json` at or above `root`, merged over the defaults. */
+export function loadBudgets(root) {
+    for (let dir = root;; dir = dirname(dir)) {
+        const f = join(dir, 'budgets.json');
+        if (existsSync(f)) {
+            const raw = JSON.parse(readFileSync(f, 'utf8'));
+            return {
+                budgets: {
+                    size_brotli_kb: { ...DEFAULT_BUDGETS.size_brotli_kb, ...raw.size_brotli_kb },
+                    frame_ms: { ...DEFAULT_BUDGETS.frame_ms, ...raw.frame_ms },
+                },
+                file: f,
+            };
+        }
+        if (dirname(dir) === dir)
+            return { budgets: DEFAULT_BUDGETS, file: null };
+    }
+}
+//# sourceMappingURL=budgets.js.map

package/dist/budgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../src/budgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmB1C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,iFAAiF;IACjF,cAAc,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE;IACxH,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;CAC5B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,KAAK,IAAI,GAAG,GAAG,IAAI,GAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACpC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAqB,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE;oBACP,cAAc,EAAE,EAAE,GAAG,eAAe,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,cAAc,EAAE;oBAC5E,QAAQ,EAAE,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE;iBAC3D;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/cdp.d.ts

@@ -0,0 +1,25 @@
+/** A page opened in a Chrome DevTools Protocol browser for the length of one command. */
+export interface CdpPage {
+    /** Evaluates an expression in the page (awaiting promises) and returns its JSON value. */
+    evaluate<T>(expression: string): Promise<T>;
+    /** Console errors, warnings and uncaught exceptions seen so far. */
+    readonly errors: readonly string[];
+    /** A PNG of the viewport, base64 (colour-converted by the browser: read pixels in-page). */
+    screenshot(): Promise<string>;
+    /** Reloads the page and waits for its load event. */
+    reload(): Promise<void>;
+    /** The page's current URL. */
+    readonly url: string;
+    /** Whether the connection is still open. */
+    readonly connected: boolean;
+    /** Detaches; closes the tab only if this page opened it. */
+    close(): Promise<void>;
+}
+/**
+ * Opens `url` in a new tab of the browser listening on `port` (`--remote-debugging-port`).
+ * The tab is brought to the front so its frames are not throttled. With `reuse`, an open
+ * tab already showing `url` (same origin and path) is attached instead, and left open.
+ */
+export declare function openPage(url: string, port: number, options?: {
+    reuse?: boolean;
+}): Promise<CdpPage>;

package/dist/cdp.js

@@ -0,0 +1,106 @@
+import { YaliError } from '@yali-engine/core';
+/**
+ * Opens `url` in a new tab of the browser listening on `port` (`--remote-debugging-port`).
+ * The tab is brought to the front so its frames are not throttled. With `reuse`, an open
+ * tab already showing `url` (same origin and path) is attached instead, and left open.
+ */
+export async function openPage(url, port, options = {}) {
+    let target;
+    let opened = true;
+    try {
+        const want = new URL(url);
+        const existing = options.reuse
+            ? (await (await fetch(`http://127.0.0.1:${port}/json/list`)).json()).find((t) => {
+                if (t.type !== 'page')
+                    return false;
+                try {
+                    const u = new URL(t.url);
+                    return u.origin === want.origin && u.pathname === want.pathname;
+                }
+                catch {
+                    return false;
+                }
+            })
+            : undefined;
+        if (existing) {
+            target = existing;
+            opened = false;
+        }
+        else {
+            target = await (await fetch(`http://127.0.0.1:${port}/json/new?${encodeURIComponent(url)}`, { method: 'PUT' })).json();
+        }
+    }
+    catch {
+        throw new YaliError('CDP_UNREACHABLE', `No browser answers on CDP port ${port}.`, `Start Chrome with --remote-debugging-port=${port} (and a dedicated --user-data-dir), or pass --cdp-port.`);
+    }
+    const ws = new WebSocket(target.webSocketDebuggerUrl);
+    await new Promise((resolve, reject) => {
+        ws.onopen = resolve;
+        ws.onerror = () => reject(new YaliError('CDP_UNREACHABLE', `Could not attach to the tab on CDP port ${port}.`, 'Check the browser allows remote origins (--remote-allow-origins=*).'));
+    });
+    let id = 0;
+    let connected = true;
+    ws.onclose = () => (connected = false);
+    const pending = new Map();
+    const errors = [];
+    ws.onmessage = (m) => {
+        const msg = JSON.parse(String(m.data));
+        if (msg.id && pending.has(msg.id)) {
+            pending.get(msg.id)(msg);
+            pending.delete(msg.id);
+        }
+        else if (msg.method === 'Runtime.exceptionThrown') {
+            errors.push(`exception: ${msg.params.exceptionDetails.exception?.description ?? msg.params.exceptionDetails.text}`);
+        }
+        else if (msg.method === 'Runtime.consoleAPICalled' && (msg.params.type === 'error' || msg.params.type === 'warning')) {
+            errors.push(`${msg.params.type}: ${msg.params.args.map((a) => a.value ?? a.description ?? '').join(' ')}`);
+        }
+    };
+    const send = (method, params = {}) => new Promise((resolve) => {
+        const k = ++id;
+        pending.set(k, resolve);
+        ws.send(JSON.stringify({ id: k, method, params }));
+    });
+    await send('Runtime.enable');
+    await send('Page.enable');
+    await send('Page.bringToFront');
+    return {
+        errors,
+        url: target.url || url,
+        get connected() {
+            return connected;
+        },
+        async screenshot() {
+            const r = await send('Page.captureScreenshot', { format: 'png' });
+            return r.result?.data ?? '';
+        },
+        async reload() {
+            const loaded = new Promise((resolve) => {
+                const prev = ws.onmessage;
+                ws.onmessage = (m) => {
+                    prev?.call(ws, m);
+                    if (JSON.parse(String(m.data)).method === 'Page.loadEventFired') {
+                        ws.onmessage = prev;
+                        resolve();
+                    }
+                };
+            });
+            await send('Page.reload');
+            await loaded;
+        },
+        async evaluate(expression) {
+            const r = await send('Runtime.evaluate', { expression: `(async () => JSON.stringify(await (${expression})))()`, awaitPromise: true, returnByValue: true });
+            const ex = r.result?.exceptionDetails;
+            if (ex)
+                throw new YaliError('PAGE_EVAL_FAILED', `Evaluating ${expression} in the page failed: ${ex.exception?.description ?? ex.text}`, 'Check the page exposes what the command reads (see --probe).');
+            const v = r.result?.result?.value;
+            return (typeof v === 'string' ? JSON.parse(v) : undefined);
+        },
+        async close() {
+            ws.close();
+            if (opened)
+                await fetch(`http://127.0.0.1:${port}/json/close/${target.id}`).catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=cdp.js.map

package/dist/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../src/cdp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAoB9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,UAA+B,EAAE;IACzF,IAAI,MAAiE,CAAC;IACtE,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK;YAC5B,CAAC,CAAE,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,oBAAoB,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAA+E,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3J,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,KAAK,CAAC;gBACpC,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACzB,OAAO,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;gBAClE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,QAAQ,CAAC;YAClB,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,oBAAoB,IAAI,aAAa,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CACjB,iBAAiB,EACjB,kCAAkC,IAAI,GAAG,EACzC,6CAA6C,IAAI,yDAAyD,CAC3G,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACtD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC;QACpB,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,iBAAiB,EAAE,2CAA2C,IAAI,GAAG,EAAE,qEAAqE,CAAC,CAAC,CAAC;IACzL,CAAC,CAAC,CAAC;IACH,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkK,CAAC;IAC1L,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,yBAAyB,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QACtH,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,0BAA0B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YACvH,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAA4C,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxJ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,SAAkC,EAAE,EAAE,EAAE,CACpE,IAAI,OAAO,CAA6D,CAAC,OAAO,EAAE,EAAE;QAClF,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IACL,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,MAAM,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,OAAO;QACL,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG;QACtB,IAAI,SAAS;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,UAAU;YACd,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC3C,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC;gBAC1B,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE;oBACnB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;oBAClB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,qBAAqB,EAAE,CAAC;wBAChE,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC;wBACpB,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,MAAM,MAAM,CAAC;QACf,CAAC;QACD,KAAK,CAAC,QAAQ,CAAI,UAAkB;YAClC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,sCAAsC,UAAU,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3J,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC;YACtC,IAAI,EAAE;gBAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,EAAE,cAAc,UAAU,wBAAwB,EAAE,CAAC,SAAS,EAAE,WAAW,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,8DAA8D,CAAC,CAAC;YACxM,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;YAClC,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,KAAK;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,MAAM;gBAAE,MAAM,KAAK,CAAC,oBAAoB,IAAI,eAAe,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+import { type Outcome } from './output.ts';
+/** Runs one CLI invocation and returns its outcome (exported for tests). */
+export declare function runCli(argv: readonly string[]): Promise<{
+    outcome: Outcome;
+    json: boolean;
+    keepAlive: boolean;
+}>;

package/dist/cli.js

@@ -0,0 +1,83 @@
+// `runCli`: one invocation of the `yali` command, as data (main.ts prints it).
+//
+// Exit codes: 0 ok · 1 error (the envelope says which) · 3 ran, but over a budget.
+import { parseArgs } from 'node:util';
+import { YaliError } from '@yali-engine/core';
+import { benchCommand } from "./cmd-bench.js";
+import { buildCommand } from "./cmd-build.js";
+import { convertCommand } from "./cmd-convert.js";
+import { createCommand } from "./cmd-create.js";
+import { devCommand } from "./cmd-dev.js";
+import { gameCommand } from "./cmd-game.js";
+import { headlessCommand } from "./cmd-headless.js";
+import { inspectCommand } from "./cmd-inspect.js";
+import { testCommand } from "./cmd-test.js";
+import { COMMANDS, GLOBAL_OPTIONS } from "./commands.js";
+import { failure, ok } from "./output.js";
+/** Runs one CLI invocation and returns its outcome (exported for tests). */
+export async function runCli(argv) {
+    const command = argv[0] && !argv[0].startsWith('-') ? argv[0] : 'help';
+    const spec = COMMANDS.find((c) => c.name === command);
+    const json = argv.includes('--json');
+    if (!spec) {
+        const err = new YaliError('UNKNOWN_COMMAND', `yali has no command ${command}.`, `Commands: ${COMMANDS.map((c) => c.name).join(', ')}. Run \`yali help\`.`);
+        return { outcome: failure(command, err), json, keepAlive: false };
+    }
+    try {
+        const options = {};
+        for (const o of [...spec.options, ...GLOBAL_OPTIONS])
+            options[o.name] = { type: o.type };
+        const { values, positionals } = parseArgs({ args: argv.slice(1), options, allowPositionals: true, strict: true });
+        const v = values;
+        const s = (k) => v[k];
+        switch (spec.name) {
+            case 'help':
+                return {
+                    outcome: ok('help', { commands: COMMANDS, globalOptions: GLOBAL_OPTIONS, exitCodes: { 0: 'ok', 1: 'error', 3: 'over a budget' } }, [
+                        'yali <command> [options] [--json]',
+                        '',
+                        ...COMMANDS.map((c) => `  ${c.name.padEnd(8)} ${c.summary}\n           ${c.usage}`),
+                        '',
+                        'Every command takes --json and prints one envelope { ok, command, result | error }.',
+                    ]),
+                    json,
+                    keepAlive: false,
+                };
+            case 'create':
+                return { outcome: createCommand({ dir: positionals[0], port: s('port') }), json, keepAlive: false };
+            case 'dev':
+                return { outcome: await devCommand({ root: s('root'), json }), json, keepAlive: true };
+            case 'build':
+                return { outcome: await buildCommand({ root: s('root'), json, report: v.report === true }), json, keepAlive: false };
+            case 'bench':
+                return {
+                    outcome: await benchCommand({ root: s('root'), url: s('url'), query: s('query'), seconds: s('seconds'), out: s('out'), cdpPort: s('cdp-port'), probe: s('probe') }),
+                    json,
+                    keepAlive: false,
+                };
+            case 'headless':
+                return {
+                    outcome: await headlessCommand({ root: s('root'), frames: s('frames'), seed: s('seed'), query: s('query'), recording: s('recording'), expect: s('expect') }),
+                    json,
+                    keepAlive: false,
+                };
+            case 'test':
+                return { outcome: await testCommand({ root: s('root'), files: positionals }), json, keepAlive: false };
+            case 'inspect':
+                return { outcome: await inspectCommand({ root: s('root'), live: v.live === true, url: s('url'), cdpPort: s('cdp-port'), probe: s('probe') }), json, keepAlive: false };
+            case 'game':
+                return { outcome: await gameCommand({ crate: s('crate'), out: s('out'), threads: v.threads === true, dev: v.dev === true, features: s('features'), json }), json, keepAlive: false };
+            case 'convert':
+                return { outcome: await convertCommand({ input: positionals[0], output: positionals[1], maxSize: s('max-size'), rdo: s('rdo'), collision: v.collision === true, clusters: v.clusters === true, stream: v.stream === true, pageKb: s('page-kb'), clusterMin: s('cluster-min'), json }), json, keepAlive: false };
+            default:
+                throw new YaliError('UNKNOWN_COMMAND', `Unhandled command ${spec.name}.`, 'This is a CLI bug.');
+        }
+    }
+    catch (err) {
+        const e = err instanceof TypeError && 'code' in err && String(err.code).startsWith('ERR_PARSE_ARGS')
+            ? new YaliError('BAD_OPTION', err.message, `Usage: ${spec.usage}. Run \`yali help --json\` for every option.`)
+            : err;
+        return { outcome: failure(command, e), json, keepAlive: false };
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,mFAAmF;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAgB,MAAM,aAAa,CAAC;AAExD,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAuB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,iBAAiB,EAAE,uBAAuB,OAAO,GAAG,EAAE,aAAa,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3J,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAmD,EAAE,CAAC;QACnE,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClH,MAAM,CAAC,GAAG,MAAsD,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAuB,CAAC;QACpD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,MAAM;gBACT,OAAO;oBACL,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE;wBACjI,mCAAmC;wBACnC,EAAE;wBACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC;wBACnF,EAAE;wBACF,qFAAqF;qBACtF,CAAC;oBACF,IAAI;oBACJ,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,KAAK,QAAQ;gBACX,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACtG,KAAK,KAAK;gBACR,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACzF,KAAK,OAAO;gBACV,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACvH,KAAK,OAAO;gBACV,OAAO;oBACL,OAAO,EAAE,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnK,IAAI;oBACJ,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,KAAK,UAAU;gBACb,OAAO;oBACL,OAAO,EAAE,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5J,IAAI;oBACJ,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,KAAK,MAAM;gBACT,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACzG,KAAK,SAAS;gBACZ,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACzK,KAAK,MAAM;gBACT,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACvL,KAAK,SAAS;gBACZ,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAClT;gBACE,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,qBAAqB,IAAI,CAAC,IAAI,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GACL,GAAG,YAAY,SAAS,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAC/G,CAAC,CAAC,IAAI,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,KAAK,8CAA8C,CAAC;YAC9G,CAAC,CAAC,GAAG,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/cmd-bench.d.ts

@@ -0,0 +1,17 @@
+import { type Outcome } from './output.ts';
+/** Exit code when the bench ran but the frame is over budget. */
+export declare const EXIT_OVER_FRAME_BUDGET = 3;
+/**
+ * `yali bench`: opens the running app in a CDP browser, lets it run, and reads the profiler
+ * through the page's tools probe (`globalThis.__yali.profile()` by default). The frame
+ * interval p95 is checked against `frame_ms.desktop`.
+ */
+export declare function benchCommand(opts: {
+    root?: string;
+    url?: string;
+    query?: string;
+    seconds?: string;
+    out?: string;
+    cdpPort?: string;
+    probe?: string;
+}): Promise<Outcome>;

package/dist/cmd-bench.js

@@ -0,0 +1,74 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { YaliError } from '@yali-engine/core';
+import { loadBudgets } from "./budgets.js";
+import { openPage } from "./cdp.js";
+import { ok } from "./output.js";
+import { cdpPort, loadProject, pageUrl } from "./project.js";
+/** Exit code when the bench ran but the frame is over budget. */
+export const EXIT_OVER_FRAME_BUDGET = 3;
+/**
+ * `yali bench`: opens the running app in a CDP browser, lets it run, and reads the profiler
+ * through the page's tools probe (`globalThis.__yali.profile()` by default). The frame
+ * interval p95 is checked against `frame_ms.desktop`.
+ */
+export async function benchCommand(opts) {
+    const project = await loadProject(opts.root);
+    const url = pageUrl(project, opts.url, opts.query);
+    const seconds = Number(opts.seconds ?? 6);
+    if (!(seconds > 0))
+        throw new YaliError('BAD_OPTION', `--seconds must be positive, got ${opts.seconds}.`, 'Pass e.g. --seconds 6.');
+    const probe = opts.probe ?? '__yali';
+    const page = await openPage(url, cdpPort(opts.cdpPort));
+    let read;
+    try {
+        await new Promise((r) => setTimeout(r, seconds * 1000));
+        read = await page.evaluate(`(() => {
+      const p = globalThis[${JSON.stringify(probe)}];
+      if (!p || typeof p.profile !== 'function') return null;
+      return { profile: p.profile(), quality: p.quality ? p.quality() : null, userAgent: navigator.userAgent,
+               error: document.getElementById('error')?.textContent || null };
+    })()`);
+    }
+    finally {
+        await page.close();
+    }
+    if (!read) {
+        throw new YaliError('NO_PROBE', `${url} has no globalThis.${probe}.profile().`, `Expose the tools probe in the app: globalThis.${probe} = { profile: (w) => app.profiler.snapshot(w), quality: () => app.quality.knobs() }.`);
+    }
+    const { budgets } = loadBudgets(project.root);
+    const p = read.profile;
+    const budget = budgets.frame_ms.desktop;
+    // The interval is vsync-locked: a 60 Hz frame is 16.67 ms against a 16.6 ms budget, so
+    // the check allows 5 %. A missed frame shows as 33 ms and fails it.
+    const withinBudget = p.interval.p95 <= budget * 1.05 && !read.error;
+    const result = {
+        url,
+        seconds,
+        userAgent: read.userAgent,
+        fps: Math.round(p.fps * 10) / 10,
+        frameMs: { p50: p.interval.p50, p95: p.interval.p95, budget },
+        cpuMs: p.cpu,
+        gpuMs: p.gpu,
+        withinBudget,
+        pageError: read.error,
+        consoleErrors: [...page.errors],
+        quality: read.quality,
+        profile: p,
+    };
+    if (opts.out) {
+        const out = resolve(project.root, opts.out);
+        mkdirSync(dirname(out), { recursive: true });
+        writeFileSync(out, `${JSON.stringify(result, null, 2)}\n`);
+    }
+    const text = [
+        `${url}  ${result.fps} fps`,
+        `frame p50 ${p.interval.p50.toFixed(2)} ms  p95 ${p.interval.p95.toFixed(2)} ms  (budget ${budget} ms)`,
+        `cpu p50 ${p.cpu.p50.toFixed(2)} ms  p95 ${p.cpu.p95.toFixed(2)} ms${p.gpu ? `  gpu mean ${p.gpu.mean.toFixed(2)} ms` : ''}`,
+        ...p.scopes.filter((s) => s.category !== 'frame' && s.category !== 'stage').slice(0, 6).map((s) => `  ${s.name.padEnd(24)} mean ${s.mean.toFixed(3)}  p95 ${s.p95.toFixed(3)} ms`),
+        ...(read.error ? [`page error: ${read.error}`] : []),
+        withinBudget ? 'within budget' : 'OVER BUDGET',
+    ];
+    return ok('bench', result, text, withinBudget ? 0 : EXIT_OVER_FRAME_BUDGET);
+}
+//# sourceMappingURL=cmd-bench.js.map

package/dist/cmd-bench.js.map

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

package/dist/cmd-build.d.ts

@@ -0,0 +1,13 @@
+import { type Outcome } from './output.ts';
+/** Exit code when the build succeeded but is over a size budget. */
+export declare const EXIT_OVER_BUDGET = 3;
+/**
+ * `yali build`: Vite build, then the size report against budgets.json. `report`: the sizes are
+ * reported and never fail the build (a demo page with app code; the engine is gated on its own
+ * reference page, ADR-0106).
+ */
+export declare function buildCommand(opts: {
+    root?: string;
+    json: boolean;
+    report?: boolean;
+}): Promise<Outcome>;

package/dist/cmd-build.js

@@ -0,0 +1,40 @@
+import { resolve } from 'node:path';
+import { yali } from '@yali-engine/vite';
+import { build as viteBuild, resolveConfig } from 'vite';
+import { loadBudgets } from "./budgets.js";
+import { ok } from "./output.js";
+import { loadProject } from "./project.js";
+import { sizeReport } from "./size.js";
+/** Exit code when the build succeeded but is over a size budget. */
+export const EXIT_OVER_BUDGET = 3;
+/**
+ * `yali build`: Vite build, then the size report against budgets.json. `report`: the sizes are
+ * reported and never fail the build (a demo page with app code; the engine is gated on its own
+ * reference page, ADR-0106).
+ */
+export async function buildCommand(opts) {
+    const project = await loadProject(opts.root);
+    const inline = {
+        root: project.root,
+        configFile: project.viteConfig ?? false,
+        plugins: project.viteConfig ? [] : [yali()],
+        logLevel: opts.json ? 'silent' : 'info',
+    };
+    const t0 = performance.now();
+    await viteBuild(inline);
+    const ms = Math.round(performance.now() - t0);
+    const resolved = await resolveConfig(inline, 'build');
+    const outDir = resolve(project.root, resolved.build.outDir);
+    const { budgets, file } = loadBudgets(project.root);
+    const size = sizeReport(outDir, budgets);
+    const text = [
+        `built ${outDir} in ${ms} ms`,
+        ...size.files.map((f) => `  ${f.path.padEnd(48)} ${f.brotliKb.toFixed(1).padStart(7)} KB br`),
+        `page total ${size.totalKb} of ${size.budgetKb} KB, threaded ${size.threadedTotalKb} of ${size.threadedBudgetKb} KB; core wasm ${size.wasmKb} of ${size.wasmBudgetKb} KB`,
+        ...size.fallbacks.map((f) => `fallback ${f.name} ${f.kb} of ${f.budgetKb} KB (not in the totals): ${f.files.join(', ') || 'none'}`),
+        `workers only ${size.workerKb} KB, content ${size.contentKb} KB (reported, not budgeted)`,
+        opts.report ? `reported only (--report): ${size.withinBudget ? 'within' : 'over'} the budgets` : size.withinBudget ? 'within budget' : 'OVER BUDGET',
+    ];
+    return ok('build', { outDir, ms, budgetsFile: file, size, report: !!opts.report }, text, size.withinBudget || opts.report ? 0 : EXIT_OVER_BUDGET);
+}
+//# sourceMappingURL=cmd-build.js.map

package/dist/cmd-build.js.map

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

package/dist/cmd-convert.d.ts

@@ -0,0 +1,27 @@
+import { type Outcome } from './output.ts';
+export interface ConvertOptions {
+    readonly input?: string;
+    readonly output?: string;
+    /** The largest texture side (default 2048: T2's size class). */
+    readonly maxSize?: string;
+    /** UASTC rate-distortion optimisation, the quality scalar (0: off). */
+    readonly rdo?: string;
+    /** Also write the level's collision (`<name>.collision.bin`). */
+    readonly collision?: boolean;
+    /** Store each big primitive's cluster LOD hierarchy in the GLB (`YALI_clusters`, ADR-0121). */
+    readonly clusters?: boolean;
+    /** The fewest triangles a primitive needs for --clusters (default 4096, `meshlets()`' own). */
+    readonly clusterMin?: string;
+    /** With --clusters: cut each hierarchy into streaming pages (`YALI_cluster_pages`, ADR-0134), the roots in the GLB and the rest in `<name>.pages.bin`. */
+    readonly stream?: boolean;
+    /** The most bytes a page holds on the GPU (default 65536). */
+    readonly pageKb?: string;
+    /** The texture encoder: `auto` (default: native basisu 1.60 if found, else WASM), `wasm`, `native` (ADR-0097). */
+    readonly encoder?: string;
+    readonly json: boolean;
+    /** Where --json's progress lines go (default stderr). */
+    readonly emit?: (line: string) => void;
+}
+/** Bilinear resample of RGBA8 `w × h` to a `size²` square (each output texel samples its centre). */
+export declare function resampleSquare(rgba: Uint8Array, w: number, h: number, size: number): Uint8Array;
+export declare function convertCommand(opts: ConvertOptions): Promise<Outcome>;