@realitycollective/iwsdk-uiextensions 0.1.0-preview.4

package/dist/scene-host.js

@@ -0,0 +1,190 @@
+/**
+ * IWSDK implementation of the core's `WindowHost` + `SceneTarget`.
+ *
+ * This is what makes a portable `SceneDescriptor` build the SAME playground
+ * on IWSDK as on plain three.js, and lets app behaviour be wired through
+ * `onPanelReady` instead of hand-written ECS queries:
+ *
+ *   const host = createSceneHost(world);
+ *   applyScene(host, PLAYGROUND);
+ *   host.onPanelReady(({ id, panel }) => wireMyPanel(id, panel));
+ *
+ * Readiness is detected with a single ECS query on `PanelUI + PanelDocument`
+ * - the engine-specific mechanism stays here, behind the portable interface.
+ * Bare panels (a `PanelUI` entity with no `UIWindow`) are announced too, with
+ * `kind: 'panel'` and their config path as the id, so devtools and hand-built
+ * entities show up in the same stream as managed windows.
+ */
+import { PanelDocument, PanelUI, createSystem, } from '@iwsdk/core';
+import { upgradePanel, } from '@realitycollective/webxr-uiextensions';
+import { createDockRegion, createUIWindow, } from './factory.js';
+import { UIWindow } from './components.js';
+/** Panel handle over an IWSDK `UIKitDocument`. */
+function panelHandleFor(document) {
+    return {
+        get root() {
+            return document.rootElement;
+        },
+        getElementById: (id) => document.getElementById(id) ?? undefined,
+        setTargetDimensions: (width, height) => document.setTargetDimensions(width, height),
+        dispose: () => {
+            /* IWSDK owns the document lifecycle via the entity. */
+        },
+    };
+}
+/**
+ * The live panel on an entity, or `undefined` while IWSDK is still loading
+ * its document. Use it to reach a panel from an entity you already hold;
+ * `onPanelReady` stays the way to be TOLD when one appears.
+ */
+export function getPanelHandle(entity) {
+    const document = PanelDocument.data.document[entity.index];
+    return document ? panelHandleFor(document) : undefined;
+}
+/**
+ * Bridges panel loading into `onPanelReady`. Registered once per host; the
+ * query fires as each panel's document is attached by IWSDK's UI system.
+ */
+function createReadySystem(onReady) {
+    return class UixPanelReadySystem extends createSystem({
+        panels: { required: [PanelUI, PanelDocument] },
+    }) {
+        init() {
+            this.cleanupFuncs.push(this.queries.panels.subscribe('qualify', (entity) => onReady(entity)));
+            this.queries.panels.entities.forEach((entity) => onReady(entity));
+        }
+    };
+}
+/**
+ * Create the host for a world. Call AFTER `registerUIExtensions(world)`.
+ */
+export function createSceneHost(world) {
+    const readyListeners = new Set();
+    const ready = new Map();
+    const seen = new WeakSet();
+    const announce = (entity) => {
+        const document = PanelDocument.data.document[entity.index];
+        if (!document || seen.has(document)) {
+            return;
+        }
+        seen.add(document);
+        // Window id comes from the UIWindow component the factory attached. A
+        // panel without one is a bare panel - still worth announcing, keyed by
+        // its config path, which is the only stable id IWSDK gives it.
+        const windowId = entity.hasComponent(UIWindow)
+            ? UIWindow.data.windowId[entity.index]
+            : '';
+        const kind = windowId ? 'window' : 'panel';
+        const id = windowId || PanelUI.data.config[entity.index];
+        const panel = panelHandleFor(document);
+        // Upgrade `data-uix` controls exactly as the ECS controls system does,
+        // so wiring code sees the same handles on every adapter (idempotent).
+        upgradePanel(document, document.rootElement);
+        const event = { id, panel, kind };
+        ready.set(id, event);
+        for (const listener of readyListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error(`[uix] panel-ready listener failed for "${id}":`, error);
+            }
+        }
+    };
+    world.registerSystem(createReadySystem(announce));
+    let windowSequence = 0;
+    const host = {
+        world,
+        // IWSDK owns panel lifecycles through the ECS, so there is no bare-panel
+        // path here - `createPanel` throws rather than half-working.
+        supportsStandalonePanels: false,
+        createPanel() {
+            throw new Error('[uix] createPanel() is not supported on the IWSDK host - spawn a window ' +
+                '(spawnWindow/createUIWindow) so IWSDK owns the panel lifecycle.');
+        },
+        onPanelReady(listener) {
+            readyListeners.add(listener);
+            for (const event of ready.values()) {
+                listener(event);
+            }
+            return () => void readyListeners.delete(listener);
+        },
+        createWindow(options) {
+            const id = options.id ?? `uix-window-${(windowSequence += 1)}`;
+            const entity = createUIWindow(world, { ...options, id });
+            return {
+                entity,
+                id,
+                get panel() {
+                    return ready.get(id)?.panel;
+                },
+                onReady(listener) {
+                    const existing = ready.get(id)?.panel;
+                    if (existing) {
+                        listener(existing);
+                        return () => { };
+                    }
+                    // `onPanelReady` replays panels that are already live, but this id
+                    // is not one of them, so the callback only ever runs later.
+                    const unsubscribe = host.onPanelReady((event) => {
+                        if (event.id === id) {
+                            unsubscribe();
+                            listener(event.panel);
+                        }
+                    });
+                    return unsubscribe;
+                },
+            };
+        },
+        spawnRegion(region) {
+            createDockRegion(world, {
+                id: region.id,
+                ...(region.flow !== undefined ? { flow: region.flow } : {}),
+                ...(region.pitch !== undefined ? { pitch: region.pitch } : {}),
+                ...(region.columns !== undefined ? { columns: region.columns } : {}),
+                ...(region.capacity !== undefined ? { capacity: region.capacity } : {}),
+                ...(region.snapRadius !== undefined
+                    ? { snapRadius: region.snapRadius }
+                    : {}),
+                ...(region.position !== undefined
+                    ? { position: [...region.position] }
+                    : {}),
+                ...(region.follow !== undefined ? { follow: region.follow } : {}),
+                ...(region.followOffset !== undefined
+                    ? { followOffset: [...region.followOffset] }
+                    : {}),
+            });
+        },
+        spawnWindow(window) {
+            host.createWindow({
+                id: window.id,
+                title: window.title,
+                config: window.config,
+                ...(window.position !== undefined
+                    ? { position: [...window.position] }
+                    : {}),
+                ...(window.maxWidth !== undefined ? { maxWidth: window.maxWidth } : {}),
+                ...(window.maxHeight !== undefined ? { maxHeight: window.maxHeight } : {}),
+                ...(window.dockMode !== undefined ? { dockMode: window.dockMode } : {}),
+                ...(window.region !== undefined ? { region: window.region } : {}),
+                ...(window.followOffset !== undefined
+                    ? { followOffset: [...window.followOffset] }
+                    : {}),
+                ...(window.followSpeed !== undefined
+                    ? { followSpeed: window.followSpeed }
+                    : {}),
+                ...(window.followTolerance !== undefined
+                    ? { followTolerance: window.followTolerance }
+                    : {}),
+                ...(window.movable !== undefined ? { movable: window.movable } : {}),
+                ...(window.closable !== undefined ? { closable: window.closable } : {}),
+                ...(window.minimizable !== undefined
+                    ? { minimizable: window.minimizable }
+                    : {}),
+                ...(window.pinnable !== undefined ? { pinnable: window.pinnable } : {}),
+            });
+        },
+    };
+    return host;
+}
+//# sourceMappingURL=scene-host.js.map

package/dist/scene-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-host.js","sourceRoot":"","sources":["../src/scene-host.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * IWSDK implementation of the core's `WindowHost` + `SceneTarget`.\n *\n * This is what makes a portable `SceneDescriptor` build the SAME playground\n * on IWSDK as on plain three.js, and lets app behaviour be wired through\n * `onPanelReady` instead of hand-written ECS queries:\n *\n *   const host = createSceneHost(world);\n *   applyScene(host, PLAYGROUND);\n *   host.onPanelReady(({ id, panel }) => wireMyPanel(id, panel));\n *\n * Readiness is detected with a single ECS query on `PanelUI + PanelDocument`\n * - the engine-specific mechanism stays here, behind the portable interface.\n * Bare panels (a `PanelUI` entity with no `UIWindow`) are announced too, with\n * `kind: 'panel'` and their config path as the id, so devtools and hand-built\n * entities show up in the same stream as managed windows.\n */\nimport {\n  PanelDocument,\n  PanelUI,\n  UIKitDocument,\n  createSystem,\n  type Entity,\n  type World,\n} from '@iwsdk/core';\nimport {\n  upgradePanel,\n  type PanelHandle,\n  type PanelReadyEvent,\n  type SceneRegion,\n  type SceneTarget,\n  type SceneWindow,\n  type UixElement,\n  type WindowHandle,\n  type WindowHost,\n} from '@realitycollective/webxr-uiextensions';\nimport {\n  createDockRegion,\n  createUIWindow,\n  type CreateWindowOptions,\n} from './factory.js';\nimport { UIWindow } from './components.js';\n\n/** Panel handle over an IWSDK `UIKitDocument`. */\nfunction panelHandleFor(document: UIKitDocument): PanelHandle {\n  return {\n    get root(): UixElement {\n      return document.rootElement as unknown as UixElement;\n    },\n    getElementById: (id) =>\n      (document.getElementById(id) as UixElement | null) ?? undefined,\n    setTargetDimensions: (width, height) =>\n      document.setTargetDimensions(width, height),\n    dispose: () => {\n      /* IWSDK owns the document lifecycle via the entity. */\n    },\n  };\n}\n\n/**\n * The live panel on an entity, or `undefined` while IWSDK is still loading\n * its document. Use it to reach a panel from an entity you already hold;\n * `onPanelReady` stays the way to be TOLD when one appears.\n */\nexport function getPanelHandle(entity: Entity): PanelHandle | undefined {\n  const document = PanelDocument.data.document[entity.index] as\n    | UIKitDocument\n    | undefined;\n  return document ? panelHandleFor(document) : undefined;\n}\n\n/**\n * Bridges panel loading into `onPanelReady`. Registered once per host; the\n * query fires as each panel's document is attached by IWSDK's UI system.\n */\nfunction createReadySystem(onReady: (entity: Entity) => void) {\n  return class UixPanelReadySystem extends createSystem({\n    panels: { required: [PanelUI, PanelDocument] },\n  }) {\n    override init(): void {\n      this.cleanupFuncs.push(\n        this.queries.panels.subscribe('qualify', (entity) => onReady(entity)),\n      );\n      this.queries.panels.entities.forEach((entity) => onReady(entity));\n    }\n  };\n}\n\n/** A window spawned by {@link IwsdkSceneHost.createWindow}. */\nexport interface IwsdkWindowHandle extends WindowHandle {\n  /** The ECS entity carrying `PanelUI`, `UIWindow` and the interaction tags. */\n  readonly entity: Entity;\n}\n\nexport interface IwsdkSceneHost extends WindowHost, SceneTarget {\n  readonly world: World;\n  /**\n   * Spawn a managed window and get a handle back straight away. IWSDK loads\n   * the markup over later frames, so `handle.panel` is `undefined` at first\n   * and `handle.onReady` is how you wait for it without an ECS query.\n   */\n  createWindow(options: CreateWindowOptions): IwsdkWindowHandle;\n}\n\n/**\n * Create the host for a world. Call AFTER `registerUIExtensions(world)`.\n */\nexport function createSceneHost(world: World): IwsdkSceneHost {\n  const readyListeners = new Set<(event: PanelReadyEvent) => void>();\n  const ready = new Map<string, PanelReadyEvent>();\n  const seen = new WeakSet<object>();\n\n  const announce = (entity: Entity): void => {\n    const document = PanelDocument.data.document[entity.index] as\n      | UIKitDocument\n      | undefined;\n    if (!document || seen.has(document)) {\n      return;\n    }\n    seen.add(document);\n    // Window id comes from the UIWindow component the factory attached. A\n    // panel without one is a bare panel - still worth announcing, keyed by\n    // its config path, which is the only stable id IWSDK gives it.\n    const windowId = entity.hasComponent(UIWindow)\n      ? (UIWindow.data.windowId[entity.index] as string)\n      : '';\n    const kind: 'window' | 'panel' = windowId ? 'window' : 'panel';\n    const id = windowId || (PanelUI.data.config[entity.index] as string);\n    const panel = panelHandleFor(document);\n    // Upgrade `data-uix` controls exactly as the ECS controls system does,\n    // so wiring code sees the same handles on every adapter (idempotent).\n    upgradePanel(document, document.rootElement as unknown as UixElement);\n    const event: PanelReadyEvent = { id, panel, kind };\n    ready.set(id, event);\n    for (const listener of readyListeners) {\n      try {\n        listener(event);\n      } catch (error) {\n        console.error(`[uix] panel-ready listener failed for \"${id}\":`, error);\n      }\n    }\n  };\n\n  world.registerSystem(createReadySystem(announce));\n\n  let windowSequence = 0;\n\n  const host: IwsdkSceneHost = {\n    world,\n\n    // IWSDK owns panel lifecycles through the ECS, so there is no bare-panel\n    // path here - `createPanel` throws rather than half-working.\n    supportsStandalonePanels: false,\n\n    createPanel(): PanelHandle {\n      throw new Error(\n        '[uix] createPanel() is not supported on the IWSDK host - spawn a window ' +\n          '(spawnWindow/createUIWindow) so IWSDK owns the panel lifecycle.',\n      );\n    },\n\n    onPanelReady(listener) {\n      readyListeners.add(listener);\n      for (const event of ready.values()) {\n        listener(event);\n      }\n      return () => void readyListeners.delete(listener);\n    },\n\n    createWindow(options: CreateWindowOptions): IwsdkWindowHandle {\n      const id = options.id ?? `uix-window-${(windowSequence += 1)}`;\n      const entity = createUIWindow(world, { ...options, id });\n      return {\n        entity,\n        id,\n        get panel(): PanelHandle | undefined {\n          return ready.get(id)?.panel;\n        },\n        onReady(listener: (panel: PanelHandle) => void): () => void {\n          const existing = ready.get(id)?.panel;\n          if (existing) {\n            listener(existing);\n            return () => {};\n          }\n          // `onPanelReady` replays panels that are already live, but this id\n          // is not one of them, so the callback only ever runs later.\n          const unsubscribe = host.onPanelReady((event) => {\n            if (event.id === id) {\n              unsubscribe();\n              listener(event.panel);\n            }\n          });\n          return unsubscribe;\n        },\n      };\n    },\n\n    spawnRegion(region: SceneRegion): void {\n      createDockRegion(world, {\n        id: region.id,\n        ...(region.flow !== undefined ? { flow: region.flow } : {}),\n        ...(region.pitch !== undefined ? { pitch: region.pitch } : {}),\n        ...(region.columns !== undefined ? { columns: region.columns } : {}),\n        ...(region.capacity !== undefined ? { capacity: region.capacity } : {}),\n        ...(region.snapRadius !== undefined\n          ? { snapRadius: region.snapRadius }\n          : {}),\n        ...(region.position !== undefined\n          ? { position: [...region.position] as [number, number, number] }\n          : {}),\n        ...(region.follow !== undefined ? { follow: region.follow } : {}),\n        ...(region.followOffset !== undefined\n          ? { followOffset: [...region.followOffset] as [number, number, number] }\n          : {}),\n      });\n    },\n\n    spawnWindow(window: SceneWindow): void {\n      host.createWindow({\n        id: window.id,\n        title: window.title,\n        config: window.config,\n        ...(window.position !== undefined\n          ? { position: [...window.position] as [number, number, number] }\n          : {}),\n        ...(window.maxWidth !== undefined ? { maxWidth: window.maxWidth } : {}),\n        ...(window.maxHeight !== undefined ? { maxHeight: window.maxHeight } : {}),\n        ...(window.dockMode !== undefined ? { dockMode: window.dockMode } : {}),\n        ...(window.region !== undefined ? { region: window.region } : {}),\n        ...(window.followOffset !== undefined\n          ? { followOffset: [...window.followOffset] as [number, number, number] }\n          : {}),\n        ...(window.followSpeed !== undefined\n          ? { followSpeed: window.followSpeed }\n          : {}),\n        ...(window.followTolerance !== undefined\n          ? { followTolerance: window.followTolerance }\n          : {}),\n        ...(window.movable !== undefined ? { movable: window.movable } : {}),\n        ...(window.closable !== undefined ? { closable: window.closable } : {}),\n        ...(window.minimizable !== undefined\n          ? { minimizable: window.minimizable }\n          : {}),\n        ...(window.pinnable !== undefined ? { pinnable: window.pinnable } : {}),\n      });\n    },\n  };\n\n  return host;\n}\n"]}

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

@@ -0,0 +1,24 @@
+declare const UIControlsSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    panels: {
+        required: import("elics").Component<{
+            document: {
+                type: import("@iwsdk/core").Types.Object;
+                default: undefined;
+            };
+        }>[];
+    };
+}, World, import("@iwsdk/core").System<import("elics").SystemSchema, {
+    panels: {
+        required: import("elics").Component<{
+            document: {
+                type: import("@iwsdk/core").Types.Object;
+                default: undefined;
+            };
+        }>[];
+    };
+}>>;
+export declare class UIControlsSystem extends UIControlsSystem_base {
+    init(): void;
+    private upgrade;
+}
+export {};

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":"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","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"]}