@needle-tools/engine 5.0.2 → 5.1.0-canary.87c4c44

package/lib/engine/postprocessing/postprocessing.js

@@ -0,0 +1,280 @@
+import { isDevEnvironment } from "../debug/index.js";
+import { DeviceUtilities, getParam } from "../engine_utils.js";
+const debug = getParam("debugpost");
+/**
+ * Core postprocessing stack accessible via `context.postprocessing`.
+ * Manages the effect pipeline independently of any specific component.
+ *
+ * Volumes and individual PostProcessingEffect components add/remove effects
+ * to this stack. The stack builds the EffectComposer pipeline when dirty.
+ *
+ * @example Add an effect directly
+ * ```ts
+ * const bloom = new BloomEffect({ intensity: 3 });
+ * this.context.postprocessing.addEffect(bloom);
+ * ```
+ *
+ * @example Remove an effect
+ * ```ts
+ * this.context.postprocessing.removeEffect(bloom);
+ * ```
+ */
+export class PostProcessing {
+    _context;
+    _handler = null;
+    _effects = [];
+    _isDirty = false;
+    /** Currently active postprocessing effects in the stack */
+    get effects() {
+        return this._effects;
+    }
+    get dirty() { return this._isDirty; }
+    set dirty(value) { this._isDirty = value; }
+    /** The internal PostProcessingHandler that manages the EffectComposer pipeline */
+    get handler() { return this._handler; }
+    /**
+     * The effect composer used to render postprocessing effects.
+     * This is set internally by the PostProcessingHandler when effects are applied.
+     */
+    get composer() { return this._composer; }
+    set composer(value) { this._composer = value; }
+    _composer = null;
+    /**
+     * Set multisampling to "auto" to automatically adjust the multisampling level based on performance.
+     * Set to a number to manually set the multisampling level.
+     * @default "auto"
+     */
+    multisampling = "auto";
+    /** When enabled, the device pixel ratio will be gradually reduced when FPS is low
+     * and restored when performance recovers.
+     * @default true
+     */
+    adaptiveResolution = true;
+    constructor(context) {
+        this._context = context;
+    }
+    /**
+     * Add a post processing effect to the stack.
+     * The effect stack will be rebuilt on the next update.
+     */
+    addEffect(effect) {
+        if (this._effects.includes(effect))
+            return;
+        this._effects.push(effect);
+        this._isDirty = true;
+    }
+    /**
+     * Remove a post processing effect from the stack.
+     * The effect stack will be rebuilt on the next update.
+     */
+    removeEffect(effect) {
+        const index = this._effects.indexOf(effect);
+        if (index !== -1) {
+            this._effects.splice(index, 1);
+            this._isDirty = true;
+        }
+    }
+    /** Mark the stack as dirty so the effects are rebuilt on the next update */
+    markDirty() {
+        this._isDirty = true;
+    }
+    // --- Adaptive multisampling state ---
+    _enabledTime = -1;
+    _multisampleAutoChangeTime = 0;
+    _multisampleAutoDecreaseTime = 0;
+    /** @internal Called from the context render loop to update the postprocessing pipeline */
+    update() {
+        const context = this._context;
+        if (context.isInXR)
+            return;
+        // Wait for a camera before applying
+        if (this._isDirty && context.mainCamera) {
+            this.apply();
+        }
+        // In tonemapping-only mode, keep renderer values in sync with the active effect
+        if (this._tonemappingOnlyActive) {
+            const activeEffects = this._effects.filter(e => e.active && e.enabled && e.isToneMapping === true);
+            if (activeEffects.length > 0) {
+                const effect = activeEffects[activeEffects.length - 1];
+                context.renderer.toneMapping = effect.threeToneMapping;
+                context.renderer.toneMappingExposure = effect.toneMappingExposure;
+            }
+            return;
+        }
+        if (!this._handler || !this._composer || this._handler.composer !== this._composer)
+            return;
+        // The composer is always a pmndrs EffectComposer (created by PostProcessingHandler)
+        const composer = this._composer;
+        // Handle context lost
+        if (context.renderer.getContext().isContextLost()) {
+            context.renderer.forceContextRestore();
+        }
+        if (composer.getRenderer() !== context.renderer)
+            composer.setRenderer(context.renderer);
+        composer.setMainScene(context.scene);
+        // --- Adaptive multisampling ---
+        if (this.multisampling === "auto") {
+            if (this._handler.hasSmaaEffect) {
+                if (this._handler.multisampling !== 0) {
+                    this._handler.multisampling = 0;
+                    if (debug || isDevEnvironment()) {
+                        console.log(`[PostProcessing] multisampling is disabled because it's set to 'auto' and there is an SMAA effect.\n\nIf you need multisampling consider changing 'auto' to a fixed value (e.g. 4).`);
+                    }
+                }
+            }
+            else {
+                const timeSinceLastChange = context.time.realtimeSinceStartup - this._multisampleAutoChangeTime;
+                if (context.time.realtimeSinceStartup - this._enabledTime > 2
+                    && timeSinceLastChange > .5) {
+                    const prev = this._handler.multisampling;
+                    if (this._handler.multisampling > 0 && context.time.smoothedFps <= 50) {
+                        this._multisampleAutoChangeTime = context.time.realtimeSinceStartup;
+                        this._multisampleAutoDecreaseTime = context.time.realtimeSinceStartup;
+                        let newMultiSample = this._handler.multisampling * .5;
+                        newMultiSample = Math.floor(newMultiSample);
+                        if (newMultiSample != this._handler.multisampling) {
+                            this._handler.multisampling = newMultiSample;
+                        }
+                        if (debug)
+                            console.debug(`[PostProcessing] Reduced multisampling from ${prev} to ${this._handler.multisampling}`);
+                    }
+                    else if (timeSinceLastChange > 1
+                        && context.time.smoothedFps >= 59
+                        && this._handler.multisampling < context.renderer.capabilities.maxSamples
+                        && context.time.realtimeSinceStartup - this._multisampleAutoDecreaseTime > 10) {
+                        this._multisampleAutoChangeTime = context.time.realtimeSinceStartup;
+                        let newMultiSample = this._handler.multisampling <= 0 ? 1 : this._handler.multisampling * 2;
+                        newMultiSample = Math.floor(newMultiSample);
+                        if (newMultiSample !== this._handler.multisampling) {
+                            this._handler.multisampling = newMultiSample;
+                        }
+                        if (debug)
+                            console.debug(`[PostProcessing] Increased multisampling from ${prev} to ${this._handler.multisampling}`);
+                    }
+                }
+            }
+        }
+        else {
+            const newMultiSample = Math.max(0, Math.min(this.multisampling, context.renderer.capabilities.maxSamples));
+            if (newMultiSample !== this._handler.multisampling)
+                this._handler.multisampling = newMultiSample;
+        }
+        // --- Adaptive pixel ratio ---
+        this._handler.adaptivePixelRatio = this.adaptiveResolution;
+        this._handler.updateAdaptivePixelRatio();
+        // Update camera on passes if needed
+        if (context.mainCamera) {
+            const passes = composer.passes;
+            for (const pass of passes) {
+                if (pass.mainCamera && pass.mainCamera !== context.mainCamera) {
+                    composer.setMainCamera(context.mainCamera);
+                    break;
+                }
+            }
+        }
+    }
+    _lastApplyTime;
+    _rapidApplyCount = 0;
+    // --- Tonemapping-only state ---
+    /** When true, tonemapping is applied directly to the renderer (no full pipeline) */
+    _tonemappingOnlyActive = false;
+    _previousToneMapping;
+    _previousToneMappingExposure;
+    apply() {
+        if (debug)
+            console.log(`[PostProcessing] Apply stack (${this._effects.length} effects)`);
+        if (isDevEnvironment()) {
+            if (this._lastApplyTime !== undefined && Date.now() - this._lastApplyTime < 100) {
+                this._rapidApplyCount++;
+                if (this._rapidApplyCount === 5)
+                    console.warn("[PostProcessing] Detected rapid post processing modifications - this might be a bug");
+            }
+            this._lastApplyTime = Date.now();
+        }
+        this._isDirty = false;
+        // Collect active effects
+        const activeEffects = this._effects.filter(e => e.active && e.enabled);
+        if (activeEffects.length <= 0) {
+            this.restoreTonemapping();
+            this._handler?.unapply(false);
+            return;
+        }
+        // Check if ALL active effects are tonemapping-only
+        const allToneMapping = activeEffects.every(e => e.isToneMapping === true);
+        if (allToneMapping) {
+            // Use the last tonemapping effect added (last in the array)
+            const tonemappingEffect = activeEffects[activeEffects.length - 1];
+            if (debug)
+                console.log(`[PostProcessing] Only tonemapping effects in stack — applying directly to renderer`);
+            // Store previous values on first activation
+            if (!this._tonemappingOnlyActive) {
+                this._previousToneMapping = this._context.renderer.toneMapping;
+                this._previousToneMappingExposure = this._context.renderer.toneMappingExposure;
+                this._tonemappingOnlyActive = true;
+            }
+            // Apply tonemapping directly to renderer
+            this._context.renderer.toneMapping = tonemappingEffect.threeToneMapping;
+            this._context.renderer.toneMappingExposure = tonemappingEffect.toneMappingExposure;
+            // Tear down any existing postprocessing pipeline
+            this._handler?.unapply(false);
+            return;
+        }
+        // We have non-tonemapping effects — restore renderer tonemapping if we were in tonemapping-only mode
+        this.restoreTonemapping();
+        // Build full postprocessing pipeline
+        this.ensureHandler()
+            .then(handler => {
+            if (!handler)
+                return;
+            return handler.apply(activeEffects);
+        })
+            .then(() => {
+            if (this._handler) {
+                if (this.multisampling === "auto") {
+                    this._handler.multisampling = DeviceUtilities.isMobileDevice()
+                        ? 2
+                        : 4;
+                }
+                else {
+                    this._handler.multisampling = Math.max(0, Math.min(this.multisampling, this._context.renderer.capabilities.maxSamples));
+                }
+                if (debug)
+                    console.debug(`[PostProcessing] Set multisampling to ${this._handler.multisampling} (Is Mobile: ${DeviceUtilities.isMobileDevice()})`);
+            }
+        });
+        this._enabledTime = this._context.time.realtimeSinceStartup;
+    }
+    /** Restore renderer tonemapping to previous values when leaving tonemapping-only mode */
+    restoreTonemapping() {
+        if (this._tonemappingOnlyActive) {
+            if (this._previousToneMapping !== undefined)
+                this._context.renderer.toneMapping = this._previousToneMapping;
+            if (this._previousToneMappingExposure !== undefined)
+                this._context.renderer.toneMappingExposure = this._previousToneMappingExposure;
+            this._tonemappingOnlyActive = false;
+            this._previousToneMapping = undefined;
+            this._previousToneMappingExposure = undefined;
+            if (debug)
+                console.log(`[PostProcessing] Restored renderer tonemapping`);
+        }
+    }
+    /** Lazily creates the PostProcessingHandler to avoid loading the postprocessing library until actually needed */
+    async ensureHandler() {
+        if (!this._handler) {
+            const { PostProcessingHandler } = await import("../../engine-components/postprocessing/PostProcessingHandler.js");
+            if (!this._handler) {
+                this._handler = new PostProcessingHandler(this._context);
+            }
+        }
+        return this._handler;
+    }
+    /** @internal */
+    dispose() {
+        this.restoreTonemapping();
+        this._handler?.dispose();
+        this._handler = null;
+        this._composer = null;
+        this._effects.length = 0;
+    }
+}
+//# sourceMappingURL=postprocessing.js.map

package/lib/engine/postprocessing/postprocessing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postprocessing.js","sourceRoot":"","sources":["../../../src/engine/postprocessing/postprocessing.ts"],"names":[],"mappings":"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"}

package/lib/engine/postprocessing/types.d.ts

@@ -0,0 +1,39 @@
+import type { EffectComposer } from "postprocessing";
+import type { ToneMapping } from "three";
+import type { EffectComposer as ThreeEffectComposer } from "three/examples/jsm/postprocessing/EffectComposer.js";
+/**
+ * Minimal interface for a postprocessing effect as seen by the core stack.
+ * Implemented by `PostProcessingEffect` in engine-components.
+ */
+export interface IPostProcessingEffect {
+    readonly active: boolean;
+    readonly enabled: boolean;
+    /** When true, this effect is a tonemapping effect. The core stack uses this to detect tonemapping-only scenarios. */
+    readonly isToneMapping?: boolean;
+}
+/**
+ * Extended interface for tonemapping effects.
+ * When ONLY tonemapping effects are in the stack, the core applies tonemapping
+ * directly to the renderer instead of creating a full postprocessing pipeline.
+ */
+export interface ITonemappingEffect extends IPostProcessingEffect {
+    readonly isToneMapping: true;
+    /** The three.js ToneMapping enum value to apply to the renderer */
+    readonly threeToneMapping: ToneMapping;
+    /** The exposure value to apply to the renderer */
+    readonly toneMappingExposure: number;
+}
+/**
+ * Interface for the pipeline builder that manages the EffectComposer.
+ * Implemented by `PostProcessingHandler` in engine-components.
+ */
+export interface IPostProcessingHandler {
+    readonly composer: EffectComposer | ThreeEffectComposer | null;
+    readonly hasSmaaEffect: boolean;
+    multisampling: number;
+    adaptivePixelRatio: boolean;
+    apply(effects: IPostProcessingEffect[]): Promise<void>;
+    unapply(dispose?: boolean): void;
+    updateAdaptivePixelRatio(): void;
+    dispose(): void;
+}

package/lib/engine/postprocessing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/engine/postprocessing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/postprocessing/types.ts"],"names":[],"mappings":""}

package/lib/engine/webcomponents/WebXRButtons.js

@@ -101,10 +101,24 @@ export class WebXRButtonFactory {
         this._arButton = button;
         button.classList.add("webxr-button");
         button.dataset["needle"] = "webxr-ar-button";
-        button.innerText = "Enter AR";
-        button.prepend(getIconElement("view_in_ar"));
         button.title = "Click to start an AR session";
-        button.addEventListener("click", () => NeedleXRSession.start(mode, init));
+        const setDefaultText = () => {
+            button.innerText = "Enter AR";
+            button.prepend(getIconElement("view_in_ar"));
+        };
+        setDefaultText();
+        let tapAgainTimeout;
+        button.addEventListener("click", () => {
+            NeedleXRSession.start(mode, init);
+            if (DeviceUtilities.isiOS() && !DeviceUtilities.isVisionOS()) {
+                setTimeout(() => {
+                    button.innerHTML = "Tap again";
+                    button.prepend(getIconElement("view_in_ar"));
+                    clearTimeout(tapAgainTimeout);
+                    tapAgainTimeout = setTimeout(setDefaultText, 4000);
+                }, 500);
+            }
+        });
         NeedleMenu.setElementPriority(button, arButtonPriority);
         this.updateSessionSupported(button, mode);
         this.listenToXRSessionState(button, mode);

package/lib/engine/webcomponents/WebXRButtons.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebXRButtons.js","sourceRoot":"","sources":["../../../src/engine/webcomponents/WebXRButtons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAyB,MAAM,wBAAwB,CAAC;AAE5F,gJAAgJ;AAEhJ,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAEnB,MAAM,CAAC,SAAS,CAAqB;IACrC,MAAM,CAAC,MAAM;QACjB,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,WAAW;QACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAY,kBAAkB,KAAK,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC;IAGlF,IAAI,eAAe,KAAK,OAAO,IAAI,CAAC,gBAAgB,CAAA,CAAC,CAAC;IAC9C,gBAAgB,CAAqB;IAE7C,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACjC,SAAS,CAAqB;IAEtC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAS,CAAA,CAAC,CAAC;IAChC,SAAS,CAAqB;IAEtC,IAAI,iBAAiB,KAAK,OAAO,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACnD,kBAAkB,CAAqB;IAE/C,IAAI,QAAQ,KAAK,OAAO,cAAc,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEtE;;;MAGE;IACF,qBAAqB;QACjB,IAAI,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAAC;QAC9C,MAAM,iBAAiB,GAAG,eAAe,CAAC,mBAAmB,EAAE,CAAC;QAChE,IAAI,UAAU,GAAG,YAAY,CAAC;QAC9B,oFAAoF;QACpF,IAAI,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/B,UAAU,GAAG,YAAY,CAAC;QAC9B,CAAC;aACI,IAAI,iBAAiB,IAAI,eAAe,CAAC,KAAK,EAAE,EAAE,CAAC;YACpD,UAAU,GAAG,mBAAmB,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7C,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;QAE/D,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,gBAAgB,GAA6B,IAAI,CAAC;QACtD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAClC,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;YAE7C,IAAI,MAAM,EAAE,CAAC;gBACT,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC;gBAClC,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC;YACrC,CAAC;YAED,+BAA+B;YAC/B,IAAI,eAAe,IAAI,gBAAgB;gBACnC,gBAAgB,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAE5D,IAAI,gBAAgB,EAAE,CAAC;gBACnB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBAC/C,gBAAgB,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;oBACvC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACtD,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;oBACX,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;oBAClD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC,CAAC,CAAC;YACP,CAAC;iBACI,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YACjE,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAClB,CAAC;IACD;;;;;;OAMG;IACH,cAAc,CAAC,IAAoB;QAC/B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAE1C,MAAM,IAAI,GAAkB,cAAc,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QAExB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC;QAC7C,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAA;QAC5C,MAAM,CAAC,KAAK,GAAG,8BAA8B,CAAC;QAC9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACxD,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,MAAM,CAAC,KAAK,GAAG,4CAA4C,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,wDAAwD;YACxF,SAAS,CAAC,EAAE,EAAE,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAEpG,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;;MAME;IACF,cAAc,CAAC,IAAoB;QAC/B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAE1C,MAAM,IAAI,GAAkB,cAAc,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACxB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC;QAC7C,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,GAAG,6BAA6B,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,UAAU,CAAC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACxD,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,MAAM,CAAC,KAAK,GAAG,4CAA4C,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,wDAAwD;YACxF,SAAS,CAAC,EAAE,EAAE,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAEpG,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;MAGE;IACF,uBAAuB;QACnB,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC;QAC5D,MAAM,OAAO,GAAG,mCAAmC,CAAA;QACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,0BAA0B,CAAC;QACtD,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,GAAG,6DAA6D,CAAC;QAC7E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAClC,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,OAAO,GAAG,YAAY,CAAC;YACnC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC3B,kBAAkB,CAAC,+CAA+C,GAAG,GAAG,GAAG,qBAAqB,CAAC,CAAC;YACtG,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACxC,8EAA8E;QAC9E,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,wDAAwD;YAC1F,SAAS,CAAC,EAAE,EAAE,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE;gBAChD,IAAI,SAAS,CAAC,EAAE,EAAE,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC;oBACnD,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;gBAClC,CAAC;qBACI,CAAC;oBACF,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;gBAC9B,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,YAAY;QACR,OAAO,cAAc,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC;IACvD,CAAC;IAEO,sBAAsB,CAAC,MAAyB,EAAE,IAAmB;QACzE,IAAI,IAAI,KAAK,cAAc,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC;YACtF,yEAAyE;YACzE,2EAA2E;YAC3E,+CAA+C;YAC/C,OAAO;QACX,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;YAC9B,OAAO;QACX,CAAC;QACD,eAAe,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;YACtD,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,IAAI,gBAAgB,EAAE,IAAI,CAAC,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,GAAG,2HAA2H,GAAG,IAAI,CAAC,CAAC;QAChN,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,0BAA0B,CAAC,OAAoB;QACnD,gBAAgB,CAAC,CAAC,CAAC,EAAE;YACjB,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YACpD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,cAAc,CAAC,CAAC,CAAC,EAAE;YACf,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,SAAS;gBACxC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,sBAAsB,CAAC,MAAyB,EAAE,IAAoB;QAE1E,IAAI,IAAI,EAAE,CAAC;YACP,eAAe,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;gBACzC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBACrB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;oBAC/C,8CAA8C;oBAC9C,wDAAwD;oBACxD,qDAAqD;gBACzD,CAAC;qBACI,CAAC;oBACF,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;oBACzC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACvB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;gBACpD,CAAC;YACL,CAAC,CAAC,CAAC;YACH,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;gBACpC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBAClD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBACnD,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;gBACzC,8CAA8C;YAClD,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"WebXRButtons.js","sourceRoot":"","sources":["../../../src/engine/webcomponents/WebXRButtons.ts"],"names":[],"mappings":"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"}

package/lib/engine/webcomponents/icons.js

@@ -18,8 +18,10 @@ export function getIconElement(str) {
     span.setAttribute("aria-label", str + " icon");
     span.setAttribute("aria-hidden", "true");
     fontReady(fontname).then(res => {
-        if (res)
+        if (res) {
             span.style.visibility = "";
+            span.innerText = str; // re-assign, otherise more_vert doesnt show up. Maybe because of layout restructuring on mobile
+        }
         else {
             if (str === "more_vert") {
                 span.style.visibility = "";

package/lib/engine/webcomponents/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../../src/engine/webcomponents/icons.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../../src/engine/webcomponents/icons.ts"],"names":[],"mappings":"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"}

package/lib/engine/xr/NeedleXRSession.d.ts

@@ -122,6 +122,7 @@ export declare class NeedleXRSession implements INeedleXRSession {
      * @returns true if the browser supports the given XRSessionMode
      */
     static isSessionSupported(mode: XRSessionMode): Promise<boolean>;
+    private static _sessionSupportedCache;
     private static _currentSessionRequest?;
     private static _activeSession;
     /** Register to listen to XRSession start events. Unsubscribe with `offXRSessionStart` */

package/lib/engine/xr/NeedleXRSession.js

@@ -33,7 +33,6 @@ function getDOMOverlayElement(domElement) {
 }
 handleSessionGranted();
 async function handleSessionGranted() {
-    // await delay(400);
     let defaultMode = "immersive-vr";
     try {
         // In app clips we default to AR
@@ -56,7 +55,6 @@ async function handleSessionGranted() {
         // showBalloonWarning("NeedleXRSession: Error while checking XR support: " + (e as Error).message);
         return;
     }
-    // showBalloonMessage("sessiongranted: " + defaultMode);
     // TODO: asap session granted doesnt handle the pre-room yet
     if (getParam("debugasap")) {
         let asapSession = globalThis["needle:XRSession"];
@@ -262,8 +260,18 @@ export class NeedleXRSession {
      * @param mode The XRSessionMode to check if it is supported
      * @returns true if the browser supports the given XRSessionMode
      */
-    static isSessionSupported(mode) { return this.xrSystem?.isSessionSupported(mode).catch(err => { if (debug)
-        console.error(err); return false; }) ?? Promise.resolve(false); }
+    static isSessionSupported(mode) {
+        // We cache the result of the session support check to avoid unnecessary calls to isSessionSupported. This is especially important for user input events that internally run session support checks during onclick where the event must be resolved as fast as possible.
+        if (this._sessionSupportedCache[mode] !== undefined) {
+            return Promise.resolve(this._sessionSupportedCache[mode]);
+        }
+        return this.xrSystem?.isSessionSupported(mode).then(supported => {
+            this._sessionSupportedCache[mode] = supported;
+            return supported;
+        }).catch(err => { if (debug)
+            console.error(err); return false; }) ?? Promise.resolve(false);
+    }
+    static _sessionSupportedCache = {};
     static _currentSessionRequest;
     static _activeSession;
     /** Register to listen to XRSession start events. Unsubscribe with `offXRSessionStart` */
@@ -395,9 +403,10 @@ export class NeedleXRSession {
         // handle iOS platform where "immersive-ar" is special:
         // - we either launch QuickLook
         // - or forward to the Needle App Clip experience for WebXR AR
-        // TODO: should we add a separate mode (e.g. "AR")? https://linear.app/needle/issue/NE-5303
         if (DeviceUtilities.isiOS()) {
-            const arSupported = await this.isARSupported().catch(() => false);
+            // IMPORTANT: on iOS we should have prefetched immersive-ar support already on app start (this is done in xrInit()) - if not then clicking the Enter AR button for the very first time does not immediately open the AppClip overlay.  
+            // Without an async await here the overlay *does* however open even when clicking for the very first time. (To test this you need to clear the local experience cache on device)
+            const arSupported = this._sessionSupportedCache["immersive-ar"] ?? await this.isARSupported();
             // On VisionOS, we use QuickLook for AR experiences; no AppClip support for now.
             if (DeviceUtilities.isVisionOS() && !arSupported && (mode === "ar" || mode === "immersive-ar")) {
                 mode = "quicklook";
@@ -412,6 +421,9 @@ export class NeedleXRSession {
             }
             if (!arSupported && (mode === "immersive-ar" || mode === "ar")) {
                 this.invokeSessionRequestStart("immersive-ar", init);
+                // if we are in an iframe, we need to navigate the top window
+                const topWindow = window.top || window;
+                const originalUrl = topWindow.location.href;
                 // Forward to the AppClip experience (Using the apple.com url the appclip overlay shows immediately)
                 // const url =`https://appclip.needle.tools/ar?url=${(location.href)}`;
                 const url = new URL("https://appclip.apple.com/id?p=tools.needle.launch-app.Clip");
@@ -422,16 +434,37 @@ export class NeedleXRSession {
                     source: "NeedleXRSession.start",
                     url: urlStr,
                 });
-                // if we are in an iframe, we need to navigate the top window
-                const topWindow = window.top || window;
                 try {
                     console.debug("iOS device detected - opening Needle App Clip for AR experience", { mode, init, url });
+                    // Prewarm the appclip by opening the URL
+                    // BUT on safari triggering this with multiple URLs causes the
+                    // Browser to show the dialogue AGAIN in the background
+                    // SO: we don't do it here...
+                    const key = "appclip-prewarm:" + new URL(url).origin;
+                    const allowMultipleNavigations = sessionStorage.getItem(key) === null;
+                    if (allowMultipleNavigations) {
+                        const secondUrl = new URL(url);
+                        secondUrl.searchParams.set("prewarm", "1");
+                        // eslint-disable-next-line xss/no-location-href-assign
+                        topWindow.location.href = secondUrl.toString();
+                        // wait a bit to give the device time to fetch the app clip metadata - this seems to fix the double tap issue (500 ms seem to work)
+                        await new Promise(res => setTimeout(res, 300));
+                    }
                     // navigate to app clip url but keep the current url in history, open in same tab
                     // eslint-disable-next-line xss/no-location-href-assign
                     topWindow.location.href = urlStr;
+                    if (allowMultipleNavigations && !DeviceUtilities.isSafari()) {
+                        setTimeout(() => {
+                            const url2 = new URL(url);
+                            url2.searchParams.set("prewarm", "1");
+                            // eslint-disable-next-line xss/no-location-href-assign
+                            topWindow.location.href = url2.toString();
+                        }, 500);
+                    }
+                    sessionStorage.setItem(key, "1");
                 }
                 catch (e) {
-                    console.warn("Error navigating to AppClip " + urlStr + "\n", e);
+                    console.warn(`Error navigating to AppClip ${urlStr}\n`, e);
                     // if top window navigation fails and we are in an iframe, we try to navigate the top window directly
                     const weAreInIframe = window !== window.top;
                     if (weAreInIframe) {
@@ -449,7 +482,7 @@ export class NeedleXRSession {
             }
         }
         if (mode === "quicklook") {
-            console.warn("QuickLook mode is only supported on iOS devices");
+            console.error("QuickLook mode is only supported on iOS devices.");
             return null;
         }
         // Since we now know we are not on iOS, ar mode becomes "immersive-ar"