@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/bakeLighting.js

@@ -0,0 +1,452 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOOT_SECONDS_PER_MIB = exports.DEFAULT_BAKE_BOOT_TIMEOUT_S = exports.DEFAULT_BAKE_KEYS = exports.BAKE_ARTIFACT_FILE = exports.BAKE_PARAM = void 0;
+exports.resolveBakeTargets = resolveBakeTargets;
+exports.measureBundleBytes = measureBundleBytes;
+exports.bootTimeoutForBundle = bootTimeoutForBundle;
+exports.patchVisualsConfigText = patchVisualsConfigText;
+exports.bakeGateFailure = bakeGateFailure;
+exports.formatDuration = formatDuration;
+exports.formatBakeProgress = formatBakeProgress;
+exports.formatBakeSummary = formatBakeSummary;
+exports.composeBakeFailure = composeBakeFailure;
+exports.composeBakeTimeoutDiagnosis = composeBakeTimeoutDiagnosis;
+exports.bakeLighting = bakeLighting;
+// The publish-time lighting bake behind `helix bake-lighting`: serves the world's BUILT bundle, drives the
+// in-page bake handle (window.__helixBake) over Playwright, then writes the field artifact and points the
+// world's visual contract at it. Nothing here imports the engine — this module only speaks its window protocol.
+// SYNC OBLIGATION: mirrors helix-web-engine-new/systems/visual/src/runtime/bakeDriver.ts — `BAKE_PARAM`
+// ('helixBake'), `BAKE_HANDLE_KEY` ('__helixBake'), the ready/failed handle shapes, the `BakeSummary` (incl.
+// `staticSun`, `bounces`, `atlasDepth`, `relocated`/`stillBuried`/`rejectedOutsideBox`/`relocationMs`, `inactive`, `occlusionDilated`) /
+// `BakeProgress` (incl. the `relocate` phase) fields read below, and `run({})` with NO keys at all — omitting them is what asks the ENGINE
+// to plan them (one key for a static sun, DEFAULT_BAKE_KEYS for a cycling one). Fix protocol bugs there first, then mirror here; drift
+// surfaces as a missing field at the END of a multi-minute run, so it has to be findable from either side.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const hostSlots_1 = require("./browser/hostSlots");
+const nonSystemChrome_1 = require("./browser/nonSystemChrome");
+const launch_1 = require("./browser/launch");
+const staticServe_1 = require("./screenshot/staticServe");
+const visualsConfig_1 = require("./visualsConfig");
+/** The query parameter that boots a world for baking. `=1` and nothing else. */
+exports.BAKE_PARAM = 'helixBake';
+/** The artifact the bake writes, next to the visual contract it is pointed at from. */
+exports.BAKE_ARTIFACT_FILE = 'helix.visuals.bake.json';
+/** K sun keys for a CYCLING sun, the driver's own default. Below 2 the planner cannot place both horizon keys. */
+exports.DEFAULT_BAKE_KEYS = 9;
+/** Boot budget FLOOR. SwiftShader boots a world minutes slower than a real GPU, so this is seconds-times-hundreds. */
+exports.DEFAULT_BAKE_BOOT_TIMEOUT_S = 300;
+/** How much boot budget a megabyte of bundle buys itself — SwiftShader decodes, uploads and compiles it all. */
+exports.BOOT_SECONDS_PER_MIB = 20;
+const BYTES_PER_MIB = 1024 * 1024;
+const PROGRESS_POLL_MS = 2000;
+// A 2 s poll over a multi-minute bake would print hundreds of identical lines, so a line goes out when the
+// phase/key count MOVES and otherwise on this heartbeat — which is what tells a stalled bake from a slow key.
+const PROGRESS_HEARTBEAT_MS = 15000;
+const MAX_DIAGNOSTIC_LINES = 6;
+const DIAGNOSTIC_LINE_MAX_CHARS = 300;
+const isDirectory = (path) => {
+    try {
+        return (0, node_fs_1.statSync)(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+// A built world bundle is an entry HTML plus the manifest at its ROOT — the pair `helix validate` reads. A vite
+// source tree carries index.html at the root too but keeps its manifest (and its visual contract) in `public/`,
+// so the pair is what tells the two apart and stops the bake serving un-transpiled source.
+const isBuiltBundle = (dir) => (0, node_fs_1.existsSync)((0, node_path_1.join)(dir, 'index.html')) && (0, node_fs_1.existsSync)((0, node_path_1.join)(dir, helix_manifest_1.MANIFEST_FILENAME));
+/**
+ * Which bundle is served and which roots are written. Mirrors the convention `helix validate` reads the visual
+ * contract under: the built bundle serves it from the ROOT, a source tree keeps it in `public/` — so both copies
+ * are patched, leaving the just-baked build publishable and the next build carrying the same pointer.
+ */
+function resolveBakeTargets(directory) {
+    const root = (0, node_path_1.resolve)(directory);
+    if (!(0, node_fs_1.existsSync)(root))
+        throw new Error(`${root} does not exist`);
+    const dist = (0, node_path_1.join)(root, 'dist');
+    if (isBuiltBundle(dist)) {
+        const source = (0, node_path_1.join)(root, 'public');
+        return { servedDir: dist, roots: isDirectory(source) ? [source, dist] : [dist] };
+    }
+    if (isBuiltBundle(root)) {
+        // `<world>/dist` handed in straight: the source contract sits one level up, in the tree vite copies from.
+        const source = (0, node_path_1.basename)(root) === 'dist' ? (0, node_path_1.join)((0, node_path_1.dirname)(root), 'public') : null;
+        return { servedDir: root, roots: source !== null && isDirectory(source) ? [source, root] : [root] };
+    }
+    throw new Error(`${root} has no built bundle — bake-lighting bakes the BUILT world (index.html + ${helix_manifest_1.MANIFEST_FILENAME}), not the source ` +
+        `project. Expected one at ${dist} or at the directory itself; run your build first (npm run build).`);
+}
+/** Every byte the browser may have to fetch, decode and upload before the handle appears. */
+function measureBundleBytes(dir) {
+    let total = 0;
+    for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+        const path = (0, node_path_1.join)(dir, entry.name);
+        if (entry.isDirectory())
+            total += measureBundleBytes(path);
+        else if (entry.isFile())
+            total += (0, node_fs_1.statSync)(path).size;
+    }
+    return total;
+}
+/**
+ * The boot budget, in seconds, for a bundle of this size. A fixed deadline is wrong in both directions —
+ * SwiftShader spends minutes on a heavy world's first frame, and a 45 MiB one blew a 300 s budget outright — so
+ * the wait scales with what the browser has to chew through, never dropping below the floor.
+ */
+function bootTimeoutForBundle(bundleBytes) {
+    return Math.max(exports.DEFAULT_BAKE_BOOT_TIMEOUT_S, Math.ceil(bundleBytes / BYTES_PER_MIB) * exports.BOOT_SECONDS_PER_MIB);
+}
+// Rewriting a hand-authored document with a different indent (or a flipped line ending) turns a two-line patch
+// into a whole-file diff in the creator's repo, so the shape is read off the file rather than assumed.
+function detectJsonStyle(text) {
+    if (text === null)
+        return { indent: 2, newline: '\n', trailingNewline: true };
+    const indented = /\n([ \t]+)\S/.exec(text);
+    const indent = indented ? (indented[1].startsWith('\t') ? '\t' : indented[1].length) : 2;
+    return { indent, newline: text.includes('\r\n') ? '\r\n' : '\n', trailingNewline: text.endsWith('\n') };
+}
+/**
+ * The contract patch: `mode: "baked"` plus the artifact pointer, every other key carried verbatim and in place.
+ * `null` text creates the minimal v1 document — a world may declare no visual contract at all until it is baked.
+ * `keys` records how many sun keys the field actually holds; omitted, the pointer keeps its older two-field shape.
+ */
+function patchVisualsConfigText(text, artifact = exports.BAKE_ARTIFACT_FILE, keys) {
+    const source = text !== null && text.trim() !== '' ? text : null;
+    const style = detectJsonStyle(source);
+    let doc;
+    if (source === null) {
+        doc = { version: visualsConfig_1.VISUALS_CONFIG_VERSION, mode: 'baked' };
+    }
+    else {
+        const parsed = JSON.parse(source);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('the visual contract must be a JSON object');
+        }
+        doc = { ...parsed };
+        if (typeof doc.version !== 'number')
+            doc.version = visualsConfig_1.VISUALS_CONFIG_VERSION;
+        doc.mode = 'baked';
+    }
+    doc.bakedLighting =
+        keys === undefined ? { version: visualsConfig_1.BAKED_LIGHTING_VERSION, artifact } : { version: visualsConfig_1.BAKED_LIGHTING_VERSION, artifact, keys };
+    const json = JSON.stringify(doc, null, style.indent) + (style.trailingNewline ? '\n' : '');
+    // JSON.stringify escapes newlines inside strings, so only the formatting ones are here to convert.
+    return style.newline === '\n' ? json : json.replace(/\n/g, style.newline);
+}
+/**
+ * THE GATE. A donated probe whose donor it cannot see is light teleported across a wall, so the artifact is
+ * refused rather than written: the run is sound only while this reads 0. Null when the field is clean.
+ */
+function bakeGateFailure(summary) {
+    const occluded = summary.repair.donorsOccluded;
+    if (occluded <= 0)
+        return null;
+    return (`GATE FAILED — ${occluded} of this field's de-ghost donors are OCCLUDED from the probe they donated to, so the ` +
+        'artifact carries teleported light across a surface. NOTHING was written. The donor visibility rule regressed ' +
+        'engine-side (systems/visual/src/probes/probeAudit.ts); re-bake once it is fixed.');
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const seconds = Math.round(ms / 1000);
+    return `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, '0')}`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function formatBakeProgress(progress, elapsedMs) {
+    return `  [${formatDuration(elapsedMs)}] ${progress.phase} · ${progress.done}/${progress.total} keys`;
+}
+const row = (label, text) => `  ${label.padEnd(8)}  ${text}`;
+/** The compact end-of-run report: what was baked, what it cost, what the audit found, and what landed on disk. */
+function formatBakeSummary(summary, written) {
+    const [px, py, pz] = summary.volume.probes;
+    const keysMs = summary.perKey.reduce((total, key) => total + key.ms, 0);
+    const counts = Object.entries(summary.audit.counts)
+        .filter(([, count]) => count > 0)
+        .map(([issue, count]) => `${issue} ${count}`)
+        .join(', ');
+    const sun = summary.staticSun === undefined ? '' : ` (${summary.staticSun ? 'static sun' : 'sun cycle'})`;
+    const buried = summary.stillBuried ?? 0;
+    const refused = summary.rejectedOutsideBox ?? 0;
+    const { leftDark } = summary.repair;
+    const deactivated = summary.inactive;
+    // Only when the left-dark wording below did NOT already name them: at leftDark 0 it never prints, so a zero
+    // deactivation still reports itself.
+    const countDeactivated = deactivated !== undefined && !(leftDark > 0 && deactivated === leftDark);
+    const lines = [
+        `✔ Baked ${summary.keys} key${summary.keys === 1 ? '' : 's'} + practicals${sun} · ${summary.probes} probes ` +
+            `(${px}×${py}×${pz}) in ${formatDuration(summary.totalMs)}`,
+        row('phases', `warm-up ${formatDuration(summary.warmUpMs)} · keys ${formatDuration(keysMs)} · practicals ` +
+            `${formatDuration(summary.practicalsMs)} · geometry ${formatDuration(summary.geometryMs)}`),
+        ...(summary.relocated === undefined ? [] : [row('relocate', `${summary.relocated} probes moved out through the nearest backface · ${buried} still buried` +
+                `${buried > 0 ? ' (left to the de-ghost)' : ''}` +
+                `${refused > 0 ? ` · ${refused} refused at the box edge` : ''} · ${Math.round(summary.relocationMs ?? 0)} ms`)]),
+        row('audit', `${summary.audit.flagged} flagged of ${summary.audit.probes}${counts ? ` (${counts})` : ''} · ` +
+            `${summary.audit.leakingEdges} leaking edges of ${summary.audit.blockedEdges} blocked`),
+        row('repair', `${summary.repairs} probes repaired of ${summary.repair.damaged} damaged · donors occluded ${summary.repair.donorsOccluded}` +
+            `${leftDark > 0 ? ` · ${leftDark} left dark (no visible donor${deactivated === leftDark ? ' — deactivated' : ''})` : ''}` +
+            `${countDeactivated ? ` · ${deactivated} deactivated` : ''}`),
+        row('artifact', `${Math.round(summary.fieldBytes / 1024)} KB field + ${Math.round(summary.geometryBytes / 1024)} KB geometry` +
+            (summary.bounces === undefined ? '' : ` · bounces ${summary.bounces}`) +
+            (summary.atlasDepth === undefined ? '' : ` · atlas depth ${summary.atlasDepth} slices`)),
+        ...(summary.occlusionVoxels === undefined ? [] : [row('occlusion', `${summary.occlusionVoxels} voxels${summary.occlusionDilated === undefined ? '' : ` · ${summary.occlusionDilated} dilated`}` +
+                ` · ${Math.round((summary.occlusionBytes ?? 0) / 1024)} KB · ${Math.round(summary.occlusionMs ?? 0)} ms`)]),
+    ];
+    if (!summary.geometry) {
+        lines.push('  ⚠ SH-ONLY FIELD — this bake ran without DDGI visibility, so a world playing it degrades visibility OFF and its', '    indirect light LEAKS THROUGH WALLS. Re-bake on a tier that carries the probe rung to get the geometry half.');
+    }
+    const fit = summary.volumeFit;
+    if (fit && !fit.fits) {
+        const [sx, sy, sz] = summary.volume.size;
+        const [cx, cy, cz] = summary.volume.center;
+        lines.push(`  ⚠ THE PROBE VOLUME DOES NOT FIT THIS WORLD — only ${fit.litLayers} of ${fit.layers} probe layers sit inside the lit space.`, `    The rest of the ${sx}×${sy}×${sz} m box at [${cx}, ${cy}, ${cz}] baked DARKNESS OR OPEN SKY, and the interpolation`, '    washes that back down over the room — a red or blue smear on ceilings is the usual tell. An interior should', `    author "probes": { "center": [x, y, z], "size": [w, h, d] } in ${visualsConfig_1.VISUALS_CONFIG_FILE} to fit the box to its room,`, '    then re-bake. The probe budget is fixed, so a smaller box costs nothing: the cells shrink to fit.');
+    }
+    written.forEach((file, index) => {
+        lines.push(row(index === 0 ? 'wrote' : '', `${file.path} (${formatBytes(file.bytes)}${file.created ? ', created' : ''})`));
+    });
+    return lines;
+}
+/** Page errors FIRST — a VisualInvariantError name is the diagnosis, and the reason below it is the consequence. */
+function composeBakeFailure(reason, errors) {
+    if (errors.length === 0)
+        return reason;
+    return `page errors during the bake:\n${errors.map((line) => `  - ${line}`).join('\n')}\n\n${reason}`;
+}
+// "absent" — no handle at all — is the real cause here: the page never called createVisualRuntime, so the world
+// is not runtime-lit and there is no probe field to bake. "present" can only be the handle landing on the
+// deadline itself, because the runtime publishes it whole (ready true OR false).
+function composeBakeTimeoutDiagnosis(state, errors) {
+    return (0, launch_1.composeTimeoutDiagnosisWith)(state, errors, {
+        absent: 'This world never published the bake handle (window.__helixBake) — nothing on the page called the visual ' +
+            "runtime's createVisualRuntime, so the world is not runtime-lit and has no probe field to bake. Check that " +
+            'the built world boots standalone, and raise --timeout <s> if the boot is simply slow (SwiftShader is).',
+        present: 'The bake handle landed as the deadline expired — the boot is slower than the budget, not broken. Re-run ' +
+            'with a longer --timeout <s>.',
+    });
+}
+// Every file is READ and patched before any is written: a world whose contract is unparseable must fail with the
+// bake still intact on the page, not half-written across two roots.
+function planWrites(roots, storeJson, keys) {
+    const planned = [];
+    for (const root of roots) {
+        const artifactPath = (0, node_path_1.join)(root, exports.BAKE_ARTIFACT_FILE);
+        planned.push({ path: artifactPath, kind: 'artifact', text: storeJson, created: !(0, node_fs_1.existsSync)(artifactPath) });
+        const configPath = (0, node_path_1.join)(root, visualsConfig_1.VISUALS_CONFIG_FILE);
+        const existing = (0, node_fs_1.existsSync)(configPath) ? (0, node_fs_1.readFileSync)(configPath, 'utf8') : null;
+        try {
+            planned.push({
+                path: configPath,
+                kind: 'contract',
+                text: patchVisualsConfigText(existing, exports.BAKE_ARTIFACT_FILE, keys),
+                created: existing === null,
+            });
+        }
+        catch (err) {
+            throw new Error(`cannot patch ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return planned;
+}
+function commitWrites(planned) {
+    return planned.map((write) => {
+        (0, node_fs_1.writeFileSync)(write.path, write.text);
+        return { path: write.path, kind: write.kind, bytes: Buffer.byteLength(write.text), created: write.created };
+    });
+}
+// PAGE-SIDE — runs inside the browser through page.evaluate, so it must close over nothing in this module. The
+// first canvas with a GL context wins; the debug extension unmasks the driver name Chrome otherwise generalizes.
+function readRendererString() {
+    for (const canvas of Array.from(document.querySelectorAll('canvas'))) {
+        const gl = canvas.getContext('webgl2') ?? canvas.getContext('webgl');
+        if (!gl)
+            continue;
+        const debug = gl.getExtension('WEBGL_debug_renderer_info');
+        const name = debug ? gl.getParameter(debug.UNMASKED_RENDERER_WEBGL) : gl.getParameter(gl.RENDERER);
+        if (name)
+            return String(name);
+    }
+    return null;
+}
+/**
+ * Serve, boot, bake, gate, write. The bake itself is MINUTES of blocking GPU work inside one `page.evaluate`,
+ * which Playwright does not time out; `--timeout` bounds only the wait for the handle.
+ */
+async function bakeLighting(opts) {
+    const onProgress = opts.onProgress ?? (() => undefined);
+    const keys = opts.keys;
+    const targets = resolveBakeTargets(opts.directory);
+    const bundleBytes = opts.timeoutMs === undefined ? measureBundleBytes(targets.servedDir) : 0;
+    const timeoutMs = opts.timeoutMs ?? bootTimeoutForBundle(bundleBytes) * 1000;
+    const playwright = await Promise.resolve().then(() => __importStar(require('playwright')));
+    const server = await (0, staticServe_1.startStaticServer)(targets.servedDir);
+    let browser;
+    try {
+        const attempts = [];
+        for (const candidate of opts.gpu ? (0, launch_1.gpuBrowserCandidates)() : (0, launch_1.browserCandidates)()) {
+            try {
+                (0, nonSystemChrome_1.assertNotSystemChrome)(candidate.launchOptions.executablePath, candidate.launchOptions.channel);
+                browser = await (0, hostSlots_1.launchWithBrowserSlot)(() => playwright.chromium.launch(candidate.launchOptions), 'disconnected', { identity: `lighting-bake:${opts.directory}` });
+            }
+            catch (err) {
+                attempts.push({ key: candidate.key, label: candidate.label, message: err instanceof Error ? err.message : String(err) });
+                continue;
+            }
+            onProgress(`  using ${candidate.label}${opts.gpu ? ' (GPU)' : ''}`);
+            break;
+        }
+        if (!browser)
+            throw new Error((0, launch_1.composeLaunchFailure)(attempts));
+        const page = await browser.newPage({ viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1 });
+        // Listening from before the navigation: the invariant the bake trips is thrown during BOOT, and its name is
+        // the whole diagnosis on every failure path below.
+        const pageErrors = [];
+        const recordPageError = (line) => {
+            const truncated = line.length > DIAGNOSTIC_LINE_MAX_CHARS ? `${line.slice(0, DIAGNOSTIC_LINE_MAX_CHARS)}…` : line;
+            pageErrors.push(truncated);
+            if (pageErrors.length > MAX_DIAGNOSTIC_LINES)
+                pageErrors.shift();
+        };
+        page.on('pageerror', (err) => recordPageError(err.message));
+        page.on('console', (msg) => {
+            if (msg.type() === 'error')
+                recordPageError(msg.text());
+        });
+        onProgress(`  serving ${targets.servedDir} on 127.0.0.1:${server.port}`);
+        await page.goto(`http://127.0.0.1:${server.port}/?${exports.BAKE_PARAM}=1`, { timeout: timeoutMs });
+        const budget = `  waiting up to ${Math.round(timeoutMs / 1000)}s for the bake handle`;
+        onProgress(opts.timeoutMs === undefined ? `${budget} (budget scaled to ${(bundleBytes / BYTES_PER_MIB).toFixed(1)} MiB of bundle)` : budget);
+        try {
+            await page.waitForFunction("typeof window.__helixBake !== 'undefined'", undefined, { timeout: timeoutMs });
+        }
+        catch {
+            const state = await page.evaluate(() => typeof window.__helixBake === 'undefined' ? 'absent' : 'present');
+            throw new Error(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for the bake handle (window.__helixBake). ` +
+                composeBakeTimeoutDiagnosis(state, pageErrors));
+        }
+        // `ready: false` is TERMINAL — the runtime publishes it rather than fall back to a configuration that would
+        // bake a wrong artifact quietly, so there is nothing to retry.
+        const handle = await page.evaluate(() => ({
+            ready: window.__helixBake.ready === true,
+            error: String(window.__helixBake.error ?? ''),
+        }));
+        if (!handle.ready) {
+            throw new Error(composeBakeFailure(`this world cannot be baked: ${handle.error}`, pageErrors));
+        }
+        // THE RECEIPT for --gpu: a system browser that quietly fell back to software renders a SwiftShader string
+        // here, and the run is otherwise indistinguishable. Never let reading it fail a bake.
+        const renderer = await page.evaluate(readRendererString).catch(() => null);
+        if (renderer)
+            onProgress(`  renderer: ${renderer}`);
+        onProgress(keys === undefined
+            ? `  handle ready — baking + practicals (the engine plans the keys: ONE for a static sun, ${exports.DEFAULT_BAKE_KEYS} for a cycle; ` +
+                'minutes; do not interrupt)'
+            : `  handle ready — baking ${keys} keys + practicals (minutes; do not interrupt)`);
+        const started = Date.now();
+        // The store comes back already stringified: the artifact ships the driver's JSON verbatim, and a Node-side
+        // re-serialization of a CDP-decoded object is one more thing that could differ from what the engine wrote.
+        let settled = false;
+        const run = page
+            .evaluate(({ keys: count }) => window.__helixBake
+            // No `keys` AT ALL when none was asked for: an explicit undefined is still an authored count engine-side.
+            .run(count === null ? {} : { keys: count })
+            .then((result) => ({ store: JSON.stringify(result.store), summary: result.summary })), { keys: keys ?? null })
+            .then((result) => {
+            settled = true;
+            return result;
+        }, (err) => {
+            settled = true;
+            throw err;
+        });
+        run.catch(() => undefined); // reported at the await below; this only keeps the poll loop's window quiet
+        let lastPrinted = 0;
+        let lastLine = '';
+        while (!settled) {
+            await new Promise((done) => setTimeout(done, PROGRESS_POLL_MS));
+            if (settled)
+                break;
+            let progress;
+            try {
+                progress = await page.evaluate(() => window.__helixBake.progress());
+            }
+            catch {
+                break; // the page went away — the run promise carries the real error
+            }
+            const line = `${progress.phase} ${progress.done}/${progress.total}`;
+            const elapsed = Date.now() - started;
+            if (line !== lastLine || elapsed - lastPrinted >= PROGRESS_HEARTBEAT_MS) {
+                onProgress(formatBakeProgress(progress, elapsed));
+                lastLine = line;
+                lastPrinted = elapsed;
+            }
+        }
+        let result;
+        try {
+            result = await run;
+        }
+        catch (err) {
+            throw new Error(composeBakeFailure(`the bake failed: ${err instanceof Error ? err.message : String(err)}`, pageErrors));
+        }
+        const gate = bakeGateFailure(result.summary);
+        if (gate)
+            throw new Error(composeBakeFailure(gate, pageErrors));
+        return {
+            summary: result.summary,
+            written: commitWrites(planWrites(targets.roots, result.store, result.summary.keys)),
+            servedDir: targets.servedDir,
+            renderer,
+        };
+    }
+    finally {
+        try {
+            await browser?.close();
+        }
+        finally {
+            await server.close();
+        }
+    }
+}
+//# sourceMappingURL=bakeLighting.js.map

package/dist/bakeLighting.js.map

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

package/dist/bridge/bridge.testutil.d.ts

@@ -0,0 +1,105 @@
+import { Document } from '@gltf-transform/core';
+export declare function addPrimitive(document: Document, mesh: ReturnType<Document['createMesh']>, materialName: string, triangles: number): void;
+export declare function writeMetaHumanFixture(path: string): Promise<void>;
+export declare function writeBipedFixture(path: string): Promise<void>;
+export declare function writeExternalFixture(directory: string, options: {
+    id: string;
+    capability?: string;
+    priority?: number;
+    extension?: string;
+    accepts?: string[];
+    produces?: string[];
+    replaces?: string[];
+    args?: string[];
+    requires?: string[];
+    handler: string[];
+}): void;
+export declare function glb(json: Record<string, unknown>): Buffer;
+export declare function writeLargeGlb(path: string, json: Record<string, unknown>, binaryBytes: number): void;
+export declare function validBaseAvatar(): {
+    asset: {
+        version: string;
+    };
+    scenes: {
+        name: string;
+        nodes: number[];
+    }[];
+    nodes: ({
+        name: string;
+        mesh: number;
+        skin: number;
+        children: number[];
+    } | {
+        name: string;
+        mesh: number;
+        skin: number;
+        children?: undefined;
+    })[];
+    meshes: ({
+        primitives: {
+            attributes: {
+                POSITION: number;
+            };
+            indices: number;
+            material: number;
+        }[];
+        name?: undefined;
+    } | {
+        name: string;
+        primitives: {
+            attributes: {
+                POSITION: number;
+            };
+            indices: number;
+            material: number;
+        }[];
+    })[];
+    skins: {
+        joints: never[];
+    }[];
+    accessors: {
+        count: number;
+    }[];
+    materials: ({
+        name: string;
+        pbrMetallicRoughness?: undefined;
+    } | {
+        name: string;
+        pbrMetallicRoughness: {
+            baseColorTexture: {
+                index: number;
+            };
+            baseColorFactor: number[];
+        };
+    })[];
+    textures: {}[];
+};
+export declare const beamngTerminalFixtureConfiguration: {
+    file: string;
+    sha256: string;
+    format: number;
+};
+export declare function unsupportedBeamngTerminalAbs(): {
+    schemaVersion: string;
+    adapterId: string;
+    adapterVersion: number;
+    beamng: {
+        version: string;
+        steamBuildId: string;
+    };
+    sourceModule: {
+        path: string;
+        sha256: string;
+        sizeBytes: number;
+    };
+    sourceReceiptSha256: string;
+    sourceShapeId: string;
+    selectedConfiguration: {
+        file: string;
+        sha256: string;
+    };
+    status: string;
+    reason: string;
+    activationCandidates: never[];
+    axleTargets: {};
+};