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

package/dist/sceneImport/fbx.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simplifiedProxyArtifact = void 0;
+exports.inspectFbxTextureReferences = inspectFbxTextureReferences;
+exports.splitObject3DIntoPlacements = splitObject3DIntoPlacements;
+exports.resetLocalTransform = resetLocalTransform;
+exports.compileFbxPlacedAssets = compileFbxPlacedAssets;
+exports.compileFbxGeometryGlbs = compileFbxGeometryGlbs;
+const promises_1 = require("node:fs/promises");
+const three_1 = require("three");
+const esm_1 = require("../character/esm");
+const simplifyMesh_1 = require("../character/stages/simplifyMesh");
+const proxy_1 = require("./proxy");
+const bistroMaterialBake_1 = require("./bistroMaterialBake");
+const bistroTexturePlan_1 = require("./bistroTexturePlan");
+const types_1 = require("./types");
+const gltfIo_1 = require("./gltfIo");
+const DEFAULT_MAX_TEXTURE_DIMENSION = 1024;
+async function parseFbxRoot(source) {
+    (0, bistroMaterialBake_1.installNodeDomShims)();
+    const arrayBuffer = source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+    const { FBXLoader } = await (0, esm_1.importEsm)('three/examples/jsm/loaders/FBXLoader.js');
+    const loader = new FBXLoader();
+    // FBXLoader constructs its TextureLoader during parse(). This handler keeps
+    // only the source-relative reference; Bridge resolves immutable bytes later.
+    const textureReferenceLoader = {
+        path: '',
+        setPath(path) {
+            this.path = path ?? '';
+            return this;
+        },
+        load(url) {
+            const texture = new three_1.Texture();
+            (0, bistroMaterialBake_1.recordTextureSource)(texture, url);
+            return texture;
+        },
+    };
+    const textureHandlerPattern = /\.(?:dds|tga)$/i;
+    loader.manager.addHandler(textureHandlerPattern, textureReferenceLoader);
+    try {
+        return loader.parse(arrayBuffer, '');
+    }
+    finally {
+        loader.manager.removeHandler(textureHandlerPattern);
+    }
+}
+/** Returns the exact texture references consumed by the FBX material baker. */
+async function inspectFbxTextureReferences(path) {
+    const root = await parseFbxRoot(await (0, promises_1.readFile)(path));
+    return [...new Set([...(0, bistroMaterialBake_1.collectMaterialTextureRoles)(root).values()].flatMap((role) => Object.values(role)))].sort();
+}
+/**
+ * Splits one parsed source scene into individually placeable assets: every
+ * direct child of the root whose subtree carries meshes becomes one placement,
+ * keeping the child's WORLD transform as the placement transform.
+ *
+ * The placement transform must be the world transform, not the child's local
+ * one: the exported per-asset GLB carries the child's local TRS on its root
+ * node, and the Scene v2 node applies the placement ON TOP of that — using the
+ * local transform would apply it twice. Callers zero the child's local
+ * transform before export (resetLocalTransform) so the GLB holds pure
+ * asset-local geometry and the Scene v2 transform holds the whole story.
+ */
+function splitObject3DIntoPlacements(root) {
+    root.updateMatrixWorld(true);
+    const containsMesh = (node) => {
+        let found = false;
+        node.traverse((child) => {
+            if (child.isMesh)
+                found = true;
+        });
+        return found;
+    };
+    const placements = [];
+    childrenOf(root).forEach((child, index) => {
+        if (!containsMesh(child))
+            return;
+        const position = new three_1.Vector3();
+        const quaternion = new three_1.Quaternion();
+        const scale = new three_1.Vector3();
+        child.matrixWorld.decompose(position, quaternion, scale);
+        const rotation = [
+            quaternion.x,
+            quaternion.y,
+            quaternion.z,
+            quaternion.w,
+        ];
+        const positionOut = [position.x, position.y, position.z];
+        const scaleOut = [scale.x, scale.y, scale.z];
+        (0, types_1.assertFiniteVec3)(positionOut, `source asset ${child.name || index} position`);
+        (0, types_1.assertFiniteVec3)(rotation.slice(0, 3), `source asset ${child.name || index} rotation`);
+        if (!Number.isFinite(rotation[3]))
+            throw new Error(`source asset ${child.name || index} rotation must be finite`);
+        (0, types_1.assertFiniteVec3)(scaleOut, `source asset ${child.name || index} scale`);
+        placements.push({
+            name: stableId(child.name || `asset-${index}`),
+            transform: { position: positionOut, rotation, scale: scaleOut },
+            subtree: child,
+        });
+    });
+    if (!placements.length && containsMesh(root)) {
+        placements.push({
+            name: stableId(root.name || 'scene'),
+            transform: { position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] },
+            subtree: root,
+        });
+    }
+    return placements;
+}
+function childrenOf(root) {
+    return [...root.children];
+}
+/** Zeros a subtree's LOCAL transform so its exported GLB carries pure asset-local geometry. */
+function resetLocalTransform(node) {
+    node.position.set(0, 0, 0);
+    node.quaternion.identity();
+    node.scale.set(1, 1, 1);
+    node.updateMatrixWorld(true);
+}
+/**
+ * Compiles each mesh-carrying child of one FBX file into its own detail+proxy
+ * GLB pair, preserving the child's source world transform for Scene v2
+ * placement. Texture decoding and material self-containment run once per FILE
+ * (materials are shared across siblings); export, simplification and baking run
+ * per ASSET, so a pack of many small props does not pay Bistro-scale costs N
+ * times over.
+ */
+async function compileFbxPlacedAssets(input) {
+    const root = await parseFbxRoot(await (0, promises_1.readFile)(input.path));
+    root.updateMatrixWorld(true);
+    const materialRoles = (0, bistroMaterialBake_1.collectMaterialTextureRoles)(root);
+    const referencedBasenames = [...new Set([...materialRoles.values()].flatMap((role) => Object.values(role)))];
+    const { images, unsupported: bakeUnsupported } = await (0, bistroMaterialBake_1.decodeReferencedTextures)(referencedBasenames, input.resolveTextures, input.maxTextureDimension ?? DEFAULT_MAX_TEXTURE_DIMENSION, input.maxDecodedTextureBytes);
+    makeMaterialsSelfContained(root);
+    const io = (0, gltfIo_1.sceneGltfIo)();
+    const placements = [];
+    for (const placement of splitObject3DIntoPlacements(root)) {
+        resetLocalTransform(placement.subtree);
+        const { GLTFExporter } = await (0, esm_1.importEsm)('three/examples/jsm/exporters/GLTFExporter.js');
+        const exported = await new GLTFExporter().parseAsync(placement.subtree, {
+            animations: [],
+            binary: true,
+            onlyVisible: false,
+            trs: true,
+        });
+        if (!(exported instanceof ArrayBuffer)) {
+            throw new Error(`${placement.name}: FBX conversion did not produce a GLB`);
+        }
+        const detailDocument = await io.readBinary(new Uint8Array(exported));
+        await (0, simplifyMesh_1.simplifyToTarget)(detailDocument, input.detailTargetTriangles ?? 350_000, 0.03, false);
+        (0, bistroMaterialBake_1.bakeMaterialTextures)(detailDocument, materialRoles, images);
+        detailDocument.getRoot().setExtras({ helixSource: input.receipt });
+        const detail = await (0, proxy_1.artifactFromDocument)(io, detailDocument, `${placement.name}.detail.glb`, boundsFromObject(placement.subtree));
+        const proxy = await (0, proxy_1.simplifiedProxyArtifact)(io, detail, placement.name, input.proxyTargetTriangles);
+        placements.push({
+            name: placement.name,
+            transform: placement.transform,
+            detail,
+            proxy: proxy.proxy,
+            proxyReduction: proxy.reduction,
+        });
+    }
+    if (!placements.length)
+        throw new Error(`${input.sourceName} contains no mesh-carrying nodes`);
+    return { placements, unsupported: bakeUnsupported };
+}
+/**
+ * Derives the collision proxy from one compiled detail artifact: flat default
+ * material, meshopt-simplified, pruned. Shared with every intake format — see
+ * proxy.ts, which owns the implementation.
+ */
+var proxy_2 = require("./proxy");
+Object.defineProperty(exports, "simplifiedProxyArtifact", { enumerable: true, get: function () { return proxy_2.simplifiedProxyArtifact; } });
+async function compileFbxGeometryGlbs(input) {
+    const root = await parseFbxRoot(await (0, promises_1.readFile)(input.path));
+    root.updateMatrixWorld(true);
+    const materialRoles = (0, bistroMaterialBake_1.collectMaterialTextureRoles)(root);
+    const referencedBasenames = [...new Set([...materialRoles.values()].flatMap((role) => Object.values(role)))];
+    const detailPlan = createDetailPlan(root, referencedBasenames);
+    const { images, unsupported: bakeUnsupported } = await (0, bistroMaterialBake_1.decodeReferencedTextures)(referencedBasenames, input.resolveTextures, input.maxTextureDimension ?? DEFAULT_MAX_TEXTURE_DIMENSION, input.maxDecodedTextureBytes);
+    const unsupported = [...detailPlan.unsupported, ...bakeUnsupported];
+    const finalDetailPlan = { ...detailPlan, unsupported };
+    const effectiveReceipt = {
+        ...input.receipt,
+        unsupported,
+    };
+    makeMaterialsSelfContained(root);
+    const { GLTFExporter } = await (0, esm_1.importEsm)('three/examples/jsm/exporters/GLTFExporter.js');
+    const exported = await new GLTFExporter().parseAsync(root, {
+        animations: [],
+        binary: true,
+        onlyVisible: false,
+        trs: true,
+    });
+    if (!(exported instanceof ArrayBuffer))
+        throw new Error('FBX conversion did not produce a GLB');
+    const io = (0, gltfIo_1.sceneGltfIo)();
+    const detailDocument = await io.readBinary(new Uint8Array(exported));
+    await (0, simplifyMesh_1.simplifyToTarget)(detailDocument, input.detailTargetTriangles ?? 350_000, 0.03, false);
+    (0, bistroMaterialBake_1.bakeMaterialTextures)(detailDocument, materialRoles, images);
+    detailDocument.getRoot().setExtras({ helixSource: effectiveReceipt, bistroDetailPlan: finalDetailPlan });
+    const detail = await (0, proxy_1.artifactFromDocument)(io, detailDocument, input.sourceName.replace(/\.fbx$/i, '.detail.glb'), boundsFromObject(root));
+    // One measured proxy, one gate: proxy.ts owns simplification AND the decision
+    // to keep the result. A whole-sheet proxy that did not get smaller is dropped
+    // and the caller declares a single-level LOD rather than shipping a twin.
+    const proxy = await (0, proxy_1.simplifiedProxyArtifact)(io, detail, input.sourceName.replace(/\.fbx$/i, ''), input.proxyTargetTriangles ?? 60_000);
+    for (const warning of (0, proxy_1.proxyReductionWarnings)([proxy.reduction]))
+        console.warn(warning);
+    return { proxy: proxy.proxy, proxyReduction: proxy.reduction, detail, detailPlan: finalDetailPlan };
+}
+function createDetailPlan(root, texturePaths) {
+    const sourceNodes = [];
+    const materialAssignments = [];
+    const seenIds = new Map();
+    const nodeIds = new Map();
+    let sourceLightCount = 0;
+    root.traverse((node) => {
+        if (node === root)
+            return;
+        const base = stableId(node.name || node.type);
+        const count = seenIds.get(base) ?? 0;
+        seenIds.set(base, count + 1);
+        const id = count ? `${base}.${count}` : base;
+        nodeIds.set(node, id);
+        const position = [node.position.x, node.position.y, node.position.z];
+        const rotation = [
+            node.quaternion.x,
+            node.quaternion.y,
+            node.quaternion.z,
+            node.quaternion.w,
+        ];
+        const scale = [node.scale.x, node.scale.y, node.scale.z];
+        (0, types_1.assertFiniteVec3)(position, `FBX node ${id} position`);
+        (0, types_1.assertFiniteVec3)(rotation.slice(0, 3), `FBX node ${id} rotation`);
+        if (!Number.isFinite(rotation[3]))
+            throw new Error(`FBX node ${id} rotation must be finite`);
+        (0, types_1.assertFiniteVec3)(scale, `FBX node ${id} scale`);
+        const mesh = node;
+        if ('isLight' in node && node.isLight === true)
+            sourceLightCount += 1;
+        const materials = mesh.isMesh ? materialNames(mesh.material) : [];
+        const parent = node.parent === root ? null : nodeIds.get(node.parent);
+        if (node.parent !== root && parent === undefined) {
+            throw new Error(`FBX node ${id} appears before its parent in source traversal`);
+        }
+        sourceNodes.push({ id, parent: parent ?? null, position, rotation, scale, materials });
+        if (materials.length)
+            materialAssignments.push({ node: id, materials });
+    });
+    const textures = (0, bistroTexturePlan_1.planBistroTextures)(texturePaths);
+    const unsupported = textures
+        .filter((texture) => texture.role === 'unsupported')
+        .map((texture) => `${texture.source}: ${texture.conversion}`);
+    if (sourceLightCount > 0) {
+        unsupported.push(`${sourceLightCount} FBX light node(s): transforms are preserved in sourceNodes, but Scene v2 light attachments must be authored explicitly before detail publication`);
+    }
+    return {
+        schemaVersion: 'helix.bistro-detail-plan/1',
+        sourceNodes,
+        materialAssignments,
+        textures,
+        unsupported,
+    };
+}
+function makeMaterialsSelfContained(root) {
+    const cache = new Map();
+    root.traverse((node) => {
+        const mesh = node;
+        if (!mesh.isMesh)
+            return;
+        const originals = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        const converted = originals.map((material) => {
+            let replacement = cache.get(material);
+            if (!replacement) {
+                const color = 'color' in material && material.color && typeof material.color === 'object'
+                    ? material.color
+                    : { r: 0.72, g: 0.72, b: 0.72 };
+                replacement = new three_1.MeshStandardMaterial({
+                    name: material.name || 'source-material',
+                    color: new three_1.Color(color.r, color.g, color.b),
+                    roughness: 1,
+                    metalness: 0,
+                    transparent: material.transparent,
+                    opacity: Number.isFinite(material.opacity) ? material.opacity : 1,
+                });
+                cache.set(material, replacement);
+            }
+            return replacement;
+        });
+        mesh.material = Array.isArray(mesh.material) ? converted : converted[0];
+    });
+}
+function boundsFromObject(root) {
+    const box = new three_1.Box3().setFromObject(root);
+    const min = [box.min.x, box.min.y, box.min.z];
+    const max = [box.max.x, box.max.y, box.max.z];
+    (0, types_1.assertFiniteVec3)(min, 'FBX bounds min');
+    (0, types_1.assertFiniteVec3)(max, 'FBX bounds max');
+    return { min, max };
+}
+function materialNames(material) {
+    return (Array.isArray(material) ? material : [material]).map((entry, index) => entry.name || `material-${index}`);
+}
+function stableId(value) {
+    return value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unnamed';
+}
+//# sourceMappingURL=fbx.js.map

package/dist/sceneImport/fbx.js.map

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

package/dist/sceneImport/glbSplit.d.ts

@@ -0,0 +1,24 @@
+import type { CompiledSceneArtifact, Vec3 } from './types';
+/**
+ * Splits one GLB source file into per-root-node placed assets.
+ *
+ * Each mesh-carrying root node of the first scene becomes its own asset whose
+ * Scene v2 placement transform is that node's local TRS; the exported per-asset
+ * GLB carries pure asset-local geometry because the kept root node's transform
+ * is zeroed before serialization. Applying both would double-transform, exactly
+ * as it would for FBX siblings.
+ */
+export type SplitGlbAsset = {
+    name: string;
+    transform: {
+        position: Vec3;
+        rotation: [number, number, number, number];
+        scale: Vec3;
+    };
+    detail: CompiledSceneArtifact;
+};
+export declare function splitGlbIntoPlacements(input: {
+    path?: string;
+    bytes?: Buffer;
+    sourceName: string;
+}): Promise<SplitGlbAsset[]>;

package/dist/sceneImport/glbSplit.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitGlbIntoPlacements = splitGlbIntoPlacements;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const core_1 = require("@gltf-transform/core");
+const functions_1 = require("@gltf-transform/functions");
+const report_1 = require("../character/stages/report");
+const gltfIo_1 = require("./gltfIo");
+async function splitGlbIntoPlacements(input) {
+    const bytes = input.bytes ?? (await (0, promises_1.readFile)(input.path));
+    const io = (0, gltfIo_1.sceneGltfIo)();
+    const document = await io.readBinary(new Uint8Array(bytes));
+    const scene = document.getRoot().listScenes()[0];
+    if (!scene)
+        throw new Error(`${input.sourceName} declares no scene`);
+    const roots = scene.listChildren();
+    const assets = roots.filter(containsMeshSubtree);
+    // A GLB whose meshes all sit below non-root nodes is still one placeable
+    // asset — treat the whole scene as a single identity-placed prop rather than
+    // silently dropping its geometry.
+    const targets = assets.length
+        ? assets.map((node, index) => ({
+            // Always prefixed by the source file. Root nodes routinely carry the
+            // same authoring name ("Cube", "Crate") across a pack's files, and an
+            // unprefixed placement name collides into ONE Scene node id — the
+            // package then fails validation with a duplicate-node error that says
+            // nothing about which two files collided. The FBX branch already
+            // prefixes; this makes GLB match it.
+            name: stableName(`${baseName(input.sourceName)}.${node.getName() || index}`),
+            transform: {
+                position: (node.getTranslation() ?? [0, 0, 0]),
+                rotation: (node.getRotation() ?? [0, 0, 0, 1]),
+                scale: (node.getScale() ?? [1, 1, 1]),
+            },
+        }))
+        : [
+            {
+                name: stableName(baseName(input.sourceName)),
+                transform: { position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] },
+            },
+        ];
+    const results = [];
+    for (const [index, target] of targets.entries()) {
+        const clone = (0, functions_1.cloneDocument)(document);
+        clone.setLogger(new core_1.Logger(core_1.Logger.Verbosity.SILENT));
+        const cloneScene = clone.getRoot().listScenes()[0];
+        if (!cloneScene)
+            throw new Error(`${input.sourceName} clone lost its scene`);
+        const keep = cloneScene.listChildren()[assets.length ? index : 0];
+        if (!keep)
+            throw new Error(`${input.sourceName} clone lost root node ${index}`);
+        for (const sibling of [...cloneScene.listChildren()]) {
+            if (sibling !== keep)
+                cloneScene.removeChild(sibling);
+        }
+        keep.setTranslation([0, 0, 0]).setRotation([0, 0, 0, 1]).setScale([1, 1, 1]);
+        await clone.transform((0, functions_1.prune)());
+        const rawBounds = (0, functions_1.getBounds)(cloneScene);
+        const bounds = {
+            min: [rawBounds.min[0], rawBounds.min[1], rawBounds.min[2]],
+            max: [rawBounds.max[0], rawBounds.max[1], rawBounds.max[2]],
+        };
+        const outBytes = Buffer.from(await io.writeBinary(clone));
+        results.push({
+            name: target.name,
+            transform: target.transform,
+            detail: {
+                filename: `${target.name}.detail.glb`,
+                bytes: outBytes,
+                contentSha256: (0, node_crypto_1.createHash)('sha256').update(outBytes).digest('hex'),
+                bounds,
+                summary: {
+                    triangles: (0, report_1.countTriangles)(clone),
+                    materials: clone.getRoot().listMaterials().length,
+                    textures: clone.getRoot().listTextures().length,
+                    nodes: clone.getRoot().listNodes().length,
+                },
+            },
+        });
+    }
+    return results;
+}
+function containsMeshSubtree(node) {
+    if (node.getMesh())
+        return true;
+    return node.listChildren().some(containsMeshSubtree);
+}
+function baseName(sourceName) {
+    return sourceName.replace(/\.[^.]+$/, '');
+}
+function stableName(value) {
+    return value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'asset';
+}
+//# sourceMappingURL=glbSplit.js.map

package/dist/sceneImport/glbSplit.js.map

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

package/dist/sceneImport/gltfIo.d.ts

@@ -0,0 +1,32 @@
+import { NodeIO } from '@gltf-transform/core';
+/**
+ * The ONE glTF IO for the scene-import path.
+ *
+ * Every call site here used to construct a bare `new NodeIO()`. A bare NodeIO
+ * has no extensions registered, and glTF marks KHR_texture_basisu as REQUIRED
+ * (a KTX2 payload is unreadable without a transcoder), so reading any
+ * KTX2-bearing GLB threw:
+ *
+ *     Missing required extension, "KHR_texture_basisu".
+ *
+ * That made compile-pack structurally unable to ingest KTX2. It is why the
+ * Pacifica mall shipped 600 encoded KTX2 textures that nothing could bind, and
+ * why the published groups still carry per-material seed anchors: not a stage
+ * anyone forgot to run, a capability that did not exist.
+ *
+ * This is a FACTORY rather than nine inline `.registerExtensions(...)` calls on
+ * purpose. Fixing only the site that threw leaves the next bare NodeIO
+ * downstream to reproduce the same bug with a different symptom — and the
+ * symptom is nasty, because a dropped extension looks exactly like the
+ * untextured state we are trying to leave. `gltfIo.spec.ts` asserts that no
+ * bare `new NodeIO(` survives anywhere in this directory.
+ *
+ * Scope is deliberately KHR_texture_basisu ONLY, not ALL_EXTENSIONS (which is
+ * what `character/` and `gesture/` use). Registering an extension changes what
+ * survives a round-trip: an OPTIONAL extension that a bare NodeIO silently
+ * drops today would start being preserved, changing the bytes of assets that
+ * have nothing to do with textures. This CLI is shared by other lanes, so the
+ * regression bar is that existing non-KTX2 assets compile byte-identically —
+ * and the narrow registration is what makes that bar meetable and provable.
+ */
+export declare function sceneGltfIo(): NodeIO;

package/dist/sceneImport/gltfIo.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sceneGltfIo = sceneGltfIo;
+const core_1 = require("@gltf-transform/core");
+const extensions_1 = require("@gltf-transform/extensions");
+/**
+ * The ONE glTF IO for the scene-import path.
+ *
+ * Every call site here used to construct a bare `new NodeIO()`. A bare NodeIO
+ * has no extensions registered, and glTF marks KHR_texture_basisu as REQUIRED
+ * (a KTX2 payload is unreadable without a transcoder), so reading any
+ * KTX2-bearing GLB threw:
+ *
+ *     Missing required extension, "KHR_texture_basisu".
+ *
+ * That made compile-pack structurally unable to ingest KTX2. It is why the
+ * Pacifica mall shipped 600 encoded KTX2 textures that nothing could bind, and
+ * why the published groups still carry per-material seed anchors: not a stage
+ * anyone forgot to run, a capability that did not exist.
+ *
+ * This is a FACTORY rather than nine inline `.registerExtensions(...)` calls on
+ * purpose. Fixing only the site that threw leaves the next bare NodeIO
+ * downstream to reproduce the same bug with a different symptom — and the
+ * symptom is nasty, because a dropped extension looks exactly like the
+ * untextured state we are trying to leave. `gltfIo.spec.ts` asserts that no
+ * bare `new NodeIO(` survives anywhere in this directory.
+ *
+ * Scope is deliberately KHR_texture_basisu ONLY, not ALL_EXTENSIONS (which is
+ * what `character/` and `gesture/` use). Registering an extension changes what
+ * survives a round-trip: an OPTIONAL extension that a bare NodeIO silently
+ * drops today would start being preserved, changing the bytes of assets that
+ * have nothing to do with textures. This CLI is shared by other lanes, so the
+ * regression bar is that existing non-KTX2 assets compile byte-identically —
+ * and the narrow registration is what makes that bar meetable and provable.
+ */
+function sceneGltfIo() {
+    return new core_1.NodeIO().registerExtensions([extensions_1.KHRTextureBasisu]);
+}
+//# sourceMappingURL=gltfIo.js.map

package/dist/sceneImport/gltfIo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltfIo.js","sourceRoot":"","sources":["../../src/sceneImport/gltfIo.ts"],"names":[],"mappings":";;AAiCA,kCAEC;AAnCD,+CAA8C;AAC9C,2DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,WAAW;IACzB,OAAO,IAAI,aAAM,EAAE,CAAC,kBAAkB,CAAC,CAAC,6BAAgB,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/sceneImport/helsinkiTiles.d.ts

@@ -0,0 +1,31 @@
+export declare const HELSINKI_TILE = "672496d1";
+export declare const HELSINKI_TILE_PREFIX = "Tile_+033_+019";
+export declare const HELSINKI_PROXY_OBJ = "672496d1/Tile_+033_+019_L13.obj";
+/**
+ * Which refinement level of the photogrammetry quadtree becomes the streamed
+ * detail mesh. The source stores levels 13 through 21; 16 is a single mesh for
+ * the whole 250 m tile and is visibly coarse underfoot, while each further
+ * level quadruples the piece count and roughly triples the bytes.
+ *
+ * 18 is also the deepest level this importer can address at all. Levels 16-18
+ * are a COMPLETE quadtree (1, 4, 16 pieces), but the source prunes and
+ * re-splits below that -- level 19 carries 68 pieces where a complete tree
+ * would have 64, and levels 20 and 21 carry 68 as well. Generated paths stop
+ * describing the archive at that point, so reaching deeper means reading the
+ * real tree out of the inventory rather than raising this number.
+ */
+export declare const HELSINKI_DETAIL_LEVEL = 18;
+export declare const HELSINKI_MAX_COMPLETE_LEVEL = 18;
+/**
+ * Every mesh at `level` beneath the tile's single level-16 node.
+ *
+ * The quadtree names each piece by its path from the root: level 16 is `000`,
+ * level 17 is `000` plus one base-4 digit, level 18 `000` plus two, and so on.
+ * The paths are generated rather than read back from the archive so the
+ * extractor keeps its explicit allowlist -- nothing is extracted because the
+ * archive happened to name it.
+ */
+export declare function helsinkiDetailMembers(level: number): Array<{
+    obj: string;
+    texture: string;
+}>;

package/dist/sceneImport/helsinkiTiles.js

@@ -0,0 +1,52 @@
+"use strict";
+// Addressing for the Helsinki 3D photogrammetry archive's quadtree.
+//
+// Kept in its own module with no heavy imports: `compiler.ts` pulls in the FBX
+// loader, which is ESM-only and cannot be required from the Jest environment,
+// so anything a test needs to reach must not sit behind it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELSINKI_MAX_COMPLETE_LEVEL = exports.HELSINKI_DETAIL_LEVEL = exports.HELSINKI_PROXY_OBJ = exports.HELSINKI_TILE_PREFIX = exports.HELSINKI_TILE = void 0;
+exports.helsinkiDetailMembers = helsinkiDetailMembers;
+exports.HELSINKI_TILE = '672496d1';
+exports.HELSINKI_TILE_PREFIX = 'Tile_+033_+019';
+exports.HELSINKI_PROXY_OBJ = `${exports.HELSINKI_TILE}/${exports.HELSINKI_TILE_PREFIX}_L13.obj`;
+/**
+ * Which refinement level of the photogrammetry quadtree becomes the streamed
+ * detail mesh. The source stores levels 13 through 21; 16 is a single mesh for
+ * the whole 250 m tile and is visibly coarse underfoot, while each further
+ * level quadruples the piece count and roughly triples the bytes.
+ *
+ * 18 is also the deepest level this importer can address at all. Levels 16-18
+ * are a COMPLETE quadtree (1, 4, 16 pieces), but the source prunes and
+ * re-splits below that -- level 19 carries 68 pieces where a complete tree
+ * would have 64, and levels 20 and 21 carry 68 as well. Generated paths stop
+ * describing the archive at that point, so reaching deeper means reading the
+ * real tree out of the inventory rather than raising this number.
+ */
+exports.HELSINKI_DETAIL_LEVEL = 18;
+exports.HELSINKI_MAX_COMPLETE_LEVEL = 18;
+/**
+ * Every mesh at `level` beneath the tile's single level-16 node.
+ *
+ * The quadtree names each piece by its path from the root: level 16 is `000`,
+ * level 17 is `000` plus one base-4 digit, level 18 `000` plus two, and so on.
+ * The paths are generated rather than read back from the archive so the
+ * extractor keeps its explicit allowlist -- nothing is extracted because the
+ * archive happened to name it.
+ */
+function helsinkiDetailMembers(level) {
+    if (!Number.isInteger(level) ||
+        level < 16 ||
+        level > exports.HELSINKI_MAX_COMPLETE_LEVEL) {
+        throw new Error(`Helsinki detail level must be an integer 16-${exports.HELSINKI_MAX_COMPLETE_LEVEL}; deeper levels prune the quadtree and cannot be addressed by generated paths (got ${level})`);
+    }
+    let paths = ['000'];
+    for (let depth = 16; depth < level; depth += 1) {
+        paths = paths.flatMap((path) => ['0', '1', '2', '3'].map((digit) => path + digit));
+    }
+    return paths.map((path) => ({
+        obj: `${exports.HELSINKI_TILE}/${exports.HELSINKI_TILE_PREFIX}_L${level}_${path}.obj`,
+        texture: `${exports.HELSINKI_TILE}/${exports.HELSINKI_TILE_PREFIX}_L${level}_${path}_0.jpg`,
+    }));
+}
+//# sourceMappingURL=helsinkiTiles.js.map

package/dist/sceneImport/helsinkiTiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helsinkiTiles.js","sourceRoot":"","sources":["../../src/sceneImport/helsinkiTiles.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,4DAA4D;;;AA8B5D,sDAoBC;AAhDY,QAAA,aAAa,GAAG,UAAU,CAAC;AAC3B,QAAA,oBAAoB,GAAG,gBAAgB,CAAC;AACxC,QAAA,kBAAkB,GAAG,GAAG,qBAAa,IAAI,4BAAoB,UAAU,CAAC;AACrF;;;;;;;;;;;;GAYG;AACU,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAC3B,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAE9C;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,KAAa;IAEb,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACxB,KAAK,GAAG,EAAE;QACV,KAAK,GAAG,mCAA2B,EACnC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+CAA+C,mCAA2B,sFAAsF,KAAK,GAAG,CACzK,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,KAAK,IAAI,KAAK,GAAG,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,GAAG,EAAE,GAAG,qBAAa,IAAI,4BAAoB,KAAK,KAAK,IAAI,IAAI,MAAM;QACrE,OAAO,EAAE,GAAG,qBAAa,IAAI,4BAAoB,KAAK,KAAK,IAAI,IAAI,QAAQ;KAC5E,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/sceneImport/materials/binding.d.ts

@@ -0,0 +1,16 @@
+import { type ContinuumMaterialBinding, type ContinuumMaterialSampler, type ContinuumPackageVersionReference } from "@hypersoniclabs/helix-manifest";
+export type SharedMaterialBindingInput = {
+    material: ContinuumPackageVersionReference;
+    slot: string;
+    tint?: [number, number, number, number];
+    opacity?: number;
+    roughnessScale?: number;
+    metallicScale?: number;
+    normalScale?: number;
+    emissiveScale?: number;
+    uv?: Partial<ContinuumMaterialBinding["uv"]>;
+    samplerOverride?: Partial<ContinuumMaterialSampler>;
+    trimSheet?: ContinuumMaterialBinding["trimSheet"];
+};
+/** Build per-use state while preserving one shared Material Package reference. */
+export declare function createSharedMaterialBinding(input: SharedMaterialBindingInput): ContinuumMaterialBinding;