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

package/CHANGELOG.md

@@ -5,31 +5,36 @@ 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
+## [1.0.0-beta.87] - 2026-03-09
+
+### 🔧 Performance
+
+- **Playback Cadence Stabilization** - Replaced RAF + `Math.floor(audioTime*25)` frame dispatch with fixed 25fps tick scheduler and bounded async queue, eliminating bursty frame production
+- **Display Decoupling** - Speaking state uses RAF-driven `presentFrameOnly()` to present latest computed frame (WebGPU only), reducing display-side pacing jitter
+- **WebGL Speaking-State Loop Suspension** - WebGL backend pauses realtime animation loop during Speaking state to avoid redundant `reorderPackedData` CPU work and RAF callback competition
 
 ### 🐛 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
+
+- **Frame Index Floating-Point Precision** - Added epsilon tolerance (`+1e-6`) to `Math.floor(audioTime * fps)` to prevent IEEE 754 precision errors from producing duplicate frame indices at frame boundaries
+- **WebGL Regression Fix** - Fixed severe WebGL performance regression (jank 9.47%→0.16%) caused by WebGPU-only optimization that triggered 60fps `reorderPackedData` calls on WebGL path
+- **SDK Duplicate Initialize** - Deduplicated SDK initialization to prevent repeated setup when `initialize()` is called multiple times
 
 ### ✅ Tests
-- Added regression tests for startup transition continuity and startup ordering to prevent reintroduction
 
-## [1.0.0-beta.84] - 2026-03-03
+- **Android Init Coverage** - Added Android duplicate-initialize regression coverage
 
-### 🐛 Bugfixes
-- **End-Transition Continuity** - Fixed the visual jump after conversation end transition by resetting idle frame cursor when returning to `Idle` state
+### 📊 Benchmark
 
-## [1.0.0-beta.83] - 2026-03-03
+- **beta.86 vs beta.87 Baseline** - Full cross-backend performance comparison (WebGPU + WebGL), 1 warmup + 10 measure rounds, 10s/round. Jank rate reduced 94.6% (WebGPU) and 93.9% (WebGL); frame interval stability improved 64-67%
 
-### 🐛 Bugfixes
-- **Playback Startup Sync** - Improved startup sequencing for SDK mode playback to reduce transition/audio desync at conversation start
-- **Initialization Guard** - Added explicit `appId` validation in `AvatarSDK.initialize()` to fail fast when `appId` is empty
+## [1.0.0-beta.86] - 2026-03-03
 
-### 🔧 Improvements
-- **Server Error Propagation** - `onError` now consistently receives `AvatarError` with server message and mapped error code for `MESSAGE_SERVER_ERROR` in SDK mode
+### 🐛 Bugfixes
+- **Transition Continuity** - Fixed start transition source frame selection to use the currently displayed idle frame, reducing first-frame jump.
+- **Transition Robustness** - Added frame index clamping for realtime callback and speaking->idle transition source lookup, preventing end-transition fallback jumps caused by out-of-range indices.
 
-### 📚 Documentation
-- **README Error Callback** - Added detailed `onError` callback behavior and server error code mapping documentation
+### ✅ Tests
+- **State Machine Coverage** - Updated `AvatarView` rendering state tests to align with current dual-transition flow, and added boundary tests for start/end transition frame selection.
 
 ## [1.0.0-beta.82] - 2026-02-12
 

package/README.md

@@ -16,6 +16,35 @@ Real-time virtual avatar rendering SDK for Web, supporting audio-driven animatio
 npm install @spatialwalk/avatarkit
 ```
 
+## 🚧 Release Gate (Hard Rule)
+
+Release must pass gates before publish. Do not publish by manual ad-hoc commands.
+
+Required gate checks:
+
+```bash
+pnpm typecheck
+pnpm test
+pnpm build
+./tools/check_perf_baseline_release_gate.sh
+```
+
+If iteration includes bugfixes, `docs/bugfix-history.md` must have completed rows (test mapping + red/green evidence).
+
+Hotfix bypass is allowed only for emergency and must be recorded:
+
+```bash
+HOTFIX_BYPASS=1 ./tools/check_perf_baseline_release_gate.sh
+```
+
+## 🧪 Benchmark Demo (Web SDK)
+
+Use the dedicated benchmark demo (independent from `vanilla/`) for perf/render baseline runs:
+
+```bash
+pnpm demo:benchmark
+```
+
 ## 🚀 Demo Repository
 
 <div align="center">

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