@iwsdk/core 0.4.2 → 0.5.1

package/dist/ui/screenspace.d.ts

@@ -4,185 +4,72 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Types } from '../ecs/component.js';
-/**
- * CSS‑like screen‑space layout for a {@link PanelUI}.
- *
- * @remarks
- * When XR is not presenting, the panel is re‑parented under the active camera and positioned
- * in pixels using CSS‑like expressions for `top`/`left`/`bottom`/`right`, with `width`/`height`
- * specified in any CSS units supported by the browser (e.g. `px`, `vw`, `vh`, `%`, `em`).
- *
- * On XR session start, the panel is automatically returned to world space.
- *
- * All size inputs are ultimately converted to meters using the camera frustum at `zOffset`.
- *
- * @example Place a panel at bottom‑right, 40% width, auto height
- * ```ts
- * entity.addComponent(PanelUI, { config: '/ui/menu.json' })
- * entity.addComponent(ScreenSpace, {
- *   width: '40vw',
- *   height: 'auto',
- *   bottom: '24px',
- *   right: '24px',
- *   zOffset: 0.25,
- * })
- * ```
- *
- * @category UI
- */
-export declare const ScreenSpace: import("elics").Component<{
-    /** CSS size expression for height (e.g., `240px`, `40vh`, `auto`). */
-    height: {
-        type: Types.String;
-        default: string;
-    };
-    /** CSS size expression for width (e.g., `480px`, `40vw`, `auto`). */
-    width: {
-        type: Types.String;
-        default: string;
-    };
-    /** CSS absolute `top` position (pixels/percent/vh) or `auto`. */
-    top: {
-        type: Types.String;
-        default: string;
-    };
-    /** CSS absolute `bottom` position (pixels/percent/vh) or `auto`. */
-    bottom: {
-        type: Types.String;
-        default: string;
-    };
-    /** CSS absolute `left` position (pixels/percent/vw) or `auto`. */
-    left: {
-        type: Types.String;
-        default: string;
-    };
-    /** CSS absolute `right` position (pixels/percent/vw) or `auto`. */
-    right: {
-        type: Types.String;
-        default: string;
-    };
-    /** Distance in meters in front of the camera’s near plane. */
-    zOffset: {
-        type: Types.Float32;
-        default: number;
-    };
-}>;
+export { ScreenSpace } from './screenspace-component.js';
 declare const ScreenSpaceUISystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
     panels: {
-        required: (import("elics").Component<{
-            config: {
-                type: Types.String;
-                default: string;
-            };
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
-        }> | import("elics").Component<{
-            document: {
-                type: Types.Object;
-                default: undefined;
-            };
-        }> | import("elics").Component<{
-            /** CSS size expression for height (e.g., `240px`, `40vh`, `auto`). */
+        required: import("elics").Component<{
             height: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS size expression for width (e.g., `480px`, `40vw`, `auto`). */
             width: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `top` position (pixels/percent/vh) or `auto`. */
             top: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `bottom` position (pixels/percent/vh) or `auto`. */
             bottom: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `left` position (pixels/percent/vw) or `auto`. */
             left: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `right` position (pixels/percent/vw) or `auto`. */
             right: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** Distance in meters in front of the camera’s near plane. */
             zOffset: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-        }>)[];
+        }>[];
     };
 }, import("../index.js").World, import("../ecs/system.js").System<import("elics").SystemSchema, {
     panels: {
-        required: (import("elics").Component<{
-            config: {
-                type: Types.String;
-                default: string;
-            };
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
-        }> | import("elics").Component<{
-            document: {
-                type: Types.Object;
-                default: undefined;
-            };
-        }> | import("elics").Component<{
-            /** CSS size expression for height (e.g., `240px`, `40vh`, `auto`). */
+        required: import("elics").Component<{
             height: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS size expression for width (e.g., `480px`, `40vw`, `auto`). */
             width: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `top` position (pixels/percent/vh) or `auto`. */
             top: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `bottom` position (pixels/percent/vh) or `auto`. */
             bottom: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `left` position (pixels/percent/vw) or `auto`. */
             left: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** CSS absolute `right` position (pixels/percent/vw) or `auto`. */
             right: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
-            /** Distance in meters in front of the camera’s near plane. */
             zOffset: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-        }>)[];
+        }>[];
     };
 }>>;
 /**
@@ -193,29 +80,54 @@ declare const ScreenSpaceUISystem_base: import("elics").SystemConstructor<import
  *   a camera‑relative plane given by `zOffset`.
  * - Automatically toggles between screen‑space (under the camera) and world‑space depending on
  *   `renderer.xr.isPresenting`.
- * - Sets {@link UIKitDocument.setTargetDimensions} so that the UI scales to the requested size
- *   without distorting aspect ratio.
+ * - Uses {@link UIKitDocument.setTargetDimensions} while camera-local, then restores intrinsic
+ *   size in XR so the entity transform remains the world-space scale authority.
  *
  * @category UI
  */
 export declare class ScreenSpaceUISystem extends ScreenSpaceUISystem_base {
     private screenSpaceDescendants;
+    private documentSizes;
+    private entityDocuments;
+    private layoutEnvironment?;
     private layoutHelpers;
     private resized;
+    private autoDimensionWarned;
     /** Prepare hidden DOM helpers and resize listener. */
     init(): void;
     /** Move panels between world and screen space and recompute layout on changes. */
     update(): void;
+    /** Detect every renderer/camera input used to map screen pixels into world units. */
+    private hasLayoutEnvironmentChanged;
+    /** Resolve legacy component-backed and manifest-backed UIKit documents. */
+    private resolveDocument;
+    /** Track intrinsic UIKit dimensions so late font/content layout invalidates positioning. */
+    private hasDocumentSizeChanged;
     /** Compute pixel size/position and apply camera‑relative transform. */
     private calculateLayout;
     /**
      * Evaluate CSS expressions for width/height using a temporary DOM node.
      * Returns pixel values from `window.getComputedStyle`.
+     *
+     * @remarks
+     * Older scene documents may explicitly declare `'auto'`. On a floating
+     * helper `<div>` the browser resolves an unconstrained `auto`
+     * dimension to `0px`. A `0px` target collapses {@link
+     * UIKitDocument.setTargetDimensions} and the panel retains its intrinsic
+     * world-space size inside camera space, blowing the UI up to most of the
+     * viewport. Until aspect-ratio derivation from the
+     * other axis lands, treat `'auto'` as an unsupported size for screen-space
+     * layout: warn once per axis, and clamp the contributing CSS expression to
+     * a viewport-relative fallback that produces a sensibly-sized HUD.
      */
     private getComputedDimensionValues;
+    /**
+     * Substitute a `'25vw'` / `'25vh'` fallback for `'auto'` on the given axis,
+     * logging a single warning per axis the first time it triggers.
+     */
+    private resolveAutoDimension;
     /** Evaluate CSS absolute positioning and return `top`/`left` in pixels. */
     private getComputedPositionValues;
     destroy(): void;
 }
-export {};
 //# sourceMappingURL=screenspace.d.ts.map

package/dist/ui/screenspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenspace.d.ts","sourceRoot":"","sources":["../../src/ui/screenspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAS7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,WAAW;IAGpB,sEAAsE;;;;;IAEtE,qEAAqE;;;;;IAErE,iEAAiE;;;;;IAEjE,oEAAoE;;;;;IAEpE,kEAAkE;;;;;IAElE,mEAAmE;;;;;IAEnE,8DAA8D;;;;;EAIjE,CAAC;;;;;;;;;;;;;;;;;;;;;;YAhBE,sEAAsE;;;;;YAEtE,qEAAqE;;;;;YAErE,iEAAiE;;;;;YAEjE,oEAAoE;;;;;YAEpE,kEAAkE;;;;;YAElE,mEAAmE;;;;;YAEnE,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAZ9D,sEAAsE;;;;;YAEtE,qEAAqE;;;;;YAErE,iEAAiE;;;;;YAEjE,oEAAoE;;;;;YAEpE,kEAAkE;;;;;YAElE,mEAAmE;;;;;YAEnE,8DAA8D;;;;;;;;AAKlE;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,wBAEvC;IACA,OAAO,CAAC,sBAAsB,CAAkB;IAChD,OAAO,CAAC,aAAa,CAKnB;IACF,OAAO,CAAC,OAAO,CAAQ;IAEvB,sDAAsD;IACtD,IAAI;IAoBJ,kFAAkF;IAClF,MAAM,IAAI,IAAI;IA0Cd,uEAAuE;IACvE,OAAO,CAAC,eAAe;IAmEvB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAgBlC,2EAA2E;IAC3E,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,IAAI,IAAI;CAOhB"}
+{"version":3,"file":"screenspace.d.ts","sourceRoot":"","sources":["../../src/ui/screenspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQzD;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,wBAEvC;IACA,OAAO,CAAC,sBAAsB,CAAkB;IAChD,OAAO,CAAC,aAAa,CAGjB;IACJ,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAKnB;IACF,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,mBAAmB,CAAmC;IAE9D,sDAAsD;IACtD,IAAI;IAoBJ,kFAAkF;IAClF,MAAM,IAAI,IAAI;IAkDd,qFAAqF;IACrF,OAAO,CAAC,2BAA2B;IAkBnC,2EAA2E;IAC3E,OAAO,CAAC,eAAe;IA4BvB,4FAA4F;IAC5F,OAAO,CAAC,sBAAsB;IAe9B,uEAAuE;IACvE,OAAO,CAAC,eAAe;IA4EvB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B,2EAA2E;IAC3E,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,IAAI,IAAI;CAOhB"}

package/dist/ui/screenspace.js

@@ -1,8 +1,8 @@
-import { createComponent, Types } from 'elics';
 import { createSystem } from '../ecs/system.js';
-import '../runtime/three.js';
-import { PanelUI, PanelDocument } from './ui.js';
-import { MathUtils } from 'three';
+import { UIKitDocument } from './document.js';
+import { ScreenSpace } from './screenspace-component.js';
+import './ui.js';
+import { PanelDocument } from './panel-components.js';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -10,48 +10,6 @@ import { MathUtils } from 'three';
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/**
- * CSS‑like screen‑space layout for a {@link PanelUI}.
- *
- * @remarks
- * When XR is not presenting, the panel is re‑parented under the active camera and positioned
- * in pixels using CSS‑like expressions for `top`/`left`/`bottom`/`right`, with `width`/`height`
- * specified in any CSS units supported by the browser (e.g. `px`, `vw`, `vh`, `%`, `em`).
- *
- * On XR session start, the panel is automatically returned to world space.
- *
- * All size inputs are ultimately converted to meters using the camera frustum at `zOffset`.
- *
- * @example Place a panel at bottom‑right, 40% width, auto height
- * ```ts
- * entity.addComponent(PanelUI, { config: '/ui/menu.json' })
- * entity.addComponent(ScreenSpace, {
- *   width: '40vw',
- *   height: 'auto',
- *   bottom: '24px',
- *   right: '24px',
- *   zOffset: 0.25,
- * })
- * ```
- *
- * @category UI
- */
-const ScreenSpace = createComponent('ScreenSpace', {
-    /** CSS size expression for height (e.g., `240px`, `40vh`, `auto`). */
-    height: { type: Types.String, default: 'auto' },
-    /** CSS size expression for width (e.g., `480px`, `40vw`, `auto`). */
-    width: { type: Types.String, default: 'auto' },
-    /** CSS absolute `top` position (pixels/percent/vh) or `auto`. */
-    top: { type: Types.String, default: 'auto' },
-    /** CSS absolute `bottom` position (pixels/percent/vh) or `auto`. */
-    bottom: { type: Types.String, default: 'auto' },
-    /** CSS absolute `left` position (pixels/percent/vw) or `auto`. */
-    left: { type: Types.String, default: 'auto' },
-    /** CSS absolute `right` position (pixels/percent/vw) or `auto`. */
-    right: { type: Types.String, default: 'auto' },
-    /** Distance in meters in front of the camera’s near plane. */
-    zOffset: { type: Types.Float32, default: 0.2 },
-}, 'Component for screen-space UI positioning');
 /**
  * Positions {@link PanelUI} documents relative to the camera with CSS‑like semantics.
  *
@@ -60,17 +18,19 @@ const ScreenSpace = createComponent('ScreenSpace', {
  *   a camera‑relative plane given by `zOffset`.
  * - Automatically toggles between screen‑space (under the camera) and world‑space depending on
  *   `renderer.xr.isPresenting`.
- * - Sets {@link UIKitDocument.setTargetDimensions} so that the UI scales to the requested size
- *   without distorting aspect ratio.
+ * - Uses {@link UIKitDocument.setTargetDimensions} while camera-local, then restores intrinsic
+ *   size in XR so the entity transform remains the world-space scale authority.
  *
  * @category UI
  */
 class ScreenSpaceUISystem extends createSystem({
-    panels: { required: [PanelUI, PanelDocument, ScreenSpace] },
+    panels: { required: [ScreenSpace] },
 }) {
     constructor() {
         super(...arguments);
         this.screenSpaceDescendants = [];
+        this.documentSizes = new WeakMap();
+        this.entityDocuments = new WeakMap();
         this.layoutHelpers = {
             dimensionContainer: document.createElement('div'),
             positionContainer: document.createElement('div'),
@@ -78,6 +38,7 @@ class ScreenSpaceUISystem extends createSystem({
             positionElement: document.createElement('div'),
         };
         this.resized = true;
+        this.autoDimensionWarned = { width: false, height: false };
     }
     /** Prepare hidden DOM helpers and resize listener. */
     init() {
@@ -89,51 +50,114 @@ class ScreenSpaceUISystem extends createSystem({
         this.layoutHelpers.positionContainer.style.height = '100vh';
         this.layoutHelpers.positionContainer.style.position = 'relative';
         this.layoutHelpers.positionContainer.style.visibility = 'hidden';
-        window.addEventListener('resize', () => {
+        const onResize = () => {
             this.resized = true;
-        }, false);
+        };
+        window.addEventListener('resize', onResize, false);
+        this.cleanupFuncs.push(() => window.removeEventListener('resize', onResize, false));
     }
     /** Move panels between world and screen space and recompute layout on changes. */
     update() {
         this.screenSpaceDescendants.length = 0;
+        const resized = this.resized;
+        const layoutEnvironmentChanged = this.hasLayoutEnvironmentChanged();
         this.queries.panels.entities.forEach((entity) => {
             const parent = entity.object3D;
-            const document = PanelDocument.data.document[entity.index];
+            const document = this.resolveDocument(entity);
             if (!document) {
                 return;
             } // Skip if UI not loaded yet
             const panelInScreenSpace = document.parent === this.camera;
+            const documentSizeChanged = this.hasDocumentSizeChanged(document);
             if (this.renderer.xr.isPresenting && panelInScreenSpace) {
                 // Move back to world space when entering XR
                 parent === null || parent === void 0 ? void 0 : parent.add(document);
+                document.clearTargetDimensions();
                 // Reset position that were set during screen space layout
                 document.position.set(0, 0, 0);
             }
             else if (!this.renderer.xr.isPresenting && !panelInScreenSpace) {
                 // Move to screen space when not in XR
                 this.camera.add(document);
-                this.calculateLayout(entity);
+                this.calculateLayout(entity, document);
             }
-            else if (panelInScreenSpace && this.resized) {
-                // Recalculate layout on resize
-                this.calculateLayout(entity);
-                this.resized = false;
+            else if (panelInScreenSpace &&
+                (resized || documentSizeChanged || layoutEnvironmentChanged)) {
+                // Recalculate when the viewport, camera projection, or UIKit's intrinsic
+                // layout changes. In particular, three.js restores the browser camera one
+                // frame after XR ends, so the first non-XR layout may still see the XR
+                // projection and must self-correct on the following frame.
+                this.calculateLayout(entity, document);
             }
             if (document.parent === this.camera) {
                 this.screenSpaceDescendants.push(document);
             }
         });
+        this.resized = false;
         const scene = this.scene;
         scene.screenSpaceDescendants =
             this.screenSpaceDescendants.length > 0
                 ? this.screenSpaceDescendants
                 : undefined;
     }
+    /** Detect every renderer/camera input used to map screen pixels into world units. */
+    hasLayoutEnvironmentChanged() {
+        const next = {
+            canvasWidth: this.renderer.domElement.clientWidth,
+            canvasHeight: this.renderer.domElement.clientHeight,
+            // Matrix element 5 is the vertical projection scale. Unlike camera.fov,
+            // it also reflects zoom and direct projection-matrix changes.
+            projectionScaleY: this.camera.projectionMatrix.elements[5],
+        };
+        const previous = this.layoutEnvironment;
+        this.layoutEnvironment = next;
+        return (previous == null ||
+            previous.canvasWidth !== next.canvasWidth ||
+            previous.canvasHeight !== next.canvasHeight ||
+            previous.projectionScaleY !== next.projectionScaleY);
+    }
+    /** Resolve legacy component-backed and manifest-backed UIKit documents. */
+    resolveDocument(entity) {
+        const host = entity.object3D;
+        if (!host) {
+            return undefined;
+        }
+        const cached = this.entityDocuments.get(host);
+        if (cached && !cached.disposed) {
+            return cached;
+        }
+        const componentDocument = PanelDocument.data.document[entity.index];
+        if (componentDocument && !componentDocument.disposed) {
+            this.entityDocuments.set(host, componentDocument);
+            return componentDocument;
+        }
+        let discovered;
+        host.traverse((object) => {
+            if (!discovered && object instanceof UIKitDocument && !object.disposed) {
+                discovered = object;
+            }
+        });
+        if (discovered) {
+            this.entityDocuments.set(host, discovered);
+        }
+        return discovered;
+    }
+    /** Track intrinsic UIKit dimensions so late font/content layout invalidates positioning. */
+    hasDocumentSizeChanged(document) {
+        const size = document.computedSize;
+        if (!size) {
+            return false;
+        }
+        const previous = this.documentSizes.get(document);
+        this.documentSizes.set(document, size);
+        return (previous == null ||
+            previous.width !== size.width ||
+            previous.height !== size.height);
+    }
     /** Compute pixel size/position and apply camera‑relative transform. */
-    calculateLayout(entity) {
-        const document = PanelDocument.data.document[entity.index];
-        const computedSize = document === null || document === void 0 ? void 0 : document.computedSize;
-        if (document && computedSize) {
+    calculateLayout(entity, document) {
+        const computedSize = document.computedSize;
+        if (computedSize) {
             const widthExp = entity.getValue(ScreenSpace, 'width');
             const heightExp = entity.getValue(ScreenSpace, 'height');
             const top = entity.getValue(ScreenSpace, 'top');
@@ -149,9 +173,18 @@ class ScreenSpaceUISystem extends createSystem({
             // Screen dimensions
             const W = this.renderer.domElement.clientWidth;
             const H = this.renderer.domElement.clientHeight;
+            const projectionScaleY = this.camera.projectionMatrix.elements[5];
+            // A hidden or transitioning canvas can temporarily report unusable
+            // dimensions. Leave the document attached and retry when the tracked
+            // layout environment becomes valid instead of writing NaN/Infinity.
+            if (W <= 0 ||
+                H <= 0 ||
+                !Number.isFinite(projectionScaleY) ||
+                projectionScaleY <= 0) {
+                return;
+            }
             // Calculate world-to-pixel conversion for screen space at zOffset
-            const vFOV = MathUtils.degToRad(this.camera.fov);
-            const worldHeightAtZ = 2 * Math.tan(vFOV / 2) * zOffset;
+            const worldHeightAtZ = (2 * zOffset) / projectionScaleY;
             const worldPerPixel = worldHeightAtZ / H;
             // Calculate desired world space dimensions
             const targetWorldWidth = wPx * worldPerPixel;
@@ -182,12 +215,25 @@ class ScreenSpaceUISystem extends createSystem({
     /**
      * Evaluate CSS expressions for width/height using a temporary DOM node.
      * Returns pixel values from `window.getComputedStyle`.
+     *
+     * @remarks
+     * Older scene documents may explicitly declare `'auto'`. On a floating
+     * helper `<div>` the browser resolves an unconstrained `auto`
+     * dimension to `0px`. A `0px` target collapses {@link
+     * UIKitDocument.setTargetDimensions} and the panel retains its intrinsic
+     * world-space size inside camera space, blowing the UI up to most of the
+     * viewport. Until aspect-ratio derivation from the
+     * other axis lands, treat `'auto'` as an unsupported size for screen-space
+     * layout: warn once per axis, and clamp the contributing CSS expression to
+     * a viewport-relative fallback that produces a sensibly-sized HUD.
      */
     getComputedDimensionValues(widthExp, heightExp) {
+        const widthForLayout = this.resolveAutoDimension(widthExp, 'width');
+        const heightForLayout = this.resolveAutoDimension(heightExp, 'height');
         const { dimensionElement: element, dimensionContainer: container } = this.layoutHelpers;
         document.body.appendChild(container);
-        element.style.width = widthExp;
-        element.style.height = heightExp;
+        element.style.width = widthForLayout;
+        element.style.height = heightForLayout;
         container.appendChild(element);
         const pixelValues = window.getComputedStyle(element);
         const result = {
@@ -197,6 +243,22 @@ class ScreenSpaceUISystem extends createSystem({
         document.body.removeChild(container);
         return result;
     }
+    /**
+     * Substitute a `'25vw'` / `'25vh'` fallback for `'auto'` on the given axis,
+     * logging a single warning per axis the first time it triggers.
+     */
+    resolveAutoDimension(expression, axis) {
+        if (expression !== 'auto') {
+            return expression;
+        }
+        if (!this.autoDimensionWarned[axis]) {
+            this.autoDimensionWarned[axis] = true;
+            console.warn(`[ScreenSpace] ${axis}: 'auto' is not supported in screen-space layout; ` +
+                `clamping to '25v${axis === 'width' ? 'w' : 'h'}'. Set an explicit CSS ` +
+                `size (e.g. '320px', '40vw') to silence this warning.`);
+        }
+        return axis === 'width' ? '25vw' : '25vh';
+    }
     /** Evaluate CSS absolute positioning and return `top`/`left` in pixels. */
     getComputedPositionValues(widthPx, heightPx, { top = 'auto', bottom = 'auto', left = 'auto', right = 'auto' }) {
         const { positionElement: element, positionContainer: container } = this.layoutHelpers;

package/dist/ui/screenspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenspace.js","sources":["../../src/ui/screenspace.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"screenspace.js","sources":["../../src/ui/screenspace.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}