@needle-tools/engine 5.1.0-beta.1 → 5.1.0-beta.2

package/src/engine/engine_utils_qrcode.ts

@@ -4,7 +4,7 @@ import { Quaternion, Vector2, Vector3, Vector4 } from "three";
 
 import { needleLogoOnlySVG } from "./assets/index.js";
 import { isDevEnvironment } from "./debug/debug.js";
-import { __Aale } from "./engine_license.js";
+import { $cgOiWi } from "./engine_license.js";
 import { InternalAttributeUtils } from "./engine_utils_attributes.js";
 import type { NeedleEngineWebComponent } from "./webcomponents/needle-engine.js";
 
@@ -135,7 +135,7 @@ async function internalRenderQRCodeOverlays(canvas: HTMLCanvasElement, args: { s
         console.debug("[QR Code] No web component found")
     }
 
-    const canUseCustomLogo = __Aale();
+    const canUseCustomLogo = $cgOiWi();
 
     // Query logo src from needle-engine attribute.
     // For any supported attribute it's possible to use "falsey" values (e.g. "0" or "false" to disable the logo in the QR code)

package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts

@@ -2,7 +2,7 @@ import { Mesh, Object3D, TextureLoader, Vector4 } from "three";
 import ThreeMeshUI from "three-mesh-ui";
 
 import { addNewComponent } from "../../engine_components.js";
-import { $KhjWEFh } from "../../engine_license.js";
+import { $cgOiWi } from "../../engine_license.js";
 import { OneEuroFilterXYZ } from "../../engine_math.js";
 import type { Context } from "../../engine_setup.js";
 import { lookAtObject } from "../../engine_three_utils.js";
@@ -321,7 +321,7 @@ export class NeedleSpatialMenu {
         }
         if (this.menu) {
             const index = this.menu.children.indexOf(this._poweredByNeedleElement as any);
-            if (!this._showNeedleLogo && $KhjWEFh()) {
+            if (!this._showNeedleLogo && $cgOiWi()) {
                 if (index >= 0) {
                     this._poweredByNeedleElement.removeFromParent();
                     this.markDirty();

package/src/engine/webcomponents/needle menu/needle-menu.ts

@@ -1,6 +1,6 @@
 import { showBalloonMessage } from "../../debug/debug.js";
 import type { Context } from "../../engine_context.js";
-import { __Aale, ytUNHgWl, Telemetry } from "../../engine_license.js";
+import { $cgOiWi, $ziNBzS, Telemetry } from "../../engine_license.js";
 import { isLocalNetwork } from "../../engine_networking_utils.js";
 import { HTMLElementBase } from "../../engine_ssr.js";
 import { DeviceUtilities, getParam } from "../../engine_utils.js";
@@ -208,14 +208,14 @@ export class NeedleMenu {
     }
 
     /**
-     * Call to show or hide the menu.  
-     * NOTE: Hiding the menu is a PRO feature and requires a needle engine license. Hiding the menu will not work in production without a license.
+     * Call to show or hide the menu.
+     * NOTE: Hiding the menu requires a commercial license. Hiding the menu will not work in production without a license.
      */
     setVisible(visible: boolean) {
         this._menu.setVisible(visible);
     }
 
-    /** When set to false, the Needle Engine logo will be hidden. Hiding the logo requires a needle engine license */
+    /** When set to false, the Needle Engine logo will be hidden. Hiding the logo requires a commercial license */
     showNeedleLogo(visible: boolean) {
         this._menu.showNeedleLogo(visible);
         this._spatialMenu?.showNeedleLogo(visible);
@@ -778,8 +778,8 @@ export class NeedleMenuElement extends HTMLElementBase {
         try {
             // if the user has a license then we CAN hide the needle logo
             // calling this method immediately will cause an issue with vite bundling tho
-            window.requestAnimationFrame(() => ytUNHgWl(res => {
-                if (res == true && __Aale() && !debugNonCommercial) {
+            window.requestAnimationFrame(() => $ziNBzS(res => {
+                if (res == true && $cgOiWi() && !debugNonCommercial) {
                     let visible = this._userRequestedLogoVisible;
                     if (visible === undefined) visible = false;
                     this.___onSetLogoVisible(visible);
@@ -830,7 +830,7 @@ export class NeedleMenuElement extends HTMLElementBase {
                 // ensure the menu is not hidden or removed
                 const requiredParent = this?.parentNode;
                 if (this.style.display != "flex" || this.style.visibility != "visible" || this.style.opacity != "1" || requiredParent != this._domElement?.shadowRoot) {
-                    if (!__Aale()) {
+                    if (!$cgOiWi()) {
                         const change = changeEventCounter++;
                         // if a user doesn't have a local pro license *but* for development the menu is hidden then we show a warning
                         if (isLocalNetwork() && this._userRequestedMenuVisible === false) {
@@ -841,7 +841,7 @@ export class NeedleMenuElement extends HTMLElementBase {
                             }
                             // warn only once
                             if (change === 1) {
-                                console.warn(`Needle Menu Warning: You need a PRO license to hide the Needle Engine menu → The menu will be visible in your deployed website if you don't have a PRO license. See https://needle.tools/pricing for details.`);
+                                console.warn(`Needle Menu Warning: You need a commercial license to hide the Needle Engine menu → The menu will be visible in your deployed website without one. See https://needle.tools/pricing for details.`);
                             }
                         }
                         else {
@@ -918,8 +918,8 @@ export class NeedleMenuElement extends HTMLElementBase {
     showNeedleLogo(visible: boolean) {
         this._userRequestedLogoVisible = visible;
         if (!visible) {
-            if (!__Aale() || debugNonCommercial) {
-                console.warn("[Needle Engine] You need a PRO license to hide the Needle Engine logo in production.");
+            if (!$cgOiWi() || debugNonCommercial) {
+                console.warn("[Needle Engine] You need a commercial license to hide the Needle Engine logo in production.");
                 const localNetwork = isLocalNetwork()
                 if (!localNetwork) return;
             }

package/src/engine/webcomponents/needle-engine.loading.ts

@@ -1,6 +1,6 @@
 import { needleLogoOnlySVG } from "../assets/index.js"
 import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
-import { __Aale, $KhjWEFh, _AaROCyv } from "../engine_license.js";
+import { $cgOiWi, _$jDMeEQ, __EJdGb } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { LoadingProgressArgs } from "../engine_setup.js";
 import { getParam } from "../engine_utils.js";
@@ -205,7 +205,7 @@ export class EngineLoadingView implements ILoadingViewHandler {
         }
 
 
-        const hasLicense = $KhjWEFh();
+        const hasLicense = _$jDMeEQ();
         if (!existing) {
             this._loadingElement.style.position = "absolute";
             this._loadingElement.style.width = "100%";
@@ -373,7 +373,7 @@ export class EngineLoadingView implements ILoadingViewHandler {
 
     // private async handleRuntimeLicense(loadingElement: HTMLElement) {
     //     // First check if we have a commercial license
-    //     let commercialLicense = __Aale();
+    //     let commercialLicense = $cgOiWi();
     //     // if it's the case then we don't need to perform a runtime check
     //     if (commercialLicense) return;
 
@@ -393,10 +393,10 @@ export class EngineLoadingView implements ILoadingViewHandler {
     //     loadingElement.appendChild(nonCommercialContainer);
 
     //     // Use the runtime license check
-    //     if (!isDevEnvironment() && _AaROCyv) {
+    //     if (!isDevEnvironment() && __EJdGb) {
     //         if (debugLicense) console.log("Waiting for runtime license check");
-    //         await _AaROCyv;
-    //         commercialLicense = __Aale();
+    //         await __EJdGb;
+    //         commercialLicense = $cgOiWi();
     //     }
     //     if (commercialLicense) return;
     //     nonCommercialContainer.style.transition = "opacity .5s ease-in-out";

package/src/engine/webcomponents/needle-engine.ts

@@ -3,7 +3,7 @@ import type { Texture } from "three";
 import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
 import { PUBLIC_KEY, VERSION } from "../engine_constants.js";
 import { ContextEvent, ContextRegistry } from "../engine_context_registry.js";
-import { __Aale } from "../engine_license.js";
+import { $cgOiWi } from "../engine_license.js";
 import { onStart } from "../engine_lifecycle_api.js";
 import { setDracoDecoderPath, setDracoDecoderType, setKtx2TranscoderPath } from "../engine_loaders.gltf.js";
 import { Context, ContextCreateArgs } from "../engine_setup.js";
@@ -579,7 +579,7 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
 
 
         // Loading start events
-        const allowOverridingDefaultLoading = __Aale();
+        const allowOverridingDefaultLoading = $cgOiWi();
         // default loading can be overriden by calling preventDefault in the onload start event
         this.ensureLoadStartIsRegistered();
         let useDefaultLoading = this.dispatchEvent(new CustomEvent("loadstart", {

package/src/engine/xr/TempXRContext.ts

@@ -3,7 +3,7 @@ import { ArrayCamera, AxesHelper, Camera, Color, DirectionalLight, Fog, GridHelp
 import { needleLogoOnlySVG } from "../assets/index.js";
 import { isDevEnvironment } from "../debug/index.js";
 import { ObjectUtils, PrimitiveType } from "../engine_create_objects.js";
-import { __Aale } from "../engine_license.js";
+import { $cgOiWi } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { delay, DeviceUtilities } from "../engine_utils.js";
 
@@ -215,7 +215,7 @@ export class TemporaryXRContext {
         this._scene.background = new Color(0x000000);
 
         let logoSrc = needleLogoOnlySVG;
-        if (__Aale()) {
+        if ($cgOiWi()) {
             const htmlComponent = document.querySelector("needle-engine");
             if (htmlComponent) {
                 const licenseLogo = htmlComponent.getAttribute("logo-src");

package/src/engine-components/NeedleMenu.ts

@@ -49,8 +49,8 @@ export class NeedleMenu extends Behaviour {
     @serializable()
     position: "top" | "bottom" = "bottom";
 
-    /** 
-     * Controls the visibility of the Needle logo in the menu (requires PRO license)
+    /**
+     * Controls the visibility of the Needle logo in the menu (requires a commercial license)
      */
     @serializable()
     showNeedleLogo: boolean = false;

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 { $KhjWEFh } from "../../../engine/engine_license.js";
+import { _$jDMeEQ } 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 (!$KhjWEFh()) {
+        if (!_$jDMeEQ()) {
             if (name !== "") name += "-";
             name += "MadeWithNeedle";
         }
@@ -682,7 +682,7 @@ export class USDZExporter extends Behaviour {
                     if (debug)
                         showBalloonMessage("Quicklook url: " + callToActionURL);
                     if (callToActionURL) {
-                        if (!$KhjWEFh()) {
+                        if (!_$jDMeEQ()) {
                             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 (!$KhjWEFh()) {
+        if (!_$jDMeEQ()) {
             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

@@ -11,6 +11,7 @@ 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";
@@ -811,13 +812,16 @@ export class PlayAudioOnClick extends Behaviour implements IPointerClickHandler,
 
     ensureAudioSource() {
         if (!this.target) {
-            const newAudioSource = this.gameObject.addComponent(AudioSource);
+            const initializeAudioSource: ComponentInit<AudioSource> = {
+                spatialBlend: 1,
+                volume: 1,
+                loop: false,
+                clip: this.clip,
+                preload: true,
+            };
+            const newAudioSource = this.gameObject.addComponent(AudioSource, initializeAudioSource);
             if (newAudioSource) {
                 this.target = newAudioSource;
-                newAudioSource.spatialBlend = 1;
-                newAudioSource.volume = 1;
-                newAudioSource.loop = false;
-                newAudioSource.preload = true;
             }
         }
     }
@@ -828,6 +832,9 @@ export class PlayAudioOnClick extends Behaviour implements IPointerClickHandler,
             label: "Play audio: " + (this.clip || this.target?.clip || "unknown clip"),
             hidden: false,
         })
+
+        this.ensureAudioSource();
+
     }
     onDisable(): void {
         this.context.accessibility.updateElement(this, {

package/src/engine-components/particlesystem/ParticleSystem.ts

@@ -593,6 +593,10 @@ class ColorBehaviour extends ParticleSystemBaseBehaviour {
         col.copy(this.system.main.startColor.evaluate(Math.random()));
         if (materialColor?.color) {
             tempColor.copy(materialColor.color);
+            // THREE.Color has no alpha — the material's color alpha is stored in
+            // material.opacity. Without this, a particle material's alpha/opacity
+            // was ignored (reported externally). multiply() propagates alpha.
+            tempColor.alpha = materialColor.opacity ?? 1;
             col.multiply(tempColor)
         }
         col.convertLinearToSRGB();

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

@@ -567,6 +567,7 @@ export class WebXRImageTracking extends Behaviour {
      * });
      * ```
      */
+    @serializable(EventList)
     imageTracked: EventList<WebXRImageTrackingEvent> = new EventList();
 
     /** @inheritdoc */