@lovelace_lol/loom3 1.0.45 → 1.0.47

package/dist/index.cjs

@@ -3014,7 +3014,7 @@ var CC4_VISEME_SLOTS = [
     order: 10,
     providerIds: { azure: [13], sapi: [13] },
     phonemes: ["R"],
-    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(r)([_ .-]|$)"],
+    matchers: ["(^|[_ .-])(v|viseme)[_ .-]?r([_ .-]|$)", "(^|[_ .-])r[_ .-]?(sound|viseme)([_ .-]|$)"],
     features: { jawOpen: 0.35, lipRound: 0.5 },
     defaultJawAmount: VISEME_JAW_AMOUNTS[10]
   },
@@ -3034,7 +3034,7 @@ var CC4_VISEME_SLOTS = [
     order: 12,
     providerIds: { azure: [14, 19], sapi: [14, 19] },
     phonemes: ["T", "L", "D", "N"],
-    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(t[_ .-]?l[_ .-]?d[_ .-]?n|tldn|l)([_ .-]|$)"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(t[_ .-]?l[_ .-]?d[_ .-]?n|tldn)([_ .-]|$)", "(^|[_ .-])(v|viseme)[_ .-]?l([_ .-]|$)"],
     features: { jawOpen: 0.3, tongueTip: 1 },
     defaultJawAmount: VISEME_JAW_AMOUNTS[12]
   },
@@ -7538,6 +7538,274 @@ function resolveFaceCenter(model, region, profile) {
   };
 }
 
+// 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__namespace.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__namespace.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__namespace.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__namespace.Box3().setFromObject(obj);
+          if (box.isEmpty()) {
+            return null;
+          }
+          return box.getCenter(new THREE2__namespace.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__namespace.Box3().setFromObject(obj);
+            if (!box.isEmpty()) {
+              return box.getCenter(new THREE2__namespace.Vector3());
+            }
+          }
+          const worldPos = new THREE2__namespace.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__namespace.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__namespace.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__namespace.Vector3(Math.sin(angleRad), 0, Math.cos(angleRad))
+  );
+}
+function getModelLocalOrbitAngle(model, modelCenter, worldPosition) {
+  const worldOffset = new THREE2__namespace.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,
@@ -8681,6 +8949,7 @@ exports.buildMappingEditorModel = buildMappingEditorModel;
 exports.collectMorphMeshes = collectMorphMeshes;
 exports.compileVisemeKeys = compileVisemeKeys;
 exports.computeCameraRelativeGazeOffset = computeCameraRelativeGazeOffset;
+exports.detectAnnotationLaterality = detectAnnotationLaterality;
 exports.detectFacingDirection = detectFacingDirection;
 exports.extendCharacterConfigWithPreset = extendCharacterConfigWithPreset;
 exports.extendPresetWithProfile = extendPresetWithProfile;
@@ -8692,30 +8961,42 @@ exports.extractProfileOverrides = extractProfileOverrides;
 exports.findFaceCenter = findFaceCenter;
 exports.fuzzyNameMatch = fuzzyNameMatch;
 exports.generateMappingCorrections = generateMappingCorrections;
+exports.getDefaultAnnotationLaterality = getDefaultAnnotationLaterality;
 exports.getMeshNamesForAUProfile = getMeshNamesForAUProfile;
 exports.getMeshNamesForVisemeProfile = getMeshNamesForVisemeProfile;
 exports.getModelForwardDirection = getModelForwardDirection;
+exports.getModelLocalOrbitAngle = getModelLocalOrbitAngle;
 exports.getPreset = getPreset;
 exports.getPresetWithProfile = getPresetWithProfile;
 exports.getProfilePresetId = getProfilePresetId;
 exports.getProfileVisemeSlots = getProfileVisemeSlots;
+exports.getRegionSemanticSide = getRegionSemanticSide;
+exports.getSemanticHorizontalSign = getSemanticHorizontalSign;
+exports.getSemanticHorizontalSignForSide = getSemanticHorizontalSignForSide;
 exports.getVisemeBindingTargets = getVisemeBindingTargets;
 exports.getVisemeJawAmounts = getVisemeJawAmounts;
 exports.getVisemeSlotIndex = getVisemeSlotIndex;
+exports.getWorldDirectionForCameraAngle = getWorldDirectionForCameraAngle;
 exports.hasLeftRightMorphs = hasLeftRightMorphs;
 exports.isMixedAU = isMixedAU;
 exports.isPresetCompatible = isPresetCompatible;
 exports.mapProviderVisemeToSlot = mapProviderVisemeToSlot;
 exports.mergeCharacterRegionsByName = mergeRegionsByName;
 exports.mergeProfileRegionsByName = mergeProfileRegionsByName;
+exports.normalizeCameraAngle = normalizeCameraAngle;
+exports.passesMarkerCameraAngleGate = passesMarkerCameraAngleGate;
 exports.resolveBoneName = resolveBoneName;
 exports.resolveBoneNames = resolveBoneNames;
 exports.resolveFaceCenter = resolveFaceCenter;
 exports.resolvePreset = resolvePreset;
 exports.resolvePresetWithOverrides = resolvePresetWithOverrides;
 exports.resolveProfileFromPreset = resolveProfileFromPreset;
+exports.resolveRegionCameraAngle = resolveRegionCameraAngle;
+exports.resolveRegionVisibilityCameraAngle = resolveRegionVisibilityCameraAngle;
 exports.resolveVisemeMeshCategory = resolveVisemeMeshCategory;
 exports.suggestBestPreset = suggestBestPreset;
+exports.toModelLocalDirection = toModelLocalDirection2;
+exports.toWorldDirection = toWorldDirection;
 exports.validateMappingConfig = validateMappingConfig;
 exports.validateMappings = validateMappings;
 //# sourceMappingURL=index.cjs.map