@lovelace_lol/embody 0.0.15 → 0.0.17

package/dist/three/vrm-animation.d.ts

@@ -0,0 +1,70 @@
+import { AnimationClip } from 'three';
+import type { Object3D } from 'three';
+import type { ThreeModelReferencePose } from './reference-pose';
+type Vec3 = [number, number, number];
+type Quat = [number, number, number, number];
+type RigNode = {
+    id: string;
+    name: string;
+    parent: string | null;
+    translation: Vec3;
+    rotation: Quat;
+    scale: Vec3;
+};
+type Rig = {
+    metersPerUnit: number;
+    nodes: RigNode[];
+    humanoidBones: Record<string, string>;
+};
+type AnimationTrack = {
+    node: string;
+    path: 'rotation' | 'translation' | 'scale';
+    interpolation: 'STEP' | 'LINEAR';
+    times: number[];
+    values: number[];
+};
+/** Validated body-animation intermediate, not a file format. Persist the .vrma GLB bytes. */
+export type VrmAnimationDocument = {
+    version: 1;
+    name: string;
+    durationSeconds: number;
+    rig: Rig;
+    tracks: AnimationTrack[];
+};
+/** Metres represented by one model coordinate unit; always supplied by the caller. */
+export type VrmAnimationUnits = {
+    metersPerUnit: number;
+};
+export type VrmAnimationFile = {
+    name: string;
+    bytes: Uint8Array;
+};
+export type VrmAnimationInfo = {
+    name: string;
+    durationSeconds: number;
+    trackCount: number;
+};
+export type MixamoVrmAnimationOptions = {
+    /** Mixamo FBX generally uses centimeters (0.01); this is explicit, never inferred. */
+    metersPerUnit: number;
+    /** Authored T reference; omission requires skin bind inverses. Never pass frame zero. */
+    referencePose?: ThreeModelReferencePose;
+};
+export type VrmAnimationTargetOptions = {
+    metersPerUnit: number;
+    referencePose: ThreeModelReferencePose;
+    /** Existing Embody profile; resolved with Rust's humanoid characterization. */
+    profile?: unknown;
+    /** Explicit VRM role -> unique target bone name, taking precedence over profile. */
+    humanoidBones?: Record<string, string>;
+    name?: string;
+};
+/** Pure conversion with borrowed native objects: no mixer, scene mutation, loading or disposal. */
+export declare function convertMixamoToVrmAnimation(source: Object3D, clip: AnimationClip, options: MixamoVrmAnimationOptions): Uint8Array;
+/** Validates embedded binary/accessors, humanoid hierarchy, reference and supported channels. */
+export declare function inspectVrmAnimation(bytes: Uint8Array): VrmAnimationDocument;
+/** Builds native target-local tracks. The caller owns mixer scheduling and blending. */
+export declare function createAnimationClipFromVrmAnimation(bytes: Uint8Array, target: Object3D, options: VrmAnimationTargetOptions): AnimationClip;
+/** Browser FBX boundary: textures are never fetched; temporary parser objects are released. */
+export declare function convertMixamoFbxToVrmAnimations(bytes: ArrayBuffer, options: VrmAnimationUnits): VrmAnimationFile[];
+export {};