@needle-tools/engine 4.4.0-beta → 4.4.0-beta.10

package/CHANGELOG.md

@@ -4,7 +4,10 @@ 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-beta] - 2025-03-28
+## [4.4.0] - 2025-04-17
+**Added**
+- Add: The needle-engine web-component `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.
+- Add: The needle-engine web-component does now support transparency for `background-color`. For example: `rgba(255, 255, 100, .5)` or `#ffdddd99` or `transparent` are valid values: `<needle-engine background-color="rgba(255, 255, 100, .5)" />`
 - 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()`
@@ -13,6 +16,66 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
     ```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: 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: SyncedTransform does now also sync scale changes
+- Add: SyncedTransform `freeOwnership()` method
+- Add: ReflectionProbe bounding box intersection check to automatically apply reflections to object's in a specific area (handled by the Renderer component)
+- Add: `devicePixelRatio` option on Needle Context. This option controls the window.devicePixelRatio set on the renderer by Needle Engine (default `auto`). It can be set to `manual` to disable this behaviour or a custom number which will then be set on the renderer or composer.
+
+**Fixed**
+- 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">`
+- Fix: `screenshot()` checks if XR is presenting
+- Fix: Issue where MeshBVH worker import breaks for projects where the needle-engine vite plugins are not added to the plugins list
+- Fix: SceneSwitcher regression with `Object3D` objects in scenes array
+- Fix: SceneSwitcher preload was not using three.js FileLoader to re-use three's caching system
+- Fix: GroundProjection regression where background blurriness was hardcoded
+- Fix: RenderTexture regression where deserialization was not properly handled anymore
+- Fix: OrbitControls regression where forward direction in `setCameraAndLookTarget` was inverted
+- Fix: Physics bug where negative box collider scales were not correctly handled in all cases causing Rapier to break
+- Fix: UI instantiate bug where three-mesh-ui `clone` method was not working and UI that was already in the scene could not be duplicated because of that.
+- Fix: Vite license plugin not waiting for the CLI process to start
+- Fix: Vite improve license checks in CI environments (e.g. when running via a Github Action).
+- Fix: Vite plugins for running in CI environment
+- Fix: Vite `manualChunks` are not defined when `preserveModules` is set to true
+
+**Changed**
+- 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.
+- Change: Scene background color or image set on `<needle-engine>` are not overridden anymore by the camera component.
+- Change: Hide Needle logo automatically when using Needle Engine with a license
+
+## [4.4.0-beta.9] - 2025-04-07
+- Add: `<needle-engine background-color="#ffdddd55">` does now support transparency. For example: `rgba(255, 255, 100, .5)` or `#ffdddd99` or `transparent` are valid values.
+- Add: SyncedTransform `freeOwnership()` method
+- Add: ReflectionProbe does now check boundingbox intersection
+- Add: `devicePixelRatio` option on Needle Context. This option controls the window.devicePixelRatio set on the renderer by Needle Engine (default `auto`). It can be set to `manual` to disable this behaviour or a custom number which will then be set on the renderer or composer.
+- Change: Scene background color or image set on `<needle-engine>` are not overridden anymore by the camera component.
+- Change: Hide Needle logo automatically when using Needle Engine with a license
+- Fix: Improve license checks in CI environments (e.g. when running via a Github Action).
+- Fix: Vite plugins for running in CI environment
+- Fix: Vite `manualChunks` are not defined when `preserveModules` is set to true
+- Fix: `screenshot()` checks if XR is presenting
+- Fix: Issue where MeshBVH worker import breaks for projects where the needle-engine vite plugins are not added to the plugins list
+- Fix: Vite license plugin not waiting for the CLI process to start
+
+## [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?:number)` 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);
@@ -22,7 +85,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - 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: 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