@lovelace_lol/loom3 1.0.37 → 1.0.39

package/dist/index.d.cts

@@ -2002,12 +2002,28 @@ declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile
  *
  * Precedence:
  * 1. preset defaults
- * 2. flattened top-level profile overrides
+ * 2. saved `config.regions` overrides, or fallbacks when `annotationRegions`
+ *    is present
  * 3. legacy nested `config.profile` overrides (compatibility only)
- * 4. top-level saved `config.regions` overrides by region name
+ * 4. flattened top-level profile overrides
  */
 declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
 
+type CameraRelativeGazeOffset = {
+    x: number;
+    y: number;
+};
+interface CameraRelativeGazeOptions {
+    yawWeight?: number;
+    pitchWeight?: number;
+    epsilon?: number;
+}
+/**
+ * Convert the current camera position into a normalized gaze offset in model-local space.
+ * This is intentionally pure so apps can cache or subscribe to camera changes however they want.
+ */
+declare function computeCameraRelativeGazeOffset(model: THREE.Object3D | null, cameraPosition: THREE.Vector3, targetPosition: THREE.Vector3, options?: CameraRelativeGazeOptions): CameraRelativeGazeOffset;
+
 interface ResolvedFaceCenter {
     center: THREE.Vector3;
     method: string;
@@ -2446,4 +2462,4 @@ declare function detectFacingDirection(model: THREE.Object3D, eyeBoneNames?: {
     right: string[];
 }): 'forward' | 'backward' | 'unknown';
 
-export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, FISH_AU_MAPPING_CONFIG, type FaceCenterResult, type FallbackConfig, type FindFaceCenterOptions, type Hair, type HairMorphAxis, type HairMorphOutput$1 as HairMorphOutput, type HairMorphTargetMapping, type HairMorphTargetValueMapping, type HairMorphTargetsConfig, type HairObjectRef, type HairObjectState, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysicsDirectionConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsProfileConfig, type HairPhysicsRuntimeConfig, type HairPhysicsRuntimeConfigUpdate, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LineConfig, type LineCurve, type LineStyle, Loom3, type Loom3Config, Loom3 as Loom3Three, type LoomLarge, type LoomLargeConfig, Loom3 as LoomLargeThree, MORPH_TO_MESH, type MappingConsistencyResult, type MappingCorrection, type MappingCorrectionOptions, type MappingCorrectionResult, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCategory, type MorphInfo, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, FISH_AU_MAPPING_CONFIG, type FaceCenterResult, type FallbackConfig, type FindFaceCenterOptions, type Hair, type HairMorphAxis, type HairMorphOutput$1 as HairMorphOutput, type HairMorphTargetMapping, type HairMorphTargetValueMapping, type HairMorphTargetsConfig, type HairObjectRef, type HairObjectState, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysicsDirectionConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsProfileConfig, type HairPhysicsRuntimeConfig, type HairPhysicsRuntimeConfigUpdate, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LineConfig, type LineCurve, type LineStyle, Loom3, type Loom3Config, Loom3 as Loom3Three, type LoomLarge, type LoomLargeConfig, Loom3 as LoomLargeThree, MORPH_TO_MESH, type MappingConsistencyResult, type MappingCorrection, type MappingCorrectionOptions, type MappingCorrectionResult, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCategory, type MorphInfo, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.d.ts

@@ -2002,12 +2002,28 @@ declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile
  *
  * Precedence:
  * 1. preset defaults
- * 2. flattened top-level profile overrides
+ * 2. saved `config.regions` overrides, or fallbacks when `annotationRegions`
+ *    is present
  * 3. legacy nested `config.profile` overrides (compatibility only)
- * 4. top-level saved `config.regions` overrides by region name
+ * 4. flattened top-level profile overrides
  */
 declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
 
+type CameraRelativeGazeOffset = {
+    x: number;
+    y: number;
+};
+interface CameraRelativeGazeOptions {
+    yawWeight?: number;
+    pitchWeight?: number;
+    epsilon?: number;
+}
+/**
+ * Convert the current camera position into a normalized gaze offset in model-local space.
+ * This is intentionally pure so apps can cache or subscribe to camera changes however they want.
+ */
+declare function computeCameraRelativeGazeOffset(model: THREE.Object3D | null, cameraPosition: THREE.Vector3, targetPosition: THREE.Vector3, options?: CameraRelativeGazeOptions): CameraRelativeGazeOffset;
+
 interface ResolvedFaceCenter {
     center: THREE.Vector3;
     method: string;
@@ -2446,4 +2462,4 @@ declare function detectFacingDirection(model: THREE.Object3D, eyeBoneNames?: {
     right: string[];
 }): 'forward' | 'backward' | 'unknown';
 
-export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, FISH_AU_MAPPING_CONFIG, type FaceCenterResult, type FallbackConfig, type FindFaceCenterOptions, type Hair, type HairMorphAxis, type HairMorphOutput$1 as HairMorphOutput, type HairMorphTargetMapping, type HairMorphTargetValueMapping, type HairMorphTargetsConfig, type HairObjectRef, type HairObjectState, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysicsDirectionConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsProfileConfig, type HairPhysicsRuntimeConfig, type HairPhysicsRuntimeConfigUpdate, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LineConfig, type LineCurve, type LineStyle, Loom3, type Loom3Config, Loom3 as Loom3Three, type LoomLarge, type LoomLargeConfig, Loom3 as LoomLargeThree, MORPH_TO_MESH, type MappingConsistencyResult, type MappingCorrection, type MappingCorrectionOptions, type MappingCorrectionResult, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCategory, type MorphInfo, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, FISH_AU_MAPPING_CONFIG, type FaceCenterResult, type FallbackConfig, type FindFaceCenterOptions, type Hair, type HairMorphAxis, type HairMorphOutput$1 as HairMorphOutput, type HairMorphTargetMapping, type HairMorphTargetValueMapping, type HairMorphTargetsConfig, type HairObjectRef, type HairObjectState, HairPhysics, type HairPhysicsConfig$1 as HairPhysicsConfig, type HairPhysicsDirectionConfig, type HairPhysics$1 as HairPhysicsInterface, type HairMorphOutput as HairPhysicsMorphOutput, type HairPhysicsProfileConfig, type HairPhysicsRuntimeConfig, type HairPhysicsRuntimeConfigUpdate, type HairPhysicsState, type HairState, type HairStrand, type HeadState$1 as HeadState, type LineConfig, type LineCurve, type LineStyle, Loom3, type Loom3Config, Loom3 as Loom3Three, type LoomLarge, type LoomLargeConfig, Loom3 as LoomLargeThree, MORPH_TO_MESH, type MappingConsistencyResult, type MappingCorrection, type MappingCorrectionOptions, type MappingCorrectionResult, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCategory, type MorphInfo, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.js

@@ -1,4 +1,4 @@
-import * as THREE from 'three';
+import * as THREE2 from 'three';
 import { Vector3, Clock, Box3, Quaternion, AdditiveAnimationBlendMode, NormalAnimationBlendMode, LoopPingPong, LoopOnce, LoopRepeat, QuaternionKeyframeTrack, NumberKeyframeTrack, AnimationClip, AnimationMixer, Mesh, PropertyBinding } from 'three';
 
 var __defProp = Object.defineProperty;
@@ -6209,10 +6209,11 @@ function extractProfileOverrides(config) {
     if (key === "annotationRegions") {
       const topLevelAnnotationRegions = Array.isArray(topLevelConfig.annotationRegions) ? topLevelConfig.annotationRegions : void 0;
       const legacyAnnotationRegions = Array.isArray(legacyNestedOverrides.annotationRegions) ? legacyNestedOverrides.annotationRegions : void 0;
-      const presetOverrideRegions = mergeRegionsByName(legacyAnnotationRegions, topLevelAnnotationRegions);
+      const legacyRegionFallback = Array.isArray(config.regions) && config.regions.length > 0 ? config.regions : void 0;
+      const legacyProfileRegions = mergeRegionsByName(legacyRegionFallback, legacyAnnotationRegions);
       const regions = mergeRegionsByName(
-        presetOverrideRegions,
-        Array.isArray(config.regions) && config.regions.length > 0 ? config.regions : void 0
+        legacyProfileRegions,
+        topLevelAnnotationRegions
       );
       if (regions) {
         overrides.annotationRegions = regions.map((region) => cloneRegion(region));
@@ -6228,6 +6229,13 @@ function extractProfileOverrides(config) {
   }
   return overrides;
 }
+function hasCanonicalAnnotationRegionOverrides(config) {
+  const topLevelConfig = config;
+  if (Array.isArray(topLevelConfig.annotationRegions)) {
+    return true;
+  }
+  return isPlainObject2(config.profile) && Array.isArray(config.profile.annotationRegions);
+}
 function applyCharacterProfileToPreset(config) {
   const presetType = config.auPresetType;
   if (!presetType) {
@@ -6265,7 +6273,7 @@ function extendCharacterConfigWithPreset(config) {
     return config;
   }
   const presetRegions = extendedPresetProfile.annotationRegions;
-  const mergedRegions = mergeRegionsByName(presetRegions, config.regions);
+  const mergedRegions = hasCanonicalAnnotationRegionOverrides(config) ? mergeRegionsByName(config.regions, presetRegions) : mergeRegionsByName(presetRegions, config.regions);
   const normalizedRegions = normalizeRegionTree(
     mergedRegions,
     profileOverrides.disabledRegions
@@ -6280,6 +6288,43 @@ function extendCharacterConfigWithPreset(config) {
     regions: extendedRegions ?? config.regions
   };
 }
+var DEFAULT_EPSILON = 1e-4;
+var DEFAULT_YAW_WEIGHT = 0.35;
+var DEFAULT_PITCH_WEIGHT = 0.2;
+var ZERO_OFFSET = { x: 0, y: 0 };
+function clampOffset(value) {
+  return THREE2.MathUtils.clamp(value, -1, 1);
+}
+function toModelLocalDirection(model, worldDirection) {
+  const localDirection = worldDirection.clone();
+  model.updateWorldMatrix(true, false);
+  const worldQuaternion = new THREE2.Quaternion();
+  model.getWorldQuaternion(worldQuaternion);
+  localDirection.applyQuaternion(worldQuaternion.invert());
+  return localDirection.normalize();
+}
+function computeCameraRelativeGazeOffset(model, cameraPosition, targetPosition, options = {}) {
+  if (!model) {
+    return ZERO_OFFSET;
+  }
+  const epsilon = options.epsilon ?? DEFAULT_EPSILON;
+  const yawWeight = options.yawWeight ?? DEFAULT_YAW_WEIGHT;
+  const pitchWeight = options.pitchWeight ?? DEFAULT_PITCH_WEIGHT;
+  const worldOffset = new THREE2.Vector3().subVectors(cameraPosition, targetPosition);
+  if (worldOffset.lengthSq() < epsilon) {
+    return ZERO_OFFSET;
+  }
+  const localDirection = toModelLocalDirection(model, worldOffset.normalize());
+  const yawAngle = Math.atan2(localDirection.x, localDirection.z);
+  const pitchAngle = Math.atan2(
+    localDirection.y,
+    Math.max(Math.hypot(localDirection.x, localDirection.z), epsilon)
+  );
+  return {
+    x: clampOffset(yawAngle / (Math.PI / 2)) * yawWeight,
+    y: clampOffset(pitchAngle / (Math.PI / 3)) * pitchWeight
+  };
+}
 var DEFAULT_HEAD_BONE_NAMES = ["CC_Base_Head", "Head", "head", "Bip01_Head"];
 var DEFAULT_REFERENCE_HEIGHT = 1.8;
 var DEFAULT_FORWARD_OFFSET = 0.08;
@@ -6295,8 +6340,8 @@ function findFaceCenter(model, options = {}) {
     referenceHeight = DEFAULT_REFERENCE_HEIGHT
   } = options;
   const debugInfo = [];
-  const boundingBox = new THREE.Box3().setFromObject(model);
-  const modelSize = new THREE.Vector3();
+  const boundingBox = new THREE2.Box3().setFromObject(model);
+  const modelSize = new THREE2.Vector3();
   boundingBox.getSize(modelSize);
   const scale = modelSize.y / referenceHeight;
   debugInfo.push(`Model height: ${modelSize.y.toFixed(2)}m, scale factor: ${scale.toFixed(2)}`);
@@ -6307,7 +6352,7 @@ function findFaceCenter(model, options = {}) {
       const objName = obj.name.toLowerCase();
       for (const boneName of headBoneNames) {
         if (objName === boneName.toLowerCase() || objName.includes(boneName.toLowerCase())) {
-          headPos2 = new THREE.Vector3();
+          headPos2 = new THREE2.Vector3();
           obj.getWorldPosition(headPos2);
           debugInfo.push(`Found head bone "${obj.name}" at (${headPos2.x.toFixed(3)}, ${headPos2.y.toFixed(3)}, ${headPos2.z.toFixed(3)})`);
           return;
@@ -6326,7 +6371,7 @@ function findFaceCenter(model, options = {}) {
       if (!eyes2.left) {
         for (const name of EYE_BONE_NAMES.left) {
           if (objName.includes(name)) {
-            eyes2.left = new THREE.Vector3();
+            eyes2.left = new THREE2.Vector3();
             obj.getWorldPosition(eyes2.left);
             debugInfo.push(`Found left eye "${obj.name}" at (${eyes2.left.x.toFixed(3)}, ${eyes2.left.y.toFixed(3)}, ${eyes2.left.z.toFixed(3)})`);
             break;
@@ -6336,7 +6381,7 @@ function findFaceCenter(model, options = {}) {
       if (!eyes2.right) {
         for (const name of EYE_BONE_NAMES.right) {
           if (objName.includes(name)) {
-            eyes2.right = new THREE.Vector3();
+            eyes2.right = new THREE2.Vector3();
             obj.getWorldPosition(eyes2.right);
             debugInfo.push(`Found right eye "${obj.name}" at (${eyes2.right.x.toFixed(3)}, ${eyes2.right.y.toFixed(3)}, ${eyes2.right.z.toFixed(3)})`);
             break;
@@ -6348,7 +6393,7 @@ function findFaceCenter(model, options = {}) {
   };
   if (faceMeshNames && faceMeshNames.length > 0) {
     debugInfo.push(`Looking for face meshes: ${faceMeshNames.join(", ")}`);
-    const meshBox = new THREE.Box3();
+    const meshBox = new THREE2.Box3();
     let foundMesh = false;
     model.traverse((obj) => {
       const isMesh = obj.isMesh;
@@ -6356,7 +6401,7 @@ function findFaceCenter(model, options = {}) {
       for (const meshName of faceMeshNames) {
         if (obj.name === meshName || obj.name.includes(meshName)) {
           const mesh = obj;
-          const tempBox = new THREE.Box3().setFromObject(mesh);
+          const tempBox = new THREE2.Box3().setFromObject(mesh);
           meshBox.union(tempBox);
           foundMesh = true;
           debugInfo.push(`Found mesh: "${obj.name}"`);
@@ -6365,11 +6410,11 @@ function findFaceCenter(model, options = {}) {
       }
     });
     if (foundMesh && !meshBox.isEmpty()) {
-      const meshBoundsSize = new THREE.Vector3();
+      const meshBoundsSize = new THREE2.Vector3();
       meshBox.getSize(meshBoundsSize);
       const isFullBodyMesh = meshBoundsSize.y > modelSize.y * 0.7;
       if (!isFullBodyMesh) {
-        const meshCenter = new THREE.Vector3();
+        const meshCenter = new THREE2.Vector3();
         meshBox.getCenter(meshCenter);
         debugInfo.push(`Using face mesh center: (${meshCenter.x.toFixed(3)}, ${meshCenter.y.toFixed(3)}, ${meshCenter.z.toFixed(3)})`);
         return {
@@ -6383,7 +6428,7 @@ function findFaceCenter(model, options = {}) {
   }
   const eyes = findEyes();
   if (eyes.left && eyes.right) {
-    const eyeCenter = new THREE.Vector3().addVectors(eyes.left, eyes.right).multiplyScalar(0.5);
+    const eyeCenter = new THREE2.Vector3().addVectors(eyes.left, eyes.right).multiplyScalar(0.5);
     debugInfo.push(`Eye center (face position): (${eyeCenter.x.toFixed(3)}, ${eyeCenter.y.toFixed(3)}, ${eyeCenter.z.toFixed(3)})`);
     const headPos2 = findHeadBone();
     return {
@@ -6408,10 +6453,10 @@ function findFaceCenter(model, options = {}) {
     };
   }
   debugInfo.push("No head bone found, using model center fallback");
-  const modelCenter = new THREE.Vector3();
+  const modelCenter = new THREE2.Vector3();
   boundingBox.getCenter(modelCenter);
   const headHeight = boundingBox.min.y + modelSize.y * 0.9;
-  const fallbackCenter = new THREE.Vector3(modelCenter.x, headHeight, modelCenter.z);
+  const fallbackCenter = new THREE2.Vector3(modelCenter.x, headHeight, modelCenter.z);
   debugInfo.push(`Fallback center: (${fallbackCenter.x.toFixed(3)}, ${fallbackCenter.y.toFixed(3)}, ${fallbackCenter.z.toFixed(3)})`);
   return {
     center: fallbackCenter,
@@ -6420,7 +6465,7 @@ function findFaceCenter(model, options = {}) {
   };
 }
 function getModelForwardDirection(model) {
-  const forward = new THREE.Vector3(0, 0, 1);
+  const forward = new THREE2.Vector3(0, 0, 1);
   forward.applyQuaternion(model.quaternion);
   return forward.normalize();
 }
@@ -6437,7 +6482,7 @@ function detectFacingDirection(model, eyeBoneNames = {
     if (!eyes.left) {
       for (const name of eyeBoneNames.left) {
         if (objName.includes(name)) {
-          eyes.left = new THREE.Vector3();
+          eyes.left = new THREE2.Vector3();
           obj.getWorldPosition(eyes.left);
           break;
         }
@@ -6446,7 +6491,7 @@ function detectFacingDirection(model, eyeBoneNames = {
     if (!eyes.right) {
       for (const name of eyeBoneNames.right) {
         if (objName.includes(name)) {
-          eyes.right = new THREE.Vector3();
+          eyes.right = new THREE2.Vector3();
           obj.getWorldPosition(eyes.right);
           break;
         }
@@ -7362,19 +7407,19 @@ function extractBones(root) {
   const bones = [];
   const boneDepths = /* @__PURE__ */ new Map();
   root.traverse((obj) => {
-    if (obj instanceof THREE.Bone || obj.type === "Bone") {
-      const worldPos = new THREE.Vector3();
+    if (obj instanceof THREE2.Bone || obj.type === "Bone") {
+      const worldPos = new THREE2.Vector3();
       obj.getWorldPosition(worldPos);
       let depth = 0;
       let parent = obj.parent;
       while (parent) {
-        if (parent instanceof THREE.Bone || parent.type === "Bone") {
+        if (parent instanceof THREE2.Bone || parent.type === "Bone") {
           depth++;
         }
         parent = parent.parent;
       }
       boneDepths.set(obj.name, depth);
-      const parentBone = obj.parent instanceof THREE.Bone || obj.parent?.type === "Bone" ? obj.parent.name : null;
+      const parentBone = obj.parent instanceof THREE2.Bone || obj.parent?.type === "Bone" ? obj.parent.name : null;
       bones.push({
         name: obj.name,
         parent: parentBone,
@@ -7598,6 +7643,6 @@ async function analyzeModel(options) {
   };
 }
 
-export { AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, DEFAULT_HAIR_PHYSICS_CONFIG, FISH_AU_MAPPING_CONFIG, HairPhysics, Loom3, Loom3 as Loom3Three, Loom3 as LoomLargeThree, MORPH_TO_MESH, VISEME_JAW_AMOUNTS, VISEME_KEYS, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
+export { AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, AnimationThree, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, DEFAULT_HAIR_PHYSICS_CONFIG, FISH_AU_MAPPING_CONFIG, HairPhysics, Loom3, Loom3 as Loom3Three, Loom3 as LoomLargeThree, MORPH_TO_MESH, VISEME_JAW_AMOUNTS, VISEME_KEYS, analyzeModel, applyCharacterProfileToPreset, collectMorphMeshes, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map