@spatialwalk/avatarkit 1.0.0-beta.55 → 1.0.0-beta.57

package/CHANGELOG.md

@@ -2,9 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0-beta.57] - 2026-01-09
+
+### 🐛 Bugfixes
+- **Idle Animation Jiggle Fix** - Fixed issue where idle animation would "jiggle" before transitioning to speaking when external audio and animation data were sent. The `handleInterrupt()` method now correctly skips processing when already in `Idle` state, preventing unnecessary idle loop restarts.
+
+## [1.0.0-beta.56] - 2026-01-09
+
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-beta.56] - 2025-01-05
+
+### ✨ New Features
+- **Eye Tracking Config API** - Changed `eyeTrackingEnabled` to complete `eyefocus` configuration object in `PostProcessingConfig`. External callers must provide full `eyefocus` configuration (enabled, auto_eyelid_adjustment, eyelid_threshold, targets) instead of just a boolean flag.
+
 ## [1.0.0-beta.55] - 2025-01-05
 
 ### ✨ New Features

package/dist/{StreamingAudioPlayer-C6hiS_B5.js → StreamingAudioPlayer-Co3xec_k.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-WcnOBRys.js";
+import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-cfYSlUmQ.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);

package/dist/core/AvatarController.d.ts

@@ -60,7 +60,7 @@ export declare class AvatarController {
     private getEffectiveConversationId;
     getPointCount(): number | null;
     setPostProcessingConfig(config: PostProcessingConfig | null): void;
-    private updateEyeTrackingEnabled;
+    private setEyeTrackingConfig;
     private rerenderCurrentFrame;
     setVolume(volume: number): void;
     getVolume(): number;

package/dist/core/AvatarView.d.ts

@@ -1,3 +1,4 @@
+import { Flame } from '../generated/driveningress/v1/driveningress';
 import { Avatar } from './Avatar';
 import { AvatarController } from './AvatarController';
 export declare class AvatarView {
@@ -56,6 +57,7 @@ export declare class AvatarView {
     private startRealtimeRendering;
     private stopRealtimeRendering;
     dispose(): void;
+    renderFlame(flame: Flame): Promise<void>;
     private rerenderCurrentFrameWithNewCamera;
     private handleResize;
     get transform(): {

package/dist/docs/render-flame-api-example.d.ts

@@ -0,0 +1,28 @@
+import { AvatarView, Flame } from '@spatialwalk/avatarkit';
+declare function initializeSDK(): Promise<void>;
+declare function createAvatarView(characterId: string, container: HTMLElement): Promise<AvatarView>;
+declare function fetchFlameDataFromServer(characterId: string, audioData: ArrayBuffer): Promise<Flame[]>;
+declare class FlameRenderer {
+    private avatarView;
+    private keyframes;
+    private currentFrameIndex;
+    private animationFrameId;
+    private isPlaying;
+    private fps;
+    private frameInterval;
+    private lastRenderTime;
+    constructor(avatarView: AvatarView);
+    setKeyframes(keyframes: Flame[]): void;
+    start(): void;
+    stop(): void;
+    renderFrame(frameIndex: number): Promise<void>;
+    private renderLoop;
+    setFPS(fps: number): void;
+    seek(frameIndex: number): void;
+    getCurrentFrameIndex(): number;
+    getTotalFrames(): number;
+}
+declare function main(): Promise<void>;
+declare function fetchAudioData(): Promise<ArrayBuffer>;
+
+export { initializeSDK, createAvatarView, fetchFlameDataFromServer, FlameRenderer, main, fetchAudioData };

package/dist/{index-WcnOBRys.js → index-cfYSlUmQ.js}

@@ -7639,7 +7639,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-C6hiS_B5.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-Co3xec_k.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -9062,7 +9062,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.55");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.57");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -11212,31 +11212,36 @@ class AvatarController {
   }
   setPostProcessingConfig(config) {
     this.postProcessingConfig = config;
-    if ((config == null ? void 0 : config.eyeTrackingEnabled) !== void 0) {
-      this.updateEyeTrackingEnabled(config.eyeTrackingEnabled).catch((error) => {
-        logger.warn("[AvatarController] Failed to update eye tracking enabled state:", error instanceof Error ? error.message : String(error));
+    if (config == null ? void 0 : config.eyefocus) {
+      this.setEyeTrackingConfig(config.eyefocus).catch((error) => {
+        logger.warn("[AvatarController] Failed to set eye tracking config:", error instanceof Error ? error.message : String(error));
       });
     }
     if (this.currentState === AvatarState.paused && this.isPlaying) {
       this.rerenderCurrentFrame();
     }
   }
-  async updateEyeTrackingEnabled(enabled) {
-    var _a;
+  async setEyeTrackingConfig(eyefocus) {
     const avatarCore = AvatarSDK.getAvatarCore();
     if (!avatarCore || !this.characterId) {
       return;
     }
     try {
-      const characterMeta = this.avatar.getCharacterMeta();
-      const eyefocus = (_a = characterMeta.characterSettings) == null ? void 0 : _a.eyefocus;
       await avatarCore.setEyeTrackingConfig({
-        enabled,
-        auto_eyelid_adjustment: (eyefocus == null ? void 0 : eyefocus.auto_eyelid_adjustment) ?? true,
-        eyelid_threshold: (eyefocus == null ? void 0 : eyefocus.eyelid_threshold) ?? 0.2
+        enabled: eyefocus.enabled,
+        auto_eyelid_adjustment: eyefocus.auto_eyelid_adjustment ?? true,
+        eyelid_threshold: eyefocus.eyelid_threshold ?? 0.2
       }, this.characterId);
+      if (eyefocus.targets && eyefocus.targets.length >= 3) {
+        await avatarCore.setGazeTarget(
+          eyefocus.targets[0],
+          eyefocus.targets[1],
+          eyefocus.targets[2],
+          this.characterId
+        );
+      }
     } catch (error) {
-      logger.warn("[AvatarController] Failed to update eye tracking enabled state:", error instanceof Error ? error.message : String(error));
+      logger.warn("[AvatarController] Failed to set eye tracking config:", error instanceof Error ? error.message : String(error));
     }
   }
   async rerenderCurrentFrameIfPaused() {
@@ -14137,7 +14142,7 @@ class AvatarView {
             auto_eyelid_adjustment: eyefocus.auto_eyelid_adjustment,
             eyelid_threshold: eyefocus.eyelid_threshold
           }, this.characterId);
-          if (eyefocus.enabled && eyefocus.targets && eyefocus.targets.length >= 3) {
+          if (eyefocus.targets && eyefocus.targets.length >= 3) {
             await avatarCore.setGazeTarget(
               eyefocus.targets[0],
               eyefocus.targets[1],
@@ -14495,6 +14500,9 @@ class AvatarView {
   }
   handleInterrupt() {
     const state = this.renderingState;
+    if (state === "idle") {
+      return;
+    }
     if (state === "transitioningToIdle") {
       return;
     }
@@ -14675,6 +14683,30 @@ class AvatarView {
       }
     }
   }
+  async renderFlame(flame) {
+    if (!this.isInitialized || !this.renderSystem) {
+      throw new Error("AvatarView not initialized");
+    }
+    try {
+      const processedFlame = this.avatarController.applyPostProcessingToFlame(flame);
+      const wasmParams = convertProtoFlameToWasmParams(processedFlame);
+      const avatarCore = AvatarSDK.getAvatarCore();
+      if (!avatarCore) {
+        throw new Error("AvatarCore not available");
+      }
+      const splatData = await avatarCore.computeFrameFlatFromParams(
+        wasmParams,
+        this.characterHandle ?? void 0
+      );
+      if (splatData) {
+        this.renderSystem.loadSplatsFromPackedData(splatData);
+        this.renderSystem.renderFrame();
+      }
+    } catch (error) {
+      logger.error("[AvatarView] Failed to render flame:", error instanceof Error ? error.message : String(error));
+      throw error;
+    }
+  }
   async rerenderCurrentFrameWithNewCamera() {
     if (this.avatarController.state !== AvatarState.paused || this.renderingState !== "speaking" || !this.renderSystem) {
       return;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-WcnOBRys.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-cfYSlUmQ.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/types/index.d.ts

@@ -131,6 +131,11 @@ export interface PostProcessingConfig {
     };
     eyeBlink?: number;
     expressionWeight?: number;
-    eyeTrackingEnabled?: boolean;
+    eyefocus?: {
+        enabled: boolean;
+        auto_eyelid_adjustment?: boolean;
+        eyelid_threshold?: number;
+        targets?: number[];
+    };
 }
 export * from './character';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.55",
+  "version": "1.0.0-beta.57",
   "packageManager": "pnpm@10.18.2",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",