@lovelace_lol/loom3 1.0.28 → 1.0.30

package/dist/index.d.cts

@@ -61,6 +61,16 @@ declare const CC4_BONE_NODES: {
     readonly NECK_TWIST: "NeckTwist02";
     readonly JAW: "JawRoot";
     readonly TONGUE: "Tongue01";
+    readonly SPINE_01: "Spine01";
+    readonly SPINE_02: "Spine02";
+    readonly CLAVICLE_L: "L_Clavicle";
+    readonly CLAVICLE_R: "R_Clavicle";
+    readonly HAND_L: "L_Hand";
+    readonly HAND_R: "R_Hand";
+    readonly FOOT_L: "L_Foot";
+    readonly FOOT_R: "R_Foot";
+    readonly TOEBASE_L: "L_ToeBase";
+    readonly TOEBASE_R: "R_ToeBase";
 };
 declare const CC4_EYE_MESH_NODES: {
     readonly LEFT: "CC_Base_Eye";
@@ -740,7 +750,6 @@ interface AnnotationRegion {
     parent?: string;
     children?: string[];
     expandAnimation?: 'outward' | 'staggered';
-    showChildConnections?: boolean;
     style?: {
         markerColor?: number;
         markerRadius?: number;
@@ -1842,8 +1851,6 @@ interface Region {
     children?: string[];
     /** Animation style for expand/collapse. Default: 'outward' */
     expandAnimation?: ExpandAnimation;
-    /** Show connecting lines to children when expanded. Default: true */
-    showChildConnections?: boolean;
     /** Per-marker style overrides */
     style?: MarkerStyleOverrides;
     /** Marker group ID for fallback behavior */
@@ -1932,15 +1939,19 @@ declare function mergeRegionsByName(base?: Region[], override?: Region[]): Regio
 declare function extractProfileOverrides(config: CharacterConfig): Partial<Profile>;
 declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile | null;
 /**
- * Resolve a saved character config into the runtime shape DPthree and similar
- * tools should consume.
+ * Extend a saved character config with its selected preset so callers get one
+ * canonical runtime object.
  *
  * Precedence:
  * 1. preset defaults
  * 2. flattened top-level profile overrides
  * 3. legacy nested `config.profile` overrides (compatibility only)
  * 4. top-level saved `config.regions` overrides by region name
- * 5. top-level saved bone naming fields remain compatibility overrides
+ */
+declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
+/**
+ * Backward-compatible alias for older integrations. Prefer
+ * `extendCharacterConfigWithPreset(...)` at new call sites.
  */
 declare function resolveCharacterConfig(config: CharacterConfig): CharacterConfig;
 
@@ -2382,4 +2393,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, 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, 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 };

package/dist/index.d.ts

@@ -61,6 +61,16 @@ declare const CC4_BONE_NODES: {
     readonly NECK_TWIST: "NeckTwist02";
     readonly JAW: "JawRoot";
     readonly TONGUE: "Tongue01";
+    readonly SPINE_01: "Spine01";
+    readonly SPINE_02: "Spine02";
+    readonly CLAVICLE_L: "L_Clavicle";
+    readonly CLAVICLE_R: "R_Clavicle";
+    readonly HAND_L: "L_Hand";
+    readonly HAND_R: "R_Hand";
+    readonly FOOT_L: "L_Foot";
+    readonly FOOT_R: "R_Foot";
+    readonly TOEBASE_L: "L_ToeBase";
+    readonly TOEBASE_R: "R_ToeBase";
 };
 declare const CC4_EYE_MESH_NODES: {
     readonly LEFT: "CC_Base_Eye";
@@ -740,7 +750,6 @@ interface AnnotationRegion {
     parent?: string;
     children?: string[];
     expandAnimation?: 'outward' | 'staggered';
-    showChildConnections?: boolean;
     style?: {
         markerColor?: number;
         markerRadius?: number;
@@ -1842,8 +1851,6 @@ interface Region {
     children?: string[];
     /** Animation style for expand/collapse. Default: 'outward' */
     expandAnimation?: ExpandAnimation;
-    /** Show connecting lines to children when expanded. Default: true */
-    showChildConnections?: boolean;
     /** Per-marker style overrides */
     style?: MarkerStyleOverrides;
     /** Marker group ID for fallback behavior */
@@ -1932,15 +1939,19 @@ declare function mergeRegionsByName(base?: Region[], override?: Region[]): Regio
 declare function extractProfileOverrides(config: CharacterConfig): Partial<Profile>;
 declare function applyCharacterProfileToPreset(config: CharacterConfig): Profile | null;
 /**
- * Resolve a saved character config into the runtime shape DPthree and similar
- * tools should consume.
+ * Extend a saved character config with its selected preset so callers get one
+ * canonical runtime object.
  *
  * Precedence:
  * 1. preset defaults
  * 2. flattened top-level profile overrides
  * 3. legacy nested `config.profile` overrides (compatibility only)
  * 4. top-level saved `config.regions` overrides by region name
- * 5. top-level saved bone naming fields remain compatibility overrides
+ */
+declare function extendCharacterConfigWithPreset(config: CharacterConfig): CharacterConfig;
+/**
+ * Backward-compatible alias for older integrations. Prefer
+ * `extendCharacterConfigWithPreset(...)` at new call sites.
  */
 declare function resolveCharacterConfig(config: CharacterConfig): CharacterConfig;
 
@@ -2382,4 +2393,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, 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, 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 };

package/dist/index.js

@@ -1866,7 +1866,17 @@ var CC4_BONE_NODES = {
   NECK: "NeckTwist01",
   NECK_TWIST: "NeckTwist02",
   JAW: "JawRoot",
-  TONGUE: "Tongue01"
+  TONGUE: "Tongue01",
+  SPINE_01: "Spine01",
+  SPINE_02: "Spine02",
+  CLAVICLE_L: "L_Clavicle",
+  CLAVICLE_R: "R_Clavicle",
+  HAND_L: "L_Hand",
+  HAND_R: "R_Hand",
+  FOOT_L: "L_Foot",
+  FOOT_R: "R_Foot",
+  TOEBASE_L: "L_ToeBase",
+  TOEBASE_R: "R_ToeBase"
 };
 var CC4_EYE_MESH_NODES = {
   LEFT: "CC_Base_Eye",
@@ -2104,74 +2114,73 @@ var CC4_PRESET = {
     },
     {
       name: "head",
-      bones: ["CC_Base_Head", "CC_Base_JawRoot"],
+      bones: ["HEAD", "JAW"],
       paddingFactor: 1.5,
       children: ["face", "left_eye", "right_eye", "mouth"],
-      expandAnimation: "staggered",
-      showChildConnections: true
+      expandAnimation: "staggered"
     },
     {
       name: "face",
-      bones: ["CC_Base_Head"],
+      bones: ["HEAD"],
       // meshes: populated by user selection in wizard - varies per character
       paddingFactor: 1.3,
       parent: "head"
     },
     {
       name: "left_eye",
-      bones: ["CC_Base_L_Eye"],
+      bones: ["EYE_L"],
       paddingFactor: 0.9,
       parent: "head"
     },
     {
       name: "right_eye",
-      bones: ["CC_Base_R_Eye"],
+      bones: ["EYE_R"],
       paddingFactor: 0.9,
       parent: "head"
     },
     {
       name: "mouth",
-      bones: ["CC_Base_JawRoot"],
+      bones: ["JAW"],
       paddingFactor: 1.5,
       parent: "head"
     },
     {
       name: "upper_body",
       bones: [
-        "CC_Base_Spine02",
-        "CC_Base_Head",
-        "CC_Base_L_Clavicle",
-        "CC_Base_R_Clavicle"
+        "SPINE_02",
+        "HEAD",
+        "CLAVICLE_L",
+        "CLAVICLE_R"
       ],
       paddingFactor: 1.6
     },
     {
       name: "back",
-      bones: ["CC_Base_Spine01", "CC_Base_Spine02"],
+      bones: ["SPINE_01", "SPINE_02"],
       paddingFactor: 1.8,
       cameraAngle: 180
     },
     {
       name: "left_hand",
-      bones: ["CC_Base_L_Hand"],
+      bones: ["HAND_L"],
       paddingFactor: 1.3,
       cameraAngle: 270
     },
     {
       name: "right_hand",
-      bones: ["CC_Base_R_Hand"],
+      bones: ["HAND_R"],
       paddingFactor: 1.3,
       cameraAngle: 90
     },
     {
       name: "left_foot",
-      bones: ["CC_Base_L_Foot", "CC_Base_L_ToeBase"],
+      bones: ["FOOT_L", "TOEBASE_L"],
       paddingFactor: 2.5,
       cameraAngle: 270
     },
     {
       name: "right_foot",
-      bones: ["CC_Base_R_Foot", "CC_Base_R_ToeBase"],
+      bones: ["FOOT_R", "TOEBASE_R"],
       paddingFactor: 2.5,
       cameraAngle: 90
     }
@@ -5426,13 +5435,6 @@ function mergeRegion(base, override) {
     } : void 0
   };
 }
-function mergeStringRecord(base, override) {
-  if (!base && !override) return void 0;
-  return {
-    ...base ? { ...base } : {},
-    ...override ? { ...override } : {}
-  };
-}
 function mergeRegionsByName(base, override) {
   if (!base && !override) return void 0;
   const merged = /* @__PURE__ */ new Map();
@@ -5498,7 +5500,7 @@ function orderResolvedRegions(resolvedRegions, prioritizedLists) {
   }
   return orderedNames.map((name) => resolvedByName.get(name)).filter((region) => Boolean(region));
 }
-function resolveCharacterConfig(config) {
+function extendCharacterConfigWithPreset(config) {
   const presetType = config.auPresetType;
   if (!presetType || presetType === "custom") {
     return config;
@@ -5516,13 +5518,13 @@ function resolveCharacterConfig(config) {
   );
   return {
     ...config,
-    bonePrefix: config.bonePrefix ?? presetResolvedProfile.bonePrefix,
-    boneSuffix: config.boneSuffix ?? presetResolvedProfile.boneSuffix,
-    boneNodes: mergeStringRecord(presetResolvedProfile.boneNodes, config.boneNodes),
-    suffixPattern: config.suffixPattern ?? presetResolvedProfile.suffixPattern,
+    ...presetResolvedProfile,
     regions: resolvedRegions ?? 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;
@@ -5710,23 +5712,32 @@ function detectFacingDirection(model, eyeBoneNames = {
 function normalizeLooseName(value) {
   return value.replace(/\./g, "");
 }
-function resolveBoneName(semanticName, config) {
-  if (!config) return semanticName;
+function resolveBoneNameCandidates(semanticName, config) {
+  if (!config) return [semanticName];
   const { bonePrefix, boneSuffix, boneNodes } = config;
   if (!boneNodes || !boneNodes[semanticName]) {
-    return semanticName;
+    return [semanticName];
   }
   const baseName = boneNodes[semanticName];
-  if (baseName.includes("_") || baseName.includes(".")) {
-    return baseName;
-  }
   const prefix = bonePrefix || "";
   const suffix = boneSuffix || "";
-  return prefix + baseName + suffix;
+  if (!prefix && !suffix) {
+    return [baseName];
+  }
+  const prefixedBase = prefix && baseName.startsWith(prefix) ? baseName : prefix + baseName;
+  const fullyAffixed = suffix && !prefixedBase.endsWith(suffix) ? `${prefixedBase}${suffix}` : prefixedBase;
+  return Array.from(/* @__PURE__ */ new Set([fullyAffixed, baseName]));
+}
+function resolveBoneName(semanticName, config) {
+  return resolveBoneNameCandidates(semanticName, config)[0] ?? semanticName;
 }
 function resolveBoneNames(names, config) {
   if (!names || names.length === 0) return [];
-  return names.map((name) => resolveBoneName(name, config));
+  return Array.from(
+    new Set(
+      names.flatMap((name) => resolveBoneNameCandidates(name, config))
+    )
+  );
 }
 function fuzzyNameMatch(objectName, targetName, suffixPattern) {
   if (objectName === targetName) return true;
@@ -6832,6 +6843,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, 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, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map