@lovelace_lol/embody 0.0.1

package/dist/engines/three/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Three.js Engine Implementation
+ */
+export { Embody, buildFrameApplierBindings, collectMorphMeshes, } from './Embody';
+export { ThreeAnimationRuntime, ThreeAnimationSystem, AnimationController, BakedAnimationController, } from './ThreeAnimationRuntime';
+export type { ThreeAnimationSystemHost, ThreeAnimationSystemOptions, AnimationControllerHost, BakedAnimationHost, } from './ThreeAnimationRuntime';
+export { ThreeModelInspector } from './ThreeModelInspector';
+export type { ThreeAnimationClipDescriptor, ThreeAnimationTrackDescriptor, ThreeModelInspection, ThreeModelInspectionOptions, } from './ThreeModelInspector';
+export { THREE_BLENDING_MODES, ThreeFrameApplier } from './ThreeFrameApplier';
+export { ThreeClipAdapter } from './ThreeClipAdapter';
+export type { ThreeFrameApplierBindings, ThreeMaterialConfig, ThreeMorphTargetBinding, ThreeResolvedMaterialConfig, } from './ThreeFrameApplier';
+export type { ThreeClipAdapterBindings, ThreeClipMeshBinding, ThreeClipMorphTargetBinding, } from './ThreeClipAdapter';
+export { HairPhysicsController } from './hair/HairPhysicsController';
+export type { HairPhysicsHost } from './hair/HairPhysicsController';
+export { createCharacterHost, } from './characterHost';
+export type { CharacterHost, CharacterHostCharacterOptions, CharacterHostExternalScene, CharacterHostOptions, } from './characterHost';
+export { CHARACTER_SCENE_TYPE_IDS, CHARACTER_SCENE_TYPES, createDefaultCharacterLighting, createDefaultCharacterScene, createShadowPlane, DEFAULT_CHARACTER_LIGHTING_PRESET_ID, DEFAULT_CHARACTER_LIGHTING_PRESET_IDS, DEFAULT_CHARACTER_LIGHTING_PRESETS, DEFAULT_CHARACTER_LIGHTING_SETTINGS, DEFAULT_CHARACTER_SCENE_TYPE_ID, normalizeDefaultCharacterLightingSettings, } from './characterScene';
+export type { CharacterSceneTypeDefinition, CharacterSceneTypeId, DefaultCharacterLightingController, DefaultCharacterLightingPresetId, DefaultCharacterLightingSettings, DefaultCharacterScene, DefaultCharacterSceneOptions, } from './characterScene';
+export { applyCharacterModelTransform, disposeCharacterModel, loadCharacterModel, parseCharacterModel, } from './modelLoader';
+export type { CharacterModelLoadOptions, CharacterModelLoadResult, CharacterModelTransform, } from './modelLoader';

package/dist/engines/three/modelLoader.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Character model loader for Embody hosts.
+ *
+ * Loads GLB/GLTF (optional Draco) and FBX, collects morph meshes, and provides
+ * dispose helpers. App-specific asset routing (CDN aliases, HTML probing) stays
+ * outside Embody — pass a resolved URL or ArrayBuffer.
+ */
+import { type AnimationClip, type Mesh, type Object3D, type Scene } from 'three';
+import { type GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+export interface CharacterModelLoadResult {
+    model: Object3D;
+    meshes: Mesh[];
+    animations: AnimationClip[];
+    gltf: GLTF | null;
+}
+export interface CharacterModelLoadOptions {
+    /** Load progress callback (0-100). */
+    onProgress?: (progress: number) => void;
+    /** Enable shadow casting on meshes. Default: true */
+    castShadows?: boolean;
+    /** Draco decoder base path. Default: '/draco-gltf/' */
+    dracoDecoderPath?: string;
+}
+export interface CharacterModelTransform {
+    modelOffset?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    modelRotation?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    /**
+     * Positive finite uniform scale applied to the model root.
+     * Omit this field to preserve the scale authored in the model asset.
+     */
+    modelScale?: number;
+    /** Lift model so its lowest point clears this Y value. */
+    modelGroundClearance?: number;
+}
+/**
+ * Apply optional placement transforms used by character profiles.
+ */
+export declare function applyCharacterModelTransform(model: Object3D, transform?: CharacterModelTransform): void;
+/**
+ * Dispose a model graph and remove it from a scene when present.
+ *
+ * Handles any renderable object (Mesh, Points, Line, ...) and releases
+ * textures referenced by materials.
+ */
+export declare function disposeCharacterModel(scene: Scene | null, model: Object3D): void;
+/**
+ * Load a character model from a URL (GLB/GLTF or FBX).
+ */
+export declare function loadCharacterModel(url: string, options?: CharacterModelLoadOptions): Promise<CharacterModelLoadResult>;
+/**
+ * Parse a character model from an already-fetched ArrayBuffer.
+ */
+export declare function parseCharacterModel(data: ArrayBuffer, resourcePath?: string, options?: CharacterModelLoadOptions): Promise<CharacterModelLoadResult>;

package/dist/engines/three/profileTestScene.d.ts

@@ -0,0 +1,52 @@
+import { AnimationClip, BufferGeometry, Mesh, Object3D } from 'three';
+import type { KeyframeTrack } from 'three';
+import type { Profile } from '../../mappings/types';
+import type { SnippetChannel } from '../../core/types';
+import { Embody } from './Embody';
+export declare const FACE_MORPHS: readonly ["BrowUp_L", "BrowUp_R", "BrowCenter", "Smile", "LookLeft", "LookRight", "RuntimeSmile"];
+export declare const VISEME_MORPHS: readonly ["Mouth_Aah", "Mouth_Wide", "Shared_Mouth"];
+export declare const HAIR_MORPHS: readonly ["L_Hair_Left", "L_Hair_Right", "L_Hair_Front", "Fluffy_Right", "Fluffy_Bottom_ALL", "Hairline_High_ALL", "Length_Short"];
+export type ProfileTestScene = {
+    profile: Profile;
+    model: Object3D;
+    engine: Embody;
+    face: Mesh;
+    viseme: Mesh;
+    hair: Mesh;
+    head: Object3D;
+    jaw: Object3D;
+    body: Object3D;
+    camera: Object3D;
+};
+export declare function makeMorphGeometry(morphKeys?: readonly string[]): BufferGeometry;
+export declare function makeMorphMesh(name: string, morphKeys?: readonly string[]): Mesh;
+export declare function makeTestProfile(overrides?: Partial<Profile>): Profile;
+export declare function makeProfileTestScene(profile?: Profile): ProfileTestScene;
+export declare function makePolymerLipVocalChannels(): SnippetChannel[];
+export declare function makePolymerJawVocalChannels(): SnippetChannel[];
+export declare function makePolymerCombinedVocalChannels(): SnippetChannel[];
+export declare function round(value: number, digits?: number): number;
+export declare function snapshotMorphInfluences(mesh: Mesh): Record<string, number>;
+export declare function snapshotBones(engine: Embody): Record<string, {
+    position: number[];
+    rotation: number[];
+}>;
+export declare function normalizeTrackName(trackName: string, scene: Pick<ProfileTestScene, 'face' | 'viseme' | 'hair' | 'head' | 'jaw' | 'body' | 'camera'>): string;
+export declare function snapshotTrack(track: KeyframeTrack, scene: Pick<ProfileTestScene, 'face' | 'viseme' | 'hair' | 'head' | 'jaw' | 'body' | 'camera'>): {
+    name: string;
+    type: string;
+    times: number[];
+    values: number[];
+};
+export declare function snapshotClip(clip: AnimationClip, scene: Pick<ProfileTestScene, 'face' | 'viseme' | 'hair' | 'head' | 'jaw' | 'body' | 'camera'>): {
+    name: string;
+    duration: number;
+    trackCount: number;
+    tracks: {
+        name: string;
+        type: string;
+        times: number[];
+        values: number[];
+    }[];
+};
+export declare function makeMixedBakedClip(scene: Pick<ProfileTestScene, 'face' | 'head' | 'body' | 'camera'>): AnimationClip;

package/dist/engines/three/types.d.ts

@@ -0,0 +1,20 @@
+import type { Object3D, Quaternion } from 'three';
+/**
+ * Snapshot of a bone node's baseline transform.
+ */
+export interface NodeBase {
+    obj: Object3D;
+    basePos: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    baseQuat: Quaternion;
+    baseEuler: {
+        x: number;
+        y: number;
+        z: number;
+        order: string;
+    };
+}
+export type ResolvedBones = Partial<Record<string, NodeBase>>;

package/dist/hair/appearance.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hair / eyebrow material appearance helpers.
+ *
+ * These are runtime material controls owned by Embody — not Polymer agencies.
+ * Agencies govern character behavior; hair materials and physics stay here.
+ */
+export interface HairColorAppearance {
+    name?: string;
+    baseColor: string;
+    emissive: string;
+    emissiveIntensity: number;
+}
+export interface HairAppearanceState {
+    hairColor: Required<Pick<HairColorAppearance, 'baseColor' | 'emissive' | 'emissiveIntensity'>> & {
+        name?: string;
+    };
+    eyebrowColor: Required<Pick<HairColorAppearance, 'baseColor' | 'emissive' | 'emissiveIntensity'>> & {
+        name?: string;
+    };
+    showOutline: boolean;
+    outlineColor: string;
+    outlineOpacity: number;
+}
+export declare const HAIR_COLOR_PRESETS: Record<string, Required<HairColorAppearance>>;
+export declare const DEFAULT_HAIR_COLOR_APPEARANCE: Required<HairColorAppearance>;
+export declare function normalizeHairColorAppearance(value: HairColorAppearance | string | null | undefined, fallback?: Required<HairColorAppearance>): Required<HairColorAppearance>;
+export declare function colorToCssHex(color: {
+    getHexString(): string;
+} | undefined | null): string | null;