@lovelace_lol/loom3 1.0.32 → 1.0.34

package/dist/index.d.cts

@@ -86,21 +86,15 @@ declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
 declare const CC4_PRESET: Profile;
 
 /**
- * Merge a base preset with a profile override.
+ * Extend a base preset with a profile extension.
  *
  * Rules:
- * - Scalars: override if provided.
- * - Maps: shallow-merged by key (override wins), values cloned.
- * - Arrays: replaced when override is provided (except annotationRegions).
- * - annotationRegions: merged by region name, shallow field merge (override wins).
+ * - Scalars: extension wins when provided.
+ * - Maps: shallow-merged by key, values cloned.
+ * - Arrays: replaced when the extension provides them (except annotationRegions).
+ * - annotationRegions: merged by region name, shallow field merge (extension wins).
  */
-declare function resolveProfile(base: Profile, override: Partial<Profile>): Profile;
-/**
- * Explicit helper for the common operation: start with a preset, then apply a
- * profile override on top. This is the preferred name at call sites where the
- * distinction between preset and profile should stay obvious.
- */
-declare function applyProfileToPreset(base: Profile, override?: Partial<Profile>): Profile;
+declare function extendPresetWithProfile(base: Profile, extension?: Partial<Profile>): Profile;
 
 declare const BETTA_FISH_PRESET: {
     bones: readonly ["Armature_rootJoint", "Bone_Armature", "Bone.001_Armature", "Bone.009_Armature", "Bone.027_Armature", "Bone.029_Armature", "Bone.031_Armature", "Bone.028_Armature", "Bone.030_Armature", "Bone.032_Armature", "Bone.010_Armature", "Bone.012_Armature", "Bone.014_Armature", "Bone.016_Armature", "Bone.011_Armature", "Bone.013_Armature", "Bone.015_Armature", "Bone.017_Armature", "Bone.002_Armature", "Bone.003_Armature", "Bone.004_Armature", "Bone.005_Armature", "Bone.020_Armature", "Bone.025_Armature", "Bone.026_Armature", "Bone.039_Armature", "Bone.040_Armature", "Bone.041_Armature", "Bone.042_Armature", "Bone.043_Armature", "Bone.044_Armature", "Bone.045_Armature", "Bone.019_Armature", "Bone.023_Armature", "Bone.024_Armature", "Bone.034_Armature", "Bone.036_Armature", "Bone.038_Armature", "Bone.018_Armature", "Bone.021_Armature", "Bone.022_Armature", "Bone.033_Armature", "Bone.035_Armature", "Bone.037_Armature", "Bone.046_Armature", "Bone.048_Armature", "Bone.050_Armature", "Bone.047_Armature", "Bone.049_Armature", "Bone.051_Armature", "Bone.006_Armature", "Bone.007_Armature", "Bone.008_Armature"];
@@ -140,6 +134,7 @@ declare const BETTA_FISH_PRESET: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 declare const AU_MAPPING_CONFIG: {
@@ -180,6 +175,7 @@ declare const AU_MAPPING_CONFIG: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 declare const FISH_AU_MAPPING_CONFIG: {
@@ -220,6 +216,7 @@ declare const FISH_AU_MAPPING_CONFIG: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 
@@ -227,7 +224,7 @@ declare const FISH_AU_MAPPING_CONFIG: {
  * Loom3 - Preset Exports
  *
  * All AU presets are exported from here.
- * Frontend passes a presetType string and loom3 resolves the preset internally.
+ * Frontend passes a presetType string and Loom3 looks up the preset internally.
  */
 
 /**
@@ -235,14 +232,14 @@ declare const FISH_AU_MAPPING_CONFIG: {
  */
 type PresetType = 'cc4' | 'skeletal' | 'fish' | 'custom';
 /**
- * Resolve a preset by type name.
+ * Get a preset by type name.
  * This allows frontend to pass a string instead of importing the full preset.
  */
-declare function resolvePreset(presetType: PresetType | string | undefined): Profile;
+declare function getPreset(presetType: PresetType | string | undefined): Profile;
 /**
- * Resolve a preset and merge optional overrides.
+ * Get a preset, then extend it with an optional profile.
  */
-declare function resolvePresetWithOverrides(presetType: PresetType | string | undefined, overrides?: Partial<Profile>): Profile;
+declare function getPresetWithProfile(presetType: PresetType | string | undefined, profile?: Partial<Profile>): Profile;
 
 /**
  * Loom3 - Core Type Definitions
@@ -673,6 +670,10 @@ interface Profile {
      * Optional: Annotation regions for camera/marker overlays.
      */
     annotationRegions?: AnnotationRegion[];
+    /**
+     * Optional: preset region names this profile explicitly disables.
+     */
+    disabledRegions?: string[];
     /**
      * Optional: Hair physics defaults for this preset/profile.
      */
@@ -1259,7 +1260,7 @@ interface ReadyPayload {
  * Configuration options for the Loom3 engine
  */
 interface LoomLargeConfig {
-    /** AU to morph target mappings (partial overrides merged via resolveProfile). */
+    /** AU to morph target mappings (partial extensions merged into the preset). */
     profile?: Partial<Profile>;
     /** Preset type to resolve if profile is not provided. */
     presetType?: PresetType | string;
@@ -1949,11 +1950,6 @@ declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile
  * 4. top-level saved `config.regions` overrides by region name
  */
 declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
-/**
- * Backward-compatible alias for older integrations. Prefer
- * `extendCharacterConfigWithPreset(...)` at new call sites.
- */
-declare function resolveCharacterConfig(config: CharacterConfig): CharacterConfig;
 
 interface ResolvedFaceCenter {
     center: THREE.Vector3;
@@ -2393,4 +2389,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 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, applyProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveCharacterConfig, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, 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 CharacterConfig, type CharacterRegistry, 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, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.d.ts

@@ -86,21 +86,15 @@ declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
 declare const CC4_PRESET: Profile;
 
 /**
- * Merge a base preset with a profile override.
+ * Extend a base preset with a profile extension.
  *
  * Rules:
- * - Scalars: override if provided.
- * - Maps: shallow-merged by key (override wins), values cloned.
- * - Arrays: replaced when override is provided (except annotationRegions).
- * - annotationRegions: merged by region name, shallow field merge (override wins).
+ * - Scalars: extension wins when provided.
+ * - Maps: shallow-merged by key, values cloned.
+ * - Arrays: replaced when the extension provides them (except annotationRegions).
+ * - annotationRegions: merged by region name, shallow field merge (extension wins).
  */
-declare function resolveProfile(base: Profile, override: Partial<Profile>): Profile;
-/**
- * Explicit helper for the common operation: start with a preset, then apply a
- * profile override on top. This is the preferred name at call sites where the
- * distinction between preset and profile should stay obvious.
- */
-declare function applyProfileToPreset(base: Profile, override?: Partial<Profile>): Profile;
+declare function extendPresetWithProfile(base: Profile, extension?: Partial<Profile>): Profile;
 
 declare const BETTA_FISH_PRESET: {
     bones: readonly ["Armature_rootJoint", "Bone_Armature", "Bone.001_Armature", "Bone.009_Armature", "Bone.027_Armature", "Bone.029_Armature", "Bone.031_Armature", "Bone.028_Armature", "Bone.030_Armature", "Bone.032_Armature", "Bone.010_Armature", "Bone.012_Armature", "Bone.014_Armature", "Bone.016_Armature", "Bone.011_Armature", "Bone.013_Armature", "Bone.015_Armature", "Bone.017_Armature", "Bone.002_Armature", "Bone.003_Armature", "Bone.004_Armature", "Bone.005_Armature", "Bone.020_Armature", "Bone.025_Armature", "Bone.026_Armature", "Bone.039_Armature", "Bone.040_Armature", "Bone.041_Armature", "Bone.042_Armature", "Bone.043_Armature", "Bone.044_Armature", "Bone.045_Armature", "Bone.019_Armature", "Bone.023_Armature", "Bone.024_Armature", "Bone.034_Armature", "Bone.036_Armature", "Bone.038_Armature", "Bone.018_Armature", "Bone.021_Armature", "Bone.022_Armature", "Bone.033_Armature", "Bone.035_Armature", "Bone.037_Armature", "Bone.046_Armature", "Bone.048_Armature", "Bone.050_Armature", "Bone.047_Armature", "Bone.049_Armature", "Bone.051_Armature", "Bone.006_Armature", "Bone.007_Armature", "Bone.008_Armature"];
@@ -140,6 +134,7 @@ declare const BETTA_FISH_PRESET: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 declare const AU_MAPPING_CONFIG: {
@@ -180,6 +175,7 @@ declare const AU_MAPPING_CONFIG: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 declare const FISH_AU_MAPPING_CONFIG: {
@@ -220,6 +216,7 @@ declare const FISH_AU_MAPPING_CONFIG: {
     }>;
     continuumLabels?: Record<string, string>;
     annotationRegions?: AnnotationRegion[];
+    disabledRegions?: string[];
     hairPhysics?: HairPhysicsProfileConfig;
 };
 
@@ -227,7 +224,7 @@ declare const FISH_AU_MAPPING_CONFIG: {
  * Loom3 - Preset Exports
  *
  * All AU presets are exported from here.
- * Frontend passes a presetType string and loom3 resolves the preset internally.
+ * Frontend passes a presetType string and Loom3 looks up the preset internally.
  */
 
 /**
@@ -235,14 +232,14 @@ declare const FISH_AU_MAPPING_CONFIG: {
  */
 type PresetType = 'cc4' | 'skeletal' | 'fish' | 'custom';
 /**
- * Resolve a preset by type name.
+ * Get a preset by type name.
  * This allows frontend to pass a string instead of importing the full preset.
  */
-declare function resolvePreset(presetType: PresetType | string | undefined): Profile;
+declare function getPreset(presetType: PresetType | string | undefined): Profile;
 /**
- * Resolve a preset and merge optional overrides.
+ * Get a preset, then extend it with an optional profile.
  */
-declare function resolvePresetWithOverrides(presetType: PresetType | string | undefined, overrides?: Partial<Profile>): Profile;
+declare function getPresetWithProfile(presetType: PresetType | string | undefined, profile?: Partial<Profile>): Profile;
 
 /**
  * Loom3 - Core Type Definitions
@@ -673,6 +670,10 @@ interface Profile {
      * Optional: Annotation regions for camera/marker overlays.
      */
     annotationRegions?: AnnotationRegion[];
+    /**
+     * Optional: preset region names this profile explicitly disables.
+     */
+    disabledRegions?: string[];
     /**
      * Optional: Hair physics defaults for this preset/profile.
      */
@@ -1259,7 +1260,7 @@ interface ReadyPayload {
  * Configuration options for the Loom3 engine
  */
 interface LoomLargeConfig {
-    /** AU to morph target mappings (partial overrides merged via resolveProfile). */
+    /** AU to morph target mappings (partial extensions merged into the preset). */
     profile?: Partial<Profile>;
     /** Preset type to resolve if profile is not provided. */
     presetType?: PresetType | string;
@@ -1949,11 +1950,6 @@ declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile
  * 4. top-level saved `config.regions` overrides by region name
  */
 declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
-/**
- * Backward-compatible alias for older integrations. Prefer
- * `extendCharacterConfigWithPreset(...)` at new call sites.
- */
-declare function resolveCharacterConfig(config: CharacterConfig): CharacterConfig;
 
 interface ResolvedFaceCenter {
     center: THREE.Vector3;
@@ -2393,4 +2389,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 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, applyProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveCharacterConfig, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, 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 CharacterConfig, type CharacterRegistry, 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, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.js

@@ -2879,7 +2879,7 @@ var HairPhysicsController = class {
   }
 };
 
-// src/mappings/resolveProfile.ts
+// src/mappings/extendPresetWithProfile.ts
 var isPlainObject = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -2971,31 +2971,33 @@ var mergeHairPhysicsConfig = (base, override) => {
   }
   return merged;
 };
-function resolveProfile(base, override) {
+function extendPresetWithProfile(base, extension) {
+  if (!extension) {
+    return base;
+  }
+  const disabledRegions = extension.disabledRegions ? [...extension.disabledRegions] : base.disabledRegions ? [...base.disabledRegions] : void 0;
   return {
     ...base,
-    ...override,
-    auToMorphs: mergeRecord(base.auToMorphs, override.auToMorphs),
-    auToBones: mergeRecord(base.auToBones, override.auToBones),
-    boneNodes: mergeRecord(base.boneNodes, override.boneNodes),
-    morphToMesh: mergeRecord(base.morphToMesh, override.morphToMesh),
-    auFacePartToMeshCategory: base.auFacePartToMeshCategory || override.auFacePartToMeshCategory ? mergeRecord(base.auFacePartToMeshCategory || {}, override.auFacePartToMeshCategory || {}) : void 0,
-    visemeKeys: override.visemeKeys ? [...override.visemeKeys] : [...base.visemeKeys],
-    visemeMeshCategory: override.visemeMeshCategory ?? base.visemeMeshCategory,
-    auMixDefaults: base.auMixDefaults || override.auMixDefaults ? mergeRecord(base.auMixDefaults || {}, override.auMixDefaults || {}) : void 0,
-    auInfo: base.auInfo || override.auInfo ? mergeRecord(base.auInfo || {}, override.auInfo || {}) : void 0,
-    eyeMeshNodes: override.eyeMeshNodes ?? base.eyeMeshNodes,
-    compositeRotations: override.compositeRotations ?? base.compositeRotations,
-    meshes: base.meshes || override.meshes ? mergeRecord(base.meshes || {}, override.meshes || {}) : void 0,
-    continuumPairs: base.continuumPairs || override.continuumPairs ? mergeRecord(base.continuumPairs || {}, override.continuumPairs || {}) : void 0,
-    continuumLabels: base.continuumLabels || override.continuumLabels ? mergeRecord(base.continuumLabels || {}, override.continuumLabels || {}) : void 0,
-    annotationRegions: mergeAnnotationRegions(base.annotationRegions, override.annotationRegions),
-    hairPhysics: mergeHairPhysicsConfig(base.hairPhysics, override.hairPhysics)
+    ...extension,
+    auToMorphs: mergeRecord(base.auToMorphs, extension.auToMorphs),
+    auToBones: mergeRecord(base.auToBones, extension.auToBones),
+    boneNodes: mergeRecord(base.boneNodes, extension.boneNodes),
+    morphToMesh: mergeRecord(base.morphToMesh, extension.morphToMesh),
+    auFacePartToMeshCategory: base.auFacePartToMeshCategory || extension.auFacePartToMeshCategory ? mergeRecord(base.auFacePartToMeshCategory || {}, extension.auFacePartToMeshCategory || {}) : void 0,
+    visemeKeys: extension.visemeKeys ? [...extension.visemeKeys] : [...base.visemeKeys],
+    visemeMeshCategory: extension.visemeMeshCategory ?? base.visemeMeshCategory,
+    auMixDefaults: base.auMixDefaults || extension.auMixDefaults ? mergeRecord(base.auMixDefaults || {}, extension.auMixDefaults || {}) : void 0,
+    auInfo: base.auInfo || extension.auInfo ? mergeRecord(base.auInfo || {}, extension.auInfo || {}) : void 0,
+    eyeMeshNodes: extension.eyeMeshNodes ?? base.eyeMeshNodes,
+    compositeRotations: extension.compositeRotations ?? base.compositeRotations,
+    meshes: base.meshes || extension.meshes ? mergeRecord(base.meshes || {}, extension.meshes || {}) : void 0,
+    continuumPairs: base.continuumPairs || extension.continuumPairs ? mergeRecord(base.continuumPairs || {}, extension.continuumPairs || {}) : void 0,
+    continuumLabels: base.continuumLabels || extension.continuumLabels ? mergeRecord(base.continuumLabels || {}, extension.continuumLabels || {}) : void 0,
+    annotationRegions: mergeAnnotationRegions(base.annotationRegions, extension.annotationRegions),
+    disabledRegions,
+    hairPhysics: mergeHairPhysicsConfig(base.hairPhysics, extension.hairPhysics)
   };
 }
-function applyProfileToPreset(base, override) {
-  return override ? resolveProfile(base, override) : base;
-}
 
 // src/presets/bettaFish.ts
 var BONES = [
@@ -3782,22 +3784,24 @@ var ANNOTATION_REGIONS = [
     name: "gills",
     bones: ["GILL_L", "GILL_R"],
     paddingFactor: 1.6,
-    children: ["throat", "gill"],
+    children: ["gill_left", "gill_right"],
     expandAnimation: "outward"
   },
   {
-    name: "throat",
+    name: "gill_left",
     bones: ["GILL_L", "GILL_L_MID", "GILL_L_TIP"],
     parent: "gills",
     paddingFactor: 1.4,
-    cameraAngle: 270
+    cameraAngle: 270,
+    style: { lineDirection: "left" }
   },
   {
-    name: "gill",
+    name: "gill_right",
     bones: ["GILL_R", "GILL_R_MID", "GILL_R_TIP"],
     parent: "gills",
     paddingFactor: 1.4,
-    cameraAngle: 90
+    cameraAngle: 90,
+    style: { lineDirection: "right" }
   }
 ];
 var BETTA_FISH_PROFILE = {
@@ -3834,7 +3838,7 @@ var AU_MAPPING_CONFIG = BETTA_FISH_PRESET;
 var FISH_AU_MAPPING_CONFIG = BETTA_FISH_PRESET;
 
 // src/presets/index.ts
-function resolvePreset(presetType) {
+function getPreset(presetType) {
   switch (presetType) {
     case "fish":
     case "skeletal":
@@ -3845,9 +3849,8 @@ function resolvePreset(presetType) {
       return CC4_PRESET;
   }
 }
-function resolvePresetWithOverrides(presetType, overrides) {
-  const base = resolvePreset(presetType);
-  return applyProfileToPreset(base, overrides);
+function getPresetWithProfile(presetType, profile) {
+  return extendPresetWithProfile(getPreset(presetType), profile);
 }
 
 // src/engines/three/Loom3.ts
@@ -3923,8 +3926,8 @@ var _Loom3 = class _Loom3 {
     __publicField(this, "isRunning", false);
     /** Store original emissive colors for highlight reset */
     __publicField(this, "originalEmissive", /* @__PURE__ */ new Map());
-    const basePreset = config.presetType ? resolvePreset(config.presetType) : CC4_PRESET;
-    this.config = applyProfileToPreset(basePreset, config.profile);
+    const basePreset = config.presetType ? getPreset(config.presetType) : CC4_PRESET;
+    this.config = extendPresetWithProfile(basePreset, config.profile);
     this.mixWeights = { ...this.config.auMixDefaults };
     this.animation = animation || new AnimationThree();
     this.compositeRotations = this.config.compositeRotations || COMPOSITE_ROTATIONS;
@@ -5333,7 +5336,30 @@ var BLENDING_MODES = {
   // THREE.NoBlending
 };
 
-// src/characters/resolveCharacterConfig.ts
+// src/regions/normalizeRegionTree.ts
+function normalizeDisabledNames(disabledNames) {
+  return new Set((disabledNames ?? []).filter((name) => Boolean(name)));
+}
+function normalizeRegionTree(regions, disabledNames) {
+  if (!regions) return void 0;
+  const disabled = normalizeDisabledNames(disabledNames);
+  const nextRegions = regions.filter((region) => !disabled.has(region.name)).map((region) => ({
+    ...region,
+    children: region.children ? [...region.children] : void 0
+  }));
+  const remainingNames = new Set(nextRegions.map((region) => region.name));
+  return nextRegions.map((region) => {
+    const nextChildren = region.children?.filter((child) => remainingNames.has(child));
+    const nextParent = region.parent && remainingNames.has(region.parent) ? region.parent : void 0;
+    return {
+      ...region,
+      parent: nextParent,
+      children: nextChildren && nextChildren.length > 0 ? nextChildren : void 0
+    };
+  });
+}
+
+// src/characters/extendCharacterConfigWithPreset.ts
 var PROFILE_OVERRIDE_KEYS = [
   "name",
   "animalType",
@@ -5361,6 +5387,7 @@ var PROFILE_OVERRIDE_KEYS = [
   "continuumPairs",
   "continuumLabels",
   "annotationRegions",
+  "disabledRegions",
   "hairPhysics"
 ];
 function isPlainObject2(value) {
@@ -5479,11 +5506,11 @@ function applyCharacterProfileToPreset(config) {
   if (!presetType) {
     return null;
   }
-  return applyProfileToPreset(resolvePreset(presetType), extractProfileOverrides(config));
+  return extendPresetWithProfile(getPreset(presetType), extractProfileOverrides(config));
 }
-function orderResolvedRegions(resolvedRegions, prioritizedLists) {
-  if (!resolvedRegions) return void 0;
-  const resolvedByName = new Map(resolvedRegions.map((region) => [region.name, region]));
+function orderExtendedRegions(extendedRegions, prioritizedLists) {
+  if (!extendedRegions) return void 0;
+  const extendedByName = new Map(extendedRegions.map((region) => [region.name, region]));
   const orderedNames = [];
   const seen = /* @__PURE__ */ new Set();
   for (const regions of prioritizedLists) {
@@ -5493,12 +5520,12 @@ function orderResolvedRegions(resolvedRegions, prioritizedLists) {
       orderedNames.push(region.name);
     }
   }
-  for (const region of resolvedRegions) {
+  for (const region of extendedRegions) {
     if (seen.has(region.name)) continue;
     seen.add(region.name);
     orderedNames.push(region.name);
   }
-  return orderedNames.map((name) => resolvedByName.get(name)).filter((region) => Boolean(region));
+  return orderedNames.map((name) => extendedByName.get(name)).filter((region) => Boolean(region));
 }
 function extendCharacterConfigWithPreset(config) {
   const presetType = config.auPresetType;
@@ -5506,25 +5533,26 @@ function extendCharacterConfigWithPreset(config) {
     return config;
   }
   const profileOverrides = extractProfileOverrides(config);
-  const presetResolvedProfile = applyCharacterProfileToPreset(config);
-  if (!presetResolvedProfile) {
+  const extendedPresetProfile = applyCharacterProfileToPreset(config);
+  if (!extendedPresetProfile) {
     return config;
   }
-  const presetRegions = presetResolvedProfile.annotationRegions;
+  const presetRegions = extendedPresetProfile.annotationRegions;
   const mergedRegions = mergeRegionsByName(presetRegions, config.regions);
-  const resolvedRegions = orderResolvedRegions(
+  const normalizedRegions = normalizeRegionTree(
     mergedRegions,
+    profileOverrides.disabledRegions
+  );
+  const extendedRegions = orderExtendedRegions(
+    normalizedRegions,
     [config.regions, profileOverrides.annotationRegions, presetRegions]
   );
   return {
     ...config,
-    ...presetResolvedProfile,
-    regions: resolvedRegions ?? config.regions
+    ...extendedPresetProfile,
+    regions: extendedRegions ?? config.regions
   };
 }
-function resolveCharacterConfig(config) {
-  return extendCharacterConfigWithPreset(config);
-}
 var DEFAULT_HEAD_BONE_NAMES = ["CC_Base_Head", "Head", "head", "Bip01_Head"];
 var DEFAULT_REFERENCE_HEIGHT = 1.8;
 var DEFAULT_FORWARD_OFFSET = 0.08;
@@ -6843,6 +6871,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, applyProfileToPreset, collectMorphMeshes, detectFacingDirection, extendCharacterConfigWithPreset, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveCharacterConfig, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveProfile, 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, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, suggestBestPreset, validateMappingConfig, validateMappings };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map