@needle-tools/engine 5.0.3 → 5.1.0-alpha.1

package/CHANGELOG.md

@@ -4,10 +4,37 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## [5.0.3] - 2026-04-08
-- Add: PMREM / FastHDR support for GroundProjection with shader-based blurriness, blending, and alpha controls
-- Fix: MaterialPropertyBlock multi-material change from opaque to transparent
-- Improved: OrbitControls JSDoc for `targetBounds`
+## [5.1.0-alpha.1] - 2026-04-10
+- Add: `AnimatorControllerBuilder` for building animator controllers from code (experimental)
+- Add: XR global events now return an unsubscribe function + `onBeforeXRSessionRequest` event
+- Add: `getComponent` by string name (experimental)
+- Add: FastHDR (PMREM) support for `GroundProjection`
+- Fix: `setParamWithoutReload` losing URL hash
+- Fix: Physics treeshaking when used in code-only projects
+- Improved: Vite logger with "latest" symlink, mobile fix, and more readable timestamps (at `node_modules/.needle/logs`). This is useful for local AI to help debug
+
+## [5.1.0-alpha] - 2026-04-07
+#### Networking
+- Add: VOIP `volume` property and `speaking` event
+- Add: `onSyncInstantiate` and `onSyncDestroy` callbacks
+- Change: `requestOwnership` now returns a `Promise`
+- Change: `addComponent` generates deterministic component GUIDs for reliable networking of runtime-added components
+- Change: `syncInstantiate` automatically adds to prefabProvider and assigns GUID
+
+#### Rendering
+- Add: MaterialX Voronoi node "cell" output
+- Add: Postprocessing tests
+- Change: Postprocessing moved to core — accessible via `context.postprocessing` and exported from `@needle-tools/engine`
+- Improved: Tonemapping without other postprocessing effects is now applied directly to the renderer, avoiding an unnecessary postprocessing pass
+- Fix: MaterialPropertyBlock multimaterial change from opaque to transparent
+
+#### XR
+- Improved: iOS AppClip AR session now opens reliably on first visit and first tap
+- Fix: XR light intensity in scaled sessions
+
+#### UI
+- Fix: HTML mobile icon not rendering
+- Fix: UI `Text` component absolute font URL handling
 
 ## [5.0.2] - 2026-04-03
 - Updated `@needle-tools/materialx` to 1.6.0:

package/README.md

@@ -92,19 +92,17 @@ onUpdate((context) => {
 
 **WebXR & AR** — immersive experiences on Android and iOS
 - WebXR support including [WebXR on iOS](https://engine.needle.tools/docs/how-to-guides/xr/ios-webxr-app-clip.html)
-- `WebXRImageTracking` — AR image targets with full tracking lifecycle
+- [`WebXRImageTracking`](https://engine.needle.tools/docs/api/WebXRImageTracking) — AR image targets with full tracking lifecycle
 - `WebXRPlaneTracking` — AR surface detection
 - Interactive QuickLook for AR on Vision Pro
 
 **Scene & Asset Management**
-- `SceneSwitcher` — load different scenes by URL
+- `SceneSwitcher` — load different scenes / hierarchies by URL
 - `AssetReference` — runtime asset loading by URL
-- `NestedGltf` — lazy-load GLB files on demand within a scene
 - Multi-scene support with dynamic content loading
 
 **Physics & Interaction** — Built-in [Rapier](https://rapier.rs/) physics engine
 - `Rigidbody`, `BoxCollider`, `SphereCollider`, `MeshCollider` — full physics simulation
-- `CharacterController` — movement with gravity, slopes, and steps
 - `DragControls` — click-and-drag 3D objects with zero code
 - `SpatialTrigger` — proximity and enter-zone detection
 
@@ -113,17 +111,18 @@ onUpdate((context) => {
 - `Voip` — built-in WebRTC voice chat
 - `PlayerSync` — player object sync on join/leave
 - `SyncedCamera` — camera sync for observer sessions
+- Low level networking events for full control
 
 **Rendering & Effects**
 - Advanced PBR rendering with lightmap support
-- Post-processing (Bloom, DepthOfField, SSAO, ChromaticAberration, and more)
-- Progressive texture and mesh loading with automatic LOD generation
+- Post-processing (Bloom, DepthOfField, SSAO, ChromaticAberration, Tonemapping and more)
+- [Progressive texture and mesh loading](https://engine.needle.tools/docs/gltf-progressive/) with automatic LOD generation
 
 **Animation & Media**
 - Animation state machines and timeline animations
 - `VideoPlayer` — full video playback component
 - `AudioSource` — 3D spatial audio
-- Animate anything via [KHR_animation_pointer](https://github.com/nicolo-ribaudo/glTF/tree/animation-pointer/extensions/2.0/Khronos/KHR_animation_pointer)
+- Animate anything via [KHR_animation_pointer](https://www.npmjs.com/package/@needle-tools/three-animation-pointer)
 
 **Framework Integration** — works with React, Vue, Svelte, or vanilla JS/TS