@spatialwalk/avatarkit 1.0.0-beta.58 → 1.0.0-beta.59

package/CHANGELOG.md

@@ -2,13 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
-## [1.0.0-beta.58] - 2026-01-12
+## [1.0.0-beta.59] - 2026-01-14
+
+### 🐛 Bugfixes
+- **AudioContext Auto-Resume** - Fixed issue where audio playback would get stuck after external applications request recording permissions. AudioContext now automatically resumes when suspended during playback
+- **PostHog Instance Initialization** - Fixed PostHog named instance initialization to avoid conflicts with external PostHog instances
+
+## [1.0.0-beta.58] - 2026-01-14
 
 ### ✨ New Features
-- **Transition Duration Control API** - Added `setTransitionDuration(isStart: boolean, durationMs: number)` method to `AvatarView` to configure transition animation durations:
-  - `isStart: true` configures the start transition duration (Idle -> Speaking), default 400ms
-  - `isStart: false` configures the end transition duration (Speaking -> Idle), default 1600ms
-  - Allows external applications to customize transition animation timing
+- **Pure Rendering Mode APIs** - Added `renderFlame()` and `generateTransitionFromIdle()` methods to `AvatarView` for external-controlled rendering without audio synchronization
 
 ## [1.0.0-beta.57] - 2026-01-09
 

package/dist/{StreamingAudioPlayer-Cka1VDtX.js → StreamingAudioPlayer-BbUBoPqm.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-wQJM-Vug.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-B0MJ_hCJ.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);
@@ -27,6 +27,8 @@ class StreamingAudioPlayer {
     __publicField(this, "gainNode", null);
     __publicField(this, "volume", 1);
     __publicField(this, "onEndedCallback");
+    __publicField(this, "stateChangeHandler");
+    __publicField(this, "isResuming", false);
     this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     this.sampleRate = (options == null ? void 0 : options.sampleRate) ?? APP_CONFIG.audio.sampleRate;
     this.channelCount = (options == null ? void 0 : options.channelCount) ?? 1;
@@ -46,6 +48,15 @@ class StreamingAudioPlayer {
       if (this.audioContext.state === "suspended") {
         await this.audioContext.resume();
       }
+      this.stateChangeHandler = (event) => {
+        const context = event.target;
+        if (context.state === "suspended" && this.isPlaying && !this.isPaused) {
+          this.ensureAudioContextRunning().catch((err) => {
+            logger.errorWithError("[StreamingAudioPlayer] Failed to auto-resume AudioContext after external suspend:", err);
+          });
+        }
+      };
+      this.audioContext.addEventListener("statechange", this.stateChangeHandler);
       this.log("AudioContext initialized", {
         sessionId: this.sessionId,
         sampleRate: this.audioContext.sampleRate,
@@ -61,11 +72,64 @@ class StreamingAudioPlayer {
       throw error instanceof Error ? error : new Error(message);
     }
   }
+  async ensureAudioContextRunning() {
+    if (!this.audioContext) {
+      return;
+    }
+    const state = this.audioContext.state;
+    if (state === "running") {
+      return;
+    }
+    if (state === "closed") {
+      this.log("AudioContext is closed, cannot resume", {
+        sessionId: this.sessionId,
+        state
+      });
+      return;
+    }
+    if (state === "suspended" && this.isPlaying && !this.isPaused) {
+      if (this.isResuming) {
+        this.log("AudioContext resume already in progress, skipping duplicate request", {
+          sessionId: this.sessionId,
+          state
+        });
+        return;
+      }
+      this.isResuming = true;
+      try {
+        this.log("AudioContext is suspended during playback, resuming...", {
+          sessionId: this.sessionId,
+          state,
+          isPlaying: this.isPlaying,
+          isPaused: this.isPaused
+        });
+        await this.audioContext.resume();
+        this.log("AudioContext resumed successfully", {
+          sessionId: this.sessionId,
+          state: this.audioContext.state
+        });
+      } catch (err) {
+        logger.errorWithError("[StreamingAudioPlayer] Failed to resume AudioContext:", err);
+        logEvent("character_player", "error", {
+          sessionId: this.sessionId,
+          event: "audio_context_resume_failed",
+          reason: err instanceof Error ? err.message : String(err)
+        });
+      } finally {
+        this.isResuming = false;
+      }
+    }
+  }
   addChunk(pcmData, isLast = false) {
     if (!this.audioContext) {
       logger.error("AudioContext not initialized");
       return;
     }
+    if (this.isPlaying && !this.isPaused && this.audioContext.state === "suspended") {
+      this.ensureAudioContextRunning().catch((err) => {
+        logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in addChunk:", err);
+      });
+    }
     this.audioChunks.push({ data: pcmData, isLast });
     this.log(`Added chunk ${this.audioChunks.length}`, {
       size: pcmData.length,
@@ -83,7 +147,9 @@ class StreamingAudioPlayer {
     }
     if (!this.isPlaying && this.autoStartEnabled && this.audioChunks.length > 0) {
       this.log("[StreamingAudioPlayer] Auto-starting playback from addChunk");
-      this.startPlayback();
+      this.startPlayback().catch((err) => {
+        logger.errorWithError("[StreamingAudioPlayer] Failed to start playback from addChunk:", err);
+      });
     } else if (this.isPlaying && !this.isPaused) {
       this.log("[StreamingAudioPlayer] Already playing, scheduling next chunk");
       this.scheduleNextChunk();
@@ -107,7 +173,7 @@ class StreamingAudioPlayer {
       this.addChunk(chunk.data, chunk.isLast);
     }
   }
-  startPlayback() {
+  async startPlayback() {
     if (!this.audioContext) {
       this.log("[StreamingAudioPlayer] Cannot start playback: AudioContext not initialized");
       return;
@@ -116,6 +182,7 @@ class StreamingAudioPlayer {
       this.log("[StreamingAudioPlayer] Cannot start playback: Already playing");
       return;
     }
+    await this.ensureAudioContextRunning();
     this.isPlaying = true;
     this.sessionStartTime = this.audioContext.currentTime;
     this.scheduledTime = this.sessionStartTime;
@@ -126,7 +193,8 @@ class StreamingAudioPlayer {
       sessionStartTime: this.sessionStartTime,
       bufferedChunks: this.audioChunks.length,
       scheduledChunks: this.scheduledChunks,
-      activeSources: this.activeSources.size
+      activeSources: this.activeSources.size,
+      audioContextState: this.audioContext.state
     });
     this.scheduleAllChunks();
   }
@@ -144,6 +212,11 @@ class StreamingAudioPlayer {
       this.log("[StreamingAudioPlayer] Cannot schedule chunk: Not playing or paused");
       return;
     }
+    if (this.audioContext.state === "suspended") {
+      this.ensureAudioContextRunning().catch((err) => {
+        logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in scheduleNextChunk:", err);
+      });
+    }
     const chunkIndex = this.scheduledChunks;
     if (chunkIndex >= this.audioChunks.length) {
       this.log(`[StreamingAudioPlayer] No more chunks to schedule (chunkIndex: ${chunkIndex}, totalChunks: ${this.audioChunks.length})`);
@@ -345,6 +418,7 @@ class StreamingAudioPlayer {
     }
     this.isPlaying = false;
     this.isPaused = false;
+    this.isResuming = false;
     this.sessionStartTime = 0;
     this.scheduledTime = 0;
     for (const source of this.activeSources) {
@@ -373,7 +447,9 @@ class StreamingAudioPlayer {
       return;
     }
     this.autoStartEnabled = true;
-    this.startPlayback();
+    this.startPlayback().catch((err) => {
+      logger.errorWithError("[StreamingAudioPlayer] Failed to start playback from play():", err);
+    });
   }
   markEnded() {
     var _a;
@@ -389,6 +465,10 @@ class StreamingAudioPlayer {
   }
   dispose() {
     this.stop();
+    if (this.audioContext && this.stateChangeHandler) {
+      this.audioContext.removeEventListener("statechange", this.stateChangeHandler);
+      this.stateChangeHandler = void 0;
+    }
     if (this.audioContext) {
       this.audioContext.close();
       this.audioContext = null;

package/dist/audio/StreamingAudioPlayer.d.ts

@@ -27,8 +27,11 @@ export declare class StreamingAudioPlayer {
     private gainNode;
     private volume;
     private onEndedCallback?;
+    private stateChangeHandler?;
+    private isResuming;
     constructor(options?: StreamingAudioPlayerOptions);
     initialize(): Promise<void>;
+    private ensureAudioContextRunning;
     addChunk(pcmData: Uint8Array, isLast?: boolean): void;
     startNewSession(audioChunks: Array<{
         data: Uint8Array;

package/dist/config/sdk-config-loader.d.ts

@@ -1,5 +1,7 @@
 import { Environment } from '../types';
 
+export declare const DEFAULT_SDK_CONFIG: Partial<Record<Environment, string>>;
+
 export declare function fetchSdkConfig(version: string): Promise<Partial<Record<Environment, string>>>;
 
 export declare function clearSdkConfigCache(): void;

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 {
@@ -21,12 +22,12 @@ export declare class AvatarView {
     private currentFPS;
     private transitionKeyframes;
     private transitionStartTime;
-    private startTransitionDurationMs;
-    private endTransitionDurationMs;
+    private readonly transitionDurationMs;
     private cachedIdleFirstFrame;
     private idleCurrentFrameIndex;
     private characterHandle;
     private characterId;
+    private isPureRenderingMode;
     private alignFlamePair;
     private generateAndAlignTransitionFrames;
     private getCachedIdleFirstFrame;
@@ -57,7 +58,8 @@ export declare class AvatarView {
     private startRealtimeRendering;
     private stopRealtimeRendering;
     dispose(): void;
-    setTransitionDuration(isStart: boolean, durationMs: number): void;
+    renderFlame(flame: Flame, enableIdleRendering?: boolean): Promise<void>;
+    generateTransitionFromIdle(toFlame: Flame, frameCount: number): Promise<Flame[]>;
     private rerenderCurrentFrameWithNewCamera;
     private handleResize;
     get transform(): {

package/dist/{index-wQJM-Vug.js → index-B0MJ_hCJ.js}

@@ -7397,19 +7397,7 @@ let isInitialized = false;
 const SDK_POSTHOG_INSTANCE_NAME = "spatialwalk-posthog";
 let sdkPosthogInstance = null;
 const eventQueue = [];
-const FILTERED_HOSTNAMES = ["localhost", "127.0.0.1", "0.0.0.0"];
-function shouldFilterHostname() {
-  if (typeof window === "undefined") {
-    return false;
-  }
-  const hostname = window.location.hostname;
-  return FILTERED_HOSTNAMES.includes(hostname);
-}
 function initializePostHog(environment, version) {
-  if (shouldFilterHostname()) {
-    logger.log(`[PostHog] Tracking disabled due to filtered hostname: ${window.location.hostname}`);
-    return;
-  }
   const { host, apiKey, disableCompression } = getPostHogConfig(environment);
   if (!apiKey) {
     logger.warn(`[PostHog] API Key not configured for environment: ${environment}, tracking disabled`);
@@ -7425,7 +7413,6 @@ function initializePostHog(environment, version) {
     const logContext = idManager.getLogContext();
     Vo.init(apiKey, {
       api_host: host,
-      name: SDK_POSTHOG_INSTANCE_NAME,
       person_profiles: "identified_only",
       capture_pageview: false,
       capture_pageleave: false,
@@ -7455,7 +7442,7 @@ function initializePostHog(environment, version) {
         }
         flushEventQueue();
       }
-    });
+    }, SDK_POSTHOG_INSTANCE_NAME);
   } catch (error) {
     logger.warn("[PostHog] Failed to initialize:", error instanceof Error ? error.message : String(error));
   }
@@ -7505,9 +7492,6 @@ function flushEventQueue() {
   }, 0);
 }
 function trackEvent(event, level = "info", contents = {}) {
-  if (shouldFilterHostname()) {
-    return;
-  }
   const instance = getSdkPosthogInstance();
   if (!instance) {
     eventQueue.push({ event, level, contents });
@@ -7639,7 +7623,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-Cka1VDtX.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BbUBoPqm.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -7786,6 +7770,10 @@ const _AnimationPlayer = class _AnimationPlayer {
 };
 __publicField(_AnimationPlayer, "audioUnlocked", false);
 let AnimationPlayer = _AnimationPlayer;
+const DEFAULT_SDK_CONFIG = {
+  [Environment.cn]: "https://api.open.spatialwalk.top",
+  [Environment.intl]: "https://api.intl.spatialwalk.cloud"
+};
 const configCache = {
   config: null,
   promise: null
@@ -7824,10 +7812,7 @@ async function fetchSdkConfig(version) {
       configCache.config = config;
       logger.log(`[SdkConfigLoader] SDK config fetched successfully:`, config);
     } catch (error) {
-      configCache.config = {
-        [Environment.cn]: "https://api.open.spatialwalk.top",
-        [Environment.intl]: "https://api.intl.spatialwalk.cloud"
-      };
+      configCache.config = { ...DEFAULT_SDK_CONFIG };
       logger.log("[SdkConfigLoader] Using default SDK config:", configCache.config);
     } finally {
       configCache.promise = null;
@@ -8887,6 +8872,7 @@ class AvatarSDK {
       idManager.setAppId(appId);
       logger.log(`[AvatarSDK] Client ID: ${idManager.getClientId()}`);
       initializePostHog(configuration.environment, this._version);
+      this._dynamicSdkConfig = { ...DEFAULT_SDK_CONFIG };
       this._fetchSdkConfig().catch((err) => {
         const message = err instanceof Error ? err.message : String(err);
         logger.warn("Failed to fetch SDK config from remote, using defaults:", message);
@@ -9062,7 +9048,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.58");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.59");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -11419,7 +11405,6 @@ class AvatarController {
       return true;
     }
     const audioContextState = ((_c = streamingPlayer.audioContext) == null ? void 0 : _c.state) || "unknown";
-    const isAudioContextSuspended = audioContextState === "suspended";
     const activeSourcesCount = ((_d = streamingPlayer.activeSources) == null ? void 0 : _d.size) || 0;
     const scheduledChunks = streamingPlayer.scheduledChunks || 0;
     const hasScheduledButNoActive = scheduledChunks > 0 && activeSourcesCount === 0;
@@ -11434,7 +11419,7 @@ class AvatarController {
       state.audioTimeStuckCount = 0;
     }
     state.lastAudioTime = audioTime;
-    const shouldReport = state.audioTimeZeroCount > this.MAX_AUDIO_TIME_ZERO_COUNT || state.audioTimeStuckCount > this.MAX_AUDIO_TIME_STUCK_COUNT || isAudioContextSuspended && this.isPlaying || hasScheduledButNoActive && this.isPlaying;
+    const shouldReport = state.audioTimeZeroCount > this.MAX_AUDIO_TIME_ZERO_COUNT || state.audioTimeStuckCount > this.MAX_AUDIO_TIME_STUCK_COUNT || hasScheduledButNoActive && this.isPlaying;
     if (shouldReport && isNotPaused) {
       state.reported = true;
       logEvent("character_player", "error", {
@@ -11442,7 +11427,6 @@ class AvatarController {
         avatar_id: this.avatar.id,
         conversationId: ((_e2 = this.networkLayer) == null ? void 0 : _e2.getCurrentConversationId()) || void 0,
         audioContextState,
-        isAudioContextSuspended,
         audioTime,
         audioTimeZero: audioTime === 0,
         audioTimeZeroCount: state.audioTimeZeroCount,
@@ -13936,82 +13920,31 @@ function lerpArrays(from, to2, progress) {
   }
   return result2;
 }
-const clamp01 = (x2) => Math.max(0, Math.min(1, x2));
-function createBezierEasing(x1, y1, x2, y2) {
-  const cx = 3 * x1;
-  const bx = 3 * (x2 - x1) - cx;
-  const ax = 1 - cx - bx;
-  const cy = 3 * y1;
-  const by = 3 * (y2 - y1) - cy;
-  const ay = 1 - cy - by;
-  const sampleCurveX = (t2) => ((ax * t2 + bx) * t2 + cx) * t2;
-  const sampleCurveY = (t2) => ((ay * t2 + by) * t2 + cy) * t2;
-  const sampleCurveDerivativeX = (t2) => (3 * ax * t2 + 2 * bx) * t2 + cx;
-  const solveCurveX = (x3) => {
-    let t2 = x3;
-    for (let i2 = 0; i2 < 8; i2++) {
-      const error = sampleCurveX(t2) - x3;
-      if (Math.abs(error) < 1e-6) break;
-      const d2 = sampleCurveDerivativeX(t2);
-      if (Math.abs(d2) < 1e-6) break;
-      t2 -= error / d2;
-    }
-    return t2;
-  };
-  return (x3) => {
-    if (x3 <= 0) return 0;
-    if (x3 >= 1) return 1;
-    return sampleCurveY(solveCurveX(x3));
-  };
-}
-const BEZIER_CURVES = {
-  jaw: createBezierEasing(0.2, 0.8, 0.3, 1),
-  expression: createBezierEasing(0.4, 0, 0.2, 1),
-  eye: createBezierEasing(0.3, 0, 0.1, 1),
-  neck: createBezierEasing(0.1, 0.2, 0.2, 1),
-  global: createBezierEasing(0.42, 0, 0.58, 1)
-};
-const TIME_SCALE = {
-  jaw: 2.5,
-  expression: 1.6,
-  eye: 1.3,
-  neck: 1,
-  global: 1
-};
-function bezierLerp(from, to2, progress) {
-  const getT = (key) => {
-    const scaledProgress = clamp01(progress * TIME_SCALE[key]);
-    return BEZIER_CURVES[key](scaledProgress);
-  };
+function linearLerp(from, to2, progress) {
+  const easedProgress = 0.5 - Math.cos(progress * Math.PI) * 0.5;
   return {
-    translation: lerpArrays(from.translation || [0, 0, 0], to2.translation || [0, 0, 0], getT("global")),
-    rotation: lerpArrays(from.rotation || [0, 0, 0], to2.rotation || [0, 0, 0], getT("global")),
-    neckPose: lerpArrays(from.neckPose || [0, 0, 0], to2.neckPose || [0, 0, 0], getT("neck")),
-    jawPose: lerpArrays(from.jawPose || [0, 0, 0], to2.jawPose || [0, 0, 0], getT("jaw")),
-    eyePose: lerpArrays(from.eyePose || [0, 0, 0, 0, 0, 0], to2.eyePose || [0, 0, 0, 0, 0, 0], getT("eye")),
+    translation: lerpArrays(from.translation || [0, 0, 0], to2.translation || [0, 0, 0], easedProgress),
+    rotation: lerpArrays(from.rotation || [0, 0, 0], to2.rotation || [0, 0, 0], easedProgress),
+    neckPose: lerpArrays(from.neckPose || [0, 0, 0], to2.neckPose || [0, 0, 0], easedProgress),
+    jawPose: lerpArrays(from.jawPose || [0, 0, 0], to2.jawPose || [0, 0, 0], easedProgress),
+    eyePose: lerpArrays(from.eyePose || [0, 0, 0, 0, 0, 0], to2.eyePose || [0, 0, 0, 0, 0, 0], easedProgress),
     eyeLid: (() => {
       const fromEyelid = from.eyeLid;
       const toEyelid = to2.eyeLid;
-      if ((fromEyelid == null ? void 0 : fromEyelid.length) && (toEyelid == null ? void 0 : toEyelid.length))
-        return lerpArrays(fromEyelid, toEyelid, getT("eye"));
+      if (fromEyelid && fromEyelid.length > 0 && toEyelid && toEyelid.length > 0)
+        return lerpArrays(fromEyelid, toEyelid, easedProgress);
       return fromEyelid || toEyelid || [];
     })(),
-    expression: lerpArrays(from.expression || [], to2.expression || [], getT("expression"))
+    expression: lerpArrays(from.expression || [], to2.expression || [], easedProgress)
   };
 }
 function generateTransitionFrames(from, to2, durationMs, fps = 25) {
   const steps = Math.max(1, Math.floor(durationMs / 1e3 * fps));
   const frames = Array.from({ length: steps });
-  if (steps === 1) {
-    frames[0] = to2;
-    return frames;
-  }
   for (let i2 = 0; i2 < steps; i2++) {
     const progress = i2 / (steps - 1);
-    frames[i2] = bezierLerp(from, to2, progress);
+    frames[i2] = linearLerp(from, to2, progress);
   }
-  frames[0] = from;
-  frames[frames.length - 1] = to2;
   return frames;
 }
 class AvatarView {
@@ -14036,12 +13969,12 @@ class AvatarView {
     __publicField(this, "currentFPS", 0);
     __publicField(this, "transitionKeyframes", []);
     __publicField(this, "transitionStartTime", 0);
-    __publicField(this, "startTransitionDurationMs", 400);
-    __publicField(this, "endTransitionDurationMs", 1600);
+    __publicField(this, "transitionDurationMs", 400);
     __publicField(this, "cachedIdleFirstFrame", null);
     __publicField(this, "idleCurrentFrameIndex", 0);
     __publicField(this, "characterHandle", null);
     __publicField(this, "characterId");
+    __publicField(this, "isPureRenderingMode", false);
     this.avatar = avatar;
     this.characterId = `${avatar.id}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     if (!AvatarSDK.configuration) {
@@ -14091,12 +14024,12 @@ class AvatarView {
     toFixed.expression = ensureLen(toFixed.expression, exprLen);
     return { from: fromFixed, to: toFixed };
   }
-  generateAndAlignTransitionFrames(from, to2, durationMs) {
+  generateAndAlignTransitionFrames(from, to2) {
     const aligned = this.alignFlamePair(from, to2);
     let keyframes = generateTransitionFrames(
       aligned.from,
       aligned.to,
-      durationMs,
+      this.transitionDurationMs,
       APP_CONFIG.animation.fps
     );
     if (keyframes.length < 2) {
@@ -14387,6 +14320,10 @@ class AvatarView {
           return;
         }
         lastTime = currentTime;
+        if (this.isPureRenderingMode) {
+          this.idleAnimationLoopId = requestAnimationFrame(renderFrame);
+          return;
+        }
         const avatarCore = AvatarSDK.getAvatarCore();
         if (!avatarCore) {
           return;
@@ -14397,6 +14334,9 @@ class AvatarView {
           if (this.renderingState !== "idle") {
             return;
           }
+          if (this.isPureRenderingMode) {
+            return;
+          }
           this.renderSystem.loadSplatsFromPackedData(splatData);
           this.renderSystem.renderFrame();
         }
@@ -14446,8 +14386,7 @@ class AvatarView {
             return;
           }
           const elapsed = performance.now() - this.transitionStartTime;
-          const currentTransitionDurationMs = state === "transitioningToSpeaking" ? this.startTransitionDurationMs : this.endTransitionDurationMs;
-          const progress = Math.min(1, Math.max(0, elapsed / currentTransitionDurationMs));
+          const progress = Math.min(1, Math.max(0, elapsed / this.transitionDurationMs));
           const steps = this.transitionKeyframes.length;
           const idx = Math.min(steps - 1, Math.floor(progress * (steps - 1)));
           const currentFrame = this.transitionKeyframes[idx];
@@ -14473,7 +14412,7 @@ class AvatarView {
               return;
             }
           }
-          if (state === "transitioningToSpeaking" && this.transitionStartTime > 0 && this.transitionKeyframes.length > 0 && elapsed >= this.startTransitionDurationMs + 100) {
+          if (state === "transitioningToSpeaking" && this.transitionStartTime > 0 && this.transitionKeyframes.length > 0 && elapsed >= this.transitionDurationMs + 100) {
             this.setState("speaking");
             this.transitionKeyframes = [];
             this.avatarController.onTransitionComplete();
@@ -14603,7 +14542,7 @@ class AvatarView {
         await this.getCachedIdleFirstFrame();
         const firstSpeaking = keyframes[0];
         const firstSpeakingWithPostProcessing = this.avatarController.applyPostProcessingToFlame(firstSpeaking);
-        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeakingWithPostProcessing, this.startTransitionDurationMs);
+        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeakingWithPostProcessing);
         this.transitionStartTime = performance.now();
         if (this.transitionKeyframes.length === 0) {
           this.setState("speaking");
@@ -14656,7 +14595,7 @@ class AvatarView {
           const lastSpeaking = this.avatarController.applyPostProcessingToFlame(lastSpeakingRaw);
           const idleFirstProto = await this.getCachedIdleFirstFrame();
           if (idleFirstProto) {
-            this.transitionKeyframes = this.generateAndAlignTransitionFrames(lastSpeaking, idleFirstProto, this.endTransitionDurationMs);
+            this.transitionKeyframes = this.generateAndAlignTransitionFrames(lastSpeaking, idleFirstProto);
             this.transitionStartTime = performance.now();
             if (this.transitionKeyframes.length > 0 && this.renderingState === "transitioningToIdle") {
               if (APP_CONFIG.debug)
@@ -14720,22 +14659,6 @@ class AvatarView {
     if (APP_CONFIG.debug)
       logger.log("[AvatarView] Avatar view disposed successfully");
   }
-  setTransitionDuration(isStart, durationMs) {
-    if (durationMs <= 0) {
-      throw new Error("Transition duration must be a positive number");
-    }
-    if (isStart) {
-      this.startTransitionDurationMs = durationMs;
-      if (APP_CONFIG.debug) {
-        logger.log("[AvatarView] Start transition duration updated:", durationMs);
-      }
-    } else {
-      this.endTransitionDurationMs = durationMs;
-      if (APP_CONFIG.debug) {
-        logger.log("[AvatarView] End transition duration updated:", durationMs);
-      }
-    }
-  }
   getCameraConfig() {
     return this.cameraConfig;
   }
@@ -14752,6 +14675,67 @@ class AvatarView {
       }
     }
   }
+  async renderFlame(flame, enableIdleRendering) {
+    if (!this.isInitialized || !this.renderSystem) {
+      throw new Error("AvatarView not initialized");
+    }
+    if (enableIdleRendering === true) {
+      this.isPureRenderingMode = false;
+      return;
+    }
+    this.isPureRenderingMode = true;
+    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 generateTransitionFromIdle(toFlame, frameCount) {
+    if (!this.isInitialized) {
+      throw new Error("AvatarView not initialized");
+    }
+    if (frameCount <= 0) {
+      throw new Error("Frame count must be greater than 0");
+    }
+    const avatarCore = AvatarSDK.getAvatarCore();
+    if (!avatarCore) {
+      throw new Error("AvatarCore not available");
+    }
+    try {
+      const idleParams = await avatarCore.getCurrentFrameParams(this.idleCurrentFrameIndex, this.characterId);
+      const idleFrameProto = convertWasmParamsToProtoFlame(idleParams);
+      const toFlameWithPostProcessing = this.avatarController.applyPostProcessingToFlame(toFlame);
+      const aligned = this.alignFlamePair(idleFrameProto, toFlameWithPostProcessing);
+      const fps = APP_CONFIG.animation.fps;
+      const durationMs = frameCount / fps * 1e3;
+      const transitionFrames = generateTransitionFrames(
+        aligned.from,
+        aligned.to,
+        durationMs,
+        fps
+      );
+      transitionFrames[0] = aligned.from;
+      transitionFrames[transitionFrames.length - 1] = aligned.to;
+      return transitionFrames;
+    } catch (error) {
+      logger.error("[AvatarView] Failed to generate transition from idle:", error instanceof Error ? error.message : String(error));
+      throw error;
+    }
+  }
   async rerenderCurrentFrameWithNewCamera() {
     if (this.avatarController.state !== AvatarState.paused || this.renderingState !== "speaking" || !this.renderSystem) {
       return;
@@ -14800,7 +14784,7 @@ export {
   LogLevel$1 as L,
   ResourceType as R,
   SPAvatarError as S,
-  logger as a,
+  logEvent as a,
   Avatar as b,
   AvatarController as c,
   AvatarSDK as d,
@@ -14811,6 +14795,6 @@ export {
   ConversationState as i,
   AvatarState as j,
   ErrorCode as k,
-  logEvent as l,
+  logger as l,
   extractResourceUrls as m
 };

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-wQJM-Vug.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-B0MJ_hCJ.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/utils/animation-interpolation.d.ts

@@ -1,12 +1,4 @@
 import { Flame } from '../generated/driveningress/v1/driveningress';
-export interface TransitionConfig {
-    duration: number;
-    delay: number;
-    easing: (t: number) => number;
-}
-export declare const TRANSITION_LAYERS: Record<string, TransitionConfig>;
-
-export declare function bezierLerp(from: Flame, to: Flame, progress: number): Flame;
 
 export declare function linearLerp(from: Flame, to: Flame, progress: number): Flame;
 

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.58",
-  "packageManager": "pnpm@10.18.2",
+  "version": "1.0.0-beta.59",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
   "license": "MIT",
@@ -32,16 +31,6 @@
     "CHANGELOG.md",
     "dist"
   ],
-  "scripts": {
-    "build": "SDK_BUILD=true vite build --mode library",
-    "dev": "vite build --mode library --watch",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
-    "test": "cd tests && pnpm test",
-    "test:watch": "cd tests && pnpm run test:watch",
-    "test:e2e": "cd tests && pnpm run test:e2e",
-    "test:perf": "cd tests && pnpm run test:perf"
-  },
   "peerDependencies": {
     "@webgpu/types": "*"
   },
@@ -58,5 +47,15 @@
     "typescript": "^5.0.0",
     "vite": "^5.0.0",
     "vite-plugin-dts": "^4.5.4"
+  },
+  "scripts": {
+    "build": "SDK_BUILD=true vite build --mode library",
+    "dev": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "cd tests && pnpm test",
+    "test:watch": "cd tests && pnpm run test:watch",
+    "test:e2e": "cd tests && pnpm run test:e2e",
+    "test:perf": "cd tests && pnpm run test:perf"
   }
-}
+}