@lovelace_lol/embody 0.0.7 → 0.0.8

package/dist/mappings/extendPresetWithProfile.d.ts

@@ -1,17 +0,0 @@
-import type { Profile } from './types';
-import type { EmbodyCoreWasmModule } from '../wasmTypes';
-/**
- * Extend a base preset with a profile extension.
- *
- * Implemented by the Rust Wasm core.
- *
- * Rules:
- * - Scalars: extension wins when provided.
- * - Maps: shallow-merged by key, values cloned.
- * - Mesh entries: merged by mesh name, including nested material settings.
- * - Arrays: replaced when the extension provides them (except annotationRegions).
- * - annotationRegions: merged by region name, with nested camera/style fields preserved.
- */
-export declare function mergePresetWithProfile(core: EmbodyCoreWasmModule, base: Profile, extension?: Partial<Profile>): Profile;
-/** Resolve a preset/profile pair through this package entry's Wasm loader. */
-export declare function extendPresetWithProfile(base: Profile, extension?: Partial<Profile>): Promise<Profile>;

package/dist/mappings/types.d.ts

@@ -1,309 +0,0 @@
-/**
- * Embody - Profile Types
- *
- * Type definitions for character profiles.
- * Profiles define how Action Units map to morphs/bones for a specific rig.
- */
-import type { BoneBinding, AUInfo, CompositeRotation } from '../core/types';
-import type { AnnotationRegion } from '../regions/types';
-export type { AnnotationRegion } from '../regions/types';
-/**
- * Profile - Complete configuration for AU-to-morph/bone mappings
- *
- * This is the main configuration object that defines how Action Units
- * map to morph targets and bone transformations for a specific rig type.
- */
-export interface Profile {
-    /** Human-readable name for this profile (e.g., 'Character Creator 4', 'Betta Fish') */
-    name?: string;
-    /** Type of animal/creature this profile is for (e.g., 'human', 'fish', 'dog') */
-    animalType?: string;
-    /** Emoji representing this animal type (e.g., '😊' for human, '🐟' for fish) */
-    emoji?: string;
-    /** AU ID to morph target names split by side */
-    auToMorphs: Record<number, MorphTargetsBySide>;
-    /** AU ID to bone bindings (e.g., AU 51 → [{ node: 'HEAD', channel: 'ry', scale: 1, maxDegrees: 30 }]) */
-    auToBones: Record<number, BoneBinding[]>;
-    /** Bone key to actual node name in the model (e.g., 'HEAD' → 'Head' or 'CC_Base_Head') */
-    boneNodes: Record<string, string>;
-    /**
-     * Optional: Prefix to prepend to bone names when resolving nodes.
-     * If set, boneNodes should contain base names without prefix (e.g., 'Head' instead of 'CC_Base_Head').
-     * The engine will try: prefix + baseName + suffix, then fuzzy match with suffixPattern.
-     */
-    bonePrefix?: string;
-    /**
-     * Optional: Suffix to append to bone names when resolving nodes.
-     * Combined with bonePrefix: prefix + baseName + suffix (e.g., 'Bone.' + '001' + '_Armature' = 'Bone.001_Armature')
-     */
-    boneSuffix?: string;
-    /**
-     * Optional: Prefix to prepend to morph target names when resolving.
-     * Similar to bonePrefix but for morph targets.
-     */
-    morphPrefix?: string;
-    /**
-     * Optional: Suffix to append to morph target names when resolving.
-     * Similar to boneSuffix but for morph targets.
-     */
-    morphSuffix?: string;
-    /**
-     * Optional: Regex pattern string for fuzzy matching bone/morph names with suffixes.
-     * Common patterns: "_\\d+$" for numbered suffixes (_01, _038), "\\.\\d+$" for Blender (.001)
-     * When set, the engine will try exact match first, then fuzzy match using this pattern.
-     */
-    suffixPattern?: string;
-    /**
-     * Optional: Suffixes that indicate left-side morph targets.
-     * Used for auto-detecting laterality in the mapping editor.
-     * Default: ['_L', ' L']
-     */
-    leftMorphSuffixes?: string[];
-    /**
-     * Optional: Suffixes that indicate right-side morph targets.
-     * Used for auto-detecting laterality in the mapping editor.
-     * Default: ['_R', ' R']
-     */
-    rightMorphSuffixes?: string[];
-    /** Morph category to mesh names (e.g., 'face' → ['CC_Base_Body_1']) */
-    morphToMesh: Record<string, string[]>;
-    /**
-     * Optional map from AU `facePart` labels (from `auInfo`) to `morphToMesh` categories.
-     * This makes AU mesh routing fully preset/profile configurable.
-     * 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`.
-     */
-    visemeMeshCategory?: string;
-    /** Optional: Jaw opening amounts per viseme index (0-1). Used for auto-generating jaw rotation in clips. */
-    visemeJawAmounts?: number[];
-    /** Optional: Default mix weights for bone/morph blending (0 = morph only, 1 = bone only) */
-    auMixDefaults?: Record<number, number>;
-    /** Optional: AU metadata (names, muscle basis, etc.) */
-    auInfo?: Record<string, AUInfo>;
-    /** Optional: Eye mesh node fallbacks (some rigs use mesh nodes instead of bone nodes) */
-    eyeMeshNodes?: {
-        LEFT: string;
-        RIGHT: string;
-    };
-    /** Optional: Composite rotation definitions for bones (defaults to CC4 composites) */
-    compositeRotations?: CompositeRotation[];
-    /** Optional: Mesh info for material settings (depthWrite, blending, renderOrder, etc.) */
-    meshes?: Record<string, MeshInfo>;
-    /**
-     * Optional: Continuum pair mappings for bidirectional AU axes.
-     * Maps AU ID to its partner info (pairId, isNegative, axis, node).
-     * Enables negative value shorthand: setAU(51, -0.5) activates AU 52 at 0.5
-     */
-    continuumPairs?: Record<number, {
-        pairId: number;
-        isNegative: boolean;
-        axis: 'pitch' | 'yaw' | 'roll';
-        node: string;
-    }>;
-    /**
-     * Optional: Human-readable labels for continuum pairs.
-     * Key format: "negativeAU-positiveAU" (e.g., "51-52")
-     * Value: Display label (e.g., "Head Turn — Left ↔ Right")
-     */
-    continuumLabels?: Record<string, string>;
-    /**
-     * Optional: Annotation regions for camera/marker overlays.
-     */
-    annotationRegions?: AnnotationRegion[];
-    /**
-     * Optional: preset region names this profile explicitly disables.
-     */
-    disabledRegions?: string[];
-    /**
-     * Optional: Hair physics defaults for this preset/profile.
-     */
-    hairPhysics?: HairPhysicsProfileConfig;
-}
-/**
- * Hair physics morph mapping axis types.
- */
-export type HairMorphAxis = 'yaw' | 'pitch' | 'roll';
-/**
- * Single morph target mapping with axis metadata.
- */
-export interface HairMorphTargetMapping {
-    key: string;
-    axis: HairMorphAxis;
-}
-/**
- * Morph target mapping with axis metadata and intensity value.
- */
-export interface HairMorphTargetValueMapping {
-    value: number;
-    axis: HairMorphAxis;
-}
-/**
- * Hair physics defaults stored in presets/profiles.
- */
-export interface HairPhysicsProfileConfig {
-    /** Whether hair physics should start enabled when this profile is applied. */
-    enabled?: boolean;
-    stiffness?: number;
-    damping?: number;
-    inertia?: number;
-    gravity?: number;
-    responseScale?: number;
-    idleSwayAmount?: number;
-    idleSwaySpeed?: number;
-    windStrength?: number;
-    windDirectionX?: number;
-    windDirectionZ?: number;
-    windTurbulence?: number;
-    windFrequency?: number;
-    idleClipDuration?: number;
-    impulseClipDuration?: number;
-    direction?: {
-        yawSign?: 1 | -1;
-        pitchSign?: 1 | -1;
-    };
-    morphTargets?: {
-        swayLeft?: HairMorphTargetMapping;
-        swayRight?: HairMorphTargetMapping;
-        swayFront?: HairMorphTargetMapping;
-        fluffRight?: HairMorphTargetMapping;
-        fluffBottom?: HairMorphTargetMapping;
-        headUp?: Record<string, HairMorphTargetValueMapping>;
-        headDown?: Record<string, HairMorphTargetValueMapping>;
-    };
-}
-/**
- * Morph target key (name in morphTargetDictionary).
- */
-export type MorphTargetKey = string;
-/**
- * Morph target index (morphTargetInfluences slot).
- */
-export type MorphTargetIndex = number;
-/**
- * Morph target reference (key or index).
- */
-export type MorphTargetRef = MorphTargetKey | MorphTargetIndex;
-export interface VisemeSlotFeatures {
-    jawOpen?: number;
-    lipClosed?: number;
-    lipRound?: number;
-    lipSpread?: number;
-    tongueTip?: number;
-    fricative?: number;
-    nasal?: number;
-}
-export 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;
-}
-export interface VisemeBindingTarget {
-    morph: MorphTargetRef;
-    weight?: number;
-}
-export interface VisemeBinding {
-    targets?: VisemeBindingTarget[];
-    /** Legacy/simplified single-target binding used by existing LoomLarge profiles. */
-    morph?: MorphTargetRef;
-    jawAmount?: number;
-    note?: string;
-    sharedWith?: string[];
-}
-export type MappingSectionKind = 'au' | 'viseme' | 'lipSync' | 'hair' | 'unmapped' | 'custom';
-export interface MappingEditorSection {
-    id: string;
-    label: string;
-    kind: MappingSectionKind;
-    order: number;
-    meshCategory?: string;
-    facePart?: string;
-}
-export type MorphCandidateReason = 'explicit' | 'regex' | 'alias' | 'phoneme' | 'provider' | 'unmapped';
-export interface MorphCandidateMatch {
-    slotId: string;
-    label: string;
-    confidence: number;
-    reason: MorphCandidateReason;
-    pattern?: string;
-}
-export interface MorphCandidate {
-    morph: string;
-    sectionId: string;
-    kind: 'explicit' | 'candidate' | 'conflict' | 'unmapped';
-    matches: MorphCandidateMatch[];
-}
-export interface MappingEditorModel {
-    sections: MappingEditorSection[];
-    candidates: MorphCandidate[];
-}
-export interface MorphTargetsBySide {
-    left: MorphTargetRef[];
-    right: MorphTargetRef[];
-    center: MorphTargetRef[];
-}
-/**
- * Helper type for mesh categories in morphToMesh
- */
-export type MorphCategory = 'face' | 'viseme' | 'eye' | 'tongue' | 'hair';
-/**
- * Mesh category types for character mesh classification
- */
-export type MeshCategory = 'body' | 'eye' | 'eyeOcclusion' | 'tearLine' | 'teeth' | 'tongue' | 'hair' | 'eyebrow' | 'cornea' | 'eyelash';
-/**
- * Blending mode names (matches Three.js constants)
- */
-export type BlendingMode = 'Normal' | 'Additive' | 'Subtractive' | 'Multiply' | 'None';
-/**
- * Blending mode options for Three.js materials
- * Maps mode name to Three.js blending constant value
- */
-export declare const BLENDING_MODES: Record<BlendingMode, number>;
-/**
- * Material settings for mesh rendering
- */
-export interface MeshMaterialSettings {
-    renderOrder?: number;
-    transparent?: boolean;
-    opacity?: number;
-    depthWrite?: boolean;
-    depthTest?: boolean;
-    blending?: BlendingMode;
-}
-/**
- * Mesh info including category, morph count, and optional material settings.
- * Used in presets, profiles, and runtime.
- */
-export interface MeshInfo {
-    name?: string;
-    visible?: boolean;
-    category: MeshCategory;
-    morphCount: number;
-    material?: MeshMaterialSettings;
-}

package/dist/mappings/visemeSystem.d.ts

@@ -1,26 +0,0 @@
-import type { MappingEditorModel, MorphTargetRef, Profile, VisemeSlot } from './types';
-export interface ResolvedVisemeBindingTarget {
-    morph: MorphTargetRef;
-    weight: number;
-}
-export declare function getProfileVisemeSlots(profile: Profile): VisemeSlot[];
-export declare function getVisemeSlotIndex(profile: Profile, slotId: string): number;
-export declare function compileVisemeKeys(profile: Profile): MorphTargetRef[];
-export declare function getVisemeBindingTargets(profile: Profile, visemeIndex: number): ResolvedVisemeBindingTarget[];
-export declare function getVisemeJawAmounts(profile: Profile): number[] | undefined;
-export declare function resolveVisemeMeshCategory(profile: Profile): string;
-export declare function getMeshNamesForVisemeProfile(profile: Profile): string[];
-export declare function getMeshNamesForAUProfile(profile: Profile, auId: number): string[];
-export declare function buildMappingEditorModel(profile: Profile, morphNames?: string[]): MappingEditorModel;
-export interface ProviderVisemeEvent {
-    provider: string;
-    id?: string | number;
-    phoneme?: string;
-}
-export interface ProviderVisemeMatch {
-    slotId: string;
-    index: number;
-    confidence: number;
-    reason: 'provider' | 'phoneme' | 'rest' | 'none';
-}
-export declare function mapProviderVisemeToSlot(profile: Profile, event: ProviderVisemeEvent): ProviderVisemeMatch | null;

package/dist/physics/HairPhysics.d.ts

@@ -1,86 +0,0 @@
-/**
- * HairPhysics - Spring-damper pendulum simulation for hair movement
- *
- * This is a pure physics simulation class with no Three.js dependencies.
- * It outputs normalized morph values (0-1) that can be applied to hair meshes
- * via EngineThree.setMorph() or transitionMorph().
- *
- * Physics model:
- * - Hair is modeled as a damped pendulum affected by:
- *   - Gravity (constant downward force based on head orientation)
- *   - Head velocity (inertia causes hair to lag behind head movement)
- *   - Wind (oscillating force with turbulence)
- *   - Spring restoration (hair returns to rest position)
- *   - Damping (air resistance)
- */
-export interface HairPhysicsConfig {
-    mass: number;
-    stiffness: number;
-    damping: number;
-    gravity: number;
-    headInfluence: number;
-    windEnabled: boolean;
-    windStrength: number;
-    windDirectionX: number;
-    windDirectionZ: number;
-    windTurbulence: number;
-    windFrequency: number;
-}
-export interface HairPhysicsState {
-    x: number;
-    z: number;
-    vx: number;
-    vz: number;
-}
-export interface HairMorphOutput {
-    L_Hair_Left: number;
-    L_Hair_Right: number;
-    L_Hair_Front: number;
-    R_Hair_Left: number;
-    R_Hair_Right: number;
-    R_Hair_Front: number;
-}
-export interface HeadState {
-    yaw: number;
-    pitch: number;
-    roll: number;
-    yawVelocity: number;
-    pitchVelocity: number;
-}
-export declare const DEFAULT_HAIR_PHYSICS_CONFIG: HairPhysicsConfig;
-export declare class HairPhysics {
-    private config;
-    private state;
-    private time;
-    private prevHeadYaw;
-    private prevHeadPitch;
-    constructor(config?: Partial<HairPhysicsConfig>);
-    /**
-     * Update physics simulation
-     * @param dt Delta time in seconds
-     * @param headState Current head orientation and velocity
-     * @returns Morph values to apply to hair meshes
-     */
-    update(dt: number, headState: HeadState): HairMorphOutput;
-    /**
-     * Convert physics state to morph target values
-     * Maps pendulum position to left/right/front morphs for both sides
-     */
-    private computeMorphOutput;
-    /**
-     * Get current physics state (for debugging/UI)
-     */
-    getState(): HairPhysicsState;
-    /**
-     * Update configuration
-     */
-    setConfig(config: Partial<HairPhysicsConfig>): void;
-    /**
-     * Get current configuration
-     */
-    getConfig(): HairPhysicsConfig;
-    /**
-     * Reset physics state to rest position
-     */
-    reset(): void;
-}

package/dist/physics/RustHairPhysics.d.ts

@@ -1,18 +0,0 @@
-import type { HairMorphOutput, HairPhysicsConfig, HairPhysicsState, HeadState } from './HairPhysics';
-export declare class RustHairPhysics {
-    private solver;
-    private constructor();
-    static create(config?: Partial<HairPhysicsConfig>): Promise<RustHairPhysics>;
-    update(dt: number, headState: HeadState): HairMorphOutput;
-    getState(): HairPhysicsState;
-    setConfig(config: Partial<HairPhysicsConfig>): void;
-    getConfig(): HairPhysicsConfig;
-    reset(): void;
-    dispose(): void;
-}
-export declare function createRustHairPhysics(config?: Partial<HairPhysicsConfig>): Promise<RustHairPhysics>;
-export declare function packHairConfig(config?: Partial<HairPhysicsConfig>): Float32Array;
-export declare function packHeadState(headState: HeadState): Float32Array;
-export declare function unpackHairConfig(values: ArrayLike<number>): HairPhysicsConfig;
-export declare function unpackHairState(values: ArrayLike<number>): HairPhysicsState;
-export declare function unpackHairMorphOutput(values: ArrayLike<number>): HairMorphOutput;

package/dist/physics/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Embody - Physics Exports
- */
-export { HairPhysics, DEFAULT_HAIR_PHYSICS_CONFIG, } from './HairPhysics';
-export { RustHairPhysics, createRustHairPhysics, packHairConfig, packHeadState, unpackHairConfig, unpackHairMorphOutput, unpackHairState, } from './RustHairPhysics';
-export type { HairPhysicsConfig, HairPhysicsState, HairMorphOutput, HeadState, } from './HairPhysics';