@realitycollective/xrblocks-uiextensions 0.1.0-preview.7 → 0.1.0

package/CHANGELOG.md

@@ -4,10 +4,20 @@ Change log for the Reality Collective WebXR UI Extensions packages. All four pac
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Preview builds are not listed separately. The entry for a version accumulates while its previews are published, and is dated when that version is released.
 
-## [0.1.0]
+## [0.1.0] - 2026-09-17
 
 ### Added
 
+- `WindowManager` is now the complete state API for a window, so a hand menu, shortcut or voice command can drive a targeted window without touching the engine. New on the record: `hidden`, `region` and `chrome`. New calls: `hide(id)`, `show(id)`, `toggleHidden(id)`; `dockTo(id, regionId)`, `undock(id)`, `returnHome(id)`; `setChrome(id, partial)`. New events: `hidden`, `shown`, `regionChanged`, `returnHome`, `chromeChanged`. `OpenWindowOptions` takes `hidden`, `region` and `chrome`. A hidden window is neither drawn nor hittable but keeps its dock mode, region slot and minimized state, and `show` puts it back in front; `returnHome` announces only, because the adapter owns the spawn snapshot. Both adapters apply every event: the IWSDK `UIWindowSystem` toggles visibility and strips or restores `RayInteractable`/`PokeInteractable`, adds or removes `UIDockedTo`, and mirrors the chrome flags onto `UIWindow`; the XR Blocks host toggles the group, docks through its registry and keeps a home snapshot. The reverse direction is kept in step too: a drag-drop dock, a rejected dock (unknown or full region) and a dock-mode change applied by the ECS are written back into the record, so `windows.get(id)` is always what the scene shows.
+- `dockable` on `WindowOptionsBase`, `SceneWindow`, the IWSDK `UIWindow` component and both adapters' create options. The DOCK button previously had no flag at all and was always live.
+- Near drag on IWSDK. `UIDragSystem` now lets the near `grab` pointer pick a window up by its title bar: a controller squeeze, or a hand pinch while the hand is on the bar. IWSDK only ever tests the grab pointer against `OneHandGrabbable`/`TwoHandsGrabbable` entities and only enables it when `features.grabbing` is on, so the system, which runs after `InputSystem`, appends every movable title bar to `scene.grabDescendants` each frame, enables the `grab` sub-pointer itself, and forwards a pinch to it only while the grab pointer is on one of its title bars (leaving pinches elsewhere to whatever the app decided, and deferring entirely when `GrabSystem` is registered with `useHandPinchForGrab`). A near grab drags at once, with no hold delay; a ray press still waits out `dragDelay` so title-bar clicks stay clicks. Off with `registerUIExtensions(world, { nearDrag: false })` or `configData: { nearDrag: false }` on the system. Putting `OneHandGrabbable` on the window was not an option: IWSDK would grab the whole panel and set `pointerEventsType = { deny: 'ray' }` on it, ending far interaction.
+- `HoldToDrag.update` takes an optional per-press `delaySeconds` override, which is what lets a near grab skip the click window without a second store.
+- A sixth contract case, `closing through the manager takes the window out of onPanelReady replay`, and a required `manager` on `WindowHostContractSetup`. Both shipped adapters pass it; the IWSDK setup now registers `UIWindowSystem` so the record opens and the entity is destroyed for real in the headless world.
+- Headless tests for the IWSDK systems, `packages/iwsdk-uiextensions/test/window-system.test.ts`: `UIWindowSystem`, `UIDockSystem`, `UIDockRegionSystem` and `UIDragSystem` run against a real `World` with fake documents. They cover close in both directions, hide/show, chrome gating and runtime enablement, regions through the manager and back, return-home, and the grab-list registration. Every world in a test file now registers the same components in the same order, because elics keeps `typeId` on the component object and `addComponent` only registers a component whose `typeId` is still -1: a component first registered lazily (IWSDK's `Transform`) keeps the id it got in an earlier world, and a later world that hands that id to another component makes the two share a bit.
+- Hand menus, as a fourth dock mode, `hand-locked`, in the manner of MRTK 2's hand menu. A hand-locked window rides a hand and shows while that palm is raised toward the viewer. The window's `handMenu` options (on `WindowOptionsBase`, `SceneWindow`, `OpenWindowOptions` and the record, with `setHandMenu` and a `handMenuChanged` event) choose the hand (`left`, `right`, or `either` for whichever palm is raised), the anchor (`above` the fingertips, `inside` on the thumb side, `outside`, or `wrist`), the distance and an extra hand-local offset, and the palm gate with its angle; defaults are left hand, above, gated at 60 degrees. The core's `hand-menu.ts` owns the placement and the gate in the WebXR grip frame as the Device API defines it (`-Z` toward the thumb, `+Y` up the arm, the palm at `-X` on the right hand and `+X` on the left; hand joint spaces differ and are not used), so every adapter reads the same offsets: `evaluateHandMenu`, `handMenuPose`, `pickHand`, `palmFacing`, `faceViewer`. A `HandPoseSource` joins the adapter contract, with an optional `hasHands()` so a page serving both a desktop and a headset can fall back to body-follow placement outside a session. On IWSDK, `UIDockSystem` reads the player rig's grip spaces (a controller's grip or the tracked hand) and writes the gate into `UIWindowState.gateOpen`; `UIWindowSystem` combines that with `hidden` in one presentation reconcile, so a shut gate strips the interaction tags the same way `hide()` does. `UIDockSystem` now registers at priority -1 so the gate it writes is applied the same frame. The `UIWindow` component carries `hand`, `handAnchor`, `handAnchorDistance`, `handOffset`, `palmGate` and `palmAngle`. On XR Blocks, `UixWindowHost` takes an optional `handPose`, `connectUIExtensions` takes `xr: renderer.xr`, and `webxrHandPoseSource` reads the session's input sources (grip space, or the target ray space for a hand without one). `HAND_MENU_SNIPPET` is the reference markup: the same root and content ids, no title bar, a vertical stack of buttons that sizes to its content. Pinning or dragging a hand menu lands it world-locked where it was.
+- `TouchPress` in `@realitycollective/webxr-uiextensions` (`core/touch-press.ts`, with `TouchPressOptions`, `DEFAULT_TOUCH_PRESS`, `resolveTouchPress`, `TouchSample`, `TouchUpdate`): the press / hold / release state machine for a near (poke) pointer over a signed distance. A press starts only when the fingertip enters the press band from the front (or is first seen in front of the surface); the touch is then held whatever the finger does until it comes back out past the release distance or contact is lost, so a second press cannot start before a release; a fingertip arriving from behind never presses unless `allowFromBehind` is set. Defaults: press at 2 cm, release at 3 cm. The target under the finger is recorded at the press and reported again at the release, because they can differ when a finger enters one button and leaves through another.
+- `UITouchGuardSystem` in `@realitycollective/iwsdk-uiextensions`, registered by `registerUIExtensions` at priority -3.9 (straight after `InputSystem`) unless `touchGuard: false`, with thresholds through `touchGuard: { pressDistance, releaseDistance, allowFromBehind }`. It takes over the two IWSDK touch pointers' `down` and `up` (IWSDK's own calls, including its forced release on lost hover, become no-ops) and issues them from `TouchPress` fed with the signed distance from the fingertip to the surface it is over, using the intersection's normal in world space (a target without one keeps the unsigned behaviour). `pointerdown`, `pointerup` and `click` still reach elements through the pointer as before, so IWSDK's own panels and every `PokeInteractable` are covered. IWSDK's 800 ms click window is unchanged.
+- The showcase's `Window Control` is that hand menu, on the left hand, wired in the engine-free `playground-behaviour.ts` so it runs on the IWSDK, XR Blocks and desktop pipelines alike (following the body on the desktop, where there are no hands). The scene also shows the three ways to use opt-in chrome, named in the titles: `Click Machine (all buttons)`, `Gallery (no buttons)` and `Player Status (menu-driven)`. `Examples/basic-window/` in `@realitycollective/iwsdk-uiextensions` now spawns its window with no title-bar buttons and drives it from a hand menu (HIDE, PIN, HOME, MIN, BUTTONS, CLOSE), with labels read back from the record.
 - `verify:pack` now lints the shape of what ships: publint over every package directory, with warnings counted as errors, and attw (Are The Types Wrong) over every packed tarball, resolving the published types under node10, node16 and bundler resolution. `cjs-resolves-to-esm` is ignored by design, because every package is ESM-only and a require() caller is expected to use a dynamic import. Both run offline on the tarballs the script already builds; `publint` and `@arethetypeswrong/cli` are dev dependencies. The script stays identical across the Reality Collective repositories.
 - `verify:pack` now also type-checks the published declarations themselves, with library checking on, through `scripts/declaration-check.mjs`, runnable on its own as `node scripts/declaration-check.mjs`. Each package's declaration entry is compiled as a strict consumer would compile it, with `skipLibCheck: false`, under nodenext and then bundler resolution; a diagnostic inside the package fails the run, and diagnostics inside upstream declaration files are counted and ignored, because they are not ours to fix and would drown the signal. attw proves the published types resolve; this proves they compile, which is what a consumer with library checking on, or a package emitting declarations on top of ours, needs. The check is opt-in per repository, through `declarationCheck` in `scripts/release.config.json`, because only a foreign declaration can put a name into our emitted types that the build did not already check. This repository reaches around 950 of them, from the IWSDK and three.js typings the adapter is built against, and every run prints that count so the opt-in stays measured rather than habitual. It is the check that would have caught the bare `World` under Fixed.
 - `@realitycollective/webxr-uiextensions` - engine-free core: window manager, dock state and regions, drag maths, hold-to-drag, control models (stepper/toggle/expandable/log), the `SceneDescriptor` scene format, window chrome conventions and the platform-adapter contract.
@@ -25,6 +35,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 ### Changed
 
+- **Every title-bar button is off by default.** `closable`, `minimizable` and `pinnable` defaulted to `true` on the IWSDK `UIWindow` component, `createUIWindow`, the scene host and the XR Blocks host, so a window showed every button its markup carried whether the app wanted it or not; the new `dockable` joins them at `false`. Pass `true` for the buttons a window should have, or enable them later with `WindowManager.setChrome`. The reference markup keeps all four elements so they can be switched on at runtime; a disabled button is hidden and its click ignored. Migration: windows that relied on the old default need `closable: true, minimizable: true, pinnable: true` (and `dockable: true` for DOCK, which was previously always on). The shipped examples, the showcase scene and the devtools playground now say which buttons they want.
+- Chrome buttons are wired once, at adoption, and gated on the record at click time, so enabling one later needs no rewiring. The IWSDK X button now closes through `manager.close(id)`, which destroys the entity, rather than destroying the entity directly, so there is one teardown path. On XR Blocks, `host.dock(windowId, regionId)` is now a forwarder to `manager.dockTo`/`manager.undock`; existing callers read the same.
 - **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`.
@@ -40,10 +52,11 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - `@realitycollective/webxr-uiextensions` takes its geometry vocabulary from `@realitycollective/webxr-input` at `^0.1.1` rather than redeclaring it. `Vec3Tuple`, `QuatTuple`, `HeadPose`, `HeadPoseSource` and `PointerSample` are now that package's types, re-exported under the same names, so no import changes for a consumer. `PointerSample` is its `RayTuple`, which is what lets an input provider written against the shared contracts feed this contract unchanged. It is the core's only runtime dependency: the contracts package is engine-free and carries none of its own, and `test/architecture.test.ts` now allows exactly that one name and fails on any other.
 - `PointerSample` states its ownership rule: a delivered sample belongs to the listener and the source never writes to it again, so the core's hold-to-drag and drag maths may keep a press-time sample without copying. It mirrors the rule `@realitycollective/webxr-input` 0.1.3 writes on `InputSourceSnapshot`, so a provider feeding both contracts has one promise to keep.
 
-[0.1.0]: https://github.com/realitycollective/WebXR-UIExtensions/commits/main
+[0.1.0]: https://github.com/realitycollective/WebXR-UIExtensions/releases/tag/v0.1.0
 
 ### Fixed
 
+- `manager.close(id)` on IWSDK removed the record and emitted `closed`, but `UIWindowSystem` had no `closed` listener, so the entity and its panel stayed in the scene, orphaned, with chrome wired to a dead id. The XR Blocks host did dispose on `closed`, so the two adapters disagreed, and the devtools playground's "replace last" path hit it on every use. The window system now destroys the entity on `closed` (guarded against the entity-side path re-entering), and the scene host forgets the window so `onPanelReady` stops replaying it.
 - `@realitycollective/iwsdk-uiextensions` shipped five declaration files (`controls-system`, `dock-region-system`, `dock-system`, `drag-system` and `window-system` under `dist/systems/`) whose `createSystem` base type named `World` without importing it, so a consumer with `skipLibCheck: false`, or one emitting declarations on top of the package, failed with TS2304 on its first import. Reported by the Anatomy Atlas XR client on 9 September 2026 against preview.4 and preview.6. The cause is upstream: `@iwsdk/core` 0.5.3's `dist/ecs/system.d.ts` imports `World` from `'./world'` with no extension, the only such import in the package, and under the NodeNext resolution this repository builds with that import does not resolve (TS2835), so `World` was an unresolved name inside the host's own declaration and TypeScript's declaration emitter preserved it verbatim. `skipLibCheck` hid the error on both sides. The adapter now takes `createSystem` from its own `src/create-system.ts`, a wrapper whose return type names `World` through `@iwsdk/core`'s barrel, so every emitted base type reads `import("@iwsdk/core").World`. The wrapper goes the day IWSDK ships `./world.js` there.
 - `createSceneHost(world)` returns the same host on every call for a world, where it previously built a new one each time. A second host registered a second readiness ECS system on the same world and repeated the panel upgrade pass, so two modules each asking for the host quietly doubled that work. It now memoises per world exactly as the window manager registry does, which also means separate modules can ask for the host without coordinating or passing it around.
 - Documented in `@realitycollective/iwsdk-uiextensions` that `onPanelReady` announces windows spawned by `createUIWindow`, not only by `host.createWindow`, so code holding factory entities has a readiness signal without changing how it spawns them. The readiness section now also warns against polling `getPanelHandle` on a timer, because a poll that gives up early leaves a window that draws and responds to nothing with no error, and records that a factory window created without an `id` is announced as `kind: 'panel'` with its config path, which a listener filtering on `kind === 'window'` will never see.

package/README.md

@@ -9,16 +9,20 @@
 | Feature | IWSDK | XR Blocks / three.js (this package) |
 | --- | --- | --- |
 | UIKitML panel hosting (runtime interpret, scale-to-fit) | ✅ | ✅ `UixPanelDocument` |
-| Window lifecycle + chrome (focus/PIN/MIN/X, pin labels) | ✅ | ✅ `UixWindowHost` |
+| Window lifecycle + chrome (focus/PIN/DOCK/MIN/X, all opt-in, pin labels) | ✅ | ✅ `UixWindowHost` |
+| Driving windows from code (`WindowManager`: hide/show, dockTo/undock/returnHome, setChrome, close) | ✅ | ✅ every manager event applied |
 | Portable scene descriptors (`applyScene`) | ✅ | ✅ implements `SceneTarget` |
 | Panel-ready wiring (`onPanelReady`) | ✅ | ✅ implements `WindowHost` |
 | Follow mode (body-follow, yaw-only, eased) | ✅ | ✅ pure `follow-math` |
-| Dock regions (wall/belt, slots, follow) | ✅ | ✅ `createRegion` / `dock` |
+| Hand menus (`hand-locked`, palm gate, anchors) | ✅ from the player rig | ✅ from a `HandPoseSource`; `webxrHandPoseSource(renderer.xr)` reads the session's input sources, and without hands the menu follows the body |
+| Dock regions (wall/belt, slots, follow) | ✅ | ✅ `createRegion`, `manager.dockTo` (`host.dock` forwards) |
 | Desktop mouse input (hover, click, drag-to-look) | ✅ | ✅ via `@pmndrs/pointer-events` |
 | Desktop locomotion (WASD, jump, crouch, sprint) | n/a | ✅ `DesktopControls` |
 | XR select-ray click forwarding | ✅ | ✅ minimal (`forwardClick`) |
 | Bare panels (`createPanel`) | ⬜ ECS owns the lifecycle | ✅ `supportsStandalonePanels` is `true` |
 | Title-bar ray drag (`@pmndrs/handle`) | ✅ | ⬜ roadmap (`movable` is accepted and ignored) |
+| Title-bar near grab (squeeze / pinch) | ✅ | ⬜ roadmap (needs drag) |
+| Guarded poke (one press per touch, front only) | ✅ `UITouchGuardSystem` over IWSDK's touch pointers | ⬜ no near touch here yet; the core `TouchPress` is ready for it |
 | Drop-to-dock by dragging | ✅ | ⬜ roadmap (needs drag) |
 | System keyboard text input | ✅ | ⬜ untested on Android XR |
 
@@ -79,6 +83,8 @@ Nothing here imports `xrblocks` - the glue binds to plain three.js shapes (`scen
 
 - `id` is optional. Omit it and the window is named `uix-window-<n>`.
 - `movable` is accepted and recorded, but nothing acts on it yet: this host has no title-bar drag of its own, so there is no gate to close. It is in the options so a scene descriptor written for IWSDK loads here unchanged.
+- The four chrome flags (`closable`, `minimizable`, `pinnable`, `dockable`) are off unless set, as on IWSDK; `host.manager.setChrome(id, {...})` changes them later. `host.manager.hide/show`, `dockTo/undock/returnHome` and `close` all take effect here, so a menu written against the manager needs no host-specific code.
+- `handMenu` and `dockMode: 'hand-locked'` make a hand menu. Pass `xr: renderer.xr` to `connectUIExtensions` (or `handPose` to the host) so it rides the session's tracked hands; on a page that also serves a desktop the source reports no hands outside a session and the menu follows the body until one starts.
 
 The handle it returns satisfies the core `WindowHandle` and adds the three.js specifics:
 

package/dist/host.d.ts

@@ -3,9 +3,15 @@
  *
  * Owns a core `WindowManager` + `RegionRegistry` and applies their decisions
  * to the scene graph: spawn UIKitML windows and dock regions, wire chrome
- * buttons (focus / PIN / MIN / X), collapse content while minimized, place
- * docked windows into their region's slots, and ease `body-follow` windows
- * (and body-locked regions) toward the viewer each frame.
+ * buttons (focus / PIN / DOCK / MIN / X), collapse content while minimized,
+ * hide and show, place docked windows into their region's slots, return a
+ * window to where it spawned, ease `body-follow` windows (and body-locked
+ * regions) toward the viewer each frame, and ride `hand-locked` windows
+ * (hand menus) on a tracked hand behind the palm gate.
+ *
+ * The manager is the API app code drives; every manager event is applied
+ * here, so `host.manager.hide(id)` or `.dockTo(id, region)` from a hand menu
+ * is all a caller needs.
  *
  * It implements the core's `WindowHost` (so app code can wire behaviour
  * through `onPanelReady` with no engine knowledge) and `SceneTarget` (so a
@@ -13,7 +19,7 @@
  */
 import { Group, type Object3D } from 'three';
 import { type Kit } from '@pmndrs/uikitml';
-import { RegionRegistry, WindowManager, type HeadPoseSource, type PanelHandle, type PanelReadyEvent, type RegionDefinition, type SceneRegion, type SceneTarget, type SceneWindow, type Vec3Tuple, type WindowHandle as CoreWindowHandle, type WindowHost, type WindowOptionsBase } from '@realitycollective/webxr-uiextensions';
+import { RegionRegistry, WindowManager, type HandPoseSource, type HeadPoseSource, type PanelHandle, type PanelReadyEvent, type RegionDefinition, type SceneRegion, type SceneTarget, type SceneWindow, type Vec3Tuple, type WindowHandle as CoreWindowHandle, type WindowHost, type WindowOptionsBase } from '@realitycollective/webxr-uiextensions';
 import { UixPanelDocument } from './panel-document.js';
 /**
  * Options for {@link UixWindowHost.createWindow}.
@@ -65,6 +71,13 @@ export interface UixWindowHostOptions {
     scene: Object3D;
     /** Viewer pose provider - camera on desktop, HMD pose in XR. */
     headPose: HeadPoseSource;
+    /**
+     * Tracked-hand pose provider, for `hand-locked` windows (hand menus). See
+     * `webxrHandPoseSource` for one backed by a WebXR session. Leave it out
+     * where there are no hands (a desktop) and hand-locked windows fall back
+     * to body-follow placement, so the same scene still shows its menus.
+     */
+    handPose?: HandPoseSource;
     /** Optional UIKitML component kit(s) (e.g. horizon kit). */
     kit?: Kit;
     /**
@@ -85,6 +98,7 @@ export declare class UixWindowHost implements WindowHost, SceneTarget {
     readonly regions: RegionRegistry;
     private readonly scene;
     private readonly headPose;
+    private readonly handPose;
     private readonly kit;
     private readonly loadConfig;
     private readonly states;
@@ -115,18 +129,33 @@ export declare class UixWindowHost implements WindowHost, SceneTarget {
     /** Create a dock region anchored in the scene. */
     createRegion(options: CreateRegionOptions): RegionHandle;
     region(id: string): RegionHandle | undefined;
-    /** Dock a window into a region (or undock it with `undefined`). */
+    /**
+     * Dock a window into a region (or undock it with `undefined`). A thin
+     * forwarder to the manager, kept so existing callers read the same;
+     * `manager.dockTo` / `manager.undock` are the portable calls.
+     */
     dock(windowId: string, regionId: string | undefined): void;
+    /** Make the registry (and the layout) agree with the record's region. */
+    private applyRegion;
+    /** Put a window back where it spawned: its region, or its placement and mode. */
+    private returnHome;
     /** Spawn a managed window from compiled UIKitML JSON. */
     createWindow(options: CreateWindowOptions): XrBlocksWindowHandle;
     window(id: string): XrBlocksWindowHandle | undefined;
     /** Drive per-frame from the engine loop (delta in SECONDS). */
     update(deltaSeconds: number): void;
+    /** This frame's tracked hands from the source, absent ones left out. */
+    private readHands;
+    private placeOnHand;
     private applyFollow;
     /** Re-place every docked window into its region's slot. */
     private layoutRegions;
     private layoutRegion;
     private wireChrome;
+    /** Show exactly the enabled buttons. */
+    private applyChrome;
+    /** Drawn exactly when not hidden and (for a hand menu) the palm gate is open. */
+    private applyPresentation;
     private setContentCollapsed;
     /** MIN when open, MAX when minimized - the label names the next action. */
     private syncMinimizeLabel;

package/dist/host.js

@@ -3,9 +3,15 @@
  *
  * Owns a core `WindowManager` + `RegionRegistry` and applies their decisions
  * to the scene graph: spawn UIKitML windows and dock regions, wire chrome
- * buttons (focus / PIN / MIN / X), collapse content while minimized, place
- * docked windows into their region's slots, and ease `body-follow` windows
- * (and body-locked regions) toward the viewer each frame.
+ * buttons (focus / PIN / DOCK / MIN / X), collapse content while minimized,
+ * hide and show, place docked windows into their region's slots, return a
+ * window to where it spawned, ease `body-follow` windows (and body-locked
+ * regions) toward the viewer each frame, and ride `hand-locked` windows
+ * (hand menus) on a tracked hand behind the palm gate.
+ *
+ * The manager is the API app code drives; every manager event is applied
+ * here, so `host.manager.hide(id)` or `.dockTo(id, region)` from a hand menu
+ * is all a caller needs.
  *
  * It implements the core's `WindowHost` (so app code can wire behaviour
  * through `onPanelReady` with no engine knowledge) and `SceneTarget` (so a
@@ -27,7 +33,7 @@ async function loadUikitmlSource(path) {
     }
     return parse(await response.text());
 }
-import { DockMode, RegionRegistry, WINDOW_CHROME_IDS, WindowManager, minimizeLabelFor, pinLabelFor, slotOffset, } from '@realitycollective/webxr-uiextensions';
+import { DockMode, RegionRegistry, WINDOW_CHROME_IDS, WindowManager, evaluateHandMenu, minimizeLabelFor, pinLabelFor, slotOffset, } from '@realitycollective/webxr-uiextensions';
 import { approach, approachAlpha, distanceSquared, followTarget, } from './follow-math.js';
 import { UixPanelDocument } from './panel-document.js';
 const DEFAULT_FOLLOW_OFFSET = [0, -0.15, -1.2];
@@ -39,6 +45,7 @@ export class UixWindowHost {
     regions = new RegionRegistry();
     scene;
     headPose;
+    handPose;
     kit;
     loadConfig;
     states = new Map();
@@ -51,6 +58,7 @@ export class UixWindowHost {
     constructor(options) {
         this.scene = options.scene;
         this.headPose = options.headPose;
+        this.handPose = options.handPose;
         this.kit = options.kit;
         this.loadConfig = options.loadConfig ?? loadUikitmlSource;
         this.manager.events.on('closed', (record) => {
@@ -64,6 +72,31 @@ export class UixWindowHost {
                 this.layoutRegions();
             }
         });
+        this.manager.events.on('hidden', (record) => {
+            this.applyPresentation(record.id);
+        });
+        this.manager.events.on('shown', (record) => {
+            this.applyPresentation(record.id);
+        });
+        this.manager.events.on('dockChanged', ({ window, previous }) => {
+            if (previous === DockMode.HandLocked) {
+                // Off the hand: the gate no longer applies.
+                const state = this.states.get(window.id);
+                if (state) {
+                    state.gateOpen = true;
+                    this.applyPresentation(window.id);
+                }
+            }
+        });
+        this.manager.events.on('regionChanged', ({ window }) => {
+            this.applyRegion(window);
+        });
+        this.manager.events.on('returnHome', (record) => {
+            this.returnHome(record.id);
+        });
+        this.manager.events.on('chromeChanged', ({ window }) => {
+            this.applyChrome(window);
+        });
         this.manager.events.on('minimized', (record) => {
             this.setContentCollapsed(record.id, true);
             this.syncMinimizeLabel(record.id);
@@ -147,6 +180,8 @@ export class UixWindowHost {
                     ? { minimizable: window.minimizable }
                     : {}),
                 ...(window.pinnable !== undefined ? { pinnable: window.pinnable } : {}),
+                ...(window.dockable !== undefined ? { dockable: window.dockable } : {}),
+                ...(window.handMenu !== undefined ? { handMenu: window.handMenu } : {}),
             });
         })
             .catch((error) => {
@@ -175,17 +210,59 @@ export class UixWindowHost {
     region(id) {
         return this.regionStates.get(id)?.handle;
     }
-    /** Dock a window into a region (or undock it with `undefined`). */
+    /**
+     * Dock a window into a region (or undock it with `undefined`). A thin
+     * forwarder to the manager, kept so existing callers read the same;
+     * `manager.dockTo` / `manager.undock` are the portable calls.
+     */
     dock(windowId, regionId) {
         if (regionId === undefined) {
-            this.regions.undock(windowId);
+            this.manager.undock(windowId);
         }
         else {
-            this.regions.dock(windowId, regionId);
-            this.manager.setDockMode(windowId, DockMode.WorldLocked);
+            this.manager.dockTo(windowId, regionId);
+        }
+    }
+    /** Make the registry (and the layout) agree with the record's region. */
+    applyRegion(record) {
+        const current = this.regions.regionOf(record.id);
+        if (current === record.region) {
+            return;
+        }
+        if (current !== undefined) {
+            this.regions.undock(record.id);
+        }
+        if (record.region !== undefined) {
+            try {
+                this.regions.dock(record.id, record.region);
+            }
+            catch (error) {
+                // Unknown or full region: the record must not claim it.
+                this.manager.undock(record.id);
+                throw error;
+            }
+            this.manager.setDockMode(record.id, DockMode.WorldLocked);
         }
         this.layoutRegions();
     }
+    /** Put a window back where it spawned: its region, or its placement and mode. */
+    returnHome(id) {
+        const state = this.states.get(id);
+        if (!state) {
+            return;
+        }
+        const { home } = state;
+        if (home.region !== undefined) {
+            this.manager.dockTo(id, home.region);
+            return;
+        }
+        this.manager.undock(id);
+        this.manager.setDockMode(id, home.dockMode);
+        if (home.dockMode === DockMode.WorldLocked) {
+            state.handle.group.position.set(...home.position);
+        }
+        // Follow modes ease back to the viewer on their own in update().
+    }
     // --- Windows --------------------------------------------------------------
     /** Spawn a managed window from compiled UIKitML JSON. */
     createWindow(options) {
@@ -212,8 +289,14 @@ export class UixWindowHost {
                 return () => { };
             },
         };
+        const dockMode = options.dockMode ?? DockMode.WorldLocked;
         this.states.set(id, {
             handle,
+            home: {
+                region: options.region,
+                position: options.position ? [...options.position] : [0, 0, 0],
+                dockMode,
+            },
             movable: options.movable ?? true,
             options: {
                 followOffset: options.followOffset ?? DEFAULT_FOLLOW_OFFSET,
@@ -223,12 +306,23 @@ export class UixWindowHost {
             content: undefined,
             pin: undefined,
             minimize: undefined,
+            buttons: { pin: undefined, dock: undefined, minimize: undefined, close: undefined },
+            gateOpen: true,
         });
-        this.manager.open(id, {
+        const record = this.manager.open(id, {
             title: options.title ?? '',
-            dockMode: options.dockMode ?? DockMode.WorldLocked,
+            dockMode,
+            // Chrome buttons are opt-in - see WindowOptionsBase.
+            chrome: {
+                close: options.closable ?? false,
+                minimize: options.minimizable ?? false,
+                pin: options.pinnable ?? false,
+                dock: options.dockable ?? false,
+            },
+            ...(options.handMenu !== undefined ? { handMenu: options.handMenu } : {}),
         });
         this.wireChrome(options, handle);
+        this.applyChrome(record);
         if (options.region !== undefined) {
             this.dock(id, options.region);
         }
@@ -252,14 +346,29 @@ export class UixWindowHost {
     }
     /** Drive per-frame from the engine loop (delta in SECONDS). */
     update(deltaSeconds) {
+        let hands;
         for (const [id, state] of this.states) {
             state.handle.document.update(deltaSeconds);
             const record = this.manager.get(id);
+            if (!record) {
+                continue;
+            }
             const docked = this.regions.regionOf(id) !== undefined;
-            if (record &&
-                record.dockMode === DockMode.BodyFollow &&
-                !record.dragging &&
-                !docked) {
+            if (record.dockMode === DockMode.HandLocked && !record.dragging && !docked) {
+                if (this.handPose && (this.handPose.hasHands?.() ?? true)) {
+                    hands ??= this.readHands();
+                    this.placeOnHand(id, state, hands);
+                }
+                else {
+                    // No hands here (a desktop, or no session yet): the menu follows
+                    // the body instead, and the gate does not apply.
+                    state.gateOpen = true;
+                    this.applyPresentation(id);
+                    this.applyFollow(state.handle.group, state.options, deltaSeconds, true);
+                }
+                continue;
+            }
+            if (record.dockMode === DockMode.BodyFollow && !record.dragging && !docked) {
                 this.applyFollow(state.handle.group, state.options, deltaSeconds, true);
             }
         }
@@ -274,6 +383,30 @@ export class UixWindowHost {
             }
         }
     }
+    /** This frame's tracked hands from the source, absent ones left out. */
+    readHands() {
+        const poses = {};
+        for (const hand of ['left', 'right']) {
+            const pose = this.handPose?.getHandPose(hand);
+            if (pose) {
+                poses[hand] = pose;
+            }
+        }
+        return poses;
+    }
+    placeOnHand(id, state, hands) {
+        const record = this.manager.get(id);
+        if (!record) {
+            return;
+        }
+        const placement = evaluateHandMenu(hands, this.headPose.getHeadPose().position, record.handMenu);
+        state.gateOpen = placement.visible;
+        if (placement.pose) {
+            state.handle.group.position.set(...placement.pose.position);
+            state.handle.group.quaternion.set(...placement.pose.quaternion);
+        }
+        this.applyPresentation(id);
+    }
     applyFollow(group, options, deltaSeconds, faceViewer) {
         const pose = this.headPose.getHeadPose();
         const target = followTarget(pose, options.followOffset);
@@ -339,51 +472,62 @@ export class UixWindowHost {
                 this.manager.focus(id);
             }
         });
-        const close = element(WINDOW_CHROME_IDS.close);
-        if (options.closable === false) {
-            close?.setProperties({ display: 'none' });
-        }
-        else {
-            close?.addEventListener('click', () => {
-                if (this.manager.has(id)) {
-                    this.manager.close(id);
-                }
-            });
-        }
-        const minimize = element(WINDOW_CHROME_IDS.minimize);
-        if (options.minimizable === false) {
-            minimize?.setProperties({ display: 'none' });
-        }
-        else {
-            minimize?.addEventListener('click', () => {
-                if (this.manager.has(id)) {
-                    this.manager.toggleMinimized(id);
-                }
-            });
-            this.syncMinimizeLabel(id);
-        }
-        const pin = element(WINDOW_CHROME_IDS.pin);
         const state = this.states.get(id);
         if (state) {
             state.content = element(WINDOW_CHROME_IDS.content);
-            state.pin = pin;
+            state.pin = element(WINDOW_CHROME_IDS.pin);
             state.minimize = element(WINDOW_CHROME_IDS.minimize);
+            state.buttons = {
+                close: element(WINDOW_CHROME_IDS.close),
+                minimize: element(WINDOW_CHROME_IDS.minimize),
+                pin: element(WINDOW_CHROME_IDS.pin),
+                dock: element(WINDOW_CHROME_IDS.dock),
+            };
         }
-        if (options.pinnable === false) {
-            pin?.setProperties({ display: 'none' });
-        }
-        else {
-            pin?.addEventListener('click', () => {
-                if (!this.manager.has(id)) {
-                    return;
-                }
+        // Every button is wired once and gated on the record at click time, so
+        // enabling a button later (manager.setChrome) needs no rewiring.
+        const enabled = (key) => this.manager.get(id)?.chrome[key] === true;
+        element(WINDOW_CHROME_IDS.close)?.addEventListener('click', () => {
+            if (enabled('close')) {
+                this.manager.close(id);
+            }
+        });
+        element(WINDOW_CHROME_IDS.minimize)?.addEventListener('click', () => {
+            if (enabled('minimize')) {
+                this.manager.toggleMinimized(id);
+            }
+        });
+        element(WINDOW_CHROME_IDS.pin)?.addEventListener('click', () => {
+            if (enabled('pin')) {
                 // Pinning a docked window pops it out of its region first.
-                if (this.regions.regionOf(id) !== undefined) {
-                    this.regions.undock(id);
-                }
+                this.manager.undock(id);
                 this.manager.togglePin(id);
-            });
-            this.syncPinLabel(id);
+            }
+        });
+        element(WINDOW_CHROME_IDS.dock)?.addEventListener('click', () => {
+            if (enabled('dock')) {
+                this.manager.returnHome(id);
+            }
+        });
+        this.syncMinimizeLabel(id);
+        this.syncPinLabel(id);
+    }
+    /** Show exactly the enabled buttons. */
+    applyChrome(record) {
+        const buttons = this.states.get(record.id)?.buttons;
+        if (!buttons) {
+            return;
+        }
+        for (const key of ['close', 'minimize', 'pin', 'dock']) {
+            buttons[key]?.setProperties({ display: record.chrome[key] ? 'flex' : 'none' });
+        }
+    }
+    /** Drawn exactly when not hidden and (for a hand menu) the palm gate is open. */
+    applyPresentation(id) {
+        const state = this.states.get(id);
+        const record = this.manager.get(id);
+        if (state && record) {
+            state.handle.group.visible = !record.hidden && state.gateOpen;
         }
     }
     setContentCollapsed(id, collapsed) {

package/dist/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UixWindowHost - the engine binding for plain three.js / XR Blocks scenes.\n *\n * Owns a core `WindowManager` + `RegionRegistry` and applies their decisions\n * to the scene graph: spawn UIKitML windows and dock regions, wire chrome\n * buttons (focus / PIN / MIN / X), collapse content while minimized, place\n * docked windows into their region's slots, and ease `body-follow` windows\n * (and body-locked regions) toward the viewer each frame.\n *\n * It implements the core's `WindowHost` (so app code can wire behaviour\n * through `onPanelReady` with no engine knowledge) and `SceneTarget` (so a\n * portable `SceneDescriptor` builds the same playground here as on IWSDK).\n */\nimport { Group, type Object3D } from 'three';\nimport { parse, type Kit } from '@pmndrs/uikitml';\n\n/**\n * Default `config` resolver: fetch UIKitML source and parse it.\n *\n * IWSDK 0.5 dropped the build-time compile step and parses `PanelUI.config`\n * as source at runtime, so descriptors carry `.uikitml` paths. This parses the\n * same file for the three.js and XR Blocks hosts, which interpret an AST.\n */\nasync function loadUikitmlSource(path: string): Promise<unknown> {\n  const response = await fetch(path);\n  if (!response.ok) {\n    throw new Error(`UIKitML source ${path} -> HTTP ${response.status}`);\n  }\n  return parse(await response.text());\n}\nimport {\n  DockMode,\n  RegionRegistry,\n  WINDOW_CHROME_IDS,\n  WindowManager,\n  minimizeLabelFor,\n  pinLabelFor,\n  slotOffset,\n  type HeadPoseSource,\n  type PanelHandle,\n  type PanelReadyEvent,\n  type RegionDefinition,\n  type SceneRegion,\n  type SceneTarget,\n  type SceneWindow,\n  type UixElement,\n  type Vec3Tuple,\n  type WindowHandle as CoreWindowHandle,\n  type WindowHost,\n  type WindowOptionsBase,\n} from '@realitycollective/webxr-uiextensions';\nimport {\n  approach,\n  approachAlpha,\n  distanceSquared,\n  followTarget,\n} from './follow-math.js';\nimport { UixPanelDocument } from './panel-document.js';\n\n/**\n * Options for {@link UixWindowHost.createWindow}.\n *\n * Everything but `config` comes from the portable {@link WindowOptionsBase},\n * so an option means the same thing here as on the IWSDK adapter. `id` is\n * optional: leave it out and the host names the window `uix-window-<n>`.\n *\n * One option is accepted but not acted on: `movable`. This host has no\n * title-bar drag of its own yet - dragging comes from the XR Blocks / desktop\n * input layer above it - so the flag is recorded and otherwise ignored.\n */\nexport interface CreateWindowOptions extends WindowOptionsBase {\n  /** Compiled UIKitML JSON (the `{ element, classes }` shape). */\n  config: unknown;\n}\n\nexport interface CreateRegionOptions extends Partial<RegionDefinition> {\n  id: string;\n  position?: Vec3Tuple;\n  /** Body-lock the region so it follows the viewer. */\n  follow?: boolean;\n  followOffset?: Vec3Tuple;\n}\n\n/**\n * A window spawned by {@link UixWindowHost.createWindow}.\n *\n * Satisfies the core {@link CoreWindowHandle} and adds the three.js specifics.\n * `panel` is the document itself, which already implements `PanelHandle`, and\n * is never `undefined` here: uikitml interprets the markup synchronously, so\n * the panel exists the moment `createWindow` returns.\n */\nexport interface XrBlocksWindowHandle extends CoreWindowHandle {\n  readonly id: string;\n  /** The scene-graph node - position/rotate freely. */\n  group: Group;\n  document: UixPanelDocument;\n  /** Same object as {@link document}, under the portable name. */\n  readonly panel: UixPanelDocument;\n  onReady(listener: (panel: PanelHandle) => void): () => void;\n}\n\n/** Back-compatible name for {@link XrBlocksWindowHandle}. */\nexport type WindowHandle = XrBlocksWindowHandle;\n\nexport interface RegionHandle {\n  id: string;\n  group: Group;\n}\n\nexport interface UixWindowHostOptions {\n  /** Parent for spawned windows (the scene, or any group inside it). */\n  scene: Object3D;\n  /** Viewer pose provider - camera on desktop, HMD pose in XR. */\n  headPose: HeadPoseSource;\n  /** Optional UIKitML component kit(s) (e.g. horizon kit). */\n  kit?: Kit;\n  /**\n   * Resolver for a window's `config` when it arrives as a string path (as\n   * portable `SceneDescriptor`s carry it).\n   *\n   * Defaults to fetching the `.uikitml` source and parsing it, which is the\n   * same artefact IWSDK loads - so one markup file serves every adapter and\n   * no build step is required. Override only for an unusual transport; you do\n   * not need to supply this to load a normal panel.\n   */\n  loadConfig?: (path: string) => Promise<unknown>;\n}\n\ninterface FollowOptions {\n  followOffset: Vec3Tuple;\n  followSpeed: number;\n  followTolerance: number;\n}\n\ninterface WindowState {\n  handle: XrBlocksWindowHandle;\n  /**\n   * Recorded from the create options and not acted on - see\n   * {@link CreateWindowOptions}. Kept so a future drag path here, or a caller\n   * inspecting the host, reads the value the scene descriptor asked for.\n   */\n  movable: boolean;\n  options: FollowOptions;\n  content: UixElement | undefined;\n  pin: UixElement | undefined;\n  minimize: UixElement | undefined;\n}\n\ninterface RegionState {\n  handle: RegionHandle;\n  follow: boolean;\n  followOffset: Vec3Tuple;\n}\n\nconst DEFAULT_FOLLOW_OFFSET: Vec3Tuple = [0, -0.15, -1.2];\nconst DEFAULT_REGION_FOLLOW_OFFSET: Vec3Tuple = [0, -0.2, -1.4];\n\nexport class UixWindowHost implements WindowHost, SceneTarget {\n  /** Bare panels work here - the host does not own a panel lifecycle. */\n  readonly supportsStandalonePanels: boolean = true;\n  readonly manager = new WindowManager();\n  readonly regions = new RegionRegistry();\n  private readonly scene: Object3D;\n  private readonly headPose: HeadPoseSource;\n  private readonly kit: Kit | undefined;\n  private readonly loadConfig: (path: string) => Promise<unknown>;\n  private readonly states = new Map<string, WindowState>();\n  private readonly regionStates = new Map<string, RegionState>();\n  private readonly readyListeners = new Set<(event: PanelReadyEvent) => void>();\n  /** Panels already live - replayed to late `onPanelReady` subscribers. */\n  private readonly ready = new Map<string, PanelReadyEvent>();\n  /** Feeds `uix-window-<n>` ids to windows created without one. */\n  private windowSequence = 0;\n\n  constructor(options: UixWindowHostOptions) {\n    this.scene = options.scene;\n    this.headPose = options.headPose;\n    this.kit = options.kit;\n    this.loadConfig = options.loadConfig ?? loadUikitmlSource;\n\n    this.manager.events.on('closed', (record) => {\n      const state = this.states.get(record.id);\n      if (state) {\n        this.states.delete(record.id);\n        this.ready.delete(record.id);\n        this.regions.undock(record.id);\n        state.handle.document.dispose();\n        state.handle.group.removeFromParent();\n        this.layoutRegions();\n      }\n    });\n    this.manager.events.on('minimized', (record) => {\n      this.setContentCollapsed(record.id, true);\n      this.syncMinimizeLabel(record.id);\n    });\n    this.manager.events.on('restored', (record) => {\n      this.setContentCollapsed(record.id, false);\n      this.syncMinimizeLabel(record.id);\n    });\n    this.manager.events.on('dockChanged', ({ window }) => {\n      this.syncPinLabel(window.id);\n    });\n  }\n\n  // --- WindowHost -----------------------------------------------------------\n\n  /**\n   * PanelHost - bare panel, unmanaged (used by devtools and tests). Always\n   * available here, which is what `supportsStandalonePanels` reports.\n   */\n  createPanel(configJson: unknown): UixPanelDocument {\n    return new UixPanelDocument(configJson, this.kit);\n  }\n\n  /**\n   * Observe panel readiness. Windows already live are replayed immediately,\n   * so wiring code never races window creation.\n   */\n  onPanelReady(listener: (event: PanelReadyEvent) => void): () => void {\n    this.readyListeners.add(listener);\n    for (const event of this.ready.values()) {\n      listener(event);\n    }\n    return () => void this.readyListeners.delete(listener);\n  }\n\n  // --- SceneTarget (portable scene descriptors) -----------------------------\n\n  spawnRegion(region: SceneRegion): void {\n    this.createRegion({\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 ? { snapRadius: region.snapRadius } : {}),\n      ...(region.position !== undefined\n        ? { position: [...region.position] as Vec3Tuple }\n        : {}),\n      ...(region.follow !== undefined ? { follow: region.follow } : {}),\n      ...(region.followOffset !== undefined\n        ? { followOffset: [...region.followOffset] as Vec3Tuple }\n        : {}),\n    });\n  }\n\n  /**\n   * Scene descriptors carry config PATHS; this resolves the path and spawns\n   * the window when it arrives. Fire-and-forget by design - subscribe with\n   * {@link onPanelReady} to wire behaviour once the panel exists.\n   */\n  spawnWindow(window: SceneWindow): void {\n    void this.loadConfig(window.config)\n      .then((config) => {\n        this.createWindow({\n          id: window.id,\n          config,\n          title: window.title,\n          ...(window.position !== undefined\n            ? { position: [...window.position] as Vec3Tuple }\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 Vec3Tuple }\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      .catch((error) => {\n        console.error(`[uix] failed to load panel \"${window.id}\":`, error);\n      });\n  }\n\n  // --- Regions --------------------------------------------------------------\n\n  /** Create a dock region anchored in the scene. */\n  createRegion(options: CreateRegionOptions): RegionHandle {\n    const { id, position, follow, followOffset, ...definition } = options;\n    this.regions.register(id, definition);\n\n    const group = new Group();\n    group.name = `uix-region:${id}`;\n    if (position) {\n      group.position.set(...position);\n    }\n    this.scene.add(group);\n\n    const handle: RegionHandle = { id, group };\n    this.regionStates.set(id, {\n      handle,\n      follow: follow ?? false,\n      followOffset: followOffset ?? DEFAULT_REGION_FOLLOW_OFFSET,\n    });\n    return handle;\n  }\n\n  region(id: string): RegionHandle | undefined {\n    return this.regionStates.get(id)?.handle;\n  }\n\n  /** Dock a window into a region (or undock it with `undefined`). */\n  dock(windowId: string, regionId: string | undefined): void {\n    if (regionId === undefined) {\n      this.regions.undock(windowId);\n    } else {\n      this.regions.dock(windowId, regionId);\n      this.manager.setDockMode(windowId, DockMode.WorldLocked);\n    }\n    this.layoutRegions();\n  }\n\n  // --- Windows --------------------------------------------------------------\n\n  /** Spawn a managed window from compiled UIKitML JSON. */\n  createWindow(options: CreateWindowOptions): XrBlocksWindowHandle {\n    const id = options.id ?? `uix-window-${(this.windowSequence += 1)}`;\n    const document = new UixPanelDocument(options.config, this.kit);\n    document.setTargetDimensions(options.maxWidth ?? 1, options.maxHeight ?? 1);\n\n    const group = new Group();\n    group.name = `uix-window:${id}`;\n    group.add(document);\n    if (options.position) {\n      group.position.set(...options.position);\n    }\n    this.scene.add(group);\n\n    const handle: XrBlocksWindowHandle = {\n      id,\n      group,\n      document,\n      panel: document,\n      // The panel exists already, so readiness is immediate. The unsubscribe\n      // is returned anyway, so callers can write one shape of code for both\n      // adapters.\n      onReady(listener: (panel: PanelHandle) => void): () => void {\n        listener(document);\n        return () => {};\n      },\n    };\n    this.states.set(id, {\n      handle,\n      movable: options.movable ?? true,\n      options: {\n        followOffset: options.followOffset ?? DEFAULT_FOLLOW_OFFSET,\n        followSpeed: options.followSpeed ?? 3,\n        followTolerance: options.followTolerance ?? 0.35,\n      },\n      content: undefined,\n      pin: undefined,\n      minimize: undefined,\n    });\n\n    this.manager.open(id, {\n      title: options.title ?? '',\n      dockMode: options.dockMode ?? DockMode.WorldLocked,\n    });\n    this.wireChrome(options, handle);\n\n    if (options.region !== undefined) {\n      this.dock(id, options.region);\n    }\n\n    // The panel's element tree exists synchronously (uikitml interprets on\n    // construction); only its LAYOUT is async. Announce readiness now so\n    // wiring can attach handlers immediately.\n    const event: PanelReadyEvent = { id, panel: document, kind: 'window' };\n    this.ready.set(id, event);\n    for (const listener of this.readyListeners) {\n      try {\n        listener(event);\n      } catch (error) {\n        console.error(`[uix] panel-ready listener failed for \"${id}\":`, error);\n      }\n    }\n\n    return handle;\n  }\n\n  window(id: string): XrBlocksWindowHandle | undefined {\n    return this.states.get(id)?.handle;\n  }\n\n  /** Drive per-frame from the engine loop (delta in SECONDS). */\n  update(deltaSeconds: number): void {\n    for (const [id, state] of this.states) {\n      state.handle.document.update(deltaSeconds);\n      const record = this.manager.get(id);\n      const docked = this.regions.regionOf(id) !== undefined;\n      if (\n        record &&\n        record.dockMode === DockMode.BodyFollow &&\n        !record.dragging &&\n        !docked\n      ) {\n        this.applyFollow(state.handle.group, state.options, deltaSeconds, true);\n      }\n    }\n    for (const state of this.regionStates.values()) {\n      if (state.follow) {\n        this.applyFollow(\n          state.handle.group,\n          {\n            followOffset: state.followOffset,\n            followSpeed: 3,\n            followTolerance: 0.2,\n          },\n          deltaSeconds,\n          false,\n        );\n        this.layoutRegion(state.handle.id);\n      }\n    }\n  }\n\n  private applyFollow(\n    group: Group,\n    options: FollowOptions,\n    deltaSeconds: number,\n    faceViewer: boolean,\n  ): void {\n    const pose = this.headPose.getHeadPose();\n    const target = followTarget(pose, options.followOffset);\n    const position = group.position;\n    const current: Vec3Tuple = [position.x, position.y, position.z];\n    const tolerance = options.followTolerance;\n    if (distanceSquared(current, target) <= tolerance * tolerance) {\n      return;\n    }\n    const next = approach(\n      current,\n      target,\n      approachAlpha(options.followSpeed, deltaSeconds),\n    );\n    position.set(...next);\n    if (faceViewer) {\n      group.lookAt(pose.position[0], position.y, pose.position[2]);\n    }\n  }\n\n  /** Re-place every docked window into its region's slot. */\n  private layoutRegions(): void {\n    for (const id of this.regionStates.keys()) {\n      this.layoutRegion(id);\n    }\n  }\n\n  private layoutRegion(regionId: string): void {\n    const regionState = this.regionStates.get(regionId);\n    const registered = this.regions.get(regionId);\n    if (!regionState || !registered) {\n      return;\n    }\n    const origin = regionState.handle.group.position;\n    registered.members.forEach((windowId, index) => {\n      const windowState = this.states.get(windowId);\n      if (!windowState) {\n        return;\n      }\n      const [dx, dy, dz] = slotOffset(registered.definition, index);\n      windowState.handle.group.position.set(\n        origin.x + dx,\n        origin.y + dy,\n        origin.z + dz,\n      );\n      windowState.handle.group.quaternion.copy(regionState.handle.group.quaternion);\n    });\n  }\n\n  private wireChrome(\n    options: CreateWindowOptions,\n    handle: XrBlocksWindowHandle,\n  ): void {\n    const element = (id: string) => handle.document.getElementById(id);\n    const id = handle.id;\n\n    const title = element(WINDOW_CHROME_IDS.title);\n    if (title && options.title) {\n      title.setProperties({ text: options.title });\n    }\n\n    // Chrome presses must not bubble to the window root's focus handler:\n    // a press on CLOSE would otherwise focus a window that is about to be\n    // destroyed, and `focus()` on a removed window throws. (Same guard the\n    // IWSDK adapter applies.)\n    const swallowPress = (button: UixElement | undefined): void => {\n      button?.addEventListener('pointerdown', (event) => {\n        (event as { stopPropagation?: () => void } | undefined)?.stopPropagation?.();\n      });\n    };\n    swallowPress(element(WINDOW_CHROME_IDS.pin));\n    swallowPress(element(WINDOW_CHROME_IDS.dock));\n    swallowPress(element(WINDOW_CHROME_IDS.minimize));\n    swallowPress(element(WINDOW_CHROME_IDS.close));\n\n    // Any press anywhere on the window brings it to the front. Guarded:\n    // events can still arrive for a window that was just closed.\n    element(WINDOW_CHROME_IDS.window)?.addEventListener('pointerdown', () => {\n      if (this.manager.has(id)) {\n        this.manager.focus(id);\n      }\n    });\n\n    const close = element(WINDOW_CHROME_IDS.close);\n    if (options.closable === false) {\n      close?.setProperties({ display: 'none' });\n    } else {\n      close?.addEventListener('click', () => {\n        if (this.manager.has(id)) {\n          this.manager.close(id);\n        }\n      });\n    }\n\n    const minimize = element(WINDOW_CHROME_IDS.minimize);\n    if (options.minimizable === false) {\n      minimize?.setProperties({ display: 'none' });\n    } else {\n      minimize?.addEventListener('click', () => {\n        if (this.manager.has(id)) {\n          this.manager.toggleMinimized(id);\n        }\n      });\n      this.syncMinimizeLabel(id);\n    }\n\n    const pin = element(WINDOW_CHROME_IDS.pin);\n    const state = this.states.get(id);\n    if (state) {\n      state.content = element(WINDOW_CHROME_IDS.content);\n      state.pin = pin;\n      state.minimize = element(WINDOW_CHROME_IDS.minimize);\n    }\n    if (options.pinnable === false) {\n      pin?.setProperties({ display: 'none' });\n    } else {\n      pin?.addEventListener('click', () => {\n        if (!this.manager.has(id)) {\n          return;\n        }\n        // Pinning a docked window pops it out of its region first.\n        if (this.regions.regionOf(id) !== undefined) {\n          this.regions.undock(id);\n        }\n        this.manager.togglePin(id);\n      });\n      this.syncPinLabel(id);\n    }\n  }\n\n  private setContentCollapsed(id: string, collapsed: boolean): void {\n    this.states\n      .get(id)\n      ?.content?.setProperties({ display: collapsed ? 'none' : 'flex' });\n  }\n\n  /** MIN when open, MAX when minimized - the label names the next action. */\n  private syncMinimizeLabel(id: string): void {\n    const record = this.manager.get(id);\n    const minimize = this.states.get(id)?.minimize;\n    if (record && minimize) {\n      minimize.setProperties({ text: minimizeLabelFor(record) });\n    }\n  }\n\n  private syncPinLabel(id: string): void {\n    const record = this.manager.get(id);\n    const pin = this.states.get(id)?.pin;\n    if (record && pin) {\n      pin.setProperties({ text: pinLabelFor(record) });\n    }\n  }\n}\n"]}
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,KAAK,EAAiB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAY,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AACD,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,UAAU,GAiBX,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,QAAQ,EACR,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8GvD,MAAM,qBAAqB,GAAc,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;AAC1D,MAAM,4BAA4B,GAAc,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;AAEhE,MAAM,OAAO,aAAa;IACxB,uEAAuE;IAC9D,wBAAwB,GAAY,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IAC9B,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACvB,KAAK,CAAW;IAChB,QAAQ,CAAiB;IACzB,QAAQ,CAA6B;IACrC,GAAG,CAAkB;IACrB,UAAU,CAAqC;IAC/C,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxC,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,cAAc,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC9E,yEAAyE;IACxD,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC5D,iEAAiE;IACzD,cAAc,GAAG,CAAC,CAAC;IAE3B,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;QAE1D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC/B,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAChC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBACtC,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC7D,IAAI,QAAQ,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACrC,4CAA4C;gBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACtB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YACrD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YACrD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YACnD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAE7E;;;OAGG;IACH,WAAW,CAAC,UAAmB;QAC7B,OAAO,IAAI,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAA0C;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,6EAA6E;IAE7E,WAAW,CAAC,MAAmB;QAC7B,IAAI,CAAC,YAAY,CAAC;YAChB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAc,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS;gBACnC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,CAAc,EAAE;gBACzD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,MAAmB;QAC7B,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;aAChC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,YAAY,CAAC;gBAChB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM;gBACN,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;oBAC/B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAc,EAAE;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS;oBACnC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,CAAc,EAAE;oBACzD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;oBAClC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS;oBACtC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE;oBAC7C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;oBAClC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxE,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,6EAA6E;IAE7E,kDAAkD;IAClD,YAAY,CAAC,OAA4B;QACvC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAEtC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,GAAG,cAAc,EAAE,EAAE,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAiB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE;YACxB,MAAM;YACN,MAAM,EAAE,MAAM,IAAI,KAAK;YACvB,YAAY,EAAE,YAAY,IAAI,4BAA4B;SAC3D,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,QAAgB,EAAE,QAA4B;QACjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,yEAAyE;IACjE,WAAW,CAAC,MAA2C;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wDAAwD;gBACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,iFAAiF;IACzE,UAAU,CAAC,EAAU;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC3C,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;QACD,iEAAiE;IACnE,CAAC;IAED,6EAA6E;IAE7E,yDAAyD;IACzD,YAAY,CAAC,OAA4B;QACvC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;QAE5E,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,GAAG,cAAc,EAAE,EAAE,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAyB;YACnC,EAAE;YACF,KAAK;YACL,QAAQ;YACR,KAAK,EAAE,QAAQ;YACf,uEAAuE;YACvE,sEAAsE;YACtE,YAAY;YACZ,OAAO,CAAC,QAAsC;gBAC5C,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;YAClB,CAAC;SACF,CAAC;QACF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE;YAClB,MAAM;YACN,IAAI,EAAE;gBACJ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9D,QAAQ;aACT;YACD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;YAChC,OAAO,EAAE;gBACP,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,qBAAqB;gBAC3D,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;gBACrC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;aACjD;YACD,OAAO,EAAE,SAAS;YAClB,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACnF,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,QAAQ;YACR,qDAAqD;YACrD,MAAM,EAAE;gBACN,KAAK,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBAChC,QAAQ,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;gBACtC,GAAG,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBAC9B,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;aAChC;YACD,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,uEAAuE;QACvE,qEAAqE;QACrE,0CAA0C;QAC1C,MAAM,KAAK,GAAoB,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrC,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,YAAoB;QACzB,IAAI,KAA4B,CAAC;QACjC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;YACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3E,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;oBAC1D,KAAK,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC3B,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACN,iEAAiE;oBACjE,iDAAiD;oBACjD,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACtB,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;oBAC3B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;gBAC1E,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3E,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,CACd,KAAK,CAAC,MAAM,CAAC,KAAK,EAClB;oBACE,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,WAAW,EAAE,CAAC;oBACd,eAAe,EAAE,GAAG;iBACrB,EACD,YAAY,EACZ,KAAK,CACN,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,wEAAwE;IAChE,SAAS;QACf,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,WAAW,CAAC,EAAU,EAAE,KAAkB,EAAE,KAAgB;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjG,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;QACnC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5D,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEO,WAAW,CACjB,KAAY,EACZ,OAAsB,EACtB,YAAoB,EACpB,UAAmB;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,OAAO,GAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;QAC1C,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CACnB,OAAO,EACP,MAAM,EACN,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CACjD,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,2DAA2D;IACnD,aAAa;QACnB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9D,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CACnC,MAAM,CAAC,CAAC,GAAG,EAAE,EACb,MAAM,CAAC,CAAC,GAAG,EAAE,EACb,MAAM,CAAC,CAAC,GAAG,EAAE,CACd,CAAC;YACF,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAChB,OAA4B,EAC5B,MAA4B;QAE5B,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QAErB,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,qEAAqE;QACrE,sEAAsE;QACtE,uEAAuE;QACvE,0BAA0B;QAC1B,MAAM,YAAY,GAAG,CAAC,MAA8B,EAAQ,EAAE;YAC5D,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC/C,KAAsD,EAAE,eAAe,EAAE,EAAE,CAAC;YAC/E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClD,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/C,oEAAoE;QACpE,6DAA6D;QAC7D,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE;YACtE,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACnD,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC3C,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACrD,KAAK,CAAC,OAAO,GAAG;gBACd,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBACvC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC;gBAC7C,GAAG,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC;gBACnC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC;aACtC,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,iEAAiE;QACjE,MAAM,OAAO,GAAG,CAAC,GAAuB,EAAW,EAAE,CACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;QAE7C,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC/D,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAClE,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC7D,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,2DAA2D;gBAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC9D,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,wCAAwC;IAChC,WAAW,CAAC,MAA2C;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAU,EAAE,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,iFAAiF;IACzE,iBAAiB,CAAC,EAAU;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,EAAU,EAAE,SAAkB;QACxD,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,EAAE,CAAC;YACR,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,2EAA2E;IACnE,iBAAiB,CAAC,EAAU;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;QAC/C,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;YACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,EAAU;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;QACrC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClB,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * UixWindowHost - the engine binding for plain three.js / XR Blocks scenes.\n *\n * Owns a core `WindowManager` + `RegionRegistry` and applies their decisions\n * to the scene graph: spawn UIKitML windows and dock regions, wire chrome\n * buttons (focus / PIN / DOCK / MIN / X), collapse content while minimized,\n * hide and show, place docked windows into their region's slots, return a\n * window to where it spawned, ease `body-follow` windows (and body-locked\n * regions) toward the viewer each frame, and ride `hand-locked` windows\n * (hand menus) on a tracked hand behind the palm gate.\n *\n * The manager is the API app code drives; every manager event is applied\n * here, so `host.manager.hide(id)` or `.dockTo(id, region)` from a hand menu\n * is all a caller needs.\n *\n * It implements the core's `WindowHost` (so app code can wire behaviour\n * through `onPanelReady` with no engine knowledge) and `SceneTarget` (so a\n * portable `SceneDescriptor` builds the same playground here as on IWSDK).\n */\nimport { Group, type Object3D } from 'three';\nimport { parse, type Kit } from '@pmndrs/uikitml';\n\n/**\n * Default `config` resolver: fetch UIKitML source and parse it.\n *\n * IWSDK 0.5 dropped the build-time compile step and parses `PanelUI.config`\n * as source at runtime, so descriptors carry `.uikitml` paths. This parses the\n * same file for the three.js and XR Blocks hosts, which interpret an AST.\n */\nasync function loadUikitmlSource(path: string): Promise<unknown> {\n  const response = await fetch(path);\n  if (!response.ok) {\n    throw new Error(`UIKitML source ${path} -> HTTP ${response.status}`);\n  }\n  return parse(await response.text());\n}\nimport {\n  DockMode,\n  RegionRegistry,\n  WINDOW_CHROME_IDS,\n  WindowManager,\n  evaluateHandMenu,\n  minimizeLabelFor,\n  pinLabelFor,\n  slotOffset,\n  type HandPoseSource,\n  type HandPoses,\n  type HeadPoseSource,\n  type PanelHandle,\n  type PanelReadyEvent,\n  type RegionDefinition,\n  type WindowChrome,\n  type WindowRecord,\n  type SceneRegion,\n  type SceneTarget,\n  type SceneWindow,\n  type UixElement,\n  type Vec3Tuple,\n  type WindowHandle as CoreWindowHandle,\n  type WindowHost,\n  type WindowOptionsBase,\n} from '@realitycollective/webxr-uiextensions';\nimport {\n  approach,\n  approachAlpha,\n  distanceSquared,\n  followTarget,\n} from './follow-math.js';\nimport { UixPanelDocument } from './panel-document.js';\n\n/**\n * Options for {@link UixWindowHost.createWindow}.\n *\n * Everything but `config` comes from the portable {@link WindowOptionsBase},\n * so an option means the same thing here as on the IWSDK adapter. `id` is\n * optional: leave it out and the host names the window `uix-window-<n>`.\n *\n * One option is accepted but not acted on: `movable`. This host has no\n * title-bar drag of its own yet - dragging comes from the XR Blocks / desktop\n * input layer above it - so the flag is recorded and otherwise ignored.\n */\nexport interface CreateWindowOptions extends WindowOptionsBase {\n  /** Compiled UIKitML JSON (the `{ element, classes }` shape). */\n  config: unknown;\n}\n\nexport interface CreateRegionOptions extends Partial<RegionDefinition> {\n  id: string;\n  position?: Vec3Tuple;\n  /** Body-lock the region so it follows the viewer. */\n  follow?: boolean;\n  followOffset?: Vec3Tuple;\n}\n\n/**\n * A window spawned by {@link UixWindowHost.createWindow}.\n *\n * Satisfies the core {@link CoreWindowHandle} and adds the three.js specifics.\n * `panel` is the document itself, which already implements `PanelHandle`, and\n * is never `undefined` here: uikitml interprets the markup synchronously, so\n * the panel exists the moment `createWindow` returns.\n */\nexport interface XrBlocksWindowHandle extends CoreWindowHandle {\n  readonly id: string;\n  /** The scene-graph node - position/rotate freely. */\n  group: Group;\n  document: UixPanelDocument;\n  /** Same object as {@link document}, under the portable name. */\n  readonly panel: UixPanelDocument;\n  onReady(listener: (panel: PanelHandle) => void): () => void;\n}\n\n/** Back-compatible name for {@link XrBlocksWindowHandle}. */\nexport type WindowHandle = XrBlocksWindowHandle;\n\nexport interface RegionHandle {\n  id: string;\n  group: Group;\n}\n\nexport interface UixWindowHostOptions {\n  /** Parent for spawned windows (the scene, or any group inside it). */\n  scene: Object3D;\n  /** Viewer pose provider - camera on desktop, HMD pose in XR. */\n  headPose: HeadPoseSource;\n  /**\n   * Tracked-hand pose provider, for `hand-locked` windows (hand menus). See\n   * `webxrHandPoseSource` for one backed by a WebXR session. Leave it out\n   * where there are no hands (a desktop) and hand-locked windows fall back\n   * to body-follow placement, so the same scene still shows its menus.\n   */\n  handPose?: HandPoseSource;\n  /** Optional UIKitML component kit(s) (e.g. horizon kit). */\n  kit?: Kit;\n  /**\n   * Resolver for a window's `config` when it arrives as a string path (as\n   * portable `SceneDescriptor`s carry it).\n   *\n   * Defaults to fetching the `.uikitml` source and parsing it, which is the\n   * same artefact IWSDK loads - so one markup file serves every adapter and\n   * no build step is required. Override only for an unusual transport; you do\n   * not need to supply this to load a normal panel.\n   */\n  loadConfig?: (path: string) => Promise<unknown>;\n}\n\ninterface FollowOptions {\n  followOffset: Vec3Tuple;\n  followSpeed: number;\n  followTolerance: number;\n}\n\ninterface WindowState {\n  handle: XrBlocksWindowHandle;\n  /** Where the window spawned, for `returnHome`. */\n  home: { region: string | undefined; position: Vec3Tuple; dockMode: WindowRecord['dockMode'] };\n  /**\n   * Recorded from the create options and not acted on - see\n   * {@link CreateWindowOptions}. Kept so a future drag path here, or a caller\n   * inspecting the host, reads the value the scene descriptor asked for.\n   */\n  movable: boolean;\n  options: FollowOptions;\n  content: UixElement | undefined;\n  pin: UixElement | undefined;\n  minimize: UixElement | undefined;\n  /** Every chrome button by its role, for `chromeChanged`. */\n  buttons: Record<keyof WindowChrome, UixElement | undefined>;\n  /** Hand-menu palm gate this frame; always open in the other dock modes. */\n  gateOpen: boolean;\n}\n\ninterface RegionState {\n  handle: RegionHandle;\n  follow: boolean;\n  followOffset: Vec3Tuple;\n}\n\nconst DEFAULT_FOLLOW_OFFSET: Vec3Tuple = [0, -0.15, -1.2];\nconst DEFAULT_REGION_FOLLOW_OFFSET: Vec3Tuple = [0, -0.2, -1.4];\n\nexport class UixWindowHost implements WindowHost, SceneTarget {\n  /** Bare panels work here - the host does not own a panel lifecycle. */\n  readonly supportsStandalonePanels: boolean = true;\n  readonly manager = new WindowManager();\n  readonly regions = new RegionRegistry();\n  private readonly scene: Object3D;\n  private readonly headPose: HeadPoseSource;\n  private readonly handPose: HandPoseSource | undefined;\n  private readonly kit: Kit | undefined;\n  private readonly loadConfig: (path: string) => Promise<unknown>;\n  private readonly states = new Map<string, WindowState>();\n  private readonly regionStates = new Map<string, RegionState>();\n  private readonly readyListeners = new Set<(event: PanelReadyEvent) => void>();\n  /** Panels already live - replayed to late `onPanelReady` subscribers. */\n  private readonly ready = new Map<string, PanelReadyEvent>();\n  /** Feeds `uix-window-<n>` ids to windows created without one. */\n  private windowSequence = 0;\n\n  constructor(options: UixWindowHostOptions) {\n    this.scene = options.scene;\n    this.headPose = options.headPose;\n    this.handPose = options.handPose;\n    this.kit = options.kit;\n    this.loadConfig = options.loadConfig ?? loadUikitmlSource;\n\n    this.manager.events.on('closed', (record) => {\n      const state = this.states.get(record.id);\n      if (state) {\n        this.states.delete(record.id);\n        this.ready.delete(record.id);\n        this.regions.undock(record.id);\n        state.handle.document.dispose();\n        state.handle.group.removeFromParent();\n        this.layoutRegions();\n      }\n    });\n    this.manager.events.on('hidden', (record) => {\n      this.applyPresentation(record.id);\n    });\n    this.manager.events.on('shown', (record) => {\n      this.applyPresentation(record.id);\n    });\n    this.manager.events.on('dockChanged', ({ window, previous }) => {\n      if (previous === DockMode.HandLocked) {\n        // Off the hand: the gate no longer applies.\n        const state = this.states.get(window.id);\n        if (state) {\n          state.gateOpen = true;\n          this.applyPresentation(window.id);\n        }\n      }\n    });\n    this.manager.events.on('regionChanged', ({ window }) => {\n      this.applyRegion(window);\n    });\n    this.manager.events.on('returnHome', (record) => {\n      this.returnHome(record.id);\n    });\n    this.manager.events.on('chromeChanged', ({ window }) => {\n      this.applyChrome(window);\n    });\n    this.manager.events.on('minimized', (record) => {\n      this.setContentCollapsed(record.id, true);\n      this.syncMinimizeLabel(record.id);\n    });\n    this.manager.events.on('restored', (record) => {\n      this.setContentCollapsed(record.id, false);\n      this.syncMinimizeLabel(record.id);\n    });\n    this.manager.events.on('dockChanged', ({ window }) => {\n      this.syncPinLabel(window.id);\n    });\n  }\n\n  // --- WindowHost -----------------------------------------------------------\n\n  /**\n   * PanelHost - bare panel, unmanaged (used by devtools and tests). Always\n   * available here, which is what `supportsStandalonePanels` reports.\n   */\n  createPanel(configJson: unknown): UixPanelDocument {\n    return new UixPanelDocument(configJson, this.kit);\n  }\n\n  /**\n   * Observe panel readiness. Windows already live are replayed immediately,\n   * so wiring code never races window creation.\n   */\n  onPanelReady(listener: (event: PanelReadyEvent) => void): () => void {\n    this.readyListeners.add(listener);\n    for (const event of this.ready.values()) {\n      listener(event);\n    }\n    return () => void this.readyListeners.delete(listener);\n  }\n\n  // --- SceneTarget (portable scene descriptors) -----------------------------\n\n  spawnRegion(region: SceneRegion): void {\n    this.createRegion({\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 ? { snapRadius: region.snapRadius } : {}),\n      ...(region.position !== undefined\n        ? { position: [...region.position] as Vec3Tuple }\n        : {}),\n      ...(region.follow !== undefined ? { follow: region.follow } : {}),\n      ...(region.followOffset !== undefined\n        ? { followOffset: [...region.followOffset] as Vec3Tuple }\n        : {}),\n    });\n  }\n\n  /**\n   * Scene descriptors carry config PATHS; this resolves the path and spawns\n   * the window when it arrives. Fire-and-forget by design - subscribe with\n   * {@link onPanelReady} to wire behaviour once the panel exists.\n   */\n  spawnWindow(window: SceneWindow): void {\n    void this.loadConfig(window.config)\n      .then((config) => {\n        this.createWindow({\n          id: window.id,\n          config,\n          title: window.title,\n          ...(window.position !== undefined\n            ? { position: [...window.position] as Vec3Tuple }\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 Vec3Tuple }\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          ...(window.dockable !== undefined ? { dockable: window.dockable } : {}),\n          ...(window.handMenu !== undefined ? { handMenu: window.handMenu } : {}),\n        });\n      })\n      .catch((error) => {\n        console.error(`[uix] failed to load panel \"${window.id}\":`, error);\n      });\n  }\n\n  // --- Regions --------------------------------------------------------------\n\n  /** Create a dock region anchored in the scene. */\n  createRegion(options: CreateRegionOptions): RegionHandle {\n    const { id, position, follow, followOffset, ...definition } = options;\n    this.regions.register(id, definition);\n\n    const group = new Group();\n    group.name = `uix-region:${id}`;\n    if (position) {\n      group.position.set(...position);\n    }\n    this.scene.add(group);\n\n    const handle: RegionHandle = { id, group };\n    this.regionStates.set(id, {\n      handle,\n      follow: follow ?? false,\n      followOffset: followOffset ?? DEFAULT_REGION_FOLLOW_OFFSET,\n    });\n    return handle;\n  }\n\n  region(id: string): RegionHandle | undefined {\n    return this.regionStates.get(id)?.handle;\n  }\n\n  /**\n   * Dock a window into a region (or undock it with `undefined`). A thin\n   * forwarder to the manager, kept so existing callers read the same;\n   * `manager.dockTo` / `manager.undock` are the portable calls.\n   */\n  dock(windowId: string, regionId: string | undefined): void {\n    if (regionId === undefined) {\n      this.manager.undock(windowId);\n    } else {\n      this.manager.dockTo(windowId, regionId);\n    }\n  }\n\n  /** Make the registry (and the layout) agree with the record's region. */\n  private applyRegion(record: Pick<WindowRecord, 'id' | 'region'>): void {\n    const current = this.regions.regionOf(record.id);\n    if (current === record.region) {\n      return;\n    }\n    if (current !== undefined) {\n      this.regions.undock(record.id);\n    }\n    if (record.region !== undefined) {\n      try {\n        this.regions.dock(record.id, record.region);\n      } catch (error) {\n        // Unknown or full region: the record must not claim it.\n        this.manager.undock(record.id);\n        throw error;\n      }\n      this.manager.setDockMode(record.id, DockMode.WorldLocked);\n    }\n    this.layoutRegions();\n  }\n\n  /** Put a window back where it spawned: its region, or its placement and mode. */\n  private returnHome(id: string): void {\n    const state = this.states.get(id);\n    if (!state) {\n      return;\n    }\n    const { home } = state;\n    if (home.region !== undefined) {\n      this.manager.dockTo(id, home.region);\n      return;\n    }\n    this.manager.undock(id);\n    this.manager.setDockMode(id, home.dockMode);\n    if (home.dockMode === DockMode.WorldLocked) {\n      state.handle.group.position.set(...home.position);\n    }\n    // Follow modes ease back to the viewer on their own in update().\n  }\n\n  // --- Windows --------------------------------------------------------------\n\n  /** Spawn a managed window from compiled UIKitML JSON. */\n  createWindow(options: CreateWindowOptions): XrBlocksWindowHandle {\n    const id = options.id ?? `uix-window-${(this.windowSequence += 1)}`;\n    const document = new UixPanelDocument(options.config, this.kit);\n    document.setTargetDimensions(options.maxWidth ?? 1, options.maxHeight ?? 1);\n\n    const group = new Group();\n    group.name = `uix-window:${id}`;\n    group.add(document);\n    if (options.position) {\n      group.position.set(...options.position);\n    }\n    this.scene.add(group);\n\n    const handle: XrBlocksWindowHandle = {\n      id,\n      group,\n      document,\n      panel: document,\n      // The panel exists already, so readiness is immediate. The unsubscribe\n      // is returned anyway, so callers can write one shape of code for both\n      // adapters.\n      onReady(listener: (panel: PanelHandle) => void): () => void {\n        listener(document);\n        return () => {};\n      },\n    };\n    const dockMode = options.dockMode ?? DockMode.WorldLocked;\n    this.states.set(id, {\n      handle,\n      home: {\n        region: options.region,\n        position: options.position ? [...options.position] : [0, 0, 0],\n        dockMode,\n      },\n      movable: options.movable ?? true,\n      options: {\n        followOffset: options.followOffset ?? DEFAULT_FOLLOW_OFFSET,\n        followSpeed: options.followSpeed ?? 3,\n        followTolerance: options.followTolerance ?? 0.35,\n      },\n      content: undefined,\n      pin: undefined,\n      minimize: undefined,\n      buttons: { pin: undefined, dock: undefined, minimize: undefined, close: undefined },\n      gateOpen: true,\n    });\n\n    const record = this.manager.open(id, {\n      title: options.title ?? '',\n      dockMode,\n      // Chrome buttons are opt-in - see WindowOptionsBase.\n      chrome: {\n        close: options.closable ?? false,\n        minimize: options.minimizable ?? false,\n        pin: options.pinnable ?? false,\n        dock: options.dockable ?? false,\n      },\n      ...(options.handMenu !== undefined ? { handMenu: options.handMenu } : {}),\n    });\n    this.wireChrome(options, handle);\n    this.applyChrome(record);\n\n    if (options.region !== undefined) {\n      this.dock(id, options.region);\n    }\n\n    // The panel's element tree exists synchronously (uikitml interprets on\n    // construction); only its LAYOUT is async. Announce readiness now so\n    // wiring can attach handlers immediately.\n    const event: PanelReadyEvent = { id, panel: document, kind: 'window' };\n    this.ready.set(id, event);\n    for (const listener of this.readyListeners) {\n      try {\n        listener(event);\n      } catch (error) {\n        console.error(`[uix] panel-ready listener failed for \"${id}\":`, error);\n      }\n    }\n\n    return handle;\n  }\n\n  window(id: string): XrBlocksWindowHandle | undefined {\n    return this.states.get(id)?.handle;\n  }\n\n  /** Drive per-frame from the engine loop (delta in SECONDS). */\n  update(deltaSeconds: number): void {\n    let hands: HandPoses | undefined;\n    for (const [id, state] of this.states) {\n      state.handle.document.update(deltaSeconds);\n      const record = this.manager.get(id);\n      if (!record) {\n        continue;\n      }\n      const docked = this.regions.regionOf(id) !== undefined;\n      if (record.dockMode === DockMode.HandLocked && !record.dragging && !docked) {\n        if (this.handPose && (this.handPose.hasHands?.() ?? true)) {\n          hands ??= this.readHands();\n          this.placeOnHand(id, state, hands);\n        } else {\n          // No hands here (a desktop, or no session yet): the menu follows\n          // the body instead, and the gate does not apply.\n          state.gateOpen = true;\n          this.applyPresentation(id);\n          this.applyFollow(state.handle.group, state.options, deltaSeconds, true);\n        }\n        continue;\n      }\n      if (record.dockMode === DockMode.BodyFollow && !record.dragging && !docked) {\n        this.applyFollow(state.handle.group, state.options, deltaSeconds, true);\n      }\n    }\n    for (const state of this.regionStates.values()) {\n      if (state.follow) {\n        this.applyFollow(\n          state.handle.group,\n          {\n            followOffset: state.followOffset,\n            followSpeed: 3,\n            followTolerance: 0.2,\n          },\n          deltaSeconds,\n          false,\n        );\n        this.layoutRegion(state.handle.id);\n      }\n    }\n  }\n\n  /** This frame's tracked hands from the source, absent ones left out. */\n  private readHands(): HandPoses {\n    const poses: HandPoses = {};\n    for (const hand of ['left', 'right'] as const) {\n      const pose = this.handPose?.getHandPose(hand);\n      if (pose) {\n        poses[hand] = pose;\n      }\n    }\n    return poses;\n  }\n\n  private placeOnHand(id: string, state: WindowState, hands: HandPoses): void {\n    const record = this.manager.get(id);\n    if (!record) {\n      return;\n    }\n    const placement = evaluateHandMenu(hands, this.headPose.getHeadPose().position, record.handMenu);\n    state.gateOpen = placement.visible;\n    if (placement.pose) {\n      state.handle.group.position.set(...placement.pose.position);\n      state.handle.group.quaternion.set(...placement.pose.quaternion);\n    }\n    this.applyPresentation(id);\n  }\n\n  private applyFollow(\n    group: Group,\n    options: FollowOptions,\n    deltaSeconds: number,\n    faceViewer: boolean,\n  ): void {\n    const pose = this.headPose.getHeadPose();\n    const target = followTarget(pose, options.followOffset);\n    const position = group.position;\n    const current: Vec3Tuple = [position.x, position.y, position.z];\n    const tolerance = options.followTolerance;\n    if (distanceSquared(current, target) <= tolerance * tolerance) {\n      return;\n    }\n    const next = approach(\n      current,\n      target,\n      approachAlpha(options.followSpeed, deltaSeconds),\n    );\n    position.set(...next);\n    if (faceViewer) {\n      group.lookAt(pose.position[0], position.y, pose.position[2]);\n    }\n  }\n\n  /** Re-place every docked window into its region's slot. */\n  private layoutRegions(): void {\n    for (const id of this.regionStates.keys()) {\n      this.layoutRegion(id);\n    }\n  }\n\n  private layoutRegion(regionId: string): void {\n    const regionState = this.regionStates.get(regionId);\n    const registered = this.regions.get(regionId);\n    if (!regionState || !registered) {\n      return;\n    }\n    const origin = regionState.handle.group.position;\n    registered.members.forEach((windowId, index) => {\n      const windowState = this.states.get(windowId);\n      if (!windowState) {\n        return;\n      }\n      const [dx, dy, dz] = slotOffset(registered.definition, index);\n      windowState.handle.group.position.set(\n        origin.x + dx,\n        origin.y + dy,\n        origin.z + dz,\n      );\n      windowState.handle.group.quaternion.copy(regionState.handle.group.quaternion);\n    });\n  }\n\n  private wireChrome(\n    options: CreateWindowOptions,\n    handle: XrBlocksWindowHandle,\n  ): void {\n    const element = (id: string) => handle.document.getElementById(id);\n    const id = handle.id;\n\n    const title = element(WINDOW_CHROME_IDS.title);\n    if (title && options.title) {\n      title.setProperties({ text: options.title });\n    }\n\n    // Chrome presses must not bubble to the window root's focus handler:\n    // a press on CLOSE would otherwise focus a window that is about to be\n    // destroyed, and `focus()` on a removed window throws. (Same guard the\n    // IWSDK adapter applies.)\n    const swallowPress = (button: UixElement | undefined): void => {\n      button?.addEventListener('pointerdown', (event) => {\n        (event as { stopPropagation?: () => void } | undefined)?.stopPropagation?.();\n      });\n    };\n    swallowPress(element(WINDOW_CHROME_IDS.pin));\n    swallowPress(element(WINDOW_CHROME_IDS.dock));\n    swallowPress(element(WINDOW_CHROME_IDS.minimize));\n    swallowPress(element(WINDOW_CHROME_IDS.close));\n\n    // Any press anywhere on the window brings it to the front. Guarded:\n    // events can still arrive for a window that was just closed.\n    element(WINDOW_CHROME_IDS.window)?.addEventListener('pointerdown', () => {\n      if (this.manager.has(id)) {\n        this.manager.focus(id);\n      }\n    });\n\n    const state = this.states.get(id);\n    if (state) {\n      state.content = element(WINDOW_CHROME_IDS.content);\n      state.pin = element(WINDOW_CHROME_IDS.pin);\n      state.minimize = element(WINDOW_CHROME_IDS.minimize);\n      state.buttons = {\n        close: element(WINDOW_CHROME_IDS.close),\n        minimize: element(WINDOW_CHROME_IDS.minimize),\n        pin: element(WINDOW_CHROME_IDS.pin),\n        dock: element(WINDOW_CHROME_IDS.dock),\n      };\n    }\n\n    // Every button is wired once and gated on the record at click time, so\n    // enabling a button later (manager.setChrome) needs no rewiring.\n    const enabled = (key: keyof WindowChrome): boolean =>\n      this.manager.get(id)?.chrome[key] === true;\n\n    element(WINDOW_CHROME_IDS.close)?.addEventListener('click', () => {\n      if (enabled('close')) {\n        this.manager.close(id);\n      }\n    });\n    element(WINDOW_CHROME_IDS.minimize)?.addEventListener('click', () => {\n      if (enabled('minimize')) {\n        this.manager.toggleMinimized(id);\n      }\n    });\n    element(WINDOW_CHROME_IDS.pin)?.addEventListener('click', () => {\n      if (enabled('pin')) {\n        // Pinning a docked window pops it out of its region first.\n        this.manager.undock(id);\n        this.manager.togglePin(id);\n      }\n    });\n    element(WINDOW_CHROME_IDS.dock)?.addEventListener('click', () => {\n      if (enabled('dock')) {\n        this.manager.returnHome(id);\n      }\n    });\n    this.syncMinimizeLabel(id);\n    this.syncPinLabel(id);\n  }\n\n  /** Show exactly the enabled buttons. */\n  private applyChrome(record: Pick<WindowRecord, 'id' | 'chrome'>): void {\n    const buttons = this.states.get(record.id)?.buttons;\n    if (!buttons) {\n      return;\n    }\n    for (const key of ['close', 'minimize', 'pin', 'dock'] as const) {\n      buttons[key]?.setProperties({ display: record.chrome[key] ? 'flex' : 'none' });\n    }\n  }\n\n  /** Drawn exactly when not hidden and (for a hand menu) the palm gate is open. */\n  private applyPresentation(id: string): void {\n    const state = this.states.get(id);\n    const record = this.manager.get(id);\n    if (state && record) {\n      state.handle.group.visible = !record.hidden && state.gateOpen;\n    }\n  }\n\n  private setContentCollapsed(id: string, collapsed: boolean): void {\n    this.states\n      .get(id)\n      ?.content?.setProperties({ display: collapsed ? 'none' : 'flex' });\n  }\n\n  /** MIN when open, MAX when minimized - the label names the next action. */\n  private syncMinimizeLabel(id: string): void {\n    const record = this.manager.get(id);\n    const minimize = this.states.get(id)?.minimize;\n    if (record && minimize) {\n      minimize.setProperties({ text: minimizeLabelFor(record) });\n    }\n  }\n\n  private syncPinLabel(id: string): void {\n    const record = this.manager.get(id);\n    const pin = this.states.get(id)?.pin;\n    if (record && pin) {\n      pin.setProperties({ text: pinLabelFor(record) });\n    }\n  }\n}\n"]}

package/dist/xrblocks.d.ts

@@ -19,7 +19,7 @@
  *   }
  */
 import { type Object3D, type PerspectiveCamera } from 'three';
-import type { HeadPoseSource } from '@realitycollective/webxr-uiextensions';
+import type { HandPoseSource, HeadPoseSource } from '@realitycollective/webxr-uiextensions';
 import type { Kit } from '@pmndrs/uikitml';
 import { UixWindowHost } from './host.js';
 /** The slice of an XR Blocks Script / three.js app the host binds to. */
@@ -30,7 +30,29 @@ export interface EngineContext {
     camera: Pick<PerspectiveCamera, 'getWorldPosition' | 'getWorldQuaternion'>;
     /** Optional UIKitML component kit(s). */
     kit?: Kit;
+    /**
+     * `renderer.xr`, so hand menus can ride the tracked hands in a session.
+     * Leave it out on a desktop; hand-locked windows then follow the body.
+     */
+    xr?: WebXRFrameAccess;
 }
+/**
+ * The slice of three's `WebXRManager` (`renderer.xr`) a hand pose source
+ * needs. Structural, so anything with the same three methods will do.
+ */
+export interface WebXRFrameAccess {
+    getFrame(): XRFrame | null | undefined;
+    getReferenceSpace(): XRReferenceSpace | null;
+    getSession(): XRSession | null;
+}
+/**
+ * HandPoseSource backed by a live WebXR session: each hand's pose is its
+ * input source's `gripSpace` (a controller's grip, or the tracked hand),
+ * falling back to the target ray space when a runtime gives a hand none.
+ * Returns `undefined` for a hand with no input source this frame, or with no
+ * frame at all (outside a session), so hand menus stay hidden there.
+ */
+export declare function webxrHandPoseSource(xr: WebXRFrameAccess): HandPoseSource;
 /** HeadPoseSource backed by a three.js camera. */
 export declare function cameraHeadPoseSource(camera: EngineContext['camera']): HeadPoseSource;
 /** Create a window host bound to an XR Blocks Script / three.js context. */

package/dist/xrblocks.js

@@ -20,6 +20,45 @@
  */
 import { Quaternion, Vector3 } from 'three';
 import { UixWindowHost } from './host.js';
+/**
+ * HandPoseSource backed by a live WebXR session: each hand's pose is its
+ * input source's `gripSpace` (a controller's grip, or the tracked hand),
+ * falling back to the target ray space when a runtime gives a hand none.
+ * Returns `undefined` for a hand with no input source this frame, or with no
+ * frame at all (outside a session), so hand menus stay hidden there.
+ */
+export function webxrHandPoseSource(xr) {
+    return {
+        hasHands() {
+            const session = xr.getSession();
+            return session !== null && session.inputSources.length > 0;
+        },
+        getHandPose(hand) {
+            const frame = xr.getFrame();
+            const referenceSpace = xr.getReferenceSpace();
+            const session = xr.getSession();
+            if (!frame || !referenceSpace || !session) {
+                return undefined;
+            }
+            for (const source of session.inputSources) {
+                if (source.handedness !== hand) {
+                    continue;
+                }
+                const space = source.gripSpace ?? source.targetRaySpace;
+                const pose = frame.getPose(space, referenceSpace);
+                if (!pose) {
+                    return undefined;
+                }
+                const { position, orientation } = pose.transform;
+                return {
+                    position: [position.x, position.y, position.z],
+                    quaternion: [orientation.x, orientation.y, orientation.z, orientation.w],
+                };
+            }
+            return undefined;
+        },
+    };
+}
 /** HeadPoseSource backed by a three.js camera. */
 export function cameraHeadPoseSource(camera) {
     const position = new Vector3();
@@ -40,6 +79,7 @@ export function connectUIExtensions(context) {
     return new UixWindowHost({
         scene: context.scene,
         headPose: cameraHeadPoseSource(context.camera),
+        ...(context.xr ? { handPose: webxrHandPoseSource(context.xr) } : {}),
         ...(context.kit ? { kit: context.kit } : {}),
     });
 }

package/dist/xrblocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"xrblocks.js","sourceRoot":"","sources":["../src/xrblocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAyC,MAAM,OAAO,CAAC;AAGnF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAY1C,kDAAkD;AAClD,MAAM,UAAU,oBAAoB,CAClC,MAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IACpC,OAAO;QACL,WAAW;YACT,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YACtC,OAAO;gBACL,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAC9C,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;aACrE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,IAAI,aAAa,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * XR Blocks glue.\n *\n * XR Blocks (https://github.com/google/xrblocks) is three.js-based: a\n * Script's `scene`/`camera` are ordinary three.js objects, and `update()`\n * runs per frame. This module binds a {@link UixWindowHost} to that shape\n * WITHOUT importing `xrblocks` (loose structural types), so the package\n * works identically in an XR Blocks Script and in any hand-rolled three.js\n * WebXR app.\n *\n * Typical XR Blocks usage:\n *\n *   import * as xb from 'xrblocks';\n *   import { connectUIExtensions } from '@realitycollective/xrblocks-uiextensions';\n *\n *   class MyScript extends xb.Script {\n *     init() { this.uix = connectUIExtensions({ scene: this, camera: xb.core.camera }); }\n *     update() { this.uix.update(xb.core.timer.getDelta()); }\n *   }\n */\nimport { Quaternion, Vector3, type Object3D, type PerspectiveCamera } from 'three';\nimport type { HeadPose, HeadPoseSource } from '@realitycollective/webxr-uiextensions';\nimport type { Kit } from '@pmndrs/uikitml';\nimport { UixWindowHost } from './host.js';\n\n/** The slice of an XR Blocks Script / three.js app the host binds to. */\nexport interface EngineContext {\n  /** Where windows are parented - an XR Blocks Script IS an Object3D. */\n  scene: Object3D;\n  /** The rendering camera; in XR the engine keeps it at the viewer pose. */\n  camera: Pick<PerspectiveCamera, 'getWorldPosition' | 'getWorldQuaternion'>;\n  /** Optional UIKitML component kit(s). */\n  kit?: Kit;\n}\n\n/** HeadPoseSource backed by a three.js camera. */\nexport function cameraHeadPoseSource(\n  camera: EngineContext['camera'],\n): HeadPoseSource {\n  const position = new Vector3();\n  const quaternion = new Quaternion();\n  return {\n    getHeadPose(): HeadPose {\n      camera.getWorldPosition(position);\n      camera.getWorldQuaternion(quaternion);\n      return {\n        position: [position.x, position.y, position.z],\n        quaternion: [quaternion.x, quaternion.y, quaternion.z, quaternion.w],\n      };\n    },\n  };\n}\n\n/** Create a window host bound to an XR Blocks Script / three.js context. */\nexport function connectUIExtensions(context: EngineContext): UixWindowHost {\n  return new UixWindowHost({\n    scene: context.scene,\n    headPose: cameraHeadPoseSource(context.camera),\n    ...(context.kit ? { kit: context.kit } : {}),\n  });\n}\n"]}
+{"version":3,"file":"xrblocks.js","sourceRoot":"","sources":["../src/xrblocks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * XR Blocks glue.\n *\n * XR Blocks (https://github.com/google/xrblocks) is three.js-based: a\n * Script's `scene`/`camera` are ordinary three.js objects, and `update()`\n * runs per frame. This module binds a {@link UixWindowHost} to that shape\n * WITHOUT importing `xrblocks` (loose structural types), so the package\n * works identically in an XR Blocks Script and in any hand-rolled three.js\n * WebXR app.\n *\n * Typical XR Blocks usage:\n *\n *   import * as xb from 'xrblocks';\n *   import { connectUIExtensions } from '@realitycollective/xrblocks-uiextensions';\n *\n *   class MyScript extends xb.Script {\n *     init() { this.uix = connectUIExtensions({ scene: this, camera: xb.core.camera }); }\n *     update() { this.uix.update(xb.core.timer.getDelta()); }\n *   }\n */\nimport { Quaternion, Vector3, type Object3D, type PerspectiveCamera } from 'three';\nimport type { HandPoseSource, HeadPose, HeadPoseSource } from '@realitycollective/webxr-uiextensions';\nimport type { Kit } from '@pmndrs/uikitml';\nimport { UixWindowHost } from './host.js';\n\n/** The slice of an XR Blocks Script / three.js app the host binds to. */\nexport interface EngineContext {\n  /** Where windows are parented - an XR Blocks Script IS an Object3D. */\n  scene: Object3D;\n  /** The rendering camera; in XR the engine keeps it at the viewer pose. */\n  camera: Pick<PerspectiveCamera, 'getWorldPosition' | 'getWorldQuaternion'>;\n  /** Optional UIKitML component kit(s). */\n  kit?: Kit;\n  /**\n   * `renderer.xr`, so hand menus can ride the tracked hands in a session.\n   * Leave it out on a desktop; hand-locked windows then follow the body.\n   */\n  xr?: WebXRFrameAccess;\n}\n\n/**\n * The slice of three's `WebXRManager` (`renderer.xr`) a hand pose source\n * needs. Structural, so anything with the same three methods will do.\n */\nexport interface WebXRFrameAccess {\n  getFrame(): XRFrame | null | undefined;\n  getReferenceSpace(): XRReferenceSpace | null;\n  getSession(): XRSession | null;\n}\n\n/**\n * HandPoseSource backed by a live WebXR session: each hand's pose is its\n * input source's `gripSpace` (a controller's grip, or the tracked hand),\n * falling back to the target ray space when a runtime gives a hand none.\n * Returns `undefined` for a hand with no input source this frame, or with no\n * frame at all (outside a session), so hand menus stay hidden there.\n */\nexport function webxrHandPoseSource(xr: WebXRFrameAccess): HandPoseSource {\n  return {\n    hasHands() {\n      const session = xr.getSession();\n      return session !== null && session.inputSources.length > 0;\n    },\n    getHandPose(hand) {\n      const frame = xr.getFrame();\n      const referenceSpace = xr.getReferenceSpace();\n      const session = xr.getSession();\n      if (!frame || !referenceSpace || !session) {\n        return undefined;\n      }\n      for (const source of session.inputSources) {\n        if (source.handedness !== hand) {\n          continue;\n        }\n        const space = source.gripSpace ?? source.targetRaySpace;\n        const pose = frame.getPose(space, referenceSpace);\n        if (!pose) {\n          return undefined;\n        }\n        const { position, orientation } = pose.transform;\n        return {\n          position: [position.x, position.y, position.z],\n          quaternion: [orientation.x, orientation.y, orientation.z, orientation.w],\n        };\n      }\n      return undefined;\n    },\n  };\n}\n\n/** HeadPoseSource backed by a three.js camera. */\nexport function cameraHeadPoseSource(\n  camera: EngineContext['camera'],\n): HeadPoseSource {\n  const position = new Vector3();\n  const quaternion = new Quaternion();\n  return {\n    getHeadPose(): HeadPose {\n      camera.getWorldPosition(position);\n      camera.getWorldQuaternion(quaternion);\n      return {\n        position: [position.x, position.y, position.z],\n        quaternion: [quaternion.x, quaternion.y, quaternion.z, quaternion.w],\n      };\n    },\n  };\n}\n\n/** Create a window host bound to an XR Blocks Script / three.js context. */\nexport function connectUIExtensions(context: EngineContext): UixWindowHost {\n  return new UixWindowHost({\n    scene: context.scene,\n    headPose: cameraHeadPoseSource(context.camera),\n    ...(context.xr ? { handPose: webxrHandPoseSource(context.xr) } : {}),\n    ...(context.kit ? { kit: context.kit } : {}),\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realitycollective/xrblocks-uiextensions",
-  "version": "0.1.0-preview.7",
+  "version": "0.1.0",
   "description": "EXPERIMENTAL Google XR Blocks / plain three.js adapter for the Reality Collective UI Extensions - hosts the engine-free @realitycollective/webxr-uiextensions windowing core (UIKitML panels, window chrome, follow mode) in any three.js WebXR scene, including XR Blocks Scripts.",
   "keywords": [
     "realitycollective",
@@ -37,7 +37,7 @@
   "dependencies": {
     "@pmndrs/uikit": "^1.0.76",
     "@pmndrs/uikitml": "^0.1.12",
-    "@realitycollective/webxr-uiextensions": "^0.1.0-preview.7"
+    "@realitycollective/webxr-uiextensions": "^0.1.0"
   },
   "peerDependencies": {
     "three": ">=0.170.0"