@helix3/helix-cli 0.1.18-helix3.299 → 0.1.18-helix3.300

package/dist/character/repairLodSkeletonsFile.d.ts

@@ -0,0 +1,25 @@
+import { type SplitSharedLodSkeletonsResult } from './stages/splitSharedLodSkeletons';
+/**
+ * File-level entry point for `helix character repair-lod-skeletons`: repairs a packaged multi-LOD add-on
+ * whose LOD scenes share one skeleton (helix-creator-cli #219's output) — see `stages/splitSharedLodSkeletons.ts`.
+ *
+ * Output contract, so a batch driver never has to guess:
+ *   - outcome 'repaired': `output` holds the repaired GLB. Its accessors are proven byte-identical to the
+ *     input's (compared as a multiset of content hashes after re-reading the written file) — only the node and
+ *     skin graph changed.
+ *   - outcome 'nothing-to-repair': every scene already had its own skeleton; `output` is a BYTE-IDENTICAL copy.
+ *   - anything the repair cannot do safely throws (see the stage's refusals) and writes nothing.
+ */
+export type RepairOutcome = 'repaired' | 'nothing-to-repair';
+export interface RepairLodSkeletonsFileResult extends SplitSharedLodSkeletonsResult {
+    outcome: RepairOutcome;
+    input: string;
+    output: string;
+    skinsBefore: number;
+    skinsAfter: number;
+    nodesBefore: number;
+    nodesAfter: number;
+    /** Accessors compared by content hash between input and written output (all must match). */
+    accessorsVerified: number;
+}
+export declare function repairLodSkeletonsFile(inputPath: string, outputPath: string): Promise<RepairLodSkeletonsFileResult>;

package/dist/character/repairLodSkeletonsFile.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairLodSkeletonsFile = repairLodSkeletonsFile;
+const core_1 = require("@gltf-transform/core");
+const extensions_1 = require("@gltf-transform/extensions");
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const meshoptimizer_1 = require("meshoptimizer");
+const splitSharedLodSkeletons_1 = require("./stages/splitSharedLodSkeletons");
+function accessorFingerprints(document) {
+    return document.getRoot().listAccessors().map((accessor) => {
+        const array = accessor.getArray();
+        const bytes = array ? Buffer.from(array.buffer, array.byteOffset, array.byteLength) : Buffer.alloc(0);
+        return `${accessor.getType()}:${accessor.getComponentType()}:${accessor.getCount()}:${accessor.getNormalized()}:${(0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex')}`;
+    }).sort();
+}
+async function repairLodSkeletonsFile(inputPath, outputPath) {
+    await Promise.all([meshoptimizer_1.MeshoptDecoder.ready, meshoptimizer_1.MeshoptEncoder.ready]);
+    const io = new core_1.NodeIO()
+        .registerExtensions(extensions_1.ALL_EXTENSIONS)
+        .registerDependencies({ 'meshopt.decoder': meshoptimizer_1.MeshoptDecoder, 'meshopt.encoder': meshoptimizer_1.MeshoptEncoder });
+    const input = (0, node_path_1.resolve)(inputPath), output = (0, node_path_1.resolve)(outputPath);
+    const inputBytes = (0, node_fs_1.readFileSync)(input);
+    const document = await io.readBinary(inputBytes);
+    const before = accessorFingerprints(document);
+    const skinsBefore = document.getRoot().listSkins().length, nodesBefore = document.getRoot().listNodes().length;
+    const split = (0, splitSharedLodSkeletons_1.splitSharedLodSkeletons)(document);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(output), { recursive: true });
+    const base = { input, output, skinsBefore, nodesBefore, ...split };
+    if (split.scenesRepaired === 0) {
+        if (input !== output)
+            (0, node_fs_1.copyFileSync)(input, output);
+        return { ...base, outcome: 'nothing-to-repair', skinsAfter: skinsBefore, nodesAfter: nodesBefore, accessorsVerified: before.length };
+    }
+    const bytes = await io.writeBinary(document);
+    const written = await io.readBinary(bytes);
+    const after = accessorFingerprints(written);
+    if (after.length !== before.length || after.some((fingerprint, i) => fingerprint !== before[i])) {
+        throw new Error(`repair: accessor data changed during the repair (${before.length} → ${after.length} accessors) — refusing to write ${output}`);
+    }
+    (0, node_fs_1.writeFileSync)(output, bytes);
+    return {
+        ...base, outcome: 'repaired',
+        skinsAfter: written.getRoot().listSkins().length, nodesAfter: written.getRoot().listNodes().length,
+        accessorsVerified: after.length,
+    };
+}
+//# sourceMappingURL=repairLodSkeletonsFile.js.map

package/dist/character/repairLodSkeletonsFile.js.map

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

package/dist/character/stages/splitSharedLodSkeletons.d.ts

@@ -0,0 +1,31 @@
+import type { Document } from '@gltf-transform/core';
+/**
+ * REPAIR IN PLACE: gives every LOD scene of an already-packaged character GLB its own copy of a skeleton that
+ * several scenes share — undoing helix-creator-cli #219's fold without the original source.
+ *
+ * #219 grouped a multi-LOD add-on's per-LOD skins by their ordered joint names, repointed every LOD's skinned
+ * mesh at the first skin, rooted that one skeleton in every scene, and disposed the other copies. Those copies
+ * were byte-for-byte duplicates — every LOD level was parsed from the same conformed bytes, so joint names,
+ * order, local transforms and inverse bind matrices were identical — so nothing was lost that cannot be
+ * rebuilt: for each scene after the first that roots a shared subtree, clone that subtree (names, TRS,
+ * extras, the same mesh/skin references), give the scene's skinned meshes a new Skin over the cloned joints
+ * with the SAME inverse-bind accessor, and swap the scene's root reference to the clone. The result is the
+ * pre-#219 structure, which three.js loads (see `mergeLods`' header for why the shared form does not).
+ *
+ * Only the node/skin graph changes: every accessor (positions, weights, joints, IBMs), mesh, material and
+ * texture is untouched and keeps its identity. The outcome is checked with `assertSelfContainedLodScenes`.
+ *
+ * Refuses (throws) rather than guesses when:
+ *   - a LOD scene has no skinned mesh left — #219's dispose would have deleted a mesh node parented UNDER a
+ *     duplicate bone, which no repair can recover (re-extract that item);
+ *   - a skin mixes joints from a shared subtree with joints owned by its own scene;
+ *   - a node to be cloned carries glTF extensions (never seen on a character skeleton; not silently dropped).
+ */
+export interface SplitSharedLodSkeletonsResult {
+    scenes: number;
+    /** Scenes that received their own copy of a shared subtree. */
+    scenesRepaired: number;
+    nodesCloned: number;
+    skinsCreated: number;
+}
+export declare function splitSharedLodSkeletons(document: Document): SplitSharedLodSkeletonsResult;

package/dist/character/stages/splitSharedLodSkeletons.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitSharedLodSkeletons = splitSharedLodSkeletons;
+const mergeLods_1 = require("./mergeLods");
+function subtree(roots) {
+    const out = [];
+    const seen = new Set();
+    const stack = [...roots];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (seen.has(node))
+            continue;
+        seen.add(node);
+        out.push(node);
+        stack.push(...node.listChildren());
+    }
+    return out;
+}
+function cloneTree(document, root, map) {
+    if (root.listExtensions().length > 0) {
+        throw new Error(`repair: node '${root.getName()}' carries glTF extensions (${root.listExtensions().map((e) => e.extensionName).join(', ')}) — refusing to clone it lossily`);
+    }
+    const copy = document.createNode(root.getName())
+        .setTranslation([...root.getTranslation()])
+        .setRotation([...root.getRotation()])
+        .setScale([...root.getScale()])
+        .setWeights([...root.getWeights()])
+        .setExtras(structuredClone(root.getExtras()));
+    const mesh = root.getMesh();
+    if (mesh)
+        copy.setMesh(mesh);
+    const skin = root.getSkin();
+    if (skin)
+        copy.setSkin(skin); // remapped once every joint copy exists
+    const camera = root.getCamera();
+    if (camera)
+        copy.setCamera(camera);
+    map.set(root, copy);
+    for (const child of root.listChildren())
+        copy.addChild(cloneTree(document, child, map));
+    return copy;
+}
+function splitSharedLodSkeletons(document) {
+    const scenes = document.getRoot().listScenes();
+    const result = { scenes: scenes.length, scenesRepaired: 0, nodesCloned: 0, skinsCreated: 0 };
+    const owner = new Map();
+    for (const scene of scenes) {
+        for (const node of subtree(scene.listChildren()))
+            if (!owner.has(node))
+                owner.set(node, scene);
+    }
+    for (const scene of scenes) {
+        const shared = scene.listChildren().filter((child) => owner.get(child) !== scene);
+        if (shared.length === 0)
+            continue;
+        const map = new Map();
+        for (const root of shared) {
+            const clone = cloneTree(document, root, map);
+            scene.removeChild(root);
+            scene.addChild(clone);
+        }
+        result.nodesCloned += map.size;
+        result.scenesRepaired++;
+        // Every skinned mesh in this scene that is bound to cloned joints gets a skin over the clones.
+        const rebuilt = new Map();
+        for (const node of subtree(scene.listChildren())) {
+            const skin = node.getSkin();
+            if (!skin)
+                continue;
+            const joints = skin.listJoints();
+            const mapped = joints.map((joint) => map.get(joint));
+            if (mapped.every((joint) => joint === undefined))
+                continue; // bound to this scene's own joints already
+            if (mapped.some((joint) => joint === undefined)) {
+                throw new Error(`repair: skin '${skin.getName()}' in scene '${scene.getName()}' mixes shared and scene-owned joints — cannot split it safely`);
+            }
+            let replacement = rebuilt.get(skin);
+            if (!replacement) {
+                replacement = document.createSkin(skin.getName());
+                for (const joint of mapped)
+                    replacement.addJoint(joint);
+                const ibm = skin.getInverseBindMatrices();
+                if (ibm)
+                    replacement.setInverseBindMatrices(ibm); // same bytes, same accessor: identical binding
+                const skeleton = skin.getSkeleton();
+                if (skeleton)
+                    replacement.setSkeleton(map.get(skeleton) ?? skeleton);
+                replacement.setExtras(structuredClone(skin.getExtras()));
+                rebuilt.set(skin, replacement);
+                result.skinsCreated++;
+            }
+            node.setSkin(replacement);
+        }
+    }
+    scenes.forEach((scene, index) => {
+        const skinned = subtree(scene.listChildren()).filter((node) => node.getMesh() && node.getSkin());
+        if (skinned.length === 0) {
+            throw new Error(`repair: LOD scene ${index + 1} ('${scene.getName()}') has no skinned mesh — it cannot be rebuilt from this file; re-extract the item`);
+        }
+    });
+    (0, mergeLods_1.assertSelfContainedLodScenes)(document);
+    return result;
+}
+//# sourceMappingURL=splitSharedLodSkeletons.js.map

package/dist/character/stages/splitSharedLodSkeletons.js.map

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

package/dist/index.js

@@ -3723,6 +3723,32 @@ character
         fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
     }
 });
+character
+    .command('repair-lod-skeletons')
+    .description("Repair a packaged multi-LOD add-on whose LOD scenes share one skeleton (helix-creator-cli #219's output, which three.js loads with undefined bones): give every LOD scene its own copy, changing only the node/skin graph")
+    .argument('<glb>', 'packaged add-on GLB')
+    .requiredOption('-o, --output <glb>', 'output GLB: the repaired file, or a byte-identical copy when nothing is shared')
+    .option('--json', 'print the result as JSON')
+    .addHelpText('after', '\nExit codes: 0 = repaired · 3 = nothing to repair (output is a byte-identical copy) · 1 = refused/error (nothing written).\nCheck the result with `node scripts/engine-bind-check.mjs <out.glb> --host <base.glb>` before publishing.')
+    .action(async (glb, opts) => {
+    try {
+        const { repairLodSkeletonsFile } = await Promise.resolve().then(() => __importStar(require('./character/repairLodSkeletonsFile')));
+        const result = await repairLodSkeletonsFile((0, node_path_1.resolve)(glb), (0, node_path_1.resolve)(opts.output));
+        if (opts.json)
+            console.log(JSON.stringify(result, null, 2));
+        else if (result.outcome === 'repaired') {
+            console.log(`✔ repaired: ${result.scenesRepaired}/${result.scenes} LOD scene(s) given their own skeleton — skins ${result.skinsBefore} → ${result.skinsAfter}, nodes ${result.nodesBefore} → ${result.nodesAfter}; ${result.accessorsVerified} accessor(s) verified byte-identical`);
+            console.log(`  output: ${result.output}`);
+        }
+        else {
+            console.log(`• nothing to repair: every LOD scene already has its own skeleton — output is a byte-identical copy (${result.output})`);
+        }
+        process.exitCode = result.outcome === 'repaired' ? 0 : 3;
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 character
     .command('retarget-animation')
     .description('Retarget one raw Meshy/Mixamo FBX or GLB directly to a helix-humanoid@1 animation clip')