@lovelace_lol/loom3 1.0.41 → 1.0.43

package/dist/index.d.cts

@@ -19,6 +19,8 @@ declare const VISEME_KEYS: string[];
  * Used by snippetToClip when autoVisemeJaw is enabled.
  */
 declare const VISEME_JAW_AMOUNTS: number[];
+declare const CC4_VISEME_SYSTEM_ID = "cc4-arkit-15";
+declare const CC4_VISEME_SLOTS: VisemeSlot[];
 /** Check if an AU has both morphs and bones (can blend between them) */
 declare const isMixedAU: (id: number) => boolean;
 /** Check if an AU has separate left/right morphs */
@@ -83,6 +85,7 @@ declare const AU_MIX_DEFAULTS: Record<number, number>;
 declare const CC4_MESHES: Record<string, MeshInfo>;
 /** Which mesh each morph category applies to */
 declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
+declare const CC4_MAPPING_SECTIONS: MappingEditorSection[];
 declare const CC4_PRESET: Profile;
 
 /**
@@ -115,7 +118,11 @@ declare const BETTA_FISH_PRESET: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -156,7 +163,11 @@ declare const AU_MAPPING_CONFIG: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -197,7 +208,11 @@ declare const FISH_AU_MAPPING_CONFIG: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -705,8 +720,16 @@ interface Profile {
      * Example: { Eye: 'eye', Eyes: 'eye', Eyelids: 'eye', Tongue: 'tongue' }.
      */
     auFacePartToMeshCategory?: Record<string, string>;
+    /** Optional ordered mapping sections for authoring UIs. Presets own this metadata, not consumers. */
+    mappingSections?: MappingEditorSection[];
     /** Viseme targets in order (typically 15 phoneme positions) */
     visemeKeys: MorphTargetRef[];
+    /** Optional id of the profile-defined viseme system (for example, 'cc4-arkit-15'). */
+    visemeSystemId?: string;
+    /** Optional profile-defined viseme slots used by editors and id-based runtime APIs. */
+    visemeSlots?: VisemeSlot[];
+    /** Optional authoring bindings keyed by viseme slot id. */
+    visemeBindings?: Record<string, VisemeBinding>;
     /**
      * Optional `morphToMesh` category to use for viseme morph routing.
      * Falls back to `morphToMesh.viseme` (if present), then `morphToMesh.face`.
@@ -865,6 +888,72 @@ type MorphTargetIndex = number;
  * Morph target reference (key or index).
  */
 type MorphTargetRef = MorphTargetKey | MorphTargetIndex;
+interface VisemeSlotFeatures {
+    jawOpen?: number;
+    lipClosed?: number;
+    lipRound?: number;
+    lipSpread?: number;
+    tongueTip?: number;
+    fricative?: number;
+    nasal?: number;
+}
+interface VisemeSlot {
+    /** Stable profile/runtime id, such as 'aa', 'bmp', or 'rest'. */
+    id: string;
+    /** Human-readable editor label. */
+    label: string;
+    /** Optional display/runtime order. Lower values render first. */
+    order?: number;
+    /** Provider-specific viseme ids that should map to this slot. */
+    providerIds?: Record<string, Array<string | number>>;
+    /** Phoneme hints that can map provider phonemes to this slot. */
+    phonemes?: string[];
+    /** Regex strings used to classify likely morph candidates for this slot. */
+    matchers?: string[];
+    /** Semantic hints for approximate provider or UI matching. */
+    features?: VisemeSlotFeatures;
+    /** Optional default jaw amount for this slot. */
+    defaultJawAmount?: number;
+}
+interface VisemeBindingTarget {
+    morph: MorphTargetRef;
+    weight?: number;
+}
+interface VisemeBinding {
+    targets?: VisemeBindingTarget[];
+    /** Legacy/simplified single-target binding used by existing LoomLarge profiles. */
+    morph?: MorphTargetRef;
+    jawAmount?: number;
+    note?: string;
+    sharedWith?: string[];
+}
+type MappingSectionKind = 'au' | 'viseme' | 'hair' | 'unmapped' | 'custom';
+interface MappingEditorSection {
+    id: string;
+    label: string;
+    kind: MappingSectionKind;
+    order: number;
+    meshCategory?: string;
+    facePart?: string;
+}
+type MorphCandidateReason = 'explicit' | 'regex' | 'alias' | 'phoneme' | 'provider' | 'unmapped';
+interface MorphCandidateMatch {
+    slotId: string;
+    label: string;
+    confidence: number;
+    reason: MorphCandidateReason;
+    pattern?: string;
+}
+interface MorphCandidate {
+    morph: string;
+    sectionId: string;
+    kind: 'explicit' | 'candidate' | 'conflict' | 'unmapped';
+    matches: MorphCandidateMatch[];
+}
+interface MappingEditorModel {
+    sections: MappingEditorSection[];
+    candidates: MorphCandidate[];
+}
 interface MorphTargetsBySide {
     left: MorphTargetRef[];
     right: MorphTargetRef[];
@@ -1015,6 +1104,14 @@ interface Animation {
      * Transition viseme value smoothly
      */
     transitionViseme(visemeIndex: number, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
+    /**
+     * Set viseme value by profile-defined slot id.
+     */
+    setVisemeById?(slotId: string, value: number, jawScale?: number): void;
+    /**
+     * Transition viseme value smoothly by profile-defined slot id.
+     */
+    transitionVisemeById?(slotId: string, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
     /**
      * Set mix weight for an AU (blend between morph and bone contribution)
      */
@@ -1542,6 +1639,8 @@ declare class Loom3 implements LoomLarge {
     transitionMorphInfluence(index: number, to: number, durationMs?: number, meshNames?: string[]): TransitionHandle;
     setViseme(visemeIndex: number, value: number, jawScale?: number): void;
     transitionViseme(visemeIndex: number, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
+    setVisemeById(slotId: string, value: number, jawScale?: number): void;
+    transitionVisemeById(slotId: string, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
     setAUMixWeight(id: number, weight: number): void;
     getAUMixWeight(id: number): number;
     /**
@@ -1556,6 +1655,7 @@ declare class Loom3 implements LoomLarge {
     getActiveTransitionCount(): number;
     resetToNeutral(): void;
     private reinitializeRuntimeStateFromCurrentControls;
+    private reapplyProceduralStateAfterBakedUpdate;
     getMeshList(): MeshInfo[];
     /** Get all morph targets grouped by mesh name */
     getMorphTargets(): Record<string, string[]>;
@@ -1863,6 +1963,27 @@ interface HairPhysics$1 {
     reset(): void;
 }
 
+declare function getProfileVisemeSlots(profile: Profile): VisemeSlot[];
+declare function getVisemeSlotIndex(profile: Profile, slotId: string): number;
+declare function compileVisemeKeys(profile: Profile): MorphTargetRef[];
+declare function getVisemeJawAmounts(profile: Profile): number[] | undefined;
+declare function resolveVisemeMeshCategory(profile: Profile): string;
+declare function getMeshNamesForVisemeProfile(profile: Profile): string[];
+declare function getMeshNamesForAUProfile(profile: Profile, auId: number): string[];
+declare function buildMappingEditorModel(profile: Profile, morphNames?: string[]): MappingEditorModel;
+interface ProviderVisemeEvent {
+    provider: string;
+    id?: string | number;
+    phoneme?: string;
+}
+interface ProviderVisemeMatch {
+    slotId: string;
+    index: number;
+    confidence: number;
+    reason: 'provider' | 'phoneme' | 'rest' | 'none';
+}
+declare function mapProviderVisemeToSlot(profile: Profile, event: ProviderVisemeEvent): ProviderVisemeMatch | null;
+
 /** Line stroke style */
 type LineStyle = 'solid' | 'dashed' | 'dotted';
 /** Line curve type */
@@ -2517,4 +2638,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 AddMorphTargetOptions, 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 CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, 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 MorphTargetAttributeData, type MorphTargetDelta, 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, collectMorphMeshes, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AddMorphTargetOptions, 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_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getPreset, getPresetWithProfile, getProfileVisemeSlots, getVisemeJawAmounts, getVisemeSlotIndex, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveVisemeMeshCategory, suggestBestPreset, validateMappingConfig, validateMappings };

package/dist/index.d.ts

@@ -19,6 +19,8 @@ declare const VISEME_KEYS: string[];
  * Used by snippetToClip when autoVisemeJaw is enabled.
  */
 declare const VISEME_JAW_AMOUNTS: number[];
+declare const CC4_VISEME_SYSTEM_ID = "cc4-arkit-15";
+declare const CC4_VISEME_SLOTS: VisemeSlot[];
 /** Check if an AU has both morphs and bones (can blend between them) */
 declare const isMixedAU: (id: number) => boolean;
 /** Check if an AU has separate left/right morphs */
@@ -83,6 +85,7 @@ declare const AU_MIX_DEFAULTS: Record<number, number>;
 declare const CC4_MESHES: Record<string, MeshInfo>;
 /** Which mesh each morph category applies to */
 declare const MORPH_TO_MESH: Record<MorphCategory, string[]>;
+declare const CC4_MAPPING_SECTIONS: MappingEditorSection[];
 declare const CC4_PRESET: Profile;
 
 /**
@@ -115,7 +118,11 @@ declare const BETTA_FISH_PRESET: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -156,7 +163,11 @@ declare const AU_MAPPING_CONFIG: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -197,7 +208,11 @@ declare const FISH_AU_MAPPING_CONFIG: {
     rightMorphSuffixes?: string[];
     morphToMesh: Record<string, string[]>;
     auFacePartToMeshCategory?: Record<string, string>;
+    mappingSections?: MappingEditorSection[];
     visemeKeys: MorphTargetRef[];
+    visemeSystemId?: string;
+    visemeSlots?: VisemeSlot[];
+    visemeBindings?: Record<string, VisemeBinding>;
     visemeMeshCategory?: string;
     visemeJawAmounts?: number[];
     auMixDefaults?: Record<number, number>;
@@ -705,8 +720,16 @@ interface Profile {
      * Example: { Eye: 'eye', Eyes: 'eye', Eyelids: 'eye', Tongue: 'tongue' }.
      */
     auFacePartToMeshCategory?: Record<string, string>;
+    /** Optional ordered mapping sections for authoring UIs. Presets own this metadata, not consumers. */
+    mappingSections?: MappingEditorSection[];
     /** Viseme targets in order (typically 15 phoneme positions) */
     visemeKeys: MorphTargetRef[];
+    /** Optional id of the profile-defined viseme system (for example, 'cc4-arkit-15'). */
+    visemeSystemId?: string;
+    /** Optional profile-defined viseme slots used by editors and id-based runtime APIs. */
+    visemeSlots?: VisemeSlot[];
+    /** Optional authoring bindings keyed by viseme slot id. */
+    visemeBindings?: Record<string, VisemeBinding>;
     /**
      * Optional `morphToMesh` category to use for viseme morph routing.
      * Falls back to `morphToMesh.viseme` (if present), then `morphToMesh.face`.
@@ -865,6 +888,72 @@ type MorphTargetIndex = number;
  * Morph target reference (key or index).
  */
 type MorphTargetRef = MorphTargetKey | MorphTargetIndex;
+interface VisemeSlotFeatures {
+    jawOpen?: number;
+    lipClosed?: number;
+    lipRound?: number;
+    lipSpread?: number;
+    tongueTip?: number;
+    fricative?: number;
+    nasal?: number;
+}
+interface VisemeSlot {
+    /** Stable profile/runtime id, such as 'aa', 'bmp', or 'rest'. */
+    id: string;
+    /** Human-readable editor label. */
+    label: string;
+    /** Optional display/runtime order. Lower values render first. */
+    order?: number;
+    /** Provider-specific viseme ids that should map to this slot. */
+    providerIds?: Record<string, Array<string | number>>;
+    /** Phoneme hints that can map provider phonemes to this slot. */
+    phonemes?: string[];
+    /** Regex strings used to classify likely morph candidates for this slot. */
+    matchers?: string[];
+    /** Semantic hints for approximate provider or UI matching. */
+    features?: VisemeSlotFeatures;
+    /** Optional default jaw amount for this slot. */
+    defaultJawAmount?: number;
+}
+interface VisemeBindingTarget {
+    morph: MorphTargetRef;
+    weight?: number;
+}
+interface VisemeBinding {
+    targets?: VisemeBindingTarget[];
+    /** Legacy/simplified single-target binding used by existing LoomLarge profiles. */
+    morph?: MorphTargetRef;
+    jawAmount?: number;
+    note?: string;
+    sharedWith?: string[];
+}
+type MappingSectionKind = 'au' | 'viseme' | 'hair' | 'unmapped' | 'custom';
+interface MappingEditorSection {
+    id: string;
+    label: string;
+    kind: MappingSectionKind;
+    order: number;
+    meshCategory?: string;
+    facePart?: string;
+}
+type MorphCandidateReason = 'explicit' | 'regex' | 'alias' | 'phoneme' | 'provider' | 'unmapped';
+interface MorphCandidateMatch {
+    slotId: string;
+    label: string;
+    confidence: number;
+    reason: MorphCandidateReason;
+    pattern?: string;
+}
+interface MorphCandidate {
+    morph: string;
+    sectionId: string;
+    kind: 'explicit' | 'candidate' | 'conflict' | 'unmapped';
+    matches: MorphCandidateMatch[];
+}
+interface MappingEditorModel {
+    sections: MappingEditorSection[];
+    candidates: MorphCandidate[];
+}
 interface MorphTargetsBySide {
     left: MorphTargetRef[];
     right: MorphTargetRef[];
@@ -1015,6 +1104,14 @@ interface Animation {
      * Transition viseme value smoothly
      */
     transitionViseme(visemeIndex: number, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
+    /**
+     * Set viseme value by profile-defined slot id.
+     */
+    setVisemeById?(slotId: string, value: number, jawScale?: number): void;
+    /**
+     * Transition viseme value smoothly by profile-defined slot id.
+     */
+    transitionVisemeById?(slotId: string, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
     /**
      * Set mix weight for an AU (blend between morph and bone contribution)
      */
@@ -1542,6 +1639,8 @@ declare class Loom3 implements LoomLarge {
     transitionMorphInfluence(index: number, to: number, durationMs?: number, meshNames?: string[]): TransitionHandle;
     setViseme(visemeIndex: number, value: number, jawScale?: number): void;
     transitionViseme(visemeIndex: number, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
+    setVisemeById(slotId: string, value: number, jawScale?: number): void;
+    transitionVisemeById(slotId: string, to: number, durationMs?: number, jawScale?: number): TransitionHandle;
     setAUMixWeight(id: number, weight: number): void;
     getAUMixWeight(id: number): number;
     /**
@@ -1556,6 +1655,7 @@ declare class Loom3 implements LoomLarge {
     getActiveTransitionCount(): number;
     resetToNeutral(): void;
     private reinitializeRuntimeStateFromCurrentControls;
+    private reapplyProceduralStateAfterBakedUpdate;
     getMeshList(): MeshInfo[];
     /** Get all morph targets grouped by mesh name */
     getMorphTargets(): Record<string, string[]>;
@@ -1863,6 +1963,27 @@ interface HairPhysics$1 {
     reset(): void;
 }
 
+declare function getProfileVisemeSlots(profile: Profile): VisemeSlot[];
+declare function getVisemeSlotIndex(profile: Profile, slotId: string): number;
+declare function compileVisemeKeys(profile: Profile): MorphTargetRef[];
+declare function getVisemeJawAmounts(profile: Profile): number[] | undefined;
+declare function resolveVisemeMeshCategory(profile: Profile): string;
+declare function getMeshNamesForVisemeProfile(profile: Profile): string[];
+declare function getMeshNamesForAUProfile(profile: Profile, auId: number): string[];
+declare function buildMappingEditorModel(profile: Profile, morphNames?: string[]): MappingEditorModel;
+interface ProviderVisemeEvent {
+    provider: string;
+    id?: string | number;
+    phoneme?: string;
+}
+interface ProviderVisemeMatch {
+    slotId: string;
+    index: number;
+    confidence: number;
+    reason: 'provider' | 'phoneme' | 'rest' | 'none';
+}
+declare function mapProviderVisemeToSlot(profile: Profile, event: ProviderVisemeEvent): ProviderVisemeMatch | null;
+
 /** Line stroke style */
 type LineStyle = 'solid' | 'dashed' | 'dotted';
 /** Line curve type */
@@ -2517,4 +2638,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 AddMorphTargetOptions, 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 CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, 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 MorphTargetAttributeData, type MorphTargetDelta, 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, collectMorphMeshes, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getModelForwardDirection, getPreset, getPresetWithProfile, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, suggestBestPreset, validateMappingConfig, validateMappings };
+export { type AUInfo, type AUSelector, AU_INFO, AU_MAPPING_CONFIG, AU_MIX_DEFAULTS, AU_TO_MORPHS, type AddMorphTargetOptions, 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_MAPPING_SECTIONS, CC4_MESHES, CC4_PRESET, CC4_SUFFIX_PATTERN, CC4_VISEME_SLOTS, CC4_VISEME_SYSTEM_ID, COMPOSITE_ROTATIONS, CONTINUUM_LABELS, CONTINUUM_PAIRS_MAP, type CameraRelativeGazeOffset, type CameraRelativeGazeOptions, type CharacterConfig, type CharacterRegistry, type ClipEvent, type ClipEventListener, 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 MappingEditorModel, type MappingEditorSection, type MappingIssue, type MarkerGroup, type MarkerStyle, type MarkerStyleOverrides, type MeshCategory, type MeshInfo, type MeshMaterialSettings, type MixerLoopMode, type ModelAnalysisReport, type ModelData, type ModelMeshInfo, type MorphCandidate, type MorphCandidateMatch, type MorphCandidateReason, type MorphCategory, type MorphInfo, type MorphTargetAttributeData, type MorphTargetDelta, type MorphTargetRef, type MorphTargetsBySide, type NamedDirection, type PresetType, type Profile, type ProviderVisemeEvent, type ProviderVisemeMatch, type ReadyPayload, type Region, type RotationAxis, type RotationsState, type Snippet, type TrackInfo, type TransitionHandle, VISEME_JAW_AMOUNTS, VISEME_KEYS, type ValidateMappingOptions, type ValidationResult, type VisemeBinding, type VisemeBindingTarget, type VisemeSlot, type VisemeSlotFeatures, analyzeModel, applyCharacterProfileToPreset, buildMappingEditorModel, collectMorphMeshes, compileVisemeKeys, computeCameraRelativeGazeOffset, detectFacingDirection, extendCharacterConfigWithPreset, extendPresetWithProfile, extractFromGLTF, extractModelData, extractProfileOverrides, findFaceCenter, fuzzyNameMatch, generateMappingCorrections, getMeshNamesForAUProfile, getMeshNamesForVisemeProfile, getModelForwardDirection, getPreset, getPresetWithProfile, getProfileVisemeSlots, getVisemeJawAmounts, getVisemeSlotIndex, hasLeftRightMorphs, isMixedAU, isPresetCompatible, mapProviderVisemeToSlot, mergeRegionsByName as mergeCharacterRegionsByName, resolveBoneName, resolveBoneNames, resolveFaceCenter, resolvePreset, resolvePresetWithOverrides, resolveVisemeMeshCategory, suggestBestPreset, validateMappingConfig, validateMappings };