@assure-one/design-system 1.38.0 → 1.40.0

package/dist/data-table-view-ep8al7P9.d.ts

@@ -0,0 +1,1132 @@
+import * as React$1 from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './vocab-DornLJbW.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { T as TableMessages } from './types-Coqw8iaS.js';
+import { a as BrandTheme } from './brand-theme-ZYM867Jz.js';
+
+/**
+ * `Code` parts, stamped as `data-slot="code[-<part>]"` (ADR-008). Inline, the
+ * root is the `<code>`; as a block, the root is the `<pre>` and `content` the
+ * `<code>` inside it. State on the root: `data-variant`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type CodeSlot = "root" | "content";
+/**
+ * `Kbd` part, stamped as `data-slot="kbd"` (ADR-008). State on the root:
+ * `data-variant`. `KbdHint` and `CommandPalette` render it.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type KbdSlot = "root";
+/**
+ * `Pressable` has one part, its root, stamped as `data-slot="pressable"`
+ * (ADR-008): the element that carries the button behaviour, whether that is
+ * the `<button>` it renders or the child it wraps with `asChild`. State on the
+ * root: `data-disabled`, `data-pressed`. Components that compose it (`Button`
+ * once it adopts the behaviour, a clickable `Surface`) declare their own parts.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-03).
+ */
+type PressableSlot = "root";
+/**
+ * `Button` parts, stamped as `data-slot="button[-<part>]"` (ADR-008).
+ * States on the root: `data-variant`, `data-size`, `data-disabled`, and the
+ * pre-existing `data-loading="true"`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type ButtonSlot = "root" | "icon-start" | "icon-end" | "spinner";
+/**
+ * `LinkButton` parts, stamped as `data-slot="link-button[-<part>]"` (ADR-008).
+ * States on the root: `data-variant`, `data-size`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type LinkButtonSlot = "root" | "icon-start" | "icon-end";
+/**
+ * `Badge` parts, stamped as `data-slot="badge[-<part>]"` (ADR-008).
+ * States on the root: `data-variant`, `data-size`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type BadgeSlot = "root" | "dot" | "icon";
+/**
+ * `Input` parts, stamped as `data-slot="input[-<part>]"` (ADR-008).
+ * `root` is the `<input>` itself — the control frame, and the element
+ * `className` lands on (`C-INPUT-CLASSNAME`). The wrappers around it are
+ * private (target architecture §29.2).
+ * States on the root: `data-variant`, `data-size`, `data-disabled`,
+ * `data-invalid`. `description` is the `description` sugar's hint text (W4-05).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type InputSlot = "root" | "label" | "icon-start" | "icon-end" | "password-toggle" | "description" | "error";
+/**
+ * `Textarea` parts, stamped as `data-slot="textarea[-<part>]"` (ADR-008).
+ * `root` is the `<textarea>`. States on the root: `data-variant`, `data-size`,
+ * `data-disabled`, `data-invalid`. `description` is the `description` sugar's
+ * hint text (W4-06).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type TextareaSlot = "root" | "label" | "description" | "error" | "count";
+/**
+ * `SearchInput` parts, stamped as `data-slot="search-input[-<part>]"`
+ * (ADR-008). `root` is the positioning wrapper `className` lands on;
+ * `control` is the `<input type="search">`.
+ * States on the root: `data-size`, `data-disabled`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SearchInputSlot = "root" | "control" | "icon" | "clear";
+/**
+ * `Select` parts, stamped as `data-slot="select-<part>"` (ADR-008).
+ * `SelectRoot` renders no element: `root` is the wrapper the options-driven
+ * `Select clearable` renders around the trigger and the `clear` button (W4-08),
+ * and exists only then. Radix's own `data-state`, `data-disabled`,
+ * `data-placeholder` and `data-highlighted` are left as they are
+ * (`P-DATA-STATE`); the trigger adds `data-size` when a `size` is set.
+ *
+ * `SelectValue` and `SelectGroup` are re-exported Radix components with no
+ * wrapper of ours, so they carry no slot of their own. `value` is the span
+ * the options-driven `Select` wraps Radix's value in when `classNames.value`
+ * or `clearable` asks for it (Radix's own span drops `className`); a legacy
+ * call renders no wrapper, so the `SelectTrigger > span` structure PRO selects
+ * on stays as frozen by `C-DOM-10`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SelectSlot = "root" | "trigger" | "value" | "icon" | "clear" | "content" | "viewport" | "item" | "item-indicator" | "label" | "separator" | "scroll-up-button" | "scroll-down-button";
+/**
+ * `Checkbox` parts, stamped as `data-slot="checkbox[-<part>]"` (ADR-008).
+ * `root` is the Radix root — the box, and the element `className` lands on.
+ * Radix's `data-state` (`checked` / `unchecked` / `indeterminate`) is left as
+ * it is; `data-shape` is not part of the state vocabulary, so the shape stays
+ * a class until W4-13.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type CheckboxSlot = "root" | "indicator" | "label";
+/**
+ * `RadioGroup` / `RadioGroupItem` parts, stamped as
+ * `data-slot="radio-group[-<part>]"` (ADR-008). `root` is the group,
+ * `item` the radio. Radix's `data-state` is left as it is. With
+ * `appearance="card"` (W4-14) the root carries `data-appearance="card"` and
+ * every item is wrapped in a `card` holding the `label` (stretched over the
+ * card, so the whole box is the click target) and an optional `description`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type RadioGroupSlot = "root" | "item" | "indicator" | "label" | "card" | "description";
+/**
+ * `Switch` parts, stamped as `data-slot="switch[-<part>]"` (ADR-008).
+ * `root` is the Radix root — the track, and the element `className` lands on;
+ * the label wrapper is a private wrapper. States on the root: `data-size`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SwitchSlot = "root" | "thumb" | "label";
+/**
+ * `Label` parts, stamped as `data-slot="label[-<part>]"` (ADR-008).
+ * `required` is the asterisk marker.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type LabelSlot = "root" | "required";
+/**
+ * `NumberInput` parts, stamped as `data-slot="number-input"` (ADR-008).
+ * `root` is the `<input>` itself — the control frame and the element
+ * `className` lands on, like `Input`. The hidden inputs `FormBridge` renders
+ * next to it are not parts. States on the root: `data-variant`, `data-size`,
+ * `data-disabled`, `data-invalid`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-21).
+ */
+type NumberInputSlot = "root";
+/**
+ * `PhoneField` parts, stamped as `data-slot="phone-field[-<part>]"` (ADR-008).
+ * `root` is the row (the element `className` lands on), `number` the `tel`
+ * `<input>` on the control chrome, `flag` a `CountryFlag` (the SVG, or its
+ * placeholder while the flag set loads). `country` is the country picker: a
+ * `Combobox`, stamped with its own anatomy and styled through
+ * `classNames.country`. States on the root: `data-variant`, `data-size`,
+ * `data-disabled`, `data-invalid`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-22).
+ */
+type PhoneFieldSlot = "root" | "country" | "number" | "flag";
+/**
+ * `FileUpload` parts, stamped as `data-slot="file-upload[-<part>]"` (ADR-008).
+ * `dropzone` is the `<label>` that `C-DOM-04` freezes and that
+ * `[&_[data-slot=file-upload-dropzone]]` replaces (target architecture §29.4).
+ * States: `data-disabled` and `data-invalid` on the root, `data-disabled` and
+ * `data-state="drag-over"` on the dropzone.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type FileUploadSlot = "root" | "dropzone" | "input" | "error";
+/**
+ * `Command` / `CommandPalette` parts, stamped as `data-slot="command-<part>"`
+ * (ADR-008, W5-19). `overlay`, `content`, `title` and `description` are the
+ * spotlight modal (`CommandDialog`); `root`, `input`, `list`, `empty`,
+ * `group` and `item` are the command-list parts; `footer` is the
+ * keyboard-hint strip `CommandPalette` renders below the list.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type CommandSlot = "overlay" | "content" | "title" | "description" | "root" | "input" | "list" | "empty" | "group" | "item" | "footer";
+/**
+ * `Dialog` parts, stamped as `data-slot="dialog-<part>"` (ADR-008). There is
+ * no `root`: `Dialog` is Radix's non-rendering root. `close` is stamped on
+ * both the built-in close button and `DialogClose`; they are the same part —
+ * a control that dismisses the dialog. `body` is the scroll region between
+ * header and footer (W5-05). States: `data-size` on the content, and
+ * `data-variant="responsive"` when it presents as a bottom sheet below `sm`
+ * (W5-09). Radix's `data-state` is left as it is (`P-DATA-STATE`).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
+/**
+ * `AlertDialog` parts, stamped as `data-slot="alert-dialog-<part>"`
+ * (ADR-008). No `root` — Radix's root renders no element.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type AlertDialogSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "action" | "cancel";
+/**
+ * `Sheet` parts, stamped as `data-slot="sheet-<part>"` (ADR-008).
+ * `body` is the scroll region between header and footer (W5-07). States:
+ * `data-size` on the content, carrying the `size` step (or the deprecated
+ * `width` preset, C-SHEET-WIDTH; `default` when neither is given). The
+ * `side` is not in the §29.2 vocabulary and stays a class.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SheetSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
+/**
+ * `SideDrawer` parts, stamped as `data-slot="side-drawer[-<part>]"`
+ * (ADR-008). `root` is the panel. The screen-reader-only Radix title that the
+ * panel always renders is an accessibility fallback, not a part, so it carries
+ * no slot. States: `data-size` on the root, carrying the `width` preset.
+ *
+ * `SideDrawer` itself is `C-SIDEDRAWER` and is replaced by `Sheet` in W5-08;
+ * the slots exist so the two can be styled the same way in the meantime.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SideDrawerSlot = "overlay" | "root" | "header" | "heading" | "subtitle" | "close" | "body" | "footer";
+/**
+ * `Popover` parts, stamped as `data-slot="popover-content"` (ADR-008).
+ * `Popover`, `PopoverTrigger`, `PopoverAnchor` and `PopoverClose` are bare
+ * Radix re-exports, so the content is the only part we render.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type PopoverSlot = "content";
+/**
+ * `DropdownMenu` parts, stamped as `data-slot="dropdown-menu-<part>"`
+ * (ADR-008). No `root`, no `trigger`: both are bare Radix re-exports.
+ * `destructive` items get no `data-intent` yet — W3-02 defines the intent
+ * values, and this task does not invent them.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type DropdownMenuSlot = "content" | "item" | "checkbox-item" | "radio-item" | "item-indicator" | "label" | "separator" | "shortcut" | "sub-trigger" | "sub-content";
+/**
+ * `ContextMenu` parts, stamped as `data-slot="context-menu-<part>"`
+ * (ADR-008). The same part names as `DropdownMenu`, which is what makes the
+ * shared `Menu` internals of W5 a rename-free change for consumers.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type ContextMenuSlot = "content" | "item" | "checkbox-item" | "radio-item" | "item-indicator" | "label" | "separator" | "shortcut" | "sub-trigger" | "sub-content";
+/**
+ * `Tooltip` parts, stamped as `data-slot="tooltip-content"` (ADR-008).
+ * `TooltipTrigger` is a bare Radix re-export.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type TooltipSlot = "content";
+/**
+ * `Toast` parts, stamped as `data-slot="toast[-<part>]"` (ADR-008).
+ * `region` is the live region; `data-slot="toast-region"` is how consumers
+ * locate it (W5-15). Its `aria-label` is not a locator contract since 2.0
+ * (C-TOAST-ARIALABEL). States: `data-variant` on the root; its
+ * `data-state` (`open` / `closed`) already existed.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type ToastSlot = "region" | "root" | "icon" | "title" | "description" | "action" | "close";
+/**
+ * `Table` parts, stamped as `data-slot="table[-<part>]"` (ADR-008).
+ * `root` is the `<table>` — the element `className` lands on; `wrapper` is the
+ * overflow container that `wrapperClassName` styles today and
+ * `classNames.wrapper` replaces (`C-CLASSNAME-PROPS`). `header` is `<thead>`
+ * and `head` is a `<th>`, matching the `TableHeader` / `TableHead` component
+ * names. Native table semantics are permanent (`P-NATIVE-TABLE`). `sort` is
+ * the `<button>` a sortable `TableHead` renders around its label and
+ * `sort-indicator` the chevron inside it (W6-01).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type TableSlot = "root" | "wrapper" | "header" | "body" | "footer" | "row" | "head" | "cell" | "caption" | "sort" | "sort-indicator";
+/**
+ * `DataTable*` parts, stamped as `data-slot="data-table[-<part>]"` (ADR-008).
+ * These are `C-DT-PARTS`, the parallel copy of `Table*` that W6-03 folds back
+ * in; the part names deliberately match `table`'s so that fold is a no-op for
+ * a consumer's selectors (`header` = `<thead>` via `DataTableHead`, `head` =
+ * the `<th>` via `DataTableHeader`).
+ *
+ * `head-button` is the sortable header's `<button>` that `C-DOM-13` freezes.
+ * The four cell components share one `cell` part and are told apart by
+ * `data-variant` (`name`, `mono`, `id`, `due`).
+ *
+ * `DataTableSearch` and `DataTablePagination` render an `Input` and a
+ * `Pagination` with no wrapper of their own, so they carry those components'
+ * slots (`data-slot="input"`, `data-slot="pagination"`) rather than one of
+ * their own — stamping over it would delete the inner component's part name.
+ * W6-06 gives the search its own `classNames.search` (`C-DOM-18`).
+ *
+ * The compound `DataTablePattern` (W6-06, `src/patterns/data/data-table.tsx`)
+ * renders in the same namespace and adds its slots: `search`, `filters`,
+ * `columns-menu`, `content` (the table's overflow wrapper), `bulk-actions`
+ * and `pagination`. It is the same component family, so a consumer's
+ * `[data-slot^="data-table"]` selectors keep meaning what they meant.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type DataTableSlot = "root" | "toolbar" | "spacer" | "results-count" | "header" | "body" | "row" | "head" | "head-button" | "head-indicator" | "cell" | "checkbox-cell" | "search" | "filters" | "columns-menu" | "content" | "bulk-actions" | "pagination";
+/**
+ * `Pagination` parts, stamped as `data-slot="pagination[-<part>]"` (ADR-008).
+ * `root` is the `<nav>`. The current page carries `data-selected` alongside
+ * its existing `aria-current="page"`. `page-size` wraps the optional
+ * rows-per-page `Select` (W6-09).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type PaginationSlot = "root" | "label" | "page-size" | "pages" | "previous" | "next" | "page" | "ellipsis";
+/**
+ * `Shell` / `Main` / `Content` parts, stamped as `data-slot="shell[-<part>]"`
+ * (ADR-008). Three elements, three names: the app frame, the column beside the
+ * sidebar and the scrolling page region.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type ShellSlot = "root" | "main" | "content";
+/**
+ * `Sidebar` and its parts, stamped as `data-slot="sidebar[-<part>]"`
+ * (ADR-008). This is the anatomy `C-DOM-06` is waiting for: PRO and TAX carry
+ * identical copies of `group-data-[labels=hide]/sidebar:*` and
+ * `[&>div:first-child]` overrides because there is no name for
+ * `section-header`, `link-label` or `user` today.
+ *
+ * `group/sidebar`, `data-labels`, `data-state`, `data-peek`, `data-overlay`,
+ * `data-collapsible` and `data-variant` on the root are **unchanged** — they
+ * are the frozen part of `C-DOM-06`, and no state attribute is re-stamped over
+ * them. W7-03 adds `data-collapsed` to the slots and the `SidebarSection`
+ * header slot; this change only names the parts.
+ *
+ * `group` is a `SidebarLinkGroup`: `group-link` is its activating row,
+ * `group-trigger` its chevron and `group-content` the collapsible body.
+ * The `tone` props on `SidebarSection` and `SidebarLinkBadge` get no
+ * `data-intent`: they are `C-TONE`, and W3-21 defines the intent values.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SidebarSlot = "root" | "trigger" | "pin" | "brand" | "brand-text" | "section" | "section-header" | "section-label" | "link" | "link-label" | "link-action" | "link-badge" | "group" | "group-link" | "group-trigger" | "group-content" | "footer" | "user" | "user-name" | "user-subtitle";
+/**
+ * `SidebarBrandSwitcher` parts, stamped as
+ * `data-slot="sidebar-brand-switcher[-<part>]"` (ADR-008). Its menu is a
+ * `DropdownMenuContent` and keeps that component's slots; its `trailing`
+ * children are rendered bare, with no wrapper of ours to name (W7-03 gives
+ * them one).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type SidebarBrandSwitcherSlot = "root" | "trigger" | "icon";
+/**
+ * `Text` parts, stamped as `data-slot="text"` (ADR-008). One part: the
+ * element that carries the role, and the element `className` lands on (with
+ * `asChild`, the child the caller supplied).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-12).
+ */
+type TextSlot = "root";
+/**
+ * `Heading` parts, stamped as `data-slot="heading"` (ADR-008). One part: the
+ * `<h1>`…`<h6>` itself, which is the element `className` lands on.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-13).
+ */
+type HeadingSlot = "root";
+/**
+ * `Stack` has one part, its root, stamped as `data-slot="stack"` (ADR-008).
+ * No state attributes: a responsive `direction` has no single value to
+ * stamp, and the primitive's job is spacing, not state.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-15).
+ */
+type StackSlot = "root";
+/**
+ * `Inline` has one part, its root, stamped as `data-slot="inline"` (ADR-008).
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-15).
+ */
+type InlineSlot = "root";
+/**
+ * `Surface` has one part, its root, stamped as `data-slot="surface"`
+ * (ADR-008). Composites built on it (Card, W3-17) declare their own parts.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-16).
+ */
+type SurfaceSlot = "root";
+/**
+ * `Avatar` parts, stamped as `data-slot="avatar[-<part>]"` (ADR-008, W3-16).
+ * `root` is the outer positioning wrapper — the element a consumer's
+ * `shrink-0` / `mt-0.5` overrides are aimed at and `classNames.root` reaches;
+ * `frame` is the circle (the Radix root: image and fallback clip to it), and
+ * the element `className` and `ref` keep landing on behind the compatibility
+ * entry (target architecture §29.1, ADR-008 decision 6 — the landing does not
+ * move silently). `image` and `fallback` are the Radix image and fallback;
+ * `status` is the corner dot, rendered only when `status` is set.
+ * States on the root: `data-size`, `data-variant`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-16).
+ */
+type AvatarSlot = "root" | "frame" | "image" | "fallback" | "status";
+/**
+ * `Card` parts, stamped as `data-slot="card[-<part>]"` (ADR-008, W3-17). The
+ * root is a `Surface` (W2-16) that stamps `card` over `surface`: a composite
+ * declares its own parts. Each part is a real JSX component (`CardHeader`,
+ * `CardTitle`, …) and takes `className` itself, so `Card` has no `classNames`
+ * (ADR-008 decision 4). States on the root: `data-variant`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-17).
+ */
+type CardSlot = "root" | "header" | "title" | "description" | "action" | "content" | "footer";
+/**
+ * `StatusBadge` parts, stamped as `data-slot="status-badge[-<part>]"`
+ * (ADR-008): the root, the `indicator` (dot, icon or spinner — one at a time)
+ * and the `label`. States on the root: `data-variant`, `data-intent`,
+ * `data-size`, `data-loading`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-14).
+ */
+type StatusBadgeSlot = "root" | "indicator" | "label";
+/**
+ * `IconButton` parts, stamped as `data-slot="icon-button[-<part>]"` (ADR-008):
+ * the square root, the `icon` box and the `spinner` that replaces it while
+ * loading. States on the root: `data-variant`, `data-intent`, `data-size`,
+ * `data-disabled`, `data-loading`, `data-pressed`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-09).
+ */
+type IconButtonSlot = "root" | "icon" | "spinner";
+/**
+ * `Chip` parts, stamped as `data-slot="chip[-<part>]"` (ADR-008): the root
+ * (the pressable itself, or the group that holds a pressable label and the
+ * `remove` button), the leading `icon`, the `label`, the `count` and the
+ * `remove` button. States on the root: `data-variant`, `data-intent`,
+ * `data-size`, `data-disabled`, `data-pressed`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-15).
+ */
+type ChipSlot = "root" | "icon" | "label" | "count" | "remove";
+/**
+ * `Field` parts, stamped as `data-slot="field[-<part>]"` (ADR-008, W4-01):
+ * the root (the layout wrapper, no chrome), the `label` (a `Label` rendered
+ * inside a field stamps this over its own `label`, the way `Card` stamps
+ * `card` over `surface`), its `required` asterisk and `optional` indicator,
+ * the `description` and the `error`. The control is not a part: it keeps its
+ * own anatomy (`input`, `select-trigger`, …) and is found by the field's id.
+ * States on the root: `data-orientation`, `data-invalid`, `data-disabled`,
+ * `data-required`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-01).
+ */
+type FieldSlot = "root" | "label" | "required" | "optional" | "description" | "error";
+/**
+ * `Fieldset` parts, stamped as `data-slot="fieldset[-<part>]"` (ADR-008,
+ * W4-01): the `<fieldset>` root and its `<legend>`. States on the root:
+ * `data-disabled`, `data-invalid`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-01).
+ */
+type FieldsetSlot = "root" | "legend";
+/**
+ * `Combobox` parts, stamped as `data-slot="combobox[-<part>]"` (ADR-008,
+ * W4-10): the `root` (the frame that holds the control and its form bridge),
+ * the `control` (the field-shaped box the popover anchors to), the `value`
+ * (a custom `renderValue` node over the input), the `chips` row and its
+ * `Chip`s in `multiple` mode, the `input` (the `role="combobox"` element that
+ * keeps focus), the leading `icon`, the `clear` and `toggle` buttons; then
+ * the portalled `content` with an optional `header`, the `list`
+ * (`role="listbox"`), a `group` with its `group-heading`, each `item`
+ * (`role="option"`, see `behavior/collection/item-attributes.ts`) and its
+ * `item-indicator`, the `create` row, the `empty` and `loading` states and an
+ * optional `footer`. States on the root: `data-state` (`open` · `closed`),
+ * `data-disabled`, `data-invalid`, `data-size`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-10).
+ */
+type ComboboxSlot = "root" | "control" | "value" | "chips" | "input" | "icon" | "clear" | "toggle" | "content" | "header" | "list" | "group" | "group-heading" | "item" | "item-indicator" | "create" | "empty" | "loading" | "footer";
+
+/** The emphasis subset a badge offers. @experimental */
+type BadgeVariant = Extract<Variant, "solid" | "soft" | "outline">;
+/** The badge's own size scale, spelled with the shared names (§17). @experimental */
+type BadgeSize = Extract<ControlSize, "xs" | "sm" | "md">;
+/** Corner treatment; omitted keeps today's corner (D1). @experimental */
+type BadgeShape = Extract<Shape, "rounded" | "pill">;
+/**
+ * The one-axis words Badge accepted before W3-13. Each resolves to a
+ * `{ variant, intent }` pair through `resolveBadgeAppearance` and renders the
+ * same classes it always did.
+ *
+ * @deprecated Use `variant` (`solid | soft | outline`) with `intent` instead:
+ * `default` → `solid` + `brand`, `secondary` → `soft` + `neutral`,
+ * `destructive` → `soft` + `danger`, `success | warning | info` → `soft` +
+ * the same word. `outline` is already an emphasis and is not deprecated.
+ */
+type BadgeLegacyVariant = "default" | "secondary" | "destructive" | "success" | "warning" | "info";
+/** A resolved `{ variant, intent }` pair. @experimental */
+interface BadgeAppearance {
+    variant: BadgeVariant;
+    intent: Intent;
+}
+/** What a badge can be asked for: the two axes, either one, or a legacy word. @experimental */
+interface BadgeAppearanceInput {
+    variant?: BadgeVariant | BadgeLegacyVariant | null | undefined;
+    intent?: Intent | null | undefined;
+}
+/**
+ * Resolves what a consumer asked for into the pair the class table is keyed by.
+ *
+ * - both axes: taken as given (a legacy `variant` word with an explicit
+ *   `intent` keeps the word's emphasis and takes the intent);
+ * - `variant` only: the per-variant default intent, or the legacy pair;
+ * - `intent` only: the per-intent default variant;
+ * - nothing: `solid` + `brand`, today's default.
+ *
+ * @experimental
+ */
+declare function resolveBadgeAppearance({ variant, intent, }?: BadgeAppearanceInput): BadgeAppearance;
+/** The inputs `badgeVariants` accepts (the legacy `variant` words included). @experimental */
+interface BadgeVariantsProps extends BadgeAppearanceInput {
+    size?: BadgeSize | null | undefined;
+    shape?: BadgeShape | null | undefined;
+    class?: string | null | undefined;
+    className?: string | null | undefined;
+}
+/**
+ * The badge's class string, for consumers that style their own element.
+ * Same call shape as before W3-13 (`variant`, `size`, `class`/`className`),
+ * plus `intent` and `shape`; a legacy `variant` word yields the string it
+ * always did.
+ */
+declare function badgeVariants({ variant, intent, size, shape, class: classValue, className, }?: BadgeVariantsProps): string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /**
+     * Visual emphasis: `solid` (filled), `soft` (tinted, the status look) or
+     * `outline`. Omitted, it follows `intent` (brand is solid, the rest soft);
+     * with neither prop the badge is `solid` + `brand`, as it always was.
+     * The legacy one-axis words are accepted and deprecated (`BadgeLegacyVariant`).
+     */
+    variant?: BadgeVariant | BadgeLegacyVariant | undefined;
+    /**
+     * Semantic meaning → colour family. Omitted, it follows `variant`
+     * (`solid` is brand, `soft` and `outline` are neutral).
+     * @experimental
+     */
+    intent?: Intent;
+    /** `xs` (10px text, W3-13), `sm` (default) or `md`. */
+    size?: BadgeSize;
+    /**
+     * Corner treatment. Omitted keeps today's corner (`--radius-pill`);
+     * `rounded` is the `radius.badge` role, `pill` is `radius.full` (D1).
+     * @experimental
+     */
+    shape?: BadgeShape | undefined;
+    /** Leading status dot, drawn in the text colour. */
+    dot?: boolean;
+    /** Leading 14px glyph. */
+    icon?: React.ReactNode;
+}
+declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * FileChip — compact attachment row: a colored file-type tile, the file
+ * name, a "size · when" meta line, and an optional trailing action
+ * (View / Download). Used in the AI receipt panel, document mini-lists,
+ * and message attachments.
+ *
+ * The tile tone keys off `kind`: documents are danger-tinted (PDF red),
+ * sheets success, images info, generic neutral — a quick visual file-type
+ * cue without a bespoke icon per extension.
+ */
+type FileKind = "doc" | "sheet" | "image" | "generic";
+interface FileChipProps extends React.HTMLAttributes<HTMLDivElement> {
+    name: string;
+    /** Right-side meta, e.g. "240 KB · uploaded just now". */
+    meta?: React.ReactNode;
+    kind?: FileKind;
+    /** Custom glyph inside the tile; defaults to a document icon. */
+    icon?: React.ReactNode;
+    /** Trailing action node (a Button / link). */
+    action?: React.ReactNode;
+}
+declare const FileChip: React$1.ForwardRefExoticComponent<FileChipProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Theme scope — the host dimensions a subtree renders with (W5-02).
+ *
+ * The design system's scopes are DOM attributes: `[data-ds-scheme]`,
+ * `[data-ds-brand]`, `[data-ds-density]`, `dir`, and the `--ds-*` style a
+ * runtime brand writes (`createBrandTheme`). Set on the document root they
+ * reach everything, portalled overlays included. Set on a *subtree* they stop
+ * at the subtree: a Dialog or Popover opened from inside it renders in
+ * `document.body`, outside the scope, and comes up in the root theme.
+ *
+ * `ThemeScope` fixes that. It stamps the attributes on its own element, as a
+ * hand-written scope would, **and** registers them in context, so the shared
+ * `Portal` (`primitives/behavior/portal.tsx`) can re-stamp the same attributes
+ * and runtime-brand style on the container wrapper it mounts portalled content
+ * into. Nested scopes merge: a `density="compact"` scope inside a `brand="tax"`
+ * one propagates both.
+ *
+ * Apps that scope the document root need none of this; the portal path is
+ * unchanged for them (no wrapper is created).
+ */
+/** The scheme a subtree renders with (`[data-ds-scheme]`). */
+type ThemeScheme = "light" | "dark";
+/** A built-in brand scope (`[data-ds-brand]`). */
+type ThemeBrand = "pro" | "audit" | "books" | "tax";
+/** The density scope (`[data-ds-density]`, W2-06). */
+type ThemeDensity = "comfortable" | "compact";
+/** Text direction (`dir`). */
+type ThemeDirection = "ltr" | "rtl";
+/**
+ * The dimensions a scope sets. Every field is optional; an unset field is
+ * inherited from the enclosing scope, then from the document.
+ *
+ * @experimental
+ */
+interface ThemeScopeValue {
+    scheme?: ThemeScheme | undefined;
+    brand?: ThemeBrand | undefined;
+    density?: ThemeDensity | undefined;
+    dir?: ThemeDirection | undefined;
+    /**
+     * A registered runtime brand: the object `createBrandTheme()` returns. It is
+     * applied as inline `--ds-*` style on the scope element and re-applied on
+     * portalled content.
+     */
+    brandTheme?: BrandTheme | undefined;
+}
+/** Props of {@link ThemeScope}. @experimental */
+interface ThemeScopeProps extends ThemeScopeValue, Omit<React.HTMLAttributes<HTMLDivElement>, "dir"> {
+    children?: ReactNode;
+}
+/**
+ * A `<div>` that scopes the host dimensions of its subtree — scheme, brand,
+ * density, direction and a runtime brand — and propagates them into every
+ * overlay opened from inside it (Dialog, Sheet, Popover, Tooltip, menus,
+ * Select, Toast …), which would otherwise render in the document's theme.
+ *
+ * ```tsx
+ * <ThemeScope brand="tax" density="compact">
+ *   <Popover>…</Popover>   // its content renders as compact Tax, too
+ * </ThemeScope>
+ *
+ * <ThemeScope brandTheme={createBrandTheme({ brand: firm.primary })}>
+ *   <Dialog>…</Dialog>     // the runtime brand follows the dialog to <body>
+ * </ThemeScope>
+ * ```
+ *
+ * Nothing changes for apps that scope `<html>` or `<body>`: no wrapper is
+ * created around portalled content when no `ThemeScope` encloses it.
+ *
+ * @experimental W5-02. The public shape follows decision D7 for the runtime
+ * brand seed.
+ */
+declare const ThemeScope: React$1.ForwardRefExoticComponent<ThemeScopeProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * How `TableHead` sets its column labels (W6-02).
+ * - `plain` (default) — sentence case in the body font, 14px medium, `text-fg-3`.
+ *   This is what Table renders today and what Pro's `HEADER_CLS` override
+ *   reproduces by hand.
+ * - `overline` — the mono uppercase eyebrow (`text-overline` role, `text-fg-4`).
+ *
+ * @experimental
+ */
+type TableHeaderStyle = "plain" | "overline";
+/** Horizontal alignment of a cell's content, in logical (writing-direction) terms. @experimental */
+type TableCellAlign = "start" | "center" | "end";
+/** Which edge a cell sticks to while the wrapper scrolls horizontally (W6-10). @experimental */
+type TableStickyEdge = "start" | "end";
+/** A column's sort direction; `null` is "sortable, not sorted". @experimental */
+type TableSortDirection = "asc" | "desc";
+interface TableProps extends React.TableHTMLAttributes<HTMLTableElement> {
+    /** Class for the wrapping `div` that handles overflow. */
+    wrapperClassName?: string;
+    /**
+     * Per-part classes (W2-17 pattern). `wrapper` is the overflow container —
+     * the same element `wrapperClassName` styles (C-CLASSNAME-PROPS).
+     *
+     * @experimental
+     */
+    classNames?: Partial<Record<Extract<TableSlot, "wrapper">, string>>;
+    /**
+     * The header label style (W6-02). Default `plain` — today's sentence-case
+     * labels. `overline` renders the mono uppercase eyebrow.
+     *
+     * @experimental
+     */
+    headerStyle?: TableHeaderStyle;
+    /**
+     * Row density (W6-11). Stamps `data-ds-density` on the wrapper, so the
+     * whole table — its rows and the controls inside them — renders one step
+     * denser: 36px rows, 12px horizontal and 8px vertical cell padding, read
+     * from the `--ds-table-*` tokens the scope re-points. Undefined leaves the
+     * table on the ambient scope (ADR-013: density is a scope; this prop is the
+     * scope on the table's own element).
+     *
+     * @experimental
+     */
+    density?: ThemeDensity;
+    /**
+     * Keep the header row visible while the wrapper scrolls vertically (W6-10).
+     * Give the wrapper a height (`wrapperClassName="max-h-96"`) for it to
+     * scroll. Header cells become `position: sticky` with the surface-2
+     * background they already have.
+     *
+     * @experimental
+     */
+    stickyHeader?: boolean;
+    /**
+     * Copy for this table; prop > provider > English default (W5-20). The only
+     * message today is the accessible name of the horizontal scroll region
+     * (`region`).
+     *
+     * @experimental
+     */
+    messages?: Partial<TableMessages>;
+}
+declare const Table: React$1.ForwardRefExoticComponent<TableProps & React$1.RefAttributes<HTMLTableElement>>;
+type TableHeaderProps = React.HTMLAttributes<HTMLTableSectionElement>;
+declare const TableHeader: React$1.ForwardRefExoticComponent<TableHeaderProps & React$1.RefAttributes<HTMLTableSectionElement>>;
+type TableBodyProps = React.HTMLAttributes<HTMLTableSectionElement>;
+declare const TableBody: React$1.ForwardRefExoticComponent<TableBodyProps & React$1.RefAttributes<HTMLTableSectionElement>>;
+type TableFooterProps = React.HTMLAttributes<HTMLTableSectionElement>;
+declare const TableFooter: React$1.ForwardRefExoticComponent<TableFooterProps & React$1.RefAttributes<HTMLTableSectionElement>>;
+interface TableRowProps extends React.HTMLAttributes<HTMLTableRowElement> {
+    /**
+     * The row is part of the current selection: renders `data-state="selected"`
+     * (P-DATA-STATE — the attribute consumers already set by hand keeps working)
+     * and the brand tint.
+     *
+     * @experimental
+     */
+    selected?: boolean | undefined;
+    /**
+     * The row itself is a click target (W6-01): a tab stop with a focus ring,
+     * Enter and Space fire `onClick` — Pressable's contract on a `<tr>`, which
+     * stays a `<tr>` (P-NATIVE-TABLE; a `role="button"` would take its cells
+     * out of the table). Keys pressed on a control inside the row (a checkbox,
+     * a menu button) are left to that control.
+     *
+     * @experimental
+     */
+    interactive?: boolean;
+}
+declare const TableRow: React$1.ForwardRefExoticComponent<TableRowProps & React$1.RefAttributes<HTMLTableRowElement>>;
+/** The props `TableHead` and `TableCell` share (W6-01). @experimental */
+interface TableCellCommonProps {
+    /**
+     * Content alignment, logical: `end` is what a consumer wrote `text-right`
+     * for (60 times in Pro). Default `start`. Replaces the deprecated HTML
+     * `align` attribute on the cell, which no consumer passes.
+     */
+    align?: TableCellAlign | undefined;
+    /** A column of figures: tabular numerals and `end` alignment. */
+    numeric?: boolean | undefined;
+    /** Clip overflowing content with an ellipsis (`truncate`, `max-width: 0`); pair with `width`. */
+    truncate?: boolean | undefined;
+    /** Column width, as a CSS length or a pixel number — an inline `width` on the cell. */
+    width?: number | string | undefined;
+    /**
+     * Stick the cell to the `start` or `end` edge while the wrapper scrolls
+     * horizontally (W6-10): the Pro sticky action column. The cell paints the
+     * surface it sits on so scrolled content never shows through it.
+     */
+    sticky?: TableStickyEdge | undefined;
+}
+interface TableHeadProps extends Omit<React.ThHTMLAttributes<HTMLTableCellElement>, "align">, TableCellCommonProps {
+    /**
+     * The column's sort state (W6-01): `"asc"`, `"desc"`, or `null` for a
+     * sortable column that is not sorted. Undefined (the default) is a plain,
+     * unsortable header. Setting it renders the label inside a `<button>` that
+     * cycles none → asc → desc → none through `onSortChange` (the order
+     * `DataTableHeader` has always used) and reflects the state as `aria-sort`
+     * and `data-state`. The `<th>`'s text stays the label alone (C-DOM-14).
+     *
+     * @experimental
+     */
+    sort?: TableSortDirection | null | undefined;
+    /** Receives the next step of the sort cycle when the header is activated. */
+    onSortChange?: ((sort: TableSortDirection | null) => void) | undefined;
+}
+declare const TableHead: React$1.ForwardRefExoticComponent<TableHeadProps & React$1.RefAttributes<HTMLTableCellElement>>;
+interface TableCellProps extends Omit<React.TdHTMLAttributes<HTMLTableCellElement>, "align">, TableCellCommonProps {
+    /**
+     * Secondary content — `text-fg-3` (content-muted), what a consumer wrote
+     * `text-muted-foreground` for (90 times in Pro).
+     */
+    muted?: boolean;
+}
+declare const TableCell: React$1.ForwardRefExoticComponent<TableCellProps & React$1.RefAttributes<HTMLTableCellElement>>;
+type TableCaptionProps = React.HTMLAttributes<HTMLTableCaptionElement>;
+declare const TableCaption: React$1.ForwardRefExoticComponent<TableCaptionProps & React$1.RefAttributes<HTMLTableCaptionElement>>;
+
+/**
+ * Practice service tones for the client portal. Each engagement surface
+ * (card, ring, timeline) is "toned per service": a fill color + a track
+ * tint. Rather than fork every primitive's `variant` enum, portal
+ * composites set these two CSS vars (`--tone`, `--tone-bg`) once on their
+ * root and let descendants read them via `[color:var(--tone)]` /
+ * `[background:var(--tone-bg)]`. One place owns the mapping; theming and
+ * dark mode flow through the underlying `--color-service-*` tokens.
+ */
+type ServiceTone = "tax" | "audit" | "accounting" | "neutral";
+/**
+ * CSS-var style object to spread on a service-toned root. Descendants read
+ * `var(--tone)` / `var(--tone-bg)`; the cast is required because
+ * `CSSProperties` doesn't type custom properties.
+ */
+declare function serviceToneStyle(tone: ServiceTone): CSSProperties;
+declare const SERVICE_TONES: ServiceTone[];
+/** Human label for a tone, for chips and headings. */
+declare const serviceToneLabel: Record<ServiceTone, string>;
+
+interface DataTableProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** When true, renders the table card with a flat top edge so it
+     *  visually attaches to a `<DataTableToolbar>` above it. */
+    withToolbar?: boolean;
+}
+/**
+ * DataTable — outer wrapper. Children are typically:
+ *   <DataTableToolbar /> + <table> + <DataTablePagination />.
+ *
+ * The `<table>` is hand-written by the consumer; this wrapper renders
+ * the surface card chrome on its descendant `<table>` element via a
+ * Tailwind arbitrary-variant selector. When `withToolbar` is set, the
+ * top corners flatten so the table visually joins the toolbar above.
+ *
+ * Children render in document order — toolbar (if any) then `<table>`
+ * then pagination — with the table card and the pagination not sharing
+ * a background.
+ */
+declare const DataTable: React$1.ForwardRefExoticComponent<DataTableProps & React$1.RefAttributes<HTMLDivElement>>;
+type DataTableToolbarProps = React.HTMLAttributes<HTMLDivElement>;
+/**
+ * DataTableToolbar — header strip at the top of the table card. The outer
+ * frame is owned by `<DataTable>`, so this is just a row with a bottom
+ * divider separating it from the table below.
+ */
+declare const DataTableToolbar: React$1.ForwardRefExoticComponent<DataTableToolbarProps & React$1.RefAttributes<HTMLDivElement>>;
+interface DataTableSearchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size"> {
+    /** Override the default placeholder. */
+    placeholder?: string;
+}
+/**
+ * DataTableSearch — small search input slot inside the toolbar. Wraps
+ * the `Input` primitive at `inputSize="sm"` with a leading search icon.
+ */
+declare const DataTableSearch: React$1.ForwardRefExoticComponent<DataTableSearchProps & React$1.RefAttributes<HTMLInputElement>>;
+type DataTableSpacerProps = React.HTMLAttributes<HTMLSpanElement>;
+/** DataTableSpacer — `flex-1` spacer for arranging toolbar items. */
+declare const DataTableSpacer: React$1.ForwardRefExoticComponent<DataTableSpacerProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface DataTableResultsCountProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+    current: number;
+    total: number;
+}
+/**
+ * DataTableResultsCount — small "12 of 247" indicator. Mono + tabular.
+ */
+declare const DataTableResultsCount: React$1.ForwardRefExoticComponent<DataTableResultsCountProps & React$1.RefAttributes<HTMLSpanElement>>;
+/** DataTableHead — `<thead>`; alias of `TableHeader`. */
+type DataTableHeadProps = TableHeaderProps;
+declare const DataTableHead: React$1.ForwardRefExoticComponent<TableHeaderProps & React$1.RefAttributes<HTMLTableSectionElement>>;
+/** DataTableBody — `<tbody>`; alias of `TableBody`. Last row drops its bottom border. */
+type DataTableBodyProps = TableBodyProps;
+declare const DataTableBody: React$1.ForwardRefExoticComponent<TableBodyProps & React$1.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * DataTableRow — `<tr>`; alias of `TableRow`. `selected` renders
+ * `data-state="selected"` and the brand tint (P-DATA-STATE); `interactive`
+ * (W6-01) makes the row a click target.
+ */
+type DataTableRowProps = TableRowProps;
+declare const DataTableRow: React$1.ForwardRefExoticComponent<TableRowProps & React$1.RefAttributes<HTMLTableRowElement>>;
+type SortDirection = TableSortDirection;
+interface DataTableHeaderProps extends Omit<TableHeadProps, "sort" | "onSortChange"> {
+    /** When true, the cell becomes a clickable button that toggles sort
+     *  state and renders a chevron indicator. */
+    sortable?: boolean;
+    /** Initial sort direction when the header mounts in a sorted state. */
+    defaultSort?: SortDirection;
+    /** Optional controlled sort state. When provided, `onSortChange` should
+     *  also be wired up — the header becomes fully controlled. */
+    sort?: SortDirection | null;
+    /** Fires whenever the user clicks a sortable header. */
+    onSortChange?: (sort: SortDirection | null) => void;
+}
+/**
+ * DataTableHeader — `<th scope="col">`; alias of `TableHead` that keeps the
+ * DataTable sort API: `sortable` gates sorting, the sort state is uncontrolled
+ * (`defaultSort`) or controlled (`sort` + `onSortChange`). Sort cycle when
+ * uncontrolled: unsorted → asc → desc → unsorted (3-state). The sort button
+ * is the header's direct child `<button>` (C-DOM-13), styled like
+ * `TableHead`'s.
+ */
+declare const DataTableHeader: React$1.ForwardRefExoticComponent<DataTableHeaderProps & React$1.RefAttributes<HTMLTableCellElement>>;
+/** DataTableCell — `<td>`; alias of `TableCell` (13px / fg-2, W6-01 cell props). */
+type DataTableCellProps = TableCellProps;
+declare const DataTableCell: React$1.ForwardRefExoticComponent<TableCellProps & React$1.RefAttributes<HTMLTableCellElement>>;
+/**
+ * DataTableCellName — primary identifier of the row. Display font,
+ * fg color, medium weight.
+ */
+declare const DataTableCellName: React$1.ForwardRefExoticComponent<TableCellProps & React$1.RefAttributes<HTMLTableCellElement>>;
+/**
+ * DataTableCellMono — currency / IDs / numerics. Body font (Plus Jakarta
+ * Sans) with tabular numerals so columns of figures stay aligned.
+ */
+declare const DataTableCellMono: React$1.ForwardRefExoticComponent<TableCellProps & React$1.RefAttributes<HTMLTableCellElement>>;
+/**
+ * DataTableCellId — muted ID (EIN, UUID, "5h ago") in the body font
+ * (Plus Jakarta Sans) with tabular numerals.
+ */
+declare const DataTableCellId: React$1.ForwardRefExoticComponent<TableCellProps & React$1.RefAttributes<HTMLTableCellElement>>;
+interface DataTableCellDueProps extends Omit<DataTableCellProps, "children"> {
+    /** Date this row is due. */
+    value: Date;
+    /** Optional override for the displayed label (defaults to the
+     *  formatted date). */
+    children?: ReactNode;
+}
+/**
+ * DataTableCellDue — accepts a Date and auto-colors:
+ *   diff < 0      → text-danger-fg  (overdue)
+ *   diff < 14d    → text-warning-fg (due-near)
+ *   otherwise     → text-fg-3       (default)
+ *
+ * The 14-day threshold and day-rounding (`Math.floor`) match the
+ * `.cell-due-near` / `.cell-due-overdue` CSS classes in the mockup.
+ */
+declare const DataTableCellDue: React$1.ForwardRefExoticComponent<DataTableCellDueProps & React$1.RefAttributes<HTMLTableCellElement>>;
+interface DataTableCheckboxProps extends Omit<DataTableCellProps, "onChange" | "defaultChecked" | "children"> {
+    /** Forwarded to the inner `Checkbox` primitive. */
+    checked?: boolean | "indeterminate";
+    defaultChecked?: boolean | "indeterminate";
+    onCheckedChange?: (checked: boolean | "indeterminate") => void;
+    /** Accessible label for the checkbox (e.g. "Select row Acme Corp."). */
+    ariaLabel?: string;
+    disabled?: boolean;
+    /** Render the cell as `<th>` (for the select-all header) instead of `<td>`. */
+    asHeader?: boolean;
+}
+/**
+ * DataTableCheckbox — `<td>` (or `<th>` with `asHeader`) containing the
+ * row-selection checkbox: `TableCell` / `TableHead` tightened to a 32px
+ * column with no right padding to match `.row-checkbox` in the spec.
+ */
+declare const DataTableCheckbox: React$1.ForwardRefExoticComponent<DataTableCheckboxProps & React$1.RefAttributes<HTMLTableCellElement>>;
+
+/**
+ * DataTableView — config-driven table on top of the composition
+ * `DataTable*` primitives. Every list/table screen is just a config:
+ * `columns` + `data` (+ optional `filters` / `searchKeys` / sort). Since
+ * W6-07 the search / filter / sort / pagination *state* lives in the
+ * headless `useDataTable` controller, so each of sort, page and search is
+ * **controllable** (`sorting` / `onSortingChange`, `page` / `onPageChange`,
+ * `search` / `onSearchChange`) while the uncontrolled defaults and the DOM
+ * stay exactly what they were: `<th>` text is `column.header`, the sort
+ * cycle is unsorted → asc → desc → unsorted (C-DOM-14). The table chrome,
+ * sortable headers and pagination all come from the existing `DataTable`
+ * family (no fork, no second table chrome).
+ *
+ * It complements — does not replace — the composition API: reach for the
+ * raw `DataTable*` parts when a screen needs bespoke cells or layout; reach
+ * for `DataTableView` when the table is "columns + rows + the usual
+ * toolbar." Render helpers (`EmptyValue`, `TagsCell`) cover the generic
+ * cell shapes; the product-flavoured ones (`StagePill`, `Assignee`,
+ * `MoneyCell`) are deprecated and flagged for hand-over to TAX (W6-14 →
+ * W8-13).
+ */
+type TableRowData = Record<string, unknown>;
+interface DataTableViewColumn<Row extends TableRowData> {
+    key: string;
+    header: string;
+    /** Column width. Fixed px (`"120px"`) sets a hard width; a grid-style
+     *  `"minmax(190px,1.5fr)"` is read as a `min-width` and the column flexes. */
+    width?: string;
+    sortable?: boolean;
+    align?: "right";
+    /** Custom sort accessor (e.g. a numeric `lastDays` behind a "5h ago" label). */
+    sortValue?: (row: Row) => string | number | null | undefined;
+    /** Custom cell renderer; defaults to the raw field value. */
+    render?: (row: Row) => ReactNode;
+}
+interface DataTableViewFilter<Row extends TableRowData> {
+    key: string;
+    label?: string;
+    allLabel?: string;
+    options: (string | {
+        value: string;
+        label: string;
+    })[];
+    match: (row: Row, value: string) => boolean;
+}
+/**
+ * Row selection. Controlled: the caller owns the id set, so a selection can
+ * outlive a filter change (or be cleared on one) — that policy belongs to the
+ * screen, not the table.
+ */
+interface DataTableViewSelection<Row extends TableRowData> {
+    /** Ids of selected rows, keyed by `rowKey`. May include rows not currently visible. */
+    selectedIds: ReadonlySet<string>;
+    onSelectionChange: (selectedIds: Set<string>) => void;
+    /**
+     * Rows the caller will not accept — e.g. an already-sent record. They render a
+     * disabled checkbox and are excluded from select-all, so "all" never selects
+     * something the action would reject.
+     */
+    isRowSelectable?: (row: Row) => boolean;
+    /**
+     * What the header checkbox covers. **Required decision, not a default to
+     * ignore:** with 132 filtered rows across 9 pages, "select all" meaning *this
+     * page* and meaning *all 132* are different features, and a table that guesses
+     * eventually acts on 132 records when the user saw 15.
+     * `"page"` (default) — the rows currently on screen.
+     * `"filtered"` — every row matching the active search and filters.
+     */
+    selectAllScope?: "page" | "filtered" | undefined;
+    /** Accessible label for a row's checkbox, e.g. ``(row) => `Select ${row.name}` ``. */
+    rowLabel?: (row: Row) => string;
+}
+/**
+ * The sort of a `DataTableView`: one column key and a direction, or `null`
+ * for unsorted. The shape `initialSort` has always used.
+ *
+ * @experimental
+ */
+type DataTableViewSort = {
+    key: string;
+    dir: SortDirection;
+} | null;
+interface DataTableViewProps<Row extends TableRowData> {
+    columns: DataTableViewColumn<Row>[];
+    data: Row[];
+    filters?: DataTableViewFilter<Row>[];
+    searchKeys?: string[];
+    searchPlaceholder?: string;
+    /** The sort the table starts with when `sorting` is not controlled. */
+    initialSort?: DataTableViewSort;
+    /**
+     * Controlled sort (W6-07). Pass it with `onSortingChange` to own the sort —
+     * e.g. to mirror it into the URL — instead of listening for header clicks.
+     * Omit it for the uncontrolled default seeded by `initialSort`.
+     *
+     * @experimental
+     */
+    sorting?: DataTableViewSort;
+    /** Called with the next sort when a header is pressed; the cycle is asc → desc → unsorted. @experimental */
+    onSortingChange?: (sorting: DataTableViewSort) => void;
+    /** Controlled 1-based page (W6-07). @experimental */
+    page?: number;
+    /** Called with the next page, including the return to page 1 on a search or filter change. @experimental */
+    onPageChange?: (page: number) => void;
+    /** Controlled search text (W6-07). @experimental */
+    search?: string;
+    /** Called with the search text on every keystroke. @experimental */
+    onSearchChange?: (search: string) => void;
+    onRowClick?: (row: Row) => void;
+    rowKey?: string;
+    pageSize?: number;
+    /**
+     * Hide the pager when every row fits on one page. Default `true` — the 1.x
+     * behaviour, kept here although `Pagination` itself defaults to `false` in
+     * 2.0 (W9-10). Pass `false` to always show the pager. @experimental
+     */
+    hideOnSinglePage?: boolean;
+    /** Plural noun for the footer / empty state, e.g. "clients". */
+    itemLabel?: string;
+    /** Opt in to row selection. Omit it and the table renders exactly as before. */
+    selection?: DataTableViewSelection<Row>;
+    className?: string;
+}
+declare function DataTableView<Row extends TableRowData>({ columns, data, filters, searchKeys, searchPlaceholder, initialSort, sorting: sortingProp, onSortingChange, page: pageProp, onPageChange, search: searchProp, onSearchChange, onRowClick, rowKey, pageSize, hideOnSinglePage, itemLabel, selection, className, }: DataTableViewProps<Row>): react_jsx_runtime.JSX.Element;
+/**
+ * EmptyValue — the em-dash placeholder for a cell with no value. Generic:
+ * no copy, no product tone.
+ *
+ * @experimental
+ */
+declare function EmptyValue(): react_jsx_runtime.JSX.Element;
+/**
+ * Em-dash placeholder for empty cells.
+ *
+ * @deprecated Renamed `EmptyValue` (W6-14); same DOM. Removed in 3.0.
+ */
+declare function Dash(): react_jsx_runtime.JSX.Element;
+/** TagsCell — first tag + "+N" overflow. */
+declare function TagsCell({ items }: {
+    items?: string[];
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Stage tones of {@link StagePill}. "blue" and "violet" are the Tax and Pro
+ * brand tones: product vocabulary, not a system palette.
+ *
+ * @deprecated Product vocabulary (W6-14). Hands over to TAX in W8-13; use
+ * `StatusBadge` with `defineStatusMap` for a system-toned status.
+ * @product
+ */
+type TableTone = "slate" | "blue" | "violet" | "amber" | "ok" | "rose";
+/**
+ * StagePill — colored stage/status pill for `column.render`.
+ *
+ * @deprecated Product vocabulary (W6-14). Hands over to TAX in W8-13; use
+ * `StatusBadge` for a status word in the system palette.
+ * @product
+ */
+declare function StagePill({ tone, dot, children, }: {
+    tone?: TableTone | undefined;
+    dot?: boolean;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Assignee — grey avatar + name, or "Unassigned".
+ *
+ * @deprecated Product copy ("Unassigned") and layout (W6-14). Hands over to
+ * TAX in W8-13; render `Avatar` + name in `column.render`.
+ * @product
+ */
+declare function Assignee({ name }: {
+    name?: string | null | undefined;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * MoneyCell — `$1,234` or an em-dash when falsy/zero.
+ *
+ * @deprecated Hard-coded `$` and host-locale formatting (W6-14). Hands over
+ * to TAX in W8-13; format with `Intl.NumberFormat` in `column.render` and
+ * fall back to `EmptyValue`.
+ * @product
+ */
+declare function MoneyCell({ value }: {
+    value?: number | null;
+}): react_jsx_runtime.JSX.Element;
+
+export { DataTableResultsCount as $, Assignee as A, type BadgeProps as B, type CardSlot as C, Dash as D, DataTableBody as E, type FileKind as F, type DataTableBodyProps as G, DataTableCell as H, type InputSlot as I, DataTableCellDue as J, type DataTableCellDueProps as K, DataTableCellId as L, MoneyCell as M, type NumberInputSlot as N, DataTableCellMono as O, type PhoneFieldSlot as P, DataTableCellName as Q, type DataTableCellProps as R, type ServiceTone as S, TagsCell as T, DataTableCheckbox as U, type DataTableCheckboxProps as V, DataTableHead as W, type DataTableHeadProps as X, DataTableHeader as Y, type DataTableHeaderProps as Z, type DataTableProps as _, StagePill as a, type TableSortDirection as a$, type DataTableResultsCountProps as a0, DataTableRow as a1, type DataTableRowProps as a2, DataTableSearch as a3, type DataTableSearchProps as a4, DataTableSpacer as a5, type DataTableSpacerProps as a6, DataTableToolbar as a7, type DataTableToolbarProps as a8, DataTableView as a9, type SidebarBrandSwitcherSlot as aA, type SidebarSlot as aB, type SortDirection as aC, type StackSlot as aD, type StatusBadgeSlot as aE, type SurfaceSlot as aF, type SwitchSlot as aG, Table as aH, TableBody as aI, type TableBodyProps as aJ, TableCaption as aK, type TableCaptionProps as aL, TableCell as aM, type TableCellAlign as aN, type TableCellCommonProps as aO, type TableCellProps as aP, TableFooter as aQ, type TableFooterProps as aR, TableHead as aS, type TableHeadProps as aT, TableHeader as aU, type TableHeaderProps as aV, type TableHeaderStyle as aW, TableRow as aX, type TableRowData as aY, type TableRowProps as aZ, type TableSlot as a_, type DataTableViewColumn as aa, type DataTableViewFilter as ab, type DataTableViewProps as ac, type DataTableViewSelection as ad, type DataTableViewSort as ae, type DialogSlot as af, type DropdownMenuSlot as ag, EmptyValue as ah, type FieldSlot as ai, type FieldsetSlot as aj, FileChip as ak, type FileChipProps as al, type HeadingSlot as am, type IconButtonSlot as an, type InlineSlot as ao, type KbdSlot as ap, type LabelSlot as aq, type LinkButtonSlot as ar, type PaginationSlot as as, type PopoverSlot as at, type PressableSlot as au, type RadioGroupSlot as av, SERVICE_TONES as aw, type SheetSlot as ax, type ShellSlot as ay, type SideDrawerSlot as az, type AvatarSlot as b, type TableStickyEdge as b0, type TableTone as b1, type TextSlot as b2, type ThemeBrand as b3, type ThemeDensity as b4, type ThemeDirection as b5, type ThemeScheme as b6, ThemeScope as b7, type ThemeScopeProps as b8, type ThemeScopeValue as b9, type ToastSlot as ba, type TooltipSlot as bb, badgeVariants as bc, resolveBadgeAppearance as bd, serviceToneLabel as be, serviceToneStyle as bf, type FileUploadSlot as c, type SearchInputSlot as d, type SelectSlot as e, type TextareaSlot as f, type BadgeSize as g, type BadgeShape as h, type DataTableSlot as i, type TableProps as j, type AlertDialogSlot as k, Badge as l, type BadgeAppearance as m, type BadgeAppearanceInput as n, type BadgeLegacyVariant as o, type BadgeSlot as p, type BadgeVariant as q, type BadgeVariantsProps as r, type ButtonSlot as s, type CheckboxSlot as t, type ChipSlot as u, type CodeSlot as v, type ComboboxSlot as w, type CommandSlot as x, type ContextMenuSlot as y, DataTable as z };