@realitycollective/iwsdk-uiextensions 0.1.0-preview.0 → 0.1.0-preview.2

package/CHANGELOG.md

@@ -13,5 +13,26 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - `@realitycollective/xrblocks-uiextensions` - EXPERIMENTAL Google XR Blocks / plain three.js adapter: panel document, window host, follow and scale maths, desktop controls and locomotion, pointer forwarding.
 - `@realitycollective/uix-devtools` - dev-only tooling: edit-session launch gate, runtime UIKitML compilation, and the `uix-dev` CLI (Cloudflare quick tunnel, QR onboarding, environment doctor).
 - Demo clients: the IWSDK showcase, the devtools playground, and the multiplatform lab that picks its pipeline from the hardware.
+- `uixComponentSet`, exported from `@realitycollective/iwsdk-uiextensions`. Pass it to `spatialUI.componentSets` so the IWSDK 0.5 parser accepts the `<uix-*>` control elements. Without it a panel using any control fails to parse and never attaches. No equivalent is needed on the three.js or XR Blocks adapters.
+- `WindowHandle` and `WindowOptionsBase` in `@realitycollective/webxr-uiextensions`. `WindowHandle` is what every adapter's `createWindow` hands back: an `id`, a `panel` that is `undefined` until the adapter has attached the document, and `onReady(listener)`, which runs once and fires immediately if the panel is already there. `WindowOptionsBase` holds the options every adapter understands, and both adapters' option types now extend it, so an option name means the same thing on each. `createWindow` itself stays adapter-specific, because the `config` payload differs per engine.
+- `WindowHost.supportsStandalonePanels`. It says whether `createPanel` works on a host, rather than leaving callers to find out by catching. `false` on the IWSDK host, where the ECS owns panel lifecycles and `createPanel` throws; `true` on the three.js / XR Blocks host.
+- `PanelReadyEvent.kind`, either `window` or `panel`. `window` means the panel came from the adapter's window factory and is managed by the window manager. `panel` means a bare panel the adapter noticed, whose `id` is then the adapter's best stable identifier for it - the config path on IWSDK. The field is optional, so existing listeners keep compiling.
+- `createWindow` on the IWSDK scene host, returning an `IwsdkWindowHandle`: a `WindowHandle` plus the ECS `entity`. It spawns through `createUIWindow`, names the window `uix-window-<n>` when no id is given, and resolves `panel` and `onReady` once the document attaches, so wiring one window needs neither an ECS query nor a filtered `onPanelReady`. `createUIWindow` is unchanged and still returns the entity.
+- `getPanelHandle(entity)` in `@realitycollective/iwsdk-uiextensions`: the panel handle for an entity you already hold, or `undefined` while IWSDK is still loading its document.
+
+### Changed
+
+- **Controls are declared as custom elements rather than attributes.** `<uix-stepper>` replaces `<div data-uix="stepper">`, and each part is its own element: `<uix-value>`, `<uix-line>`, `<uix-label>` and so on, replacing `data-uix-role`. Parameters are unchanged and stay `data-uix-*`. This is what makes one markup file portable: IWSDK 0.5 parses with `@drawcall/uikitml`, which rejects every `data-*` attribute on a built-in tag but accepts custom tags declared in a component set, while the three.js and XR Blocks parser accepts custom tags with no registration at all. Both expose the declared tag on `userData.customElement.componentName`, so the engine-free upgraders read one contract on every adapter.
+- The expandable label's `toggle` part is now `<uix-more>`. As an element the old name would have collided with the `<uix-toggle>` control.
+- `@realitycollective/iwsdk-uiextensions` targets **IWSDK 0.5.x**: peer range `>=0.5.0 <0.6.0`, developed against `@iwsdk/core` 0.5.3. `PanelUI` in 0.5 declares a single field, `config`, holding the URL of the UIKitML **source**; the compiled JSON it took on 0.4.x, and the `@iwsdk/vite-plugin-uikitml` step that produced it, are both gone. `maxWidth` and `maxHeight` were removed from the component schema, and ECS ignores unknown fields silently, so a panel that still writes them is mis-sized with no error. Size through `createUIWindow`, which routes to `UIWindow.targetWidth/Height`.
+- `UixWindowHost` resolves a window's `config` by fetching the `.uikitml` source and parsing it, where it previously fetched compiled JSON. Supplying `loadConfig` is no longer necessary for an ordinary panel; override it only for an unusual transport.
+- `compilePanelSource` in `@realitycollective/uix-devtools` serves the **source** on its `blob:` URL rather than compiled JSON, matching what 0.5 fetches. `CompiledPanel.json` is now `CompiledPanel.source`, and the `resolveFile` option is gone because the 0.5 parser has no `<link ref>` stylesheet resolution; put shared rules in a `<style>` block, of which several are allowed and merge. Validation now runs on `@drawcall/uikitml`, pinned to the version `@iwsdk/core` depends on, so a source that passes here is one `PanelUISystem` will accept and no second parser enters the tree.
+- Example and demo markup uses `rgba()` or eight-digit hex rather than `background-opacity`, which the 0.5 parser removed. Both parsers accept the replacement, so one stylesheet serves every adapter.
+- The IWSDK component kit is selected by name, `spatialUI: { kit: 'horizon' }`, rather than by passing an imported kit module. The kits now live inside the parser.
+- `@types/three` is pinned to `0.184.0` across the workspace. IWSDK 0.5.3 and xrblocks resolved different copies, and two copies of the three typings make structurally identical `Object3D` types mutually unassignable, which surfaces as spurious errors far from their cause.
+- `onPanelReady` on the IWSDK host announces bare panels as well as managed windows. A `PanelUI` entity with no `UIWindow`, or with an empty `windowId`, used to be dropped silently; it is now announced with `kind: 'panel'` and its config path as the id. Listeners that only want managed windows should check `kind`.
+- `id` is optional in the XR Blocks host's `CreateWindowOptions`; a window created without one is named `uix-window-<n>`, as on IWSDK. The options also accept `movable` for parity, but this host has no title-bar drag of its own yet, so the flag is recorded and not acted on.
+- The XR Blocks window handle gains `panel` - the document, which already implements `PanelHandle` - and `onReady`, which fires synchronously because uikitml interprets the markup during `createWindow`. The interface is now named `XrBlocksWindowHandle`, with `WindowHandle` kept as an alias, because the core exports a `WindowHandle` of its own.
+- Coverage gates `packages/iwsdk-uiextensions/src/factory.ts` and `src/scene-host.ts` at the same 100% as the core. `new World()` from `@iwsdk/core` constructs headlessly - no renderer, no WebGL, no XR session - so the factories, the scene host and its ECS query all run for real in a node test. The per-frame ECS systems still need a live world and stay outside the gate.
 
 [0.1.0]: https://github.com/realitycollective/WebXR-UIExtensions/commits/main

package/Examples/basic-window/main.ts

@@ -1,6 +1,7 @@
 /**
  * Basic window - chrome, focus, docking and drag with one call.
- * Put window.uikitml in your app's ui/ folder (compiles to /ui/window.json).
+ * Put window.uikitml in your app's public/ui/ folder - IWSDK 0.5 fetches and
+ * parses the source at runtime, so there is no compile step.
  */
 import { World } from '@iwsdk/core';
 import {
@@ -19,7 +20,7 @@ export async function start(container: HTMLDivElement) {
   createUIWindow(world, {
     id: 'hello',
     title: 'Hello Window',
-    config: './ui/window.json',
+    config: './ui/window.uikitml',
     dockMode: DockMode.BodyFollow, // follows until pinned or dragged
     followOffset: [0, -0.15, -1.2],
   });

package/Examples/basic-window/window.uikitml

@@ -3,8 +3,7 @@
     display: flex;
     flex-direction: column;
     width: 300;
-    background-color: #101a26;
-    background-opacity: 0.92;
+    background-color: rgba(16, 26, 38, 0.92);
     border-radius: 12.5;
     border-color: #2e4a66;
     border-width: 0.75;

package/Examples/controls/controls.uikitml

@@ -4,8 +4,7 @@
     flex-direction: column;
     width: 300;
     padding: 10;
-    background-color: #101a26;
-    background-opacity: 0.92;
+    background-color: rgba(16, 26, 38, 0.92);
     border-radius: 12.5;
   }
   .row { display: flex; flex-direction: row; align-items: center; justify-content: space-between; width: 100%; margin-top: 7; }

package/Examples/controls/main.ts

@@ -17,16 +17,20 @@ export async function start(container: HTMLDivElement) {
   });
   registerUIExtensions(world);
 
+  // `config` is the only field PanelUI carries in IWSDK 0.5. maxWidth/maxHeight
+  // were removed from the schema; ECS ignores unknown fields silently, so
+  // writing them here would mis-size the panel with no error. Size a panel
+  // through createUIWindow instead, which routes to UIWindow.targetWidth/Height.
   const panel = world
     .createTransformEntity()
-    .addComponent(PanelUI, { config: './ui/controls.json', maxWidth: 0.8, maxHeight: 1 });
+    .addComponent(PanelUI, { config: './ui/controls.uikitml' });
   panel.object3D!.position.set(0, 1.5, -1.2);
 
   // Wire the handles once the panel loads.
   class WireSystem extends createSystem({
     panel: {
       required: [PanelUI, PanelDocument],
-      where: [eq(PanelUI, 'config', './ui/controls.json')],
+      where: [eq(PanelUI, 'config', './ui/controls.uikitml')],
     },
   }) {
     override init(): void {

package/Examples/dock-regions/main.ts

@@ -41,7 +41,7 @@ export async function start(container: HTMLDivElement) {
   createUIWindow(world, {
     id: 'docked',
     title: 'Docked Window',
-    config: './ui/window.json',
+    config: './ui/window.uikitml',
     region: 'wall',
   });
 
@@ -49,7 +49,7 @@ export async function start(container: HTMLDivElement) {
   createUIWindow(world, {
     id: 'floating',
     title: 'Drag Me Into A Region',
-    config: './ui/window.json',
+    config: './ui/window.uikitml',
     position: [0, 1.5, -1.4],
   });
 }

package/README.md

@@ -20,7 +20,7 @@ Everything is authored in plain UIKitML (HTML/CSS-like) - no new markup language
 
 ```bash
 npm install @realitycollective/iwsdk-uiextensions
-# peer: @iwsdk/core >= 0.4
+# peer: @iwsdk/core >=0.5.0 <0.6.0
 ```
 
 ## Quick start
@@ -45,7 +45,7 @@ createDockRegion(world, { id: 'wall', flow: 'column', position: [1.5, 1.8, -1.5]
 createUIWindow(world, {
   id: 'status',
   title: 'Player Status',
-  config: './ui/status.json',      // compiled UIKitML
+  config: './ui/status.uikitml', // UIKitML source; IWSDK 0.5 parses it at runtime
   dockMode: DockMode.BodyFollow,   // follows until the user pins it
 });
 
@@ -103,6 +103,44 @@ controls.stepper('health').events.on('change', (hp) => setHealth(hp));
 
 See `Examples/` (shipped in this package) and the deployable showcase client in the repository for complete, working demonstrations of every feature.
 
+## Windows and panel readiness
+
+`createUIWindow` returns the ECS entity, which is what you want when you are going to add components to it. When you want the PANEL, use the scene host: `createWindow` gives you a handle that resolves itself.
+
+```ts
+import { createSceneHost, getPanelHandle } from '@realitycollective/iwsdk-uiextensions';
+
+const host = createSceneHost(world);          // call after registerUIExtensions(world)
+
+const status = host.createWindow({
+  id: 'status',                                // optional - omit and you get uix-window-<n>
+  title: 'Player Status',
+  config: './ui/status.uikitml',
+});
+
+status.panel;                                  // undefined until IWSDK attaches the document
+status.onReady((panel) => {                    // runs once, immediately if it is already there
+  panel.getElementById('uix-title');
+});
+status.entity;                                 // still the entity, for ECS work
+```
+
+`getPanelHandle(entity)` does the same lookup for an entity you already hold, and returns `undefined` while the document is still loading.
+
+Across a whole scene, subscribe to the host instead:
+
+```ts
+host.onPanelReady(({ id, panel, kind }) => {
+  if (kind === 'panel') {
+    // A bare PanelUI entity with no UIWindow: `id` is its config path.
+    return;
+  }
+  wireMyWindow(id, panel);
+});
+```
+
+Bare panels are announced as well as managed windows, which is how devtools and hand-built `PanelUI` entities show up in the same stream. `supportsStandalonePanels` is `false` on this host: IWSDK owns panel lifecycles through the ECS, so `createPanel()` throws rather than half-working. Spawn a window instead.
+
 ## Headless core
 
 All decision logic (window manager, dock state machine, region slot math, drag math, control models) lives in `@realitycollective/webxr-uiextensions` - pure TypeScript with no engine imports, tested at 100% coverage. The ECS systems in this package are thin appliers of that core onto `@iwsdk/core` components.

package/dist/component-set.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The UIKitML component set for `<uix-*>` control elements.
+ *
+ * IWSDK 0.5 parses panels with `@drawcall/uikitml`, which validates every tag
+ * against a component schema and rejects anything it does not know - including
+ * every `data-*` attribute on a built-in tag. Declaring the control elements
+ * here is the supported way to extend that vocabulary.
+ *
+ * The three.js and XR Blocks adapters need no equivalent: their parser accepts
+ * custom tags unregistered, exposing the tag on
+ * `userData.customElement.componentName`. This set reproduces that convention
+ * on the IWSDK side - the constructor below stamps the same key and lifts
+ * `data-uix-*` attributes into `userData` - so ONE markup file drives every
+ * adapter and the engine-free upgraders read it identically everywhere.
+ *
+ * Register it when creating the world:
+ * ```ts
+ * const world = await World.create(container, {
+ *   features: { spatialUI: { kit: 'horizon', componentSets: [uixComponentSet] } },
+ * });
+ * ```
+ */
+import { type ComponentSet } from '@drawcall/uikitml';
+/**
+ * Pass to `spatialUI.componentSets` so `<uix-*>` elements parse on IWSDK 0.5.
+ * Without it, a panel using any control fails to parse and never attaches.
+ */
+export declare const uixComponentSet: ComponentSet;

package/dist/component-set.js

@@ -0,0 +1,108 @@
+/**
+ * The UIKitML component set for `<uix-*>` control elements.
+ *
+ * IWSDK 0.5 parses panels with `@drawcall/uikitml`, which validates every tag
+ * against a component schema and rejects anything it does not know - including
+ * every `data-*` attribute on a built-in tag. Declaring the control elements
+ * here is the supported way to extend that vocabulary.
+ *
+ * The three.js and XR Blocks adapters need no equivalent: their parser accepts
+ * custom tags unregistered, exposing the tag on
+ * `userData.customElement.componentName`. This set reproduces that convention
+ * on the IWSDK side - the constructor below stamps the same key and lifts
+ * `data-uix-*` attributes into `userData` - so ONE markup file drives every
+ * adapter and the engine-free upgraders read it identically everywhere.
+ *
+ * Register it when creating the world:
+ * ```ts
+ * const world = await World.create(container, {
+ *   features: { spatialUI: { kit: 'horizon', componentSets: [uixComponentSet] } },
+ * });
+ * ```
+ */
+import { htmlComponentSet } from '@drawcall/uikitml';
+import { z } from 'zod';
+/**
+ * Base container, taken from the parser's own `<div>` definition rather than
+ * imported from `@pmndrs/uikit` directly - that keeps a single copy of uikit
+ * in the tree, whichever version `@iwsdk/core` resolves.
+ */
+const BaseContainer = htmlComponentSet['div']
+    ?.component;
+/** Control elements an author writes, and the parts that live inside them. */
+const CONTROL_TAGS = [
+    'uix-stepper',
+    'uix-toggle',
+    'uix-expandable-label',
+    'uix-log-view',
+];
+const ROLE_TAGS = [
+    'uix-decrement',
+    'uix-value',
+    'uix-increment',
+    'uix-label',
+    'uix-line',
+    'uix-up',
+    'uix-down',
+    'uix-clear',
+    'uix-status',
+    'uix-text',
+    'uix-more',
+];
+/**
+ * `data-uix-min` → `uixMin`, matching how the other parser fills userData.
+ *
+ * The parser hands properties over already camelCased, so `data-uix-min`
+ * arrives as `dataUixMin`; both spellings are normalised here.
+ */
+function toUserDataKey(attribute) {
+    if (/^data[A-Z]/.test(attribute)) {
+        const rest = attribute.slice(4);
+        return rest.charAt(0).toLowerCase() + rest.slice(1);
+    }
+    return attribute
+        .replace(/^data-/, '')
+        .replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * A plain uikit Container that records what it was declared as.
+ *
+ * Anything the schema let through that is not a uikit property - the
+ * `data-uix-*` parameters - is moved into `userData` rather than handed to
+ * uikit, which would warn about properties it does not recognise.
+ */
+function controlComponent(tag) {
+    return class UixControlContainer extends BaseContainer {
+        constructor(properties = {}) {
+            const uikitProps = {};
+            const userData = {};
+            for (const [key, value] of Object.entries(properties)) {
+                if (key.startsWith('data-') || /^data[A-Z]/.test(key)) {
+                    userData[toUserDataKey(key)] = value;
+                }
+                else {
+                    uikitProps[key] = value;
+                }
+            }
+            super(uikitProps);
+            Object.assign(this.userData, userData, {
+                customElement: { componentName: tag, sourceTag: tag },
+            });
+        }
+    };
+}
+/** Permissive: the parameters are ours, and the upgraders validate them. */
+const schema = z.object({}).passthrough();
+function define(tag) {
+    return {
+        component: controlComponent(tag),
+        schema,
+        canHaveChildren: true,
+    };
+}
+/**
+ * Pass to `spatialUI.componentSets` so `<uix-*>` elements parse on IWSDK 0.5.
+ * Without it, a panel using any control fails to parse and never attaches.
+ */
+export const uixComponentSet = Object.fromEntries([...CONTROL_TAGS, ...ROLE_TAGS].map((tag) => [tag, define(tag)]));
+//# sourceMappingURL=component-set.js.map

package/dist/component-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-set.js","sourceRoot":"","sources":["../src/component-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,gBAAgB,EAA+C,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC;IAC3C,EAAE,SAEH,CAAC;AAEF,8EAA8E;AAC9E,MAAM,YAAY,GAAG;IACnB,aAAa;IACb,YAAY;IACZ,sBAAsB;IACtB,cAAc;CACN,CAAC;AAEX,MAAM,SAAS,GAAG;IAChB,eAAe;IACf,WAAW;IACX,eAAe;IACf,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;IACZ,UAAU;IACV,UAAU;CACF,CAAC;AAEX;;;;;GAKG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,SAAS;SACb,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,MAAM,mBAAoB,SAAQ,aAAa;QACpD,YAAY,aAAsC,EAAE;YAClD,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAA4B,EAAE,CAAC;YAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtD,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,UAAU,CAAC,CAAC;YAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACrC,aAAa,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE;aACtD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAE1C,SAAS,MAAM,CAAC,GAAW;IACzB,OAAO;QACL,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAgD;QAC/E,MAAM;QACN,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB,MAAM,CAAC,WAAW,CAC7D,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CACjE,CAAC","sourcesContent":["/**\n * The UIKitML component set for `<uix-*>` control elements.\n *\n * IWSDK 0.5 parses panels with `@drawcall/uikitml`, which validates every tag\n * against a component schema and rejects anything it does not know - including\n * every `data-*` attribute on a built-in tag. Declaring the control elements\n * here is the supported way to extend that vocabulary.\n *\n * The three.js and XR Blocks adapters need no equivalent: their parser accepts\n * custom tags unregistered, exposing the tag on\n * `userData.customElement.componentName`. This set reproduces that convention\n * on the IWSDK side - the constructor below stamps the same key and lifts\n * `data-uix-*` attributes into `userData` - so ONE markup file drives every\n * adapter and the engine-free upgraders read it identically everywhere.\n *\n * Register it when creating the world:\n * ```ts\n * const world = await World.create(container, {\n *   features: { spatialUI: { kit: 'horizon', componentSets: [uixComponentSet] } },\n * });\n * ```\n */\nimport { htmlComponentSet, type ComponentSet, type ComponentDefinition } from '@drawcall/uikitml';\nimport { z } from 'zod';\n\n/**\n * Base container, taken from the parser's own `<div>` definition rather than\n * imported from `@pmndrs/uikit` directly - that keeps a single copy of uikit\n * in the tree, whichever version `@iwsdk/core` resolves.\n */\nconst BaseContainer = htmlComponentSet['div']\n  ?.component as unknown as new (properties?: Record<string, unknown>) => {\n  userData: Record<string, unknown>;\n};\n\n/** Control elements an author writes, and the parts that live inside them. */\nconst CONTROL_TAGS = [\n  'uix-stepper',\n  'uix-toggle',\n  'uix-expandable-label',\n  'uix-log-view',\n] as const;\n\nconst ROLE_TAGS = [\n  'uix-decrement',\n  'uix-value',\n  'uix-increment',\n  'uix-label',\n  'uix-line',\n  'uix-up',\n  'uix-down',\n  'uix-clear',\n  'uix-status',\n  'uix-text',\n  'uix-more',\n] as const;\n\n/**\n * `data-uix-min` → `uixMin`, matching how the other parser fills userData.\n *\n * The parser hands properties over already camelCased, so `data-uix-min`\n * arrives as `dataUixMin`; both spellings are normalised here.\n */\nfunction toUserDataKey(attribute: string): string {\n  if (/^data[A-Z]/.test(attribute)) {\n    const rest = attribute.slice(4);\n    return rest.charAt(0).toLowerCase() + rest.slice(1);\n  }\n  return attribute\n    .replace(/^data-/, '')\n    .replace(/-([a-z0-9])/g, (_, c: string) => c.toUpperCase());\n}\n\n/**\n * A plain uikit Container that records what it was declared as.\n *\n * Anything the schema let through that is not a uikit property - the\n * `data-uix-*` parameters - is moved into `userData` rather than handed to\n * uikit, which would warn about properties it does not recognise.\n */\nfunction controlComponent(tag: string): typeof BaseContainer {\n  return class UixControlContainer extends BaseContainer {\n    constructor(properties: Record<string, unknown> = {}) {\n      const uikitProps: Record<string, unknown> = {};\n      const userData: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(properties)) {\n        if (key.startsWith('data-') || /^data[A-Z]/.test(key)) {\n          userData[toUserDataKey(key)] = value;\n        } else {\n          uikitProps[key] = value;\n        }\n      }\n      super(uikitProps);\n      Object.assign(this.userData, userData, {\n        customElement: { componentName: tag, sourceTag: tag },\n      });\n    }\n  };\n}\n\n/** Permissive: the parameters are ours, and the upgraders validate them. */\nconst schema = z.object({}).passthrough();\n\nfunction define(tag: string): ComponentDefinition {\n  return {\n    component: controlComponent(tag) as unknown as ComponentDefinition['component'],\n    schema,\n    canHaveChildren: true,\n  };\n}\n\n/**\n * Pass to `spatialUI.componentSets` so `<uix-*>` elements parse on IWSDK 0.5.\n * Without it, a panel using any control fails to parse and never attaches.\n */\nexport const uixComponentSet: ComponentSet = Object.fromEntries(\n  [...CONTROL_TAGS, ...ROLE_TAGS].map((tag) => [tag, define(tag)]),\n);\n"]}

package/dist/factory.d.ts

@@ -5,35 +5,24 @@
  */
 import { type Entity, type World } from '@iwsdk/core';
 import { RegionFlowType } from './components.js';
-import { type DockModeValue } from '@realitycollective/webxr-uiextensions';
-export interface CreateWindowOptions {
+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;
-    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;
+    /** Keep the window yawed toward the viewer while it is being dragged. */
     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 {

package/dist/factory.js

@@ -5,7 +5,7 @@
  */
 import { Follower, FollowBehavior, PanelUI, PokeInteractable, RayInteractable, } from '@iwsdk/core';
 import { UIDockRegion, UIDockedTo, UIWindow, RegionFlowType } from './components.js';
-import { DockMode } from '@realitycollective/webxr-uiextensions';
+import { DockMode, } from '@realitycollective/webxr-uiextensions';
 export function createUIWindow(world, options) {
     const entity = world
         .createTransformEntity()

package/dist/factory.js.map

@@ -1 +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"]}
+{"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

@@ -14,6 +14,7 @@ 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';

package/dist/index.js

@@ -16,6 +16,7 @@ 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';

package/dist/index.js.map

@@ -1 +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"]}
+{"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/scene-host.d.ts

@@ -11,11 +11,32 @@
  *
  * 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 World } from '@iwsdk/core';
-import { type SceneTarget, type WindowHost } from '@realitycollective/webxr-uiextensions';
+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)`.

package/dist/scene-host.js

@@ -11,10 +11,13 @@
  *
  * 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 { createDockRegion, createUIWindow, } from './factory.js';
 import { UIWindow } from './components.js';
 /** Panel handle over an IWSDK `UIKitDocument`. */
 function panelHandleFor(document) {
@@ -29,6 +32,15 @@ function panelHandleFor(document) {
         },
     };
 }
+/**
+ * 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.
@@ -56,18 +68,19 @@ export function createSceneHost(world) {
             return;
         }
         seen.add(document);
-        // Window id comes from the UIWindow component the factory attached.
-        const id = entity.hasComponent(UIWindow)
+        // 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]
             : '';
-        if (!id) {
-            return; // a bare panel, not a managed window - nothing to wire by id
-        }
+        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 };
+        const event = { id, panel, kind };
         ready.set(id, event);
         for (const listener of readyListeners) {
             try {
@@ -79,8 +92,12 @@ export function createSceneHost(world) {
         }
     };
     world.registerSystem(createReadySystem(announce));
-    return {
+    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.');
@@ -92,6 +109,33 @@ export function createSceneHost(world) {
             }
             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,
@@ -112,7 +156,7 @@ export function createSceneHost(world) {
             });
         },
         spawnWindow(window) {
-            createUIWindow(world, {
+            host.createWindow({
                 id: window.id,
                 title: window.title,
                 config: window.config,
@@ -141,5 +185,6 @@ export function createSceneHost(world) {
             });
         },
     };
+    return host;
 }
 //# sourceMappingURL=scene-host.js.map

package/dist/scene-host.js.map

@@ -1 +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"]}
+{"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/window-system.d.ts

@@ -80,14 +80,6 @@ declare const UIWindowSystem_base: import("elics").SystemConstructor<import("eli
                 type: import("@iwsdk/core").Types.String;
                 default: string;
             };
-            maxWidth: {
-                type: import("@iwsdk/core").Types.Float32;
-                default: number;
-            };
-            maxHeight: {
-                type: import("@iwsdk/core").Types.Float32;
-                default: number;
-            };
         }> | import("elics").Component<{
             document: {
                 type: import("@iwsdk/core").Types.Object;
@@ -293,14 +285,6 @@ declare const UIWindowSystem_base: import("elics").SystemConstructor<import("eli
                 type: import("@iwsdk/core").Types.String;
                 default: string;
             };
-            maxWidth: {
-                type: import("@iwsdk/core").Types.Float32;
-                default: number;
-            };
-            maxHeight: {
-                type: import("@iwsdk/core").Types.Float32;
-                default: number;
-            };
         }> | import("elics").Component<{
             document: {
                 type: import("@iwsdk/core").Types.Object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realitycollective/iwsdk-uiextensions",
-  "version": "0.1.0-preview.0",
+  "version": "0.1.0-preview.2",
   "description": "Meta IWSDK adapter for the Reality Collective UI Extensions - windowing, docking, layout regions and extra controls, binding the engine-free @realitycollective/webxr-uiextensions core onto IWSDK's ECS, UIKitML and interaction systems.",
   "keywords": [
     "realitycollective",
@@ -36,16 +36,18 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@drawcall/uikitml": "0.1.8",
+    "zod": "^4.4.3",
     "@pmndrs/handle": "^6.6.16",
-    "@realitycollective/webxr-uiextensions": "^0.1.0-preview.0"
+    "@realitycollective/webxr-uiextensions": "^0.1.0-preview.2"
   },
   "peerDependencies": {
-    "@iwsdk/core": ">=0.4.0 <0.6.0"
+    "@iwsdk/core": ">=0.5.0 <0.6.0"
   },
   "devDependencies": {
-    "@iwsdk/core": "0.4.2",
+    "@iwsdk/core": "0.5.3",
     "three": "npm:super-three@0.181.0",
-    "@types/three": "*"
+    "@types/three": "0.184.0"
   },
   "repository": {
     "type": "git",