@needle-tools/engine 3.28.7-beta → 3.28.7-beta.1

package/CHANGELOG.md

@@ -1,2257 +1,2260 @@
-# Changelog
-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).
-
-## [3.28.7-beta] - 2023-12-30
-- Fix: Issue in AnimatorController evaluation of bool condition where the threshold wasnt taken into account (e.g. only making a transition if a bool parameter was set to false)
-
-## [3.28.6-beta] - 2023-12-30
-- Add: EventList can now have multiple arguments allowing support for e.g. `setBool` on Animator component being called from a Button directly
-- Add: Animator `toggleBool` method 
-- Fix: Issue where destroying an object in `onCollisionEnter` it would not be removed from the physics event queue and result in `onCollisionStay` being called with an already destroyed component
-- Fix: Rigidbody matrix changed watcher should ignore events during physics to threejs synchronization
-- Fix: Set gizmos renderOrder to be always rendered last to avoid cases where gizmos are hidden due to custom renderOrder on scene objects
-
-## [3.28.5-beta] - 2023-12-22
-- Fix: WebXRController falsely triggering click in EventSystem
-
-## [3.28.3-beta] - 2023-12-21
-- Fix: Issue in pointer events not triggering onPointerEnter and Exit in VR
-- Remove: warning log in USDZ export about double sided materials not being supported
-
-## [3.28.2-beta] - 2023-12-20
-- Add: Support double sided material export for USDZ
-- Fix: `PlayAudioOnClick` when explicit clip is given, use loop from attached audio source
-- Change: Improve Everywhere Action `SetActiveOnClick`
-
-## [3.28.1-beta] - 2023-12-18
-- Add: `context.recreate` to destroy the whole scene and reload everything (including all script instances)
-- Fix: issue where EventSystem pointer events would not be received anymore if the event component was on e.g. an empty object in the parent hierarchy
-
-## [3.28.0-beta] - 2023-12-14
-- Fix: USDZ: `emissiveIntensity` was not applied and `emissiveColor` wasn't used for scale/bias properly
-- Fix: USDZ: compressed textures with alpha channel were not being read back correctly
-- Change: USDZ: bake `effectiveOpacity` into the opacity texture if needed, since QuickLook/usdview don't support `.a` scale values
-- Change: Bump UnityGLTF version to 2.6.0-exp to support GPU Instancing on imported glTF materials
-
-## [3.27.5-beta] - 2023-12-12
-- Fix: Offscreencanvas support for iOS 16.x
-- Fix:  `PlayAudioOnClick` now respects playOnAwake if an explicit audio source is assigned
-- Change: `EventSystem` should only check objects if they're meshes
-
-## [3.27.4-beta] - 2023-12-11
-- Fix: instancing now updating bounds in Needle Engine before render callback if necessary
-- Change: expose `onPauseChanged` on components
-- Change: handle case where a added coroutine function is not a coroutine (Generator) 
-
-## [3.27.3-beta] - 2023-12-09
-- Add: `InstancingUtil.getRenderer` to get the three InstancedMesh for any Object3D (if it's using instancing)
-- Add: instancing does now automatically update culling bounds if it's dirty. This can be disabled via `InstancingUtil.setAutoUpdateBounds(obj, false)`
-- Add: Rigidbody method documentation
-- Add: `ParticleSystem.addBehaviour` method and expose underlying particle system. We now also export the particle types
-- Fix: Issue where `this.physics.raycastFromRay` was modifying the default raycast options
-- Fix: Issue where sprites would be falsely interpreted as builtin sprite causing the image to be not displayed correctly
-- Change: `this.physics.raycast()` can now be called with anonymous options (instead of having to use a `RaycastOptions` class), for example `this.physics.raycast({ray:myRay})`
-
-
-## [3.27.2-beta] - 2023-12-08
-- Fix: don't set font on `<needle-engine>` host styles to prevent leaking into child elements
-- Fix: `AssetReference.loadAsync` being called multiple times should always return the `asset` result
-- Change: register OrbitControls events on the canvas and not the needle engine element to allow child HTML objects to capture input
-
-## [3.27.1-beta] - 2023-12-06
-- Add `addCustomExtensionPlugin` API to register custom glTF importer and exporter extensions
-- Fix: issue where instanced and animated object was rendered for one frame with a wrong matrix
-- Change: expose `imageToCanvas` method from USDZExporter
-- Change: GltfExporter component does not cache exporter anymore and expose all exporter options
-
-## [3.27.0-beta] - 2023-12-04
-- Add: USDZ: skinned mesh export, including animations
-- Add: USDZ: ability to specify if we're exporting for QuickLook or not
-- Add: USDZ: animation export respects basic root motion (translation and rotation)
-- Add: USDZ: `USDZExporter` API supports exporting binary buffer similar to `GLTFExport` API
-- Fix: USDZ: correct `defaultPrim` encapsulation so that it also contains materials
-- Fix: USDZ: render texture readback failure when exporting
-- Fix: `ISceneEventListener` only being found when first component
-- Fix: error in vite plugin facebook instant games if no config would exist
-- Fix: Gizmo label padding and border radius were not properly applied when re-using label
-- Change: USDZ: animation export now automatically includes Animator states
-- Change: USDZ: `PlayAnimationOnClick` now automatically uses Animator state logic to determine looping and continuation of animation (what happens after the specified animation has finished playing)
-- Change: USDZ: current animator states are exported as `PlayAnimation` on scene start
-
-## [3.26.2-beta] - 2023-11-28
-- Add physics NaN safeguards to avoid invalid rapier data propagating through three objects
-
-## [3.26.1-beta] - 2023-11-27
-- Add: information about mouse button, hit point, hit normal, hit distance to `PointerEventData`
-- Fix: EventSystem regression where UI events stopped working
-
-## [3.26.0-beta] - 2023-11-27
-- Fix: LOD update frame delay
-- Change: EventSystem optimization to avoid raycasting objects without event receiver components
-
-## [3.25.5] - 2023-11-24
-- Add: vite plugin for facebook deployment
-- Fix: Physics collider center being not applied correctly with rotated parent
-
-## [3.25.4] - 2023-11-23
-- Add: `onInitialized(ctx => {...})` and `onBeforeRender` event functions
-- Add: `Camera.cullingLayer` property
-- Fix: Physics collider center being modified causing rapier runtime error 
-
-## [3.25.3] - 2023-11-23
-- Add: `onStart((ctx)=>{})` and `onUpdate((ctx)=>{})` functions API
-- Fix: AudioSource not starting autoplay anymore after registered user interaction (which is necessary to playback audio in the browser)
-- Fix: `TransformGizmo` component not working as expected anymore since it also defines `worldPosition`
-- Change: Improve performance for colliders without rigidbody to not create an implicity rapier rigidbody anymore
-
-## [3.25.2] - 2023-11-20
-- Add: `worldForward`, `worldRight` and `worldUp` to Object3D and GameObject types 
-- Add: `getTempVector` utility method that has a circular array of vector3 instances for re-use
-- Fix: ImageTracking hysteresis for images to stay visible during bad tracking for up to a second after tracking has been lost
-
-## [3.25.1] - 2023-11-18
-- Add: getters and setters on Object3D and GameObject types for `worldPosition`, `worldRotation`, `worldQuaternion` and `worldScale`
-- Fix: ImageTracking now has hysteresis for how long to keep a tracked object visible before disabling it (if tracking is lost just for a few frames)
-- Fix: Catch and log exception in rapier during collider creation
-- Change: WebXRImageTracking objects that are already present in the scene are now hidden when entering WebXR/AR
-
-## [3.25.0] - 2023-11-18
-- Add: `Mathf.easinOutCubic` utility method
-- Add: ObjectRaycaster expose option to ignore skinned mesh renderers
-- Fix: detecing website interaction to allow playing audio before any component or audio component has been loaded
-- Fix: Physics capsule height creation
-- Fix: WebXRImageTracking not hiding tracked objects after tracking has been lost
-- Change: Improved ContactShadows component
-- Change: Improve OrbitControls for smoother lerping. Add methods to set camera position and look at target by passing in an Object3D reference.
-- Change: PlayAudioOnClick does now create an AudioSource implictly if non is assigned
-- Change: EventSystem does ignore SkinnedMeshRenderers by default now
-- Change: WebXR reticle is now hidden when image tracking starts
-
-## [3.24.1] - 2023-11-15
-- Fix: Everywhere Action material otherVariants was not cleared between behaviour generation
-- Fix: Everywhere Action Change Material loosing track of the target material
-- Fix: issue where SpatialTrigger calling AudioSource.play doesnt work because of wrong argument
-- Fix: text linebreak in USDZ
-- Fix: material bindings API for Preliminary_Text and don't apply material when no geometry is found
-- Fix: material assignments for USDZ text and fix color space
-- Fix: Capsulecollider height
-- Fix: Core networking issue where throwing callbacks would silently be ignored and causing not all callbacks being called
-- Fix: PlayerSync `owner-changed` being raised twice
-- Fix: PlayerSync unsubscribe from UserLeftRoom event once the player is leaving/has left
-- Fix: Catch exception in creating `new type()` during deserialization of animationclip if the clip is just a string and could not be resolved because it's missing, falsely serialized or annotated
-- Change: OnClick Everywhere Actions now ensure they have a raycaster component assigned or in parent hierarchy
-- Change: Everywhere Action PlayAnimationOnClick remove target field
-
-## [3.24.0] - 2023-11-13
-- Add: ContactShadows component
-- Add: `Gizmos.DrawLabel`
-- Fix: issue with AnimatorController behaviour when using loop and cycle offset
-- Fix: error when loading component with missing AnimatorController field
-- Fix: use correct colorspace for UI components
-- Fix: loading of remote GLB and `skybox-image` url where default camera should set clearflags to skybox
-- Fix: Various colorspace issues fixed
-- Change: USDZ export `imageToCanvas` now uses OffscreenCanvas for improved performance
-- Change: Update pmndrs postprocessing package to 6.33.3 to fix SSAO not working on mobile android
-- Change: `ObjectUtils.createPrimitive` so all primitives use the same settings
-
-## [3.23.1] - 2023-11-09
-- Add: `Gizmos.DrawLabel` method
-- Add: `LookAtObject` utils method with options to keep upwards direction and copying target rotation to stay screen aligned
-- Fix: WebXRPlaneTracking dispose old mesh data properly, heuristically determine if a shape should be convex or not
-- Fix: AudioSource `play` not working anymore if called without parameters
-- Internal: rapier meshcolliders now use convexHull instead of convexMesh, the latter already expects the input data to be convex
-
-## [3.23.0] - 2023-11-08
-- Add: support for changing animatorcontroller at runtime
-- Add: AnimatorController support for cycle offset and speed being used from parameter (or fixed serialized value)
-- Add: `OrbtiControls.allowInterrupt` property that can be set to false to prevent animation to a target point or autoRotate being interrupted by user input like clicking or dragging
-- Add: Physics collision now includes tangent vector for contact points
-- Add: Physics exposes API for getting the object velocity per collider (`context.physics.engine.getLinearVelocity`)
-- Add: Physics Material can now be updated at runtime. Call `updatePhysicsMaterial` on the collider with the changed physics material
-- Fix: scaled capsule collider being created with wrong size
-- Fix: timeline audiotracks not respecting speed property on PlayableDirector (effectively being cut-off instead of being played back at another speed/playbackRate) 
-- Fix: Prevent using XRAnchor on Quest in AR mode (pass-through)
-- Fix: Timeline evaluate is now done in lateUpdate which gives animated objects time to apply the changed data (e.g. OrbitControls where the target object may be animated)
-- Fix: Timeline Audio tracks do not require AudioListener in scene anymore
-
-## [3.22.6] - 2023-11-06
--  Change: work on approximated transmission export in USDZ
-
-## [3.22.4] - 2023-11-03
-- Add: Option to WebXRControllers to disable default controls (`enableDefaultControls`) and raycasting (`enableRaycasts`)
-- Fix: AnimatorController transition with exitTime and trigger didnt work since trigger was reset before transition could be made
-- Fix: USDZExporter isssue where compressed textures always ended up as JPG after decompression since format check was only checking for RGBAFormat, now also checks for compressed formats
-- Change: catch and display unhandled exceptions during creation of engine, make sure bubble messages are on top of loading overlay
-- Change: USDZExporter should re-use renderer 
-
-## [3.22.3] - 2023-11-02
-- Add: Coroutine can now yield on promise and wait for the promise to be resolved
-- Fix: CharacterController not being grounded on mesh collider
-- Fix: ShadowCatcher set to additive mode didnt work anymore
-
-## [3.22.2] - 2023-11-01
-- Add: Optional `RectTransform.minWidth` and `RectTransform.maxWidth`
-- Fix: GameObject instantiate should clone color objects (to not share instance)
-- Fix: Call to `parseSync` with full url argument now correctly passes base url to three GLTFLoader for resolving external resources
-- Change: PhysicsMaterial properties are now all optional (e.g. so we can set only friction)
-- Change: `Rigidbody.setForce` to take a vec3
-- Change: `AudioSource.onDisable` should pause not stop
-- Change: `Mathf.random(<min>?, <max>?)` now takes optional min and max parameters
-
-## [3.22.1] - 2023-10-30
-- Fix: `Screencapture.autoconnect` when already connected to networking server or connection is in progress / window selection is currently open
-- Change: when `isManagedExternally` is enabled then framerate is user controlled and not automatically clamped
-- Change: add more documentation to networking methods
-
-## [3.22.0] - 2023-10-26
-- Fix: SyncedCamera deserialization warning
-- Change: Collider property updates now trigger rigidbody mass recalculation immediately (if set to auto-mass)
-- Change: Rigidbody methods now take Vec3 object as well as arguments like `{x:0, y:1, z:0}`
-- Change: Improve Screencapture
-- Change: Screencapture now also allows `Microphone` as input device
-- Change: Updated VOIP script and removed old VOIP implementation - it now uses the same underlying codebase as screencapture
-- Change: Update imports to use `type` where appropriate
-
-## [3.21.5] - 2023-10-25
-- Fix: remove leftover console.log
-- Fix: Hovered button should reset pointer state when destroyed
-- Fix: WebXR Rig parenting in VR when switching scenes
-- Fix: Timeline activation track not properly evaluating when timeline is paused and manually evaluated from user code
-- Fix: Sphere Collider radius not being set correctly
-
-## [3.21.3] - 2023-10-23
-- Fix: Issue where Chrome touch emulation caused "onPointerClick" being called twice per click
-- Fix: EventList instances are now not shared anymore between components created via `instantiate`
-- Fix: Regression where SphereCollider radius was not being applied
-
-## [3.21.2] - 2023-10-23
-- Change: Expose EventList subscriber count
-- Change: `PointerEventArgs.use()` should not stop propagation
-
-## [3.21.1-alpha] - 2023-10-20
-- Add: Multitouch support on `input` events, our EventSystem implementation now handles multitouch cases and is using the browser events directly and immediately (before events via `window` where deferred and hanlded during the engine update loop)
-
-## [3.21.0-alpha] - 2023-10-19
-- Add: support for translate, rotate and scale of AR scene on android devices (needs `WebXRSessionRoot.arTouchTransform` set to true right now)
-- Add: `SphereCollider.radius` and `BoxCollider.size` updates at runtime are now automatically propagated to the physics engine updating the physics shapes. Additionally the object scale for SphereCollider objects is watched and automatically applied on change 
-- Fix: removal of all colliders on an object now also fully cleansup the implictly created RigidBody
-- Change: `Context.isManagedExternally` can now be set at runtime as a first step towards allowing complete external control over the Needle Engine lifecycle loop in cases where Needle Engine scenes or components are mixed with an external three.js scene (and projects that require more explicit control)
-
-## [3.20.3] - 2023-10-18
-- Add: Expose Rapier dominance group option on Rigidbody
-- Fix: Ignore root motion when animator weight is <= 0 due to Timeline playing
-- Fix: Rapier race condition caused by dynamic loading
-- Change: Allow setting Rigidbody mass explictly now by either setting `autoMass` to false or by setting the `mass` property
-
-## [3.20.2] - 2023-10-17
-- Fix: renderer access nullreference exceptions caused by deferred initialization
-- Fix: disabling postprocessing now restores renderer clear state (which got disabled by the postprocessing package)
-- Fix: disable generating WebXRPlane tangents
-
-## [3.20.1] - 2023-10-16
-- Change: `addComponent` can now take component instance or type
-
-## [3.20.0] - 2023-10-13
-- Fix: issue where physics colliders where not yet fully initialized in `start` event
-- Fix: Pointer delta while cursor is locked
-- Change: Expose `context.phyiscs.engine.world` and  `context.physics.engine.getComponent` method to directly work with rapier physics engine and to easily get access to Needle Engine components from rapier colliders
-- Change: Expose `Context.DefaultWebGLRendererParameters` that can be modified in static context before renderer is created
-
-## [3.19.9] - 2023-10-11
-- Change: `AnimatorController.createFromClips` now sets the state hash to index of clip
-- Fix: AnimatorController root motion direction when runtime instantiating and using the same clip on multiple objects
-- Fix: AnimatorController root motion forward direction when rotating object from script as well
-
-## [3.19.8] - 2023-10-10
-- Add: `AnimatorController.createFromClips` utility method taking in a animationclips array to create a simple controller from. By default it creates transitions to the next clip
-- Fix: occasional issue where the scrollbar would cause flickering due to hiding/showing when the website was zoomed
-- Fix: screenshot utility method respecting page zoom
-- Fix: vite dependency watcher plugin running installation if dependency in package.json would change
-- Fix: Animator root motion working with multiple states, clips and transitions
-
-## [3.19.7] - 2023-10-04
-- Add: OrbitControls `enableRotate` property
-- Fix: LODGroup not using last LOD in cases where the last LOD is never culled
-- Fix: PostProcessing EffectStack correctly ordered when using N8 Ambient Occlusion (together with Bloom for example)
-- Fix: Postprocessing N8 should not modify gamma if it's not the last effect in the stack
-
-## [3.19.6] - 2023-10-02
-- Fix: AudioSource does now create an AudioListener on the main camera if none is found in the scene
-- Change: VideoPlayer does fallback to clip if src is empty or null
-- Change: OrbitControls now expose `enableRotate` property
-
-## [3.19.5] - 2023-10-02
-- Fix: web component font import
-
-## [3.19.4] - 2023-09-29
-- Fix: Remove leftover OrbitControls log
-- Change: Timeline TrackModel `markers` and `clips` fields are now optional
-- Change: VideoPlayer is set to use url as default video source (if nothing is defined)
-
-## [3.19.3] - 2023-09-28
-- Fix: regression in OrbitControls without lookat target assigned
-- Fix: progressive textures loading with custom reflection probe
-- Fix: WebAR touch event screenspace position using `this.context.input` 
-
-## [3.19.2] - 2023-09-27
-- Add: OrbitControls `autoFit` property
-- Add: API to access underlying Rapier physics body using `context.physics.engine.getBody(IComponent | IRigidbody)`
-
-## [3.19.1] - 2023-09-27
-- Add: ParticleSystem now supports HorizontalBillboard and VerticalBillboard
-- Fix: [WebXR chromium bug](https://bugs.chromium.org/p/chromium/issues/detail?id=1475680) where the tracking transform matrix rotates roughly by 90° - we now add an WebXR Anchor to keep the scene at the placed location in the real world
-- Fix: SceneSwitcher does now call event on first `ISceneEventListener` found on root level of a loaded scene (e.g. if a Unity scene is loaded that contains multiple children and does not have just one root object)
-- Fix: Text UI clipping with multiple active screenspace canvases in scene
-- Fix: Screenspace canvas events should not be blocked anymore by objects in 3D scene
-- Fix: FirstPersonController rotation not being correctly / falsely resetted and flipped in some cases
-
-## [3.19.0] - 2023-09-26
-- Fix: collider scale wrongly affecting physics objects
-- Fix: collider debug lines should not be raycastable
-- Fix: mesh-collider behaving unexpectedly
-- Fix: animator root motion causing error due to uninitialized Quaternion object
-
-## [3.18.0] - 2023-09-21
-- Add: SceneSwitcher has now a field for `loadingScene` which can be used to display a scene while loading other scenes
-- Add: `ISceneEventListener` which is called by the SceneSwitcher when a scene has been loaded or a scene is being unloaded. It can be used to handle showing and hiding content gracefully. It has to be added to the root of the scene that is being loaded (e.g. the root of the scene or prefab assigned to the `loadingScene` field or the root of a scene assigned to the `scenes` array)
-- Add: `hide-loading-overlay` attribute to `<needle-engine>` webcomponent (use like `<needle-engine hide-loading-overlay>`). Custom loading requires a PRO license. See [all attributes in the documentation](https://engine.needle.tools/docs/reference/needle-engine-attributes.html).
-- Fix: Loading overlay should not link to needle website anymore when using a custom logo
-- Fix: Add safeguard to user assigned events on `<needle-engine>` for cases where methods are not defined in the global scope
-- Change: Update loading message displayed in overlay while waiting for `ContextCreated` promise (e.g. in cases where a large environment skybox is being loaded)
-
-## [3.17.0] - 2023-09-20
-- Fix: handle exception when loading GLB/glTF files with invalid lightmapping extension
-
-## [3.16.5] - 2023-09-18
-- Change: Ignore shadow catcher and GroundProjectedEnvironment sphere when running OrbitControls.fit
-
-## [3.16.4] - 2023-09-16
-- Add: help balloon message if user tries to open a local file without using a webserver
-- Add: helpful console.log if user tries to add a component that is not a Needle Engine component
-
-## [3.16.3] - 2023-09-15
-- Add: logo now respects prefer-reduced-motion, reduce and is immediately added instead of after 1s
-- Fix: use default background color if GLB without camera and skybox is loaded
-- Fix: ensure custom KTX2 loader is correctly initialized
-- Fix: revert RectTransform change that broke hotspot rendering
-- Change: adjust default backgroundBlurriness to match Blender defaults
-
-## [3.16.2] - 2023-09-15
-- Add: mesh collider handling for invalid mesh data (non-indexed geometry)
-
-## [3.16.2-beta] - 2023-09-13
-- Add: `camera.environmentIntensity` property
-- Change: default background blurriness for fallback camera to match blender default
-
-## [3.16.1-beta] - 2023-09-13
-- Change: if loaded glTF doesnt contain a camera we now also create the default OrbitControls (e.g. glTF exported from a Blender scene without a camera)
-
-## [3.16.0-beta] - 2023-09-13
-- Add: `NEEDLE_lightmaps` entries `pointer` property can now also be a path to a local texture on disc instead of a texture pointer. This allows Blender EXR and HDR maps to be used at runtime until Blender export supports hdr and exr images to be stored inside the GLB
-
-## [3.15.0-beta] - 2023-09-13
-- Fix: remove leftover console.log
-- Fix: `DeviceFlag` component not detecting devices correctly for iOS safari
-- Fix: loading glTF without any nodes
-- Fix: `SceneSwitcher` bug where a scene would be added twice when switching in fast succession
-- Fix: `Animation.isPlaying` bool was always returning false
-- Fix: Handle typescript 5 decorator change to prevent VSCode error message (or cases where `experimentalDecorators` is off in tsconfig). See [179](https://github.com/needle-tools/needle-engine-support/issues/179)
-- Fix: Improve internal lifecycle checks and component method calls
-- Change: Improse ContextRegistry/NeedleEngine `ContextEvent` enum documentation
-- Change: `<needle-engine skybox-image=` and `environment-image=` attributes are now awaited (loading overlay is still being displayed until loading the images have finished or failed loading)
-
-## [3.14.0-beta] - 2023-09-11
-- Add: exposing `Needle.glTF.loadFromURL` in global scope to support loading of any glTF or GLB file with needle extensions and components when using the prebundled needle engine library (via CDN)
-- Add: `context.update` method for cases where needle engine is now owning renderer/scene/camera and the update loop is managed externally
-- Fix: animating custom shader property named `_Color` 
-- Fix: issue with wrong CSS setting in Needle Engine breaking touch scroll
-- Change: `?stats` now logs renderer statistics every few seconds
-- Change: simplify creating a new Needle Context that is controlled externally (not owning camera/renderer)
-
-## [3.13.0-beta] - 2023-09-08
-- Add: ParticleSystem now also uses material color
-- Add: `IEditorModificationListener.onAfterEditorModification` callback (requires `@needle-tools/editor-sync@2.0.1-beta`)
-- Bump: Three.Quarks dependency to 0.10.6
-- Update draco decoder include files
-
-## [3.12.2-beta] - 2023-09-04
-- Add: option to override peerjs host and id (options) via `setPeerOptions`
-- Fix: potential nullreference error in AudioListener
-- Fix: Networking component cases where invalid localhost input with "/" causes url to contain "//" sometimes -> we can skip one "/" in this case and make it just work for users
-- Fix: package.json `overrides` syntax for quarks three.js version
-- Change: Screensharing bool to disable click to start networking + add deviceFilter to share(opts:ScreenCaptureOptions)
-
-## [3.12.1-beta] - 2023-09-04
-- Fix: next.js/webpack useRapier setting
-- Change: typestore is now globally registered
-
-## [3.12.0-beta.1] - 2023-08-28
-- Fix: vite hot reload plugin to dynamically import needle engine to support usage in server-side rendering context
-
-## [3.12.0-beta] - 2023-08-28
-- Add: Timeline api for modifying final timeline position and rotation values (implement `ITimelineAnimationCallbacks` and call `director.registerAnimationCallback(this)`)
-- Change: Update three quarks particlesystem library to latest
-- Fix: issue where onPointerExit was being called when cursor stops moving
-- Fix: USDZ normal scale Z was incorrect
-- Fix: Timeline Signal events using different casing than UnityEvent events
-- Fix: issue where `isLocalNetwork` was falsely determined
-
-## [3.11.6] - 2023-08-15
-- Remove beta
-
-## [3.11.6-beta] - 2023-08-14
-- Fix: find exported animation by PropertyBinding 
-- Fix: USDZExporter was not exporting animation from Animation component but only from Animator
-- Fix: potential issues with Animation component `clip.tracks` being null/undefined on USDZ export
-- Fix: `loadstart` event not being called
-- Fix: getComponent should always either the component or null (never undefined)
-- Fix: dynamic import of websocket-ts package
-- Fix: progressive texture loading wasn't properly awaited on USDZ export
-- Fix: apply XR flags when exporting to QuickLook
-- Fix: USDZ alpha clipping for materials without textures
-- Fix: USDZ same material used in different ChangeMaterialOnClick resulted in duplicate behaviour names
-- Change: set default WebARSessionRoot to "1" instead of "5"
-
-## [3.11.5-beta] - 2023-08-10
-- Fix: components keep their gameObject references until `destroy` call of object's is completed when destroying an hierarchy. Previously child components might already be destroyed resulting in `myChildComponent.gameObject` being null when called in `onDestroy` from a parent component
-- Fix: regression where timeline was not updating animations anymore if Animator had an empty AnimatorController assigned (without any states)
-- Fix: `SceneSwitcher.switchScene` can now handle cases where it's called with a string url instead of an AssetReference 
-- Fix: issue where `onPointerMove` event was being called continuously on mobile after touch had already ended
-- Fix: issue where GLTFLoader extensions where missing name field resulting in extensions not being properly registered (causing stencils to not work sometimes)
-- Change: EventSystem raycast is now only performed when pointer has changed (moved, pressed, down, up) which should improve performance on mobile devices when raycasting on skinned meshes
-- Change: peer and websocket-ts import asynchronously
-- Remove: legacy include files
-
-## [3.11.4-beta] - 2023-08-04
-- Fix: USDZExporter exception caused by programmatically calling `exportAsync` without quicklook button
-- Fix: Timeline `evaluate` while being paused
-- Bump three to fix issue with blend shape animation not being applied to Group objects (KHR_animation_pointer)
-
-## [3.11.3-beta] - 2023-08-03
-- Change: improve styling of `<needle-engine>` DOM overlay element to allow positioning of child elements
-- Fix: USDZExporter normal bias when normalScale is used
-- Fix: Nullreference in SceneSwitcher when creating the component from code and calling `select` with a new scene url
-- Fix: Quicklook button creation
-- Fix: Particlesystem layermask not being respected
-
-## [3.11.2-beta] - 2023-07-31
-- Fix: `ChangeMaterialOnClick` with multi material objects
-- Fix: progressive textures regression
-
-## [3.11.1-beta] - 2023-07-31
-- Add: `saveImage` utility method and make `screenshot` parameter optional
-- Add: `loading-style="auto"`
-- Fix: skybox image caching
-- Fix: finding animation tracks for unnamed nodes when using the `autoplay` attribute
-- Change: improved `<needle-engine>` default sizes
-- Change: smoother src changes on `<needle-engine>` by only showing loading overlay when loading of files takes longer than a second
-- Change: bump three version to 154.2 fixing KHR_animation_pointer not working with SkinnedMesh
-
-## [3.11.0-beta] - 2023-07-29
-- Add: Support for blending between Timeline and Animator animation by fading out animation clips allowing to blend idle and animator timeline animations
-- Fix: WebXR buttons style to stay inside `<needle-engine>` web component
-- Fix: `OrbitControls.fitCamera` now sets rotation target to the center of the bounding box
-- Fix: Timeline animation regression causing Animator not being enabled again after timeline has finished playing
-- Fix: Timeline should re-enable animator when ended reached end with wrap-mode set to None
-- Change: add `.js` extensions to all imports
-- Change: allow overriding loading style in local develoopment
-- Change: expose flatbuffer scheme helper methods
-
-## [3.10.7-beta] - 2023-07-28
-- Fix: Camera using RenderTarget (RenderTexture) now applies clear flags before rendering (to render with solid color or another skybox for example)
-- Fix: RenderTexture not working in production build due to texture being compressed
-- Fix: RenderTexture warning `Feedback loop formed between Framebuffer and active Texture`
-- Fix: Handle Subparticlesystem not being properly serialized avoiding runtime error
-- Internal: add resource usage tracking of textures and materials
-
-## [3.10.6-beta] - 2023-07-27
-- Fix: Timeline ActivationTrack behaves like `leave as is` when timeline is disabled (not changing the activate state anymore)
-- Fix: Timeline Signal Track with duration of 0 and signal at time 0 does now trigger
-- Fix: Timeline disabling or pausing does now activate animator again
-- Fix: CustomShader Time node for BiRP
-- Fix: ParticleSystem simulation mode local now correctly applies parent scale
-- Change: Show warning for wrong usage of `@serializable` with `Object3D` where a `AssetReference` is expected
-- Change: ParticleSystem shows warning when using unsupported scale mode (we only support local right now)
-
-## [3.10.5-beta] - 2023-07-25
-- Fix: warning at runtime when methods called by `EventList`/`UnityEvent` are in the wrong format
-- Fix: OrbitControls issue where double clicking/focus on screenspace UI would cause the camera to be moved far away
-- Fix: `OrbitControls.fitCamera` where three `expandByObject` now requires an additional call to `updateWorldMatrix` [26485](https://github.com/mrdoob/three.js/issues/26485#issuecomment-1649596717)
-- Change: replace some old `Texture.encoding` calls with new `Texture.colorSpace`
-- Change: improve `PlayerSync` networking and add `onPlayerSpawned` event
-- Remove: `RectTransform.offsetMin` and `offsetMax` because it's not implemented at the moment
-
-## [3.10.4-beta] - 2023-07-24
-- Fix: activating UI elements in VR not applying transform
-
-## [3.10.3-beta] - 2023-07-21
-- Fix: AnimatorController error caused by missing animationclip
-- Fix: next.js webpack versions plugin
-- Fix: Occasional `failed to load glb` error caused by not properly registering `KHR_animation_pointer` extension 
-- Fix: UI issue where Text in worldspace canvas would be visible at wrong position for a frame
-- Fix: UI issue where Text would not properly update when switching between text with and without richtext
-- Fix: UI issue where Image would not automatically update when setting texture from script
-- Fix: issue where RenderTexture would not be cleared before rendering
-- Change: make `addEventListener` attribute on `<needle-engine>` optional
-
-## [3.10.2-beta] - 2023-07-19
-- Fix: iOS double touch / input
-- Change: minor WebXRController refactor moving functionality into separate methods to be patchable
-
-## [3.10.1-beta] - 2023-07-18
-- Fix: prebundled package
-- Fix: runtime license check
-- Fix: Input being ignored after first touch
-- Fix: SpatialTrigger, reverting previous change where we removed the trigger arguments
-
-## [3.10.0-beta.2] - 2023-07-18
-- Fix: prebundled package by locking vite to <= 4.3.9
-
-## [3.10.0-beta.1] - 2023-07-17
-- Fix: prebundled package
-
-## [3.10.0-beta] - 2023-07-17
-- Fix: Text clipping in VR
-- Fix: AR overlay `quit-ar` button not being properly detected
-- Fix: Timeline animation track post-extrapolate set to `Hold`
-- Fix: iOS touch event always producing double click due to not properly ignoring mouse-up event
-- Change: DragControls to automatically add ObjectRaycaster if none is found in parent hierarchy
-- Change: DragControls now expose options to hide gizmo and to disable view-dependant behaviour
-
-## [3.10.0-alpha] - 2023-07-15
-- Change: WebXR component now automatically adds a WebARSessionRoot on entering AR when no session root was found in the scene
-- Change: `@syncField` can now sync objects by re-assigning the object to the same field (e.g. `this.mySyncedObject = this.mySyncedObject` to trigger syncing)
-- Change: log error when `@syncField` is being used in unsupported types (currently we only support syncField being used inside Components directly)
-- Change: improve message when circular scene loading is detected and link to documentation page 
-
-## [3.9.1-alpha] - 2023-07-14
-- Add: SceneSwitcher now uses scene name by default. Can be turned off in component
-- Fix: ParticleSystem lifetime not respecting simulation speed 
-- Fix: ParticleSystem prewarm with simulation speed and improved calculation of how many frames to simulate
-- Fix: Exit AR and Exit VR now restores previous field of view
-- Change: close AR button adjusted for better visibility on bright backgrounds
-- Change: bump @types/three to 154
-
-## [3.9.0-alpha.1] - 2023-07-12
-- Add: vite plugin to clamp version to `<= 4.3.9` since 4.4 and above currently cause issues with typescript decorators, [vite#13736](https://github.com/vitejs/vite/issues/13736)
-
-## [3.9.0-alpha] - 2023-07-12
-- Add: `<needle-engine>` web component slot support, AR DOM overlay can now be added by simple adding HTML elements inside the `<needle-engine></needle-engine>` web component. Fixing [164](https://github.com/needle-tools/needle-engine-support/issues/164)
-- Add: Basic USDZ exporting of UI shadow hierarchies as mesh hierarchies for UI in Quicklook AR support
-- Fix: WebXR Rig not being rotated as expected when setting up in Unity [129](https://github.com/needle-tools/needle-engine-support/issues/129)
-- Fix: WebXR VR button click, hover is still not working
-- Fix: Issue with Lightmaps breaking when switching back and forth between multiple lightmapped scenes
-- Change: Button click should not invoke with middle or right mouse
-
-## [3.8.0-alpha] - 2023-07-11
-- Update three.js to 154 (latest)
-- Bump postprocessing dependency
-- Add: `this.context.xrCamera` property
-- Fix: screenspace canvas should not run in VR
-- Fix: OrbitControls should not update while in AR and touching the screen
-- Change: allow using vanilla three.js by dynamically importing KHR_animation pointer api 
-
-## [3.7.7-beta] - 2023-07-11
-- Fix: LookAt copyTarget + keepUpDirection
-- Fix: DragControls not working on first touch on mobile / clone input event
-- Fix: Renderer assigning renderOrder in URP on SkinnedMesh with multi-material
-
-## [3.7.5-beta] - 2023-07-07
-- Fix: USDZExporter should not show Needle banner when branding information is empty (pro only)
-- Fix: USDZExporter sessionroot scale should be applied to object to be exported when the root is in the parent
-- Fix: DropListener localhost without explicit backend url + dropping file caused exceptions
-- Fix: instanceof error that tsc complained about
-- Change: Fonts handle semibold variant
-- Internal: DropListener re-use addFiles method, remove old code
-- Internal: Bump tools package dependency
-
-## [3.7.5-alpha] - 2023-07-06
-- Add: SignalEvents support for arguments
-- Fix: SpatialTrigger Unity events removing extra (unexpected) event arguments
-- Fix: safeguard `AudioSource.play` to not fail when `clip` argument is not a string
-- Change: change Timeline signal event trigger time to use last frame deltatime with padding to estimate if the event should fire
-
-## [3.7.4-alpha] - 2023-07-05
-- Change: targetFps, use timestamp that we get from the animation callback event because it is more reliable on Firefox
-
-## [3.7.3-alpha] - 2023-06-26
-- Add: physics gravity to `IPhysicsEngine` interface to be available via `this.context.physics.engine.gravity`
-- Fix: USDZ text alignment
-
-## [3.7.2-alpha] - 2023-06-23
-- Fix: Nullref in SpectatorCamera.onDestroy when camera wasnt active
-
-## [3.7.1-alpha] - 2023-06-22
-- Add: ChangeMaterialOnClick `fadeDuration` option (Quicklook only)
-- Change: USDZ export now enforces progressive textures to be loaded before export
-- Change: USDZ export callbacks for `beforeCreateDocument` and `afterCreateDocument` can now run async
-- Fix: USDZExporter quicklook button
-- Fix: USDZExporter Quicklook button not being removed when exporter gets removed or disabled
-- Fix: USDZ ChangeMaterialOnClick clear cache before exporting, this caused USDZ export to fail on third export in USDZ sample scene
-- Fix: Engine loading bar not being updated
-- Fix: USDZ text linebreaks
-- Fix: UI font name style check. Unknown font styles are now not touched anymore (e.g. font name ending with `-Medium`)
-
-## [3.7.0-alpha] - 2023-06-21
-- Change: Move HTML elements into <needle-engine> shadow dom
-
-## [3.6.13] - 2023-06-21
-- Add: static Context.DefaultTargetFrameRate
-- Add: option to prevent USDZExporter from creating the button
-- Fix: `@prefix` handling promise resolving to false
-
-## [3.6.12] - 2023-06-20
-- Update Readme
-
-## [3.6.11] - 2023-06-19
-- Add: UI InputField API for clear, select and deselect from code
-- Change: LODGroup serialization
-- Fix: mobile debug console should be above loading overlay if error happens during loading
-- Fix: LODGroup not being able to resolve renderer reference
-- Fix: Particles direction being wrong in some causes with scaled parent and scaled particle system
-- Fix: Particles subsystem emitter position being wrong when main particle system was scaled
-- Fix: Bundled library failing to load due to undeclared variable
-- Fix: UI InputField hide html element
-- Fix: Joining empty room name is not allowed anymore
-- Fix: Clamp Room name length to 1024 chars
-
-## [3.6.10] - 2023-06-14
-- Fix: Text with richText not updating properly
-- Internal: Change font style parsing
-
-## [3.6.9] - 2023-06-12
-- Fix: Particles SizeOverLifetime module for mesh particles
-
-## [3.6.6] - 2023-06-12
-- Internal updates
-
-## [3.6.5] - 2023-06-09
-- Add: NestedGltf `loaded` event being raised when the glb has been loaded
-- Add: AnimationCurve cubic interpolation support
-- Change: set targetFramerate to 60 by default (in `context.targetFrameRate`)
-- Fix: USDZ metalness/roughness potentially being undefined when exporting Unlit materials
-- Fix: Handle exception when loading components due to bug when using meshopt compression and material count changes
-- Fix: ColorAdjustments setting tonemapping exposure to 0 when exposure parameter override is off [824]
-
-## [3.6.4] - 2023-06-02
-- Add: `ObjectUtils.createPrimitive` for cube and sphere
-- Change: expose `ObjectUtils`
-- Fix: BoxGizmo component
-- Fix: vite copy plugin when needle.config.json "assets" directory starts with "/"
-
-## [3.6.3] - 2023-06-01
-- Change: OrbitControls apply settings in update
-- Fix: Rapier stripping not being respected
-
-## [3.6.2] - 2023-06-01
-- Fix: wrong UI z-offset in some cases
-- Fix: Particle velocity over lifetime not using world rotation
-- Fix: Particle burst being played twice
-- Fix: Particle `playOnAwake` option not being respected
-
-## [3.6.2-beta] - 2023-05-31
-- Add: `setAllowOverlayMessages` to explictly disable overlay messages without url parameter
-- Add: allow larger textures for USDZ generation
-- Fix: nested gltf with disposing of resources leading to broken files
-
-## [3.6.1-beta] - 2023-05-29
-- Fix: removing `<needle-engine>` from DOM does now dispose the context properly and unsubscribes from browser events. Add `keep-alive` attribute to disable disposing
-
-## [3.6.0-beta] - 2023-05-29
-- Add callbacks for ContextClearing
-- Add: [n8AO postprocessing effect](https://github.com/N8python/n8ao) (Screenspace Ambient Occlusion) support
-- Add: option to disable automatic poster generation (use `noPoster` in options in vite.config) 
-- Fix: `<needle-engine>` without any src should setup an empty scene
-- Change: `OrbitControls.fit` now handles empty scene and ignores GridHelper
-- Change: TimelineAudio disconnect audio in onDestroy
-- Change: Ensure PostProcessing VolumeParameters are initialized
-- Change: Improve memory allocs and disposing of resources
-- Change: Update three.js fixing GLTFLoader memory leak
-
-## [3.6.0-alpha.3] - 2023-05-27
-- Add: `auto-rotate` attribute
-- Add: `autoplay` attribute
-- Change: await loading of `skybox-image` and `environment-image`
-- Change: do not clear renderer when switching `src` attribute
-
-## [3.6.0-alpha.2] - 2023-05-27
-- Fix: error in vite plugin when `meta.json` was missing
-- Fix: three.js OrbitControls causing look direction to not work anymore due to forcing an update in the constructor 
-
-## [3.6.0-alpha] - 2023-05-27
-- Add: Changing `src` attribute now does scene cleanup and loads new files
-- Add: `skybox-image` and `environment-image` attributes, allow changing both at runtime 
-- Fix: error display overlapping in cases where somehow engine is imported twice
-- Fix: logo overlay should only show when loading is done, change error during render loop message
-- Fix: OrbitControls camera fitting now done once before rendering when loaded glb does not contain any camera
-- Fix: Vite client plugin imports
-- Change: Context now handle errors during initializing or when starting render loop
-- Change: ContextRegistry exported as NeedleEngine and export hasIndieLicense function
-- Change: Remove need to manually define global engine variables in cases without bundler or Needle plugins
-
-## [3.5.13-beta.1] - 2023-05-26
-- Change: embed logo svg and avoid loading it
-
-## [3.5.13-beta] - 2023-05-26
-- Change: OrbitControls camera fitting improved
-
-## [3.5.12-beta] - 2023-05-24
-- Add: option to toggle collider visibility from script via `this.context.physics.engine.debugRenderColliders` 
-- Change: engine.physics raycast doesnt need any parameters now anymore
-- Change: OrbitControls default target should be related to distance to center (if nothing is hit by raycast)
-- Fix: EventList object and component argument deserialization
-
-## [3.5.11-beta] - 2023-05-22
-- Add: `@registerType` decorator that can be added to classes for registration in TypeStore. Currently only useful for cases outside of Unity or Blender for Hot Reload support
-- Fix: `Component.name` should return Object3D name
-- Fix: GameObject static methods generic
-- Fix: Logo animation causing browser scrollbar to appear
-
-## [3.5.10-beta] - 2023-05-22
-- Add: SpriteRenderer now exposes shadow casting and transparency options
-- Fix: vite plugin issue caused by missing src/generated/meta
-- Fix: nullref in debug_overlay, typo in physics comment
-- Fix: disabling collider with rigidbody component did cause an error in rapier
-- Fix: HTMLElement css, cleanup loading element, move logo into html element
-- Fix: GameObject.addComponent now takes Object3D type too
-- Fix: loading overlay not hiding when <needle-engine> src changes
-- Change: OrbitControls now sets target to 10 meter by default if nothing is assigned or hit in the scene (previously it was set to 1 meter)
-- Change: fit camera to scene after loading when no camera is present in file
-
-## [3.5.9-beta.2] - 2023-05-20
-- Add: WebXRPlaneTracking should initiate room setup on Quest when no tracked planes are found
-
-## [3.5.9-beta.1] - 2023-05-19
-- Fix: SceneSwitcher should ignore swipe events when `useSwipe` is disabled
-
-## [3.5.9-beta] - 2023-05-19
-- Add: Support for progressive texture loading for custom shaders
-- Fix: react-three-fiber template
-
-## [3.5.9-alpha.2] - 2023-05-18
-- Add: needle-engine attributes documentation
-- Change: assign main camera during gltf component deserialization when no camera is currently assigned
-
-## [3.5.9-alpha] - 2023-05-18
-- Add: add nextjs plugin to handle transpiling and defines
-- Change: expose USD types to make custom behaviours, add proximityToCameraTrigger
-- Fix: loading element position to absolute to avoid jumps when added to e.g. nextjs template
-- Fix: texcoords werren't quicklook compatible in ThreeUSDZExporter
-- Fix: `LookAt` component with invertForward option was flipped vertically in QuickLook
-
-## [3.5.8-alpha] - 2023-05-16
-- Add NeedleConfig `baseUrl` for codegen
-- Change: AudioSource should pause in background on mobile
-- Fix: logo svg import for nextjs
-- Fix: particle system playOnAwake
-
-## [3.5.7-alpha] - 2023-05-15
-- Add: Initial support for text in USDZ
-- Change: add generic to `networking.send` for validation of model
-- Change: SyncedRoom, expose tryJoinRoom method + remove error thrown when roomName.length <= 0, join room in onEnable
-- Fix: setting position on UI object (RectTransform) works again
-- Fix addressable instantiate options called with `{ position: .... }` and without a parent, it should then still take the scene as the default parent
-- Fix: WebXR `arEnabled` option
-- Fix: Worldspace canvas always being rendered on top
-- Fix: CanvasGroup alpha not being applied to text
-
-## [3.5.6-alpha] - 2023-05-12
-- Fix defines for vanilla JS usage
-- Fix CanvasGroup not overriding alpha
-- Remove some spurious logs
-- Add `addComponent` method to this.gameObject
-- Add "light" version on bundle processing
-
-## [3.5.5-alpha.1] - 2023-05-11
-- Fix: declare missing defines for pre-bundled engine
-
-## [3.5.5-alpha] - 2023-05-11
-- Add: getWorldDirection
-- Add: needle.config.json `build.copy = []` to copy files on build from arbitrary locations into the dist folder for example:
-  ```md
-  "build": {
-    "copy": [
-      "cards" <-- can be relative or absolute folder or file. In this case the folder is named "cards" in the web project directory
-    ]
-  }
-  ```
-- Add ip and location utils
-- Change: add buffers for getWorldQuaternion, getWorldScale util methods
-- Change: animatorcontroller should only log "no-action" warning when in debug mode
-- Fix: apply and check license
-
-## [3.5.4-alpha] - 2023-05-11
-- Fix: wrong serialization check if a property is writeable
-- Fix: mark UI dirty when text changes
-- Change: allow UI graphic texture to be set to null to remove any texture/image
-- Change: rename USDZExporter `overlay` to `branding`
-
-## [3.5.3-alpha.1] - 2023-05-10
-- Fix: wrong check in serialization causing particles to break (introduced in 3.5.3-exp)
-
-## [3.5.3-alpha] - 2023-05-10
-- Add: `IPointerMoveHandler` interface providing `onPointerMove` event while hovered
-- Add: USDZ AudioSource support and PlayAudioOnClick
-- Change: balloon messages can now loop
-- Change: pointer event methods are now lowercase
-- Change: allow `moveComponent` to be called with component instance that was not added to a gameObject before (e.g. created in global scope and not using the `addComponent` methods)
-- Fix: input pointer position delta when browser console is open
-- Fix: GameObject.destroy nullcheck
-- Fix: typescript error because of import.meta.env acccess
-- Fix: issue where added scenelighting component by extension caused animation binding to break
-- Fix: UI layout adding objects dynamically by setting anchorMinMax
-- Fix: Prevent exception during de-serialization when implictly assigning value to setter property
-- Fix: screenspace canvas being rendered twice when using explicit additional canvas data component
-- Fix: EventSystem cached state of hovered canvasgroup not being reset causing no element to receive any input anymore after having hovered a non-interactable canvasgroup once
-- Fix: empty array being returned in `GameObject.getComponents` call when the passed in object was null or undefined
-
-## [3.5.2-alpha] - 2023-05-09
-- Add: SceneSwitcher preload feature
-- Change: interactive behaviours for QuickLook are on by default now
-- Fix: SetActiveOnClick toggle for QuickLook
-- Fix: USDZ texture transform export works in more cases
-
-## [3.5.1-alpha] - 2023-05-09
-- Fix: reflection probes not working anymore
-- Fix: false RectTransform return breaking some cases with reparenting
-- Fix: RectTransform mark dirty when anchors change (due to animation for example)
-
-## [3.5.0-alpha] - 2023-05-08
-- Change: allow tree-shaking rapier physics
-- Fix various USDZ export issues:
-  - fix UV2 for occlusion maps (paves the way for lightmaps), had to be texCoord2f[] instead of float2[]
-  - fix missing MaterialBindingAPI schema
-  - fix normal scale for non-ARQL systems (ARQL doesn't support it though, but needed for other viewers)
-  - fix input:scale for textures not being used if it's (1,1,1,1)
-  - fix normal maps not being in raw colorSpace
-
-## [3.4.0-alpha] - 2023-05-05
-- Add: low-level USD Actions/Triggers API for building complex interactions for iOS devices
-- Add: high-level USDBehaviours components: ChangeMaterialOnClick, PlayAnimationOnClick, SetActiveOnClick, HideOnStart
-- Add: LookAt component now supports iOS AR
-- Add: more settings for LookAt
-- Add: support for Horizontal- and VerticalLayoutGroup (UI)
-- Fix: `setWorldScale` was setting incorrect scale in some cases
-- Fix: WebXR Image Tracking now works with WebARSessionRoot / rig movements
-- Fix: vite reload only when files inside "assets" change and only if its a known file type
-
-## [3.3.0-alpha] - 2023-05-02
-- Add: AssetReference can now handle scene reference
-- Add: UI update with support for screenspace UI, anchoring, pivots, image outline effect, image pixelPerUnit multiplier
-- Add: basic LookAt component
-- Add: basic UI outline support + handle builtin Knob image
-- Add: WebXRImageTracking ability to directly add a tracked object to an image marker
-- Fix: OrbitControls should only update when being the active camera
-- Fix: UI input ignored browser "mouseDown" for each "touchUp" event
-- Fix: OrbitControls requiring additional tab after having clicked on UI
-- Fix: OrbitControls only being deactivated when down event starts on UI element
-- Fix: loading bar text not being decoded (displayed e.g. `%20` for a space)
-- Fix: TransformGizmo not working anymore
-
-## [3.2.15-alpha] - 2023-04-28
-- Add: SceneSwitcher.select(AssetReference) support to be invoked from a UnityEvent with an object reference (must be an asset)
-- USDZExporter: change exported usdz name, remove needle name for license holders
-
-## [3.2.14-alpha] - 2023-04-28
-- Add: OpenURL component
-- Change: Implictly add Raycaster to scene if it is not found.
-- Fix: USDZ export breaking if the object name is just a number 
-
-## [3.2.13-alpha] - 2023-04-27
-- Add: USDZExporter editor shows warning if no objects are assigned and exposes quicklook overlay texts
-- Add: USDZExporter callToActionButton can now invoke url to open
-- Add: SceneSwitcher can now use history without updating the url parameter
-- Fix: Fix vite html transform plugin
-
-## [3.2.12-alpha] - 2023-04-26
-- Fix: issue where removing an object from the scene would disable all its components
-
-## [3.2.11-alpha] - 2023-04-25
-- Fix: lighting settings being implictly switched (enabled/disabled) when using SyncCamera / any loaded prefab at runtime
-
-## [3.2.10-alpha] - 2023-04-25
-- Fix: Remove log in `Animator.SetTrigger`
-- Fix: GroundEnv radius property setting wrong value internally
-- Fix: Apply license to unnamed local vite chunk files
-
-## [3.2.9-alpha] - 2023-04-23
-- Fix: VideoPlayer not restarting when enable/disable being toggled
-- Fix: Builtin serializer for URLs `@serializable(URL)` should ignore empty strings
-- Change: set `enabled` to true before calling `onEnable`
-- Change: VideoPlayer now deferrs loading of the video until the video should play
-- Change: ScreenSharing component now changes cursor pointer on hover to indicate that is can be clicked
-
-## [3.2.8-alpha] - 2023-04-23
-- Add: this.context.getPointerUsed(index) and setPointerUsed(index)
-- Change: physics now by default receives collisions/triggers between two colliders that are set to trigger
-
-## [3.2.7-alpha] - 2023-04-22
-- Change: ambient light does now look closer to Unity ambient light
-- Fix: guard calls to component event methods when the component or object has been destroyed
-
-## [3.2.6-alpha] - 2023-04-21
-- Add: SceneSwitcher has now option to automatically set scene environment lighting
-- Fix: Issue caused by NeedleEngineHTMLElement import from SceneSwitcher
-- Change: Allow component to be disabled in awake (e.g. calling `this.enabled = false` in awake callback)
-- Change: Export more types e.g. AnimatorStateMachineBehaviour
-- Change: VolumeParameter.value should return rawValue (unprocessed)
-- Change: rename "rendererData" to "sceneLighting"
-- Change: scene lighting must now be enabled explictly when additional scene are being loaded, use `this.context.sceneLighting.enable(...)` with the AssetReference or sourceId of the scene you want to enable
-
-## [3.2.5-alpha.1] - 2023-04-20
-- Change: export more types
-
-## [3.2.5-alpha] - 2023-04-20
-- Add: WebXRPlaneTracking
-- Add: `<needle-engine loading-style="light">` for a brighter loading screen
-- Fix: InputField.onEndEdit should send string
-- Change: move webxr into subfolder
-- Change: export more types
-
-## [3.2.4-alpha.2] - 2023-04-20
-- Change: export more types
-
-## [3.2.4-alpha] - 2023-04-20
-- Change: export more types (e.g. `syncField`)
-- Fix: PlayerSync
-- Fix: Environment lighting
-- Fix: license check
-
-## [3.2.3-alpha] - 2023-04-20
-- Fix: VideoPlayer AudioOutput.None should mute video
-- Fix: SpriteRenderer applies layer from current object (e.g. for IgnoreRaycast)
-
-## [3.2.2-alpha] - 2023-04-19
-- Fix: issue where the environment lighting would be falsely disabled
-- Change: minor improvements to initial state of the SceneSwitcher
-
-## [3.2.1-alpha] - 2023-04-19
-- Change: SceneSwitcher clamp option
-- Change: timeline signals without bound receiver are now invoked globally on all active SignalReceivers with the specific signal asset
-- Change: internal check preventing errors during initialization for projects where the package is falsely added multiple times to the project by importing from internal types directly instead of `from "@needle-tools/engine"`
-
-## [3.2.0-alpha] - 2023-04-19
-- Add: built-in SceneSwitcher component
-- Change: VideoPlayer.playInBackground is set to true by default
-- Change: Screensharing should continue playback of receiving video when the sending tab becomes inactive
-- Change: log additional information when button events can not be resolved
-- Change: AudioSource.playInBackground set to true by default to allow audio playback when tab is not active
-- Change: syncField can now take function argument
-- Change: Renderer.sharedMaterials can now be iterated using `for(const mat of myRenderer.sharedMaterials)`
-- Fix: lightmap not being resolved anymore
-- Fix: environment lighting / reflection not switching with scenes
-- Fix: progressive texture did not check if the texture was disposed when switching to an unloaded scene resulting in textures being black/missing
-- Fix: timeline does enable animator again when pausing/stopping allowing to switch to e.g. idle animations controlled by an AnimatorController
-- Fix: changing material on renderer with lightmapping will now re-assign the lightmap to the new material
-
-## [3.1.0-alpha.2] - 2023-04-18
-- Fix: UI font style resolving
-
-## [3.1.0-alpha.1] - 2023-04-18
-- Fix: RemoteSkybox not being able to load locally reference dimage
-- Fix: ParticleSystem sphere scale not being applied anymore
-- Fix: WebXRImageTracking url not being resolved
-
-## [3.1.0-alpha] - 2023-04-18
-- Add: `ImageReference` type, use to export textures to external files and load them as `img`, `texture` or to get the binary data for e.g. image tracking
-- Add: api for `WebXRImageTracking`, this does currently require the ``webxr-incubations`` flag to be enabled
-- Add: TiltShift postprocessing effect
-- Add: AnimatorController support for negative speed
-- Change: ParticleSystem now has a reset method to allow for clearing state, stop has options for calling stop on Sub-Emitters and to clear already emitted particles
-
-## [3.0.1-alpha.5] - 2023-04-17
-- Add: `this.context.xrFrame` to get access to the current XRFrame from every lifecycle event method
-- Change: license check is now baked
-- Change: Rename "EngineElement" to NeedleEngineHTMLElement
-- Change: disable "Enable Keys" on OrbitControls by default as it conflicts with so many things
-- Fix: ParticleSystem circle shape
-- Fix: balloon messages are now truncated to 300 characters
-- Fix: Screensharing connection setup and start of video playback
-- Fix: Screensharing muting now local audio
-- Fix: AudioSource does not play again when it did finish and the user switches tabs
-- Fix: ParticleSystem prewarm
-- Fix: ParticleSystem minMax size, it's currently not supported and should thus not affect rendering
-
-## [3.0.1-alpha.4] - 2023-04-12
-- Bump with changed package.json
-
-## [3.0.1-alpha.3] - 2023-04-11
-- Fix: WebXR all layers should be visible
-- Fix: WebXRController raycast on all layers
-- Fix: issue with mouse vector position being re-used causing delta position being falsely modified
-- Change: store static Context.Current in globalThis
-- Change: alias resolve imports `@needle-tools/engine/engine` and `@needle-tools/engine/src` to lib folder
-
-## [3.0.0-alpha] - 2023-04-05
-- Add: vite alias plugin
-- Add: vite copyfiles plugin
-- Fix: lib sourcemap path
-- Fix: Postprocessing not being applied
-- Internal: needle vite plugin names now all start with "needle-"
-
-## [2.67.16] - 2023-04-13
-- Add: static ``AudioTrackHandler.dispose`` for disposing loaded audio data in timeline
-- Fix: issue where only the first audio clip would be played in a timeline with multiple audio clips of the same file
-- Change: Text should not change font name casing
-- Change: Timeline does now wait for audio and first interaction by default (if any audio track is being used, this can be disabled by setting `waitForAudio` to false on the PlayableDirector component)
-- Change: postprocessing DOF exposes resolution scale and takes device pixel density into account. By default the resolution is slightly lowered on mobile devices
-
-## [2.67.14-pre] - 2023-04-12
-- Change: WebXR camera now copies culling mask from main camera
-- Fix: WebXRController raycast on all layers
-- Fix: WebXR all layers should be visible
-- Fix: set pointer position properly on mouse down to prevent jumps in delta
-- Fix: respect IgnoreRaycast in physics raycasts
-- Fix: issue with CircularBuffer where sometimes the same item was returned twice
-- Fix: boxcolliders with scale 0 (such as adding a BoxCollider to a plane) resulted in flipped normals being returned from raycasts
-- Fix: parenthesis error in CharacterController
-- Fix: issue with mouse vector position being re-used causing delta position being falsely modified
-
-## [2.67.13-pre] - 2023-04-11
-- Fix: Animation component settings
-- Fix: instanced renderer matrix auto update
-- Change: enable shadow casting in instanced rendering when any mesh has castShadow enabled
-- Change: export ui pointer events
-
-## [2.67.12-pre] - 2023-04-09
-- Add: SSAO color and luminance influence options
-- Change: postprocessing now exposes effect order
-
-## [2.67.11-pre] - 2023-04-08
-- Add: some checks for WebGPURenderer
-
-## [2.67.10-pre] - 2023-04-06
-- Add vite copy files build plugin
-- Fix: PostProcessing not applying effects when enabled for the second time as well as removing earlier hack
-- Change: update user-select/touch-action in project templates style.css to prevent accidental iOS selection of canvas
-- Change: disable text selection on Needle logo
-- Bump three version, see changes below
-
-### Three
-- change USDZExporter: pass writer into onAfterHierarchy callback, move onAfterHierarchy callback after scene hierarchy write
-- fix USDZExporter: fix exception when trying to process render targets
-- fix WebXRManager: Correctly update the user camera when it has a parent with a non-identity transform.
-
-## [2.67.9-pre] - 2023-04-03
-- Change: SpriteRenderer material to transparent
-- Bump: tools package dependency
-
-## [2.67.8-pre.1] - 2023-03-31
-- Fix: exception when using BoxColliders caused by error in initial activeInHierarchy state assignment
-
-## [2.67.8-pre] - 2023-03-31
-- Fix: vite plugins must have a name
-- Fix: activeInHierarchy update when key is undefined (e.g. in r3f context)
-- Change: cleanup r3f component
-
-## [2.67.7-pre] - 2023-03-30
-- Add: time smoothed delta time
-- Add this.context.targetFrameRate
-- Fix: enum / type conversion errors
-- Fix: CanvasGroup overriding text `raycastTarget` state in event handling causing problems with button events
-- Fix: Text z-fighting from invisible ThreeMeshUI frame object
-- Change: Canvas `renderOnTop` moved into separate render call to avoid ordering issues and postprocessing affecting overlay UI
-- Internal: Move context from engine_setup to engine_context
-
-## [2.67.6-pre] - 2023-03-30
-- Fix: Postprocessing enforce effect order
-- Change: gizmos should not render depth
-
-## [2.67.5-pre] - 2023-03-30
-- Fix: issue where postprocessing did not check composer type (e.g. when using threejs composer instead of pmndrs package)
-- Change: Postprocessing now uses stencil layers
-
-## [2.67.4-pre] - 2023-03-28
-- Change: Postprocessing effects value mapping / settings improved (Bloom & ColorAdjustments)
-
-## [2.67.3-pre] - 2023-03-28
-- Fix: issue where progressive textures would not be applied correctly anymore
-- Fix: Timeline audio loading on firefox
-- Fix: issue where progressive textures with reflection probes wouldn't be applied correctly anymore
-
-## [2.67.2-pre] - 2023-03-28
-- Change: calculations for rect transform animation offsets
-- Change: Warn if engine element src contains a url without .glb or .gltf
-
-## [2.67.1-pre] - 2023-03-28
-- Fix: PostProcessing failing to be re-applied after exit XR
-
-## [2.67.0-pre] - 2023-03-27
-- Add: `this.gameObject.destroy` as a shorthand for `GameObject.destroy(this.gameObject)`
-- Add: support for camera `targetTexture` to render into a RenderTexture (when assigned to e.g. the main camera in Unity)
-- Add: utility methods to toplevel engine export (for example `getParam`, `delay`, `isMobileDevice`, `isQuest`)
-- Add: first version of usage tracking of materials, textures and meshes. This is off by default and can be enabled using the `?trackusage` url parameter. When enabled `findUsers` can be used to find users of an object.
-- Add: pmnders postprocessing package
-- Change: improved PlayerState component and added event for PlayerState events for owner change (to properly listen to first assignment)
-- Change: `AssetReference.unload` now calls dispose to free all resources
-- Change: `WebXR` component now has static field for modifying optionalFeatures 
-- Change: `Physics.RaycastOptions` now have a `setLayer` method to simplify setting the correct layer mask (similar to Unity's layers to enable e.g. just layer 4 for raycasting)
-- Change: `RemoteSkybox` now requests to re-apply clear flags on main camera when disabling to restore previous state.
-- Fix: issue where component instances were created using wrong method causing arrow functions to be bound to the wrong instance
-- Fix: `@syncField` now properly handles destroy of an component
-- Fix: react-three-fiber template
-- Fix: ParticleSystem prewarm safeguard and additional checks where emission is set to 0
-- Fix: Timeline only playing first audio clip
-- Fix: Issue where scene with multiple root glbs cross-referencing each other were not being resolved correctly in all cases
-- Fix: Progressive textures not being loaded when using tiling
-- Fix: Text UI anchoring
-
-## [2.66.1-pre] - 2023-03-16
-- Add: `sphereOverlapPhysics` function for more accurate sphere overlap detection using rapier
-- Fix: Gizmos should be excluded from being hit by raycasts
-- Fix: Gizmo sphere radius was twice the desired size
-- Fix: Physics now prevent negative collider scale
-- Fix: renderer instancing auto update when using multi material objects
-- Change: Show warning that stencil and instancing doesnt work together at the moment
-
-## [2.66.0-pre] - 2023-03-14
-- Add: particle system prewarm support
-- Add: `poseMatrix` argument in WebARSessionRoot.placedSession event
-- Add: MeshCollider minimal support for submeshes (they can be added but currently not removed from the physics world)
-- Fix: debug_overlay error when rejection reason is null
-- Fix typo beginListenBinrary → beginListenBinary
-- Fix: particle system staying visible after disabling gameObject
-- Fix particle system not finding subemitter in certain cases
-- Fix: particles with subemitters and trails and disabled "die with particle" should emit subemitter when the particle dies (and not when the trail dies)
-- Fix: Loading overlay now hides when loading is done and the first frame has finished rendering
-- Change: rename networking `stopListening` to `stopListen` for consistency
-- Change: addressables allow up to 10k instantiations per frame before aborting
-- Change: set material shadowSide to match side
-- Change: generate poster image with 1080x1080 px and add `og:image:width` and `og:image:height` meta tags
-
-## [2.65.2-pre] - 2023-03-11
-- Change: custom shaders should not log warning for unsupported ``OrthoParams`` shader property 
-- Change: Animator methods starting with uppercase are marked as deprecated because UnityEvent methods are now exported starting with lowercase letter, added lowercase methods
-
-## [2.65.1-pre] - 2023-03-10
-- Fix: ParticleSystem using `min/max` size in the renderer module is now minimally handled
-- Fix: ParticleSystem emission when using local space with scaled parents
-- Fix: ParticleSystem not finding SubEmitter systems
-- Fix: ParticleSystem simulation speed not being applied to gravity and initial speed
-- Fix: RemoteSkybox not resolving relative url correctly (when assigning a cubemap in the editor)
-
-## [2.65.0-pre.1] - 2023-03-10
-- Fix: issue where `<needle-engine>` element was not yet in the DOM when queried by exporter codegen which caused the paths to not be assigned and the engine to not load
-
-## [2.65.0-pre] - 2023-03-09
-- Add: runtime checks for recursive loading to prevent it from breaking
-- Change: internal duplicate active state on `Object3D` has been removed, instead `visible` is used. This was previously a workaround for the `Renderer` setting the visible state when being enabled or disabled but this has been changed in a previous version and it now only sets a flag in the object's Layers instead (which allows for a single object in the hierarchy to not being rendered by setting `Renderer.enabled = false` while objects in the child hierarchy stay visible) 
-- Change: `<needle-engine>` src attribute can now also take an array of glbs to load. This simplifies codegen done by exporters and also prevents errors due to bundler optimizations as well as being easier to understand. Runtime changes of the `src` attribute (especially when using arrays of files) have not been tested for this release. Networking for `src` changes has been removed in this release. 
-- Change: move engine into src subfolder. All paths to explicit script files are now `@needle-tools/engine/src/...`
-- Change: poster screenshot will be taken after 200ms now
-- Change: canvas default set to false for castShadow and receiveShadow
-- Change: Remote skybox should not set `scene.background` when in XR with pass through device (e.g. when using Quest Pro AR or AR on mobile)
-- Fix: issue where ColorAdjustments Volume effect was applied with `active` set to false
-- Fix: `Light` not being enabled again after disabling the component once
-
-## [2.64.0-pre] - 2023-03-07
-- Add: `PlayableDirector` now correctly applies timescale
-- Add: `PlayableDirector.speed` property allowing to play the timeline at different speeds or even reverse (reversed audio playback is not supported at the moment)
-- Add: `Physics.enabled` property for disabling physics updates. This also prevents any collider shapes to be created
-- Add: `this.gameObject.transform` property to ease getting started for devs coming from Unity. This property is merely a forward to `this.gameObject` and shouldnt really be used. The property description contains information and a [link to the docs](https://fwd.needle.tools/needle-engine/docs/transform) with further information.
-- Fix: instanced materials using progressive loading are now correctly updated
-- Fix: Timeline animation tracks now disable the `Animator`. This fixes cases where two animations were played at the same time. When the PlayableDirector is paused or stopped the animator state is reset
-- Fix: License styles leaking into website
-- Fix: Timeline audio not stopping correctly at end of timeline when set to hold
-- Change: improve instancing updates, instanced objects now auto update detect matrix changes. This includes improvements of instancing when used with `Animation` components
-- Change: set particle system layers to `IgnoreRaycast` to not receive wrong click events on batched particle meshes
-- Change: Timeline audio is now loaded on evaluation. Only clips in a range of 1 second to the current time are loading. To manually trigger preload of audio you can invoke `loadAudio` with a time range on audio tracks of a timeline
-
-## [2.63.3-pre] - 2023-03-03
-- Fix: engine published to npm was missing vite plugins
-
-## [2.63.2-pre] - 2023-03-03
-- Fix: license styling in some cases
-- Fix: duplicatable + draggable issue causing drag to not release the object (due to wrong event handling)
-- Fix duplicatable + deletion not working properly
-- Fix: timeline breaking when time is set to NaN
-
-## [2.63.1-pre] - 2023-03-02
-- Add: components now have `up` and `right` vectors (access via ``this.up`` from a component)
-- Fix: import of license and logo for npm package
-
-## [2.63.0-pre] - 2023-03-01
-- Add: licensing information
-- Add: logo to loading display
-- Change: VideoPlayer now exposes VideoMaterial
-- Change: Screencapture now only accepts clicks with pointerId 0 (left mouse button, first touch) to toggle screen capture
-- Change: expose physics gravity setting `this.context.physics.gravity`
-
-## [2.62.2-pre] - 2023-02-27
-- Add: support for `camera-controls` attribute on `<needle-engine>` element. When added it will automatically add an `OrbitControls` component on start if the active main camera has no controller (you can assign custom controllers by calling `setCameraController` with the camera that is being controlled)
-- Fix: rare error in extension_util
-- Fix: timeline preExtrapolation setting
-- Fix: disabling Light component should turn off light
-- Fix: animating camera fov, near or far plane
-- Fix: threejs layer patch for Renderer visibility is now always applied
-- Fix: UI runtime instantiate of canvas from templates in scene
-- Fix: UI text did not update shadow-component-owner on font loading
-- Fix: UI EventSystem raising click event multiple times in some cases
-- Fix: UI Text raycast now respects object layer (NoRaycast)
-- Fix: UI duplicate pointerUp event
-- Fix: UI highlighting getting stuck in wrong state sometimes
-
-## [2.62.1-pre] - 2023-02-23
-- Fix: pause wasn't evaluating and thus not pausing audio tracks
-- Fix: debug overlay styles were not properly scoped and affected objects inside needle-engine tag
-- Fix: Addressables wrong recursive instantiation error
-- Fix: UI not showing fully when setting active at runtime
-- Change: timeline tracks are now created immediately but their audio clips are deferred until audio is allowed
-
-## [2.62.0-pre] - 2023-02-13
-- Bump version
-
-## [2.61.0-pre] - 2023-01-30
-- Add: canvas applyRenderSettings
-- Add: progressive support for particle system textures
-
-## [2.60.4-pre] - 2023-01-27
-- Fix UI prefab instantiate throwing error at runtime
-- Change: show warning when unsupported canvas type is selected
-- Change: show warning when trying to use webxr features in non-secure context
-
-## [2.60.3-pre] - 2023-01-26
-- Fix: camera fov for blender export allowing fieldOfView property to be undefined, where the fov should be handled by the blender exporter completely.
-
-## [2.60.2-pre] - 2023-01-26
-- Fix: particle textures being flipped horizontally
-
-## [2.60.1-pre] - 2023-01-25
-- Change: export Mathf in `@needle.tools/engine`
-
-## [2.60.0-pre] - 2023-01-25
-- Add: Particles support for horizontal and vertical billboards
-- Add: Timeline now supports reversed clip (for blender timeline)
-- Change: bump gltf pipeline package dependency adding support for global `NEEDLE_TOKTX` environment variable
-- Change: timeline clip pos and rot are now optional (for blender timeline)
-- Fix: when first loading a gltf pass guidsmap to components (for blender timeline)
-- Fix: scrubbing TimelineTrack scrubs audio sources as well now
-- Fix: stencils for multimaterial objects
-
-## [2.59.2-pre] - 2023-01-21
-- Add: particles basic support for on birth and ondeath subemitter behaviour
-
-## [2.59.1-pre.1] - 2023-01-20
-- Fix: issue where click on overlay html element did also trigger events in the underlying engine scene  
-
-## [2.59.1-pre] - 2023-01-20
-- Add: SpectatorCam.useKeys to allow users to disable spectator cam keyboard input usage (`f` to send follow request to connected users and `esc` to stop following)
-- Change: expose SyncedRoom.RoomPrefix
-
-## [2.59.0-pre] - 2023-01-18
-- Add: AssetReference.unload does now dispose materials and mesh geometry
-- Add: ``setParamWithoutReload`` now accepts null as paramValue which will remove the query parameter from the url
-- Change: timeline does now skip export for muted tracks
-- Change: OrbitControls can now use a custom html target when added via script and before enable/awake is being called (e.g. ``const orbit = GameObject.addNewComponent(this.gameObject, OrbitControls, false); orbit.targetElement = myElement``)
-- Change: Input start events are now being ignored if a html element is ontop of the canvas
-- Fix: use custom element registry to avoid error with `needle-engine element has already been defined`
-- Fix: timeline not stopping audio on stop
-- Fix: input click event being invoked twice in certain cases
-- Fix: ParticleSystem start color from gradient
-- Fix: ParticleSystem not properly cleaning up / removing particles in the scene in onDestroy
-- Fix: ParticleSystem velocity now respects scale (when mode is set to worldscale)
-
-## [2.58.4-pre] - 2023-01-14
-- Update gltf-extensions package dependency
-
-## [2.58.3-pre] - 2023-01-13
-- Bump version
-
-## [2.58.2-pre] - 2023-01-12
-- Change: use draco and ktx loader from gstatic server by default
-- Change: reduce circular dependencies
-- Fix: Reflectionprobe selecting wrong probe when multiple probes had the exact same position
-
-## [2.58.1-pre] - 2023-01-09
-- Add: Prewarm rendering of newly loaded objects to remove lag/jitter when they become visible for the first time
-- Change: renderer now warns when sharedMaterials have missing entries. It then tries to remap those values when accessing them by index (e.g. when another component has a material index serialized and relies on that index to be pointing to the correct object)
-
-## [2.58.0-pre] - 2023-01-09
-- Add: EventSystem input events (e.g. IPointerClick) are now invoked for all buttons (e.g. right click)
-- Add: Hot reload for components
-
-## [2.57.0-pre] - 2023-01-07
-- Remove: Meshline dependency
-- Fix: Testrunner Rigidbody import error
-
-## [2.56.2-pre] - 2023-01-06
-- Change: Component.addEventListener argument can now derive from Event
-
-## [2.56.1-pre] - 2023-01-05
-- Fix: UI setting Image.sprite property did apply vertical flip every time the sprite was set
-
-## [2.56.0-pre] - 2023-01-04
-- Add: file-dropped event to DropListener
-- Add: UI image and raw image components now support updating texture/sprite at runtime
-- Change: Bump needle gltf-transform extensions package adding mesh compression and caching for texture compression leading to significant speedups for subsequent production builds (only changed textures are re-processed)
-- Fix: light normal bias defaults
-
-## [2.55.2-pre] - 2023-01-02
-- Add: Rigidbody.gravityScale property
-- Add: Gizmos.DrawArrow method
-- Add: Rigidbody.getAngularVelocity method
-- Fix: Mesh collider center of mass
-
-## [2.55.1-pre] - 2022-12-30
-- Add: Warning when serialized component field name is starting with uppercase letter
-- Change: bump component compiler dependency
-- Fix: Particle rotation over lifetime
-- Fix: Particles should not emit when emission module is disabled
-- Fix: LODGroup breaking rendering when used with multi-material objects or added on mesh to be culled directly
-
-## [2.55.0-pre] - 2022-12-21
-- Add: PhysicsMaterial support
-- Add: ``Time.timesScale`` factor
-- Change: VideoPlayer exposes underlying HTML video element
-- Change: EffectComposer check if ``setPixelRatio`` method exists before calling
-- Change: WebARSessionRoot and Rig rotation
-- Fix: WebXRController raycast line not being visible in Quest AR
-- Fix: Renderer that is disabled initially now hides object
-- Fix: Some ParticleSystem worldspace settings when calling emit directly
-
-## [2.54.2-pre] - 2022-12-19
-- Change: debug parameter can now take ``=0`` for disabling them (e.g. ``freecam=0``)
-- Fix: InputField opens keyboard on iOS
-
-## [2.54.1-pre] - 2022-12-15
-- Fix: issue with progressive loading, loading files multiple times if a texture was used in multiple materials/material slots. This was causing problems and sometimes crashes on mobile devices 
-- Fix: balloon messages using cached containers didnt update the message sometimes and displaying an old message instead
-
-## [2.54.0-pre.1] - 2022-12-14
-- Fix: bump gltf extensions package fixing issue with progressive texture loading when multiple textures had the same name 
-
-## [2.54.0-pre] - 2022-12-14
-- Add: start and end events for progressive loading
-- Add: USDZExporter events for button creation and after export
-- Change: apply WebARSessionRoot scale to exported object, e.g. if scene is scaled down on Android it should receive the same scale when exporting for Quicklook
-- Fix: process reflection probe update in update event to avoid visible flickr after component enabled state has changed
-
-## [2.53.1-pre.1] - 2022-12-12
-- Fix: implement ButtonColors
-
-## [2.53.1-pre] - 2022-12-12
-- Add: GroundProjection appyOnAwake to make it possible to just use it when the environment changes via remote skybox and not apply it to the default skybox
-- Change: more strict tsconfig
-- Change: allow overriding loading element
-- Fix: apply shape module rotation to direction
-- Fix: ParticleSystem world position not being set when shape module was disabled
-
-## [2.53.0-pre] - 2022-12-08
-- Add: InstantiateIdProvider constructor can now take string too for initializing seed
-- Add: USDZExpoter component enabling ``Open in Quicklook`` option by default when running on iOS Safari
-- Fix: Light intensity
-- Fix: Add workaround texture image encoding issue: https://github.com/needle-tools/needle-engine-support/issues/109
-- Fix: OrbitControls.enableKeys
-- Fix: Remove warning message about missing ``serializable`` when the reference is really missing
-- Fix: ``context.domX`` and ``domY`` using wrong values when in AR mode
-
-## [2.52.0-pre] - 2022-12-05
-- Add iOS platform util methods
-- Add ``?debugrig`` to render XRRig gizmo
-- Add support for Spritesheet Animation
-- Add: EventTrigger implementations for onPointerClick, onPointerEnter, onPointerExit, onPointerDown, onPointerUp
-- Add: RemoteSkybox environmentBlurriness setting
-- Fix: Renderer reflection probe event order issue not applying reflection probes when enabling/disabling object because reflection probes have not been enabled
-- Fix: remove log in ParticleSystemModules
-
-## [2.51.0-pre] - 2022-11-30
-- Change: remove nebula, dat.gui and symlink package dependencies
-- Change: Light does not change renderer shadowtype anymore
-- Change: update threejs to 146
-- Change: update threejs types
-- Change: Screencapture should not start on click when not connected to networked room
-- Change: WebXR returns ar supported when using Mozilla WebXR
-- Fix DragControls drag interaction not disabling OrbitControls at right time
-- Fix physics collider position in certain cases
-- Fix Rigidbody not syncing physics position when parent transform changes
-- Fix Timeline awake / active and enable
-- Fix: OrbitControls calulcating target position with middle mouse click in worldspace instead of localspace causing wrong movement when parent is transformed
-- Fix: Raycast in Mozilla WebXR / using window sizes instead of dom element sizes
-- Fix input with scrolled window
-- Fix: destroy local avatar on end of webxr session (https://github.com/needle-tools/needle-engine-support/issues/117)
-- Fix: WebXRAvatar setting correct XRFlags
-
-## [2.50.0-pre] - 2022-11-28
-- Add warning to Light when soft shadows change renderer shadow type
-- Add: RemoteSkybox can now load jpg and png textures as skybox
-- Change: Instantiate does now copy Vector, Quaternion and Euler objects to ensure multiple components dont share the same objects
-- Fix: AnimatorController causes threejs error when creating empty animationclip (Blender) 
-- Fix: AnimatorController error when transition has no conditions array (Blender)
-
-## [2.49.1-pre] - 2022-11-25
-- Add circular instantiation check to AssetReference
-- Allow filtering ``context.input.foreachPointerId()`` by pointer types (e.g. mouse or touch)
-- Fix typescript error in particle system module function (happened only when ``strict`` was set to false in tsconfig)
-- Fix XRFlag component not being applied on startup
-
-## [2.49.0-pre] - 2022-11-24
-- Add: input iterator methods to loop over currently active input pointer ids
-- Change: input refactor to work better with touch
-- Fix GraphicRaycaster serialization warning
-- Fix deserialization bug when Animation clips array is not serialized (exported from blender)
-- Fix: remove leftover log in AnimatorController when cloning
-- Fix XR flag not correctly restoring state
-- Fix reticle not being rendered when XRRig is inside WebARSessionRoot
-- Fix Mozilla XR AR overlay (https://github.com/needle-tools/needle-engine-support/issues/81)
-- Fix Mozilla XR removing renderer canvas on exit AR (https://github.com/needle-tools/needle-engine-support/issues/115)
-
-## [2.48.0-pre] - 2022-11-23
-- Add: debug console for better mobile debugging (shows up on error on mobile in local dev environment or when using the ``?console`` query parameter)
-- Add: dom element visibility checks and suspend rendering and update loops (if ``this.context.runInBackground`` is false)
-- Add: ``this.context.isPaused`` to manually suspend rendering
-- Add: ``IComponent.onPausedChanged`` event method which is called when rendering is paused or resumed
-- Change: update copy-from-to dev dependency version to fix build error when path contains ``(``
-- Change: ``this.context.input`` does now support pointer lock state (properly reports delta)
-- Fix: make sure VRButton has the same logic as in three again (regex instead of try-catch)
-- Fix: WebXRViewer DOM Overlay bugs when dom overlay element is inside canvas
-- Fix: exitAR not being called in some cases when exiting AR
-- Fix: ``this.context.domX`` and ``this.context.domY`` when web component is not fullscreen
-
-## [2.47.0-pre] - 2022-11-17
-- Add: Initial react three fiber components
-- Change: OrbitControls made lerp stop distance smaller 
-- Change: expose ``*enumerateActions()`` in AnimatorController
-- Fix: Flipped custom reflection texture
-- Fix: Volume exposure not being applied when no Tonemapping effect was set
-- Fix: Volume tonemapping not respecting override state setting
-- Fix: ``AudioSource.loop`` not working
-- Fix: Collider center being not not applied correctly
-- Fix: MeshCollider scale not being applied from object
-
-## [2.46.0-pre] - 2022-11-16
-- Add: Particles subemitter support
-- Add: Particles inherit velocity support
-- Add: Particles size by speed support
-- Add: Particles color by speed support
-- Add: Particles trail now fadeout properly when "die with particle" is disabled
-- Add: Particles circle shape
-- Change: button hover now sets cursor to pointer
-- Fix: WebXR controller disabling raycast line for hands
-- Fix: WebXR hands path when not assigned in Unity
-- Fix: Mesh Particles not rendering because of rotation being wrongly applied
-- Fix: Mesh particles size in AR
-- Fix: Particles color and size lerp between two curves
-
-## [2.45.0-pre] - 2022-11-14
-- Add: RemoteSkybox option to control if its set as background and/or environment
-- Add: @serializable decorator, @serializeable will be removed in a future version
-- Add: getComponent etc methods to IGameObject interface
-- Add: Renderer.enable does now set visible state only without affecting the hierarchy or component active state
-- Change: Expose Typestore
-- Change: Animation componet does loop by default (use the AdditionalAnimationData component to set the default loop setting)
-- Fix: WebXR relative hands path in subfolders
-- Fix: Rigidbody did not properly detect object position change if the position change was applied a second time at the exact same target position (it worked setting it once and didnt work in subsequent calls - now it does always detect it)
-
-## [2.44.1-pre] - 2022-11-13
-- Add: RemoteSkybox exposes ``background`` and ``environmnet`` properties to configure if the loaded skybox is set for the scene background and/or the environment light
-- Change: Expose TypeStore
-
-## [2.44.0-pre] - 2022-11-11
-- Add: Particles limit velocity over time
-- Add: Particles rotation by speed
-- Add: ParticleSystem play, pause, stop and emit(count) methods
-- Add: ``WebXR.showRaycastLine`` exposed so it can be disabled from code
-- Fix: issues in applying some forces/values for different scaling and worldspace <> localspace scenarios
-- Change: raise input events in core method to also allow receiving WebAR mock touch events
-- Change: ``Animation.play()`` does not require argument anymore
-
-## [2.43.0-pre] - 2022-11-10
-- Add: particles emission over distance
-- Add: particles can enable trail (settings are not yet applied tho) 
-- Add: camera now useses culling mask settings
-- Add: particle VelocityOverLife
-- Add: particle basic texture sheet animation support
-- Change: ensure ``time.deltaTime`` is always > 0 and nevery exactly 0
-- Fix: progressbar handle progress event not reporting total file size
-- Fix: layer on camera did affect visibility
-- Fix: cloning animatorcontrollers in builds did fail because of legacy AnimatorAction name check
-- Fix: ``RGBAColor.lerpColors`` did produce wrong alpha value
-- Fix: custom shader ``_ZTest`` value is now applied as threejs depthTest function
-
-## [2.42.0-pre] - 2022-11-09
-- add ``Graphics.copyTexture``
-- add ``Renderer.allowProgressiveLoad``
-- add ``Gizmos.DrawBox`` and ``DrawBox3``
-- add particles burst emission
-- add particles color interpolation between two gradients
-- fix: reflection probe material caching for when material is being changed at certain times outside of animation loop and cache applied wrong material
-- fix: AnimationCurve evaluation when time and keyframe are both exactly 0
-- change: reflection probe now requires anchor override
-- change: bump threejs dependency 
-
-## [2.41.0-pre] - 2022-11-07
-- Add: start adding particle systems support again
-- Change: update dependency version to needle gltf-transform-extensions package
-- Change: light set to soft shadows now changes renderer shadow mode to ``VSMShadowMap`` (can be disabled by setting ``Light.allowChangingShadowMapType`` to false)
-- Fix: WebXR creating AR button when called from script in awake 
-- Fix: ``AnimationCurve.evaluate``
-
-## [2.40.0-pre] - 2022-11-05
-- Add support for deleting all room state by calling ``context.connection.sendDeleteRemoteStateAll()`` (requires backend to update ``@needle-tools/needle-tiny-networking-ws`` to ``^1.1.0-pre``)
-- Add Hinge joint
-- Add ``Gizmos.DrawLine``, ``DrawRay`` ``DrawWireSphere`` and ``DrawSphere``
-- Add: physics Collision Contacts now contain information about ``impulse`` and ``friction``
-- Add ``physics.raycastPhysicsFast`` as a first method to raycast against physics colliders, the returning object contains the point in worldspace and the collider. This is the most simplest and thus fastest way to raycast using Rapier. More complex options will follow in future versions.
-- Fix joint matrix calculation
-- Fix and improve physics Contacts point calculations  
-- Fix issue in physics event callbacks where ``onCollisionStay`` and ``onCollisionExit`` would only be called when ``onCollisionEnter`` was defined
-
-## [2.39.0-pre] - 2022-11-04
-- Add: physics FixedJoint
-- Change: CharacterController now rotates with camera
-- Change: scaled mesh colliders are now cached
-- Change: disable OrbitControls when in XR
-- Change: first enabled camera component sets itself as rendering camera if no camera is yet assigned (mainCamera still overrides that)
-- Change: package module field now shows to ``src/needle-engine``
-- Change: ``Camera.backgroundColor`` assigning Color without alpha sets alpha to 1 now
-- Fix: improved missing ``serializable`` detection / warning: now only shows warning for members actually declared in script 
-- Fix: wrong light intensity in VR when light is child of WebARSessionRoot [issue 103](https://github.com/needle-tools/needle-engine-support/issues/103) 
-
-## [2.38.0-pre] - 2022-11-02
-- Add ``context.isInAR`` and ``context.isInVR`` properties
-- Add physics capsule collider support
-- Add basic character controller implementation (experimental)
-- Add ``context.input.getMouseWheelDeltaY()``
-- Add: SmoothFollow option to restrict following on certain axes only for position
-- Add: ``Rigidbody.teleport`` method to properly reset internal state
-- Add: load glbs using build hash (appended as ``?v=123``)
-- Change: Collision event args now exposes contacts array
-- Fix Exit AR (X) button not showing up
-- Fix physics collider center offset
-- Fix removing colliders and rigidbodies throwing error (when trying to access properties for already removed bodies)
-- Fix bug in AnimatorController causing broken animations when the same clip is used in multiple states (caused by ``mixer.uncacheCip``)
-- Fix rigidbody friction allowing for physical bodies being transported on e.g. platforms
-- Fix ``onTriggerStay`` being invoked with the correct collider argument
-- Fix AnimatorController exit time not being used properly
-- Fix AnimatorController not checking all possible transitions if one transition did match conditions but could not be made due to exit time setting
-- Fix ``Renderer.sharedMaterials`` not handling SkinnedMeshRenderer
-- Fix environment blend mode for mozilla XR browser on iOS
-- Fix: Camera now removing self from being set as currently rendering in ``onDisable``
-
-## [2.37.0-pre] - 2022-10-28
-- Add: rapier physics backend and overall improved physics system like constraint support, fixed physics collider updates and synchronization between rendering and physics world or animation of physical bodies 
-- Remove: cannon-es
-- Add basic mesh collider support
-- Add ``@validate`` decorator and ``onValidate`` event method that can be used to automatically get callbacks when marked properties are being written to (for example internally this is used on the Rigidbody to update the physics body when values on the Rigidbody component are being updated)
-- Change: assign nested gltf layers
-- Change: reworked Rigidbody api
-- Fix: allow Draco and KRTX compression on custom hand models
-- Fix: applying Unity layers to threejs objects
-- Fix: BoxHelper stopped working with SpatialTrigger
-- Fix: AR reticle showing up in wrong position with transformed WebARSessionRoot
-
-## [2.36.0-pre] - 2022-10-26
-- Add: Expose WebXR hand model path
-- Add: Animation component can now be configured with random time scale and offset
-- Change: allow blocking overlay errors using the ``?noerrors`` query parameter
-- Change: don't use Composer for postprocessing in XR (see [issue](https://github.com/needle-tools/needle-engine-support/issues/101)) 
-- Change: physics intersections causing NaN's are now reported prominently and physics bodies are removed from physics world as an interim solution, this provides more information about problematic colliders for debugging
-- Fix: bug that caused component events for onEnable and onDisable not being called anymore in some cases
-- Fix: cases where loading overlay using old project template wouldnt be removed/hidden anymore
-- Fix: WebXR hide large hand grab sphere
-- Fix: onPointerUp event not firing using WebXR controllers when grabbing an object for the second time
-- Fix: GroundProjection can now be removed again
-- Fix: Custom shaders exported using builtin RP can now use  _Time property
-- Fix: Only create two controllers when in AR on oculus browser
-- Fix: BoxHelperComponent can now handle multi-material objects (groups) 
-
-## [2.35.6-pre] - 2022-10-24
-- Add: warning balloon when unknown components are detected and have been most likely forgot to be installed, linking to npmdef docs 
-- Fix: dont show serialization warning for builtin components where specific fields are not deserialized on purpose (since right now the serializer does not check which fields are actually implemented) 
-
-## [2.35.5-pre] - 2022-10-24
-- Change: AudioSource exposes ``clip`` field
-- Change: improve error and messaging overlay
-- Change: detect when serialized Object3D and AssetReference are missing ``@serializable`` attribute and show message in overlay
-- Change: add WebXR hands path to controllers
-- Fix: WebXR controllers now use interactable object when grabbing (instead of hit object previously) which fixes interaction with nested hierarchies in XR and DragControls
-
-## [2.35.4-pre] - 2022-10-23
-- Change: Renderer ``material`` is now ``sharedMaterial`` to make it more clear for Unity devs that the material is not being cloned when accessed
-- Fix: When not specifying any explicit networking backend for glitch deployment it now falls back to the current glitch instance for networking
-
-## [2.35.3-pre] - 2022-10-21
-- Add: Screenshare component ``share`` method now takes optional options to configure device and MediaStreamConstraints for starting the stream 
-- Fix: WebXR should show EnterVR button when enabled in Unity
-- Fix: component ``enable`` boolean wasnt correctly initialized when loaded from gltf
-- Fix: Object3D prototype extensions weren't correctly applied anymore
-- Fix: Interaction bug when using DragControls with OrbitControls with multitouch
-
-## [2.35.2-pre] - 2022-10-20
-- Add ``Renderer.mesh`` getter property
-- Change: ``Renderer.material`` now returns first entry in ``sharedMaterials`` array so it automatically works in cases where a Renderer is actually a multi-material object
-- Change: warn when trying to access components using string name instead of type
-- Change: update needle gltf-transform-extensions to 0.6.2
-- Fix: remove log from UIRaycastUtil
-- Fix: move TypeStore import in builtin engine again to not break cases where ``import @needle-engine`` was never used
-- Fix: React3Fiber template and AR overlay container access when using react
-
-## [2.35.1-pre] - 2022-10-19
-- Change: unify component access methods, first argument is now always the object with the component type as second argument
-- Fix physics collision events throwing caused by refactoring in last version
-- Fix loading screen css
-
-## [2.35.0-pre] - 2022-10-19
-- Change: First pass of reducing circular dependencies
-- Change: Update @needle-tools/gltf-transform-extensions version
-- Change: Update component compiler to 1.9.0. Changed include:
-   * Private and protected methods will now not be emitted anymore
-   * ``onEnable/onDisable`` will be emitted as ``OnEnable`` and ``OnDisable`` [issue 93](https://github.com/needle-tools/needle-engine-support/issues/93)
-- Change: handle Vector3 prototype extensions
-- Fix: issue with UI causing rendering to break when enabling text components during runtime that have not yet been active before
-- Fix: OrbitControls LookAtConstraint reference deserialization
-- Fix: WebXRController raycasting against UI marked as ``noRaycastTarget`` or in CanvasGroup with disabled ``interactable`` or ``blocksRaycast``
-
-## [2.34.0-pre] - 2022-10-17
-- Add: start adding support for 2D video overlay mode
-- Change: Install threejs from @needle-tools/npm - this removes the requirement to have git installed and should fix a case where pulling the package from github would fail 
-- Change: Move Screensharing aspect mode settings into VideoPlayer component
-- Change: Move ``InstancingUtils`` into ``engine/engine_instancing.ts``
-- Change: BoxCollider now checks if ``attachedRigidBody`` is assigned at start
-- Change: Collision now exposes internal cannon data via ``__internalCollision`` property
-- Fix: EventSystem now properly unsubscribes WebXRController events
-
-## [2.33.0-pre] - 2022-10-17
-- Add: ScreenCapture has mode for capturing webgl canvas (unfortunately it doesnt seem to work well in Chrome or Firefox yet)
-- Change: move threejs prototype extensions into own file and make available to vanilla js builds
-- Change: ScreenCapture component has explicit VideoPlayer component reference
-- Fix: animating properties on custom shaders
-
-## [2.32.0-pre] - 2022-10-15
-- Add: start implementing trigger callbacks for ``onTriggerEnter``, ``onTriggerExit`` and ``onTriggerStay``
-- Change: ``GameObject.setActive`` now updates ``isActiveAndEnabled`` state and executes ``awake`` and ``onEnable`` calls when the object was activated for the first time (e.g. when instantiating from an previously inactive prefab)
-- Change: improve collision callback events for components (``onCollisionEnter``, ``onCollisionExit`` and ``onCollisionStay``)
-- Change: this.context.input keycode enums are now strings
-- Fix: local dev error overlay now also displays errors that happen before web component is completely loaded (e.g. when script has import error)
-- Fix: Rigidbody force is now correctly applied when the component was just instantiated (from inactive prefab) and added to the physics world for the first time
-- Fix: DragControls component keyboard events ("space" and "d" for modifying height and rotation)
-
-## [2.31.1-pre] - 2022-10-14
-- Change: Rigidbody now tracks position changes to detect when to update/override simulated physics body
-- Fix: loading relative font paths when exported via Asset context menu
-
-## [2.31.0-pre] - 2022-10-13
-- Add: inital ScreenCapture component for sharing screens and camera streams across all connected users
-- Add: ``onCollisionEnter``, ``onCollisionStay`` and ``onCollisionExit`` event methods to components
-
-## [2.30.0-pre] - 2022-10-12
-- Add: Quest 2 passthrough support
-- Add: UI Graphic components now support ``raycastTarget`` again
-- Add: VideoPlayer now supports ``materialTarget`` option which allows for assigning any renderer in the scene that should be used as a video canvas
-- Changed: updated three-mesh-ui dependency version
-- Changed: updated needle-gltfTransform extensions package, fixing an issue with passthrough of texture json pointers
-- Changed: selecting SpectatorCam now requires click (instead of just listening to pointer up event)
-- Fix: Avatars using instanced materials should now update transforms correctly again
-
-## [2.29.0-pre] - 2022-10-10
-- Add: Context.removeCamera method
-- Add: SpectatorCam allows to follow other users across devices by clicking on respective avatar (e.g. clicking SyncedCam avatar or WebXR avatar, ESC or long press to stop spectating)
-- Add: ``Input`` events for pointerdown, pointerup, pointermove and keydown, keyup, keypress. Subscribe via ``this.context.input.addEventListener(InputEvents.pointerdown, evt => {...})`` 
-- Change: Default WebXR rig matches Unity forward
-- Fix: WebXRController raycast line being rendered as huge line before first world hit
-- Fix: SpectatorCam works again
-- Fix: ``serializable()`` does now not write undefined values if serialize data is undefined
-- Fix: exit VR lighting
-
-## [2.28.0-pre] - 2022-10-06
-- Add: ``resolutionScaleFactor`` to context
-- Fix ``IsLocalNetwork`` regex
-- Fix custom shaders failing to render caused by json pointer change
-- Change: rename Context ``AROverlayElement`` to ``arOverlayElement``
-
-## [2.27.0-pre] - 2022-10-06
-- Fix: EventList failing to find target when targeting a Object3D without any components
-- Fix: text now showing up when disabling and enabling again after the underlying three-mesh-ui components have been created
-- Fix: Builtin sprites not rendering correctly in production builds
-- Change: Bump needle glTF transform extensions version
-- Change: json pointers now have correct format (e.g. ``/textures/0`` instead ``textures/0``)
-- Change: Bump UnityGLTF version
-
-## [2.26.1-pre] - 2022-10-05
-- Fix animating ``activeSelf`` on GameObject in canvas hierarchy
-- Fix SpectatorCam component
-- Fix WebXRController raycast line being rendered as huge line before first world hit
-
-## [2.26.0-pre] - 2022-10-05
-- Add: experimental AlignmentConstraint and OffsetConstraint
-- Remove: MeshCollider script since it is not supported yet
-- Change: Camera does now use XRSession environment blend mode to determine if background should be transparent or not.
-- Change: WebXR exposes ``IsInVR`` and ``IsInAR``
-- Fix: RGBAColor copy alpha fix
-- Fix: Avatar mouth shapes in networked environment
-
-## [2.25.1-pre] - 2022-10-04
-- Change: DropListener file drop event does send whole gltf instead of just the scene
-
-## [2.25.0-pre] - 2022-10-04
-- Add: allow overriding draco and ktx2 decoders on <needle-engine> web component by setting ``dracoDecoderPath``, ``dracoDecoderType``, ``ktx2DecoderPath`` 
-- Add: ``loadstart`` and ``progress`` events to <needle-engine> web component
-- Fix rare timeline animation bug where position and rotation of objects would be falsely applied
-- Change: update to three v245
-- Change: export ``THREE`` to global scope for bundled version
-
-## [2.24.0-pre] - 2022-10-01
-- Add: make engine code easily accessible from vanilla javascript
-- Fix: handle number animation setting component enable where values are interpolated
-- Change: Remove internal shadow bias multiplication
-- Change: Addressable references are now resolved using relative paths
-- Change: Update package json
-
-## [2.23.2-pre] - 2022-09-29
-- Add: Light component shadow settings can not be set/updated at runtime
-- Fix: enter XR using GroundProjectedEnv component
-- Fix: Light shadows missing when LightShadowData component was not added in Unity (was using wrong shadowResolution)
-- Change: dont allow raycasting by default on GroundProjectedEnv sphere
-
-## [2.23.1-pre] - 2022-09-29
-- Add: Light exposes shadow resolution
-
-## [2.23.0-pre] - 2022-09-28
-- Add RemoteSkybox component to use HDRi images from e.g. polyhaven
-- Add GroundProjectedEnv component to use threejs skybox projection 
-- Fix: export ``GameObject`` in ``@needle-tools/engine``
-
-## [2.22.1-pre] - 2022-09-28
-- Add: ``noerrors`` url parameter to hide overlay
-- Fix: WebXR avatar rendering may be visually offset due to root transform. Will now reset root transform to identity
-
-## [2.22.0-pre] - 2022-09-28
-- Add: ``@needle-tools/engine`` now exports all components
-- Add: environment light from tricolor (used for envlight when set to custom but without custom cubemap assigned)
-- Add: show console error on screen for localhost / local dev environment
-- Fix: create environment lighting textures from exported colors
-- Change: UI InputField expose text
-- Change: Bump threejs version to latest (> r144) which also contains USDZExporter PR
-
-## [2.21.0-pre] - 2022-09-26
-- Add: custom shader set ``_ScreenParams``
-- Change: DropListener event ``details`` now contains whole gltf file (instead of just scene object)
-
-## [2.20.1-pre] - 2022-09-23
-- Add: AudioSource volume and spatial blending settings can now be set at runtime
-- Fix: AudioSource not playing on ``play`` when ``playOnAwake`` is false
-
-## [2.20.0-pre] - 2022-09-23
-- Add: VideoPlayer crossorigin attribute support
-- Add: ``debuginstancing`` url parameter flag
-- Add: Image handle builtin ``Background`` sprite
-- Add: Component now implements EventTargt so you can use ``addEventListener`` etc on every component
-- Add: EventList does automatically dispatch event with same name on component. E.g. UnityEvent named ``onClick`` will be dispatched on component as ``on-click``
-- Add: experimental progressive loading of textures
-- Add: ``WebXR`` exposes ``IsARSupported`` and ``IsVRSupported``
-- Fix: remove Ambient Intensity
-- Fix: ShadowCatcher material should not write depth
-
-## [2.19.1-pre] - 2022-09-21
-- Fix: SpatialTrigger intersection check when it's not a mesh
-- Fix: UnityEvent / EventList argument of ``0`` not being passed to the receiving method
-- Fix: Physics rigidbody/collider instantiate calls
-- Fix: Physics rigidbody transform changes will now be applied to internal physics body 
-- Fix: ``needle-engine.getContext`` now listens to loading finished event namely ``loadfinished``
-- Change: cleanup some old code in Rigidbody component
-
-## [2.19.0-pre] - 2022-09-20
-- Add: initial support for ``InputField`` UI (rendering, input handling on desktop, mobile and AR, change and endedit events)
-- Add: ``EventList.invoke`` can now handle an arbitrary number of arguments
-- Change: lower double click threshold to 200ms instead of 500ms
-- Change: runtime font-style does not change font being used in this version. This will temporarely break rich text support.
-- Fix: custom shader regression where multiple objects using the same material were not rendered correctly
-- Fix: Text sometimes using invalid path
-- Fix: Remove unused imports
-
-## [2.18.0-pre] - 2022-09-20
-- Add basic support for ``CameraDepth`` and ``OpaqueTexture`` (the opaque texture still contains transparent textures in this first version) being used in custom shaders
-
-## [2.17.1-pre] - 2022-09-17
-- Improve Animator root motion blending
-- Fix SpatialTrigger error when adding both SpatialTrigger as well as SpatialTrigger receiver components to the same object
-- AnimatorController can now handle states with empty motion or missing clips
-
-## [2.17.0-pre] - 2022-09-15
-- Add: automatic runtime font atlas generation from Unity font assets 
-- Remove: shipped font assets in ``include/fonts``
-- Fix: Physics pass custom vector into ``getWorldPosition``, internal vector buffer size increased to 100
-- Fix: SpatialTrigger and SpatialTrigger receivers didnt work anymore due to LayerMask serialization
-
-## [2.16.1-pre] - 2022-09-14
-- Change: UI disable shadow receiving and casting by default, can be configured via Canvas
-- Fix: ``gameObject.getComponentInParent`` was making false call to ``getComponentsInParent`` and returning an array instead of a single object
-- Fix: light intensity in AR
-
-## [2.16.0-pre] - 2022-09-14
-- Add: first draft of Animator root motion support
-- Fix: ``Renderer.sharedMaterials`` assignment bug when GameObject was mesh
-- Fix: Buttons set to color transition did not apply transition colors
-- Fix: UI textures being flipped
-- Fix: UI textures were not stretched across panel but instead being clipped if the aspect ratio didnt match perfectly
-
-## [2.15.0-pre] - 2022-09-12
-- Add stencil support to ``Renderer``
-- Add timeline ``removeTrackOffset`` support
-- Fix timeline animation track offset only being applied to root
-- Fix timeline clip offsets not being applied when no track for e.g. rotation or translation exists
-
-## [2.14.0-pre] - 2022-09-11
-- Add initial UI anchoring support
-- Add initial support for URP RenderObject Stencil via ``NEEDLE_render_objects`` extension
-
-## [2.13.4-pre] - 2022-09-09
-- Fix UI transform handling for [issue 42](https://github.com/needle-tools/needle-engine-support/issues/42) and [issue 30](https://github.com/needle-tools/needle-engine-support/issues/30)
-- Fix AudioSource not restarting to play at onEnable when ``playOnAwake`` is true (this is the default behaviour in Unity)
-
-## [2.13.3-pre] - 2022-09-09
-- Fix RGBAColor not implementing copy which caused alpha to be set to 0 (this caused ``Camera.backgroundColor`` to not work properly)
-
-## [2.13.2-pre] - 2022-09-07
-- Add support to set OrbitControls camera position immediately
-
-## [2.13.1-pre] - 2022-09-07
-- Fix EventList invocation not using deserialized method arguments
-
-## [2.13.0-pre] - 2022-09-07
-- Add ``context`` to ``StateMachineBehaviour``
-- Fix ``StateMachineBehaviour`` binding (event functions were called with wrong binding)
-
-## [2.12.0-pre.1] - 2022-09-06
-- Fix deserialization error when data is null or undefined
-
-## [2.12.0-pre] - 2022-09-05
-- Add initial tonemapping and exposure support
-- Add AR shadow catcher
-- Fix objects parented to camera appear behind camera
-- Fix reticle showing and never disappearing when no WebARSessionRoot is in scene
-- Fix WebARSessionRoot when on same gameobject as WebXR component
-- Fix deserialization of ``@serializable(Material)`` producing a new default instance in certain cases
-- Fix ``OrbitControls`` enable when called from UI button event
-- Fix EventList / UnityEvent calls to properties (e.g. ``MyComponent.enable = true`` works now from UnityEvent)
-
-## [2.11.1-pre] - 2022-09-02
-- Change: ``OrbitControls.setTarget`` does now lerp by default. Use method parameter ``immediate`` to change it immediately
-- Change: bump component compiler dependency to ``1.8.0``
-
-## [2.10.3-pre] - 2022-09-01
-- Fix EventList serialization for cross-glb references
-- Fix AnimatorController transition from state without animation
-
-## [2.10.2-pre] - 2022-09-01
-- Fix: skybox/camera background on exit AR
-- Change: AnimatorController can now contain empty states
-- Change: Expose ``Animator.Play`` transition duration
-
-## [2.10.1-pre] - 2022-08-31
-- Improved RectTransform animation support and canvas element positioning
-- Fix ``Animator.Play``
-- Change: Expose ``AnimatorController.FindState(name)`` 
-
-## [2.10.0-pre] - 2022-08-29
-- Add UI to gltf export
-- Add button animation transition support for triggers ``Normal``, ``Highlighted`` and ``Pressed``
-
-## [2.9.0-pre] - 2022-08-26
-- Add ``Canvas.renderOnTop`` option
-- Fix ``OrbitControls`` changing focus/moving when interacting with the UI
-- Fix nullref in AnimatorController with empty state
-
-## [2.8.0-pre] - 2022-08-25
-- Add export for ``Renderer.allowOcclusionWhenDynamic``
-- Fix: bug in ``@serializable`` type assignment for inherited classes with multiple members with same name but different serialized types
-- Change: ``GameObject.findObjectOfType`` now also accepts an object as a search root
-
-## [2.7.3-pre] - 2022-08-25
-- Fix canvas button breaking orbit controls [issue #4](https://github.com/needle-tools/needle-engine-support/issues/4)
-
-## [2.7.2-pre] - 2022-08-23
-- Fix SyncedRoom to not append room parameter multiple times
-
-## [2.7.1-pre] - 2022-08-22
-- Add: Timeline AudioTrack nullcheck when audio file is missing
-- Fix: AnimatorController error when behaviours are undefined
-- Change StateMachineBehaviour methods to be lowercase
-
-## [2.7.0-pre] - 2022-08-22
-- Add initial StateMachineBehaviour support with "OnStateEnter", "OnStateUpdate" and "OnStateExit"
-- Fix input raycast position calculation for scrolled content
-
-## [2.6.1-pre] - 2022-08-22
-- Fix texture pointer remapping in gltf-transform opaque extension
-- Change: skip texture-transform for textures starting with "Lightmap" for now until we can configure this properly 
-
-## [2.6.0-pre] - 2022-08-18
-- Add scale to instantiation sync messages
-- Fix ``BoxHelper``
-- Fix AR reticle being not visible when ``XRRig`` is child of ``WebARSessionRoot`` component
-- Fix exception in ``DragControls`` when dragged object was deleted while dragging
-
-## [2.5.0-pre] - 2022-08-18
-- Change name of ``KHR_webgl_extension`` to ``NEEDLE_webgl_extension``
-- Change: dont write depth for custom shader set to transparent 
-- Deprecate and disable ``AssetDatabase``
-
-## [2.4.1-pre] - 2022-08-17
-- Add ``Mathf.MoveTowards``
-- Change: rename ``needle-tiny`` webcomponent to ``needle-engine``
-- Fix ordering issue in needle web component when codegen.js is executed too late
-
-## [2.3.0-pre] - 2022-08-16
-- Add SyncedCamera prefab/AssetReference support
-- Add TypeArray support for ``serializable`` to provide multiple possible deserialization types for one field (e.g. ``serializable([Object3D, AssetReference])`` to try to deserialize a type as Object3D first and then as AssetReference)
-
-## [2.2.0-pre] - 2022-08-14
-- Add event callbacks for Gltf loading: ``BeforeLoad`` (use to register custom extensions), ``AfterLoaded`` (to receive loaded gltf), ``FinishedSetup`` (called after components have been created)
-
-## [2.1.2-pre] - 2022-08-14
-- Fix AnimatorController exit state
-- Fix AR camera background alpha to be fully transparent by default 
-
-## [2.1.1-pre] - 2022-08-12
-- Fix: light shadow bias
-
-## [2.1.0-pre] - 2022-08-11
-- Add ``@needle-tools/engine`` to be used as import for "most used" apis and functions
-- Change: remove obsolete ``Renderer.materialProperties``
-- Fix: ``NEEDLE_persistent_assets`` extension is now valid format (change from array to object)
-
-## [2.0.0-pre] - 2022-08-08
-- Renamed package
-
-## [1.21.2-pre] - 2022-08-08
-- Fix: NestedGltf transform
-
-## [1.20.1-pre] - 2022-08-06
-- Remove: Duplicateable animation time offset hack
-- Change: GameObjectData extension properly await assigning values
-- Change: NestedGltf instantiate using guid
-- Change: ``instantiate`` does now again create guids for three Objects too
-
-## [1.20.0-pre] - 2022-08-05
-- Add: NestedGltf ``listenToProgress`` method
-- Add: Allow changing Renderer lightmap at runtime
-- Fix: Environment lighting when set to flat or gradient (instead of skybox)
-- Fix: ``this.gameObject.getComponentInChildren`` - was internally calling wrong method
-- Fix: Spectator camera, requires Camera component in glb now
-
-## [1.19.0-pre] - 2022-08-03
-- Add: Animator.keepAnimatorStateOnDisable, defaults to false as in Unity so start state is entered on enable again
-- Add: warning if different types with the same name are registered
-- Add: timeline track ``onMutedChanged`` callback
-- Change: PlayableDirector expose audio tracks
-- Change: BoxCollider and SphereCollider being added to the physics scene just once
-- Change: try catch around physics step
-
-## [1.18.0-pre] - 2022-08-01
-- Add: Addressable download progress is now observeable
-- Add: Addressable preload support, allows to load raw bytes without actually building any components
-- Add: PlayableDirector exposes tracks / clips
-- Change: modify default engine loading progress bar to be used from user code
-- Change: add option to Instantiate call to keep world position (set ``keepWorldPosition`` in ``InstantiateOptions`` object that you can pass into instantiate)
-- Change: light uses shadow bias from Unity
-- Fix: instancing requiring worldmatrix update being not properly processed
-- Fix: Duplicatable world position being off (using ``keepWorldPosition``)
-- Fix: ``Animation`` component, it does allow to use one main clip only now, for more complex setups please use AnimationController or Timeline
-- Fix: ``SyncedRoom`` room connection on enter WebXR
-- Fix: WebXR avatar loading
-
-## [1.17.1-pre] - 2022-07-27
-- Change: bump component compiler dependency to ``1.7.1``
-- Change: ``context.mainCameraComponent`` is now of type ``Camera``
-- Fix: timeline control track
-- Fix: timeline animation track post extrapolation
-- Fix: custom shader does not fail when scene uses object with transmission (additional render pass)
-
-## [1.17.0-pre] - 2022-07-21
-- engine: add loading bar and show loading state text
-
-## [1.16.0-pre] - 2022-07-20
-- engine: add using ambient light settings (Intensity Multiplier) exported from Unity
-
-## [1.15.1-pre] - 2022-07-18
-- engine: fix nullref in registering texture
-
-## [1.15.0-pre] - 2022-07-15
-- engine: remove legacy file
-- engine: add basic implementation of ``Context.destroy``
-- engine: fix ``<needle-tiny>`` src attribute
-- engine: add implictly creating camera with orbit controls when loaded glb doesnt contain any (e.g. via src) 
-
-## [1.14.2-pre] - 2022-07-12
-- engine: fix dont apply lightmaps to unlit materials
-- engine: remove log in PlayableDirector
-- engine: add support to override (not automatically create) WebXR buttons 
-
-## [1.14.1-pre] - 2022-07-11
-- engine: Fix AnimatorController finding clip when cloned via ``AssetReference.instantiate``
-- engine: Fix deep clone array type
-- engine: Fix PlayableDirectory binding when cloned via ``AssetReference.instantiate``
-
-## [1.14.0] - 2022-07-10
-- engine: add VideoPlayer using ``AudioOutputMode.None``
-- engine: fix VideoPlayer waiting for input before playing video with audio (unmuted) and being loaded lazily
-
-## [1.13.0-pre] - 2022-07-07
-- engine: Add ``getComponent`` etc methods to THREE.Object3D prototype so we can use it like in Unity: ``this.gameObject.getComponent...``
-- engine: Change ``Duplictable`` serialization
-
-## [1.12.2-pre] - 2022-07-06
-- engine: Fix networking localhost detection
-- engine: update component generator package version (supporting now CODEGEN_START and END sections as well as //@ifdef for fields)
-
-## [1.12.1-pre] - 2022-07-06
-- engine: change lightmap extension to be object
-
-## [1.12.0-pre] - 2022-07-06
-- engine: Add DeviceFlag component
-- engine: Fix VideoPlayer loop and playback speed
-- engine: Improve VideoTrack sync
-
-## [1.11.0-pre] - 2022-07-04
-- engine: fix ``enabled`` not being always assigned
-- engine: fix react-three-fiber component setting camera
-- engine: add support for custom timeline track
-- engine: add VideoTrack npmdef
-
-## [1.10.3-pre] - 2022-07-01
-- engine: Change; PlayableDirector Wrap.None now stops/resets timeline on end
-- engine: Change; PlayableDirector now stops on disabling  
-
-## [1.10.2-pre] - 2022-07-01
-- engine: fix timeline clip offsets and hold
-- engine: fix timeline animationtrack support for post-extrapolation (hold, loop, pingpong)
-
-## [1.10.1-pre] - 2022-06-30
-- engine: improve timeline clip offsets
-
-## [1.10.0-pre] - 2022-06-30
-- engine: Improved timeline clip- and track offset (ongoing)
-- engine: Change assigning all serialized properties by default again (instead of require ``@allProperties`` decorator)
-- engine: Change; deprecate ``@allProperties`` and ``@strict`` decorators
-
-## [1.9.1-pre] - 2022-06-29
-- engine: add methods for unsubscribing to EventList and make constructor args optional
-- engine: change camera to not change transform anymore
-
-## [1.9.0-pre] - 2022-06-28
-- engine: add support for transparent rendering using camera background alpha
-
-## [1.8.0-pre] - 2022-06-27
-- Add: transform gizmo component
-- Change: component generator for npmdef is not required anymore
-- Change: component gen runs in background now
-- Fix: typescript drag drop adding component twice in some cases
-- engine: update component gen package dependency
-- engine: fix redundant camera creation when exported in GLTF
-- engine: fix orbit controls focus lerp, stops now on input
-
-## [1.7.1-pre] - 2022-06-25
-- Override PlayMode in sub-scene
-- engine: lightmaps encoding fix
-- engine: directional light direction fix 
-
-## [1.7.0-pre] - 2022-06-25
-- engine: animator controler can handle multiple target animators
-- engine: fix WebXR being a child of WebARSessionRoot
-- engine: improve Camera, OrbitControls, Lights OnEnable/Disable behaviour
-- engine: add ``Input.getKeyPressed()``
-
-## [1.6.0-pre] - 2022-06-23
-- engine: fix light error "can't add object to self" when re-enabled
-- engine: remove extension log
-- engine: log missing info when UnityEvent has not target (or method not found)
-- engine: use lightmap index for supporting multiple lightmaps
-
-## [1.5.2-pre] - 2022-06-23
-- engine: Camera dont set skybox when in XR
-- engine: dont add lights to scene if baked
-
-## [1.5.1-pre] - 2022-06-22
-- engine: fix threejs dependency pointer
-
-## [1.5.0-pre] - 2022-06-22
-- engine: ``<needle-tiny>`` added awaitable ``getContext()`` (waits for scene being loaded to be used in external js)
-- engine: fix finding main camera warning
-- engine: add ``SourceIdentifier`` to components to be used to get gltf specific data (e.g. lightmaps shipped per gltf)
-- engine: persistent asset resolve fix
-- engine: update three dependency to support khr_pointer
-- engine: remove custom khr_pointer extension
-- engine: fix WebARSessionRoot exported in gltf
-- engine: smaller AR reticle
-
-## [1.4.1-pre] - 2022-06-17
-- engine: create new GltfLoader per loading request
-- engine: fix bug in core where it could happen that scripts were added multiple times
-- engine: Added SyncedRoom auto rejoin option (to handle disconnection by server due to window inactivity)
-- engine: guid resolving first in loaded gltf and retry in whole scene on fail
-- engine: fix nullref in DropListener
-- engine: register main camera before first awake
-
-## [1.4.0-pre] - 2022-06-15
-- engine: add ``GameObject.getOrAddComponent``
-- engine: ``OrbitControl`` exposing controlled object
-- engine: ``getWorldPosition`` now uses buffer of cached vector3's instead of only one
-- engine: add ``AvatarMarker`` to synced camera (also allows to easily attach ``PlayerColor``)
-- engine: fix ``Animation`` component when using khr_pointer extension
-- engine: ``VideoPlayer`` expose current time
-- engine: fix ``Animator.runtimeController`` serialization
-- engine: make ``SyncedRoom.tryJoinRoom`` public
-
-## [1.3.1-pre] - 2022-06-10
-- engine: allow ``@serializeable`` taking abstract types
-- engine: add ``Renderer.sharedMaterials`` support
-
-## [1.3.0-pre] - 2022-06-09
-- engine: move log behind debug flag
-- engine: improved serialization property assignment respecting getter only properties
-- engine: add optional serialization callbacks to ``ISerializable``
-- engine: default to only assign declared properties
-
-## [1.2.3-pre] - 2022-06-09
-- engine: downloading dropped file shows minimal preview box
-- engine: ``DropListener`` can use localhost
-- engine: ``SyncedRoom`` avoid reload due to room parameter
-- engine: ``LODGroup`` instantiate workaround
-- engine: improve deserialization supporting multiple type levels
-
-## [1.2.2-pre] - 2022-05-30
-- engine: change md5 hashing package
-- engine: file upload logs proper server error
-
-## [1.2.1-pre] - 2022-05-30
-- engine: disable light in gltf if mode is baked
-- engine: use tiny starter as default networking backend
-- engine: synced file init fix for resolving references
-- engine: allow removing of gen.js completely
-- engine: expose ``Camera.buildCamera`` for core allowing to use blender camera
-- engine: on filedrop only add drag control if none is found
-
-## [1.2.0-pre] - 2022-05-27
-- engine: fix networked flatbuffer state not being stored
-- engine: make ``src`` on ``<needle-tiny>`` web component optional
-- engine: ``src`` can now point to glb or gltf directly
-- engine: fix ``Raycaster`` registration
-- engine: add ``GameObject.destroySynced``
-- engine: add ``context.setCurrentCamera``
-- engine: make ``DropListener`` to EventTarget
-- engine: make ``DropListener`` accept explicit backend url
-
-## [1.1.0-pre.6] - 2022-05-26
-- Fix gltf transform textures output when used in custom shaders only
-
-## [1.1.0-pre.5] - 2022-05-25
-- engine: fix ``VideoPlayer`` being hidden, play automatically muted until interaction
-- engine: added helpers to update window history
-- engine: fix setting custom shader ``Vector4`` property
-- 
-## [1.1.0-pre.4] - 2022-05-25
-- engine: fix tsc error in ``Animation`` component
-- engine: fix ``Animation`` component assigning animations for GameObject again
-- engine: fix ``Animation`` calling play before awake
-- engine: ``AnimatorController`` handle missing motion (not assigned in Unity)
-- engine: ``AnimatorController.IsInTransition()`` fix
-
-## [1.1.0-pre.1] - 2022-05-20
-- engine: minor tsc issues fixed
-
-## [1.1.0-pre] - 2022-05-20
-- engine: add ``isManagedExternally`` if renderer is not owned (e.g. when using react-fiber)
-
-## [1.0.0-pre.18] - 2022-05-19
-- engine: add basic support for ``stopEventPropagation`` (to make e.g. ``DragControls`` camera control agnostic in preparation of react support)
-
-## [1.0.0-pre.17] - 2022-05-17
-- fix ``EventList`` outside of gltf
-- fix ``EventList`` without any function assigned (``No Function`` in Unity)
-- engine: support changing ``WebARSessionRoot.arScale`` changing at runtime
-
-## [1.0.0-pre.16] - 2022-05-12
-- engine: fix webx avatar instantiate
-- engine: stop input preventing key event defaults
-
-## [1.0.0-pre.15] - 2022-05-12
-- engine: log error if ``instantiate`` is called with false parent
-- engine: fix instantiate with correct ``AnimatorController`` cloning
-
-## [1.0.0-pre.14] - 2022-05-11
-- engine: fix ``@syncField()``
-- engine: fix ``AssetReference.instantiate`` and ``AssetReference.instantiateSynced`` parenting
-- engine: improve ``PlayerSync`` and ``PlayerState``
-
-## [1.0.0-pre.13] - 2022-05-11
-- engine: prepend three canvas to the web element instead of appending
-- engine: ``SyncedRoom`` logs warning when disconnected
-- engine: internal networking does not attempt to reconnect on connection closed
-- engine: internal networking now empties user list when disconnected from room
-- engine: ``GameObject.instantiate`` does not always generate new guid to support cases where e.g. ``SyncTransform`` is on cloned object and requires unique id
-- engine: ``syncedInstantiate`` add fallback to ``Context.Current`` when missing
-- engine: ``EventList`` refactored to use list of ``CallInfo`` objects internally instead of plain function array to more easily attach meta info like ``UnityEvent.off`` 
-- engine: add ``GameObject.instantiateSynced``
-
-## [1.0.0-pre.12] - 2022-05-10
-- engine: fix font path
-- engine: add ``debugnewscripts`` url parameter
-- engine: start adding simplifcation to automatic instance creation + sync per player
-- engine: allow InstantiateOptions in ``GameObject.instantiate`` to be inlined as e.g. ``{ position: ... }``
-- engine: add ``AvatarMarker`` creation and destroy events
-- engine: fix networking message buffering
-
-## [1.0.0-pre.11] - 2022-05-08
-- engine: ``SpatialTrigger`` is serializable
-- engine: fix ``DragControls`` offset when using without ground
-- engine: fix ``WebXRController`` interaction with UI ``Button.onClick``
-
-## [1.0.0-pre.10] - 2022-05-04
-- engine: fix gltf extension not awaiting dependencies
-- engine: fix persistent asset @serializable check for arrays
-- engine: add ``setWorldScale``
-- engine: fix ``instantiate`` setting position
-- engine: ``AssetReference`` does now create new instance in ``instantiate`` call
-- engine: add awaitable ``delay`` util method
-- engine: fix scripts being active when loaded in gltf but never added to scene
-- engine: minimal support for mocking pointer input
-- engine: emit minimal down and up input events when in AR
-
-## [1.0.0-pre.9] - 2022-05-03
-- improved default loading element
-- changed animation pointer to support emissive intensity
-
-## [1.0.0-pre.8] - 2022-05-02
-- lightmaps fixed
-- glitch upload shows time estimate
-- deployment build error fix
-- json pointer resolve
-- improved auto install
-- started basic ``SpriteRenderer`` support
-- basic ``AnimationCurve`` support
-- fixed ``PlayerColor``
-- fixed ``persistent_assets`` and ``serializeable`` conflict
-- basic export of references to components in root prefab
-
-## [1.0.0-pre.7] - 2022-04-30
-- ``WebXR`` does not load avatar from prefab reference
-- ``WebXRSync`` is added implictly and creates local avatar even when not networked
-- ``SpectatorCam`` is using local avatar
-- ``SpectatorCam`` camera component in Unity is now optional and implictly added if missing
-
-## [1.0.0-pre.6] - 2022-04-29
-- fix environment light
-- fix light shadows setting
-- fix video player in extension
-- fix video player texture not overlaying rendering while awaiting interaction
-- fix webAR root reticle when no rig component is in scene
-
-## [1.0.0-pre.5] - 2022-04-28
-- start adding support for ``AssetReference`` again
-
-## [1.0.0-pre.4] - 2022-04-27
-- add persistent asset extension
-- removed timeline and animator controller extensions as both are now serialized and resolved in assets
-- can resolve json pointers (``animations/``, ``materials/``, ``textures/``, ``extensions``) in component paths
-- add ``syncField()`` decorator
-
-## [1.0.0-pre.2] - 2022-04-20
-- updated to https:// three.js url instead of git:// url
-- fixated flatbuffers dependency to 2.0.4 due to breaking changes and bugs in 2.0.6
-
-## [1.0.0-pre] - 2022-04-19
+# Changelog
+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).
+
+## [3.28.7-beta.1] - 2023-12-30
+- Fix: Revert AnimatorController condition evaluation change
+
+## [3.28.7-beta] - 2023-12-30
+- Fix: Issue in AnimatorController evaluation of bool condition where the threshold wasnt taken into account (e.g. only making a transition if a bool parameter was set to false)
+
+## [3.28.6-beta] - 2023-12-30
+- Add: EventList can now have multiple arguments allowing support for e.g. `setBool` on Animator component being called from a Button directly
+- Add: Animator `toggleBool` method 
+- Fix: Issue where destroying an object in `onCollisionEnter` it would not be removed from the physics event queue and result in `onCollisionStay` being called with an already destroyed component
+- Fix: Rigidbody matrix changed watcher should ignore events during physics to threejs synchronization
+- Fix: Set gizmos renderOrder to be always rendered last to avoid cases where gizmos are hidden due to custom renderOrder on scene objects
+
+## [3.28.5-beta] - 2023-12-22
+- Fix: WebXRController falsely triggering click in EventSystem
+
+## [3.28.3-beta] - 2023-12-21
+- Fix: Issue in pointer events not triggering onPointerEnter and Exit in VR
+- Remove: warning log in USDZ export about double sided materials not being supported
+
+## [3.28.2-beta] - 2023-12-20
+- Add: Support double sided material export for USDZ
+- Fix: `PlayAudioOnClick` when explicit clip is given, use loop from attached audio source
+- Change: Improve Everywhere Action `SetActiveOnClick`
+
+## [3.28.1-beta] - 2023-12-18
+- Add: `context.recreate` to destroy the whole scene and reload everything (including all script instances)
+- Fix: issue where EventSystem pointer events would not be received anymore if the event component was on e.g. an empty object in the parent hierarchy
+
+## [3.28.0-beta] - 2023-12-14
+- Fix: USDZ: `emissiveIntensity` was not applied and `emissiveColor` wasn't used for scale/bias properly
+- Fix: USDZ: compressed textures with alpha channel were not being read back correctly
+- Change: USDZ: bake `effectiveOpacity` into the opacity texture if needed, since QuickLook/usdview don't support `.a` scale values
+- Change: Bump UnityGLTF version to 2.6.0-exp to support GPU Instancing on imported glTF materials
+
+## [3.27.5-beta] - 2023-12-12
+- Fix: Offscreencanvas support for iOS 16.x
+- Fix:  `PlayAudioOnClick` now respects playOnAwake if an explicit audio source is assigned
+- Change: `EventSystem` should only check objects if they're meshes
+
+## [3.27.4-beta] - 2023-12-11
+- Fix: instancing now updating bounds in Needle Engine before render callback if necessary
+- Change: expose `onPauseChanged` on components
+- Change: handle case where a added coroutine function is not a coroutine (Generator) 
+
+## [3.27.3-beta] - 2023-12-09
+- Add: `InstancingUtil.getRenderer` to get the three InstancedMesh for any Object3D (if it's using instancing)
+- Add: instancing does now automatically update culling bounds if it's dirty. This can be disabled via `InstancingUtil.setAutoUpdateBounds(obj, false)`
+- Add: Rigidbody method documentation
+- Add: `ParticleSystem.addBehaviour` method and expose underlying particle system. We now also export the particle types
+- Fix: Issue where `this.physics.raycastFromRay` was modifying the default raycast options
+- Fix: Issue where sprites would be falsely interpreted as builtin sprite causing the image to be not displayed correctly
+- Change: `this.physics.raycast()` can now be called with anonymous options (instead of having to use a `RaycastOptions` class), for example `this.physics.raycast({ray:myRay})`
+
+
+## [3.27.2-beta] - 2023-12-08
+- Fix: don't set font on `<needle-engine>` host styles to prevent leaking into child elements
+- Fix: `AssetReference.loadAsync` being called multiple times should always return the `asset` result
+- Change: register OrbitControls events on the canvas and not the needle engine element to allow child HTML objects to capture input
+
+## [3.27.1-beta] - 2023-12-06
+- Add `addCustomExtensionPlugin` API to register custom glTF importer and exporter extensions
+- Fix: issue where instanced and animated object was rendered for one frame with a wrong matrix
+- Change: expose `imageToCanvas` method from USDZExporter
+- Change: GltfExporter component does not cache exporter anymore and expose all exporter options
+
+## [3.27.0-beta] - 2023-12-04
+- Add: USDZ: skinned mesh export, including animations
+- Add: USDZ: ability to specify if we're exporting for QuickLook or not
+- Add: USDZ: animation export respects basic root motion (translation and rotation)
+- Add: USDZ: `USDZExporter` API supports exporting binary buffer similar to `GLTFExport` API
+- Fix: USDZ: correct `defaultPrim` encapsulation so that it also contains materials
+- Fix: USDZ: render texture readback failure when exporting
+- Fix: `ISceneEventListener` only being found when first component
+- Fix: error in vite plugin facebook instant games if no config would exist
+- Fix: Gizmo label padding and border radius were not properly applied when re-using label
+- Change: USDZ: animation export now automatically includes Animator states
+- Change: USDZ: `PlayAnimationOnClick` now automatically uses Animator state logic to determine looping and continuation of animation (what happens after the specified animation has finished playing)
+- Change: USDZ: current animator states are exported as `PlayAnimation` on scene start
+
+## [3.26.2-beta] - 2023-11-28
+- Add physics NaN safeguards to avoid invalid rapier data propagating through three objects
+
+## [3.26.1-beta] - 2023-11-27
+- Add: information about mouse button, hit point, hit normal, hit distance to `PointerEventData`
+- Fix: EventSystem regression where UI events stopped working
+
+## [3.26.0-beta] - 2023-11-27
+- Fix: LOD update frame delay
+- Change: EventSystem optimization to avoid raycasting objects without event receiver components
+
+## [3.25.5] - 2023-11-24
+- Add: vite plugin for facebook deployment
+- Fix: Physics collider center being not applied correctly with rotated parent
+
+## [3.25.4] - 2023-11-23
+- Add: `onInitialized(ctx => {...})` and `onBeforeRender` event functions
+- Add: `Camera.cullingLayer` property
+- Fix: Physics collider center being modified causing rapier runtime error 
+
+## [3.25.3] - 2023-11-23
+- Add: `onStart((ctx)=>{})` and `onUpdate((ctx)=>{})` functions API
+- Fix: AudioSource not starting autoplay anymore after registered user interaction (which is necessary to playback audio in the browser)
+- Fix: `TransformGizmo` component not working as expected anymore since it also defines `worldPosition`
+- Change: Improve performance for colliders without rigidbody to not create an implicity rapier rigidbody anymore
+
+## [3.25.2] - 2023-11-20
+- Add: `worldForward`, `worldRight` and `worldUp` to Object3D and GameObject types 
+- Add: `getTempVector` utility method that has a circular array of vector3 instances for re-use
+- Fix: ImageTracking hysteresis for images to stay visible during bad tracking for up to a second after tracking has been lost
+
+## [3.25.1] - 2023-11-18
+- Add: getters and setters on Object3D and GameObject types for `worldPosition`, `worldRotation`, `worldQuaternion` and `worldScale`
+- Fix: ImageTracking now has hysteresis for how long to keep a tracked object visible before disabling it (if tracking is lost just for a few frames)
+- Fix: Catch and log exception in rapier during collider creation
+- Change: WebXRImageTracking objects that are already present in the scene are now hidden when entering WebXR/AR
+
+## [3.25.0] - 2023-11-18
+- Add: `Mathf.easinOutCubic` utility method
+- Add: ObjectRaycaster expose option to ignore skinned mesh renderers
+- Fix: detecing website interaction to allow playing audio before any component or audio component has been loaded
+- Fix: Physics capsule height creation
+- Fix: WebXRImageTracking not hiding tracked objects after tracking has been lost
+- Change: Improved ContactShadows component
+- Change: Improve OrbitControls for smoother lerping. Add methods to set camera position and look at target by passing in an Object3D reference.
+- Change: PlayAudioOnClick does now create an AudioSource implictly if non is assigned
+- Change: EventSystem does ignore SkinnedMeshRenderers by default now
+- Change: WebXR reticle is now hidden when image tracking starts
+
+## [3.24.1] - 2023-11-15
+- Fix: Everywhere Action material otherVariants was not cleared between behaviour generation
+- Fix: Everywhere Action Change Material loosing track of the target material
+- Fix: issue where SpatialTrigger calling AudioSource.play doesnt work because of wrong argument
+- Fix: text linebreak in USDZ
+- Fix: material bindings API for Preliminary_Text and don't apply material when no geometry is found
+- Fix: material assignments for USDZ text and fix color space
+- Fix: Capsulecollider height
+- Fix: Core networking issue where throwing callbacks would silently be ignored and causing not all callbacks being called
+- Fix: PlayerSync `owner-changed` being raised twice
+- Fix: PlayerSync unsubscribe from UserLeftRoom event once the player is leaving/has left
+- Fix: Catch exception in creating `new type()` during deserialization of animationclip if the clip is just a string and could not be resolved because it's missing, falsely serialized or annotated
+- Change: OnClick Everywhere Actions now ensure they have a raycaster component assigned or in parent hierarchy
+- Change: Everywhere Action PlayAnimationOnClick remove target field
+
+## [3.24.0] - 2023-11-13
+- Add: ContactShadows component
+- Add: `Gizmos.DrawLabel`
+- Fix: issue with AnimatorController behaviour when using loop and cycle offset
+- Fix: error when loading component with missing AnimatorController field
+- Fix: use correct colorspace for UI components
+- Fix: loading of remote GLB and `skybox-image` url where default camera should set clearflags to skybox
+- Fix: Various colorspace issues fixed
+- Change: USDZ export `imageToCanvas` now uses OffscreenCanvas for improved performance
+- Change: Update pmndrs postprocessing package to 6.33.3 to fix SSAO not working on mobile android
+- Change: `ObjectUtils.createPrimitive` so all primitives use the same settings
+
+## [3.23.1] - 2023-11-09
+- Add: `Gizmos.DrawLabel` method
+- Add: `LookAtObject` utils method with options to keep upwards direction and copying target rotation to stay screen aligned
+- Fix: WebXRPlaneTracking dispose old mesh data properly, heuristically determine if a shape should be convex or not
+- Fix: AudioSource `play` not working anymore if called without parameters
+- Internal: rapier meshcolliders now use convexHull instead of convexMesh, the latter already expects the input data to be convex
+
+## [3.23.0] - 2023-11-08
+- Add: support for changing animatorcontroller at runtime
+- Add: AnimatorController support for cycle offset and speed being used from parameter (or fixed serialized value)
+- Add: `OrbtiControls.allowInterrupt` property that can be set to false to prevent animation to a target point or autoRotate being interrupted by user input like clicking or dragging
+- Add: Physics collision now includes tangent vector for contact points
+- Add: Physics exposes API for getting the object velocity per collider (`context.physics.engine.getLinearVelocity`)
+- Add: Physics Material can now be updated at runtime. Call `updatePhysicsMaterial` on the collider with the changed physics material
+- Fix: scaled capsule collider being created with wrong size
+- Fix: timeline audiotracks not respecting speed property on PlayableDirector (effectively being cut-off instead of being played back at another speed/playbackRate) 
+- Fix: Prevent using XRAnchor on Quest in AR mode (pass-through)
+- Fix: Timeline evaluate is now done in lateUpdate which gives animated objects time to apply the changed data (e.g. OrbitControls where the target object may be animated)
+- Fix: Timeline Audio tracks do not require AudioListener in scene anymore
+
+## [3.22.6] - 2023-11-06
+-  Change: work on approximated transmission export in USDZ
+
+## [3.22.4] - 2023-11-03
+- Add: Option to WebXRControllers to disable default controls (`enableDefaultControls`) and raycasting (`enableRaycasts`)
+- Fix: AnimatorController transition with exitTime and trigger didnt work since trigger was reset before transition could be made
+- Fix: USDZExporter isssue where compressed textures always ended up as JPG after decompression since format check was only checking for RGBAFormat, now also checks for compressed formats
+- Change: catch and display unhandled exceptions during creation of engine, make sure bubble messages are on top of loading overlay
+- Change: USDZExporter should re-use renderer 
+
+## [3.22.3] - 2023-11-02
+- Add: Coroutine can now yield on promise and wait for the promise to be resolved
+- Fix: CharacterController not being grounded on mesh collider
+- Fix: ShadowCatcher set to additive mode didnt work anymore
+
+## [3.22.2] - 2023-11-01
+- Add: Optional `RectTransform.minWidth` and `RectTransform.maxWidth`
+- Fix: GameObject instantiate should clone color objects (to not share instance)
+- Fix: Call to `parseSync` with full url argument now correctly passes base url to three GLTFLoader for resolving external resources
+- Change: PhysicsMaterial properties are now all optional (e.g. so we can set only friction)
+- Change: `Rigidbody.setForce` to take a vec3
+- Change: `AudioSource.onDisable` should pause not stop
+- Change: `Mathf.random(<min>?, <max>?)` now takes optional min and max parameters
+
+## [3.22.1] - 2023-10-30
+- Fix: `Screencapture.autoconnect` when already connected to networking server or connection is in progress / window selection is currently open
+- Change: when `isManagedExternally` is enabled then framerate is user controlled and not automatically clamped
+- Change: add more documentation to networking methods
+
+## [3.22.0] - 2023-10-26
+- Fix: SyncedCamera deserialization warning
+- Change: Collider property updates now trigger rigidbody mass recalculation immediately (if set to auto-mass)
+- Change: Rigidbody methods now take Vec3 object as well as arguments like `{x:0, y:1, z:0}`
+- Change: Improve Screencapture
+- Change: Screencapture now also allows `Microphone` as input device
+- Change: Updated VOIP script and removed old VOIP implementation - it now uses the same underlying codebase as screencapture
+- Change: Update imports to use `type` where appropriate
+
+## [3.21.5] - 2023-10-25
+- Fix: remove leftover console.log
+- Fix: Hovered button should reset pointer state when destroyed
+- Fix: WebXR Rig parenting in VR when switching scenes
+- Fix: Timeline activation track not properly evaluating when timeline is paused and manually evaluated from user code
+- Fix: Sphere Collider radius not being set correctly
+
+## [3.21.3] - 2023-10-23
+- Fix: Issue where Chrome touch emulation caused "onPointerClick" being called twice per click
+- Fix: EventList instances are now not shared anymore between components created via `instantiate`
+- Fix: Regression where SphereCollider radius was not being applied
+
+## [3.21.2] - 2023-10-23
+- Change: Expose EventList subscriber count
+- Change: `PointerEventArgs.use()` should not stop propagation
+
+## [3.21.1-alpha] - 2023-10-20
+- Add: Multitouch support on `input` events, our EventSystem implementation now handles multitouch cases and is using the browser events directly and immediately (before events via `window` where deferred and hanlded during the engine update loop)
+
+## [3.21.0-alpha] - 2023-10-19
+- Add: support for translate, rotate and scale of AR scene on android devices (needs `WebXRSessionRoot.arTouchTransform` set to true right now)
+- Add: `SphereCollider.radius` and `BoxCollider.size` updates at runtime are now automatically propagated to the physics engine updating the physics shapes. Additionally the object scale for SphereCollider objects is watched and automatically applied on change 
+- Fix: removal of all colliders on an object now also fully cleansup the implictly created RigidBody
+- Change: `Context.isManagedExternally` can now be set at runtime as a first step towards allowing complete external control over the Needle Engine lifecycle loop in cases where Needle Engine scenes or components are mixed with an external three.js scene (and projects that require more explicit control)
+
+## [3.20.3] - 2023-10-18
+- Add: Expose Rapier dominance group option on Rigidbody
+- Fix: Ignore root motion when animator weight is <= 0 due to Timeline playing
+- Fix: Rapier race condition caused by dynamic loading
+- Change: Allow setting Rigidbody mass explictly now by either setting `autoMass` to false or by setting the `mass` property
+
+## [3.20.2] - 2023-10-17
+- Fix: renderer access nullreference exceptions caused by deferred initialization
+- Fix: disabling postprocessing now restores renderer clear state (which got disabled by the postprocessing package)
+- Fix: disable generating WebXRPlane tangents
+
+## [3.20.1] - 2023-10-16
+- Change: `addComponent` can now take component instance or type
+
+## [3.20.0] - 2023-10-13
+- Fix: issue where physics colliders where not yet fully initialized in `start` event
+- Fix: Pointer delta while cursor is locked
+- Change: Expose `context.phyiscs.engine.world` and  `context.physics.engine.getComponent` method to directly work with rapier physics engine and to easily get access to Needle Engine components from rapier colliders
+- Change: Expose `Context.DefaultWebGLRendererParameters` that can be modified in static context before renderer is created
+
+## [3.19.9] - 2023-10-11
+- Change: `AnimatorController.createFromClips` now sets the state hash to index of clip
+- Fix: AnimatorController root motion direction when runtime instantiating and using the same clip on multiple objects
+- Fix: AnimatorController root motion forward direction when rotating object from script as well
+
+## [3.19.8] - 2023-10-10
+- Add: `AnimatorController.createFromClips` utility method taking in a animationclips array to create a simple controller from. By default it creates transitions to the next clip
+- Fix: occasional issue where the scrollbar would cause flickering due to hiding/showing when the website was zoomed
+- Fix: screenshot utility method respecting page zoom
+- Fix: vite dependency watcher plugin running installation if dependency in package.json would change
+- Fix: Animator root motion working with multiple states, clips and transitions
+
+## [3.19.7] - 2023-10-04
+- Add: OrbitControls `enableRotate` property
+- Fix: LODGroup not using last LOD in cases where the last LOD is never culled
+- Fix: PostProcessing EffectStack correctly ordered when using N8 Ambient Occlusion (together with Bloom for example)
+- Fix: Postprocessing N8 should not modify gamma if it's not the last effect in the stack
+
+## [3.19.6] - 2023-10-02
+- Fix: AudioSource does now create an AudioListener on the main camera if none is found in the scene
+- Change: VideoPlayer does fallback to clip if src is empty or null
+- Change: OrbitControls now expose `enableRotate` property
+
+## [3.19.5] - 2023-10-02
+- Fix: web component font import
+
+## [3.19.4] - 2023-09-29
+- Fix: Remove leftover OrbitControls log
+- Change: Timeline TrackModel `markers` and `clips` fields are now optional
+- Change: VideoPlayer is set to use url as default video source (if nothing is defined)
+
+## [3.19.3] - 2023-09-28
+- Fix: regression in OrbitControls without lookat target assigned
+- Fix: progressive textures loading with custom reflection probe
+- Fix: WebAR touch event screenspace position using `this.context.input` 
+
+## [3.19.2] - 2023-09-27
+- Add: OrbitControls `autoFit` property
+- Add: API to access underlying Rapier physics body using `context.physics.engine.getBody(IComponent | IRigidbody)`
+
+## [3.19.1] - 2023-09-27
+- Add: ParticleSystem now supports HorizontalBillboard and VerticalBillboard
+- Fix: [WebXR chromium bug](https://bugs.chromium.org/p/chromium/issues/detail?id=1475680) where the tracking transform matrix rotates roughly by 90° - we now add an WebXR Anchor to keep the scene at the placed location in the real world
+- Fix: SceneSwitcher does now call event on first `ISceneEventListener` found on root level of a loaded scene (e.g. if a Unity scene is loaded that contains multiple children and does not have just one root object)
+- Fix: Text UI clipping with multiple active screenspace canvases in scene
+- Fix: Screenspace canvas events should not be blocked anymore by objects in 3D scene
+- Fix: FirstPersonController rotation not being correctly / falsely resetted and flipped in some cases
+
+## [3.19.0] - 2023-09-26
+- Fix: collider scale wrongly affecting physics objects
+- Fix: collider debug lines should not be raycastable
+- Fix: mesh-collider behaving unexpectedly
+- Fix: animator root motion causing error due to uninitialized Quaternion object
+
+## [3.18.0] - 2023-09-21
+- Add: SceneSwitcher has now a field for `loadingScene` which can be used to display a scene while loading other scenes
+- Add: `ISceneEventListener` which is called by the SceneSwitcher when a scene has been loaded or a scene is being unloaded. It can be used to handle showing and hiding content gracefully. It has to be added to the root of the scene that is being loaded (e.g. the root of the scene or prefab assigned to the `loadingScene` field or the root of a scene assigned to the `scenes` array)
+- Add: `hide-loading-overlay` attribute to `<needle-engine>` webcomponent (use like `<needle-engine hide-loading-overlay>`). Custom loading requires a PRO license. See [all attributes in the documentation](https://engine.needle.tools/docs/reference/needle-engine-attributes.html).
+- Fix: Loading overlay should not link to needle website anymore when using a custom logo
+- Fix: Add safeguard to user assigned events on `<needle-engine>` for cases where methods are not defined in the global scope
+- Change: Update loading message displayed in overlay while waiting for `ContextCreated` promise (e.g. in cases where a large environment skybox is being loaded)
+
+## [3.17.0] - 2023-09-20
+- Fix: handle exception when loading GLB/glTF files with invalid lightmapping extension
+
+## [3.16.5] - 2023-09-18
+- Change: Ignore shadow catcher and GroundProjectedEnvironment sphere when running OrbitControls.fit
+
+## [3.16.4] - 2023-09-16
+- Add: help balloon message if user tries to open a local file without using a webserver
+- Add: helpful console.log if user tries to add a component that is not a Needle Engine component
+
+## [3.16.3] - 2023-09-15
+- Add: logo now respects prefer-reduced-motion, reduce and is immediately added instead of after 1s
+- Fix: use default background color if GLB without camera and skybox is loaded
+- Fix: ensure custom KTX2 loader is correctly initialized
+- Fix: revert RectTransform change that broke hotspot rendering
+- Change: adjust default backgroundBlurriness to match Blender defaults
+
+## [3.16.2] - 2023-09-15
+- Add: mesh collider handling for invalid mesh data (non-indexed geometry)
+
+## [3.16.2-beta] - 2023-09-13
+- Add: `camera.environmentIntensity` property
+- Change: default background blurriness for fallback camera to match blender default
+
+## [3.16.1-beta] - 2023-09-13
+- Change: if loaded glTF doesnt contain a camera we now also create the default OrbitControls (e.g. glTF exported from a Blender scene without a camera)
+
+## [3.16.0-beta] - 2023-09-13
+- Add: `NEEDLE_lightmaps` entries `pointer` property can now also be a path to a local texture on disc instead of a texture pointer. This allows Blender EXR and HDR maps to be used at runtime until Blender export supports hdr and exr images to be stored inside the GLB
+
+## [3.15.0-beta] - 2023-09-13
+- Fix: remove leftover console.log
+- Fix: `DeviceFlag` component not detecting devices correctly for iOS safari
+- Fix: loading glTF without any nodes
+- Fix: `SceneSwitcher` bug where a scene would be added twice when switching in fast succession
+- Fix: `Animation.isPlaying` bool was always returning false
+- Fix: Handle typescript 5 decorator change to prevent VSCode error message (or cases where `experimentalDecorators` is off in tsconfig). See [179](https://github.com/needle-tools/needle-engine-support/issues/179)
+- Fix: Improve internal lifecycle checks and component method calls
+- Change: Improse ContextRegistry/NeedleEngine `ContextEvent` enum documentation
+- Change: `<needle-engine skybox-image=` and `environment-image=` attributes are now awaited (loading overlay is still being displayed until loading the images have finished or failed loading)
+
+## [3.14.0-beta] - 2023-09-11
+- Add: exposing `Needle.glTF.loadFromURL` in global scope to support loading of any glTF or GLB file with needle extensions and components when using the prebundled needle engine library (via CDN)
+- Add: `context.update` method for cases where needle engine is now owning renderer/scene/camera and the update loop is managed externally
+- Fix: animating custom shader property named `_Color` 
+- Fix: issue with wrong CSS setting in Needle Engine breaking touch scroll
+- Change: `?stats` now logs renderer statistics every few seconds
+- Change: simplify creating a new Needle Context that is controlled externally (not owning camera/renderer)
+
+## [3.13.0-beta] - 2023-09-08
+- Add: ParticleSystem now also uses material color
+- Add: `IEditorModificationListener.onAfterEditorModification` callback (requires `@needle-tools/editor-sync@2.0.1-beta`)
+- Bump: Three.Quarks dependency to 0.10.6
+- Update draco decoder include files
+
+## [3.12.2-beta] - 2023-09-04
+- Add: option to override peerjs host and id (options) via `setPeerOptions`
+- Fix: potential nullreference error in AudioListener
+- Fix: Networking component cases where invalid localhost input with "/" causes url to contain "//" sometimes -> we can skip one "/" in this case and make it just work for users
+- Fix: package.json `overrides` syntax for quarks three.js version
+- Change: Screensharing bool to disable click to start networking + add deviceFilter to share(opts:ScreenCaptureOptions)
+
+## [3.12.1-beta] - 2023-09-04
+- Fix: next.js/webpack useRapier setting
+- Change: typestore is now globally registered
+
+## [3.12.0-beta.1] - 2023-08-28
+- Fix: vite hot reload plugin to dynamically import needle engine to support usage in server-side rendering context
+
+## [3.12.0-beta] - 2023-08-28
+- Add: Timeline api for modifying final timeline position and rotation values (implement `ITimelineAnimationCallbacks` and call `director.registerAnimationCallback(this)`)
+- Change: Update three quarks particlesystem library to latest
+- Fix: issue where onPointerExit was being called when cursor stops moving
+- Fix: USDZ normal scale Z was incorrect
+- Fix: Timeline Signal events using different casing than UnityEvent events
+- Fix: issue where `isLocalNetwork` was falsely determined
+
+## [3.11.6] - 2023-08-15
+- Remove beta
+
+## [3.11.6-beta] - 2023-08-14
+- Fix: find exported animation by PropertyBinding 
+- Fix: USDZExporter was not exporting animation from Animation component but only from Animator
+- Fix: potential issues with Animation component `clip.tracks` being null/undefined on USDZ export
+- Fix: `loadstart` event not being called
+- Fix: getComponent should always either the component or null (never undefined)
+- Fix: dynamic import of websocket-ts package
+- Fix: progressive texture loading wasn't properly awaited on USDZ export
+- Fix: apply XR flags when exporting to QuickLook
+- Fix: USDZ alpha clipping for materials without textures
+- Fix: USDZ same material used in different ChangeMaterialOnClick resulted in duplicate behaviour names
+- Change: set default WebARSessionRoot to "1" instead of "5"
+
+## [3.11.5-beta] - 2023-08-10
+- Fix: components keep their gameObject references until `destroy` call of object's is completed when destroying an hierarchy. Previously child components might already be destroyed resulting in `myChildComponent.gameObject` being null when called in `onDestroy` from a parent component
+- Fix: regression where timeline was not updating animations anymore if Animator had an empty AnimatorController assigned (without any states)
+- Fix: `SceneSwitcher.switchScene` can now handle cases where it's called with a string url instead of an AssetReference 
+- Fix: issue where `onPointerMove` event was being called continuously on mobile after touch had already ended
+- Fix: issue where GLTFLoader extensions where missing name field resulting in extensions not being properly registered (causing stencils to not work sometimes)
+- Change: EventSystem raycast is now only performed when pointer has changed (moved, pressed, down, up) which should improve performance on mobile devices when raycasting on skinned meshes
+- Change: peer and websocket-ts import asynchronously
+- Remove: legacy include files
+
+## [3.11.4-beta] - 2023-08-04
+- Fix: USDZExporter exception caused by programmatically calling `exportAsync` without quicklook button
+- Fix: Timeline `evaluate` while being paused
+- Bump three to fix issue with blend shape animation not being applied to Group objects (KHR_animation_pointer)
+
+## [3.11.3-beta] - 2023-08-03
+- Change: improve styling of `<needle-engine>` DOM overlay element to allow positioning of child elements
+- Fix: USDZExporter normal bias when normalScale is used
+- Fix: Nullreference in SceneSwitcher when creating the component from code and calling `select` with a new scene url
+- Fix: Quicklook button creation
+- Fix: Particlesystem layermask not being respected
+
+## [3.11.2-beta] - 2023-07-31
+- Fix: `ChangeMaterialOnClick` with multi material objects
+- Fix: progressive textures regression
+
+## [3.11.1-beta] - 2023-07-31
+- Add: `saveImage` utility method and make `screenshot` parameter optional
+- Add: `loading-style="auto"`
+- Fix: skybox image caching
+- Fix: finding animation tracks for unnamed nodes when using the `autoplay` attribute
+- Change: improved `<needle-engine>` default sizes
+- Change: smoother src changes on `<needle-engine>` by only showing loading overlay when loading of files takes longer than a second
+- Change: bump three version to 154.2 fixing KHR_animation_pointer not working with SkinnedMesh
+
+## [3.11.0-beta] - 2023-07-29
+- Add: Support for blending between Timeline and Animator animation by fading out animation clips allowing to blend idle and animator timeline animations
+- Fix: WebXR buttons style to stay inside `<needle-engine>` web component
+- Fix: `OrbitControls.fitCamera` now sets rotation target to the center of the bounding box
+- Fix: Timeline animation regression causing Animator not being enabled again after timeline has finished playing
+- Fix: Timeline should re-enable animator when ended reached end with wrap-mode set to None
+- Change: add `.js` extensions to all imports
+- Change: allow overriding loading style in local develoopment
+- Change: expose flatbuffer scheme helper methods
+
+## [3.10.7-beta] - 2023-07-28
+- Fix: Camera using RenderTarget (RenderTexture) now applies clear flags before rendering (to render with solid color or another skybox for example)
+- Fix: RenderTexture not working in production build due to texture being compressed
+- Fix: RenderTexture warning `Feedback loop formed between Framebuffer and active Texture`
+- Fix: Handle Subparticlesystem not being properly serialized avoiding runtime error
+- Internal: add resource usage tracking of textures and materials
+
+## [3.10.6-beta] - 2023-07-27
+- Fix: Timeline ActivationTrack behaves like `leave as is` when timeline is disabled (not changing the activate state anymore)
+- Fix: Timeline Signal Track with duration of 0 and signal at time 0 does now trigger
+- Fix: Timeline disabling or pausing does now activate animator again
+- Fix: CustomShader Time node for BiRP
+- Fix: ParticleSystem simulation mode local now correctly applies parent scale
+- Change: Show warning for wrong usage of `@serializable` with `Object3D` where a `AssetReference` is expected
+- Change: ParticleSystem shows warning when using unsupported scale mode (we only support local right now)
+
+## [3.10.5-beta] - 2023-07-25
+- Fix: warning at runtime when methods called by `EventList`/`UnityEvent` are in the wrong format
+- Fix: OrbitControls issue where double clicking/focus on screenspace UI would cause the camera to be moved far away
+- Fix: `OrbitControls.fitCamera` where three `expandByObject` now requires an additional call to `updateWorldMatrix` [26485](https://github.com/mrdoob/three.js/issues/26485#issuecomment-1649596717)
+- Change: replace some old `Texture.encoding` calls with new `Texture.colorSpace`
+- Change: improve `PlayerSync` networking and add `onPlayerSpawned` event
+- Remove: `RectTransform.offsetMin` and `offsetMax` because it's not implemented at the moment
+
+## [3.10.4-beta] - 2023-07-24
+- Fix: activating UI elements in VR not applying transform
+
+## [3.10.3-beta] - 2023-07-21
+- Fix: AnimatorController error caused by missing animationclip
+- Fix: next.js webpack versions plugin
+- Fix: Occasional `failed to load glb` error caused by not properly registering `KHR_animation_pointer` extension 
+- Fix: UI issue where Text in worldspace canvas would be visible at wrong position for a frame
+- Fix: UI issue where Text would not properly update when switching between text with and without richtext
+- Fix: UI issue where Image would not automatically update when setting texture from script
+- Fix: issue where RenderTexture would not be cleared before rendering
+- Change: make `addEventListener` attribute on `<needle-engine>` optional
+
+## [3.10.2-beta] - 2023-07-19
+- Fix: iOS double touch / input
+- Change: minor WebXRController refactor moving functionality into separate methods to be patchable
+
+## [3.10.1-beta] - 2023-07-18
+- Fix: prebundled package
+- Fix: runtime license check
+- Fix: Input being ignored after first touch
+- Fix: SpatialTrigger, reverting previous change where we removed the trigger arguments
+
+## [3.10.0-beta.2] - 2023-07-18
+- Fix: prebundled package by locking vite to <= 4.3.9
+
+## [3.10.0-beta.1] - 2023-07-17
+- Fix: prebundled package
+
+## [3.10.0-beta] - 2023-07-17
+- Fix: Text clipping in VR
+- Fix: AR overlay `quit-ar` button not being properly detected
+- Fix: Timeline animation track post-extrapolate set to `Hold`
+- Fix: iOS touch event always producing double click due to not properly ignoring mouse-up event
+- Change: DragControls to automatically add ObjectRaycaster if none is found in parent hierarchy
+- Change: DragControls now expose options to hide gizmo and to disable view-dependant behaviour
+
+## [3.10.0-alpha] - 2023-07-15
+- Change: WebXR component now automatically adds a WebARSessionRoot on entering AR when no session root was found in the scene
+- Change: `@syncField` can now sync objects by re-assigning the object to the same field (e.g. `this.mySyncedObject = this.mySyncedObject` to trigger syncing)
+- Change: log error when `@syncField` is being used in unsupported types (currently we only support syncField being used inside Components directly)
+- Change: improve message when circular scene loading is detected and link to documentation page 
+
+## [3.9.1-alpha] - 2023-07-14
+- Add: SceneSwitcher now uses scene name by default. Can be turned off in component
+- Fix: ParticleSystem lifetime not respecting simulation speed 
+- Fix: ParticleSystem prewarm with simulation speed and improved calculation of how many frames to simulate
+- Fix: Exit AR and Exit VR now restores previous field of view
+- Change: close AR button adjusted for better visibility on bright backgrounds
+- Change: bump @types/three to 154
+
+## [3.9.0-alpha.1] - 2023-07-12
+- Add: vite plugin to clamp version to `<= 4.3.9` since 4.4 and above currently cause issues with typescript decorators, [vite#13736](https://github.com/vitejs/vite/issues/13736)
+
+## [3.9.0-alpha] - 2023-07-12
+- Add: `<needle-engine>` web component slot support, AR DOM overlay can now be added by simple adding HTML elements inside the `<needle-engine></needle-engine>` web component. Fixing [164](https://github.com/needle-tools/needle-engine-support/issues/164)
+- Add: Basic USDZ exporting of UI shadow hierarchies as mesh hierarchies for UI in Quicklook AR support
+- Fix: WebXR Rig not being rotated as expected when setting up in Unity [129](https://github.com/needle-tools/needle-engine-support/issues/129)
+- Fix: WebXR VR button click, hover is still not working
+- Fix: Issue with Lightmaps breaking when switching back and forth between multiple lightmapped scenes
+- Change: Button click should not invoke with middle or right mouse
+
+## [3.8.0-alpha] - 2023-07-11
+- Update three.js to 154 (latest)
+- Bump postprocessing dependency
+- Add: `this.context.xrCamera` property
+- Fix: screenspace canvas should not run in VR
+- Fix: OrbitControls should not update while in AR and touching the screen
+- Change: allow using vanilla three.js by dynamically importing KHR_animation pointer api 
+
+## [3.7.7-beta] - 2023-07-11
+- Fix: LookAt copyTarget + keepUpDirection
+- Fix: DragControls not working on first touch on mobile / clone input event
+- Fix: Renderer assigning renderOrder in URP on SkinnedMesh with multi-material
+
+## [3.7.5-beta] - 2023-07-07
+- Fix: USDZExporter should not show Needle banner when branding information is empty (pro only)
+- Fix: USDZExporter sessionroot scale should be applied to object to be exported when the root is in the parent
+- Fix: DropListener localhost without explicit backend url + dropping file caused exceptions
+- Fix: instanceof error that tsc complained about
+- Change: Fonts handle semibold variant
+- Internal: DropListener re-use addFiles method, remove old code
+- Internal: Bump tools package dependency
+
+## [3.7.5-alpha] - 2023-07-06
+- Add: SignalEvents support for arguments
+- Fix: SpatialTrigger Unity events removing extra (unexpected) event arguments
+- Fix: safeguard `AudioSource.play` to not fail when `clip` argument is not a string
+- Change: change Timeline signal event trigger time to use last frame deltatime with padding to estimate if the event should fire
+
+## [3.7.4-alpha] - 2023-07-05
+- Change: targetFps, use timestamp that we get from the animation callback event because it is more reliable on Firefox
+
+## [3.7.3-alpha] - 2023-06-26
+- Add: physics gravity to `IPhysicsEngine` interface to be available via `this.context.physics.engine.gravity`
+- Fix: USDZ text alignment
+
+## [3.7.2-alpha] - 2023-06-23
+- Fix: Nullref in SpectatorCamera.onDestroy when camera wasnt active
+
+## [3.7.1-alpha] - 2023-06-22
+- Add: ChangeMaterialOnClick `fadeDuration` option (Quicklook only)
+- Change: USDZ export now enforces progressive textures to be loaded before export
+- Change: USDZ export callbacks for `beforeCreateDocument` and `afterCreateDocument` can now run async
+- Fix: USDZExporter quicklook button
+- Fix: USDZExporter Quicklook button not being removed when exporter gets removed or disabled
+- Fix: USDZ ChangeMaterialOnClick clear cache before exporting, this caused USDZ export to fail on third export in USDZ sample scene
+- Fix: Engine loading bar not being updated
+- Fix: USDZ text linebreaks
+- Fix: UI font name style check. Unknown font styles are now not touched anymore (e.g. font name ending with `-Medium`)
+
+## [3.7.0-alpha] - 2023-06-21
+- Change: Move HTML elements into <needle-engine> shadow dom
+
+## [3.6.13] - 2023-06-21
+- Add: static Context.DefaultTargetFrameRate
+- Add: option to prevent USDZExporter from creating the button
+- Fix: `@prefix` handling promise resolving to false
+
+## [3.6.12] - 2023-06-20
+- Update Readme
+
+## [3.6.11] - 2023-06-19
+- Add: UI InputField API for clear, select and deselect from code
+- Change: LODGroup serialization
+- Fix: mobile debug console should be above loading overlay if error happens during loading
+- Fix: LODGroup not being able to resolve renderer reference
+- Fix: Particles direction being wrong in some causes with scaled parent and scaled particle system
+- Fix: Particles subsystem emitter position being wrong when main particle system was scaled
+- Fix: Bundled library failing to load due to undeclared variable
+- Fix: UI InputField hide html element
+- Fix: Joining empty room name is not allowed anymore
+- Fix: Clamp Room name length to 1024 chars
+
+## [3.6.10] - 2023-06-14
+- Fix: Text with richText not updating properly
+- Internal: Change font style parsing
+
+## [3.6.9] - 2023-06-12
+- Fix: Particles SizeOverLifetime module for mesh particles
+
+## [3.6.6] - 2023-06-12
+- Internal updates
+
+## [3.6.5] - 2023-06-09
+- Add: NestedGltf `loaded` event being raised when the glb has been loaded
+- Add: AnimationCurve cubic interpolation support
+- Change: set targetFramerate to 60 by default (in `context.targetFrameRate`)
+- Fix: USDZ metalness/roughness potentially being undefined when exporting Unlit materials
+- Fix: Handle exception when loading components due to bug when using meshopt compression and material count changes
+- Fix: ColorAdjustments setting tonemapping exposure to 0 when exposure parameter override is off [824]
+
+## [3.6.4] - 2023-06-02
+- Add: `ObjectUtils.createPrimitive` for cube and sphere
+- Change: expose `ObjectUtils`
+- Fix: BoxGizmo component
+- Fix: vite copy plugin when needle.config.json "assets" directory starts with "/"
+
+## [3.6.3] - 2023-06-01
+- Change: OrbitControls apply settings in update
+- Fix: Rapier stripping not being respected
+
+## [3.6.2] - 2023-06-01
+- Fix: wrong UI z-offset in some cases
+- Fix: Particle velocity over lifetime not using world rotation
+- Fix: Particle burst being played twice
+- Fix: Particle `playOnAwake` option not being respected
+
+## [3.6.2-beta] - 2023-05-31
+- Add: `setAllowOverlayMessages` to explictly disable overlay messages without url parameter
+- Add: allow larger textures for USDZ generation
+- Fix: nested gltf with disposing of resources leading to broken files
+
+## [3.6.1-beta] - 2023-05-29
+- Fix: removing `<needle-engine>` from DOM does now dispose the context properly and unsubscribes from browser events. Add `keep-alive` attribute to disable disposing
+
+## [3.6.0-beta] - 2023-05-29
+- Add callbacks for ContextClearing
+- Add: [n8AO postprocessing effect](https://github.com/N8python/n8ao) (Screenspace Ambient Occlusion) support
+- Add: option to disable automatic poster generation (use `noPoster` in options in vite.config) 
+- Fix: `<needle-engine>` without any src should setup an empty scene
+- Change: `OrbitControls.fit` now handles empty scene and ignores GridHelper
+- Change: TimelineAudio disconnect audio in onDestroy
+- Change: Ensure PostProcessing VolumeParameters are initialized
+- Change: Improve memory allocs and disposing of resources
+- Change: Update three.js fixing GLTFLoader memory leak
+
+## [3.6.0-alpha.3] - 2023-05-27
+- Add: `auto-rotate` attribute
+- Add: `autoplay` attribute
+- Change: await loading of `skybox-image` and `environment-image`
+- Change: do not clear renderer when switching `src` attribute
+
+## [3.6.0-alpha.2] - 2023-05-27
+- Fix: error in vite plugin when `meta.json` was missing
+- Fix: three.js OrbitControls causing look direction to not work anymore due to forcing an update in the constructor 
+
+## [3.6.0-alpha] - 2023-05-27
+- Add: Changing `src` attribute now does scene cleanup and loads new files
+- Add: `skybox-image` and `environment-image` attributes, allow changing both at runtime 
+- Fix: error display overlapping in cases where somehow engine is imported twice
+- Fix: logo overlay should only show when loading is done, change error during render loop message
+- Fix: OrbitControls camera fitting now done once before rendering when loaded glb does not contain any camera
+- Fix: Vite client plugin imports
+- Change: Context now handle errors during initializing or when starting render loop
+- Change: ContextRegistry exported as NeedleEngine and export hasIndieLicense function
+- Change: Remove need to manually define global engine variables in cases without bundler or Needle plugins
+
+## [3.5.13-beta.1] - 2023-05-26
+- Change: embed logo svg and avoid loading it
+
+## [3.5.13-beta] - 2023-05-26
+- Change: OrbitControls camera fitting improved
+
+## [3.5.12-beta] - 2023-05-24
+- Add: option to toggle collider visibility from script via `this.context.physics.engine.debugRenderColliders` 
+- Change: engine.physics raycast doesnt need any parameters now anymore
+- Change: OrbitControls default target should be related to distance to center (if nothing is hit by raycast)
+- Fix: EventList object and component argument deserialization
+
+## [3.5.11-beta] - 2023-05-22
+- Add: `@registerType` decorator that can be added to classes for registration in TypeStore. Currently only useful for cases outside of Unity or Blender for Hot Reload support
+- Fix: `Component.name` should return Object3D name
+- Fix: GameObject static methods generic
+- Fix: Logo animation causing browser scrollbar to appear
+
+## [3.5.10-beta] - 2023-05-22
+- Add: SpriteRenderer now exposes shadow casting and transparency options
+- Fix: vite plugin issue caused by missing src/generated/meta
+- Fix: nullref in debug_overlay, typo in physics comment
+- Fix: disabling collider with rigidbody component did cause an error in rapier
+- Fix: HTMLElement css, cleanup loading element, move logo into html element
+- Fix: GameObject.addComponent now takes Object3D type too
+- Fix: loading overlay not hiding when <needle-engine> src changes
+- Change: OrbitControls now sets target to 10 meter by default if nothing is assigned or hit in the scene (previously it was set to 1 meter)
+- Change: fit camera to scene after loading when no camera is present in file
+
+## [3.5.9-beta.2] - 2023-05-20
+- Add: WebXRPlaneTracking should initiate room setup on Quest when no tracked planes are found
+
+## [3.5.9-beta.1] - 2023-05-19
+- Fix: SceneSwitcher should ignore swipe events when `useSwipe` is disabled
+
+## [3.5.9-beta] - 2023-05-19
+- Add: Support for progressive texture loading for custom shaders
+- Fix: react-three-fiber template
+
+## [3.5.9-alpha.2] - 2023-05-18
+- Add: needle-engine attributes documentation
+- Change: assign main camera during gltf component deserialization when no camera is currently assigned
+
+## [3.5.9-alpha] - 2023-05-18
+- Add: add nextjs plugin to handle transpiling and defines
+- Change: expose USD types to make custom behaviours, add proximityToCameraTrigger
+- Fix: loading element position to absolute to avoid jumps when added to e.g. nextjs template
+- Fix: texcoords werren't quicklook compatible in ThreeUSDZExporter
+- Fix: `LookAt` component with invertForward option was flipped vertically in QuickLook
+
+## [3.5.8-alpha] - 2023-05-16
+- Add NeedleConfig `baseUrl` for codegen
+- Change: AudioSource should pause in background on mobile
+- Fix: logo svg import for nextjs
+- Fix: particle system playOnAwake
+
+## [3.5.7-alpha] - 2023-05-15
+- Add: Initial support for text in USDZ
+- Change: add generic to `networking.send` for validation of model
+- Change: SyncedRoom, expose tryJoinRoom method + remove error thrown when roomName.length <= 0, join room in onEnable
+- Fix: setting position on UI object (RectTransform) works again
+- Fix addressable instantiate options called with `{ position: .... }` and without a parent, it should then still take the scene as the default parent
+- Fix: WebXR `arEnabled` option
+- Fix: Worldspace canvas always being rendered on top
+- Fix: CanvasGroup alpha not being applied to text
+
+## [3.5.6-alpha] - 2023-05-12
+- Fix defines for vanilla JS usage
+- Fix CanvasGroup not overriding alpha
+- Remove some spurious logs
+- Add `addComponent` method to this.gameObject
+- Add "light" version on bundle processing
+
+## [3.5.5-alpha.1] - 2023-05-11
+- Fix: declare missing defines for pre-bundled engine
+
+## [3.5.5-alpha] - 2023-05-11
+- Add: getWorldDirection
+- Add: needle.config.json `build.copy = []` to copy files on build from arbitrary locations into the dist folder for example:
+  ```md
+  "build": {
+    "copy": [
+      "cards" <-- can be relative or absolute folder or file. In this case the folder is named "cards" in the web project directory
+    ]
+  }
+  ```
+- Add ip and location utils
+- Change: add buffers for getWorldQuaternion, getWorldScale util methods
+- Change: animatorcontroller should only log "no-action" warning when in debug mode
+- Fix: apply and check license
+
+## [3.5.4-alpha] - 2023-05-11
+- Fix: wrong serialization check if a property is writeable
+- Fix: mark UI dirty when text changes
+- Change: allow UI graphic texture to be set to null to remove any texture/image
+- Change: rename USDZExporter `overlay` to `branding`
+
+## [3.5.3-alpha.1] - 2023-05-10
+- Fix: wrong check in serialization causing particles to break (introduced in 3.5.3-exp)
+
+## [3.5.3-alpha] - 2023-05-10
+- Add: `IPointerMoveHandler` interface providing `onPointerMove` event while hovered
+- Add: USDZ AudioSource support and PlayAudioOnClick
+- Change: balloon messages can now loop
+- Change: pointer event methods are now lowercase
+- Change: allow `moveComponent` to be called with component instance that was not added to a gameObject before (e.g. created in global scope and not using the `addComponent` methods)
+- Fix: input pointer position delta when browser console is open
+- Fix: GameObject.destroy nullcheck
+- Fix: typescript error because of import.meta.env acccess
+- Fix: issue where added scenelighting component by extension caused animation binding to break
+- Fix: UI layout adding objects dynamically by setting anchorMinMax
+- Fix: Prevent exception during de-serialization when implictly assigning value to setter property
+- Fix: screenspace canvas being rendered twice when using explicit additional canvas data component
+- Fix: EventSystem cached state of hovered canvasgroup not being reset causing no element to receive any input anymore after having hovered a non-interactable canvasgroup once
+- Fix: empty array being returned in `GameObject.getComponents` call when the passed in object was null or undefined
+
+## [3.5.2-alpha] - 2023-05-09
+- Add: SceneSwitcher preload feature
+- Change: interactive behaviours for QuickLook are on by default now
+- Fix: SetActiveOnClick toggle for QuickLook
+- Fix: USDZ texture transform export works in more cases
+
+## [3.5.1-alpha] - 2023-05-09
+- Fix: reflection probes not working anymore
+- Fix: false RectTransform return breaking some cases with reparenting
+- Fix: RectTransform mark dirty when anchors change (due to animation for example)
+
+## [3.5.0-alpha] - 2023-05-08
+- Change: allow tree-shaking rapier physics
+- Fix various USDZ export issues:
+  - fix UV2 for occlusion maps (paves the way for lightmaps), had to be texCoord2f[] instead of float2[]
+  - fix missing MaterialBindingAPI schema
+  - fix normal scale for non-ARQL systems (ARQL doesn't support it though, but needed for other viewers)
+  - fix input:scale for textures not being used if it's (1,1,1,1)
+  - fix normal maps not being in raw colorSpace
+
+## [3.4.0-alpha] - 2023-05-05
+- Add: low-level USD Actions/Triggers API for building complex interactions for iOS devices
+- Add: high-level USDBehaviours components: ChangeMaterialOnClick, PlayAnimationOnClick, SetActiveOnClick, HideOnStart
+- Add: LookAt component now supports iOS AR
+- Add: more settings for LookAt
+- Add: support for Horizontal- and VerticalLayoutGroup (UI)
+- Fix: `setWorldScale` was setting incorrect scale in some cases
+- Fix: WebXR Image Tracking now works with WebARSessionRoot / rig movements
+- Fix: vite reload only when files inside "assets" change and only if its a known file type
+
+## [3.3.0-alpha] - 2023-05-02
+- Add: AssetReference can now handle scene reference
+- Add: UI update with support for screenspace UI, anchoring, pivots, image outline effect, image pixelPerUnit multiplier
+- Add: basic LookAt component
+- Add: basic UI outline support + handle builtin Knob image
+- Add: WebXRImageTracking ability to directly add a tracked object to an image marker
+- Fix: OrbitControls should only update when being the active camera
+- Fix: UI input ignored browser "mouseDown" for each "touchUp" event
+- Fix: OrbitControls requiring additional tab after having clicked on UI
+- Fix: OrbitControls only being deactivated when down event starts on UI element
+- Fix: loading bar text not being decoded (displayed e.g. `%20` for a space)
+- Fix: TransformGizmo not working anymore
+
+## [3.2.15-alpha] - 2023-04-28
+- Add: SceneSwitcher.select(AssetReference) support to be invoked from a UnityEvent with an object reference (must be an asset)
+- USDZExporter: change exported usdz name, remove needle name for license holders
+
+## [3.2.14-alpha] - 2023-04-28
+- Add: OpenURL component
+- Change: Implictly add Raycaster to scene if it is not found.
+- Fix: USDZ export breaking if the object name is just a number 
+
+## [3.2.13-alpha] - 2023-04-27
+- Add: USDZExporter editor shows warning if no objects are assigned and exposes quicklook overlay texts
+- Add: USDZExporter callToActionButton can now invoke url to open
+- Add: SceneSwitcher can now use history without updating the url parameter
+- Fix: Fix vite html transform plugin
+
+## [3.2.12-alpha] - 2023-04-26
+- Fix: issue where removing an object from the scene would disable all its components
+
+## [3.2.11-alpha] - 2023-04-25
+- Fix: lighting settings being implictly switched (enabled/disabled) when using SyncCamera / any loaded prefab at runtime
+
+## [3.2.10-alpha] - 2023-04-25
+- Fix: Remove log in `Animator.SetTrigger`
+- Fix: GroundEnv radius property setting wrong value internally
+- Fix: Apply license to unnamed local vite chunk files
+
+## [3.2.9-alpha] - 2023-04-23
+- Fix: VideoPlayer not restarting when enable/disable being toggled
+- Fix: Builtin serializer for URLs `@serializable(URL)` should ignore empty strings
+- Change: set `enabled` to true before calling `onEnable`
+- Change: VideoPlayer now deferrs loading of the video until the video should play
+- Change: ScreenSharing component now changes cursor pointer on hover to indicate that is can be clicked
+
+## [3.2.8-alpha] - 2023-04-23
+- Add: this.context.getPointerUsed(index) and setPointerUsed(index)
+- Change: physics now by default receives collisions/triggers between two colliders that are set to trigger
+
+## [3.2.7-alpha] - 2023-04-22
+- Change: ambient light does now look closer to Unity ambient light
+- Fix: guard calls to component event methods when the component or object has been destroyed
+
+## [3.2.6-alpha] - 2023-04-21
+- Add: SceneSwitcher has now option to automatically set scene environment lighting
+- Fix: Issue caused by NeedleEngineHTMLElement import from SceneSwitcher
+- Change: Allow component to be disabled in awake (e.g. calling `this.enabled = false` in awake callback)
+- Change: Export more types e.g. AnimatorStateMachineBehaviour
+- Change: VolumeParameter.value should return rawValue (unprocessed)
+- Change: rename "rendererData" to "sceneLighting"
+- Change: scene lighting must now be enabled explictly when additional scene are being loaded, use `this.context.sceneLighting.enable(...)` with the AssetReference or sourceId of the scene you want to enable
+
+## [3.2.5-alpha.1] - 2023-04-20
+- Change: export more types
+
+## [3.2.5-alpha] - 2023-04-20
+- Add: WebXRPlaneTracking
+- Add: `<needle-engine loading-style="light">` for a brighter loading screen
+- Fix: InputField.onEndEdit should send string
+- Change: move webxr into subfolder
+- Change: export more types
+
+## [3.2.4-alpha.2] - 2023-04-20
+- Change: export more types
+
+## [3.2.4-alpha] - 2023-04-20
+- Change: export more types (e.g. `syncField`)
+- Fix: PlayerSync
+- Fix: Environment lighting
+- Fix: license check
+
+## [3.2.3-alpha] - 2023-04-20
+- Fix: VideoPlayer AudioOutput.None should mute video
+- Fix: SpriteRenderer applies layer from current object (e.g. for IgnoreRaycast)
+
+## [3.2.2-alpha] - 2023-04-19
+- Fix: issue where the environment lighting would be falsely disabled
+- Change: minor improvements to initial state of the SceneSwitcher
+
+## [3.2.1-alpha] - 2023-04-19
+- Change: SceneSwitcher clamp option
+- Change: timeline signals without bound receiver are now invoked globally on all active SignalReceivers with the specific signal asset
+- Change: internal check preventing errors during initialization for projects where the package is falsely added multiple times to the project by importing from internal types directly instead of `from "@needle-tools/engine"`
+
+## [3.2.0-alpha] - 2023-04-19
+- Add: built-in SceneSwitcher component
+- Change: VideoPlayer.playInBackground is set to true by default
+- Change: Screensharing should continue playback of receiving video when the sending tab becomes inactive
+- Change: log additional information when button events can not be resolved
+- Change: AudioSource.playInBackground set to true by default to allow audio playback when tab is not active
+- Change: syncField can now take function argument
+- Change: Renderer.sharedMaterials can now be iterated using `for(const mat of myRenderer.sharedMaterials)`
+- Fix: lightmap not being resolved anymore
+- Fix: environment lighting / reflection not switching with scenes
+- Fix: progressive texture did not check if the texture was disposed when switching to an unloaded scene resulting in textures being black/missing
+- Fix: timeline does enable animator again when pausing/stopping allowing to switch to e.g. idle animations controlled by an AnimatorController
+- Fix: changing material on renderer with lightmapping will now re-assign the lightmap to the new material
+
+## [3.1.0-alpha.2] - 2023-04-18
+- Fix: UI font style resolving
+
+## [3.1.0-alpha.1] - 2023-04-18
+- Fix: RemoteSkybox not being able to load locally reference dimage
+- Fix: ParticleSystem sphere scale not being applied anymore
+- Fix: WebXRImageTracking url not being resolved
+
+## [3.1.0-alpha] - 2023-04-18
+- Add: `ImageReference` type, use to export textures to external files and load them as `img`, `texture` or to get the binary data for e.g. image tracking
+- Add: api for `WebXRImageTracking`, this does currently require the ``webxr-incubations`` flag to be enabled
+- Add: TiltShift postprocessing effect
+- Add: AnimatorController support for negative speed
+- Change: ParticleSystem now has a reset method to allow for clearing state, stop has options for calling stop on Sub-Emitters and to clear already emitted particles
+
+## [3.0.1-alpha.5] - 2023-04-17
+- Add: `this.context.xrFrame` to get access to the current XRFrame from every lifecycle event method
+- Change: license check is now baked
+- Change: Rename "EngineElement" to NeedleEngineHTMLElement
+- Change: disable "Enable Keys" on OrbitControls by default as it conflicts with so many things
+- Fix: ParticleSystem circle shape
+- Fix: balloon messages are now truncated to 300 characters
+- Fix: Screensharing connection setup and start of video playback
+- Fix: Screensharing muting now local audio
+- Fix: AudioSource does not play again when it did finish and the user switches tabs
+- Fix: ParticleSystem prewarm
+- Fix: ParticleSystem minMax size, it's currently not supported and should thus not affect rendering
+
+## [3.0.1-alpha.4] - 2023-04-12
+- Bump with changed package.json
+
+## [3.0.1-alpha.3] - 2023-04-11
+- Fix: WebXR all layers should be visible
+- Fix: WebXRController raycast on all layers
+- Fix: issue with mouse vector position being re-used causing delta position being falsely modified
+- Change: store static Context.Current in globalThis
+- Change: alias resolve imports `@needle-tools/engine/engine` and `@needle-tools/engine/src` to lib folder
+
+## [3.0.0-alpha] - 2023-04-05
+- Add: vite alias plugin
+- Add: vite copyfiles plugin
+- Fix: lib sourcemap path
+- Fix: Postprocessing not being applied
+- Internal: needle vite plugin names now all start with "needle-"
+
+## [2.67.16] - 2023-04-13
+- Add: static ``AudioTrackHandler.dispose`` for disposing loaded audio data in timeline
+- Fix: issue where only the first audio clip would be played in a timeline with multiple audio clips of the same file
+- Change: Text should not change font name casing
+- Change: Timeline does now wait for audio and first interaction by default (if any audio track is being used, this can be disabled by setting `waitForAudio` to false on the PlayableDirector component)
+- Change: postprocessing DOF exposes resolution scale and takes device pixel density into account. By default the resolution is slightly lowered on mobile devices
+
+## [2.67.14-pre] - 2023-04-12
+- Change: WebXR camera now copies culling mask from main camera
+- Fix: WebXRController raycast on all layers
+- Fix: WebXR all layers should be visible
+- Fix: set pointer position properly on mouse down to prevent jumps in delta
+- Fix: respect IgnoreRaycast in physics raycasts
+- Fix: issue with CircularBuffer where sometimes the same item was returned twice
+- Fix: boxcolliders with scale 0 (such as adding a BoxCollider to a plane) resulted in flipped normals being returned from raycasts
+- Fix: parenthesis error in CharacterController
+- Fix: issue with mouse vector position being re-used causing delta position being falsely modified
+
+## [2.67.13-pre] - 2023-04-11
+- Fix: Animation component settings
+- Fix: instanced renderer matrix auto update
+- Change: enable shadow casting in instanced rendering when any mesh has castShadow enabled
+- Change: export ui pointer events
+
+## [2.67.12-pre] - 2023-04-09
+- Add: SSAO color and luminance influence options
+- Change: postprocessing now exposes effect order
+
+## [2.67.11-pre] - 2023-04-08
+- Add: some checks for WebGPURenderer
+
+## [2.67.10-pre] - 2023-04-06
+- Add vite copy files build plugin
+- Fix: PostProcessing not applying effects when enabled for the second time as well as removing earlier hack
+- Change: update user-select/touch-action in project templates style.css to prevent accidental iOS selection of canvas
+- Change: disable text selection on Needle logo
+- Bump three version, see changes below
+
+### Three
+- change USDZExporter: pass writer into onAfterHierarchy callback, move onAfterHierarchy callback after scene hierarchy write
+- fix USDZExporter: fix exception when trying to process render targets
+- fix WebXRManager: Correctly update the user camera when it has a parent with a non-identity transform.
+
+## [2.67.9-pre] - 2023-04-03
+- Change: SpriteRenderer material to transparent
+- Bump: tools package dependency
+
+## [2.67.8-pre.1] - 2023-03-31
+- Fix: exception when using BoxColliders caused by error in initial activeInHierarchy state assignment
+
+## [2.67.8-pre] - 2023-03-31
+- Fix: vite plugins must have a name
+- Fix: activeInHierarchy update when key is undefined (e.g. in r3f context)
+- Change: cleanup r3f component
+
+## [2.67.7-pre] - 2023-03-30
+- Add: time smoothed delta time
+- Add this.context.targetFrameRate
+- Fix: enum / type conversion errors
+- Fix: CanvasGroup overriding text `raycastTarget` state in event handling causing problems with button events
+- Fix: Text z-fighting from invisible ThreeMeshUI frame object
+- Change: Canvas `renderOnTop` moved into separate render call to avoid ordering issues and postprocessing affecting overlay UI
+- Internal: Move context from engine_setup to engine_context
+
+## [2.67.6-pre] - 2023-03-30
+- Fix: Postprocessing enforce effect order
+- Change: gizmos should not render depth
+
+## [2.67.5-pre] - 2023-03-30
+- Fix: issue where postprocessing did not check composer type (e.g. when using threejs composer instead of pmndrs package)
+- Change: Postprocessing now uses stencil layers
+
+## [2.67.4-pre] - 2023-03-28
+- Change: Postprocessing effects value mapping / settings improved (Bloom & ColorAdjustments)
+
+## [2.67.3-pre] - 2023-03-28
+- Fix: issue where progressive textures would not be applied correctly anymore
+- Fix: Timeline audio loading on firefox
+- Fix: issue where progressive textures with reflection probes wouldn't be applied correctly anymore
+
+## [2.67.2-pre] - 2023-03-28
+- Change: calculations for rect transform animation offsets
+- Change: Warn if engine element src contains a url without .glb or .gltf
+
+## [2.67.1-pre] - 2023-03-28
+- Fix: PostProcessing failing to be re-applied after exit XR
+
+## [2.67.0-pre] - 2023-03-27
+- Add: `this.gameObject.destroy` as a shorthand for `GameObject.destroy(this.gameObject)`
+- Add: support for camera `targetTexture` to render into a RenderTexture (when assigned to e.g. the main camera in Unity)
+- Add: utility methods to toplevel engine export (for example `getParam`, `delay`, `isMobileDevice`, `isQuest`)
+- Add: first version of usage tracking of materials, textures and meshes. This is off by default and can be enabled using the `?trackusage` url parameter. When enabled `findUsers` can be used to find users of an object.
+- Add: pmnders postprocessing package
+- Change: improved PlayerState component and added event for PlayerState events for owner change (to properly listen to first assignment)
+- Change: `AssetReference.unload` now calls dispose to free all resources
+- Change: `WebXR` component now has static field for modifying optionalFeatures 
+- Change: `Physics.RaycastOptions` now have a `setLayer` method to simplify setting the correct layer mask (similar to Unity's layers to enable e.g. just layer 4 for raycasting)
+- Change: `RemoteSkybox` now requests to re-apply clear flags on main camera when disabling to restore previous state.
+- Fix: issue where component instances were created using wrong method causing arrow functions to be bound to the wrong instance
+- Fix: `@syncField` now properly handles destroy of an component
+- Fix: react-three-fiber template
+- Fix: ParticleSystem prewarm safeguard and additional checks where emission is set to 0
+- Fix: Timeline only playing first audio clip
+- Fix: Issue where scene with multiple root glbs cross-referencing each other were not being resolved correctly in all cases
+- Fix: Progressive textures not being loaded when using tiling
+- Fix: Text UI anchoring
+
+## [2.66.1-pre] - 2023-03-16
+- Add: `sphereOverlapPhysics` function for more accurate sphere overlap detection using rapier
+- Fix: Gizmos should be excluded from being hit by raycasts
+- Fix: Gizmo sphere radius was twice the desired size
+- Fix: Physics now prevent negative collider scale
+- Fix: renderer instancing auto update when using multi material objects
+- Change: Show warning that stencil and instancing doesnt work together at the moment
+
+## [2.66.0-pre] - 2023-03-14
+- Add: particle system prewarm support
+- Add: `poseMatrix` argument in WebARSessionRoot.placedSession event
+- Add: MeshCollider minimal support for submeshes (they can be added but currently not removed from the physics world)
+- Fix: debug_overlay error when rejection reason is null
+- Fix typo beginListenBinrary → beginListenBinary
+- Fix: particle system staying visible after disabling gameObject
+- Fix particle system not finding subemitter in certain cases
+- Fix: particles with subemitters and trails and disabled "die with particle" should emit subemitter when the particle dies (and not when the trail dies)
+- Fix: Loading overlay now hides when loading is done and the first frame has finished rendering
+- Change: rename networking `stopListening` to `stopListen` for consistency
+- Change: addressables allow up to 10k instantiations per frame before aborting
+- Change: set material shadowSide to match side
+- Change: generate poster image with 1080x1080 px and add `og:image:width` and `og:image:height` meta tags
+
+## [2.65.2-pre] - 2023-03-11
+- Change: custom shaders should not log warning for unsupported ``OrthoParams`` shader property 
+- Change: Animator methods starting with uppercase are marked as deprecated because UnityEvent methods are now exported starting with lowercase letter, added lowercase methods
+
+## [2.65.1-pre] - 2023-03-10
+- Fix: ParticleSystem using `min/max` size in the renderer module is now minimally handled
+- Fix: ParticleSystem emission when using local space with scaled parents
+- Fix: ParticleSystem not finding SubEmitter systems
+- Fix: ParticleSystem simulation speed not being applied to gravity and initial speed
+- Fix: RemoteSkybox not resolving relative url correctly (when assigning a cubemap in the editor)
+
+## [2.65.0-pre.1] - 2023-03-10
+- Fix: issue where `<needle-engine>` element was not yet in the DOM when queried by exporter codegen which caused the paths to not be assigned and the engine to not load
+
+## [2.65.0-pre] - 2023-03-09
+- Add: runtime checks for recursive loading to prevent it from breaking
+- Change: internal duplicate active state on `Object3D` has been removed, instead `visible` is used. This was previously a workaround for the `Renderer` setting the visible state when being enabled or disabled but this has been changed in a previous version and it now only sets a flag in the object's Layers instead (which allows for a single object in the hierarchy to not being rendered by setting `Renderer.enabled = false` while objects in the child hierarchy stay visible) 
+- Change: `<needle-engine>` src attribute can now also take an array of glbs to load. This simplifies codegen done by exporters and also prevents errors due to bundler optimizations as well as being easier to understand. Runtime changes of the `src` attribute (especially when using arrays of files) have not been tested for this release. Networking for `src` changes has been removed in this release. 
+- Change: move engine into src subfolder. All paths to explicit script files are now `@needle-tools/engine/src/...`
+- Change: poster screenshot will be taken after 200ms now
+- Change: canvas default set to false for castShadow and receiveShadow
+- Change: Remote skybox should not set `scene.background` when in XR with pass through device (e.g. when using Quest Pro AR or AR on mobile)
+- Fix: issue where ColorAdjustments Volume effect was applied with `active` set to false
+- Fix: `Light` not being enabled again after disabling the component once
+
+## [2.64.0-pre] - 2023-03-07
+- Add: `PlayableDirector` now correctly applies timescale
+- Add: `PlayableDirector.speed` property allowing to play the timeline at different speeds or even reverse (reversed audio playback is not supported at the moment)
+- Add: `Physics.enabled` property for disabling physics updates. This also prevents any collider shapes to be created
+- Add: `this.gameObject.transform` property to ease getting started for devs coming from Unity. This property is merely a forward to `this.gameObject` and shouldnt really be used. The property description contains information and a [link to the docs](https://fwd.needle.tools/needle-engine/docs/transform) with further information.
+- Fix: instanced materials using progressive loading are now correctly updated
+- Fix: Timeline animation tracks now disable the `Animator`. This fixes cases where two animations were played at the same time. When the PlayableDirector is paused or stopped the animator state is reset
+- Fix: License styles leaking into website
+- Fix: Timeline audio not stopping correctly at end of timeline when set to hold
+- Change: improve instancing updates, instanced objects now auto update detect matrix changes. This includes improvements of instancing when used with `Animation` components
+- Change: set particle system layers to `IgnoreRaycast` to not receive wrong click events on batched particle meshes
+- Change: Timeline audio is now loaded on evaluation. Only clips in a range of 1 second to the current time are loading. To manually trigger preload of audio you can invoke `loadAudio` with a time range on audio tracks of a timeline
+
+## [2.63.3-pre] - 2023-03-03
+- Fix: engine published to npm was missing vite plugins
+
+## [2.63.2-pre] - 2023-03-03
+- Fix: license styling in some cases
+- Fix: duplicatable + draggable issue causing drag to not release the object (due to wrong event handling)
+- Fix duplicatable + deletion not working properly
+- Fix: timeline breaking when time is set to NaN
+
+## [2.63.1-pre] - 2023-03-02
+- Add: components now have `up` and `right` vectors (access via ``this.up`` from a component)
+- Fix: import of license and logo for npm package
+
+## [2.63.0-pre] - 2023-03-01
+- Add: licensing information
+- Add: logo to loading display
+- Change: VideoPlayer now exposes VideoMaterial
+- Change: Screencapture now only accepts clicks with pointerId 0 (left mouse button, first touch) to toggle screen capture
+- Change: expose physics gravity setting `this.context.physics.gravity`
+
+## [2.62.2-pre] - 2023-02-27
+- Add: support for `camera-controls` attribute on `<needle-engine>` element. When added it will automatically add an `OrbitControls` component on start if the active main camera has no controller (you can assign custom controllers by calling `setCameraController` with the camera that is being controlled)
+- Fix: rare error in extension_util
+- Fix: timeline preExtrapolation setting
+- Fix: disabling Light component should turn off light
+- Fix: animating camera fov, near or far plane
+- Fix: threejs layer patch for Renderer visibility is now always applied
+- Fix: UI runtime instantiate of canvas from templates in scene
+- Fix: UI text did not update shadow-component-owner on font loading
+- Fix: UI EventSystem raising click event multiple times in some cases
+- Fix: UI Text raycast now respects object layer (NoRaycast)
+- Fix: UI duplicate pointerUp event
+- Fix: UI highlighting getting stuck in wrong state sometimes
+
+## [2.62.1-pre] - 2023-02-23
+- Fix: pause wasn't evaluating and thus not pausing audio tracks
+- Fix: debug overlay styles were not properly scoped and affected objects inside needle-engine tag
+- Fix: Addressables wrong recursive instantiation error
+- Fix: UI not showing fully when setting active at runtime
+- Change: timeline tracks are now created immediately but their audio clips are deferred until audio is allowed
+
+## [2.62.0-pre] - 2023-02-13
+- Bump version
+
+## [2.61.0-pre] - 2023-01-30
+- Add: canvas applyRenderSettings
+- Add: progressive support for particle system textures
+
+## [2.60.4-pre] - 2023-01-27
+- Fix UI prefab instantiate throwing error at runtime
+- Change: show warning when unsupported canvas type is selected
+- Change: show warning when trying to use webxr features in non-secure context
+
+## [2.60.3-pre] - 2023-01-26
+- Fix: camera fov for blender export allowing fieldOfView property to be undefined, where the fov should be handled by the blender exporter completely.
+
+## [2.60.2-pre] - 2023-01-26
+- Fix: particle textures being flipped horizontally
+
+## [2.60.1-pre] - 2023-01-25
+- Change: export Mathf in `@needle.tools/engine`
+
+## [2.60.0-pre] - 2023-01-25
+- Add: Particles support for horizontal and vertical billboards
+- Add: Timeline now supports reversed clip (for blender timeline)
+- Change: bump gltf pipeline package dependency adding support for global `NEEDLE_TOKTX` environment variable
+- Change: timeline clip pos and rot are now optional (for blender timeline)
+- Fix: when first loading a gltf pass guidsmap to components (for blender timeline)
+- Fix: scrubbing TimelineTrack scrubs audio sources as well now
+- Fix: stencils for multimaterial objects
+
+## [2.59.2-pre] - 2023-01-21
+- Add: particles basic support for on birth and ondeath subemitter behaviour
+
+## [2.59.1-pre.1] - 2023-01-20
+- Fix: issue where click on overlay html element did also trigger events in the underlying engine scene  
+
+## [2.59.1-pre] - 2023-01-20
+- Add: SpectatorCam.useKeys to allow users to disable spectator cam keyboard input usage (`f` to send follow request to connected users and `esc` to stop following)
+- Change: expose SyncedRoom.RoomPrefix
+
+## [2.59.0-pre] - 2023-01-18
+- Add: AssetReference.unload does now dispose materials and mesh geometry
+- Add: ``setParamWithoutReload`` now accepts null as paramValue which will remove the query parameter from the url
+- Change: timeline does now skip export for muted tracks
+- Change: OrbitControls can now use a custom html target when added via script and before enable/awake is being called (e.g. ``const orbit = GameObject.addNewComponent(this.gameObject, OrbitControls, false); orbit.targetElement = myElement``)
+- Change: Input start events are now being ignored if a html element is ontop of the canvas
+- Fix: use custom element registry to avoid error with `needle-engine element has already been defined`
+- Fix: timeline not stopping audio on stop
+- Fix: input click event being invoked twice in certain cases
+- Fix: ParticleSystem start color from gradient
+- Fix: ParticleSystem not properly cleaning up / removing particles in the scene in onDestroy
+- Fix: ParticleSystem velocity now respects scale (when mode is set to worldscale)
+
+## [2.58.4-pre] - 2023-01-14
+- Update gltf-extensions package dependency
+
+## [2.58.3-pre] - 2023-01-13
+- Bump version
+
+## [2.58.2-pre] - 2023-01-12
+- Change: use draco and ktx loader from gstatic server by default
+- Change: reduce circular dependencies
+- Fix: Reflectionprobe selecting wrong probe when multiple probes had the exact same position
+
+## [2.58.1-pre] - 2023-01-09
+- Add: Prewarm rendering of newly loaded objects to remove lag/jitter when they become visible for the first time
+- Change: renderer now warns when sharedMaterials have missing entries. It then tries to remap those values when accessing them by index (e.g. when another component has a material index serialized and relies on that index to be pointing to the correct object)
+
+## [2.58.0-pre] - 2023-01-09
+- Add: EventSystem input events (e.g. IPointerClick) are now invoked for all buttons (e.g. right click)
+- Add: Hot reload for components
+
+## [2.57.0-pre] - 2023-01-07
+- Remove: Meshline dependency
+- Fix: Testrunner Rigidbody import error
+
+## [2.56.2-pre] - 2023-01-06
+- Change: Component.addEventListener argument can now derive from Event
+
+## [2.56.1-pre] - 2023-01-05
+- Fix: UI setting Image.sprite property did apply vertical flip every time the sprite was set
+
+## [2.56.0-pre] - 2023-01-04
+- Add: file-dropped event to DropListener
+- Add: UI image and raw image components now support updating texture/sprite at runtime
+- Change: Bump needle gltf-transform extensions package adding mesh compression and caching for texture compression leading to significant speedups for subsequent production builds (only changed textures are re-processed)
+- Fix: light normal bias defaults
+
+## [2.55.2-pre] - 2023-01-02
+- Add: Rigidbody.gravityScale property
+- Add: Gizmos.DrawArrow method
+- Add: Rigidbody.getAngularVelocity method
+- Fix: Mesh collider center of mass
+
+## [2.55.1-pre] - 2022-12-30
+- Add: Warning when serialized component field name is starting with uppercase letter
+- Change: bump component compiler dependency
+- Fix: Particle rotation over lifetime
+- Fix: Particles should not emit when emission module is disabled
+- Fix: LODGroup breaking rendering when used with multi-material objects or added on mesh to be culled directly
+
+## [2.55.0-pre] - 2022-12-21
+- Add: PhysicsMaterial support
+- Add: ``Time.timesScale`` factor
+- Change: VideoPlayer exposes underlying HTML video element
+- Change: EffectComposer check if ``setPixelRatio`` method exists before calling
+- Change: WebARSessionRoot and Rig rotation
+- Fix: WebXRController raycast line not being visible in Quest AR
+- Fix: Renderer that is disabled initially now hides object
+- Fix: Some ParticleSystem worldspace settings when calling emit directly
+
+## [2.54.2-pre] - 2022-12-19
+- Change: debug parameter can now take ``=0`` for disabling them (e.g. ``freecam=0``)
+- Fix: InputField opens keyboard on iOS
+
+## [2.54.1-pre] - 2022-12-15
+- Fix: issue with progressive loading, loading files multiple times if a texture was used in multiple materials/material slots. This was causing problems and sometimes crashes on mobile devices 
+- Fix: balloon messages using cached containers didnt update the message sometimes and displaying an old message instead
+
+## [2.54.0-pre.1] - 2022-12-14
+- Fix: bump gltf extensions package fixing issue with progressive texture loading when multiple textures had the same name 
+
+## [2.54.0-pre] - 2022-12-14
+- Add: start and end events for progressive loading
+- Add: USDZExporter events for button creation and after export
+- Change: apply WebARSessionRoot scale to exported object, e.g. if scene is scaled down on Android it should receive the same scale when exporting for Quicklook
+- Fix: process reflection probe update in update event to avoid visible flickr after component enabled state has changed
+
+## [2.53.1-pre.1] - 2022-12-12
+- Fix: implement ButtonColors
+
+## [2.53.1-pre] - 2022-12-12
+- Add: GroundProjection appyOnAwake to make it possible to just use it when the environment changes via remote skybox and not apply it to the default skybox
+- Change: more strict tsconfig
+- Change: allow overriding loading element
+- Fix: apply shape module rotation to direction
+- Fix: ParticleSystem world position not being set when shape module was disabled
+
+## [2.53.0-pre] - 2022-12-08
+- Add: InstantiateIdProvider constructor can now take string too for initializing seed
+- Add: USDZExpoter component enabling ``Open in Quicklook`` option by default when running on iOS Safari
+- Fix: Light intensity
+- Fix: Add workaround texture image encoding issue: https://github.com/needle-tools/needle-engine-support/issues/109
+- Fix: OrbitControls.enableKeys
+- Fix: Remove warning message about missing ``serializable`` when the reference is really missing
+- Fix: ``context.domX`` and ``domY`` using wrong values when in AR mode
+
+## [2.52.0-pre] - 2022-12-05
+- Add iOS platform util methods
+- Add ``?debugrig`` to render XRRig gizmo
+- Add support for Spritesheet Animation
+- Add: EventTrigger implementations for onPointerClick, onPointerEnter, onPointerExit, onPointerDown, onPointerUp
+- Add: RemoteSkybox environmentBlurriness setting
+- Fix: Renderer reflection probe event order issue not applying reflection probes when enabling/disabling object because reflection probes have not been enabled
+- Fix: remove log in ParticleSystemModules
+
+## [2.51.0-pre] - 2022-11-30
+- Change: remove nebula, dat.gui and symlink package dependencies
+- Change: Light does not change renderer shadowtype anymore
+- Change: update threejs to 146
+- Change: update threejs types
+- Change: Screencapture should not start on click when not connected to networked room
+- Change: WebXR returns ar supported when using Mozilla WebXR
+- Fix DragControls drag interaction not disabling OrbitControls at right time
+- Fix physics collider position in certain cases
+- Fix Rigidbody not syncing physics position when parent transform changes
+- Fix Timeline awake / active and enable
+- Fix: OrbitControls calulcating target position with middle mouse click in worldspace instead of localspace causing wrong movement when parent is transformed
+- Fix: Raycast in Mozilla WebXR / using window sizes instead of dom element sizes
+- Fix input with scrolled window
+- Fix: destroy local avatar on end of webxr session (https://github.com/needle-tools/needle-engine-support/issues/117)
+- Fix: WebXRAvatar setting correct XRFlags
+
+## [2.50.0-pre] - 2022-11-28
+- Add warning to Light when soft shadows change renderer shadow type
+- Add: RemoteSkybox can now load jpg and png textures as skybox
+- Change: Instantiate does now copy Vector, Quaternion and Euler objects to ensure multiple components dont share the same objects
+- Fix: AnimatorController causes threejs error when creating empty animationclip (Blender) 
+- Fix: AnimatorController error when transition has no conditions array (Blender)
+
+## [2.49.1-pre] - 2022-11-25
+- Add circular instantiation check to AssetReference
+- Allow filtering ``context.input.foreachPointerId()`` by pointer types (e.g. mouse or touch)
+- Fix typescript error in particle system module function (happened only when ``strict`` was set to false in tsconfig)
+- Fix XRFlag component not being applied on startup
+
+## [2.49.0-pre] - 2022-11-24
+- Add: input iterator methods to loop over currently active input pointer ids
+- Change: input refactor to work better with touch
+- Fix GraphicRaycaster serialization warning
+- Fix deserialization bug when Animation clips array is not serialized (exported from blender)
+- Fix: remove leftover log in AnimatorController when cloning
+- Fix XR flag not correctly restoring state
+- Fix reticle not being rendered when XRRig is inside WebARSessionRoot
+- Fix Mozilla XR AR overlay (https://github.com/needle-tools/needle-engine-support/issues/81)
+- Fix Mozilla XR removing renderer canvas on exit AR (https://github.com/needle-tools/needle-engine-support/issues/115)
+
+## [2.48.0-pre] - 2022-11-23
+- Add: debug console for better mobile debugging (shows up on error on mobile in local dev environment or when using the ``?console`` query parameter)
+- Add: dom element visibility checks and suspend rendering and update loops (if ``this.context.runInBackground`` is false)
+- Add: ``this.context.isPaused`` to manually suspend rendering
+- Add: ``IComponent.onPausedChanged`` event method which is called when rendering is paused or resumed
+- Change: update copy-from-to dev dependency version to fix build error when path contains ``(``
+- Change: ``this.context.input`` does now support pointer lock state (properly reports delta)
+- Fix: make sure VRButton has the same logic as in three again (regex instead of try-catch)
+- Fix: WebXRViewer DOM Overlay bugs when dom overlay element is inside canvas
+- Fix: exitAR not being called in some cases when exiting AR
+- Fix: ``this.context.domX`` and ``this.context.domY`` when web component is not fullscreen
+
+## [2.47.0-pre] - 2022-11-17
+- Add: Initial react three fiber components
+- Change: OrbitControls made lerp stop distance smaller 
+- Change: expose ``*enumerateActions()`` in AnimatorController
+- Fix: Flipped custom reflection texture
+- Fix: Volume exposure not being applied when no Tonemapping effect was set
+- Fix: Volume tonemapping not respecting override state setting
+- Fix: ``AudioSource.loop`` not working
+- Fix: Collider center being not not applied correctly
+- Fix: MeshCollider scale not being applied from object
+
+## [2.46.0-pre] - 2022-11-16
+- Add: Particles subemitter support
+- Add: Particles inherit velocity support
+- Add: Particles size by speed support
+- Add: Particles color by speed support
+- Add: Particles trail now fadeout properly when "die with particle" is disabled
+- Add: Particles circle shape
+- Change: button hover now sets cursor to pointer
+- Fix: WebXR controller disabling raycast line for hands
+- Fix: WebXR hands path when not assigned in Unity
+- Fix: Mesh Particles not rendering because of rotation being wrongly applied
+- Fix: Mesh particles size in AR
+- Fix: Particles color and size lerp between two curves
+
+## [2.45.0-pre] - 2022-11-14
+- Add: RemoteSkybox option to control if its set as background and/or environment
+- Add: @serializable decorator, @serializeable will be removed in a future version
+- Add: getComponent etc methods to IGameObject interface
+- Add: Renderer.enable does now set visible state only without affecting the hierarchy or component active state
+- Change: Expose Typestore
+- Change: Animation componet does loop by default (use the AdditionalAnimationData component to set the default loop setting)
+- Fix: WebXR relative hands path in subfolders
+- Fix: Rigidbody did not properly detect object position change if the position change was applied a second time at the exact same target position (it worked setting it once and didnt work in subsequent calls - now it does always detect it)
+
+## [2.44.1-pre] - 2022-11-13
+- Add: RemoteSkybox exposes ``background`` and ``environmnet`` properties to configure if the loaded skybox is set for the scene background and/or the environment light
+- Change: Expose TypeStore
+
+## [2.44.0-pre] - 2022-11-11
+- Add: Particles limit velocity over time
+- Add: Particles rotation by speed
+- Add: ParticleSystem play, pause, stop and emit(count) methods
+- Add: ``WebXR.showRaycastLine`` exposed so it can be disabled from code
+- Fix: issues in applying some forces/values for different scaling and worldspace <> localspace scenarios
+- Change: raise input events in core method to also allow receiving WebAR mock touch events
+- Change: ``Animation.play()`` does not require argument anymore
+
+## [2.43.0-pre] - 2022-11-10
+- Add: particles emission over distance
+- Add: particles can enable trail (settings are not yet applied tho) 
+- Add: camera now useses culling mask settings
+- Add: particle VelocityOverLife
+- Add: particle basic texture sheet animation support
+- Change: ensure ``time.deltaTime`` is always > 0 and nevery exactly 0
+- Fix: progressbar handle progress event not reporting total file size
+- Fix: layer on camera did affect visibility
+- Fix: cloning animatorcontrollers in builds did fail because of legacy AnimatorAction name check
+- Fix: ``RGBAColor.lerpColors`` did produce wrong alpha value
+- Fix: custom shader ``_ZTest`` value is now applied as threejs depthTest function
+
+## [2.42.0-pre] - 2022-11-09
+- add ``Graphics.copyTexture``
+- add ``Renderer.allowProgressiveLoad``
+- add ``Gizmos.DrawBox`` and ``DrawBox3``
+- add particles burst emission
+- add particles color interpolation between two gradients
+- fix: reflection probe material caching for when material is being changed at certain times outside of animation loop and cache applied wrong material
+- fix: AnimationCurve evaluation when time and keyframe are both exactly 0
+- change: reflection probe now requires anchor override
+- change: bump threejs dependency 
+
+## [2.41.0-pre] - 2022-11-07
+- Add: start adding particle systems support again
+- Change: update dependency version to needle gltf-transform-extensions package
+- Change: light set to soft shadows now changes renderer shadow mode to ``VSMShadowMap`` (can be disabled by setting ``Light.allowChangingShadowMapType`` to false)
+- Fix: WebXR creating AR button when called from script in awake 
+- Fix: ``AnimationCurve.evaluate``
+
+## [2.40.0-pre] - 2022-11-05
+- Add support for deleting all room state by calling ``context.connection.sendDeleteRemoteStateAll()`` (requires backend to update ``@needle-tools/needle-tiny-networking-ws`` to ``^1.1.0-pre``)
+- Add Hinge joint
+- Add ``Gizmos.DrawLine``, ``DrawRay`` ``DrawWireSphere`` and ``DrawSphere``
+- Add: physics Collision Contacts now contain information about ``impulse`` and ``friction``
+- Add ``physics.raycastPhysicsFast`` as a first method to raycast against physics colliders, the returning object contains the point in worldspace and the collider. This is the most simplest and thus fastest way to raycast using Rapier. More complex options will follow in future versions.
+- Fix joint matrix calculation
+- Fix and improve physics Contacts point calculations  
+- Fix issue in physics event callbacks where ``onCollisionStay`` and ``onCollisionExit`` would only be called when ``onCollisionEnter`` was defined
+
+## [2.39.0-pre] - 2022-11-04
+- Add: physics FixedJoint
+- Change: CharacterController now rotates with camera
+- Change: scaled mesh colliders are now cached
+- Change: disable OrbitControls when in XR
+- Change: first enabled camera component sets itself as rendering camera if no camera is yet assigned (mainCamera still overrides that)
+- Change: package module field now shows to ``src/needle-engine``
+- Change: ``Camera.backgroundColor`` assigning Color without alpha sets alpha to 1 now
+- Fix: improved missing ``serializable`` detection / warning: now only shows warning for members actually declared in script 
+- Fix: wrong light intensity in VR when light is child of WebARSessionRoot [issue 103](https://github.com/needle-tools/needle-engine-support/issues/103) 
+
+## [2.38.0-pre] - 2022-11-02
+- Add ``context.isInAR`` and ``context.isInVR`` properties
+- Add physics capsule collider support
+- Add basic character controller implementation (experimental)
+- Add ``context.input.getMouseWheelDeltaY()``
+- Add: SmoothFollow option to restrict following on certain axes only for position
+- Add: ``Rigidbody.teleport`` method to properly reset internal state
+- Add: load glbs using build hash (appended as ``?v=123``)
+- Change: Collision event args now exposes contacts array
+- Fix Exit AR (X) button not showing up
+- Fix physics collider center offset
+- Fix removing colliders and rigidbodies throwing error (when trying to access properties for already removed bodies)
+- Fix bug in AnimatorController causing broken animations when the same clip is used in multiple states (caused by ``mixer.uncacheCip``)
+- Fix rigidbody friction allowing for physical bodies being transported on e.g. platforms
+- Fix ``onTriggerStay`` being invoked with the correct collider argument
+- Fix AnimatorController exit time not being used properly
+- Fix AnimatorController not checking all possible transitions if one transition did match conditions but could not be made due to exit time setting
+- Fix ``Renderer.sharedMaterials`` not handling SkinnedMeshRenderer
+- Fix environment blend mode for mozilla XR browser on iOS
+- Fix: Camera now removing self from being set as currently rendering in ``onDisable``
+
+## [2.37.0-pre] - 2022-10-28
+- Add: rapier physics backend and overall improved physics system like constraint support, fixed physics collider updates and synchronization between rendering and physics world or animation of physical bodies 
+- Remove: cannon-es
+- Add basic mesh collider support
+- Add ``@validate`` decorator and ``onValidate`` event method that can be used to automatically get callbacks when marked properties are being written to (for example internally this is used on the Rigidbody to update the physics body when values on the Rigidbody component are being updated)
+- Change: assign nested gltf layers
+- Change: reworked Rigidbody api
+- Fix: allow Draco and KRTX compression on custom hand models
+- Fix: applying Unity layers to threejs objects
+- Fix: BoxHelper stopped working with SpatialTrigger
+- Fix: AR reticle showing up in wrong position with transformed WebARSessionRoot
+
+## [2.36.0-pre] - 2022-10-26
+- Add: Expose WebXR hand model path
+- Add: Animation component can now be configured with random time scale and offset
+- Change: allow blocking overlay errors using the ``?noerrors`` query parameter
+- Change: don't use Composer for postprocessing in XR (see [issue](https://github.com/needle-tools/needle-engine-support/issues/101)) 
+- Change: physics intersections causing NaN's are now reported prominently and physics bodies are removed from physics world as an interim solution, this provides more information about problematic colliders for debugging
+- Fix: bug that caused component events for onEnable and onDisable not being called anymore in some cases
+- Fix: cases where loading overlay using old project template wouldnt be removed/hidden anymore
+- Fix: WebXR hide large hand grab sphere
+- Fix: onPointerUp event not firing using WebXR controllers when grabbing an object for the second time
+- Fix: GroundProjection can now be removed again
+- Fix: Custom shaders exported using builtin RP can now use  _Time property
+- Fix: Only create two controllers when in AR on oculus browser
+- Fix: BoxHelperComponent can now handle multi-material objects (groups) 
+
+## [2.35.6-pre] - 2022-10-24
+- Add: warning balloon when unknown components are detected and have been most likely forgot to be installed, linking to npmdef docs 
+- Fix: dont show serialization warning for builtin components where specific fields are not deserialized on purpose (since right now the serializer does not check which fields are actually implemented) 
+
+## [2.35.5-pre] - 2022-10-24
+- Change: AudioSource exposes ``clip`` field
+- Change: improve error and messaging overlay
+- Change: detect when serialized Object3D and AssetReference are missing ``@serializable`` attribute and show message in overlay
+- Change: add WebXR hands path to controllers
+- Fix: WebXR controllers now use interactable object when grabbing (instead of hit object previously) which fixes interaction with nested hierarchies in XR and DragControls
+
+## [2.35.4-pre] - 2022-10-23
+- Change: Renderer ``material`` is now ``sharedMaterial`` to make it more clear for Unity devs that the material is not being cloned when accessed
+- Fix: When not specifying any explicit networking backend for glitch deployment it now falls back to the current glitch instance for networking
+
+## [2.35.3-pre] - 2022-10-21
+- Add: Screenshare component ``share`` method now takes optional options to configure device and MediaStreamConstraints for starting the stream 
+- Fix: WebXR should show EnterVR button when enabled in Unity
+- Fix: component ``enable`` boolean wasnt correctly initialized when loaded from gltf
+- Fix: Object3D prototype extensions weren't correctly applied anymore
+- Fix: Interaction bug when using DragControls with OrbitControls with multitouch
+
+## [2.35.2-pre] - 2022-10-20
+- Add ``Renderer.mesh`` getter property
+- Change: ``Renderer.material`` now returns first entry in ``sharedMaterials`` array so it automatically works in cases where a Renderer is actually a multi-material object
+- Change: warn when trying to access components using string name instead of type
+- Change: update needle gltf-transform-extensions to 0.6.2
+- Fix: remove log from UIRaycastUtil
+- Fix: move TypeStore import in builtin engine again to not break cases where ``import @needle-engine`` was never used
+- Fix: React3Fiber template and AR overlay container access when using react
+
+## [2.35.1-pre] - 2022-10-19
+- Change: unify component access methods, first argument is now always the object with the component type as second argument
+- Fix physics collision events throwing caused by refactoring in last version
+- Fix loading screen css
+
+## [2.35.0-pre] - 2022-10-19
+- Change: First pass of reducing circular dependencies
+- Change: Update @needle-tools/gltf-transform-extensions version
+- Change: Update component compiler to 1.9.0. Changed include:
+   * Private and protected methods will now not be emitted anymore
+   * ``onEnable/onDisable`` will be emitted as ``OnEnable`` and ``OnDisable`` [issue 93](https://github.com/needle-tools/needle-engine-support/issues/93)
+- Change: handle Vector3 prototype extensions
+- Fix: issue with UI causing rendering to break when enabling text components during runtime that have not yet been active before
+- Fix: OrbitControls LookAtConstraint reference deserialization
+- Fix: WebXRController raycasting against UI marked as ``noRaycastTarget`` or in CanvasGroup with disabled ``interactable`` or ``blocksRaycast``
+
+## [2.34.0-pre] - 2022-10-17
+- Add: start adding support for 2D video overlay mode
+- Change: Install threejs from @needle-tools/npm - this removes the requirement to have git installed and should fix a case where pulling the package from github would fail 
+- Change: Move Screensharing aspect mode settings into VideoPlayer component
+- Change: Move ``InstancingUtils`` into ``engine/engine_instancing.ts``
+- Change: BoxCollider now checks if ``attachedRigidBody`` is assigned at start
+- Change: Collision now exposes internal cannon data via ``__internalCollision`` property
+- Fix: EventSystem now properly unsubscribes WebXRController events
+
+## [2.33.0-pre] - 2022-10-17
+- Add: ScreenCapture has mode for capturing webgl canvas (unfortunately it doesnt seem to work well in Chrome or Firefox yet)
+- Change: move threejs prototype extensions into own file and make available to vanilla js builds
+- Change: ScreenCapture component has explicit VideoPlayer component reference
+- Fix: animating properties on custom shaders
+
+## [2.32.0-pre] - 2022-10-15
+- Add: start implementing trigger callbacks for ``onTriggerEnter``, ``onTriggerExit`` and ``onTriggerStay``
+- Change: ``GameObject.setActive`` now updates ``isActiveAndEnabled`` state and executes ``awake`` and ``onEnable`` calls when the object was activated for the first time (e.g. when instantiating from an previously inactive prefab)
+- Change: improve collision callback events for components (``onCollisionEnter``, ``onCollisionExit`` and ``onCollisionStay``)
+- Change: this.context.input keycode enums are now strings
+- Fix: local dev error overlay now also displays errors that happen before web component is completely loaded (e.g. when script has import error)
+- Fix: Rigidbody force is now correctly applied when the component was just instantiated (from inactive prefab) and added to the physics world for the first time
+- Fix: DragControls component keyboard events ("space" and "d" for modifying height and rotation)
+
+## [2.31.1-pre] - 2022-10-14
+- Change: Rigidbody now tracks position changes to detect when to update/override simulated physics body
+- Fix: loading relative font paths when exported via Asset context menu
+
+## [2.31.0-pre] - 2022-10-13
+- Add: inital ScreenCapture component for sharing screens and camera streams across all connected users
+- Add: ``onCollisionEnter``, ``onCollisionStay`` and ``onCollisionExit`` event methods to components
+
+## [2.30.0-pre] - 2022-10-12
+- Add: Quest 2 passthrough support
+- Add: UI Graphic components now support ``raycastTarget`` again
+- Add: VideoPlayer now supports ``materialTarget`` option which allows for assigning any renderer in the scene that should be used as a video canvas
+- Changed: updated three-mesh-ui dependency version
+- Changed: updated needle-gltfTransform extensions package, fixing an issue with passthrough of texture json pointers
+- Changed: selecting SpectatorCam now requires click (instead of just listening to pointer up event)
+- Fix: Avatars using instanced materials should now update transforms correctly again
+
+## [2.29.0-pre] - 2022-10-10
+- Add: Context.removeCamera method
+- Add: SpectatorCam allows to follow other users across devices by clicking on respective avatar (e.g. clicking SyncedCam avatar or WebXR avatar, ESC or long press to stop spectating)
+- Add: ``Input`` events for pointerdown, pointerup, pointermove and keydown, keyup, keypress. Subscribe via ``this.context.input.addEventListener(InputEvents.pointerdown, evt => {...})`` 
+- Change: Default WebXR rig matches Unity forward
+- Fix: WebXRController raycast line being rendered as huge line before first world hit
+- Fix: SpectatorCam works again
+- Fix: ``serializable()`` does now not write undefined values if serialize data is undefined
+- Fix: exit VR lighting
+
+## [2.28.0-pre] - 2022-10-06
+- Add: ``resolutionScaleFactor`` to context
+- Fix ``IsLocalNetwork`` regex
+- Fix custom shaders failing to render caused by json pointer change
+- Change: rename Context ``AROverlayElement`` to ``arOverlayElement``
+
+## [2.27.0-pre] - 2022-10-06
+- Fix: EventList failing to find target when targeting a Object3D without any components
+- Fix: text now showing up when disabling and enabling again after the underlying three-mesh-ui components have been created
+- Fix: Builtin sprites not rendering correctly in production builds
+- Change: Bump needle glTF transform extensions version
+- Change: json pointers now have correct format (e.g. ``/textures/0`` instead ``textures/0``)
+- Change: Bump UnityGLTF version
+
+## [2.26.1-pre] - 2022-10-05
+- Fix animating ``activeSelf`` on GameObject in canvas hierarchy
+- Fix SpectatorCam component
+- Fix WebXRController raycast line being rendered as huge line before first world hit
+
+## [2.26.0-pre] - 2022-10-05
+- Add: experimental AlignmentConstraint and OffsetConstraint
+- Remove: MeshCollider script since it is not supported yet
+- Change: Camera does now use XRSession environment blend mode to determine if background should be transparent or not.
+- Change: WebXR exposes ``IsInVR`` and ``IsInAR``
+- Fix: RGBAColor copy alpha fix
+- Fix: Avatar mouth shapes in networked environment
+
+## [2.25.1-pre] - 2022-10-04
+- Change: DropListener file drop event does send whole gltf instead of just the scene
+
+## [2.25.0-pre] - 2022-10-04
+- Add: allow overriding draco and ktx2 decoders on <needle-engine> web component by setting ``dracoDecoderPath``, ``dracoDecoderType``, ``ktx2DecoderPath`` 
+- Add: ``loadstart`` and ``progress`` events to <needle-engine> web component
+- Fix rare timeline animation bug where position and rotation of objects would be falsely applied
+- Change: update to three v245
+- Change: export ``THREE`` to global scope for bundled version
+
+## [2.24.0-pre] - 2022-10-01
+- Add: make engine code easily accessible from vanilla javascript
+- Fix: handle number animation setting component enable where values are interpolated
+- Change: Remove internal shadow bias multiplication
+- Change: Addressable references are now resolved using relative paths
+- Change: Update package json
+
+## [2.23.2-pre] - 2022-09-29
+- Add: Light component shadow settings can not be set/updated at runtime
+- Fix: enter XR using GroundProjectedEnv component
+- Fix: Light shadows missing when LightShadowData component was not added in Unity (was using wrong shadowResolution)
+- Change: dont allow raycasting by default on GroundProjectedEnv sphere
+
+## [2.23.1-pre] - 2022-09-29
+- Add: Light exposes shadow resolution
+
+## [2.23.0-pre] - 2022-09-28
+- Add RemoteSkybox component to use HDRi images from e.g. polyhaven
+- Add GroundProjectedEnv component to use threejs skybox projection 
+- Fix: export ``GameObject`` in ``@needle-tools/engine``
+
+## [2.22.1-pre] - 2022-09-28
+- Add: ``noerrors`` url parameter to hide overlay
+- Fix: WebXR avatar rendering may be visually offset due to root transform. Will now reset root transform to identity
+
+## [2.22.0-pre] - 2022-09-28
+- Add: ``@needle-tools/engine`` now exports all components
+- Add: environment light from tricolor (used for envlight when set to custom but without custom cubemap assigned)
+- Add: show console error on screen for localhost / local dev environment
+- Fix: create environment lighting textures from exported colors
+- Change: UI InputField expose text
+- Change: Bump threejs version to latest (> r144) which also contains USDZExporter PR
+
+## [2.21.0-pre] - 2022-09-26
+- Add: custom shader set ``_ScreenParams``
+- Change: DropListener event ``details`` now contains whole gltf file (instead of just scene object)
+
+## [2.20.1-pre] - 2022-09-23
+- Add: AudioSource volume and spatial blending settings can now be set at runtime
+- Fix: AudioSource not playing on ``play`` when ``playOnAwake`` is false
+
+## [2.20.0-pre] - 2022-09-23
+- Add: VideoPlayer crossorigin attribute support
+- Add: ``debuginstancing`` url parameter flag
+- Add: Image handle builtin ``Background`` sprite
+- Add: Component now implements EventTargt so you can use ``addEventListener`` etc on every component
+- Add: EventList does automatically dispatch event with same name on component. E.g. UnityEvent named ``onClick`` will be dispatched on component as ``on-click``
+- Add: experimental progressive loading of textures
+- Add: ``WebXR`` exposes ``IsARSupported`` and ``IsVRSupported``
+- Fix: remove Ambient Intensity
+- Fix: ShadowCatcher material should not write depth
+
+## [2.19.1-pre] - 2022-09-21
+- Fix: SpatialTrigger intersection check when it's not a mesh
+- Fix: UnityEvent / EventList argument of ``0`` not being passed to the receiving method
+- Fix: Physics rigidbody/collider instantiate calls
+- Fix: Physics rigidbody transform changes will now be applied to internal physics body 
+- Fix: ``needle-engine.getContext`` now listens to loading finished event namely ``loadfinished``
+- Change: cleanup some old code in Rigidbody component
+
+## [2.19.0-pre] - 2022-09-20
+- Add: initial support for ``InputField`` UI (rendering, input handling on desktop, mobile and AR, change and endedit events)
+- Add: ``EventList.invoke`` can now handle an arbitrary number of arguments
+- Change: lower double click threshold to 200ms instead of 500ms
+- Change: runtime font-style does not change font being used in this version. This will temporarely break rich text support.
+- Fix: custom shader regression where multiple objects using the same material were not rendered correctly
+- Fix: Text sometimes using invalid path
+- Fix: Remove unused imports
+
+## [2.18.0-pre] - 2022-09-20
+- Add basic support for ``CameraDepth`` and ``OpaqueTexture`` (the opaque texture still contains transparent textures in this first version) being used in custom shaders
+
+## [2.17.1-pre] - 2022-09-17
+- Improve Animator root motion blending
+- Fix SpatialTrigger error when adding both SpatialTrigger as well as SpatialTrigger receiver components to the same object
+- AnimatorController can now handle states with empty motion or missing clips
+
+## [2.17.0-pre] - 2022-09-15
+- Add: automatic runtime font atlas generation from Unity font assets 
+- Remove: shipped font assets in ``include/fonts``
+- Fix: Physics pass custom vector into ``getWorldPosition``, internal vector buffer size increased to 100
+- Fix: SpatialTrigger and SpatialTrigger receivers didnt work anymore due to LayerMask serialization
+
+## [2.16.1-pre] - 2022-09-14
+- Change: UI disable shadow receiving and casting by default, can be configured via Canvas
+- Fix: ``gameObject.getComponentInParent`` was making false call to ``getComponentsInParent`` and returning an array instead of a single object
+- Fix: light intensity in AR
+
+## [2.16.0-pre] - 2022-09-14
+- Add: first draft of Animator root motion support
+- Fix: ``Renderer.sharedMaterials`` assignment bug when GameObject was mesh
+- Fix: Buttons set to color transition did not apply transition colors
+- Fix: UI textures being flipped
+- Fix: UI textures were not stretched across panel but instead being clipped if the aspect ratio didnt match perfectly
+
+## [2.15.0-pre] - 2022-09-12
+- Add stencil support to ``Renderer``
+- Add timeline ``removeTrackOffset`` support
+- Fix timeline animation track offset only being applied to root
+- Fix timeline clip offsets not being applied when no track for e.g. rotation or translation exists
+
+## [2.14.0-pre] - 2022-09-11
+- Add initial UI anchoring support
+- Add initial support for URP RenderObject Stencil via ``NEEDLE_render_objects`` extension
+
+## [2.13.4-pre] - 2022-09-09
+- Fix UI transform handling for [issue 42](https://github.com/needle-tools/needle-engine-support/issues/42) and [issue 30](https://github.com/needle-tools/needle-engine-support/issues/30)
+- Fix AudioSource not restarting to play at onEnable when ``playOnAwake`` is true (this is the default behaviour in Unity)
+
+## [2.13.3-pre] - 2022-09-09
+- Fix RGBAColor not implementing copy which caused alpha to be set to 0 (this caused ``Camera.backgroundColor`` to not work properly)
+
+## [2.13.2-pre] - 2022-09-07
+- Add support to set OrbitControls camera position immediately
+
+## [2.13.1-pre] - 2022-09-07
+- Fix EventList invocation not using deserialized method arguments
+
+## [2.13.0-pre] - 2022-09-07
+- Add ``context`` to ``StateMachineBehaviour``
+- Fix ``StateMachineBehaviour`` binding (event functions were called with wrong binding)
+
+## [2.12.0-pre.1] - 2022-09-06
+- Fix deserialization error when data is null or undefined
+
+## [2.12.0-pre] - 2022-09-05
+- Add initial tonemapping and exposure support
+- Add AR shadow catcher
+- Fix objects parented to camera appear behind camera
+- Fix reticle showing and never disappearing when no WebARSessionRoot is in scene
+- Fix WebARSessionRoot when on same gameobject as WebXR component
+- Fix deserialization of ``@serializable(Material)`` producing a new default instance in certain cases
+- Fix ``OrbitControls`` enable when called from UI button event
+- Fix EventList / UnityEvent calls to properties (e.g. ``MyComponent.enable = true`` works now from UnityEvent)
+
+## [2.11.1-pre] - 2022-09-02
+- Change: ``OrbitControls.setTarget`` does now lerp by default. Use method parameter ``immediate`` to change it immediately
+- Change: bump component compiler dependency to ``1.8.0``
+
+## [2.10.3-pre] - 2022-09-01
+- Fix EventList serialization for cross-glb references
+- Fix AnimatorController transition from state without animation
+
+## [2.10.2-pre] - 2022-09-01
+- Fix: skybox/camera background on exit AR
+- Change: AnimatorController can now contain empty states
+- Change: Expose ``Animator.Play`` transition duration
+
+## [2.10.1-pre] - 2022-08-31
+- Improved RectTransform animation support and canvas element positioning
+- Fix ``Animator.Play``
+- Change: Expose ``AnimatorController.FindState(name)`` 
+
+## [2.10.0-pre] - 2022-08-29
+- Add UI to gltf export
+- Add button animation transition support for triggers ``Normal``, ``Highlighted`` and ``Pressed``
+
+## [2.9.0-pre] - 2022-08-26
+- Add ``Canvas.renderOnTop`` option
+- Fix ``OrbitControls`` changing focus/moving when interacting with the UI
+- Fix nullref in AnimatorController with empty state
+
+## [2.8.0-pre] - 2022-08-25
+- Add export for ``Renderer.allowOcclusionWhenDynamic``
+- Fix: bug in ``@serializable`` type assignment for inherited classes with multiple members with same name but different serialized types
+- Change: ``GameObject.findObjectOfType`` now also accepts an object as a search root
+
+## [2.7.3-pre] - 2022-08-25
+- Fix canvas button breaking orbit controls [issue #4](https://github.com/needle-tools/needle-engine-support/issues/4)
+
+## [2.7.2-pre] - 2022-08-23
+- Fix SyncedRoom to not append room parameter multiple times
+
+## [2.7.1-pre] - 2022-08-22
+- Add: Timeline AudioTrack nullcheck when audio file is missing
+- Fix: AnimatorController error when behaviours are undefined
+- Change StateMachineBehaviour methods to be lowercase
+
+## [2.7.0-pre] - 2022-08-22
+- Add initial StateMachineBehaviour support with "OnStateEnter", "OnStateUpdate" and "OnStateExit"
+- Fix input raycast position calculation for scrolled content
+
+## [2.6.1-pre] - 2022-08-22
+- Fix texture pointer remapping in gltf-transform opaque extension
+- Change: skip texture-transform for textures starting with "Lightmap" for now until we can configure this properly 
+
+## [2.6.0-pre] - 2022-08-18
+- Add scale to instantiation sync messages
+- Fix ``BoxHelper``
+- Fix AR reticle being not visible when ``XRRig`` is child of ``WebARSessionRoot`` component
+- Fix exception in ``DragControls`` when dragged object was deleted while dragging
+
+## [2.5.0-pre] - 2022-08-18
+- Change name of ``KHR_webgl_extension`` to ``NEEDLE_webgl_extension``
+- Change: dont write depth for custom shader set to transparent 
+- Deprecate and disable ``AssetDatabase``
+
+## [2.4.1-pre] - 2022-08-17
+- Add ``Mathf.MoveTowards``
+- Change: rename ``needle-tiny`` webcomponent to ``needle-engine``
+- Fix ordering issue in needle web component when codegen.js is executed too late
+
+## [2.3.0-pre] - 2022-08-16
+- Add SyncedCamera prefab/AssetReference support
+- Add TypeArray support for ``serializable`` to provide multiple possible deserialization types for one field (e.g. ``serializable([Object3D, AssetReference])`` to try to deserialize a type as Object3D first and then as AssetReference)
+
+## [2.2.0-pre] - 2022-08-14
+- Add event callbacks for Gltf loading: ``BeforeLoad`` (use to register custom extensions), ``AfterLoaded`` (to receive loaded gltf), ``FinishedSetup`` (called after components have been created)
+
+## [2.1.2-pre] - 2022-08-14
+- Fix AnimatorController exit state
+- Fix AR camera background alpha to be fully transparent by default 
+
+## [2.1.1-pre] - 2022-08-12
+- Fix: light shadow bias
+
+## [2.1.0-pre] - 2022-08-11
+- Add ``@needle-tools/engine`` to be used as import for "most used" apis and functions
+- Change: remove obsolete ``Renderer.materialProperties``
+- Fix: ``NEEDLE_persistent_assets`` extension is now valid format (change from array to object)
+
+## [2.0.0-pre] - 2022-08-08
+- Renamed package
+
+## [1.21.2-pre] - 2022-08-08
+- Fix: NestedGltf transform
+
+## [1.20.1-pre] - 2022-08-06
+- Remove: Duplicateable animation time offset hack
+- Change: GameObjectData extension properly await assigning values
+- Change: NestedGltf instantiate using guid
+- Change: ``instantiate`` does now again create guids for three Objects too
+
+## [1.20.0-pre] - 2022-08-05
+- Add: NestedGltf ``listenToProgress`` method
+- Add: Allow changing Renderer lightmap at runtime
+- Fix: Environment lighting when set to flat or gradient (instead of skybox)
+- Fix: ``this.gameObject.getComponentInChildren`` - was internally calling wrong method
+- Fix: Spectator camera, requires Camera component in glb now
+
+## [1.19.0-pre] - 2022-08-03
+- Add: Animator.keepAnimatorStateOnDisable, defaults to false as in Unity so start state is entered on enable again
+- Add: warning if different types with the same name are registered
+- Add: timeline track ``onMutedChanged`` callback
+- Change: PlayableDirector expose audio tracks
+- Change: BoxCollider and SphereCollider being added to the physics scene just once
+- Change: try catch around physics step
+
+## [1.18.0-pre] - 2022-08-01
+- Add: Addressable download progress is now observeable
+- Add: Addressable preload support, allows to load raw bytes without actually building any components
+- Add: PlayableDirector exposes tracks / clips
+- Change: modify default engine loading progress bar to be used from user code
+- Change: add option to Instantiate call to keep world position (set ``keepWorldPosition`` in ``InstantiateOptions`` object that you can pass into instantiate)
+- Change: light uses shadow bias from Unity
+- Fix: instancing requiring worldmatrix update being not properly processed
+- Fix: Duplicatable world position being off (using ``keepWorldPosition``)
+- Fix: ``Animation`` component, it does allow to use one main clip only now, for more complex setups please use AnimationController or Timeline
+- Fix: ``SyncedRoom`` room connection on enter WebXR
+- Fix: WebXR avatar loading
+
+## [1.17.1-pre] - 2022-07-27
+- Change: bump component compiler dependency to ``1.7.1``
+- Change: ``context.mainCameraComponent`` is now of type ``Camera``
+- Fix: timeline control track
+- Fix: timeline animation track post extrapolation
+- Fix: custom shader does not fail when scene uses object with transmission (additional render pass)
+
+## [1.17.0-pre] - 2022-07-21
+- engine: add loading bar and show loading state text
+
+## [1.16.0-pre] - 2022-07-20
+- engine: add using ambient light settings (Intensity Multiplier) exported from Unity
+
+## [1.15.1-pre] - 2022-07-18
+- engine: fix nullref in registering texture
+
+## [1.15.0-pre] - 2022-07-15
+- engine: remove legacy file
+- engine: add basic implementation of ``Context.destroy``
+- engine: fix ``<needle-tiny>`` src attribute
+- engine: add implictly creating camera with orbit controls when loaded glb doesnt contain any (e.g. via src) 
+
+## [1.14.2-pre] - 2022-07-12
+- engine: fix dont apply lightmaps to unlit materials
+- engine: remove log in PlayableDirector
+- engine: add support to override (not automatically create) WebXR buttons 
+
+## [1.14.1-pre] - 2022-07-11
+- engine: Fix AnimatorController finding clip when cloned via ``AssetReference.instantiate``
+- engine: Fix deep clone array type
+- engine: Fix PlayableDirectory binding when cloned via ``AssetReference.instantiate``
+
+## [1.14.0] - 2022-07-10
+- engine: add VideoPlayer using ``AudioOutputMode.None``
+- engine: fix VideoPlayer waiting for input before playing video with audio (unmuted) and being loaded lazily
+
+## [1.13.0-pre] - 2022-07-07
+- engine: Add ``getComponent`` etc methods to THREE.Object3D prototype so we can use it like in Unity: ``this.gameObject.getComponent...``
+- engine: Change ``Duplictable`` serialization
+
+## [1.12.2-pre] - 2022-07-06
+- engine: Fix networking localhost detection
+- engine: update component generator package version (supporting now CODEGEN_START and END sections as well as //@ifdef for fields)
+
+## [1.12.1-pre] - 2022-07-06
+- engine: change lightmap extension to be object
+
+## [1.12.0-pre] - 2022-07-06
+- engine: Add DeviceFlag component
+- engine: Fix VideoPlayer loop and playback speed
+- engine: Improve VideoTrack sync
+
+## [1.11.0-pre] - 2022-07-04
+- engine: fix ``enabled`` not being always assigned
+- engine: fix react-three-fiber component setting camera
+- engine: add support for custom timeline track
+- engine: add VideoTrack npmdef
+
+## [1.10.3-pre] - 2022-07-01
+- engine: Change; PlayableDirector Wrap.None now stops/resets timeline on end
+- engine: Change; PlayableDirector now stops on disabling  
+
+## [1.10.2-pre] - 2022-07-01
+- engine: fix timeline clip offsets and hold
+- engine: fix timeline animationtrack support for post-extrapolation (hold, loop, pingpong)
+
+## [1.10.1-pre] - 2022-06-30
+- engine: improve timeline clip offsets
+
+## [1.10.0-pre] - 2022-06-30
+- engine: Improved timeline clip- and track offset (ongoing)
+- engine: Change assigning all serialized properties by default again (instead of require ``@allProperties`` decorator)
+- engine: Change; deprecate ``@allProperties`` and ``@strict`` decorators
+
+## [1.9.1-pre] - 2022-06-29
+- engine: add methods for unsubscribing to EventList and make constructor args optional
+- engine: change camera to not change transform anymore
+
+## [1.9.0-pre] - 2022-06-28
+- engine: add support for transparent rendering using camera background alpha
+
+## [1.8.0-pre] - 2022-06-27
+- Add: transform gizmo component
+- Change: component generator for npmdef is not required anymore
+- Change: component gen runs in background now
+- Fix: typescript drag drop adding component twice in some cases
+- engine: update component gen package dependency
+- engine: fix redundant camera creation when exported in GLTF
+- engine: fix orbit controls focus lerp, stops now on input
+
+## [1.7.1-pre] - 2022-06-25
+- Override PlayMode in sub-scene
+- engine: lightmaps encoding fix
+- engine: directional light direction fix 
+
+## [1.7.0-pre] - 2022-06-25
+- engine: animator controler can handle multiple target animators
+- engine: fix WebXR being a child of WebARSessionRoot
+- engine: improve Camera, OrbitControls, Lights OnEnable/Disable behaviour
+- engine: add ``Input.getKeyPressed()``
+
+## [1.6.0-pre] - 2022-06-23
+- engine: fix light error "can't add object to self" when re-enabled
+- engine: remove extension log
+- engine: log missing info when UnityEvent has not target (or method not found)
+- engine: use lightmap index for supporting multiple lightmaps
+
+## [1.5.2-pre] - 2022-06-23
+- engine: Camera dont set skybox when in XR
+- engine: dont add lights to scene if baked
+
+## [1.5.1-pre] - 2022-06-22
+- engine: fix threejs dependency pointer
+
+## [1.5.0-pre] - 2022-06-22
+- engine: ``<needle-tiny>`` added awaitable ``getContext()`` (waits for scene being loaded to be used in external js)
+- engine: fix finding main camera warning
+- engine: add ``SourceIdentifier`` to components to be used to get gltf specific data (e.g. lightmaps shipped per gltf)
+- engine: persistent asset resolve fix
+- engine: update three dependency to support khr_pointer
+- engine: remove custom khr_pointer extension
+- engine: fix WebARSessionRoot exported in gltf
+- engine: smaller AR reticle
+
+## [1.4.1-pre] - 2022-06-17
+- engine: create new GltfLoader per loading request
+- engine: fix bug in core where it could happen that scripts were added multiple times
+- engine: Added SyncedRoom auto rejoin option (to handle disconnection by server due to window inactivity)
+- engine: guid resolving first in loaded gltf and retry in whole scene on fail
+- engine: fix nullref in DropListener
+- engine: register main camera before first awake
+
+## [1.4.0-pre] - 2022-06-15
+- engine: add ``GameObject.getOrAddComponent``
+- engine: ``OrbitControl`` exposing controlled object
+- engine: ``getWorldPosition`` now uses buffer of cached vector3's instead of only one
+- engine: add ``AvatarMarker`` to synced camera (also allows to easily attach ``PlayerColor``)
+- engine: fix ``Animation`` component when using khr_pointer extension
+- engine: ``VideoPlayer`` expose current time
+- engine: fix ``Animator.runtimeController`` serialization
+- engine: make ``SyncedRoom.tryJoinRoom`` public
+
+## [1.3.1-pre] - 2022-06-10
+- engine: allow ``@serializeable`` taking abstract types
+- engine: add ``Renderer.sharedMaterials`` support
+
+## [1.3.0-pre] - 2022-06-09
+- engine: move log behind debug flag
+- engine: improved serialization property assignment respecting getter only properties
+- engine: add optional serialization callbacks to ``ISerializable``
+- engine: default to only assign declared properties
+
+## [1.2.3-pre] - 2022-06-09
+- engine: downloading dropped file shows minimal preview box
+- engine: ``DropListener`` can use localhost
+- engine: ``SyncedRoom`` avoid reload due to room parameter
+- engine: ``LODGroup`` instantiate workaround
+- engine: improve deserialization supporting multiple type levels
+
+## [1.2.2-pre] - 2022-05-30
+- engine: change md5 hashing package
+- engine: file upload logs proper server error
+
+## [1.2.1-pre] - 2022-05-30
+- engine: disable light in gltf if mode is baked
+- engine: use tiny starter as default networking backend
+- engine: synced file init fix for resolving references
+- engine: allow removing of gen.js completely
+- engine: expose ``Camera.buildCamera`` for core allowing to use blender camera
+- engine: on filedrop only add drag control if none is found
+
+## [1.2.0-pre] - 2022-05-27
+- engine: fix networked flatbuffer state not being stored
+- engine: make ``src`` on ``<needle-tiny>`` web component optional
+- engine: ``src`` can now point to glb or gltf directly
+- engine: fix ``Raycaster`` registration
+- engine: add ``GameObject.destroySynced``
+- engine: add ``context.setCurrentCamera``
+- engine: make ``DropListener`` to EventTarget
+- engine: make ``DropListener`` accept explicit backend url
+
+## [1.1.0-pre.6] - 2022-05-26
+- Fix gltf transform textures output when used in custom shaders only
+
+## [1.1.0-pre.5] - 2022-05-25
+- engine: fix ``VideoPlayer`` being hidden, play automatically muted until interaction
+- engine: added helpers to update window history
+- engine: fix setting custom shader ``Vector4`` property
+- 
+## [1.1.0-pre.4] - 2022-05-25
+- engine: fix tsc error in ``Animation`` component
+- engine: fix ``Animation`` component assigning animations for GameObject again
+- engine: fix ``Animation`` calling play before awake
+- engine: ``AnimatorController`` handle missing motion (not assigned in Unity)
+- engine: ``AnimatorController.IsInTransition()`` fix
+
+## [1.1.0-pre.1] - 2022-05-20
+- engine: minor tsc issues fixed
+
+## [1.1.0-pre] - 2022-05-20
+- engine: add ``isManagedExternally`` if renderer is not owned (e.g. when using react-fiber)
+
+## [1.0.0-pre.18] - 2022-05-19
+- engine: add basic support for ``stopEventPropagation`` (to make e.g. ``DragControls`` camera control agnostic in preparation of react support)
+
+## [1.0.0-pre.17] - 2022-05-17
+- fix ``EventList`` outside of gltf
+- fix ``EventList`` without any function assigned (``No Function`` in Unity)
+- engine: support changing ``WebARSessionRoot.arScale`` changing at runtime
+
+## [1.0.0-pre.16] - 2022-05-12
+- engine: fix webx avatar instantiate
+- engine: stop input preventing key event defaults
+
+## [1.0.0-pre.15] - 2022-05-12
+- engine: log error if ``instantiate`` is called with false parent
+- engine: fix instantiate with correct ``AnimatorController`` cloning
+
+## [1.0.0-pre.14] - 2022-05-11
+- engine: fix ``@syncField()``
+- engine: fix ``AssetReference.instantiate`` and ``AssetReference.instantiateSynced`` parenting
+- engine: improve ``PlayerSync`` and ``PlayerState``
+
+## [1.0.0-pre.13] - 2022-05-11
+- engine: prepend three canvas to the web element instead of appending
+- engine: ``SyncedRoom`` logs warning when disconnected
+- engine: internal networking does not attempt to reconnect on connection closed
+- engine: internal networking now empties user list when disconnected from room
+- engine: ``GameObject.instantiate`` does not always generate new guid to support cases where e.g. ``SyncTransform`` is on cloned object and requires unique id
+- engine: ``syncedInstantiate`` add fallback to ``Context.Current`` when missing
+- engine: ``EventList`` refactored to use list of ``CallInfo`` objects internally instead of plain function array to more easily attach meta info like ``UnityEvent.off`` 
+- engine: add ``GameObject.instantiateSynced``
+
+## [1.0.0-pre.12] - 2022-05-10
+- engine: fix font path
+- engine: add ``debugnewscripts`` url parameter
+- engine: start adding simplifcation to automatic instance creation + sync per player
+- engine: allow InstantiateOptions in ``GameObject.instantiate`` to be inlined as e.g. ``{ position: ... }``
+- engine: add ``AvatarMarker`` creation and destroy events
+- engine: fix networking message buffering
+
+## [1.0.0-pre.11] - 2022-05-08
+- engine: ``SpatialTrigger`` is serializable
+- engine: fix ``DragControls`` offset when using without ground
+- engine: fix ``WebXRController`` interaction with UI ``Button.onClick``
+
+## [1.0.0-pre.10] - 2022-05-04
+- engine: fix gltf extension not awaiting dependencies
+- engine: fix persistent asset @serializable check for arrays
+- engine: add ``setWorldScale``
+- engine: fix ``instantiate`` setting position
+- engine: ``AssetReference`` does now create new instance in ``instantiate`` call
+- engine: add awaitable ``delay`` util method
+- engine: fix scripts being active when loaded in gltf but never added to scene
+- engine: minimal support for mocking pointer input
+- engine: emit minimal down and up input events when in AR
+
+## [1.0.0-pre.9] - 2022-05-03
+- improved default loading element
+- changed animation pointer to support emissive intensity
+
+## [1.0.0-pre.8] - 2022-05-02
+- lightmaps fixed
+- glitch upload shows time estimate
+- deployment build error fix
+- json pointer resolve
+- improved auto install
+- started basic ``SpriteRenderer`` support
+- basic ``AnimationCurve`` support
+- fixed ``PlayerColor``
+- fixed ``persistent_assets`` and ``serializeable`` conflict
+- basic export of references to components in root prefab
+
+## [1.0.0-pre.7] - 2022-04-30
+- ``WebXR`` does not load avatar from prefab reference
+- ``WebXRSync`` is added implictly and creates local avatar even when not networked
+- ``SpectatorCam`` is using local avatar
+- ``SpectatorCam`` camera component in Unity is now optional and implictly added if missing
+
+## [1.0.0-pre.6] - 2022-04-29
+- fix environment light
+- fix light shadows setting
+- fix video player in extension
+- fix video player texture not overlaying rendering while awaiting interaction
+- fix webAR root reticle when no rig component is in scene
+
+## [1.0.0-pre.5] - 2022-04-28
+- start adding support for ``AssetReference`` again
+
+## [1.0.0-pre.4] - 2022-04-27
+- add persistent asset extension
+- removed timeline and animator controller extensions as both are now serialized and resolved in assets
+- can resolve json pointers (``animations/``, ``materials/``, ``textures/``, ``extensions``) in component paths
+- add ``syncField()`` decorator
+
+## [1.0.0-pre.2] - 2022-04-20
+- updated to https:// three.js url instead of git:// url
+- fixated flatbuffers dependency to 2.0.4 due to breaking changes and bugs in 2.0.6
+
+## [1.0.0-pre] - 2022-04-19
 - initial release