@realitycollective/iwsdk-uiextensions 0.1.0-preview.4

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

@@ -0,0 +1,205 @@
+declare const UIDockSystem_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;
+            };
+        }>)[];
+    };
+}, 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;
+            };
+        }>)[];
+    };
+}>>;
+export declare class UIDockSystem extends UIDockSystem_base {
+    private manager;
+    private windowPosition;
+    private viewerPosition;
+    init(): void;
+    update(): void;
+    private apply;
+    private faceViewer;
+    private offsetHelper;
+    private yawQuaternion;
+    private yawEuler;
+    private addFollower;
+}
+export {};

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