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

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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).
 

package/dist/{StreamingAudioPlayer-BL5cZ22i.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-C4RgEOS1.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/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-C4RgEOS1.js → index-cfYSlUmQ.js}

@@ -7639,7 +7639,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BL5cZ22i.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.56");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.57");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -14500,6 +14500,9 @@ class AvatarView {
   }
   handleInterrupt() {
     const state = this.renderingState;
+    if (state === "idle") {
+      return;
+    }
     if (state === "transitioningToIdle") {
       return;
     }
@@ -14680,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-C4RgEOS1.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/package.json

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