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

package/dist/character/meshyToHelixMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"meshyToHelixMap.js","sourceRoot":"","sources":["../../src/character/meshyToHelixMap.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;AAChG,sGAAsG;;;AAIzF,QAAA,kBAAkB,GAAY;IACzC,IAAI,EAAE,iCAAiC;IACvC,OAAO,EAAE,OAAO;IAChB,OAAO,EACL,yJAAyJ;QACzJ,0JAA0J;QAC1J,4JAA4J;QAC5J,2EAA2E;IAC7E,GAAG,EAAE;QACH,IAAI,EAAE,QAAQ;QAEd,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,UAAU;QAEjB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM;QAEZ,YAAY,EAAE,YAAY;QAC1B,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,QAAQ;QAElB,aAAa,EAAE,YAAY;QAC3B,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,YAAY;QAC1B,SAAS,EAAE,QAAQ;QAEnB,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,QAAQ;QAErB,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,QAAQ;QACnB,YAAY,EAAE,QAAQ;KACvB;IACD,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;CAChC,CAAC"}
+{"version":3,"file":"meshyToHelixMap.js","sourceRoot":"","sources":["../../src/character/meshyToHelixMap.ts"],"names":[],"mappings":"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"}

package/dist/character/metahumanToHelixMap.d.ts

@@ -0,0 +1,2 @@
+import type { BoneMap } from './stages/retarget';
+export declare const METAHUMAN_TO_HELIX_MAP: BoneMap;

package/dist/character/metahumanToHelixMap.js

@@ -0,0 +1,34 @@
+"use strict";
+// Embedded copy of the engine character pipeline's metahuman-to-helix.json.
+// MetaHuman-authored modular meshes already use the HELIX humanoid bone names,
+// so conversion preserves those names while rebuilding the canonical rest rig.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METAHUMAN_TO_HELIX_MAP = void 0;
+const METAHUMAN_BONES = [
+    'root', 'pelvis',
+    'spine_01', 'spine_02', 'spine_03', 'spine_04', 'spine_05',
+    'neck_01', 'neck_02', 'head',
+    'clavicle_l', 'upperarm_l', 'upperarm_twist_01_l', 'upperarm_twist_02_l',
+    'lowerarm_l', 'lowerarm_twist_01_l', 'lowerarm_twist_02_l', 'hand_l',
+    'clavicle_r', 'upperarm_r', 'upperarm_twist_01_r', 'upperarm_twist_02_r',
+    'lowerarm_r', 'lowerarm_twist_01_r', 'lowerarm_twist_02_r', 'hand_r',
+    'thumb_01_l', 'thumb_02_l', 'thumb_03_l',
+    'index_01_l', 'index_02_l', 'index_03_l',
+    'middle_01_l', 'middle_02_l', 'middle_03_l',
+    'ring_01_l', 'ring_02_l', 'ring_03_l',
+    'pinky_01_l', 'pinky_02_l', 'pinky_03_l',
+    'thumb_01_r', 'thumb_02_r', 'thumb_03_r',
+    'index_01_r', 'index_02_r', 'index_03_r',
+    'middle_01_r', 'middle_02_r', 'middle_03_r',
+    'ring_01_r', 'ring_02_r', 'ring_03_r',
+    'pinky_01_r', 'pinky_02_r', 'pinky_03_r',
+    'thigh_l', 'thigh_twist_01_l', 'calf_l', 'calf_twist_01_l', 'foot_l', 'ball_l',
+    'thigh_r', 'thigh_twist_01_r', 'calf_r', 'calf_twist_01_r', 'foot_r', 'ball_r',
+];
+exports.METAHUMAN_TO_HELIX_MAP = {
+    name: 'metahuman-to-helix',
+    version: '1.0.0',
+    comment: 'Identity map for HELIX MetaHuman-authored modular meshes. FACIAL_C_FacialRoot is intentionally unmapped so conform folds its weights through its mapped head ancestor onto the 68-joint helix-humanoid@1 rig.',
+    map: Object.fromEntries(METAHUMAN_BONES.map((bone) => [bone, bone])),
+};
+//# sourceMappingURL=metahumanToHelixMap.js.map

package/dist/character/metahumanToHelixMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metahumanToHelixMap.js","sourceRoot":"","sources":["../../src/character/metahumanToHelixMap.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;;;AAI/E,MAAM,eAAe,GAAG;IACtB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAC1D,SAAS,EAAE,SAAS,EAAE,MAAM;IAC5B,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB;IACxE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,QAAQ;IACpE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB;IACxE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,QAAQ;IACpE,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,aAAa,EAAE,aAAa,EAAE,aAAa;IAC3C,WAAW,EAAE,WAAW,EAAE,WAAW;IACrC,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,aAAa,EAAE,aAAa,EAAE,aAAa;IAC3C,WAAW,EAAE,WAAW,EAAE,WAAW;IACrC,YAAY,EAAE,YAAY,EAAE,YAAY;IACxC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ;IAC9E,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ;CACtE,CAAC;AAEE,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;IAChB,OAAO,EACL,+MAA+M;IACjN,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;CACrE,CAAC"}

package/dist/character/normalMapGuard.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Refuse a character GLB whose `normalTexture` is not a tangent-space normal map.
+ *
+ * ── THE DEFECT (live, found by the 2026-10-02 whole-catalogue visual-QA sweep) ───────────────────────
+ * Two different importers shipped normal maps that are not normal maps, and nothing read a pixel of them:
+ *
+ *   MISSING-Z   Cyberpunk 2077 `*_n01` maps are two-channel (BC5, red/green only). The extraction wrote them out as
+ *               RGB with blue = 0 and nobody rebuilt Z, so every texel decodes to a vector with no "up" component:
+ *               mean RGB (127,128,0). Lit, the surface goes black along every panel edge and glassy elsewhere —
+ *               "jagged torn black streaks" on the Cyberpunk Jumpsuit, "blotchy z-fighting" on the Baseball Cap,
+ *               "crumpled faceted" Sneakers. Nine live Cyberpunk items carry it.
+ *   NOT-NORMAL  Sims 4 imports bound a different DST/RLE texture as the normal map (mean RGB like 0,154,0 or
+ *               5,2,0) or baked garbage from it (`helix_baked_normal`, mean 92,109,88). Lit, that is faceted noise:
+ *               "torn jagged panels" on shoes, dresses and caps that are geometrically fine.
+ *
+ * ── WHY EVERY EXISTING GATE PASSED IT ──────────────────────────────────────────────────────────────
+ * Same story as `baseColorGuard.ts`: the structural and budget checks never read a pixel of a normal map.
+ *
+ * ── THE TESTS ────────────────────────────────────────────────────────────────────────────────────────
+ * A real tangent-space normal map clusters around (128,128,255): most of a surface faces its own normal, so the
+ * mean blue is high (>= ~170 even for heavily detailed maps). Both defects have a mean blue far below that.
+ *   MISSING-Z   mean B < 24 and mean R,G within 24 of 128  -> repairable: Z = sqrt(1 - x^2 - y^2)
+ *               (`repairMissingNormalZ`), so the detail the artist authored is kept.
+ *   NOT-NORMAL  mean B < 100 otherwise                      -> not recoverable; drop the normalTexture.
+ * A texture that cannot be decoded is reported UNCHECKED and does not refuse.
+ *
+ * Escape hatch: `HELIX_ALLOW_BROKEN_NORMAL_MAP=1`.
+ */
+import type { Document } from '@gltf-transform/core';
+export declare const NORMAL_MAP_MISSING_Z_MAX_BLUE_MEAN = 24;
+export declare const NORMAL_MAP_MISSING_Z_RG_TOLERANCE = 24;
+export declare const NORMAL_MAP_MIN_BLUE_MEAN_FOR_NORMAL = 100;
+export interface NormalMapFinding {
+    material: string;
+    texture: string;
+    reason: 'missing-z' | 'not-normal';
+    detail: string;
+    mean: [number, number, number];
+}
+export interface NormalMapReport {
+    findings: NormalMapFinding[];
+    /** Materials whose normal image could not be decoded, so no verdict was possible. */
+    unchecked: string[];
+}
+export declare function inspectNormalMaps(document: Document): Promise<NormalMapReport>;
+/**
+ * Rebuild Z in every two-channel (missing-Z) normal map, in place, as PNG (the caller's KTX2 stage re-encodes).
+ * Returns the number of textures rebuilt. Maps that are not missing-Z are untouched.
+ */
+export declare function repairMissingNormalZ(document: Document): Promise<number>;
+export declare function describeNormalMapFindings(findings: readonly NormalMapFinding[]): string;
+/** Throws with an itemized report when any material's normalTexture is not a tangent-space normal map. */
+export declare function assertNormalMapsAreNormals(document: Document, name?: string): Promise<NormalMapReport>;
+export declare function assertGlbNormalMapsAreNormals(glb: Uint8Array, name?: string): Promise<NormalMapReport>;
+/** Shared by publish, publish --dry-run and publish-version, so the gate before the fee is the gate at it. */
+export declare function assertPublishNormalMaps(opts: {
+    kind: string;
+    mesh?: string;
+}, meshBytes: Uint8Array | null | undefined): Promise<void>;

package/dist/character/normalMapGuard.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NORMAL_MAP_MIN_BLUE_MEAN_FOR_NORMAL = exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE = exports.NORMAL_MAP_MISSING_Z_MAX_BLUE_MEAN = void 0;
+exports.inspectNormalMaps = inspectNormalMaps;
+exports.repairMissingNormalZ = repairMissingNormalZ;
+exports.describeNormalMapFindings = describeNormalMapFindings;
+exports.assertNormalMapsAreNormals = assertNormalMapsAreNormals;
+exports.assertGlbNormalMapsAreNormals = assertGlbNormalMapsAreNormals;
+exports.assertPublishNormalMaps = assertPublishNormalMaps;
+const core_1 = require("@gltf-transform/core");
+const extensions_1 = require("@gltf-transform/extensions");
+const sharp_1 = __importDefault(require("sharp"));
+const ktx2Decode_1 = require("./ktx2Decode");
+exports.NORMAL_MAP_MISSING_Z_MAX_BLUE_MEAN = 24;
+exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE = 24;
+exports.NORMAL_MAP_MIN_BLUE_MEAN_FOR_NORMAL = 100;
+const isKtx2 = (b) => b.length > 12 && b[0] === 0xab && b[1] === 0x4b && b[2] === 0x54 && b[3] === 0x58;
+async function decode(bytes) {
+    const buffer = Buffer.from(bytes);
+    if (isKtx2(buffer)) {
+        const { data, width, height } = await (0, ktx2Decode_1.decodeKtx2ToRgba)(buffer);
+        return { data: Buffer.from(data), width, height };
+    }
+    const out = await (0, sharp_1.default)(buffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+    return { data: out.data, width: out.info.width, height: out.info.height };
+}
+function meanRgb(img) {
+    const mean = [0, 0, 0];
+    let used = 0;
+    // Sampling every 7th texel is plenty for a mean and keeps a 2k map under a few ms.
+    for (let i = 0; i < img.width * img.height; i += 7) {
+        used += 1;
+        for (let c = 0; c < 3; c += 1)
+            mean[c] += img.data[i * 4 + c];
+    }
+    for (let c = 0; c < 3; c += 1)
+        mean[c] /= Math.max(1, used);
+    return mean;
+}
+const label = (m, i) => m.getName() || `material[${i}]`;
+async function inspectNormalMaps(document) {
+    const findings = [];
+    const unchecked = [];
+    const seen = new Set();
+    const materials = document.getRoot().listMaterials();
+    for (let index = 0; index < materials.length; index += 1) {
+        const material = materials[index];
+        const texture = material.getNormalTexture();
+        if (!texture || seen.has(texture))
+            continue;
+        seen.add(texture);
+        const bytes = texture.getImage();
+        if (!bytes)
+            continue;
+        let img;
+        try {
+            img = await decode(bytes);
+        }
+        catch {
+            unchecked.push(label(material, index));
+            continue;
+        }
+        const mean = meanRgb(img);
+        const [r, g, b] = mean;
+        const base = { material: label(material, index), texture: texture.getName() || '(unnamed)', mean };
+        if (b < exports.NORMAL_MAP_MISSING_Z_MAX_BLUE_MEAN && Math.abs(r - 128) < exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE && Math.abs(g - 128) < exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE) {
+            findings.push({ ...base, reason: 'missing-z', detail: `two-channel normal map with no Z (mean RGB ${mean.map((v) => v.toFixed(0)).join(',')}; a normal map is ~128,128,255)` });
+        }
+        else if (b < exports.NORMAL_MAP_MIN_BLUE_MEAN_FOR_NORMAL) {
+            findings.push({ ...base, reason: 'not-normal', detail: `not a tangent-space normal map (mean RGB ${mean.map((v) => v.toFixed(0)).join(',')}; a normal map is ~128,128,255)` });
+        }
+    }
+    return { findings, unchecked };
+}
+/**
+ * Rebuild Z in every two-channel (missing-Z) normal map, in place, as PNG (the caller's KTX2 stage re-encodes).
+ * Returns the number of textures rebuilt. Maps that are not missing-Z are untouched.
+ */
+async function repairMissingNormalZ(document) {
+    let rebuilt = 0;
+    const done = new Set();
+    for (const material of document.getRoot().listMaterials()) {
+        const texture = material.getNormalTexture();
+        const bytes = texture?.getImage();
+        if (!texture || !bytes || done.has(texture))
+            continue;
+        done.add(texture);
+        const img = await decode(bytes);
+        const [r, g, b] = meanRgb(img);
+        if (!(b < exports.NORMAL_MAP_MISSING_Z_MAX_BLUE_MEAN && Math.abs(r - 128) < exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE && Math.abs(g - 128) < exports.NORMAL_MAP_MISSING_Z_RG_TOLERANCE))
+            continue;
+        const px = Buffer.from(img.data);
+        for (let i = 0; i < px.length; i += 4) {
+            const x = px[i] / 127.5 - 1;
+            const y = px[i + 1] / 127.5 - 1;
+            px[i + 2] = Math.round((Math.sqrt(Math.max(0, 1 - x * x - y * y)) * 0.5 + 0.5) * 255);
+            px[i + 3] = 255;
+        }
+        const png = await (0, sharp_1.default)(px, { raw: { width: img.width, height: img.height, channels: 4 } }).png().toBuffer();
+        texture.setImage(new Uint8Array(png)).setMimeType('image/png');
+        rebuilt += 1;
+    }
+    return rebuilt;
+}
+function describeNormalMapFindings(findings) {
+    return findings.map((f) => `  - material "${f.material}", texture "${f.texture}": ${f.reason.toUpperCase()} — ${f.detail}`).join('\n');
+}
+/** Throws with an itemized report when any material's normalTexture is not a tangent-space normal map. */
+async function assertNormalMapsAreNormals(document, name = 'this GLB') {
+    const report = await inspectNormalMaps(document);
+    if (report.findings.length === 0 || process.env.HELIX_ALLOW_BROKEN_NORMAL_MAP === '1')
+        return report;
+    throw new Error(`Refusing ${name}: ${report.findings.length} normal map(s) are not tangent-space normal maps, so the surface will ` +
+        `shade as torn, faceted or black patches however clean the mesh is.\n${describeNormalMapFindings(report.findings)}\n` +
+        `MISSING-Z maps (two-channel, blue ~0) are repairable: rebuild Z = sqrt(1 - x^2 - y^2) (repairMissingNormalZ). ` +
+        `NOT-NORMAL maps are the wrong texture: drop the normalTexture or bind the real normal map. ` +
+        `To ship anyway set HELIX_ALLOW_BROKEN_NORMAL_MAP=1.`);
+}
+async function assertGlbNormalMapsAreNormals(glb, name) {
+    let document;
+    try {
+        document = await new core_1.NodeIO().registerExtensions(extensions_1.ALL_EXTENSIONS).readBinary(glb);
+    }
+    catch {
+        return { findings: [], unchecked: ['(glTF could not be parsed locally)'] };
+    }
+    return assertNormalMapsAreNormals(document, name);
+}
+const NORMAL_MAP_GUARDED_KINDS = new Set(['add_on', 'wearable', 'avatar']);
+/** Shared by publish, publish --dry-run and publish-version, so the gate before the fee is the gate at it. */
+async function assertPublishNormalMaps(opts, meshBytes) {
+    if (!meshBytes || !NORMAL_MAP_GUARDED_KINDS.has(opts.kind))
+        return;
+    await assertGlbNormalMapsAreNormals(meshBytes, opts.mesh ?? 'the mesh');
+}
+//# sourceMappingURL=normalMapGuard.js.map

package/dist/character/normalMapGuard.js.map

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

package/dist/character/quat.js

@@ -1,6 +1,6 @@
 "use strict";
-// PORTED from helix-web-engine-new/tools/character-pipeline — the source of truth for the character
-// pipeline. SYNC OBLIGATION: fix bugs there first, then mirror the change here; do not diverge.
+// Minimal quaternion math for world-space clip retargeting. Hamilton convention, [x,y,z,w], matching
+// three.js: mul(a,b) composes "apply b, then a" so worldQuat = mul(parentWorldQuat, localQuat).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.conj = void 0;
 exports.mul = mul;

package/dist/character/quat.js.map

@@ -1 +1 @@
-{"version":3,"file":"quat.js","sourceRoot":"","sources":["../../src/character/quat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"quat.js","sourceRoot":"","sources":["../../src/character/quat.ts"],"names":[],"mappings":";AAAA,qGAAqG;AACrG,gGAAgG;;;AAIhG,kBAQC;AAKD,8BAGC;AAGD,0BAiBC;AAGD,8BAOC;AAGD,sBAOC;AAGD,gCAWC;AAGD,gCAYC;AArFD,SAAgB,GAAG,CAAC,CAAO,EAAE,CAAO;IAClC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO;QACL,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QACrC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QACrC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QACrC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,gDAAgD;AACzC,MAAM,IAAI,GAAG,CAAC,CAAO,EAAoC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAAlF,QAAA,IAAI,QAA8E;AAE/F,SAAgB,SAAS,CAAC,CAAO;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,4GAA4G;AAC5G,SAAgB,OAAO,CAAC,CAAoB;IAC1C,MAAM,CAAC,GAAG,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAE,CAAC;IAClE,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9B,IAAI,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACpH,CAAC;SAAM,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5H,CAAC;SAAM,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5H,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAC5H,CAAC;IACD,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,SAAgB,SAAS,CAAC,CAAO,EAAE,CAAoC;IACrE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,0DAA0D;IAC1D,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACnH,CAAC;AAED,gFAAgF;AAChF,SAAgB,KAAK,CAAC,CAAO,EAAE,CAAO,EAAE,CAAS;IAC/C,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAAC,CAAC;IAC9D,IAAI,CAAC,GAAG,MAAM;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,0FAA0F;AAC1F,SAAgB,UAAU,CAAC,KAAwB,EAAE,KAAwB,EAAE,CAAS;IACtF,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,MAAM,CAAC,GAAG,CAAC,CAAS,EAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IACxG,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,KAAK,CAAC,GAAG,CAAE,IAAI,CAAC;YAAE,EAAE,GAAG,GAAG,CAAC;;YAAM,EAAE,GAAG,GAAG,CAAC;IAAC,CAAC;IAClG,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAE,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,+EAA+E;AAC/E,SAAgB,UAAU,CAAC,KAAwB,EAAE,IAAuB,EAAE,CAAS;IACrF,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,MAAM,CAAC,GAAG,CAAC,CAAS,EAA4B,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IACtG,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE;QAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,KAAK,CAAC,GAAG,CAAE,IAAI,CAAC;YAAE,EAAE,GAAG,GAAG,CAAC;;YAAM,EAAE,GAAG,GAAG,CAAC;IAAC,CAAC;IAClG,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAE,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/character/reframeSkeletonFile.d.ts

@@ -0,0 +1,19 @@
+import { type ReframeSkeletonResult } from './stages/reframeSkeletonToHost';
+/**
+ * File-level entry point for `helix character reframe-skeleton`: re-frames a packaged add-on's skeleton onto its
+ * host's (see `stages/reframeSkeletonToHost.ts`). Output contract:
+ *   - outcome 'reframed': `output` holds the repaired GLB; every accessor except the inverse-bind matrices is
+ *     proven byte-identical to the input's (multiset of content hashes, re-read from the written file).
+ *   - outcome 'nothing-to-do': the host hoists no wrapper, or every skin is already framed; `output` is a
+ *     byte-identical copy.
+ *   - anything it cannot prove is a pure frame shift throws and writes nothing.
+ */
+export type ReframeOutcome = 'reframed' | 'nothing-to-do';
+export interface ReframeSkeletonFileResult extends ReframeSkeletonResult {
+    outcome: ReframeOutcome;
+    input: string;
+    output: string;
+    /** Non-IBM accessors compared by content hash between input and written output (all must match). */
+    accessorsVerified: number;
+}
+export declare function reframeSkeletonFile(inputPath: string, hostPath: string, outputPath: string): Promise<ReframeSkeletonFileResult>;

package/dist/character/reframeSkeletonFile.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reframeSkeletonFile = reframeSkeletonFile;
+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 reframeSkeletonToHost_1 = require("./stages/reframeSkeletonToHost");
+function fingerprints(document, skipIbm) {
+    const ibm = new Set(document.getRoot().listSkins().map((skin) => skin.getInverseBindMatrices()));
+    return document.getRoot().listAccessors().filter((a) => !(skipIbm && ibm.has(a))).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 reframeSkeletonFile(inputPath, hostPath, 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 part = await io.readBinary(inputBytes);
+    const host = await io.readBinary((0, node_fs_1.readFileSync)((0, node_path_1.resolve)(hostPath)));
+    const before = fingerprints(part, true);
+    const result = (0, reframeSkeletonToHost_1.reframeSkeletonToHost)(part, host);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(output), { recursive: true });
+    if (!result.reframed) {
+        if (input !== output)
+            (0, node_fs_1.copyFileSync)(input, output);
+        return { ...result, outcome: 'nothing-to-do', input, output, accessorsVerified: before.length };
+    }
+    const bytes = await io.writeBinary(part);
+    const reread = await io.readBinary(bytes);
+    const after = fingerprints(reread, true);
+    if (after.length !== before.length || after.some((value, index) => value !== before[index])) {
+        throw new Error('reframe: the written GLB differs from the input in more than its inverse-bind matrices — nothing written');
+    }
+    (0, node_fs_1.writeFileSync)(output, bytes);
+    return { ...result, outcome: 'reframed', input, output, accessorsVerified: before.length };
+}
+//# sourceMappingURL=reframeSkeletonFile.js.map

package/dist/character/reframeSkeletonFile.js.map

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

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/restFrameGuard.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Refuse a `helix-humanoid@1` character GLB whose bones are not in the canonical rest FRAMES.
+ *
+ * ── THE DEFECT (live, found 2026-10-02 by the whole-catalogue visual-QA sweep) ───────────────────────
+ * Cyberpunk Female Base 1.0.4–1.0.7 shipped with every bone frame turned 180 degrees about the vertical axis.
+ * The source faced -Z, the importer (`fitSkeletonToWarrior`) embedded the canonical skeleton at the source's joint
+ * positions (so left-side bones sat on the -X side of the root frame) and the author turned the whole thing round
+ * with a `cyberpunk_forward_frame` wrapper node (q 0,1,0,0) above skeleton AND mesh. A wrapper like that keeps
+ * every WORLD POSITION right, so it renders correctly at rest, in every thumbnail and in every T-pose proof — and
+ * leaves every bone FRAME 180 degrees off canonical. The clips are absolute canonical local rotations
+ * (`retargetLocomotion.ts`: "Canonical rotations are absolute local poses"), so idle folded both hands behind the
+ * back and the walk/run swung the arms and legs the wrong way round. Every skinned add-on bound to that base inherits
+ * the rig, so none of them could be fitted or posed correctly either.
+ *
+ * ── WHY EVERY EXISTING GATE PASSED IT ──────────────────────────────────────────────────────────────
+ * Same story as `normalMapGuard.ts`: skeleton checks compare joint NAMES, ORDER and rest POSITIONS. None compared
+ * a rest ORIENTATION to anything.
+ *
+ * ── THE TEST ───────────────────────────────────────────────────────────────────────────────────────
+ * Every conformed `helix-humanoid@1` body measured on 2026-10-02 (17 live characters, Base Male/Female, Sims 4,
+ * Kemonomimi, Unitree G1, Brass Keeper...) has its trunk, neck, head, leg and foot frames within 35 degrees of the
+ * canonical rest world frame, and its arm chain (aimed at the source's own arm pose) within 65. The flipped
+ * Cyberpunk base is at 171-180 on every one of them. Anything past `REST_FRAME_MAX_DEVIATION_DEG` is a turned or
+ * rolled skeleton, never a pose difference. Only a rig that actually carries the canonical joint names is judged;
+ * a rig with none of them is somebody else's skeleton and is left alone.
+ *
+ * Escape hatch: `HELIX_ALLOW_NONCANONICAL_REST_FRAMES=1`.
+ */
+import type { Document } from '@gltf-transform/core';
+export declare const REST_FRAME_MAX_DEVIATION_DEG = 100;
+/** The bones every humanoid body must have in the canonical orientation: trunk, head, legs, feet and the arm chain. */
+export declare const REST_FRAME_CHECKED_JOINTS: readonly string[];
+export interface RestFrameFinding {
+    joint: string;
+    degrees: number;
+}
+export interface RestFrameReport {
+    /** Joints actually compared (those present in both the GLB and the canonical skeleton). */
+    checked: number;
+    findings: RestFrameFinding[];
+}
+/** Compare the first skin's joint WORLD frames (wrapper nodes included: they are part of what the engine draws) to canonical. */
+export declare function inspectRestFrames(document: Document): RestFrameReport;
+export declare function describeRestFrameFindings(findings: readonly RestFrameFinding[]): string;
+/** Throws with an itemized report when the rig is a canonical humanoid that is turned or rolled away from the canonical frames. */
+export declare function assertRestFramesAreCanonical(document: Document, name?: string): RestFrameReport;
+export declare function assertGlbRestFramesAreCanonical(glb: Uint8Array, name?: string): Promise<RestFrameReport>;
+/** Shared by publish and publish --dry-run, so the gate before the fee is the gate at it. Character BASES only: an add-on carries a part skeleton judged by its host. */
+export declare function assertPublishRestFrames(opts: {
+    kind: string;
+    mesh?: string;
+}, meshBytes: Uint8Array | null | undefined): Promise<void>;