@rezi-ui/core 0.1.0-alpha.7 → 0.1.0-alpha.71

package/dist/runtime/widgetMeta/collector.js

@@ -0,0 +1,293 @@
+import { getWidgetProtocol } from "../../widgets/protocol.js";
+import { recordFocusContainerId } from "./focusContainers.js";
+import { buildFocusInfo, readFieldContext } from "./focusInfo.js";
+import { isEnabledInteractive, isFocusableInteractive, readInteractiveId } from "./helpers.js";
+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.
+ */
+export function collectAllWidgetMetadata(tree) {
+    // Use a one-shot collector (allocates, but preserves API compatibility)
+    const collector = new WidgetMetadataCollector();
+    return collector.collect(tree);
+}
+//# sourceMappingURL=collector.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { FocusZoneNavigation } from "../../widgets/types.js";
+import type { RuntimeInstance } from "../commit.js";
+export type FocusContainerKind = "focusZone" | "focusTrap" | "modal";
+export type ContainerInfo = {
+    kind: "zone" | "trap";
+    id: string;
+};
+export declare function recordFocusContainerId(seen: Map<string, FocusContainerKind>, id: string, kind: FocusContainerKind): void;
+/** 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>;
+//# sourceMappingURL=focusContainers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusContainers.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/focusContainers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAUlE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAMN;AAED,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC,CAAC;AA0DH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CA0F3F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAuD3F"}

package/dist/runtime/widgetMeta/focusContainers.js

@@ -0,0 +1,190 @@
+import { ZrUiError } from "../../abi.js";
+import { isEnabledInteractive, isFocusableInteractive } from "./helpers.js";
+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.`;
+}
+export 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 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;
+}
+//# sourceMappingURL=focusContainers.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { RuntimeInstance } from "../commit.js";
+/** 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;
+}>;
+export type FieldContext = Readonly<{
+    label: string | null;
+    required: boolean;
+    error: string | null;
+}>;
+export declare function readFieldContext(vnode: RuntimeInstance["vnode"]): FieldContext | null;
+export declare function buildFocusInfo(vnode: RuntimeInstance["vnode"], id: string, fieldStack: readonly FieldContext[]): FocusInfo;
+//# sourceMappingURL=focusInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusInfo.d.ts","sourceRoot":"","sources":["../../../src/runtime/widgetMeta/focusInfo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC,CAAC;AAmHH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI,CAYrF;AA8CD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAC/B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,SAAS,CAoBX"}