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

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":"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"}

package/dist/runtime/widgetMeta.d.ts

@@ -1,177 +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 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 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 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>;
-/** 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;
-}>;
-/** Structured accessibility/focus semantics for a focusable widget. */
-export type FocusInfo = Readonly<{
-    id: string | null;
-    kind: RuntimeInstance["vnode"]["kind"] | null;
-    accessibleLabel: string | null;
-    visibleLabel: string | null;
-    required: boolean;
-    errors: readonly string[];
-    announcement: string | null;
-}>;
-/**
- * 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[];
-    parentZoneId?: string;
-    onEnter?: () => void;
-    onExit?: () => void;
-}>;
-/** Collected focus trap metadata. */
-export type CollectedTrap = Readonly<{
-    id: string;
-    kind?: "focusTrap" | "modal";
-    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[];
-    focusInfoById: ReadonlyMap<string, FocusInfo>;
-    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 _focusInfoById;
-    private readonly _enabledById;
-    private readonly _pressableIds;
-    private readonly _inputById;
-    private readonly _focusContainerKindsById;
-    private readonly _zoneDataById;
-    private readonly _trapDataById;
-    private readonly _zoneFocusables;
-    private readonly _trapFocusables;
-    private readonly _containerStack;
-    private readonly _fieldStack;
-    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"}