@realitycollective/iwsdk-uiextensions 0.1.0-preview.0

package/dist/systems/controls-system.js

@@ -0,0 +1,24 @@
+/**
+ * UIControlsSystem - upgrades `data-uix` controls in every loaded panel.
+ *
+ * Runs against ALL `PanelDocument` panels, not just windows: any IWSDK panel
+ * gains steppers, toggles, expandable labels and log views by markup alone.
+ */
+import { PanelDocument, createSystem } from '@iwsdk/core';
+import { upgradePanel } from '@realitycollective/webxr-uiextensions';
+export class UIControlsSystem extends createSystem({
+    panels: { required: [PanelDocument] },
+}) {
+    init() {
+        this.cleanupFuncs.push(this.queries.panels.subscribe('qualify', (entity) => this.upgrade(entity)));
+        this.queries.panels.entities.forEach((entity) => this.upgrade(entity));
+    }
+    upgrade(entity) {
+        const document = PanelDocument.data.document[entity.index];
+        if (!document?.rootElement) {
+            return;
+        }
+        upgradePanel(document, document.rootElement);
+    }
+}
+//# sourceMappingURL=controls-system.js.map

package/dist/systems/controls-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls-system.js","sourceRoot":"","sources":["../../src/systems/controls-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAiB,YAAY,EAAe,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,MAAM,OAAO,gBAAiB,SAAQ,YAAY,CAAC;IACjD,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE;CACtC,CAAC;IACS,IAAI;QACX,IAAI,CAAC,YAAY,CAAC,IAAI,CACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAC3E,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAEO,OAAO,CAAC,MAAc;QAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAE5C,CAAC;QACd,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAoC,CAAC,CAAC;IACxE,CAAC;CACF","sourcesContent":["/**\n * UIControlsSystem - upgrades `data-uix` controls in every loaded panel.\n *\n * Runs against ALL `PanelDocument` panels, not just windows: any IWSDK panel\n * gains steppers, toggles, expandable labels and log views by markup alone.\n */\nimport { PanelDocument, UIKitDocument, createSystem, type Entity } from '@iwsdk/core';\nimport type { UixElement } from '@realitycollective/webxr-uiextensions';\nimport { upgradePanel } from '@realitycollective/webxr-uiextensions';\n\nexport class UIControlsSystem extends createSystem({\n  panels: { required: [PanelDocument] },\n}) {\n  override init(): void {\n    this.cleanupFuncs.push(\n      this.queries.panels.subscribe('qualify', (entity) => this.upgrade(entity)),\n    );\n    this.queries.panels.entities.forEach((entity) => this.upgrade(entity));\n  }\n\n  private upgrade(entity: Entity): void {\n    const document = PanelDocument.data.document[entity.index] as\n      | UIKitDocument\n      | undefined;\n    if (!document?.rootElement) {\n      return;\n    }\n    upgradePanel(document, document.rootElement as unknown as UixElement);\n  }\n}\n"]}

package/dist/systems/dock-region-system.d.ts

@@ -0,0 +1,230 @@
+declare const UIDockRegionSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    regions: {
+        required: import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            flow: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly Row: "row";
+                    readonly Column: "column";
+                    readonly Grid: "grid";
+                };
+                default: "column";
+            };
+            pitch: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            columns: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            capacity: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            snapRadius: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+    docked: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+        }>)[];
+    };
+}, World, import("@iwsdk/core").System<import("elics").SystemSchema, {
+    regions: {
+        required: import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            flow: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly Row: "row";
+                    readonly Column: "column";
+                    readonly Grid: "grid";
+                };
+                default: "column";
+            };
+            pitch: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            columns: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            capacity: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            snapRadius: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+    docked: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+        }>)[];
+    };
+}>>;
+export declare class UIDockRegionSystem extends UIDockRegionSystem_base {
+    private registry;
+    private regionEntities;
+    private slotPosition;
+    private regionQuaternion;
+    init(): void;
+    update(): void;
+    private addRegion;
+    private removeRegion;
+    private dockWindow;
+    private undockWindow;
+}
+export {};

package/dist/systems/dock-region-system.js

@@ -0,0 +1,102 @@
+/**
+ * UIDockRegionSystem - keeps the region registry in sync with `UIDockRegion`
+ * entities and lays docked windows out in their region's slots each frame.
+ *
+ * Regions are ordinary entities: give one a `Follower` and its docked
+ * windows become a body-locked toolbar; leave it static for a world-locked
+ * console wall.
+ */
+import { Quaternion, Vector3, createSystem } from '@iwsdk/core';
+import { UIDockRegion, UIDockedTo, UIWindow } from '../components.js';
+import { DockMode } from '@realitycollective/webxr-uiextensions';
+import { regionRegistryFor } from '../region-registry-store.js';
+let autoRegionId = 0;
+export class UIDockRegionSystem extends createSystem({
+    regions: { required: [UIDockRegion] },
+    docked: { required: [UIWindow, UIDockedTo] },
+}) {
+    registry;
+    regionEntities = new Map();
+    slotPosition = new Vector3();
+    regionQuaternion = new Quaternion();
+    init() {
+        this.registry = regionRegistryFor(this.world);
+        this.cleanupFuncs.push(this.queries.regions.subscribe('qualify', (entity) => this.addRegion(entity)), this.queries.regions.subscribe('disqualify', (entity) => this.removeRegion(entity)), this.queries.docked.subscribe('qualify', (entity) => this.dockWindow(entity)), this.queries.docked.subscribe('disqualify', (entity) => this.undockWindow(entity)));
+        this.queries.regions.entities.forEach((entity) => this.addRegion(entity));
+        this.queries.docked.entities.forEach((entity) => this.dockWindow(entity));
+    }
+    update() {
+        for (const entity of this.queries.docked.entities) {
+            const windowId = entity.getValue(UIWindow, 'windowId');
+            const offset = this.registry.offsetOf(windowId);
+            const regionId = this.registry.regionOf(windowId);
+            const regionEntity = regionId === undefined ? undefined : this.regionEntities.get(regionId);
+            const regionObject = regionEntity?.object3D;
+            const object = entity.object3D;
+            if (!offset || !regionObject || !object || !object.parent) {
+                continue;
+            }
+            // Slot offset is region-local; express it in the window's parent space.
+            this.slotPosition.set(offset[0], offset[1], offset[2]);
+            regionObject.localToWorld(this.slotPosition);
+            object.parent.worldToLocal(this.slotPosition);
+            object.position.copy(this.slotPosition);
+            regionObject.getWorldQuaternion(this.regionQuaternion);
+            object.quaternion.copy(this.regionQuaternion);
+        }
+    }
+    addRegion(entity) {
+        let id = entity.getValue(UIDockRegion, 'regionId');
+        if (!id) {
+            id = `uix-region-${autoRegionId++}`;
+            entity.setValue(UIDockRegion, 'regionId', id);
+        }
+        if (this.registry.get(id)) {
+            return;
+        }
+        const definition = {
+            flow: entity.getValue(UIDockRegion, 'flow'),
+            pitch: entity.getValue(UIDockRegion, 'pitch'),
+            columns: Math.max(1, Math.round(entity.getValue(UIDockRegion, 'columns'))),
+            capacity: Math.max(0, Math.round(entity.getValue(UIDockRegion, 'capacity'))),
+            snapRadius: entity.getValue(UIDockRegion, 'snapRadius'),
+        };
+        this.registry.register(id, definition);
+        this.regionEntities.set(id, entity);
+    }
+    removeRegion(entity) {
+        const id = entity.getValue(UIDockRegion, 'regionId');
+        if (id && this.regionEntities.get(id) === entity) {
+            this.registry.unregister(id);
+            this.regionEntities.delete(id);
+        }
+    }
+    dockWindow(entity) {
+        const windowId = entity.getValue(UIWindow, 'windowId');
+        const regionId = entity.getValue(UIDockedTo, 'regionId');
+        if (!windowId || !regionId || !this.registry.get(regionId)) {
+            // Unknown region (or the window has no id yet) - docking is meaningless.
+            entity.removeComponent(UIDockedTo);
+            return;
+        }
+        try {
+            this.registry.dock(windowId, regionId);
+        }
+        catch {
+            // Region is full: reject the dock.
+            entity.removeComponent(UIDockedTo);
+            return;
+        }
+        // Docked windows are world-locked by definition (the region may follow).
+        if (entity.getValue(UIWindow, 'dockMode') !== DockMode.WorldLocked) {
+            entity.setValue(UIWindow, 'dockMode', DockMode.WorldLocked);
+        }
+    }
+    undockWindow(entity) {
+        const windowId = entity.getValue(UIWindow, 'windowId');
+        if (windowId) {
+            this.registry.undock(windowId);
+        }
+    }
+}
+//# sourceMappingURL=dock-region-system.js.map

package/dist/systems/dock-region-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock-region-system.js","sourceRoot":"","sources":["../../src/systems/dock-region-system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,MAAM,OAAO,kBAAmB,SAAQ,YAAY,CAAC;IACnD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE;IACrC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;CAC7C,CAAC;IACQ,QAAQ,CAAkB;IAC1B,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,YAAY,GAAG,IAAI,OAAO,EAAE,CAAC;IAC7B,gBAAgB,GAAG,IAAI,UAAU,EAAE,CAAC;IAEnC,IAAI;QACX,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9C,IAAI,CAAC,YAAY,CAAC,IAAI,CACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAC7E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EACnF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CACnF,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEQ,MAAM;QACb,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAW,CAAC;YACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,YAAY,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5F,MAAM,YAAY,GAAG,YAAY,EAAE,QAAQ,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC/B,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC1D,SAAS;YACX,CAAC;YACD,wEAAwE;YACxE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxC,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACvD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAW,CAAC;QAC7D,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,cAAc,YAAY,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAA8B;YAC5C,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAe;YACzD,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAW;YACvD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAW,CAAC,CAAC;YACpF,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAW,CAAC,CAAC;YACtF,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAW;SAClE,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAW,CAAC;QAC/D,IAAI,EAAE,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,MAAc;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAW,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAW,CAAC;QACnE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,yEAAyE;YACzE,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,yEAAyE;QACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAW,CAAC;QACjE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * UIDockRegionSystem - keeps the region registry in sync with `UIDockRegion`\n * entities and lays docked windows out in their region's slots each frame.\n *\n * Regions are ordinary entities: give one a `Follower` and its docked\n * windows become a body-locked toolbar; leave it static for a world-locked\n * console wall.\n */\nimport { Quaternion, Vector3, createSystem, type Entity } from '@iwsdk/core';\nimport { UIDockRegion, UIDockedTo, UIWindow } from '../components.js';\nimport { DockMode } from '@realitycollective/webxr-uiextensions';\nimport type { RegionDefinition, RegionFlow } from '@realitycollective/webxr-uiextensions';\nimport { regionRegistryFor } from '../region-registry-store.js';\nimport type { RegionRegistry } from '@realitycollective/webxr-uiextensions';\n\nlet autoRegionId = 0;\n\nexport class UIDockRegionSystem extends createSystem({\n  regions: { required: [UIDockRegion] },\n  docked: { required: [UIWindow, UIDockedTo] },\n}) {\n  private registry!: RegionRegistry;\n  private regionEntities = new Map<string, Entity>();\n  private slotPosition = new Vector3();\n  private regionQuaternion = new Quaternion();\n\n  override init(): void {\n    this.registry = regionRegistryFor(this.world);\n\n    this.cleanupFuncs.push(\n      this.queries.regions.subscribe('qualify', (entity) => this.addRegion(entity)),\n      this.queries.regions.subscribe('disqualify', (entity) => this.removeRegion(entity)),\n      this.queries.docked.subscribe('qualify', (entity) => this.dockWindow(entity)),\n      this.queries.docked.subscribe('disqualify', (entity) => this.undockWindow(entity)),\n    );\n    this.queries.regions.entities.forEach((entity) => this.addRegion(entity));\n    this.queries.docked.entities.forEach((entity) => this.dockWindow(entity));\n  }\n\n  override update(): void {\n    for (const entity of this.queries.docked.entities) {\n      const windowId = entity.getValue(UIWindow, 'windowId') as string;\n      const offset = this.registry.offsetOf(windowId);\n      const regionId = this.registry.regionOf(windowId);\n      const regionEntity = regionId === undefined ? undefined : this.regionEntities.get(regionId);\n      const regionObject = regionEntity?.object3D;\n      const object = entity.object3D;\n      if (!offset || !regionObject || !object || !object.parent) {\n        continue;\n      }\n      // Slot offset is region-local; express it in the window's parent space.\n      this.slotPosition.set(offset[0], offset[1], offset[2]);\n      regionObject.localToWorld(this.slotPosition);\n      object.parent.worldToLocal(this.slotPosition);\n      object.position.copy(this.slotPosition);\n      regionObject.getWorldQuaternion(this.regionQuaternion);\n      object.quaternion.copy(this.regionQuaternion);\n    }\n  }\n\n  private addRegion(entity: Entity): void {\n    let id = entity.getValue(UIDockRegion, 'regionId') as string;\n    if (!id) {\n      id = `uix-region-${autoRegionId++}`;\n      entity.setValue(UIDockRegion, 'regionId', id);\n    }\n    if (this.registry.get(id)) {\n      return;\n    }\n    const definition: Partial<RegionDefinition> = {\n      flow: entity.getValue(UIDockRegion, 'flow') as RegionFlow,\n      pitch: entity.getValue(UIDockRegion, 'pitch') as number,\n      columns: Math.max(1, Math.round(entity.getValue(UIDockRegion, 'columns') as number)),\n      capacity: Math.max(0, Math.round(entity.getValue(UIDockRegion, 'capacity') as number)),\n      snapRadius: entity.getValue(UIDockRegion, 'snapRadius') as number,\n    };\n    this.registry.register(id, definition);\n    this.regionEntities.set(id, entity);\n  }\n\n  private removeRegion(entity: Entity): void {\n    const id = entity.getValue(UIDockRegion, 'regionId') as string;\n    if (id && this.regionEntities.get(id) === entity) {\n      this.registry.unregister(id);\n      this.regionEntities.delete(id);\n    }\n  }\n\n  private dockWindow(entity: Entity): void {\n    const windowId = entity.getValue(UIWindow, 'windowId') as string;\n    const regionId = entity.getValue(UIDockedTo, 'regionId') as string;\n    if (!windowId || !regionId || !this.registry.get(regionId)) {\n      // Unknown region (or the window has no id yet) - docking is meaningless.\n      entity.removeComponent(UIDockedTo);\n      return;\n    }\n    try {\n      this.registry.dock(windowId, regionId);\n    } catch {\n      // Region is full: reject the dock.\n      entity.removeComponent(UIDockedTo);\n      return;\n    }\n    // Docked windows are world-locked by definition (the region may follow).\n    if (entity.getValue(UIWindow, 'dockMode') !== DockMode.WorldLocked) {\n      entity.setValue(UIWindow, 'dockMode', DockMode.WorldLocked);\n    }\n  }\n\n  private undockWindow(entity: Entity): void {\n    const windowId = entity.getValue(UIWindow, 'windowId') as string;\n    if (windowId) {\n      this.registry.undock(windowId);\n    }\n  }\n}\n"]}

package/dist/systems/dock-system.d.ts

@@ -0,0 +1,205 @@
+declare const UIDockSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    windows: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            appliedDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            chromeWired: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: false;
+            };
+            homeDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homeRegion: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homePosition: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            homeYaw: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>)[];
+    };
+}, World, import("@iwsdk/core").System<import("elics").SystemSchema, {
+    windows: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            appliedDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            chromeWired: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: false;
+            };
+            homeDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homeRegion: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homePosition: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            homeYaw: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>)[];
+    };
+}>>;
+export declare class UIDockSystem extends UIDockSystem_base {
+    private manager;
+    private windowPosition;
+    private viewerPosition;
+    init(): void;
+    update(): void;
+    private apply;
+    private faceViewer;
+    private offsetHelper;
+    private yawQuaternion;
+    private yawEuler;
+    private addFollower;
+}
+export {};