@rezi-ui/core 0.1.0-alpha.6 → 0.1.0-alpha.63

package/dist/runtime/widgetMeta/focusInfo.js

@@ -0,0 +1,172 @@
+import { getSelectDisplayText } from "../../widgets/select.js";
+import { readNonEmptyString } from "./helpers.js";
+const EMPTY_ERRORS = Object.freeze([]);
+function readFocusableVisibleLabel(vnode) {
+    switch (vnode.kind) {
+        case "button":
+            return readNonEmptyString(vnode.props.label);
+        case "link": {
+            const props = vnode.props;
+            return readNonEmptyString(props.label) ?? readNonEmptyString(props.url);
+        }
+        case "slider":
+            return readNonEmptyString(vnode.props.label);
+        case "checkbox":
+            return readNonEmptyString(vnode.props.label);
+        case "select": {
+            const props = vnode.props;
+            const value = typeof props.value === "string" ? props.value : "";
+            const options = Array.isArray(props.options)
+                ? props.options
+                : [];
+            return readNonEmptyString(getSelectDisplayText(value, options, readNonEmptyString(props.placeholder) ?? undefined));
+        }
+        case "radioGroup": {
+            const props = vnode.props;
+            const value = typeof props.value === "string" ? props.value : "";
+            const options = Array.isArray(props.options)
+                ? props.options
+                : [];
+            for (const option of options) {
+                if (typeof option?.value === "string" &&
+                    option.value === value &&
+                    typeof option.label === "string") {
+                    return readNonEmptyString(option.label);
+                }
+            }
+            return null;
+        }
+        case "commandPalette":
+            return readNonEmptyString(vnode.props.placeholder);
+        case "filePicker":
+            return readNonEmptyString(vnode.props.rootPath);
+        case "diffViewer": {
+            const diff = vnode.props.diff;
+            if (diff && typeof diff === "object") {
+                return readNonEmptyString(diff.newPath) ?? readNonEmptyString(diff.oldPath);
+            }
+            return null;
+        }
+        case "toolApprovalDialog": {
+            const request = vnode.props.request;
+            if (request && typeof request === "object") {
+                return readNonEmptyString(request.toolName);
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+function kindToAnnouncementPrefix(kind) {
+    switch (kind) {
+        case "button":
+            return "Button";
+        case "link":
+            return "Link";
+        case "input":
+            return "Input";
+        case "slider":
+            return "Slider";
+        case "virtualList":
+            return "List";
+        case "table":
+            return "Table";
+        case "tree":
+            return "Tree";
+        case "select":
+            return "Select";
+        case "checkbox":
+            return "Checkbox";
+        case "radioGroup":
+            return "Radio group";
+        case "commandPalette":
+            return "Command palette";
+        case "filePicker":
+            return "File picker";
+        case "fileTreeExplorer":
+            return "File tree explorer";
+        case "codeEditor":
+            return "Code editor";
+        case "diffViewer":
+            return "Diff viewer";
+        case "toolApprovalDialog":
+            return "Tool approval dialog";
+        case "logsConsole":
+            return "Logs console";
+        default:
+            return "Widget";
+    }
+}
+export function readFieldContext(vnode) {
+    if (vnode.kind !== "field")
+        return null;
+    const props = vnode.props;
+    return Object.freeze({
+        label: readNonEmptyString(props.label),
+        required: props.required === true,
+        error: readNonEmptyString(props.error),
+    });
+}
+function resolveFieldLabel(fieldStack) {
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        const label = fieldStack[i]?.label;
+        if (label)
+            return label;
+    }
+    return null;
+}
+function resolveFieldRequired(fieldStack) {
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        if (fieldStack[i]?.required === true)
+            return true;
+    }
+    return false;
+}
+function resolveFieldErrors(fieldStack) {
+    if (fieldStack.length === 0)
+        return EMPTY_ERRORS;
+    const out = [];
+    const seen = new Set();
+    for (let i = fieldStack.length - 1; i >= 0; i--) {
+        const error = fieldStack[i]?.error;
+        if (!error || seen.has(error))
+            continue;
+        seen.add(error);
+        out.push(error);
+    }
+    return out.length > 0 ? Object.freeze(out) : EMPTY_ERRORS;
+}
+function buildFocusAnnouncement(primary, required, errors) {
+    const parts = [primary];
+    if (required)
+        parts.push("Required");
+    if (errors.length === 1) {
+        const first = errors[0];
+        if (first)
+            parts.push(first);
+    }
+    else if (errors.length > 1) {
+        parts.push(`${String(errors.length)} validation errors`);
+    }
+    return parts.join(" — ");
+}
+export function buildFocusInfo(vnode, id, fieldStack) {
+    const accessibleLabel = readNonEmptyString(vnode.props.accessibleLabel);
+    const widgetLabel = readFocusableVisibleLabel(vnode);
+    const fieldLabel = resolveFieldLabel(fieldStack);
+    const visibleLabel = widgetLabel ?? fieldLabel;
+    const required = resolveFieldRequired(fieldStack);
+    const errors = resolveFieldErrors(fieldStack);
+    const primary = accessibleLabel ?? visibleLabel ?? `${kindToAnnouncementPrefix(vnode.kind)} ${id}`;
+    return Object.freeze({
+        id,
+        kind: vnode.kind,
+        accessibleLabel,
+        visibleLabel,
+        required,
+        errors,
+        announcement: buildFocusAnnouncement(primary, required, errors),
+    });
+}
+//# sourceMappingURL=focusInfo.js.map

package/dist/runtime/widgetMeta/focusInfo.js.map

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

package/dist/runtime/widgetMeta/helpers.d.ts

@@ -0,0 +1,47 @@
+import type { RuntimeInstance } from "../commit.js";
+import type { InstanceId } from "../instance.js";
+/** Extract interactive widget ID from a node with a valid `id` prop. */
+export declare function readInteractiveId(v: RuntimeInstance["vnode"]): string | null;
+export declare function isFocusableInteractive(v: RuntimeInstance["vnode"]): boolean;
+export declare function isEnabledInteractive(v: RuntimeInstance["vnode"]): string | null;
+export declare function readNonEmptyString(v: unknown): string | null;
+/** Metadata for an Input widget instance. */
+export type InputMeta = Readonly<{
+    instanceId: InstanceId;
+    value: string;
+    disabled: boolean;
+    readOnly: boolean;
+    multiline: boolean;
+    rows: number;
+    wordWrap: boolean;
+    onInput?: (value: string, cursor: number) => void;
+    onBlur?: () => void;
+}>;
+/**
+ * Collect focusable ids from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Children: left-to-right
+ * - Focusable set: enabled focusable interactive widgets
+ */
+export declare function collectFocusableIds(tree: RuntimeInstance): readonly string[];
+/**
+ * Collect a deterministic enabled map (interactive id -> enabled) from a committed runtime tree.
+ *
+ * Interactive widgets are always included when their `id` is a non-empty string;
+ * enabled is `true` iff `disabled !== true`.
+ */
+export declare function collectEnabledMap(tree: RuntimeInstance): ReadonlyMap<string, boolean>;
+/**
+ * Collect ids that can produce a "press" action (Buttons).
+ *
+ * Includes Buttons with a non-empty string id, regardless of disabled state.
+ */
+export declare function collectPressableIds(tree: RuntimeInstance): ReadonlySet<string>;
+/**
+ * Collect a deterministic map of Input id -> { instanceId, value, disabled } from a committed runtime tree.
+ *
+ * Inputs are included when their `id` is a non-empty string and `value` is a string.
+ */
+export declare function collectInputMetaById(tree: RuntimeInstance): ReadonlyMap<string, InputMeta>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/runtime/widgetMeta/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,CAO3E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAgB/E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BrF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAoB9E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAgE1F"}

package/dist/runtime/widgetMeta/helpers.js

@@ -0,0 +1,182 @@
+import { getWidgetProtocol, kindIsFocusable, kindIsPressable } from "../../widgets/protocol.js";
+/** Extract interactive widget ID from a node with a valid `id` prop. */
+export function readInteractiveId(v) {
+    const proto = getWidgetProtocol(v.kind);
+    if (!proto.requiresId && !proto.focusable && !proto.pressable)
+        return null;
+    const id = v.props.id;
+    if (typeof id !== "string" || id.length === 0)
+        return null;
+    return id;
+}
+export function isFocusableInteractive(v) {
+    const focusable = v.props.focusable;
+    if (focusable === false)
+        return false;
+    // Note: Some interactive widgets require an id for routing (e.g. SplitPane dividers),
+    // but are explicitly NOT focusable (PLAN.md).
+    return kindIsFocusable(v.kind);
+}
+export function isEnabledInteractive(v) {
+    const id = readInteractiveId(v);
+    if (id === null)
+        return null;
+    const proto = getWidgetProtocol(v.kind);
+    if (proto.disableable) {
+        const disabled = v.props.disabled;
+        if (disabled === true)
+            return null;
+    }
+    if (proto.openGated) {
+        const open = v.props.open;
+        if (open !== true)
+            return null;
+    }
+    return id;
+}
+export function readNonEmptyString(v) {
+    if (typeof v !== "string")
+        return null;
+    const trimmed = v.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/**
+ * Collect focusable ids from a committed runtime tree.
+ *
+ * - Order: depth-first preorder
+ * - Children: left-to-right
+ * - Focusable set: enabled focusable interactive widgets
+ */
+export function collectFocusableIds(tree) {
+    const out = [];
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        const id = isFocusableInteractive(node.vnode) ? isEnabledInteractive(node.vnode) : null;
+        if (id !== null)
+            out.push(id);
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return Object.freeze(out);
+}
+/**
+ * Collect a deterministic enabled map (interactive id -> enabled) from a committed runtime tree.
+ *
+ * Interactive widgets are always included when their `id` is a non-empty string;
+ * enabled is `true` iff `disabled !== true`.
+ */
+export function collectEnabledMap(tree) {
+    const m = new Map();
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        const id = readInteractiveId(node.vnode);
+        if (id !== null && !m.has(id)) {
+            let enabled = true;
+            const proto = getWidgetProtocol(node.vnode.kind);
+            if (proto.disableable) {
+                const disabled = node.vnode.props.disabled;
+                enabled = disabled !== true;
+            }
+            if (proto.openGated) {
+                const open = node.vnode.props.open;
+                enabled = open === true;
+            }
+            m.set(id, enabled);
+        }
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return m;
+}
+/**
+ * Collect ids that can produce a "press" action (Buttons).
+ *
+ * Includes Buttons with a non-empty string id, regardless of disabled state.
+ */
+export function collectPressableIds(tree) {
+    const s = new Set();
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        if (kindIsPressable(node.vnode.kind)) {
+            const id = node.vnode.props.id;
+            if (typeof id === "string" && id.length > 0)
+                s.add(id);
+        }
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return s;
+}
+/**
+ * Collect a deterministic map of Input id -> { instanceId, value, disabled } from a committed runtime tree.
+ *
+ * Inputs are included when their `id` is a non-empty string and `value` is a string.
+ */
+export function collectInputMetaById(tree) {
+    const m = new Map();
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        if (node.vnode.kind === "input") {
+            const props = node.vnode.props;
+            const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
+            const value = typeof props.value === "string" ? props.value : null;
+            if (id !== null && value !== null && !m.has(id)) {
+                const disabled = props.disabled === true;
+                const readOnly = props.readOnly === true;
+                const multiline = props.multiline === true;
+                const rowsRaw = typeof props.rows === "number" && Number.isFinite(props.rows) ? props.rows : 3;
+                const rows = multiline ? Math.max(1, Math.trunc(rowsRaw)) : 1;
+                const wordWrap = multiline ? props.wordWrap !== false : false;
+                const onInput = typeof props.onInput === "function"
+                    ? props.onInput
+                    : undefined;
+                const onBlur = typeof props.onBlur === "function" ? props.onBlur : undefined;
+                const metaBase = {
+                    instanceId: node.instanceId,
+                    value,
+                    disabled,
+                    readOnly,
+                    multiline,
+                    rows,
+                    wordWrap,
+                };
+                const meta = onInput || onBlur
+                    ? Object.freeze({
+                        ...metaBase,
+                        ...(onInput ? { onInput } : {}),
+                        ...(onBlur ? { onBlur } : {}),
+                    })
+                    : Object.freeze(metaBase);
+                m.set(id, meta);
+            }
+        }
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const c = node.children[i];
+            if (c)
+                stack.push(c);
+        }
+    }
+    return m;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/runtime/widgetMeta/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIhG,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,CAA2B;IAC3D,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,EAAE,GAAI,CAAC,CAAC,KAA0B,CAAC,EAAE,CAAC;IAC5C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAA2B;IAChE,MAAM,SAAS,GAAI,CAAC,CAAC,KAAiC,CAAC,SAAS,CAAC;IACjE,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAEtC,sFAAsF;IACtF,8CAA8C;IAC9C,OAAO,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAA2B;IAC9D,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAI,CAAC,CAAC,KAAgC,CAAC,QAAQ,CAAC;QAC9D,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,GAAI,CAAC,CAAC,KAA4B,CAAC,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAU;IAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,MAAM,KAAK,GAAsB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,IAAI,EAAE,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAmB,CAAC;IAErC,MAAM,KAAK,GAAsB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,IAAI,OAAO,GAAG,IAAI,CAAC;YACnB,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAI,IAAI,CAAC,KAAK,CAAC,KAAgC,CAAC,QAAQ,CAAC;gBACvE,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,KAA4B,CAAC,IAAI,CAAC;gBAC3D,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;YAC1B,CAAC;YACD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACrB,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5B,MAAM,KAAK,GAAsB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,EAAE,GAAI,IAAI,CAAC,KAAK,CAAC,KAA0B,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAqB;IACxD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEvC,MAAM,KAAK,GAAsB,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAUxB,CAAC;YACF,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACjF,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACnE,IAAI,EAAE,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;gBACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;gBACzC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;gBAC3C,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjF,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC9D,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU;oBACjC,CAAC,CAAE,KAAK,CAAC,OAA0C;oBACnD,CAAC,CAAC,SAAS,CAAC;gBAChB,MAAM,MAAM,GACV,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAE,KAAK,CAAC,MAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChF,MAAM,QAAQ,GAAc;oBAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,KAAK;oBACL,QAAQ;oBACR,QAAQ;oBACR,SAAS;oBACT,IAAI;oBACJ,QAAQ;iBACT,CAAC;gBACF,MAAM,IAAI,GACR,OAAO,IAAI,MAAM;oBACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;wBACZ,GAAG,QAAQ;wBACX,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC9B,CAAC;oBACJ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/runtime/widgetMeta.d.ts

@@ -1,157 +1,14 @@
 /**
- * packages/core/src/runtime/widgetMeta.ts — Widget metadata collection.
- *
- * Why: Extracts structured metadata from the committed runtime tree for use in
- * focus management, event routing, and input handling. These functions provide
- * deterministic traversal-order collections of widget properties.
- *
- * Collections:
- *   - focusableIds: enabled Buttons + Inputs in traversal order
- *   - enabledMap: all interactive widgets mapped to enabled state
- *   - pressableIds: Buttons that can produce "press" actions
- *   - inputMetaById: Input widget metadata (value, cursor, etc.)
- *   - focusZones: zone metadata with their contained focusable ids
- *   - focusTraps: trap metadata with their contained focusable ids
- *
- * @see docs/guide/runtime-and-layout.md
- */
-import type { FocusZoneNavigation } from "../widgets/types.js";
-import type { RuntimeInstance } from "./commit.js";
-import type { InstanceId } from "./instance.js";
-/**
- * Collect focusable ids from a committed runtime tree.
- *
- * - Order: depth-first preorder
- * - Children: left-to-right
- * - Focusable set: enabled Buttons + Inputs
- */
-export declare function collectFocusableIds(tree: RuntimeInstance): readonly string[];
-/**
- * Collect a deterministic enabled map (interactive id -> enabled) from a committed runtime tree.
- *
- * Interactive widgets (Buttons + Inputs) are always included when their `id` is a non-empty string;
- * enabled is `true` iff `disabled !== true`.
- */
-export declare function collectEnabledMap(tree: RuntimeInstance): ReadonlyMap<string, boolean>;
-/** Metadata for an Input widget instance. */
-export type InputMeta = Readonly<{
-    instanceId: InstanceId;
-    value: string;
-    disabled: boolean;
-    onInput?: (value: string, cursor: number) => void;
-    onBlur?: () => void;
-}>;
-/**
- * Collect ids that can produce a "press" action (Buttons).
- *
- * Includes Buttons with a non-empty string id, regardless of disabled state.
- */
-export declare function collectPressableIds(tree: RuntimeInstance): ReadonlySet<string>;
-/**
- * Collect a deterministic map of Input id -> { instanceId, value, disabled } from a committed runtime tree.
- *
- * Inputs are included when their `id` is a non-empty string and `value` is a string.
- */
-export declare function collectInputMetaById(tree: RuntimeInstance): ReadonlyMap<string, InputMeta>;
-/** Collected focus zone metadata. */
-export type CollectedZone = Readonly<{
-    id: string;
-    tabIndex: number;
-    navigation: FocusZoneNavigation;
-    columns: number;
-    wrapAround: boolean;
-    focusableIds: readonly string[];
-    onEnter?: () => void;
-    onExit?: () => void;
-}>;
-/** Collected focus trap metadata. */
-export type CollectedTrap = Readonly<{
-    id: string;
-    active: boolean;
-    returnFocusTo: string | null;
-    initialFocus: string | null;
-    focusableIds: readonly string[];
-}>;
-/**
- * Collect all focus zones from a committed runtime tree.
- *
- * - Order: depth-first preorder
- * - Each zone contains only the focusable ids directly within it (not in nested zones/traps)
- */
-export declare function collectFocusZones(tree: RuntimeInstance): ReadonlyMap<string, CollectedZone>;
-/**
- * Collect all focus traps from a committed runtime tree.
- *
- * - Order: depth-first preorder
- * - Each trap contains only the focusable ids directly within it (not in nested zones/traps)
- */
-export declare function collectFocusTraps(tree: RuntimeInstance): ReadonlyMap<string, CollectedTrap>;
-/**
- * All widget metadata collected in a single tree traversal.
- *
- * Replaces 6+ separate O(n) traversals with one O(n) pass.
- */
-export type CollectedWidgetMetadata = Readonly<{
-    focusableIds: readonly string[];
-    enabledById: ReadonlyMap<string, boolean>;
-    pressableIds: ReadonlySet<string>;
-    inputById: ReadonlyMap<string, InputMeta>;
-    zones: ReadonlyMap<string, CollectedZone>;
-    traps: ReadonlyMap<string, CollectedTrap>;
-    /**
-     * True when the tree contains widget kinds that require the routing-rebuild pass.
-     * Allows renderer fast-paths to skip an extra traversal for static/non-interactive trees.
-     */
-    hasRoutingWidgets: boolean;
-}>;
-/**
- * Reusable metadata collector that pools internal data structures.
- *
- * Instead of allocating new Maps/Sets/arrays on every frame, this class
- * clears and reuses its internal collections, reducing GC pressure.
- *
- * Usage:
- *   const collector = createWidgetMetadataCollector();
- *   // Each frame:
- *   const metadata = collector.collect(committedRoot);
- */
-export declare class WidgetMetadataCollector {
-    private readonly _focusableIds;
-    private readonly _enabledById;
-    private readonly _pressableIds;
-    private readonly _inputById;
-    private readonly _zoneDataById;
-    private readonly _trapDataById;
-    private readonly _zoneFocusables;
-    private readonly _trapFocusables;
-    private readonly _containerStack;
-    private readonly _stack;
-    private readonly _zones;
-    private readonly _traps;
-    /**
-     * Collect all widget metadata in a single tree traversal.
-     *
-     * Internal collections are cleared and reused to avoid allocations.
-     */
-    collect(tree: RuntimeInstance): CollectedWidgetMetadata;
-}
-/** Create a reusable widget metadata collector. */
-export declare function createWidgetMetadataCollector(): WidgetMetadataCollector;
-/**
- * Collect all widget metadata in a single tree traversal.
- *
- * This replaces:
- * - collectFocusableIds()
- * - collectEnabledMap()
- * - collectPressableIds()
- * - collectInputMetaById()
- * - collectFocusZones()
- * - collectFocusTraps()
- *
- * Performance: O(n) where n = number of nodes in the tree.
- *
- * Note: This function allocates new collections each call. For hot paths,
- * use createWidgetMetadataCollector() to reuse collections across frames.
- */
-export declare function collectAllWidgetMetadata(tree: RuntimeInstance): CollectedWidgetMetadata;
+ * packages/core/src/runtime/widgetMeta.ts — Public widget metadata API.
+ *
+ * Why: Keep the stable widget metadata entrypoint small while delegating
+ * concern-specific logic to internal modules under `runtime/widgetMeta/`.
+ */
+export type { CollectedWidgetMetadata } from "./widgetMeta/collector.js";
+export { WidgetMetadataCollector, collectAllWidgetMetadata, createWidgetMetadataCollector, } from "./widgetMeta/collector.js";
+export type { CollectedTrap, CollectedZone } from "./widgetMeta/focusContainers.js";
+export { collectFocusTraps, collectFocusZones } from "./widgetMeta/focusContainers.js";
+export type { FocusInfo } from "./widgetMeta/focusInfo.js";
+export type { InputMeta } from "./widgetMeta/helpers.js";
+export { collectEnabledMap, collectFocusableIds, collectInputMetaById, collectPressableIds, } from "./widgetMeta/helpers.js";
 //# sourceMappingURL=widgetMeta.d.ts.map

package/dist/runtime/widgetMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetMeta.d.ts","sourceRoot":"","sources":["../../src/runtime/widgetMeta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widgetMeta.d.ts","sourceRoot":"","sources":["../../src/runtime/widgetMeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}