@slowclap/rezi-core 0.1.0-fork.1

package/dist/runtime/router/types.d.ts

@@ -0,0 +1,230 @@
+import type { TableSelectionMode } from "../../widgets/table.js";
+import type { FlattenedNode } from "../../widgets/tree.js";
+import type { DropdownItem, ItemHeightSpec } from "../../widgets/types.js";
+import type { FocusZone } from "../focus.js";
+import type { TableLocalState, TreeLocalState, VirtualListLocalState } from "../localState.js";
+import type { CollectedTrap } from "../widgetMeta.js";
+/** Map of interactive widget ID to enabled state. */
+export type EnabledById = ReadonlyMap<string, boolean>;
+/**
+ * Action produced by event routing.
+ *   - press: Button-like widget activation
+ *   - input: Text input edit
+ *   - select: List-like item selection
+ *   - rowPress: Table row activation
+ *   - toggle/change: Value change for boolean/choice widgets
+ *   - activate: Tree node activation
+ *   - scroll: Scroll position updates
+ */
+export type RoutedAction = Readonly<{
+    id: string;
+    action: "press";
+}> | Readonly<{
+    id: string;
+    action: "input";
+    value: string;
+    cursor: number;
+}> | Readonly<{
+    id: string;
+    action: "select";
+    index: number;
+    item?: unknown;
+}> | Readonly<{
+    id: string;
+    action: "rowPress";
+    rowIndex: number;
+    row?: unknown;
+}> | Readonly<{
+    id: string;
+    action: "toggle";
+    checked: boolean;
+}> | Readonly<{
+    id: string;
+    action: "change";
+    value: unknown;
+}> | Readonly<{
+    id: string;
+    action: "activate";
+    nodeKey: string;
+}> | Readonly<{
+    id: string;
+    action: "scroll";
+    scrollTop: number;
+}>;
+/**
+ * Result of routing an event.
+ *   - nextFocusedId: new focus target (undefined = no change)
+ *   - nextPressedId: new pressed widget (undefined = no change)
+ *   - action: emitted action if widget was activated
+ */
+export type RoutingResult = Readonly<{
+    nextFocusedId?: string | null;
+    nextPressedId?: string | null;
+    action?: RoutedAction;
+}>;
+export type KeyRoutingCtx = Readonly<{
+    focusedId: string | null;
+    focusList: readonly string[];
+    enabledById: EnabledById;
+    /**
+     * Optional set of ids that can produce a "press" action (Buttons).
+     * When omitted, routing behaves as in MVP (all enabled focused ids are pressable).
+     */
+    pressableIds?: ReadonlySet<string>;
+}>;
+export type MouseRoutingCtx = Readonly<{
+    pressedId: string | null;
+    /**
+     * Hit-test winner id for the mouse point, computed by the layout/hitTest module.
+     * This router MUST NOT re-implement hit testing.
+     */
+    hitTestTargetId: string | null;
+    enabledById: EnabledById;
+    /**
+     * Optional set of ids that can produce a "press" action (Buttons).
+     * When omitted, routing behaves as in MVP (all enabled hit targets are pressable).
+     */
+    pressableIds?: ReadonlySet<string>;
+}>;
+/** Extended routing result with zone tracking. */
+export type RoutingResultWithZones = RoutingResult & Readonly<{
+    nextZoneId?: string | null;
+}>;
+/** Extended key routing context with zone and trap support. */
+export type KeyRoutingCtxWithZones = Readonly<{
+    focusedId: string | null;
+    activeZoneId: string | null;
+    focusList: readonly string[];
+    zones: ReadonlyMap<string, FocusZone>;
+    lastFocusedByZone?: ReadonlyMap<string, string>;
+    traps: ReadonlyMap<string, CollectedTrap>;
+    trapStack: readonly string[];
+    enabledById: EnabledById;
+    pressableIds?: ReadonlySet<string>;
+}>;
+/** Routing context for virtual list keyboard navigation. */
+export type VirtualListRoutingCtx<T = unknown> = Readonly<{
+    virtualListId: string;
+    items: readonly T[];
+    itemHeight: ItemHeightSpec<T>;
+    measuredHeights?: ReadonlyMap<number, number>;
+    state: VirtualListLocalState;
+    keyboardNavigation: boolean;
+    wrapAround: boolean;
+}>;
+/** Result of virtual list key routing. */
+export type VirtualListRoutingResult = Readonly<{
+    nextSelectedIndex?: number;
+    nextScrollTop?: number;
+    action?: {
+        id: string;
+        action: "select";
+        index: number;
+    };
+}>;
+/** Routing context for virtual list mouse wheel. */
+export type VirtualListWheelCtx = Readonly<{
+    scrollTop: number;
+    totalHeight: number;
+    viewportHeight: number;
+    scrollDirection?: "natural" | "traditional";
+}>;
+/** Layer routing context. */
+export type LayerRoutingCtx = Readonly<{
+    /** Stack of active layer IDs (topmost last). */
+    layerStack: readonly string[];
+    /** Map of layer ID to close-on-escape flag. */
+    closeOnEscape: ReadonlyMap<string, boolean>;
+    /** Map of layer ID to onClose callback. */
+    onClose: ReadonlyMap<string, () => void>;
+}>;
+/** Layer routing result. */
+export type LayerRoutingResult = Readonly<{
+    /** Layer that was closed, if any. */
+    closedLayerId?: string;
+    /** Error thrown by the close callback, if any. */
+    callbackError?: unknown;
+    /** Whether the event was consumed. */
+    consumed: boolean;
+}>;
+/** Dropdown routing context. */
+export type DropdownRoutingCtx = Readonly<{
+    /** Dropdown ID. */
+    dropdownId: string;
+    /** Dropdown items. */
+    items: readonly DropdownItem[];
+    /** Currently selected item index. */
+    selectedIndex: number;
+    /** Callback when item is selected. */
+    onSelect?: (item: DropdownItem) => void;
+    /** Callback when dropdown should close. */
+    onClose?: () => void;
+}>;
+/** Dropdown routing result. */
+export type DropdownRoutingResult = Readonly<{
+    /** New selected index. */
+    nextSelectedIndex?: number;
+    /** Item that was activated, if any. */
+    activatedItem?: DropdownItem;
+    /** Whether the dropdown should close. */
+    shouldClose?: boolean;
+    /** Whether the event was consumed. */
+    consumed: boolean;
+}>;
+/** Routing context for table keyboard navigation. */
+export type TableRoutingCtx<T = unknown> = Readonly<{
+    tableId: string;
+    rowKeys: readonly string[];
+    rowKeyToIndex?: ReadonlyMap<string, number>;
+    data: readonly T[];
+    rowHeight: number;
+    state: TableLocalState;
+    selection: readonly string[];
+    selectionMode: TableSelectionMode;
+    keyboardNavigation: boolean;
+}>;
+/** Result of table key routing. */
+export type TableRoutingResult = Readonly<{
+    /** New focused row index. */
+    nextFocusedRowIndex?: number;
+    /** New scroll position. */
+    nextScrollTop?: number;
+    /** New selection. */
+    nextSelection?: readonly string[];
+    /** Last clicked key (for shift-select). */
+    nextLastClickedKey?: string | null;
+    /** Action to emit. */
+    action?: {
+        id: string;
+        action: "rowPress";
+        rowIndex: number;
+    };
+    /** Whether the event was consumed. */
+    consumed: boolean;
+}>;
+/** Routing context for tree keyboard navigation. */
+export type TreeRoutingCtx<T = unknown> = Readonly<{
+    treeId: string;
+    flatNodes: readonly FlattenedNode<T>[];
+    expanded: readonly string[];
+    state: TreeLocalState;
+    keyboardNavigation: boolean;
+}>;
+/** Result of tree key routing. */
+export type TreeRoutingResult = Readonly<{
+    /** New focused node key. */
+    nextFocusedKey?: string | null;
+    /** New expanded set. */
+    nextExpanded?: readonly string[];
+    /** Node to select. */
+    nodeToSelect?: string;
+    /** Node to activate. */
+    nodeToActivate?: string;
+    /** Node that needs children loaded. */
+    nodeToLoad?: string;
+    /** New scroll position. */
+    nextScrollTop?: number;
+    /** Whether the event was consumed. */
+    consumed: boolean;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/router/types.d.ts.map

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

package/dist/runtime/router/types.js

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

package/dist/runtime/router/types.js.map

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

package/dist/runtime/router/virtualList.d.ts

@@ -0,0 +1,21 @@
+import type { ZrevEvent } from "../../events.js";
+import type { VirtualListRoutingCtx, VirtualListRoutingResult, VirtualListWheelCtx } from "./types.js";
+/**
+ * Route keyboard events for virtual list navigation.
+ *
+ * Navigation keys:
+ *   - ArrowUp/Down: Move selection by 1, auto-scroll to keep visible
+ *   - PageUp/PageDown: Move by floor(viewportHeight / avgItemHeight) items
+ *   - Home/End: Jump to first/last item
+ *   - Enter/Space: Emit select action for current item
+ */
+export declare function routeVirtualListKey<T>(event: ZrevEvent, ctx: VirtualListRoutingCtx<T>): VirtualListRoutingResult;
+/**
+ * Route mouse wheel events for virtual list scrolling.
+ *
+ * @param event - The ZREV event
+ * @param ctx - Wheel routing context
+ * @returns New scrollTop value if scrolling occurred
+ */
+export declare function routeVirtualListWheel(event: ZrevEvent, ctx: VirtualListWheelCtx): VirtualListRoutingResult;
+//# sourceMappingURL=virtualList.d.ts.map

package/dist/runtime/router/virtualList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualList.d.ts","sourceRoot":"","sources":["../../../src/runtime/router/virtualList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AASjD,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAapB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC5B,wBAAwB,CAuJ1B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,mBAAmB,GACvB,wBAAwB,CAiB1B"}

package/dist/runtime/router/virtualList.js

@@ -0,0 +1,180 @@
+import { clampScrollTop, computeVisibleRange, ensureVisible, getItemHeight, getItemOffset, getTotalHeight, } from "../../widgets/virtualList.js";
+/* --- Key Codes (locked by engine ABI) --- */
+/* MUST match packages/core/src/keybindings/keyCodes.ts */
+const ZR_KEY_ENTER = 2;
+const ZR_KEY_HOME = 12;
+const ZR_KEY_END = 13;
+const ZR_KEY_PAGE_UP = 14;
+const ZR_KEY_PAGE_DOWN = 15;
+const ZR_KEY_UP = 20;
+const ZR_KEY_DOWN = 21;
+const ZR_KEY_SPACE = 32; /* Space as ASCII codepoint in ZREV key events */
+/**
+ * Route keyboard events for virtual list navigation.
+ *
+ * Navigation keys:
+ *   - ArrowUp/Down: Move selection by 1, auto-scroll to keep visible
+ *   - PageUp/PageDown: Move by floor(viewportHeight / avgItemHeight) items
+ *   - Home/End: Jump to first/last item
+ *   - Enter/Space: Emit select action for current item
+ */
+export function routeVirtualListKey(event, ctx) {
+    if (event.kind !== "key")
+        return Object.freeze({});
+    if (event.action !== "down")
+        return Object.freeze({});
+    if (!ctx.keyboardNavigation)
+        return Object.freeze({});
+    const { items, itemHeight, measuredHeights, state, wrapAround, virtualListId } = ctx;
+    const { selectedIndex, scrollTop, viewportHeight } = state;
+    const itemCount = items.length;
+    if (itemCount === 0)
+        return Object.freeze({});
+    const clampedSelectedIndex = Math.max(0, Math.min(itemCount - 1, selectedIndex));
+    const repairStaleSelection = () => {
+        if (selectedIndex !== clampedSelectedIndex) {
+            return Object.freeze({ nextSelectedIndex: clampedSelectedIndex });
+        }
+        return Object.freeze({});
+    };
+    // Helper to compute scroll position for a given selection
+    const scrollToIndex = (index) => {
+        const offset = getItemOffset(items, itemHeight, index, measuredHeights);
+        const height = getItemHeight(items, itemHeight, index, measuredHeights);
+        const totalHeight = getTotalHeight(items, itemHeight, measuredHeights);
+        const newScrollTop = ensureVisible(scrollTop, viewportHeight, offset, height);
+        return clampScrollTop(newScrollTop, totalHeight, viewportHeight);
+    };
+    // Compute items per page for PageUp/PageDown
+    const computePageSize = () => {
+        if (typeof itemHeight === "number" &&
+            (measuredHeights === undefined || measuredHeights.size === 0)) {
+            const safeItemHeight = itemHeight > 0 ? itemHeight : 1;
+            const safeViewportHeight = Math.max(0, viewportHeight);
+            return Math.max(1, Math.floor(safeViewportHeight / safeItemHeight));
+        }
+        // Variable heights: compute viewport-only visible range (overscan=0).
+        // state.startIndex/endIndex can include renderer overscan and inflate page jumps.
+        const viewportRange = computeVisibleRange(items, itemHeight, scrollTop, viewportHeight, 0, measuredHeights);
+        const visibleCount = viewportRange.endIndex - viewportRange.startIndex;
+        if (visibleCount > 0) {
+            return Math.max(1, visibleCount);
+        }
+        // Fallback: estimate average item height from first few items
+        let sampleHeight = 0;
+        const sampleCount = Math.min(10, itemCount);
+        for (let i = 0; i < sampleCount; i++) {
+            const item = items[i];
+            if (item !== undefined) {
+                sampleHeight += getItemHeight(items, itemHeight, i, measuredHeights);
+            }
+        }
+        const avgHeight = sampleCount > 0 ? sampleHeight / sampleCount : 1;
+        return Math.max(1, Math.floor(viewportHeight / avgHeight));
+    };
+    // Move selection up
+    if (event.key === ZR_KEY_UP) {
+        let nextIndex = clampedSelectedIndex - 1;
+        if (nextIndex < 0) {
+            nextIndex = wrapAround ? itemCount - 1 : 0;
+        }
+        if (nextIndex === clampedSelectedIndex)
+            return repairStaleSelection();
+        const newScrollTop = scrollToIndex(nextIndex);
+        if (newScrollTop !== scrollTop) {
+            return Object.freeze({ nextSelectedIndex: nextIndex, nextScrollTop: newScrollTop });
+        }
+        return Object.freeze({ nextSelectedIndex: nextIndex });
+    }
+    // Move selection down
+    if (event.key === ZR_KEY_DOWN) {
+        let nextIndex = clampedSelectedIndex + 1;
+        if (nextIndex >= itemCount) {
+            nextIndex = wrapAround ? 0 : itemCount - 1;
+        }
+        if (nextIndex === clampedSelectedIndex)
+            return repairStaleSelection();
+        const newScrollTop = scrollToIndex(nextIndex);
+        if (newScrollTop !== scrollTop) {
+            return Object.freeze({ nextSelectedIndex: nextIndex, nextScrollTop: newScrollTop });
+        }
+        return Object.freeze({ nextSelectedIndex: nextIndex });
+    }
+    // Page up
+    if (event.key === ZR_KEY_PAGE_UP) {
+        const pageSize = computePageSize();
+        const nextIndex = Math.max(0, clampedSelectedIndex - pageSize);
+        if (nextIndex === clampedSelectedIndex)
+            return repairStaleSelection();
+        const newScrollTop = scrollToIndex(nextIndex);
+        if (newScrollTop !== scrollTop) {
+            return Object.freeze({ nextSelectedIndex: nextIndex, nextScrollTop: newScrollTop });
+        }
+        return Object.freeze({ nextSelectedIndex: nextIndex });
+    }
+    // Page down
+    if (event.key === ZR_KEY_PAGE_DOWN) {
+        const pageSize = computePageSize();
+        const nextIndex = Math.min(itemCount - 1, clampedSelectedIndex + pageSize);
+        if (nextIndex === clampedSelectedIndex)
+            return repairStaleSelection();
+        const newScrollTop = scrollToIndex(nextIndex);
+        if (newScrollTop !== scrollTop) {
+            return Object.freeze({ nextSelectedIndex: nextIndex, nextScrollTop: newScrollTop });
+        }
+        return Object.freeze({ nextSelectedIndex: nextIndex });
+    }
+    // Home - jump to first item
+    if (event.key === ZR_KEY_HOME) {
+        if (clampedSelectedIndex === 0)
+            return repairStaleSelection();
+        return Object.freeze({
+            nextSelectedIndex: 0,
+            nextScrollTop: 0,
+        });
+    }
+    // End - jump to last item
+    if (event.key === ZR_KEY_END) {
+        const lastIndex = itemCount - 1;
+        if (clampedSelectedIndex === lastIndex)
+            return repairStaleSelection();
+        const totalHeight = getTotalHeight(items, itemHeight, measuredHeights);
+        const nextScrollTop = clampScrollTop(totalHeight, totalHeight, viewportHeight);
+        return Object.freeze({
+            nextSelectedIndex: lastIndex,
+            nextScrollTop,
+        });
+    }
+    // Enter/Space - emit select action
+    if (event.key === ZR_KEY_ENTER || event.key === ZR_KEY_SPACE) {
+        return Object.freeze({
+            action: { id: virtualListId, action: "select", index: clampedSelectedIndex },
+        });
+    }
+    return Object.freeze({});
+}
+/**
+ * Route mouse wheel events for virtual list scrolling.
+ *
+ * @param event - The ZREV event
+ * @param ctx - Wheel routing context
+ * @returns New scrollTop value if scrolling occurred
+ */
+export function routeVirtualListWheel(event, ctx) {
+    if (event.kind !== "mouse")
+        return Object.freeze({});
+    // Mouse kind 5 is scroll/wheel
+    if (event.mouseKind !== 5)
+        return Object.freeze({});
+    const SCROLL_LINES = 3; // Lines per wheel tick
+    // Use wheelY for vertical scrolling (negative = scroll up, positive = scroll down).
+    // "natural" flips wheelY to track trackpad-style content movement.
+    const sign = ctx.scrollDirection === "natural" ? -1 : 1;
+    const scrollDelta = sign * event.wheelY * SCROLL_LINES;
+    const { scrollTop, totalHeight, viewportHeight } = ctx;
+    const nextScrollTop = clampScrollTop(scrollTop + scrollDelta, totalHeight, viewportHeight);
+    if (nextScrollTop === scrollTop)
+        return Object.freeze({});
+    return Object.freeze({ nextScrollTop });
+}
+//# sourceMappingURL=virtualList.js.map

package/dist/runtime/router/virtualList.js.map

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

package/dist/runtime/router/wheel.d.ts

@@ -0,0 +1,15 @@
+import type { ZrevEvent } from "../../protocol/types.js";
+export type WheelRoutingCtx = Readonly<{
+    scrollX: number;
+    scrollY: number;
+    contentWidth: number;
+    contentHeight: number;
+    viewportWidth: number;
+    viewportHeight: number;
+}>;
+export type WheelRoutingResult = Readonly<{
+    nextScrollX?: number;
+    nextScrollY?: number;
+}>;
+export declare function routeWheel(event: ZrevEvent, ctx: WheelRoutingCtx): WheelRoutingResult;
+//# sourceMappingURL=wheel.d.ts.map

package/dist/runtime/router/wheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel.d.ts","sourceRoot":"","sources":["../../../src/runtime/router/wheel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAIH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAgBrF"}

package/dist/runtime/router/wheel.js

@@ -0,0 +1,16 @@
+const SCROLL_LINES = 3;
+export function routeWheel(event, ctx) {
+    if (event.kind !== "mouse" || event.mouseKind !== 5)
+        return Object.freeze({});
+    const deltaY = event.wheelY * SCROLL_LINES;
+    const deltaX = event.wheelX * SCROLL_LINES;
+    const maxScrollY = Math.max(0, ctx.contentHeight - ctx.viewportHeight);
+    const maxScrollX = Math.max(0, ctx.contentWidth - ctx.viewportWidth);
+    const nextScrollY = Math.max(0, Math.min(maxScrollY, ctx.scrollY + deltaY));
+    const nextScrollX = Math.max(0, Math.min(maxScrollX, ctx.scrollX + deltaX));
+    const changed = nextScrollY !== ctx.scrollY || nextScrollX !== ctx.scrollX;
+    if (!changed)
+        return Object.freeze({});
+    return Object.freeze({ nextScrollX, nextScrollY });
+}
+//# sourceMappingURL=wheel.js.map

package/dist/runtime/router/wheel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel.js","sourceRoot":"","sources":["../../../src/runtime/router/wheel.ts"],"names":[],"mappings":"AAgBA,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,GAAoB;IAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IAE3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IAErE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAG,WAAW,KAAK,GAAG,CAAC,OAAO,IAAI,WAAW,KAAK,GAAG,CAAC,OAAO,CAAC;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/runtime/router/zones.d.ts

@@ -0,0 +1,16 @@
+import type { ZrevEvent } from "../../events.js";
+import type { KeyRoutingCtxWithZones, RoutingResultWithZones } from "./types.js";
+/**
+ * Zone and trap-aware KEY routing.
+ *
+ * Routing logic:
+ * 1. TAB/Shift+TAB:
+ *    - If in active trap → wrap within trap
+ *    - Else if zones exist → move to next/prev zone
+ *    - Else → use existing computeMovedFocusId
+ * 2. Arrow keys:
+ *    - If focused widget is in a zone with navigation !== "none" → compute zone movement
+ * 3. Enter/Space: Unchanged press action
+ */
+export declare function routeKeyWithZones(event: ZrevEvent, ctx: KeyRoutingCtxWithZones): RoutingResultWithZones;
+//# sourceMappingURL=zones.d.ts.map

package/dist/runtime/router/zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../../../src/runtime/router/zones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,OAAO,KAAK,EAEV,sBAAsB,EAEtB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AA+CpB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,sBAAsB,GAC1B,sBAAsB,CA8HxB"}