@needle-tools/engine 5.1.13 → 5.1.14

package/src/engine-components/AnimatorController.builder.ts

@@ -1,11 +1,11 @@
-import { AnimationClip, Object3D } from "three";
 import type { Light, Material, PerspectiveCamera } from "three";
+import { AnimationClip, Object3D } from "three";
 
-import { AnimatorConditionMode, AnimatorControllerParameterType } from "../engine/extensions/NEEDLE_animator_controller_model.js";
-import type { AnimatorControllerModel, Condition, Parameter, State, Transition } from "../engine/extensions/NEEDLE_animator_controller_model.js";
 import { InstantiateIdProvider } from "../engine/engine_networking_instantiate.js";
+import type { AnimatorControllerModel, Condition, Parameter, State, Transition } from "../engine/extensions/NEEDLE_animator_controller_model.js";
+import { AnimatorConditionMode, AnimatorControllerParameterType } from "../engine/extensions/NEEDLE_animator_controller_model.js";
+import { type AnimationKeyframe, type ColorValue,type EulerValue, type QuatValue, resolveClipSource, track as trackFn, type TrackDescriptor, type TrackOptions, type Tween, type Vec3Value } from "./AnimationBuilder.js";
 import { AnimatorController } from "./AnimatorController.js";
-import { resolveClipSource, track as trackFn, type TrackDescriptor, type TrackOptions, type AnimationKeyframe, type Tween, type Vec3Value, type QuatValue, type EulerValue, type ColorValue } from "./AnimationBuilder.js";
 
 /** Keyframe array or tween shorthand */
 type KF<V> = AnimationKeyframe<V>[] | Tween<V>;

package/src/engine-components/Component.ts

@@ -4,6 +4,7 @@ import { isDevEnvironment } from "../engine/debug/index.js";
 import { type AssetReference } from "../engine/engine_addressables.js";
 import { addComponent, destroyComponentInstance, findObjectOfType, findObjectsOfType, getComponent, getComponentInChildren, getComponentInParent, getComponents, getComponentsInChildren, getComponentsInParent, getOrAddComponent, removeComponent } from "../engine/engine_components.js";
 import { activeInHierarchyFieldName } from "../engine/engine_constants.js";
+import { DisposableStore, type DisposeFn,type IDisposable } from "../engine/engine_disposable.js";
 import { destroy, findByGuid, foreachComponent, type IInstantiateOptions, instantiate, isActiveInHierarchy, isActiveSelf, isDestroyed, isUsingInstancing, markAsInstancedRendered, setActive } from "../engine/engine_gameobject.js";
 import { isHotReloadEnabled, registerHotReloadType, unregisterHotReloadType } from "../engine/engine_hot_reload.js";
 import * as main from "../engine/engine_mainloop_utils.js";
@@ -13,7 +14,6 @@ import * as threeutils from "../engine/engine_three_utils.js";
 import { $componentName, type Collision, type ComponentInit, type Constructor, type ConstructorConcrete, type ICollider, type IComponent, type IGameObject, type SourceIdentifier } from "../engine/engine_types.js";
 import { TypeStore } from "../engine/engine_typestore.js";
 import type { INeedleXRSessionEventReceiver, NeedleXRControllerEventArgs, NeedleXREventArgs } from "../engine/engine_xr.js";
-import { DisposableStore, type IDisposable, type DisposeFn } from "../engine/engine_disposable.js";
 import { type IPointerEventHandler, PointerEventData } from "./ui/PointerEvents.js";
 
 

package/src/engine-components/DragControls.ts

@@ -1,9 +1,7 @@
 import { AxesHelper, Box3, Euler, Matrix4, Object3D, Plane, Quaternion, Ray, Vector3 } from "three";
 
 export type { IDragConstraint, IDragConstraintContext } from "./DragControlsConstraints.js";
-export { AxisRotationConstraint, GridSnapConstraint, GrabPointPlaneConstraint, KeepRotationConstraint, KeepScaleConstraint, ScaleLimitConstraint, RotationAxis, FixedRotationAxesConstraint, PlaneHeightLockConstraint, SnapToSurfaceConstraint, applyFollowObjectConstraints } from "./DragControlsConstraints.js";
-import { IDragConstraint, IDragConstraintContext, AxisRotationConstraint, GridSnapConstraint, GrabPointPlaneConstraint, KeepRotationConstraint, ScaleLimitConstraint, FixedRotationAxesConstraint, PlaneHeightLockConstraint, SnapToSurfaceConstraint, applyFollowObjectConstraints } from "./DragControlsConstraints.js";
-
+export { applyFollowObjectConstraints,AxisRotationConstraint, FixedRotationAxesConstraint, GrabPointPlaneConstraint, GridSnapConstraint, KeepRotationConstraint, KeepScaleConstraint, PlaneHeightLockConstraint, RotationAxis, ScaleLimitConstraint, SnapToSurfaceConstraint } from "./DragControlsConstraints.js";
 import { Gizmos } from "../engine/engine_gizmos.js";
 import { InstancingUtil } from "../engine/engine_instancing.js";
 import { Mathf } from "../engine/engine_math.js";
@@ -14,6 +12,7 @@ import { type IGameObject } from "../engine/engine_types.js";
 import { getParam } from "../engine/engine_utils.js";
 import { NeedleXRSession } from "../engine/engine_xr.js";
 import { Behaviour, GameObject } from "./Component.js";
+import { applyFollowObjectConstraints,AxisRotationConstraint, FixedRotationAxesConstraint, GrabPointPlaneConstraint, GridSnapConstraint, IDragConstraint, IDragConstraintContext, KeepRotationConstraint, PlaneHeightLockConstraint, ScaleLimitConstraint, SnapToSurfaceConstraint } from "./DragControlsConstraints.js";
 import { EventList } from "./EventList.js";
 import { UsageMarker } from "./Interactable.js";
 import { Rigidbody } from "./RigidBody.js";

package/src/engine-components/DragControlsConstraints.ts

@@ -1,9 +1,8 @@
 import { Box3, Euler, Object3D, Plane, Quaternion, Ray, Vector3 } from "three";
 
 import type { Context } from "../engine/engine_setup.js";
-
-import { GameObject } from "./Component.js";
 import type { IGameObject } from "../engine/engine_types.js";
+import { GameObject } from "./Component.js";
 
 // #region Interfaces
 /**

package/src/engine-components/Light.ts

@@ -1,12 +1,12 @@
 import { CameraHelper, Color, DirectionalLight, DirectionalLightHelper, Light as ThreeLight, OrthographicCamera, PointLight, SpotLight, Vector3 } from "three";
 
+import { isDevEnvironment } from "../engine/debug/index.js";
 import { serializable } from "../engine/engine_serialization_decorator.js";
 import { setWorldPositionXYZ } from "../engine/engine_three_utils.js";
 import type { ILight } from "../engine/engine_types.js";
 import { getParam } from "../engine/engine_utils.js";
 import type { NeedleXREventArgs } from "../engine/xr/api.js";
 import { Behaviour, GameObject } from "./Component.js";
-import { isDevEnvironment } from "../engine/debug/index.js";
 
 // https://threejs.org/examples/webgl_shadowmap_csm.html
 

package/src/engine-components/api.ts

@@ -34,7 +34,7 @@
  * @module Built-in Components
  */
 
-export { AnimationBuilder, type AnimationKeyframe, type Tween, type AnimationInterpolation } from "./AnimationBuilder.js";
+export { AnimationBuilder, type AnimationInterpolation,type AnimationKeyframe, type Tween } from "./AnimationBuilder.js";
 export { AnimatorControllerBuilder, type ConditionMode, type StateOptions, type TransitionOptions } from "./AnimatorController.builder.js";
 export * from "./codegen/components.js";
 export { Collider } from "./Collider.js"; // export abstract type
@@ -44,11 +44,11 @@ export { Behaviour, Component, GameObject } from "./Component.js";
 export { AudioRolloffMode } from "./AudioSource.js";
 export { ClearFlags } from "./Camera.js"
 export { DragMode } from "./DragControls.js";
-export { ShadowCastingMode, ReflectionProbeUsage } from "./Renderer.js";
 export type { DropListenerNetworkEventArguments, DropListenerOnDropArguments } from "./DropListener.js";
 export * from "./export/index.js"
 export * from "./particlesystem/api.js"
 export * from "./postprocessing/index.js"
+export { ReflectionProbeUsage,ShadowCastingMode } from "./Renderer.js";
 export { type ISceneEventListener } from "./SceneSwitcher.js";
 export * from "./splines/index.js";
 export * from "./timeline/index.js"

package/src/engine-components/export/usdz/USDZExporter.ts

@@ -3,7 +3,7 @@ import { Euler, Material, Matrix4, Mesh, Object3D, Quaternion, Vector3 } from "t
 
 import { isDevEnvironment, showBalloonMessage, showBalloonWarning } from "../../../engine/debug/index.js";
 import { findObjectOfType } from "../../../engine/engine_components.js";
-import { __csRKN } from "../../../engine/engine_license.js";
+import { _$xBhfh } from "../../../engine/engine_license.js";
 import { serializable } from "../../../engine/engine_serialization.js";
 import { getFormattedDate, Progress } from "../../../engine/engine_time_utils.js";
 import { DeviceUtilities, getParam } from "../../../engine/engine_utils.js";
@@ -277,7 +277,7 @@ export class USDZExporter extends Behaviour {
         let name = this.exportFileName ?? this.objectToExport?.name ?? this.name;
         name += "-" + getFormattedDate(); // seems iOS caches the file in some cases, this ensures we always have a fresh file
 
-        if (!__csRKN()) {
+        if (!_$xBhfh()) {
             if (name !== "") name += "-";
             name += "MadeWithNeedle";
         }
@@ -682,7 +682,7 @@ export class USDZExporter extends Behaviour {
                     if (debug)
                         showBalloonMessage("Quicklook url: " + callToActionURL);
                     if (callToActionURL) {
-                        if (!__csRKN()) {
+                        if (!_$xBhfh()) {
                             console.warn("Quicklook closed: custom redirects require a Needle Engine Pro license: https://needle.tools/pricing", callToActionURL)
                         }
                         else {
@@ -697,7 +697,7 @@ export class USDZExporter extends Behaviour {
     private buildQuicklookOverlay(): CustomBranding {
         const obj: CustomBranding = {};
         if (this.customBranding) Object.assign(obj, this.customBranding);
-        if (!__csRKN()) {
+        if (!_$xBhfh()) {
             console.log("Custom Quicklook banner text requires pro license: https://needle.tools/pricing");
             obj.callToAction = "Close";
             obj.checkoutTitle = "🌵 Made with Needle";

package/src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts

@@ -3,6 +3,7 @@ import { AnimationClip, Material, Matrix4, Mesh, Object3D, Quaternion, Vector3 }
 import { isDevEnvironment, showBalloonWarning } from "../../../../../engine/debug/index.js";
 import { serializable } from "../../../../../engine/engine_serialization_decorator.js";
 import { getWorldPosition, getWorldQuaternion, getWorldScale, setWorldPosition, setWorldQuaternion, setWorldScale } from "../../../../../engine/engine_three_utils.js";
+import type { ComponentInit } from "../../../../../engine/engine_types.js";
 import { getParam } from "../../../../../engine/engine_utils.js";
 import { compareAssociation } from "../../../../../engine/extensions/extension_utils.js";
 import type { State } from "../../../../../engine/extensions/NEEDLE_animator_controller_model.js";
@@ -11,7 +12,6 @@ import { Animation } from "../../../../Animation.js";
 import { Animator } from "../../../../Animator.js";
 import { AudioSource } from "../../../../AudioSource.js";
 import { Behaviour, GameObject } from "../../../../Component.js";
-import type { ComponentInit } from "../../../../../engine/engine_types.js";
 import { Rigidbody } from "../../../../RigidBody.js";
 import type { IPointerClickHandler, PointerEventData } from "../../../../ui/PointerEvents.js";
 import { makeNameSafeForUSD, USDDocument, USDObject, USDZExporterContext } from "../../ThreeUSDZExporter.js";

package/src/engine-components/postprocessing/index.ts

@@ -4,8 +4,8 @@ export { PostProcessingEffectOrder } from "./utils.js";
 /* Effect option enums. The effect components themselves are exported from
    codegen/components.ts, but these were unreachable: `DepthOfField.mode`
    could not be set to a named value from outside the package. */
-export { DepthOfFieldMode } from "./Effects/DepthOfField.js";
 export { QualityLevel } from "./Effects/Antialiasing.js";
+export { DepthOfFieldMode } from "./Effects/DepthOfField.js";
 export { ScreenSpaceAmbientOcclusionN8QualityMode } from "./Effects/ScreenspaceAmbientOcclusionN8.js";
 export { NEToneMappingMode } from "./Effects/Tonemapping.utils.js";
 export { PostProcessingManager } from "./Volume.js"

package/src/engine-components/timeline/TimelineBuilder.ts

@@ -1,19 +1,19 @@
-import { AnimationClip, Object3D } from "three";
 import type { Light, Material, PerspectiveCamera } from "three";
+import { AnimationClip, Object3D } from "three";
 
+import { InstantiateIdProvider } from "../../engine/engine_networking_instantiate.js";
+import { type AnimationKeyframe, type ColorValue,type EulerValue, isTrackDescriptor, type QuatValue, resolveToClip, track as trackFn, type TrackDescriptor, type TrackOptions, type Tween, type Vec3Value } from "../AnimationBuilder.js";
 import type { Animator } from "../Animator.js";
 import type { AudioSource } from "../AudioSource.js";
 import { GameObject } from "../Component.js";
-import { InstantiateIdProvider } from "../../engine/engine_networking_instantiate.js";
 import { EventList } from "../EventList.js";
-import { isTrackDescriptor, resolveToClip, track as trackFn, type TrackDescriptor, type TrackOptions, type AnimationKeyframe, type Tween, type Vec3Value, type QuatValue, type EulerValue, type ColorValue } from "../AnimationBuilder.js";
 
 /** Keyframe array or tween shorthand */
 type KF<V> = AnimationKeyframe<V>[] | Tween<V>;
-import { SignalAsset, SignalReceiver, SignalReceiverEvent } from "./SignalAsset.js";
 import type { PlayableDirector } from "./PlayableDirector.js";
+import { SignalAsset, SignalReceiver, SignalReceiverEvent } from "./SignalAsset.js";
+import type { AnimationClipModel, AudioClipModel, ClipModel, ControlClipModel, MarkerModel, SignalMarkerModel, TimelineAssetModel, TrackModel, TrackOffset } from "./TimelineModels.js";
 import { ClipExtrapolation, TrackType } from "./TimelineModels.js";
-import type { TimelineAssetModel, TrackModel, ClipModel, AnimationClipModel, AudioClipModel, ControlClipModel, MarkerModel, SignalMarkerModel, TrackOffset } from "./TimelineModels.js";
 import { MarkerType } from "./TimelineModels.js";
 
 /**

package/src/engine-components/timeline/TimelineTracks.ts

@@ -1,6 +1,7 @@
 import { AnimationAction, AnimationClip, AnimationMixer, Audio, AudioListener, AudioLoader, Euler, Object3D, Quaternion, QuaternionKeyframeTrack, Vector3, VectorKeyframeTrack } from "three";
 
 import { isDevEnvironment } from "../../engine/debug/index.js";
+import { AnimationUtils } from "../../engine/engine_animation.js";
 import { Context } from "../../engine/engine_setup.js";
 import type { Constructor } from "../../engine/engine_types.js";
 import { getParam, resolveUrl } from "../../engine/engine_utils.js";
@@ -9,9 +10,8 @@ import { AudioSource } from "../AudioSource.js";
 import { GameObject } from "../Component.js";
 import type { PlayableDirector } from "./PlayableDirector.js";
 import { SignalReceiver } from "./SignalAsset.js";
-import * as Models from "./TimelineModels.js";
 import type { TimelineBuilder } from "./TimelineBuilder.js";
-import { AnimationUtils } from "../../engine/engine_animation.js";
+import * as Models from "./TimelineModels.js";
 
 const debug = getParam("debugtimeline");
 
@@ -722,6 +722,20 @@ export class TimelineAudioTrack extends TimelineTrackHandler {
             audio.playbackRate = this.director.context.time.timeScale * this.director.speed;
             audio.loop = asset.loop;
             if (time >= model.start && time <= model.end && time < this.director.duration) {
+                let vol = asset.volume as number;
+                if (this.track.volume !== undefined)
+                    vol *= this.track.volume;
+                if (isMuted) vol = 0;
+                if (model.easeInDuration > 0) {
+                    const easeIn = Math.min((time - model.start) / model.easeInDuration, 1);
+                    vol *= easeIn;
+                }
+                if (model.easeOutDuration > 0) {
+                    const easeOut = Math.min((model.end - time) / model.easeOutDuration, 1);
+                    vol *= easeOut;
+                }
+                vol *= this.director.weight;
+
                 if (!audio.isPlaying || !this.director.isPlaying) {
                     // if the timeline is paused we trigger the audio clip once when the model is entered
                     // we dont playback the audio clip if we scroll back in time
@@ -733,6 +747,11 @@ export class TimelineAudioTrack extends TimelineTrackHandler {
                             audio.offset = model.clipIn + (time - model.start) * model.timeScale;
                         else audio.offset = 0;
                         if (debug) console.log("Timeline Audio (" + this.track.name + ") play with offset " + audio.offset + " - " + model.asset.clip);
+                        // Audio.setVolume() fades over 10 ms. Set the initial gain immediately
+                        // before starting the source so short muted clips cannot be heard.
+                        const gain = audio.gain.gain;
+                        gain.cancelScheduledValues(audio.context.currentTime);
+                        gain.setValueAtTime(vol, audio.context.currentTime);
                         audio.play(playTimeOffset);
                         model._didTriggerPlay = true;
                     }
@@ -750,24 +769,13 @@ export class TimelineAudioTrack extends TimelineTrackHandler {
                     if (diff > 0.3) {
                         audio.offset = targetOffset;
                         audio.stop();
+                        const gain = audio.gain.gain;
+                        gain.cancelScheduledValues(audio.context.currentTime);
+                        gain.setValueAtTime(vol, audio.context.currentTime);
                         audio.play(playTimeOffset);
                     }
                 }
-                let vol = asset.volume as number;
-
-                if (this.track.volume !== undefined)
-                    vol *= this.track.volume;
-
-                if (isMuted) vol = 0;
-                if (model.easeInDuration > 0) {
-                    const easeIn = Math.min((time - model.start) / model.easeInDuration, 1);
-                    vol *= easeIn;
-                }
-                if (model.easeOutDuration > 0) {
-                    const easeOut = Math.min((model.end - time) / model.easeOutDuration, 1);
-                    vol *= easeOut;
-                }
-                audio.setVolume(vol * this.director.weight);
+                audio.setVolume(vol);
             }
             else {
                 model._didTriggerPlay = false;

package/src/engine-components/webxr/WebXRImageTracking.utils.ts

@@ -1,6 +1,5 @@
 import { isDevEnvironment } from "../../engine/debug/index.js";
 import { getParam } from "../../engine/engine_utils.js";
-
 import type { WebXRImageTrackingModel } from "./WebXRImageTracking.js";
 
 // Kept in a dedicated module (with only lightweight imports) so the marker-loading logic can be unit