@lovelace_lol/loom3 1.0.45 → 1.0.46

package/dist/index.d.cts

@@ -2244,6 +2244,31 @@ declare function resolveBoneNames(names: string[] | undefined, profile?: BoneRes
 declare function fuzzyNameMatch(objectName: string, targetName: string, suffixPattern?: string): boolean;
 declare function resolveFaceCenter(model: THREE.Object3D, region: Region, profile?: BoneResolutionProfile): ResolvedFaceCenter;
 
+type SemanticSide = 'left' | 'right';
+interface AnnotationLaterality {
+    leftSideX: 1 | -1;
+    confidence: number;
+    evidence: string[];
+}
+type LateralityRegion = Pick<Region, 'name' | 'cameraAngle' | 'parent'>;
+declare function getDefaultAnnotationLaterality(): AnnotationLaterality;
+declare function normalizeCameraAngle(angle: number): number;
+declare function getRegionSemanticSide(regionName?: string): SemanticSide | null;
+declare function getSemanticHorizontalSign(regionName: string, laterality: AnnotationLaterality): 1 | -1 | null;
+declare function getSemanticHorizontalSignForSide(side: SemanticSide, laterality: AnnotationLaterality): 1 | -1;
+declare function detectAnnotationLaterality(model: THREE.Object3D | null, regions: Region[], characterConfig: BoneResolutionProfile | null): AnnotationLaterality;
+declare function resolveRegionCameraAngle(region: LateralityRegion, laterality: AnnotationLaterality): number | undefined;
+declare function resolveRegionVisibilityCameraAngle(region: LateralityRegion, laterality: AnnotationLaterality): number | undefined;
+declare function toWorldDirection(model: THREE.Object3D | null, localDirection: THREE.Vector3): THREE.Vector3;
+declare function toModelLocalDirection(model: THREE.Object3D | null, worldDirection: THREE.Vector3): THREE.Vector3;
+declare function getWorldDirectionForCameraAngle(model: THREE.Object3D | null, cameraAngle: number): THREE.Vector3;
+declare function getModelLocalOrbitAngle(model: THREE.Object3D | null, modelCenter: THREE.Vector3, worldPosition: THREE.Vector3): number;
+declare function passesMarkerCameraAngleGate(params: {
+    markerAngle?: number;
+    currentCameraAngle?: number;
+    rangeDegrees?: number;
+}): boolean;
+
 /**
  * HairPhysics - Spring-damper pendulum simulation for hair movement
  *
@@ -2672,4 +2697,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 AddMorphTargetOptions, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, type AnnotationRegion, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, type BoneResolutionProfile, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterProfile, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, type CustomProfileRuntimeConfig, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetBackedProfileRuntimeConfig, type PresetType, type Profile, type ProfileOverrides, type ProfilePresetId, type ProfileRegistry, type ProfileRuntimeConfig, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type ResolvedFaceCenter, type ResolvedProfileRuntimeConfig, type ResolvedVisemeBindingTarget, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveVisemeMeshCategory, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AddMorphTargetOptions, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, type AnnotationLaterality, type AnnotationRegion, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, type BoneResolutionProfile, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterProfile, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, type CustomProfileRuntimeConfig, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetBackedProfileRuntimeConfig, type PresetType, type Profile, type ProfileOverrides, type ProfilePresetId, type ProfileRegistry, type ProfileRuntimeConfig, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type ResolvedFaceCenter, type ResolvedProfileRuntimeConfig, type ResolvedVisemeBindingTarget, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectAnnotationLaterality, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getDefaultAnnotationLaterality, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getModelLocalOrbitAngle, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getRegionSemanticSide, getSemanticHorizontalSign, getSemanticHorizontalSignForSide, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, getWorldDirectionForCameraAngle, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, normalizeCameraAngle, passesMarkerCameraAngleGate, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveRegionCameraAngle, resolveRegionVisibilityCameraAngle, resolveVisemeMeshCategory, suggestBestPreset, toModelLocalDirection, toWorldDirection, validateMappingConfig, validateMappings };

package/dist/index.d.ts

@@ -2244,6 +2244,31 @@ declare function resolveBoneNames(names: string[] | undefined, profile?: BoneRes
 declare function fuzzyNameMatch(objectName: string, targetName: string, suffixPattern?: string): boolean;
 declare function resolveFaceCenter(model: THREE.Object3D, region: Region, profile?: BoneResolutionProfile): ResolvedFaceCenter;
 
+type SemanticSide = 'left' | 'right';
+interface AnnotationLaterality {
+    leftSideX: 1 | -1;
+    confidence: number;
+    evidence: string[];
+}
+type LateralityRegion = Pick<Region, 'name' | 'cameraAngle' | 'parent'>;
+declare function getDefaultAnnotationLaterality(): AnnotationLaterality;
+declare function normalizeCameraAngle(angle: number): number;
+declare function getRegionSemanticSide(regionName?: string): SemanticSide | null;
+declare function getSemanticHorizontalSign(regionName: string, laterality: AnnotationLaterality): 1 | -1 | null;
+declare function getSemanticHorizontalSignForSide(side: SemanticSide, laterality: AnnotationLaterality): 1 | -1;
+declare function detectAnnotationLaterality(model: THREE.Object3D | null, regions: Region[], characterConfig: BoneResolutionProfile | null): AnnotationLaterality;
+declare function resolveRegionCameraAngle(region: LateralityRegion, laterality: AnnotationLaterality): number | undefined;
+declare function resolveRegionVisibilityCameraAngle(region: LateralityRegion, laterality: AnnotationLaterality): number | undefined;
+declare function toWorldDirection(model: THREE.Object3D | null, localDirection: THREE.Vector3): THREE.Vector3;
+declare function toModelLocalDirection(model: THREE.Object3D | null, worldDirection: THREE.Vector3): THREE.Vector3;
+declare function getWorldDirectionForCameraAngle(model: THREE.Object3D | null, cameraAngle: number): THREE.Vector3;
+declare function getModelLocalOrbitAngle(model: THREE.Object3D | null, modelCenter: THREE.Vector3, worldPosition: THREE.Vector3): number;
+declare function passesMarkerCameraAngleGate(params: {
+    markerAngle?: number;
+    currentCameraAngle?: number;
+    rangeDegrees?: number;
+}): boolean;
+
 /**
  * HairPhysics - Spring-damper pendulum simulation for hair movement
  *
@@ -2672,4 +2697,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 AddMorphTargetOptions, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, type AnnotationRegion, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, type BoneResolutionProfile, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterProfile, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, type CustomProfileRuntimeConfig, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetBackedProfileRuntimeConfig, type PresetType, type Profile, type ProfileOverrides, type ProfilePresetId, type ProfileRegistry, type ProfileRuntimeConfig, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type ResolvedFaceCenter, type ResolvedProfileRuntimeConfig, type ResolvedVisemeBindingTarget, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveVisemeMeshCategory, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AddMorphTargetOptions, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationBlendMode, type AnimationClipInfo, type AnimationEasing, type AnimationInfo, type AnimationPlayOptions, type AnimationSource, type AnimationState, AnimationThree, type AnnotationLaterality, type AnnotationRegion, BETTA_FISH_PRESET, BLENDING_MODES, BONE_AU_TO_BINDINGS, type BlendingMode, type BoneBinding, type BoneInfo, type BoneKey, type BoneResolutionProfile, CC4_BONE_NODES, CC4_BONE_PREFIX, CC4_EYE_MESH_NODES, CC4_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterProfile, type CharacterRegistry, type ClipEvent, type ClipEventListener, type ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, type CustomProfileRuntimeConfig, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetBackedProfileRuntimeConfig, type PresetType, type Profile, type ProfileOverrides, type ProfilePresetId, type ProfileRegistry, type ProfileRuntimeConfig, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type ResolvedFaceCenter, type ResolvedProfileRuntimeConfig, type ResolvedVisemeBindingTarget, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectAnnotationLaterality, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getDefaultAnnotationLaterality, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getModelLocalOrbitAngle, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getRegionSemanticSide, getSemanticHorizontalSign, getSemanticHorizontalSignForSide, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, getWorldDirectionForCameraAngle, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, normalizeCameraAngle, passesMarkerCameraAngleGate, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveRegionCameraAngle, resolveRegionVisibilityCameraAngle, resolveVisemeMeshCategory, suggestBestPreset, toModelLocalDirection, toWorldDirection, validateMappingConfig, validateMappings };

package/dist/index.js

@@ -7517,6 +7517,274 @@ function resolveFaceCenter(model, region, profile) {
   };
 }
 
+// src/camera/annotationCameraAngles.ts
+var DEFAULT_LATERALITY = {
+  leftSideX: -1,
+  confidence: 0,
+  evidence: ["default:left=-X"]
+};
+var SIDE_TOKEN_PATTERN = /(^|[_\s-])(left|right)(?=$|[_\s-])/i;
+var MIN_LATERAL_SEPARATION = 1e-3;
+function invertHorizontalSign(sign) {
+  return sign === 1 ? -1 : 1;
+}
+function averagePoints(points) {
+  if (points.length === 0) return null;
+  const center = new THREE2.Vector3();
+  for (const point of points) {
+    center.add(point);
+  }
+  return center.divideScalar(points.length);
+}
+function replaceSemanticSideToken(name, replacement) {
+  const match = SIDE_TOKEN_PATTERN.exec(name);
+  if (!match) return null;
+  const [fullMatch, prefix] = match;
+  const start = match.index;
+  const end = start + fullMatch.length;
+  return `${name.slice(0, start)}${prefix}${replacement}${name.slice(end)}`;
+}
+function collectMatchedPoints(model, targetNames, matcher, extractor) {
+  const points = [];
+  for (const targetName of targetNames) {
+    model.traverse((obj) => {
+      if (!matcher(obj, targetName)) return;
+      const point = extractor(obj);
+      if (point) {
+        points.push(point);
+      }
+    });
+  }
+  return points;
+}
+function getRegionWorldCenter(model, region, characterConfig) {
+  if (region.customPosition) {
+    return new THREE2.Vector3(
+      region.customPosition.x,
+      region.customPosition.y,
+      region.customPosition.z
+    );
+  }
+  if (region.objects?.includes("*")) {
+    return null;
+  }
+  const suffixPattern = characterConfig?.suffixPattern;
+  const points = [];
+  if (region.bones?.length) {
+    const boneNames = resolveBoneNames(region.bones, characterConfig ?? void 0);
+    points.push(
+      ...collectMatchedPoints(
+        model,
+        boneNames,
+        (obj, targetName) => fuzzyNameMatch(obj.name, targetName, suffixPattern),
+        (obj) => {
+          const worldPos = new THREE2.Vector3();
+          obj.getWorldPosition(worldPos);
+          return worldPos;
+        }
+      )
+    );
+  }
+  if (region.meshes?.length) {
+    points.push(
+      ...collectMatchedPoints(
+        model,
+        region.meshes,
+        (obj, targetName) => obj.isMesh && fuzzyNameMatch(obj.name, targetName, suffixPattern),
+        (obj) => {
+          const box = new THREE2.Box3().setFromObject(obj);
+          if (box.isEmpty()) {
+            return null;
+          }
+          return box.getCenter(new THREE2.Vector3());
+        }
+      )
+    );
+  }
+  if (region.objects?.length) {
+    const objectTargets = region.objects.filter((target) => target !== "*");
+    points.push(
+      ...collectMatchedPoints(
+        model,
+        objectTargets,
+        (obj, targetName) => fuzzyNameMatch(obj.name, targetName, suffixPattern),
+        (obj) => {
+          if (obj.isMesh) {
+            const box = new THREE2.Box3().setFromObject(obj);
+            if (!box.isEmpty()) {
+              return box.getCenter(new THREE2.Vector3());
+            }
+          }
+          const worldPos = new THREE2.Vector3();
+          obj.getWorldPosition(worldPos);
+          return worldPos;
+        }
+      )
+    );
+  }
+  return averagePoints(points);
+}
+function getRegionLocalCenter(model, region, characterConfig) {
+  const worldCenter = getRegionWorldCenter(model, region, characterConfig);
+  return worldCenter ? model.worldToLocal(worldCenter.clone()) : null;
+}
+function cloneLaterality(value) {
+  return {
+    leftSideX: value.leftSideX,
+    confidence: value.confidence,
+    evidence: [...value.evidence]
+  };
+}
+function getDefaultAnnotationLaterality() {
+  return cloneLaterality(DEFAULT_LATERALITY);
+}
+function normalizeCameraAngle(angle) {
+  return (angle % 360 + 360) % 360;
+}
+function getRegionSemanticSide(regionName) {
+  if (!regionName) return null;
+  const match = SIDE_TOKEN_PATTERN.exec(regionName);
+  if (!match) return null;
+  return match[2].toLowerCase() === "left" ? "left" : "right";
+}
+function getSemanticHorizontalSign(regionName, laterality) {
+  const side = getRegionSemanticSide(regionName);
+  if (side === "left") return laterality.leftSideX;
+  if (side === "right") return invertHorizontalSign(laterality.leftSideX);
+  return null;
+}
+function getSemanticHorizontalSignForSide(side, laterality) {
+  return side === "left" ? laterality.leftSideX : invertHorizontalSign(laterality.leftSideX);
+}
+function detectAnnotationLaterality(model, regions, characterConfig) {
+  if (!model || regions.length === 0) {
+    return getDefaultAnnotationLaterality();
+  }
+  model.updateMatrixWorld(true);
+  const regionsByName = new Map(
+    regions.map((region) => [region.name.toLowerCase(), region])
+  );
+  const votes = [];
+  const pairedKeys = /* @__PURE__ */ new Set();
+  for (const region of regions) {
+    if (getRegionSemanticSide(region.name) !== "left") continue;
+    const mirroredName = replaceSemanticSideToken(region.name, "right");
+    if (!mirroredName) continue;
+    const other = regionsByName.get(mirroredName.toLowerCase());
+    if (!other) continue;
+    const pairKey = [region.name.toLowerCase(), other.name.toLowerCase()].sort().join("|");
+    if (pairedKeys.has(pairKey)) continue;
+    pairedKeys.add(pairKey);
+    const leftCenter = getRegionLocalCenter(model, region, characterConfig);
+    const rightCenter = getRegionLocalCenter(model, other, characterConfig);
+    if (!leftCenter || !rightCenter) continue;
+    const separation = Math.abs(leftCenter.x - rightCenter.x);
+    if (separation < MIN_LATERAL_SEPARATION) continue;
+    votes.push({
+      sign: leftCenter.x > rightCenter.x ? 1 : -1,
+      weight: separation,
+      evidence: `pair:${region.name}/${other.name}:${leftCenter.x.toFixed(3)}/${rightCenter.x.toFixed(3)}`
+    });
+  }
+  if (votes.length === 0) {
+    for (const region of regions) {
+      const side = getRegionSemanticSide(region.name);
+      if (!side) continue;
+      const center = getRegionLocalCenter(model, region, characterConfig);
+      if (!center || Math.abs(center.x) < MIN_LATERAL_SEPARATION) continue;
+      const sign = side === "left" ? center.x > 0 ? 1 : -1 : center.x > 0 ? -1 : 1;
+      votes.push({
+        sign,
+        weight: Math.abs(center.x),
+        evidence: `single:${region.name}:${center.x.toFixed(3)}`
+      });
+    }
+  }
+  if (votes.length === 0) {
+    return getDefaultAnnotationLaterality();
+  }
+  let signedWeight = 0;
+  let totalWeight = 0;
+  for (const vote of votes) {
+    signedWeight += vote.sign * vote.weight;
+    totalWeight += vote.weight;
+  }
+  if (Math.abs(signedWeight) < MIN_LATERAL_SEPARATION) {
+    return getDefaultAnnotationLaterality();
+  }
+  return {
+    leftSideX: signedWeight > 0 ? 1 : -1,
+    confidence: totalWeight > 0 ? Math.abs(signedWeight) / totalWeight : 0,
+    evidence: votes.map((vote) => vote.evidence)
+  };
+}
+function resolveRegionCameraAngle(region, laterality) {
+  if (region.cameraAngle === void 0) {
+    return void 0;
+  }
+  const normalizedAngle = normalizeCameraAngle(region.cameraAngle);
+  const side = getRegionSemanticSide(region.name);
+  if (side && (normalizedAngle === 90 || normalizedAngle === 270)) {
+    return side === "left" ? laterality.leftSideX > 0 ? 90 : 270 : laterality.leftSideX > 0 ? 270 : 90;
+  }
+  return normalizedAngle;
+}
+function resolveRegionVisibilityCameraAngle(region, laterality) {
+  const explicitAngle = resolveRegionCameraAngle(region, laterality);
+  if (explicitAngle !== void 0) {
+    return explicitAngle;
+  }
+  if (!region.parent) {
+    return void 0;
+  }
+  const side = getRegionSemanticSide(region.name);
+  if (!side) {
+    return void 0;
+  }
+  return side === "left" ? laterality.leftSideX > 0 ? 90 : 270 : laterality.leftSideX > 0 ? 270 : 90;
+}
+function toWorldDirection(model, localDirection) {
+  const worldDirection = localDirection.clone();
+  if (model) {
+    model.updateMatrixWorld(true);
+    const worldQuaternion = new THREE2.Quaternion();
+    model.getWorldQuaternion(worldQuaternion);
+    worldDirection.applyQuaternion(worldQuaternion);
+  }
+  return worldDirection.normalize();
+}
+function toModelLocalDirection2(model, worldDirection) {
+  const localDirection = worldDirection.clone();
+  if (model) {
+    model.updateMatrixWorld(true);
+    const worldQuaternion = new THREE2.Quaternion();
+    model.getWorldQuaternion(worldQuaternion);
+    localDirection.applyQuaternion(worldQuaternion.invert());
+  }
+  return localDirection.normalize();
+}
+function getWorldDirectionForCameraAngle(model, cameraAngle) {
+  const angleRad = normalizeCameraAngle(cameraAngle) * Math.PI / 180;
+  return toWorldDirection(
+    model,
+    new THREE2.Vector3(Math.sin(angleRad), 0, Math.cos(angleRad))
+  );
+}
+function getModelLocalOrbitAngle(model, modelCenter, worldPosition) {
+  const worldOffset = new THREE2.Vector3().subVectors(worldPosition, modelCenter);
+  const localOffset = toModelLocalDirection2(model, worldOffset);
+  return normalizeCameraAngle(Math.atan2(localOffset.x, localOffset.z) * (180 / Math.PI));
+}
+function passesMarkerCameraAngleGate(params) {
+  const { markerAngle, currentCameraAngle, rangeDegrees = 90 } = params;
+  if (markerAngle === void 0 || markerAngle === 0 || currentCameraAngle === void 0) {
+    return true;
+  }
+  let diff = Math.abs(currentCameraAngle - markerAngle);
+  if (diff > 180) diff = 360 - diff;
+  return diff <= rangeDegrees;
+}
+
 // src/physics/HairPhysics.ts
 var DEFAULT_HAIR_PHYSICS_CONFIG = {
   mass: 1,
@@ -8625,6 +8893,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_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, 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, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveVisemeMeshCategory, 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_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, 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, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectAnnotationLaterality, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extendProfileConfigWithPreset, extractFromGLTF, extractLegacyCharacterProfileOverrides, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getDefaultAnnotationLaterality, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getModelLocalOrbitAngle, getPreset, getPresetWithProfile, getProfilePresetId, getProfileVisemeSlots, getRegionSemanticSide, getSemanticHorizontalSign, getSemanticHorizontalSignForSide, getVisemeBindingTargets, getVisemeJawAmounts, getVisemeSlotIndex, getWorldDirectionForCameraAngle, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, mergeProfileRegionsByName, normalizeCameraAngle, passesMarkerCameraAngleGate, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfileFromPreset, resolveRegionCameraAngle, resolveRegionVisibilityCameraAngle, resolveVisemeMeshCategory, suggestBestPreset, toModelLocalDirection2 as toModelLocalDirection, toWorldDirection, validateMappingConfig, validateMappings };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map