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

package/.needle/generated/needle-bindings.gen.d.ts

@@ -0,0 +1,5 @@
+// Auto-generated by @needle-tools/engine — do not edit
+// Regenerated on each vite dev-server start and GLB change.
+declare module "needle-bindings" {
+  interface SceneData {}
+}

package/CHANGELOG.md

@@ -4,6 +4,24 @@ 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.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.
+  ```ts
+  // fully typed, with autocomplete for every node and component
+  const cam = ctx.sceneData.MyScene.MainCamera.$object;                      // THREE.PerspectiveCamera
+  const orbit = ctx.sceneData.MyScene.MainCamera.$components.OrbitControls;  // typed!
+  ```
+- **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**: `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
+  export default defineConfig({ plugins: [sveltekit(), needlePlugins()] });
+  ```
+- Fix: BloomEffect and Sharpening were pulling in the entire `postprocessing` library even in projects that don't use postprocessing, increasing bundle size unnecessarily
+- Fix: SceneSwitcher now shows the object name in the URL when referencing scene objects (instead of just an index)
+- Improved: Vite plugin reliability (fewer unnecessary reloads, cleaner log output)
+
 ## [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