@needle-tools/engine 5.1.0-alpha.4 → 5.1.0-alpha.5

package/CHANGELOG.md

@@ -4,6 +4,35 @@ 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.5] - 2026-05-08
+**Added**
+- `Context.events` — typed event bus for decoupled component communication. Known events get autocomplete; custom events can be typed at the call site:
+  ```ts
+  context.events.on("scene-content-changed", e => console.log(e.object));
+  context.events.emit<{ pts: number }>("scored", { pts: 10 });
+  ```
+- `ContactShadows` auto-refit — when `autoFit` is enabled, shadows automatically refit when scene content changes (e.g. SceneSwitcher load, DropListener asset loading)
+- `Input.addEventListener` now returns an unsubscribe function (works with `autoCleanup`):
+  ```ts
+  this.autoCleanup(this.context.input.addEventListener("pointerdown", (evt) => { ... }));
+  ```
+- `AnimationBuilder` — low-level API for defining animation tracks with typed keyframes and tween shorthands. Used by `AnimatorControllerBuilder` and `TimelineBuilder` for inline `.track()` calls
+- `TimelineBuilder` typed track builder interfaces per track type (`AnimationTrackBuilder`, `AudioTrackBuilder`, etc.) with inline `.track()` support for keyframe animation
+- `AnimatorControllerBuilder`: inline `.track()` for defining animation directly on states, support for `TrackDescriptor` arrays as clip sources, simplified `exitTime` (replaces separate `hasExitTime` flag)
+- Physics raycast `includeTriggers` option — opt-in to hitting trigger/sensor colliders (skipped by default)
+
+**Changed**
+- Timeline track classes renamed for consistency: `AnimationTrackHandler` → `TimelineAnimationTrack`, `AudioTrackHandler` → `TimelineAudioTrack`, `ActivationTrackHandler` → `TimelineActivationTrack`, `ControlTrackHandler` → `TimelineControlTrack`, `MarkerTrackHandler` → `TimelineMarkerTrack`, `TrackHandler` → `TimelineTrackHandler`
+- `OrbitControls.fitCamera` deprecated overload removed from type declarations (runtime still accepts `Object3D` for backwards compat — use `fitCamera({ objects: [...] })` instead)
+
+**Fixed**
+- `OrbitControls`: programmatic camera transitions (e.g. `fitCamera`) no longer interrupted continuously during an ongoing drag — only at interaction start
+- `fitCamera` with `centerCamera: "y"` producing incorrect camera elevation when camera was above the scene center
+- `Animator`: switching `runtimeAnimatorController` now properly disposes the previous controller
+- `AnimatorController.dispose()` guard against missing mixer
+- `CursorFollow.snapToSurface` incorrect property description removed
+- Vite 8 compatibility fixes
+
 ## [5.1.0-alpha.4] - 2026-05-06
 #### Added
 - `autoCleanup` on `Behaviour` — register disposables or cleanup functions tied to the component lifecycle. Automatically cleaned up on disable or destroy depending on when registered: