@lovelace_lol/loom3 1.0.41 → 1.0.42

package/dist/index.cjs

@@ -60,6 +60,223 @@ function getCompositeAxisBinding(nodeKey, axisConfig, direction, getValue, auToB
   return null;
 }
 
+// src/mappings/visemeSystem.ts
+function hasOwn(value, key) {
+  return Boolean(value && Object.prototype.hasOwnProperty.call(value, key));
+}
+function toSlotId(label, index) {
+  const normalized = label.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized || `viseme-${index}`;
+}
+function bindingTargets(binding) {
+  if (!binding) return [];
+  const targets = binding.targets?.map((target) => target.morph).filter((morph) => morph !== "");
+  if (targets && targets.length > 0) return targets;
+  return binding.morph !== void 0 && binding.morph !== "" ? [binding.morph] : [];
+}
+function getProfileVisemeSlots(profile) {
+  if (profile.visemeSlots && profile.visemeSlots.length > 0) {
+    return [...profile.visemeSlots].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+  }
+  return (profile.visemeKeys || []).map((key, index) => {
+    const label = typeof key === "string" && key ? key : `Viseme ${index}`;
+    return {
+      id: toSlotId(label, index),
+      label,
+      order: index,
+      defaultJawAmount: profile.visemeJawAmounts?.[index]
+    };
+  });
+}
+function getVisemeSlotIndex(profile, slotId) {
+  return getProfileVisemeSlots(profile).findIndex((slot) => slot.id === slotId);
+}
+function compileVisemeKeys(profile) {
+  const slots = getProfileVisemeSlots(profile);
+  if (!profile.visemeBindings) return [...profile.visemeKeys || []];
+  return slots.map((slot, index) => {
+    const target = bindingTargets(profile.visemeBindings?.[slot.id])[0];
+    return target ?? profile.visemeKeys?.[index] ?? "";
+  });
+}
+function getVisemeJawAmounts(profile) {
+  const slots = getProfileVisemeSlots(profile);
+  if (slots.length === 0) return profile.visemeJawAmounts ? [...profile.visemeJawAmounts] : void 0;
+  return slots.map((slot, index) => slot.defaultJawAmount ?? profile.visemeJawAmounts?.[index] ?? 0);
+}
+function resolveVisemeMeshCategory(profile) {
+  const morphToMesh = profile.morphToMesh || {};
+  if (profile.visemeMeshCategory) return profile.visemeMeshCategory;
+  if (hasOwn(morphToMesh, "viseme")) return "viseme";
+  return "face";
+}
+function getMeshNamesForVisemeProfile(profile) {
+  const morphToMesh = profile.morphToMesh || {};
+  const category = resolveVisemeMeshCategory(profile);
+  if (hasOwn(morphToMesh, category)) {
+    return Array.isArray(morphToMesh[category]) ? [...morphToMesh[category]] : [];
+  }
+  return profile.visemeMeshCategory ? [] : [...morphToMesh.face || []];
+}
+function getMeshNamesForAUProfile(profile, auId) {
+  const morphToMesh = profile.morphToMesh || {};
+  const facePart = profile.auInfo?.[String(auId)]?.facePart;
+  const category = facePart ? profile.auFacePartToMeshCategory?.[facePart] : void 0;
+  if (category) return Array.isArray(morphToMesh[category]) ? [...morphToMesh[category]] : [];
+  return [...morphToMesh.face || []];
+}
+function compileMatcher(pattern) {
+  try {
+    return new RegExp(pattern, "i");
+  } catch {
+    return null;
+  }
+}
+function classifyVisemeMorph(morphName, profile) {
+  const slots = getProfileVisemeSlots(profile);
+  const matches = [];
+  for (const slot of slots) {
+    const explicitTargets = bindingTargets(profile.visemeBindings?.[slot.id]);
+    if (explicitTargets.some((target) => String(target).toLowerCase() === morphName.toLowerCase())) {
+      matches.push({
+        slotId: slot.id,
+        label: slot.label,
+        confidence: 1,
+        reason: "explicit"
+      });
+      continue;
+    }
+    for (const pattern of slot.matchers || []) {
+      const matcher = compileMatcher(pattern);
+      if (matcher?.test(morphName)) {
+        matches.push({
+          slotId: slot.id,
+          label: slot.label,
+          confidence: 0.75,
+          reason: "regex",
+          pattern
+        });
+      }
+    }
+  }
+  return matches;
+}
+function buildMappingEditorModel(profile, morphNames = []) {
+  const sections = /* @__PURE__ */ new Map();
+  const configuredSections = profile.mappingSections || [];
+  const configuredById = new Map(configuredSections.map((section) => [section.id, section]));
+  let nextOrder = configuredSections.length;
+  for (const section of configuredSections) {
+    sections.set(section.id, { ...section });
+  }
+  const getOrder = (id, fallback) => {
+    const configured = configuredById.get(id);
+    if (configured) return configured.order;
+    if (fallback !== void 0) return fallback;
+    const order = nextOrder;
+    nextOrder += 1;
+    return order;
+  };
+  const auSectionOrders = /* @__PURE__ */ new Map();
+  for (const [auId, info] of Object.entries(profile.auInfo || {})) {
+    const label = info.facePart || "Unmapped";
+    auSectionOrders.set(label, Math.min(auSectionOrders.get(label) ?? Number.MAX_SAFE_INTEGER, Number(auId)));
+  }
+  if (configuredSections.length === 0 && auSectionOrders.size > 0) {
+    nextOrder = Math.max(...auSectionOrders.values()) + 1;
+  }
+  for (const info of Object.values(profile.auInfo || {})) {
+    const label = info.facePart || "Unmapped";
+    const configured = configuredById.get(label);
+    const meshCategory = profile.auFacePartToMeshCategory?.[label] || "face";
+    sections.set(label, {
+      ...configured,
+      id: label,
+      label: configured?.label || label,
+      kind: "au",
+      order: getOrder(label, auSectionOrders.get(label)),
+      meshCategory: configured?.meshCategory || meshCategory,
+      facePart: label
+    });
+  }
+  const configuredVisemes = configuredById.get("Visemes");
+  sections.set("Visemes", {
+    ...configuredVisemes,
+    id: "Visemes",
+    label: configuredVisemes?.label || "Visemes",
+    kind: "viseme",
+    order: getOrder("Visemes"),
+    meshCategory: configuredVisemes?.meshCategory || resolveVisemeMeshCategory(profile)
+  });
+  if (hasOwn(profile.morphToMesh, "hair")) {
+    const configuredHair = configuredById.get("Hair");
+    sections.set("Hair", {
+      ...configuredHair,
+      id: "Hair",
+      label: configuredHair?.label || "Hair",
+      kind: "hair",
+      order: getOrder("Hair"),
+      meshCategory: configuredHair?.meshCategory || "hair"
+    });
+  }
+  const configuredUnmapped = configuredById.get("Unmapped");
+  sections.set("Unmapped", {
+    ...configuredUnmapped,
+    id: "Unmapped",
+    label: configuredUnmapped?.label || "Unmapped",
+    kind: "unmapped",
+    order: getOrder("Unmapped"),
+    meshCategory: configuredUnmapped?.meshCategory || "face"
+  });
+  const candidates = morphNames.map((morph) => {
+    const matches = classifyVisemeMorph(morph, profile);
+    if (matches.length === 0) {
+      return { morph, sectionId: "Unmapped", kind: "unmapped", matches };
+    }
+    const explicit = matches.filter((match) => match.reason === "explicit");
+    if (explicit.length > 0) {
+      return { morph, sectionId: "Visemes", kind: "explicit", matches: explicit };
+    }
+    return {
+      morph,
+      sectionId: "Visemes",
+      kind: matches.length > 1 ? "conflict" : "candidate",
+      matches
+    };
+  });
+  return {
+    sections: Array.from(sections.values()).sort((a, b) => a.order - b.order || a.label.localeCompare(b.label)),
+    candidates
+  };
+}
+function mapProviderVisemeToSlot(profile, event) {
+  const slots = getProfileVisemeSlots(profile);
+  const provider = event.provider.toLowerCase();
+  if (event.id !== void 0) {
+    const id = String(event.id);
+    const index = slots.findIndex(
+      (slot) => (slot.providerIds?.[provider] || []).some((candidate) => String(candidate) === id)
+    );
+    if (index >= 0) {
+      return { slotId: slots[index].id, index, confidence: 1, reason: "provider" };
+    }
+  }
+  if (event.phoneme) {
+    const phoneme = event.phoneme.toLowerCase();
+    const index = slots.findIndex(
+      (slot) => (slot.phonemes || []).some((candidate) => candidate.toLowerCase() === phoneme)
+    );
+    if (index >= 0) {
+      return { slotId: slots[index].id, index, confidence: 0.8, reason: "phoneme" };
+    }
+  }
+  const restIndex = slots.findIndex((slot) => slot.id === "rest" || slot.features?.lipClosed === 1);
+  if (restIndex >= 0) {
+    return { slotId: slots[restIndex].id, index: restIndex, confidence: 0.25, reason: "rest" };
+  }
+  return null;
+}
+
 // src/engines/three/balanceUtils.ts
 function clampBalance(value) {
   if (!Number.isFinite(value)) return 0;
@@ -670,12 +887,7 @@ var BakedAnimationController = class {
     if (typeof this.host.getMeshNamesForAU === "function") {
       return this.host.getMeshNamesForAU(auId) || [];
     }
-    const facePart = config.auInfo?.[String(auId)]?.facePart;
-    if (facePart) {
-      const category = config.auFacePartToMeshCategory?.[facePart];
-      if (category) return config.morphToMesh?.[category] || [];
-    }
-    return config.morphToMesh?.face || [];
+    return getMeshNamesForAUProfile(config, auId);
   }
   getMeshNamesForViseme(config, explicitMeshNames) {
     if (explicitMeshNames && explicitMeshNames.length > 0) {
@@ -684,10 +896,7 @@ var BakedAnimationController = class {
     if (typeof this.host.getMeshNamesForViseme === "function") {
       return this.host.getMeshNamesForViseme() || [];
     }
-    const category = config.visemeMeshCategory || (config.morphToMesh?.viseme ? "viseme" : "face");
-    const visemeMeshes = config.morphToMesh?.[category];
-    if (visemeMeshes && visemeMeshes.length > 0) return visemeMeshes;
-    return config.morphToMesh?.face || [];
+    return getMeshNamesForVisemeProfile(config);
   }
   update(dtSeconds) {
     if (this.animationMixer) {
@@ -1740,7 +1949,7 @@ var BakedAnimationController = class {
   }
   addMorphTracks(tracks, morphKey, keyframes, intensityScale, meshNames) {
     const config = this.host.getConfig();
-    const hasExplicitMeshes = !!(meshNames && meshNames.length > 0);
+    const hasExplicitMeshes = meshNames !== void 0;
     const targetMeshNames = hasExplicitMeshes ? meshNames : config.morphToMesh?.face || [];
     const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : [];
     const addTrackForMesh = (mesh) => {
@@ -1764,7 +1973,7 @@ var BakedAnimationController = class {
   addMorphIndexTracks(tracks, morphIndex, keyframes, intensityScale, meshNames) {
     if (!Number.isInteger(morphIndex) || morphIndex < 0) return;
     const config = this.host.getConfig();
-    const hasExplicitMeshes = !!(meshNames && meshNames.length > 0);
+    const hasExplicitMeshes = meshNames !== void 0;
     const targetMeshNames = hasExplicitMeshes ? meshNames : config.morphToMesh?.face || [];
     const targetMeshes = targetMeshNames.length ? targetMeshNames.map((name) => this.host.getMeshByName(name)).filter(Boolean) : [];
     const addTrackForMesh = (mesh) => {
@@ -2398,6 +2607,159 @@ var VISEME_JAW_AMOUNTS = [
   0.5
   // 14: W_OO
 ];
+var CC4_VISEME_SYSTEM_ID = "cc4-arkit-15";
+var CC4_VISEME_SLOTS = [
+  {
+    id: "ae",
+    label: "AE",
+    order: 0,
+    providerIds: { azure: [4], sapi: [4] },
+    phonemes: ["AE", "EH", "EY", "UH"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(ae|eh|ey)([_ .-]|$)"],
+    features: { jawOpen: 0.75, lipSpread: 0.35 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[0]
+  },
+  {
+    id: "ah",
+    label: "Ah",
+    order: 1,
+    providerIds: { azure: [1, 2, 9, 11, 12], sapi: [1, 2, 9, 11, 12] },
+    phonemes: ["AA", "AE", "AH", "AX", "AW", "AY", "HH"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(ah|aa|aah|open)([_ .-]|$)"],
+    features: { jawOpen: 0.8 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[1]
+  },
+  {
+    id: "b-m-p",
+    label: "B_M_P",
+    order: 2,
+    providerIds: { azure: [0, 21], sapi: [0, 21] },
+    phonemes: ["B", "M", "P"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(b[_ .-]?m[_ .-]?p|bmp|closed|sil|rest)([_ .-]|$)"],
+    features: { jawOpen: 0, lipClosed: 1 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[2]
+  },
+  {
+    id: "ch-j",
+    label: "Ch_J",
+    order: 3,
+    providerIds: { azure: [16], sapi: [16] },
+    phonemes: ["CH", "JH", "SH", "ZH"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(ch|j|sh|zh)([_ .-]|$)"],
+    features: { jawOpen: 0.3, fricative: 0.6 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[3]
+  },
+  {
+    id: "ee",
+    label: "EE",
+    order: 4,
+    providerIds: { azure: [6], sapi: [6] },
+    phonemes: ["IY", "IH", "IX", "Y"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(ee|iy|y)([_ .-]|$)"],
+    features: { jawOpen: 0.2, lipSpread: 0.8 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[4]
+  },
+  {
+    id: "er",
+    label: "Er",
+    order: 5,
+    providerIds: { azure: [5], sapi: [5] },
+    phonemes: ["ER"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(er)([_ .-]|$)"],
+    features: { jawOpen: 0.35, lipRound: 0.35 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[5]
+  },
+  {
+    id: "f-v",
+    label: "F_V",
+    order: 6,
+    providerIds: { azure: [18], sapi: [18] },
+    phonemes: ["F", "V"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(f[_ .-]?v|fv)([_ .-]|$)"],
+    features: { jawOpen: 0.1, fricative: 1 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[6]
+  },
+  {
+    id: "ih",
+    label: "Ih",
+    order: 7,
+    providerIds: { azure: [6], sapi: [6] },
+    phonemes: ["IH", "IX"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(ih|ix)([_ .-]|$)"],
+    features: { jawOpen: 0.2, lipSpread: 0.55 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[7]
+  },
+  {
+    id: "k-g-h-ng",
+    label: "K_G_H_NG",
+    order: 8,
+    providerIds: { azure: [20], sapi: [20] },
+    phonemes: ["K", "G", "NG"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(k[_ .-]?g[_ .-]?h?[_ .-]?ng|kg|ng)([_ .-]|$)"],
+    features: { jawOpen: 0.35 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[8]
+  },
+  {
+    id: "oh",
+    label: "Oh",
+    order: 9,
+    providerIds: { azure: [3, 8, 10], sapi: [3, 8, 10] },
+    phonemes: ["AO", "OW", "OY"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(oh|ao|ow|oy)([_ .-]|$)"],
+    features: { jawOpen: 0.6, lipRound: 0.8 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[9]
+  },
+  {
+    id: "r",
+    label: "R",
+    order: 10,
+    providerIds: { azure: [13], sapi: [13] },
+    phonemes: ["R"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(r)([_ .-]|$)"],
+    features: { jawOpen: 0.35, lipRound: 0.5 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[10]
+  },
+  {
+    id: "s-z",
+    label: "S_Z",
+    order: 11,
+    providerIds: { azure: [15], sapi: [15] },
+    phonemes: ["S", "Z"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(s[_ .-]?z|sz)([_ .-]|$)"],
+    features: { jawOpen: 0.1, fricative: 1 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[11]
+  },
+  {
+    id: "t-l-d-n",
+    label: "T_L_D_N",
+    order: 12,
+    providerIds: { azure: [14, 19], sapi: [14, 19] },
+    phonemes: ["T", "L", "D", "N"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(t[_ .-]?l[_ .-]?d[_ .-]?n|tldn|l)([_ .-]|$)"],
+    features: { jawOpen: 0.3, tongueTip: 1 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[12]
+  },
+  {
+    id: "th",
+    label: "Th",
+    order: 13,
+    providerIds: { azure: [17], sapi: [17] },
+    phonemes: ["TH", "DH"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(th|dh)([_ .-]|$)"],
+    features: { jawOpen: 0.15, tongueTip: 0.8, fricative: 0.8 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[13]
+  },
+  {
+    id: "w-oo",
+    label: "W_OO",
+    order: 14,
+    providerIds: { azure: [7], sapi: [7] },
+    phonemes: ["W", "UW"],
+    matchers: ["(^|[_ .-])(v|viseme)?[_ .-]?(w[_ .-]?oo|woo|uw|oo)([_ .-]|$)"],
+    features: { jawOpen: 0.5, lipRound: 1 },
+    defaultJawAmount: VISEME_JAW_AMOUNTS[14]
+  }
+];
 var isMixedAU = (id) => {
   const morphs = AU_TO_MORPHS[id];
   const hasMorphs = !!(morphs?.left?.length || morphs?.right?.length || morphs?.center?.length);
@@ -2709,6 +3071,23 @@ var AU_FACEPART_TO_MESH_CATEGORY = {
   Eyelids: "eye",
   Tongue: "tongue"
 };
+var CC4_MAPPING_SECTIONS = [
+  { id: "Forehead", label: "Forehead", kind: "au", order: 0, meshCategory: "face", facePart: "Forehead" },
+  { id: "Eyelids", label: "Eyelids", kind: "au", order: 1, meshCategory: "eye", facePart: "Eyelids" },
+  { id: "Eyes", label: "Eyes", kind: "au", order: 2, meshCategory: "eye", facePart: "Eyes" },
+  { id: "Cheeks", label: "Cheeks", kind: "au", order: 3, meshCategory: "face", facePart: "Cheeks" },
+  { id: "Nose", label: "Nose", kind: "au", order: 4, meshCategory: "face", facePart: "Nose" },
+  { id: "Mouth", label: "Mouth", kind: "au", order: 5, meshCategory: "face", facePart: "Mouth" },
+  { id: "Chin", label: "Chin", kind: "au", order: 6, meshCategory: "face", facePart: "Chin" },
+  { id: "Jaw", label: "Jaw", kind: "au", order: 7, meshCategory: "face", facePart: "Jaw" },
+  { id: "Tongue", label: "Tongue", kind: "au", order: 8, meshCategory: "tongue", facePart: "Tongue" },
+  { id: "Head", label: "Head", kind: "au", order: 9, meshCategory: "face", facePart: "Head" },
+  { id: "Joint Controls", label: "Joint Controls", kind: "au", order: 10, meshCategory: "face", facePart: "Joint Controls" },
+  { id: "Eye", label: "Eye", kind: "au", order: 11, meshCategory: "eye", facePart: "Eye" },
+  { id: "Hair", label: "Hair", kind: "hair", order: 12, meshCategory: "hair" },
+  { id: "Visemes", label: "Visemes", kind: "viseme", order: 13, meshCategory: "viseme" },
+  { id: "Unmapped", label: "Unmapped", kind: "unmapped", order: 14, meshCategory: "face" }
+];
 var CC4_HAIR_PHYSICS = {
   stiffness: 7.5,
   damping: 0.18,
@@ -2755,7 +3134,10 @@ var CC4_PRESET = {
   suffixPattern: CC4_SUFFIX_PATTERN,
   morphToMesh: MORPH_TO_MESH,
   auFacePartToMeshCategory: AU_FACEPART_TO_MESH_CATEGORY,
+  mappingSections: CC4_MAPPING_SECTIONS,
   visemeKeys: VISEME_KEYS,
+  visemeSystemId: CC4_VISEME_SYSTEM_ID,
+  visemeSlots: CC4_VISEME_SLOTS,
   visemeMeshCategory: "viseme",
   visemeJawAmounts: VISEME_JAW_AMOUNTS,
   auMixDefaults: AU_MIX_DEFAULTS,
@@ -3642,8 +4024,13 @@ function extendPresetWithProfile(base, extension) {
     boneNodes: mergeRecord(base.boneNodes, extension.boneNodes),
     morphToMesh: mergeRecord(base.morphToMesh, extension.morphToMesh),
     auFacePartToMeshCategory: base.auFacePartToMeshCategory || extension.auFacePartToMeshCategory ? mergeRecord(base.auFacePartToMeshCategory || {}, extension.auFacePartToMeshCategory || {}) : void 0,
+    mappingSections: extension.mappingSections ? [...extension.mappingSections] : base.mappingSections ? [...base.mappingSections] : void 0,
     visemeKeys: extension.visemeKeys ? [...extension.visemeKeys] : [...base.visemeKeys],
+    visemeSystemId: extension.visemeSystemId ?? base.visemeSystemId,
+    visemeSlots: extension.visemeSlots ? [...extension.visemeSlots] : base.visemeSlots ? [...base.visemeSlots] : void 0,
+    visemeBindings: base.visemeBindings || extension.visemeBindings ? mergeRecord(base.visemeBindings || {}, extension.visemeBindings || {}) : void 0,
     visemeMeshCategory: extension.visemeMeshCategory ?? base.visemeMeshCategory,
+    visemeJawAmounts: extension.visemeJawAmounts ? [...extension.visemeJawAmounts] : base.visemeJawAmounts ? [...base.visemeJawAmounts] : void 0,
     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,
@@ -5209,6 +5596,21 @@ var _Loom3 = class _Loom3 {
     const jawHandle = this.transitionBoneRotation("JAW", "pitch", jawAmount, durationMs);
     return this.combineHandles([morphHandle, jawHandle]);
   }
+  setVisemeById(slotId, value, jawScale = 1) {
+    const index = getVisemeSlotIndex(this.config, slotId);
+    if (index < 0) return;
+    this.setViseme(index, value, jawScale);
+  }
+  transitionVisemeById(slotId, to, durationMs = 80, jawScale = 1) {
+    const index = getVisemeSlotIndex(this.config, slotId);
+    if (index < 0) {
+      return { promise: Promise.resolve(), pause: () => {
+      }, resume: () => {
+      }, cancel: () => {
+      } };
+    }
+    return this.transitionViseme(index, to, durationMs, jawScale);
+  }
   // ============================================================================
   // MIX WEIGHT CONTROL
   // ============================================================================
@@ -5554,21 +5956,10 @@ var _Loom3 = class _Loom3 {
    * Routing is driven by `auFacePartToMeshCategory` in profile config.
    */
   getMeshNamesForAU(auId) {
-    const m = this.config.morphToMesh;
-    const info = this.config.auInfo?.[String(auId)];
-    const facePart = info?.facePart;
-    if (facePart) {
-      const category = this.config.auFacePartToMeshCategory?.[facePart];
-      if (category) {
-        return m?.[category] || [];
-      }
-    }
-    return m?.face || [];
+    return getMeshNamesForAUProfile(this.config, auId);
   }
   getMeshNamesForViseme() {
-    const m = this.config.morphToMesh;
-    const category = this.config.visemeMeshCategory || (m?.viseme ? "viseme" : "face");
-    return m?.[category] || m?.face || [];
+    return getMeshNamesForVisemeProfile(this.config);
   }
   // ============================================================================
   // HAIR PHYSICS
@@ -5836,7 +6227,7 @@ var _Loom3 = class _Loom3 {
     );
   }
   getVisemeJawAmount(visemeIndex) {
-    return this.config.visemeJawAmounts?.[visemeIndex] ?? _Loom3.VISEME_JAW_AMOUNTS[visemeIndex] ?? 0;
+    return getVisemeJawAmounts(this.config)?.[visemeIndex] ?? this.config.visemeJawAmounts?.[visemeIndex] ?? _Loom3.VISEME_JAW_AMOUNTS[visemeIndex] ?? 0;
   }
   collectResolvedExpressionMorphTargets() {
     const targets = [];
@@ -6314,7 +6705,11 @@ var PROFILE_OVERRIDE_KEYS = [
   "rightMorphSuffixes",
   "morphToMesh",
   "auFacePartToMeshCategory",
+  "mappingSections",
   "visemeKeys",
+  "visemeSystemId",
+  "visemeSlots",
+  "visemeBindings",
   "visemeMeshCategory",
   "visemeJawAmounts",
   "auMixDefaults",
@@ -7414,6 +7809,33 @@ function validateMappingConfig(config) {
     }
     visemeSeen.add(key);
   }
+  const morphCategories = new Set(Object.keys(config.morphToMesh || {}));
+  if (config.visemeMeshCategory && !morphCategories.has(config.visemeMeshCategory)) {
+    push(
+      "error",
+      "VISEME_MESH_CATEGORY_MISSING",
+      `visemeMeshCategory "${config.visemeMeshCategory}" is not present in morphToMesh`,
+      { category: config.visemeMeshCategory }
+    );
+  }
+  for (const [facePart, category] of Object.entries(config.auFacePartToMeshCategory || {})) {
+    if (!morphCategories.has(category)) {
+      push(
+        "error",
+        "AU_MESH_CATEGORY_MISSING",
+        `AU facePart "${facePart}" routes to missing morphToMesh category "${category}"`,
+        { facePart, category }
+      );
+    }
+  }
+  if (config.visemeJawAmounts && config.visemeJawAmounts.length !== (config.visemeKeys || []).length) {
+    push(
+      "warning",
+      "VISEME_JAW_AMOUNT_LENGTH_MISMATCH",
+      "visemeJawAmounts length does not match visemeKeys length",
+      { visemeKeys: (config.visemeKeys || []).length, visemeJawAmounts: config.visemeJawAmounts.length }
+    );
+  }
   if (config.auMixDefaults) {
     for (const key of Object.keys(config.auMixDefaults)) {
       const auId = Number(key);
@@ -7878,9 +8300,12 @@ exports.BONE_AU_TO_BINDINGS = BONE_AU_TO_BINDINGS;
 exports.CC4_BONE_NODES = CC4_BONE_NODES;
 exports.CC4_BONE_PREFIX = CC4_BONE_PREFIX;
 exports.CC4_EYE_MESH_NODES = CC4_EYE_MESH_NODES;
+exports.CC4_MAPPING_SECTIONS = CC4_MAPPING_SECTIONS;
 exports.CC4_MESHES = CC4_MESHES;
 exports.CC4_PRESET = CC4_PRESET;
 exports.CC4_SUFFIX_PATTERN = CC4_SUFFIX_PATTERN;
+exports.CC4_VISEME_SLOTS = CC4_VISEME_SLOTS;
+exports.CC4_VISEME_SYSTEM_ID = CC4_VISEME_SYSTEM_ID;
 exports.COMPOSITE_ROTATIONS = COMPOSITE_ROTATIONS;
 exports.CONTINUUM_LABELS = CONTINUUM_LABELS;
 exports.CONTINUUM_PAIRS_MAP = CONTINUUM_PAIRS_MAP;
@@ -7895,7 +8320,9 @@ exports.VISEME_JAW_AMOUNTS = VISEME_JAW_AMOUNTS;
 exports.VISEME_KEYS = VISEME_KEYS;
 exports.analyzeModel = analyzeModel;
 exports.applyCharacterProfileToPreset = applyCharacterProfileToPreset;
+exports.buildMappingEditorModel = buildMappingEditorModel;
 exports.collectMorphMeshes = collectMorphMeshes;
+exports.compileVisemeKeys = compileVisemeKeys;
 exports.computeCameraRelativeGazeOffset = computeCameraRelativeGazeOffset;
 exports.detectFacingDirection = detectFacingDirection;
 exports.extendCharacterConfigWithPreset = extendCharacterConfigWithPreset;
@@ -7906,18 +8333,25 @@ exports.extractProfileOverrides = extractProfileOverrides;
 exports.findFaceCenter = findFaceCenter;
 exports.fuzzyNameMatch = fuzzyNameMatch;
 exports.generateMappingCorrections = generateMappingCorrections;
+exports.getMeshNamesForAUProfile = getMeshNamesForAUProfile;
+exports.getMeshNamesForVisemeProfile = getMeshNamesForVisemeProfile;
 exports.getModelForwardDirection = getModelForwardDirection;
 exports.getPreset = getPreset;
 exports.getPresetWithProfile = getPresetWithProfile;
+exports.getProfileVisemeSlots = getProfileVisemeSlots;
+exports.getVisemeJawAmounts = getVisemeJawAmounts;
+exports.getVisemeSlotIndex = getVisemeSlotIndex;
 exports.hasLeftRightMorphs = hasLeftRightMorphs;
 exports.isMixedAU = isMixedAU;
 exports.isPresetCompatible = isPresetCompatible;
+exports.mapProviderVisemeToSlot = mapProviderVisemeToSlot;
 exports.mergeCharacterRegionsByName = mergeRegionsByName;
 exports.resolveBoneName = resolveBoneName;
 exports.resolveBoneNames = resolveBoneNames;
 exports.resolveFaceCenter = resolveFaceCenter;
 exports.resolvePreset = resolvePreset;
 exports.resolvePresetWithOverrides = resolvePresetWithOverrides;
+exports.resolveVisemeMeshCategory = resolveVisemeMeshCategory;
 exports.suggestBestPreset = suggestBestPreset;
 exports.validateMappingConfig = validateMappingConfig;
 exports.validateMappings = validateMappings;