@needle-tools/engine 5.1.0-alpha.2 → 5.1.0-canary.244f23e

package/CHANGELOG.md

@@ -5,7 +5,7 @@ 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.1.0-alpha.2] - 2026-04-13
-- **NEW**: Scene Bindings (experimental) — auto-generated TypeScript types from your glTF scenes, providing typed access to nodes, components, and properties via `ctx.sceneData` or `needle.sceneData`. Types are generated automatically by a Vite plugin whenever your scene files change — no configuration needed. Works with both local and remote (Needle Cloud) assets. The API shape (particularly `$components` and `$object` accessors) may evolve based on feedback. Can be disabled with `dts: { enabled: false }` in your Vite plugin config.
+- **NEW**: Scene Bindings (experimental) — auto-generated TypeScript types from your glTF scenes, providing typed access to nodes, components, and properties via `ctx.sceneData` or `needle.sceneData`. Types are generated automatically by a Vite plugin whenever your scene files change — no configuration needed. Works with any glTF/GLB assigned as `src` on `<needle-engine>`, including remote URLs and Needle Cloud assets. The API shape (particularly `$components` and `$object` accessors) may evolve based on feedback. Can be disabled with `dts: { enabled: false }` in your Vite plugin config.
   ```ts
   // fully typed, with autocomplete for every node and component
   const cam = ctx.sceneData.MyScene.MainCamera.$object;                      // THREE.PerspectiveCamera
@@ -13,6 +13,13 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
   ```
 - **NEW**: SSR support (experimental) — import Needle Engine in Node.js/SSR frameworks (SvelteKit, Next.js, Nuxt) without `ReferenceError` crashes. The engine now provides SSR-safe base classes and skips browser-dependent initialization on the server. Core rendering still happens client-side — SSR support means your app can import and reference engine code server-side without errors.
 - **NEW**: JSX type declarations for `<needle-engine>` and other web components — first-class support for React, Preact, SolidJS, and other JSX-based frameworks with full autocomplete and type checking
+- **NEW**: `needle` shorthand (experimental) — quick access to the current engine context from anywhere without passing `ctx` around. Works in React/Svelte/Vue components, button handlers, or plain JavaScript. SSR-safe.
+  ```ts
+  import { needle } from "@needle-tools/engine";
+  needle.scene.traverse(obj => { ... });  // access the three.js scene
+  needle.renderer;                         // access the WebGLRenderer
+  needle.sceneData.MyScene.Camera.$components.OrbitControls.autoRotate = true;
+  ```
 - **NEW**: `context.lights` array and `context.mainLight` getter for easy access to all scene lights and the primary directional light
 - Add: `needlePlugins()` can now be called without arguments — the Vite command is resolved automatically. This simplifies setup in frameworks like SvelteKit where `defineConfig` doesn't expose the command:
   ```js
@@ -54,6 +61,15 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Fix: HTML mobile icon not rendering
 - Fix: UI `Text` component absolute font URL handling
 
+## [5.0.4] - 2026-04-20
+- Fix: VideoPlayer not working when tree-shaking is enabled due to URL serializer being removed
+- Fix: ReflectionProbe not cleaning up `envMapRotation` and `envMapIntensity` overrides when removing envMap
+
+## [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.0.2] - 2026-04-03
 - Updated `@needle-tools/materialx` to 1.6.0:
   - UV coordinate convention handling (glTF ↔ OpenGL) — fixes UV-dependent effects like displacement and procedural noise in the browser