@realitycollective/webxr-uiextensions 0.1.0-preview.0

package/dist/core/events.js

@@ -0,0 +1,40 @@
+export class Emitter {
+    listeners = new Map();
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    once(event, listener) {
+        const dispose = this.on(event, (payload) => {
+            dispose();
+            listener(payload);
+        });
+        return dispose;
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+    }
+    emit(event, payload) {
+        // Copy before iterating so listeners can unsubscribe (or subscribe) safely
+        // from inside a handler without corrupting the iteration.
+        const set = this.listeners.get(event);
+        if (!set) {
+            return;
+        }
+        for (const listener of [...set]) {
+            listener(payload);
+        }
+    }
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+    clear() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/core/events.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,OAAO;IACV,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEnE,EAAE,CAA0B,KAAQ,EAAE,QAA8B;QAClE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAA0B,KAAQ,EAAE,QAA8B;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACzC,OAAO,EAAE,CAAC;YACV,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAA0B,KAAQ,EAAE,QAA8B;QACnE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAA0B,KAAQ,EAAE,OAAmB;QACzD,2EAA2E;QAC3E,0DAA0D;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/B,QAAiC,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,aAAa,CAA0B,KAAQ;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["/**\n * Minimal typed event emitter.\n *\n * The library keeps its observable surface deliberately tiny - consumers that\n * want richer eventing can bridge these into their own bus (for example the\n * Reality Collective service framework's IEventService).\n */\nexport type Listener<T> = (payload: T) => void;\n\nexport class Emitter<TEvents extends Record<string, unknown>> {\n  private listeners = new Map<keyof TEvents, Set<Listener<never>>>();\n\n  on<K extends keyof TEvents>(event: K, listener: Listener<TEvents[K]>): () => void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(listener as Listener<never>);\n    return () => this.off(event, listener);\n  }\n\n  once<K extends keyof TEvents>(event: K, listener: Listener<TEvents[K]>): () => void {\n    const dispose = this.on(event, (payload) => {\n      dispose();\n      listener(payload);\n    });\n    return dispose;\n  }\n\n  off<K extends keyof TEvents>(event: K, listener: Listener<TEvents[K]>): void {\n    this.listeners.get(event)?.delete(listener as Listener<never>);\n  }\n\n  emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void {\n    // Copy before iterating so listeners can unsubscribe (or subscribe) safely\n    // from inside a handler without corrupting the iteration.\n    const set = this.listeners.get(event);\n    if (!set) {\n      return;\n    }\n    for (const listener of [...set]) {\n      (listener as Listener<TEvents[K]>)(payload);\n    }\n  }\n\n  listenerCount<K extends keyof TEvents>(event: K): number {\n    return this.listeners.get(event)?.size ?? 0;\n  }\n\n  clear(): void {\n    this.listeners.clear();\n  }\n}\n"]}

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

@@ -0,0 +1,35 @@
+/**
+ * Expandable label model - pure truncation/expansion state for the
+ * `data-uix="expandable-label"` control (a multi-line label that collapses to
+ * a preview with an ellipsis and a "more/less" affordance).
+ *
+ * Truncation is character-budget based (lines × charsPerLine) rather than
+ * pixel based: uikit lays text out with MSDF glyphs at panel resolution, so
+ * an exact pixel measure would need the live renderer. A stable budget keeps
+ * the control deterministic and testable; authors tune `charsPerLine` to
+ * their font size.
+ */
+export interface ExpandableOptions {
+    text?: string;
+    collapsedLines?: number;
+    charsPerLine?: number;
+}
+export declare const ELLIPSIS = "...";
+export declare class ExpandableModel {
+    readonly collapsedLines: number;
+    readonly charsPerLine: number;
+    private fullText;
+    private isExpanded;
+    constructor(options?: ExpandableOptions);
+    get text(): string;
+    setText(text: string): void;
+    get expanded(): boolean;
+    toggle(): boolean;
+    /** True when the text overflows the collapsed budget (i.e. a toggle is useful). */
+    get overflows(): boolean;
+    /** The string the label should currently display. */
+    get displayText(): string;
+    /** Label for the expand/collapse affordance. */
+    get toggleLabel(): string;
+    private get budget();
+}

package/dist/core/expandable-model.js

@@ -0,0 +1,57 @@
+// Three ASCII dots, not U+2026: MSDF font atlases routinely lack the
+// ellipsis glyph and render a tofu box instead.
+export const ELLIPSIS = '...';
+export class ExpandableModel {
+    collapsedLines;
+    charsPerLine;
+    fullText;
+    isExpanded = false;
+    constructor(options = {}) {
+        this.collapsedLines = options.collapsedLines ?? 2;
+        this.charsPerLine = options.charsPerLine ?? 42;
+        if (this.collapsedLines < 1) {
+            throw new Error(`[uix] collapsedLines must be >= 1 (got ${this.collapsedLines})`);
+        }
+        if (this.charsPerLine < 4) {
+            throw new Error(`[uix] charsPerLine must be >= 4 (got ${this.charsPerLine})`);
+        }
+        this.fullText = options.text ?? '';
+    }
+    get text() {
+        return this.fullText;
+    }
+    setText(text) {
+        this.fullText = text;
+    }
+    get expanded() {
+        return this.isExpanded;
+    }
+    toggle() {
+        this.isExpanded = !this.isExpanded;
+        return this.isExpanded;
+    }
+    /** True when the text overflows the collapsed budget (i.e. a toggle is useful). */
+    get overflows() {
+        return this.fullText.length > this.budget;
+    }
+    /** The string the label should currently display. */
+    get displayText() {
+        if (this.isExpanded || !this.overflows) {
+            return this.fullText;
+        }
+        // Cut on the last word boundary inside the budget so the preview never
+        // ends mid-word; fall back to a hard cut for a single unbroken token.
+        const slice = this.fullText.slice(0, this.budget - ELLIPSIS.length);
+        const lastSpace = slice.lastIndexOf(' ');
+        const cut = lastSpace > this.budget * 0.5 ? slice.slice(0, lastSpace) : slice;
+        return `${cut.trimEnd()}${ELLIPSIS}`;
+    }
+    /** Label for the expand/collapse affordance. */
+    get toggleLabel() {
+        return this.isExpanded ? 'less' : 'more';
+    }
+    get budget() {
+        return this.collapsedLines * this.charsPerLine;
+    }
+}
+//# sourceMappingURL=expandable-model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expandable-model.js","sourceRoot":"","sources":["../../src/core/expandable-model.ts"],"names":[],"mappings":"AAiBA,qEAAqE;AACrE,gDAAgD;AAChD,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAE9B,MAAM,OAAO,eAAe;IACjB,cAAc,CAAS;IACvB,YAAY,CAAS;IACtB,QAAQ,CAAS;IACjB,UAAU,GAAG,KAAK,CAAC;IAE3B,YAAY,UAA6B,EAAE;QACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,mFAAmF;IACnF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED,qDAAqD;IACrD,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QACD,uEAAuE;QACvE,sEAAsE;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,gDAAgD;IAChD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC;IACjD,CAAC;CACF","sourcesContent":["/**\n * Expandable label model - pure truncation/expansion state for the\n * `data-uix=\"expandable-label\"` control (a multi-line label that collapses to\n * a preview with an ellipsis and a \"more/less\" affordance).\n *\n * Truncation is character-budget based (lines × charsPerLine) rather than\n * pixel based: uikit lays text out with MSDF glyphs at panel resolution, so\n * an exact pixel measure would need the live renderer. A stable budget keeps\n * the control deterministic and testable; authors tune `charsPerLine` to\n * their font size.\n */\nexport interface ExpandableOptions {\n  text?: string;\n  collapsedLines?: number;\n  charsPerLine?: number;\n}\n\n// Three ASCII dots, not U+2026: MSDF font atlases routinely lack the\n// ellipsis glyph and render a tofu box instead.\nexport const ELLIPSIS = '...';\n\nexport class ExpandableModel {\n  readonly collapsedLines: number;\n  readonly charsPerLine: number;\n  private fullText: string;\n  private isExpanded = false;\n\n  constructor(options: ExpandableOptions = {}) {\n    this.collapsedLines = options.collapsedLines ?? 2;\n    this.charsPerLine = options.charsPerLine ?? 42;\n    if (this.collapsedLines < 1) {\n      throw new Error(`[uix] collapsedLines must be >= 1 (got ${this.collapsedLines})`);\n    }\n    if (this.charsPerLine < 4) {\n      throw new Error(`[uix] charsPerLine must be >= 4 (got ${this.charsPerLine})`);\n    }\n    this.fullText = options.text ?? '';\n  }\n\n  get text(): string {\n    return this.fullText;\n  }\n\n  setText(text: string): void {\n    this.fullText = text;\n  }\n\n  get expanded(): boolean {\n    return this.isExpanded;\n  }\n\n  toggle(): boolean {\n    this.isExpanded = !this.isExpanded;\n    return this.isExpanded;\n  }\n\n  /** True when the text overflows the collapsed budget (i.e. a toggle is useful). */\n  get overflows(): boolean {\n    return this.fullText.length > this.budget;\n  }\n\n  /** The string the label should currently display. */\n  get displayText(): string {\n    if (this.isExpanded || !this.overflows) {\n      return this.fullText;\n    }\n    // Cut on the last word boundary inside the budget so the preview never\n    // ends mid-word; fall back to a hard cut for a single unbroken token.\n    const slice = this.fullText.slice(0, this.budget - ELLIPSIS.length);\n    const lastSpace = slice.lastIndexOf(' ');\n    const cut = lastSpace > this.budget * 0.5 ? slice.slice(0, lastSpace) : slice;\n    return `${cut.trimEnd()}${ELLIPSIS}`;\n  }\n\n  /** Label for the expand/collapse affordance. */\n  get toggleLabel(): string {\n    return this.isExpanded ? 'less' : 'more';\n  }\n\n  private get budget(): number {\n    return this.collapsedLines * this.charsPerLine;\n  }\n}\n"]}

package/dist/core/hold-to-drag.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Hold-to-drag threshold - pure timing state for title-bar dragging.
+ *
+ * A press only becomes a drag after being held for `delaySeconds`. Anything
+ * shorter is a click (pin/minimize/close and friends), so buttons on the
+ * drag surface never fight the drag gesture.
+ */
+export type HoldPhase = 'idle' | 'pending' | 'dragging';
+export interface HoldUpdate {
+    phase: HoldPhase;
+    /** True on the exact update where the hold crossed into dragging. */
+    began: boolean;
+    /** True on the exact update where an active drag was released. */
+    ended: boolean;
+}
+export declare class HoldToDrag {
+    readonly delaySeconds: number;
+    private heldFor;
+    private phase;
+    constructor(delaySeconds?: number);
+    get current(): HoldPhase;
+    /** Advance with this frame's held state and delta time (seconds). */
+    update(held: boolean, delta: number): HoldUpdate;
+}

package/dist/core/hold-to-drag.js

@@ -0,0 +1,34 @@
+export class HoldToDrag {
+    delaySeconds;
+    heldFor = 0;
+    phase = 'idle';
+    constructor(delaySeconds = 0.3) {
+        this.delaySeconds = delaySeconds;
+        if (delaySeconds < 0) {
+            throw new Error(`[uix] drag delay must be >= 0 (got ${delaySeconds})`);
+        }
+    }
+    get current() {
+        return this.phase;
+    }
+    /** Advance with this frame's held state and delta time (seconds). */
+    update(held, delta) {
+        if (!held) {
+            const ended = this.phase === 'dragging';
+            this.phase = 'idle';
+            this.heldFor = 0;
+            return { phase: 'idle', began: false, ended };
+        }
+        if (this.phase === 'dragging') {
+            return { phase: 'dragging', began: false, ended: false };
+        }
+        this.heldFor += delta;
+        if (this.heldFor >= this.delaySeconds) {
+            this.phase = 'dragging';
+            return { phase: 'dragging', began: true, ended: false };
+        }
+        this.phase = 'pending';
+        return { phase: 'pending', began: false, ended: false };
+    }
+}
+//# sourceMappingURL=hold-to-drag.js.map

package/dist/core/hold-to-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hold-to-drag.js","sourceRoot":"","sources":["../../src/core/hold-to-drag.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,UAAU;IAIA;IAHb,OAAO,GAAG,CAAC,CAAC;IACZ,KAAK,GAAc,MAAM,CAAC;IAElC,YAAqB,eAAe,GAAG;QAAlB,iBAAY,GAAZ,YAAY,CAAM;QACrC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,YAAY,GAAG,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,IAAa,EAAE,KAAa;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC;YACxC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;CACF","sourcesContent":["/**\n * Hold-to-drag threshold - pure timing state for title-bar dragging.\n *\n * A press only becomes a drag after being held for `delaySeconds`. Anything\n * shorter is a click (pin/minimize/close and friends), so buttons on the\n * drag surface never fight the drag gesture.\n */\nexport type HoldPhase = 'idle' | 'pending' | 'dragging';\n\nexport interface HoldUpdate {\n  phase: HoldPhase;\n  /** True on the exact update where the hold crossed into dragging. */\n  began: boolean;\n  /** True on the exact update where an active drag was released. */\n  ended: boolean;\n}\n\nexport class HoldToDrag {\n  private heldFor = 0;\n  private phase: HoldPhase = 'idle';\n\n  constructor(readonly delaySeconds = 0.3) {\n    if (delaySeconds < 0) {\n      throw new Error(`[uix] drag delay must be >= 0 (got ${delaySeconds})`);\n    }\n  }\n\n  get current(): HoldPhase {\n    return this.phase;\n  }\n\n  /** Advance with this frame's held state and delta time (seconds). */\n  update(held: boolean, delta: number): HoldUpdate {\n    if (!held) {\n      const ended = this.phase === 'dragging';\n      this.phase = 'idle';\n      this.heldFor = 0;\n      return { phase: 'idle', began: false, ended };\n    }\n    if (this.phase === 'dragging') {\n      return { phase: 'dragging', began: false, ended: false };\n    }\n    this.heldFor += delta;\n    if (this.heldFor >= this.delaySeconds) {\n      this.phase = 'dragging';\n      return { phase: 'dragging', began: true, ended: false };\n    }\n    this.phase = 'pending';\n    return { phase: 'pending', began: false, ended: false };\n  }\n}\n"]}

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

@@ -0,0 +1,42 @@
+/**
+ * Log model - pure ring buffer + viewport for the `data-uix="log-view"`
+ * control (scrollable log/list windows).
+ *
+ * UIKitML text nodes are a fixed pool (see "the text rule": dynamic text
+ * needs a placeholder child), so the view renders into a fixed number of
+ * visible rows and the model computes which slice of the buffer those rows
+ * show. `follow` mode pins the viewport to the newest entry, like a console.
+ */
+export interface LogEntry {
+    message: string;
+    /** Optional severity/category tag; the view can color rows by it. */
+    level: string;
+}
+export interface LogModelOptions {
+    /** Maximum retained entries; older entries are dropped. */
+    capacity?: number;
+    /** Number of visible rows in the view. */
+    visibleRows?: number;
+}
+export declare class LogModel {
+    readonly capacity: number;
+    readonly visibleRows: number;
+    private entries;
+    /** Index of the first visible entry when not following. */
+    private scrollTop;
+    private following;
+    constructor(options?: LogModelOptions);
+    get count(): number;
+    get isFollowing(): boolean;
+    push(message: string, level?: string): void;
+    clear(): void;
+    /** Scroll up (towards older entries) by `rows`; disengages follow mode. */
+    scrollUp(rows?: number): void;
+    /** Scroll down; re-engages follow mode when the newest entry comes into view. */
+    scrollDown(rows?: number): void;
+    follow(): void;
+    /** The entries currently in the viewport, oldest first. */
+    visible(): LogEntry[];
+    private maxTop;
+    private effectiveTop;
+}

package/dist/core/log-model.js

@@ -0,0 +1,69 @@
+export class LogModel {
+    capacity;
+    visibleRows;
+    entries = [];
+    /** Index of the first visible entry when not following. */
+    scrollTop = 0;
+    following = true;
+    constructor(options = {}) {
+        this.capacity = options.capacity ?? 200;
+        this.visibleRows = options.visibleRows ?? 8;
+        if (this.capacity < 1) {
+            throw new Error(`[uix] log capacity must be >= 1 (got ${this.capacity})`);
+        }
+        if (this.visibleRows < 1) {
+            throw new Error(`[uix] log visibleRows must be >= 1 (got ${this.visibleRows})`);
+        }
+    }
+    get count() {
+        return this.entries.length;
+    }
+    get isFollowing() {
+        return this.following;
+    }
+    push(message, level = 'info') {
+        this.entries.push({ message, level });
+        const overflow = this.entries.length - this.capacity;
+        if (overflow > 0) {
+            this.entries.splice(0, overflow);
+            this.scrollTop = Math.max(0, this.scrollTop - overflow);
+        }
+    }
+    clear() {
+        this.entries = [];
+        this.scrollTop = 0;
+        this.following = true;
+    }
+    /** Scroll up (towards older entries) by `rows`; disengages follow mode. */
+    scrollUp(rows = 1) {
+        // Seed from the viewport the user is looking at NOW (which, while
+        // following, is the tail) before switching to manual scrolling.
+        const top = this.effectiveTop();
+        this.following = false;
+        this.scrollTop = Math.max(0, top - rows);
+    }
+    /** Scroll down; re-engages follow mode when the newest entry comes into view. */
+    scrollDown(rows = 1) {
+        const max = this.maxTop();
+        const next = Math.min(max, this.effectiveTop() + rows);
+        this.scrollTop = next;
+        if (next >= max) {
+            this.following = true;
+        }
+    }
+    follow() {
+        this.following = true;
+    }
+    /** The entries currently in the viewport, oldest first. */
+    visible() {
+        const top = this.effectiveTop();
+        return this.entries.slice(top, top + this.visibleRows);
+    }
+    maxTop() {
+        return Math.max(0, this.entries.length - this.visibleRows);
+    }
+    effectiveTop() {
+        return this.following ? this.maxTop() : Math.min(this.scrollTop, this.maxTop());
+    }
+}
+//# sourceMappingURL=log-model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log-model.js","sourceRoot":"","sources":["../../src/core/log-model.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Log model - pure ring buffer + viewport for the `data-uix=\"log-view\"`\n * control (scrollable log/list windows).\n *\n * UIKitML text nodes are a fixed pool (see \"the text rule\": dynamic text\n * needs a placeholder child), so the view renders into a fixed number of\n * visible rows and the model computes which slice of the buffer those rows\n * show. `follow` mode pins the viewport to the newest entry, like a console.\n */\nexport interface LogEntry {\n  message: string;\n  /** Optional severity/category tag; the view can color rows by it. */\n  level: string;\n}\n\nexport interface LogModelOptions {\n  /** Maximum retained entries; older entries are dropped. */\n  capacity?: number;\n  /** Number of visible rows in the view. */\n  visibleRows?: number;\n}\n\nexport class LogModel {\n  readonly capacity: number;\n  readonly visibleRows: number;\n  private entries: LogEntry[] = [];\n  /** Index of the first visible entry when not following. */\n  private scrollTop = 0;\n  private following = true;\n\n  constructor(options: LogModelOptions = {}) {\n    this.capacity = options.capacity ?? 200;\n    this.visibleRows = options.visibleRows ?? 8;\n    if (this.capacity < 1) {\n      throw new Error(`[uix] log capacity must be >= 1 (got ${this.capacity})`);\n    }\n    if (this.visibleRows < 1) {\n      throw new Error(`[uix] log visibleRows must be >= 1 (got ${this.visibleRows})`);\n    }\n  }\n\n  get count(): number {\n    return this.entries.length;\n  }\n\n  get isFollowing(): boolean {\n    return this.following;\n  }\n\n  push(message: string, level = 'info'): void {\n    this.entries.push({ message, level });\n    const overflow = this.entries.length - this.capacity;\n    if (overflow > 0) {\n      this.entries.splice(0, overflow);\n      this.scrollTop = Math.max(0, this.scrollTop - overflow);\n    }\n  }\n\n  clear(): void {\n    this.entries = [];\n    this.scrollTop = 0;\n    this.following = true;\n  }\n\n  /** Scroll up (towards older entries) by `rows`; disengages follow mode. */\n  scrollUp(rows = 1): void {\n    // Seed from the viewport the user is looking at NOW (which, while\n    // following, is the tail) before switching to manual scrolling.\n    const top = this.effectiveTop();\n    this.following = false;\n    this.scrollTop = Math.max(0, top - rows);\n  }\n\n  /** Scroll down; re-engages follow mode when the newest entry comes into view. */\n  scrollDown(rows = 1): void {\n    const max = this.maxTop();\n    const next = Math.min(max, this.effectiveTop() + rows);\n    this.scrollTop = next;\n    if (next >= max) {\n      this.following = true;\n    }\n  }\n\n  follow(): void {\n    this.following = true;\n  }\n\n  /** The entries currently in the viewport, oldest first. */\n  visible(): LogEntry[] {\n    const top = this.effectiveTop();\n    return this.entries.slice(top, top + this.visibleRows);\n  }\n\n  private maxTop(): number {\n    return Math.max(0, this.entries.length - this.visibleRows);\n  }\n\n  private effectiveTop(): number {\n    return this.following ? this.maxTop() : Math.min(this.scrollTop, this.maxTop());\n  }\n}\n"]}

package/dist/core/region-layout.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Layout regions - pure slot math for docking windows into named regions.
+ *
+ * A `DockRegion` is an anchor in space (an entity transform) that lays its
+ * docked windows out in a row, column or grid of fixed-pitch slots. The math
+ * here is deliberately simple and deterministic: given a slot index and a
+ * region definition, produce a local-space offset; given a drop point and the
+ * regions in the scene, decide which region (if any) captured the drop.
+ */
+export type Vec3 = readonly [number, number, number];
+export type RegionFlow = 'row' | 'column' | 'grid';
+export interface RegionDefinition {
+    /** Layout direction. `row` = +X, `column` = -Y, `grid` = rows of `columns`. */
+    flow: RegionFlow;
+    /** Distance between slot origins, in meters. */
+    pitch: number;
+    /** Number of columns per row; only meaningful for `grid`. */
+    columns: number;
+    /** Maximum windows the region accepts (0 = unlimited). */
+    capacity: number;
+    /** Drop-capture radius around the region origin, in meters. */
+    snapRadius: number;
+}
+export declare const DEFAULT_REGION: RegionDefinition;
+export declare function normalizeRegion(partial: Partial<RegionDefinition>): RegionDefinition;
+/** Local-space offset of slot `index` within a region. */
+export declare function slotOffset(region: RegionDefinition, index: number): Vec3;
+export declare function hasCapacity(region: RegionDefinition, occupancy: number): boolean;
+export interface RegionCandidate<TId> {
+    id: TId;
+    origin: Vec3;
+    region: RegionDefinition;
+    occupancy: number;
+}
+/**
+ * Which region captures a window dropped at `point`? The nearest region whose
+ * `snapRadius` contains the point and which still has capacity; `undefined`
+ * when the drop lands in open space (the window stays world-locked where it
+ * was released).
+ */
+export declare function captureDrop<TId>(point: Vec3, candidates: readonly RegionCandidate<TId>[]): RegionCandidate<TId> | undefined;

package/dist/core/region-layout.js

@@ -0,0 +1,79 @@
+/**
+ * Layout regions - pure slot math for docking windows into named regions.
+ *
+ * A `DockRegion` is an anchor in space (an entity transform) that lays its
+ * docked windows out in a row, column or grid of fixed-pitch slots. The math
+ * here is deliberately simple and deterministic: given a slot index and a
+ * region definition, produce a local-space offset; given a drop point and the
+ * regions in the scene, decide which region (if any) captured the drop.
+ */
+export const DEFAULT_REGION = {
+    flow: 'column',
+    pitch: 0.35,
+    columns: 2,
+    capacity: 0,
+    snapRadius: 0.5,
+};
+export function normalizeRegion(partial) {
+    const region = { ...DEFAULT_REGION, ...partial };
+    if (!(region.pitch > 0)) {
+        throw new Error(`[uix] region pitch must be > 0 (got ${region.pitch})`);
+    }
+    if (!(region.columns >= 1)) {
+        throw new Error(`[uix] region columns must be >= 1 (got ${region.columns})`);
+    }
+    if (region.capacity < 0) {
+        throw new Error(`[uix] region capacity must be >= 0 (got ${region.capacity})`);
+    }
+    if (!(region.snapRadius > 0)) {
+        throw new Error(`[uix] region snapRadius must be > 0 (got ${region.snapRadius})`);
+    }
+    return region;
+}
+/** Local-space offset of slot `index` within a region. */
+export function slotOffset(region, index) {
+    if (index < 0 || !Number.isInteger(index)) {
+        throw new Error(`[uix] slot index must be a non-negative integer (got ${index})`);
+    }
+    // `+ 0` folds the -0 that `-0 * pitch` would produce into plain 0.
+    switch (region.flow) {
+        case 'row':
+            return [index * region.pitch, 0, 0];
+        case 'column':
+            return [0, -index * region.pitch + 0, 0];
+        case 'grid': {
+            const col = index % region.columns;
+            const row = Math.floor(index / region.columns);
+            return [col * region.pitch, -row * region.pitch + 0, 0];
+        }
+    }
+}
+export function hasCapacity(region, occupancy) {
+    return region.capacity === 0 || occupancy < region.capacity;
+}
+/**
+ * Which region captures a window dropped at `point`? The nearest region whose
+ * `snapRadius` contains the point and which still has capacity; `undefined`
+ * when the drop lands in open space (the window stays world-locked where it
+ * was released).
+ */
+export function captureDrop(point, candidates) {
+    let best;
+    let bestDistSq = Infinity;
+    for (const candidate of candidates) {
+        if (!hasCapacity(candidate.region, candidate.occupancy)) {
+            continue;
+        }
+        const dx = point[0] - candidate.origin[0];
+        const dy = point[1] - candidate.origin[1];
+        const dz = point[2] - candidate.origin[2];
+        const distSq = dx * dx + dy * dy + dz * dz;
+        const radius = candidate.region.snapRadius;
+        if (distSq <= radius * radius && distSq < bestDistSq) {
+            best = candidate;
+            bestDistSq = distSq;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=region-layout.js.map

package/dist/core/region-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-layout.js","sourceRoot":"","sources":["../../src/core/region-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,GAAG;CAChB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,OAAkC;IAChE,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACjD,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,MAAwB,EAAE,KAAa;IAChE,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,wDAAwD,KAAK,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,mEAAmE;IACnE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAwB,EAAE,SAAiB;IACrE,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC9D,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,KAAW,EACX,UAA2C;IAE3C,IAAI,IAAsC,CAAC;IAC3C,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;QAC3C,IAAI,MAAM,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;YACrD,IAAI,GAAG,SAAS,CAAC;YACjB,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Layout regions - pure slot math for docking windows into named regions.\n *\n * A `DockRegion` is an anchor in space (an entity transform) that lays its\n * docked windows out in a row, column or grid of fixed-pitch slots. The math\n * here is deliberately simple and deterministic: given a slot index and a\n * region definition, produce a local-space offset; given a drop point and the\n * regions in the scene, decide which region (if any) captured the drop.\n */\n\nexport type Vec3 = readonly [number, number, number];\n\nexport type RegionFlow = 'row' | 'column' | 'grid';\n\nexport interface RegionDefinition {\n  /** Layout direction. `row` = +X, `column` = -Y, `grid` = rows of `columns`. */\n  flow: RegionFlow;\n  /** Distance between slot origins, in meters. */\n  pitch: number;\n  /** Number of columns per row; only meaningful for `grid`. */\n  columns: number;\n  /** Maximum windows the region accepts (0 = unlimited). */\n  capacity: number;\n  /** Drop-capture radius around the region origin, in meters. */\n  snapRadius: number;\n}\n\nexport const DEFAULT_REGION: RegionDefinition = {\n  flow: 'column',\n  pitch: 0.35,\n  columns: 2,\n  capacity: 0,\n  snapRadius: 0.5,\n};\n\nexport function normalizeRegion(partial: Partial<RegionDefinition>): RegionDefinition {\n  const region = { ...DEFAULT_REGION, ...partial };\n  if (!(region.pitch > 0)) {\n    throw new Error(`[uix] region pitch must be > 0 (got ${region.pitch})`);\n  }\n  if (!(region.columns >= 1)) {\n    throw new Error(`[uix] region columns must be >= 1 (got ${region.columns})`);\n  }\n  if (region.capacity < 0) {\n    throw new Error(`[uix] region capacity must be >= 0 (got ${region.capacity})`);\n  }\n  if (!(region.snapRadius > 0)) {\n    throw new Error(`[uix] region snapRadius must be > 0 (got ${region.snapRadius})`);\n  }\n  return region;\n}\n\n/** Local-space offset of slot `index` within a region. */\nexport function slotOffset(region: RegionDefinition, index: number): Vec3 {\n  if (index < 0 || !Number.isInteger(index)) {\n    throw new Error(`[uix] slot index must be a non-negative integer (got ${index})`);\n  }\n  // `+ 0` folds the -0 that `-0 * pitch` would produce into plain 0.\n  switch (region.flow) {\n    case 'row':\n      return [index * region.pitch, 0, 0];\n    case 'column':\n      return [0, -index * region.pitch + 0, 0];\n    case 'grid': {\n      const col = index % region.columns;\n      const row = Math.floor(index / region.columns);\n      return [col * region.pitch, -row * region.pitch + 0, 0];\n    }\n  }\n}\n\nexport function hasCapacity(region: RegionDefinition, occupancy: number): boolean {\n  return region.capacity === 0 || occupancy < region.capacity;\n}\n\nexport interface RegionCandidate<TId> {\n  id: TId;\n  origin: Vec3;\n  region: RegionDefinition;\n  occupancy: number;\n}\n\n/**\n * Which region captures a window dropped at `point`? The nearest region whose\n * `snapRadius` contains the point and which still has capacity; `undefined`\n * when the drop lands in open space (the window stays world-locked where it\n * was released).\n */\nexport function captureDrop<TId>(\n  point: Vec3,\n  candidates: readonly RegionCandidate<TId>[],\n): RegionCandidate<TId> | undefined {\n  let best: RegionCandidate<TId> | undefined;\n  let bestDistSq = Infinity;\n  for (const candidate of candidates) {\n    if (!hasCapacity(candidate.region, candidate.occupancy)) {\n      continue;\n    }\n    const dx = point[0] - candidate.origin[0];\n    const dy = point[1] - candidate.origin[1];\n    const dz = point[2] - candidate.origin[2];\n    const distSq = dx * dx + dy * dy + dz * dz;\n    const radius = candidate.region.snapRadius;\n    if (distSq <= radius * radius && distSq < bestDistSq) {\n      best = candidate;\n      bestDistSq = distSq;\n    }\n  }\n  return best;\n}\n"]}

package/dist/core/region-registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RegionRegistry - pure bookkeeping of dock regions and their members.
+ *
+ * The ECS layer feeds it region definitions (from `UIDockRegion` components)
+ * and world-space origins at drop time; it answers slot assignments and drop
+ * capture. Window/region ids are opaque strings.
+ */
+import { RegionDefinition, Vec3 } from './region-layout.js';
+export interface RegisteredRegion {
+    id: string;
+    definition: RegionDefinition;
+    /** Docked window ids in slot order. */
+    members: string[];
+}
+export declare class RegionRegistry {
+    private regions;
+    private regionByWindow;
+    register(id: string, definition?: Partial<RegionDefinition>): RegisteredRegion;
+    unregister(id: string): void;
+    get(id: string): RegisteredRegion | undefined;
+    /** Dock a window; returns its slot index. */
+    dock(windowId: string, regionId: string): number;
+    /** Remove a window from whichever region holds it. Later members shift up. */
+    undock(windowId: string): string | undefined;
+    regionOf(windowId: string): string | undefined;
+    /** Local-space offset for a docked window, or undefined when not docked. */
+    offsetOf(windowId: string): Vec3 | undefined;
+    /**
+     * Which region captures a drop at `point`, given each region's current
+     * world-space origin? Regions missing from `origins` are not considered
+     * (e.g. their entity is gone this frame).
+     */
+    capture(point: Vec3, origins: ReadonlyMap<string, Vec3>): string | undefined;
+    list(): RegisteredRegion[];
+}

package/dist/core/region-registry.js

@@ -0,0 +1,97 @@
+/**
+ * RegionRegistry - pure bookkeeping of dock regions and their members.
+ *
+ * The ECS layer feeds it region definitions (from `UIDockRegion` components)
+ * and world-space origins at drop time; it answers slot assignments and drop
+ * capture. Window/region ids are opaque strings.
+ */
+import { captureDrop, hasCapacity, normalizeRegion, slotOffset, } from './region-layout.js';
+export class RegionRegistry {
+    regions = new Map();
+    regionByWindow = new Map();
+    register(id, definition = {}) {
+        if (this.regions.has(id)) {
+            throw new Error(`[uix] region "${id}" is already registered`);
+        }
+        const region = {
+            id,
+            definition: normalizeRegion(definition),
+            members: [],
+        };
+        this.regions.set(id, region);
+        return region;
+    }
+    unregister(id) {
+        const region = this.regions.get(id);
+        if (!region) {
+            return;
+        }
+        for (const windowId of region.members) {
+            this.regionByWindow.delete(windowId);
+        }
+        this.regions.delete(id);
+    }
+    get(id) {
+        return this.regions.get(id);
+    }
+    /** Dock a window; returns its slot index. */
+    dock(windowId, regionId) {
+        const region = this.regions.get(regionId);
+        if (!region) {
+            throw new Error(`[uix] unknown region "${regionId}"`);
+        }
+        if (!hasCapacity(region.definition, region.members.length)) {
+            throw new Error(`[uix] region "${regionId}" is full`);
+        }
+        this.undock(windowId);
+        region.members.push(windowId);
+        this.regionByWindow.set(windowId, regionId);
+        return region.members.length - 1;
+    }
+    /** Remove a window from whichever region holds it. Later members shift up. */
+    undock(windowId) {
+        const regionId = this.regionByWindow.get(windowId);
+        if (regionId === undefined) {
+            return undefined;
+        }
+        this.regionByWindow.delete(windowId);
+        // `unregister` scrubs regionByWindow, so a mapped id always has a region.
+        const region = this.regions.get(regionId);
+        region.members = region.members.filter((member) => member !== windowId);
+        return regionId;
+    }
+    regionOf(windowId) {
+        return this.regionByWindow.get(windowId);
+    }
+    /** Local-space offset for a docked window, or undefined when not docked. */
+    offsetOf(windowId) {
+        const regionId = this.regionByWindow.get(windowId);
+        if (regionId === undefined) {
+            return undefined;
+        }
+        // A mapped window always has a live region with it as a member (dock/
+        // undock/unregister keep both maps in step).
+        const region = this.regions.get(regionId);
+        return slotOffset(region.definition, region.members.indexOf(windowId));
+    }
+    /**
+     * Which region captures a drop at `point`, given each region's current
+     * world-space origin? Regions missing from `origins` are not considered
+     * (e.g. their entity is gone this frame).
+     */
+    capture(point, origins) {
+        const candidates = [...this.regions.values()]
+            .filter((region) => origins.has(region.id))
+            .map((region) => ({
+            id: region.id,
+            origin: origins.get(region.id),
+            region: region.definition,
+            occupancy: region.members.length,
+        }));
+        return captureDrop(point, candidates)?.id;
+    }
+    list() {
+        return [...this.regions.values()];
+    }
+}
+//# sourceMappingURL=region-registry.js.map

package/dist/core/region-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-registry.js","sourceRoot":"","sources":["../../src/core/region-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RegionRegistry - pure bookkeeping of dock regions and their members.\n *\n * The ECS layer feeds it region definitions (from `UIDockRegion` components)\n * and world-space origins at drop time; it answers slot assignments and drop\n * capture. Window/region ids are opaque strings.\n */\nimport {\n  RegionDefinition,\n  Vec3,\n  captureDrop,\n  hasCapacity,\n  normalizeRegion,\n  slotOffset,\n} from './region-layout.js';\n\nexport interface RegisteredRegion {\n  id: string;\n  definition: RegionDefinition;\n  /** Docked window ids in slot order. */\n  members: string[];\n}\n\nexport class RegionRegistry {\n  private regions = new Map<string, RegisteredRegion>();\n  private regionByWindow = new Map<string, string>();\n\n  register(id: string, definition: Partial<RegionDefinition> = {}): RegisteredRegion {\n    if (this.regions.has(id)) {\n      throw new Error(`[uix] region \"${id}\" is already registered`);\n    }\n    const region: RegisteredRegion = {\n      id,\n      definition: normalizeRegion(definition),\n      members: [],\n    };\n    this.regions.set(id, region);\n    return region;\n  }\n\n  unregister(id: string): void {\n    const region = this.regions.get(id);\n    if (!region) {\n      return;\n    }\n    for (const windowId of region.members) {\n      this.regionByWindow.delete(windowId);\n    }\n    this.regions.delete(id);\n  }\n\n  get(id: string): RegisteredRegion | undefined {\n    return this.regions.get(id);\n  }\n\n  /** Dock a window; returns its slot index. */\n  dock(windowId: string, regionId: string): number {\n    const region = this.regions.get(regionId);\n    if (!region) {\n      throw new Error(`[uix] unknown region \"${regionId}\"`);\n    }\n    if (!hasCapacity(region.definition, region.members.length)) {\n      throw new Error(`[uix] region \"${regionId}\" is full`);\n    }\n    this.undock(windowId);\n    region.members.push(windowId);\n    this.regionByWindow.set(windowId, regionId);\n    return region.members.length - 1;\n  }\n\n  /** Remove a window from whichever region holds it. Later members shift up. */\n  undock(windowId: string): string | undefined {\n    const regionId = this.regionByWindow.get(windowId);\n    if (regionId === undefined) {\n      return undefined;\n    }\n    this.regionByWindow.delete(windowId);\n    // `unregister` scrubs regionByWindow, so a mapped id always has a region.\n    const region = this.regions.get(regionId) as RegisteredRegion;\n    region.members = region.members.filter((member) => member !== windowId);\n    return regionId;\n  }\n\n  regionOf(windowId: string): string | undefined {\n    return this.regionByWindow.get(windowId);\n  }\n\n  /** Local-space offset for a docked window, or undefined when not docked. */\n  offsetOf(windowId: string): Vec3 | undefined {\n    const regionId = this.regionByWindow.get(windowId);\n    if (regionId === undefined) {\n      return undefined;\n    }\n    // A mapped window always has a live region with it as a member (dock/\n    // undock/unregister keep both maps in step).\n    const region = this.regions.get(regionId) as RegisteredRegion;\n    return slotOffset(region.definition, region.members.indexOf(windowId));\n  }\n\n  /**\n   * Which region captures a drop at `point`, given each region's current\n   * world-space origin? Regions missing from `origins` are not considered\n   * (e.g. their entity is gone this frame).\n   */\n  capture(point: Vec3, origins: ReadonlyMap<string, Vec3>): string | undefined {\n    const candidates = [...this.regions.values()]\n      .filter((region) => origins.has(region.id))\n      .map((region) => ({\n        id: region.id,\n        origin: origins.get(region.id) as Vec3,\n        region: region.definition,\n        occupancy: region.members.length,\n      }));\n    return captureDrop(point, candidates)?.id;\n  }\n\n  list(): RegisteredRegion[] {\n    return [...this.regions.values()];\n  }\n}\n"]}