@texturehq/edges 5.0.1 → 5.1.5

package/dist/{TimeField-rRIt80g3.d.ts → TimeField-DVuYVoDw.d.ts}

@@ -205,6 +205,93 @@ interface ColorFieldProps extends Omit<TextFieldProps$1, "isRequired" | "size" |
  */
 declare function ColorField({ label, description, errorMessage, size, tooltip, isRequired, transparent, className, validationResult, value: controlledValue, defaultValue, onChange, placeholder, showColorSwatch, reserveErrorSpace, ...props }: ColorFieldProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    value: string;
+    label: string;
+    /** Display-only decoration. Never contributes to the search key. */
+    count?: number;
+    disabled?: boolean;
+    group?: string;
+}
+type MultiSelectMatcher = (text: string, query: string) => boolean;
+declare const defaultMultiSelectMatcher: MultiSelectMatcher;
+/**
+ * The only strings an option is searchable by. Presentational decoration —
+ * `count`, badges, anything a renderer composes — is deliberately excluded:
+ * making facet-count digits searchable turned a query for `5` into a match on
+ * a substation labelled `28 (15656)`.
+ */
+declare function multiSelectSearchKeys(option: MultiSelectOption): string[];
+declare function filterMultiSelectOptions<T extends MultiSelectOption>(options: readonly T[], query: string, matcher?: MultiSelectMatcher): T[];
+/**
+ * Whether the typed string should be offered as a selectable literal.
+ *
+ * The trigger is "the query is not already an identity in play" — not "nothing
+ * in the list matched". A match-count trigger is defeatable by any incidental
+ * substring hit, which is how single-digit values became unreachable in the
+ * control this component replaces.
+ */
+declare function shouldOfferLiteralOption(args: {
+    query: string;
+    options: readonly MultiSelectOption[];
+    selected: readonly string[];
+}): boolean;
+interface MultiSelectSelectionEntry {
+    value: string;
+    label: string;
+    count?: number;
+    /** True when the value is not present in the current `options` set. */
+    isUnknown: boolean;
+}
+/**
+ * Selections in insertion order, hydrating labels from `options` where possible.
+ * Values with no matching option still produce an entry so URL-hydrated state is
+ * never silently dropped.
+ */
+declare function multiSelectSelectionEntries(selected: readonly string[], options: readonly MultiSelectOption[]): MultiSelectSelectionEntry[];
+
+interface MultiSelectProps {
+    options: readonly MultiSelectOption[];
+    /** Controlled selection. Order is insertion order. */
+    value?: readonly string[];
+    /** Uncontrolled initial selection. */
+    defaultValue?: readonly string[];
+    onChange: (next: string[]) => void;
+    label: string;
+    placeholder?: string;
+    size?: Size;
+    loading?: boolean;
+    disabled?: boolean;
+    maxSelected?: number;
+    /** Offer the typed string as a selectable value. Off by default. */
+    allowLiteral?: boolean;
+    /** Server-side search. Debouncing is the caller's job. */
+    onSearchChange?: (query: string) => void;
+    /** `options` is a clipped set rather than the whole domain. */
+    truncated?: boolean;
+    /** Size of the whole domain. Rendered with `truncated` as "showing N of M". */
+    totalCount?: number;
+    emptyMessage?: string;
+    showSelectAll?: boolean;
+    description?: string;
+    errorMessage?: string;
+    isRequired?: boolean;
+    /** Fires when the search input loses focus. Form adapters use this to mark the field touched. */
+    onBlur?: (event: React__default.FocusEvent<HTMLInputElement>) => void;
+    /** Ref to the search input, so callers (and `setFocus`) can focus the control. */
+    inputRef?: React__default.Ref<HTMLInputElement>;
+    className?: string;
+    id?: string;
+}
+/**
+ * MultiSelect
+ *
+ * A combobox whose popup is a multi-select listbox (W3C ARIA APG): a search
+ * input narrows a checkbox list, and current selections live in their own
+ * pinned region above it.
+ */
+declare function MultiSelect({ options, value, defaultValue, onChange, label, placeholder, size, loading, disabled, maxSelected, allowLiteral, onSearchChange, truncated, totalCount, emptyMessage, showSelectAll, description, errorMessage, isRequired, onBlur, inputRef: forwardedInputRef, className, id, }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 /**
  * NumberField
  *
@@ -546,4 +633,4 @@ interface TimeFieldProps extends Omit<TimeFieldProps$1<TimeValue>, "isRequired"
  */
 declare function TimeField({ label, description, errorMessage, size, tooltip, isRequired, isDisabled, isInvalid, reserveErrorSpace, validationResult, className, descriptionPlacement, ...props }: TimeFieldProps): react_jsx_runtime.JSX.Element;
 
-export { Autocomplete as A, Button as B, Checkbox as C, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, RadioGroup as c, Switch as d, TextField as e, type TimeFieldProps as f, type ButtonProps as g, type ColorFieldProps as h, Radio as i, RadioCard as j, type RadioCardGroupProps as k, type RadioCardProps as l, type SelectItem as m, TimeField as n };
+export { Autocomplete as A, Button as B, Checkbox as C, MultiSelect as M, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, type MultiSelectOption as c, RadioGroup as d, Switch as e, TextField as f, type TimeFieldProps as g, type ButtonProps as h, type ColorFieldProps as i, type MultiSelectMatcher as j, type MultiSelectProps as k, type MultiSelectSelectionEntry as l, Radio as m, RadioCard as n, type RadioCardGroupProps as o, type RadioCardProps as p, type SelectItem as q, TimeField as r, defaultMultiSelectMatcher as s, filterMultiSelectOptions as t, multiSelectSearchKeys as u, multiSelectSelectionEntries as v, shouldOfferLiteralOption as w };

package/dist/{TimeField-CJUNJDQT.d.cts → TimeField-DsHO9pLs.d.cts}

@@ -205,6 +205,93 @@ interface ColorFieldProps extends Omit<TextFieldProps$1, "isRequired" | "size" |
  */
 declare function ColorField({ label, description, errorMessage, size, tooltip, isRequired, transparent, className, validationResult, value: controlledValue, defaultValue, onChange, placeholder, showColorSwatch, reserveErrorSpace, ...props }: ColorFieldProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    value: string;
+    label: string;
+    /** Display-only decoration. Never contributes to the search key. */
+    count?: number;
+    disabled?: boolean;
+    group?: string;
+}
+type MultiSelectMatcher = (text: string, query: string) => boolean;
+declare const defaultMultiSelectMatcher: MultiSelectMatcher;
+/**
+ * The only strings an option is searchable by. Presentational decoration —
+ * `count`, badges, anything a renderer composes — is deliberately excluded:
+ * making facet-count digits searchable turned a query for `5` into a match on
+ * a substation labelled `28 (15656)`.
+ */
+declare function multiSelectSearchKeys(option: MultiSelectOption): string[];
+declare function filterMultiSelectOptions<T extends MultiSelectOption>(options: readonly T[], query: string, matcher?: MultiSelectMatcher): T[];
+/**
+ * Whether the typed string should be offered as a selectable literal.
+ *
+ * The trigger is "the query is not already an identity in play" — not "nothing
+ * in the list matched". A match-count trigger is defeatable by any incidental
+ * substring hit, which is how single-digit values became unreachable in the
+ * control this component replaces.
+ */
+declare function shouldOfferLiteralOption(args: {
+    query: string;
+    options: readonly MultiSelectOption[];
+    selected: readonly string[];
+}): boolean;
+interface MultiSelectSelectionEntry {
+    value: string;
+    label: string;
+    count?: number;
+    /** True when the value is not present in the current `options` set. */
+    isUnknown: boolean;
+}
+/**
+ * Selections in insertion order, hydrating labels from `options` where possible.
+ * Values with no matching option still produce an entry so URL-hydrated state is
+ * never silently dropped.
+ */
+declare function multiSelectSelectionEntries(selected: readonly string[], options: readonly MultiSelectOption[]): MultiSelectSelectionEntry[];
+
+interface MultiSelectProps {
+    options: readonly MultiSelectOption[];
+    /** Controlled selection. Order is insertion order. */
+    value?: readonly string[];
+    /** Uncontrolled initial selection. */
+    defaultValue?: readonly string[];
+    onChange: (next: string[]) => void;
+    label: string;
+    placeholder?: string;
+    size?: Size;
+    loading?: boolean;
+    disabled?: boolean;
+    maxSelected?: number;
+    /** Offer the typed string as a selectable value. Off by default. */
+    allowLiteral?: boolean;
+    /** Server-side search. Debouncing is the caller's job. */
+    onSearchChange?: (query: string) => void;
+    /** `options` is a clipped set rather than the whole domain. */
+    truncated?: boolean;
+    /** Size of the whole domain. Rendered with `truncated` as "showing N of M". */
+    totalCount?: number;
+    emptyMessage?: string;
+    showSelectAll?: boolean;
+    description?: string;
+    errorMessage?: string;
+    isRequired?: boolean;
+    /** Fires when the search input loses focus. Form adapters use this to mark the field touched. */
+    onBlur?: (event: React__default.FocusEvent<HTMLInputElement>) => void;
+    /** Ref to the search input, so callers (and `setFocus`) can focus the control. */
+    inputRef?: React__default.Ref<HTMLInputElement>;
+    className?: string;
+    id?: string;
+}
+/**
+ * MultiSelect
+ *
+ * A combobox whose popup is a multi-select listbox (W3C ARIA APG): a search
+ * input narrows a checkbox list, and current selections live in their own
+ * pinned region above it.
+ */
+declare function MultiSelect({ options, value, defaultValue, onChange, label, placeholder, size, loading, disabled, maxSelected, allowLiteral, onSearchChange, truncated, totalCount, emptyMessage, showSelectAll, description, errorMessage, isRequired, onBlur, inputRef: forwardedInputRef, className, id, }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 /**
  * NumberField
  *
@@ -546,4 +633,4 @@ interface TimeFieldProps extends Omit<TimeFieldProps$1<TimeValue>, "isRequired"
  */
 declare function TimeField({ label, description, errorMessage, size, tooltip, isRequired, isDisabled, isInvalid, reserveErrorSpace, validationResult, className, descriptionPlacement, ...props }: TimeFieldProps): react_jsx_runtime.JSX.Element;
 
-export { Autocomplete as A, Button as B, Checkbox as C, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, RadioGroup as c, Switch as d, TextField as e, type TimeFieldProps as f, type ButtonProps as g, type ColorFieldProps as h, Radio as i, RadioCard as j, type RadioCardGroupProps as k, type RadioCardProps as l, type SelectItem as m, TimeField as n };
+export { Autocomplete as A, Button as B, Checkbox as C, MultiSelect as M, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, type MultiSelectOption as c, RadioGroup as d, Switch as e, TextField as f, type TimeFieldProps as g, type ButtonProps as h, type ColorFieldProps as i, type MultiSelectMatcher as j, type MultiSelectProps as k, type MultiSelectSelectionEntry as l, Radio as m, RadioCard as n, type RadioCardGroupProps as o, type RadioCardProps as p, type SelectItem as q, TimeField as r, defaultMultiSelectMatcher as s, filterMultiSelectOptions as t, multiSelectSearchKeys as u, multiSelectSelectionEntries as v, shouldOfferLiteralOption as w };

package/dist/{colors-CG2ClL96.d.ts → colors-C7lR_GcP.d.ts}

@@ -1,9 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
-import React__default, { ReactNode, ComponentType } from 'react';
+import React__default, { ReactNode, RefObject, ComponentType } from 'react';
 import { d as IconName } from './RichTextEditor-B_GaE_Yf.js';
 import * as _visx_vendor_d3_scale from '@visx/vendor/d3-scale';
 import { ScaleTime, ScaleLinear } from 'd3-scale';
+import { Virtualizer } from '@tanstack/react-virtual';
 import * as react_map_gl from 'react-map-gl';
 import { ViewState, MapRef } from 'react-map-gl';
 import { MeterProps as MeterProps$1 } from 'react-aria-components';
@@ -113,6 +114,67 @@ interface ActionMenuProps {
  */
 declare function ActionMenu({ children, items, className, align, textAlign, size, onAction, header, footer, useMobileTray, popoverClassName, }: ActionMenuProps): react_jsx_runtime.JSX.Element;
 
+type LoadingState = "idle" | "loading" | "loading-more" | "error";
+interface UseInfiniteScrollOptions<T = unknown> {
+    /** Array of items being displayed */
+    items: T[];
+    /** Callback to load more items (optional - if not provided, no infinite scroll) */
+    onLoadMore?: () => void | Promise<void>;
+    /** Whether there are more items to load */
+    hasMore?: boolean;
+    /** Auto-detects initial vs loading-more from items.length */
+    isLoading?: boolean;
+    /** Explicit loading state override (takes precedence) */
+    loadingState?: LoadingState;
+    /** Enable virtualization (default: true for 100+ items) */
+    enableVirtualization?: boolean;
+    /** Estimated size of each item in pixels */
+    estimatedItemSize?: number;
+    /** Number of items to render outside viewport */
+    overscan?: number;
+    /** Custom scroll element (defaults to parent) */
+    scrollElement?: HTMLElement | null;
+    /** Distance from bottom in pixels to trigger load */
+    loadMoreThreshold?: number;
+}
+interface UseInfiniteScrollReturn {
+    virtualizer: Virtualizer<HTMLElement, Element> | null;
+    virtualItems: ReturnType<Virtualizer<HTMLElement, Element>["getVirtualItems"]>;
+    computedLoadingState: LoadingState;
+    isInitialLoad: boolean;
+    isLoadingMore: boolean;
+    scrollRef: RefObject<HTMLDivElement | null>;
+    loadMoreRef: RefObject<HTMLDivElement | null>;
+    scrollToIndex: (index: number, options?: {
+        align?: "start" | "center" | "end";
+    }) => void;
+    scrollToTop: () => void;
+}
+/**
+ * useInfiniteScroll
+ *
+ * Hook for implementing infinite scroll with optional virtualization.
+ * Intelligently detects initial vs loading-more states from context.
+ *
+ * Features:
+ * - Smart loading state detection (initial vs loading-more)
+ * - Optional explicit state control
+ * - TanStack Virtual integration for performance
+ * - Intersection Observer for load triggering
+ * - Configurable virtualization threshold
+ *
+ * @example
+ * ```tsx
+ * const { scrollRef, computedLoadingState, isLoadingMore } = useInfiniteScroll({
+ *   items,
+ *   onLoadMore: fetchNextPage,
+ *   hasMore: hasNextPage,
+ *   isLoading: isFetching,
+ * });
+ * ```
+ */
+declare function useInfiniteScroll<T = unknown>({ items, onLoadMore, hasMore, isLoading, loadingState, enableVirtualization, estimatedItemSize, overscan, scrollElement, loadMoreThreshold, }: UseInfiniteScrollOptions<T>): UseInfiniteScrollReturn;
+
 type SideNavItem = {
     id: string;
     label: string;
@@ -731,6 +793,195 @@ interface CodeEditorProps {
  */
 declare function CodeEditor({ value, readOnly, onChange, language, theme, height, width, className, lineHeight, minLines, maxLines, showLineNumbers, showGutter, fontSize, wrapEnabled, }: CodeEditorProps): react_jsx_runtime.JSX.Element;
 
+type SortDirection = "asc" | "desc";
+type CellAlignment = "left" | "center" | "right";
+type TableDensity = "compact" | "default" | "relaxed";
+type CellEmphasis = "strong" | "high" | "normal" | "low";
+type LinkBehavior = "none" | "hover" | "visible";
+type TableLayout = "auto" | "fixed" | "responsive";
+type TableWidth = "full" | "auto" | "contained";
+type MobileRenderer = "auto" | "cards" | "custom" | "none";
+type MobileBreakpoint = "sm" | "md" | "lg" | "xl";
+interface SortConfig {
+    columnId: string;
+    direction: SortDirection;
+}
+interface CellContext {
+    isLoading: boolean;
+    /**
+     * Whether this cell's row is selected.
+     *
+     * Populated whenever the table is driven by `onSelectionChange` — before that
+     * it was declared here and assigned by nothing, so `SelectCell` was a checkbox
+     * that reported to nobody. Every cell in a selected row sees it, not just the
+     * checkbox: a cell that wants to render differently inside a selection (a muted
+     * action, a highlighted value) reads it from here.
+     *
+     * `undefined` (not `false`) when selection is off, so a cell can tell "not
+     * selected" from "this table has no selection model".
+     */
+    isSelected?: boolean;
+    isHovered?: boolean;
+    rowIndex: number;
+    columnIndex: number;
+    density: TableDensity;
+}
+interface CellComponentProps<T = any> {
+    value: any;
+    row: T;
+    context: CellContext;
+    [key: string]: any;
+}
+type CellComponent<T = any> = ComponentType<CellComponentProps<T>>;
+interface MobileConfig {
+    priority?: 1 | 2 | 3;
+    format?: "primary" | "secondary" | "badge" | "inline";
+    label?: boolean;
+    icon?: string;
+}
+interface Column<T> {
+    id: string;
+    label: string;
+    accessor?: keyof T | ((row: T) => any);
+    align?: CellAlignment;
+    width?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    flex?: number;
+    cell?: CellComponent<T>;
+    cellProps?: Record<string, any> | ((value: any, row: T) => Record<string, any>);
+    render?: (value: any, row: T, context: CellContext) => ReactNode;
+    sortable?: boolean;
+    /**
+     * Whether this column can be reordered via drag-and-drop.
+     * Defaults to true. Set to false to lock a column in place (e.g., sticky first column).
+     */
+    reorderable?: boolean;
+    noCellPadding?: boolean;
+    mobile?: MobileConfig | false;
+    popover?: string | ((value: unknown, row: T) => ReactNode) | {
+        content: string | ((value: unknown, row: T) => ReactNode);
+        placement?: "top" | "bottom" | "left" | "right";
+        showArrow?: boolean;
+        trigger?: "hover" | "click";
+    };
+    /** Label to use for this column in CSV export headers. Falls back to `label` if not provided. */
+    exportLabel?: string;
+    /**
+     * Custom function to transform the cell value for export.
+     * If not provided, uses the raw accessor value converted to string.
+     * @param value - The raw cell value from the accessor
+     * @param row - The full row data
+     * @returns The value to export (will be converted to string)
+     */
+    exportValue?: (value: unknown, row: T) => string | number | boolean | null;
+    /**
+     * Whether to include this column in CSV exports.
+     * Defaults to true. Set to false to exclude columns like action buttons.
+     */
+    exportable?: boolean;
+}
+interface DataTableProps<T> {
+    columns: Column<T>[];
+    data: T[];
+    className?: string;
+    density?: TableDensity;
+    width?: TableWidth;
+    height?: string | number;
+    maxHeight?: string | number;
+    layout?: TableLayout;
+    mobileRenderer?: MobileRenderer;
+    customMobileRowRender?: (row: T, index: number) => ReactNode;
+    mobileBreakpoint?: MobileBreakpoint;
+    isLoading?: boolean;
+    loadingState?: LoadingState;
+    loadingRowCount?: number;
+    onLoadMore?: () => void | Promise<void>;
+    hasMore?: boolean;
+    enableVirtualization?: boolean;
+    estimatedRowHeight?: number;
+    loadingIndicator?: ReactNode;
+    stickyHeader?: boolean;
+    /** Make the first column sticky on horizontal scroll */
+    stickyFirstColumn?: boolean;
+    onRowClick?: (row: T) => void;
+    /**
+     * How to identify a row. Used for React keys and, when selection is on, as the
+     * key the selection set is expressed in. Defaults to `row.id` when the row has
+     * a string or finite-number one, and to the row's position otherwise —
+     * positional identity is a last resort, because a re-sort moves it.
+     */
+    getRowId?: (row: T) => string;
+    hideHeader?: boolean;
+    /**
+     * Selected row ids. **Controlled**: the table never mutates this and holds no
+     * selection state of its own.
+     *
+     * A table that owned its selection could not be driven by a bulk-action bar
+     * outside it, reset after the action completed, or restored when the user
+     * navigated back — and every consumer here is a host that already holds state.
+     *
+     * Ids the table cannot see are kept, not pruned: a user who selects three rows,
+     * paginates, and selects two more is acting on five, and dropping the first
+     * three would silently narrow a bulk action. The host owns showing the count.
+     */
+    selectedRowIds?: ReadonlySet<string>;
+    /**
+     * Called with the **full** next selection — never a delta, so a host can never
+     * accumulate a stale union.
+     *
+     * Absent means selection is off: no checkbox column, no selected-row
+     * background, and `CellContext.isSelected` stays `undefined`. Rendering is
+     * gated on this handler rather than on `selectionMode`, because a checkbox that
+     * reports to nobody is the state this model exists to remove.
+     */
+    onSelectionChange?: (next: ReadonlySet<string>) => void;
+    /**
+     * `"multi"` (the default) adds the page-scoped header checkbox; `"single"`
+     * replaces the selection on each pick and renders no header checkbox.
+     */
+    selectionMode?: "single" | "multi";
+    /** Controlled sort configuration - when provided, DataTable becomes controlled */
+    sortConfig?: SortConfig | null;
+    onSort?: (sortConfig: SortConfig | null) => void;
+    /**
+     * A caveat about the *currently sorted* column, for the case where the sort is
+     * real but has nothing to act on — every row on this page is empty in that
+     * column, so the order the table is showing carries no information.
+     *
+     * When set (and a sort is active), the sorted column's caret renders muted and
+     * the string is attached to the header as a `title` and an `sr-only` line.
+     * `aria-sort` is deliberately left alone: the column *is* sorted, and lying
+     * about that to assistive tech would be a worse bug than the one this fixes.
+     *
+     * Nothing about the data changes — no reorder, no dropped sort. This is a
+     * statement about the sort, not a replacement for it.
+     *
+     * A plain `string` rather than a `ReactNode`, and scoped to the sorted column
+     * rather than keyed by column id, because the only caller is the one that owns
+     * `sortConfig`: a general per-column header API was considered and rejected
+     * (see `TableHeaderCell.headerContent`).
+     */
+    sortNote?: string;
+    "aria-label"?: string;
+    /**
+     * Enable drag-and-drop column reordering (like Notion tables).
+     * When enabled, users can drag column headers to reorder columns.
+     */
+    enableColumnReorder?: boolean;
+    /**
+     * Controlled column order - array of column IDs in display order.
+     * When provided, DataTable uses this order instead of the columns array order.
+     * Use with onColumnOrderChange for controlled behavior.
+     */
+    columnOrder?: string[];
+    /**
+     * Callback fired when column order changes via drag-and-drop.
+     * Receives the new array of column IDs in their new order.
+     */
+    onColumnOrderChange?: (columnOrder: string[]) => void;
+}
+
 /**
  * Core types for the formatting system
  */
@@ -1085,6 +1336,120 @@ declare function getYFormatSettings(formatter?: YFormatType): YFormatSettings;
 declare const createXScale: (data: BaseDataPoint[], width: number) => _visx_vendor_d3_scale.ScaleTime<number, number, never>;
 declare const createYScale: (data: BaseDataPoint[], height: number, formatType: YFormatType, explicitDomain?: [number, number]) => _visx_vendor_d3_scale.ScaleLinear<number, number, never>;
 
+/**
+ * The category palette, kept apart from the cell that draws it.
+ *
+ * `CategoryCell` is a `"use client"` module, so a server component — or a Next.js app
+ * route, which resolves `@texturehq/edges` through the `react-server` condition and
+ * therefore against `dist/server.js` — cannot reach anything declared inside it. These
+ * two are plain data derived from `getDefaultColors()`: no JSX, no hooks, no client
+ * directive. Splitting them out is what lets `@texturehq/edges/server` re-export them,
+ * which is what the boards table-cell planner needs to assign colour slots on the
+ * server. The same split `deviceStateLabels` already has, for the same reason.
+ */
+/**
+ * The swatch for a value with no slot of its own.
+ *
+ * Twelve categorical slots exist; a rendering with more distinct values than that
+ * gives the overflow this one shared grey. Deliberately not a thirteenth colour and
+ * deliberately not slot 1 again: a recycled colour asserts that two unrelated values
+ * belong together, which is the exact failure a category swatch is supposed to
+ * prevent. Grey says "not one of the twelve", which is true.
+ */
+declare const CATEGORY_NEUTRAL_COLOR = "var(--color-text-subtle)";
+/**
+ * The categorical slots, as CSS custom-property references, in the palette's own
+ * order: `CATEGORY_COLOR_TOKENS[i]` names the variable `getThemeCategoricalColors()`
+ * reads at index `i`.
+ *
+ * This is the single source of truth for "slot i ↔ colour", and it exists so the
+ * caller that assigns slots (a table's column-level colour map) and the charts that
+ * read the palette cannot disagree. The length is taken from `getDefaultColors()`
+ * rather than written as `12`, so adding a thirteenth slot to the ramp extends this
+ * list instead of silently capping it — and the array is index-aligned with the
+ * variables by construction there.
+ *
+ * References, not resolved colours: the browser resolves them per theme, so one
+ * stored value is right in light and dark and a persisted board never freezes
+ * today's palette. No DOM is needed to build this, which is what lets a server
+ * render assign slots.
+ */
+declare const CATEGORY_COLOR_TOKENS: ReadonlyArray<string>;
+
+/**
+ * Where a percentage stops being unremarkable.
+ *
+ * Both bounds are **inclusive**: a value exactly at `critical` colours. Exclusive
+ * would leave the round number — the one a human configured — as the only
+ * uncoloured value on the scale, which is the opposite of useful.
+ *
+ * Both are optional and independent: a column may want only a critical line.
+ * `critical` wins when a value satisfies both.
+ *
+ * Deliberately *numbers*, not a level. What counts as low is a question about the
+ * device and its configuration — a battery told to hold a 30% reserve is in trouble
+ * at 28% and fine at 28% if its reserve is 5% — so the caller decides and this cell
+ * only compares. See the `thresholds` prop.
+ */
+interface PercentThresholds {
+    /** Warn at or below this value. */
+    low?: number;
+    /** Alarm at or below this value. Takes precedence over `low`. */
+    critical?: number;
+}
+/** The level a value falls into, or `undefined` when it is unremarkable. */
+type PercentThresholdLevel = "low" | "critical";
+/**
+ * Classify a percentage against its thresholds.
+ *
+ * Exported because three callers need the same answer and must not each derive it:
+ * this cell (to colour the fill), its serializable twin (to keep the label and the
+ * marker consistent with it), and the tests.
+ */
+declare function percentThresholdLevel(percentage: number, thresholds: PercentThresholds | undefined): PercentThresholdLevel | undefined;
+interface PercentBarCellProps extends CellComponentProps {
+    value: number;
+    showLabel?: boolean;
+    color?: string | "auto";
+    backgroundColor?: string | "none";
+    height?: number;
+    segments?: number;
+    segmentGap?: number;
+    colorScale?: {
+        type: "sequential" | "diverging";
+        scheme?: string;
+        center?: number;
+    };
+    /**
+     * Recolours the **fill** when the value is at or below a bound.
+     *
+     * The design inventory's `MeterCell` asks for a "threshold recolor below 20%"; the
+     * number is the caller's because 20% is not universally low. Absent — the default —
+     * renders exactly what this cell rendered before thresholds existed.
+     *
+     * Three things it deliberately does not do:
+     *
+     * - **The track never recolours.** The track is the scale, and a scale that changes
+     *   colour with the reading is no longer a scale.
+     * - **It does not replace the label.** Colour is the scan and the number is the
+     *   answer; colour is never the only signal, which is also the accessibility floor.
+     * - **It does not clamp or convert.** The comparison runs on the same 0–100 value
+     *   the bar draws.
+     *
+     * Wins over `color` and `colorScale`: a threshold is a statement about this
+     * reading, and a gradient is a restatement of the value the bar already shows.
+     */
+    thresholds?: PercentThresholds;
+}
+/**
+ * PercentBarCell
+ *
+ * Horizontal bar showing percentage (0-100%).
+ * Perfect for battery charge, progress indicators, and utilization metrics.
+ * Supports segmented "LED meter" style with optional gradient coloring.
+ */
+declare const PercentBarCell: React__default.NamedExoticComponent<PercentBarCellProps>;
+
 declare const variantSizeMap: {
     readonly heading: {
         readonly sm: "text-heading-sm";
@@ -4366,4 +4731,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
  */
 declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
 
-export { defaultMargin as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, type ChartMargin as C, type DeviceState as D, ENTITY_CONFIG as E, type SideNavItem as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SideNavProps as J, type StaticMapProps as K, Loader as L, type MapPoint as M, type TooltipData as N, type TooltipSeries as O, TopNav as P, type TopNavProps as Q, type YFormatType as R, type SegmentOption as S, TextLink as T, activeDeviceStates as U, archetypeFor as V, clearColorCache as W, createCategoryColorMap as X, type YFormatSettings as Y, createXScale as Z, createYScale as _, type ActionItem as a, type EntityCategoryConfig as a$, deviceStateLabels as a0, deviceStateMetricFormats as a1, entityHasDetailPage as a2, entityHasStatList as a3, entityShowsNow as a4, getContrastingTextColor as a5, getDefaultChartColor as a6, getDefaultColors as a7, getDeviceStateLabel as a8, getEntityConfig as a9, type TemperatureUnitString as aA, type TemperatureUnit as aB, type TextFormat as aC, type VoltageFormat as aD, type ComponentFormatter as aE, type LayerSpec as aF, type CustomPinsSpec as aG, type GeoJsonLayerSpec as aH, type RasterLayerSpec as aI, type VectorLayerSpec as aJ, type ClusteredVectorLayerSpec as aK, type ColorSpec as aL, ActionMenu as aM, AppShell as aN, Avatar as aO, Badge as aP, type BaseFormat as aQ, ChartContext as aR, CodeEditor as aS, type ComponentFormatOptions as aT, type CurrentUnit as aU, type CustomFormat as aV, DEFAULT_MAP_TYPE as aW, type DateFormatStyle as aX, type DistanceUnit as aY, ENTITY_CATEGORY_CONFIG as aZ, type EntityCategory as a_, getEntityIcon as aa, getEntityLabel as ab, getEntityStatList as ac, getGridStateLabel as ad, getResolvedColor as ae, getThemeCategoricalColors as af, getYFormatSettings as ag, gridStateLabels as ah, isActiveState as ai, isLightColor as aj, type FieldValue as ak, type BooleanFormat as al, type FormattedValue as am, type FieldFormat as an, type CurrentFormat as ao, type DateFormat as ap, type DistanceFormat as aq, type EnergyUnit as ar, type EnergyFormat as as, type CurrencyFormat as at, type NumberFormat as au, type PhoneFormat as av, type PowerFormat as aw, type FormatterFunction as ax, type ResistanceFormat as ay, type TemperatureFormat as az, type ActionMenuProps as b, GRID_STATE_COLORS as b0, type GridStateColor as b1, InteractiveMap as b2, type InteractiveMapHandle as b3, type LayerCheckState as b4, type LayerFeature as b5, type LayerSelection as b6, type LayerStyle as b7, type LayerTreeNode as b8, type LayerVisibilityPatch as b9, useChartContext as bA, useComponentFormatter as bB, MAP_TYPES as ba, type MapType as bb, Meter as bc, type PercentageFormat as bd, type PowerUnit as be, type RenderType as bf, type ResistanceUnit as bg, SegmentedControl as bh, StackNav as bi, type StackNavGroup as bj, type StackNavItem as bk, type StackNavLinkComponentProps as bl, type StackNavProps as bm, type StackNavRenderRow as bn, type StackNavRowRenderProps as bo, type StackNavTheme as bp, StaticMap as bq, type TextTransform as br, type TextTruncatePosition as bs, UNVERIFIED_VOLTAGE_UNIT_ROWS as bt, type VoltageUnit as bu, type ZoomStops as bv, baselineFromPoint as bw, formatComponentValue as bx, getEntityCategory as by, mapValuesToCategoricalColors as bz, type AppShellProps as c, type AvatarProps as d, type BaseDataPoint as e, type CodeEditorProps as f, type CodeLanguage as g, type CodeTheme as h, type EntityArchetype as i, type EntityConfig as j, type EntityStateRule as k, type EntityType as l, GRID_STAT_LIST as m, type GridElementSourceType as n, type GridStatField as o, type GridStatFieldFormat as p, type GridState as q, Heading as r, type HeadlineMetric as s, Logo as t, type MeterProps as u, type MetricFormat as v, type MetricSource as w, type SegmentedControlProps as x, type SerializableFieldFormat as y, SideNav as z };
+export { clearColorCache as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, CATEGORY_COLOR_TOKENS as C, type DeviceState as D, ENTITY_CONFIG as E, type SegmentedControlProps as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SerializableFieldFormat as J, SideNav as K, Loader as L, type MapPoint as M, type SideNavItem as N, type SideNavProps as O, type PercentThresholdLevel as P, type StaticMapProps as Q, type TooltipData as R, type SegmentOption as S, TextLink as T, type TooltipSeries as U, TopNav as V, type TopNavProps as W, type YFormatType as X, type YFormatSettings as Y, activeDeviceStates as Z, archetypeFor as _, type ActionItem as a, type BaseFormat as a$, createCategoryColorMap as a0, createXScale as a1, createYScale as a2, defaultMargin as a3, deviceStateLabels as a4, deviceStateMetricFormats as a5, entityHasDetailPage as a6, entityHasStatList as a7, entityShowsNow as a8, getContrastingTextColor as a9, type CurrencyFormat as aA, type NumberFormat as aB, type PhoneFormat as aC, type PowerFormat as aD, type FormatterFunction as aE, type ResistanceFormat as aF, type TemperatureFormat as aG, type TemperatureUnitString as aH, type TemperatureUnit as aI, type TextFormat as aJ, type VoltageFormat as aK, type CellComponentProps as aL, type CellAlignment as aM, type LinkBehavior as aN, type ComponentFormatter as aO, type DataTableProps as aP, type LayerSpec as aQ, type CustomPinsSpec as aR, type GeoJsonLayerSpec as aS, type RasterLayerSpec as aT, type VectorLayerSpec as aU, type ClusteredVectorLayerSpec as aV, type ColorSpec as aW, ActionMenu as aX, AppShell as aY, Avatar as aZ, Badge as a_, getDefaultChartColor as aa, getDefaultColors as ab, getDeviceStateLabel as ac, getEntityConfig as ad, getEntityIcon as ae, getEntityLabel as af, getEntityStatList as ag, getGridStateLabel as ah, getResolvedColor as ai, getThemeCategoricalColors as aj, getYFormatSettings as ak, gridStateLabels as al, isActiveState as am, isLightColor as an, type LoadingState as ao, type Column as ap, type CellEmphasis as aq, type FieldValue as ar, type BooleanFormat as as, type FormattedValue as at, type FieldFormat as au, type CurrentFormat as av, type DateFormat as aw, type DistanceFormat as ax, type EnergyUnit as ay, type EnergyFormat as az, type ActionMenuProps as b, useComponentFormatter as b$, type CellComponent as b0, type CellContext as b1, ChartContext as b2, CodeEditor as b3, type ComponentFormatOptions as b4, type CurrentUnit as b5, type CustomFormat as b6, DEFAULT_MAP_TYPE as b7, type DateFormatStyle as b8, type DistanceUnit as b9, type SortConfig as bA, type SortDirection as bB, StackNav as bC, type StackNavGroup as bD, type StackNavItem as bE, type StackNavLinkComponentProps as bF, type StackNavProps as bG, type StackNavRenderRow as bH, type StackNavRowRenderProps as bI, type StackNavTheme as bJ, StaticMap as bK, type TableDensity as bL, type TableLayout as bM, type TableWidth as bN, type TextTransform as bO, type TextTruncatePosition as bP, UNVERIFIED_VOLTAGE_UNIT_ROWS as bQ, type UseInfiniteScrollOptions as bR, type UseInfiniteScrollReturn as bS, type VoltageUnit as bT, type ZoomStops as bU, baselineFromPoint as bV, formatComponentValue as bW, getEntityCategory as bX, mapValuesToCategoricalColors as bY, percentThresholdLevel as bZ, useChartContext as b_, ENTITY_CATEGORY_CONFIG as ba, type EntityCategory as bb, type EntityCategoryConfig as bc, GRID_STATE_COLORS as bd, type GridStateColor as be, InteractiveMap as bf, type InteractiveMapHandle as bg, type LayerCheckState as bh, type LayerFeature as bi, type LayerSelection as bj, type LayerStyle as bk, type LayerTreeNode as bl, type LayerVisibilityPatch as bm, MAP_TYPES as bn, type MapType as bo, Meter as bp, type MobileBreakpoint as bq, type MobileConfig as br, type MobileRenderer as bs, PercentBarCell as bt, type PercentBarCellProps as bu, type PercentageFormat as bv, type PowerUnit as bw, type RenderType as bx, type ResistanceUnit as by, SegmentedControl as bz, type AppShellProps as c, useInfiniteScroll as c0, type AvatarProps as d, type BaseDataPoint as e, CATEGORY_NEUTRAL_COLOR as f, type ChartMargin as g, type CodeEditorProps as h, type CodeLanguage as i, type CodeTheme as j, type EntityArchetype as k, type EntityConfig as l, type EntityStateRule as m, type EntityType as n, GRID_STAT_LIST as o, type GridElementSourceType as p, type GridStatField as q, type GridStatFieldFormat as r, type GridState as s, Heading as t, type HeadlineMetric as u, Logo as v, type MeterProps as w, type MetricFormat as x, type MetricSource as y, type PercentThresholds as z };