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

package/dist/runtime/widgetMeta.js

@@ -1,851 +1,10 @@
 /**
- * packages/core/src/runtime/widgetMeta.ts — Widget metadata collection.
+ * packages/core/src/runtime/widgetMeta.ts — Public widget metadata API.
  *
- * 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 focusable widgets 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 { ZrUiError } from "../abi.js";
-import { getWidgetProtocol, kindIsFocusable, kindIsPressable } from "../widgets/protocol.js";
-/** Extract interactive widget ID from a node with a valid `id` prop. */
-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;
-}
-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);
-}
-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;
-}
-function duplicateFocusContainerDetail(id, firstKind, secondKind) {
-    return `Duplicate focus container id "${id}". First: <${firstKind}>, second: <${secondKind}>. Hint: focusZone, focusTrap, and modal ids must be unique across the tree.`;
-}
-function recordFocusContainerId(seen, id, kind) {
-    const existing = seen.get(id);
-    if (existing !== undefined) {
-        throw new ZrUiError("ZRUI_DUPLICATE_ID", duplicateFocusContainerDetail(id, existing, kind));
-    }
-    seen.set(id, kind);
-}
-/**
- * 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;
-}
-const EMPTY_ERRORS = Object.freeze([]);
-function readNonEmptyString(v) {
-    if (typeof v !== "string")
-        return null;
-    const trimmed = v.trim();
-    return trimmed.length > 0 ? trimmed : null;
-}
-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
-                : [];
-            for (const option of options) {
-                if (typeof option?.value === "string" &&
-                    option.value === value &&
-                    typeof option.label === "string") {
-                    return readNonEmptyString(option.label);
-                }
-            }
-            return readNonEmptyString(props.placeholder);
-        }
-        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";
-    }
-}
-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(" — ");
-}
-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),
-    });
-}
-/**
- * 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;
-}
-/**
- * Collect focusable ids from a subtree (not traversing into nested zones/traps/modals).
- */
-function collectFocusableIdsInSubtree(node) {
-    const out = [];
-    const stack = [node];
-    while (stack.length > 0) {
-        const cur = stack.pop();
-        if (!cur)
-            continue;
-        // Don't traverse into nested zones or traps.
-        if (cur.vnode.kind === "focusZone" ||
-            cur.vnode.kind === "focusTrap" ||
-            cur.vnode.kind === "modal") {
-            continue;
-        }
-        const id = isFocusableInteractive(cur.vnode) ? isEnabledInteractive(cur.vnode) : null;
-        if (id !== null)
-            out.push(id);
-        for (let i = cur.children.length - 1; i >= 0; i--) {
-            const c = cur.children[i];
-            if (c)
-                stack.push(c);
-        }
-    }
-    return Object.freeze(out);
-}
-function collectFocusableIdsInTrapSubtree(node) {
-    const out = [];
-    const stack = [node];
-    while (stack.length > 0) {
-        const current = stack.pop();
-        if (!current)
-            continue;
-        if (current.vnode.kind === "focusTrap" || current.vnode.kind === "modal") {
-            continue;
-        }
-        const id = isFocusableInteractive(current.vnode) ? isEnabledInteractive(current.vnode) : null;
-        if (id !== null)
-            out.push(id);
-        for (let i = current.children.length - 1; i >= 0; i--) {
-            const child = current.children[i];
-            if (child)
-                stack.push(child);
-        }
-    }
-    return Object.freeze(out);
-}
-/**
- * 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 function collectFocusZones(tree) {
-    const m = new Map();
-    const seen = new Map();
-    const stack = [
-        { node: tree, parentZoneId: null },
-    ];
-    while (stack.length > 0) {
-        const item = stack.pop();
-        if (!item)
-            continue;
-        const node = item.node;
-        if (node.vnode.kind === "focusZone") {
-            const props = node.vnode.props;
-            const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
-            if (id !== null) {
-                recordFocusContainerId(seen, id, "focusZone");
-                const tabIndex = typeof props.tabIndex === "number" ? props.tabIndex : 0;
-                const navigation = props.navigation === "linear" ||
-                    props.navigation === "grid" ||
-                    props.navigation === "none"
-                    ? props.navigation
-                    : "linear";
-                const columns = typeof props.columns === "number" && props.columns > 0 ? props.columns : 1;
-                const wrapAround = props.wrapAround !== false;
-                const onEnter = typeof props.onEnter === "function" ? props.onEnter : undefined;
-                const onExit = typeof props.onExit === "function" ? props.onExit : undefined;
-                // Collect focusable ids from zone children (not traversing into nested zones/traps)
-                const focusableIds = [];
-                for (const child of node.children) {
-                    if (child.vnode.kind === "focusZone" ||
-                        child.vnode.kind === "focusTrap" ||
-                        child.vnode.kind === "modal") {
-                        continue;
-                    }
-                    const childFocusables = collectFocusableIdsInSubtree(child);
-                    focusableIds.push(...childFocusables);
-                }
-                const zone = {
-                    id,
-                    tabIndex,
-                    navigation,
-                    columns,
-                    wrapAround,
-                    focusableIds: Object.freeze(focusableIds),
-                };
-                if (item.parentZoneId !== null) {
-                    zone.parentZoneId = item.parentZoneId;
-                }
-                if (onEnter !== undefined) {
-                    zone.onEnter = onEnter;
-                }
-                if (onExit !== undefined) {
-                    zone.onExit = onExit;
-                }
-                m.set(id, Object.freeze(zone));
-            }
-        }
-        // Continue traversing children for nested zones
-        let childParentZoneId = item.parentZoneId;
-        if (node.vnode.kind === "focusZone") {
-            const zoneId = node.vnode.props.id;
-            if (typeof zoneId === "string" && zoneId.length > 0) {
-                childParentZoneId = zoneId;
-            }
-        }
-        for (let i = node.children.length - 1; i >= 0; i--) {
-            const c = node.children[i];
-            if (c)
-                stack.push({ node: c, parentZoneId: childParentZoneId ?? null });
-        }
-    }
-    return m;
-}
-/**
- * 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 function collectFocusTraps(tree) {
-    const m = new Map();
-    const seen = new Map();
-    const stack = [tree];
-    while (stack.length > 0) {
-        const node = stack.pop();
-        if (!node)
-            continue;
-        if (node.vnode.kind === "focusTrap" || node.vnode.kind === "modal") {
-            const props = node.vnode.props;
-            const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
-            if (id !== null) {
-                recordFocusContainerId(seen, id, node.vnode.kind);
-                const active = node.vnode.kind === "modal" ? true : props.active === true;
-                const returnFocusTo = typeof props.returnFocusTo === "string" ? props.returnFocusTo : null;
-                const initialFocus = typeof props.initialFocus === "string" ? props.initialFocus : null;
-                // Collect focusable ids from trap children, including nested zones but
-                // excluding nested traps/modals which manage their own focus scope.
-                const focusableIds = [];
-                for (const child of node.children) {
-                    if (child.vnode.kind === "focusTrap" || child.vnode.kind === "modal")
-                        continue;
-                    const childFocusables = collectFocusableIdsInTrapSubtree(child);
-                    focusableIds.push(...childFocusables);
-                }
-                m.set(id, Object.freeze({
-                    id,
-                    kind: node.vnode.kind,
-                    active,
-                    returnFocusTo,
-                    initialFocus,
-                    focusableIds: Object.freeze(focusableIds),
-                }));
-            }
-        }
-        // Continue traversing children for nested traps
-        for (let i = node.children.length - 1; i >= 0; i--) {
-            const c = node.children[i];
-            if (c)
-                stack.push(c);
-        }
-    }
-    return m;
-}
-function requiresRoutingRebuild(vnode) {
-    return getWidgetProtocol(vnode.kind).requiresRoutingRebuild;
-}
-/**
- * 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 class WidgetMetadataCollector {
-    // Output collections (reused)
-    _focusableIds = [];
-    _focusInfoById = new Map();
-    _enabledById = new Map();
-    _pressableIds = new Set();
-    _inputById = new Map();
-    // Zone/trap intermediate data (reused)
-    _focusContainerKindsById = new Map();
-    _zoneDataById = new Map();
-    _trapDataById = new Map();
-    _zoneFocusables = new Map();
-    _trapFocusables = new Map();
-    // Container stack for tracking current zone/trap nesting (reused)
-    _containerStack = [];
-    _fieldStack = [];
-    // Traversal stack (reused)
-    _stack = [];
-    // Final output maps (reused)
-    _zones = new Map();
-    _traps = new Map();
-    /**
-     * Collect all widget metadata in a single tree traversal.
-     *
-     * Internal collections are cleared and reused to avoid allocations.
-     */
-    collect(tree) {
-        // Clear all reusable collections
-        this._focusableIds.length = 0;
-        this._focusInfoById.clear();
-        this._enabledById.clear();
-        this._pressableIds.clear();
-        this._inputById.clear();
-        this._focusContainerKindsById.clear();
-        this._zoneDataById.clear();
-        this._trapDataById.clear();
-        this._zoneFocusables.clear();
-        this._trapFocusables.clear();
-        this._containerStack.length = 0;
-        this._fieldStack.length = 0;
-        this._stack.length = 0;
-        this._zones.clear();
-        this._traps.clear();
-        let hasRoutingWidgets = false;
-        this._stack.push({ type: "node", node: tree });
-        while (this._stack.length > 0) {
-            const item = this._stack.pop();
-            if (!item)
-                continue;
-            // Handle exit markers.
-            if (item.type === "containerExit") {
-                this._containerStack.pop();
-                continue;
-            }
-            if (item.type === "fieldExit") {
-                this._fieldStack.pop();
-                continue;
-            }
-            const node = item.node;
-            const vnode = node.vnode;
-            if (!hasRoutingWidgets && requiresRoutingRebuild(vnode)) {
-                hasRoutingWidgets = true;
-            }
-            const fieldContext = readFieldContext(vnode);
-            if (fieldContext !== null) {
-                this._fieldStack.push(fieldContext);
-                this._stack.push({ type: "fieldExit" });
-            }
-            // --- Collect focusable IDs ---
-            const focusableId = isFocusableInteractive(vnode) ? isEnabledInteractive(vnode) : null;
-            if (focusableId !== null) {
-                this._focusableIds.push(focusableId);
-                if (!this._focusInfoById.has(focusableId)) {
-                    this._focusInfoById.set(focusableId, buildFocusInfo(vnode, focusableId, this._fieldStack));
-                }
-                for (let i = this._containerStack.length - 1; i >= 0; i--) {
-                    const container = this._containerStack[i];
-                    if (container?.kind === "trap") {
-                        break;
-                    }
-                    if (container?.kind === "zone") {
-                        this._zoneFocusables.get(container.id)?.push(focusableId);
-                        break;
-                    }
-                }
-                for (let i = this._containerStack.length - 1; i >= 0; i--) {
-                    const container = this._containerStack[i];
-                    if (container?.kind === "trap") {
-                        this._trapFocusables.get(container.id)?.push(focusableId);
-                        break;
-                    }
-                }
-            }
-            // --- Collect enabled map ---
-            const interactiveId = readInteractiveId(vnode);
-            if (interactiveId !== null && !this._enabledById.has(interactiveId)) {
-                let enabled = true;
-                const proto = getWidgetProtocol(vnode.kind);
-                if (proto.disableable) {
-                    const disabled = vnode.props.disabled;
-                    enabled = disabled !== true;
-                }
-                if (proto.openGated) {
-                    const open = vnode.props.open;
-                    enabled = open === true;
-                }
-                this._enabledById.set(interactiveId, enabled);
-            }
-            // --- Collect pressable IDs ---
-            if (vnode.kind === "button" || vnode.kind === "link") {
-                const id = vnode.props.id;
-                if (typeof id === "string" && id.length > 0) {
-                    this._pressableIds.add(id);
-                }
-            }
-            // --- Collect input metadata ---
-            if (vnode.kind === "input") {
-                const props = 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 && !this._inputById.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);
-                    this._inputById.set(id, meta);
-                }
-            }
-            // --- Collect focus zones ---
-            if (vnode.kind === "focusZone") {
-                const props = vnode.props;
-                const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
-                if (id !== null) {
-                    recordFocusContainerId(this._focusContainerKindsById, id, "focusZone");
-                    const tabIndex = typeof props.tabIndex === "number" ? props.tabIndex : 0;
-                    const navigation = props.navigation === "linear" ||
-                        props.navigation === "grid" ||
-                        props.navigation === "none"
-                        ? props.navigation
-                        : "linear";
-                    const columns = typeof props.columns === "number" && props.columns > 0 ? props.columns : 1;
-                    const wrapAround = props.wrapAround !== false;
-                    const onEnter = typeof props.onEnter === "function" ? props.onEnter : undefined;
-                    const onExit = typeof props.onExit === "function" ? props.onExit : undefined;
-                    let parentZoneId = null;
-                    for (let i = this._containerStack.length - 1; i >= 0; i--) {
-                        const container = this._containerStack[i];
-                        if (container?.kind === "zone") {
-                            parentZoneId = container.id;
-                            break;
-                        }
-                    }
-                    const zoneData = { id, tabIndex, navigation, columns, wrapAround };
-                    if (parentZoneId !== null) {
-                        zoneData.parentZoneId = parentZoneId;
-                    }
-                    if (onEnter !== undefined) {
-                        zoneData.onEnter = onEnter;
-                    }
-                    if (onExit !== undefined) {
-                        zoneData.onExit = onExit;
-                    }
-                    this._zoneDataById.set(id, zoneData);
-                    this._zoneFocusables.set(id, []);
-                    // Push exit marker and enter container
-                    const container = { kind: "zone", id };
-                    this._containerStack.push(container);
-                    this._stack.push({ type: "containerExit", container });
-                }
-            }
-            // --- Collect focus traps ---
-            if (vnode.kind === "focusTrap" || vnode.kind === "modal") {
-                const props = vnode.props;
-                const id = typeof props.id === "string" && props.id.length > 0 ? props.id : null;
-                if (id !== null) {
-                    recordFocusContainerId(this._focusContainerKindsById, id, vnode.kind);
-                    const active = vnode.kind === "modal" ? true : props.active === true;
-                    const returnFocusTo = typeof props.returnFocusTo === "string" ? props.returnFocusTo : null;
-                    const initialFocus = typeof props.initialFocus === "string" ? props.initialFocus : null;
-                    this._trapDataById.set(id, {
-                        id,
-                        active,
-                        returnFocusTo,
-                        initialFocus,
-                    });
-                    this._trapFocusables.set(id, []);
-                    // Push exit marker and enter container
-                    const container = { kind: "trap", id };
-                    this._containerStack.push(container);
-                    this._stack.push({ type: "containerExit", container });
-                }
-            }
-            // Push children in reverse order for correct traversal order
-            for (let i = node.children.length - 1; i >= 0; i--) {
-                const c = node.children[i];
-                if (c)
-                    this._stack.push({ type: "node", node: c });
-            }
-        }
-        // Build final zones with focusableIds
-        for (const [id, data] of this._zoneDataById) {
-            const focusables = this._zoneFocusables.get(id) ?? [];
-            this._zones.set(id, Object.freeze({
-                ...data,
-                focusableIds: Object.freeze(focusables.slice()),
-            }));
-        }
-        // Build final traps with focusableIds
-        for (const [id, data] of this._trapDataById) {
-            const focusables = this._trapFocusables.get(id) ?? [];
-            this._traps.set(id, Object.freeze({
-                ...data,
-                focusableIds: Object.freeze(focusables.slice()),
-            }));
-        }
-        return Object.freeze({
-            focusableIds: Object.freeze(this._focusableIds.slice()),
-            focusInfoById: new Map(this._focusInfoById),
-            enabledById: new Map(this._enabledById),
-            pressableIds: new Set(this._pressableIds),
-            inputById: new Map(this._inputById),
-            zones: new Map(this._zones),
-            traps: new Map(this._traps),
-            hasRoutingWidgets,
-        });
-    }
-}
-/** Create a reusable widget metadata collector. */
-export function createWidgetMetadataCollector() {
-    return new 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.
+ * Why: Keep the stable widget metadata entrypoint small while delegating
+ * concern-specific logic to internal modules under `runtime/widgetMeta/`.
  */
-export function collectAllWidgetMetadata(tree) {
-    // Use a one-shot collector (allocates, but preserves API compatibility)
-    const collector = new WidgetMetadataCollector();
-    return collector.collect(tree);
-}
+export { WidgetMetadataCollector, collectAllWidgetMetadata, createWidgetMetadataCollector, } from "./widgetMeta/collector.js";
+export { collectFocusTraps, collectFocusZones } from "./widgetMeta/focusContainers.js";
+export { collectEnabledMap, collectFocusableIds, collectInputMetaById, collectPressableIds, } from "./widgetMeta/helpers.js";
 //# sourceMappingURL=widgetMeta.js.map