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

package/dist/sceneHlod/imageSampling.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sampleHlodImage = sampleHlodImage;
+exports.createHlodImageSampler = createHlodImageSampler;
+exports.sourceUvFootprint = sourceUvFootprint;
+const linear = (v) => v <= .04045 ? v / 12.92 : ((v + .055) / 1.055) ** 2.4;
+const srgb = (v) => v <= .0031308 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - .055;
+const decoded = Array.from({ length: 256 }, (_, i) => linear(i / 255));
+function wrapped(n, size, mode = 10497) {
+    if (mode === 33071)
+        return Math.max(0, Math.min(size - 1, n));
+    const period = mode === 33648 ? size * 2 : size, x = ((n % period) + period) % period;
+    return x < size ? x : period - x - 1;
+}
+/** Decode color to linear before filtering; scalar and encoded normal channels stay linear. */
+function sampleHlodImage(image, u, v, color) {
+    if (!image)
+        return [1, 1, 1, 1];
+    const m = image.transform;
+    if (m)
+        [u, v] = [m[0] * u + m[3] * v + m[6], m[1] * u + m[4] * v + m[7]];
+    const x = u * image.width - .5, y = v * image.height - .5, x0 = Math.floor(x), y0 = Math.floor(y), dx = x - x0, dy = y - y0;
+    const out = [0, 0, 0, 0];
+    for (let j = 0; j < 2; j++)
+        for (let i = 0; i < 2; i++) {
+            const offset = (wrapped(y0 + j, image.height, image.wrapT) * image.width + wrapped(x0 + i, image.width, image.wrapS)) * 4;
+            const weight = (i ? dx : 1 - dx) * (j ? dy : 1 - dy);
+            for (let k = 0; k < 4; k++)
+                out[k] += (color && k < 3 ? decoded[image.data[offset + k]] : image.data[offset + k] / 255) * weight;
+        }
+    return out;
+}
+function downsample(image, color, signal) {
+    const width = Math.max(1, Math.floor(image.width / 2)), height = Math.max(1, Math.floor(image.height / 2));
+    const data = new Uint8Array(width * height * 4), sx = image.width / width, sy = image.height / height;
+    for (let y = 0; y < height; y++) {
+        signal?.throwIfAborted();
+        for (let x = 0; x < width; x++) {
+            const x0 = x * sx, x1 = (x + 1) * sx, y0 = y * sy, y1 = (y + 1) * sy, sum = [0, 0, 0, 0];
+            // Fractional coverage keeps every source texel's contribution, including odd image dimensions.
+            for (let j = Math.floor(y0); j < Math.ceil(y1); j++)
+                for (let i = Math.floor(x0); i < Math.ceil(x1); i++) {
+                    const weight = (Math.min(i + 1, x1) - Math.max(i, x0)) * (Math.min(j + 1, y1) - Math.max(j, y0)) / (sx * sy);
+                    const offset = (Math.min(j, image.height - 1) * image.width + Math.min(i, image.width - 1)) * 4;
+                    for (let k = 0; k < 4; k++)
+                        sum[k] += (color && k < 3 ? decoded[image.data[offset + k]] : image.data[offset + k] / 255) * weight;
+                }
+            for (let k = 0; k < 4; k++)
+                data[(y * width + x) * 4 + k] = Math.round((color && k < 3 ? srgb(sum[k]) : sum[k]) * 255);
+        }
+    }
+    return { width, height, data };
+}
+/** Per-transfer cache: mip bytes are shared across texture bindings and released with the bake. */
+function createHlodImageSampler(signal) {
+    const cache = new WeakMap();
+    return (image, u, v, color, footprint) => {
+        if (!image)
+            return [1, 1, 1, 1];
+        const m = image.transform, [ux, vx, uy, vy] = footprint;
+        const dx = [(m ? m[0] * ux + m[3] * vx : ux) * image.width, (m ? m[1] * ux + m[4] * vx : vx) * image.height];
+        const dy = [(m ? m[0] * uy + m[3] * vy : uy) * image.width, (m ? m[1] * uy + m[4] * vy : vy) * image.height];
+        const lod = Math.log2(Math.max(1, Math.hypot(...dx), Math.hypot(...dy)));
+        if (lod === 0)
+            return sampleHlodImage(image, u, v, color);
+        let bindings = cache.get(image.data);
+        if (!bindings) {
+            bindings = new Map();
+            cache.set(image.data, bindings);
+        }
+        const key = `${image.width}:${image.height}:${color}`;
+        let levels = bindings.get(key);
+        if (!levels) {
+            levels = [{ width: image.width, height: image.height, data: image.data }];
+            while (levels.at(-1).width > 1 || levels.at(-1).height > 1)
+                levels.push(downsample(levels.at(-1), color, signal));
+            bindings.set(key, levels);
+        }
+        const low = Math.min(Math.floor(lod), levels.length - 1), high = Math.min(low + 1, levels.length - 1), blend = Math.min(1, lod - low);
+        const a = sampleHlodImage({ ...image, ...levels[low] }, u, v, color), b = sampleHlodImage({ ...image, ...levels[high] }, u, v, color);
+        return a.map((value, k) => value * (1 - blend) + b[k] * blend);
+    };
+}
+/** Project destination world-space derivatives onto the original triangle's UV parameterization. */
+function sourceUvFootprint(source, a, b, c, dx, dy) {
+    const p = source.positions, uv = source.uvs;
+    const e1 = [0, 1, 2].map(k => p[b * 3 + k] - p[a * 3 + k]), e2 = [0, 1, 2].map(k => p[c * 3 + k] - p[a * 3 + k]);
+    const dot = (u, v) => u[0] * v[0] + u[1] * v[1] + u[2] * v[2];
+    const g11 = dot(e1, e1), g12 = dot(e1, e2), g22 = dot(e2, e2), determinant = g11 * g22 - g12 * g12;
+    if (determinant <= g11 * g22 * 1e-12)
+        return [0, 0, 0, 0];
+    const result = [0, 0, 0, 0];
+    for (const [axis, delta] of [dx, dy].entries()) {
+        const d1 = dot(delta, e1), d2 = dot(delta, e2), db = (d1 * g22 - d2 * g12) / determinant, dc = (d2 * g11 - d1 * g12) / determinant;
+        for (let k = 0; k < 2; k++)
+            result[axis * 2 + k] = db * (uv[b * 2 + k] - uv[a * 2 + k]) + dc * (uv[c * 2 + k] - uv[a * 2 + k]);
+    }
+    return result;
+}
+//# sourceMappingURL=imageSampling.js.map

package/dist/sceneHlod/imageSampling.js.map

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

package/dist/sceneHlod/refinement.d.ts

@@ -0,0 +1,46 @@
+import { type SceneHlodRefinementSettings } from '@hypersoniclabs/helix-manifest';
+import { type CompleteSceneHlodOptions } from './complete';
+export interface SceneHlodRefinementOptions extends Partial<SceneHlodRefinementSettings> {
+    compression?: 'png' | 'ktx2';
+    force?: boolean;
+    signal?: AbortSignal;
+    onProgress?: CompleteSceneHlodOptions['onProgress'];
+}
+export declare const DEFAULT_HLOD_REFINEMENT_SETTINGS: SceneHlodRefinementSettings;
+/** Keep regional upload/decode peaks bounded. Repeated and larger source silhouettes retain more texels. */
+export declare function planHlodRefinementAtlas(items: readonly {
+    id: string;
+    size: number;
+    importance: number;
+}[], maxSize: number, minSize: number): import("./sharedAtlas").HlodSharedAtlasPlan;
+/** Bake regional upgrades from pinned original sources, retaining every existing complete coarse artifact. */
+export declare function bakeSceneHlodRefinements(files: string | readonly string[], options?: SceneHlodRefinementOptions): Promise<{
+    bakerVersion: number;
+    scenes: {
+        file: string;
+        id: string;
+        integrity: import("@hypersoniclabs/helix-manifest").SceneIntegrity;
+    }[];
+    prototypes: number;
+    cachedPrototypes: number;
+    cells: {
+        scene: string;
+        cluster: string;
+        sources: number;
+        triangles: number;
+        reducedTiles: number;
+        bytes: number;
+        estimatedBytes: number;
+        material: {
+            estimatedBytes: number;
+            width: number;
+            height: number;
+            sha256: string;
+            uri: string;
+            bytes: number;
+        };
+        quantizationErrorM: number;
+    }[];
+    triangles: number;
+    totalMs: number;
+}>;

package/dist/sceneHlod/refinement.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_HLOD_REFINEMENT_SETTINGS = void 0;
+exports.planHlodRefinementAtlas = planHlodRefinementAtlas;
+exports.bakeSceneHlodRefinements = bakeSceneHlodRefinements;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const scene_1 = require("./scene");
+const complete_1 = require("./complete");
+const source_1 = require("./source");
+const completePrototype_1 = require("./completePrototype");
+const sharedAtlas_1 = require("./sharedAtlas");
+const cellArtifact_1 = require("./cellArtifact");
+exports.DEFAULT_HLOD_REFINEMENT_SETTINGS = {
+    maxDistanceM: 896, fadeMs: 350, maxErrorM: .5, triangleRatio: .01, voxelSizeM: .5, texelsPerM: 4, minTileSize: 64, maxTileSize: 256,
+    atlasSize: 1024,
+};
+/** Keep regional upload/decode peaks bounded. Repeated and larger source silhouettes retain more texels. */
+function planHlodRefinementAtlas(items, maxSize, minSize) {
+    if (![256, 512, 1024, 2048].includes(maxSize) || ![32, 64, 128, 256, 512, 1024].includes(minSize) || minSize > maxSize
+        || !items.length || items.length > 4096 || new Set(items.map(item => item.id)).size !== items.length
+        || items.some(item => ![32, 64, 128, 256, 512, 1024].includes(item.size) || item.size < minSize
+            || !Number.isFinite(item.importance) || item.importance <= 0))
+        throw new Error('Invalid HLOD refinement atlas budget');
+    const tiles = items.map(item => ({ ...item }));
+    let area = tiles.reduce((n, tile) => n + tile.size ** 2, 0);
+    while (area > maxSize ** 2 || tiles.some(tile => tile.size > maxSize)) {
+        const candidates = tiles.filter(tile => tile.size > minSize).sort((a, b) => a.importance / a.size ** 2 - b.importance / b.size ** 2
+            || a.id.localeCompare(b.id));
+        const tile = candidates[0];
+        if (!tile)
+            throw new Error('HLOD refinement minimum tiles exceed the regional atlas budget; lower min-tile or increase atlas');
+        area -= tile.size ** 2 * .75;
+        tile.size /= 2;
+    }
+    return (0, sharedAtlas_1.planSharedHlodAtlas)(tiles.map(({ id, size }) => ({ id, size })));
+}
+/** Bake regional upgrades from pinned original sources, retaining every existing complete coarse artifact. */
+async function bakeSceneHlodRefinements(files, options = {}) {
+    const started = performance.now(), paths = (typeof files === 'string' ? [files] : [...files]).map(file => (0, node_path_1.resolve)(file));
+    if (!paths.length || paths.length > 16 || new Set(paths).size !== paths.length || new Set(paths.map(node_path_1.dirname)).size !== 1) {
+        throw new Error('HLOD refinements require 1–16 distinct scene files in the same bundle');
+    }
+    const root = (0, node_path_1.dirname)(paths[0]), compression = options.compression ?? 'ktx2';
+    const documents = [];
+    if (!['png', 'ktx2'].includes(compression))
+        throw new Error('Invalid HLOD compression');
+    const prototypes = new Map(), instances = new Map();
+    const pins = new Map();
+    for (const file of paths) {
+        options.signal?.throwIfAborted();
+        const input = await (0, scene_1.readScene)(file), scene = structuredClone(input.scene), hlod = scene.hlod;
+        if (!hlod || hlod.version < 2 || !hlod.clusters.length)
+            throw new Error('Bake complete coarse HLODs before adding refinements');
+        const errors = (0, helix_manifest_1.validateSceneDocument)(scene).errors.filter(error => !error.includes('rebuild HLOD refinement'));
+        if (errors.length)
+            throw new Error(errors.join('; '));
+        (0, scene_1.planSceneHlod)(scene);
+        if (documents.some(input => input.scene.id === scene.id))
+            throw new Error('Refinement scenes require distinct IDs');
+        // Verify retained coarse bytes as well as source inputs, including on warm cache hits.
+        const discarded = new Set(hlod.clusters.flatMap(cluster => cluster.refinement ? [cluster.refinement.resource] : []));
+        const baseMaterials = new Set(hlod.clusters.map(cluster => cluster.material));
+        for (const material of hlod.sharedMaterials)
+            if (!baseMaterials.has(material.resource))
+                discarded.add(material.resource);
+        scene.resources = scene.resources.filter(item => !discarded.has(item.id));
+        hlod.sharedMaterials = hlod.sharedMaterials.filter(item => baseMaterials.has(item.resource));
+        for (const cluster of hlod.clusters)
+            delete cluster.refinement;
+        const settings = { ...exports.DEFAULT_HLOD_REFINEMENT_SETTINGS, ...hlod.refinement };
+        for (const key of Object.keys(settings))
+            if (options[key] !== undefined)
+                settings[key] = options[key];
+        hlod.version = 3;
+        hlod.refinement = settings;
+        scene.capabilities.required = [...new Set([...scene.capabilities.required, helix_manifest_1.SCENE_HLOD_REFINEMENT_CAPABILITY])];
+        const probe = structuredClone(scene);
+        probe.hlod.clusters = [];
+        probe.integrity.sha256 = (0, helix_manifest_1.computeSceneDocumentIntegrity)(probe);
+        const validation = (0, helix_manifest_1.validateSceneDocument)(probe);
+        if (!validation.valid)
+            throw new Error(validation.errors.join('; '));
+        const matrices = (0, complete_1.sceneMatrices)(scene), selected = new Map();
+        const nodes = new Map(scene.nodes.map(node => [node.id, node]));
+        const required = new Set(hlod.clusters.flatMap(cluster => [cluster.resource, cluster.material,
+            ...cluster.nodes.map(id => (0, source_1.hlodSourceResourceId)(nodes.get(id)))]));
+        for (const item of scene.resources)
+            if (required.has(item.id) && item.source.kind === 'bundle') {
+                const previous = pins.get(item.source.uri);
+                if (previous && (previous.integrity.sha256 !== item.integrity.sha256 || previous.bytes !== item.bytes))
+                    throw new Error('Conflicting HLOD source pins');
+                pins.set(item.source.uri, item);
+            }
+        for (const cluster of hlod.clusters)
+            for (const id of cluster.nodes) {
+                const node = nodes.get(id), matrix = matrices.get(id), scale = (0, complete_1.scaleBound)(matrix);
+                const source = scene.resources.find(item => item.id === (0, source_1.hlodSourceResourceId)(node));
+                const primitive = node.components?.find(component => component.type === 'render.primitive');
+                if (source && source.source.kind !== 'bundle')
+                    throw new Error(`HLOD ${id}: requires a local immutable source`);
+                if (scene.surfaces.some(surface => surface.node === id && (surface.default.kind !== 'source' || surface.overridePolicy.allowed))) {
+                    throw new Error(`HLOD ${id}: bake authored material overrides into the immutable source first`);
+                }
+                const layer = { ...hlod.layers.find(layer => layer.id === cluster.layer), maxErrorM: settings.maxErrorM, triangleRatio: settings.triangleRatio };
+                const bake = { cellSizeM: hlod.bake.cellSizeM, voxelSizeM: settings.voxelSizeM, texelsPerM: settings.texelsPerM,
+                    minTileSize: settings.minTileSize, maxTileSize: settings.maxTileSize };
+                const identity = (0, source_1.hlodDigest)(JSON.stringify({ source: source?.integrity.sha256, bytes: source?.bytes, primitive,
+                    error: layer.maxErrorM, ratio: layer.triangleRatio, settings: bake, bakerVersion: completePrototype_1.COMPLETE_HLOD_BAKER_VERSION }));
+                const previous = prototypes.get(identity);
+                if (previous)
+                    previous.scale = Math.max(previous.scale, scale);
+                else
+                    prototypes.set(identity, { key: identity, scene, node, scale, layer, settings: bake });
+                selected.set(id, { node, matrix, scale, key: identity, cell: cluster.cell, layer: cluster.layer });
+            }
+        instances.set(scene.id, selected);
+        documents.push({ file, bytes: input.bytes, scene });
+    }
+    for (const [uri, pin] of pins) {
+        options.signal?.throwIfAborted();
+        const file = await (0, source_1.hlodLocalPath)(root, uri);
+        if ((await (0, promises_1.stat)(file)).size > 256 * 1048576)
+            throw new Error('HLOD input exceeds 256 MiB');
+        const bytes = await (0, promises_1.readFile)(file);
+        if ((0, source_1.hlodDigest)(bytes) !== pin.integrity.sha256 || pin.bytes !== bytes.length)
+            throw new Error(`HLOD input integrity mismatch: ${pin.id}`);
+    }
+    const output = await (0, scene_1.bundleDirectory)(root, ['hlod-complete']), cache = await (0, scene_1.bundleDirectory)(root, ['.helix', 'hlod-complete-cache']);
+    const records = new Map();
+    let completed = 0, cachedPrototypes = 0;
+    for (const [identity, input] of [...prototypes].sort(([a], [b]) => a.localeCompare(b))) {
+        input.key = (0, source_1.hlodDigest)(JSON.stringify({ identity, scale: input.scale }));
+        const { prototype, cached } = await (0, completePrototype_1.bakeCompletePrototype)(input, root, cache, options);
+        const extent = Math.max(...prototype.bounds.max.map((value, axis) => value - prototype.bounds.min[axis])) * input.scale;
+        records.set(identity, { key: input.key, extent, emissive: !!prototype.emissive, size: Math.max(input.settings.minTileSize, Math.min(input.settings.maxTileSize, 2 ** Math.ceil(Math.log2(Math.max(1e-6, extent * input.settings.texelsPerM))))) });
+        if (cached)
+            cachedPrototypes++;
+        options.onProgress?.({ phase: 'prototype', completed: ++completed, total: prototypes.size, id: input.node.id, cached });
+    }
+    const decoded = new Map();
+    const get = async (key) => {
+        let prototype = decoded.get(key);
+        if (!prototype) {
+            prototype = await (0, completePrototype_1.readCompletePrototype)(cache, records.get(key).key) ?? undefined;
+            if (!prototype)
+                throw new Error('Missing HLOD refinement prototype cache');
+            decoded.set(key, prototype);
+            if (decoded.size > 12)
+                decoded.delete(decoded.keys().next().value);
+        }
+        return prototype;
+    };
+    const receipts = [];
+    completed = 0;
+    const total = documents.reduce((n, input) => n + input.scene.hlod.clusters.length, 0);
+    for (const input of documents) {
+        const scene = input.scene, hlod = scene.hlod;
+        for (const cluster of hlod.clusters) {
+            options.signal?.throwIfAborted();
+            const selected = cluster.nodes.map(id => instances.get(scene.id).get(id));
+            const keys = [...new Set(selected.map(item => item.key))];
+            const tiles = keys.map(id => ({ id, size: records.get(id).size,
+                importance: selected.filter(item => item.key === id).length * Math.max(.01, records.get(id).extent ** 2) }));
+            const plan = planHlodRefinementAtlas(tiles, hlod.refinement.atlasSize ?? 1024, hlod.refinement.minTileSize);
+            const atlas = await (0, sharedAtlas_1.bakeSharedHlodAtlas)(plan, get, { signal: options.signal, emissive: keys.some(id => records.get(id).emissive) });
+            const material = await (0, cellArtifact_1.writeSharedHlodMaterialGlb)(atlas, compression);
+            options.signal?.throwIfAborted();
+            const appearance = await (0, complete_1.durableArtifact)(output, material.bytes), materialId = 'resource.hlod.material.' + appearance.sha256.slice(0, 24);
+            if (!scene.resources.some(item => item.id === materialId)) {
+                scene.resources.push((0, complete_1.resource)(materialId, appearance));
+                hlod.sharedMaterials.push({ resource: materialId, estimatedBytes: material.estimatedBytes });
+            }
+            const geometry = await (0, complete_1.mergeCompleteCell)(selected, new Map(plan.slots.map(slot => [slot.id, slot])), get, cluster.origin, options.signal);
+            const artifact = await (0, cellArtifact_1.writeHlodCellGlb)(geometry, selected.length), stored = await (0, complete_1.durableArtifact)(output, artifact.bytes);
+            const id = 'resource.' + cluster.id + '.refinement';
+            scene.resources.push((0, complete_1.resource)(id, stored));
+            cluster.refinement = { resource: id, material: materialId, triangles: geometry.indices.length / 3,
+                estimatedBytes: artifact.estimatedBytes, sourceHash: '' };
+            receipts.push({ scene: scene.id, cluster: cluster.id, sources: selected.length, triangles: cluster.refinement.triangles,
+                reducedTiles: plan.slots.filter(slot => slot.size < records.get(slot.id).size).length,
+                bytes: stored.bytes, estimatedBytes: artifact.estimatedBytes, material: { ...appearance, estimatedBytes: material.estimatedBytes,
+                    width: plan.width, height: plan.height }, quantizationErrorM: artifact.quantizationErrorM });
+            options.onProgress?.({ phase: 'cell', completed: ++completed, total, id: cluster.id, cached: false });
+        }
+        const hash = (0, helix_manifest_1.createSceneHlodRefinementSourceHasher)(scene);
+        for (const cluster of hlod.clusters)
+            cluster.refinement.sourceHash = hash(cluster);
+        scene.integrity.sha256 = (0, helix_manifest_1.computeSceneDocumentIntegrity)(scene);
+        const validation = (0, helix_manifest_1.validateSceneDocument)(scene);
+        if (!validation.valid)
+            throw new Error(validation.errors.join('; '));
+    }
+    for (const input of documents)
+        if (!(await (0, promises_1.readFile)(input.file)).equals(input.bytes))
+            throw new Error('Scene changed during HLOD refinement bake');
+    options.signal?.throwIfAborted();
+    for (const input of documents)
+        await (0, scene_1.replaceScene)(input.file, input.bytes, input.scene);
+    return { bakerVersion: completePrototype_1.COMPLETE_HLOD_BAKER_VERSION, scenes: documents.map(input => ({ file: input.file, id: input.scene.id, integrity: input.scene.integrity })),
+        prototypes: prototypes.size, cachedPrototypes, cells: receipts, triangles: receipts.reduce((n, row) => n + row.triangles, 0), totalMs: performance.now() - started };
+}
+//# sourceMappingURL=refinement.js.map

package/dist/sceneHlod/refinement.js.map

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

package/dist/sceneHlod/scene.d.ts

@@ -0,0 +1,80 @@
+import { type HelixSceneV2, type SceneHlodCluster, type SceneHlodLayer, type SceneHlodParticipation } from '@hypersoniclabs/helix-manifest';
+import type { HlodBakeMetrics } from './types';
+/** Bump whenever normalization, simplification, UV layout, sampling or output encoding changes. */
+export declare const HLOD_BAKER_VERSION = 3;
+export declare const DEFAULT_HLOD_LAYER: SceneHlodLayer;
+export declare function withoutBake(original: HelixSceneV2): HelixSceneV2;
+export declare function readScene(file: string): Promise<{
+    bytes: Buffer;
+    scene: HelixSceneV2;
+}>;
+export declare function replaceScene(file: string, before: Buffer, scene: HelixSceneV2): Promise<void>;
+/** Explicit node selection. Changing a tag invalidates the prior bake while retaining its content-addressed files for reuse. */
+export declare function tagSceneHlod(file: string, options: {
+    nodes: string[];
+    mode: SceneHlodParticipation['mode'];
+    layer?: string;
+    layerSettings?: Partial<Omit<SceneHlodLayer, 'id'>>;
+}): Promise<HelixSceneV2>;
+export declare function planSceneHlod(scene: HelixSceneV2): {
+    layer: string;
+    cell: string;
+    nodes: string[];
+}[];
+export declare function inspectSceneHlod(file: string): Promise<{
+    scene: string;
+    layers: SceneHlodLayer[];
+    bake: import("@hypersoniclabs/helix-manifest").SceneHlodCompleteBakeSettings | undefined;
+    refinement: import("@hypersoniclabs/helix-manifest").SceneHlodRefinementSettings | undefined;
+    sharedMaterials: import("@hypersoniclabs/helix-manifest").SceneHlodSharedMaterial[] | undefined;
+    clusters: SceneHlodCluster[];
+} | {
+    scene: string;
+    layers: SceneHlodLayer[];
+    clusters: {
+        sourceHash: string;
+        bake: SceneHlodCluster | null;
+        layer: string;
+        cell: string;
+        nodes: string[];
+    }[];
+    bake?: undefined;
+    refinement?: undefined;
+    sharedMaterials?: undefined;
+}>;
+export interface HlodBakeReceipt {
+    bakerVersion: number;
+    key: string;
+    cluster: SceneHlodCluster;
+    sha256: string;
+    bytes: number;
+    uri: string;
+    sourceDrawCalls: number;
+    sourceBytes: number;
+    metrics: HlodBakeMetrics;
+}
+export interface SceneHlodBakeOptions {
+    compression?: 'png' | 'ktx2';
+    signal?: AbortSignal;
+    force?: boolean;
+    onProgress?: (progress: {
+        completed: number;
+        total: number;
+        cluster: string;
+        cached: boolean;
+    }) => void;
+}
+export declare function bundleDirectory(root: string, parts: string[]): Promise<string>;
+/** Whole-scene bake is serial and bounded. Resources are durable before the scene is atomically resealed. */
+export declare function bakeSceneHlod(file: string, options?: SceneHlodBakeOptions): Promise<{
+    scene: string;
+    clusters: (HlodBakeReceipt & {
+        cached: boolean;
+    })[];
+    totalMs: number;
+    sourceTriangles: number;
+    outputTriangles: number;
+    sourceDrawCalls: number;
+    proxyDrawCalls: number;
+    outputBytes: number;
+}>;