@realitycollective/iwsdk-uiextensions 0.1.0-preview.0

package/dist/components.js

@@ -0,0 +1,97 @@
+/**
+ * ECS components for UI Extensions.
+ *
+ * These compose with the IWSDK's own components - a window entity typically
+ * carries `PanelUI` (the IWSDK loads/renders the panel), `UIWindow` (ours),
+ * and the IWSDK interaction tags (`RayInteractable`, `PokeInteractable`).
+ * The systems in this package add/remove the IWSDK `Follower` / `ScreenSpace`
+ * components to realise dock modes rather than re-implementing them.
+ */
+import { Types, createComponent } from '@iwsdk/core';
+import { DockMode } from '@realitycollective/webxr-uiextensions';
+/** Region flow options mirrored as an enum object for the component schema. */
+export const RegionFlowType = {
+    Row: 'row',
+    Column: 'column',
+    Grid: 'grid',
+};
+/**
+ * Marks a panel entity as a managed window with chrome, focus, docking and
+ * drag behaviour. Pair with `PanelUI` whose markup contains the window chrome
+ * elements (see `WINDOW_CHROME_IDS` / the Examples folder).
+ */
+export const UIWindow = createComponent('UIWindow', {
+    /** Stable id; auto-generated when empty. */
+    windowId: { type: Types.String, default: '' },
+    /** Title text written into the `uix-title` element. */
+    title: { type: Types.String, default: '' },
+    /** Current dock state. */
+    dockMode: { type: Types.Enum, enum: DockMode, default: DockMode.WorldLocked },
+    /** Whether the title bar drags the window. */
+    movable: { type: Types.Boolean, default: true },
+    /** Show/enable the close affordance. */
+    closable: { type: Types.Boolean, default: true },
+    /** Show/enable the minimize affordance. */
+    minimizable: { type: Types.Boolean, default: true },
+    /** Show/enable the pin (body-follow ⇄ world-locked) affordance. */
+    pinnable: { type: Types.Boolean, default: true },
+    /** Keep the window yawed toward the viewer while it is being dragged. */
+    billboardWhileDragging: { type: Types.Boolean, default: true },
+    /**
+     * Seconds a title-bar press must be held before it becomes a drag.
+     * Shorter presses stay clicks, so title-bar buttons don't fight the drag.
+     */
+    dragDelay: { type: Types.Float32, default: 0.3 },
+    /** Head-relative offset used in `body-follow` mode (meters). */
+    followOffset: { type: Types.Vec3, default: [0, -0.15, -1.2] },
+    /** `Follower` lerp speed for body-follow. */
+    followSpeed: { type: Types.Float32, default: 3 },
+    /** `Follower` positional deadzone for body-follow (meters). */
+    followTolerance: { type: Types.Float32, default: 0.35 },
+    /** Meters the focused window is nudged toward the viewer per focus depth. */
+    focusBias: { type: Types.Float32, default: 0.02 },
+    /**
+     * World size box in meters, applied via `UIKitDocument.setTargetDimensions`
+     * once the document loads. IWSDK 0.5 removed `PanelUI.maxWidth/maxHeight`;
+     * this is the supported replacement. `0` leaves the document at its
+     * intrinsic markup size, scaled only by the entity transform.
+     */
+    targetWidth: { type: Types.Float32, default: 0 },
+    targetHeight: { type: Types.Float32, default: 0 },
+}, 'UI Extensions managed window (chrome, focus, docking, drag)');
+/**
+ * Internal bookkeeping the systems keep on window entities - which dock mode
+ * has actually been applied to engine components, and whether chrome wiring
+ * has run for the current PanelDocument.
+ */
+export const UIWindowState = createComponent('UIWindowState', {
+    appliedDockMode: { type: Types.String, default: '' },
+    chromeWired: { type: Types.Boolean, default: false },
+    /** "Home" snapshot captured on adoption - the DOCK button returns here. */
+    homeDockMode: { type: Types.String, default: '' },
+    homeRegion: { type: Types.String, default: '' },
+    homePosition: { type: Types.Vec3, default: [0, 0, 0] },
+    homeYaw: { type: Types.Float32, default: 0 },
+}, 'Internal UI Extensions window bookkeeping');
+/**
+ * A named layout region that docked windows snap to and are laid out within.
+ * Place the entity where the region should live (it can itself carry a
+ * `Follower` to make a body-locked region).
+ */
+export const UIDockRegion = createComponent('UIDockRegion', {
+    regionId: { type: Types.String, default: '' },
+    flow: { type: Types.Enum, enum: RegionFlowType, default: RegionFlowType.Column },
+    /** Distance between slot origins (meters). */
+    pitch: { type: Types.Float32, default: 0.35 },
+    /** Columns per row (grid flow only). */
+    columns: { type: Types.Float32, default: 2 },
+    /** Max docked windows (0 = unlimited). */
+    capacity: { type: Types.Float32, default: 0 },
+    /** Drop-capture radius (meters). */
+    snapRadius: { type: Types.Float32, default: 0.5 },
+}, 'UI Extensions layout region for docking windows');
+/** Present on a window entity while it is docked into a region. */
+export const UIDockedTo = createComponent('UIDockedTo', {
+    regionId: { type: Types.String, default: '' },
+}, 'Marks a UI Extensions window as docked into a region');
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CACrC,UAAU,EACV;IACE,4CAA4C;IAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IAC7C,uDAAuD;IACvD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IAC1C,0BAA0B;IAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE;IAC7E,8CAA8C;IAC9C,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAC/C,wCAAwC;IACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAChD,2CAA2C;IAC3C,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACnD,mEAAmE;IACnE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAChD,yEAAyE;IACzE,sBAAsB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAC9D;;;OAGG;IACH,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IAChD,gEAAgE;IAChE,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE;IAC7D,6CAA6C;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAChD,+DAA+D;IAC/D,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACvD,6EAA6E;IAC7E,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IACjD;;;;;OAKG;IACH,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;CAClD,EACD,6DAA6D,CAC9D,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAC1C,eAAe,EACf;IACE,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IACpD,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACpD,2EAA2E;IAC3E,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IACjD,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IAC/C,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACtD,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;CAC7C,EACD,2CAA2C,CAC5C,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CACzC,cAAc,EACd;IACE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE;IAChF,8CAA8C;IAC9C,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAC7C,wCAAwC;IACxC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAC5C,0CAA0C;IAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;IAC7C,oCAAoC;IACpC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;CAClD,EACD,iDAAiD,CAClD,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CACvC,YAAY,EACZ;IACE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;CAC9C,EACD,sDAAsD,CACvD,CAAC","sourcesContent":["/**\n * ECS components for UI Extensions.\n *\n * These compose with the IWSDK's own components - a window entity typically\n * carries `PanelUI` (the IWSDK loads/renders the panel), `UIWindow` (ours),\n * and the IWSDK interaction tags (`RayInteractable`, `PokeInteractable`).\n * The systems in this package add/remove the IWSDK `Follower` / `ScreenSpace`\n * components to realise dock modes rather than re-implementing them.\n */\nimport { Types, createComponent } from '@iwsdk/core';\nimport { DockMode } from '@realitycollective/webxr-uiextensions';\n\n/** Region flow options mirrored as an enum object for the component schema. */\nexport const RegionFlowType = {\n  Row: 'row',\n  Column: 'column',\n  Grid: 'grid',\n} as const;\n\n/**\n * Marks a panel entity as a managed window with chrome, focus, docking and\n * drag behaviour. Pair with `PanelUI` whose markup contains the window chrome\n * elements (see `WINDOW_CHROME_IDS` / the Examples folder).\n */\nexport const UIWindow = createComponent(\n  'UIWindow',\n  {\n    /** Stable id; auto-generated when empty. */\n    windowId: { type: Types.String, default: '' },\n    /** Title text written into the `uix-title` element. */\n    title: { type: Types.String, default: '' },\n    /** Current dock state. */\n    dockMode: { type: Types.Enum, enum: DockMode, default: DockMode.WorldLocked },\n    /** Whether the title bar drags the window. */\n    movable: { type: Types.Boolean, default: true },\n    /** Show/enable the close affordance. */\n    closable: { type: Types.Boolean, default: true },\n    /** Show/enable the minimize affordance. */\n    minimizable: { type: Types.Boolean, default: true },\n    /** Show/enable the pin (body-follow ⇄ world-locked) affordance. */\n    pinnable: { type: Types.Boolean, default: true },\n    /** Keep the window yawed toward the viewer while it is being dragged. */\n    billboardWhileDragging: { type: Types.Boolean, default: true },\n    /**\n     * Seconds a title-bar press must be held before it becomes a drag.\n     * Shorter presses stay clicks, so title-bar buttons don't fight the drag.\n     */\n    dragDelay: { type: Types.Float32, default: 0.3 },\n    /** Head-relative offset used in `body-follow` mode (meters). */\n    followOffset: { type: Types.Vec3, default: [0, -0.15, -1.2] },\n    /** `Follower` lerp speed for body-follow. */\n    followSpeed: { type: Types.Float32, default: 3 },\n    /** `Follower` positional deadzone for body-follow (meters). */\n    followTolerance: { type: Types.Float32, default: 0.35 },\n    /** Meters the focused window is nudged toward the viewer per focus depth. */\n    focusBias: { type: Types.Float32, default: 0.02 },\n    /**\n     * World size box in meters, applied via `UIKitDocument.setTargetDimensions`\n     * once the document loads. IWSDK 0.5 removed `PanelUI.maxWidth/maxHeight`;\n     * this is the supported replacement. `0` leaves the document at its\n     * intrinsic markup size, scaled only by the entity transform.\n     */\n    targetWidth: { type: Types.Float32, default: 0 },\n    targetHeight: { type: Types.Float32, default: 0 },\n  },\n  'UI Extensions managed window (chrome, focus, docking, drag)',\n);\n\n/**\n * Internal bookkeeping the systems keep on window entities - which dock mode\n * has actually been applied to engine components, and whether chrome wiring\n * has run for the current PanelDocument.\n */\nexport const UIWindowState = createComponent(\n  'UIWindowState',\n  {\n    appliedDockMode: { type: Types.String, default: '' },\n    chromeWired: { type: Types.Boolean, default: false },\n    /** \"Home\" snapshot captured on adoption - the DOCK button returns here. */\n    homeDockMode: { type: Types.String, default: '' },\n    homeRegion: { type: Types.String, default: '' },\n    homePosition: { type: Types.Vec3, default: [0, 0, 0] },\n    homeYaw: { type: Types.Float32, default: 0 },\n  },\n  'Internal UI Extensions window bookkeeping',\n);\n\n/**\n * A named layout region that docked windows snap to and are laid out within.\n * Place the entity where the region should live (it can itself carry a\n * `Follower` to make a body-locked region).\n */\nexport const UIDockRegion = createComponent(\n  'UIDockRegion',\n  {\n    regionId: { type: Types.String, default: '' },\n    flow: { type: Types.Enum, enum: RegionFlowType, default: RegionFlowType.Column },\n    /** Distance between slot origins (meters). */\n    pitch: { type: Types.Float32, default: 0.35 },\n    /** Columns per row (grid flow only). */\n    columns: { type: Types.Float32, default: 2 },\n    /** Max docked windows (0 = unlimited). */\n    capacity: { type: Types.Float32, default: 0 },\n    /** Drop-capture radius (meters). */\n    snapRadius: { type: Types.Float32, default: 0.5 },\n  },\n  'UI Extensions layout region for docking windows',\n);\n\n/** Present on a window entity while it is docked into a region. */\nexport const UIDockedTo = createComponent(\n  'UIDockedTo',\n  {\n    regionId: { type: Types.String, default: '' },\n  },\n  'Marks a UI Extensions window as docked into a region',\n);\n"]}

package/dist/factory.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Convenience factories - one call to spawn a managed window or dock region.
+ * Thin sugar over `createTransformEntity().addComponent(...)`; everything
+ * they do can be done manually with the components.
+ */
+import { type Entity, type World } from '@iwsdk/core';
+import { RegionFlowType } from './components.js';
+import { type DockModeValue } from '@realitycollective/webxr-uiextensions';
+export interface CreateWindowOptions {
+    /**
+     * URL of the UIKitML source (e.g. "/ui/my-window.uikitml"). IWSDK 0.5 parses
+     * UIKitML at runtime - the build-time plugin and its generated JSON are gone.
+     */
+    config: string;
+    id?: string;
+    title?: string;
+    dockMode?: DockModeValue;
+    /** World position for world-locked windows. */
+    position?: [number, number, number];
+    /**
+     * Fit the panel into this world-space box (meters), preserving aspect ratio.
+     * Replaces the `PanelUI.maxWidth/maxHeight` fields removed in IWSDK 0.5.
+     * Omit to keep the markup's intrinsic size and scale via the entity transform.
+     */
+    maxWidth?: number;
+    maxHeight?: number;
+    movable?: boolean;
+    closable?: boolean;
+    minimizable?: boolean;
+    pinnable?: boolean;
+    billboardWhileDragging?: boolean;
+    followOffset?: [number, number, number];
+    followSpeed?: number;
+    followTolerance?: number;
+    /** Dock straight into this region on spawn. */
+    region?: string;
+}
+export declare function createUIWindow(world: World, options: CreateWindowOptions): Entity;
+export interface CreateDockRegionOptions {
+    id: string;
+    flow?: (typeof RegionFlowType)[keyof typeof RegionFlowType];
+    pitch?: number;
+    columns?: number;
+    capacity?: number;
+    snapRadius?: number;
+    /** World position of the region origin. */
+    position?: [number, number, number];
+    /**
+     * Body-lock the region itself: it follows the player's head at
+     * `followOffset`, and every window docked into it comes along.
+     */
+    follow?: boolean;
+    followOffset?: [number, number, number];
+}
+export declare function createDockRegion(world: World, options: CreateDockRegionOptions): Entity;

package/dist/factory.js

@@ -0,0 +1,63 @@
+/**
+ * Convenience factories - one call to spawn a managed window or dock region.
+ * Thin sugar over `createTransformEntity().addComponent(...)`; everything
+ * they do can be done manually with the components.
+ */
+import { Follower, FollowBehavior, PanelUI, PokeInteractable, RayInteractable, } from '@iwsdk/core';
+import { UIDockRegion, UIDockedTo, UIWindow, RegionFlowType } from './components.js';
+import { DockMode } from '@realitycollective/webxr-uiextensions';
+export function createUIWindow(world, options) {
+    const entity = world
+        .createTransformEntity()
+        .addComponent(PanelUI, {
+        config: options.config,
+    })
+        .addComponent(UIWindow, {
+        // Applied by UIWindowSystem once the document loads - see components.ts.
+        targetWidth: options.maxWidth ?? 0,
+        targetHeight: options.maxHeight ?? 0,
+        windowId: options.id ?? '',
+        title: options.title ?? '',
+        dockMode: options.dockMode ?? DockMode.WorldLocked,
+        movable: options.movable ?? true,
+        closable: options.closable ?? true,
+        minimizable: options.minimizable ?? true,
+        pinnable: options.pinnable ?? true,
+        billboardWhileDragging: options.billboardWhileDragging ?? true,
+        followOffset: options.followOffset ?? [0, -0.15, -1.2],
+        followSpeed: options.followSpeed ?? 3,
+        followTolerance: options.followTolerance ?? 0.35,
+    })
+        .addComponent(RayInteractable)
+        .addComponent(PokeInteractable);
+    if (options.position) {
+        entity.object3D?.position.set(...options.position);
+    }
+    if (options.region) {
+        entity.addComponent(UIDockedTo, { regionId: options.region });
+    }
+    return entity;
+}
+export function createDockRegion(world, options) {
+    const entity = world.createTransformEntity().addComponent(UIDockRegion, {
+        regionId: options.id,
+        flow: options.flow ?? RegionFlowType.Column,
+        pitch: options.pitch ?? 0.35,
+        columns: options.columns ?? 2,
+        capacity: options.capacity ?? 0,
+        snapRadius: options.snapRadius ?? 0.5,
+    });
+    if (options.position) {
+        entity.object3D?.position.set(...options.position);
+    }
+    if (options.follow) {
+        entity.addComponent(Follower, {
+            // Camera, not player.head - the head rig is origin-locked outside XR.
+            target: world.camera,
+            offsetPosition: options.followOffset ?? [0, -0.2, -1.4],
+            behavior: FollowBehavior.PivotY,
+        });
+    }
+    return entity;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Convenience factories - one call to spawn a managed window or dock region.\n * Thin sugar over `createTransformEntity().addComponent(...)`; everything\n * they do can be done manually with the components.\n */\nimport {\n  Follower,\n  FollowBehavior,\n  PanelUI,\n  PokeInteractable,\n  RayInteractable,\n  type Entity,\n  type World,\n} from '@iwsdk/core';\nimport { UIDockRegion, UIDockedTo, UIWindow, RegionFlowType } from './components.js';\nimport { DockMode, type DockModeValue } from '@realitycollective/webxr-uiextensions';\n\nexport interface CreateWindowOptions {\n  /**\n   * URL of the UIKitML source (e.g. \"/ui/my-window.uikitml\"). IWSDK 0.5 parses\n   * UIKitML at runtime - the build-time plugin and its generated JSON are gone.\n   */\n  config: string;\n  id?: string;\n  title?: string;\n  dockMode?: DockModeValue;\n  /** World position for world-locked windows. */\n  position?: [number, number, number];\n  /**\n   * Fit the panel into this world-space box (meters), preserving aspect ratio.\n   * Replaces the `PanelUI.maxWidth/maxHeight` fields removed in IWSDK 0.5.\n   * Omit to keep the markup's intrinsic size and scale via the entity transform.\n   */\n  maxWidth?: number;\n  maxHeight?: number;\n  movable?: boolean;\n  closable?: boolean;\n  minimizable?: boolean;\n  pinnable?: boolean;\n  billboardWhileDragging?: boolean;\n  followOffset?: [number, number, number];\n  followSpeed?: number;\n  followTolerance?: number;\n  /** Dock straight into this region on spawn. */\n  region?: string;\n}\n\nexport function createUIWindow(world: World, options: CreateWindowOptions): Entity {\n  const entity = world\n    .createTransformEntity()\n    .addComponent(PanelUI, {\n      config: options.config,\n    })\n    .addComponent(UIWindow, {\n      // Applied by UIWindowSystem once the document loads - see components.ts.\n      targetWidth: options.maxWidth ?? 0,\n      targetHeight: options.maxHeight ?? 0,\n      windowId: options.id ?? '',\n      title: options.title ?? '',\n      dockMode: options.dockMode ?? DockMode.WorldLocked,\n      movable: options.movable ?? true,\n      closable: options.closable ?? true,\n      minimizable: options.minimizable ?? true,\n      pinnable: options.pinnable ?? true,\n      billboardWhileDragging: options.billboardWhileDragging ?? true,\n      followOffset: options.followOffset ?? [0, -0.15, -1.2],\n      followSpeed: options.followSpeed ?? 3,\n      followTolerance: options.followTolerance ?? 0.35,\n    })\n    .addComponent(RayInteractable)\n    .addComponent(PokeInteractable);\n\n  if (options.position) {\n    entity.object3D?.position.set(...options.position);\n  }\n  if (options.region) {\n    entity.addComponent(UIDockedTo, { regionId: options.region });\n  }\n  return entity;\n}\n\nexport interface CreateDockRegionOptions {\n  id: string;\n  flow?: (typeof RegionFlowType)[keyof typeof RegionFlowType];\n  pitch?: number;\n  columns?: number;\n  capacity?: number;\n  snapRadius?: number;\n  /** World position of the region origin. */\n  position?: [number, number, number];\n  /**\n   * Body-lock the region itself: it follows the player's head at\n   * `followOffset`, and every window docked into it comes along.\n   */\n  follow?: boolean;\n  followOffset?: [number, number, number];\n}\n\nexport function createDockRegion(world: World, options: CreateDockRegionOptions): Entity {\n  const entity = world.createTransformEntity().addComponent(UIDockRegion, {\n    regionId: options.id,\n    flow: options.flow ?? RegionFlowType.Column,\n    pitch: options.pitch ?? 0.35,\n    columns: options.columns ?? 2,\n    capacity: options.capacity ?? 0,\n    snapRadius: options.snapRadius ?? 0.5,\n  });\n  if (options.position) {\n    entity.object3D?.position.set(...options.position);\n  }\n  if (options.follow) {\n    entity.addComponent(Follower, {\n      // Camera, not player.head - the head rig is origin-locked outside XR.\n      target: world.camera,\n      offsetPosition: options.followOffset ?? [0, -0.2, -1.4],\n      behavior: FollowBehavior.PivotY,\n    });\n  }\n  return entity;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @realitycollective/iwsdk-uiextensions - the Meta IWSDK adapter.
+ *
+ * The engine-free UX core (window manager, dock state, region math, drag
+ * math, control models, markup upgraders, adapter interfaces) lives in
+ * `@realitycollective/webxr-uiextensions` and is re-exported here in full,
+ * so this package remains a drop-in single dependency for IWSDK apps.
+ *
+ * What this package adds is the IWSDK binding: ECS components + systems
+ * that apply the core onto `@iwsdk/core` entities, plus the one-call
+ * factories and `registerUIExtensions`.
+ */
+export * from '@realitycollective/webxr-uiextensions';
+export * from './components.js';
+export * from './manager-registry.js';
+export * from './region-registry-store.js';
+export * from './factory.js';
+export * from './scene-host.js';
+export * from './register.js';
+export * from './systems/window-system.js';
+export * from './systems/dock-system.js';
+export * from './systems/drag-system.js';
+export * from './systems/dock-region-system.js';
+export * from './systems/controls-system.js';

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @realitycollective/iwsdk-uiextensions - the Meta IWSDK adapter.
+ *
+ * The engine-free UX core (window manager, dock state, region math, drag
+ * math, control models, markup upgraders, adapter interfaces) lives in
+ * `@realitycollective/webxr-uiextensions` and is re-exported here in full,
+ * so this package remains a drop-in single dependency for IWSDK apps.
+ *
+ * What this package adds is the IWSDK binding: ECS components + systems
+ * that apply the core onto `@iwsdk/core` entities, plus the one-call
+ * factories and `registerUIExtensions`.
+ */
+// The portable core - re-exported for a single-dependency experience.
+export * from '@realitycollective/webxr-uiextensions';
+// IWSDK ECS binding
+export * from './components.js';
+export * from './manager-registry.js';
+export * from './region-registry-store.js';
+export * from './factory.js';
+export * from './scene-host.js';
+export * from './register.js';
+export * from './systems/window-system.js';
+export * from './systems/dock-system.js';
+export * from './systems/drag-system.js';
+export * from './systems/dock-region-system.js';
+export * from './systems/controls-system.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,sEAAsE;AACtE,cAAc,uCAAuC,CAAC;AAEtD,oBAAoB;AACpB,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC","sourcesContent":["/**\n * @realitycollective/iwsdk-uiextensions - the Meta IWSDK adapter.\n *\n * The engine-free UX core (window manager, dock state, region math, drag\n * math, control models, markup upgraders, adapter interfaces) lives in\n * `@realitycollective/webxr-uiextensions` and is re-exported here in full,\n * so this package remains a drop-in single dependency for IWSDK apps.\n *\n * What this package adds is the IWSDK binding: ECS components + systems\n * that apply the core onto `@iwsdk/core` entities, plus the one-call\n * factories and `registerUIExtensions`.\n */\n// The portable core - re-exported for a single-dependency experience.\nexport * from '@realitycollective/webxr-uiextensions';\n\n// IWSDK ECS binding\nexport * from './components.js';\nexport * from './manager-registry.js';\nexport * from './region-registry-store.js';\nexport * from './factory.js';\nexport * from './scene-host.js';\nexport * from './register.js';\nexport * from './systems/window-system.js';\nexport * from './systems/dock-system.js';\nexport * from './systems/drag-system.js';\nexport * from './systems/dock-region-system.js';\nexport * from './systems/controls-system.js';\n"]}

package/dist/manager-registry.d.ts

@@ -0,0 +1,8 @@
+/**
+ * One `WindowManager` per IWSDK `World`, lazily created. App code and the
+ * systems in this package resolve the same instance through this registry,
+ * so window state has a single home without a global singleton.
+ */
+import type { World } from '@iwsdk/core';
+import { WindowManager } from '@realitycollective/webxr-uiextensions';
+export declare function windowManagerFor(world: World): WindowManager;

package/dist/manager-registry.js

@@ -0,0 +1,11 @@
+import { WindowManager } from '@realitycollective/webxr-uiextensions';
+const managers = new WeakMap();
+export function windowManagerFor(world) {
+    let manager = managers.get(world);
+    if (!manager) {
+        manager = new WindowManager();
+        managers.set(world, manager);
+    }
+    return manager;
+}
+//# sourceMappingURL=manager-registry.js.map

package/dist/manager-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager-registry.js","sourceRoot":"","sources":["../src/manager-registry.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAEtE,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAwB,CAAC;AAErD,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QAC9B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * One `WindowManager` per IWSDK `World`, lazily created. App code and the\n * systems in this package resolve the same instance through this registry,\n * so window state has a single home without a global singleton.\n */\nimport type { World } from '@iwsdk/core';\nimport { WindowManager } from '@realitycollective/webxr-uiextensions';\n\nconst managers = new WeakMap<World, WindowManager>();\n\nexport function windowManagerFor(world: World): WindowManager {\n  let manager = managers.get(world);\n  if (!manager) {\n    manager = new WindowManager();\n    managers.set(world, manager);\n  }\n  return manager;\n}\n"]}

package/dist/region-registry-store.d.ts

@@ -0,0 +1,7 @@
+/**
+ * One `RegionRegistry` per IWSDK `World` (same pattern as the window
+ * manager) so the drag and region systems share region state.
+ */
+import type { World } from '@iwsdk/core';
+import { RegionRegistry } from '@realitycollective/webxr-uiextensions';
+export declare function regionRegistryFor(world: World): RegionRegistry;

package/dist/region-registry-store.js

@@ -0,0 +1,11 @@
+import { RegionRegistry } from '@realitycollective/webxr-uiextensions';
+const registries = new WeakMap();
+export function regionRegistryFor(world) {
+    let registry = registries.get(world);
+    if (!registry) {
+        registry = new RegionRegistry();
+        registries.set(world, registry);
+    }
+    return registry;
+}
+//# sourceMappingURL=region-registry-store.js.map

package/dist/region-registry-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-registry-store.js","sourceRoot":"","sources":["../src/region-registry-store.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,MAAM,UAAU,GAAG,IAAI,OAAO,EAAyB,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,KAAY;IAC5C,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QAChC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * One `RegionRegistry` per IWSDK `World` (same pattern as the window\n * manager) so the drag and region systems share region state.\n */\nimport type { World } from '@iwsdk/core';\nimport { RegionRegistry } from '@realitycollective/webxr-uiextensions';\n\nconst registries = new WeakMap<World, RegionRegistry>();\n\nexport function regionRegistryFor(world: World): RegionRegistry {\n  let registry = registries.get(world);\n  if (!registry) {\n    registry = new RegionRegistry();\n    registries.set(world, registry);\n  }\n  return registry;\n}\n"]}

package/dist/register.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One-call setup: register every UI Extensions system on a world.
+ *
+ * ```ts
+ * const world = await World.create(container, { features: { spatialUI: true } });
+ * registerUIExtensions(world);
+ * ```
+ */
+import type { World } from '@iwsdk/core';
+import type { WindowManager } from '@realitycollective/webxr-uiextensions';
+export interface RegisterOptions {
+    /** Disable the title-bar drag system. */
+    drag?: boolean;
+    /** Disable dock regions. */
+    regions?: boolean;
+    /** Disable the `data-uix` control upgrades. */
+    controls?: boolean;
+}
+export declare function registerUIExtensions(world: World, options?: RegisterOptions): WindowManager;

package/dist/register.js

@@ -0,0 +1,20 @@
+import { UIWindowSystem } from './systems/window-system.js';
+import { UIDockSystem } from './systems/dock-system.js';
+import { UIDragSystem } from './systems/drag-system.js';
+import { UIDockRegionSystem } from './systems/dock-region-system.js';
+import { UIControlsSystem } from './systems/controls-system.js';
+import { windowManagerFor } from './manager-registry.js';
+export function registerUIExtensions(world, options = {}) {
+    world.registerSystem(UIWindowSystem).registerSystem(UIDockSystem);
+    if (options.drag !== false) {
+        world.registerSystem(UIDragSystem);
+    }
+    if (options.regions !== false) {
+        world.registerSystem(UIDockRegionSystem);
+    }
+    if (options.controls !== false) {
+        world.registerSystem(UIControlsSystem);
+    }
+    return windowManagerFor(world);
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAYzD,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,UAA2B,EAAE;IAE7B,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC9B,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC","sourcesContent":["/**\n * One-call setup: register every UI Extensions system on a world.\n *\n * ```ts\n * const world = await World.create(container, { features: { spatialUI: true } });\n * registerUIExtensions(world);\n * ```\n */\nimport type { World } from '@iwsdk/core';\nimport { UIWindowSystem } from './systems/window-system.js';\nimport { UIDockSystem } from './systems/dock-system.js';\nimport { UIDragSystem } from './systems/drag-system.js';\nimport { UIDockRegionSystem } from './systems/dock-region-system.js';\nimport { UIControlsSystem } from './systems/controls-system.js';\nimport { windowManagerFor } from './manager-registry.js';\nimport type { WindowManager } from '@realitycollective/webxr-uiextensions';\n\nexport interface RegisterOptions {\n  /** Disable the title-bar drag system. */\n  drag?: boolean;\n  /** Disable dock regions. */\n  regions?: boolean;\n  /** Disable the `data-uix` control upgrades. */\n  controls?: boolean;\n}\n\nexport function registerUIExtensions(\n  world: World,\n  options: RegisterOptions = {},\n): WindowManager {\n  world.registerSystem(UIWindowSystem).registerSystem(UIDockSystem);\n  if (options.drag !== false) {\n    world.registerSystem(UIDragSystem);\n  }\n  if (options.regions !== false) {\n    world.registerSystem(UIDockRegionSystem);\n  }\n  if (options.controls !== false) {\n    world.registerSystem(UIControlsSystem);\n  }\n  return windowManagerFor(world);\n}\n"]}

package/dist/scene-host.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+import { type World } from '@iwsdk/core';
+import { type SceneTarget, type WindowHost } from '@realitycollective/webxr-uiextensions';
+export interface IwsdkSceneHost extends WindowHost, SceneTarget {
+    readonly world: World;
+}
+/**
+ * Create the host for a world. Call AFTER `registerUIExtensions(world)`.
+ */
+export declare function createSceneHost(world: World): IwsdkSceneHost;

package/dist/scene-host.js

@@ -0,0 +1,145 @@
+/**
+ * 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.
+ */
+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. */
+        },
+    };
+}
+/**
+ * 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.
+        const id = entity.hasComponent(UIWindow)
+            ? UIWindow.data.windowId[entity.index]
+            : '';
+        if (!id) {
+            return; // a bare panel, not a managed window - nothing to wire by id
+        }
+        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 };
+        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));
+    return {
+        world,
+        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);
+        },
+        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) {
+            createUIWindow(world, {
+                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 } : {}),
+            });
+        },
+    };
+}
+//# 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 */\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 WindowHost,\n} from '@realitycollective/webxr-uiextensions';\nimport { createDockRegion, createUIWindow } 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 * 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\nexport interface IwsdkSceneHost extends WindowHost, SceneTarget {\n  readonly world: World;\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.\n    const id = entity.hasComponent(UIWindow)\n      ? (UIWindow.data.windowId[entity.index] as string)\n      : '';\n    if (!id) {\n      return; // a bare panel, not a managed window - nothing to wire by id\n    }\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 };\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  return {\n    world,\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    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      createUIWindow(world, {\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"]}

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 {};