storysplat-viewer 2.9.1 → 2.9.2

package/README.md

@@ -796,11 +796,28 @@ return () => {
 };
 ```
 
+### Build Target Must Be ES2016+
+
+If you bundle `storysplat-viewer` with Vite, esbuild, or another bundler, your build target **must be `es2016` or higher** (we recommend `es2020`).
+
+PlayCanvas (the 3D engine) serializes its gsplat sort worker via `Function.toString()` into a blob URL. If your bundler targets `es2015`, it will extract the `**` (exponentiation) operator into a module-scoped helper function. That helper doesn't exist inside the worker's isolated scope, causing a `ReferenceError` at runtime (e.g., `ss is not defined`).
+
+```js
+// vite.config.ts
+export default {
+  build: {
+    target: 'es2020', // Must be es2016+ (NOT es2015)
+  }
+};
+```
+
+This only affects production builds — development servers typically don't minify and won't trigger the issue.
+
 ### Browser Compatibility
 
 StorySplat Viewer requires:
 - WebGL 2.0 support
-- Modern JavaScript (ES2015+)
+- Modern JavaScript (ES2016+)
 - Recommended browsers: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+
 
 ## Native App Integration