@helix3/helix-cli 0.1.7-helix3.43 → 0.1.7-helix3.45

package/dist/gesture/inspect.js

@@ -0,0 +1,357 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BONES = void 0;
+exports.compass = compass;
+exports.describePose = describePose;
+exports.inspectGesture = inspectGesture;
+exports.formatInspect = formatInspect;
+exports.relevantAxisRows = relevantAxisRows;
+// PORTED from helix-web-engine-new/systems/humanoid-character/scripts/pose.mjs — the source of truth for
+// pose observability. SYNC OBLIGATION: fix bugs there first, then mirror the change here; do not diverge.
+/**
+ * Headless pose observability — answers "where does this clip actually put the body, and what is it
+ * actually doing" without a browser.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * The bone axis table describes what each axis does FROM REST. Those meanings stop being true the moment
+ * a parent rotates: rotations chain, so a child's "raises the arm" axis is carried wherever the parent
+ * twist put it. Authoring a large multi-joint pose therefore cannot be reasoned out from the table alone
+ * — the only ground truth is where the bones land once the whole chain is posed.
+ *
+ * Runs the world's OWN compileGesture + GesturePlayer, so it cannot drift from what the world renders.
+ */
+const node_fs_1 = require("node:fs");
+const rig_1 = require("./rig");
+const worldRuntime_1 = require("./worldRuntime");
+const axisReference_1 = require("./axisReference");
+exports.DEFAULT_BONES = ['clavicle_r', 'upperarm_r', 'lowerarm_r', 'hand_r', 'head', 'spine_03'];
+const MOTION_SAMPLES = 64;
+const AXIS_PROBE_DEG = 10;
+const round = (v, n = 3) => Math.round(v * 10 ** n) / 10 ** n;
+const vec = (v) => [round(v.x), round(v.y), round(v.z)];
+const AXIS_NAMES = ['x', 'y', 'z'];
+/** Exported for tests: these two produce the human-facing readback, and are duck-typed on .x/.y/.z so
+ *  they need no three. A sign error here silently misleads every measurement an agent takes. */
+/** Coarse compass for a unit vector — never a precise angle, because conformed rigs differ by ~20° at the extremities. */
+function compass(v) {
+    const opts = [
+        ['up', v.y], ['down', -v.y], ['forward', v.z], ['backward', -v.z],
+        ['character-left', v.x], ['character-right', -v.x],
+    ].sort((a, b) => b[1] - a[1]);
+    return opts[0][1] < 0.8 ? `${opts[0][0]} and ${opts[1][0]}` : opts[0][0];
+}
+const worldOf = (three, bone) => { const p = new three.Vector3(); bone.getWorldPosition(p); return p; };
+const childBone = (bone) => bone.children.find((c) => c.isBone === true);
+/** The bone's TIP (its child joint). Rotating a bone does not move its own origin — only the tip moves,
+ *  which is why wrist rotation is invisible to a hand_r position probe. */
+const tipOf = (three, bone) => { const c = childBone(bone); return c !== undefined ? worldOf(three, c) : worldOf(three, bone); };
+function poseAt(ctx, gesture, seconds) {
+    for (const [bone, q] of ctx.rig.bind)
+        bone.quaternion.copy(q);
+    ctx.player.pose(gesture, seconds);
+    ctx.rig.root.updateMatrixWorld(true);
+}
+// ---- Self-calibrating hand frame ---------------------------------------------------------------------
+// Conform rebinds every character to the canonical skeleton but AIMS each mapped bone at that character's
+// own child joint (shortestArc4) — so hand frames differ by up to ~20° between rigs. Deriving the palm
+// from THIS rig's own bind pose absorbs that arc by construction; a canonical constant would not.
+function handFrame(ctx, handName) {
+    const { three, rig } = ctx;
+    const hand = rig.find(handName);
+    if (hand === null)
+        return null;
+    const side = handName.endsWith('_l') ? '_l' : '_r';
+    const fingerBone = rig.find(`middle_01${side}`) ?? rig.find(`index_01${side}`);
+    const thumbBone = rig.find(`thumb_01${side}`);
+    if (fingerBone === null || thumbBone === null)
+        return { unavailable: 'rig lacks finger bones' };
+    for (const [bone, q] of rig.bind)
+        bone.quaternion.copy(q);
+    rig.root.updateMatrixWorld(true);
+    const origin = worldOf(three, hand);
+    const fingers = worldOf(three, fingerBone).sub(origin).normalize();
+    const thumb = worldOf(three, thumbBone).sub(origin).normalize();
+    const palm = new three.Vector3().crossVectors(fingers, thumb).normalize();
+    // Cross-product handedness is a convention, not a measurement — fix it per side rather than sniffing a
+    // component. Verified on body-m / body-f / web-viking: right-hand cross(fingers,thumb) points INTO the
+    // palm on all three, and the left hand mirrors it exactly (Y/Z negated, X equal).
+    if (side === '_r')
+        palm.negate();
+    const bindQ = new three.Quaternion();
+    hand.getWorldQuaternion(bindQ);
+    const inv = bindQ.clone().invert();
+    return { hand, fingersLocal: fingers.applyQuaternion(inv), palmLocal: palm.applyQuaternion(inv) };
+}
+function facingNow(ctx, frame) {
+    if (frame === null)
+        return null;
+    if ('unavailable' in frame)
+        return { unavailable: frame.unavailable };
+    const q = new ctx.three.Quaternion();
+    frame.hand.getWorldQuaternion(q);
+    const palm = frame.palmLocal.clone().applyQuaternion(q);
+    const fingers = frame.fingersLocal.clone().applyQuaternion(q);
+    return { palm: vec(palm), fingers: vec(fingers), reads: `palm faces ${compass(palm)}, fingers point ${compass(fingers)}` };
+}
+/** Plain-English readback so an agent with no eyes can still tell a good pose from a broken one. */
+function describePose(name, pos, dir, ref) {
+    const parts = [];
+    if (ref.head !== null) {
+        const d = pos.y - ref.head;
+        if (d > 0.08)
+            parts.push(`${round(d, 2)}m above head`);
+        else if (d > -0.08)
+            parts.push('at head height');
+        else if (pos.y > ref.shoulder - 0.08)
+            parts.push('between shoulder and head');
+        else if (pos.y > ref.hip)
+            parts.push('between hip and shoulder');
+        else
+            parts.push('below hip');
+    }
+    const side = pos.x - ref.centerX;
+    if (Math.abs(side) > 0.12)
+        parts.push(`${round(Math.abs(side), 2)}m to the ${side > 0 ? 'character-left' : 'character-right'}`);
+    else
+        parts.push('near the midline');
+    const fwd = pos.z - ref.centerZ;
+    if (Math.abs(fwd) > 0.12)
+        parts.push(fwd > 0 ? `${round(fwd, 2)}m in front` : `${round(-fwd, 2)}m behind`);
+    if (dir !== null)
+        parts.push(`points ${compass(dir)}`);
+    return `${name}: ${parts.join(', ')}`;
+}
+function refsNow(ctx) {
+    const at = (n) => { const b = ctx.rig.find(n); return b !== null ? worldOf(ctx.three, b) : null; };
+    const head = at('head'), clav = at('clavicle_r'), pelvis = at('pelvis'), spine = at('spine_03');
+    return {
+        head: head !== null ? head.y : null,
+        shoulder: clav !== null ? clav.y : 0,
+        hip: pelvis !== null ? pelvis.y : 0,
+        centerX: spine !== null ? spine.x : 0,
+        centerZ: spine !== null ? spine.z : 0,
+    };
+}
+async function inspectGesture(opts) {
+    let raw;
+    try {
+        raw = opts.clip === '-' ? (0, node_fs_1.readFileSync)(0, 'utf8') : (0, node_fs_1.readFileSync)(opts.clip, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`cannot read the gesture clip ${opts.clip}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let source;
+    try {
+        source = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`${opts.clip} is not valid JSON: ${err.message}`);
+    }
+    const runtime = await (0, worldRuntime_1.loadGestureRuntime)(opts.worldDir);
+    const { three } = runtime;
+    const compiled = runtime.compileGesture(source);
+    const rig = opts.rig ? await (0, rig_1.glbRig)(three, opts.rig) : (0, rig_1.canonicalRig)(three);
+    // The player captures the bind pose at construction — must happen before anything poses the rig.
+    const ctx = { three, rig, player: new runtime.GesturePlayer(rig.root) };
+    const bones = opts.bones ?? exports.DEFAULT_BONES;
+    const times = (opts.times ?? []).length > 0 || opts.motion === true || opts.axes === true ? (opts.times ?? []) : ['0'];
+    const handFrames = new Map();
+    for (const name of bones)
+        if (/^hand_(l|r)$/.test(name))
+            handFrames.set(name, handFrame(ctx, name));
+    // ---- static frames --------------------------------------------------------------------------------
+    const frames = [];
+    for (const spec of times) {
+        const seconds = spec.endsWith('%') ? (parseFloat(spec) / 100) * compiled.gesture.duration : parseFloat(spec);
+        if (Number.isNaN(seconds))
+            throw new Error(`--t: '${spec}' is not a number of seconds or a percentage`);
+        poseAt(ctx, compiled.gesture, seconds);
+        const ref = refsNow(ctx);
+        const out = {};
+        for (const name of bones) {
+            const bone = rig.find(name);
+            if (bone === null) {
+                out[name] = { reads: `${name}: no such bone`, error: 'no such bone' };
+                continue;
+            }
+            const pos = worldOf(three, bone);
+            const child = childBone(bone);
+            const dir = child !== undefined ? worldOf(three, child).sub(pos).normalize() : null;
+            const entry = { pos: vec(pos), dir: dir !== null ? vec(dir) : null, reads: describePose(name, pos, dir, ref) };
+            if (handFrames.has(name))
+                entry.facing = facingNow(ctx, handFrames.get(name));
+            out[name] = entry;
+        }
+        frames.push({ t: seconds, bones: out });
+    }
+    // ---- --motion: what the clip DOES over time -------------------------------------------------------
+    // A static frame cannot show this. Tracks each bone's TIP, so wrist/finger rotation is visible.
+    let motion = null;
+    if (opts.motion === true) {
+        motion = {};
+        const paths = new Map(bones.map((n) => [n, []]));
+        const [w0, w1] = opts.motionWindow ?? [0, compiled.gesture.duration];
+        for (let i = 0; i < MOTION_SAMPLES; i++) {
+            poseAt(ctx, compiled.gesture, w0 + (i / (MOTION_SAMPLES - 1)) * (w1 - w0));
+            for (const name of bones) {
+                const bone = rig.find(name);
+                if (bone !== null)
+                    paths.get(name).push(tipOf(three, bone));
+            }
+        }
+        for (const [name, path] of paths) {
+            if (path.length === 0) {
+                motion[name] = { reads: `${name}: no such bone`, error: 'no such bone' };
+                continue;
+            }
+            const ext = ['x', 'y', 'z'].map((k) => {
+                const vals = path.map((p) => p[k]);
+                return Math.max(...vals) - Math.min(...vals);
+            });
+            const [lateral, vertical, depth] = ext;
+            let length = 0;
+            for (let i = 1; i < path.length; i++)
+                length += path[i].distanceTo(path[i - 1]);
+            const dominant = ext.indexOf(Math.max(...ext));
+            const total = Math.hypot(lateral, vertical, depth) || 1;
+            // Reversals along the dominant axis: a wave has several, a one-way reach has none.
+            const key = ['x', 'y', 'z'][dominant];
+            let reversals = 0, sign = 0;
+            for (let i = 1; i < path.length; i++) {
+                const d = path[i][key] - path[i - 1][key];
+                if (Math.abs(d) < 1e-4)
+                    continue;
+                const s = Math.sign(d);
+                if (sign !== 0 && s !== sign)
+                    reversals++;
+                sign = s;
+            }
+            const label = ['side-to-side', 'up-and-down', 'front-to-back'][dominant];
+            const purity = round(ext[dominant] / total, 2);
+            motion[name] = {
+                lateral: round(lateral), vertical: round(vertical), depth: round(depth),
+                pathLength: round(length), dominant: label, purity, reversals,
+                reads: `${name}: moves ${round(ext[dominant], 2)}m ${label} (purity ${purity}), `
+                    + `lateral ${round(lateral, 2)} / vertical ${round(vertical, 2)} / depth ${round(depth, 2)}, ${reversals} reversal(s)`,
+            };
+        }
+    }
+    // ---- --axes: what each keyed axis actually does AT the posed chain ---------------------------------
+    // The rest-frame table cannot answer this once parents have rotated. Perturbs the SOURCE key value (what
+    // an author would edit) and recompiles, so the reported effect is exactly what changing that number does.
+    let axes = null;
+    if (opts.axes === true) {
+        const keys = Array.isArray(source.keys) ? source.keys : [];
+        const probeName = opts.probe ?? [...bones].reverse().find((n) => rig.find(n) !== null) ?? 'hand_r';
+        axes = { probe: probeName, keys: [] };
+        for (let ki = 0; ki < keys.length; ki++) {
+            const key = keys[ki];
+            const bonesAtKey = key.bones ?? {};
+            const t = key.t ?? 0;
+            poseAt(ctx, compiled.gesture, t);
+            const probeBone = rig.find(probeName);
+            if (probeBone === null)
+                break;
+            const base = tipOf(three, probeBone);
+            const rows = [];
+            for (const boneName of Object.keys(bonesAtKey)) {
+                for (let ai = 0; ai < 3; ai++) {
+                    const probeSource = JSON.parse(JSON.stringify(source));
+                    probeSource.keys[ki].bones[boneName][ai] += AXIS_PROBE_DEG;
+                    let probeGesture;
+                    try {
+                        probeGesture = runtime.compileGesture(probeSource).gesture;
+                    }
+                    catch {
+                        continue;
+                    }
+                    poseAt(ctx, probeGesture, t);
+                    const moved = tipOf(three, rig.find(probeName)).sub(base);
+                    const mag = moved.length();
+                    if (mag < 1e-4) {
+                        rows.push({ axis: `${boneName}.${AXIS_NAMES[ai]}`, magnitude: 0, reads: `${boneName}.${AXIS_NAMES[ai]}: no effect on ${probeName}` });
+                        continue;
+                    }
+                    const unit = moved.clone().normalize();
+                    rows.push({
+                        axis: `${boneName}.${AXIS_NAMES[ai]}`, magnitude: round(mag), delta: vec(moved),
+                        reads: `${boneName}.${AXIS_NAMES[ai]}: +${AXIS_PROBE_DEG}° moves ${probeName} ${round(mag, 3)}m ${compass(unit)}`,
+                    });
+                    poseAt(ctx, compiled.gesture, t);
+                }
+            }
+            rows.sort((a, b) => b.magnitude - a.magnitude);
+            axes.keys.push({ t, rows });
+        }
+    }
+    return {
+        clip: compiled.gesture.name,
+        duration: compiled.gesture.duration,
+        rig: rig.source,
+        system: runtime.systemPath,
+        warnings: compiled.warnings ?? [],
+        frames,
+        motion,
+        axes,
+        keyedAxisRows: relevantAxisRows(runtime.axisTable, source),
+    };
+}
+/** Human-readable report. `--json` returns the InspectResult instead. */
+function formatInspect(r, opts = {}) {
+    const out = [`${r.clip} (${r.duration}s) — rig ${r.rig}`];
+    if (r.warnings.length > 0)
+        out.push(`warnings:\n  ${r.warnings.join('\n  ')}`);
+    for (const f of r.frames) {
+        out.push(`\nt=${f.t}s`);
+        for (const [name, b] of Object.entries(f.bones)) {
+            out.push(`  ${b.reads}`);
+            if (b.pos !== undefined)
+                out.push(`      pos=${JSON.stringify(b.pos)} dir=${JSON.stringify(b.dir)}`);
+            if (b.facing != null)
+                out.push(`      ${b.facing.unavailable !== undefined ? `facing unavailable — ${b.facing.unavailable}` : b.facing.reads}`);
+        }
+    }
+    if (r.motion !== null) {
+        out.push(`\nmotion over ${opts.motionWindow ? `t=${opts.motionWindow[0]}..${opts.motionWindow[1]}` : 'the whole clip'}`);
+        for (const m of Object.values(r.motion))
+            out.push(`  ${m.reads}`);
+    }
+    if (r.axes !== null) {
+        out.push(`\naxis effects at the posed chain (probe: ${r.axes.probe}, +${AXIS_PROBE_DEG}° each)`);
+        for (const k of r.axes.keys) {
+            if (k.rows.length === 0)
+                continue;
+            out.push(`  t=${k.t}s`);
+            for (const row of k.rows.slice(0, 8))
+                out.push(`    ${row.reads}`);
+        }
+    }
+    if (r.warnings.length > 0 && r.keyedAxisRows.length > 0) {
+        out.push('\nnatural ranges for the bones this clip keys (outside them warns, it does not fail)');
+        for (const row of r.keyedAxisRows) {
+            out.push(`  ${row.bones}  x ${row.natural.x.join('…')}  y ${row.natural.y.join('…')}  z ${row.natural.z.join('…')}`);
+        }
+    }
+    return out.join('\n');
+}
+/** Natural-range context for the bones a clip actually keys — the table rows that matter, not all 15. */
+function relevantAxisRows(table, clipJson) {
+    if (table === null)
+        return [];
+    const keyed = new Set();
+    for (const key of Array.isArray(clipJson?.keys) ? clipJson.keys : [])
+        for (const b of Object.keys(key.bones ?? {}))
+            keyed.add(b);
+    const seen = new Set();
+    const hits = [];
+    for (const bone of keyed) {
+        const ref = (0, axisReference_1.axisReferenceFor)(table, bone);
+        if (ref === undefined || seen.has(ref))
+            continue;
+        seen.add(ref);
+        hits.push({ bones: ref.bones.source, axes: ref.axes, natural: ref.natural });
+    }
+    return hits;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/gesture/inspect.js.map

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

package/dist/gesture/rig.d.ts

@@ -0,0 +1,12 @@
+export interface Rig {
+    root: any;
+    /** Bind-pose quaternion per bone, captured before any posing — the pose reset restores from this. */
+    bind: Map<any, any>;
+    find: (name: string) => any | null;
+    source: string;
+}
+/** The embedded canonical skeleton: local rest transforms are column-major mat4s, decomposed to TRS. */
+export declare function canonicalRig(three: any): Rig;
+/** A custom character's own rig. Only names + TRS are read, so KTX2 textures never need transcoding.
+ *  Mirrors `buildRig` in the engine's scripts/pose.mjs — same SYNC OBLIGATION as ./inspect.ts. */
+export declare function glbRig(three: any, glbPath: string): Promise<Rig>;

package/dist/gesture/rig.js

@@ -0,0 +1,111 @@
+"use strict";
+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.canonicalRig = canonicalRig;
+exports.glbRig = glbRig;
+// Builds the bone tree the gesture player poses. Default source is the canonical helix-humanoid@1 rest
+// skeleton already embedded for the conform pipeline — so inspecting a clip needs no asset download and
+// no network. `--rig <glb>` swaps in a custom character's own skeleton (conform aims each mapped bone at
+// that character's child joint, so extremity frames differ by up to ~20° between rigs).
+const canonicalSkeletonData_1 = require("../character/canonicalSkeletonData");
+function finalize(root, source) {
+    root.updateMatrixWorld(true);
+    const bind = new Map();
+    const byName = new Map();
+    root.traverse((n) => {
+        if (n.isBone !== true)
+            return;
+        bind.set(n, n.quaternion.clone());
+        if (!byName.has(n.name))
+            byName.set(n.name, n);
+    });
+    return { root, bind, find: (name) => byName.get(name) ?? null, source };
+}
+/** The embedded canonical skeleton: local rest transforms are column-major mat4s, decomposed to TRS. */
+function canonicalRig(three) {
+    const bones = new Map();
+    const root = new three.Object3D();
+    const m = new three.Matrix4();
+    for (const node of canonicalSkeletonData_1.CANONICAL_SKELETON_NODES) {
+        const bone = new three.Bone();
+        bone.name = node.name;
+        m.fromArray(node.local);
+        m.decompose(bone.position, bone.quaternion, bone.scale);
+        bones.set(node.name, bone);
+        const parent = node.parent === null ? root : bones.get(node.parent);
+        if (parent === undefined)
+            throw new Error(`canonical skeleton is out of order: ${node.name} precedes its parent ${node.parent}`);
+        parent.add(bone);
+    }
+    if (!bones.has(canonicalSkeletonData_1.CANONICAL_SKELETON_ROOT))
+        throw new Error(`canonical skeleton has no root '${canonicalSkeletonData_1.CANONICAL_SKELETON_ROOT}'`);
+    return finalize(root, `canonical helix-humanoid@1 (embedded, ${bones.size} bones)`);
+}
+/** A custom character's own rig. Only names + TRS are read, so KTX2 textures never need transcoding.
+ *  Mirrors `buildRig` in the engine's scripts/pose.mjs — same SYNC OBLIGATION as ./inspect.ts. */
+async function glbRig(three, glbPath) {
+    const { NodeIO } = await Promise.resolve().then(() => __importStar(require('@gltf-transform/core')));
+    const { ALL_EXTENSIONS } = await Promise.resolve().then(() => __importStar(require('@gltf-transform/extensions')));
+    // Extensions must be registered even though only the node hierarchy is read: the reader validates
+    // extensionsRequired up front, and the shipped bodies carry KTX2.
+    let doc;
+    try {
+        doc = await new NodeIO().registerExtensions(ALL_EXTENSIONS).read(glbPath);
+    }
+    catch (err) {
+        // The reader fails deep inside on a non-GLB (e.g. "reading 'version'"), which says nothing useful.
+        throw new Error(`--rig: ${glbPath} is not a readable .glb/.gltf — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const root = new three.Object3D();
+    let count = 0;
+    const convert = (node) => {
+        const bone = new three.Bone();
+        bone.name = node.getName();
+        bone.position.fromArray(node.getTranslation());
+        bone.quaternion.fromArray(node.getRotation());
+        bone.scale.fromArray(node.getScale());
+        count++;
+        for (const child of node.listChildren())
+            bone.add(convert(child));
+        return bone;
+    };
+    const scene = doc.getRoot().listScenes()[0];
+    if (scene === undefined)
+        throw new Error(`${glbPath} has no scene`);
+    for (const node of scene.listChildren())
+        root.add(convert(node));
+    return finalize(root, `${glbPath} (${count} nodes)`);
+}
+//# sourceMappingURL=rig.js.map

package/dist/gesture/rig.js.map

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

package/dist/gesture/worldRuntime.d.ts

@@ -0,0 +1,27 @@
+import type { BoneAxisReference } from './axisReference';
+export declare const SYSTEM_SLUG = "humanoid-character";
+/** The subset of @helix/humanoid-character's public API the gesture tools use. */
+export interface GestureRuntime {
+    three: any;
+    compileGesture: (json: unknown) => {
+        gesture: any;
+        warnings: string[];
+    };
+    GesturePlayer: new (root: any) => {
+        pose: (gesture: any, t: number, weight?: number) => void;
+    };
+    /** Absent on systems pinned before the table was exported — callers degrade instead of failing. */
+    axisTable: readonly BoneAxisReference[] | null;
+    systemPath: string;
+}
+/** Walk node_modules the way Node does. require.resolve is not usable here: three's `exports` map has no
+ *  "./package.json" entry, so resolving into the package to find its root is blocked. Exported so capture
+ *  resolves three the same way (hoisted/workspace layouts) and fails with this same npm-install message. */
+export declare function threeRoot(worldDir: string): string;
+/**
+ * The exact file Node gives the system's own bare `import … from 'three'`, so the CLI and the system share
+ * ONE module instance — two instances would break every instanceof inside the player. Exported for tests:
+ * it is the only part of this module they can reach, since Jest cannot load real ESM through importEsm.
+ */
+export declare function threeEsmPath(worldDir: string): string;
+export declare function loadGestureRuntime(worldDir: string): Promise<GestureRuntime>;

package/dist/gesture/worldRuntime.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_SLUG = void 0;
+exports.threeRoot = threeRoot;
+exports.threeEsmPath = threeEsmPath;
+exports.loadGestureRuntime = loadGestureRuntime;
+// Loads a world's OWN installed humanoid-character system (+ the three it was built against) so gesture
+// tooling runs the real compiler and player rather than a reimplementation that could drift. Everything
+// comes from the world: the code `helix install` downloaded, and the `three` in its node_modules.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const esm_1 = require("../character/esm");
+const paths_1 = require("../paths");
+exports.SYSTEM_SLUG = 'humanoid-character';
+function systemEntry(worldDir) {
+    const entry = (0, node_path_1.join)(worldDir, 'public', paths_1.MODULES_DIR, exports.SYSTEM_SLUG, 'index.js');
+    if (!(0, node_fs_1.existsSync)(entry)) {
+        throw new Error(`no installed ${exports.SYSTEM_SLUG} found at public/${paths_1.MODULES_DIR}/${exports.SYSTEM_SLUG}/index.js\n`
+            + `  Gesture tools run the world's OWN pinned system, so the world must be installed first:\n`
+            + `    cd ${worldDir} && npm install && helix install\n`
+            + '  (via MCP: npm install, then install_world_packages on this directory)');
+    }
+    return entry;
+}
+/** Walk node_modules the way Node does. require.resolve is not usable here: three's `exports` map has no
+ *  "./package.json" entry, so resolving into the package to find its root is blocked. Exported so capture
+ *  resolves three the same way (hoisted/workspace layouts) and fails with this same npm-install message. */
+function threeRoot(worldDir) {
+    for (let dir = worldDir;;) {
+        const candidate = (0, node_path_1.join)(dir, 'node_modules', 'three');
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(candidate, 'package.json')))
+            return candidate;
+        const parent = (0, node_path_1.dirname)(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`three is not installed in ${worldDir}\n`
+        + '  The character system imports three as an external — install the world\'s dependencies:\n'
+        + `    cd ${worldDir} && npm install`);
+}
+/**
+ * The exact file Node gives the system's own bare `import … from 'three'`, so the CLI and the system share
+ * ONE module instance — two instances would break every instanceof inside the player. Exported for tests:
+ * it is the only part of this module they can reach, since Jest cannot load real ESM through importEsm.
+ */
+function threeEsmPath(worldDir) {
+    const root = threeRoot(worldDir);
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(root, 'package.json'), 'utf8'));
+    const rel = pkg.exports?.['.']?.import ?? pkg.module ?? './build/three.module.js';
+    const esm = (0, node_path_1.join)(root, rel);
+    if (!(0, node_fs_1.existsSync)(esm))
+        throw new Error(`three at ${root} has no ESM entry at ${rel} — unexpected layout`);
+    return esm;
+}
+async function loadGestureRuntime(worldDir) {
+    const entry = systemEntry(worldDir);
+    const three = await (0, esm_1.importEsm)((0, node_url_1.pathToFileURL)(threeEsmPath(worldDir)).href);
+    const system = await (0, esm_1.importEsm)((0, node_url_1.pathToFileURL)(entry).href);
+    if (typeof system.compileGesture !== 'function' || typeof system.GesturePlayer !== 'function') {
+        throw new Error(`the installed ${exports.SYSTEM_SLUG} does not export compileGesture/GesturePlayer — it predates the gesture DSL.\n`
+            + '  Re-pin a newer version in helix.json and rerun `helix install`.');
+    }
+    return {
+        three,
+        compileGesture: system.compileGesture,
+        GesturePlayer: system.GesturePlayer,
+        axisTable: Array.isArray(system.BONE_AXIS_REFERENCE) ? system.BONE_AXIS_REFERENCE : null,
+        systemPath: entry,
+    };
+}
+//# sourceMappingURL=worldRuntime.js.map

package/dist/gesture/worldRuntime.js.map

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