@lovelace_lol/loom3 1.0.44 → 1.0.46

package/dist/index.js

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