@needle-tools/engine 4.4.0-alpha.4 → 4.4.0-beta

package/CHANGELOG.md

@@ -4,12 +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.4.0-alpha.3] - 2025-03-21
+## [4.4.0-beta] - 2025-03-28
 - Add: `ObjectUtils.createPrimitive()` now supports scale as array   
     e.g. `ObjectUtils.createPrimitive("Cube", { scale: [1, .25, 1] } );`
+- Add: Input `getGamepad(<index>)` function to query a connected gamepad. Example: `this.context.input.getGamepad()`
+- Add: `lookAtScreenPoint()` function which allows 3D object to look at points in 2D screen coordinates (e.g. your mouse position).    
+    **Example Component that makes the object look at the mouse**
+    ```ts
+    import { Behaviour, lookAtScreenPoint } from "@needle-tools/engine";
+
+    export class LookAtMouse extends Behaviour {
+      update() {
+        lookAtScreenPoint(this.gameObject, this.context.input.mousePosition, this.context.mainCamera);
+      }
+    }
+    ```
+- Add: SyncedTransform does now also sync scale changes
+- Add: Default environment lighting. If you don't configure any environment-image needle engine will now create a default scene to light your objects. Previously the scene was just black when the loaded model didn't contain any lighting information.
+- Add: The `contactshadows` attribute now allows you to specify a factor for controlling the darkness/lightness. E.g. `<needle-engine contactshadows="1">` will make the shadows appear darker vs. `<needle-engine contactshadows=".2">` will make the contact shadow appear lighter.
 - Fix: Implicit camera did not automatically set to skybox when using `background-image`. E.g. `<needle-engine background-image="<url>"> 
 - Fix: Tonemapping falsely set tonemappingEsposure to undefined causing a black screen
+- Fix: `background-color` attribute was not always applied. E.g. `<needle-engine background-color="#ff3333">`
 - Change: License check aborts now faster instead of retrying when connection is actively refused
+- Change: OrbitControls `autoTarget` does now automatically update the look at target after panning and not when rotating the camera (previously the target would be updated after any input but this resultet in undesireable behaviour when rotating around objects)
+- Change: When no background-color is defined by either the loaded scene or by a `background-color` attribute then the default scene background color respects the user's accessibility setting for `prefer-dark` or `prefer-light`. This means that the background color will be set to a default light or dark value.
 
 ## [4.3.2] - 2025-03-20
 #### Added