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

package/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.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
+
+- **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
+
+- **Android Init Coverage** - Added Android duplicate-initialize regression coverage
+
+### 📊 Benchmark
+
+- **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%
+
 ## [1.0.0-beta.86] - 2026-03-03
 
 ### 🐛 Bugfixes

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-pfCQ3Bn7.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-Z9AXSJw3.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) {