@helix3/helix-cli 0.1.14-helix3.162 → 0.1.14-helix3.164

package/dist/bakeLighting.d.ts

@@ -0,0 +1,131 @@
+import { type HelperTimeoutState } from './browser/launch';
+/** The query parameter that boots a world for baking. `=1` and nothing else. */
+export declare const BAKE_PARAM = "helixBake";
+/** The artifact the bake writes, next to the visual contract it is pointed at from. */
+export declare const BAKE_ARTIFACT_FILE = "helix.visuals.bake.json";
+/** K sun keys, the driver's own default. Below 2 the planner cannot place both horizon keys. */
+export declare const DEFAULT_BAKE_KEYS = 9;
+/** Boot budget. SwiftShader boots a world minutes slower than a real GPU, so this is seconds-times-hundreds. */
+export declare const DEFAULT_BAKE_BOOT_TIMEOUT_S = 300;
+export type BakePhase = 'idle' | 'warm-up' | 'audit' | 'key' | 'practicals' | 'geometry' | 'done' | 'failed';
+export type BakeProgress = {
+    phase: BakePhase;
+    done: number;
+    total: number;
+};
+export type BakeKeyTiming = {
+    hours: number;
+    elevationDeg: number;
+    azimuthDeg: number;
+    ms: number;
+    bakeMs: number;
+};
+export type BakeAuditSummary = {
+    probes: number;
+    flagged: number;
+    counts: Record<string, number>;
+    blockedEdges: number;
+    leakingEdges: number;
+    ms: number;
+};
+export type BakeRepairSummary = {
+    damaged: number;
+    substituted: number;
+    leftDark: number;
+    donorPool: number;
+    occludedCandidates: number;
+    maxDonorGridDistance: number;
+    /** THE TRIPWIRE: a donated probe whose donor it cannot see is a cross-zone light teleport. MUST read 0. */
+    donorsOccluded: number;
+    ms: number;
+};
+/** Whether the probe volume fits the space the world is played in — a PLACEMENT verdict, not a bake defect. */
+export type BakeVolumeFitSummary = {
+    layers: number;
+    /** Probe layers carrying at least `litShare` of the strongest layer's energy. */
+    litLayers: number;
+    litShare: number;
+    /** Total DC irradiance per Y layer, bottom first. */
+    layerEnergy: number[];
+    /** False = most of the box baked darkness or open sky. */
+    fits: boolean;
+};
+export type BakeSummary = {
+    keys: number;
+    probes: number;
+    totalMs: number;
+    warmUpMs: number;
+    perKey: BakeKeyTiming[];
+    practicalsMs: number;
+    geometryMs: number;
+    auditKey: number;
+    audit: BakeAuditSummary;
+    repair: BakeRepairSummary;
+    /** OPTIONAL against the ENGINE, not against the contract: a world bundles its own @helix/visual, so a build
+     *  made before the volume-fit verdict existed reports no `volumeFit` at all and simply gets no warning. */
+    volumeFit?: BakeVolumeFitSummary;
+    repairs: number;
+    volume: {
+        probes: [number, number, number];
+        size: [number, number, number];
+        center: [number, number, number];
+    };
+    /** False when the tier ran without DDGI visibility — the artifact then ships SH only. */
+    geometry: boolean;
+    fieldBytes: number;
+    geometryBytes: number;
+};
+/** Where the bake serves from and which roots take the artifact + the pointer. */
+export type BakeTargets = {
+    /** The built bundle the browser loads. */
+    servedDir: string;
+    /** The world roots written to: the source `public/` (when it exists) and the built bundle root. */
+    roots: string[];
+};
+export type BakeWrite = {
+    path: string;
+    kind: 'artifact' | 'contract';
+    bytes: number;
+    /** True when the file did not exist and this run created it. */
+    created: boolean;
+};
+export type BakeLightingOptions = {
+    directory: string;
+    keys?: number | undefined;
+    /** Boot budget in ms — the wait for `window.__helixBake`, NOT a cap on the bake itself. */
+    timeoutMs?: number | undefined;
+    onProgress?: ((message: string) => void) | undefined;
+};
+export type BakeLightingResult = {
+    summary: BakeSummary;
+    written: BakeWrite[];
+    servedDir: string;
+};
+/**
+ * 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.
+ */
+export declare function resolveBakeTargets(directory: string): BakeTargets;
+/**
+ * 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.
+ */
+export declare function patchVisualsConfigText(text: string | null, artifact?: string): string;
+/**
+ * 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.
+ */
+export declare function bakeGateFailure(summary: BakeSummary): string | null;
+export declare function formatDuration(ms: number): string;
+export declare function formatBakeProgress(progress: BakeProgress, elapsedMs: number): string;
+/** The compact end-of-run report: what was baked, what it cost, what the audit found, and what landed on disk. */
+export declare function formatBakeSummary(summary: BakeSummary, written: readonly BakeWrite[]): string[];
+/** Page errors FIRST — a VisualInvariantError name is the diagnosis, and the reason below it is the consequence. */
+export declare function composeBakeFailure(reason: string, errors: readonly string[]): string;
+export declare function composeBakeTimeoutDiagnosis(state: HelperTimeoutState, errors: string[]): string;
+/**
+ * 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.
+ */
+export declare function bakeLighting(opts: BakeLightingOptions): Promise<BakeLightingResult>;

package/dist/bakeLighting.js

@@ -0,0 +1,363 @@
+"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.DEFAULT_BAKE_BOOT_TIMEOUT_S = exports.DEFAULT_BAKE_KEYS = exports.BAKE_ARTIFACT_FILE = exports.BAKE_PARAM = void 0;
+exports.resolveBakeTargets = resolveBakeTargets;
+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, and the `BakeSummary` /
+// `BakeProgress` fields read below. 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 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, the driver's own default. Below 2 the planner cannot place both horizon keys. */
+exports.DEFAULT_BAKE_KEYS = 9;
+/** Boot budget. SwiftShader boots a world minutes slower than a real GPU, so this is seconds-times-hundreds. */
+exports.DEFAULT_BAKE_BOOT_TIMEOUT_S = 300;
+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).`);
+}
+// 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.
+ */
+function patchVisualsConfigText(text, artifact = exports.BAKE_ARTIFACT_FILE) {
+    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 = { version: visualsConfig_1.BAKED_LIGHTING_VERSION, artifact };
+    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 lines = [
+        `✔ Baked ${summary.keys} keys + practicals · ${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)}`),
+        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}${summary.repair.leftDark > 0 ? ` · ${summary.repair.leftDark} left dark (no visible donor)` : ''}`),
+        row('artifact', `${Math.round(summary.fieldBytes / 1024)} KB field + ${Math.round(summary.geometryBytes / 1024)} KB geometry`),
+    ];
+    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) {
+    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), 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 };
+    });
+}
+/**
+ * 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 ?? exports.DEFAULT_BAKE_KEYS;
+    const timeoutMs = opts.timeoutMs ?? exports.DEFAULT_BAKE_BOOT_TIMEOUT_S * 1000;
+    const targets = resolveBakeTargets(opts.directory);
+    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 (0, launch_1.browserCandidates)()) {
+            try {
+                browser = await playwright.chromium.launch(candidate.launchOptions);
+                onProgress(`  using ${candidate.label}`);
+                break;
+            }
+            catch (err) {
+                attempts.push({ key: candidate.key, label: candidate.label, message: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        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 });
+        onProgress(`  waiting up to ${Math.round(timeoutMs / 1000)}s for the bake handle`);
+        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));
+        }
+        onProgress(`  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
+            .run({ keys: count })
+            .then((result) => ({ store: JSON.stringify(result.store), summary: result.summary })), { keys })
+            .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)), servedDir: targets.servedDir };
+    }
+    finally {
+        await browser?.close();
+        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/bundle.d.ts

@@ -11,6 +11,8 @@ export type BundleCheck = {
     errors: string[];
     /** Not publish-blocking, but the creator must SEE them. See streamablePayload. */
     warnings: string[];
+    /** One line per optional contract file that IS present, saying what it declares. Nothing is wrong. */
+    notes: string[];
 };
 export declare function streamablePayload(files: BundleFile[]): {
     files: BundleFile[];