@realitycollective/webxr-uiextensions 0.1.0-preview.0

package/dist/core/stepper-model.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Stepper model - pure numeric state for the `data-uix="stepper"` control.
+ */
+export interface StepperOptions {
+    min?: number;
+    max?: number;
+    step?: number;
+    value?: number;
+}
+export declare class StepperModel {
+    readonly min: number;
+    readonly max: number;
+    readonly step: number;
+    private current;
+    constructor(options?: StepperOptions);
+    get value(): number;
+    /** Set (clamped); returns true when the value actually changed. */
+    set(value: number): boolean;
+    increment(): boolean;
+    decrement(): boolean;
+    get canIncrement(): boolean;
+    get canDecrement(): boolean;
+    private clamp;
+}

package/dist/core/stepper-model.js

@@ -0,0 +1,46 @@
+export class StepperModel {
+    min;
+    max;
+    step;
+    current;
+    constructor(options = {}) {
+        this.min = options.min ?? 0;
+        this.max = options.max ?? 10;
+        this.step = options.step ?? 1;
+        if (this.max < this.min) {
+            throw new Error(`[uix] stepper max (${this.max}) < min (${this.min})`);
+        }
+        if (!(this.step > 0)) {
+            throw new Error(`[uix] stepper step must be > 0 (got ${this.step})`);
+        }
+        this.current = this.clamp(options.value ?? this.min);
+    }
+    get value() {
+        return this.current;
+    }
+    /** Set (clamped); returns true when the value actually changed. */
+    set(value) {
+        const next = this.clamp(value);
+        if (next === this.current) {
+            return false;
+        }
+        this.current = next;
+        return true;
+    }
+    increment() {
+        return this.set(this.current + this.step);
+    }
+    decrement() {
+        return this.set(this.current - this.step);
+    }
+    get canIncrement() {
+        return this.current < this.max;
+    }
+    get canDecrement() {
+        return this.current > this.min;
+    }
+    clamp(value) {
+        return Math.min(this.max, Math.max(this.min, value));
+    }
+}
+//# sourceMappingURL=stepper-model.js.map

package/dist/core/stepper-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper-model.js","sourceRoot":"","sources":["../../src/core/stepper-model.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,YAAY;IACd,GAAG,CAAS;IACZ,GAAG,CAAS;IACZ,IAAI,CAAS;IACd,OAAO,CAAS;IAExB,YAAY,UAA0B,EAAE;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,GAAG,YAAY,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,GAAG,CAAC,KAAa;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;CACF","sourcesContent":["/**\n * Stepper model - pure numeric state for the `data-uix=\"stepper\"` control.\n */\nexport interface StepperOptions {\n  min?: number;\n  max?: number;\n  step?: number;\n  value?: number;\n}\n\nexport class StepperModel {\n  readonly min: number;\n  readonly max: number;\n  readonly step: number;\n  private current: number;\n\n  constructor(options: StepperOptions = {}) {\n    this.min = options.min ?? 0;\n    this.max = options.max ?? 10;\n    this.step = options.step ?? 1;\n    if (this.max < this.min) {\n      throw new Error(`[uix] stepper max (${this.max}) < min (${this.min})`);\n    }\n    if (!(this.step > 0)) {\n      throw new Error(`[uix] stepper step must be > 0 (got ${this.step})`);\n    }\n    this.current = this.clamp(options.value ?? this.min);\n  }\n\n  get value(): number {\n    return this.current;\n  }\n\n  /** Set (clamped); returns true when the value actually changed. */\n  set(value: number): boolean {\n    const next = this.clamp(value);\n    if (next === this.current) {\n      return false;\n    }\n    this.current = next;\n    return true;\n  }\n\n  increment(): boolean {\n    return this.set(this.current + this.step);\n  }\n\n  decrement(): boolean {\n    return this.set(this.current - this.step);\n  }\n\n  get canIncrement(): boolean {\n    return this.current < this.max;\n  }\n\n  get canDecrement(): boolean {\n    return this.current > this.min;\n  }\n\n  private clamp(value: number): number {\n    return Math.min(this.max, Math.max(this.min, value));\n  }\n}\n"]}

package/dist/core/toggle-model.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Toggle model - pure boolean state for the `data-uix="toggle"` control.
+ */
+export declare class ToggleModel {
+    private state;
+    constructor(initial?: boolean);
+    get value(): boolean;
+    /** Set the state; returns true when it actually changed. */
+    set(value: boolean): boolean;
+    toggle(): boolean;
+}

package/dist/core/toggle-model.js

@@ -0,0 +1,25 @@
+/**
+ * Toggle model - pure boolean state for the `data-uix="toggle"` control.
+ */
+export class ToggleModel {
+    state;
+    constructor(initial = false) {
+        this.state = initial;
+    }
+    get value() {
+        return this.state;
+    }
+    /** Set the state; returns true when it actually changed. */
+    set(value) {
+        if (value === this.state) {
+            return false;
+        }
+        this.state = value;
+        return true;
+    }
+    toggle() {
+        this.state = !this.state;
+        return this.state;
+    }
+}
+//# sourceMappingURL=toggle-model.js.map

package/dist/core/toggle-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-model.js","sourceRoot":"","sources":["../../src/core/toggle-model.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,KAAK,CAAU;IAEvB,YAAY,OAAO,GAAG,KAAK;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,4DAA4D;IAC5D,GAAG,CAAC,KAAc;QAChB,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF","sourcesContent":["/**\n * Toggle model - pure boolean state for the `data-uix=\"toggle\"` control.\n */\nexport class ToggleModel {\n  private state: boolean;\n\n  constructor(initial = false) {\n    this.state = initial;\n  }\n\n  get value(): boolean {\n    return this.state;\n  }\n\n  /** Set the state; returns true when it actually changed. */\n  set(value: boolean): boolean {\n    if (value === this.state) {\n      return false;\n    }\n    this.state = value;\n    return true;\n  }\n\n  toggle(): boolean {\n    this.state = !this.state;\n    return this.state;\n  }\n}\n"]}

package/dist/core/window-manager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * WindowManager - pure window registry, focus ordering and minimize state.
+ *
+ * The manager knows nothing about entities, three.js or uikit. It deals in
+ * opaque window ids and answers two questions the ECS layer applies each
+ * frame:
+ *
+ * 1. What is the focus (z) order? (`orderOf` → depth bias so the focused
+ *    window renders nearest the user and receives pointer priority)
+ * 2. What state is a window in? (minimized / focused / dock mode)
+ */
+import { Emitter } from './events.js';
+import { DockModeValue } from './dock-state.js';
+export interface WindowRecord {
+    id: string;
+    title: string;
+    dockMode: DockModeValue;
+    minimized: boolean;
+    /** True while the user is actively dragging the window by its title bar. */
+    dragging: boolean;
+}
+export interface WindowManagerEvents extends Record<string, unknown> {
+    opened: WindowRecord;
+    closed: WindowRecord;
+    focused: WindowRecord;
+    minimized: WindowRecord;
+    restored: WindowRecord;
+    dockChanged: {
+        window: WindowRecord;
+        previous: DockModeValue;
+    };
+    dragStarted: WindowRecord;
+    dragEnded: WindowRecord;
+}
+export interface OpenWindowOptions {
+    title?: string;
+    dockMode?: DockModeValue;
+}
+/**
+ * What the pin affordance should read for a window's current state:
+ * - dragging            → "PIN"   (the window is loose in your hand)
+ * - placed/world-locked → "UNPIN" (click releases it to follow)
+ * - following           → "PIN"   (click pins it where it is)
+ */
+export declare function pinLabelFor(record: Pick<WindowRecord, 'dockMode' | 'dragging'>): 'PIN' | 'UNPIN';
+/**
+ * What the minimize affordance should read for a window's current state -
+ * the label always names what the NEXT click does, matching `pinLabelFor`:
+ * - open      → "MIN" (click collapses the content)
+ * - minimized → "MAX" (click restores it)
+ */
+export declare function minimizeLabelFor(record: Pick<WindowRecord, 'minimized'>): 'MIN' | 'MAX';
+export declare class WindowManager {
+    readonly events: Emitter<WindowManagerEvents>;
+    private windows;
+    /** Most-recently-focused last (top of the stack). */
+    private focusStack;
+    open(id: string, options?: OpenWindowOptions): WindowRecord;
+    close(id: string): void;
+    focus(id: string): void;
+    minimize(id: string): void;
+    restore(id: string): void;
+    toggleMinimized(id: string): void;
+    setDockMode(id: string, mode: DockModeValue): void;
+    /** Track an active title-bar drag; emits dragStarted/dragEnded on change. */
+    setDragging(id: string, dragging: boolean): void;
+    /** Title-bar pin button behaviour: place in space ↔ follow the player. */
+    togglePin(id: string): DockModeValue;
+    get(id: string): WindowRecord | undefined;
+    has(id: string): boolean;
+    get focused(): WindowRecord | undefined;
+    /**
+     * Focus depth of a window: 0 = focused (topmost), 1 = next, and so on.
+     * The ECS layer converts this into a small z bias toward the viewer so
+     * overlapping panels resolve in focus order.
+     */
+    orderOf(id: string): number;
+    get count(): number;
+    list(): WindowRecord[];
+    private require;
+}

package/dist/core/window-manager.js

@@ -0,0 +1,172 @@
+/**
+ * WindowManager - pure window registry, focus ordering and minimize state.
+ *
+ * The manager knows nothing about entities, three.js or uikit. It deals in
+ * opaque window ids and answers two questions the ECS layer applies each
+ * frame:
+ *
+ * 1. What is the focus (z) order? (`orderOf` → depth bias so the focused
+ *    window renders nearest the user and receives pointer priority)
+ * 2. What state is a window in? (minimized / focused / dock mode)
+ */
+import { Emitter } from './events.js';
+import { DockMode, isDockMode, togglePinned } from './dock-state.js';
+/**
+ * What the pin affordance should read for a window's current state:
+ * - dragging            → "PIN"   (the window is loose in your hand)
+ * - placed/world-locked → "UNPIN" (click releases it to follow)
+ * - following           → "PIN"   (click pins it where it is)
+ */
+export function pinLabelFor(record) {
+    if (record.dragging) {
+        return 'PIN';
+    }
+    return record.dockMode === DockMode.WorldLocked ? 'UNPIN' : 'PIN';
+}
+/**
+ * What the minimize affordance should read for a window's current state -
+ * the label always names what the NEXT click does, matching `pinLabelFor`:
+ * - open      → "MIN" (click collapses the content)
+ * - minimized → "MAX" (click restores it)
+ */
+export function minimizeLabelFor(record) {
+    return record.minimized ? 'MAX' : 'MIN';
+}
+export class WindowManager {
+    events = new Emitter();
+    windows = new Map();
+    /** Most-recently-focused last (top of the stack). */
+    focusStack = [];
+    open(id, options = {}) {
+        if (this.windows.has(id)) {
+            throw new Error(`[uix] window "${id}" is already open`);
+        }
+        const dockMode = options.dockMode ?? DockMode.WorldLocked;
+        if (!isDockMode(dockMode)) {
+            throw new Error(`[uix] "${String(dockMode)}" is not a dock mode`);
+        }
+        const record = {
+            id,
+            title: options.title ?? id,
+            dockMode,
+            minimized: false,
+            dragging: false,
+        };
+        this.windows.set(id, record);
+        this.focusStack.push(id);
+        this.events.emit('opened', record);
+        this.events.emit('focused', record);
+        return record;
+    }
+    close(id) {
+        const record = this.require(id);
+        this.windows.delete(id);
+        this.focusStack = this.focusStack.filter((w) => w !== id);
+        this.events.emit('closed', record);
+        const top = this.focused;
+        if (top) {
+            this.events.emit('focused', top);
+        }
+    }
+    focus(id) {
+        const record = this.require(id);
+        const top = this.focusStack[this.focusStack.length - 1];
+        if (top === id) {
+            return;
+        }
+        this.focusStack = this.focusStack.filter((w) => w !== id);
+        this.focusStack.push(id);
+        this.events.emit('focused', record);
+    }
+    minimize(id) {
+        const record = this.require(id);
+        if (record.minimized) {
+            return;
+        }
+        record.minimized = true;
+        this.events.emit('minimized', record);
+    }
+    restore(id) {
+        const record = this.require(id);
+        if (!record.minimized) {
+            return;
+        }
+        record.minimized = false;
+        this.events.emit('restored', record);
+        this.focus(id);
+    }
+    toggleMinimized(id) {
+        if (this.require(id).minimized) {
+            this.restore(id);
+        }
+        else {
+            this.minimize(id);
+        }
+    }
+    setDockMode(id, mode) {
+        if (!isDockMode(mode)) {
+            throw new Error(`[uix] "${String(mode)}" is not a dock mode`);
+        }
+        const record = this.require(id);
+        if (record.dockMode === mode) {
+            return;
+        }
+        const previous = record.dockMode;
+        record.dockMode = mode;
+        this.events.emit('dockChanged', { window: record, previous });
+    }
+    /** Track an active title-bar drag; emits dragStarted/dragEnded on change. */
+    setDragging(id, dragging) {
+        const record = this.require(id);
+        if (record.dragging === dragging) {
+            return;
+        }
+        record.dragging = dragging;
+        this.events.emit(dragging ? 'dragStarted' : 'dragEnded', record);
+    }
+    /** Title-bar pin button behaviour: place in space ↔ follow the player. */
+    togglePin(id) {
+        const next = togglePinned(this.require(id).dockMode);
+        this.setDockMode(id, next);
+        return next;
+    }
+    get(id) {
+        return this.windows.get(id);
+    }
+    has(id) {
+        return this.windows.has(id);
+    }
+    get focused() {
+        const top = this.focusStack[this.focusStack.length - 1];
+        return top === undefined ? undefined : this.windows.get(top);
+    }
+    /**
+     * Focus depth of a window: 0 = focused (topmost), 1 = next, and so on.
+     * The ECS layer converts this into a small z bias toward the viewer so
+     * overlapping panels resolve in focus order.
+     */
+    orderOf(id) {
+        this.require(id);
+        // focusStack is bottom→top; depth counts down from the top.
+        const index = this.focusStack.lastIndexOf(id);
+        return this.focusStack.length - 1 - index;
+    }
+    get count() {
+        return this.windows.size;
+    }
+    list() {
+        // Top-of-stack first - the natural order for "window list" UIs.
+        return [...this.focusStack]
+            .reverse()
+            .map((id) => this.windows.get(id))
+            .filter((record) => record !== undefined);
+    }
+    require(id) {
+        const record = this.windows.get(id);
+        if (!record) {
+            throw new Error(`[uix] unknown window "${id}"`);
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=window-manager.js.map

package/dist/core/window-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-manager.js","sourceRoot":"","sources":["../../src/core/window-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WindowManager - pure window registry, focus ordering and minimize state.\n *\n * The manager knows nothing about entities, three.js or uikit. It deals in\n * opaque window ids and answers two questions the ECS layer applies each\n * frame:\n *\n * 1. What is the focus (z) order? (`orderOf` → depth bias so the focused\n *    window renders nearest the user and receives pointer priority)\n * 2. What state is a window in? (minimized / focused / dock mode)\n */\nimport { Emitter } from './events.js';\nimport { DockMode, DockModeValue, isDockMode, togglePinned } from './dock-state.js';\n\nexport interface WindowRecord {\n  id: string;\n  title: string;\n  dockMode: DockModeValue;\n  minimized: boolean;\n  /** True while the user is actively dragging the window by its title bar. */\n  dragging: boolean;\n}\n\nexport interface WindowManagerEvents extends Record<string, unknown> {\n  opened: WindowRecord;\n  closed: WindowRecord;\n  focused: WindowRecord;\n  minimized: WindowRecord;\n  restored: WindowRecord;\n  dockChanged: { window: WindowRecord; previous: DockModeValue };\n  dragStarted: WindowRecord;\n  dragEnded: WindowRecord;\n}\n\nexport interface OpenWindowOptions {\n  title?: string;\n  dockMode?: DockModeValue;\n}\n\n/**\n * What the pin affordance should read for a window's current state:\n * - dragging            → \"PIN\"   (the window is loose in your hand)\n * - placed/world-locked → \"UNPIN\" (click releases it to follow)\n * - following           → \"PIN\"   (click pins it where it is)\n */\nexport function pinLabelFor(record: Pick<WindowRecord, 'dockMode' | 'dragging'>): 'PIN' | 'UNPIN' {\n  if (record.dragging) {\n    return 'PIN';\n  }\n  return record.dockMode === DockMode.WorldLocked ? 'UNPIN' : 'PIN';\n}\n\n/**\n * What the minimize affordance should read for a window's current state -\n * the label always names what the NEXT click does, matching `pinLabelFor`:\n * - open      → \"MIN\" (click collapses the content)\n * - minimized → \"MAX\" (click restores it)\n */\nexport function minimizeLabelFor(record: Pick<WindowRecord, 'minimized'>): 'MIN' | 'MAX' {\n  return record.minimized ? 'MAX' : 'MIN';\n}\n\nexport class WindowManager {\n  readonly events = new Emitter<WindowManagerEvents>();\n\n  private windows = new Map<string, WindowRecord>();\n  /** Most-recently-focused last (top of the stack). */\n  private focusStack: string[] = [];\n\n  open(id: string, options: OpenWindowOptions = {}): WindowRecord {\n    if (this.windows.has(id)) {\n      throw new Error(`[uix] window \"${id}\" is already open`);\n    }\n    const dockMode = options.dockMode ?? DockMode.WorldLocked;\n    if (!isDockMode(dockMode)) {\n      throw new Error(`[uix] \"${String(dockMode)}\" is not a dock mode`);\n    }\n    const record: WindowRecord = {\n      id,\n      title: options.title ?? id,\n      dockMode,\n      minimized: false,\n      dragging: false,\n    };\n    this.windows.set(id, record);\n    this.focusStack.push(id);\n    this.events.emit('opened', record);\n    this.events.emit('focused', record);\n    return record;\n  }\n\n  close(id: string): void {\n    const record = this.require(id);\n    this.windows.delete(id);\n    this.focusStack = this.focusStack.filter((w) => w !== id);\n    this.events.emit('closed', record);\n    const top = this.focused;\n    if (top) {\n      this.events.emit('focused', top);\n    }\n  }\n\n  focus(id: string): void {\n    const record = this.require(id);\n    const top = this.focusStack[this.focusStack.length - 1];\n    if (top === id) {\n      return;\n    }\n    this.focusStack = this.focusStack.filter((w) => w !== id);\n    this.focusStack.push(id);\n    this.events.emit('focused', record);\n  }\n\n  minimize(id: string): void {\n    const record = this.require(id);\n    if (record.minimized) {\n      return;\n    }\n    record.minimized = true;\n    this.events.emit('minimized', record);\n  }\n\n  restore(id: string): void {\n    const record = this.require(id);\n    if (!record.minimized) {\n      return;\n    }\n    record.minimized = false;\n    this.events.emit('restored', record);\n    this.focus(id);\n  }\n\n  toggleMinimized(id: string): void {\n    if (this.require(id).minimized) {\n      this.restore(id);\n    } else {\n      this.minimize(id);\n    }\n  }\n\n  setDockMode(id: string, mode: DockModeValue): void {\n    if (!isDockMode(mode)) {\n      throw new Error(`[uix] \"${String(mode)}\" is not a dock mode`);\n    }\n    const record = this.require(id);\n    if (record.dockMode === mode) {\n      return;\n    }\n    const previous = record.dockMode;\n    record.dockMode = mode;\n    this.events.emit('dockChanged', { window: record, previous });\n  }\n\n  /** Track an active title-bar drag; emits dragStarted/dragEnded on change. */\n  setDragging(id: string, dragging: boolean): void {\n    const record = this.require(id);\n    if (record.dragging === dragging) {\n      return;\n    }\n    record.dragging = dragging;\n    this.events.emit(dragging ? 'dragStarted' : 'dragEnded', record);\n  }\n\n  /** Title-bar pin button behaviour: place in space ↔ follow the player. */\n  togglePin(id: string): DockModeValue {\n    const next = togglePinned(this.require(id).dockMode);\n    this.setDockMode(id, next);\n    return next;\n  }\n\n  get(id: string): WindowRecord | undefined {\n    return this.windows.get(id);\n  }\n\n  has(id: string): boolean {\n    return this.windows.has(id);\n  }\n\n  get focused(): WindowRecord | undefined {\n    const top = this.focusStack[this.focusStack.length - 1];\n    return top === undefined ? undefined : this.windows.get(top);\n  }\n\n  /**\n   * Focus depth of a window: 0 = focused (topmost), 1 = next, and so on.\n   * The ECS layer converts this into a small z bias toward the viewer so\n   * overlapping panels resolve in focus order.\n   */\n  orderOf(id: string): number {\n    this.require(id);\n    // focusStack is bottom→top; depth counts down from the top.\n    const index = this.focusStack.lastIndexOf(id);\n    return this.focusStack.length - 1 - index;\n  }\n\n  get count(): number {\n    return this.windows.size;\n  }\n\n  list(): WindowRecord[] {\n    // Top-of-stack first - the natural order for \"window list\" UIs.\n    return [...this.focusStack]\n      .reverse()\n      .map((id) => this.windows.get(id))\n      .filter((record): record is WindowRecord => record !== undefined);\n  }\n\n  private require(id: string): WindowRecord {\n    const record = this.windows.get(id);\n    if (!record) {\n      throw new Error(`[uix] unknown window \"${id}\"`);\n    }\n    return record;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @realitycollective/webxr-uiextensions - the engine-free core.
+ *
+ * Everything exported here is pure TypeScript with no engine imports
+ * (enforced by test/architecture.test.ts): window/dock/region/drag logic,
+ * control models, the `data-uix` markup upgraders, the window chrome
+ * conventions, and the platform-adapter interfaces engine packages
+ * implement.
+ */
+export * from './core/events.js';
+export * from './core/dock-state.js';
+export * from './core/window-manager.js';
+export * from './core/region-layout.js';
+export * from './core/region-registry.js';
+export * from './core/drag-math.js';
+export * from './core/hold-to-drag.js';
+export * from './core/stepper-model.js';
+export * from './core/toggle-model.js';
+export * from './core/expandable-model.js';
+export * from './core/log-model.js';
+export * from './chrome/markup.js';
+export * from './controls/element.js';
+export * from './controls/stepper.js';
+export * from './controls/toggle.js';
+export * from './controls/expandable-label.js';
+export * from './controls/log-view.js';
+export * from './controls/upgrade.js';
+export * from './adapter.js';
+export * from './scene.js';

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @realitycollective/webxr-uiextensions - the engine-free core.
+ *
+ * Everything exported here is pure TypeScript with no engine imports
+ * (enforced by test/architecture.test.ts): window/dock/region/drag logic,
+ * control models, the `data-uix` markup upgraders, the window chrome
+ * conventions, and the platform-adapter interfaces engine packages
+ * implement.
+ */
+// Pure logic
+export * from './core/events.js';
+export * from './core/dock-state.js';
+export * from './core/window-manager.js';
+export * from './core/region-layout.js';
+export * from './core/region-registry.js';
+export * from './core/drag-math.js';
+export * from './core/hold-to-drag.js';
+export * from './core/stepper-model.js';
+export * from './core/toggle-model.js';
+export * from './core/expandable-model.js';
+export * from './core/log-model.js';
+// Chrome conventions (markup ids + reference snippet)
+export * from './chrome/markup.js';
+// Interface-driven control upgraders
+export * from './controls/element.js';
+export * from './controls/stepper.js';
+export * from './controls/toggle.js';
+export * from './controls/expandable-label.js';
+export * from './controls/log-view.js';
+export * from './controls/upgrade.js';
+// Platform-adapter contract + portable scene descriptors
+export * from './adapter.js';
+export * from './scene.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,aAAa;AACb,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AAEpC,sDAAsD;AACtD,cAAc,oBAAoB,CAAC;AAEnC,qCAAqC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,yDAAyD;AACzD,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC","sourcesContent":["/**\n * @realitycollective/webxr-uiextensions - the engine-free core.\n *\n * Everything exported here is pure TypeScript with no engine imports\n * (enforced by test/architecture.test.ts): window/dock/region/drag logic,\n * control models, the `data-uix` markup upgraders, the window chrome\n * conventions, and the platform-adapter interfaces engine packages\n * implement.\n */\n// Pure logic\nexport * from './core/events.js';\nexport * from './core/dock-state.js';\nexport * from './core/window-manager.js';\nexport * from './core/region-layout.js';\nexport * from './core/region-registry.js';\nexport * from './core/drag-math.js';\nexport * from './core/hold-to-drag.js';\nexport * from './core/stepper-model.js';\nexport * from './core/toggle-model.js';\nexport * from './core/expandable-model.js';\nexport * from './core/log-model.js';\n\n// Chrome conventions (markup ids + reference snippet)\nexport * from './chrome/markup.js';\n\n// Interface-driven control upgraders\nexport * from './controls/element.js';\nexport * from './controls/stepper.js';\nexport * from './controls/toggle.js';\nexport * from './controls/expandable-label.js';\nexport * from './controls/log-view.js';\nexport * from './controls/upgrade.js';\n\n// Platform-adapter contract + portable scene descriptors\nexport * from './adapter.js';\nexport * from './scene.js';\n"]}

package/dist/scene.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Portable scene descriptors.
+ *
+ * A scene is plain DATA - which windows exist, where they sit, which dock
+ * regions they can drop into - with no engine types anywhere. Each adapter
+ * knows how to apply the same descriptor through its own factories, so one
+ * playground definition drives IWSDK, XR Blocks and plain three.js alike:
+ *
+ *   applyScene(iwsdkTarget, PLAYGROUND);   // ECS entities
+ *   applyScene(vanillaHost, PLAYGROUND);   // three.js groups
+ *
+ * Panel config paths stay strings (`./ui/foo.json`) because every adapter
+ * resolves them the same way - IWSDK fetches them itself, the vanilla host
+ * is handed the parsed JSON by `applyScene`'s loader.
+ */
+import type { DockModeValue } from './core/dock-state.js';
+import type { RegionFlow, Vec3 } from './core/region-layout.js';
+/** One window in a scene. */
+export interface SceneWindow {
+    id: string;
+    title: string;
+    /** Path to the compiled UIKitML JSON, e.g. `./ui/clicker.json`. */
+    config: string;
+    /** World position for world-locked windows. */
+    position?: Vec3;
+    maxWidth?: number;
+    maxHeight?: number;
+    dockMode?: DockModeValue;
+    /** Dock straight into this region on spawn. */
+    region?: string;
+    followOffset?: Vec3;
+    followSpeed?: number;
+    followTolerance?: number;
+    movable?: boolean;
+    closable?: boolean;
+    minimizable?: boolean;
+    pinnable?: boolean;
+}
+/** One dock region in a scene. */
+export interface SceneRegion {
+    id: string;
+    flow?: RegionFlow;
+    pitch?: number;
+    columns?: number;
+    capacity?: number;
+    snapRadius?: number;
+    position?: Vec3;
+    /** Body-lock the region so it follows the viewer. */
+    follow?: boolean;
+    followOffset?: Vec3;
+}
+/** A complete, engine-free scene definition. */
+export interface SceneDescriptor {
+    name?: string;
+    regions?: readonly SceneRegion[];
+    windows: readonly SceneWindow[];
+}
+/**
+ * What an adapter must provide for {@link applyScene} to build a scene.
+ * Both shipped adapters implement this; a new adapter only needs these two
+ * methods to gain full scene portability.
+ */
+export interface SceneTarget {
+    spawnRegion(region: SceneRegion): void;
+    spawnWindow(window: SceneWindow): void;
+}
+/**
+ * Apply a descriptor to an adapter. Regions are created before windows so a
+ * window that spawns docked (`region: 'x'`) always finds its region.
+ */
+export declare function applyScene(target: SceneTarget, scene: SceneDescriptor): void;
+/** Every distinct panel config path in a scene (for preloading). */
+export declare function sceneConfigPaths(scene: SceneDescriptor): string[];
+/**
+ * Validate a descriptor: unique window/region ids, and every `region`
+ * reference resolvable. Returns the problems found (empty = valid) rather
+ * than throwing, so callers can report them all at once.
+ */
+export declare function validateScene(scene: SceneDescriptor): string[];

package/dist/scene.js

@@ -0,0 +1,43 @@
+/**
+ * Apply a descriptor to an adapter. Regions are created before windows so a
+ * window that spawns docked (`region: 'x'`) always finds its region.
+ */
+export function applyScene(target, scene) {
+    for (const region of scene.regions ?? []) {
+        target.spawnRegion(region);
+    }
+    for (const window of scene.windows) {
+        target.spawnWindow(window);
+    }
+}
+/** Every distinct panel config path in a scene (for preloading). */
+export function sceneConfigPaths(scene) {
+    return [...new Set(scene.windows.map((window) => window.config))];
+}
+/**
+ * Validate a descriptor: unique window/region ids, and every `region`
+ * reference resolvable. Returns the problems found (empty = valid) rather
+ * than throwing, so callers can report them all at once.
+ */
+export function validateScene(scene) {
+    const problems = [];
+    const regionIds = new Set();
+    for (const region of scene.regions ?? []) {
+        if (regionIds.has(region.id)) {
+            problems.push(`duplicate region id "${region.id}"`);
+        }
+        regionIds.add(region.id);
+    }
+    const windowIds = new Set();
+    for (const window of scene.windows) {
+        if (windowIds.has(window.id)) {
+            problems.push(`duplicate window id "${window.id}"`);
+        }
+        windowIds.add(window.id);
+        if (window.region !== undefined && !regionIds.has(window.region)) {
+            problems.push(`window "${window.id}" docks into unknown region "${window.region}"`);
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAuEA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,KAAsB;IACpE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,IAAI,CACX,WAAW,MAAM,CAAC,EAAE,gCAAgC,MAAM,CAAC,MAAM,GAAG,CACrE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Portable scene descriptors.\n *\n * A scene is plain DATA - which windows exist, where they sit, which dock\n * regions they can drop into - with no engine types anywhere. Each adapter\n * knows how to apply the same descriptor through its own factories, so one\n * playground definition drives IWSDK, XR Blocks and plain three.js alike:\n *\n *   applyScene(iwsdkTarget, PLAYGROUND);   // ECS entities\n *   applyScene(vanillaHost, PLAYGROUND);   // three.js groups\n *\n * Panel config paths stay strings (`./ui/foo.json`) because every adapter\n * resolves them the same way - IWSDK fetches them itself, the vanilla host\n * is handed the parsed JSON by `applyScene`'s loader.\n */\nimport type { DockModeValue } from './core/dock-state.js';\nimport type { RegionFlow, Vec3 } from './core/region-layout.js';\n\n/** One window in a scene. */\nexport interface SceneWindow {\n  id: string;\n  title: string;\n  /** Path to the compiled UIKitML JSON, e.g. `./ui/clicker.json`. */\n  config: string;\n  /** World position for world-locked windows. */\n  position?: Vec3;\n  maxWidth?: number;\n  maxHeight?: number;\n  dockMode?: DockModeValue;\n  /** Dock straight into this region on spawn. */\n  region?: string;\n  followOffset?: Vec3;\n  followSpeed?: number;\n  followTolerance?: number;\n  movable?: boolean;\n  closable?: boolean;\n  minimizable?: boolean;\n  pinnable?: boolean;\n}\n\n/** One dock region in a scene. */\nexport interface SceneRegion {\n  id: string;\n  flow?: RegionFlow;\n  pitch?: number;\n  columns?: number;\n  capacity?: number;\n  snapRadius?: number;\n  position?: Vec3;\n  /** Body-lock the region so it follows the viewer. */\n  follow?: boolean;\n  followOffset?: Vec3;\n}\n\n/** A complete, engine-free scene definition. */\nexport interface SceneDescriptor {\n  name?: string;\n  regions?: readonly SceneRegion[];\n  windows: readonly SceneWindow[];\n}\n\n/**\n * What an adapter must provide for {@link applyScene} to build a scene.\n * Both shipped adapters implement this; a new adapter only needs these two\n * methods to gain full scene portability.\n */\nexport interface SceneTarget {\n  spawnRegion(region: SceneRegion): void;\n  spawnWindow(window: SceneWindow): void;\n}\n\n/**\n * Apply a descriptor to an adapter. Regions are created before windows so a\n * window that spawns docked (`region: 'x'`) always finds its region.\n */\nexport function applyScene(target: SceneTarget, scene: SceneDescriptor): void {\n  for (const region of scene.regions ?? []) {\n    target.spawnRegion(region);\n  }\n  for (const window of scene.windows) {\n    target.spawnWindow(window);\n  }\n}\n\n/** Every distinct panel config path in a scene (for preloading). */\nexport function sceneConfigPaths(scene: SceneDescriptor): string[] {\n  return [...new Set(scene.windows.map((window) => window.config))];\n}\n\n/**\n * Validate a descriptor: unique window/region ids, and every `region`\n * reference resolvable. Returns the problems found (empty = valid) rather\n * than throwing, so callers can report them all at once.\n */\nexport function validateScene(scene: SceneDescriptor): string[] {\n  const problems: string[] = [];\n  const regionIds = new Set<string>();\n  for (const region of scene.regions ?? []) {\n    if (regionIds.has(region.id)) {\n      problems.push(`duplicate region id \"${region.id}\"`);\n    }\n    regionIds.add(region.id);\n  }\n  const windowIds = new Set<string>();\n  for (const window of scene.windows) {\n    if (windowIds.has(window.id)) {\n      problems.push(`duplicate window id \"${window.id}\"`);\n    }\n    windowIds.add(window.id);\n    if (window.region !== undefined && !regionIds.has(window.region)) {\n      problems.push(\n        `window \"${window.id}\" docks into unknown region \"${window.region}\"`,\n      );\n    }\n  }\n  return problems;\n}\n"]}