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

package/dist/sceneHlod/complete.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPLETE_HLOD_SETTINGS = void 0;
+exports.sceneMatrices = sceneMatrices;
+exports.scaleBound = scaleBound;
+exports.durableArtifact = durableArtifact;
+exports.resource = resource;
+exports.bakeCompleteSceneHlod = bakeCompleteSceneHlod;
+exports.mergeCompleteCell = mergeCompleteCell;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const three_1 = require("three");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const scene_1 = require("./scene");
+const source_1 = require("./source");
+const completePrototype_1 = require("./completePrototype");
+const sharedAtlas_1 = require("./sharedAtlas");
+const cellArtifact_1 = require("./cellArtifact");
+exports.DEFAULT_COMPLETE_HLOD_SETTINGS = {
+    cellSizeM: 512, voxelSizeM: 2, texelsPerM: 1, minTileSize: 64, maxTileSize: 256,
+};
+function sceneMatrices(scene) {
+    const nodes = new Map(scene.nodes.map(node => [node.id, node])), matrices = new Map(), pending = new Set();
+    const get = (node) => {
+        const existing = matrices.get(node.id);
+        if (existing)
+            return existing;
+        if (pending.has(node.id))
+            throw new Error('Cyclic HLOD ancestry');
+        pending.add(node.id);
+        const t = node.transform, matrix = new three_1.Matrix4().compose(new three_1.Vector3().fromArray(t.position), new three_1.Quaternion().fromArray(t.rotation), new three_1.Vector3().fromArray(t.scale));
+        if (node.parent)
+            matrix.premultiply(get(nodes.get(node.parent)));
+        if (!matrix.elements.every(Number.isFinite) || Math.abs(matrix.determinant()) < 1e-12)
+            throw new Error('Invalid HLOD source transform');
+        pending.delete(node.id);
+        matrices.set(node.id, matrix);
+        return matrix;
+    };
+    for (const node of scene.nodes)
+        get(node);
+    return matrices;
+}
+function scaleBound(matrix) {
+    const e = matrix.elements, columns = [[e[0], e[1], e[2]], [e[4], e[5], e[6]], [e[8], e[9], e[10]]];
+    // Gershgorin bound of A^T A covers nonuniform scale and inherited shear, without penalizing ordinary rotations.
+    return Math.sqrt(Math.max(...columns.map(a => columns.reduce((sum, b) => sum + Math.abs(a.reduce((n, v, i) => n + v * b[i], 0)), 0))));
+}
+async function durableArtifact(output, bytes) {
+    const sha256 = (0, source_1.hlodDigest)(bytes), name = sha256 + '.glb';
+    await (0, promises_1.writeFile)((0, node_path_1.resolve)(output, name), bytes, { flag: 'wx' }).catch(async (error) => {
+        if (error.code !== 'EEXIST' || (0, source_1.hlodDigest)(await (0, promises_1.readFile)(await (0, source_1.hlodLocalPath)(output, name))) !== sha256)
+            throw error;
+    });
+    return { sha256, uri: `hlod-complete/${name}`, bytes: bytes.byteLength };
+}
+function resource(id, artifact) {
+    return { id, kind: 'model', source: { kind: 'bundle', assetId: id, uri: artifact.uri }, bytes: artifact.bytes,
+        mimeType: 'model/gltf-binary', integrity: { sha256: artifact.sha256 }, required: true };
+}
+/** Complete coarse scene bake. Multiple documents in one bundle share appearance while keeping their sealed scene roots independent. */
+async function bakeCompleteSceneHlod(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('Complete HLOD bake requires 1–16 distinct scene files in the same bundle directory');
+    }
+    const root = (0, node_path_1.dirname)(paths[0]), compression = options.compression ?? 'ktx2';
+    if (!['png', 'ktx2'].includes(compression))
+        throw new Error('Invalid HLOD compression');
+    const inputs = [];
+    for (const file of paths) {
+        options.signal?.throwIfAborted();
+        const input = await (0, scene_1.readScene)(file);
+        inputs.push({ file, ...input });
+    }
+    if (new Set(inputs.map(input => input.scene.id)).size !== inputs.length)
+        throw new Error('Complete HLOD input scenes require distinct IDs');
+    const prototypes = new Map(), instances = new Map(), sourceFiles = new Map();
+    const documents = inputs.map(input => ({ ...input, scene: (0, scene_1.withoutBake)(structuredClone(input.scene)) }));
+    for (const input of documents) {
+        const scene = input.scene, plan = (0, scene_1.planSceneHlod)(scene), matrices = sceneMatrices(scene), nodes = new Map(scene.nodes.map(node => [node.id, node]));
+        const settings = { ...exports.DEFAULT_COMPLETE_HLOD_SETTINGS, ...scene.hlod?.bake };
+        for (const key of Object.keys(settings))
+            if (options[key] !== undefined) {
+                settings[key] = options[key];
+            }
+        scene.hlod.version = 2;
+        scene.hlod.bake = settings;
+        scene.hlod.sharedMaterials = [];
+        delete scene.hlod.refinement;
+        scene.capabilities.required = scene.capabilities.required.filter(cap => cap !== 'helix.scene-hlod/3');
+        scene.hlod.layers = scene.hlod.layers.map(layer => ({ ...layer, residency: 'complete' }));
+        scene.capabilities.required = [...new Set([...scene.capabilities.required.filter(cap => cap !== helix_manifest_1.SCENE_HLOD_CAPABILITY), helix_manifest_1.SCENE_HLOD_COMPLETE_CAPABILITY])];
+        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('; '));
+        const selected = [];
+        for (const cell of plan)
+            for (const id of cell.nodes) {
+                const node = nodes.get(id), matrix = matrices.get(id), scale = scaleBound(matrix), layer = scene.hlod.layers.find(layer => layer.id === cell.layer);
+                const source = scene.resources.find(resource => resource.id === (0, source_1.hlodSourceResourceId)(node));
+                const primitive = node.components?.find(component => component.type === 'render.primitive');
+                if (source) {
+                    if (source.source.kind !== 'bundle')
+                        throw new Error(`HLOD ${id}: requires a local immutable source`);
+                    const previous = sourceFiles.get(source.source.uri);
+                    if (previous && (previous.integrity.sha256 !== source.integrity.sha256 || previous.bytes !== source.bytes)) {
+                        throw new Error(`Conflicting HLOD source pins for ${source.source.uri}`);
+                    }
+                    sourceFiles.set(source.source.uri, 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 identity = (0, source_1.hlodDigest)(JSON.stringify({ source: source?.integrity.sha256, bytes: source?.bytes, primitive,
+                    error: layer.maxErrorM, ratio: layer.triangleRatio, settings, bakerVersion: completePrototype_1.COMPLETE_HLOD_BAKER_VERSION }));
+                const existing = prototypes.get(identity);
+                if (existing)
+                    existing.scale = Math.max(existing.scale, scale);
+                else
+                    prototypes.set(identity, { key: identity, scene, node, scale, layer, settings });
+                selected.push({ node, matrix, scale, key: identity, cell: cell.cell, layer: cell.layer });
+            }
+        instances.set(scene.id, selected);
+    }
+    // Warm bakes still verify every pinned input. A corrupted source cannot hide behind the prototype cache.
+    for (const [uri, source] of sourceFiles) {
+        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 source exceeds 256 MiB');
+        const bytes = await (0, promises_1.readFile)(file);
+        if ((0, source_1.hlodDigest)(bytes) !== source.integrity.sha256 || source.bytes !== bytes.length)
+            throw new Error(`HLOD source integrity mismatch: ${source.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;
+        const size = Math.max(input.settings.minTileSize, Math.min(input.settings.maxTileSize, 2 ** Math.ceil(Math.log2(Math.max(1e-6, extent * input.settings.texelsPerM)))));
+        records.set(identity, { key: input.key, bounds: prototype.bounds, metrics: prototype.metrics, size, emissive: !!prototype.emissive });
+        if (cached)
+            cachedPrototypes++;
+        options.onProgress?.({ phase: 'prototype', completed: ++completed, total: prototypes.size, id: input.node.id, cached });
+    }
+    const atlasPlan = (0, sharedAtlas_1.planSharedHlodAtlas)([...records].map(([id, value]) => ({ id, size: value.size })));
+    const atlas = await (0, sharedAtlas_1.bakeSharedHlodAtlas)(atlasPlan, async (id) => {
+        const prototype = await (0, completePrototype_1.readCompletePrototype)(cache, records.get(id).key);
+        if (!prototype)
+            throw new Error('Missing complete HLOD prototype cache');
+        return prototype;
+    }, { signal: options.signal, emissive: [...records.values()].some(record => record.emissive) });
+    const material = await (0, cellArtifact_1.writeSharedHlodMaterialGlb)(atlas, compression);
+    options.signal?.throwIfAborted();
+    const materialArtifact = await durableArtifact(output, material.bytes), materialId = 'resource.hlod.material.' + materialArtifact.sha256.slice(0, 24);
+    options.onProgress?.({ phase: 'material', completed: 1, total: 1, id: materialId, cached: false });
+    const slots = new Map(atlasPlan.slots.map(slot => [slot.id, slot])), receipts = [];
+    const decoded = new Map();
+    const getPrototype = async (identity) => {
+        let prototype = decoded.get(identity);
+        if (!prototype) {
+            prototype = await (0, completePrototype_1.readCompletePrototype)(cache, records.get(identity).key) ?? undefined;
+            if (!prototype)
+                throw new Error('Missing complete HLOD prototype cache');
+            decoded.set(identity, prototype);
+            if (decoded.size > 12)
+                decoded.delete(decoded.keys().next().value);
+        }
+        return prototype;
+    };
+    for (const input of documents) {
+        const scene = input.scene, settings = scene.hlod.bake, groups = new Map();
+        const cells = new Map(scene.streamGroups.flatMap(group => group.cells.map(cell => [cell.id, cell])));
+        for (const instance of instances.get(scene.id)) {
+            const bounds = cells.get(instance.cell).bounds;
+            const x = Math.floor((bounds.min[0] + bounds.max[0]) * .5 / settings.cellSizeM), z = Math.floor((bounds.min[2] + bounds.max[2]) * .5 / settings.cellSizeM);
+            const key = `${instance.layer}:${x}:${z}`;
+            if (!groups.has(key))
+                groups.set(key, []);
+            groups.get(key).push(instance);
+        }
+        if (groups.size > 2048)
+            throw new Error('Complete HLOD exceeds the scene cell cap');
+        scene.resources.push(resource(materialId, materialArtifact));
+        scene.hlod.sharedMaterials.push({ resource: materialId, estimatedBytes: material.estimatedBytes });
+        let complete = 0;
+        for (const [key, selected] of [...groups].sort(([a], [b]) => a.localeCompare(b))) {
+            options.signal?.throwIfAborted();
+            selected.sort((a, b) => a.node.id.localeCompare(b.node.id));
+            if (selected.length > 1024)
+                throw new Error(`HLOD ${key} exceeds 1,024 sources; choose a smaller coarse cell size`);
+            const [, x, z] = key.split(':'), origin = [(Number(x) + .5) * settings.cellSizeM, 0, (Number(z) + .5) * settings.cellSizeM];
+            const geometry = await mergeCompleteCell(selected, slots, getPrototype, origin, options.signal);
+            const artifact = await (0, cellArtifact_1.writeHlodCellGlb)(geometry, selected.length), stored = await durableArtifact(output, artifact.bytes);
+            const memberCells = [...new Set(selected.map(instance => instance.cell))].sort(), id = 'hlod.' + (0, source_1.hlodDigest)(scene.id + '/' + key).slice(0, 24);
+            const bounds = { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] };
+            for (let i = 0; i < geometry.positions.length; i++) {
+                const axis = i % 3, value = geometry.positions[i] + origin[axis];
+                bounds.min[axis] = Math.min(bounds.min[axis], value);
+                bounds.max[axis] = Math.max(bounds.max[axis], value);
+            }
+            const cluster = { id, layer: selected[0].layer, cell: memberCells[0], cells: memberCells, nodes: selected.map(instance => instance.node.id),
+                resource: 'resource.' + id, material: materialId, coverage: 'source', origin, bounds, sourceHash: '', triangles: geometry.indices.length / 3,
+                estimatedBytes: artifact.estimatedBytes };
+            scene.hlod.clusters.push(cluster);
+            scene.resources.push(resource(cluster.resource, stored));
+            receipts.push({ scene: scene.id, cluster: id, sources: selected.length, triangles: cluster.triangles, bytes: stored.bytes,
+                estimatedBytes: artifact.estimatedBytes, quantizationErrorM: artifact.quantizationErrorM });
+            options.onProgress?.({ phase: 'cell', completed: ++complete, total: groups.size, id, cached: false });
+        }
+        const hasher = (0, helix_manifest_1.createSceneHlodSourceHasher)(scene);
+        for (const cluster of scene.hlod.clusters)
+            cluster.sourceHash = hasher(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('; '));
+    }
+    // Validate every output and check all input revisions before making any sealed document visible.
+    for (const input of documents)
+        if (!(await (0, promises_1.readFile)(input.file)).equals(input.bytes))
+            throw new Error('Scene changed during complete HLOD 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, revision: input.scene.revision,
+            integrity: input.scene.integrity })), prototypes: prototypes.size, cachedPrototypes, cells: receipts,
+        sources: receipts.reduce((n, receipt) => n + receipt.sources, 0), triangles: receipts.reduce((n, receipt) => n + receipt.triangles, 0),
+        geometryBytes: receipts.reduce((n, receipt) => n + receipt.bytes, 0), geometryEstimatedBytes: receipts.reduce((n, receipt) => n + receipt.estimatedBytes, 0),
+        material: { ...materialArtifact, estimatedBytes: material.estimatedBytes, width: atlasPlan.width, height: atlasPlan.height }, totalMs: performance.now() - started };
+}
+async function mergeCompleteCell(instances, slots, get, origin, signal) {
+    const positions = [], normals = [], uvs = [], indices = [], sources = [];
+    const vector = new three_1.Vector3();
+    for (const [owner, instance] of instances.entries()) {
+        signal?.throwIfAborted();
+        const prototype = await get(instance.key), geometry = prototype.geometry, slot = slots.get(instance.key);
+        const base = positions.length / 3, normalMatrix = new three_1.Matrix3().getNormalMatrix(instance.matrix), reflected = instance.matrix.determinant() < 0;
+        if (indices.length + geometry.indices.length > 1_500_000 || base + geometry.positions.length / 3 > 1_500_000) {
+            throw new Error('Complete HLOD cell exceeds its geometry budget; choose a smaller coarse cell size');
+        }
+        for (let i = 0; i < geometry.positions.length / 3; i++) {
+            vector.fromArray(geometry.positions, i * 3).applyMatrix4(instance.matrix);
+            positions.push(vector.x - origin[0], vector.y - origin[1], vector.z - origin[2]);
+            vector.fromArray(geometry.normals, i * 3).applyMatrix3(normalMatrix).normalize();
+            normals.push(vector.x, vector.y, vector.z);
+            uvs.push(slot.uv[0] + geometry.uvs[i * 2] * slot.uv[2], slot.uv[1] + geometry.uvs[i * 2 + 1] * slot.uv[3]);
+            sources.push(owner);
+        }
+        for (let i = 0; i < geometry.indices.length; i += 3)
+            for (const offset of reflected ? [0, 2, 1] : [0, 1, 2])
+                indices.push(base + geometry.indices[i + offset]);
+    }
+    return { positions: new Float32Array(positions), normals: new Float32Array(normals), uvs: new Float32Array(uvs),
+        indices: new Uint32Array(indices), sources: new Uint16Array(sources) };
+}
+//# sourceMappingURL=complete.js.map

package/dist/sceneHlod/complete.js.map

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

package/dist/sceneHlod/completePrototype.d.ts

@@ -0,0 +1,39 @@
+import type { HelixSceneV2, SceneBounds, SceneHlodCompleteBakeSettings, SceneHlodLayer, SceneNode } from '@hypersoniclabs/helix-manifest';
+import type { HlodGeometry } from './types';
+export declare const COMPLETE_HLOD_BAKER_VERSION = 2;
+export interface CompletePrototype {
+    key: string;
+    bounds: SceneBounds;
+    geometry: HlodGeometry;
+    baseColor: Uint8Array;
+    normal: Uint8Array;
+    orm: Uint8Array;
+    emissive?: Uint8Array;
+    metrics: {
+        sourceTriangles: number;
+        sourceDraws: number;
+        triangles: number;
+        method: string;
+        sampled: number;
+        projectionDistanceM: number;
+    };
+}
+export interface PrototypeInput {
+    key: string;
+    scene: HelixSceneV2;
+    node: SceneNode;
+    layer: SceneHlodLayer;
+    scale: number;
+    settings: SceneHlodCompleteBakeSettings;
+}
+export declare function atomicHlodCache(file: string, text: string): Promise<void>;
+export declare function encodeCompletePrototype(prototype: CompletePrototype): string;
+export declare function readCompletePrototype(cache: string, key: string): Promise<CompletePrototype | null>;
+/** Bake immutable prototype appearance once; instance transforms are merged into spatial cells later. */
+export declare function bakeCompletePrototype(input: PrototypeInput, root: string, cache: string, options: {
+    force?: boolean;
+    signal?: AbortSignal;
+}): Promise<{
+    prototype: CompletePrototype;
+    cached: boolean;
+}>;

package/dist/sceneHlod/completePrototype.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPLETE_HLOD_BAKER_VERSION = void 0;
+exports.atomicHlodCache = atomicHlodCache;
+exports.encodeCompletePrototype = encodeCompletePrototype;
+exports.readCompletePrototype = readCompletePrototype;
+exports.bakeCompletePrototype = bakeCompletePrototype;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const approximate_1 = require("./approximate");
+const geometry_1 = require("./geometry");
+const transfer_1 = require("./transfer");
+const source_1 = require("./source");
+exports.COMPLETE_HLOD_BAKER_VERSION = 2;
+async function atomicHlodCache(file, text) {
+    const temporary = file + '.' + (0, node_crypto_1.randomUUID)() + '.pending';
+    try {
+        await (0, promises_1.writeFile)(temporary, text, { flag: 'wx' });
+        await (0, promises_1.rename)(temporary, file);
+    }
+    finally {
+        await (0, promises_1.unlink)(temporary).catch(error => { if (error.code !== 'ENOENT')
+            throw error; });
+    }
+}
+function encodeCompletePrototype(prototype) {
+    const encode = (value) => Buffer.from(value.buffer, value.byteOffset, value.byteLength).toString('base64');
+    const data = { key: prototype.key, bounds: prototype.bounds, metrics: prototype.metrics,
+        geometry: Object.fromEntries(Object.entries(prototype.geometry).map(([key, array]) => [key, encode(array)])),
+        maps: Object.fromEntries(['baseColor', 'normal', 'orm', 'emissive'].flatMap(key => {
+            const array = prototype[key];
+            return array ? [[key, encode(array)]] : [];
+        })) };
+    const payload = JSON.stringify(data);
+    return JSON.stringify({ hash: (0, source_1.hlodDigest)(payload), payload });
+}
+async function readCompletePrototype(cache, key) {
+    try {
+        const file = await (0, source_1.hlodLocalPath)(cache, key + '.json');
+        if ((await (0, promises_1.stat)(file)).size > 128 * 1048576)
+            throw new Error('HLOD prototype cache exceeds its bounded size');
+        const envelope = JSON.parse(await (0, promises_1.readFile)(file, 'utf8'));
+        if ((0, source_1.hlodDigest)(envelope.payload) !== envelope.hash)
+            return null;
+        const saved = JSON.parse(envelope.payload);
+        if (saved.key !== key)
+            return null;
+        const geometry = Object.fromEntries(Object.entries(saved.geometry).map(([name, data]) => {
+            const bytes = Buffer.from(data, 'base64'), array = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+            return [name, name === 'indices' ? new Uint32Array(array) : new Float32Array(array)];
+        }));
+        return { key, bounds: saved.bounds, metrics: saved.metrics, geometry,
+            ...Object.fromEntries(Object.entries(saved.maps).map(([name, data]) => [name, Buffer.from(data, 'base64')])) };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT' || error instanceof SyntaxError)
+            return null;
+        throw error;
+    }
+}
+/** Bake immutable prototype appearance once; instance transforms are merged into spatial cells later. */
+async function bakeCompletePrototype(input, root, cache, options) {
+    options.signal?.throwIfAborted();
+    if (!options.force) {
+        const cached = await readCompletePrototype(cache, input.key);
+        if (cached)
+            return { prototype: cached, cached: true };
+    }
+    const node = { ...input.node, transform: { position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] } };
+    delete node.parent;
+    const source = await (0, source_1.readHlodClusterSource)({ ...input.scene, nodes: [node] }, root, [node.id], [0, 0, 0], options.signal);
+    const maxErrorM = input.layer.maxErrorM / input.scale, voxelSizeM = input.settings.voxelSizeM / input.scale;
+    const limits = { atlasSize: 128, maxErrorM, triangleRatio: input.layer.triangleRatio, signal: options.signal };
+    let simplified, approximation;
+    let simplifyFailure;
+    try {
+        simplified = await (0, geometry_1.simplifyHlodSurface)(source.surface, limits);
+    }
+    catch (error) {
+        options.signal?.throwIfAborted();
+        simplifyFailure = error;
+    }
+    if (voxelSizeM >= .001 && voxelSizeM <= 16) {
+        try {
+            approximation = await (0, approximate_1.approximateHlodGeometry)(source.surface, { voxelSizeM, maxErrorM: maxErrorM / 2,
+                triangleRatio: limits.triangleRatio, signal: options.signal });
+        }
+        catch {
+            options.signal?.throwIfAborted();
+        }
+    }
+    let chosen = approximation && (!simplified || approximation.geometry.indices.length < simplified.geometry.indices.length * .75) ? approximation : simplified;
+    if (!chosen)
+        throw simplifyFailure ?? new Error('HLOD source could not be approximated within the bounded grid');
+    let method = chosen === approximation ? 'exterior' : 'simplify';
+    const extent = Math.max(...source.bounds.max.map((value, axis) => value - source.bounds.min[axis])) * input.scale;
+    const tile = Math.max(input.settings.minTileSize, Math.min(input.settings.maxTileSize, 2 ** Math.ceil(Math.log2(Math.max(1e-6, extent * input.settings.texelsPerM)))));
+    const size = Math.max(128, tile);
+    let geometry = await (0, geometry_1.unwrapHlodGeometry)(chosen.geometry, size, options.signal);
+    let transferred = (0, transfer_1.transferHlodSurface)(source.surface, source.materials, geometry, size, Math.max(1e-4, maxErrorM * 2, voxelSizeM * 4), options.signal);
+    // A geometric error metric does not bound material projection through every opening. Retry only the failing prototype.
+    for (const error of [maxErrorM, maxErrorM / 2, maxErrorM / 4, 0]) {
+        if (!transferred.misses && transferred.sampled)
+            break;
+        chosen = await (0, geometry_1.simplifyHlodSurface)(source.surface, { ...limits, maxErrorM: error, ...(error === 0 ? { triangleRatio: 1 } : {}) });
+        geometry = await (0, geometry_1.unwrapHlodGeometry)(chosen.geometry, size, options.signal);
+        transferred = (0, transfer_1.transferHlodSurface)(source.surface, source.materials, geometry, size, Math.max(1e-4, maxErrorM * 2), options.signal);
+        method = `projection-fallback:${error}`;
+    }
+    if (transferred.misses || !transferred.sampled)
+        throw new Error(`HLOD ${node.id}: no complete original-source material projection`);
+    const prototype = { key: input.key, bounds: source.bounds, geometry, baseColor: transferred.baseColor,
+        normal: transferred.normal, orm: transferred.orm, ...(transferred.emissive ? { emissive: transferred.emissive } : {}),
+        metrics: { sourceTriangles: source.surface.indices.length / 3, sourceDraws: source.drawCalls, triangles: geometry.indices.length / 3,
+            method, sampled: transferred.sampled, projectionDistanceM: transferred.maxDistanceM } };
+    options.signal?.throwIfAborted();
+    await atomicHlodCache((0, node_path_1.resolve)(cache, input.key + '.json'), encodeCompletePrototype(prototype));
+    return { prototype, cached: false };
+}
+//# sourceMappingURL=completePrototype.js.map

package/dist/sceneHlod/completePrototype.js.map

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

package/dist/sceneHlod/geometry.d.ts

@@ -0,0 +1,6 @@
+import type { HlodBakeOptions, HlodGeometry, HlodSurface } from './types';
+export declare function simplifyHlodSurface(source: Pick<HlodSurface, 'positions' | 'indices'>, options: HlodBakeOptions): Promise<{
+    geometry: HlodGeometry;
+    errorM: number;
+}>;
+export declare function unwrapHlodGeometry(geometry: HlodGeometry, size: number, signal?: AbortSignal): Promise<HlodGeometry>;

package/dist/sceneHlod/geometry.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simplifyHlodSurface = simplifyHlodSurface;
+exports.unwrapHlodGeometry = unwrapHlodGeometry;
+const meshoptimizer_1 = require("meshoptimizer");
+const esm_1 = require("../character/esm");
+const surfaceBvh_1 = require("../mesh/surfaceBvh");
+let atlasModule;
+async function simplifyHlodSurface(source, options) {
+    options.signal?.throwIfAborted();
+    await meshoptimizer_1.MeshoptSimplifier.ready;
+    const vertices = [], slots = new Map(), remap = new Uint32Array(source.positions.length / 3);
+    // Remove UV/normal/material seams from the simplifier's input; the source surface retains them for rebaking.
+    for (let i = 0; i < remap.length; i++) {
+        const x = source.positions[i * 3], y = source.positions[i * 3 + 1], z = source.positions[i * 3 + 2];
+        const key = `${x},${y},${z}`;
+        let index = slots.get(key);
+        if (index === undefined) {
+            index = vertices.length / 3;
+            slots.set(key, index);
+            vertices.push(x, y, z);
+        }
+        remap[i] = index;
+    }
+    const positions = new Float32Array(vertices), welded = [];
+    for (let i = 0; i < source.indices.length; i += 3) {
+        const a = remap[source.indices[i]], b = remap[source.indices[i + 1]], c = remap[source.indices[i + 2]];
+        if (a !== b && b !== c && a !== c)
+            welded.push(a, b, c);
+    }
+    const target = Math.max(12, Math.floor(welded.length / 3 * options.triangleRatio)) * 3;
+    const [reduced, errorM] = meshoptimizer_1.MeshoptSimplifier.simplify(new Uint32Array(welded), positions, 3, Math.min(welded.length, target), options.maxErrorM, ['ErrorAbsolute']);
+    if (!reduced.length)
+        throw new Error('HLOD simplification produced no surface');
+    // Share smooth corners while splitting architectural creases. Per-triangle seams waste atlas space and amplify mip noise.
+    const faces = new Float32Array(reduced.length), incident = Array.from({ length: positions.length / 3 }, () => []);
+    for (let i = 0; i < reduced.length; i += 3) {
+        const normal = (0, surfaceBvh_1.faceNormal)(positions, reduced[i], reduced[i + 1], reduced[i + 2]);
+        faces.set(normal, i);
+        for (let k = 0; k < 3; k++)
+            incident[reduced[i + k]].push(i);
+    }
+    const outputPositions = [], outputNormals = [], corners = new Map(), indices = new Uint32Array(reduced.length);
+    for (let i = 0; i < reduced.length; i++) {
+        const face = Math.floor(i / 3) * 3, vertex = reduced[i];
+        let nx = 0, ny = 0, nz = 0;
+        for (const other of incident[vertex]) {
+            const dot = faces[face] * faces[other] + faces[face + 1] * faces[other + 1] + faces[face + 2] * faces[other + 2];
+            if (dot < Math.SQRT1_2)
+                continue;
+            nx += faces[other];
+            ny += faces[other + 1];
+            nz += faces[other + 2];
+        }
+        const length = Math.hypot(nx, ny, nz) || 1;
+        nx /= length;
+        ny /= length;
+        nz /= length;
+        const key = `${vertex}:${nx.toFixed(6)},${ny.toFixed(6)},${nz.toFixed(6)}`;
+        let corner = corners.get(key);
+        if (corner === undefined) {
+            corner = outputPositions.length / 3;
+            corners.set(key, corner);
+            outputPositions.push(positions[vertex * 3], positions[vertex * 3 + 1], positions[vertex * 3 + 2]);
+            outputNormals.push(nx, ny, nz);
+        }
+        indices[i] = corner;
+    }
+    options.signal?.throwIfAborted();
+    return { geometry: { positions: new Float32Array(outputPositions), normals: new Float32Array(outputNormals), indices,
+            uvs: new Float32Array(outputPositions.length / 3 * 2) }, errorM };
+}
+async function unwrapHlodGeometry(geometry, size, signal) {
+    atlasModule ??= (async () => { const m = await (0, esm_1.importEsm)('watlas'); await m.Initialize(); return m; })();
+    const watlas = await atlasModule;
+    signal?.throwIfAborted();
+    const atlas = new watlas.Atlas();
+    try {
+        atlas.addMesh({ vertexPositionData: geometry.positions, vertexPositionStride: 12, vertexCount: geometry.positions.length / 3,
+            vertexNormalData: geometry.normals, vertexNormalStride: 12, indexData: geometry.indices, indexCount: geometry.indices.length });
+        atlas.generate({}, { resolution: size, padding: 4, bilinear: true, blockAlign: true });
+        if (atlas.atlasCount !== 1 || !atlas.width || !atlas.height)
+            throw new Error('HLOD UV charts exceed a single bounded atlas; split the cluster');
+        const mesh = atlas.getMesh(0), positions = new Float32Array(mesh.vertexCount * 3), normals = new Float32Array(positions.length);
+        const uvs = new Float32Array(mesh.vertexCount * 2), indices = new Uint32Array(mesh.indexCount);
+        mesh.getIndexArray(indices);
+        for (let i = 0; i < mesh.vertexCount; i++) {
+            const vertex = mesh.getVertex(i);
+            positions.set(geometry.positions.subarray(vertex.xref * 3, vertex.xref * 3 + 3), i * 3);
+            normals.set(geometry.normals.subarray(vertex.xref * 3, vertex.xref * 3 + 3), i * 3);
+            uvs[i * 2] = vertex.uv[0] / atlas.width;
+            uvs[i * 2 + 1] = vertex.uv[1] / atlas.height;
+        }
+        signal?.throwIfAborted();
+        return { positions, normals, uvs, indices };
+    }
+    finally {
+        atlas.delete();
+    }
+}
+//# sourceMappingURL=geometry.js.map

package/dist/sceneHlod/geometry.js.map

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

package/dist/sceneHlod/imageSampling.d.ts

@@ -0,0 +1,11 @@
+import type { HlodImage, HlodSurface } from './types';
+type Color = [number, number, number, number];
+/** Source UV change across one destination texel: du/dx, dv/dx, du/dy, dv/dy. */
+export type HlodUvFootprint = [number, number, number, number];
+/** Decode color to linear before filtering; scalar and encoded normal channels stay linear. */
+export declare function sampleHlodImage(image: HlodImage | undefined, u: number, v: number, color: boolean): Color;
+/** Per-transfer cache: mip bytes are shared across texture bindings and released with the bake. */
+export declare function createHlodImageSampler(signal?: AbortSignal): (image: HlodImage | undefined, u: number, v: number, color: boolean, footprint: HlodUvFootprint) => Color;
+/** Project destination world-space derivatives onto the original triangle's UV parameterization. */
+export declare function sourceUvFootprint(source: HlodSurface, a: number, b: number, c: number, dx: readonly number[], dy: readonly number[]): HlodUvFootprint;
+export {};