@lovelace_lol/loom3 1.0.4 → 1.0.7

package/dist/index.d.cts

@@ -374,14 +374,16 @@ interface BoneBinding {
     /** Optional side hint for balance-aware AUs. */
     side?: 'left' | 'right';
 }
+/** A single AU id or a grouped list of AU ids that share one semantic direction. */
+type AUSelector = number | number[];
 /**
  * RotationAxis - Defines which AUs control a specific rotation axis
  */
 interface RotationAxis {
     aus: number[];
     axis: 'rx' | 'ry' | 'rz';
-    negative?: number;
-    positive?: number;
+    negative?: AUSelector;
+    positive?: AUSelector;
 }
 /**
  * CompositeRotation - Defines unified rotation axes for bones
@@ -1583,6 +1585,9 @@ declare class Loom3 implements LoomLarge {
     private getMorphKeyCacheKey;
     private getMorphIndexCacheKey;
     private isMixedAU;
+    private getEffectiveBoneAUValue;
+    private getCompositeAxisValueForNode;
+    private getCompositeAxisBindingForNode;
     private initBoneRotations;
     /** Update rotation state - just stores -1 to 1 value like stable version */
     private updateBoneRotation;
@@ -2043,23 +2048,24 @@ declare class HairPhysics {
     reset(): void;
 }
 
-/**
- * Loom3 - Mapping Corrections
- *
- * Attempts to generate a corrected mapping configuration using fuzzy matching.
- * This is a best-effort helper that can be layered on top of validation.
- */
-
-interface MorphMesh$1 {
+interface ValidationMorphMesh {
     name: string;
     morphTargetDictionary?: Record<string, number>;
     morphTargetInfluences?: number[];
 }
-interface Skeleton$1 {
+interface ValidationSkeleton {
     bones: Array<{
         name: string;
     }>;
 }
+
+/**
+ * Loom3 - Mapping Corrections
+ *
+ * Attempts to generate a corrected mapping configuration using fuzzy matching.
+ * This is a best-effort helper that can be layered on top of validation.
+ */
+
 interface MappingCorrection {
     type: 'bone' | 'morph' | 'viseme' | 'mesh';
     source: string;
@@ -2083,7 +2089,7 @@ interface MappingCorrectionOptions {
      */
     useResolvedNames?: boolean;
 }
-declare function generateMappingCorrections(meshes: MorphMesh$1[], skeleton: Skeleton$1 | null, config: Profile, options?: MappingCorrectionOptions): MappingCorrectionResult;
+declare function generateMappingCorrections(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile, options?: MappingCorrectionOptions): MappingCorrectionResult;
 
 /**
  * Loom3 - Mapping Validation
@@ -2143,36 +2149,20 @@ interface MappingConsistencyResult {
 interface ValidateMappingOptions extends MappingCorrectionOptions {
     suggestCorrections?: boolean;
 }
-/**
- * Interface for mesh with morph targets (compatible with Three.js Mesh)
- */
-interface MorphMesh {
-    name: string;
-    morphTargetDictionary?: Record<string, number>;
-    morphTargetInfluences?: number[];
-}
-/**
- * Interface for skeleton (compatible with Three.js Skeleton)
- */
-interface Skeleton {
-    bones: Array<{
-        name: string;
-    }>;
-}
 /**
  * Validate that the mapping dictionaries are internally consistent.
  */
 declare function validateMappingConfig(config: Profile): MappingConsistencyResult;
-declare function validateMappings(meshes: MorphMesh[], skeleton: Skeleton | null, config: Profile, options?: ValidateMappingOptions): ValidationResult;
+declare function validateMappings(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile, options?: ValidateMappingOptions): ValidationResult;
 /**
  * Quick check if a preset is compatible with a model.
  * Returns true if at least 50% of mappings are found.
  */
-declare function isPresetCompatible(meshes: MorphMesh[], skeleton: Skeleton | null, config: Profile): boolean;
+declare function isPresetCompatible(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile): boolean;
 /**
  * Suggest the best preset from a list based on validation scores.
  */
-declare function suggestBestPreset<T extends Profile>(meshes: MorphMesh[], skeleton: Skeleton | null, presets: T[]): {
+declare function suggestBestPreset<T extends Profile>(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, presets: T[]): {
     preset: T;
     score: number;
 } | null;
@@ -2399,4 +2389,4 @@ declare function detectFacingDirection(model: THREE.Object3D, eyeBoneNames?: {
     right: string[];
 }): 'forward' | 'backward' | 'unknown';
 
-export { type AUInfo, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationClipInfo, type AnimationInfo, type AnimationPlayOptions, 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 ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, AU_MAPPING_CONFIG as 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$1 as 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, collectMorphMeshes, detectFacingDirection, extractFromGLTF, extractModelData, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationClipInfo, type AnimationInfo, type AnimationPlayOptions, 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 ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, AU_MAPPING_CONFIG as 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$1 as 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, collectMorphMeshes, detectFacingDirection, extractFromGLTF, extractModelData, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.d.ts

@@ -374,14 +374,16 @@ interface BoneBinding {
     /** Optional side hint for balance-aware AUs. */
     side?: 'left' | 'right';
 }
+/** A single AU id or a grouped list of AU ids that share one semantic direction. */
+type AUSelector = number | number[];
 /**
  * RotationAxis - Defines which AUs control a specific rotation axis
  */
 interface RotationAxis {
     aus: number[];
     axis: 'rx' | 'ry' | 'rz';
-    negative?: number;
-    positive?: number;
+    negative?: AUSelector;
+    positive?: AUSelector;
 }
 /**
  * CompositeRotation - Defines unified rotation axes for bones
@@ -1583,6 +1585,9 @@ declare class Loom3 implements LoomLarge {
     private getMorphKeyCacheKey;
     private getMorphIndexCacheKey;
     private isMixedAU;
+    private getEffectiveBoneAUValue;
+    private getCompositeAxisValueForNode;
+    private getCompositeAxisBindingForNode;
     private initBoneRotations;
     /** Update rotation state - just stores -1 to 1 value like stable version */
     private updateBoneRotation;
@@ -2043,23 +2048,24 @@ declare class HairPhysics {
     reset(): void;
 }
 
-/**
- * Loom3 - Mapping Corrections
- *
- * Attempts to generate a corrected mapping configuration using fuzzy matching.
- * This is a best-effort helper that can be layered on top of validation.
- */
-
-interface MorphMesh$1 {
+interface ValidationMorphMesh {
     name: string;
     morphTargetDictionary?: Record<string, number>;
     morphTargetInfluences?: number[];
 }
-interface Skeleton$1 {
+interface ValidationSkeleton {
     bones: Array<{
         name: string;
     }>;
 }
+
+/**
+ * Loom3 - Mapping Corrections
+ *
+ * Attempts to generate a corrected mapping configuration using fuzzy matching.
+ * This is a best-effort helper that can be layered on top of validation.
+ */
+
 interface MappingCorrection {
     type: 'bone' | 'morph' | 'viseme' | 'mesh';
     source: string;
@@ -2083,7 +2089,7 @@ interface MappingCorrectionOptions {
      */
     useResolvedNames?: boolean;
 }
-declare function generateMappingCorrections(meshes: MorphMesh$1[], skeleton: Skeleton$1 | null, config: Profile, options?: MappingCorrectionOptions): MappingCorrectionResult;
+declare function generateMappingCorrections(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile, options?: MappingCorrectionOptions): MappingCorrectionResult;
 
 /**
  * Loom3 - Mapping Validation
@@ -2143,36 +2149,20 @@ interface MappingConsistencyResult {
 interface ValidateMappingOptions extends MappingCorrectionOptions {
     suggestCorrections?: boolean;
 }
-/**
- * Interface for mesh with morph targets (compatible with Three.js Mesh)
- */
-interface MorphMesh {
-    name: string;
-    morphTargetDictionary?: Record<string, number>;
-    morphTargetInfluences?: number[];
-}
-/**
- * Interface for skeleton (compatible with Three.js Skeleton)
- */
-interface Skeleton {
-    bones: Array<{
-        name: string;
-    }>;
-}
 /**
  * Validate that the mapping dictionaries are internally consistent.
  */
 declare function validateMappingConfig(config: Profile): MappingConsistencyResult;
-declare function validateMappings(meshes: MorphMesh[], skeleton: Skeleton | null, config: Profile, options?: ValidateMappingOptions): ValidationResult;
+declare function validateMappings(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile, options?: ValidateMappingOptions): ValidationResult;
 /**
  * Quick check if a preset is compatible with a model.
  * Returns true if at least 50% of mappings are found.
  */
-declare function isPresetCompatible(meshes: MorphMesh[], skeleton: Skeleton | null, config: Profile): boolean;
+declare function isPresetCompatible(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, config: Profile): boolean;
 /**
  * Suggest the best preset from a list based on validation scores.
  */
-declare function suggestBestPreset<T extends Profile>(meshes: MorphMesh[], skeleton: Skeleton | null, presets: T[]): {
+declare function suggestBestPreset<T extends Profile>(meshes: ValidationMorphMesh[], skeleton: ValidationSkeleton | null, presets: T[]): {
     preset: T;
     score: number;
 } | null;
@@ -2399,4 +2389,4 @@ declare function detectFacingDirection(model: THREE.Object3D, eyeBoneNames?: {
     right: string[];
 }): 'forward' | 'backward' | 'unknown';
 
-export { type AUInfo, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationClipInfo, type AnimationInfo, type AnimationPlayOptions, 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 ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, AU_MAPPING_CONFIG as 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$1 as 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, collectMorphMeshes, detectFacingDirection, extractFromGLTF, extractModelData, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AnalyzeModelOptions, type Animation, type AnimationActionHandle, type AnimationAnalysis, type AnimationClipInfo, type AnimationInfo, type AnimationPlayOptions, 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 ClipHandle, type ClipOptions, type CompositeRotation, type CompositeRotationState, type CurvePoint, type CurvesMap, DEFAULT_HAIR_PHYSICS_CONFIG, type ExpandAnimation, type ExpandedRegionState, AU_MAPPING_CONFIG as 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$1 as 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, collectMorphMeshes, detectFacingDirection, extractFromGLTF, extractModelData, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, suggestBestPreset, validateMappingConfig, validateMappings };