@slowclap/rezi-core 0.1.0-fork.1

package/dist/widgets/table.js

@@ -0,0 +1,380 @@
+/**
+ * packages/core/src/widgets/table.ts — Table widget core algorithms.
+ *
+ * Why: Implements the core logic for table widgets including column width
+ * distribution, row selection state management, and virtualization support.
+ *
+ * Algorithms:
+ *   - Column width distribution: flex-based layout with min/max constraints
+ *   - Selection: single/multi mode with shift-click range support
+ *   - Virtualization: reuses virtualList algorithms for row windowing
+ *
+ * @see docs/widgets/table.md
+ */
+/**
+ * Distribute available width among table columns.
+ *
+ * Algorithm:
+ * 1. Assign fixed widths to columns with explicit width
+ * 2. Calculate remaining space after fixed columns
+ * 3. Distribute remaining space to flex columns proportionally
+ * 4. Apply min/max constraints to flex columns
+ * 5. Redistribute overflow from constrained columns
+ *
+ * @param columns - Column definitions
+ * @param availableWidth - Total available width in cells
+ * @returns Column widths and total width
+ */
+export function distributeColumnWidths(columns, availableWidth) {
+    const n = columns.length;
+    if (n === 0) {
+        return Object.freeze({ widths: Object.freeze([]), totalWidth: 0 });
+    }
+    const widths = new Array(n).fill(0);
+    let remainingWidth = availableWidth;
+    let totalFlex = 0;
+    const flexRemainders = [];
+    // Pass 1: Assign fixed widths and calculate total flex
+    for (let i = 0; i < n; i++) {
+        const col = columns[i];
+        if (col === undefined)
+            continue;
+        if (col.width !== undefined) {
+            // Fixed width column
+            const width = Math.max(0, col.width);
+            widths[i] = width;
+            remainingWidth -= width;
+        }
+        else {
+            // Flex column (default flex: 1)
+            const flex = col.flex ?? 1;
+            totalFlex += flex;
+        }
+    }
+    // Pass 2: Distribute remaining width to flex columns
+    if (totalFlex > 0 && remainingWidth > 0) {
+        const widthPerFlex = remainingWidth / totalFlex;
+        for (let i = 0; i < n; i++) {
+            const col = columns[i];
+            if (col === undefined)
+                continue;
+            if (col.width === undefined) {
+                const flex = col.flex ?? 1;
+                const rawWidth = widthPerFlex * flex;
+                let width = Math.floor(rawWidth);
+                // Apply min/max constraints
+                if (col.minWidth !== undefined) {
+                    width = Math.max(width, col.minWidth);
+                }
+                if (col.maxWidth !== undefined) {
+                    width = Math.min(width, col.maxWidth);
+                }
+                widths[i] = Math.max(0, width);
+                if (flex <= 0)
+                    continue;
+                flexRemainders.push(Object.freeze({
+                    index: i,
+                    remainder: rawWidth - Math.floor(rawWidth),
+                }));
+            }
+        }
+        let totalAssignedWidth = 0;
+        for (let i = 0; i < n; i++) {
+            const width = widths[i];
+            if (width !== undefined)
+                totalAssignedWidth += width;
+        }
+        let leftoverWidth = Math.max(0, availableWidth - totalAssignedWidth);
+        if (leftoverWidth > 0 && flexRemainders.length > 0) {
+            const remainderOrder = [...flexRemainders].sort((a, b) => {
+                if (b.remainder !== a.remainder)
+                    return b.remainder - a.remainder;
+                return a.index - b.index;
+            });
+            let distributed = true;
+            while (leftoverWidth > 0 && distributed) {
+                distributed = false;
+                for (let i = 0; i < remainderOrder.length; i++) {
+                    const candidate = remainderOrder[i];
+                    if (!candidate)
+                        continue;
+                    const col = columns[candidate.index];
+                    if (!col || col.width !== undefined)
+                        continue;
+                    const currentWidth = widths[candidate.index] ?? 0;
+                    if (col.maxWidth !== undefined && currentWidth >= col.maxWidth)
+                        continue;
+                    widths[candidate.index] = currentWidth + 1;
+                    leftoverWidth--;
+                    distributed = true;
+                    if (leftoverWidth === 0)
+                        break;
+                }
+            }
+        }
+    }
+    // Calculate total width
+    let totalWidth = 0;
+    for (let i = 0; i < n; i++) {
+        const w = widths[i];
+        if (w !== undefined) {
+            totalWidth += w;
+        }
+    }
+    return Object.freeze({
+        widths: Object.freeze(widths),
+        totalWidth,
+    });
+}
+/**
+ * Compute new selection state after clicking a row.
+ *
+ * @param currentSelection - Current selected keys
+ * @param rowKey - Key of clicked row
+ * @param mode - Selection mode
+ * @param modifiers - Keyboard modifiers (shift, ctrl/cmd)
+ * @param allRowKeys - All row keys for shift-select range
+ * @param lastClickedKey - Previously clicked key for shift-select
+ * @param rowKeyToIndex - Optional pre-built index map for O(1) lookup (recommended for large tables)
+ * @returns New selection state
+ */
+export function computeSelection(currentSelection, rowKey, mode, modifiers, allRowKeys, lastClickedKey, rowKeyToIndex) {
+    if (mode === "none") {
+        return Object.freeze({ selection: Object.freeze([]), changed: false });
+    }
+    if (mode === "single") {
+        // Single mode: clicking selects only that row
+        const isSelected = currentSelection.includes(rowKey);
+        if (isSelected && currentSelection.length === 1) {
+            return Object.freeze({ selection: currentSelection, changed: false });
+        }
+        return Object.freeze({
+            selection: Object.freeze([rowKey]),
+            changed: true,
+        });
+    }
+    // Multi mode
+    if (modifiers.shift && lastClickedKey !== null) {
+        // Shift-click: select range from last clicked to current
+        // Use O(1) map lookup if available, otherwise fall back to O(n) indexOf
+        const startIdx = rowKeyToIndex?.get(lastClickedKey) ?? allRowKeys.indexOf(lastClickedKey);
+        const endIdx = rowKeyToIndex?.get(rowKey) ?? allRowKeys.indexOf(rowKey);
+        if (startIdx === -1 || endIdx === -1) {
+            // Fallback: just toggle current row
+            return toggleSelection(currentSelection, rowKey);
+        }
+        const minIdx = Math.min(startIdx, endIdx);
+        const maxIdx = Math.max(startIdx, endIdx);
+        // Build new selection including the range
+        const rangeKeys = allRowKeys.slice(minIdx, maxIdx + 1);
+        const newSelection = new Set(currentSelection);
+        for (const key of rangeKeys) {
+            newSelection.add(key);
+        }
+        const result = [...newSelection];
+        return Object.freeze({
+            selection: Object.freeze(result),
+            changed: result.length !== currentSelection.length,
+        });
+    }
+    if (modifiers.ctrl) {
+        // Ctrl-click: toggle selection
+        return toggleSelection(currentSelection, rowKey);
+    }
+    // Plain click: select only this row
+    const isOnlySelected = currentSelection.length === 1 && currentSelection[0] === rowKey;
+    if (isOnlySelected) {
+        return Object.freeze({ selection: currentSelection, changed: false });
+    }
+    return Object.freeze({
+        selection: Object.freeze([rowKey]),
+        changed: true,
+    });
+}
+/**
+ * Toggle selection of a single row.
+ */
+function toggleSelection(currentSelection, rowKey) {
+    const isSelected = currentSelection.includes(rowKey);
+    if (isSelected) {
+        const newSelection = currentSelection.filter((k) => k !== rowKey);
+        return Object.freeze({
+            selection: Object.freeze(newSelection),
+            changed: true,
+        });
+    }
+    const newSelection = [...currentSelection, rowKey];
+    return Object.freeze({
+        selection: Object.freeze(newSelection),
+        changed: true,
+    });
+}
+/**
+ * Select all rows.
+ *
+ * @param allRowKeys - All row keys
+ * @param currentSelection - Current selection
+ * @returns New selection with all rows selected
+ */
+export function selectAll(allRowKeys, currentSelection) {
+    if (currentSelection.length === allRowKeys.length) {
+        // Check if already all selected - use Set for O(n) instead of O(n²)
+        const selectionSet = new Set(currentSelection);
+        const allSelected = allRowKeys.every((k) => selectionSet.has(k));
+        if (allSelected) {
+            return Object.freeze({ selection: currentSelection, changed: false });
+        }
+    }
+    return Object.freeze({
+        selection: allRowKeys,
+        changed: true,
+    });
+}
+/**
+ * Clear all selection.
+ *
+ * @param currentSelection - Current selection
+ * @returns Empty selection
+ */
+export function clearSelection(currentSelection) {
+    if (currentSelection.length === 0) {
+        return Object.freeze({ selection: currentSelection, changed: false });
+    }
+    return Object.freeze({
+        selection: Object.freeze([]),
+        changed: true,
+    });
+}
+/**
+ * Compute next sort state when clicking a column header.
+ *
+ * Logic:
+ * - Clicking unsorted column → sort ascending
+ * - Clicking ascending column → sort descending
+ * - Clicking descending column → sort ascending (cycle)
+ *
+ * @param currentColumn - Currently sorted column (or undefined)
+ * @param currentDirection - Current sort direction
+ * @param clickedColumn - Clicked column key
+ * @returns New sort state
+ */
+export function toggleSort(currentColumn, currentDirection, clickedColumn) {
+    if (currentColumn !== clickedColumn) {
+        // New column: start ascending
+        return Object.freeze({ column: clickedColumn, direction: "asc" });
+    }
+    // Same column: toggle direction
+    const newDirection = currentDirection === "asc" ? "desc" : "asc";
+    return Object.freeze({ column: clickedColumn, direction: newDirection });
+}
+/* ========== Row Key Extraction ========== */
+/**
+ * Extract row keys from data using getRowKey function.
+ *
+ * @param data - Row data array
+ * @param getRowKey - Function to extract key from row
+ * @returns Array of row keys
+ */
+export function extractRowKeys(data, getRowKey) {
+    const keys = new Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        const row = data[i];
+        if (row !== undefined) {
+            keys[i] = getRowKey(row, i);
+        }
+        else {
+            keys[i] = `__empty_${i}`;
+        }
+    }
+    return Object.freeze(keys);
+}
+/**
+ * Build an index map from row keys for O(1) lookups.
+ *
+ * This is an optimization for large tables to avoid O(n) indexOf() calls
+ * during shift-click range selection. For tables with <1000 rows, the
+ * overhead of building this map may not be worth it.
+ *
+ * @param rowKeys - Array of row keys (from extractRowKeys)
+ * @returns Map from row key to index
+ */
+export function buildRowKeyIndex(rowKeys) {
+    const map = new Map();
+    for (let i = 0; i < rowKeys.length; i++) {
+        const key = rowKeys[i];
+        if (key !== undefined) {
+            map.set(key, i);
+        }
+    }
+    return map;
+}
+/* ========== Sort Indicator ========== */
+/** Sort indicator characters. */
+export const SORT_INDICATOR_ASC = "▲";
+export const SORT_INDICATOR_DESC = "▼";
+/**
+ * Get sort indicator for a column header.
+ *
+ * @param columnKey - Column key
+ * @param sortColumn - Currently sorted column
+ * @param sortDirection - Current sort direction
+ * @returns Sort indicator string or empty string
+ */
+export function getSortIndicator(columnKey, sortColumn, sortDirection) {
+    if (sortColumn !== columnKey) {
+        return "";
+    }
+    return sortDirection === "asc" ? SORT_INDICATOR_ASC : SORT_INDICATOR_DESC;
+}
+/**
+ * Pad text to fit within a cell with specified alignment.
+ *
+ * @param text - Text content
+ * @param width - Cell width
+ * @param align - Alignment
+ * @returns Padded text
+ */
+export function alignCellText(text, width, align) {
+    const textLength = text.length;
+    if (textLength >= width) {
+        // Truncate if too long
+        return text.slice(0, width);
+    }
+    const padding = width - textLength;
+    switch (align) {
+        case "right":
+            return " ".repeat(padding) + text;
+        case "center": {
+            const leftPad = Math.floor(padding / 2);
+            const rightPad = padding - leftPad;
+            return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+        }
+        case "left":
+            return text + " ".repeat(padding);
+    }
+}
+/* ========== Focused Row Navigation ========== */
+/**
+ * Compute row index from row key.
+ *
+ * @param rowKeys - All row keys
+ * @param rowKey - Key to find
+ * @returns Index or -1 if not found
+ */
+export function getRowIndex(rowKeys, rowKey) {
+    return rowKeys.indexOf(rowKey);
+}
+/**
+ * Compute row key from row index.
+ *
+ * @param rowKeys - All row keys
+ * @param index - Row index
+ * @returns Row key or undefined if out of bounds
+ */
+export function getRowKeyAtIndex(rowKeys, index) {
+    if (index < 0 || index >= rowKeys.length) {
+        return undefined;
+    }
+    return rowKeys[index];
+}
+//# sourceMappingURL=table.js.map

package/dist/widgets/table.js.map

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

package/dist/widgets/tabs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * packages/core/src/widgets/tabs.ts — Tabs widget utilities.
+ *
+ * Why: Provides deterministic Tabs helpers for active-tab normalization,
+ * focus ID generation, keyboard movement, and VNode construction.
+ */
+import type { TabsProps, VNode } from "./types.js";
+export declare const TABS_BAR_ZONE_PREFIX = "__rezi_tabs_bar__";
+export declare const TABS_CONTENT_ZONE_PREFIX = "__rezi_tabs_content__";
+export declare const TABS_TRIGGER_PREFIX = "__rezi_tabs_trigger__";
+export type TabsDirection = "next" | "prev";
+export type ParsedTabsTriggerId = Readonly<{
+    tabsId: string;
+    index: number;
+    tabKey: string;
+}>;
+export declare function getTabsBarZoneId(tabsId: string): string;
+export declare function getTabsContentZoneId(tabsId: string): string;
+export declare function parseTabsBarZoneId(id: string): string | null;
+export declare function parseTabsContentZoneId(id: string): string | null;
+export declare function getTabsTriggerId(tabsId: string, index: number, tabKey: string): string;
+export declare function parseTabsTriggerId(id: string): ParsedTabsTriggerId | null;
+export declare function resolveTabsActiveIndex(tabs: TabsProps["tabs"], activeTab: string): number;
+export declare function moveTabsIndex(currentIndex: number, count: number, direction: TabsDirection, wrapAround: boolean): number;
+export declare function buildTabsChildren(props: TabsProps): readonly VNode[];
+export declare function createTabsVNode(props: TabsProps): VNode;
+export declare function createTabsWidgetVNode(props: TabsProps): VNode;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/widgets/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/widgets/tabs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAChE,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAgBzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,OAAO,GAClB,MAAM,CAWR;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,KAAK,EAAE,CA+CpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAMvD;AAkBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAE7D"}

package/dist/widgets/tabs.js

@@ -0,0 +1,146 @@
+/**
+ * packages/core/src/widgets/tabs.ts — Tabs widget utilities.
+ *
+ * Why: Provides deterministic Tabs helpers for active-tab normalization,
+ * focus ID generation, keyboard movement, and VNode construction.
+ */
+import { decodeIdSegment, encodeIdSegment } from "../runtime/idCodec.js";
+import { defineWidget } from "./composition.js";
+export const TABS_BAR_ZONE_PREFIX = "__rezi_tabs_bar__";
+export const TABS_CONTENT_ZONE_PREFIX = "__rezi_tabs_content__";
+export const TABS_TRIGGER_PREFIX = "__rezi_tabs_trigger__";
+export function getTabsBarZoneId(tabsId) {
+    return `${TABS_BAR_ZONE_PREFIX}:${encodeIdSegment(tabsId)}`;
+}
+export function getTabsContentZoneId(tabsId) {
+    return `${TABS_CONTENT_ZONE_PREFIX}:${encodeIdSegment(tabsId)}`;
+}
+export function parseTabsBarZoneId(id) {
+    if (!id.startsWith(`${TABS_BAR_ZONE_PREFIX}:`))
+        return null;
+    return decodeIdSegment(id.slice(TABS_BAR_ZONE_PREFIX.length + 1));
+}
+export function parseTabsContentZoneId(id) {
+    if (!id.startsWith(`${TABS_CONTENT_ZONE_PREFIX}:`))
+        return null;
+    return decodeIdSegment(id.slice(TABS_CONTENT_ZONE_PREFIX.length + 1));
+}
+export function getTabsTriggerId(tabsId, index, tabKey) {
+    return `${TABS_TRIGGER_PREFIX}:${encodeIdSegment(tabsId)}:${String(index)}:${encodeIdSegment(tabKey)}`;
+}
+export function parseTabsTriggerId(id) {
+    if (!id.startsWith(`${TABS_TRIGGER_PREFIX}:`))
+        return null;
+    const body = id.slice(TABS_TRIGGER_PREFIX.length + 1);
+    const firstSep = body.indexOf(":");
+    if (firstSep <= 0)
+        return null;
+    const secondSep = body.indexOf(":", firstSep + 1);
+    if (secondSep <= firstSep + 1)
+        return null;
+    if (body.indexOf(":", secondSep + 1) !== -1)
+        return null;
+    const tabsId = decodeIdSegment(body.slice(0, firstSep));
+    const indexRaw = Number.parseInt(body.slice(firstSep + 1, secondSep), 10);
+    const tabKey = decodeIdSegment(body.slice(secondSep + 1));
+    if (tabsId === null || tabKey === null)
+        return null;
+    if (!Number.isFinite(indexRaw) || indexRaw < 0)
+        return null;
+    return Object.freeze({ tabsId, index: indexRaw, tabKey });
+}
+export function resolveTabsActiveIndex(tabs, activeTab) {
+    if (tabs.length === 0)
+        return -1;
+    const idx = tabs.findIndex((tab) => tab.key === activeTab);
+    return idx >= 0 ? idx : 0;
+}
+export function moveTabsIndex(currentIndex, count, direction, wrapAround) {
+    if (count <= 0)
+        return -1;
+    const clamped = Math.max(0, Math.min(count - 1, currentIndex));
+    if (direction === "next") {
+        if (clamped + 1 < count)
+            return clamped + 1;
+        return wrapAround ? 0 : clamped;
+    }
+    if (clamped - 1 >= 0)
+        return clamped - 1;
+    return wrapAround ? count - 1 : clamped;
+}
+function formatTabsLabel(label, active, variant) {
+    if (variant === "enclosed") {
+        return active ? `[${label}]` : ` ${label} `;
+    }
+    if (variant === "pills") {
+        return active ? `( ${label} )` : `  ${label}  `;
+    }
+    return active ? `> ${label}` : `  ${label}`;
+}
+export function buildTabsChildren(props) {
+    const activeIndex = resolveTabsActiveIndex(props.tabs, props.activeTab);
+    const variant = props.variant ?? "line";
+    const position = props.position ?? "top";
+    const tabButtons = [];
+    for (let i = 0; i < props.tabs.length; i++) {
+        const tab = props.tabs[i];
+        if (!tab)
+            continue;
+        tabButtons.push({
+            kind: "button",
+            props: {
+                id: getTabsTriggerId(props.id, i, tab.key),
+                label: formatTabsLabel(tab.label, i === activeIndex, variant),
+                onPress: () => props.onChange(tab.key),
+            },
+        });
+    }
+    const barZone = {
+        kind: "focusZone",
+        props: {
+            id: getTabsBarZoneId(props.id),
+            tabIndex: 0,
+            navigation: "linear",
+            columns: 1,
+            wrapAround: true,
+        },
+        children: Object.freeze(tabButtons),
+    };
+    const activeContent = activeIndex >= 0 ? props.tabs[activeIndex]?.content : undefined;
+    const contentZone = {
+        kind: "focusZone",
+        props: {
+            id: getTabsContentZoneId(props.id),
+            tabIndex: 1,
+            navigation: "none",
+            columns: 1,
+            wrapAround: false,
+        },
+        children: activeContent ? Object.freeze([activeContent]) : Object.freeze([]),
+    };
+    return position === "bottom"
+        ? Object.freeze([contentZone, barZone])
+        : Object.freeze([barZone, contentZone]);
+}
+export function createTabsVNode(props) {
+    return {
+        kind: "tabs",
+        props,
+        children: buildTabsChildren(props),
+    };
+}
+let tabsWidgetFactory = null;
+function getTabsWidgetFactory() {
+    if (tabsWidgetFactory === null) {
+        tabsWidgetFactory = defineWidget((props, ctx) => {
+            const idRef = ctx.useRef(props.id);
+            idRef.current = props.id;
+            return createTabsVNode(props);
+        }, { name: "tabs" });
+    }
+    return tabsWidgetFactory;
+}
+export function createTabsWidgetVNode(props) {
+    return getTabsWidgetFactory()(props);
+}
+//# sourceMappingURL=tabs.js.map

package/dist/widgets/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/widgets/tabs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAU3D,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,GAAG,oBAAoB,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,GAAG,wBAAwB,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,oBAAoB,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,wBAAwB,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa,EAAE,MAAc;IAC5E,OAAO,GAAG,mBAAmB,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,mBAAmB,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,SAAS,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAuB,EAAE,SAAiB;IAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC3D,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,YAAoB,EACpB,KAAa,EACb,SAAwB,EACxB,UAAmB;IAEnB,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/D,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK;YAAE,OAAO,OAAO,GAAG,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,GAAG,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1C,CAAC;AAED,SAAS,eAAe,CACtB,KAAa,EACb,MAAe,EACf,OAA0C;IAE1C,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC;IAEzC,MAAM,UAAU,GAAY,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACL,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;gBAC1C,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,WAAW,EAAE,OAAO,CAAC;gBAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;aACvC;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAU;QACrB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE;YACL,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,IAAI;SACjB;QACD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;KACpC,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,WAAW,GAAU;QACzB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE;YACL,EAAE,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,KAAK;SAClB;QACD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KAC7E,CAAC;IAEF,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK;QACL,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,IAAI,iBAAiB,GAAyC,IAAI,CAAC;AAEnE,SAAS,oBAAoB;IAC3B,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,iBAAiB,GAAG,YAAY,CAC9B,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAgB;IACpD,OAAO,oBAAoB,EAAE,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/widgets/toast.d.ts

@@ -0,0 +1,85 @@
+/**
+ * packages/core/src/widgets/toast.ts — Toast/Notifications core algorithms.
+ *
+ * Why: Implements positioning, stacking, and auto-dismiss logic for toast
+ * notifications. Toasts are non-blocking feedback messages that stack
+ * vertically from a screen edge.
+ *
+ * @see docs/widgets/toast.md
+ */
+import type { Rgb24 } from "./style.js";
+import type { Toast, ToastPosition } from "./types.js";
+/** Height of a single toast in cells. */
+export declare const TOAST_HEIGHT = 3;
+/** Default max visible toasts. */
+export declare const DEFAULT_MAX_VISIBLE = 5;
+/** Default auto-dismiss duration in ms. */
+export declare const DEFAULT_DURATION = 3000;
+/** Focus id for a toast action button (used by runtime-local focus routing). */
+export declare function getToastActionFocusId(toastId: string): string;
+export declare function parseToastActionFocusId(id: string): string | null;
+/**
+ * Compute visible toasts based on max visible limit.
+ *
+ * @param toasts - All active toasts
+ * @param maxVisible - Maximum number of visible toasts
+ * @returns Toasts to display (most recent first)
+ */
+export declare function getVisibleToasts(toasts: readonly Toast[], maxVisible?: number): readonly Toast[];
+/**
+ * Compute toast Y position within the container.
+ *
+ * @param index - Toast index (0 = first)
+ * @param position - Container position
+ * @param containerHeight - Container height in cells
+ * @returns Y offset within container
+ */
+export declare function getToastY(index: number, position: ToastPosition, containerHeight: number): number;
+/**
+ * Compute toast X position based on container position.
+ *
+ * @param position - Container position
+ * @param containerWidth - Container width in cells
+ * @param toastWidth - Individual toast width in cells
+ * @returns X offset for toast
+ */
+export declare function getToastX(position: ToastPosition, containerWidth: number, toastWidth: number): number;
+/**
+ * Filter toasts by auto-dismiss status.
+ * Returns toasts that should still be visible based on their creation time.
+ *
+ * @param toasts - All toasts
+ * @param now - Current timestamp in ms
+ * @param createdAt - Map of toast ID to creation timestamp
+ * @returns Toasts that haven't expired
+ */
+export declare function filterExpiredToasts(toasts: readonly Toast[], now: number, createdAt: ReadonlyMap<string, number>): readonly Toast[];
+/**
+ * Add a toast to the list, maintaining order (newest first).
+ *
+ * @param toasts - Existing toasts
+ * @param toast - Toast to add
+ * @returns Updated toast list
+ */
+export declare function addToast(toasts: readonly Toast[], toast: Toast): readonly Toast[];
+/**
+ * Remove a toast by ID.
+ *
+ * @param toasts - Existing toasts
+ * @param id - Toast ID to remove
+ * @returns Updated toast list
+ */
+export declare function removeToast(toasts: readonly Toast[], id: string): readonly Toast[];
+/**
+ * Update a toast's progress.
+ *
+ * @param toasts - Existing toasts
+ * @param id - Toast ID to update
+ * @param progress - New progress value (0-100)
+ * @returns Updated toast list
+ */
+export declare function updateToastProgress(toasts: readonly Toast[], id: string, progress: number): readonly Toast[];
+/** Icon character for each toast type. */
+export declare const TOAST_ICONS: Record<Toast["type"], string>;
+export declare const TOAST_COLORS: Record<Toast["type"], Rgb24>;
+//# sourceMappingURL=toast.d.ts.map