@rezi-ui/core 0.1.0-alpha.1

package/dist/layout/engine/layoutEngine.js

@@ -0,0 +1,344 @@
+/**
+ * packages/core/src/layout/layout.ts — Widget tree layout computation.
+ *
+ * Why: Computes absolute positions and sizes for all widgets in a VNode tree.
+ * Uses a constraint-based approach: parent provides max width/height, children
+ * report their natural size, and the layout algorithm positions them accordingly.
+ *
+ * Layout rules:
+ *   - Text/Button/Input: single row, width = content width
+ *   - Spacer: size cells in stack axis, 0 or 1 in cross axis
+ *   - Row: horizontal stack with pad/gap/align
+ *   - Column: vertical stack with pad/gap/align
+ *   - Box: optional border + pad, children laid out as column
+ *
+ * Invariants:
+ *   - All coordinates are int32 in range [-2147483648, 2147483647]
+ *   - Negative dimensions clamped to 0
+ *   - Props validated before layout; invalid props produce fatal error
+ *
+ * @see docs/guide/layout.md
+ */
+import { layoutBoxKinds, measureBoxKinds } from "../kinds/box.js";
+import { layoutCollections, measureCollections } from "../kinds/collections.js";
+import { layoutLeafKind, measureLeaf } from "../kinds/leaf.js";
+import { layoutOverlays, measureOverlays } from "../kinds/overlays.js";
+import { layoutSplitPaneKinds, measureSplitPaneKinds } from "../kinds/splitPane.js";
+import { layoutStackKinds, measureStackKinds } from "../kinds/stack.js";
+import { clampNonNegative, isI32 } from "./bounds.js";
+let activeMeasureCache = null;
+const measureCacheStack = [];
+function pushMeasureCache(cache) {
+    measureCacheStack.push(cache);
+    activeMeasureCache = cache;
+}
+function popMeasureCache() {
+    measureCacheStack.pop();
+    activeMeasureCache =
+        measureCacheStack.length > 0 ? (measureCacheStack[measureCacheStack.length - 1] ?? null) : null;
+}
+/**
+ * Measure the natural size of a VNode given constraints.
+ * Does not position; only computes width and height.
+ */
+function measureNode(vnode, maxW, maxH, axis) {
+    if (!isI32(maxW) || maxW < 0) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "measure: maxW must be an int32 >= 0" },
+        };
+    }
+    if (!isI32(maxH) || maxH < 0) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "measure: maxH must be an int32 >= 0" },
+        };
+    }
+    const cache = activeMeasureCache;
+    if (cache) {
+        const entry = cache.get(vnode);
+        if (entry) {
+            const axisMap = axis === "row" ? entry.row : entry.column;
+            const byH = axisMap.get(maxW);
+            const hit = byH?.get(maxH);
+            if (hit)
+                return hit;
+        }
+    }
+    let computed;
+    switch (vnode.kind) {
+        case "text":
+        case "button":
+        case "input":
+        case "spacer":
+        case "divider":
+        case "icon":
+        case "spinner":
+        case "progress":
+        case "skeleton":
+        case "richText":
+        case "kbd":
+        case "badge":
+        case "status":
+        case "tag":
+        case "gauge":
+        case "empty":
+        case "errorDisplay":
+        case "callout":
+        case "sparkline":
+        case "barChart":
+        case "miniChart": {
+            computed = measureLeaf(vnode, maxW, maxH, axis);
+            break;
+        }
+        case "row": {
+            computed = measureStackKinds(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "column": {
+            computed = measureStackKinds(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "box": {
+            computed = measureBoxKinds(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "focusZone":
+        case "focusTrap": {
+            computed = measureOverlays(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "virtualList": {
+            computed = measureCollections(vnode, maxW, maxH);
+            break;
+        }
+        case "layers":
+        case "modal":
+        case "dropdown":
+        case "layer": {
+            computed = measureOverlays(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "table":
+        case "tree": {
+            computed = measureCollections(vnode, maxW, maxH);
+            break;
+        }
+        case "field": {
+            computed = measureBoxKinds(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "select":
+        case "checkbox":
+        case "radioGroup": {
+            computed = measureLeaf(vnode, maxW, maxH, axis);
+            break;
+        }
+        /* ========== Advanced Widgets (GitHub issue #136) ========== */
+        case "commandPalette": {
+            computed = measureOverlays(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "filePicker":
+        case "fileTreeExplorer": {
+            computed = measureCollections(vnode, maxW, maxH);
+            break;
+        }
+        case "splitPane":
+        case "panelGroup":
+        case "resizablePanel": {
+            computed = measureSplitPaneKinds(vnode, maxW, maxH);
+            break;
+        }
+        case "codeEditor":
+        case "diffViewer": {
+            computed = measureCollections(vnode, maxW, maxH);
+            break;
+        }
+        case "toolApprovalDialog": {
+            computed = measureOverlays(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+        case "logsConsole": {
+            computed = measureCollections(vnode, maxW, maxH);
+            break;
+        }
+        case "toastContainer": {
+            computed = measureOverlays(vnode, maxW, maxH, axis, measureNode);
+            break;
+        }
+    }
+    if (cache) {
+        let entry = cache.get(vnode);
+        if (!entry) {
+            entry = Object.freeze({ row: new Map(), column: new Map() });
+            cache.set(vnode, entry);
+        }
+        const axisMap = axis === "row" ? entry.row : entry.column;
+        let byH = axisMap.get(maxW);
+        if (!byH) {
+            byH = new Map();
+            axisMap.set(maxW, byH);
+        }
+        byH.set(maxH, computed);
+    }
+    return computed;
+}
+/**
+ * Layout a VNode and its children, producing a positioned LayoutTree.
+ * Combines measurement with positioning based on stack axis and alignment.
+ */
+function layoutNode(vnode, x, y, maxW, maxH, axis, forcedW = null, forcedH = null) {
+    if (!isI32(x)) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "layout: x must be an int32" },
+        };
+    }
+    if (!isI32(y)) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "layout: y must be an int32" },
+        };
+    }
+    if (!isI32(maxW) || maxW < 0) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "layout: maxW must be an int32 >= 0" },
+        };
+    }
+    if (!isI32(maxH) || maxH < 0) {
+        return {
+            ok: false,
+            fatal: { code: "ZRUI_INVALID_PROPS", detail: "layout: maxH must be an int32 >= 0" },
+        };
+    }
+    const sizeRes = measureNode(vnode, maxW, maxH, axis);
+    if (!sizeRes.ok)
+        return sizeRes;
+    const rectW = clampNonNegative(Math.min(maxW, forcedW ?? sizeRes.value.w));
+    const rectH = clampNonNegative(Math.min(maxH, forcedH ?? sizeRes.value.h));
+    switch (vnode.kind) {
+        case "text":
+        case "button":
+        case "input":
+        case "spacer":
+        case "divider":
+        case "icon":
+        case "spinner":
+        case "progress":
+        case "skeleton":
+        case "richText":
+        case "kbd":
+        case "badge":
+        case "status":
+        case "tag":
+        case "gauge":
+        case "empty":
+        case "errorDisplay":
+        case "callout":
+        case "sparkline":
+        case "barChart":
+        case "miniChart":
+        case "select":
+        case "checkbox":
+        case "radioGroup": {
+            return layoutLeafKind(vnode, x, y, rectW, rectH);
+        }
+        case "row": {
+            return layoutStackKinds(vnode, x, y, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "column": {
+            return layoutStackKinds(vnode, x, y, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "box": {
+            return layoutBoxKinds(vnode, x, y, rectW, rectH, axis, layoutNode);
+        }
+        case "focusZone":
+        case "focusTrap": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "virtualList": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "layers": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "modal": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "dropdown": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "layer": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "table": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "tree": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "field": {
+            return layoutBoxKinds(vnode, x, y, rectW, rectH, axis, layoutNode);
+        }
+        /* ========== Advanced Widgets (GitHub issue #136) ========== */
+        case "commandPalette": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "filePicker": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "fileTreeExplorer": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "splitPane":
+        case "panelGroup":
+        case "resizablePanel": {
+            return layoutSplitPaneKinds(vnode, x, y, maxW, maxH, rectW, rectH, axis, layoutNode);
+        }
+        case "codeEditor": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "diffViewer": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "toolApprovalDialog": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+        case "logsConsole": {
+            return layoutCollections(vnode, x, y, rectW, rectH);
+        }
+        case "toastContainer": {
+            return layoutOverlays(vnode, x, y, maxW, maxH, rectW, rectH, axis, measureNode, layoutNode);
+        }
+    }
+}
+/** Measure a VNode tree without positioning (public API). */
+export function measure(node, maxW, maxH, axis) {
+    return measureNode(node, maxW, maxH, axis);
+}
+/**
+ * Compute layout for a VNode tree starting at position (x,y) with constraints.
+ *
+ * @param node - Root VNode to layout
+ * @param x - Starting X position in terminal cells
+ * @param y - Starting Y position in terminal cells
+ * @param maxW - Maximum available width
+ * @param maxH - Maximum available height
+ * @param axis - Stack axis for root container behavior
+ * @returns LayoutTree on success, fatal error on invalid props
+ */
+export function layout(node, x, y, maxW, maxH, axis, measureCache) {
+    const cache = measureCache
+        ? measureCache
+        : new WeakMap();
+    pushMeasureCache(cache);
+    try {
+        return layoutNode(node, x, y, maxW, maxH, axis);
+    }
+    finally {
+        popMeasureCache();
+    }
+}
+//# sourceMappingURL=layoutEngine.js.map

package/dist/layout/engine/layoutEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutEngine.js","sourceRoot":"","sources":["../../../src/layout/engine/layoutEngine.ts"],"names":[],"mappings":"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"}

package/dist/layout/engine/layoutTree.d.ts

@@ -0,0 +1,6 @@
+import type { VNode } from "../../index.js";
+import type { LayoutResult } from "../validateProps.js";
+import type { LayoutTree } from "./types.js";
+/** Create a LayoutTree leaf node (no children) with validated rect. */
+export declare function layoutLeaf(vnode: VNode, x: number, y: number, w: number, h: number): LayoutResult<LayoutTree>;
+//# sourceMappingURL=layoutTree.d.ts.map

package/dist/layout/engine/layoutTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutTree.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/layoutTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uEAAuE;AACvE,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,YAAY,CAAC,UAAU,CAAC,CAW1B"}

package/dist/layout/engine/layoutTree.js

@@ -0,0 +1,16 @@
+import { isI32 } from "./bounds.js";
+import { ok } from "./result.js";
+/** Create a LayoutTree leaf node (no children) with validated rect. */
+export function layoutLeaf(vnode, x, y, w, h) {
+    if (!isI32(x) || !isI32(y) || !isI32(w) || !isI32(h) || w < 0 || h < 0) {
+        return {
+            ok: false,
+            fatal: {
+                code: "ZRUI_INVALID_PROPS",
+                detail: "layout: computed rect is not valid int32 cells",
+            },
+        };
+    }
+    return ok({ vnode, rect: { x, y, w, h }, children: Object.freeze([]) });
+}
+//# sourceMappingURL=layoutTree.js.map

package/dist/layout/engine/layoutTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutTree.js","sourceRoot":"","sources":["../../../src/layout/engine/layoutTree.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjC,uEAAuE;AACvE,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,CAAS,EACT,CAAS,EACT,CAAS,EACT,CAAS;IAET,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,MAAM,EAAE,gDAAgD;aACzD;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/layout/engine/pool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get or create a number array of the specified length, zeroed.
+ * Reuses pooled arrays when possible.
+ */
+export declare function acquireArray(length: number): number[];
+/**
+ * Return an array to the pool for reuse.
+ */
+export declare function releaseArray(arr: number[]): void;
+//# sourceMappingURL=pool.d.ts.map

package/dist/layout/engine/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/pool.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAarD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAIhD"}

package/dist/layout/engine/pool.js

@@ -0,0 +1,33 @@
+/* ========== Layout Array Pooling ========== */
+// Reusable arrays to reduce GC pressure during layout computation.
+// These are cleared and reused rather than allocated fresh each time.
+/** Pool of reusable number arrays for layout computation. */
+const arrayPool = [];
+const MAX_POOL_SIZE = 8;
+/**
+ * Get or create a number array of the specified length, zeroed.
+ * Reuses pooled arrays when possible.
+ */
+export function acquireArray(length) {
+    // Try to find a pooled array that's large enough
+    for (let i = 0; i < arrayPool.length; i++) {
+        const arr = arrayPool[i];
+        if (arr !== undefined && arr.length >= length) {
+            arrayPool.splice(i, 1);
+            // Zero the portion we'll use
+            arr.fill(0, 0, length);
+            return arr;
+        }
+    }
+    // Create new array
+    return new Array(length).fill(0);
+}
+/**
+ * Return an array to the pool for reuse.
+ */
+export function releaseArray(arr) {
+    if (arrayPool.length < MAX_POOL_SIZE) {
+        arrayPool.push(arr);
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/layout/engine/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../src/layout/engine/pool.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,mEAAmE;AACnE,sEAAsE;AAEtE,6DAA6D;AAC7D,MAAM,SAAS,GAAe,EAAE,CAAC;AACjC,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,iDAAiD;IACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC9C,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,6BAA6B;YAC7B,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACvB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,mBAAmB;IACnB,OAAO,IAAI,KAAK,CAAS,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,IAAI,SAAS,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACrC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/layout/engine/result.d.ts

@@ -0,0 +1,3 @@
+import type { LayoutResult } from "../validateProps.js";
+export declare function ok<T>(value: T): LayoutResult<T>;
+//# sourceMappingURL=result.d.ts.map

package/dist/layout/engine/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAE/C"}

package/dist/layout/engine/result.js

@@ -0,0 +1,4 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+//# sourceMappingURL=result.js.map

package/dist/layout/engine/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/layout/engine/result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/layout/engine/types.d.ts

@@ -0,0 +1,12 @@
+import type { VNode } from "../../index.js";
+import type { Rect } from "../types.js";
+/**
+ * Tree of layout results mirroring VNode structure.
+ * Each node contains its positioned rectangle and children.
+ */
+export type LayoutTree = Readonly<{
+    vnode: VNode;
+    rect: Rect;
+    children: readonly LayoutTree[];
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/layout/engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAC,CAAC"}

package/dist/layout/engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/layout/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/layout/engine/types.ts"],"names":[],"mappings":""}

package/dist/layout/hitTest.d.ts

@@ -0,0 +1,25 @@
+/**
+ * packages/core/src/layout/hitTest.ts — Mouse hit testing for focusable widgets.
+ *
+ * Why: Determines which focusable widget (if any) is under a given mouse
+ * position. Used for mouse-based focus changes and click routing.
+ *
+ * Tie-break rule: When multiple focusable widgets overlap at a point, the
+ * LAST one in depth-first preorder traversal wins (typically the "topmost"
+ * visually, though stacking is logical not visual in terminal UI).
+ *
+ * @see docs/guide/layout.md
+ */
+import type { VNode } from "../index.js";
+import type { LayoutTree } from "./layout.js";
+import type { Rect } from "./types.js";
+/** Check if point (x,y) is inside rect (exclusive of right/bottom edges). */
+export declare function contains(rect: Rect, x: number, y: number): boolean;
+/**
+ * Hit test focusable widgets (enabled interactive ids).
+ *
+ * Tie-break is deterministic: if multiple focusable widgets contain the point,
+ * the winner is the LAST focusable widget in depth-first preorder traversal order.
+ */
+export declare function hitTestFocusable(tree: VNode, layout: LayoutTree, x: number, y: number): string | null;
+//# sourceMappingURL=hitTest.d.ts.map

package/dist/layout/hitTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitTest.d.ts","sourceRoot":"","sources":["../../src/layout/hitTest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAElE;AA8CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,UAAU,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,GAAG,IAAI,CAmDf"}

package/dist/layout/hitTest.js

@@ -0,0 +1,111 @@
+/**
+ * packages/core/src/layout/hitTest.ts — Mouse hit testing for focusable widgets.
+ *
+ * Why: Determines which focusable widget (if any) is under a given mouse
+ * position. Used for mouse-based focus changes and click routing.
+ *
+ * Tie-break rule: When multiple focusable widgets overlap at a point, the
+ * LAST one in depth-first preorder traversal wins (typically the "topmost"
+ * visually, though stacking is logical not visual in terminal UI).
+ *
+ * @see docs/guide/layout.md
+ */
+/** Check if point (x,y) is inside rect (exclusive of right/bottom edges). */
+export function contains(rect, x, y) {
+    return x >= rect.x && x < rect.x + rect.w && y >= rect.y && y < rect.y + rect.h;
+}
+/** Return the ID of a focusable widget, or null if not focusable/disabled. */
+function isFocusable(v) {
+    switch (v.kind) {
+        case "button":
+        case "input":
+        case "virtualList":
+        case "table":
+        case "tree":
+        case "select":
+        case "checkbox":
+        case "radioGroup":
+        // Advanced widgets (GitHub issue #136)
+        case "commandPalette":
+        case "filePicker":
+        case "fileTreeExplorer":
+        case "codeEditor":
+        case "diffViewer":
+        case "toolApprovalDialog":
+        case "logsConsole": {
+            const id = v.props.id;
+            if (typeof id !== "string" || id.length === 0)
+                return null;
+            if (v.kind === "commandPalette" || v.kind === "toolApprovalDialog") {
+                const open = v.props.open;
+                if (open !== true)
+                    return null;
+            }
+            if (v.kind === "button" ||
+                v.kind === "input" ||
+                v.kind === "select" ||
+                v.kind === "checkbox" ||
+                v.kind === "radioGroup") {
+                const disabled = v.props.disabled;
+                if (disabled === true)
+                    return null;
+            }
+            return id;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Hit test focusable widgets (enabled interactive ids).
+ *
+ * Tie-break is deterministic: if multiple focusable widgets contain the point,
+ * the winner is the LAST focusable widget in depth-first preorder traversal order.
+ */
+export function hitTestFocusable(tree, layout, x, y) {
+    void tree;
+    let winner = null;
+    const nodeStack = [layout];
+    const clipXStack = [layout.rect.x];
+    const clipYStack = [layout.rect.y];
+    const clipWStack = [layout.rect.w];
+    const clipHStack = [layout.rect.h];
+    while (nodeStack.length > 0) {
+        const node = nodeStack.pop();
+        const clipX = clipXStack.pop();
+        const clipY = clipYStack.pop();
+        const clipW = clipWStack.pop();
+        const clipH = clipHStack.pop();
+        if (node === undefined ||
+            clipX === undefined ||
+            clipY === undefined ||
+            clipW === undefined ||
+            clipH === undefined) {
+            continue;
+        }
+        const nodeRect = node.rect;
+        const ix0 = Math.max(clipX, nodeRect.x);
+        const iy0 = Math.max(clipY, nodeRect.y);
+        const ix1 = Math.min(clipX + clipW, nodeRect.x + nodeRect.w);
+        const iy1 = Math.min(clipY + clipH, nodeRect.y + nodeRect.h);
+        if (ix1 <= ix0 || iy1 <= iy0)
+            continue;
+        const id = isFocusable(node.vnode);
+        if (id !== null && x >= ix0 && x < ix1 && y >= iy0 && y < iy1) {
+            winner = id;
+        }
+        // Depth-first preorder: push children in reverse so left-to-right is visited first.
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const child = node.children[i];
+            if (!child)
+                continue;
+            nodeStack.push(child);
+            clipXStack.push(ix0);
+            clipYStack.push(iy0);
+            clipWStack.push(ix1 - ix0);
+            clipHStack.push(iy1 - iy0);
+        }
+    }
+    return winner;
+}
+//# sourceMappingURL=hitTest.js.map

package/dist/layout/hitTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitTest.js","sourceRoot":"","sources":["../../src/layout/hitTest.ts"],"names":[],"mappings":"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"}

package/dist/layout/kinds/box.d.ts

@@ -0,0 +1,10 @@
+import type { VNode } from "../../index.js";
+import type { LayoutTree } from "../engine/types.js";
+import type { Axis, Size } from "../types.js";
+import type { LayoutResult } from "../validateProps.js";
+type MeasureNodeFn = (vnode: VNode, maxW: number, maxH: number, axis: Axis) => LayoutResult<Size>;
+type LayoutNodeFn = (vnode: VNode, x: number, y: number, maxW: number, maxH: number, axis: Axis, forcedW?: number | null, forcedH?: number | null) => LayoutResult<LayoutTree>;
+export declare function measureBoxKinds(vnode: VNode, maxW: number, maxH: number, axis: Axis, measureNode: MeasureNodeFn): LayoutResult<Size>;
+export declare function layoutBoxKinds(vnode: VNode, x: number, y: number, rectW: number, rectH: number, axis: Axis, layoutNode: LayoutNodeFn): LayoutResult<LayoutTree>;
+export {};
+//# sourceMappingURL=box.d.ts.map