@slowclap/rezi-core 0.1.0-fork.1

package/dist/widgets/logsConsole.d.ts

@@ -0,0 +1,97 @@
+/**
+ * packages/core/src/widgets/logsConsole.ts — LogsConsole core algorithms.
+ *
+ * Why: Implements log filtering, auto-scroll, and search functionality
+ * for the logs console widget.
+ *
+ * @see docs/widgets/logs-console.md
+ */
+import type { Rgb24 } from "./style.js";
+import type { LogEntry, LogLevel } from "./types.js";
+/** Default max log entries to keep. */
+export declare const MAX_LOG_ENTRIES = 10000;
+/**
+ * Filter log entries by level.
+ *
+ * @param entries - All log entries
+ * @param levels - Levels to include
+ * @returns Filtered entries
+ */
+export declare function filterByLevel(entries: readonly LogEntry[], levels: readonly LogLevel[]): readonly LogEntry[];
+/**
+ * Filter log entries by source.
+ *
+ * @param entries - All log entries
+ * @param sources - Sources to include
+ * @returns Filtered entries
+ */
+export declare function filterBySource(entries: readonly LogEntry[], sources: readonly string[]): readonly LogEntry[];
+/**
+ * Search log entries by query.
+ *
+ * @param entries - All log entries
+ * @param query - Search query
+ * @returns Filtered entries matching query
+ */
+export declare function searchEntries(entries: readonly LogEntry[], query: string): readonly LogEntry[];
+/**
+ * Apply all filters to log entries.
+ *
+ * @param entries - All log entries
+ * @param levelFilter - Levels to include
+ * @param sourceFilter - Sources to include
+ * @param searchQuery - Search query
+ * @returns Filtered entries
+ */
+export declare function applyFilters(entries: readonly LogEntry[], levelFilter?: readonly LogLevel[], sourceFilter?: readonly string[], searchQuery?: string): readonly LogEntry[];
+/**
+ * Compute scroll position for auto-scroll behavior.
+ *
+ * @param currentScrollTop - Current scroll position
+ * @param entryCount - Total number of entries
+ * @param viewportHeight - Visible viewport height
+ * @param autoScroll - Whether auto-scroll is enabled
+ * @returns New scroll position
+ */
+export declare function computeAutoScrollPosition(currentScrollTop: number, entryCount: number, viewportHeight: number, autoScroll: boolean): number;
+/**
+ * Add a log entry, maintaining max entries limit.
+ *
+ * @param entries - Existing entries
+ * @param entry - Entry to add
+ * @param maxEntries - Maximum entries to keep
+ * @returns Updated entries
+ */
+export declare function addEntry(entries: readonly LogEntry[], entry: LogEntry, maxEntries?: number): readonly LogEntry[];
+/**
+ * Format timestamp for display.
+ *
+ * @param timestamp - Unix timestamp in ms
+ * @returns Formatted time string (HH:MM:SS)
+ */
+export declare function formatTimestamp(timestamp: number): string;
+/**
+ * Format duration for display.
+ *
+ * @param durationMs - Duration in milliseconds
+ * @returns Formatted duration string
+ */
+export declare function formatDuration(durationMs: number): string;
+/**
+ * Format token count for display.
+ *
+ * @param count - Token count
+ * @returns Formatted string (e.g., "1,234")
+ */
+export declare function formatTokenCount(count: number): string;
+/**
+ * Format cost for display.
+ *
+ * @param costCents - Cost in cents
+ * @returns Formatted string (e.g., "$0.02")
+ */
+export declare function formatCost(costCents: number): string;
+export declare const LEVEL_COLORS: Record<LogLevel, Rgb24>;
+/** Level priority for filtering. */
+export declare const LEVEL_PRIORITY: Record<LogLevel, number>;
+//# sourceMappingURL=logsConsole.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logsConsole.d.ts","sourceRoot":"","sources":["../../src/widgets/logsConsole.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,uCAAuC;AACvC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,MAAM,EAAE,SAAS,QAAQ,EAAE,GAC1B,SAAS,QAAQ,EAAE,CAIrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,QAAQ,EAAE,CAIrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,CAW9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,WAAW,CAAC,EAAE,SAAS,QAAQ,EAAE,EACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,EAChC,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,QAAQ,EAAE,CAYrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,OAAO,GAClB,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,KAAK,EAAE,QAAQ,EACf,UAAU,GAAE,MAAwB,GACnC,SAAS,QAAQ,EAAE,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAetD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAKD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,CAMhD,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMnD,CAAC"}

package/dist/widgets/logsConsole.js

@@ -0,0 +1,191 @@
+/**
+ * packages/core/src/widgets/logsConsole.ts — LogsConsole core algorithms.
+ *
+ * Why: Implements log filtering, auto-scroll, and search functionality
+ * for the logs console widget.
+ *
+ * @see docs/widgets/logs-console.md
+ */
+import { defaultTheme } from "../theme/defaultTheme.js";
+/** Default max log entries to keep. */
+export const MAX_LOG_ENTRIES = 10000;
+/**
+ * Filter log entries by level.
+ *
+ * @param entries - All log entries
+ * @param levels - Levels to include
+ * @returns Filtered entries
+ */
+export function filterByLevel(entries, levels) {
+    if (levels.length === 0)
+        return entries;
+    const levelSet = new Set(levels);
+    return Object.freeze(entries.filter((e) => levelSet.has(e.level)));
+}
+/**
+ * Filter log entries by source.
+ *
+ * @param entries - All log entries
+ * @param sources - Sources to include
+ * @returns Filtered entries
+ */
+export function filterBySource(entries, sources) {
+    if (sources.length === 0)
+        return entries;
+    const sourceSet = new Set(sources);
+    return Object.freeze(entries.filter((e) => sourceSet.has(e.source)));
+}
+/**
+ * Search log entries by query.
+ *
+ * @param entries - All log entries
+ * @param query - Search query
+ * @returns Filtered entries matching query
+ */
+export function searchEntries(entries, query) {
+    if (!query)
+        return entries;
+    const lowerQuery = query.toLowerCase();
+    return Object.freeze(entries.filter((e) => e.message.toLowerCase().includes(lowerQuery) ||
+        e.source.toLowerCase().includes(lowerQuery) ||
+        e.details?.toLowerCase().includes(lowerQuery)));
+}
+/**
+ * Apply all filters to log entries.
+ *
+ * @param entries - All log entries
+ * @param levelFilter - Levels to include
+ * @param sourceFilter - Sources to include
+ * @param searchQuery - Search query
+ * @returns Filtered entries
+ */
+export function applyFilters(entries, levelFilter, sourceFilter, searchQuery) {
+    let filtered = entries;
+    if (levelFilter && levelFilter.length > 0) {
+        filtered = filterByLevel(filtered, levelFilter);
+    }
+    if (sourceFilter && sourceFilter.length > 0) {
+        filtered = filterBySource(filtered, sourceFilter);
+    }
+    if (searchQuery) {
+        filtered = searchEntries(filtered, searchQuery);
+    }
+    return filtered;
+}
+/**
+ * Compute scroll position for auto-scroll behavior.
+ *
+ * @param currentScrollTop - Current scroll position
+ * @param entryCount - Total number of entries
+ * @param viewportHeight - Visible viewport height
+ * @param autoScroll - Whether auto-scroll is enabled
+ * @returns New scroll position
+ */
+export function computeAutoScrollPosition(currentScrollTop, entryCount, viewportHeight, autoScroll) {
+    if (!autoScroll)
+        return currentScrollTop;
+    const maxScroll = Math.max(0, entryCount - viewportHeight);
+    return maxScroll;
+}
+/**
+ * Add a log entry, maintaining max entries limit.
+ *
+ * @param entries - Existing entries
+ * @param entry - Entry to add
+ * @param maxEntries - Maximum entries to keep
+ * @returns Updated entries
+ */
+export function addEntry(entries, entry, maxEntries = MAX_LOG_ENTRIES) {
+    const newEntries = [...entries, entry];
+    if (newEntries.length > maxEntries) {
+        return Object.freeze(newEntries.slice(newEntries.length - maxEntries));
+    }
+    return Object.freeze(newEntries);
+}
+/**
+ * Format timestamp for display.
+ *
+ * @param timestamp - Unix timestamp in ms
+ * @returns Formatted time string (HH:MM:SS)
+ */
+export function formatTimestamp(timestamp) {
+    if (!Number.isFinite(timestamp))
+        return "00:00:00";
+    const totalSeconds = Math.floor(timestamp / 1000);
+    // Deterministic HH:MM:SS (UTC-ish) without Date/timezone dependence.
+    const secondsInDay = 24 * 60 * 60;
+    const daySeconds = ((totalSeconds % secondsInDay) + secondsInDay) % secondsInDay;
+    const h = Math.floor(daySeconds / 3600);
+    const m = Math.floor((daySeconds % 3600) / 60);
+    const s = daySeconds % 60;
+    return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+/**
+ * Format duration for display.
+ *
+ * @param durationMs - Duration in milliseconds
+ * @returns Formatted duration string
+ */
+export function formatDuration(durationMs) {
+    if (durationMs < 1000) {
+        return `${durationMs}ms`;
+    }
+    if (durationMs < 60000) {
+        return `${(durationMs / 1000).toFixed(1)}s`;
+    }
+    const minutes = Math.floor(durationMs / 60000);
+    const seconds = Math.floor((durationMs % 60000) / 1000);
+    return `${minutes}m${seconds}s`;
+}
+/**
+ * Format token count for display.
+ *
+ * @param count - Token count
+ * @returns Formatted string (e.g., "1,234")
+ */
+export function formatTokenCount(count) {
+    if (!Number.isFinite(count))
+        return "0";
+    const n = Math.trunc(count);
+    const sign = n < 0 ? "-" : "";
+    const abs = Math.abs(n);
+    const raw = String(abs);
+    let out = "";
+    for (let i = 0; i < raw.length; i++) {
+        const idx = raw.length - 1 - i;
+        const ch = raw[idx];
+        if (!ch)
+            continue;
+        if (i > 0 && i % 3 === 0)
+            out = `,${out}`;
+        out = `${ch}${out}`;
+    }
+    return `${sign}${out}`;
+}
+/**
+ * Format cost for display.
+ *
+ * @param costCents - Cost in cents
+ * @returns Formatted string (e.g., "$0.02")
+ */
+export function formatCost(costCents) {
+    return `$${(costCents / 100).toFixed(2)}`;
+}
+/** Level color map (packed RGB24). */
+const WIDGET_PALETTE = defaultTheme.colors;
+export const LEVEL_COLORS = {
+    trace: WIDGET_PALETTE["widget.logs.trace"] ?? WIDGET_PALETTE.muted,
+    debug: WIDGET_PALETTE["widget.logs.debug"] ?? WIDGET_PALETTE.secondary,
+    info: WIDGET_PALETTE["widget.logs.info"] ?? WIDGET_PALETTE.fg,
+    warn: WIDGET_PALETTE["widget.logs.warn"] ?? WIDGET_PALETTE.warning,
+    error: WIDGET_PALETTE["widget.logs.error"] ?? WIDGET_PALETTE.danger,
+};
+/** Level priority for filtering. */
+export const LEVEL_PRIORITY = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+};
+//# sourceMappingURL=logsConsole.js.map

package/dist/widgets/logsConsole.js.map

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

package/dist/widgets/pagination.d.ts

@@ -0,0 +1,35 @@
+/**
+ * packages/core/src/widgets/pagination.ts — Pagination widget utilities.
+ *
+ * Why: Provides deterministic pagination helpers for page normalization,
+ * visible-page computation, focus IDs, keyboard movement semantics, and
+ * VNode construction.
+ */
+import type { PaginationProps, VNode } from "./types.js";
+export declare const PAGINATION_ZONE_PREFIX = "__rezi_pagination_zone__";
+export declare const PAGINATION_CONTROL_PREFIX = "__rezi_pagination_control__";
+export declare const PAGINATION_PAGE_PREFIX = "__rezi_pagination_page__";
+export declare const PAGINATION_ELLIPSIS = "...";
+export type PaginationControl = "first" | "prev" | "next" | "last";
+export type PaginationVisibleItem = number | typeof PAGINATION_ELLIPSIS;
+export type ParsedPaginationId = Readonly<{
+    paginationId: string;
+    kind: "control";
+    control: PaginationControl;
+}> | Readonly<{
+    paginationId: string;
+    kind: "page";
+    page: number;
+}>;
+export declare function normalizeTotalPages(totalPages: number): number;
+export declare function normalizePaginationPage(page: number, totalPages: number): number;
+export declare function movePaginationPage(page: number, totalPages: number, direction: "prev" | "next" | "first" | "last"): number;
+export declare function computeVisiblePaginationItems(page: number, totalPages: number, maxVisible?: number): readonly PaginationVisibleItem[];
+export declare function getPaginationZoneId(paginationId: string): string;
+export declare function getPaginationControlId(paginationId: string, control: PaginationControl): string;
+export declare function getPaginationPageId(paginationId: string, page: number): string;
+export declare function parsePaginationId(id: string): ParsedPaginationId | null;
+export declare function buildPaginationChildren(props: PaginationProps): readonly VNode[];
+export declare function createPaginationVNode(props: PaginationProps): VNode;
+export declare function createPaginationWidgetVNode(props: PaginationProps): VNode;
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/widgets/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAazD,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,mBAAmB,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,CAAC;IACP,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,CAAC,GACF,QAAQ,CAAC;IACP,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AA0BP,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAC5C,MAAM,CAQR;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,SAAI,GACb,SAAS,qBAAqB,EAAE,CAoClC;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE/F;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAyBvE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,KAAK,EAAE,CA2FhF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAMnE;AAkBD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAEzE"}

package/dist/widgets/pagination.js

@@ -0,0 +1,250 @@
+/**
+ * packages/core/src/widgets/pagination.ts — Pagination widget utilities.
+ *
+ * Why: Provides deterministic pagination helpers for page normalization,
+ * visible-page computation, focus IDs, keyboard movement semantics, and
+ * VNode construction.
+ */
+import { defineWidget } from "./composition.js";
+const NODE_ENV = globalThis.process?.env?.NODE_ENV ??
+    "development";
+const DEV_MODE = NODE_ENV !== "production";
+function warnDev(message) {
+    if (!DEV_MODE)
+        return;
+    const c = globalThis.console;
+    c?.warn?.(message);
+}
+export const PAGINATION_ZONE_PREFIX = "__rezi_pagination_zone__";
+export const PAGINATION_CONTROL_PREFIX = "__rezi_pagination_control__";
+export const PAGINATION_PAGE_PREFIX = "__rezi_pagination_page__";
+export const PAGINATION_ELLIPSIS = "...";
+function encodeSegment(value) {
+    return encodeURIComponent(value);
+}
+function describeThrown(v) {
+    if (v instanceof Error)
+        return v.message;
+    try {
+        return String(v);
+    }
+    catch {
+        return "[unstringifiable thrown value]";
+    }
+}
+function decodeSegment(value) {
+    if (value.length === 0)
+        return null;
+    try {
+        return decodeURIComponent(value);
+    }
+    catch (e) {
+        const message = describeThrown(e);
+        warnDev(`[rezi] pagination decodeURIComponent failed: ${message}`);
+        return null;
+    }
+}
+export function normalizeTotalPages(totalPages) {
+    if (!Number.isFinite(totalPages))
+        return 1;
+    const asInt = Math.trunc(totalPages);
+    return Math.max(1, asInt);
+}
+export function normalizePaginationPage(page, totalPages) {
+    const safeTotal = normalizeTotalPages(totalPages);
+    if (!Number.isFinite(page))
+        return 1;
+    const asInt = Math.trunc(page);
+    if (asInt <= 1)
+        return 1;
+    if (asInt >= safeTotal)
+        return safeTotal;
+    return asInt;
+}
+export function movePaginationPage(page, totalPages, direction) {
+    const safeTotal = normalizeTotalPages(totalPages);
+    const safePage = normalizePaginationPage(page, safeTotal);
+    if (direction === "first")
+        return 1;
+    if (direction === "last")
+        return safeTotal;
+    if (direction === "prev")
+        return safePage <= 1 ? 1 : safePage - 1;
+    return safePage >= safeTotal ? safeTotal : safePage + 1;
+}
+export function computeVisiblePaginationItems(page, totalPages, maxVisible = 7) {
+    const safeTotal = normalizeTotalPages(totalPages);
+    const safePage = normalizePaginationPage(page, safeTotal);
+    const safeMaxVisible = Math.max(5, Math.trunc(maxVisible));
+    if (safeTotal <= safeMaxVisible) {
+        const all = [];
+        for (let p = 1; p <= safeTotal; p++)
+            all.push(p);
+        return Object.freeze(all);
+    }
+    const siblingCount = Math.max(1, Math.floor((safeMaxVisible - 3) / 2) - 1);
+    const left = Math.max(2, safePage - siblingCount);
+    const right = Math.min(safeTotal - 1, safePage + siblingCount);
+    const showLeftDots = left > 2;
+    const showRightDots = right < safeTotal - 1;
+    const out = [1];
+    if (showLeftDots) {
+        out.push(PAGINATION_ELLIPSIS);
+    }
+    else {
+        for (let p = 2; p < left; p++)
+            out.push(p);
+    }
+    for (let p = left; p <= right; p++)
+        out.push(p);
+    if (showRightDots) {
+        out.push(PAGINATION_ELLIPSIS);
+    }
+    else {
+        for (let p = right + 1; p < safeTotal; p++)
+            out.push(p);
+    }
+    out.push(safeTotal);
+    return Object.freeze(out);
+}
+export function getPaginationZoneId(paginationId) {
+    return `${PAGINATION_ZONE_PREFIX}:${encodeSegment(paginationId)}`;
+}
+export function getPaginationControlId(paginationId, control) {
+    return `${PAGINATION_CONTROL_PREFIX}:${encodeSegment(paginationId)}:${control}`;
+}
+export function getPaginationPageId(paginationId, page) {
+    return `${PAGINATION_PAGE_PREFIX}:${encodeSegment(paginationId)}:${String(normalizePaginationPage(page, Number.MAX_SAFE_INTEGER))}`;
+}
+export function parsePaginationId(id) {
+    if (id.startsWith(`${PAGINATION_CONTROL_PREFIX}:`)) {
+        const body = id.slice(PAGINATION_CONTROL_PREFIX.length + 1);
+        const sep = body.lastIndexOf(":");
+        if (sep <= 0 || sep >= body.length - 1)
+            return null;
+        const paginationId = decodeSegment(body.slice(0, sep));
+        const control = body.slice(sep + 1);
+        if (paginationId === null)
+            return null;
+        if (control !== "first" && control !== "prev" && control !== "next" && control !== "last") {
+            return null;
+        }
+        return Object.freeze({ paginationId, kind: "control", control });
+    }
+    if (id.startsWith(`${PAGINATION_PAGE_PREFIX}:`)) {
+        const body = id.slice(PAGINATION_PAGE_PREFIX.length + 1);
+        const sep = body.lastIndexOf(":");
+        if (sep <= 0 || sep >= body.length - 1)
+            return null;
+        const paginationId = decodeSegment(body.slice(0, sep));
+        const pageRaw = Number.parseInt(body.slice(sep + 1), 10);
+        if (paginationId === null || !Number.isFinite(pageRaw) || pageRaw < 1)
+            return null;
+        return Object.freeze({ paginationId, kind: "page", page: pageRaw });
+    }
+    return null;
+}
+export function buildPaginationChildren(props) {
+    const safeTotal = normalizeTotalPages(props.totalPages);
+    const safePage = normalizePaginationPage(props.page, safeTotal);
+    const items = computeVisiblePaginationItems(safePage, safeTotal, 7);
+    const showFirstLast = props.showFirstLast === true;
+    const controls = [];
+    if (showFirstLast) {
+        controls.push({
+            kind: "button",
+            props: {
+                id: getPaginationControlId(props.id, "first"),
+                label: "<<",
+                disabled: safePage <= 1,
+                onPress: () => props.onChange(1),
+            },
+        });
+    }
+    controls.push({
+        kind: "button",
+        props: {
+            id: getPaginationControlId(props.id, "prev"),
+            label: "<",
+            disabled: safePage <= 1,
+            onPress: () => props.onChange(movePaginationPage(safePage, safeTotal, "prev")),
+        },
+    });
+    for (const token of items) {
+        if (token === PAGINATION_ELLIPSIS) {
+            controls.push({ kind: "text", text: PAGINATION_ELLIPSIS, props: {} });
+            continue;
+        }
+        controls.push({
+            kind: "button",
+            props: {
+                id: getPaginationPageId(props.id, token),
+                label: token === safePage ? `[${String(token)}]` : String(token),
+                onPress: () => props.onChange(token),
+            },
+        });
+    }
+    controls.push({
+        kind: "button",
+        props: {
+            id: getPaginationControlId(props.id, "next"),
+            label: ">",
+            disabled: safePage >= safeTotal,
+            onPress: () => props.onChange(movePaginationPage(safePage, safeTotal, "next")),
+        },
+    });
+    if (showFirstLast) {
+        controls.push({
+            kind: "button",
+            props: {
+                id: getPaginationControlId(props.id, "last"),
+                label: ">>",
+                disabled: safePage >= safeTotal,
+                onPress: () => props.onChange(safeTotal),
+            },
+        });
+    }
+    const controlsRow = {
+        kind: "row",
+        props: {
+            gap: 0,
+            wrap: true,
+            items: "center",
+        },
+        children: Object.freeze(controls),
+    };
+    const zone = {
+        kind: "focusZone",
+        props: {
+            id: getPaginationZoneId(props.id),
+            tabIndex: 0,
+            navigation: "linear",
+            columns: 1,
+            wrapAround: false,
+        },
+        children: Object.freeze([controlsRow]),
+    };
+    return Object.freeze([zone]);
+}
+export function createPaginationVNode(props) {
+    return {
+        kind: "pagination",
+        props,
+        children: buildPaginationChildren(props),
+    };
+}
+let paginationWidgetFactory = null;
+function getPaginationWidgetFactory() {
+    if (paginationWidgetFactory === null) {
+        paginationWidgetFactory = defineWidget((props, ctx) => {
+            const idRef = ctx.useRef(props.id);
+            idRef.current = props.id;
+            return createPaginationVNode(props);
+        }, { name: "pagination" });
+    }
+    return paginationWidgetFactory;
+}
+export function createPaginationWidgetVNode(props) {
+    return getPaginationWidgetFactory()(props);
+}
+//# sourceMappingURL=pagination.js.map

package/dist/widgets/pagination.js.map

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

package/dist/widgets/protocol.d.ts

@@ -0,0 +1,39 @@
+/** Children layout policy. */
+export type ChildrenPolicy = "none" | "single" | "many";
+/** Input model for event routing. */
+export type InputModel = "none" | "press" | "text" | "value" | "composite";
+/** Per-widget-kind capability descriptor. */
+export type WidgetProtocol = Readonly<{
+    /** Does this widget require a unique `id` prop for focus/routing? */
+    requiresId: boolean;
+    /** Is this widget focusable by default (Tab traversal)? */
+    focusable: boolean;
+    /** Can this widget produce a "press" action? */
+    pressable: boolean;
+    /** Does this widget support the `disabled` prop to suppress focus? */
+    disableable: boolean;
+    /** Does this widget need an `open` prop to be focusable? (commandPalette, toolApprovalDialog) */
+    openGated: boolean;
+    /** Does this widget require routing rebuild when props change? */
+    requiresRoutingRebuild: boolean;
+}>;
+/**
+ * Canonical widget protocol registry.
+ *
+ * To add a new widget kind: add its entry here, and all subsystems
+ * (commit, widgetMeta, hitTest, router) will automatically pick it up.
+ */
+export declare const WIDGET_PROTOCOL: Readonly<Partial<Record<string, WidgetProtocol>>>;
+/** Get the protocol for a widget kind. Returns DISPLAY_ONLY for unknown kinds. */
+export declare function getWidgetProtocol(kind: string): WidgetProtocol;
+/** Check if a widget kind requires a unique interactive id. */
+export declare function kindRequiresId(kind: string): boolean;
+/** Check if a widget kind is focusable by default. */
+export declare function kindIsFocusable(kind: string): boolean;
+/** Check if a widget kind can produce press actions. */
+export declare function kindIsPressable(kind: string): boolean;
+/** Check if a widget kind supports the disabled prop for focus suppression. */
+export declare function kindIsDisableable(kind: string): boolean;
+/** Check if a widget kind requires `open: true` to be focusable. */
+export declare function kindIsOpenGated(kind: string): boolean;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/widgets/protocol.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAE3E,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,WAAW,EAAE,OAAO,CAAC;IACrB,iGAAiG;IACjG,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC,CAAC;AAiEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CA8E5E,CAAC;AAEH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE9D;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}