@realitycollective/iwsdk-uiextensions 0.1.0-preview.0

package/dist/systems/dock-system.js

@@ -0,0 +1,135 @@
+/**
+ * UIDockSystem - realises dock modes by composing IWSDK components.
+ *
+ * `body-follow` and `head-locked` are implemented with the IWSDK's own
+ * `Follower` / `ScreenSpace` components (reuse, not recreation); this system
+ * only plans and applies transitions with the pure dock state machine.
+ */
+import { Euler, Follower, FollowBehavior, Quaternion, ScreenSpace, Vector3, createSystem, } from '@iwsdk/core';
+import { UIWindow, UIWindowState } from '../components.js';
+import { DockMode, isDockMode, planTransition, recipeFor, } from '@realitycollective/webxr-uiextensions';
+import { faceViewerYaw } from '@realitycollective/webxr-uiextensions';
+import { windowManagerFor } from '../manager-registry.js';
+export class UIDockSystem extends createSystem({
+    windows: { required: [UIWindow, UIWindowState] },
+}) {
+    manager;
+    windowPosition = new Vector3();
+    viewerPosition = new Vector3();
+    init() {
+        this.manager = windowManagerFor(this.world);
+    }
+    update() {
+        for (const entity of this.queries.windows.entities) {
+            const requested = entity.getValue(UIWindow, 'dockMode');
+            const applied = entity.getValue(UIWindowState, 'appliedDockMode');
+            if (!isDockMode(requested) || applied === requested) {
+                continue;
+            }
+            this.apply(entity, applied, requested);
+        }
+    }
+    apply(entity, applied, requested) {
+        if (isDockMode(applied)) {
+            const plan = planTransition(applied, requested);
+            if (!plan) {
+                return;
+            }
+            if (plan.removeFollower && entity.hasComponent(Follower)) {
+                entity.removeComponent(Follower);
+            }
+            if (plan.removeFollower && requested === DockMode.WorldLocked) {
+                // Pinning in place: leave the window facing the user at the spot it
+                // was pinned, instead of freezing whatever lagging follow rotation
+                // it happened to have this frame.
+                this.faceViewer(entity);
+            }
+            if (plan.removeScreenSpace && entity.hasComponent(ScreenSpace)) {
+                entity.removeComponent(ScreenSpace);
+            }
+            if (plan.addFollower) {
+                // Unpinning: keep the window where the user left it, expressed
+                // relative to their head, instead of snapping to the default offset.
+                this.addFollower(entity, { fromCurrentPose: true });
+            }
+            if (plan.addScreenSpace) {
+                entity.addComponent(ScreenSpace);
+            }
+            if (plan.snap && entity.hasComponent(Follower)) {
+                entity.setValue(Follower, 'needsPositionSync', true);
+            }
+        }
+        else {
+            // First application after adoption: build the requested recipe from
+            // scratch (the entity carries no dock components we own yet).
+            const recipe = recipeFor(requested);
+            if (recipe.follower && !entity.hasComponent(Follower)) {
+                this.addFollower(entity);
+            }
+            if (!recipe.follower && entity.hasComponent(Follower)) {
+                entity.removeComponent(Follower);
+            }
+            if (recipe.screenSpace && !entity.hasComponent(ScreenSpace)) {
+                entity.addComponent(ScreenSpace);
+            }
+            if (!recipe.screenSpace && entity.hasComponent(ScreenSpace)) {
+                entity.removeComponent(ScreenSpace);
+            }
+        }
+        entity.setValue(UIWindowState, 'appliedDockMode', requested);
+        const id = entity.getValue(UIWindow, 'windowId');
+        if (id && this.manager.has(id)) {
+            this.manager.setDockMode(id, requested);
+        }
+    }
+    faceViewer(entity) {
+        const object = entity.object3D;
+        if (!object) {
+            return;
+        }
+        object.getWorldPosition(this.windowPosition);
+        this.camera.getWorldPosition(this.viewerPosition);
+        const yaw = faceViewerYaw([this.windowPosition.x, this.windowPosition.y, this.windowPosition.z], [this.viewerPosition.x, this.viewerPosition.y, this.viewerPosition.z], object.rotation.y);
+        object.rotation.set(0, yaw, 0);
+    }
+    offsetHelper = new Vector3();
+    yawQuaternion = new Quaternion();
+    yawEuler = new Euler();
+    addFollower(entity, options = {}) {
+        const configured = entity.getVectorView(UIWindow, 'followOffset');
+        let offset = [
+            configured[0] ?? 0,
+            configured[1] ?? 0,
+            configured[2] ?? 0,
+        ];
+        const object = entity.object3D;
+        if (options.fromCurrentPose && object) {
+            // Current window position in the viewer's yaw-local frame (matching
+            // how Follower's PivotY applies offsets), so following resumes from
+            // the same bearing and distance the window was unpinned at.
+            object.getWorldPosition(this.offsetHelper);
+            this.camera.getWorldPosition(this.windowPosition);
+            this.camera.getWorldQuaternion(this.yawQuaternion);
+            this.yawEuler.setFromQuaternion(this.yawQuaternion, 'YXZ');
+            this.yawEuler.x = 0;
+            this.yawEuler.z = 0;
+            this.yawQuaternion.setFromEuler(this.yawEuler).conjugate();
+            this.offsetHelper.sub(this.windowPosition).applyQuaternion(this.yawQuaternion);
+            // Degenerate (window at the viewer): keep the configured offset.
+            if (this.offsetHelper.lengthSq() > 0.01) {
+                offset = [this.offsetHelper.x, this.offsetHelper.y, this.offsetHelper.z];
+            }
+        }
+        entity.addComponent(Follower, {
+            // The camera, not player.head: three.js syncs the camera to the
+            // headset pose in-session, while the head rig sits at the origin
+            // outside XR (desktop) - following it would park windows at the floor.
+            target: this.camera,
+            offsetPosition: offset,
+            behavior: FollowBehavior.PivotY,
+            speed: entity.getValue(UIWindow, 'followSpeed'),
+            tolerance: entity.getValue(UIWindow, 'followTolerance'),
+        });
+    }
+}
+//# sourceMappingURL=dock-system.js.map

package/dist/systems/dock-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock-system.js","sourceRoot":"","sources":["../../src/systems/dock-system.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UIDockSystem - realises dock modes by composing IWSDK components.\n *\n * `body-follow` and `head-locked` are implemented with the IWSDK's own\n * `Follower` / `ScreenSpace` components (reuse, not recreation); this system\n * only plans and applies transitions with the pure dock state machine.\n */\nimport {\n  Euler,\n  Follower,\n  FollowBehavior,\n  Quaternion,\n  ScreenSpace,\n  Vector3,\n  createSystem,\n  type Entity,\n} from '@iwsdk/core';\nimport { UIWindow, UIWindowState } from '../components.js';\nimport {\n  DockMode,\n  isDockMode,\n  planTransition,\n  recipeFor,\n  type DockModeValue,\n} from '@realitycollective/webxr-uiextensions';\nimport { faceViewerYaw } from '@realitycollective/webxr-uiextensions';\nimport { windowManagerFor } from '../manager-registry.js';\nimport type { WindowManager } from '@realitycollective/webxr-uiextensions';\n\nexport class UIDockSystem extends createSystem({\n  windows: { required: [UIWindow, UIWindowState] },\n}) {\n  private manager!: WindowManager;\n  private windowPosition = new Vector3();\n  private viewerPosition = new Vector3();\n\n  override init(): void {\n    this.manager = windowManagerFor(this.world);\n  }\n\n  override update(): void {\n    for (const entity of this.queries.windows.entities) {\n      const requested = entity.getValue(UIWindow, 'dockMode') as DockModeValue;\n      const applied = entity.getValue(UIWindowState, 'appliedDockMode') as string;\n      if (!isDockMode(requested) || applied === requested) {\n        continue;\n      }\n      this.apply(entity, applied, requested);\n    }\n  }\n\n  private apply(entity: Entity, applied: string, requested: DockModeValue): void {\n    if (isDockMode(applied)) {\n      const plan = planTransition(applied, requested);\n      if (!plan) {\n        return;\n      }\n      if (plan.removeFollower && entity.hasComponent(Follower)) {\n        entity.removeComponent(Follower);\n      }\n      if (plan.removeFollower && requested === DockMode.WorldLocked) {\n        // Pinning in place: leave the window facing the user at the spot it\n        // was pinned, instead of freezing whatever lagging follow rotation\n        // it happened to have this frame.\n        this.faceViewer(entity);\n      }\n      if (plan.removeScreenSpace && entity.hasComponent(ScreenSpace)) {\n        entity.removeComponent(ScreenSpace);\n      }\n      if (plan.addFollower) {\n        // Unpinning: keep the window where the user left it, expressed\n        // relative to their head, instead of snapping to the default offset.\n        this.addFollower(entity, { fromCurrentPose: true });\n      }\n      if (plan.addScreenSpace) {\n        entity.addComponent(ScreenSpace);\n      }\n      if (plan.snap && entity.hasComponent(Follower)) {\n        entity.setValue(Follower, 'needsPositionSync', true);\n      }\n    } else {\n      // First application after adoption: build the requested recipe from\n      // scratch (the entity carries no dock components we own yet).\n      const recipe = recipeFor(requested);\n      if (recipe.follower && !entity.hasComponent(Follower)) {\n        this.addFollower(entity);\n      }\n      if (!recipe.follower && entity.hasComponent(Follower)) {\n        entity.removeComponent(Follower);\n      }\n      if (recipe.screenSpace && !entity.hasComponent(ScreenSpace)) {\n        entity.addComponent(ScreenSpace);\n      }\n      if (!recipe.screenSpace && entity.hasComponent(ScreenSpace)) {\n        entity.removeComponent(ScreenSpace);\n      }\n    }\n\n    entity.setValue(UIWindowState, 'appliedDockMode', requested);\n\n    const id = entity.getValue(UIWindow, 'windowId') as string;\n    if (id && this.manager.has(id)) {\n      this.manager.setDockMode(id, requested);\n    }\n  }\n\n  private faceViewer(entity: Entity): void {\n    const object = entity.object3D;\n    if (!object) {\n      return;\n    }\n    object.getWorldPosition(this.windowPosition);\n    this.camera.getWorldPosition(this.viewerPosition);\n    const yaw = faceViewerYaw(\n      [this.windowPosition.x, this.windowPosition.y, this.windowPosition.z],\n      [this.viewerPosition.x, this.viewerPosition.y, this.viewerPosition.z],\n      object.rotation.y,\n    );\n    object.rotation.set(0, yaw, 0);\n  }\n\n  private offsetHelper = new Vector3();\n  private yawQuaternion = new Quaternion();\n  private yawEuler = new Euler();\n\n  private addFollower(entity: Entity, options: { fromCurrentPose?: boolean } = {}): void {\n    const configured = entity.getVectorView(UIWindow, 'followOffset');\n    let offset: [number, number, number] = [\n      configured[0] ?? 0,\n      configured[1] ?? 0,\n      configured[2] ?? 0,\n    ];\n\n    const object = entity.object3D;\n    if (options.fromCurrentPose && object) {\n      // Current window position in the viewer's yaw-local frame (matching\n      // how Follower's PivotY applies offsets), so following resumes from\n      // the same bearing and distance the window was unpinned at.\n      object.getWorldPosition(this.offsetHelper);\n      this.camera.getWorldPosition(this.windowPosition);\n      this.camera.getWorldQuaternion(this.yawQuaternion);\n      this.yawEuler.setFromQuaternion(this.yawQuaternion, 'YXZ');\n      this.yawEuler.x = 0;\n      this.yawEuler.z = 0;\n      this.yawQuaternion.setFromEuler(this.yawEuler).conjugate();\n      this.offsetHelper.sub(this.windowPosition).applyQuaternion(this.yawQuaternion);\n      // Degenerate (window at the viewer): keep the configured offset.\n      if (this.offsetHelper.lengthSq() > 0.01) {\n        offset = [this.offsetHelper.x, this.offsetHelper.y, this.offsetHelper.z];\n      }\n    }\n\n    entity.addComponent(Follower, {\n      // The camera, not player.head: three.js syncs the camera to the\n      // headset pose in-session, while the head rig sits at the origin\n      // outside XR (desktop) - following it would park windows at the floor.\n      target: this.camera,\n      offsetPosition: offset,\n      behavior: FollowBehavior.PivotY,\n      speed: entity.getValue(UIWindow, 'followSpeed') as number,\n      tolerance: entity.getValue(UIWindow, 'followTolerance') as number,\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,280 @@
+declare const UIDragSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    windows: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            appliedDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            chromeWired: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: false;
+            };
+            homeDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homeRegion: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homePosition: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            homeYaw: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            document: {
+                type: import("@iwsdk/core").Types.Object;
+                default: undefined;
+            };
+        }>)[];
+    };
+    regions: {
+        required: import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            flow: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly Row: "row";
+                    readonly Column: "column";
+                    readonly Grid: "grid";
+                };
+                default: "column";
+            };
+            pitch: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            columns: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            capacity: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            snapRadius: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+}, World, import("@iwsdk/core").System<import("elics").SystemSchema, {
+    windows: {
+        required: (import("elics").Component<{
+            windowId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            title: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            dockMode: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly WorldLocked: "world-locked";
+                    readonly BodyFollow: "body-follow";
+                    readonly HeadLocked: "head-locked";
+                };
+                default: "world-locked";
+            };
+            movable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            closable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            minimizable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            pinnable: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            billboardWhileDragging: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: true;
+            };
+            dragDelay: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followOffset: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            followSpeed: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            followTolerance: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            focusBias: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetWidth: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            targetHeight: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            appliedDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            chromeWired: {
+                type: import("@iwsdk/core").Types.Boolean;
+                default: false;
+            };
+            homeDockMode: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homeRegion: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            homePosition: {
+                type: import("@iwsdk/core").Types.Vec3;
+                default: [number, number, number];
+            };
+            homeYaw: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            document: {
+                type: import("@iwsdk/core").Types.Object;
+                default: undefined;
+            };
+        }>)[];
+    };
+    regions: {
+        required: import("elics").Component<{
+            regionId: {
+                type: import("@iwsdk/core").Types.String;
+                default: string;
+            };
+            flow: {
+                type: import("@iwsdk/core").Types.Enum;
+                enum: {
+                    readonly Row: "row";
+                    readonly Column: "column";
+                    readonly Grid: "grid";
+                };
+                default: "column";
+            };
+            pitch: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            columns: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            capacity: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+            snapRadius: {
+                type: import("@iwsdk/core").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+}>>;
+export declare class UIDragSystem extends UIDragSystem_base {
+    private states;
+    private worldPosition;
+    private viewerPosition;
+    init(): void;
+    update(delta: number): void;
+    private attach;
+    private detach;
+    private onDragStart;
+    private whileDragging;
+    private onDragEnd;
+}
+export {};

package/dist/systems/drag-system.js

@@ -0,0 +1,167 @@
+/**
+ * UIDragSystem - drag windows by the title bar.
+ *
+ * Reuses `@pmndrs/handle` (the exact library behind the IWSDK's grab
+ * systems): a `HandleStore` targets the window entity's object while being
+ * *bound* to the title-bar uikit element, so grabbing the title bar with the
+ * ray (or a pinch) moves the whole window with the same feel as native IWSDK
+ * grabbing. The system pumps its own stores, so it works even when the app
+ * doesn't enable `features.grabbing`.
+ *
+ * Dragging implies placing: on grab the window leaves any dock region and
+ * switches to `world-locked`; on release near a region it docks there.
+ */
+import { HandleStore } from '@pmndrs/handle';
+import { PanelDocument, Vector3, createSystem, } from '@iwsdk/core';
+import { UIDockRegion, UIDockedTo, UIWindow, UIWindowState } from '../components.js';
+import { WINDOW_CHROME_IDS } from '@realitycollective/webxr-uiextensions';
+import { DockMode } from '@realitycollective/webxr-uiextensions';
+import { faceViewerYaw } from '@realitycollective/webxr-uiextensions';
+import { HoldToDrag } from '@realitycollective/webxr-uiextensions';
+import { regionRegistryFor } from '../region-registry-store.js';
+import { windowManagerFor } from '../manager-registry.js';
+export class UIDragSystem extends createSystem({
+    windows: { required: [UIWindow, UIWindowState, PanelDocument] },
+    regions: { required: [UIDockRegion] },
+}) {
+    states = new Map();
+    worldPosition = new Vector3();
+    viewerPosition = new Vector3();
+    init() {
+        this.cleanupFuncs.push(this.queries.windows.subscribe('qualify', (entity) => {
+            this.attach(entity);
+        }), this.queries.windows.subscribe('disqualify', (entity) => {
+            this.detach(entity);
+        }));
+        this.queries.windows.entities.forEach((entity) => this.attach(entity));
+    }
+    update(delta) {
+        for (const [entity, state] of this.states) {
+            const held = state.store.inputState.size > 0;
+            const { phase, began, ended } = state.hold.update(held, delta);
+            if (began) {
+                this.onDragStart(entity);
+            }
+            if (phase === 'dragging') {
+                // The store only runs while an actual drag is in progress: presses
+                // shorter than the hold delay never move the window (they're
+                // clicks), and skipping the release-frame update stops the handle
+                // from restoring its grab-time rotation over our billboard yaw.
+                state.store.update(delta);
+                this.whileDragging(entity);
+            }
+            if (ended) {
+                this.onDragEnd(entity);
+            }
+        }
+    }
+    attach(entity) {
+        if (this.states.has(entity) || !entity.getValue(UIWindow, 'movable')) {
+            return;
+        }
+        const document = PanelDocument.data.document[entity.index];
+        const titlebar = document?.getElementById(WINDOW_CHROME_IDS.titlebar);
+        const object = entity.object3D;
+        if (!titlebar || !object) {
+            return;
+        }
+        const store = new HandleStore(object, () => ({
+            translate: true,
+            rotate: false,
+            scale: false,
+            multitouch: false,
+            projectRays: false,
+        }));
+        // The title-bar uikit element is an Object3D - bind it as the grab
+        // surface while the store's target stays the window root.
+        store.bind(titlebar);
+        this.states.set(entity, {
+            store,
+            hold: new HoldToDrag(Math.max(0, entity.getValue(UIWindow, 'dragDelay'))),
+        });
+    }
+    detach(entity) {
+        const state = this.states.get(entity);
+        if (!state) {
+            return;
+        }
+        try {
+            state.store.cancel();
+        }
+        catch {
+            // Handle stores throw when cancelled with no active input; ignore.
+        }
+        this.states.delete(entity);
+    }
+    onDragStart(entity) {
+        const id = entity.getValue(UIWindow, 'windowId');
+        const manager = windowManagerFor(this.world);
+        if (id && manager.has(id)) {
+            manager.focus(id);
+            // Mark dragging BEFORE the dock change so the pin label reads "PIN"
+            // (loose in hand) throughout the drag, not "UNPIN".
+            manager.setDragging(id, true);
+        }
+        // Grabbing takes the window out of any region and out of follow mode -
+        // the user is placing it by hand.
+        if (entity.hasComponent(UIDockedTo)) {
+            entity.removeComponent(UIDockedTo);
+        }
+        if (entity.getValue(UIWindow, 'dockMode') !== DockMode.WorldLocked) {
+            entity.setValue(UIWindow, 'dockMode', DockMode.WorldLocked);
+        }
+    }
+    whileDragging(entity) {
+        if (!entity.getValue(UIWindow, 'billboardWhileDragging')) {
+            return;
+        }
+        const object = entity.object3D;
+        if (!object) {
+            return;
+        }
+        object.getWorldPosition(this.worldPosition);
+        this.camera.getWorldPosition(this.viewerPosition);
+        const yaw = faceViewerYaw([this.worldPosition.x, this.worldPosition.y, this.worldPosition.z], [this.viewerPosition.x, this.viewerPosition.y, this.viewerPosition.z], object.rotation.y);
+        object.rotation.set(0, yaw, 0);
+    }
+    onDragEnd(entity) {
+        const id = entity.getValue(UIWindow, 'windowId');
+        const manager = windowManagerFor(this.world);
+        if (id && manager.has(id)) {
+            manager.setDragging(id, false); // released → placed → label "UNPIN"
+        }
+        // Settle facing the viewer at the drop spot - the window keeps the
+        // orientation it was dragged in, not its pre-drag rotation.
+        this.whileDragging(entity);
+        const object = entity.object3D;
+        if (!object) {
+            return;
+        }
+        object.getWorldPosition(this.worldPosition);
+        const dropPoint = [
+            this.worldPosition.x,
+            this.worldPosition.y,
+            this.worldPosition.z,
+        ];
+        const registry = regionRegistryFor(this.world);
+        const origins = new Map();
+        this.queries.regions.entities.forEach((regionEntity) => {
+            const regionId = regionEntity.getValue(UIDockRegion, 'regionId');
+            const regionObject = regionEntity.object3D;
+            if (!regionId || !regionObject) {
+                return;
+            }
+            regionObject.getWorldPosition(this.viewerPosition);
+            origins.set(regionId, [
+                this.viewerPosition.x,
+                this.viewerPosition.y,
+                this.viewerPosition.z,
+            ]);
+        });
+        const captured = registry.capture(dropPoint, origins);
+        if (captured !== undefined) {
+            entity.addComponent(UIDockedTo, { regionId: captured });
+        }
+    }
+}
+//# sourceMappingURL=drag-system.js.map

package/dist/systems/drag-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-system.js","sourceRoot":"","sources":["../../src/systems/drag-system.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UIDragSystem - drag windows by the title bar.\n *\n * Reuses `@pmndrs/handle` (the exact library behind the IWSDK's grab\n * systems): a `HandleStore` targets the window entity's object while being\n * *bound* to the title-bar uikit element, so grabbing the title bar with the\n * ray (or a pinch) moves the whole window with the same feel as native IWSDK\n * grabbing. The system pumps its own stores, so it works even when the app\n * doesn't enable `features.grabbing`.\n *\n * Dragging implies placing: on grab the window leaves any dock region and\n * switches to `world-locked`; on release near a region it docks there.\n */\nimport { HandleStore } from '@pmndrs/handle';\nimport {\n  PanelDocument,\n  UIKitDocument,\n  Object3D,\n  Vector3,\n  createSystem,\n  type Entity,\n} from '@iwsdk/core';\nimport { UIDockRegion, UIDockedTo, UIWindow, UIWindowState } from '../components.js';\nimport { WINDOW_CHROME_IDS } from '@realitycollective/webxr-uiextensions';\nimport { DockMode } from '@realitycollective/webxr-uiextensions';\nimport { faceViewerYaw } from '@realitycollective/webxr-uiextensions';\nimport { HoldToDrag } from '@realitycollective/webxr-uiextensions';\nimport type { Vec3 } from '@realitycollective/webxr-uiextensions';\nimport { regionRegistryFor } from '../region-registry-store.js';\nimport { windowManagerFor } from '../manager-registry.js';\n\ninterface DragState {\n  store: HandleStore<unknown>;\n  hold: HoldToDrag;\n}\n\nexport class UIDragSystem extends createSystem({\n  windows: { required: [UIWindow, UIWindowState, PanelDocument] },\n  regions: { required: [UIDockRegion] },\n}) {\n  private states = new Map<Entity, DragState>();\n  private worldPosition = new Vector3();\n  private viewerPosition = new Vector3();\n\n  override init(): void {\n    this.cleanupFuncs.push(\n      this.queries.windows.subscribe('qualify', (entity) => {\n        this.attach(entity);\n      }),\n      this.queries.windows.subscribe('disqualify', (entity) => {\n        this.detach(entity);\n      }),\n    );\n    this.queries.windows.entities.forEach((entity) => this.attach(entity));\n  }\n\n  override update(delta: number): void {\n    for (const [entity, state] of this.states) {\n      const held = state.store.inputState.size > 0;\n      const { phase, began, ended } = state.hold.update(held, delta);\n\n      if (began) {\n        this.onDragStart(entity);\n      }\n      if (phase === 'dragging') {\n        // The store only runs while an actual drag is in progress: presses\n        // shorter than the hold delay never move the window (they're\n        // clicks), and skipping the release-frame update stops the handle\n        // from restoring its grab-time rotation over our billboard yaw.\n        state.store.update(delta);\n        this.whileDragging(entity);\n      }\n      if (ended) {\n        this.onDragEnd(entity);\n      }\n    }\n  }\n\n  private attach(entity: Entity): void {\n    if (this.states.has(entity) || !entity.getValue(UIWindow, 'movable')) {\n      return;\n    }\n    const document = PanelDocument.data.document[entity.index] as\n      | UIKitDocument\n      | undefined;\n    const titlebar = document?.getElementById(WINDOW_CHROME_IDS.titlebar);\n    const object = entity.object3D;\n    if (!titlebar || !object) {\n      return;\n    }\n    const store = new HandleStore(object, () => ({\n      translate: true as const,\n      rotate: false as const,\n      scale: false as const,\n      multitouch: false,\n      projectRays: false,\n    }));\n    // The title-bar uikit element is an Object3D - bind it as the grab\n    // surface while the store's target stays the window root.\n    store.bind(titlebar as unknown as Object3D<never>);\n    this.states.set(entity, {\n      store,\n      hold: new HoldToDrag(Math.max(0, entity.getValue(UIWindow, 'dragDelay') as number)),\n    });\n  }\n\n  private detach(entity: Entity): void {\n    const state = this.states.get(entity);\n    if (!state) {\n      return;\n    }\n    try {\n      state.store.cancel();\n    } catch {\n      // Handle stores throw when cancelled with no active input; ignore.\n    }\n    this.states.delete(entity);\n  }\n\n  private onDragStart(entity: Entity): void {\n    const id = entity.getValue(UIWindow, 'windowId') as string;\n    const manager = windowManagerFor(this.world);\n    if (id && manager.has(id)) {\n      manager.focus(id);\n      // Mark dragging BEFORE the dock change so the pin label reads \"PIN\"\n      // (loose in hand) throughout the drag, not \"UNPIN\".\n      manager.setDragging(id, true);\n    }\n    // Grabbing takes the window out of any region and out of follow mode -\n    // the user is placing it by hand.\n    if (entity.hasComponent(UIDockedTo)) {\n      entity.removeComponent(UIDockedTo);\n    }\n    if (entity.getValue(UIWindow, 'dockMode') !== DockMode.WorldLocked) {\n      entity.setValue(UIWindow, 'dockMode', DockMode.WorldLocked);\n    }\n  }\n\n  private whileDragging(entity: Entity): void {\n    if (!entity.getValue(UIWindow, 'billboardWhileDragging')) {\n      return;\n    }\n    const object = entity.object3D;\n    if (!object) {\n      return;\n    }\n    object.getWorldPosition(this.worldPosition);\n    this.camera.getWorldPosition(this.viewerPosition);\n    const yaw = faceViewerYaw(\n      [this.worldPosition.x, this.worldPosition.y, this.worldPosition.z],\n      [this.viewerPosition.x, this.viewerPosition.y, this.viewerPosition.z],\n      object.rotation.y,\n    );\n    object.rotation.set(0, yaw, 0);\n  }\n\n  private onDragEnd(entity: Entity): void {\n    const id = entity.getValue(UIWindow, 'windowId') as string;\n    const manager = windowManagerFor(this.world);\n    if (id && manager.has(id)) {\n      manager.setDragging(id, false); // released → placed → label \"UNPIN\"\n    }\n    // Settle facing the viewer at the drop spot - the window keeps the\n    // orientation it was dragged in, not its pre-drag rotation.\n    this.whileDragging(entity);\n    const object = entity.object3D;\n    if (!object) {\n      return;\n    }\n    object.getWorldPosition(this.worldPosition);\n    const dropPoint: Vec3 = [\n      this.worldPosition.x,\n      this.worldPosition.y,\n      this.worldPosition.z,\n    ];\n\n    const registry = regionRegistryFor(this.world);\n    const origins = new Map<string, Vec3>();\n    this.queries.regions.entities.forEach((regionEntity) => {\n      const regionId = regionEntity.getValue(UIDockRegion, 'regionId') as string;\n      const regionObject = regionEntity.object3D;\n      if (!regionId || !regionObject) {\n        return;\n      }\n      regionObject.getWorldPosition(this.viewerPosition);\n      origins.set(regionId, [\n        this.viewerPosition.x,\n        this.viewerPosition.y,\n        this.viewerPosition.z,\n      ]);\n    });\n\n    const captured = registry.capture(dropPoint, origins);\n    if (captured !== undefined) {\n      entity.addComponent(UIDockedTo, { regionId: captured });\n    }\n  }\n}\n"]}