@lovelace_lol/embody 0.0.6 → 0.0.8

package/dist/core/contracts/frame.d.ts

@@ -1,27 +0,0 @@
-import type { BoneId, MeshId, MorphTargetId } from './ids';
-import type { Transform } from './primitives';
-export type FrameValueMode = 'absolute' | 'additive';
-export type TransformSpace = 'local' | 'model';
-export interface MorphTargetFrameDelta {
-    readonly meshId: MeshId;
-    readonly morphTargetId: MorphTargetId;
-    readonly value: number;
-    readonly mode?: FrameValueMode;
-}
-export interface BoneFrameDelta {
-    readonly boneId: BoneId;
-    readonly transform: Transform;
-    readonly mode?: FrameValueMode;
-    readonly space?: TransformSpace;
-}
-export interface MeshFrameDelta {
-    readonly meshId: MeshId;
-    readonly visible?: boolean;
-}
-export interface FrameDelta {
-    readonly timeSeconds?: number;
-    readonly deltaSeconds?: number;
-    readonly morphTargets?: readonly MorphTargetFrameDelta[];
-    readonly bones?: readonly BoneFrameDelta[];
-    readonly meshes?: readonly MeshFrameDelta[];
-}

package/dist/core/contracts/host.d.ts

@@ -1,28 +0,0 @@
-import type { ClipIR } from './clip';
-import type { FrameDelta } from './frame';
-import type { ModelDescriptor } from './model';
-export interface HostModelInspector<HostModel = unknown> {
-    describeModel(model: HostModel): ModelDescriptor;
-}
-export interface HostFrameApplier<HostModel = unknown> {
-    applyFrameDelta(model: HostModel, frame: FrameDelta): void;
-}
-export interface HostAnimationHandle {
-    readonly id?: string;
-    stop(): void;
-    pause?(): void;
-    resume?(): void;
-    setWeight?(weight: number): void;
-    setPlaybackRate?(playbackRate: number): void;
-}
-export interface HostAnimationPlayOptions {
-    readonly weight?: number;
-    readonly playbackRate?: number;
-    readonly loop?: boolean;
-    readonly startTimeSeconds?: number;
-}
-export interface HostAnimationSystem<HostModel = unknown, HostClip = unknown, AnimationHandle extends HostAnimationHandle = HostAnimationHandle> extends HostModelInspector<HostModel>, HostFrameApplier<HostModel> {
-    createClip(model: HostModel, clip: ClipIR): HostClip;
-    playClip(model: HostModel, clip: HostClip, options?: HostAnimationPlayOptions): AnimationHandle | null;
-    update?(model: HostModel, deltaSeconds: number): void;
-}

package/dist/core/contracts/ids.d.ts

@@ -1,15 +0,0 @@
-/**
- * Stable numeric identifiers used by host-neutral model, frame, and clip
- * contracts. Adapters assign these ids while inspecting a host model and keep
- * them stable for the lifetime of that descriptor.
- */
-type StableNumericId<Tag extends string> = number & {
-    readonly __embodyStableId: Tag;
-};
-export type MeshId = StableNumericId<'mesh'>;
-export type MorphTargetId = StableNumericId<'morphTarget'>;
-export type BoneId = StableNumericId<'bone'>;
-export type TrackId = StableNumericId<'track'>;
-export type ChannelId = StableNumericId<'channel'>;
-export type HostTargetId = MeshId | MorphTargetId | BoneId;
-export {};

package/dist/core/contracts/index.d.ts

@@ -1,10 +0,0 @@
-export type { HairConfigField, HairHeadStateField, HairMorphOutputField, HairStateField, PackedHairMorphOutput, PackedHairPhysicsState, PackedMeshProportions, PackedMorphFrameDelta, PackedMorphFrameDeltaField, PackedTemplateSkeletonFitSolution, PackedTemplateSkeletonFitTransform, TemplateSkeletonFitTransformField, MeshProportionsField, TemplateSkeletonFitSolutionField, } from './abi';
-export { ANNOTATION_CAMERA_FRAMING_FIELDS, ANNOTATION_CAMERA_FRAMING_STRIDE, CAMERA_FLIGHT_SAMPLE_FIELDS, CAMERA_FLIGHT_SAMPLE_STRIDE, EMBODY_CORE_ABI_VERSION, HAIR_CONFIG_FIELDS, HAIR_CONFIG_STRIDE, HAIR_HEAD_STATE_FIELDS, HAIR_HEAD_STATE_STRIDE, HAIR_MORPH_OUTPUT_FIELDS, HAIR_MORPH_OUTPUT_STRIDE, HAIR_STATE_FIELDS, HAIR_STATE_STRIDE, MARKER_VISIBILITY_FACTORS_FIELDS, MARKER_VISIBILITY_FACTORS_STRIDE, MARKER_ENDPOINT_FIELDS, MARKER_ENDPOINT_STRIDE, MESH_PROPORTIONS_FIELDS, MESH_PROPORTIONS_STRIDE, PACKED_MORPH_FRAME_DELTA_FIELDS, PACKED_MORPH_FRAME_DELTA_STRIDE, PACKED_BONE_FRAME_DELTA_FIELDS, PACKED_BONE_FRAME_DELTA_STRIDE, PACKED_BONE_FLAG_HAS_POSITION, PACKED_BONE_FLAG_HAS_ROTATION, TEMPLATE_SKELETON_FIT_SOLUTION_FIELDS, TEMPLATE_SKELETON_FIT_SOLUTION_STRIDE, TEMPLATE_SKELETON_FIT_TRANSFORM_FIELDS, TEMPLATE_SKELETON_FIT_TRANSFORM_STRIDE, } from './abi';
-export type { BoneId, ChannelId, HostTargetId, MeshId, MorphTargetId, TrackId, } from './ids';
-export type { NumericArray, Quat, Transform, Vec3, } from './primitives';
-export { TEMPLATE_SKELETON_FIT_METADATA_KIND, TEMPLATE_SKELETON_FIT_METADATA_VERSION, TEMPLATE_SKELETON_FIT_STATUSES, TEMPLATE_SKELETON_FIT_VERTICAL_ANCHORS, TEMPLATE_SKELETON_FIT_VERTICAL_AXES, composeTemplateSkeletonFitTransform, isTemplateSkeletonFitStatus, validateTemplateSkeletonFitMetadata, } from './skeletonFit';
-export type { TemplateSkeletonFitManualAdjustment, TemplateSkeletonFitMetadata, TemplateSkeletonFitMetrics, TemplateSkeletonFitStatus, TemplateSkeletonFitTransform, TemplateSkeletonFitValidationResult, TemplateSkeletonFitVerticalAnchor, TemplateSkeletonFitVerticalAxis, } from './skeletonFit';
-export type { BoneDescriptor, MeshDescriptor, ModelDescriptor, MorphTargetDescriptor, } from './model';
-export type { BoneFrameDelta, FrameDelta, FrameValueMode, MeshFrameDelta, MorphTargetFrameDelta, TransformSpace, } from './frame';
-export type { BoneTransformTrackTarget, ClipChannelIR, ClipChannelKind, ClipIR, ClipInterpolation, ClipTrackIR, ClipTrackTarget, ClipTrackTargetKind, ClipTrackTransformProperty, ClipTrackValueType, MeshVisibilityTrackTarget, MorphTargetTrackTarget, } from './clip';
-export type { HostAnimationHandle, HostAnimationPlayOptions, HostAnimationSystem, HostFrameApplier, HostModelInspector, } from './host';

package/dist/core/contracts/model.d.ts

@@ -1,31 +0,0 @@
-import type { BoneId, MeshId, MorphTargetId } from './ids';
-import type { Transform } from './primitives';
-export interface MorphTargetDescriptor {
-    readonly id: MorphTargetId;
-    readonly meshId: MeshId;
-    readonly name: string;
-    /** Host-local morph slot/index, recorded as data and not used as identity. */
-    readonly hostIndex?: number;
-}
-export interface MeshDescriptor {
-    readonly id: MeshId;
-    readonly name: string;
-    readonly parentBoneId?: BoneId;
-    readonly morphTargetIds: readonly MorphTargetId[];
-    readonly visible?: boolean;
-}
-export interface BoneDescriptor {
-    readonly id: BoneId;
-    readonly name: string;
-    readonly parentId?: BoneId;
-    readonly childIds: readonly BoneId[];
-    readonly restTransform?: Transform;
-}
-export interface ModelDescriptor {
-    readonly id?: string;
-    readonly name?: string;
-    readonly meshes: readonly MeshDescriptor[];
-    readonly morphTargets: readonly MorphTargetDescriptor[];
-    readonly bones: readonly BoneDescriptor[];
-    readonly metadata?: Readonly<Record<string, unknown>>;
-}

package/dist/core/contracts/primitives.d.ts

@@ -1,17 +0,0 @@
-export type NumericArray = readonly number[] | Float32Array;
-export interface Vec3 {
-    readonly x: number;
-    readonly y: number;
-    readonly z: number;
-}
-export interface Quat {
-    readonly x: number;
-    readonly y: number;
-    readonly z: number;
-    readonly w: number;
-}
-export interface Transform {
-    readonly position?: Vec3;
-    readonly rotation?: Quat;
-    readonly scale?: Vec3;
-}

package/dist/core/contracts/skeletonFit.d.ts

@@ -1,41 +0,0 @@
-import type { Vec3 } from './primitives';
-export declare const TEMPLATE_SKELETON_FIT_METADATA_KIND = "template-skeleton-fit";
-export declare const TEMPLATE_SKELETON_FIT_METADATA_VERSION = 1;
-export declare const TEMPLATE_SKELETON_FIT_STATUSES: readonly ["unfitted", "estimated", "manual-adjusted", "invalid"];
-export declare const TEMPLATE_SKELETON_FIT_VERTICAL_AXES: readonly ["x", "y", "z"];
-export declare const TEMPLATE_SKELETON_FIT_VERTICAL_ANCHORS: readonly ["min", "center", "max"];
-export type TemplateSkeletonFitStatus = (typeof TEMPLATE_SKELETON_FIT_STATUSES)[number];
-export type TemplateSkeletonFitVerticalAxis = (typeof TEMPLATE_SKELETON_FIT_VERTICAL_AXES)[number];
-export type TemplateSkeletonFitVerticalAnchor = (typeof TEMPLATE_SKELETON_FIT_VERTICAL_ANCHORS)[number];
-export interface TemplateSkeletonFitTransform {
-    readonly scale: number;
-    readonly translation: Vec3;
-}
-export interface TemplateSkeletonFitMetrics extends TemplateSkeletonFitTransform {
-    readonly confidence: number;
-    readonly meshHeight: number;
-    readonly templateHeight: number;
-    readonly crossAxisSpans: Vec3;
-    readonly status: TemplateSkeletonFitStatus;
-}
-export interface TemplateSkeletonFitManualAdjustment {
-    readonly scale?: number;
-    readonly translation?: Vec3;
-}
-export interface TemplateSkeletonFitMetadata {
-    readonly kind: typeof TEMPLATE_SKELETON_FIT_METADATA_KIND;
-    readonly version: typeof TEMPLATE_SKELETON_FIT_METADATA_VERSION;
-    readonly templateId: string;
-    readonly sourceCharacterId: string;
-    readonly verticalAxis: TemplateSkeletonFitVerticalAxis;
-    readonly verticalAnchor: TemplateSkeletonFitVerticalAnchor;
-    readonly fit: TemplateSkeletonFitMetrics;
-    readonly manualAdjustment?: TemplateSkeletonFitManualAdjustment;
-}
-export interface TemplateSkeletonFitValidationResult {
-    readonly valid: boolean;
-    readonly errors: readonly string[];
-}
-export declare function isTemplateSkeletonFitStatus(value: unknown): value is TemplateSkeletonFitStatus;
-export declare function composeTemplateSkeletonFitTransform(fit: TemplateSkeletonFitTransform, manualAdjustment?: TemplateSkeletonFitManualAdjustment): TemplateSkeletonFitTransform;
-export declare function validateTemplateSkeletonFitMetadata(metadata: unknown): TemplateSkeletonFitValidationResult;

package/dist/core/index.d.ts

@@ -1,6 +0,0 @@
-export type { BoneDescriptor, BoneFrameDelta, BoneId, BoneTransformTrackTarget, ChannelId, ClipChannelIR, ClipChannelKind, ClipIR, ClipInterpolation, ClipTrackIR, ClipTrackTarget, ClipTrackTargetKind, ClipTrackTransformProperty, ClipTrackValueType, FrameDelta, FrameValueMode, HostAnimationHandle, HostAnimationPlayOptions, HostAnimationSystem, HostFrameApplier, HostModelInspector, HostTargetId, MeshDescriptor, MeshFrameDelta, MeshId, MeshVisibilityTrackTarget, ModelDescriptor, MorphTargetDescriptor, MorphTargetFrameDelta, MorphTargetId, MorphTargetTrackTarget, NumericArray, PackedMeshProportions, PackedTemplateSkeletonFitSolution, Quat, MeshProportionsField, TemplateSkeletonFitSolutionField, TemplateSkeletonFitManualAdjustment, TemplateSkeletonFitMetadata, TemplateSkeletonFitMetrics, TemplateSkeletonFitStatus, TemplateSkeletonFitTransform, TemplateSkeletonFitTransformField, TemplateSkeletonFitValidationResult, TemplateSkeletonFitVerticalAnchor, TemplateSkeletonFitVerticalAxis, TrackId, Transform, TransformSpace, Vec3, } from './contracts';
-export { TEMPLATE_SKELETON_FIT_METADATA_KIND, TEMPLATE_SKELETON_FIT_METADATA_VERSION, MESH_PROPORTIONS_FIELDS, MESH_PROPORTIONS_STRIDE, TEMPLATE_SKELETON_FIT_STATUSES, TEMPLATE_SKELETON_FIT_SOLUTION_FIELDS, TEMPLATE_SKELETON_FIT_SOLUTION_STRIDE, TEMPLATE_SKELETON_FIT_TRANSFORM_FIELDS, TEMPLATE_SKELETON_FIT_TRANSFORM_STRIDE, TEMPLATE_SKELETON_FIT_VERTICAL_ANCHORS, TEMPLATE_SKELETON_FIT_VERTICAL_AXES, composeTemplateSkeletonFitTransform, isTemplateSkeletonFitStatus, validateTemplateSkeletonFitMetadata, } from './contracts';
-export { TsClipCompiler, numericArrayToNumbers, } from './TsClipCompiler';
-export { WasmRuntimeCore, unpackMorphFrameDelta, unpackBoneFrameDelta, } from './WasmRuntimeCore';
-export type { WasmRuntimeCoreOptions, } from './WasmRuntimeCore';
-export type { TsClipCompilerInput, TsClipCompilerKeyframe, TsClipCompilerTrackInput, TsClipCurveTarget, TsClipCurvesInput, } from './TsClipCompiler';

package/dist/core/types.d.ts

@@ -1,472 +0,0 @@
-/**
- * Embody - Core Type Definitions
- *
- * Type definitions for the 3D character animation engine.
- * These are framework-agnostic interfaces that work with any 3D engine.
- */
-/**
- * TransitionHandle - returned from transition methods
- * Provides promise-based completion notification plus fine-grained control.
- */
-export interface TransitionHandle {
-    /** Resolves when the transition completes (or is cancelled) */
-    promise: Promise<void>;
-    /** Pause this transition (holds at current value) */
-    pause: () => void;
-    /** Resume this transition after pause */
-    resume: () => void;
-    /** Cancel this transition immediately (resolves promise) */
-    cancel: () => void;
-}
-/** Standard bone keys used in AU bindings */
-export type BoneKey = 'EYE_L' | 'EYE_R' | 'JAW' | 'HEAD' | 'NECK' | 'TONGUE' | string;
-/**
- * BoneBinding - Defines how an AU maps to bone transformations
- */
-export interface BoneBinding {
-    node: BoneKey;
-    channel: 'rx' | 'ry' | 'rz' | 'tx' | 'ty' | 'tz';
-    scale: -1 | 1;
-    maxDegrees?: number;
-    maxUnits?: number;
-    /** Optional side hint for balance-aware AUs. */
-    side?: 'left' | 'right';
-}
-/** A single AU id or a grouped list of AU ids that share one semantic direction. */
-export type AUSelector = number | number[];
-/**
- * RotationAxis - Defines which AUs control a specific rotation axis
- */
-export interface RotationAxis {
-    aus: number[];
-    axis: 'rx' | 'ry' | 'rz';
-    negative?: AUSelector;
-    positive?: AUSelector;
-}
-/**
- * CompositeRotation - Defines unified rotation axes for bones
- */
-export interface CompositeRotation {
-    node: string;
-    pitch: RotationAxis | null;
-    yaw: RotationAxis | null;
-    roll: RotationAxis | null;
-}
-/**
- * AUInfo - Metadata about an Action Unit
- */
-export interface AUInfo {
-    id: string;
-    name: string;
-    muscularBasis?: string;
-    links?: string[];
-    faceArea?: 'Upper' | 'Lower';
-    facePart?: string;
-}
-/** Per-axis rotation state - simple -1 to 1 values like stable version */
-export interface CompositeRotationState {
-    pitch: number;
-    yaw: number;
-    roll: number;
-}
-export type RotationsState = Record<string, CompositeRotationState>;
-/**
- * EmbodyConfig - Configuration options for the Embody engine
- */
-export interface EmbodyConfig {
-    /** AU to morph target mappings (defaults to CC4_PRESET) */
-    profile?: import('../mappings/types').Profile;
-    /** Preset type to resolve if profile is not provided. */
-    presetType?: import('../presets').PresetType | string;
-}
-export type MorphTargetAttributeData = Float32Array | number[];
-export interface MorphTargetDelta {
-    /** Mesh name from the loaded Three.js scene. */
-    meshName: string;
-    /** Morph target name to add to morphTargetDictionary. */
-    name: string;
-    /** POSITION deltas, usually XYZ values relative to the base mesh. */
-    position: MorphTargetAttributeData;
-    /** Optional NORMAL deltas. */
-    normal?: MorphTargetAttributeData;
-    /** Optional TANGENT deltas. */
-    tangent?: MorphTargetAttributeData;
-    /** Whether deltas are relative to base attributes. Defaults to true. */
-    relative?: boolean;
-}
-export interface AddMorphTargetOptions {
-    /** Replace an existing morph target with the same name. */
-    replace?: boolean;
-    /** Initialize the new or replaced influence value to zero. Defaults to true. */
-    resetInfluence?: boolean;
-    /**
-     * Replace and dispose the BufferGeometry instead of mutating it in place.
-     * Defaults to true because Three.js does not support mutating morph attributes
-     * after a geometry has rendered.
-     */
-    forceGeometryReplacement?: boolean;
-}
-/** Source category for mixer-driven animations. */
-export type AnimationSource = 'baked' | 'clip' | 'snippet';
-/** Shared blend-mode surface for downstream animation UIs. */
-export type AnimationBlendMode = 'replace' | 'additive';
-/** Mixer channel classes derived from one authored baked source clip. */
-export type BakedClipChannel = 'face' | 'body' | 'scene';
-/** Metadata describing one derived baked mixer channel. */
-export interface BakedClipChannelInfo {
-    /** Logical channel key surfaced to downstream UIs. */
-    channel: BakedClipChannel;
-    /** Number of tracks routed into this channel. */
-    trackCount: number;
-    /** Whether Embody can play this channel directly. */
-    playable: boolean;
-    /** Effective/default blend mode for this channel when playable. */
-    blendMode?: AnimationBlendMode;
-}
-/** Shared easing labels for downstream animation UIs. */
-export type AnimationEasing = 'linear' | 'easeInOut' | 'easeInOutCubic' | 'easeIn' | 'easeOut';
-/**
- * Options for playing a mixer animation clip.
- */
-export interface AnimationPlayOptions {
-    /** Playback speed multiplier (default: 1.0). Alias: playbackRate. */
-    speed?: number;
-    /** Alias for speed so loaded clips and dynamic clips can share one UI contract. */
-    playbackRate?: number;
-    /** Animation intensity/weight (default: 1.0). Alias: weight. */
-    intensity?: number;
-    /** Alias for intensity so loaded clips and dynamic clips can share one UI contract. */
-    weight?: number;
-    /** Whether the animation should loop (default: true) */
-    loop?: boolean;
-    /** Loop mode: 'repeat' (restart from beginning), 'pingpong' (reverse direction), 'once' (no loop) */
-    loopMode?: 'repeat' | 'pingpong' | 'once';
-    /** Number of repetitions when looping (default: Infinity for repeat/pingpong) */
-    repeatCount?: number;
-    /** Play clip backwards when true (implemented via negative time scale) */
-    reverse?: boolean;
-    /** Shared balance metadata for downstream UIs (-1 to 1, default: 0) */
-    balance?: number;
-    /** Shared blend metadata for downstream UIs (default: replace) */
-    blendMode?: AnimationBlendMode;
-    /** Shared easing metadata for downstream UIs (default: linear) */
-    easing?: AnimationEasing;
-    /** Crossfade duration in seconds when transitioning from another animation (default: 0.3) */
-    crossfadeDuration?: number;
-    /** Clamp animation at end when not looping (default: true) */
-    clampWhenFinished?: boolean;
-    /** Start time offset in seconds (default: 0) */
-    startTime?: number;
-    /** Optional source override for downstream consumers */
-    source?: AnimationSource;
-}
-/**
- * Information about a loaded animation clip.
- */
-export interface AnimationClipInfo {
-    /** Name of the animation clip */
-    name: string;
-    /** Duration of the animation in seconds */
-    duration: number;
-    /** Number of tracks (bones/morphs being animated) */
-    trackCount: number;
-    /** Source of the clip for downstream UI grouping */
-    source?: AnimationSource;
-    /** Derived channel metadata for partitioned baked clips. */
-    channels?: BakedClipChannelInfo[];
-}
-/**
- * State of a currently playing animation.
- */
-export interface AnimationState {
-    /** Name of the animation */
-    name: string;
-    /** Optional action id for the current mixer action */
-    actionId?: string;
-    /** Source of the animation for downstream UIs */
-    source?: AnimationSource;
-    /** Whether the animation is currently playing */
-    isPlaying: boolean;
-    /** Whether the animation is paused */
-    isPaused: boolean;
-    /** Current playback time in seconds */
-    time: number;
-    /** Duration of the animation in seconds */
-    duration: number;
-    /** Current playback speed magnitude. */
-    speed: number;
-    /** Alias for speed to match snippet-style UIs. */
-    playbackRate: number;
-    /** Whether the animation is playing in reverse */
-    reverse: boolean;
-    /** Current weight/intensity */
-    weight: number;
-    /** Shared balance metadata for downstream UIs */
-    balance: number;
-    /** Requested source-level blend mode before per-channel routing. */
-    requestedBlendMode: AnimationBlendMode;
-    /** Shared blend metadata for downstream UIs */
-    blendMode: AnimationBlendMode;
-    /** Derived channel metadata for partitioned baked clips. */
-    channels?: BakedClipChannelInfo[];
-    /** Shared easing metadata for downstream UIs */
-    easing: AnimationEasing;
-    /** Whether the animation is looping */
-    loop: boolean;
-    /** Loop mode */
-    loopMode: 'repeat' | 'pingpong' | 'once';
-    /** Number of repetitions when looping (if configured) */
-    repeatCount?: number;
-    /** Whether the animation is looping */
-    isLooping: boolean;
-}
-/**
- * Handle returned when playing an animation, providing control methods.
- */
-export interface AnimationActionHandle {
-    /** Optional unique id for the underlying mixer action */
-    actionId?: string;
-    /** Stop the animation */
-    stop: () => void;
-    /** Pause the animation */
-    pause: () => void;
-    /** Resume a paused animation */
-    resume: () => void;
-    /** Set playback speed */
-    setSpeed: (speed: number) => void;
-    /** Set animation weight/intensity (0-1) */
-    setWeight: (weight: number) => void;
-    /** Seek to a specific time in seconds */
-    seekTo: (time: number) => void;
-    /** Get current animation state */
-    getState: () => AnimationState;
-    /** Crossfade to another animation */
-    crossfadeTo: (clipName: string, duration?: number) => AnimationActionHandle | null;
-    /** Promise that resolves when animation completes (only for non-looping) */
-    finished: Promise<void>;
-}
-export type ClipEvent = {
-    type: 'keyframe';
-    clipName: string;
-    keyframeIndex: number;
-    totalKeyframes: number;
-    currentTime: number;
-    duration: number;
-    iteration: number;
-} | {
-    type: 'loop';
-    clipName: string;
-    iteration: number;
-    currentTime: number;
-    duration: number;
-} | {
-    type: 'seek';
-    clipName: string;
-    currentTime: number;
-    duration: number;
-    iteration: number;
-} | {
-    type: 'completed';
-    clipName: string;
-    currentTime: number;
-    duration: number;
-    iteration: number;
-};
-export type ClipEventListener = (event: ClipEvent) => void;
-export interface EmbodyAnimationRuntimeConnector {
-    buildClip?: (clipName: string, curves: CurvesMap, options?: ClipOptions) => unknown;
-    playClip?: (clipName: string, curves?: CurvesMap, options?: ClipOptions) => unknown;
-    buildTypedClip?: (clipName: string, channels: SnippetChannel[], options?: ClipOptions) => unknown;
-    playTypedSnippet?: (snippet: TypedSnippet, options?: ClipOptions) => unknown;
-    stopClip?: (clipName: string) => void;
-    pauseClip?: (clipName: string) => void;
-    resumeClip?: (clipName: string) => void;
-    setClipWeight?: (clipName: string, weight: number) => void;
-    setClipPlaybackRate?: (clipName: string, rate: number) => void;
-    setClipLoop?: (clipName: string, mode: 'once' | 'repeat' | 'pingpong', repeatCount?: number) => void;
-    setClipTime?: (clipName: string, time: number) => void;
-    getClipTime?: (clipName: string) => number;
-    getClipDuration?: (clipName: string) => number;
-    updateClipParams?: (clipName: string, params: Record<string, unknown>) => boolean;
-    cleanupSnippet?: (clipName: string) => void;
-    onCommand?: (command: Record<string, unknown>) => void;
-    onState?: (state: Record<string, unknown>) => void;
-}
-export interface EmbodyAnimationRuntime {
-    snapshot(): Record<string, unknown>;
-    buildClip(clipName: string, curves: CurvesMap, options?: ClipOptions): ClipHandle | null;
-    playSnippet(clipName: string, curves: CurvesMap, options?: ClipOptions): ClipHandle | null;
-    buildTypedClip?: (clipName: string, channels: SnippetChannel[], options?: ClipOptions) => ClipHandle | null;
-    playTypedSnippet?: (snippet: TypedSnippet, options?: ClipOptions) => ClipHandle | null;
-    acceptClipEvent(event: ClipEvent | Record<string, unknown>): boolean;
-    cleanupSnippet(clipName: string): boolean;
-    updateClipParams(clipName: string, params: Record<string, unknown>): boolean;
-}
-export type EmbodyAnimationRuntimeFactory = (config?: Record<string, unknown> | null, connector?: EmbodyAnimationRuntimeConnector | null) => EmbodyAnimationRuntime;
-/**
- * A single keyframe point in an animation curve.
- */
-export interface CurvePoint {
-    /** Time in seconds */
-    time: number;
-    /** Intensity value (0-1) */
-    intensity: number;
-    /**
-     * When true on the first keyframe, capture the driven target's current live
-     * value at clip construction/playback start and transition from that anchor
-     * into the following authored keyframes.
-     */
-    inherit?: boolean;
-}
-/**
- * Map of curve IDs (AU numbers or morph names) to keyframe arrays.
- */
-export type CurvesMap = Record<string, CurvePoint[]>;
-export type SnippetChannelTarget = {
-    type: 'au';
-    id: number;
-    balance?: number;
-} | {
-    type: 'viseme';
-    id: number;
-    meshNames?: string[];
-} | {
-    type: 'lipSync';
-    id: number;
-} | {
-    type: 'morph';
-    id: string | number;
-    meshNames?: string[];
-} | {
-    type: 'bone';
-    id: BoneKey;
-    channel: 'rx' | 'ry' | 'rz' | 'tx' | 'ty' | 'tz';
-    scale?: number;
-    maxDegrees?: number;
-    maxUnits?: number;
-};
-/**
- * A typed snippet channel names the target namespace explicitly. This avoids
- * the legacy curve-map ambiguity where numeric key "1" can mean AU 1 or
- * viseme slot 1 depending on snippetCategory, and it keeps speech-only
- * lip-sync controls out of FACS AU space.
- */
-export interface SnippetChannel {
-    target: SnippetChannelTarget;
-    keyframes: CurvePoint[];
-    /** Per-channel intensity multiplier applied in addition to ClipOptions.intensityScale. */
-    intensityScale?: number;
-}
-export interface TypedSnippet {
-    name: string;
-    channels: SnippetChannel[];
-    maxTime?: number;
-    loop?: boolean;
-}
-/**
- * Options for building and playing a clip from curves.
- */
-export interface ClipOptions {
-    /** Whether the clip should loop (default: false) */
-    loop?: boolean;
-    /** Loop mode: repeat (default), pingpong (forward/back), or once */
-    loopMode?: 'repeat' | 'pingpong' | 'once';
-    /** Number of repetitions when looping (default: Infinity for repeat/pingpong) */
-    repeatCount?: number;
-    /** Playback rate multiplier (default: 1.0) */
-    playbackRate?: number;
-    /** Alias for playbackRate so dynamic clips can share one UI contract with loaded clips. */
-    speed?: number;
-    /** Play clip backwards when true (implemented via negative time scale) */
-    reverse?: boolean;
-    /** Start time offset in seconds (default: clip start, or clip end for reverse once playback) */
-    startTime?: number;
-    /** Mixer weight/intensity (default: 1.0) */
-    mixerWeight?: number;
-    /** Alias for mixerWeight/intensity so clip-backed animations can share one UI contract. */
-    weight?: number;
-    /** Alias for weight/intensity so clip-backed animations can share one UI contract. */
-    intensity?: number;
-    /** Left/right balance for bilateral AUs (-1 to 1, default: 0) */
-    balance?: number;
-    /** Shared blend metadata for downstream UIs (default: replace) */
-    blendMode?: AnimationBlendMode;
-    /** Shared easing metadata for downstream UIs (default: linear) */
-    easing?: AnimationEasing;
-    /** Legacy additive toggle alias for downstream compatibility */
-    mixerAdditive?: boolean;
-    /**
-     * Per-curve left/right balance overrides keyed by curve id (typically AU ids as strings).
-     * Example: { "43": 1, "12": 0.7 }.
-     * Falls back to `balance` when a curve id is not present.
-     */
-    balanceMap?: Record<string, number>;
-    /** Jaw scale for viseme playback (default: 1.0) */
-    jawScale?: number;
-    /** Intensity scale multiplier (default: 1.0) */
-    intensityScale?: number;
-    /** Optional morph target mesh names to constrain track creation */
-    meshNames?: string[];
-    /** Snippet category - when 'visemeSnippet', numeric curve IDs (0-14) are viseme indices; otherwise they're AU IDs */
-    snippetCategory?: 'auSnippet' | 'visemeSnippet';
-    /**
-     * When true, automatically generate jaw bone rotation from viseme curves.
-     * Uses VISEME_JAW_AMOUNTS to determine jaw opening per viseme index.
-     * Only applies when snippetCategory is 'visemeSnippet'.
-     * Default: true (for backwards compatibility with transitionViseme behavior)
-     */
-    autoVisemeJaw?: boolean;
-    /** Optional source override for downstream consumers */
-    source?: AnimationSource;
-}
-/**
- * Handle returned when playing a dynamically-built clip.
- */
-export interface ClipHandle {
-    /** Name of the clip */
-    clipName: string;
-    /** Optional unique id for the underlying mixer action */
-    actionId?: string;
-    /** Start or restart playback */
-    play: () => void;
-    /** Stop playback and reset */
-    stop: () => void;
-    /** Pause playback at current position */
-    pause: () => void;
-    /** Resume paused playback */
-    resume: () => void;
-    /** Optional weight setter for live mixer updates */
-    setWeight?: (w: number) => void;
-    /** Optional playback-rate setter for live mixer updates */
-    setPlaybackRate?: (r: number) => void;
-    /** Optional loop setter for live mixer updates */
-    setLoop?: (mode: 'once' | 'repeat' | 'pingpong', repeatCount?: number) => void;
-    /** Optional time setter for scrubbing */
-    setTime?: (time: number) => void;
-    /** Get current playback time in seconds */
-    getTime: () => number;
-    /** Get total clip duration in seconds */
-    getDuration: () => number;
-    /** Subscribe to clip lifecycle events emitted during mixer updates */
-    subscribe?: (listener: ClipEventListener) => () => void;
-    /** Promise that resolves when clip finishes (non-looping only) */
-    finished: Promise<void>;
-}
-/**
- * Snippet definition for animation playback.
- * Can be loaded from JSON and converted to a mixer clip.
- */
-export interface Snippet {
-    /** Unique name for this snippet */
-    name: string;
-    /** Optional description */
-    description?: string;
-    /** Map of AU/morph IDs to keyframe curves */
-    curves: CurvesMap;
-    /** Category for grouping (e.g., 'eyeHeadTracking', 'visemeSnippet') */
-    snippetCategory?: string;
-    /** Priority for scheduling conflicts */
-    snippetPriority?: number;
-    /** Whether to loop playback */
-    loop?: boolean;
-}