@streamoji/aitwin 0.5.1 → 0.5.3

package/dist/index.d.ts

@@ -6,6 +6,15 @@ export declare const AI_TWIN_THUMBNAIL_FILENAME = "thumbnail.webp";
 
 export declare const AiTwin: ForwardRefExoticComponent<AiTwinProps & RefAttributes<AiTwinHandle>>;
 
+export declare type AiTwinCaptionsOptions = {
+    /** CSS font-family, e.g. "Inter, sans-serif" or "Georgia, serif". */
+    fontFamily?: string;
+    /** CSS font-size, e.g. "1rem" or "18px". Default: clamp for readability. */
+    fontSize?: string;
+    /** Text color. Default: rgba(255,255,255,0.85). */
+    color?: string;
+};
+
 export declare type AiTwinHandle = {
     speakText: (text: string, options?: AvatarTtsSpeakOptions) => Promise<void>;
     stop: () => void;
@@ -16,8 +25,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;
@@ -106,6 +119,8 @@ export declare type AiTwinProps = {
      * atlas handling. Omit to use the device limit.
      */
     pixiMaxTextureSize?: number;
+    /** Plain subtitles during TTS/voice playback. */
+    captions?: boolean | AiTwinCaptionsOptions;
 };
 
 export declare type AiTwinRecord = {
@@ -375,6 +390,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 +430,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.3",
   "description": "Embeddable React AI twin face with TTS lipsync",
   "type": "module",
   "main": "./dist/aitwin.cjs",