@realitycollective/iwsdk-uiextensions 0.1.0-preview.4

package/dist/components.d.ts

@@ -0,0 +1,189 @@
+/**
+ * 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 } from '@iwsdk/core';
+/** Region flow options mirrored as an enum object for the component schema. */
+export declare const RegionFlowType: {
+    readonly Row: "row";
+    readonly Column: "column";
+    readonly 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 declare const UIWindow: import("elics").Component<{
+    /** Stable id; auto-generated when empty. */
+    windowId: {
+        type: Types.String;
+        default: string;
+    };
+    /** Title text written into the `uix-title` element. */
+    title: {
+        type: Types.String;
+        default: string;
+    };
+    /** Current dock state. */
+    dockMode: {
+        type: Types.Enum;
+        enum: {
+            readonly WorldLocked: "world-locked";
+            readonly BodyFollow: "body-follow";
+            readonly HeadLocked: "head-locked";
+        };
+        default: "world-locked";
+    };
+    /** 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: number;
+    };
+    /** Head-relative offset used in `body-follow` mode (meters). */
+    followOffset: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** `Follower` lerp speed for body-follow. */
+    followSpeed: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** `Follower` positional deadzone for body-follow (meters). */
+    followTolerance: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** Meters the focused window is nudged toward the viewer per focus depth. */
+    focusBias: {
+        type: Types.Float32;
+        default: number;
+    };
+    /**
+     * 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: number;
+    };
+    targetHeight: {
+        type: Types.Float32;
+        default: number;
+    };
+}>;
+/**
+ * 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 declare const UIWindowState: import("elics").Component<{
+    appliedDockMode: {
+        type: Types.String;
+        default: string;
+    };
+    chromeWired: {
+        type: Types.Boolean;
+        default: false;
+    };
+    /** "Home" snapshot captured on adoption - the DOCK button returns here. */
+    homeDockMode: {
+        type: Types.String;
+        default: string;
+    };
+    homeRegion: {
+        type: Types.String;
+        default: string;
+    };
+    homePosition: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    homeYaw: {
+        type: Types.Float32;
+        default: number;
+    };
+}>;
+/**
+ * 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 declare const UIDockRegion: import("elics").Component<{
+    regionId: {
+        type: Types.String;
+        default: string;
+    };
+    flow: {
+        type: Types.Enum;
+        enum: {
+            readonly Row: "row";
+            readonly Column: "column";
+            readonly Grid: "grid";
+        };
+        default: "column";
+    };
+    /** Distance between slot origins (meters). */
+    pitch: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** Columns per row (grid flow only). */
+    columns: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** Max docked windows (0 = unlimited). */
+    capacity: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** Drop-capture radius (meters). */
+    snapRadius: {
+        type: Types.Float32;
+        default: number;
+    };
+}>;
+/** Present on a window entity while it is docked into a region. */
+export declare const UIDockedTo: import("elics").Component<{
+    regionId: {
+        type: Types.String;
+        default: string;
+    };
+}>;

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":"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","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,44 @@
+/**
+ * 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 WindowOptionsBase } from '@realitycollective/webxr-uiextensions';
+/**
+ * Options for {@link createUIWindow}.
+ *
+ * Everything but `config` comes from the portable {@link WindowOptionsBase},
+ * so the same option names mean the same thing on every adapter. `maxWidth`
+ * and `maxHeight` route to `UIWindow.targetWidth/Height` here, because IWSDK
+ * 0.5 removed those fields from `PanelUI`; omit them to keep the markup's
+ * intrinsic size and scale through the entity transform.
+ */
+export interface CreateWindowOptions extends WindowOptionsBase {
+    /**
+     * 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;
+    /** Keep the window yawed toward the viewer while it is being dragged. */
+    billboardWhileDragging?: boolean;
+}
+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 {\n  DockMode,\n  type WindowOptionsBase,\n} from '@realitycollective/webxr-uiextensions';\n\n/**\n * Options for {@link createUIWindow}.\n *\n * Everything but `config` comes from the portable {@link WindowOptionsBase},\n * so the same option names mean the same thing on every adapter. `maxWidth`\n * and `maxHeight` route to `UIWindow.targetWidth/Height` here, because IWSDK\n * 0.5 removed those fields from `PanelUI`; omit them to keep the markup's\n * intrinsic size and scale through the entity transform.\n */\nexport interface CreateWindowOptions extends WindowOptionsBase {\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  /** Keep the window yawed toward the viewer while it is being dragged. */\n  billboardWhileDragging?: boolean;\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,25 @@
+/**
+ * @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 './component-set.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,28 @@
+/**
+ * @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 './component-set.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,oBAAoB,CAAC;AACnC,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 './component-set.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,44 @@
+/**
+ * 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 { type Entity, type World } from '@iwsdk/core';
+import { type PanelHandle, type SceneTarget, type WindowHandle, type WindowHost } from '@realitycollective/webxr-uiextensions';
+import { type CreateWindowOptions } from './factory.js';
+/**
+ * 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 declare function getPanelHandle(entity: Entity): PanelHandle | undefined;
+/** A window spawned by {@link IwsdkSceneHost.createWindow}. */
+export interface IwsdkWindowHandle extends WindowHandle {
+    /** The ECS entity carrying `PanelUI`, `UIWindow` and the interaction tags. */
+    readonly entity: Entity;
+}
+export interface IwsdkSceneHost extends WindowHost, SceneTarget {
+    readonly world: World;
+    /**
+     * Spawn a managed window and get a handle back straight away. IWSDK loads
+     * the markup over later frames, so `handle.panel` is `undefined` at first
+     * and `handle.onReady` is how you wait for it without an ECS query.
+     */
+    createWindow(options: CreateWindowOptions): IwsdkWindowHandle;
+}
+/**
+ * Create the host for a world. Call AFTER `registerUIExtensions(world)`.
+ */
+export declare function createSceneHost(world: World): IwsdkSceneHost;