@spatialwalk/avatarkit 1.0.0-beta.73 → 1.0.0-beta.74

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.74] - 2026-01-22
+
+### 🔧 Improvements
+- **Transition API** - Replaced `generateTransitionFromIdle` with `generateTransition` (options-based API: `from`, `to`, `frameCount`, `useLinear`)
+
 ## [1.0.0-beta.73] - 2026-01-22
 
 ### ✨ New Features

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

package/dist/core/AvatarView.d.ts

@@ -55,14 +55,12 @@ export declare class AvatarView {
      * @param enableIdleRendering - Whether to enable idle loop rendering. true: Enable idle rendering and return immediately (skip this keyframe); false: Disable idle rendering and process keyframe (default)
      */
     renderFlame(keyframeData: KeyframeData, enableIdleRendering?: boolean): Promise<void>;
-    /**
-     * Generate transition frame array from current idle frame to target keyframe (pure rendering mode)
-     * @param toKeyframeData - Target keyframe data
-     * @param frameCount - Number of transition frames
-     * @param transitionType - Transition type: 'start' means Idle -> toKeyframeData (start transition), 'end' means toKeyframeData -> Idle (end transition)
-     * @returns Transition frame array with length of frameCount
-     */
-    generateTransitionFromIdle(toKeyframeData: KeyframeData, frameCount: number, transitionType?: 'start' | 'end'): Promise<KeyframeData[]>;
+    generateTransition(options: {
+        from?: KeyframeData;
+        to?: KeyframeData;
+        frameCount: number;
+        useLinear?: boolean;
+    }): Promise<KeyframeData[]>;
     /**
      * Get or set avatar transform in canvas
      *

package/dist/{index-AtEuBzqP.js → index-CXzGTmFB.js}

@@ -8243,7 +8243,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-C8IqtjfL.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BDIgU70Y.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -9936,7 +9936,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.73");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.74");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -16679,17 +16679,11 @@ class AvatarView {
       throw error;
     }
   }
-  /**
-   * Generate transition frame array from current idle frame to target keyframe (pure rendering mode)
-   * @param toKeyframeData - Target keyframe data
-   * @param frameCount - Number of transition frames
-   * @param transitionType - Transition type: 'start' means Idle -> toKeyframeData (start transition), 'end' means toKeyframeData -> Idle (end transition)
-   * @returns Transition frame array with length of frameCount
-   */
-  async generateTransitionFromIdle(toKeyframeData, frameCount, transitionType = "start") {
+  async generateTransition(options) {
     if (!this.isInitialized) {
       throw new Error("AvatarView not initialized");
     }
+    const { from, to: to2, frameCount, useLinear = false } = options;
     if (frameCount <= 0) {
       throw new Error("Frame count must be greater than 0");
     }
@@ -16698,32 +16692,31 @@ class AvatarView {
       throw new Error("AvatarCore not available");
     }
     try {
-      const idleParams = await avatarCore.getCurrentFrameParams(this.idleCurrentFrameIndex, this.characterId);
-      const idleFrameProto = convertWasmParamsToProtoFlame(idleParams);
-      const toFlame = toKeyframeData;
-      const toFlameWithPostProcessing = this.avatarController.applyPostProcessingToFlame(toFlame);
-      const aligned = this.alignFlamePair(idleFrameProto, toFlameWithPostProcessing);
-      const from = transitionType === "start" ? aligned.from : aligned.to;
-      const to2 = transitionType === "start" ? aligned.to : aligned.from;
+      let fromFrame;
+      if (from) {
+        fromFrame = from;
+      } else {
+        const idleParams = await avatarCore.getCurrentFrameParams(this.idleCurrentFrameIndex, this.characterId);
+        fromFrame = convertWasmParamsToProtoFlame(idleParams);
+      }
+      let toFrame;
+      if (to2) {
+        toFrame = this.avatarController.applyPostProcessingToFlame(to2);
+      } else {
+        const idleFirstParams = await avatarCore.getCurrentFrameParams(0, this.characterId);
+        toFrame = convertWasmParamsToProtoFlame(idleFirstParams);
+      }
+      const aligned = this.alignFlamePair(fromFrame, toFrame);
+      const alignedFrom = aligned.from;
+      const alignedTo = aligned.to;
       const fps = APP_CONFIG.animation.fps;
       const durationMs = frameCount / fps * 1e3;
-      const useLinear = transitionType === "start";
-      const transitionFrames = useLinear ? generateTransitionFramesLinear(
-        from,
-        to2,
-        durationMs,
-        fps
-      ) : generateTransitionFrames(
-        from,
-        to2,
-        durationMs,
-        fps
-      );
-      transitionFrames[0] = from;
-      transitionFrames[transitionFrames.length - 1] = to2;
+      const transitionFrames = useLinear ? generateTransitionFramesLinear(alignedFrom, alignedTo, durationMs, fps) : generateTransitionFrames(alignedFrom, alignedTo, durationMs, fps);
+      transitionFrames[0] = alignedFrom;
+      transitionFrames[transitionFrames.length - 1] = alignedTo;
       return transitionFrames;
     } catch (error) {
-      logger.error("[AvatarView] Failed to generate transition from idle:", error instanceof Error ? error.message : String(error));
+      logger.error("[AvatarView] Failed to generate transition:", error instanceof Error ? error.message : String(error));
       throw error;
     }
   }

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

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.73",
-  "packageManager": "pnpm@10.18.2",
+  "version": "1.0.0-beta.74",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",
   "license": "MIT",
@@ -38,17 +37,6 @@
     "vite.js",
     "vite.d.ts"
   ],
-  "scripts": {
-    "build": "SDK_BUILD=true vite build --mode library && npm run build:vite-plugin",
-    "build:vite-plugin": "tsc vite.ts --outDir . --module esnext --target es2020 --moduleResolution bundler --esModuleInterop --skipLibCheck --declaration --declarationMap",
-    "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": "*",
     "vite": "^5.0.0"
@@ -66,5 +54,16 @@
     "typescript": "^5.0.0",
     "vite": "^5.0.0",
     "vite-plugin-dts": "^4.5.4"
+  },
+  "scripts": {
+    "build": "SDK_BUILD=true vite build --mode library && npm run build:vite-plugin",
+    "build:vite-plugin": "tsc vite.ts --outDir . --module esnext --target es2020 --moduleResolution bundler --esModuleInterop --skipLibCheck --declaration --declarationMap",
+    "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"
   }
-}
+}