@ultimat3/ui 29.4.0 → 30.1.0

package/src/index.ts

@@ -60,28 +60,61 @@ export {
 } from './components/async-branch';
 export type { BadgeProps } from './components/Badge';
 export { Badge } from './components/Badge';
-export type { BarChartProps } from './components/BarChart';
+export type {
+  BarChartPointsProps,
+  BarChartProps,
+  BarChartSeriesProps,
+} from './components/BarChart';
 export { BarChart } from './components/BarChart';
+export type { BoardColumn, BoardProps } from './components/Board';
+export { Board } from './components/Board';
+export type { BottomNavItem, BottomNavProps } from './components/BottomNav';
+export { BottomNav } from './components/BottomNav';
 export type { BreadcrumbItem, BreadcrumbProps } from './components/Breadcrumb';
 export { Breadcrumb } from './components/Breadcrumb';
 export type { ButtonProps } from './components/Button';
 export { Button } from './components/Button';
-export type { BarRect, ChartPoint } from './components/bar-chart-view';
+export type { BarExtent, BarRect, ChartPoint } from './components/bar-chart-view';
 export { barRects } from './components/bar-chart-view';
+export { BOTTOM_NAV_MAX, bottomNavItems } from './components/bottom-nav-view';
+export type {
+  CalendarLinkProps,
+  CalendarProps,
+  CalendarSelectProps,
+} from './components/Calendar';
+export { Calendar } from './components/Calendar';
 export type { CardProps, Elevation } from './components/Card';
 export { Card } from './components/Card';
 export type { ChartFrameProps, ChartLegendItem } from './components/ChartFrame';
 export { ChartFrame } from './components/ChartFrame';
 export type { CheckboxProps } from './components/Checkbox';
 export { Checkbox } from './components/Checkbox';
+export type { CodeBlockProps } from './components/CodeBlock';
+export { CodeBlock } from './components/CodeBlock';
 export type { ComboboxProps } from './components/Combobox';
 export { Combobox } from './components/Combobox';
 export type { CommandPaletteLabels, CommandPaletteProps } from './components/CommandPalette';
 export { CommandPalette } from './components/CommandPalette';
+export type {
+  ConfirmDialogIslandProps,
+  ConfirmDialogPostProps,
+  ConfirmDialogProps,
+} from './components/ConfirmDialog';
+export { ConfirmDialog } from './components/ConfirmDialog';
 export type { ContainerProps, ContainerSize } from './components/Container';
 export { Container } from './components/Container';
 export type { CopyButtonProps } from './components/CopyButton';
 export { COPIED_MS, CopyButton } from './components/CopyButton';
+export type { CalendarBounds, CalendarDay, StepOptions, Weekday } from './components/calendar-view';
+export {
+  dayLabel,
+  monthGrid,
+  monthLabel,
+  rovingDay,
+  stepDay,
+  weekdayLabels,
+  weekStartOf,
+} from './components/calendar-view';
 export type {
   ChartSeries,
   ChartTable,
@@ -91,17 +124,25 @@ export type {
   SeriesStyle,
 } from './components/chart-frame-view';
 export { CHART_SERIES_SLOTS, chartTable, seriesStyle } from './components/chart-frame-view';
+export type { ChartReference } from './components/chart-reference-view';
 export type { NiceScale, NiceTicksOptions } from './components/chart-ticks-view';
 export { niceTicks } from './components/chart-ticks-view';
 export type { ComboboxOption } from './components/combobox-filter';
 export { filterOptions, normalizeQuery } from './components/combobox-filter';
-export type { CommandPaletteItem, PaletteKeyAction } from './components/command-palette-view';
+export type {
+  CommandPaletteGroup,
+  CommandPaletteItem,
+  PaletteKeyAction,
+} from './components/command-palette-view';
 export {
   filterItems,
+  groupItems,
   keyAction,
   settleActive,
   stepActive,
 } from './components/command-palette-view';
+export type { ConfirmEvent, ConfirmState } from './components/confirm-dialog-view';
+export { CONFIRM_IDLE, confirmLabelOf, confirmStep } from './components/confirm-dialog-view';
 export type {
   Column,
   DataTableCallbackProps,
@@ -110,10 +151,18 @@ export type {
   DataTableProps,
 } from './components/DataTable';
 export { DataTable } from './components/DataTable';
+export type { DatePickerProps } from './components/DatePicker';
+export { DatePicker } from './components/DatePicker';
+export type { DateRangePickerProps } from './components/DateRangePicker';
+export { DateRangePicker } from './components/DateRangePicker';
 export type { DateTimeProps } from './components/DateTime';
 export { DateTime } from './components/DateTime';
+export type { DescriptionItem, DescriptionListProps } from './components/DescriptionList';
+export { DescriptionList } from './components/DescriptionList';
 export type { DialogProps } from './components/Dialog';
 export { Dialog } from './components/Dialog';
+export type { DiffViewPatchProps, DiffViewProps, DiffViewTextProps } from './components/DiffView';
+export { DiffView } from './components/DiffView';
 export type { DividerProps } from './components/Divider';
 export { Divider } from './components/Divider';
 export type { DonutChartProps, DonutSegment } from './components/DonutChart';
@@ -123,6 +172,8 @@ export { Drawer } from './components/Drawer';
 export type { DropzoneProps } from './components/Dropzone';
 export { Dropzone } from './components/Dropzone';
 export type { ColumnPriority } from './components/data-table-view';
+export type { DateRange, SpanPosition } from './components/date-range-view';
+export { orderedRange, pickRange, spanPosition } from './components/date-range-view';
 export type {
   DateStyle,
   DateTimeFormatter,
@@ -131,6 +182,8 @@ export type {
   TimeInput,
 } from './components/date-time-view';
 export { dateTimeView, toDate, toInstant, toIsoInstant } from './components/date-time-view';
+export type { DrawerRelease, DrawerSnap } from './components/drawer-gesture-view';
+export { dragOffset, releaseSnap } from './components/drawer-gesture-view';
 export type { EmptyStateProps } from './components/EmptyState';
 export { EmptyState } from './components/EmptyState';
 export type { ErrorStateProps } from './components/ErrorState';
@@ -157,8 +210,12 @@ export type { GaugeProps } from './components/Gauge';
 export { Gauge } from './components/Gauge';
 export type { GridProps } from './components/Grid';
 export { Grid } from './components/Grid';
+export type { GaugeThreshold } from './components/gauge-view';
+export type { HeatStripProps } from './components/HeatStrip';
+export { HeatStrip } from './components/HeatStrip';
 export type { HeadingLevel, HeadingTag } from './components/heading-level';
 export { HEADING_LEVELS, headingTag, nextHeadingLevel } from './components/heading-level';
+export type { HeatCell, HeatRow, HeatShape } from './components/heat-strip-view';
 export type { IconProps } from './components/Icon';
 // --- icons: the glyphs themselves are per-icon modules, `@ultimat3/ui/icons/<name>` ---------
 export { Icon } from './components/Icon';
@@ -184,15 +241,25 @@ export type {
 } from './components/image-source';
 export { boxFor, reservedRatio, sourceSetsFor, variantSrcset } from './components/image-source';
 export type { LoadMoreInput, LoadMoreState } from './components/infinite-scroll-view';
+export type { JsonViewProps } from './components/JsonView';
+export { JsonView } from './components/JsonView';
 export type { KbdProps } from './components/Kbd';
 export { Kbd } from './components/Kbd';
 export type { AreaChartProps, LineChartProps } from './components/LineChart';
 export { AreaChart, LineChart } from './components/LineChart';
 export type { ButtonLinkProps, LinkProps, TextLinkProps } from './components/Link';
 export { Link } from './components/Link';
+export type { LiveIndicatorProps, LiveIndicatorState } from './components/LiveIndicator';
+export { LIVE_INDICATOR_STATES, LiveIndicator } from './components/LiveIndicator';
 export type { LocaleSwitcherProps } from './components/LocaleSwitcher';
 export { LocaleSwitcher, localeLabel } from './components/LocaleSwitcher';
+export type { LogViewerProps } from './components/LogViewer';
+export { LogViewer } from './components/LogViewer';
 export type { LinkTarget } from './components/link-target';
+export type { LogLine, LogViewerLevel } from './components/log-viewer-view';
+export { LOG_VIEWER_LEVELS } from './components/log-viewer-view';
+export type { MarkdownProps, ResolvedImage } from './components/Markdown';
+export { Markdown } from './components/Markdown';
 export type { MenuItem, MenuProps } from './components/Menu';
 export { Menu } from './components/Menu';
 export type { MeterProps } from './components/Meter';
@@ -202,6 +269,14 @@ export { Money } from './components/Money';
 export type { MoneyFormatter, MoneyInput, MoneyViewOptions } from './components/money-view';
 // --- formatting cores (pure, renderer-free) ----------------------------------
 export { moneyText, toMoney } from './components/money-view';
+export type {
+  NavListEntry,
+  NavListGroup,
+  NavListLink,
+  NavListProps,
+} from './components/NavList';
+export { NavList } from './components/NavList';
+export { currentOf } from './components/nav-list-view';
 export type { PageHeaderProps } from './components/PageHeader';
 export { PageHeader } from './components/PageHeader';
 export type {
@@ -212,6 +287,17 @@ export type {
 export { Pagination } from './components/Pagination';
 export type { Placement, PopoverProps } from './components/Popover';
 export { Popover } from './components/Popover';
+export type { PullToRefreshProps } from './components/PullToRefresh';
+export { PullToRefresh } from './components/PullToRefresh';
+export type { PullController, PullEvent, PullState } from './components/pull-refresh-view';
+export {
+  PULL_IDLE,
+  PULL_MAX,
+  PULL_THRESHOLD,
+  pullController,
+  pullDistance,
+  pullStep,
+} from './components/pull-refresh-view';
 export type { QrCodeProps } from './components/QrCode';
 export { QrCode } from './components/QrCode';
 export type { QrMatrix } from './components/qr-matrix';
@@ -220,38 +306,78 @@ export type { RadioOption, RadioProps } from './components/Radio';
 export { Radio } from './components/Radio';
 export type { RelativeTimeProps } from './components/RelativeTime';
 export { RelativeTime } from './components/RelativeTime';
+export type { RankableOption, RankedOptions } from './components/rank-options';
+export { rankOptions } from './components/rank-options';
 export type { RelativeTimeOptions } from './components/relative-time-view';
+export type {
+  SearchableSelectManyProps,
+  SearchableSelectOneProps,
+  SearchableSelectProps,
+} from './components/SearchableSelect';
+export { SearchableSelect } from './components/SearchableSelect';
 export type { SectionProps } from './components/Section';
 export { Section } from './components/Section';
 export type { SelectOption, SelectProps } from './components/Select';
 export { Select } from './components/Select';
+export type { ShortcutSheetProps } from './components/ShortcutSheet';
+export { ShortcutSheet } from './components/ShortcutSheet';
 export type { SkeletonProps } from './components/Skeleton';
 export { Skeleton } from './components/Skeleton';
+export type { SliderProps } from './components/Slider';
+export { Slider } from './components/Slider';
+export type { SortableListProps } from './components/SortableList';
+export { SortableList } from './components/SortableList';
 export type { SparklineProps } from './components/Sparkline';
 export { Sparkline } from './components/Sparkline';
 export type { SpinnerProps } from './components/Spinner';
 export { Spinner } from './components/Spinner';
+export type { SplitPaneProps } from './components/SplitPane';
+export { SplitPane } from './components/SplitPane';
 export type { StackProps } from './components/Stack';
 export { Stack } from './components/Stack';
 export type { StatTileProps } from './components/StatTile';
 export { StatTile } from './components/StatTile';
+export type { StepperProps } from './components/Stepper';
+export { Stepper } from './components/Stepper';
 export type { SwitchProps } from './components/Switch';
 export { Switch } from './components/Switch';
+export type { SearchableOption } from './components/searchable-select-view';
 export type { SortDirection, SortState } from './components/sort-state';
-export type { SparkPoint } from './components/sparkline-view';
+export type { SortFields } from './components/sort-surface';
+export type { SparklinePoint, SparkPoint } from './components/sparkline-view';
 export { sparklinePath } from './components/sparkline-view';
-export type { StatDelta, StatTrend } from './components/stat-delta';
-export { deltaOf } from './components/stat-delta';
+export type {
+  DeltaOptions,
+  StatDelta,
+  StatGoodWhen,
+  StatMood,
+  StatTrend,
+} from './components/stat-delta';
+export { deltaMood, deltaOf } from './components/stat-delta';
+export type { StepperModel, StepperStep, StepState } from './components/stepper-view';
+export { stepperModel } from './components/stepper-view';
 export type { TableProps } from './components/Table';
 export { Table } from './components/Table';
-export type { TabItem, TabsProps } from './components/Tabs';
+export type {
+  TabItem,
+  TabLinkItem,
+  TabsButtonProps,
+  TabsLinkProps,
+  TabsProps,
+} from './components/Tabs';
 export { Tabs } from './components/Tabs';
+export type { TerminalViewProps } from './components/TerminalView';
+export { TerminalView } from './components/TerminalView';
 export type { TextProps, TextSize, TextTone, TextWeight } from './components/Text';
 export { TEXT_TONES, Text } from './components/Text';
 export type { TextareaProps } from './components/Textarea';
 export { Textarea } from './components/Textarea';
 export type { ThemeChoice, ThemeToggleProps } from './components/ThemeToggle';
 export { ThemeToggle } from './components/ThemeToggle';
+export type { TimelineItem, TimelineProps } from './components/Timeline';
+export { Timeline } from './components/Timeline';
+export type { TimeRangePickerProps } from './components/TimeRangePicker';
+export { TimeRangePicker } from './components/TimeRangePicker';
 export type { ToastPlacement, ToastProps, ToastRegionProps } from './components/Toast';
 export { Toast, ToastRegion } from './components/Toast';
 export type { ToasterProps } from './components/Toaster';
@@ -260,14 +386,63 @@ export type { ToolbarProps } from './components/Toolbar';
 export { Toolbar } from './components/Toolbar';
 export type { TooltipProps } from './components/Tooltip';
 export { Tooltip } from './components/Tooltip';
+export type { TreeLinkProps, TreeProps, TreeSelectProps } from './components/Tree';
+export { Tree } from './components/Tree';
+export type { TimelineGroup } from './components/timeline-view';
+export { timelineGroups } from './components/timeline-view';
+export type { FlatTreeNode, TreeMove, TreeNode } from './components/tree-view';
+export {
+  flattenTree,
+  treeAncestors,
+  treeMove,
+  treeTypeahead,
+  visibleTreeIds,
+} from './components/tree-view';
+export type {
+  CommandPaletteController,
+  CommandPaletteState,
+  UseCommandPaletteOptions,
+} from './components/use-command-palette';
+export { useCommandPalette } from './components/use-command-palette';
+export type { VirtualListProps } from './components/VirtualList';
+export { VirtualList } from './components/VirtualList';
 export type { Align, ButtonVariant, Size, SpaceStep, Tone } from './components/variants';
 // --- variants ----------------------------------------------------------------
 export { BUTTON_VARIANTS, SIZES, TONES } from './components/variants';
+export type { ScrollAnchor, VisibleRange } from './components/virtual-list-view';
+export {
+  anchorAt,
+  anchoredScrollTop,
+  rowOffsets,
+  VIRTUAL_LIST_ESTIMATE,
+  VIRTUAL_LIST_OVERSCAN,
+  visibleRange,
+} from './components/virtual-list-view';
+export { headingIds, headingSlug } from './content/heading-slug';
+export type { Language, Token, TokenKind, TokenRule } from './content/highlight';
+export { defineLanguage, highlight, TOKEN_KINDS } from './content/highlight';
+export { allLanguages } from './content/languages/all';
+export { diffLanguage } from './content/languages/diff';
+export { htmlLanguage } from './content/languages/html';
+export { jsonLanguage } from './content/languages/json';
+export { shellLanguage } from './content/languages/shell';
+export { sqlLanguage } from './content/languages/sql';
+export { tsLanguage } from './content/languages/ts';
+export { yamlLanguage } from './content/languages/yaml';
+export { parseMarkdown } from './content/markdown-parse';
+export type {
+  MarkdownBlock,
+  MarkdownInline,
+  MarkdownListItem,
+  TableAlign,
+} from './content/markdown-tree';
+export { MARKDOWN_MAX_CHARS } from './content/markdown-tree';
 export type { ClassValue } from './cx';
 // --- helpers -----------------------------------------------------------------
 export { cx } from './cx';
 export type { Debounced } from './debounce';
 export { DEBOUNCE_DEFAULT_MS, debounce } from './debounce';
+export type { CanDrop, SortMove } from './drag/sort-view';
 export type { UiErrorCode } from './errors';
 export {
   conflictingFieldNameError,
@@ -285,16 +460,11 @@ export {
   unknownTokenError,
 } from './errors';
 // --- forms: the binding between an action's input schema and Field's error slot ---------------
-export type { FieldPathSegment, IssuePathSegment } from './form/field-path';
-export { fieldSelector, formatFieldPath, MAX_FIELD_INDEX, parseFieldPath } from './form/field-path';
+export type { FieldPathSegment } from './form/field-path';
+export { fieldSelector, MAX_FIELD_INDEX, parseFieldPath } from './form/field-path';
 export type { FormBinding, FormBindingOptions } from './form/form-binding';
 export { formBinding } from './form/form-binding';
-export type {
-  FormIssue,
-  FormSchema,
-  FormValidationIssue,
-  FormValidationResult,
-} from './form/form-issue';
+export type { FormIssue } from './form/form-issue';
 export { issuesFromRejection, issuesFromValidation } from './form/form-issue';
 export type { FormErrors, FormState, FormStatus } from './form/form-state';
 export {
@@ -312,13 +482,33 @@ export {
 } from './form/form-touch';
 export { valuesOfForm } from './form/form-values';
 export { useForm } from './form/use-form';
+export type {
+  CompiledHotkeys,
+  HotkeyAnswer,
+  HotkeyKeyEvent,
+  HotkeyRow,
+  HotkeyState,
+  HotkeyTable,
+} from './hotkeys-view';
+export {
+  CHORD_WINDOW_MS,
+  compileHotkeys,
+  hotkeyAction,
+  hotkeyKeycaps,
+  IDLE_HOTKEY_STATE,
+} from './hotkeys-view';
 export type { UiKey } from './i18n-keys';
 export { UI_KEYS } from './i18n-keys';
+export type { ListChange, ListLimit, ListUrl, ListUrlOptions } from './list-url';
+export { listUrl } from './list-url';
+export type { LiveWindowOptions } from './live-window';
+export { liveWindow } from './live-window';
 export type { ArrowKeyElement, RovingItem } from './roving';
 export {
   handlesOwnArrowKeys,
   MENU_ITEM_SELECTOR,
   TAB_SELECTOR,
+  TREE_ITEM_SELECTOR,
   tabStopIndex,
 } from './roving';
 export { ambientUiContext } from './theme/ambient';
@@ -363,6 +553,13 @@ export {
   toggleTheme,
   watchOsTheme,
 } from './theme/theme';
+export type {
+  TimeRangeChange,
+  TimeRangePreset,
+  TimeRangeUrl,
+  TimeRangeUrlOptions,
+} from './time-range-url';
+export { fromLocalDateTime, timeRangeUrl, toLocalDateTime } from './time-range-url';
 export type {
   ToastAction,
   ToastDwell,
@@ -423,3 +620,5 @@ export {
   zTokens,
 } from './tokens/tokens';
 export { uiCatalog } from './ui-catalog';
+export type { HotkeyHost } from './use-hotkeys';
+export { EDITABLE_SELECTOR, registerHotkeys, useHotkeyRows, useHotkeys } from './use-hotkeys';

package/src/list-url.ts

@@ -0,0 +1,123 @@
+// A list's state in its URL — sort, cursor, limit, search — read leniently and written as hrefs, so
+// a server-rendered `DataTable` sorts and pages with no island and an island reads the same URL.
+// Pure: no DOM, no router. Beside `sort-state.ts`, whose `SortState` it speaks.
+
+import type { SortDirection, SortState } from './components/sort-state';
+
+/** The page size a URL may ask for: `default` when absent or unreadable, never above `max`. */
+export interface ListLimit {
+  readonly default: number;
+  readonly max: number;
+}
+
+export interface ListUrlOptions<S extends string> {
+  /** The column keys the list can sort by. Any other `sort` in the URL is no sort. */
+  readonly sorts: readonly S[];
+  /**
+   * Prefixes every parameter (`runs.after`), for two lists on one page. With it, any change but a
+   * cursor drops EVERY cursor on the page: a cursor is bound to the filter and sort it was minted
+   * under, and the server refuses a stale one (`X_CURSOR_INVALID`).
+   */
+  readonly ns?: string | undefined;
+  readonly limit?: ListLimit | undefined;
+}
+
+/** What `href` changes. A key present with `undefined` removes that parameter. */
+export interface ListChange {
+  readonly sort?: SortState | undefined;
+  readonly q?: string | undefined;
+  readonly limit?: number | undefined;
+}
+
+export interface ListUrl<S extends string> {
+  readonly sort: (SortState & { readonly key: S }) | undefined;
+  /** The opaque cursor to read after; `undefined` on the first page. */
+  readonly cursor: string | undefined;
+  readonly limit: number;
+  /** The search text, trimmed; `undefined` when empty. */
+  readonly q: string | undefined;
+  /** The list under `change`, every other parameter kept, its cursor dropped. */
+  href(change: ListChange): string;
+  /** `DataTable`/`Pagination`'s `hrefFor`: the same list at `cursor`, everything else kept. */
+  hrefFor(cursor: string, direction: 'next' | 'prev'): string;
+  /** `DataTable`'s `sortHrefFor`: the list under the next sort state; `undefined` is unsorted. */
+  sortHrefFor(sort: SortState | undefined): string;
+  /** The first page — the list without its cursor. `undefined` when already there. */
+  readonly firstHref: string | undefined;
+}
+
+const DEFAULT_LIMIT: ListLimit = { default: 50, max: 100 };
+
+/** A relative URL needs a base to parse; it never reaches an href, which is path and query only. */
+const BASE = 'http://list.invalid';
+
+const CURSOR = 'after';
+
+const isCursorParam = (name: string): boolean => name === CURSOR || name.endsWith(`.${CURSOR}`);
+
+const direction = (raw: string | null): SortDirection => (raw === 'desc' ? 'desc' : 'asc');
+
+const readLimit = (raw: string | null, bounds: ListLimit): number => {
+  if (raw === null || !/^\d+$/.test(raw)) return bounds.default;
+  const value = Number(raw);
+  return value >= 1 && value <= bounds.max ? value : bounds.default;
+};
+
+const present = (raw: string | null): string | undefined => {
+  const value = raw?.trim();
+  return value === undefined || value === '' ? undefined : value;
+};
+
+export function listUrl<S extends string>(
+  url: URL | string,
+  options: ListUrlOptions<S>,
+): ListUrl<S> {
+  const parsed = new URL(url, BASE);
+  const name = (param: string): string =>
+    options.ns === undefined ? param : `${options.ns}.${param}`;
+  const params = parsed.searchParams;
+
+  const rawSort = params.get(name('sort'));
+  const key = options.sorts.find((candidate) => candidate === rawSort);
+  const sort =
+    key === undefined ? undefined : { key, direction: direction(params.get(name('dir'))) };
+  const cursor = present(params.get(name(CURSOR)));
+
+  const write = (edit: (next: URLSearchParams) => void): string => {
+    const next = new URLSearchParams(params);
+    edit(next);
+    const search = next.toString();
+    return search === '' ? parsed.pathname : `${parsed.pathname}?${search}`;
+  };
+  const put = (next: URLSearchParams, param: string, value: string | undefined): void => {
+    if (value === undefined) next.delete(name(param));
+    else next.set(name(param), value);
+  };
+  /** Without `ns` the list owns one cursor; with it, a filter change resets every list. */
+  const dropCursors = (next: URLSearchParams): void => {
+    const cursors = options.ns === undefined ? [CURSOR] : [...next.keys()].filter(isCursorParam);
+    for (const param of cursors) next.delete(param);
+  };
+
+  const href = (change: ListChange): string =>
+    write((next) => {
+      dropCursors(next);
+      if ('sort' in change) {
+        put(next, 'sort', change.sort?.key);
+        put(next, 'dir', change.sort?.direction);
+      }
+      if ('q' in change) put(next, 'q', present(change.q ?? null));
+      if ('limit' in change) put(next, 'limit', change.limit?.toString());
+    });
+
+  return {
+    sort,
+    cursor,
+    limit: readLimit(params.get(name('limit')), options.limit ?? DEFAULT_LIMIT),
+    q: present(params.get(name('q'))),
+    href,
+    hrefFor: (to) => write((next) => put(next, CURSOR, to)),
+    sortHrefFor: (next) => href({ sort: next }),
+    firstHref: cursor === undefined ? undefined : write((next) => put(next, CURSOR, undefined)),
+  };
+}

package/src/live-window.ts

@@ -0,0 +1,23 @@
+// The trim behind a live chart: append the newest point, keep the last `max`. Pure and free of any
+// chart module, so a live island pays for one function — and every point that survives keeps its
+// key, which is what keeps its node (and the focus on it) through the tick (`hitIds`).
+
+import { finiteCount } from '@ultimat3/core';
+
+export interface LiveWindowOptions {
+  /** How many points the window holds, at least 1. A whole number — it counts points. */
+  readonly max: number;
+}
+
+/** `series` with `point` appended and the oldest dropped past `max`. Never mutates `series`. */
+export function liveWindow<T>(
+  series: readonly T[],
+  point: T,
+  options: LiveWindowOptions,
+): readonly T[] {
+  // `slice(-NaN)` is the whole array and `slice(-Infinity)` too: an unbounded window, which is
+  // the leak a live chart left open for an hour is.
+  const max = finiteCount('liveWindow', 'max', options.max, 1);
+  const next = [...series, point];
+  return next.length > max ? next.slice(next.length - max) : next;
+}

package/src/roving.ts

@@ -11,6 +11,8 @@
  */
 export const MENU_ITEM_SELECTOR = '[role="menuitem"]:not([disabled])';
 export const TAB_SELECTOR = '[role="tab"]:not([disabled])';
+/** A tree item is an `<li>`, which has no `disabled`: a disabled one carries `aria-disabled`. */
+export const TREE_ITEM_SELECTOR = '[role="treeitem"]:not([aria-disabled="true"])';
 
 /** The only thing the tab-stop rule needs to know about an item. */
 export interface RovingItem {

package/src/theme/inert-runtime.ts

@@ -45,4 +45,8 @@ export const INERT_SOLID_RUNTIME: SolidRuntime = Object.freeze({
   createEffect: () => {},
 
   onCleanup: () => {},
+
+  // A server render is one pass: there is nothing to outlive, so a root is the call itself, and
+  // its `dispose` has nothing to release.
+  createRoot: <T>(fn: (dispose: () => void) => T): T => fn(() => {}),
 });

package/src/theme/runtime-slot.ts

@@ -11,8 +11,8 @@ import type { SolidRuntime } from './solid-adapter';
 let runtime: SolidRuntime | null = null;
 
 /**
- * Register once, in the app entry, before the first render. Hand it the six named imports —
- * `{ createContext, useContext, createSignal, createMemo, createEffect, onCleanup }` — and not
+ * Register once, in the app entry, before the first render. Hand it the seven named imports —
+ * `{ createContext, useContext, createSignal, createMemo, createEffect, onCleanup, createRoot }` — and not
  * `import * as solidRuntime`: the namespace registers too, and costs 14.8 kB of unshaken solid-js
  * per island chunk (`solid-adapter.ts` has the measurement).
  */

package/src/theme/solid-adapter.ts

@@ -30,13 +30,13 @@ export interface SolidContext<T> {
 }
 
 /**
- * The exact slice of solid-js the design system touches — six functions, and the registration is
- * meant to be handed exactly those six as NAMED imports: `setSolidRuntime({ createContext,
- * useContext, createSignal, createMemo, createEffect, onCleanup })`. A `typeof import('solid-js')`
+ * The exact slice of solid-js the design system touches — seven functions, and the registration is
+ * meant to be handed exactly those seven as NAMED imports: `setSolidRuntime({ createContext,
+ * useContext, createSignal, createMemo, createEffect, onCleanup, createRoot })`. A `typeof import('solid-js')`
  * namespace still satisfies this shape and still registers, but a namespace object passed to a
  * function is one the bundler cannot shake — every export of solid-js stays in the chunk. Measured
  * with the island bundler's own settings (minified, production, no splitting): the namespace form
- * is 28,556 B against 13,708 B for the six picks, 14.8 kB per island that nothing ever calls.
+ * is 28,556 B against 13,708 B for the picks (six, then), 14.8 kB per island that nothing ever calls.
  */
 export interface SolidRuntime {
   createContext<T>(defaultValue: T): SolidContext<T>;
@@ -45,6 +45,12 @@ export interface SolidRuntime {
   createMemo<T>(fn: () => T): Accessor<T>;
   createEffect(fn: () => void): void;
   onCleanup(fn: () => void): void;
+  /**
+   * An owner that outlives the computation it was created in. `DataTable`'s keyed rows need it:
+   * Solid disposes what a computation owns each time it re-runs, so a row built inside the body
+   * kept its markup and lost every binding in it on the next live update. v30.
+   */
+  createRoot<T>(fn: (dispose: () => void) => T): T;
 }
 
 /**
@@ -72,7 +78,7 @@ export function solid(): SolidRuntime {
       // ONE literal, never a concatenation: `fix-scan.ts` reads a single literal in this position
       // and counts anything else `unreadable`, so a fix split across `+` is a fix the gate stops
       // checking.
-      "paste `import { createContext, createEffect, createMemo, createSignal, onCleanup, useContext } from 'solid-js';` at the top of your *.island.tsx and `setSolidRuntime({ createContext, useContext, createSignal, createMemo, createEffect, onCleanup });` as the first line of its mount(), above render() — six named imports, never `import * as`, which keeps all of solid-js in the chunk; a server render needs none",
+      "paste `import { createContext, createEffect, createMemo, createRoot, createSignal, onCleanup, useContext } from 'solid-js';` at the top of your *.island.tsx and `setSolidRuntime({ createContext, useContext, createSignal, createMemo, createEffect, onCleanup, createRoot });` as the first line of its mount(), above render() — seven named imports, never `import * as`, which keeps all of solid-js in the chunk; a server render needs none",
     );
   }
   return INERT_SOLID_RUNTIME;