@helix3/helix-cli 0.1.4-helix3.24

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

@@ -0,0 +1,56 @@
+import { Document } from '@gltf-transform/core';
+import type { BoneMap } from './retarget';
+export interface SkelNodeDef {
+    name: string;
+    /** local rest transform, column-major 16 */
+    local: number[];
+    parent: string | null;
+}
+export interface CanonicalSkeleton {
+    /** every node in the skeleton subtree (joints + structural, e.g. metacarpals), DFS order */
+    nodes: SkelNodeDef[];
+    /** the 68 skin joints, in skin joint order */
+    jointNames: string[];
+    /** world rest transform per node, accumulated from the skeleton root (root parent = identity) */
+    worldByName: Map<string, number[]>;
+    skeletonRootName: string;
+}
+/**
+ * Reads the canonical helix-humanoid@1 rest skeleton out of a shipped body GLB (body-m-default): the
+ * full bone subtree (local rest transforms + hierarchy) and the skin's joint order. World transforms
+ * are recomputed from the skeleton root down (independent of the source file's mesh-node ancestor),
+ * so a rebuilt copy with the root at scene identity reproduces them exactly.
+ */
+export declare function extractCanonicalSkeleton(document: Document): CanonicalSkeleton;
+export interface ConformResult {
+    mode: 'embed' | 'repose';
+    verticesProcessed: number;
+    jointsRebuilt: number;
+    /** warrior joint name -> helix joint that received its weights (via map, or nearest mapped ancestor) */
+    weightTargets: Record<string, string>;
+}
+export interface ConformOptions {
+    /**
+     * 'embed' (default): keep the source mesh EXACTLY (no distortion), embed the canonical skeleton at the
+     * source's own joint positions with canonical orientations. 'repose': re-pose the mesh onto the
+     * canonical rest via frame-based deltas (mesh conforms to canonical proportions — use only when a rig
+     * with canonical proportions is wanted over preserving the source character's silhouette).
+     */
+    mode?: 'embed' | 'repose';
+}
+/**
+ * Retargets a source character onto `helix-humanoid@1` so the PLATFORM's shared clips drive it.
+ *
+ * 'embed' (default, the better retarget): the source mesh is left byte-for-byte unchanged and the
+ * canonical 68-bone skeleton is fitted INTO it (canonical bone orientations at the source's joint
+ * positions, §fitSkeletonToWarrior). Clips — authored as local rotations relative to the canonical rest
+ * — produce the correct WORLD-space motion regardless of the source's bone-axis convention, because the
+ * mesh rides the bones in world space (we never route the mesh through mismatched local frames). Output
+ * IBMs = inverse(fitted world), so LBS at rest reproduces the pristine source bind pose.
+ *
+ * 'repose' re-poses the mesh onto the canonical rest via frame-based rest-pose correction (kept for
+ * cases wanting canonical proportions); it reshapes the mesh and is not the default.
+ *
+ * Source joints with no map entry fold onto their nearest mapped ancestor.
+ */
+export declare function conformToHelixRest(warrior: Document, canon: CanonicalSkeleton, boneMap: BoneMap, opts?: ConformOptions): ConformResult;

package/dist/character/stages/conform.js

@@ -0,0 +1,292 @@
+"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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCanonicalSkeleton = extractCanonicalSkeleton;
+exports.conformToHelixRest = conformToHelixRest;
+const core_1 = require("@gltf-transform/core");
+const mat4_1 = require("../mat4");
+const IDENTITY = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+const posOf = (m) => [m[12], m[13], m[14]];
+const vlen = (v) => Math.hypot(v[0], v[1], v[2]);
+/** Apply the transpose (=inverse, for a rotation) of a column-major matrix's upper 3x3 to a vector. */
+const applyRotT = (m, v) => [m[0] * v[0] + m[1] * v[1] + m[2] * v[2], m[4] * v[0] + m[5] * v[1] + m[6] * v[2], m[8] * v[0] + m[9] * v[1] + m[10] * v[2]];
+function parentNode(node) {
+    for (const p of node.listParents())
+        if (p.propertyType === core_1.PropertyType.NODE)
+            return p;
+    return null;
+}
+/**
+ * Reads the canonical helix-humanoid@1 rest skeleton out of a shipped body GLB (body-m-default): the
+ * full bone subtree (local rest transforms + hierarchy) and the skin's joint order. World transforms
+ * are recomputed from the skeleton root down (independent of the source file's mesh-node ancestor),
+ * so a rebuilt copy with the root at scene identity reproduces them exactly.
+ */
+function extractCanonicalSkeleton(document) {
+    const skin = document.getRoot().listSkins()[0];
+    if (skin === undefined)
+        throw new Error('extractCanonicalSkeleton: no skin in the canonical body GLB');
+    const jointNames = skin.listJoints().map((j) => j.getName());
+    const rootNode = skin.getSkeleton() ?? skin.listJoints()[0];
+    const nodes = [];
+    const worldByName = new Map();
+    const visit = (node, parent, parentWorld) => {
+        const local = node.getMatrix();
+        const world = (0, mat4_1.mul4)(parentWorld, local);
+        const name = node.getName();
+        nodes.push({ name, local, parent });
+        worldByName.set(name, world);
+        for (const child of node.listChildren())
+            visit(child, name, world);
+    };
+    visit(rootNode, null, IDENTITY);
+    return { nodes, jointNames, worldByName, skeletonRootName: rootNode.getName() };
+}
+/**
+ * Fits the canonical skeleton onto a source character's proportions: KEEPS every canonical bone's local
+ * REST ROTATION (so target clips apply natively) but sets each bone's WORLD POSITION to the source's
+ * corresponding joint — directly for mapped bones, and for unmapped in-betweens (spine_02/04, neck_02,
+ * twists, fingers) by scaling their canonical offset-from-parent by the enclosing mapped segment's
+ * scale. The result is a rig with canonical orientations at the source's own joint positions, so the
+ * source mesh binds to it UNCHANGED (no shape distortion — the whole point vs. re-posing the mesh).
+ */
+function fitSkeletonToWarrior(canon, directPos) {
+    const canonPos = (n) => posOf(canon.worldByName.get(n));
+    // Pass 1 — desired world position per bone (canon.nodes is DFS, parent before child).
+    const desired = new Map();
+    const scaleBy = new Map();
+    for (const def of canon.nodes) {
+        if (def.parent === null) {
+            desired.set(def.name, canonPos(def.name));
+            scaleBy.set(def.name, 1);
+            continue;
+        }
+        const pPos = desired.get(def.parent);
+        const canonOff = (0, mat4_1.sub3)(canonPos(def.name), canonPos(def.parent));
+        if (directPos.has(def.name)) {
+            const dp = directPos.get(def.name);
+            desired.set(def.name, dp);
+            const cl = vlen(canonOff);
+            scaleBy.set(def.name, cl > 1e-6 ? vlen((0, mat4_1.sub3)(dp, pPos)) / cl : (scaleBy.get(def.parent) ?? 1));
+        }
+        else {
+            const s = scaleBy.get(def.parent) ?? 1;
+            desired.set(def.name, [pPos[0] + canonOff[0] * s, pPos[1] + canonOff[1] * s, pPos[2] + canonOff[2] * s]);
+            scaleBy.set(def.name, s);
+        }
+    }
+    // Pass 2 — rebuild local matrices = canonical local ROTATION + fitted local TRANSLATION; recompute world.
+    // Exception — CLAVICLE rest-correction: the source's shoulder mesh is authored for its own clavicle
+    // direction (Meshy is ~horizontal; MetaHuman droops ~9°). Keeping the canonical clavicle rest binds the
+    // shoulder to the wrong reference, so a SHARED canonical clip drives the animated shoulder ~9° too
+    // horizontal (a shrug). Fix: rebase ONLY the two clavicle bones' rest ORIENTATION to point along the
+    // SOURCE clavicle direction. The IBM (inverse of this rest) then re-references the clip — the ~9° gap
+    // between the clip's canonical clavicle pose and this source-aligned rest becomes the corrective pull,
+    // so the animated shoulder matches the stock body. Children keep canonical local rotation and ride the
+    // correction. Positions/proportions untouched (lt kept); rest render stays pristine (M·IBM = I).
+    const ORIGIN = [0, 0, 0];
+    const CLAVICLE_CHILD = { clavicle_l: 'upperarm_l', clavicle_r: 'upperarm_r' };
+    const world = new Map();
+    const nodes = [];
+    for (const def of canon.nodes) {
+        const parentWorld = def.parent !== null ? world.get(def.parent) : IDENTITY;
+        const worldOff = def.parent !== null ? (0, mat4_1.sub3)(desired.get(def.name), desired.get(def.parent)) : desired.get(def.name);
+        const lt = def.parent !== null ? applyRotT(parentWorld, worldOff) : worldOff; // into parent's (canonical) frame
+        let rot = (0, mat4_1.rigidize)(def.local); // default: canonical local orientation
+        const clavChild = CLAVICLE_CHILD[def.name];
+        if (clavChild !== undefined && directPos.has(def.name) && directPos.has(clavChild)) {
+            const srcDir = (0, mat4_1.normalize3)((0, mat4_1.sub3)(directPos.get(clavChild), directPos.get(def.name))); // warrior clavicle dir
+            const canonDir = (0, mat4_1.normalize3)((0, mat4_1.sub3)(canonPos(clavChild), canonPos(def.name))); // canonical clavicle dir
+            const O = (0, mat4_1.mul4)((0, mat4_1.frameFromAxis)(canonDir, ORIGIN), (0, mat4_1.invert4)((0, mat4_1.frameFromAxis)(srcDir, ORIGIN))); // world src->canon
+            const worldRotDes = (0, mat4_1.mul4)((0, mat4_1.invert4)(O), (0, mat4_1.rigidize)(canon.worldByName.get(def.name))); // canon->src rest world
+            rot = (0, mat4_1.mul4)((0, mat4_1.invert4)((0, mat4_1.rigidize)(parentWorld)), worldRotDes); // back to local
+        }
+        const local = [rot[0], rot[1], rot[2], 0, rot[4], rot[5], rot[6], 0, rot[8], rot[9], rot[10], 0, lt[0], lt[1], lt[2], 1];
+        nodes.push({ name: def.name, local, parent: def.parent });
+        world.set(def.name, (0, mat4_1.mul4)(parentWorld, local));
+    }
+    return { nodes, jointNames: canon.jointNames, worldByName: world, skeletonRootName: canon.skeletonRootName };
+}
+/**
+ * Retargets a source character onto `helix-humanoid@1` so the PLATFORM's shared clips drive it.
+ *
+ * 'embed' (default, the better retarget): the source mesh is left byte-for-byte unchanged and the
+ * canonical 68-bone skeleton is fitted INTO it (canonical bone orientations at the source's joint
+ * positions, §fitSkeletonToWarrior). Clips — authored as local rotations relative to the canonical rest
+ * — produce the correct WORLD-space motion regardless of the source's bone-axis convention, because the
+ * mesh rides the bones in world space (we never route the mesh through mismatched local frames). Output
+ * IBMs = inverse(fitted world), so LBS at rest reproduces the pristine source bind pose.
+ *
+ * 'repose' re-poses the mesh onto the canonical rest via frame-based rest-pose correction (kept for
+ * cases wanting canonical proportions); it reshapes the mesh and is not the default.
+ *
+ * Source joints with no map entry fold onto their nearest mapped ancestor.
+ */
+function conformToHelixRest(warrior, canon, boneMap, opts = {}) {
+    const mode = opts.mode ?? 'embed';
+    const root = warrior.getRoot();
+    const wskin = root.listSkins()[0];
+    if (wskin === undefined)
+        throw new Error('conformToHelixRest: warrior GLB has no skin');
+    const wjoints = wskin.listJoints();
+    // Resolve each warrior joint to a helix joint (map, else nearest mapped ancestor).
+    const jointByNode = new Map(wjoints.map((j) => [j, true]));
+    const helixFor = (joint) => {
+        let cur = joint;
+        while (cur !== null) {
+            const mapped = boneMap.map[cur.getName()];
+            if (mapped !== undefined)
+                return mapped;
+            const p = parentNode(cur);
+            cur = p !== null && jointByNode.has(p) ? p : null;
+        }
+        throw new Error(`conformToHelixRest: warrior joint '${joint.getName()}' has no mapped ancestor`);
+    };
+    const helixByWarriorIdx = wjoints.map((j) => helixFor(j));
+    const weightTargets = {};
+    wjoints.forEach((j, i) => (weightTargets[j.getName()] = helixByWarriorIdx[i]));
+    // Warrior joint hierarchy + world rest positions.
+    const idxByNode = new Map(wjoints.map((j, i) => [j, i]));
+    const parentIdx = wjoints.map((j) => { const p = parentNode(j); return p !== null && idxByNode.has(p) ? idxByNode.get(p) : -1; });
+    const childIdxs = wjoints.map(() => []);
+    parentIdx.forEach((p, i) => { if (p >= 0)
+        childIdxs[p].push(i); });
+    const Tsrc = wjoints.map((j) => posOf(j.getWorldMatrix()));
+    // The rig the mesh binds to. 'embed': canonical orientations at the source's joint positions
+    // (proportions preserved). 'repose': the pristine canonical rest.
+    const directPos = new Map();
+    wjoints.forEach((j, i) => { const m = boneMap.map[j.getName()]; if (m !== undefined)
+        directPos.set(m, Tsrc[i]); });
+    const rig = mode === 'embed' ? fitSkeletonToWarrior(canon, directPos) : canon;
+    const Tdst = (helix) => posOf(rig.worldByName.get(helix));
+    // 'repose' only: per-warrior-joint frame-based delta D_i = frameDst·frameSrc⁻¹ (both frames from
+    // GEOMETRY, so the bone-axis CONVENTION cancels). Unused in 'embed' (mesh is not re-posed).
+    const incomingDirSrc = (i) => (parentIdx[i] >= 0 ? (0, mat4_1.normalize3)((0, mat4_1.sub3)(Tsrc[i], Tsrc[parentIdx[i]])) : [0, 1, 0]);
+    const incomingDirDst = (i) => parentIdx[i] >= 0 ? (0, mat4_1.normalize3)((0, mat4_1.sub3)(Tdst(helixByWarriorIdx[i]), Tdst(helixByWarriorIdx[parentIdx[i]]))) : [0, 1, 0];
+    const D = mode === 'repose' ? wjoints.map((_, i) => {
+        const inDir = incomingDirSrc(i);
+        let primary = -1, best = -Infinity;
+        for (const c of childIdxs[i]) {
+            if (helixByWarriorIdx[c] === helixByWarriorIdx[i])
+                continue;
+            const d = (0, mat4_1.dot3)((0, mat4_1.normalize3)((0, mat4_1.sub3)(Tsrc[c], Tsrc[i])), inDir);
+            if (d > best) {
+                best = d;
+                primary = c;
+            }
+        }
+        const axisSrc = primary >= 0 ? (0, mat4_1.normalize3)((0, mat4_1.sub3)(Tsrc[primary], Tsrc[i])) : inDir;
+        const axisDst = primary >= 0 ? (0, mat4_1.normalize3)((0, mat4_1.sub3)(Tdst(helixByWarriorIdx[primary]), Tdst(helixByWarriorIdx[i]))) : incomingDirDst(i);
+        return (0, mat4_1.mul4)((0, mat4_1.frameFromAxis)(axisDst, Tdst(helixByWarriorIdx[i])), (0, mat4_1.invert4)((0, mat4_1.frameFromAxis)(axisSrc, Tsrc[i])));
+    }) : null;
+    const canonIndexByName = new Map(canon.jointNames.map((n, i) => [n, i]));
+    const newIndexForWarriorIdx = wjoints.map((_, i) => {
+        const idx = canonIndexByName.get(helixByWarriorIdx[i]);
+        if (idx === undefined)
+            throw new Error(`conformToHelixRest: '${helixByWarriorIdx[i]}' not a canonical joint`);
+        return idx;
+    });
+    // Remap JOINTS_* to the canonical joint order on every primitive; in 'repose' also blend D into
+    // POSITION/NORMAL. In 'embed' the geometry is left untouched.
+    let verticesProcessed = 0;
+    for (const node of root.listNodes()) {
+        if (node.getSkin() !== wskin || node.getMesh() === null)
+            continue;
+        for (const prim of node.getMesh().listPrimitives()) {
+            const setCount = prim.listSemantics().filter((s) => s.startsWith('JOINTS_')).length;
+            if (setCount === 0)
+                continue;
+            const pos = prim.getAttribute('POSITION');
+            const nrm = prim.getAttribute('NORMAL');
+            const vCount = pos.getCount();
+            const jointSets = Array.from({ length: setCount }, (_, s) => new Uint32Array(prim.getAttribute(`JOINTS_${s}`).getArray()));
+            if (D !== null) {
+                const weightSets = Array.from({ length: setCount }, (_, s) => prim.getAttribute(`WEIGHTS_${s}`).getArray());
+                const posArr = Float32Array.from(pos.getArray());
+                const nrmArr = nrm !== null ? Float32Array.from(nrm.getArray()) : null;
+                for (let v = 0; v < vCount; v++) {
+                    const p = [posArr[v * 3], posArr[v * 3 + 1], posArr[v * 3 + 2]];
+                    const n = nrmArr !== null ? [nrmArr[v * 3], nrmArr[v * 3 + 1], nrmArr[v * 3 + 2]] : null;
+                    let px = 0, py = 0, pz = 0, nx = 0, ny = 0, nz = 0, wsum = 0;
+                    for (let s = 0; s < setCount; s++)
+                        for (let c = 0; c < 4; c++) {
+                            const w = weightSets[s][v * 4 + c];
+                            if (w === 0)
+                                continue;
+                            const d = D[jointSets[s][v * 4 + c]];
+                            const tp = (0, mat4_1.transformPoint)(d, p);
+                            px += w * tp[0];
+                            py += w * tp[1];
+                            pz += w * tp[2];
+                            if (n !== null) {
+                                const td = (0, mat4_1.transformDir)(d, n);
+                                nx += w * td[0];
+                                ny += w * td[1];
+                                nz += w * td[2];
+                            }
+                            wsum += w;
+                        }
+                    if (wsum > 0) {
+                        px /= wsum;
+                        py /= wsum;
+                        pz /= wsum;
+                    }
+                    posArr[v * 3] = px;
+                    posArr[v * 3 + 1] = py;
+                    posArr[v * 3 + 2] = pz;
+                    if (nrmArr !== null) {
+                        const l = Math.hypot(nx, ny, nz) || 1;
+                        nrmArr[v * 3] = nx / l;
+                        nrmArr[v * 3 + 1] = ny / l;
+                        nrmArr[v * 3 + 2] = nz / l;
+                    }
+                }
+                pos.setArray(posArr);
+                if (nrm !== null && nrmArr !== null)
+                    nrm.setArray(nrmArr);
+            }
+            for (let s = 0; s < setCount; s++) {
+                const src = jointSets[s];
+                const out = new Uint16Array(src.length);
+                for (let k = 0; k < src.length; k++)
+                    out[k] = newIndexForWarriorIdx[src[k]];
+                prim.getAttribute(`JOINTS_${s}`).setArray(out);
+            }
+            verticesProcessed += vCount;
+        }
+    }
+    // Rebuild the target skeleton (`rig`) in the warrior doc.
+    const buffer = root.listBuffers()[0];
+    const created = new Map();
+    for (const def of rig.nodes)
+        created.set(def.name, warrior.createNode(def.name).setMatrix(def.local));
+    for (const def of rig.nodes)
+        if (def.parent !== null)
+            created.get(def.parent).addChild(created.get(def.name));
+    const skeletonRoot = created.get(rig.skeletonRootName);
+    root.listScenes()[0].addChild(skeletonRoot);
+    const newIbm = new Float32Array(rig.jointNames.length * 16);
+    rig.jointNames.forEach((name, i) => newIbm.set((0, mat4_1.invert4)(rig.worldByName.get(name)), i * 16));
+    const newIbmAcc = warrior.createAccessor().setType('MAT4').setArray(newIbm).setBuffer(buffer);
+    const newSkin = warrior.createSkin('helix-humanoid').setInverseBindMatrices(newIbmAcc).setSkeleton(skeletonRoot);
+    for (const name of rig.jointNames)
+        newSkin.addJoint(created.get(name));
+    // Rebind the mesh nodes, reparent to the scene at identity, and delete the old rig + its bind-pose anim.
+    const scene = root.listScenes()[0];
+    for (const node of root.listNodes()) {
+        if (node.getSkin() === wskin && node.getMesh() !== null) {
+            node.setSkin(newSkin);
+            node.setMatrix(IDENTITY);
+            scene.addChild(node);
+        }
+    }
+    for (const anim of root.listAnimations())
+        anim.dispose();
+    wskin.dispose();
+    const topOld = (() => { let cur = wjoints[0]; for (let p = parentNode(cur); p !== null; p = parentNode(cur))
+        cur = p; return cur; })();
+    topOld.dispose();
+    return { mode, verticesProcessed, jointsRebuilt: rig.jointNames.length, weightTargets };
+}
+//# sourceMappingURL=conform.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { Document } from '@gltf-transform/core';
+export type Ktx2Mode = 'etc1s' | 'uastc';
+export interface Ktx2Result {
+    encoder: 'basis-wasm';
+    mode: Ktx2Mode;
+    encoded: {
+        name: string;
+        before: number;
+        after: number;
+    }[];
+}
+/**
+ * Encodes the document's color textures to KTX2 / Basis (KHR_texture_basisu) via the BasisU WASM
+ * encoder — GPU-compressed in VRAM (ETC1S ~6–8×, UASTC ~4×) and transcoded once at load by the
+ * client's KTX2Loader. Run on the FINAL merged web GLB. The import pipeline carries a single baked
+ * base-color atlas, so every remaining texture is an sRGB color/albedo map. Textures already in
+ * image/ktx2 are skipped (idempotent).
+ */
+export declare function encodeKtx2(document: Document, opts?: {
+    mode?: Ktx2Mode;
+    quality?: number;
+}): Promise<Ktx2Result>;

package/dist/character/stages/ktx2.js

@@ -0,0 +1,97 @@
+"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.
+// Deliberate divergence (the one rewrite): the engine tool shells out to the toktx binary; the CLI
+// encodes in-process via the ktx2-encoder WASM (BasisU) so `helix character import` needs no native
+// install. Options mirror the engine's toktx flags (--encode etc1s --clevel 2 --qlevel 196 --genmipmap
+// --assign_oetf srgb). Walk/extension/idempotence/result shape are kept identical.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeKtx2 = encodeKtx2;
+const extensions_1 = require("@gltf-transform/extensions");
+const esm_1 = require("../esm");
+/**
+ * Encodes the document's color textures to KTX2 / Basis (KHR_texture_basisu) via the BasisU WASM
+ * encoder — GPU-compressed in VRAM (ETC1S ~6–8×, UASTC ~4×) and transcoded once at load by the
+ * client's KTX2Loader. Run on the FINAL merged web GLB. The import pipeline carries a single baked
+ * base-color atlas, so every remaining texture is an sRGB color/albedo map. Textures already in
+ * image/ktx2 are skipped (idempotent).
+ */
+async function encodeKtx2(document, opts) {
+    const mode = opts?.mode ?? 'etc1s';
+    document.createExtension(extensions_1.KHRTextureBasisu).setRequired(true);
+    const { encodeToKTX2 } = (await (0, esm_1.importEsm)('ktx2-encoder'));
+    const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
+    const imageDecoder = async (buf) => {
+        const { data, info } = await sharp(Buffer.from(buf)).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+        return { width: info.width, height: info.height, data: new Uint8Array(data) };
+    };
+    // ETC1S: qualityLevel 1..255 (default 128). UASTC: uastcLDRQualityLevel 0..4. Faces are
+    // quality-sensitive, so default ETC1S quality high; raise/switch to uastc if blocking shows.
+    const options = mode === 'uastc'
+        ? {
+            isUASTC: true,
+            uastcLDRQualityLevel: opts?.quality ?? 2,
+            needSupercompression: true,
+            generateMipmap: true,
+            isPerceptual: true,
+            isSetKTX2SRGBTransferFunc: true,
+            isKTX2File: true,
+            imageDecoder,
+        }
+        : {
+            isUASTC: false,
+            qualityLevel: opts?.quality ?? 196,
+            compressionLevel: 2,
+            generateMipmap: true,
+            isPerceptual: true,
+            isSetKTX2SRGBTransferFunc: true,
+            isKTX2File: true,
+            imageDecoder,
+        };
+    const encoded = [];
+    for (const texture of document.getRoot().listTextures()) {
+        if (texture.getMimeType() === 'image/ktx2')
+            continue;
+        const img = texture.getImage();
+        if (img === null)
+            continue;
+        const ktx2 = await encodeToKTX2(img, options);
+        encoded.push({ name: texture.getName() || '(unnamed)', before: img.byteLength, after: ktx2.byteLength });
+        texture.setImage(ktx2).setMimeType('image/ktx2');
+    }
+    return { encoder: 'basis-wasm', mode, encoded };
+}
+//# sourceMappingURL=ktx2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ktx2.js","sourceRoot":"","sources":["../../../src/character/stages/ktx2.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;AAChG,mGAAmG;AACnG,oGAAoG;AACpG,uGAAuG;AACvG,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BnF,gCA8CC;AA1ED,2DAA8D;AAC9D,gCAAmC;AAoBnC;;;;;;GAMG;AACI,KAAK,UAAU,UAAU,CAAC,QAAkB,EAAE,IAA4C;IAC/F,MAAM,IAAI,GAAa,IAAI,EAAE,IAAI,IAAI,OAAO,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,6BAAgB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,IAAA,eAAS,EAAC,cAAc,CAAC,CAAsB,CAAC;IAChF,MAAM,KAAK,GAAG,CAAC,wDAAa,OAAO,GAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,EAAE,GAAe,EAAyB,EAAE;QACpE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/G,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAChF,CAAC,CAAC;IAEF,wFAAwF;IACxF,6FAA6F;IAC7F,MAAM,OAAO,GACX,IAAI,KAAK,OAAO;QACd,CAAC,CAAC;YACE,OAAO,EAAE,IAAI;YACb,oBAAoB,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC;YACxC,oBAAoB,EAAE,IAAI;YAC1B,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;YAClB,yBAAyB,EAAE,IAAI;YAC/B,UAAU,EAAE,IAAI;YAChB,YAAY;SACb;QACH,CAAC,CAAC;YACE,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,IAAI,EAAE,OAAO,IAAI,GAAG;YAClC,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;YAClB,yBAAyB,EAAE,IAAI;YAC/B,UAAU,EAAE,IAAI;YAChB,YAAY;SACb,CAAC;IAER,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC;QACxD,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,YAAY;YAAE,SAAS;QACrD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAC3B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACzG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,15 @@
+import { Document } from '@gltf-transform/core';
+export interface MergeLodsResult {
+    document: Document;
+    scenes: string[];
+    texturesBefore: number;
+    texturesAfter: number;
+}
+/**
+ * Merges per-LOD GLBs into one multi-scene document: scene i = LOD level i (named `lodN`, document
+ * order = level order), then dedup() collapses the byte-identical embedded images/materials the
+ * per-LOD optimize runs each carried. Three.js GLTFLoader exposes the levels as gltf.scenes[i] and
+ * its per-index caching shares one Texture/Material instance across levels — the runtime GPU dedupe
+ * falls out of the file format, no runtime code. (C2 materials backlog items 1+4.)
+ */
+export declare function mergeLods(documents: Document[]): Promise<MergeLodsResult>;

package/dist/character/stages/mergeLods.js

@@ -0,0 +1,42 @@
+"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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeLods = mergeLods;
+const core_1 = require("@gltf-transform/core");
+const functions_1 = require("@gltf-transform/functions");
+/**
+ * Merges per-LOD GLBs into one multi-scene document: scene i = LOD level i (named `lodN`, document
+ * order = level order), then dedup() collapses the byte-identical embedded images/materials the
+ * per-LOD optimize runs each carried. Three.js GLTFLoader exposes the levels as gltf.scenes[i] and
+ * its per-index caching shares one Texture/Material instance across levels — the runtime GPU dedupe
+ * falls out of the file format, no runtime code. (C2 materials backlog items 1+4.)
+ */
+async function mergeLods(documents) {
+    if (documents.length < 2)
+        throw new Error('merge-lods: needs at least two LOD documents');
+    const [target, ...rest] = documents;
+    let texturesBefore = target.getRoot().listTextures().length;
+    for (const source of rest) {
+        texturesBefore += source.getRoot().listTextures().length;
+        (0, functions_1.mergeDocuments)(target, source);
+    }
+    const sceneList = target.getRoot().listScenes();
+    if (sceneList.length !== documents.length) {
+        throw new Error(`merge-lods: expected ${documents.length} scenes after merge, found ${sceneList.length} (multi-scene input?)`);
+    }
+    const scenes = sceneList.map((scene, i) => {
+        scene.setName(`lod${i + 1}`);
+        return scene.getName();
+    });
+    target.getRoot().setDefaultScene(sceneList[0]);
+    // dedup everything EXCEPT meshes: a bare dedup() also fuses byte-identical MESHES, silently
+    // collapsing same-density LOD levels (e.g. a seam-floored import whose low LODs land at the same
+    // tri count) into one shared mesh object. Identical ACCESSORS may still merge — that only shrinks
+    // the GLB, never the scene/mesh structure. keepSolidTextures stops a near-solid bake from being
+    // folded into a material factor (which would delete the texture).
+    // unpartition: merged docs carry one buffer per source; GLB output requires exactly one.
+    await target.transform((0, functions_1.dedup)({ propertyTypes: [core_1.PropertyType.ACCESSOR, core_1.PropertyType.TEXTURE, core_1.PropertyType.MATERIAL, core_1.PropertyType.SKIN] }), (0, functions_1.prune)({ keepSolidTextures: true }), (0, functions_1.unpartition)());
+    return { document: target, scenes, texturesAfter: target.getRoot().listTextures().length, texturesBefore };
+}
+//# sourceMappingURL=mergeLods.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mergeLods.js","sourceRoot":"","sources":["../../../src/character/stages/mergeLods.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;;AAmBhG,8BA+BC;AAhDD,+CAA8D;AAC9D,yDAAsF;AAStF;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAAC,SAAqB;IACnD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC1F,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACpC,IAAI,cAAc,GAAG,MAAO,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;IAC7D,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,cAAc,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;QACzD,IAAA,0BAAc,EAAC,MAAO,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,SAAS,GAAG,MAAO,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC;IACjD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,CAAC,MAAM,8BAA8B,SAAS,CAAC,MAAM,uBAAuB,CAAC,CAAC;IACjI,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACxC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,MAAO,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC;IAEjD,4FAA4F;IAC5F,iGAAiG;IACjG,kGAAkG;IAClG,gGAAgG;IAChG,kEAAkE;IAClE,yFAAyF;IACzF,MAAM,MAAO,CAAC,SAAS,CACrB,IAAA,iBAAK,EAAC,EAAE,aAAa,EAAE,CAAC,mBAAY,CAAC,QAAQ,EAAE,mBAAY,CAAC,OAAO,EAAE,mBAAY,CAAC,QAAQ,EAAE,mBAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EACjH,IAAA,iBAAK,EAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,EAClC,IAAA,uBAAW,GAAE,CACd,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,MAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAO,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;AAC/G,CAAC"}

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

@@ -0,0 +1,2 @@
+import { Document } from '@gltf-transform/core';
+export declare function countTriangles(document: Document): number;

package/dist/character/stages/report.js

@@ -0,0 +1,19 @@
+"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.
+// Slim port: only countTriangles — the sole export the ported stages need (budgets/reports stay in the engine tool).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countTriangles = countTriangles;
+function countTriangles(document) {
+    let tris = 0;
+    for (const mesh of document.getRoot().listMeshes()) {
+        for (const prim of mesh.listPrimitives()) {
+            const indices = prim.getIndices();
+            const vertexCount = indices !== null ? indices.getCount() : (prim.getAttribute('POSITION')?.getCount() ?? 0);
+            if (prim.getMode() === 4)
+                tris += Math.floor(vertexCount / 3);
+        }
+    }
+    return tris;
+}
+//# sourceMappingURL=report.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/character/stages/report.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;AAChG,qHAAqH;;AAIrH,wCAUC;AAVD,SAAgB,cAAc,CAAC,QAAkB;IAC/C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC7G,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,11 @@
+import { Document } from '@gltf-transform/core';
+export interface ResizeTexturesResult {
+    /** `name WxH -> WxH` per resized texture. */
+    resized: string[];
+}
+/**
+ * Downsizes every embedded texture whose longest edge exceeds maxSize (PNG re-encode via sharp).
+ * Covers textures that arrive embedded in the UE export (the baked eye materials) — the head/body
+ * bake goes through its own TGA-decode resize in the CLI before it ever enters the document.
+ */
+export declare function resizeTextures(document: Document, maxSize: number): Promise<ResizeTexturesResult>;