@streamoji/aitwin 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -79,6 +79,8 @@ export declare type AiTwinProps = {
     onBotOutput?: (text: string) => void;
     /** Voice lipsync debug (viseme segments, clock, queue). */
     onRealtimeLipsyncDebug?: (snapshot: RealtimeLipsyncDebugSnapshot) => void;
+    /** Canvas render skip stats (RIFE transitions, draw coalescing, visemes). */
+    onFrameRenderStats?: (stats: FrameRenderStatsSnapshot) => void;
 };
 
 export declare type AiTwinRecord = {
@@ -148,6 +150,55 @@ export declare function fetchAiTwin(id: string, baseUrl?: string): Promise<AiTwi
 /** Bearer token for /avatar_ttsWithPoses and /api/session-value. */
 export declare function fetchDevAuthToken(): Promise<string>;
 
+export declare type FrameRenderDrawContext = {
+    label: string;
+    elapsedMs: number;
+    mouthPath: string | null;
+    transitionMeta?: FrameRenderTransitionMeta;
+};
+
+export declare type FrameRenderStatsSnapshot = {
+    rafTicksSpeaking: number;
+    /** Same draw key as previous RAF sample (healthy coalescing). */
+    rafTicksDeduped: number;
+    drawsRequested: number;
+    drawsDisplayed: number;
+    queueSuperseded: number;
+    workerStale: number;
+    /** Real drops: queue + worker stale + undisplayed requests. */
+    renderLoss: number;
+    visemeSlotsTotal: number;
+    visemeSlotsCovered: number;
+    visemeCoveragePct: number;
+    transitionFramesUniqueSampled: number;
+    transitionFramesUniquePainted: number;
+    transitionFramesMissed: number;
+    rifeFramesOmittedByGap: number;
+    transitionFramesSampled: number;
+    transitionFramesDisplayed: number;
+    /** @deprecated Use `rafTicksDeduped`. */
+    drawsDeduped: number;
+    /** @deprecated Use `renderLoss`. */
+    renderSkips: number;
+    /** @deprecated Use `visemeSlotsCovered`. */
+    visemesShown: number;
+    /** @deprecated Use `visemeSlotsTotal - visemeSlotsCovered`. */
+    visemesSkipped: number;
+    /** @deprecated Use `transitionFramesMissed`. */
+    rifeTransitionFramesSkipped: number;
+};
+
+declare type FrameRenderTransitionMeta = {
+    from: string;
+    to: string;
+    fromVtime: number;
+    toVtime: number;
+    frameIdx: number;
+    frameCount: number;
+    fullFrameCount: number;
+    omittedByGap: number;
+};
+
 /** Public CDN original portrait for custom-faces/{faceId}/ (same id as pipeline avatarId). */
 export declare function getAiTwinSourceUrl(faceId: string, cdnBase?: string, extension?: string): string;
 

package/package.json

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