@holoscript/engine 6.0.3 → 6.0.4

package/dist/chunk-ZIJQYHSQ.js

@@ -0,0 +1,1204 @@
+import {
+  __export
+} from "./chunk-AKLW2MUS.js";
+
+// src/character/index.ts
+var character_exports = {};
+__export(character_exports, {
+  DEFAULT_LIP_SYNC_CONFIG: () => DEFAULT_LIP_SYNC_CONFIG,
+  EXPRESSION_PRESETS: () => EXPRESSION_PRESETS,
+  FACS_ACTION_UNITS: () => FACS_ACTION_UNITS,
+  HUMANOID_65_SKELETON: () => HUMANOID_65_SKELETON,
+  HUMANOID_BONE_NAMES: () => HUMANOID_BONE_NAMES,
+  IdleBehaviorSystem: () => IdleBehaviorSystem,
+  LipSyncEngine: () => LipSyncEngine,
+  MIXAMO_BONE_MAP: () => MIXAMO_BONE_MAP,
+  PIPELINE_STAGES: () => PIPELINE_STAGES,
+  VISEME_15: () => VISEME_15,
+  VRM_BONE_MAP: () => VRM_BONE_MAP,
+  applyMorphTargets: () => applyMorphTargets,
+  computeSparseMorphTarget: () => computeSparseMorphTarget,
+  createIdleBehaviorSystem: () => createIdleBehaviorSystem,
+  evaluateExpression: () => evaluateExpression,
+  getActionUnit: () => getActionUnit,
+  getBoneChain: () => getBoneChain,
+  getBoneChildren: () => getBoneChildren,
+  getViseme: () => getViseme,
+  validateSkeleton: () => validateSkeleton
+});
+
+// src/character/CharacterPipelineTypes.ts
+var PIPELINE_STAGES = [
+  "sculpt",
+  "mesh_extraction",
+  "optimization",
+  "rigging",
+  "facial",
+  "dressing",
+  "deployment"
+];
+
+// src/character/HumanoidSkeleton.ts
+var HUMANOID_BONE_NAMES = [
+  // Root
+  "root",
+  "hips",
+  // Spine chain (5)
+  "spine",
+  "spine1",
+  "spine2",
+  "neck",
+  "head",
+  // Left arm (4 + 15 fingers = 19)
+  "left_shoulder",
+  "left_upper_arm",
+  "left_forearm",
+  "left_hand",
+  "left_thumb_proximal",
+  "left_thumb_intermediate",
+  "left_thumb_distal",
+  "left_index_proximal",
+  "left_index_intermediate",
+  "left_index_distal",
+  "left_middle_proximal",
+  "left_middle_intermediate",
+  "left_middle_distal",
+  "left_ring_proximal",
+  "left_ring_intermediate",
+  "left_ring_distal",
+  "left_pinky_proximal",
+  "left_pinky_intermediate",
+  "left_pinky_distal",
+  // Right arm (4 + 15 fingers = 19)
+  "right_shoulder",
+  "right_upper_arm",
+  "right_forearm",
+  "right_hand",
+  "right_thumb_proximal",
+  "right_thumb_intermediate",
+  "right_thumb_distal",
+  "right_index_proximal",
+  "right_index_intermediate",
+  "right_index_distal",
+  "right_middle_proximal",
+  "right_middle_intermediate",
+  "right_middle_distal",
+  "right_ring_proximal",
+  "right_ring_intermediate",
+  "right_ring_distal",
+  "right_pinky_proximal",
+  "right_pinky_intermediate",
+  "right_pinky_distal",
+  // Left leg (5)
+  "left_upper_leg",
+  "left_lower_leg",
+  "left_foot",
+  "left_toes",
+  "left_toe_end",
+  // Right leg (5)
+  "right_upper_leg",
+  "right_lower_leg",
+  "right_foot",
+  "right_toes",
+  "right_toe_end"
+];
+var HUMANOID_65_SKELETON = [
+  // Root & hips
+  { name: "root", parent: null, position: [0, 0, 0], length: 0 },
+  {
+    name: "hips",
+    parent: "root",
+    position: [0, 0.95, 0],
+    length: 0.12,
+    rotationLimits: [-30, 30, -40, 40, -30, 30]
+  },
+  // Spine chain
+  {
+    name: "spine",
+    parent: "hips",
+    position: [0, 0.12, 0],
+    length: 0.12,
+    rotationLimits: [-20, 40, -20, 20, -20, 20]
+  },
+  {
+    name: "spine1",
+    parent: "spine",
+    position: [0, 0.12, 0],
+    length: 0.12,
+    rotationLimits: [-20, 30, -15, 15, -15, 15]
+  },
+  {
+    name: "spine2",
+    parent: "spine1",
+    position: [0, 0.12, 0],
+    length: 0.12,
+    rotationLimits: [-15, 25, -10, 10, -10, 10]
+  },
+  {
+    name: "neck",
+    parent: "spine2",
+    position: [0, 0.12, 0],
+    length: 0.08,
+    rotationLimits: [-40, 40, -50, 50, -30, 30]
+  },
+  {
+    name: "head",
+    parent: "neck",
+    position: [0, 0.08, 0],
+    length: 0.2,
+    rotationLimits: [-30, 30, -60, 60, -20, 20]
+  },
+  // Left arm
+  {
+    name: "left_shoulder",
+    parent: "spine2",
+    position: [0.08, 0.1, 0],
+    length: 0.1,
+    rotationLimits: [-15, 15, -10, 30, -30, 10]
+  },
+  {
+    name: "left_upper_arm",
+    parent: "left_shoulder",
+    position: [0.1, 0, 0],
+    length: 0.28,
+    rotationLimits: [-90, 90, -60, 135, -90, 30]
+  },
+  {
+    name: "left_forearm",
+    parent: "left_upper_arm",
+    position: [0.28, 0, 0],
+    length: 0.25,
+    rotationLimits: [0, 145, -90, 90, 0, 0]
+  },
+  {
+    name: "left_hand",
+    parent: "left_forearm",
+    position: [0.25, 0, 0],
+    length: 0.08,
+    rotationLimits: [-70, 70, -30, 30, -15, 15]
+  },
+  // Left fingers — thumb
+  { name: "left_thumb_proximal", parent: "left_hand", position: [0.03, -0.01, 0.02], length: 0.03 },
+  {
+    name: "left_thumb_intermediate",
+    parent: "left_thumb_proximal",
+    position: [0.03, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "left_thumb_distal",
+    parent: "left_thumb_intermediate",
+    position: [0.025, 0, 0],
+    length: 0.02
+  },
+  // Left fingers — index
+  { name: "left_index_proximal", parent: "left_hand", position: [0.08, 0, 0.02], length: 0.035 },
+  {
+    name: "left_index_intermediate",
+    parent: "left_index_proximal",
+    position: [0.035, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "left_index_distal",
+    parent: "left_index_intermediate",
+    position: [0.025, 0, 0],
+    length: 0.02
+  },
+  // Left fingers — middle
+  { name: "left_middle_proximal", parent: "left_hand", position: [0.08, 0, 0], length: 0.038 },
+  {
+    name: "left_middle_intermediate",
+    parent: "left_middle_proximal",
+    position: [0.038, 0, 0],
+    length: 0.028
+  },
+  {
+    name: "left_middle_distal",
+    parent: "left_middle_intermediate",
+    position: [0.028, 0, 0],
+    length: 0.02
+  },
+  // Left fingers — ring
+  { name: "left_ring_proximal", parent: "left_hand", position: [0.08, 0, -0.015], length: 0.035 },
+  {
+    name: "left_ring_intermediate",
+    parent: "left_ring_proximal",
+    position: [0.035, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "left_ring_distal",
+    parent: "left_ring_intermediate",
+    position: [0.025, 0, 0],
+    length: 0.018
+  },
+  // Left fingers — pinky
+  { name: "left_pinky_proximal", parent: "left_hand", position: [0.075, 0, -0.03], length: 0.028 },
+  {
+    name: "left_pinky_intermediate",
+    parent: "left_pinky_proximal",
+    position: [0.028, 0, 0],
+    length: 0.02
+  },
+  {
+    name: "left_pinky_distal",
+    parent: "left_pinky_intermediate",
+    position: [0.02, 0, 0],
+    length: 0.015
+  },
+  // Right arm (mirrored X)
+  {
+    name: "right_shoulder",
+    parent: "spine2",
+    position: [-0.08, 0.1, 0],
+    length: 0.1,
+    rotationLimits: [-15, 15, -30, 10, -10, 30]
+  },
+  {
+    name: "right_upper_arm",
+    parent: "right_shoulder",
+    position: [-0.1, 0, 0],
+    length: 0.28,
+    rotationLimits: [-90, 90, -135, 60, -30, 90]
+  },
+  {
+    name: "right_forearm",
+    parent: "right_upper_arm",
+    position: [-0.28, 0, 0],
+    length: 0.25,
+    rotationLimits: [0, 145, -90, 90, 0, 0]
+  },
+  {
+    name: "right_hand",
+    parent: "right_forearm",
+    position: [-0.25, 0, 0],
+    length: 0.08,
+    rotationLimits: [-70, 70, -30, 30, -15, 15]
+  },
+  // Right fingers — thumb
+  {
+    name: "right_thumb_proximal",
+    parent: "right_hand",
+    position: [-0.03, -0.01, 0.02],
+    length: 0.03
+  },
+  {
+    name: "right_thumb_intermediate",
+    parent: "right_thumb_proximal",
+    position: [-0.03, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "right_thumb_distal",
+    parent: "right_thumb_intermediate",
+    position: [-0.025, 0, 0],
+    length: 0.02
+  },
+  // Right fingers — index
+  { name: "right_index_proximal", parent: "right_hand", position: [-0.08, 0, 0.02], length: 0.035 },
+  {
+    name: "right_index_intermediate",
+    parent: "right_index_proximal",
+    position: [-0.035, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "right_index_distal",
+    parent: "right_index_intermediate",
+    position: [-0.025, 0, 0],
+    length: 0.02
+  },
+  // Right fingers — middle
+  { name: "right_middle_proximal", parent: "right_hand", position: [-0.08, 0, 0], length: 0.038 },
+  {
+    name: "right_middle_intermediate",
+    parent: "right_middle_proximal",
+    position: [-0.038, 0, 0],
+    length: 0.028
+  },
+  {
+    name: "right_middle_distal",
+    parent: "right_middle_intermediate",
+    position: [-0.028, 0, 0],
+    length: 0.02
+  },
+  // Right fingers — ring
+  {
+    name: "right_ring_proximal",
+    parent: "right_hand",
+    position: [-0.08, 0, -0.015],
+    length: 0.035
+  },
+  {
+    name: "right_ring_intermediate",
+    parent: "right_ring_proximal",
+    position: [-0.035, 0, 0],
+    length: 0.025
+  },
+  {
+    name: "right_ring_distal",
+    parent: "right_ring_intermediate",
+    position: [-0.025, 0, 0],
+    length: 0.018
+  },
+  // Right fingers — pinky
+  {
+    name: "right_pinky_proximal",
+    parent: "right_hand",
+    position: [-0.075, 0, -0.03],
+    length: 0.028
+  },
+  {
+    name: "right_pinky_intermediate",
+    parent: "right_pinky_proximal",
+    position: [-0.028, 0, 0],
+    length: 0.02
+  },
+  {
+    name: "right_pinky_distal",
+    parent: "right_pinky_intermediate",
+    position: [-0.02, 0, 0],
+    length: 0.015
+  },
+  // Left leg
+  {
+    name: "left_upper_leg",
+    parent: "hips",
+    position: [0.09, -0.05, 0],
+    length: 0.42,
+    rotationLimits: [-20, 120, -45, 45, -40, 30]
+  },
+  {
+    name: "left_lower_leg",
+    parent: "left_upper_leg",
+    position: [0, -0.42, 0],
+    length: 0.4,
+    rotationLimits: [-130, 0, 0, 0, 0, 0]
+  },
+  {
+    name: "left_foot",
+    parent: "left_lower_leg",
+    position: [0, -0.4, 0],
+    length: 0.15,
+    rotationLimits: [-40, 40, -20, 20, -15, 15]
+  },
+  {
+    name: "left_toes",
+    parent: "left_foot",
+    position: [0, 0, 0.15],
+    length: 0.06,
+    rotationLimits: [-30, 60, 0, 0, 0, 0]
+  },
+  { name: "left_toe_end", parent: "left_toes", position: [0, 0, 0.06], length: 0 },
+  // Right leg (mirrored X)
+  {
+    name: "right_upper_leg",
+    parent: "hips",
+    position: [-0.09, -0.05, 0],
+    length: 0.42,
+    rotationLimits: [-20, 120, -45, 45, -30, 40]
+  },
+  {
+    name: "right_lower_leg",
+    parent: "right_upper_leg",
+    position: [0, -0.42, 0],
+    length: 0.4,
+    rotationLimits: [-130, 0, 0, 0, 0, 0]
+  },
+  {
+    name: "right_foot",
+    parent: "right_lower_leg",
+    position: [0, -0.4, 0],
+    length: 0.15,
+    rotationLimits: [-40, 40, -20, 20, -15, 15]
+  },
+  {
+    name: "right_toes",
+    parent: "right_foot",
+    position: [0, 0, 0.15],
+    length: 0.06,
+    rotationLimits: [-30, 60, 0, 0, 0, 0]
+  },
+  { name: "right_toe_end", parent: "right_toes", position: [0, 0, 0.06], length: 0 }
+];
+var MIXAMO_BONE_MAP = {
+  hips: "mixamorig:Hips",
+  spine: "mixamorig:Spine",
+  spine1: "mixamorig:Spine1",
+  spine2: "mixamorig:Spine2",
+  neck: "mixamorig:Neck",
+  head: "mixamorig:Head",
+  left_shoulder: "mixamorig:LeftShoulder",
+  left_upper_arm: "mixamorig:LeftArm",
+  left_forearm: "mixamorig:LeftForeArm",
+  left_hand: "mixamorig:LeftHand",
+  right_shoulder: "mixamorig:RightShoulder",
+  right_upper_arm: "mixamorig:RightArm",
+  right_forearm: "mixamorig:RightForeArm",
+  right_hand: "mixamorig:RightHand",
+  left_upper_leg: "mixamorig:LeftUpLeg",
+  left_lower_leg: "mixamorig:LeftLeg",
+  left_foot: "mixamorig:LeftFoot",
+  left_toes: "mixamorig:LeftToeBase",
+  right_upper_leg: "mixamorig:RightUpLeg",
+  right_lower_leg: "mixamorig:RightLeg",
+  right_foot: "mixamorig:RightFoot",
+  right_toes: "mixamorig:RightToeBase"
+};
+var VRM_BONE_MAP = {
+  hips: "hips",
+  spine: "spine",
+  spine2: "chest",
+  neck: "neck",
+  head: "head",
+  left_shoulder: "leftShoulder",
+  left_upper_arm: "leftUpperArm",
+  left_forearm: "leftLowerArm",
+  left_hand: "leftHand",
+  right_shoulder: "rightShoulder",
+  right_upper_arm: "rightUpperArm",
+  right_forearm: "rightLowerArm",
+  right_hand: "rightHand",
+  left_upper_leg: "leftUpperLeg",
+  left_lower_leg: "leftLowerLeg",
+  left_foot: "leftFoot",
+  left_toes: "leftToes",
+  right_upper_leg: "rightUpperLeg",
+  right_lower_leg: "rightLowerLeg",
+  right_foot: "rightFoot",
+  right_toes: "rightToes"
+};
+function getBoneChildren(boneName, skeleton = HUMANOID_65_SKELETON) {
+  return skeleton.filter((b) => b.parent === boneName);
+}
+function getBoneChain(boneName, skeleton = HUMANOID_65_SKELETON) {
+  const chain = [];
+  let current = skeleton.find((b) => b.name === boneName);
+  while (current) {
+    chain.unshift(current);
+    if (!current.parent) break;
+    current = skeleton.find((b) => b.name === current.parent);
+  }
+  return chain;
+}
+function validateSkeleton(skeleton) {
+  const errors = [];
+  const names = new Set(skeleton.map((b) => b.name));
+  for (const bone of skeleton) {
+    if (bone.parent !== null && !names.has(bone.parent)) {
+      errors.push(`Bone "${bone.name}" references missing parent "${bone.parent}"`);
+    }
+  }
+  const roots = skeleton.filter((b) => b.parent === null);
+  if (roots.length !== 1) {
+    errors.push(`Expected exactly 1 root bone, found ${roots.length}`);
+  }
+  return { valid: errors.length === 0, errors };
+}
+
+// src/character/FACSSystem.ts
+var FACS_ACTION_UNITS = [
+  // Upper Face — Brow & Forehead
+  {
+    id: 1,
+    name: "Inner Brow Raise",
+    region: "brow",
+    description: "Frontalis (medial)",
+    bilateral: true,
+    arkitMapping: ["browInnerUp"]
+  },
+  {
+    id: 2,
+    name: "Outer Brow Raise",
+    region: "brow",
+    description: "Frontalis (lateral)",
+    bilateral: true,
+    arkitMapping: ["browOuterUpLeft", "browOuterUpRight"]
+  },
+  {
+    id: 4,
+    name: "Brow Lowerer",
+    region: "brow",
+    description: "Corrugator supercilii + Depressor supercilii",
+    bilateral: true,
+    arkitMapping: ["browDownLeft", "browDownRight"]
+  },
+  // Upper Face — Eyes
+  {
+    id: 5,
+    name: "Upper Lid Raise",
+    region: "eye",
+    description: "Levator palpebrae superioris",
+    bilateral: true,
+    arkitMapping: ["eyeWideLeft", "eyeWideRight"]
+  },
+  {
+    id: 6,
+    name: "Cheek Raise",
+    region: "eye",
+    description: "Orbicularis oculi (orbital)",
+    bilateral: true,
+    arkitMapping: ["cheekSquintLeft", "cheekSquintRight"]
+  },
+  {
+    id: 7,
+    name: "Lid Tightener",
+    region: "eye",
+    description: "Orbicularis oculi (palpebral)",
+    bilateral: true,
+    arkitMapping: ["eyeSquintLeft", "eyeSquintRight"]
+  },
+  {
+    id: 43,
+    name: "Eyes Closed",
+    region: "eye",
+    description: "Relaxation of Levator palpebrae superioris",
+    bilateral: true,
+    arkitMapping: ["eyeBlinkLeft", "eyeBlinkRight"]
+  },
+  {
+    id: 45,
+    name: "Blink",
+    region: "eye",
+    description: "Rapid Orbicularis oculi contraction",
+    bilateral: true,
+    arkitMapping: ["eyeBlinkLeft", "eyeBlinkRight"]
+  },
+  {
+    id: 46,
+    name: "Wink",
+    region: "eye",
+    description: "Unilateral Orbicularis oculi",
+    bilateral: false,
+    arkitMapping: ["eyeBlinkLeft"]
+  },
+  // Nose
+  {
+    id: 9,
+    name: "Nose Wrinkler",
+    region: "nose",
+    description: "Levator labii superioris alaeque nasi",
+    bilateral: true,
+    arkitMapping: ["noseSneerLeft", "noseSneerRight"]
+  },
+  {
+    id: 10,
+    name: "Upper Lip Raiser",
+    region: "nose",
+    description: "Levator labii superioris",
+    bilateral: true
+  },
+  {
+    id: 11,
+    name: "Nasolabial Deepener",
+    region: "nose",
+    description: "Zygomaticus minor",
+    bilateral: true
+  },
+  // Mouth — Lip Position
+  {
+    id: 12,
+    name: "Lip Corner Puller",
+    region: "mouth",
+    description: "Zygomaticus major",
+    bilateral: true,
+    arkitMapping: ["mouthSmileLeft", "mouthSmileRight"]
+  },
+  {
+    id: 13,
+    name: "Sharp Lip Puller",
+    region: "mouth",
+    description: "Levator anguli oris (caninus)",
+    bilateral: true
+  },
+  {
+    id: 14,
+    name: "Dimpler",
+    region: "mouth",
+    description: "Buccinator",
+    bilateral: true,
+    arkitMapping: ["mouthDimpleLeft", "mouthDimpleRight"]
+  },
+  {
+    id: 15,
+    name: "Lip Corner Depressor",
+    region: "mouth",
+    description: "Depressor anguli oris (triangularis)",
+    bilateral: true,
+    arkitMapping: ["mouthFrownLeft", "mouthFrownRight"]
+  },
+  {
+    id: 16,
+    name: "Lower Lip Depressor",
+    region: "mouth",
+    description: "Depressor labii inferioris",
+    bilateral: true,
+    arkitMapping: ["mouthLowerDownLeft", "mouthLowerDownRight"]
+  },
+  { id: 17, name: "Chin Raiser", region: "mouth", description: "Mentalis", bilateral: false },
+  {
+    id: 18,
+    name: "Lip Pucker",
+    region: "mouth",
+    description: "Incisivii labii + Orbicularis oris",
+    bilateral: false,
+    arkitMapping: ["mouthPucker"]
+  },
+  {
+    id: 20,
+    name: "Lip Stretcher",
+    region: "mouth",
+    description: "Risorius + Platysma",
+    bilateral: true,
+    arkitMapping: ["mouthStretchLeft", "mouthStretchRight"]
+  },
+  {
+    id: 22,
+    name: "Lip Funneler",
+    region: "mouth",
+    description: "Orbicularis oris",
+    bilateral: false,
+    arkitMapping: ["mouthFunnel"]
+  },
+  {
+    id: 23,
+    name: "Lip Tightener",
+    region: "mouth",
+    description: "Orbicularis oris",
+    bilateral: false,
+    arkitMapping: ["mouthPressLeft", "mouthPressRight"]
+  },
+  {
+    id: 24,
+    name: "Lip Pressor",
+    region: "mouth",
+    description: "Orbicularis oris",
+    bilateral: false
+  },
+  {
+    id: 25,
+    name: "Lips Part",
+    region: "mouth",
+    description: "Depressor labii + Mentalis",
+    bilateral: false
+  },
+  {
+    id: 26,
+    name: "Jaw Drop",
+    region: "jaw",
+    description: "Masseter + internal pterygoid relaxation",
+    bilateral: false,
+    arkitMapping: ["jawOpen"]
+  },
+  {
+    id: 27,
+    name: "Mouth Stretch",
+    region: "jaw",
+    description: "Pterygoids + Digastric",
+    bilateral: false
+  },
+  {
+    id: 28,
+    name: "Lip Suck",
+    region: "mouth",
+    description: "Mentalis",
+    bilateral: false,
+    arkitMapping: ["mouthRollLower", "mouthRollUpper"]
+  },
+  // Tongue & Cheeks
+  {
+    id: 19,
+    name: "Tongue Show",
+    region: "tongue",
+    description: "Tongue protrusion",
+    bilateral: false,
+    arkitMapping: ["tongueOut"]
+  },
+  { id: 21, name: "Neck Tightener", region: "jaw", description: "Platysma", bilateral: false },
+  {
+    id: 29,
+    name: "Jaw Thrust",
+    region: "jaw",
+    description: "External pterygoid",
+    bilateral: false,
+    arkitMapping: ["jawForward"]
+  },
+  {
+    id: 30,
+    name: "Jaw Sideways",
+    region: "jaw",
+    description: "Lateral pterygoid",
+    bilateral: false,
+    arkitMapping: ["jawLeft", "jawRight"]
+  },
+  {
+    id: 31,
+    name: "Jaw Clench",
+    region: "jaw",
+    description: "Masseter + Temporalis",
+    bilateral: false
+  },
+  {
+    id: 32,
+    name: "Lip Bite",
+    region: "mouth",
+    description: "Lower lip drawn under upper teeth",
+    bilateral: false
+  },
+  {
+    id: 33,
+    name: "Cheek Blow",
+    region: "cheek",
+    description: "Buccinator expansion",
+    bilateral: true,
+    arkitMapping: ["cheekPuff"]
+  },
+  {
+    id: 34,
+    name: "Cheek Puff",
+    region: "cheek",
+    description: "Unilateral cheek inflation",
+    bilateral: false
+  },
+  {
+    id: 35,
+    name: "Cheek Suck",
+    region: "cheek",
+    description: "Buccinator contraction",
+    bilateral: true
+  },
+  {
+    id: 36,
+    name: "Tongue Bulge",
+    region: "tongue",
+    description: "Tongue pressed into cheek",
+    bilateral: false
+  },
+  { id: 37, name: "Lip Wipe", region: "mouth", description: "Tongue wipes lips", bilateral: false },
+  {
+    id: 38,
+    name: "Nostril Dilator",
+    region: "nose",
+    description: "Nasalis (alar)",
+    bilateral: true
+  },
+  {
+    id: 39,
+    name: "Nostril Compressor",
+    region: "nose",
+    description: "Nasalis (transverse)",
+    bilateral: true
+  },
+  // Head Position
+  {
+    id: 51,
+    name: "Head Turn Left",
+    region: "head",
+    description: "Neck rotation left",
+    bilateral: false
+  },
+  {
+    id: 52,
+    name: "Head Turn Right",
+    region: "head",
+    description: "Neck rotation right",
+    bilateral: false
+  },
+  { id: 53, name: "Head Up", region: "head", description: "Neck extension", bilateral: false },
+  { id: 54, name: "Head Down", region: "head", description: "Neck flexion", bilateral: false },
+  {
+    id: 55,
+    name: "Head Tilt Left",
+    region: "head",
+    description: "Lateral neck flexion left",
+    bilateral: false
+  },
+  {
+    id: 56,
+    name: "Head Tilt Right",
+    region: "head",
+    description: "Lateral neck flexion right",
+    bilateral: false
+  },
+  {
+    id: 57,
+    name: "Head Forward",
+    region: "head",
+    description: "Cervical protraction",
+    bilateral: false
+  },
+  {
+    id: 58,
+    name: "Head Back",
+    region: "head",
+    description: "Cervical retraction",
+    bilateral: false
+  },
+  // Eye Gaze
+  {
+    id: 61,
+    name: "Eyes Turn Left",
+    region: "gaze",
+    description: "Lateral rectus (left), Medial rectus (right)",
+    bilateral: false,
+    arkitMapping: ["eyeLookOutLeft", "eyeLookInRight"]
+  },
+  {
+    id: 62,
+    name: "Eyes Turn Right",
+    region: "gaze",
+    description: "Medial rectus (left), Lateral rectus (right)",
+    bilateral: false,
+    arkitMapping: ["eyeLookInLeft", "eyeLookOutRight"]
+  },
+  {
+    id: 63,
+    name: "Eyes Up",
+    region: "gaze",
+    description: "Superior rectus",
+    bilateral: false,
+    arkitMapping: ["eyeLookUpLeft", "eyeLookUpRight"]
+  },
+  {
+    id: 64,
+    name: "Eyes Down",
+    region: "gaze",
+    description: "Inferior rectus",
+    bilateral: false,
+    arkitMapping: ["eyeLookDownLeft", "eyeLookDownRight"]
+  }
+];
+var EXPRESSION_PRESETS = [
+  { name: "happy", weights: { 6: 0.8, 12: 1 } },
+  { name: "sad", weights: { 1: 0.6, 4: 0.3, 15: 0.8 } },
+  { name: "angry", weights: { 4: 1, 5: 0.5, 7: 0.6, 23: 0.8 } },
+  { name: "surprised", weights: { 1: 1, 2: 1, 5: 0.8, 26: 0.7 } },
+  { name: "disgusted", weights: { 9: 0.9, 10: 0.7, 17: 0.4 } },
+  { name: "fearful", weights: { 1: 1, 2: 0.8, 4: 0.5, 5: 0.8, 20: 0.9 } },
+  { name: "contempt", weights: { 12: 0.5, 14: 0.7 } },
+  { name: "thinking", weights: { 4: 0.4, 7: 0.3, 28: 0.5 } },
+  { name: "confused", weights: { 1: 0.5, 4: 0.6, 7: 0.3, 15: 0.3 } },
+  { name: "smirk", weights: { 12: 0.7, 14: 0.4 } }
+];
+var VISEME_15 = [
+  { name: "sil", phonemes: ["(silence)"], weights: {} },
+  { name: "aa", phonemes: ["ah", "father"], weights: { 25: 0.8, 26: 0.5 } },
+  { name: "ee", phonemes: ["ee", "see"], weights: { 25: 0.4, 12: 0.3 } },
+  { name: "ih", phonemes: ["ih", "bit"], weights: { 25: 0.3, 20: 0.2 } },
+  { name: "oh", phonemes: ["oh", "go"], weights: { 25: 0.6, 27: 0.4 } },
+  { name: "oo", phonemes: ["oo", "too"], weights: { 25: 0.3, 10: 0.2 } },
+  { name: "pp", phonemes: ["pp", "bb", "mm"], weights: { 28: 0.8 } },
+  { name: "ff", phonemes: ["ff", "vv"], weights: { 25: 0.1, 10: 0.4 } },
+  { name: "th", phonemes: ["th"], weights: { 25: 0.3, 19: 0.5 } },
+  { name: "dd", phonemes: ["dd", "tt", "nn"], weights: { 25: 0.2, 19: 0.3 } },
+  { name: "kk", phonemes: ["kk", "gg"], weights: { 25: 0.2, 26: 0.3 } },
+  { name: "ch", phonemes: ["ch", "jj", "sh"], weights: { 25: 0.3, 22: 0.4 } },
+  { name: "ss", phonemes: ["ss", "zz"], weights: { 25: 0.15, 20: 0.3 } },
+  { name: "nn", phonemes: ["ng"], weights: { 25: 0.1, 26: 0.15 } },
+  { name: "rr", phonemes: ["rr", "ll"], weights: { 25: 0.25, 22: 0.2 } }
+];
+function computeSparseMorphTarget(name, neutral, deformed, epsilon = 1e-4) {
+  const totalVertices = neutral.length / 3;
+  const deltas = [];
+  for (let i = 0; i < totalVertices; i++) {
+    const i3 = i * 3;
+    const dx = deformed[i3] - neutral[i3];
+    const dy = deformed[i3 + 1] - neutral[i3 + 1];
+    const dz = deformed[i3 + 2] - neutral[i3 + 2];
+    const magnitude = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    if (magnitude > epsilon) {
+      deltas.push({ vertexIndex: i, delta: [dx, dy, dz] });
+    }
+  }
+  return { name, deltas, totalVertices };
+}
+function applyMorphTargets(basePositions, targets) {
+  for (const { target, weight } of targets) {
+    if (weight === 0) continue;
+    for (const delta of target.deltas) {
+      const i3 = delta.vertexIndex * 3;
+      basePositions[i3] += delta.delta[0] * weight;
+      basePositions[i3 + 1] += delta.delta[1] * weight;
+      basePositions[i3 + 2] += delta.delta[2] * weight;
+    }
+  }
+}
+function evaluateExpression(expressionName) {
+  const preset = EXPRESSION_PRESETS.find((e) => e.name === expressionName);
+  return preset ? { ...preset.weights } : {};
+}
+function getActionUnit(id) {
+  return FACS_ACTION_UNITS.find((au) => au.id === id);
+}
+function getViseme(name) {
+  return VISEME_15.find((v) => v.name === name);
+}
+
+// src/character/LipSyncEngine.ts
+var DEFAULT_LIP_SYNC_CONFIG = {
+  method: "rhubarb",
+  blendSpeed: 0.08,
+  emotionOverlay: true,
+  emotionBlend: 0.3,
+  smoothing: 0.4
+};
+var LipSyncEngine = class {
+  config;
+  currentWeights = /* @__PURE__ */ new Map();
+  targetWeights = /* @__PURE__ */ new Map();
+  visemeMap = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.config = { ...DEFAULT_LIP_SYNC_CONFIG, ...config };
+    for (const v of VISEME_15) {
+      this.visemeMap.set(v.name, v);
+    }
+  }
+  /**
+   * Get the interpolated AU weights for a given time position in a lip sync track.
+   *
+   * @param track - The lip sync track with viseme keyframes
+   * @param time - Current time position in seconds
+   * @param emotion - Optional emotion name for overlay (e.g., 'happy', 'sad')
+   * @param emotionIntensity - Emotion intensity 0-1
+   * @returns Map of FACS AU id → weight
+   */
+  evaluate(track, time, emotion, emotionIntensity = 1) {
+    const { prev, next, t } = this.findBracketingKeyframes(track, time);
+    this.targetWeights.clear();
+    if (prev && next && t > 0) {
+      const prevDef = this.visemeMap.get(prev.viseme);
+      const nextDef = this.visemeMap.get(next.viseme);
+      const prevWeight = prev.weight ?? 1;
+      const nextWeight = next.weight ?? 1;
+      if (prevDef) {
+        for (const [auStr, w] of Object.entries(prevDef.weights)) {
+          const au = Number(auStr);
+          const current = this.targetWeights.get(au) ?? 0;
+          this.targetWeights.set(au, current + w * prevWeight * (1 - t));
+        }
+      }
+      if (nextDef) {
+        for (const [auStr, w] of Object.entries(nextDef.weights)) {
+          const au = Number(auStr);
+          const current = this.targetWeights.get(au) ?? 0;
+          this.targetWeights.set(au, current + w * nextWeight * t);
+        }
+      }
+    } else if (prev) {
+      const prevDef = this.visemeMap.get(prev.viseme);
+      const prevWeight = prev.weight ?? 1;
+      if (prevDef) {
+        for (const [auStr, w] of Object.entries(prevDef.weights)) {
+          this.targetWeights.set(Number(auStr), w * prevWeight);
+        }
+      }
+    }
+    if (this.config.emotionOverlay && emotion) {
+      const emotionPreset = EXPRESSION_PRESETS.find((e) => e.name === emotion);
+      if (emotionPreset) {
+        const emoBlend = this.config.emotionBlend * emotionIntensity;
+        const visBlend = 1 - emoBlend;
+        for (const [au, w] of this.targetWeights.entries()) {
+          this.targetWeights.set(au, w * visBlend);
+        }
+        for (const [auStr, w] of Object.entries(emotionPreset.weights)) {
+          const au = Number(auStr);
+          const current = this.targetWeights.get(au) ?? 0;
+          this.targetWeights.set(au, current + w * emoBlend);
+        }
+      }
+    }
+    const alpha = this.config.smoothing;
+    for (const [au, target] of this.targetWeights.entries()) {
+      const current = this.currentWeights.get(au) ?? 0;
+      this.currentWeights.set(au, current + (target - current) * alpha);
+    }
+    for (const [au, current] of this.currentWeights.entries()) {
+      if (!this.targetWeights.has(au)) {
+        const decayed = current * (1 - alpha);
+        if (decayed < 1e-3) {
+          this.currentWeights.delete(au);
+        } else {
+          this.currentWeights.set(au, decayed);
+        }
+      }
+    }
+    return new Map(this.currentWeights);
+  }
+  /**
+   * Reset the engine state. Call when switching audio tracks.
+   */
+  reset() {
+    this.currentWeights.clear();
+    this.targetWeights.clear();
+  }
+  /**
+   * Get the current configuration.
+   */
+  getConfig() {
+    return this.config;
+  }
+  // ---------------------------------------------------------------------------
+  // Private
+  // ---------------------------------------------------------------------------
+  findBracketingKeyframes(track, time) {
+    if (track.keyframes.length === 0) return { t: 0 };
+    if (time <= track.keyframes[0].time) {
+      return { prev: track.keyframes[0], t: 0 };
+    }
+    if (time >= track.keyframes[track.keyframes.length - 1].time) {
+      return { prev: track.keyframes[track.keyframes.length - 1], t: 0 };
+    }
+    for (let i = 0; i < track.keyframes.length - 1; i++) {
+      const a = track.keyframes[i];
+      const b = track.keyframes[i + 1];
+      if (time >= a.time && time <= b.time) {
+        const duration = b.time - a.time;
+        const t = duration > 0 ? (time - a.time) / duration : 0;
+        return { prev: a, next: b, t };
+      }
+    }
+    return { prev: track.keyframes[track.keyframes.length - 1], t: 0 };
+  }
+};
+
+// src/character/IdleBehaviorSystem.ts
+var DEFAULT_CONFIG = {
+  breathsPerMinute: 12,
+  chestAmplitude: 0.035,
+  nostrilAmplitude: 0.22,
+  blinkIntervalRangeSec: [2.4, 5.2],
+  blinkDurationSec: 0.12,
+  microSaccadeIntervalRangeSec: [0.7, 1.6],
+  microSaccadeAmplitude: 0.03
+};
+function clamp01(v) {
+  return Math.max(0, Math.min(1, v));
+}
+function lerp(a, b, t) {
+  return a + (b - a) * t;
+}
+var IdleBehaviorSystem = class {
+  bindings;
+  config;
+  rnd;
+  elapsedSec = 0;
+  nextBlinkSec = 0;
+  blinkT = 0;
+  nextSaccadeSec = 0;
+  saccadeTarget = { x: 0, y: 0 };
+  gaze = { x: 0, y: 0 };
+  constructor(bindings, config = {}) {
+    this.bindings = bindings;
+    this.config = {
+      breathsPerMinute: config.breathsPerMinute ?? DEFAULT_CONFIG.breathsPerMinute,
+      chestAmplitude: config.chestAmplitude ?? DEFAULT_CONFIG.chestAmplitude,
+      nostrilAmplitude: config.nostrilAmplitude ?? DEFAULT_CONFIG.nostrilAmplitude,
+      blinkIntervalRangeSec: config.blinkIntervalRangeSec ?? DEFAULT_CONFIG.blinkIntervalRangeSec,
+      blinkDurationSec: config.blinkDurationSec ?? DEFAULT_CONFIG.blinkDurationSec,
+      microSaccadeIntervalRangeSec: config.microSaccadeIntervalRangeSec ?? DEFAULT_CONFIG.microSaccadeIntervalRangeSec,
+      microSaccadeAmplitude: config.microSaccadeAmplitude ?? DEFAULT_CONFIG.microSaccadeAmplitude
+    };
+    this.rnd = config.random ?? Math.random;
+    this.scheduleNextBlink();
+    this.scheduleNextSaccade();
+  }
+  /** Force an immediate blink cycle. Useful for deterministic tests and scripted beats. */
+  triggerBlink() {
+    this.blinkT = this.config.blinkDurationSec;
+  }
+  update(deltaSec) {
+    if (deltaSec <= 0) {
+      return this.computeFrame();
+    }
+    const prevElapsedSec = this.elapsedSec;
+    this.elapsedSec += deltaSec;
+    if (this.blinkT > 0) {
+      this.blinkT = Math.max(0, this.blinkT - deltaSec);
+    }
+    if (prevElapsedSec < this.nextBlinkSec && this.elapsedSec >= this.nextBlinkSec) {
+      const overshoot = this.elapsedSec - this.nextBlinkSec;
+      this.blinkT = Math.max(0, this.config.blinkDurationSec - overshoot);
+      this.scheduleNextBlink();
+    }
+    if (this.elapsedSec >= this.nextSaccadeSec) {
+      const a = this.config.microSaccadeAmplitude;
+      this.saccadeTarget = {
+        x: lerp(-a, a, this.rnd()),
+        y: lerp(-a, a, this.rnd())
+      };
+      this.scheduleNextSaccade();
+    }
+    const settle = clamp01(deltaSec * 18);
+    this.gaze.x = lerp(this.gaze.x, this.saccadeTarget.x, settle);
+    this.gaze.y = lerp(this.gaze.y, this.saccadeTarget.y, settle);
+    return this.computeFrame();
+  }
+  computeFrame() {
+    const breathHz = this.config.breathsPerMinute / 60;
+    const breath = Math.sin(this.elapsedSec * breathHz * Math.PI * 2);
+    const inhale = Math.max(0, breath);
+    const nostril = Math.pow(inhale, 1.65) * this.config.nostrilAmplitude;
+    const blink = this.computeBlinkWeight();
+    const boneScale = {};
+    if (this.bindings.chestBone) {
+      boneScale[this.bindings.chestBone] = 1 + breath * this.config.chestAmplitude;
+    }
+    const morphWeights = {};
+    if (this.bindings.eyelidLeft) morphWeights[this.bindings.eyelidLeft] = blink;
+    if (this.bindings.eyelidRight) morphWeights[this.bindings.eyelidRight] = blink;
+    if (this.bindings.nostrilFlare) morphWeights[this.bindings.nostrilFlare] = nostril;
+    return {
+      boneScale,
+      morphWeights,
+      gazeOffset: { ...this.gaze },
+      blink,
+      breath
+    };
+  }
+  computeBlinkWeight() {
+    if (this.blinkT <= 0) return 0;
+    const total = this.config.blinkDurationSec;
+    const progress = 1 - this.blinkT / total;
+    if (progress <= 0.5) {
+      return clamp01(progress / 0.5);
+    }
+    return clamp01((1 - progress) / 0.5);
+  }
+  scheduleNextBlink() {
+    const [minS, maxS] = this.config.blinkIntervalRangeSec;
+    this.nextBlinkSec = this.elapsedSec + lerp(minS, maxS, this.rnd());
+  }
+  scheduleNextSaccade() {
+    const [minS, maxS] = this.config.microSaccadeIntervalRangeSec;
+    this.nextSaccadeSec = this.elapsedSec + lerp(minS, maxS, this.rnd());
+  }
+};
+function createIdleBehaviorSystem(bindings, config) {
+  return new IdleBehaviorSystem(bindings, config);
+}
+
+export {
+  PIPELINE_STAGES,
+  HUMANOID_BONE_NAMES,
+  HUMANOID_65_SKELETON,
+  MIXAMO_BONE_MAP,
+  VRM_BONE_MAP,
+  getBoneChildren,
+  getBoneChain,
+  validateSkeleton,
+  FACS_ACTION_UNITS,
+  EXPRESSION_PRESETS,
+  VISEME_15,
+  computeSparseMorphTarget,
+  applyMorphTargets,
+  evaluateExpression,
+  getActionUnit,
+  getViseme,
+  DEFAULT_LIP_SYNC_CONFIG,
+  LipSyncEngine,
+  IdleBehaviorSystem,
+  createIdleBehaviorSystem,
+  character_exports
+};