@helix3/helix-cli 0.1.4-helix3.24

package/dist/character/stages/resizeTextures.js

@@ -0,0 +1,62 @@
+"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.
+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.resizeTextures = resizeTextures;
+/**
+ * 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.
+ */
+async function resizeTextures(document, maxSize) {
+    const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
+    const resized = [];
+    for (const texture of document.getRoot().listTextures()) {
+        const image = texture.getImage();
+        if (image === null)
+            continue;
+        const meta = await sharp(image).metadata();
+        const width = meta.width ?? 0;
+        const height = meta.height ?? 0;
+        if (width <= 0 || height <= 0 || Math.max(width, height) <= maxSize)
+            continue;
+        const out = await sharp(image).resize(maxSize, maxSize, { fit: 'inside' }).png().toBuffer();
+        texture.setImage(new Uint8Array(out)).setMimeType('image/png');
+        resized.push(`${texture.getName()} ${width}x${height} -> <=${maxSize}`);
+    }
+    return { resized };
+}
+//# sourceMappingURL=resizeTextures.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resizeTextures.js","sourceRoot":"","sources":["../../../src/character/stages/resizeTextures.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAchG,wCAeC;AApBD;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,QAAkB,EAAE,OAAe;IACtE,MAAM,KAAK,GAAG,CAAC,wDAAa,OAAO,GAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO;YAAE,SAAS;QAC9E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC5F,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,MAAM,SAAS,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,49 @@
+import { Document } from '@gltf-transform/core';
+export interface BoneMap {
+    name: string;
+    version: string;
+    comment?: string;
+    /** source bone name -> helix-humanoid@1 bone name */
+    map: Record<string, string>;
+    /** source bones with no helix target, removed if they are childless leaves */
+    drop?: string[];
+}
+export interface RetargetResult {
+    /** source name -> helix name, for every joint actually renamed */
+    renamed: Record<string, string>;
+    /** source bones present in the rig but absent from the map (left untouched) */
+    unmapped: string[];
+    /** dropped leaf helper bones */
+    dropped: string[];
+}
+export interface MapCoverage {
+    /** number of skin joints found on the source rig (0 = not a skinned character at all) */
+    sourceJoints: number;
+    /** map keys present on the source rig */
+    matched: string[];
+    /** canonical (helix) bone names the matched sources cover */
+    coveredTargets: Set<string>;
+    /** source joints in neither map nor drop (kept as-is by retargetSkeleton; deformation unverified) */
+    extra: string[];
+    /** true when the rig uses raw Mixamo download naming ('mixamorig:' prefixes) — the bundled map expects bare names */
+    mixamoPrefixed: boolean;
+}
+/**
+ * Preflight for retarget/conform: how much of the source rig does a bone map actually cover?
+ * Coverage is judged in CANONICAL terms (which helix bones receive a source match), so callers can
+ * enforce the same requirements against any custom map, not just the bundled Meshy one.
+ */
+export declare function checkMapCoverage(document: Document, boneMap: BoneMap): MapCoverage;
+/**
+ * Renames a source biped rig's joints to `helix-humanoid@1` bone names by an explicit map.
+ *
+ * This is the NAME half of the retarget (architecture §6.2): glTF animation channels target nodes
+ * by INDEX, so a joint rename automatically re-homes every clip track and the skin's joint list —
+ * the mesh's inverse bind matrices are untouched, so the body renders identically, now driven by
+ * helix bone names. The REST-POSE correction half (aligning the source rest orientation to the
+ * MetaHuman rest so the platform's own clips look right) is a separate stage; this alone is enough
+ * to drive the rig with clips authored IN ITS OWN rest frame (its bundled walk).
+ *
+ * Drop-list leaves (Meshy's head_end/headfront helpers) are removed from the graph + skin + IBMs.
+ */
+export declare function retargetSkeleton(document: Document, boneMap: BoneMap): RetargetResult;

package/dist/character/stages/retarget.js

@@ -0,0 +1,105 @@
+"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.checkMapCoverage = checkMapCoverage;
+exports.retargetSkeleton = retargetSkeleton;
+const core_1 = require("@gltf-transform/core");
+function parentOf(node) {
+    for (const parent of node.listParents()) {
+        if (parent.propertyType === core_1.PropertyType.NODE)
+            return parent;
+        if (parent.propertyType === core_1.PropertyType.SCENE)
+            return parent;
+    }
+    return null;
+}
+/**
+ * Preflight for retarget/conform: how much of the source rig does a bone map actually cover?
+ * Coverage is judged in CANONICAL terms (which helix bones receive a source match), so callers can
+ * enforce the same requirements against any custom map, not just the bundled Meshy one.
+ */
+function checkMapCoverage(document, boneMap) {
+    const joints = new Set();
+    for (const skin of document.getRoot().listSkins())
+        for (const j of skin.listJoints())
+            joints.add(j.getName());
+    const drop = new Set(boneMap.drop ?? []);
+    const matched = Object.keys(boneMap.map).filter((k) => joints.has(k));
+    return {
+        sourceJoints: joints.size,
+        matched,
+        coveredTargets: new Set(matched.map((k) => boneMap.map[k])),
+        extra: [...joints].filter((n) => !(n in boneMap.map) && !drop.has(n)),
+        mixamoPrefixed: [...joints].some((n) => n.startsWith('mixamorig')),
+    };
+}
+/**
+ * Renames a source biped rig's joints to `helix-humanoid@1` bone names by an explicit map.
+ *
+ * This is the NAME half of the retarget (architecture §6.2): glTF animation channels target nodes
+ * by INDEX, so a joint rename automatically re-homes every clip track and the skin's joint list —
+ * the mesh's inverse bind matrices are untouched, so the body renders identically, now driven by
+ * helix bone names. The REST-POSE correction half (aligning the source rest orientation to the
+ * MetaHuman rest so the platform's own clips look right) is a separate stage; this alone is enough
+ * to drive the rig with clips authored IN ITS OWN rest frame (its bundled walk).
+ *
+ * Drop-list leaves (Meshy's head_end/headfront helpers) are removed from the graph + skin + IBMs.
+ */
+function retargetSkeleton(document, boneMap) {
+    const root = document.getRoot();
+    const map = boneMap.map;
+    const dropSet = new Set(boneMap.drop ?? []);
+    const renamed = {};
+    const unmapped = [];
+    const dropped = [];
+    // Collect joint nodes from every skin (a source name may appear once; rename is idempotent per node).
+    const jointNodes = new Set();
+    for (const skin of root.listSkins())
+        for (const j of skin.listJoints())
+            jointNodes.add(j);
+    // 1. Drop childless leaf helpers first (so they never enter the rename/IBM bookkeeping).
+    for (const skin of root.listSkins()) {
+        const joints = skin.listJoints();
+        const dropIdx = joints
+            .map((j, i) => ({ j, i }))
+            .filter(({ j }) => dropSet.has(j.getName()) && j.listChildren().length === 0);
+        if (dropIdx.length === 0)
+            continue;
+        const oldIbm = skin.getInverseBindMatrices();
+        const keep = joints.filter((j) => !(dropSet.has(j.getName()) && j.listChildren().length === 0));
+        if (oldIbm !== null) {
+            const oldData = oldIbm.getArray();
+            const newData = new Float32Array(keep.length * 16);
+            keep.forEach((j, newIndex) => {
+                const oldIndex = joints.indexOf(j);
+                newData.set(oldData.subarray(oldIndex * 16, oldIndex * 16 + 16), newIndex * 16);
+            });
+            oldIbm.setArray(newData);
+        }
+        for (const { j } of dropIdx) {
+            skin.removeJoint(j);
+            if (!dropped.includes(j.getName()))
+                dropped.push(j.getName());
+            jointNodes.delete(j);
+            const parent = parentOf(j);
+            if (parent !== null)
+                for (const child of [...j.listChildren()])
+                    parent.addChild(child);
+            j.dispose();
+        }
+    }
+    // 2. Rename mapped joints. Channels target nodes by index → clip tracks follow the rename for free.
+    for (const node of jointNodes) {
+        const src = node.getName();
+        const dst = map[src];
+        if (dst === undefined) {
+            unmapped.push(src);
+            continue;
+        }
+        node.setName(dst);
+        renamed[src] = dst;
+    }
+    return { renamed, unmapped, dropped };
+}
+//# sourceMappingURL=retarget.js.map

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

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

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

@@ -0,0 +1,27 @@
+import { Document } from '@gltf-transform/core';
+import type { BoneMap } from './retarget';
+import type { CanonicalSkeleton } from './conform';
+export interface RetargetClipResult {
+    document: Document;
+    meta: {
+        name: string;
+        duration: number;
+        loop: boolean;
+        strideSpeed: null;
+        additive: false;
+    };
+    frames: number;
+    /** helix bones that received a retargeted rotation track */
+    animatedBones: string[];
+}
+/**
+ * Retargets a source animation CLIP onto the canonical `helix-humanoid@1` skeleton via world-space
+ * motion transfer (the architecture §6.2 / three-vrm approach): each mapped bone's WORLD-space rotation
+ * delta from the SOURCE rest is re-applied to the TARGET rest, then converted back to the target's local
+ * frame. Because the motion is transferred as a delta-from-rest in world space, the source↔target
+ * bone-axis convention cancels — the same reason the mesh embed is convention-proof. Root (pelvis)
+ * translation is retargeted as an in-place bob/sway scaled to the target's hip height. Unmapped target
+ * bones (spine_02/04, twists, fingers) stay at rest. Output is a clip-only GLB (canonical skeleton
+ * nodes + one animation, no mesh/skin) — the platform clip format.
+ */
+export declare function retargetClip(source: Document, canon: CanonicalSkeleton, boneMap: BoneMap, clipName: string): RetargetClipResult;

package/dist/character/stages/retargetClip.js

@@ -0,0 +1,237 @@
+"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.
+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.retargetClip = retargetClip;
+const core_1 = require("@gltf-transform/core");
+const mat4_1 = require("../mat4");
+const q = __importStar(require("../quat"));
+function jointParent(node, jointSet) {
+    for (const p of node.listParents())
+        if (p.propertyType === core_1.PropertyType.NODE && jointSet.has(p))
+            return p;
+    return null;
+}
+/**
+ * Retargets a source animation CLIP onto the canonical `helix-humanoid@1` skeleton via world-space
+ * motion transfer (the architecture §6.2 / three-vrm approach): each mapped bone's WORLD-space rotation
+ * delta from the SOURCE rest is re-applied to the TARGET rest, then converted back to the target's local
+ * frame. Because the motion is transferred as a delta-from-rest in world space, the source↔target
+ * bone-axis convention cancels — the same reason the mesh embed is convention-proof. Root (pelvis)
+ * translation is retargeted as an in-place bob/sway scaled to the target's hip height. Unmapped target
+ * bones (spine_02/04, twists, fingers) stay at rest. Output is a clip-only GLB (canonical skeleton
+ * nodes + one animation, no mesh/skin) — the platform clip format.
+ */
+function retargetClip(source, canon, boneMap, clipName) {
+    // ---- source rig: hierarchy (DFS parent-first), rest local/world rotations, and clip tracks --------
+    const srcSkin = source.getRoot().listSkins()[0];
+    if (srcSkin === undefined)
+        throw new Error('retargetClip: source has no skin');
+    const srcJoints = srcSkin.listJoints();
+    const jointSet = new Set(srcJoints);
+    const srcRoot = srcSkin.getSkeleton() ?? srcJoints.find((j) => jointParent(j, jointSet) === null) ?? srcJoints[0];
+    const srcOrder = [];
+    (function dfs(n) { srcOrder.push(n); for (const c of n.listChildren())
+        if (jointSet.has(c))
+            dfs(c); })(srcRoot);
+    const srcParentName = new Map();
+    for (const j of srcOrder)
+        srcParentName.set(j.getName(), jointParent(j, jointSet)?.getName() ?? null);
+    const srcRestLocalQuat = new Map(srcOrder.map((j) => [j.getName(), j.getRotation()]));
+    const srcRestLocalTrans = new Map(srcOrder.map((j) => [j.getName(), [...j.getTranslation()]]));
+    const srcRestWorldQuat = new Map();
+    for (const j of srcOrder) {
+        const p = srcParentName.get(j.getName());
+        srcRestWorldQuat.set(j.getName(), q.normalize(p === null ? srcRestLocalQuat.get(j.getName()) : q.mul(srcRestWorldQuat.get(p), srcRestLocalQuat.get(j.getName()))));
+    }
+    const anim = source.getRoot().listAnimations()[0];
+    if (anim === undefined)
+        throw new Error('retargetClip: source has no animation');
+    const rotTrack = new Map();
+    const transTrack = new Map();
+    const allTimes = new Set();
+    let hasRot = false;
+    for (const ch of anim.listChannels()) {
+        const node = ch.getTargetNode();
+        const s = ch.getSampler();
+        if (node === null || s === null)
+            continue;
+        const times = s.getInput().getArray();
+        const out = s.getOutput().getArray();
+        // Master timeline = union of rotation ∪ translation input times, so a bob key at a different density
+        // than the rotation keys isn't aliased away (scale/STEP tracks are dropped and don't contribute).
+        if (ch.getTargetPath() === 'rotation') {
+            rotTrack.set(node.getName(), { times, quats: out });
+            hasRot = true;
+            for (const t of times)
+                allTimes.add(t);
+        }
+        else if (ch.getTargetPath() === 'translation') {
+            transTrack.set(node.getName(), { times, vals: out });
+            for (const t of times)
+                allTimes.add(t);
+        }
+    }
+    if (!hasRot)
+        throw new Error('retargetClip: source animation has no rotation channels');
+    const srcTimes = [...allTimes].sort((a, b) => a - b);
+    const t0 = srcTimes[0];
+    const outTimes = srcTimes.map((t) => t - t0);
+    const frames = srcTimes.length;
+    // ---- target rig: canonical rest local/world rotations + pelvis rest ------------------------------
+    const canonParent = new Map(canon.nodes.map((n) => [n.name, n.parent]));
+    const canonLocalMat = new Map(canon.nodes.map((n) => [n.name, n.local]));
+    const canonRestLocalQuat = new Map(canon.nodes.map((n) => [n.name, q.fromMat((0, mat4_1.rigidize)(n.local))]));
+    const canonRestWorldQuat = new Map();
+    for (const n of canon.nodes) {
+        const p = n.parent;
+        canonRestWorldQuat.set(n.name, q.normalize(p === null ? canonRestLocalQuat.get(n.name) : q.mul(canonRestWorldQuat.get(p), canonRestLocalQuat.get(n.name))));
+    }
+    const pelvisLocal = canonLocalMat.get('pelvis');
+    const canonPelvisRestLocalTrans = [pelvisLocal[12], pelvisLocal[13], pelvisLocal[14]];
+    const canonPelvisRestWorldY = canon.worldByName.get('pelvis')[13];
+    // invert the bone map (helix -> source), direct entries only
+    const invMap = new Map();
+    for (const [src, helix] of Object.entries(boneMap.map))
+        invMap.set(helix, src);
+    // pelvis bob scale: source hips local translation (armature-scaled, ~cm) -> canonical-meter bob.
+    const hipsSrcName = invMap.get('pelvis');
+    const hipsNode = srcJoints.find((j) => j.getName() === hipsSrcName);
+    const hipsWorldRestY = hipsNode.getWorldMatrix()[13];
+    const hipsLocalRest = srcRestLocalTrans.get(hipsSrcName);
+    const bobScale = Math.abs(hipsLocalRest[1]) > 1e-6 ? canonPelvisRestWorldY / hipsLocalRest[1] : 1;
+    // Rotation that carries a vector from the source pelvis-parent local frame into the target pelvis-parent
+    // local frame (via world): conj(dstParentWorld)·srcParentWorld. Without it a vertical bob in the source
+    // frame lands on the wrong target axis (the two rigs' conventions differ) → a sideways shove.
+    const srcHipsParentName = srcParentName.get(hipsSrcName) ?? null;
+    const srcHipsParentWorldRot = srcHipsParentName !== null ? srcRestWorldQuat.get(srcHipsParentName) : [0, 0, 0, 1];
+    const canonPelvisParentName = canonParent.get('pelvis') ?? null;
+    const canonPelvisParentWorldRot = canonPelvisParentName !== null ? canonRestWorldQuat.get(canonPelvisParentName) : [0, 0, 0, 1];
+    const bobRot = q.mul(q.conj(canonPelvisParentWorldRot), srcHipsParentWorldRot);
+    // Clavicle rest-correction (mirror of the embed lane). The rigs' clavicle RESTS differ ~9° (Meshy
+    // shoulder ~horizontal, MetaHuman droops). The transfer maps source-rest → canonical-rest, so a Meshy
+    // shoulder held horizontal lands ~9° too low (dropped shoulders). For the two clavicles, use a rest
+    // REFERENCE aligned to the SOURCE clavicle direction, so the imported animation preserves the source's
+    // shoulder carriage. Only the clavicle bone shifts — the child upperarm's local compensates (its world
+    // orientation is unchanged), so the arm just rides the lifted shoulder instead of tilting.
+    const ORIGIN = [0, 0, 0];
+    const posOf = (m) => [m[12], m[13], m[14]];
+    const restRef = new Map(canon.nodes.map((n) => [n.name, canonRestWorldQuat.get(n.name)]));
+    for (const [clav, upper] of [['clavicle_l', 'upperarm_l'], ['clavicle_r', 'upperarm_r']]) {
+        const srcClav = invMap.get(clav), srcUpper = invMap.get(upper);
+        const scn = srcClav !== undefined ? srcJoints.find((j) => j.getName() === srcClav) : undefined;
+        const sun = srcUpper !== undefined ? srcJoints.find((j) => j.getName() === srcUpper) : undefined;
+        if (scn === undefined || sun === undefined)
+            continue;
+        const srcDir = (0, mat4_1.normalize3)((0, mat4_1.sub3)(posOf(sun.getWorldMatrix()), posOf(scn.getWorldMatrix())));
+        const canonDir = (0, mat4_1.normalize3)((0, mat4_1.sub3)(posOf(canon.worldByName.get(upper)), posOf(canon.worldByName.get(clav))));
+        const O = q.fromMat((0, mat4_1.mul4)((0, mat4_1.frameFromAxis)(canonDir, ORIGIN), (0, mat4_1.invert4)((0, mat4_1.frameFromAxis)(srcDir, ORIGIN)))); // src->canon world rot
+        restRef.set(clav, q.normalize(q.mul(q.conj(O), canonRestWorldQuat.get(clav)))); // canon rest, re-aimed at source dir
+    }
+    // ---- per-frame retarget --------------------------------------------------------------------------
+    const animatedBones = [...invMap.keys()].filter((c) => canonParent.has(c));
+    const outRot = new Map(animatedBones.map((c) => [c, new Float32Array(frames * 4)]));
+    const outPelvis = new Float32Array(frames * 3);
+    for (let f = 0; f < frames; f++) {
+        const tOrig = srcTimes[f];
+        // 1. source FK pose
+        const srcWorld = new Map();
+        for (const j of srcOrder) {
+            const name = j.getName();
+            const track = rotTrack.get(name);
+            const local = track ? q.sampleQuat(track.times, track.quats, tOrig) : srcRestLocalQuat.get(name);
+            const p = srcParentName.get(name);
+            srcWorld.set(name, q.normalize(p === null ? local : q.mul(srcWorld.get(p), local)));
+        }
+        // 2+3. target world rotations. Mapped bones follow the source's world delta-from-rest. UNMAPPED
+        // bones PROPAGATE their (already-retargeted) parent's motion while keeping their canonical rest
+        // LOCAL — matching how they behave at playback (no track ⇒ rest-local under a moving parent). Freezing
+        // them at rest WORLD instead would make a mapped child counter-rotate and shear the spine.
+        const dstWorld = new Map();
+        for (const n of canon.nodes) {
+            const s = invMap.get(n.name);
+            if (s !== undefined && srcWorld.has(s)) {
+                const delta = q.mul(srcWorld.get(s), q.conj(srcRestWorldQuat.get(s)));
+                dstWorld.set(n.name, q.normalize(q.mul(delta, restRef.get(n.name)))); // restRef = canon rest, clavicle re-aimed at source
+            }
+            else if (n.parent === null) {
+                dstWorld.set(n.name, canonRestWorldQuat.get(n.name));
+            }
+            else {
+                dstWorld.set(n.name, q.normalize(q.mul(dstWorld.get(n.parent), canonRestLocalQuat.get(n.name))));
+            }
+        }
+        // 4. mapped bones -> local rotation track
+        for (const c of animatedBones) {
+            const p = canonParent.get(c);
+            const local = p === null ? dstWorld.get(c) : q.mul(q.conj(dstWorld.get(p)), dstWorld.get(c));
+            outRot.get(c).set(local, f * 4);
+        }
+        // 5. pelvis in-place bob — route the source-local delta through world into the target-local frame.
+        const hipsTrack = transTrack.get(hipsSrcName);
+        const hips = hipsTrack ? q.sampleVec3(hipsTrack.times, hipsTrack.vals, tOrig) : hipsLocalRest;
+        const bob = q.rotateVec(bobRot, [bobScale * (hips[0] - hipsLocalRest[0]), bobScale * (hips[1] - hipsLocalRest[1]), bobScale * (hips[2] - hipsLocalRest[2])]);
+        outPelvis[f * 3] = canonPelvisRestLocalTrans[0] + bob[0];
+        outPelvis[f * 3 + 1] = canonPelvisRestLocalTrans[1] + bob[1];
+        outPelvis[f * 3 + 2] = canonPelvisRestLocalTrans[2] + bob[2];
+    }
+    // ---- assemble the clip-only GLB: canonical skeleton nodes + one animation ------------------------
+    const doc = new core_1.Document();
+    const buffer = doc.createBuffer();
+    const scene = doc.createScene('clip');
+    const created = new Map();
+    for (const def of canon.nodes)
+        created.set(def.name, doc.createNode(def.name).setMatrix(def.local));
+    for (const def of canon.nodes)
+        if (def.parent !== null)
+            created.get(def.parent).addChild(created.get(def.name));
+    scene.addChild(created.get(canon.skeletonRootName));
+    const clip = doc.createAnimation(clipName);
+    const input = doc.createAccessor().setType('SCALAR').setArray(new Float32Array(outTimes)).setBuffer(buffer);
+    for (const c of animatedBones) {
+        const output = doc.createAccessor().setType('VEC4').setArray(outRot.get(c)).setBuffer(buffer);
+        const sampler = doc.createAnimationSampler().setInput(input).setOutput(output).setInterpolation('LINEAR');
+        clip.addSampler(sampler);
+        clip.addChannel(doc.createAnimationChannel().setTargetNode(created.get(c)).setTargetPath('rotation').setSampler(sampler));
+    }
+    const pelvisOut = doc.createAccessor().setType('VEC3').setArray(outPelvis).setBuffer(buffer);
+    const pelvisSampler = doc.createAnimationSampler().setInput(input).setOutput(pelvisOut).setInterpolation('LINEAR');
+    clip.addSampler(pelvisSampler);
+    clip.addChannel(doc.createAnimationChannel().setTargetNode(created.get('pelvis')).setTargetPath('translation').setSampler(pelvisSampler));
+    const duration = outTimes[frames - 1] - outTimes[0];
+    return { document: doc, meta: { name: clipName, duration: Math.round(duration * 1000) / 1000, loop: true, strideSpeed: null, additive: false }, frames, animatedBones };
+}
+//# sourceMappingURL=retargetClip.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { Document } from '@gltf-transform/core';
+export interface SimplifyResult {
+    before: number;
+    after: number;
+}
+/**
+ * Attribute-preserving simplification to a triangle target via meshopt. `lockBorder` additionally
+ * locks open-border vertices (architecture §6: never re-UV — the platform's identity-as-textures
+ * depends on the original layout), so it stays TRUE for first-party bodies; importers with real open
+ * borders (hair cards, garments) may pass false. Note meshopt ALWAYS preserves attribute-seam
+ * vertices regardless of these knobs — a micro-chart baked atlas (Meshy) therefore floors at its
+ * chart-border ring (~34% on the reference warrior) whatever the error budget; that case needs
+ * weldedSimplify, not bigger `errorCap` (0.001 first-party; ~0.02 for imports).
+ */
+export declare function simplifyToTarget(document: Document, targetTris: number, errorCap?: number, lockBorder?: boolean): Promise<SimplifyResult>;

package/dist/character/stages/simplifyMesh.js

@@ -0,0 +1,37 @@
+"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.simplifyToTarget = simplifyToTarget;
+const functions_1 = require("@gltf-transform/functions");
+const meshoptimizer_1 = require("meshoptimizer");
+const report_1 = require("./report");
+/**
+ * Attribute-preserving simplification to a triangle target via meshopt. `lockBorder` additionally
+ * locks open-border vertices (architecture §6: never re-UV — the platform's identity-as-textures
+ * depends on the original layout), so it stays TRUE for first-party bodies; importers with real open
+ * borders (hair cards, garments) may pass false. Note meshopt ALWAYS preserves attribute-seam
+ * vertices regardless of these knobs — a micro-chart baked atlas (Meshy) therefore floors at its
+ * chart-border ring (~34% on the reference warrior) whatever the error budget; that case needs
+ * weldedSimplify, not bigger `errorCap` (0.001 first-party; ~0.02 for imports).
+ */
+async function simplifyToTarget(document, targetTris, errorCap = 0.001, lockBorder = true) {
+    const before = (0, report_1.countTriangles)(document);
+    if (before <= targetTris)
+        return { before, after: before };
+    await meshoptimizer_1.MeshoptSimplifier.ready;
+    await document.transform((0, functions_1.weld)());
+    // meshopt treats ratio as a hint (lockBorder / the error budget raise the floor), so iterate until
+    // at/under target or the count stops moving — the floor is then the honest result. Seam-locked
+    // imports (micro-chart atlases) floor by attempt 2 no matter what; weldedSimplify is the tool there.
+    let current = before;
+    for (let attempt = 0; attempt < 4 && current > targetTris; attempt++) {
+        await document.transform((0, functions_1.simplify)({ simplifier: meshoptimizer_1.MeshoptSimplifier, ratio: targetTris / current, error: errorCap, lockBorder }));
+        const after = (0, report_1.countTriangles)(document);
+        if (after >= current)
+            break;
+        current = after;
+    }
+    return { before, after: current };
+}
+//# sourceMappingURL=simplifyMesh.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simplifyMesh.js","sourceRoot":"","sources":["../../../src/character/stages/simplifyMesh.ts"],"names":[],"mappings":";AAAA,oGAAoG;AACpG,gGAAgG;;AAqBhG,4CAiBC;AAnCD,yDAA2D;AAC3D,iDAAkD;AAClD,qCAA0C;AAO1C;;;;;;;;GAQG;AACI,KAAK,UAAU,gBAAgB,CAAC,QAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI;IAChH,MAAM,MAAM,GAAG,IAAA,uBAAc,EAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,IAAI,UAAU;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAE3D,MAAM,iCAAiB,CAAC,KAAK,CAAC;IAC9B,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAA,gBAAI,GAAE,CAAC,CAAC;IACjC,mGAAmG;IACnG,+FAA+F;IAC/F,qGAAqG;IACrG,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACrE,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAA,oBAAQ,EAAC,EAAE,UAAU,EAAE,iCAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAChI,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,KAAK,IAAI,OAAO;YAAE,MAAM;QAC5B,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,30 @@
+import { Document } from '@gltf-transform/core';
+export interface SplitFaceResult {
+    split: boolean;
+    faceTris: number;
+    bodyTris: number;
+    /** joints in the head subtree that drove the classification */
+    headJoints: number;
+}
+/**
+ * Slices the head geometry out of a single-mesh character into its own 'FaceMesh' node, so the
+ * runtime's first-person mode can hide it (CameraRig `fpHideMeshes` matches mesh names containing
+ * 'FaceMesh'; the stock character ships its face as a separate part — imports are one welded mesh).
+ *
+ * The split is WEIGHT-driven and therefore rig-agnostic: after conform the skeleton is canonical,
+ * so a triangle belongs to the face part when its mean skin weight into the NECK-AND-UP subtree
+ * (neck_01 -> neck_02 -> head -> facial root; falls back to 'head' when no neck joint exists)
+ * exceeds 0.5. Rooting at the neck matters on auto-rigged imports: their face skin blends head WITH
+ * neck (head alone rarely crosses 0.5 outside the skull), and the stock face part includes a neck
+ * skirt too (see CameraRig's skull-measure). Scalp-anchored hair/hats ride along; LONG draped hair
+ * that auto-rigs weight to the clavicles stays on the body — in first person it behaves like
+ * shoulder-wear, swaying at the screen edges the way the visible shoulders do. Only the index
+ * buffer splits — the face primitive SHARES the body's attribute accessors, so the file grows by
+ * one index accessor and one node per scene. The MATERIAL however must be a distinct instance
+ * (textures still shared): the runtime hides the face by mutating material.colorWrite, and
+ * GLTFLoader gives prims that reference one glTF material the same THREE.Material — a shared
+ * material would hide the body. For that same reason this stage MUST run AFTER merge-lods: its
+ * dedup compares materials by value (names ignored) and would fold the face clone back into the
+ * body material. Every scene of the merged document is split (scene i = LOD level i).
+ */
+export declare function splitFacePrimitive(document: Document): SplitFaceResult;