@spatialwalk/avatarkit 1.0.0-beta.102 → 1.0.0-beta.103

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.103]
+
+### 🔧 Internal
+
+- Optimize internal type exports
+
 ## [1.0.0-beta.102]
 
 ### 🐛 Bugfixes

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

package/dist/core/AvatarView.d.ts

@@ -1,4 +1,4 @@
-import { CameraConfig, KeyframeData } from '../types';
+import { CameraConfig } from '../types';
 import { Avatar } from './Avatar';
 import { AvatarController } from './AvatarController';
 export declare class AvatarView {
@@ -57,19 +57,6 @@ export declare class AvatarView {
      * 更新相机配置
      */
     updateCameraConfig(cameraConfig: CameraConfig): void;
-    /**
-     * Render specified keyframe (pure rendering mode, no audio-animation synchronization)
-     * Suitable for scenarios where external application controls audio playback and animation playback
-     * @param keyframeData - Keyframe data
-     * @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>;
-    generateTransition(options: {
-        from?: KeyframeData;
-        to?: KeyframeData;
-        frameCount: number;
-        useLinear?: boolean;
-    }): Promise<KeyframeData[]>;
     /**
      * Render a single animation frame from raw protobuf data.
      *
@@ -107,6 +94,22 @@ export declare class AvatarView {
      * Start idle animation (stop pure rendering mode, resume idle loop).
      */
     startIdle(): void;
+    /**
+     * Generate transition frames from protobuf data.
+     *
+     * Decodes the protobuf, extracts the target keyframe, and generates
+     * transition frames from the current idle position to the target.
+     * The caller is responsible for playing the returned frames at the desired cadence.
+     *
+     * @param data - Raw protobuf bytes containing the target frame
+     * @param frameCount - Number of transition frames to generate
+     * @param options - Additional options
+     * @param options.useLinear - Use linear interpolation (default: true)
+     * @returns Array of opaque keyframe data for sequential playback
+     */
+    generateTransitionFromProtobuf(data: ArrayBuffer | Uint8Array, frameCount: number, options?: {
+        useLinear?: boolean;
+    }): Promise<unknown[]>;
     /**
      * Cancel any in-progress frame sequence playback.
      * Called by renderFromProtobuf when streaming frames arrive during transition.

package/dist/{index-DNq7oTVY.js → index-BqX6ubaV.js}

@@ -9508,7 +9508,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-tmb18x3O.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CxtOBEsC.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -11548,7 +11548,7 @@ class AvatarSDK {
 __publicField(AvatarSDK, "_initializationState", "uninitialized");
 __publicField(AvatarSDK, "_initializingPromise", null);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.102");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.103");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 __publicField(AvatarSDK, "_cachedDeviceScore", null);
@@ -17954,9 +17954,9 @@ class AvatarView {
   }
   /**
    * Render specified keyframe (pure rendering mode, no audio-animation synchronization)
-   * Suitable for scenarios where external application controls audio playback and animation playback
    * @param keyframeData - Keyframe data
-   * @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)
+   * @param enableIdleRendering - Whether to enable idle loop rendering
+   * @internal
    */
   async renderFlame(keyframeData, enableIdleRendering) {
     if (!this.isInitialized || !this.renderSystem) {
@@ -17987,6 +17987,7 @@ class AvatarView {
       throw error;
     }
   }
+  /** @internal */
   async generateTransition(options) {
     if (!this.isInitialized) {
       throw new Error("AvatarView not initialized");
@@ -18098,6 +18099,30 @@ class AvatarView {
   startIdle() {
     this.renderFlame(void 0, true);
   }
+  /**
+   * Generate transition frames from protobuf data.
+   *
+   * Decodes the protobuf, extracts the target keyframe, and generates
+   * transition frames from the current idle position to the target.
+   * The caller is responsible for playing the returned frames at the desired cadence.
+   *
+   * @param data - Raw protobuf bytes containing the target frame
+   * @param frameCount - Number of transition frames to generate
+   * @param options - Additional options
+   * @param options.useLinear - Use linear interpolation (default: true)
+   * @returns Array of opaque keyframe data for sequential playback
+   */
+  async generateTransitionFromProtobuf(data, frameCount, options) {
+    const keyframes = decodeAnimationKeyframes(data);
+    if (!keyframes || keyframes.length === 0) {
+      return [];
+    }
+    return this.generateTransition({
+      to: keyframes[0],
+      frameCount,
+      useLinear: (options == null ? void 0 : options.useLinear) ?? true
+    });
+  }
   /**
    * Cancel any in-progress frame sequence playback.
    * Called by renderFromProtobuf when streaming frames arrive during transition.

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

package/dist/types/index.d.ts

@@ -119,26 +119,6 @@ export interface CameraConfig {
     up?: [number, number, number];
     aspect?: number;
 }
-/**
- * Animation keyframe data
- * Used to represent avatar pose and expression parameters
- */
-export interface KeyframeData {
-    /** Translation [x, y, z] */
-    translation: number[];
-    /** Rotation [x, y, z] (Euler angles, in radians) */
-    rotation: number[];
-    /** Neck pose [x, y, z] (in radians) */
-    neckPose: number[];
-    /** Jaw pose [x, y, z] (in radians) */
-    jawPose: number[];
-    /** Eye pose [x, y, z, x, y, z] (3 parameters for each eye) */
-    eyePose: number[];
-    /** Eyelid [x, y] */
-    eyeLid: number[];
-    /** Expression parameters array */
-    expression: number[];
-}
 /**
  * Post-processing parameter configuration
  * Used to overlay in real-time on animation parameters returned by the server

package/package.json

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