loomlarge 0.1.0 → 0.1.6

package/dist/index.d.cts

@@ -35,7 +35,7 @@ interface AUMappingConfig {
 /**
  * Helper type for mesh categories in morphToMesh
  */
-type MorphCategory = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
+type MorphCategory$1 = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
 
 /**
  * LoomLarge - Core Type Definitions
@@ -203,10 +203,21 @@ interface LoomLarge {
     onReady(payload: ReadyPayload): void;
     /**
      * Update animation state. Call each frame with delta time in seconds.
+     * If using start(), this is called automatically.
      */
     update(deltaSeconds: number): void;
+    /**
+     * Start the internal animation loop (RAF-based).
+     * Automatically calls update() each frame with delta time.
+     */
+    start(): void;
+    /**
+     * Stop the internal animation loop.
+     */
+    stop(): void;
     /**
      * Dispose engine resources and cleanup.
+     * Stops the animation loop and clears all transitions.
      */
     dispose(): void;
     /**
@@ -369,11 +380,18 @@ declare class LoomLargeThree implements LoomLarge {
     private bones;
     private mixWeights;
     private visemeValues;
+    private clock;
+    private rafId;
+    private running;
     private static readonly VISEME_JAW_AMOUNTS;
     private static readonly JAW_MAX_DEGREES;
     constructor(config?: LoomLargeConfig, animation?: Animation);
     onReady(payload: ReadyPayload): void;
     update(deltaSeconds: number): void;
+    /** Start the internal RAF loop */
+    start(): void;
+    /** Stop the internal RAF loop */
+    stop(): void;
     dispose(): void;
     setAU(id: number | string, v: number, balance?: number): void;
     transitionAU(id: number | string, to: number, durationMs?: number, balance?: number): TransitionHandle;
@@ -539,6 +557,70 @@ interface HairPhysics$1 {
  * and AU metadata that we painstakingly worked through.
  */
 
+declare const AU_TO_MORPHS: Record<number, string[]>;
+declare const VISEME_KEYS: string[];
+declare const BONE_AU_TO_BINDINGS: Record<number, BoneBinding[]>;
+/** Check if an AU has both morphs and bones (can blend between them) */
+declare const isMixedAU: (id: number) => boolean;
+/** Check if an AU has separate left/right morphs */
+declare const hasLeftRightMorphs: (auId: number) => boolean;
+declare const COMPOSITE_ROTATIONS: CompositeRotation[];
+/**
+ * Continuum pair mappings - precomputed from COMPOSITE_ROTATIONS
+ * Maps AU ID to its continuum partner info for bidirectional axes
+ * (e.g., AU 51 "Head Left" is paired with AU 52 "Head Right")
+ */
+declare const CONTINUUM_PAIRS_MAP: Record<number, {
+    pairId: number;
+    isNegative: boolean;
+    axis: 'pitch' | 'yaw' | 'roll';
+    node: 'JAW' | 'HEAD' | 'EYE_L' | 'EYE_R' | 'TONGUE';
+}>;
+/**
+ * Human-readable labels for continuum pairs
+ * Key format: "negativeAU-positiveAU"
+ * Used by UI components (ContinuumSlider, AUSection) to display friendly axis names
+ */
+declare const CONTINUUM_LABELS: Record<string, string>;
+declare const CC4_BONE_NODES: {
+    readonly EYE_L: "CC_Base_L_Eye";
+    readonly EYE_R: "CC_Base_R_Eye";
+    readonly HEAD: "CC_Base_Head";
+    readonly NECK: "CC_Base_NeckTwist01";
+    readonly NECK_TWIST: "CC_Base_NeckTwist02";
+    readonly JAW: "CC_Base_JawRoot";
+    readonly TONGUE: "CC_Base_Tongue01";
+};
+declare const CC4_EYE_MESH_NODES: {
+    readonly LEFT: "CC_Base_Eye";
+    readonly RIGHT: "CC_Base_Eye_1";
+};
+declare const AU_INFO: Record<string, AUInfo>;
+/** Default mix weights (0 = morph only, 1 = bone only) */
+declare const AU_MIX_DEFAULTS: Record<number, number>;
+type MeshCategory = 'body' | 'eye' | 'eyeOcclusion' | 'tearLine' | 'teeth' | 'tongue' | 'hair' | 'eyebrow' | 'cornea' | 'eyelash';
+/** Blending mode names (matches Three.js constants) */
+type BlendingMode = 'Normal' | 'Additive' | 'Subtractive' | 'Multiply' | 'None';
+/** Material settings for mesh rendering */
+interface MeshMaterialSettings {
+    renderOrder?: number;
+    transparent?: boolean;
+    opacity?: number;
+    depthWrite?: boolean;
+    depthTest?: boolean;
+    blending?: BlendingMode;
+}
+/** Mesh info including category, morph count, and optional material settings */
+interface CC4MeshInfo {
+    category: MeshCategory;
+    morphCount: number;
+    material?: MeshMaterialSettings;
+}
+/** Exact mesh name -> category mapping from the character GLB */
+declare const CC4_MESHES: Record<string, CC4MeshInfo>;
+type MorphCategory = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
+/** Which mesh each morph category applies to */
+declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
 declare const CC4_PRESET: AUMappingConfig;
 
 /**
@@ -628,4 +710,4 @@ declare class HairPhysics {
     reset(): void;
 }
 
-export { type AUInfo, type AUMappingConfig, type Animation, AnimationThree, type BoneBinding, type BoneKey, CC4_PRESET, type CompositeRotation, type CompositeRotationState, DEFAULT_HAIR_PHYSICS_CONFIG, type HairMorphOutput$1 as HairMorphOutput, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LoomEuler, type LoomLarge, type LoomLargeConfig, LoomLargeThree, type LoomMesh, type LoomObject3D, type LoomQuaternion, type LoomVector3, type MeshInfo, type MorphCategory, type ReadyPayload, type RotationAxis, type RotationAxisState, type RotationsState, type TransitionHandle, collectMorphMeshes, LoomLargeThree as default };
+export { type AUInfo, type AUMappingConfig, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type Animation, AnimationThree, BONE_AU_TO_BINDINGS, type BoneBinding, type BoneKey, CC4_BONE_NODES, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CompositeRotation, type CompositeRotationState, DEFAULT_HAIR_PHYSICS_CONFIG, type HairMorphOutput$1 as HairMorphOutput, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LoomEuler, type LoomLarge, type LoomLargeConfig, LoomLargeThree, type LoomMesh, type LoomObject3D, type LoomQuaternion, type LoomVector3, MORPH_TO_MESH, type MeshInfo, type MorphCategory$1 as MorphCategory, type ReadyPayload, type RotationAxis, type RotationAxisState, type RotationsState, type TransitionHandle, VISEME_KEYS, collectMorphMeshes, LoomLargeThree as default, hasLeftRightMorphs, isMixedAU };

package/dist/index.d.ts

@@ -35,7 +35,7 @@ interface AUMappingConfig {
 /**
  * Helper type for mesh categories in morphToMesh
  */
-type MorphCategory = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
+type MorphCategory$1 = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
 
 /**
  * LoomLarge - Core Type Definitions
@@ -203,10 +203,21 @@ interface LoomLarge {
     onReady(payload: ReadyPayload): void;
     /**
      * Update animation state. Call each frame with delta time in seconds.
+     * If using start(), this is called automatically.
      */
     update(deltaSeconds: number): void;
+    /**
+     * Start the internal animation loop (RAF-based).
+     * Automatically calls update() each frame with delta time.
+     */
+    start(): void;
+    /**
+     * Stop the internal animation loop.
+     */
+    stop(): void;
     /**
      * Dispose engine resources and cleanup.
+     * Stops the animation loop and clears all transitions.
      */
     dispose(): void;
     /**
@@ -369,11 +380,18 @@ declare class LoomLargeThree implements LoomLarge {
     private bones;
     private mixWeights;
     private visemeValues;
+    private clock;
+    private rafId;
+    private running;
     private static readonly VISEME_JAW_AMOUNTS;
     private static readonly JAW_MAX_DEGREES;
     constructor(config?: LoomLargeConfig, animation?: Animation);
     onReady(payload: ReadyPayload): void;
     update(deltaSeconds: number): void;
+    /** Start the internal RAF loop */
+    start(): void;
+    /** Stop the internal RAF loop */
+    stop(): void;
     dispose(): void;
     setAU(id: number | string, v: number, balance?: number): void;
     transitionAU(id: number | string, to: number, durationMs?: number, balance?: number): TransitionHandle;
@@ -539,6 +557,70 @@ interface HairPhysics$1 {
  * and AU metadata that we painstakingly worked through.
  */
 
+declare const AU_TO_MORPHS: Record<number, string[]>;
+declare const VISEME_KEYS: string[];
+declare const BONE_AU_TO_BINDINGS: Record<number, BoneBinding[]>;
+/** Check if an AU has both morphs and bones (can blend between them) */
+declare const isMixedAU: (id: number) => boolean;
+/** Check if an AU has separate left/right morphs */
+declare const hasLeftRightMorphs: (auId: number) => boolean;
+declare const COMPOSITE_ROTATIONS: CompositeRotation[];
+/**
+ * Continuum pair mappings - precomputed from COMPOSITE_ROTATIONS
+ * Maps AU ID to its continuum partner info for bidirectional axes
+ * (e.g., AU 51 "Head Left" is paired with AU 52 "Head Right")
+ */
+declare const CONTINUUM_PAIRS_MAP: Record<number, {
+    pairId: number;
+    isNegative: boolean;
+    axis: 'pitch' | 'yaw' | 'roll';
+    node: 'JAW' | 'HEAD' | 'EYE_L' | 'EYE_R' | 'TONGUE';
+}>;
+/**
+ * Human-readable labels for continuum pairs
+ * Key format: "negativeAU-positiveAU"
+ * Used by UI components (ContinuumSlider, AUSection) to display friendly axis names
+ */
+declare const CONTINUUM_LABELS: Record<string, string>;
+declare const CC4_BONE_NODES: {
+    readonly EYE_L: "CC_Base_L_Eye";
+    readonly EYE_R: "CC_Base_R_Eye";
+    readonly HEAD: "CC_Base_Head";
+    readonly NECK: "CC_Base_NeckTwist01";
+    readonly NECK_TWIST: "CC_Base_NeckTwist02";
+    readonly JAW: "CC_Base_JawRoot";
+    readonly TONGUE: "CC_Base_Tongue01";
+};
+declare const CC4_EYE_MESH_NODES: {
+    readonly LEFT: "CC_Base_Eye";
+    readonly RIGHT: "CC_Base_Eye_1";
+};
+declare const AU_INFO: Record<string, AUInfo>;
+/** Default mix weights (0 = morph only, 1 = bone only) */
+declare const AU_MIX_DEFAULTS: Record<number, number>;
+type MeshCategory = 'body' | 'eye' | 'eyeOcclusion' | 'tearLine' | 'teeth' | 'tongue' | 'hair' | 'eyebrow' | 'cornea' | 'eyelash';
+/** Blending mode names (matches Three.js constants) */
+type BlendingMode = 'Normal' | 'Additive' | 'Subtractive' | 'Multiply' | 'None';
+/** Material settings for mesh rendering */
+interface MeshMaterialSettings {
+    renderOrder?: number;
+    transparent?: boolean;
+    opacity?: number;
+    depthWrite?: boolean;
+    depthTest?: boolean;
+    blending?: BlendingMode;
+}
+/** Mesh info including category, morph count, and optional material settings */
+interface CC4MeshInfo {
+    category: MeshCategory;
+    morphCount: number;
+    material?: MeshMaterialSettings;
+}
+/** Exact mesh name -> category mapping from the character GLB */
+declare const CC4_MESHES: Record<string, CC4MeshInfo>;
+type MorphCategory = 'face' | 'viseme' | 'eye' | 'tearLine' | 'tongue' | 'hair';
+/** Which mesh each morph category applies to */
+declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
 declare const CC4_PRESET: AUMappingConfig;
 
 /**
@@ -628,4 +710,4 @@ declare class HairPhysics {
     reset(): void;
 }
 
-export { type AUInfo, type AUMappingConfig, type Animation, AnimationThree, type BoneBinding, type BoneKey, CC4_PRESET, type CompositeRotation, type CompositeRotationState, DEFAULT_HAIR_PHYSICS_CONFIG, type HairMorphOutput$1 as HairMorphOutput, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LoomEuler, type LoomLarge, type LoomLargeConfig, LoomLargeThree, type LoomMesh, type LoomObject3D, type LoomQuaternion, type LoomVector3, type MeshInfo, type MorphCategory, type ReadyPayload, type RotationAxis, type RotationAxisState, type RotationsState, type TransitionHandle, collectMorphMeshes, LoomLargeThree as default };
+export { type AUInfo, type AUMappingConfig, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type Animation, AnimationThree, BONE_AU_TO_BINDINGS, type BoneBinding, type BoneKey, CC4_BONE_NODES, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CompositeRotation, type CompositeRotationState, DEFAULT_HAIR_PHYSICS_CONFIG, type HairMorphOutput$1 as HairMorphOutput, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LoomEuler, type LoomLarge, type LoomLargeConfig, LoomLargeThree, type LoomMesh, type LoomObject3D, type LoomQuaternion, type LoomVector3, MORPH_TO_MESH, type MeshInfo, type MorphCategory$1 as MorphCategory, type ReadyPayload, type RotationAxis, type RotationAxisState, type RotationsState, type TransitionHandle, VISEME_KEYS, collectMorphMeshes, LoomLargeThree as default, hasLeftRightMorphs, isMixedAU };

package/dist/index.js

@@ -1,3 +1,5 @@
+import { Clock } from 'three';
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -354,6 +356,107 @@ var BONE_AU_TO_BINDINGS = {
     { node: "TONGUE", channel: "rx", scale: 1, maxDegrees: 20 }
   ]
 };
+var isMixedAU = (id) => !!(AU_TO_MORPHS[id]?.length && BONE_AU_TO_BINDINGS[id]?.length);
+var hasLeftRightMorphs = (auId) => {
+  const keys = AU_TO_MORPHS[auId] || [];
+  return keys.some((k) => /_L$|_R$| L$| R$|Left$|Right$/i.test(k));
+};
+var COMPOSITE_ROTATIONS = [
+  {
+    node: "JAW",
+    pitch: { aus: [25, 26, 27], axis: "rz" },
+    // Jaw drop (opens mouth downward)
+    yaw: { aus: [30, 35], axis: "ry", negative: 30, positive: 35 },
+    // Jaw lateral (left/right)
+    roll: null
+    // Jaw doesn't have roll
+  },
+  {
+    node: "HEAD",
+    pitch: { aus: [54, 53], axis: "rx", negative: 54, positive: 53 },
+    // Head down/up
+    yaw: { aus: [51, 52], axis: "ry", negative: 51, positive: 52 },
+    // Head turn left/right
+    roll: { aus: [55, 56], axis: "rz", negative: 55, positive: 56 }
+    // Head tilt left/right
+  },
+  {
+    node: "EYE_L",
+    pitch: { aus: [64, 63], axis: "rx", negative: 64, positive: 63 },
+    // Eyes down/up
+    yaw: { aus: [61, 62], axis: "rz", negative: 61, positive: 62 },
+    // Eyes left/right (rz for CC4)
+    roll: null
+    // Eyes don't have roll
+  },
+  {
+    node: "EYE_R",
+    pitch: { aus: [64, 63], axis: "rx", negative: 64, positive: 63 },
+    // Eyes down/up
+    yaw: { aus: [61, 62], axis: "rz", negative: 61, positive: 62 },
+    // Eyes left/right (rz for CC4)
+    roll: null
+    // Eyes don't have roll
+  },
+  {
+    node: "TONGUE",
+    pitch: { aus: [38, 37], axis: "rz", negative: 38, positive: 37 },
+    // Tongue down/up
+    yaw: { aus: [39, 40], axis: "ry", negative: 39, positive: 40 },
+    // Tongue left/right
+    roll: { aus: [41, 42], axis: "rx", negative: 41, positive: 42 }
+    // Tongue tilt left/right
+  }
+];
+var CONTINUUM_PAIRS_MAP = {
+  // Eyes horizontal (yaw) - both eyes share same AUs
+  61: { pairId: 62, isNegative: true, axis: "yaw", node: "EYE_L" },
+  62: { pairId: 61, isNegative: false, axis: "yaw", node: "EYE_L" },
+  // Eyes vertical (pitch)
+  64: { pairId: 63, isNegative: true, axis: "pitch", node: "EYE_L" },
+  63: { pairId: 64, isNegative: false, axis: "pitch", node: "EYE_L" },
+  // Head yaw (turn left/right)
+  51: { pairId: 52, isNegative: true, axis: "yaw", node: "HEAD" },
+  52: { pairId: 51, isNegative: false, axis: "yaw", node: "HEAD" },
+  // Head pitch (up/down)
+  54: { pairId: 53, isNegative: true, axis: "pitch", node: "HEAD" },
+  53: { pairId: 54, isNegative: false, axis: "pitch", node: "HEAD" },
+  // Head roll (tilt left/right)
+  55: { pairId: 56, isNegative: true, axis: "roll", node: "HEAD" },
+  56: { pairId: 55, isNegative: false, axis: "roll", node: "HEAD" },
+  // Jaw yaw (left/right)
+  30: { pairId: 35, isNegative: true, axis: "yaw", node: "JAW" },
+  35: { pairId: 30, isNegative: false, axis: "yaw", node: "JAW" },
+  // Tongue yaw (left/right)
+  39: { pairId: 40, isNegative: true, axis: "yaw", node: "TONGUE" },
+  40: { pairId: 39, isNegative: false, axis: "yaw", node: "TONGUE" },
+  // Tongue pitch (up/down)
+  38: { pairId: 37, isNegative: true, axis: "pitch", node: "TONGUE" },
+  37: { pairId: 38, isNegative: false, axis: "pitch", node: "TONGUE" },
+  // Tongue roll (tilt left/right)
+  41: { pairId: 42, isNegative: true, axis: "roll", node: "TONGUE" },
+  42: { pairId: 41, isNegative: false, axis: "roll", node: "TONGUE" },
+  // Extended tongue morphs (continuum pairs)
+  73: { pairId: 74, isNegative: true, axis: "yaw", node: "TONGUE" },
+  // Tongue Narrow/Wide
+  74: { pairId: 73, isNegative: false, axis: "yaw", node: "TONGUE" },
+  76: { pairId: 77, isNegative: false, axis: "pitch", node: "TONGUE" },
+  // Tongue Tip Up/Down
+  77: { pairId: 76, isNegative: true, axis: "pitch", node: "TONGUE" }
+};
+var CONTINUUM_LABELS = {
+  "61-62": "Eyes \u2014 Horizontal",
+  "64-63": "Eyes \u2014 Vertical",
+  "51-52": "Head \u2014 Horizontal",
+  "54-53": "Head \u2014 Vertical",
+  "55-56": "Head \u2014 Tilt",
+  "30-35": "Jaw \u2014 Horizontal",
+  "38-37": "Tongue \u2014 Vertical",
+  "39-40": "Tongue \u2014 Horizontal",
+  "41-42": "Tongue \u2014 Tilt",
+  "73-74": "Tongue \u2014 Width",
+  "76-77": "Tongue Tip \u2014 Vertical"
+};
 var CC4_BONE_NODES = {
   EYE_L: "CC_Base_L_Eye",
   EYE_R: "CC_Base_R_Eye",
@@ -486,6 +589,41 @@ var AU_MIX_DEFAULTS = {
   35: 0.5
   // jaw left/right
 };
+var CC4_MESHES = {
+  // Body (6 meshes, 80 morphs each) - default render order 0
+  "CC_Base_Body_1": { category: "body", morphCount: 80 },
+  "CC_Base_Body_2": { category: "body", morphCount: 80 },
+  "CC_Base_Body_3": { category: "body", morphCount: 80 },
+  "CC_Base_Body_4": { category: "body", morphCount: 80 },
+  "CC_Base_Body_5": { category: "body", morphCount: 80 },
+  "CC_Base_Body_6": { category: "body", morphCount: 80 },
+  // Eyes (bone-driven, no morphs) - render first (behind everything)
+  "CC_Base_Eye": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_1": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_2": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_3": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Eye_4": { category: "eye", morphCount: 0, material: { renderOrder: -10 } },
+  // Eye occlusion (94 morphs each) - render on top of eyes with transparency support
+  "CC_Base_EyeOcclusion_1": { category: "eyeOcclusion", morphCount: 94, material: { renderOrder: 2, transparent: true, opacity: 1, depthWrite: true, depthTest: true, blending: "Normal" } },
+  "CC_Base_EyeOcclusion_2": { category: "eyeOcclusion", morphCount: 94, material: { renderOrder: 2, transparent: true, opacity: 1, depthWrite: true, depthTest: true, blending: "Normal" } },
+  // Tear lines (90 morphs each) - on top of eyes/face
+  "CC_Base_TearLine_1": { category: "tearLine", morphCount: 90, material: { renderOrder: 2 } },
+  "CC_Base_TearLine_2": { category: "tearLine", morphCount: 90, material: { renderOrder: 2 } },
+  // Cornea (no morphs) - render first with eyes
+  "CC_Base_Cornea": { category: "cornea", morphCount: 0, material: { renderOrder: -10 } },
+  "CC_Base_Cornea_1": { category: "cornea", morphCount: 0, material: { renderOrder: -10 } },
+  // Teeth (no morphs, follow jaw bone) - default render order
+  "CC_Base_Teeth_1": { category: "teeth", morphCount: 0 },
+  "CC_Base_Teeth_2": { category: "teeth", morphCount: 0 },
+  // Tongue (23 morphs) - default render order
+  "CC_Base_Tongue": { category: "tongue", morphCount: 23 },
+  // Eyebrows (91 morphs each) - above face
+  "Male_Bushy_1": { category: "eyebrow", morphCount: 91, material: { renderOrder: 5 } },
+  "Male_Bushy_2": { category: "eyebrow", morphCount: 91, material: { renderOrder: 5 } },
+  // Hair (14 styling morphs each) - render last (on top of everything)
+  "Side_part_wavy_1": { category: "hair", morphCount: 14, material: { renderOrder: 10 } },
+  "Side_part_wavy_2": { category: "hair", morphCount: 14, material: { renderOrder: 10 } }
+};
 var MORPH_TO_MESH = {
   // Face/AU morphs affect the main face mesh and both eyebrow meshes.
   face: ["CC_Base_Body_1", "Male_Bushy_1", "Male_Bushy_2"],
@@ -537,6 +675,10 @@ var _LoomLargeThree = class _LoomLargeThree {
     __publicField(this, "mixWeights", {});
     // Viseme state
     __publicField(this, "visemeValues", new Array(15).fill(0));
+    // Internal RAF loop
+    __publicField(this, "clock", new Clock());
+    __publicField(this, "rafId", null);
+    __publicField(this, "running", false);
     this.config = config.auMappings || CC4_PRESET;
     this.mixWeights = { ...this.config.auMixDefaults };
     this.animation = animation || new AnimationThree();
@@ -580,7 +722,30 @@ var _LoomLargeThree = class _LoomLargeThree {
     this.animation.tick(dtSeconds);
     this.flushPendingComposites();
   }
+  /** Start the internal RAF loop */
+  start() {
+    if (this.running) return;
+    this.running = true;
+    this.clock.start();
+    const tick = () => {
+      if (!this.running) return;
+      const dt = this.clock.getDelta();
+      this.update(dt);
+      this.rafId = requestAnimationFrame(tick);
+    };
+    this.rafId = requestAnimationFrame(tick);
+  }
+  /** Stop the internal RAF loop */
+  stop() {
+    this.running = false;
+    if (this.rafId !== null) {
+      cancelAnimationFrame(this.rafId);
+      this.rafId = null;
+    }
+    this.clock.stop();
+  }
   dispose() {
+    this.stop();
     this.clearTransitions();
     this.meshes = [];
     this.model = null;
@@ -1161,6 +1326,6 @@ var HairPhysics = class {
   }
 };
 
-export { AnimationThree, CC4_PRESET, DEFAULT_HAIR_PHYSICS_CONFIG, HairPhysics, LoomLargeThree, collectMorphMeshes, LoomLargeThree as default };
+export { AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, AnimationThree, BONE_AU_TO_BINDINGS, CC4_BONE_NODES, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, DEFAULT_HAIR_PHYSICS_CONFIG, HairPhysics, LoomLargeThree, MORPH_TO_MESH, VISEME_KEYS, collectMorphMeshes, LoomLargeThree as default, hasLeftRightMorphs, isMixedAU };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map