@spatialwalk/avatarkit 1.0.0-beta.63 → 1.0.0-beta.65

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0-beta.65] - 2026-01-14
+
+### 🐛 Bugfixes
+- **Transition Frame Reset Logic** - Fixed issue where `currentPlayingFrame` was not reset after generating transitions, causing jump artifacts on second conversation
+  - Reset `currentPlayingFrame` to `null` after generating idle->speaking transitions
+  - Reset `currentPlayingFrame` to `null` after generating speaking->idle transitions
+  - Reset `currentPlayingFrame` to `null` when entering Idle state
+  - Ensures each transition starts from the correct current frame by re-fetching the current state frame when needed
+
+## [1.0.0-beta.64] - 2026-01-14
+
+### ✨ New Features
+- **Vite Plugin for WASM Configuration** - Added `avatarkitVitePlugin` to automate WASM file configuration
+  - Automatically handles WASM MIME types in dev server
+  - Copies WASM files to dist/assets/ during build
+  - Generates `_headers` file for Cloudflare Pages deployment
+  - Configures Vite's optimizeDeps, assetsInclude, and assetsInlineLimit
+
+### 🔧 Improvements
+- **Unified Transition Logic** - All transitions now start from the current playing frame, ensuring smooth transitions from any state (Idle, Speaking, or Transitioning)
+- **Idle State Performance** - Optimized idle state to avoid unnecessary frame parameter fetching on every frame
+- **Transition Animation** - Idle->Speaking uses linear interpolation, Speaking->Idle uses Bezier curve easing
+
+### 🐛 Bugfixes
+- Fixed vanilla demo audio context initialization issue
+- Fixed recording button only working once in vanilla demo
+- Fixed host mode data loading to use local files instead of API endpoint
+
+### 📚 Documentation
+- Added transition animation technical specification document for cross-platform alignment
+
 ## [1.0.0-beta.63] - 2026-01-14
 
 ### ✨ New Features

package/README.md

@@ -18,6 +18,70 @@ Real-time virtual avatar rendering SDK based on 3D Gaussian Splatting, supportin
 npm install @spatialwalk/avatarkit
 ```
 
+## 🔧 Vite 配置（推荐）
+
+如果你使用 Vite 作为构建工具，强烈推荐使用我们的 Vite 插件来自动处理 WASM 文件配置。插件会自动处理所有必要的配置，让你无需手动设置。
+
+### 使用插件
+
+在 `vite.config.ts` 中添加插件：
+
+```typescript
+import { defineConfig } from 'vite'
+import { avatarkitVitePlugin } from '@spatialwalk/avatarkit/vite'
+
+export default defineConfig({
+  plugins: [
+    avatarkitVitePlugin(), // 添加这一行即可
+  ],
+})
+```
+
+### 插件功能
+
+插件会自动处理：
+
+- ✅ **开发服务器**：自动设置 WASM 文件的正确 MIME 类型 (`application/wasm`)
+- ✅ **构建时**：自动复制 WASM 文件到 `dist/assets/` 目录
+- ✅ **Cloudflare Pages**：自动生成 `_headers` 文件
+- ✅ **Vite 配置**：自动配置 `optimizeDeps`、`assetsInclude`、`assetsInlineLimit` 等选项
+
+### 手动配置（不使用插件）
+
+如果你不使用 Vite 插件，需要手动配置以下内容：
+
+```typescript
+// vite.config.ts
+export default defineConfig({
+  optimizeDeps: {
+    exclude: ['@spatialwalk/avatarkit'],
+  },
+  assetsInclude: ['**/*.wasm'],
+  build: {
+    assetsInlineLimit: 0,
+    rollupOptions: {
+      output: {
+        assetFileNames: (assetInfo) => {
+          if (assetInfo.name?.endsWith('.wasm')) {
+            return 'assets/[name][extname]'
+          }
+          return 'assets/[name]-[hash][extname]'
+        },
+      },
+    },
+  },
+  // 开发服务器需要手动配置中间件设置 WASM MIME 类型
+  configureServer(server) {
+    server.middlewares.use((req, res, next) => {
+      if (req.url?.endsWith('.wasm')) {
+        res.setHeader('Content-Type', 'application/wasm')
+      }
+      next()
+    })
+  },
+})
+```
+
 ## 🎯 Quick Start
 
 ### ⚠️ Important: Audio Context Initialization
@@ -592,17 +656,17 @@ The rendering system automatically selects the best backend, no manual configura
 
 ## 🚨 Error Handling
 
-### SPAvatarError
+### AvatarError
 
 The SDK uses custom error types, providing more detailed error information:
 
 ```typescript
-import { SPAvatarError } from '@spatialwalk/avatarkit'
+import { AvatarError } from '@spatialwalk/avatarkit'
 
 try {
   await avatarView.avatarController.start()
 } catch (error) {
-  if (error instanceof SPAvatarError) {
+  if (error instanceof AvatarError) {
     console.error('SDK Error:', error.message, error.code)
   } else {
     console.error('Unknown error:', error)

package/dist/{StreamingAudioPlayer-CO9WTktN.js → StreamingAudioPlayer-GEsQnXc9.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-C1md-jKJ.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-xTAIRBMF.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);