@streamoji/aitwin 0.5.1 → 0.5.2

package/dist/index.d.ts

@@ -16,8 +16,12 @@ export declare type AiTwinHandle = {
      * Suspends idle video until the next speak/stop clears preview mode.
      */
     setEmotion: (emotion: string) => void;
+    /** Hold a still mouth viseme preview (Oculus id, e.g. aa, PP, sil). */
+    setViseme: (viseme: string) => void;
     /** Active expression preview emotion, or null when not in preview mode. */
     getEmotion: () => string | null;
+    /** Active viseme preview id, or null when not in viseme preview mode. */
+    getViseme: () => string | null;
     /** Leave expression preview and return to normal idle. */
     clearEmotionPreview: () => void;
     isReady: () => boolean;
@@ -375,6 +379,11 @@ declare type SkippedVisemeEntry = {
     vtime: number;
 };
 
+/** Round each viseme vtime to the nearest grid slot for playback spacing. */
+export declare function snapVisemeQueueToGrid(queue: VisemeQueueItem[], gridMs?: number): VisemeQueueItem[];
+
+export declare function snapVisemeVtimeToGrid(vtime: number, gridMs?: number): number;
+
 export declare const SPEAKING_RATE_MAX = 1.5;
 
 export declare const SPEAKING_RATE_MIN = 0.5;
@@ -410,6 +419,9 @@ export declare const VISEME_TEST_SPEAKING_RATE = 0.85;
 /** Viseme-test page: fixed female voice + speech speed for /avatar_ttsWithPoses. */
 export declare const VISEME_TEST_VOICE_ID = "Olivia";
 
+/** Align viseme vtimes to this grid (matches transition frame tick). */
+export declare const VISEME_VTIME_GRID_MS = 16;
+
 export declare interface VisemeQueueItem {
     viseme: string;
     weight: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamoji/aitwin",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Embeddable React AI twin face with TTS lipsync",
   "type": "module",
   "main": "./dist/aitwin.cjs",