@needle-tools/engine 4.12.0-next.fb75c78 → 4.12.0

package/CHANGELOG.md

@@ -4,20 +4,30 @@ 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).
 
-## [4.12.0-beta.1] - 2025-12-04
+## [4.12.0] - 2026-01-30
+- **NEW:** WebXR support for iOS - Your AR experiences now launch instantly on iPhone and iPad without app installation. Just tap "Enter AR" and you're in. Powered by Needle Go AppClip, combining Apple's excellent AR tracking with standards-compliant WebXR. Try it at [appclip.needle.tools](https://appclip.needle.tools)
 - **NEW:** Intellisense support for the `<needle-engine>` web component and its attributes, both in HTML and in code. The `custom-elements.json` allows for VSCode intellisense support, while `HTMLElementTagNameMap` and `get/setAttribute` overloads bring code completion and documentation.
 - Add: exposed `createCollider` API for the Rapier physics engine
-- Add: an `beforeLODExport` callback for USDZ export. This allows overriding which LOD level gets exported per object.
-- Add: `?spector=#frame` URL parameter to enable a Spector.js capture on the specified frame number after page load. Make sure to install the [Spector.js browser extension](https://chromewebstore.google.com/detail/spectorjs/denbgaamihkadbghdceggmchnflmhpmk?pli=1). You can optionally specify a frame number for capturing: `?spector=15`.
+- Add: `beforeLODExport` callback for USDZ export. This allows overriding which LOD level gets exported per object.
+- Add: `?spector=#frame` URL parameter to enable a Spector.js capture on the specified frame number after page load. Make sure to install the [Spector.js browser extension](<https://chromewebstore.google.com/detail/spectorjs/denbgaamihkadbghdceggmchnflmhpmk?pli=1>). You can optionally specify a frame number for capturing: `?spector=15`.
 - Add: auto-registration of custom elements for easier discovery of available web components in Needle Engine. You can disable this feature by setting `noCustomElementData` to false in vite config. To manually register custom elements data, add it to your workspace or `.vscode/settings.json` via the `html.customData` setting.
-- Improve: detection of user interactions to enable media playback
+- Add: Support for rotation and scaling in DropListener component
+- Improve: VisionOS and iPad detection for better WebXR compatibility
+- Improve: WebXR session flow and error handling
+- Improve: QuickLook integration - disabled by default in WebXR component, shows "Open in Quicklook" button
+- Improve: SceneSwitcher now supports multiple scene switchers referencing the same asset reference
+- Improve: DragControls smoothed velocity calculations and region support
+- Improve: Detection of user interactions to enable media playback
 - Improve: JSDoc documentation for Everywhere Actions and other components
 - Fix: issue with callbacks on freshly destroyed components when leaving XR sessions
 - Fix: Instancing issue with growing vertex/index buffers when not necessary
 - Fix: Instancing and texture LODs
 - Fix: Issue with `<needle-engine>` element being moved in the DOM
+- Fix: SceneSwitcher was destroying local scene content
 - Fix: Better type declarations in package.json
 
+  https://cloud.needle.tools/-/media/WI0Q0s961BjdXgUEQHxifQ.gif
+
 ## [4.11.5] - 2025-10-31
 - Fix: Timeline cloning with `instantiate` ([forum 2733](<https://forum.needle.tools/t/2733>))
 - Fix: Renderer `sharedMaterials` being null in awake

package/README.md

@@ -15,8 +15,8 @@ Built on three.js and the glTF standard, Needle Engine delivers flexible, extens
 - Multi-scene support with dynamic content loading
 
 **🌐 Web & XR Ready**
-- WebXR support for immersive experiences
-- iOS QuickLook support for interactive AR
+- WebXR support for immersive experiences on Android and iOS ([yes! WebXR on iOS!](https://engine.needle.tools/docs/how-to-guides/xr/ios-webxr-app-clip.html))
+- Interactive QuickLook support for interactive AR on Vision Pro
 - Built-in networking and collaboration
 
 **⚡ Performance Optimized**
@@ -58,6 +58,8 @@ npm install @needle-tools/engine
 
 | Preview | Example | Description | Links |
 |---------|---------|-------------|-------|
+| [![](https://cloud.needle.tools/-/media/WI0Q0s961BjdXgUEQHxifQ.gif)](https://engine.needle.tools/samples/collaborative-sandbox) | [Collaborative Sandbox](https://engine.needle.tools/samples/collaborative-sandbox) | Real-time collaborative multiplayer sandbox experience with WebXR on Android and iOS |
+| [![](https://cloud.needle.tools/-/media/vRUf9BmqW_bgNARATjmfCQ.gif)](https://engine.needle.tools/samples/image-tracking/?room=needle110) | [Image Tracking AR](https://engine.needle.tools/samples/image-tracking/?room=needle110) | AR image tracking example (iOS and Android). [See docs](https://docs.needle.tools/image-tracking) |
 | [![](https://cdn.needle.tools/static/images/changelog/scrollytelling-bike-thumbnail.jpg)](https://scrollytelling-bike-z23hmxb2gnu5a.needle.run/) | [Scrollytelling Bike Example](https://scrollytelling-bike-z23hmxb2gnu5a.needle.run/) | Timeline Animation using ScrollFollow, ViewBox and FocusRect | [Project on Github](https://github.com/needle-engine/needle-engine-bike-scrollytelling) |
 | [![](https://cdn.needle.tools/static/images/changelog/see-through-walls-thumbnail.jpg)](https://engine.needle.tools/samples/see-through) | [See-Through Walls](https://engine.needle.tools/samples/see-through) | See-Through component sample |
 | [![](https://cdn.needle.tools/static/images/changelog/follow-cursor-thumbnail.jpg)](https://engine.needle.tools/samples/look-at-cursor-interactive-3d-header) | [Cursor Follow](https://engine.needle.tools/samples/look-at-cursor-interactive-3d-header) | Cursor Follow sample |