@lovelace_lol/loom3 1.0.44 → 1.0.45

package/README.md

@@ -350,15 +350,20 @@ const loom = new Loom3({
 
 `annotationRegions` is the Loom3 field for camera/marker region defaults and profile overrides.
 
-If your app fetches a full saved `CharacterConfig` from Firestore or another backend, use `extendCharacterConfigWithPreset(...)` to build the runtime shape before handing that config to camera/marker tooling:
+If your app fetches a saved model/profile record from Firestore or another backend, use `extendProfileConfigWithPreset(...)` to build the runtime shape before handing that profile config to camera/marker tooling:
 
 ```typescript
-import { extendCharacterConfigWithPreset } from '@lovelace_lol/loom3';
+import { extendProfileConfigWithPreset } from '@lovelace_lol/loom3';
 
-const savedConfig = await fetchCharacterConfig();
-const runtimeConfig = extendCharacterConfigWithPreset(savedConfig);
+const savedConfig = await fetchProfileConfig();
+const runtimeConfig = extendProfileConfigWithPreset({
+  ...savedConfig,
+  profilePresetId: savedConfig.profilePresetId ?? 'cc4',
+});
 ```
 
+`CharacterConfig`, `auPresetType`, and `extendCharacterConfigWithPreset(...)` are still exported as deprecated compatibility aliases for apps migrating from older LoomLarge-style character records. New Loom3 integrations should model presets as base profiles, pass profile overrides through `profile`, `annotationRegions`, or other `Profile` fields, and use `profilePresetId` for preset selection.
+
 For the current runtime-oriented documentation, including:
 
 - `paddingFactor`
@@ -2091,7 +2096,7 @@ console.log(result.center, result.method, result.debugInfo);
 ### Resolving region-driven centers
 
 ```typescript
-import type { CharacterConfig, Region } from '@lovelace_lol/loom3';
+import type { BoneResolutionProfile, Region } from '@lovelace_lol/loom3';
 import { resolveBoneName, resolveBoneNames, resolveFaceCenter } from '@lovelace_lol/loom3';
 
 const region: Region = {
@@ -2100,18 +2105,14 @@ const region: Region = {
   meshes: ['CC_Base_Body'],
 };
 
-const config = {
-  characterId: 'demo',
-  characterName: 'Demo',
-  modelPath: '/demo.glb',
-  regions: [region],
+const profile: BoneResolutionProfile = {
   bonePrefix: 'CC_Base_',
   boneNodes: { HEAD: 'Head' },
-} satisfies CharacterConfig;
+};
 
-const headBone = resolveBoneName('HEAD', config);
-const resolvedBones = resolveBoneNames(['HEAD'], config);
-const faceCenter = resolveFaceCenter(gltf.scene, region, config);
+const headBone = resolveBoneName('HEAD', profile);
+const resolvedBones = resolveBoneNames(['HEAD'], profile);
+const faceCenter = resolveFaceCenter(gltf.scene, region, profile);
 ```
 
 ### Working with model orientation
@@ -2128,7 +2129,7 @@ const facing = detectFacingDirection(gltf.scene);
 
 Use these helpers when you need to:
 - place annotation markers using semantic regions instead of hard-coded coordinates
-- resolve prefixed/suffixed bone names from a reusable character config
+- resolve prefixed/suffixed bone names from a reusable profile or minimal bone-resolution object
 - derive a face anchor for camera tooling or interaction layers
 - reason about model orientation before building your own camera or annotation system
 

package/dist/index.cjs

@@ -7032,7 +7032,7 @@ function normalizeRegionTree(regions, disabledNames) {
   });
 }
 
-// src/characters/extendCharacterConfigWithPreset.ts
+// src/profiles/resolveProfileConfig.ts
 var PROFILE_OVERRIDE_KEYS = [
   "name",
   "animalType",
@@ -7139,7 +7139,7 @@ function mergeRegion(base, override) {
     } : void 0
   };
 }
-function mergeRegionsByName(base, override) {
+function mergeProfileRegionsByName(base, override) {
   if (!base && !override) return void 0;
   const merged = /* @__PURE__ */ new Map();
   for (const region of base ?? []) {
@@ -7154,6 +7154,10 @@ function mergeRegionsByName(base, override) {
 function getAnnotationRegions(value) {
   return Array.isArray(value) ? value : void 0;
 }
+var mergeRegionsByName = mergeProfileRegionsByName;
+function getProfilePresetId(config) {
+  return config.profilePresetId ?? config.presetId ?? config.baseProfileId ?? config.auPresetType;
+}
 function getLegacyNestedOverrides(config) {
   return isPlainObject2(config.profile) ? config.profile : {};
 }
@@ -7161,12 +7165,12 @@ function getLegacyRuntimeRegions(config) {
   return Array.isArray(config.regions) && config.regions.length > 0 ? config.regions : void 0;
 }
 function getCanonicalAnnotationOverrides(config) {
-  return mergeRegionsByName(
+  return mergeProfileRegionsByName(
     getAnnotationRegions(getLegacyNestedOverrides(config).annotationRegions),
     getAnnotationRegions(config.annotationRegions)
   );
 }
-function extractProfileOverrides(config) {
+function extractLegacyCharacterProfileOverrides(config) {
   const topLevelConfig = config;
   const legacyNestedOverrides = getLegacyNestedOverrides(config);
   const canonicalAnnotationOverrides = getCanonicalAnnotationOverrides(config);
@@ -7189,12 +7193,18 @@ function extractProfileOverrides(config) {
   }
   return overrides;
 }
-function applyCharacterProfileToPreset(config) {
-  const presetType = config.auPresetType;
+function extractProfileOverrides(config) {
+  return extractLegacyCharacterProfileOverrides(config);
+}
+function resolveProfileFromPreset(config) {
+  const presetType = getProfilePresetId(config);
   if (!presetType) {
     return null;
   }
-  return extendPresetWithProfile(getPreset(presetType), extractProfileOverrides(config));
+  return extendPresetWithProfile(getPreset(presetType), extractLegacyCharacterProfileOverrides(config));
+}
+function applyCharacterProfileToPreset(config) {
+  return resolveProfileFromPreset(config);
 }
 function orderExtendedRegions(extendedRegions, prioritizedLists) {
   if (!extendedRegions) return void 0;
@@ -7215,15 +7225,15 @@ function orderExtendedRegions(extendedRegions, prioritizedLists) {
   }
   return orderedNames.map((name) => extendedByName.get(name)).filter((region) => Boolean(region));
 }
-function extendCharacterConfigWithPreset(config) {
-  const presetType = config.auPresetType;
+function extendProfileConfigWithPreset(config) {
+  const presetType = getProfilePresetId(config);
   if (!presetType || presetType === "custom") {
     return config;
   }
   const canonicalAnnotationOverrides = getCanonicalAnnotationOverrides(config);
   const legacyRuntimeRegions = getLegacyRuntimeRegions(config);
-  const profileOverrides = extractProfileOverrides(config);
-  const extendedPresetProfile = applyCharacterProfileToPreset(config);
+  const profileOverrides = extractLegacyCharacterProfileOverrides(config);
+  const extendedPresetProfile = resolveProfileFromPreset(config);
   if (!extendedPresetProfile) {
     return config;
   }
@@ -7237,7 +7247,7 @@ function extendCharacterConfigWithPreset(config) {
   const extendedRegionNames = new Set((extendedAnnotationRegions ?? []).map((region) => region.name));
   const legacyExtraRegions = canonicalAnnotationOverrides && legacyRuntimeRegions ? legacyRuntimeRegions.filter((region) => !presetRegionNames.has(region.name) && !extendedRegionNames.has(region.name)).map((region) => cloneRegion(region)) : void 0;
   const mergedRegions = normalizeRegionTree(
-    mergeRegionsByName(extendedAnnotationRegions, legacyExtraRegions),
+    mergeProfileRegionsByName(extendedAnnotationRegions, legacyExtraRegions),
     profileOverrides.disabledRegions
   );
   const extendedRegions = orderExtendedRegions(
@@ -7251,6 +7261,9 @@ function extendCharacterConfigWithPreset(config) {
     regions: extendedRegions ?? config.regions
   };
 }
+function extendCharacterConfigWithPreset(config) {
+  return extendProfileConfigWithPreset(config);
+}
 var DEFAULT_EPSILON = 1e-4;
 var DEFAULT_YAW_WEIGHT = 0.35;
 var DEFAULT_PITCH_WEIGHT = 0.2;
@@ -7475,9 +7488,9 @@ function detectFacingDirection(model, eyeBoneNames = {
 function normalizeLooseName(value) {
   return value.replace(/\./g, "");
 }
-function resolveBoneNameCandidates(semanticName, config) {
-  if (!config) return [semanticName];
-  const { bonePrefix, boneSuffix, boneNodes } = config;
+function resolveBoneNameCandidates(semanticName, profile) {
+  if (!profile) return [semanticName];
+  const { bonePrefix, boneSuffix, boneNodes } = profile;
   if (!boneNodes || !boneNodes[semanticName]) {
     return [semanticName];
   }
@@ -7491,14 +7504,14 @@ function resolveBoneNameCandidates(semanticName, config) {
   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 resolveBoneName(semanticName, profile) {
+  return resolveBoneNameCandidates(semanticName, profile)[0] ?? semanticName;
 }
-function resolveBoneNames(names, config) {
+function resolveBoneNames(names, profile) {
   if (!names || names.length === 0) return [];
   return Array.from(
     new Set(
-      names.flatMap((name) => resolveBoneNameCandidates(name, config))
+      names.flatMap((name) => resolveBoneNameCandidates(name, profile))
     )
   );
 }
@@ -7511,8 +7524,8 @@ function fuzzyNameMatch(objectName, targetName, suffixPattern) {
   const regex = suffixPattern ? new RegExp(suffixPattern) : /^[_\.]\d+$/;
   return regex.test(suffix);
 }
-function resolveFaceCenter(model, region, config) {
-  const resolvedBones = resolveBoneNames(region.bones, config);
+function resolveFaceCenter(model, region, profile) {
+  const resolvedBones = resolveBoneNames(region.bones, profile);
   const headBoneNames = resolvedBones.filter((name) => name.toLowerCase().includes("head"));
   const result = findFaceCenter(model, {
     headBoneNames: headBoneNames.length > 0 ? headBoneNames : void 0,
@@ -8671,7 +8684,9 @@ exports.computeCameraRelativeGazeOffset = computeCameraRelativeGazeOffset;
 exports.detectFacingDirection = detectFacingDirection;
 exports.extendCharacterConfigWithPreset = extendCharacterConfigWithPreset;
 exports.extendPresetWithProfile = extendPresetWithProfile;
+exports.extendProfileConfigWithPreset = extendProfileConfigWithPreset;
 exports.extractFromGLTF = extractFromGLTF;
+exports.extractLegacyCharacterProfileOverrides = extractLegacyCharacterProfileOverrides;
 exports.extractModelData = extractModelData;
 exports.extractProfileOverrides = extractProfileOverrides;
 exports.findFaceCenter = findFaceCenter;
@@ -8682,6 +8697,7 @@ exports.getMeshNamesForVisemeProfile = getMeshNamesForVisemeProfile;
 exports.getModelForwardDirection = getModelForwardDirection;
 exports.getPreset = getPreset;
 exports.getPresetWithProfile = getPresetWithProfile;
+exports.getProfilePresetId = getProfilePresetId;
 exports.getProfileVisemeSlots = getProfileVisemeSlots;
 exports.getVisemeBindingTargets = getVisemeBindingTargets;
 exports.getVisemeJawAmounts = getVisemeJawAmounts;
@@ -8691,11 +8707,13 @@ exports.isMixedAU = isMixedAU;
 exports.isPresetCompatible = isPresetCompatible;
 exports.mapProviderVisemeToSlot = mapProviderVisemeToSlot;
 exports.mergeCharacterRegionsByName = mergeRegionsByName;
+exports.mergeProfileRegionsByName = mergeProfileRegionsByName;
 exports.resolveBoneName = resolveBoneName;
 exports.resolveBoneNames = resolveBoneNames;
 exports.resolveFaceCenter = resolveFaceCenter;
 exports.resolvePreset = resolvePreset;
 exports.resolvePresetWithOverrides = resolvePresetWithOverrides;
+exports.resolveProfileFromPreset = resolveProfileFromPreset;
 exports.resolveVisemeMeshCategory = resolveVisemeMeshCategory;
 exports.suggestBestPreset = suggestBestPreset;
 exports.validateMappingConfig = validateMappingConfig;