@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/character/stages/vrmDynamics.js

@@ -0,0 +1,421 @@
+"use strict";
+/**
+ * VRM SpringBone → `helix/dynamics@1`.
+ *
+ * ── WHY VRM FIRST ──────────────────────────────────────────────────────────────────────────────────────────────
+ * It is the only openly specified secondary-motion format with a large body of real content, the configuration
+ * travels INSIDE the .vrm (unlike a Unity prefab, where the parameters live in a scene file that never ships),
+ * and both major versions are readable without a game engine. That makes it the honest first target for an
+ * importer and the honest test corpus for a solver. VRChat PhysBone conversion is the same shape of problem with
+ * a harder extraction step, and lands on this same intermediate form.
+ *
+ * ── THE HARD PART IS UNITS, NOT STRUCTURE ──────────────────────────────────────────────────────────────────────
+ * Chains and colliders map across almost mechanically. The parameters do not, and this is where every naive
+ * converter goes wrong — including, by its own admission, VRChat's:
+ *
+ *   · VRM `stiffness` is **world units per second**. It is added to the tail as `axis * stiffness * dt`, then the
+ *     tail is projected back to its authored bone length. The projection couples stiffness, bone length and drag;
+ *     none of the three can be converted independently without changing the response.
+ *
+ *   · VRM `dragForce` is a per-FRAME velocity multiplier. Three-vrm's reference Verlet step retains
+ *     `(1 - dragForce)` of the previous displacement once per update while stiffness and gravity are scaled by
+ *     dt. Converting it means choosing the frame rate it was authored against; 60 Hz is the preview convention.
+ *     We linearise that exact projected step and map its two discrete poles to the continuous spring's poles.
+ *     This preserves both oscillation frequency and decay instead of equating velocity retention alone, which
+ *     over-damped ordinary VRoid hair and flattened distinct authored values at the critical-damping clamp.
+ *
+ *   · VRM `gravityPower` is likewise a velocity, not an acceleration, so it cannot be read as m/s². The
+ *     conversion goes through the EQUILIBRIUM instead: in VRM the rest droop satisfies
+ *     `tan θ ≈ gravityPower / stiffness`, and in this solver the sag is `g / (ω²L)`. Setting those equal gives
+ *     `g = gravityPower * ω²L / stiffness`, using the bounded ω this converter actually emits. That preserves
+ *     how far a chain hangs rather than preserving a number that means something different on each side.
+ *
+ * None of this is exact, and it is not claimed to be. The research that produced these relations fitted them
+ * numerically and found parameter recovery good but multi-joint waveforms drifting in phase over seconds. The
+ * goal is a chain that hangs and swings the way the author intended, not one that matches frame for frame.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CENTRE_INERTIA = exports.VRM_ASSUMED_AUTHORING_HZ = void 0;
+exports.omegaToStiffness = omegaToStiffness;
+exports.convertSpring = convertSpring;
+exports.convertGravity = convertGravity;
+exports.guessImportance = guessImportance;
+exports.convertVrmDynamics = convertVrmDynamics;
+exports.VRM_ASSUMED_AUTHORING_HZ = 60;
+/**
+ * Inertia given to a chain whose VRM declares a `center` node.
+ *
+ * VRoid writes a `center` BY DEFAULT — its UI calls the option "prevent excessive sway during movement" — so a
+ * large share of real VRM files depend on it, and a converter that ignores it produces hair that flails while
+ * the character merely walks. Measured across the reference set: `AvatarSample_B` centres all 11 of its groups
+ * and `Seed-san` 8 of its 9 springs, while `Vivi` and `AliciaSolid` centre nothing at all.
+ *
+ * True centre-space integration resolves motion against the named node — usually the hips — and is a V2 item;
+ * it needs the character root transform, which a chain anchored to the head does not have. This is the honest
+ * approximation available to a per-anchor scalar: carry most of the anchor's motion, keep some lag. It is
+ * deliberately not 1.0, because full carry would also cancel the head-turn response that makes hair read as
+ * hair, and the failure it is fixing is gross body translation, not rotation.
+ */
+exports.CENTRE_INERTIA = 0.6;
+const WORLD_GRAVITY = 9.81;
+/** The ω range `helix/dynamics@1` normalises onto. MUST match `DynamicsContract.ts`. */
+const STIFFNESS_MIN_OMEGA = 2;
+const STIFFNESS_MAX_OMEGA = 40;
+/** ω (rad/s) → the contract's normalised 0..1 stiffness. The inverse of `stiffnessToOmega`. */
+function omegaToStiffness(omega) {
+    const clamped = Math.min(Math.max(omega, STIFFNESS_MIN_OMEGA), STIFFNESS_MAX_OMEGA);
+    return Math.sqrt((clamped - STIFFNESS_MIN_OMEGA) / (STIFFNESS_MAX_OMEGA - STIFFNESS_MIN_OMEGA));
+}
+/**
+ * Convert one VRM projected-Verlet joint to the continuous `helix/dynamics@1` spring.
+ *
+ * For a small angular displacement `x`, three-vrm's documented update linearises to:
+ *
+ *     q = 1 + (stiffness / boneLength) dt
+ *     x[n+1] = ((1 + retention) / q) x[n] - (retention / q) x[n-1]
+ *
+ * The roots of that recurrence are the response sampled at the authoring rate. Mapping their magnitude and
+ * phase to `exp((-ζω ± iωd)dt)` gives the continuous spring parameters directly. Dynamics@1 cannot express an
+ * overdamped response, so real positive roots map to a critical spring at the slow pole's rate. That preserves
+ * the visible return tail by lowering stiffness, as the contract requires, instead of clamping damping while
+ * retaining the geometric-mean frequency and making a heavily dragged chain snap back too quickly.
+ */
+function convertSpring(vrmStiffness, dragForce, boneLengthM, hz = exports.VRM_ASSUMED_AUTHORING_HZ) {
+    const safeHz = Number.isFinite(hz) ? Math.max(hz, 1e-3) : exports.VRM_ASSUMED_AUTHORING_HZ;
+    const dt = 1 / safeHz;
+    const finiteLength = Number.isFinite(boneLengthM) ? boneLengthM : 0.07;
+    const length = Math.max(finiteLength, 1e-3);
+    const finiteStiffness = Number.isFinite(vrmStiffness) ? vrmStiffness : 0;
+    const restoringRate = Math.max(finiteStiffness, 0) / length;
+    const finiteDrag = Number.isFinite(dragForce) ? dragForce : 0.5;
+    const drag = Math.min(Math.max(finiteDrag, 0), 1);
+    const retention = 1 - drag;
+    const projectionScale = 1 + restoringRate * dt;
+    const trace = (1 + retention) / projectionScale;
+    const determinant = retention / projectionScale;
+    const discriminant = trace * trace - 4 * determinant;
+    let omega;
+    let dampingRatio;
+    let decayRate;
+    let mappedOmega;
+    if (retention <= Number.EPSILON) {
+        // dragForce=1 removes the second pole entirely. Preserve its one finite return rate with the closest
+        // representable response: a critically damped spring at the same slow-pole rate.
+        decayRate = Math.log(projectionScale) / dt;
+        omega = decayRate;
+        dampingRatio = 1;
+        mappedOmega = decayRate;
+    }
+    else if (discriminant < 0) {
+        const magnitude = Math.sqrt(determinant);
+        decayRate = -Math.log(magnitude) / dt;
+        const phase = Math.acos(Math.min(Math.max(trace / (2 * magnitude), -1), 1));
+        const dampedOmega = phase / dt;
+        omega = Math.hypot(decayRate, dampedOmega);
+        dampingRatio = omega > 0 ? decayRate / omega : 1;
+        mappedOmega = omega;
+    }
+    else {
+        const rootDelta = Math.sqrt(discriminant);
+        const slowRoot = Math.max((trace + rootDelta) / 2, Number.EPSILON);
+        const fastRoot = Math.max((trace - rootDelta) / 2, Number.EPSILON);
+        const slowRate = -Math.log(slowRoot) / dt;
+        const fastRate = -Math.log(fastRoot) / dt;
+        const rateProduct = Math.max(slowRate * fastRate, 0);
+        omega = Math.sqrt(rateProduct);
+        decayRate = (slowRate + fastRate) / 2;
+        dampingRatio = omega > 1e-8 ? (slowRate + fastRate) / (2 * omega) : 1;
+        // A critical spring has one repeated pole. Preserve the source's dominant return pole rather than its
+        // geometric-mean natural frequency; keeping the latter while clamping zeta to one can be many times faster.
+        mappedOmega = Math.max(slowRate, 0);
+    }
+    if (!Number.isFinite(omega))
+        omega = STIFFNESS_MAX_OMEGA;
+    if (!Number.isFinite(dampingRatio))
+        dampingRatio = 1;
+    if (!Number.isFinite(decayRate))
+        decayRate = omega;
+    if (!Number.isFinite(mappedOmega))
+        mappedOmega = STIFFNESS_MAX_OMEGA;
+    const engineOmega = Math.min(Math.max(mappedOmega, STIFFNESS_MIN_OMEGA), STIFFNESS_MAX_OMEGA);
+    const mappedDampingRatio = dampingRatio > 1 || mappedOmega <= 1e-8 ? 1 : decayRate / engineOmega;
+    return {
+        omega,
+        dampingRatio,
+        mappedOmega,
+        engineOmega,
+        mappedDampingRatio,
+        stiffness: omegaToStiffness(mappedOmega),
+        damping: Math.min(Math.max(mappedDampingRatio, 0), 1),
+    };
+}
+/** VRM `gravityPower` → a multiplier on real world gravity, via the equilibrium droop. See the header. */
+function convertGravity(gravityPower, vrmStiffness, boneLengthM, engineOmega) {
+    if (!Number.isFinite(gravityPower) || gravityPower <= 0)
+        return 0;
+    const stiffness = Number.isFinite(vrmStiffness) ? Math.max(vrmStiffness, 0) : 0;
+    // Gravity with no restoring term has no finite VRM equilibrium: the joint falls as far as its length allows.
+    // The bounded V1 contract cannot express that exactly, so retain the fully-drooped intent with its max force.
+    if (stiffness <= Number.EPSILON)
+        return 8;
+    const finiteLength = Number.isFinite(boneLengthM) ? boneLengthM : 0.07;
+    const length = Math.max(finiteLength, 1e-3);
+    const finiteOmega = Number.isFinite(engineOmega) ? engineOmega : STIFFNESS_MIN_OMEGA;
+    const boundedOmega = Math.min(Math.max(finiteOmega, STIFFNESS_MIN_OMEGA), STIFFNESS_MAX_OMEGA);
+    const accel = (gravityPower * boundedOmega * boundedOmega * length) / stiffness;
+    return Math.min(Math.max(accel / WORLD_GRAVITY, 0), 8);
+}
+/**
+ * Guess how much a chain matters from its bone names.
+ *
+ * Importance drives the frame budget, so getting it roughly right is what lets a crowd degrade sensibly rather
+ * than uniformly. Nothing in VRM carries this, and asking a creator to hand-classify twenty-two chains is the
+ * kind of chore the platform is supposed to absorb. Names in real content are remarkably consistent — VRoid
+ * emits `J_Sec_Hair*`, `*Skirt*`, `*Bust*` — so a table gets most of it, and it is only ever a default.
+ */
+function guessImportance(name) {
+    const lower = name.toLowerCase();
+    if (/bust|breast|chest|oppai/.test(lower))
+        return 'high';
+    if (/hair|ponytail|tail|ahoge|braid|mituami/.test(lower))
+        return 'high';
+    if (/skirt|coat|dress|cape|cloak|sleeve|tops/.test(lower))
+        return 'normal';
+    if (/ear|horn|antenna|wing/.test(lower))
+        return 'normal';
+    return 'decorative';
+}
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const numberOr = (v, fallback) => typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+/** glTF node name, or a stable synthetic one. Real VRM files do have named nodes; malformed ones may not. */
+function nodeName(nodes, index) {
+    const node = nodes[index];
+    if (node === undefined)
+        return null;
+    return typeof node.name === 'string' && node.name.length > 0 ? node.name : `node_${index}`;
+}
+/** Distance from a node to its first child — the bone length the unit conversions need. */
+function boneLength(nodes, index) {
+    const child = nodes[index]?.children?.[0];
+    const translation = child === undefined ? undefined : nodes[child]?.translation;
+    if (translation === undefined || translation.length !== 3)
+        return 0.07; // the VRM 0.x virtual-tail convention
+    return Math.hypot(translation[0], translation[1], translation[2]) || 0.07;
+}
+/** Names must survive the contract's `safeName` pattern; VRoid uses only safe characters, but imports may not. */
+const sanitiseId = (raw, fallback) => {
+    const cleaned = raw.replace(/[^A-Za-z0-9_.\-]/g, '_').slice(0, 60);
+    return cleaned.length > 0 ? cleaned : fallback;
+};
+/**
+ * Convert the spring-bone configuration of a parsed VRM glTF document.
+ *
+ * Takes the JSON chunk, not a file path or a three.js scene, so it runs in the pipeline, in a test, and in a
+ * browser importer without change.
+ */
+function convertVrmDynamics(gltf) {
+    const nodes = gltf.nodes ?? [];
+    const springBone = gltf.extensions?.VRMC_springBone;
+    if (isRecord(springBone))
+        return convertVrm1(nodes, springBone);
+    const vrm0 = gltf.extensions?.VRM;
+    if (isRecord(vrm0) && isRecord(vrm0.secondaryAnimation))
+        return convertVrm0(nodes, vrm0.secondaryAnimation);
+    return null;
+}
+function convertVrm1(nodes, springBone) {
+    const warnings = [];
+    const colliders = [];
+    const rawColliders = Array.isArray(springBone.colliders) ? springBone.colliders : [];
+    rawColliders.forEach((raw, index) => {
+        if (!isRecord(raw) || !isRecord(raw.shape))
+            return;
+        const bone = nodeName(nodes, numberOr(raw.node, -1));
+        if (bone === null)
+            return;
+        const id = `c${index}`;
+        if (isRecord(raw.shape.sphere)) {
+            const sphere = raw.shape.sphere;
+            const radius = numberOr(sphere.radius, 0);
+            if (radius <= 0)
+                return;
+            colliders.push({
+                id, bone, shape: 'sphere', radius,
+                ...(Array.isArray(sphere.offset) ? { offset: sphere.offset.slice(0, 3) } : {}),
+                ...(sphere.inside === true ? { inside: true } : {}),
+            });
+        }
+        else if (isRecord(raw.shape.capsule)) {
+            const capsule = raw.shape.capsule;
+            const radius = numberOr(capsule.radius, 0);
+            if (radius <= 0 || !Array.isArray(capsule.tail))
+                return;
+            colliders.push({
+                id, bone, shape: 'capsule', radius,
+                tail: capsule.tail.slice(0, 3),
+                ...(Array.isArray(capsule.offset) ? { offset: capsule.offset.slice(0, 3) } : {}),
+                ...(capsule.inside === true ? { inside: true } : {}),
+            });
+        }
+        else {
+            warnings.push(`collider ${index} uses an unsupported shape and was dropped`);
+        }
+    });
+    // A collider group is a named bundle of collider indices; a spring references groups, not colliders.
+    const groups = [];
+    for (const raw of Array.isArray(springBone.colliderGroups) ? springBone.colliderGroups : []) {
+        const ids = [];
+        if (isRecord(raw) && Array.isArray(raw.colliders)) {
+            for (const index of raw.colliders) {
+                const collider = colliders.find((c) => c.id === `c${index}`);
+                if (collider !== undefined)
+                    ids.push(collider.id);
+            }
+        }
+        groups.push(ids);
+    }
+    const chains = [];
+    const springs = Array.isArray(springBone.springs) ? springBone.springs : [];
+    springs.forEach((raw, index) => {
+        if (!isRecord(raw) || !Array.isArray(raw.joints) || raw.joints.length === 0)
+            return;
+        const first = raw.joints[0];
+        if (!isRecord(first))
+            return;
+        const rootIndex = numberOr(first.node, -1);
+        const root = nodeName(nodes, rootIndex);
+        if (root === null)
+            return;
+        // VRM parameters are per joint; the contract's curve would carry all of them, but the ROOT joint's values
+        // are what govern the chain's character and every authoring tool presents them that way. Taking the root's
+        // and noting divergence is more honest than averaging into a number nobody chose.
+        const stiffnessRaw = numberOr(first.stiffness, 1);
+        const dragRaw = numberOr(first.dragForce, 0.5);
+        const gravityPower = numberOr(first.gravityPower, 0);
+        const length = boneLength(nodes, rootIndex);
+        const spring = convertSpring(stiffnessRaw, dragRaw, length);
+        const name = typeof raw.name === 'string' && raw.name.length > 0 ? raw.name : root;
+        noteSaturation(warnings, name, spring, dragRaw);
+        const chainColliders = [];
+        for (const groupIndex of Array.isArray(raw.colliderGroups) ? raw.colliderGroups : []) {
+            for (const id of groups[Number(groupIndex)] ?? [])
+                if (!chainColliders.includes(id))
+                    chainColliders.push(id);
+        }
+        const hitRadius = numberOr(first.hitRadius, 0);
+        const centred = raw.center !== undefined;
+        chains.push({
+            ...(centred ? { inertia: exports.CENTRE_INERTIA } : {}),
+            id: sanitiseId(`${name}_${index}`, `spring_${index}`),
+            root,
+            importance: guessImportance(name),
+            stiffness: spring.stiffness,
+            damping: spring.damping,
+            gravity: convertGravity(gravityPower, stiffnessRaw, length, spring.engineOmega),
+            ...(Array.isArray(first.gravityDir) && first.gravityDir.length === 3
+                ? { gravityDir: first.gravityDir.slice(0, 3) } : {}),
+            ...(hitRadius > 0 && chainColliders.length > 0
+                ? { radius: hitRadius, colliders: chainColliders.slice(0, 8) } : {}),
+            // VRM's own 0.x-compatibility rule: the chain's last joint needs somewhere to aim.
+            endpoint: [0, -Math.max(length, 0.01), 0],
+        });
+        if (raw.center !== undefined)
+            warnings.push(centreNote(name));
+    });
+    return { contract: 'helix/dynamics@1', chains, colliders, warnings, sourceVersion: '1.0' };
+}
+function convertVrm0(nodes, secondary) {
+    const warnings = [];
+    const colliders = [];
+    const groups = [];
+    const rawGroups = Array.isArray(secondary.colliderGroups) ? secondary.colliderGroups : [];
+    rawGroups.forEach((raw, groupIndex) => {
+        const ids = [];
+        if (isRecord(raw)) {
+            const bone = nodeName(nodes, numberOr(raw.node, -1));
+            const list = Array.isArray(raw.colliders) ? raw.colliders : [];
+            list.forEach((collider, i) => {
+                if (bone === null || !isRecord(collider))
+                    return;
+                const radius = numberOr(collider.radius, 0);
+                if (radius <= 0)
+                    return;
+                const id = `g${groupIndex}_${i}`;
+                const offset = isRecord(collider.offset)
+                    // VRM 0.x is left-handed: three-vrm negates Z on import and rotates the model 180 degrees about Y.
+                    // Only the negation belongs here; the model rotation is the loader's business, not the manifest's.
+                    ? [numberOr(collider.offset.x, 0), numberOr(collider.offset.y, 0), -numberOr(collider.offset.z, 0)]
+                    : undefined;
+                colliders.push({ id, bone, shape: 'sphere', radius, ...(offset ? { offset } : {}) });
+                ids.push(id);
+            });
+        }
+        groups.push(ids);
+    });
+    const chains = [];
+    const boneGroups = Array.isArray(secondary.boneGroups) ? secondary.boneGroups : [];
+    boneGroups.forEach((raw, groupIndex) => {
+        if (!isRecord(raw) || !Array.isArray(raw.bones))
+            return;
+        // In 0.x a "bone group" is a set of chain ROOTS sharing one parameter block, so it becomes N chains here.
+        const stiffnessRaw = numberOr(raw.stiffiness, 1); // the spec's own misspelling — see three-vrm
+        const dragRaw = numberOr(raw.dragForce, 0.5);
+        const gravityPower = numberOr(raw.gravityPower, 0);
+        const hitRadius = numberOr(raw.hitRadius, 0);
+        const comment = typeof raw.comment === 'string' && raw.comment.length > 0 ? raw.comment : `group${groupIndex}`;
+        const hasCentre = numberOr(raw.center, -1) >= 0;
+        const chainColliders = [];
+        for (const index of Array.isArray(raw.colliderGroups) ? raw.colliderGroups : []) {
+            for (const id of groups[Number(index)] ?? [])
+                if (!chainColliders.includes(id))
+                    chainColliders.push(id);
+        }
+        raw.bones.forEach((boneIndex, i) => {
+            const rootIndex = Number(boneIndex);
+            const root = nodeName(nodes, rootIndex);
+            if (root === null)
+                return;
+            const length = boneLength(nodes, rootIndex);
+            const spring = convertSpring(stiffnessRaw, dragRaw, length);
+            noteSaturation(warnings, root, spring, dragRaw);
+            chains.push({
+                ...(hasCentre ? { inertia: exports.CENTRE_INERTIA } : {}),
+                id: sanitiseId(`${root}_${groupIndex}_${i}`, `spring_${groupIndex}_${i}`),
+                root,
+                importance: guessImportance(`${comment} ${root}`),
+                stiffness: spring.stiffness,
+                damping: spring.damping,
+                gravity: convertGravity(gravityPower, stiffnessRaw, length, spring.engineOmega),
+                ...(isRecord(raw.gravityDir)
+                    ? { gravityDir: [numberOr(raw.gravityDir.x, 0), numberOr(raw.gravityDir.y, -1), -numberOr(raw.gravityDir.z, 0)] }
+                    : {}),
+                ...(hitRadius > 0 && chainColliders.length > 0
+                    ? { radius: hitRadius, colliders: chainColliders.slice(0, 8) } : {}),
+                endpoint: [0, -Math.max(length, 0.01), 0],
+            });
+        });
+        if (hasCentre)
+            warnings.push(centreNote(comment));
+    });
+    return { contract: 'helix/dynamics@1', chains, colliders, warnings, sourceVersion: '0.x' };
+}
+/**
+ * Record where a source value fell outside the contract's expressible range.
+ *
+ * Both conversions are reported — an overdamped chain has its slow return pole preserved with lower stiffness,
+ * and a representable response past 40 rad/s is already visually rigid. A creator comparing side by side
+ * deserves to know which knob stopped mattering rather than wonder why two chains they tuned differently move
+ * the same.
+ */
+function centreNote(name) {
+    return `'${name}': declares a center node; approximated with inertia ${exports.CENTRE_INERTIA} (true centre-space is a V2 item)`;
+}
+function noteSaturation(warnings, name, spring, dragForce) {
+    if (spring.mappedOmega > STIFFNESS_MAX_OMEGA) {
+        warnings.push(`'${name}': response maps to ${spring.mappedOmega.toFixed(0)} rad/s, clamped to ${STIFFNESS_MAX_OMEGA} — it will read as rigid, which is how it already read`);
+    }
+    if (spring.dampingRatio > 1) {
+        warnings.push(`'${name}': dragForce ${dragForce} produces an overdamped response (zeta ${spring.dampingRatio.toFixed(1)}), fitted to critical damping at its slow return rate`);
+    }
+}
+//# sourceMappingURL=vrmDynamics.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * VRM BLEND SHAPES → `helix/avatar-face@1`.
+ *
+ * The sibling of `vrmDynamics.ts`, and it exists for the same reason: a bridge that carries an avatar's bones
+ * but not its mouth has not carried the avatar. Every VRM in the reference set declares the same five vowels
+ * and a blink, and HELIX's own face contract names them identically — `vowel.aa/ih/ou/ee/oh` IS the VRM 1.0
+ * preset vocabulary, and VRM 0.x's `a/i/u/e/o` is the same five under older names. So this is a rename plus an
+ * index resolution, not a retarget, and there is no excuse for an imported character to arrive mute.
+ *
+ * What it deliberately does NOT do:
+ *
+ *   - Invent the 15 visemes. VRM assets have five vowels; `FaceRuntime` already folds a 15-viseme provider down
+ *     onto five when that is all the asset has. Declaring `viseme.pp` against a mouth shape that cannot make a
+ *     P would be a lie the runtime then blends.
+ *   - Carry the emotion presets (joy, angry, sorrow, fun). They are real and they are worth having, but the
+ *     face contract is 24 channels of SPEECH and EYES; emotions belong to whatever expression system claims
+ *     them, and squatting on the contract now would make that harder, not easier.
+ *   - Guess. If the file has no expression block, this returns null and the caller ships an avatar with no face
+ *     manifest, which is honest. A name-based fallback for VRoid's `Fcl_MTH_*` exists but runs only when the
+ *     file's own declaration is missing, and says so in the warnings.
+ */
+import type { ExpressionId } from '../faceManifest';
+export interface GltfLike {
+    meshes?: Array<{
+        name?: string;
+        extras?: {
+            targetNames?: string[];
+        };
+        primitives?: Array<{
+            extras?: {
+                targetNames?: string[];
+            };
+        }>;
+    }>;
+    nodes?: Array<{
+        name?: string;
+        mesh?: number;
+    }>;
+    extensions?: Record<string, unknown>;
+}
+/** The subset of `helix/avatar-face@1` this converter can produce. */
+export type VrmFaceSemantic = 'vowel.aa' | 'vowel.ih' | 'vowel.ou' | 'vowel.ee' | 'vowel.oh' | 'blink.left' | 'blink.right';
+export interface VrmFaceChannel {
+    kind: 'morph';
+    name: string;
+    mesh?: string;
+    scale: number;
+}
+export interface VrmFaceResult {
+    sourceVersion: '0.x' | '1.0';
+    channels: Partial<Record<VrmFaceSemantic, VrmFaceChannel>>;
+    expressions: Partial<Record<ExpressionId, VrmFaceChannel>>;
+    warnings: string[];
+}
+/**
+ * Read a VRM's expressions and return the HELIX face channels, or null if it declares none this can use.
+ *
+ * NO `jawOpen`, deliberately, and it took building the wrong thing first to see why. VRM has no jaw channel, and
+ * the face runtime's cheap LOD rung drives `jawOpen` alone — so deriving it from the "aa" morph looked like free
+ * fidelity at distance. It is not: two semantics bound to the SAME morph both write it, so driving "ih" or "oh"
+ * also opened the "A" shape all the way. Measured on the reference avatar — `vowel.ih` at 1.0 left `Fcl_MTH_A`
+ * at 1.0 — which is a mouth stuck in one vowel for every sound it makes.
+ *
+ * A still mouth at forty pixels is a smaller lie than the wrong mouth shape at four hundred — and it is not
+ * even that, because `FaceRuntime` already handles the absence properly: at the jaw rung, an asset with no
+ * `jawOpen` binding has its `vowel.aa` target driven by the jaw signal instead ("their broadest open-mouth
+ * target, never a blink/expression or an arbitrary first morph"). So the fallback exists where it belongs, at
+ * the rung that needs it, instead of corrupting the full rung as an aliased channel did. An asset with a
+ * genuine, distinct jaw morph can still declare `jawOpen` in a hand-authored manifest; this converter will not
+ * invent one by aliasing a vowel.
+ */
+export declare function convertVrmFace(gltf: GltfLike): VrmFaceResult | null;
+/** The `helix/avatar-face@1` manifest for a converted face, ready for `attachFaceManifest`. */
+export declare function faceManifestFrom(result: VrmFaceResult): {
+    contract: 'helix/avatar-face@1';
+    channels: Partial<Record<VrmFaceSemantic, VrmFaceChannel>>;
+    expressions?: Partial<Record<ExpressionId, VrmFaceChannel>>;
+    lod: {
+        fullMinPixels: number;
+        jawMinPixels: number;
+    };
+};