@spatialwalk/avatarkit 1.0.0-beta.83 → 1.0.0-beta.85

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 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.85] - 2026-03-03
+
+### 🐛 Bugfixes
+- **Startup Transition Continuity** - Fixed first-round playback jump by generating start transition from the currently displayed idle frame instead of fixed idle frame 0
+- **Startup Rendering Order** - Emit `startRendering` only after startup transition frames are injected to avoid first-frame state mismatch
+
+### ✅ Tests
+- Added regression tests for startup transition continuity and startup ordering to prevent reintroduction
+
+## [1.0.0-beta.84] - 2026-03-03
+
+### 🐛 Bugfixes
+- **End-Transition Continuity** - Fixed the visual jump after conversation end transition by resetting idle frame cursor when returning to `Idle` state
+
 ## [1.0.0-beta.83] - 2026-03-03
 
 ### 🐛 Bugfixes

package/dist/{StreamingAudioPlayer-yvKtEWGz.js → StreamingAudioPlayer-By5EueKJ.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, l as logger, e as errorToMessage, a as logEvent } from "./index-CQqZD1OY.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-vzFN-bug.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {

package/dist/core/AvatarController.d.ts

@@ -11,6 +11,7 @@ export declare class AvatarController {
     onError: ((error: Error) => void) | null;
     private eventListeners;
     private renderCallback?;
+    private getCurrentIdleFrameCallback?;
     private characterHandle;
     private characterId;
     private postProcessingConfig;

package/dist/{index-CQqZD1OY.js → index-vzFN-bug.js}

@@ -9491,7 +9491,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-yvKtEWGz.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-By5EueKJ.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -11220,7 +11220,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.83");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.85");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -12217,6 +12217,7 @@ class AvatarController {
     __publicField(this, "eventListeners", /* @__PURE__ */ new Map());
     // ========== Callbacks ==========
     __publicField(this, "renderCallback");
+    __publicField(this, "getCurrentIdleFrameCallback");
     __publicField(this, "characterHandle", null);
     // Character handle for multi-character support
     __publicField(this, "characterId", null);
@@ -13003,6 +13004,7 @@ class AvatarController {
    * @internal
    */
   setupInternalEventListeners(callbacks) {
+    this.getCurrentIdleFrameCallback = callbacks.getCurrentIdleFrame;
     if (callbacks.onKeyframesUpdate) {
       this.registerEventListener("keyframesUpdate", callbacks.onKeyframesUpdate);
     }
@@ -13061,11 +13063,11 @@ class AvatarController {
           conversationId: ((_b2 = this.networkLayer) == null ? void 0 : _b2.getCurrentConversationId()) || void 0
         });
       });
-      this.emit("startRendering");
       const transitionFrames = await this.generateStartTransitionFrames();
       if (transitionFrames.length > 0) {
         this.currentKeyframes.unshift(...transitionFrames);
       }
+      this.emit("startRendering");
       const silenceDurationS = START_TRANSITION_DURATION_MS / 1e3;
       const silenceChunk = this.createSilencePCMChunk(silenceDurationS);
       const audioChunksWithSilence = [
@@ -13114,8 +13116,11 @@ class AvatarController {
       if (!toFrame) return [];
       const toFrameWithPP = this.applyPostProcessingToFlame(toFrame);
       let fromFrame = null;
+      if (this.getCurrentIdleFrameCallback) {
+        fromFrame = await this.getCurrentIdleFrameCallback();
+      }
       const avatarCore = AvatarSDK.getAvatarCore();
-      if (avatarCore && this.characterId) {
+      if (!fromFrame && avatarCore && this.characterId) {
         const idleParams = await avatarCore.getCurrentFrameParams(0, this.characterId);
         fromFrame = convertWasmParamsToProtoFlame(idleParams);
       }
@@ -16393,6 +16398,28 @@ class AvatarView {
     }
     return this.cachedIdleFirstFrame;
   }
+  /**
+   * Get the currently displayed idle frame.
+   * Used as the start frame for idle -> speaking transition to avoid startup jump.
+   * @internal
+   */
+  async getCurrentDisplayedIdleFrame() {
+    if (this.renderingState !== "idle") {
+      return null;
+    }
+    const avatarCore = AvatarSDK.getAvatarCore();
+    if (!avatarCore) {
+      return null;
+    }
+    try {
+      const displayedIndex = Math.max(0, this.idleCurrentFrameIndex - 1);
+      const idleParams = await avatarCore.getCurrentFrameParams(displayedIndex, this.characterId);
+      return convertWasmParamsToProtoFlame(idleParams);
+    } catch (e2) {
+      logger.warn("[AvatarView] Failed to get current idle frame:", e2 instanceof Error ? e2.message : String(e2));
+      return null;
+    }
+  }
   /**
    * Get controller (public interface)
    */
@@ -16806,6 +16833,7 @@ class AvatarView {
       this.endTransitionFrames = [];
       this.isConversationActive = false;
       this.currentPlayingFrame = null;
+      this.idleCurrentFrameIndex = 0;
     }
   }
   /**
@@ -16851,6 +16879,9 @@ class AvatarView {
       },
       onInterrupt: () => {
         this.handleInterrupt();
+      },
+      getCurrentIdleFrame: async () => {
+        return this.getCurrentDisplayedIdleFrame();
       }
     });
   }

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-CQqZD1OY.js";
+import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-vzFN-bug.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.83",
+  "version": "1.0.0-beta.85",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",
@@ -62,8 +62,12 @@
     "next": ">=13.0.0"
   },
   "peerDependenciesMeta": {
-    "vite": { "optional": true },
-    "next": { "optional": true }
+    "vite": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.10.0",