@assure-one/design-system 1.37.0 → 1.39.0

package/dist/index-BAAuIQqP.d.ts

@@ -0,0 +1,2579 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './vocab-DornLJbW.js';
+import { k as TableMessages } from './types-k_kjwipx.js';
+import { a as BrandTheme } from './brand-theme-B6rem2II.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 that `C-TOAST-ARIALABEL` currently locates by
+ * `aria-label="Notifications"`; `data-slot="toast-region"` is the replacement
+ * that guard moves to (W5-15). 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;
+    /**
+     * 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;
+    /** 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>>;
+
+/**
+ * Blockquote — semantic quote with optional attribution. Uses `font-display`
+ * (Inter) at a comfortable reading scale; smart quotes are wrapped automatically.
+ */
+interface BlockquoteProps extends React.BlockquoteHTMLAttributes<HTMLQuoteElement> {
+    author?: string;
+    role?: string;
+}
+declare const Blockquote: React$1.ForwardRefExoticComponent<BlockquoteProps & React$1.RefAttributes<HTMLQuoteElement>>;
+
+/**
+ * CategoryDivider — THE category separator: a tone-tinted category pill, a
+ * flex-1 hairline rule, and an optional trailing count chip. Used to group a
+ * run of feed items / cards by service line. Per the ONE-brand rule, this tag
+ * is the *only* place per-service color is allowed — everything else stays on
+ * the single brand. Pure presentational.
+ *
+ * Tones map to the suite tints:
+ *   brand → --color-brand-pro · audit → --color-brand-audit ·
+ *   books → --color-brand-books · tax → --color-brand-tax ·
+ *   neutral → --color-fg-3
+ */
+declare const categoryTagVariants: (props?: ({
+    tone?: "brand" | "neutral" | "audit" | "books" | "tax" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type CategoryTone = NonNullable<VariantProps<typeof categoryTagVariants>["tone"]>;
+interface CategoryTagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof categoryTagVariants> {
+    /** Tag label text. */
+    label: string;
+    /** Optional leading icon rendered inside the pill. */
+    icon?: React.ReactNode;
+}
+/**
+ * CategoryTag — the standalone tone-tinted category pill, reusable in card
+ * headers and feed-item rows. Same atom CategoryDivider renders on its left.
+ */
+declare const CategoryTag: React$1.ForwardRefExoticComponent<CategoryTagProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface CategoryDividerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof categoryTagVariants> {
+    /** Category label shown in the tone-tinted tag. */
+    label: string;
+    /** Optional leading icon rendered inside the tag. */
+    icon?: React.ReactNode;
+    /** Optional item count → trailing neutral count chip. */
+    count?: number;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PORTAL client portal, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const CategoryDivider: React$1.ForwardRefExoticComponent<CategoryDividerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * DocumentSourceTag — provenance atom for a document row/card: how the file
+ * arrived. Mirrors StatusPill's shape (a `source` enum maps to label + icon +
+ * tone), so call sites read as `<DocumentSourceTag source="requested" />`
+ * instead of repeating the label/icon/colour triple.
+ *
+ *   requested → brand tint  · send glyph    (client fulfilled a firm request)
+ *   direct    → outline    · upload glyph  (client uploaded unprompted)
+ *   internal  → neutral    · shield glyph  (firm-prepared, not client-visible)
+ *
+ * Pass `children` to override the label while keeping the mapped tone/icon,
+ * `icon` to swap the glyph, or `hideIcon` for a label-only tag.
+ */
+type DocumentSource = "requested" | "direct" | "internal";
+interface DocumentSourceTagProps extends React.HTMLAttributes<HTMLSpanElement> {
+    source: DocumentSource;
+    /** Override the leading glyph for the mapped source. */
+    icon?: React.ReactNode;
+    /** Render label-only, with no leading glyph. */
+    hideIcon?: boolean;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO documents, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentSourceTag: React$1.ForwardRefExoticComponent<DocumentSourceTagProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * DocumentsWorkspaceLayout — 3-pane CSS-grid shell for a firm Documents workspace.
+ *
+ * Renders three independently-scrolling columns: a clients rail, a folder tree,
+ * and a files area. The root fills its parent height and does not scroll itself.
+ * Each pane is a flex column container; consumers are responsible for placing
+ * their own scroll regions inside the slots.
+ *
+ * Responsive grid:
+ *   Base (<lg): 2 visible columns — clientsRail + filesArea. The folderTree
+ *     pane is hidden so it does not occupy the 2-column base template.
+ *   lg (>=1024px): All 3 columns — 248px rail | 220px folders | remaining files.
+ *   xl (>=1280px): Wider columns — 280px rail | 244px folders | remaining files.
+ *
+ * No padding is imposed on any pane; the consumer owns spacing inside each slot.
+ */
+interface DocumentsWorkspaceLayoutProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Left column — client list rail (always visible). */
+    clientsRail: React.ReactNode;
+    /** Middle column — folder/category tree (hidden below lg breakpoint). */
+    folderTree: React.ReactNode;
+    /** Right column — file list and preview area (always visible). */
+    filesArea: React.ReactNode;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO documents, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentsWorkspaceLayout: React$1.ForwardRefExoticComponent<DocumentsWorkspaceLayoutProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 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>>;
+
+/**
+ * SectionHeader — title + description block for marketing-style sections.
+ * Uses Inter (`font-display`) with the spec's `-0.022em` letterspacing.
+ */
+interface SectionHeaderProps {
+    title: string;
+    description?: string;
+    align?: "left" | "center";
+    className?: string;
+}
+declare function SectionHeader({ title, description, align, className, }: SectionHeaderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Section — max-width centered wrapper for marketing/section content.
+ * The `--content-pad` token (32px) is the canonical app-content gutter,
+ * but Section keeps its 24px (`px-6`) gutter for narrower marketing pages.
+ */
+declare const maxWidthStyles: {
+    readonly sm: "ds:max-w-3xl";
+    readonly md: "ds:max-w-4xl";
+    readonly lg: "ds:max-w-5xl";
+    readonly xl: "ds:max-w-6xl";
+};
+interface SectionProps extends React.HTMLAttributes<HTMLElement> {
+    maxWidth?: keyof typeof maxWidthStyles;
+    as?: "section" | "div";
+}
+declare const Section: React$1.ForwardRefExoticComponent<SectionProps & React$1.RefAttributes<HTMLElement>>;
+interface SectionHeadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    eyebrow?: React.ReactNode;
+    title?: React.ReactNode;
+    meta?: React.ReactNode;
+}
+declare const SectionHead: React$1.ForwardRefExoticComponent<SectionHeadProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Stat — paired numeric display + caption (the StatNum primitive).
+ * Numerals are set in `font-display` (Inter) at a fluid clamp size with
+ * `font-variant-numeric: tabular-nums` for vertical alignment.
+ */
+interface StatProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: string;
+    label: string;
+}
+declare const Stat: React$1.ForwardRefExoticComponent<StatProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * StatusPill — semantic status atom for engagement / document / signature
+ * lifecycles. It is a thin mapping over <Badge>: each known `status` picks
+ * the right variant + default label + dot, so call sites read as
+ * `<StatusPill status="needs-revision" />` instead of repeating the
+ * variant/label pairing everywhere.
+ *
+ * Mapping (per the portal spec):
+ *   requested        → warning   "Requested"
+ *   in-review        → info      "In review"
+ *   needs-revision   → danger    "Needs revision"
+ *   accepted/signed/
+ *   approved/paid/
+ *   received         → success   "Accepted" / "Signed" / "Received" / …
+ *   draft/pending    → secondary
+ *   overdue          → danger
+ *
+ * Pass `children` to override the label while keeping the mapped variant.
+ */
+type PillStatus = "requested" | "in-review" | "needs-revision" | "accepted" | "signed" | "approved" | "paid" | "complete" | "received" | "draft" | "pending" | "overdue" | "declined" | "internal" | "shared";
+interface StatusPillProps extends Omit<BadgeProps, "variant"> {
+    status: PillStatus;
+    /** Show a leading dot. Default `true` (status atoms read better with one). */
+    dot?: boolean;
+}
+declare const StatusPill: React$1.ForwardRefExoticComponent<StatusPillProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * 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;
+    brand?: ThemeBrand;
+    density?: ThemeDensity;
+    dir?: ThemeDirection;
+    /**
+     * 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;
+}
+/** 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;
+    /**
+     * 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;
+    /** A column of figures: tabular numerals and `end` alignment. */
+    numeric?: boolean;
+    /** Clip overflowing content with an ellipsis (`truncate`, `max-width: 0`); pair with `width`. */
+    truncate?: boolean;
+    /** Column width, as a CSS length or a pixel number — an inline `width` on the cell. */
+    width?: number | string;
+    /**
+     * 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;
+}
+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;
+    /** Receives the next step of the sort cycle when the header is activated. */
+    onSortChange?: (sort: TableSortDirection | null) => void;
+}
+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>>;
+
+interface TeamMember {
+    id: string;
+    fullName: string;
+}
+interface TeamMemberSelectProps {
+    teamMembers: TeamMember[];
+    currentUserId?: string | null;
+    value: string;
+    onValueChange: (value: string) => void;
+    includeUnassigned?: boolean;
+    placeholder?: string;
+    className?: string;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: TAX, which keeps a local `TeamMemberPicker`; new code uses
+ * `PeoplePicker` (W7-10). Never removed before 3.0.
+ */
+declare function TeamMemberSelect({ teamMembers, currentUserId, value, onValueChange, includeUnassigned, placeholder, className, }: TeamMemberSelectProps): react_jsx_runtime.JSX.Element;
+declare namespace TeamMemberSelect {
+    var displayName: string;
+}
+
+/**
+ * ChannelTabs — a controlled, pill-style tab strip for switching between
+ * communication channels (Chat / Email / SMS / Internal) on a thread surface.
+ *
+ * Each tab carries a colored status dot (toned per channel) and an optional
+ * unread count. The active tab gets the accent ring treatment; inactive tabs
+ * are quiet until hovered. The component is presentational and fully
+ * controlled — the consumer owns the active value and maps it to whatever
+ * backend channel group / compose channel the tab represents.
+ *
+ *   <ChannelTabs
+ *     value={tab}
+ *     onChange={setTab}
+ *     tabs={[
+ *       { value: "chat", label: "Chat", tone: "success", count: 2 },
+ *       { value: "email", label: "Email", tone: "info" },
+ *       { value: "sms", label: "SMS", tone: "accent" },
+ *     ]}
+ *   />
+ *
+ * @since 1.5.0
+ */
+/** Status-dot tone for a channel tab. Maps to a semantic color token. */
+type ChannelTone = "brand" | "info" | "success" | "warning" | "muted" | "danger";
+interface ChannelTabItem {
+    /** Stable identifier passed back to `onChange`. */
+    value: string;
+    /** Visible label. */
+    label: string;
+    /** Status-dot tone. Defaults to `muted`. */
+    tone?: ChannelTone;
+    /** Optional unread count — hidden when `0` or `undefined`. */
+    count?: number;
+}
+interface ChannelTabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** The tabs to render. */
+    tabs: ChannelTabItem[];
+    /** Currently active tab `value`. */
+    value: string;
+    /** Fired with the picked tab's `value`. */
+    onChange: (value: string) => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function ChannelTabs({ tabs, value, onChange, className, ...props }: ChannelTabsProps): react_jsx_runtime.JSX.Element;
+declare namespace ChannelTabs {
+    var displayName: string;
+}
+
+/**
+ * IntentBadge — a small dashed-outline badge for an AI-classified intent
+ * (Document, Question, Payment, Scheduling, Urgent, FYI, Follow-up…).
+ *
+ * The dashed border is the signature: it reads as "machine-suggested, not
+ * yet confirmed", distinguishing it from the solid `StatusPill` used for
+ * authoritative state. Presentational and generic — the consumer owns the
+ * intent→tone→icon→label mapping in their own domain config and passes the
+ * resolved pieces in.
+ *
+ *   <IntentBadge tone="info" icon={<FileIcon size={12} />}>Document</IntentBadge>
+ *
+ * @since 1.5.0
+ */
+/** Color tone for an intent badge. */
+type IntentTone = "brand" | "info" | "primary" | "success" | "warning" | "danger" | "muted";
+interface IntentBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** Color tone. Defaults to `muted`. */
+    tone?: IntentTone;
+    /** Optional leading glyph — pass a 12px icon. */
+    icon?: ReactNode;
+    /** Badge label. */
+    children: ReactNode;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function IntentBadge({ tone, icon, children, className, ...props }: IntentBadgeProps): react_jsx_runtime.JSX.Element;
+declare namespace IntentBadge {
+    var displayName: string;
+}
+
+/**
+ * DocumentRequestUpload — one self-contained "please upload this document" row
+ * for an organizer or a document-request list: a label (with optional help +
+ * required flag), a drag-drop dropzone, and the list of already-uploaded files
+ * rendered as removable chips.
+ *
+ * It packages the `FileUpload` + `FileChip` primitives into the exact shape a
+ * document-request row needs — including the file **remove** affordance that
+ * the `Questions` `file-upload` type only exposes via its `onFileRemove` prop.
+ * Reach for `Questions type="file-upload"` when the upload is one field inside a
+ * larger question list; reach for this when a document request is the whole unit
+ * (its own card, its own awaiting/locked state).
+ *
+ * Fully presentational and controlled: the caller owns the file list and every
+ * handler.
+ */
+interface DocumentRequestUploadFile {
+    /** Stable key. Falls back to `name` + `size` when omitted. */
+    id?: string;
+    /** File name shown on the chip. */
+    name: string;
+    /** Size in bytes; rendered as a human meta line when `meta` is not given. */
+    size?: number;
+    /** File-type tone for the chip tile. Defaults to `"doc"`. */
+    kind?: FileKind;
+    /** Overrides the derived "size" meta line (e.g. "2.1 MB · uploaded just now"). */
+    meta?: React.ReactNode;
+}
+interface DocumentRequestUploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Row headline, e.g. "W-2 from each employer". */
+    label: string;
+    /** Optional supporting line under the label. */
+    description?: string;
+    /** Renders a "Required" pill next to the label. */
+    required?: boolean;
+    /** Optional help tooltip beside the label. */
+    help?: {
+        title?: string;
+        body: string;
+    };
+    /** Already-uploaded files, rendered as removable chips. */
+    files?: DocumentRequestUploadFile[];
+    /** New files chosen via the dropzone / picker. */
+    onFilesSelected?: (files: File[]) => void;
+    /** Remove an uploaded file. When omitted, chips have no remove button. */
+    onRemoveFile?: (file: DocumentRequestUploadFile, index: number) => void;
+    /** Dropzone `accept` list, e.g. ".pdf,.jpg,.png". */
+    accept?: string;
+    /** Max per-file size in bytes. */
+    maxSize?: number;
+    /** Allow selecting multiple files. Defaults to `true`. */
+    multiple?: boolean;
+    /** Locks the row: hides the dropzone and the remove buttons. */
+    disabled?: boolean;
+    /** Message shown in place of the dropzone when `disabled`. Defaults to a lock note. */
+    disabledHint?: string;
+    /** Card chrome or bare layout. Defaults to `"card"`. */
+    chrome?: "card" | "plain";
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PORTAL client portal, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentRequestUpload: React$1.ForwardRefExoticComponent<DocumentRequestUploadProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * AIReceiptPanel — the portal "attach a receipt, auto-fill with AI" panel.
+ * Three states drive the whole surface:
+ *
+ *   idle    → dashed "Attach receipt" button
+ *   reading → pulsing sparkle + "Reading your receipt…"
+ *   done    → "Auto-filled from receipt" badge, the file chip, and the
+ *             extracted vendor / amount / date grid (each confirmed ✓)
+ *
+ * It is **controlled**: the consumer owns `state` and supplies `result`
+ * when done. The simulated extraction in the reference is just one driver;
+ * swap in real OCR/AI and the contract is unchanged — flip `state` to
+ * "reading", then to "done" with a `result`.
+ */
+interface AIReceiptResult {
+    vendor: string;
+    amount: string;
+    date: string;
+    file: {
+        name: string;
+        meta?: React.ReactNode;
+    };
+}
+interface AIReceiptPanelProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "results"> {
+    state?: "idle" | "reading" | "done";
+    /** Extracted fields, shown in the `done` state. */
+    result?: AIReceiptResult;
+    /** Fired when the idle attach button is pressed. */
+    onAttach?: () => void;
+    /** Fired when the done-state "Remove" link is pressed. */
+    onRemove?: () => void;
+    /** View action for the file chip (e.g. open the receipt). */
+    onViewFile?: () => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const AIReceiptPanel: React$1.ForwardRefExoticComponent<AIReceiptPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 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>;
+
+/**
+ * AttentionItem — one row in the portal "Needs your attention" feed:
+ * a toned icon tile, a title + supporting line, and a trailing action
+ * (custom node or a default chevron). Group these by service at the call
+ * site; the row itself just renders one item.
+ *
+ * Set `tone` to color the icon tile per service (or use a status tone via
+ * `urgency`). The whole row is a `<button>` when `onClick` is supplied.
+ */
+type AttentionUrgency = "default" | "warning" | "danger";
+interface AttentionItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    icon: React.ReactNode;
+    title: React.ReactNode;
+    description?: React.ReactNode;
+    /** Service tone for the icon tile (used when `urgency` is "default"). */
+    tone?: ServiceTone;
+    /** Status urgency — overrides the service tone for the tile. */
+    urgency?: AttentionUrgency;
+    /** Trailing slot; defaults to a chevron when the row is interactive. */
+    action?: React.ReactNode;
+    onClick?: () => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const AttentionItem: React$1.ForwardRefExoticComponent<AttentionItemProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * BottomNav — mobile tab bar for the client portal (desktop uses the
+ * sidebar instead). Fixed to the viewport bottom with safe-area padding;
+ * each tab is an icon + short label with an optional count/dot badge.
+ *
+ * Controlled via `value` + `onChange`. Keep it to 3–5 tabs — beyond that,
+ * labels truncate and the row gets cramped on a 390px screen.
+ */
+interface BottomNavTab {
+    id: string;
+    label: string;
+    icon: React.ReactNode;
+    /** Numeric badge; `true` renders a dot. */
+    badge?: number | boolean;
+}
+interface BottomNavProps extends Omit<React.HTMLAttributes<HTMLElement>, "onChange"> {
+    tabs: BottomNavTab[];
+    value: string;
+    onChange: (id: string) => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: DS — name released (docs/ownership/investigate.md, row 8); Portal's
+ * mobile nav moves to the Sidebar mobile mode (W7-04). Never removed before 3.0.
+ */
+declare const BottomNav: React$1.ForwardRefExoticComponent<BottomNavProps & React$1.RefAttributes<HTMLElement>>;
+
+/**
+ * DashGrid — drag-to-reorder widget grid for the firm dashboard. Each
+ * widget gets a 6-dot grab handle; dragging it over another widget moves
+ * it to that slot. The flat order is the source of truth; widgets flow
+ * row-major into a responsive CSS grid.
+ *
+ * Order is uncontrolled by default. Pass `storageKey` to persist it to
+ * `localStorage` — the initial order is read **once** in a lazy
+ * `useState` initializer (SSR-safe: no read on the server), and the grid
+ * carries `suppressHydrationWarning` because a persisted client order will
+ * legitimately differ from the server's default order on first paint.
+ * `onReorder` fires with the new id order on every move.
+ */
+interface DashWidget {
+    id: string;
+    content: React.ReactNode;
+    /** Column span on the lg grid (1–3). Default 1. */
+    span?: 1 | 2 | 3;
+}
+interface DashGridProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onReorder"> {
+    widgets: DashWidget[];
+    /** Persist order under this `localStorage` key. Omit to disable persistence. */
+    storageKey?: string;
+    onReorder?: (orderedIds: string[]) => void;
+    /** Max columns on large screens. Default 3. */
+    columns?: 2 | 3 | 4;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DashGrid: React$1.ForwardRefExoticComponent<DashGridProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface EngagementCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Service name, e.g. "Tax". */
+    service: string;
+    /** Service glyph (an icon node). */
+    serviceIcon?: React.ReactNode;
+    tone?: ServiceTone;
+    title: string;
+    /** Status node (typically a <StatusPill> or plain label). */
+    status?: React.ReactNode;
+    /** Current step index (1-based) and total. */
+    current: number;
+    steps: number;
+    /** Name of the current step, shown in the caption. */
+    stepLabel?: string;
+    /** Footer ETA content, e.g. "Est. completion Mar 14" or "Recurring engagement". */
+    eta?: React.ReactNode;
+    /** Show a ProgressRing instead of segments + percent. */
+    ring?: boolean;
+    onOpen?: () => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PORTAL client portal (PRO workflow keeps one too), which decides to
+ * adopt, contribute or release the name. Never removed before 3.0.
+ */
+declare const EngagementCard: React$1.ForwardRefExoticComponent<EngagementCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * EngagementTimeline — vertical stepper for an engagement's lifecycle.
+ * Each step is a node + connector rail on the left and a body on the right.
+ *
+ *   done   → filled success node with a check + "Completed {date}" line
+ *   active → toned ring node + "In progress" badge + inline actions
+ *   todo   → muted node + "Upcoming" badge
+ *
+ * The active node + badge read the service `--tone` set once on the
+ * container (see `serviceToneStyle`). Compose with `<EngagementTimelineStep>`
+ * children, mirroring the `<ActivityList>` / `<ActivityItem>` split.
+ */
+type TimelineState = "done" | "active" | "todo";
+interface EngagementTimelineProps extends React.HTMLAttributes<HTMLOListElement> {
+    /** Service tone for active nodes. */
+    tone?: ServiceTone;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PORTAL client portal (PRO documents keeps one too), which decides to
+ * adopt, contribute or release the name. Never removed before 3.0.
+ */
+declare const EngagementTimeline: React$1.ForwardRefExoticComponent<EngagementTimelineProps & React$1.RefAttributes<HTMLOListElement>>;
+interface EngagementTimelineStepProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    state: TimelineState;
+    /** Step name. */
+    name: React.ReactNode;
+    /** 1-based index shown inside todo/active nodes. */
+    index: number;
+    /** Supporting copy under the name. */
+    note?: React.ReactNode;
+    /** Completion date, shown for `done` steps. */
+    date?: React.ReactNode;
+    /** Inline action row, shown for `active` steps. */
+    actions?: React.ReactNode;
+    /** Hide the connector below the node (last step). */
+    last?: boolean;
+}
+declare const EngagementTimelineStep: React$1.ForwardRefExoticComponent<EngagementTimelineStepProps & React$1.RefAttributes<HTMLLIElement>>;
+
+/**
+ * ClientRailItem — a client row in the firm Documents left rail.
+ *
+ * Renders as a full-width, left-aligned `<button>`. Displays the client
+ * avatar, name, an optional pending-documents indicator (purple dot +
+ * "N pending" label), a file-count chip, and a meta suffix (e.g. a relative
+ * timestamp).
+ *
+ * Active state highlights the row with `bg-brand-bg` and a 3 px left accent
+ * bar in the active brand colour. Hover (when not active) applies `bg-surface-2`.
+ *
+ * Spread standard `<button>` attributes (including `onClick`) directly.
+ */
+interface ClientRailItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Client or entity display name. */
+    name: string;
+    /** Optional avatar image URL — forwarded to the DS Avatar `src` prop. */
+    avatarSrc?: string;
+    /** Entity kind label, e.g. "Individual" or "Business". */
+    entityType: string;
+    /** Number of pending document requests; 0 / undefined → no pending badge. */
+    pendingCount?: number;
+    /** Total file count shown in the name-row chip. Omit to hide the chip. */
+    fileCount?: number;
+    /** Trailing meta node — typically a relative-time string like "2h ago". */
+    metaSuffix?: React.ReactNode;
+    /** Whether this row is the currently-selected client in the rail. */
+    active?: boolean;
+}
+declare const ClientRailItem: React$1.ForwardRefExoticComponent<ClientRailItemProps & React$1.RefAttributes<HTMLButtonElement>>;
+/**
+ * ClientRailGroupHeader — section label row for the Documents left rail.
+ *
+ * When `accent` is true a 7 px pro-tone dot precedes the label and the text
+ * is coloured in the active brand colour — signals that the group contains clients with
+ * pending document requests. An optional `count` is appended as " · N".
+ */
+interface ClientRailGroupHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Group label text, e.g. "Awaiting documents" or "All clients". */
+    label: string;
+    /** Optional count appended as " · N" after the label. */
+    count?: number;
+    /**
+     * When true, renders a purple StatusDot before the label and colours the
+     * label in `text-brand` (the active brand colour). Use for "Awaiting documents" groups.
+     */
+    accent?: boolean;
+}
+declare const ClientRailGroupHeader: React$1.ForwardRefExoticComponent<ClientRailGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface DocumentFileRowProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    name: string;
+    fileType: string;
+    size?: string;
+    date?: string;
+    by?: string;
+    status?: React$1.ReactNode;
+    nameAdornment?: React$1.ReactNode;
+    menu?: React$1.ReactNode;
+    selected?: boolean;
+    showCheckbox?: boolean;
+    onSelectedChange?: (checked: boolean) => void;
+    onOpen?: () => void;
+}
+type DocumentFileCardProps = DocumentFileRowProps;
+declare const DocumentFileRow: React$1.ForwardRefExoticComponent<DocumentFileRowProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DocumentFileCard: React$1.ForwardRefExoticComponent<DocumentFileRowProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const lineCaptionToneClass: {
+    readonly muted: "ds:text-fg-4";
+    readonly warning: "ds:text-warning-fg";
+    readonly danger: "ds:text-danger-fg";
+};
+interface DocumentFileLineProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** The file's own name. */
+    name: string;
+    /** Drives the leading glyph colour ("pdf", "image/png", "xlsx", …). */
+    fileType?: string;
+    /** Small chip at the trailing edge — e.g. the classified document type. */
+    typeLabel?: React$1.ReactNode;
+    /** One muted status line under the name — e.g. "Categorizing…". */
+    caption?: React$1.ReactNode;
+    /** Colour tone for the caption. */
+    captionTone?: keyof typeof lineCaptionToneClass;
+    /** When set, a preview (eye) button is shown that calls this. */
+    onOpen?: () => void;
+    /** Accessible label for the preview button (defaults to `Preview {name}`). */
+    previewLabel?: string;
+}
+/**
+ * DocumentFileLine — a compact single-line file row for DENSE inline lists:
+ * the files collected under a checklist item, a "still sorting" group, or an
+ * "also received" list. Unlike {@link DocumentFileRow} it carries no checkbox,
+ * kebab menu, or size/date/by meta — just a file glyph, name, an optional type
+ * chip + caption, and an optional preview (eye) action. Purpose-built for
+ * {@link DocumentChecklist}; reach for `DocumentFileRow` when you need
+ * selection, a menu, or file metadata.
+ */
+declare const DocumentFileLine: React$1.ForwardRefExoticComponent<DocumentFileLineProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * A checklist item's lifecycle, from the client's point of view:
+ *   awaiting        — expected, nothing uploaded yet
+ *   in-review       — a file arrived and is being categorized / verified
+ *   received        — the document is in
+ *   complete        — in and finalized
+ *   not-applicable  — the client marked it as not-needed
+ */
+type DocumentChecklistStatus = "awaiting" | "in-review" | "received" | "complete" | "not-applicable";
+/** A single collected file rendered under an item (or in the sorting/extra lists). */
+interface DocumentChecklistFile extends Pick<DocumentFileLineProps, "name" | "fileType" | "typeLabel" | "caption" | "captionTone" | "onOpen"> {
+    id: string;
+}
+/** One expected document type on the checklist. */
+interface DocumentChecklistItem {
+    id: string;
+    /** Plain-English label the client reads (e.g. "W-2"). */
+    label: string;
+    status: DocumentChecklistStatus;
+    /** Files classified into this slot (0..N). */
+    files?: DocumentChecklistFile[];
+    /**
+     * Rendered under an awaiting row — the "I can't provide this" control (a
+     * caller-owned Select of missing-reason options). Kept as a slot so the
+     * composite stays presentational and product-agnostic.
+     */
+    action?: React$1.ReactNode;
+}
+interface DocumentChecklistProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
+    items: DocumentChecklistItem[];
+    /** Section heading. */
+    title?: string;
+    /** Roll-up shown as a count + bar. Omit to hide the progress header. */
+    progress?: {
+        received: number;
+        total: number;
+        percent: number;
+    };
+    /** The upload dropzone, rendered at the very top of the single column. */
+    upload?: React$1.ReactNode;
+    /** Files still being sorted (not yet placed on a slot). */
+    reviewing?: DocumentChecklistFile[];
+    /** Recognized files that aren't on the checklist. */
+    extra?: DocumentChecklistFile[];
+    reviewingLabel?: string;
+    extraLabel?: string;
+    /** Rendered when there are no items at all. */
+    emptyState?: React$1.ReactNode;
+}
+/**
+ * DocumentChecklist — the client's single-column "your documents" experience.
+ *
+ * One scannable list: an upload dropzone on top, a progress roll-up, then every
+ * expected document as a row that moves through Awaiting → Reviewing → Received
+ * in place (state lives on the row, never in a separate bucket). Files still
+ * being sorted surface in a compact "we're sorting these" group, and recognized
+ * files that aren't on the checklist fall under an "also received" divider — so
+ * nothing an upload produced is ever hidden, and there is exactly one place to
+ * look.
+ *
+ * Fully controlled and presentational: the caller supplies `items`, `progress`,
+ * and slots (`upload`, per-row `action`, per-file `onOpen`). It consumes only
+ * semantic tokens, so `data-brand` retints it per product automatically.
+ *
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PORTAL client portal, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentChecklist: React$1.ForwardRefExoticComponent<DocumentChecklistProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * DocumentRequestField — one numbered "document N" card inside the Request
+ * Documents modal. Renders a header badge, an optional remove button, and a
+ * three-field grid: document-type slot (caller-supplied), a required label
+ * input, and an optional note input.
+ *
+ * Props:
+ *  - `index`         — zero-based position; badge shows `index + 1`.
+ *  - `typeControl`   — ReactNode rendered in the Type field slot (pass a
+ *                      select, combobox, or disabled placeholder).
+ *  - `label`         — controlled value for the Label input.
+ *  - `onLabelChange` — called with the new string on every keystroke.
+ *  - `note`          — controlled value for the Note input.
+ *  - `onNoteChange`  — called with the new string on every keystroke.
+ *  - `onRemove`      — when provided (and `canRemove` is true) a remove
+ *                      button appears in the header row.
+ *  - `canRemove`     — guards `onRemove`; set false when only one field
+ *                      remains so the user cannot delete the last entry.
+ */
+interface DocumentRequestFieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Zero-based index; displayed as `index + 1` in the badge and aria-labels. */
+    index: number;
+    /** Slot for the document-type control (select, combobox, disabled input, etc.). */
+    typeControl: React.ReactNode;
+    /** Controlled value for the Label field. */
+    label: string;
+    /** Called with the updated string whenever the Label input changes. */
+    onLabelChange: (value: string) => void;
+    /** Controlled value for the Note field. */
+    note: string;
+    /** Called with the updated string whenever the Note input changes. */
+    onNoteChange: (value: string) => void;
+    /** Callback to remove this card from the list. Only rendered when `canRemove` is also true. */
+    onRemove?: () => void;
+    /** Whether removal is permitted (e.g. false when this is the last card). */
+    canRemove?: boolean;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO documents, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentRequestField: React$1.ForwardRefExoticComponent<DocumentRequestFieldProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * MissingDocumentsPanel — an AI insight card that surfaces documents still
+ * expected from a client within an engagement.
+ *
+ * Items carry one of three states that map to a `<StatusPill>` semantic:
+ *   missing  → "Requested"  (warning)
+ *   pending  → "Pending"    (secondary)
+ *   received → "Received"   (success)
+ *
+ * When no items remain, the panel renders a compact "All documents received"
+ * success line instead of an empty list.
+ *
+ * Pass `onRequest` to show a "Request missing" footer button. The panel is
+ * fully controlled — it renders whatever `items` you supply.
+ */
+type DocumentItemState = "missing" | "pending" | "received";
+interface MissingDocumentItem {
+    /** Document label shown in the row. */
+    label: string;
+    /** Optional due / expected date string (e.g. "Due Jun 20"). */
+    dueDate?: string;
+    /** Current fulfilment state for this document. */
+    state: DocumentItemState;
+}
+interface MissingDocumentsPanelProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** List of expected documents and their current states. */
+    items: MissingDocumentItem[];
+    /** Subtitle below the panel title. */
+    subtitle?: string;
+    /** When provided a "Request missing" button is rendered in the footer. */
+    onRequest?: () => void;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO documents, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const MissingDocumentsPanel: React$1.ForwardRefExoticComponent<MissingDocumentsPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * NewMenu — the TopBar "+ New" create dropdown. A primary button opens a
+ * menu of create actions, optionally split into labelled groups (e.g.
+ * "Work" vs "People"). Thin composition over the DropdownMenu primitive;
+ * the surface, focus, and portal behavior all come from there.
+ */
+interface NewMenuAction {
+    id: string;
+    label: React.ReactNode;
+    /** Supporting line under the label. */
+    description?: React.ReactNode;
+    icon?: React.ReactNode;
+    /** Keyboard hint, right-aligned (display only). */
+    shortcut?: string;
+    onSelect?: () => void;
+}
+interface NewMenuGroup {
+    label?: React.ReactNode;
+    actions: NewMenuAction[];
+}
+interface NewMenuProps {
+    /** Flat action list. Use `groups` instead for labelled sections. */
+    actions?: NewMenuAction[];
+    groups?: NewMenuGroup[];
+    /** Trigger label. Default "New". */
+    triggerLabel?: React.ReactNode;
+    /** Override the trigger entirely (still opens the menu). */
+    trigger?: React.ReactNode;
+    align?: "start" | "center" | "end";
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const NewMenu: React$1.ForwardRefExoticComponent<NewMenuProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+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";
+    /** 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;
+    /** 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, 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;
+    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;
+}): 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;
+
+/**
+ * DocumentRequestCard + DocumentRequestDetail — the firm "Requests" surface.
+ *
+ * Both are presentational: the app owns data fetching, tab/preview state, and
+ * every action handler, and passes plain data + callbacks. They wrap the
+ * `DocumentDetail*` kit, the icon set, the tab primitives, and the assignee
+ * dropdown so a consuming app imports two components instead of ~40 parts.
+ */
+type DocumentRequestTone = "warning" | "success" | "danger" | "muted";
+interface DocumentRequestItemSummary {
+    /** Stable id for the row key. */
+    id: string;
+    /** Requested-document label, e.g. "AR aging (12/31/2025)". */
+    label: string;
+    /** Short type chip, e.g. "Schedule". */
+    docType?: string;
+    /** Status text, e.g. "Received". */
+    statusLabel: string;
+    /** Status colour. */
+    statusTone: DocumentRequestTone;
+}
+interface DocumentRequestCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onClick" | "title"> {
+    /** Request headline. */
+    title: string;
+    /** Free-form category chip. */
+    category?: string;
+    /** Renders the urgent triangle when true. */
+    highPriority?: boolean;
+    /** Relative due chip + tone, e.g. `{ text: "Due in 6d", tone: "warning" }`. */
+    due?: {
+        text: string;
+        tone: DocumentRequestTone;
+    };
+    /** Optional request description rendered as a quote. */
+    comment?: string;
+    /** Fulfilled item count (numerator of the progress pill). */
+    fulfilledCount: number;
+    /** Total item count (denominator of the progress pill). */
+    totalCount: number;
+    /** Requested items rendered as rows. */
+    items: DocumentRequestItemSummary[];
+    /** Assignee display names for the footer avatar stack. */
+    assignees?: string[];
+    /** Open the request detail. */
+    onOpen: () => void;
+}
+declare const DocumentRequestCard: React$1.ForwardRefExoticComponent<DocumentRequestCardProps & React$1.RefAttributes<HTMLDivElement>>;
+type DocumentRequestDetailTab = "documents" | "comments" | "activity";
+type DocumentRequestActivityKind = "assigned" | "unassigned" | "added" | "uploaded" | "priority" | "created" | "reminded" | "updated" | "commented" | "cancelled" | "received" | "approved" | "needs_revision" | "locked" | "unlocked" | "status";
+interface DocumentRequestDetailDoc {
+    /** Stable id for the row key. */
+    id: string;
+    /** File name shown as the row's primary line. */
+    fileName: string;
+    /** Secondary meta line (size · date · uploader). */
+    meta?: React.ReactNode;
+    /** Highlight the row (e.g. its preview is open). */
+    active?: boolean;
+    /** Firm review verdict — `true` renders the row in its approved state
+     *  (green icon + "Approved" tag) and hides the approve action. */
+    approved?: boolean;
+    /** Firm review verdict — `true` renders the row in its rejected state
+     *  (red icon + "Rejected" tag). Ignored when `approved` is set. */
+    rejected?: boolean;
+    /** Approve this document. Renders a tick action before Preview while the
+     *  doc is not yet approved; omit to hide the affordance. */
+    onApprove?: () => void;
+    onPreview?: () => void;
+    onDownload?: () => void;
+    onDelete?: () => void;
+}
+interface DocumentRequestRequestedItem {
+    /** Stable id for the row key. */
+    id: string;
+    /** Requested-document label, e.g. "AR aging (12/31/2025)". */
+    label: string;
+    /** Short type chip, e.g. "Schedule". */
+    docType?: string;
+    /** Status text, e.g. "Received". */
+    statusLabel: string;
+    /** Status colour (drives the dot + label). */
+    statusTone: DocumentRequestTone;
+    /** Client upload(s) fulfilling this item; empty means still awaiting. */
+    documents: DocumentRequestDetailDoc[];
+}
+interface DocumentRequestDetailComment {
+    /** Stable id for the row key. */
+    id: string;
+    /** Author display name. */
+    author: string;
+    /** True for a firm author (vs a client contact) — drives the badge. */
+    isFirm: boolean;
+    /** Render a "(You)" suffix for the current user. */
+    you?: boolean;
+    /** Relative time. */
+    time: string;
+    /** Comment body. */
+    body: string;
+}
+interface DocumentRequestDetailActivityEvent {
+    /** Stable id for the row key. */
+    id: string;
+    /** Event kind — selects the leading icon. */
+    kind: DocumentRequestActivityKind;
+    /** Rendered event text (may include bolded names). */
+    text: React.ReactNode;
+    /** Relative time. */
+    time: string;
+}
+interface DocumentRequestAssigneeOption {
+    /** Firm-user id. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Whether currently assigned. */
+    selected: boolean;
+}
+interface DocumentRequestReviewStatusOption {
+    /** Stored value (e.g. "provided"). */
+    value: string;
+    /** Human label (e.g. "Provided"). */
+    label: string;
+    /** Tailwind background class for the leading status dot (e.g. "bg-info-fg"). */
+    color?: string;
+}
+interface DocumentRequestDetailProps {
+    /** Request headline. */
+    title: string;
+    /** Category chip (left of the header bar). */
+    category?: string;
+    /** Renders a "High priority" chip. */
+    highPriority?: boolean;
+    /** Status pill text, right-aligned. */
+    statusLabel?: string;
+    /** Status pill colour. */
+    statusVariant?: BadgeProps["variant"];
+    /** Requester block. */
+    requester: {
+        org: string;
+        avatar?: string;
+        requestedBy: string;
+        time: string;
+    };
+    /** Due chip text + absolute date. */
+    due?: {
+        text: string;
+        dateLabel?: string;
+    };
+    /** Assignee options for the picker; `selected` marks the current set. */
+    assignees: DocumentRequestAssigneeOption[];
+    /** Toggle one assignee (omit to render the avatar stack read-only). */
+    onToggleAssignee?: (id: string) => void;
+    /** Show the Edit / Lock / Status / Delete action row (firm only). */
+    canEdit?: boolean;
+    onEdit?: () => void;
+    onDelete?: () => void;
+    onClose?: () => void;
+    /** Whether the request is frozen (drives the Lock/Unlock button label + icon). */
+    isLocked?: boolean;
+    /** Toggle the lock (omit to hide the Lock button). */
+    onToggleLock?: () => void;
+    /** The firm's current review verdict (radio-selected in the Status menu). */
+    reviewStatus?: string | null;
+    /** Selectable review-status options for the Status menu. */
+    reviewStatusOptions?: DocumentRequestReviewStatusOption[];
+    /** Set the review verdict, or `null` to clear it (omit to hide the Status button). */
+    onSetReviewStatus?: (value: string | null) => void;
+    /** Controlled active tab. */
+    tab?: DocumentRequestDetailTab;
+    /** Uncontrolled initial tab (defaults to "documents"). */
+    defaultTab?: DocumentRequestDetailTab;
+    onTabChange?: (tab: DocumentRequestDetailTab) => void;
+    /** Documents tab — flat client-uploaded vault docs. Used only as a fallback
+     * when `requestedItems` is omitted. */
+    clientUploads?: DocumentRequestDetailDoc[];
+    /** Documents tab — firm reference documents. */
+    firmDocuments: DocumentRequestDetailDoc[];
+    /** Documents tab — requested items with the client upload(s) fulfilling each.
+     * When provided, the tab renders a per-item grouped view (each requested
+     * document, its status, and the uploads against it) instead of the flat
+     * client-uploads list. */
+    requestedItems?: DocumentRequestRequestedItem[];
+    /** Client uploads not tied to any current item — rendered as a trailing
+     * "Other uploads" group in the grouped view. */
+    otherUploads?: DocumentRequestDetailDoc[];
+    /** Upload affordance for the firm-documents section (omit to hide). */
+    onUploadFirmDocument?: () => void;
+    /** Comments tab thread. */
+    comments: DocumentRequestDetailComment[];
+    /** Controlled composer value. */
+    commentDraft: string;
+    onCommentDraftChange: (value: string) => void;
+    onSubmitComment: () => void;
+    /** Disable the composer (e.g. lacking permission). */
+    commentDisabled?: boolean;
+    /** In-flight comment submit. */
+    commentPending?: boolean;
+    /** Activity tab events, newest-first as desired by the caller. */
+    activity: DocumentRequestDetailActivityEvent[];
+    className?: string;
+}
+declare const DocumentRequestDetail: React$1.ForwardRefExoticComponent<DocumentRequestDetailProps & React$1.RefAttributes<HTMLElement>>;
+
+/**
+ * DocumentSourceFilter — segmented single-select for a files toolbar: scope the
+ * list to a provenance bucket. Wraps ToggleGroup (so it inherits roving-focus
+ * keyboard nav + the pro-tint active state) and reuses the same `source` →
+ * glyph mapping as DocumentSourceTag, plus an "all" aggregate segment.
+ *
+ *   all       → (no glyph)   every document
+ *   requested → send glyph   client fulfilled a firm request
+ *   direct    → upload glyph  client uploaded unprompted
+ *   internal  → shield glyph  firm-prepared, not client-visible
+ *
+ * Controlled: pass `value` + `onValueChange`. `counts` adds a trailing badge per
+ * segment; `hideIcons` renders label-only segments.
+ */
+type DocumentSourceFilterValue = "all" | DocumentSource;
+interface DocumentSourceFilterProps {
+    /** Currently active segment. */
+    value: DocumentSourceFilterValue;
+    /** Fired when a segment is chosen (re-selecting the active one is ignored). */
+    onValueChange: (value: DocumentSourceFilterValue) => void;
+    /** Per-segment item counts, rendered as a trailing badge. */
+    counts?: Partial<Record<DocumentSourceFilterValue, number>>;
+    /** Render label-only segments, with no leading glyph. */
+    hideIcons?: boolean;
+    className?: string;
+    /** Accessible name for the group. */
+    "aria-label"?: string;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO documents, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare const DocumentSourceFilter: React$1.ForwardRefExoticComponent<DocumentSourceFilterProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/** Running-clock format from milliseconds → `H:MM:SS`. */
+declare function formatClock(ms: number): string;
+/** Compact duration from seconds → `Xh Ym` (e.g. `2h 10m`, `45m`, `3h`). */
+declare function formatDuration(totalSeconds: number): string;
+/** Parse human input (`3h 20m`, `1:30`, `45m`, bare `90` → minutes) → seconds, or `null`. */
+declare function parseDuration(input: string): number | null;
+/** Currency format used by the billing rows; falls back to `$0.00` for bad ISO codes. */
+declare function formatCurrency(amount: number, currency?: string): string;
+type TimeLoggerPhase = "idle" | "running" | "paused" | "stopped";
+interface UseStopwatchReturn {
+    phase: TimeLoggerPhase;
+    elapsedMs: number;
+    isRunning: boolean;
+    /** Begin running, optionally seeded with an offset (e.g. a parsed manual entry). */
+    start: (fromMs?: number) => void;
+    pause: () => void;
+    resume: () => void;
+    /** Freeze and mark complete; elapsed is preserved for saving. */
+    stop: () => void;
+    /** Return to idle at zero. */
+    reset: () => void;
+}
+declare function useStopwatch(): UseStopwatchReturn;
+interface TimeLoggerProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Layout direction.
+     *   - `"vertical"` (default) — the stacked panel; rows separated by top
+     *     rules. For popovers and side panels.
+     *   - `"horizontal"` — a single compact bar; segments sit side by side,
+     *     separated by left rules. For an app top/bottom bar. Exposed as
+     *     `data-orientation` so segment atoms flip their divider via
+     *     `group-data-[orientation=horizontal]/timelogger`.
+     */
+    orientation?: "vertical" | "horizontal";
+}
+declare const TimeLogger: React$1.ForwardRefExoticComponent<TimeLoggerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: React$1.ReactNode;
+    icon?: React$1.ReactNode;
+    /** Minutes logged today. With `goalMinutes`, renders the `Xh / Yh` figure + seam. */
+    loggedMinutes?: number;
+    /** Daily goal in minutes. Omit to hide the goal figure and the progress seam. */
+    goalMinutes?: number;
+}
+declare const TimeLoggerHeader: React$1.ForwardRefExoticComponent<TimeLoggerHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerContextRowProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
+    client: React$1.ReactNode;
+    engagement?: React$1.ReactNode;
+    /** Leading slot, e.g. an `<Avatar variant="branded" />`. */
+    avatar?: React$1.ReactNode;
+    onClientSelect?: () => void;
+    /** Right-aligned slot — an assignee avatar + menu, or a `<TeamMemberSelect>`. */
+    member?: React$1.ReactNode;
+}
+declare const TimeLoggerContextRow: React$1.ForwardRefExoticComponent<TimeLoggerContextRowProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerTimerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    phase: TimeLoggerPhase;
+    elapsedMs: number;
+    /** Manual-entry text, shown only while idle. Controlled. */
+    value?: string;
+    onValueChange?: (value: string) => void;
+    placeholder?: string;
+    onStart?: () => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    onStop?: () => void;
+}
+declare const TimeLoggerTimer: React$1.ForwardRefExoticComponent<TimeLoggerTimerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerFieldProps extends Omit<React$1.HTMLAttributes<HTMLElement>, "onSelect"> {
+    icon?: React$1.ReactNode;
+    /** Small caption above the value. */
+    label?: React$1.ReactNode;
+    onSelect?: () => void;
+    /** Trailing node; defaults to a chevron when interactive. Pass `null` to suppress. */
+    trailing?: React$1.ReactNode;
+    /** Render the value in the muted placeholder colour. */
+    muted?: boolean;
+}
+declare const TimeLoggerField: React$1.ForwardRefExoticComponent<TimeLoggerFieldProps & React$1.RefAttributes<HTMLElement>>;
+interface TimeLoggerNotesProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange"> {
+    value?: string;
+    onValueChange?: (value: string) => void;
+    icon?: React$1.ReactNode;
+}
+declare const TimeLoggerNotes: React$1.ForwardRefExoticComponent<TimeLoggerNotesProps & React$1.RefAttributes<HTMLInputElement>>;
+interface TimeLoggerTier {
+    id: string;
+    name: React$1.ReactNode;
+    /** Hourly rate in the panel currency; shown in the tier menu's right column. */
+    rate: number;
+}
+interface TimeLoggerBillableProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    billable: boolean;
+    onBillableChange?: (billable: boolean) => void;
+    /** Defaults to "Billable" / "Non-billable" derived from `billable`. */
+    label?: React$1.ReactNode;
+    /** Pricing tiers shown in the settings pop-view. Omit to hide the gear. */
+    tiers?: TimeLoggerTier[];
+    tierId?: string;
+    onTierChange?: (id: string) => void;
+    /** ISO currency for tier-rate formatting. Default `"USD"`. */
+    currency?: string;
+    /** Computed amount readout (rate × time). Pass a formatted node, or omit. */
+    amount?: React$1.ReactNode;
+}
+declare const TimeLoggerBillable: React$1.ForwardRefExoticComponent<TimeLoggerBillableProps & React$1.RefAttributes<HTMLDivElement>>;
+type TimeLoggerActionsProps = React$1.HTMLAttributes<HTMLDivElement>;
+declare const TimeLoggerActions: React$1.ForwardRefExoticComponent<TimeLoggerActionsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerEntryListProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Day group caption, e.g. "Fri, May 29". */
+    dayLabel?: React$1.ReactNode;
+    /** Right-aligned day subtotal, e.g. "2h 10m". */
+    total?: React$1.ReactNode;
+}
+declare const TimeLoggerEntryList: React$1.ForwardRefExoticComponent<TimeLoggerEntryListProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimeLoggerEntryProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
+    title: React$1.ReactNode;
+    /** Secondary line — time range, billable amount, etc. */
+    meta?: React$1.ReactNode;
+    duration: React$1.ReactNode;
+    onResume?: () => void;
+    onDelete?: () => void;
+}
+declare const TimeLoggerEntry: React$1.ForwardRefExoticComponent<TimeLoggerEntryProps & React$1.RefAttributes<HTMLDivElement>>;
+type TimeLoggerFooterProps = React$1.HTMLAttributes<HTMLDivElement>;
+declare const TimeLoggerFooter: React$1.ForwardRefExoticComponent<TimeLoggerFooterProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * SuggestionPills — a horizontal strip of AI quick-reply pills, typically
+ * floated above a message composer when the last inbound message warrants a
+ * fast response.
+ *
+ * The pills materialise with a staggered "magic smoke" entrance (the bar
+ * rises, the sparkle pulses, each pill puffs in) driven by the shipped
+ * `.ds-suggestion-*` classes — motion is suppressed under
+ * `prefers-reduced-motion`. Presentational and controlled: the consumer
+ * supplies the suggestion strings and a pick handler.
+ *
+ *   <SuggestionPills
+ *     suggestions={["Sounds good — thanks!", "Could you send the W-2?"]}
+ *     onPick={(text) => editor.insert(text)}
+ *     loading={generating}
+ *   />
+ *
+ * Returns `null` when not loading and there are no suggestions, so it can be
+ * rendered unconditionally.
+ *
+ * @since 1.5.0
+ */
+interface SuggestionPillsProps {
+    /** Suggestion strings to render as pills. */
+    suggestions: string[];
+    /** Fired with the picked suggestion text. */
+    onPick: (text: string) => void;
+    /** Show skeleton pills while suggestions are being generated. */
+    loading?: boolean;
+    /** Strip label. Default: `"Smart replies"`. */
+    label?: string;
+    /** Extra classes on the bar. */
+    className?: string;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function SuggestionPills({ suggestions, onPick, loading, label, className, }: SuggestionPillsProps): react_jsx_runtime.JSX.Element | null;
+declare namespace SuggestionPills {
+    var displayName: string;
+}
+
+/**
+ * AiDraftCard — the "lit-from-within" slab that presents an AI-generated
+ * message draft inside a composer.
+ *
+ * It owns four visual states behind one prop:
+ *   - `loading` / `refining` — a sparkle + shimmer skeleton over the flowing
+ *     neon `.ds-ai-surface`.
+ *   - `error` — a quiet destructive panel with an optional Retry and a
+ *     Dismiss.
+ *   - `ready` — the collapsible draft: header (sparkle, "AI Draft",
+ *     optional context line, collapse toggle), an optional subject line, the
+ *     draft `children`, and a footer `actions` slot.
+ *
+ * Presentational only — the consumer supplies the draft text as `children`
+ * and the action buttons (Insert / Regenerate / Shorter / …) as `actions`.
+ * The card re-expands automatically whenever fresh `children` arrive (keyed
+ * off `resetCollapseKey`) so a refined draft is never hidden behind a stale
+ * collapsed state.
+ *
+ *   <AiDraftCard
+ *     state="ready"
+ *     contextLine="Replying to Jane"
+ *     subject="Re: Your 2024 return"
+ *     resetCollapseKey={draftText}
+ *     actions={<><Button size="sm">Insert</Button>…</>}
+ *   >
+ *     <p className="whitespace-pre-wrap">{draftText}</p>
+ *   </AiDraftCard>
+ *
+ * @since 1.5.0
+ */
+type AiDraftState = "loading" | "refining" | "error" | "ready";
+interface AiDraftCardProps {
+    /** Which visual state to render. */
+    state: AiDraftState;
+    /** Header title. Default: `"AI Draft"`. */
+    title?: string;
+    /** Optional muted context line in the header (e.g. "Replying to Jane"). */
+    contextLine?: ReactNode;
+    /** Optional bold subject line shown above the body (email drafts). */
+    subject?: ReactNode;
+    /** The draft body — typically a `<p className="whitespace-pre-wrap">`. */
+    children?: ReactNode;
+    /** Footer action buttons (Insert / Regenerate / Discard …). */
+    actions?: ReactNode;
+    /** Error message — shown when `state="error"`. */
+    error?: ReactNode;
+    /** Retry handler — adds a Retry button to the error panel. */
+    onRetry?: () => void;
+    /** Dismiss handler for the error panel. */
+    onDismiss?: () => void;
+    /** Re-expands the card whenever this value changes (pass the draft text so
+     * a freshly generated/refined draft is always revealed). */
+    resetCollapseKey?: unknown;
+    className?: string;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function AiDraftCard({ state, title, contextLine, subject, children, actions, error, onRetry, onDismiss, resetCollapseKey, className, }: AiDraftCardProps): react_jsx_runtime.JSX.Element;
+declare namespace AiDraftCard {
+    var displayName: string;
+}
+
+/**
+ * EmailMessageCard — renders an email message as an envelope-style card
+ * (header strip / readable body / footer) inside a conversation thread,
+ * replacing the "rich HTML stuffed into a chat bubble" anti-pattern.
+ *
+ * Anatomy:
+ *   - a meta line ("Name via Email · 3:42 PM") above the card,
+ *   - a tinted header strip with a mail glyph, the "EMAIL" eyebrow, the
+ *     subject, a "From …" / optional "Cc N" sub-line, and the time,
+ *   - a readable body (`children`) that auto-clamps past `clampHeight` with a
+ *     gradient fade and a "Show full email" toggle,
+ *   - an optional footer carrying `attachments`, a `status` slot, and
+ *     `actions` (e.g. a Reply button).
+ *
+ * Presentational only. The consumer sanitises and renders the email HTML as
+ * `children`, supplies the avatar, and brings its own attachment chips /
+ * status indicator / Reply control via slots. Direction flips the layout:
+ * outbound aligns right with a brand-tinted border; inbound aligns left.
+ *
+ *   <EmailMessageCard
+ *     direction="inbound"
+ *     senderName="Jane Cooper"
+ *     subject="Question about my W-2"
+ *     time="3:42 PM"
+ *     avatar={<Avatar name="Jane Cooper" size="xs" />}
+ *     ccCount={2}
+ *     attachments={<AttachmentChip … />}
+ *     actions={<Button size="sm" variant="outline">Reply</Button>}
+ *   >
+ *     <div dangerouslySetInnerHTML={{ __html: safeHtml }} />
+ *   </EmailMessageCard>
+ *
+ * @since 1.5.0
+ */
+interface EmailMessageCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Message direction — flips alignment and border treatment. */
+    direction: "inbound" | "outbound";
+    /** Sender display name. */
+    senderName: string;
+    /** Email subject — omitted for replies without one. */
+    subject?: string;
+    /** Pre-formatted send time (e.g. "3:42 PM"). */
+    time: string;
+    /** Channel label in the meta line. Default: `"Email"`. */
+    via?: string;
+    /** Avatar node — rendered for inbound messages only. */
+    avatar?: ReactNode;
+    /** Cc recipient count — shows a "Cc N" indicator when > 0. */
+    ccCount?: number;
+    /** Sanitised email body (HTML node or plain text). */
+    children: ReactNode;
+    /** Footer attachment chips. */
+    attachments?: ReactNode;
+    /** Footer status slot (delivery state). */
+    status?: ReactNode;
+    /** Footer actions (e.g. Reply). */
+    actions?: ReactNode;
+    /** Body height (px) above which the clamp/expand toggle appears. Default 240. */
+    clampHeight?: number;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function EmailMessageCard({ direction, senderName, subject, time, via, avatar, ccCount, children, attachments, status, actions, clampHeight, className, ...props }: EmailMessageCardProps): react_jsx_runtime.JSX.Element;
+declare namespace EmailMessageCard {
+    var displayName: string;
+}
+
+/**
+ * SignatureEditor — the panel chrome for editing a personal email signature
+ * (rich text, links, and an inline banner image). Designed to live inside a
+ * Popover anchored to a "Pen" affordance in the email composer, but it's just
+ * a self-contained card so it works in a Dialog or settings page too.
+ *
+ * Like `MessageComposer`, DS owns the CHROME and the consumer owns the
+ * EDITOR: pass your rich-text editor (Tiptap, contenteditable, etc.) as
+ * `children`. The panel supplies the titled header with an "Add image"
+ * action, a body region (with a loading skeleton), and a Save / Insert
+ * footer. All actions are slots/handlers — persistence, image upload, and
+ * insertion logic stay with the consumer.
+ *
+ *   <Popover>
+ *     <PopoverContent className="w-96 p-0">
+ *       <SignatureEditor
+ *         loading={loading}
+ *         addingImage={uploading}
+ *         onAddImage={pickImage}
+ *         saving={saving}
+ *         onSave={save}
+ *         onInsert={insert}
+ *       >
+ *         <RichTextEditor ref={editorRef} />
+ *       </SignatureEditor>
+ *     </PopoverContent>
+ *   </Popover>
+ *
+ * @since 1.5.0
+ */
+interface SignatureEditorProps {
+    /** Panel title. Default: `"Email signature"`. */
+    title?: string;
+    /** The editor — a rich-text input the consumer owns. */
+    children: ReactNode;
+    /** Show a loading skeleton in place of the editor (while the saved
+     * signature is being fetched). */
+    loading?: boolean;
+    /** "Add image" handler — hides the button when omitted. */
+    onAddImage?: () => void;
+    /** Spinner + disabled state on the "Add image" button while uploading. */
+    addingImage?: boolean;
+    /** Save handler — hides the Save button when omitted. */
+    onSave?: () => void;
+    /** Spinner + disabled state on Save. */
+    saving?: boolean;
+    /** Insert handler — hides the Insert button when omitted. */
+    onInsert?: () => void;
+    className?: string;
+}
+/**
+ * @deprecated Frozen in `/legacy` (W8-09): no known consumer, no feature work.
+ * Owner: PRO communications, which decides to adopt, contribute or release
+ * the name. Never removed before 3.0.
+ */
+declare function SignatureEditor({ title, children, loading, onAddImage, addingImage, onSave, saving, onInsert, className, }: SignatureEditorProps): react_jsx_runtime.JSX.Element;
+declare namespace SignatureEditor {
+    var displayName: string;
+}
+
+export { type ComboboxSlot as $, type AvatarSlot as A, type BadgeSize as B, type ButtonSlot as C, type DataTableSlot as D, type CardSlot as E, type FileUploadSlot as F, CategoryDivider as G, type CategoryDividerProps as H, type InputSlot as I, CategoryTag as J, type CategoryTagProps as K, type CategoryTone as L, type ChannelTabItem as M, type NumberInputSlot as N, ChannelTabs as O, type PhoneFieldSlot as P, type ChannelTabsProps as Q, type ChannelTone as R, type SearchInputSlot as S, type TextareaSlot as T, type CheckboxSlot as U, type ChipSlot as V, ClientRailGroupHeader as W, type ClientRailGroupHeaderProps as X, ClientRailItem as Y, type ClientRailItemProps as Z, type CodeSlot as _, type SelectSlot as a, type DocumentRequestFieldProps as a$, type CommandSlot as a0, type ContextMenuSlot as a1, Dash as a2, DashGrid as a3, type DashGridProps as a4, type DashWidget as a5, DataTable as a6, DataTableBody as a7, type DataTableBodyProps as a8, DataTableCell as a9, type DataTableViewProps as aA, type DataTableViewSelection as aB, type DataTableViewSort as aC, type DialogSlot as aD, DocumentChecklist as aE, type DocumentChecklistFile as aF, type DocumentChecklistItem as aG, type DocumentChecklistProps as aH, type DocumentChecklistStatus as aI, DocumentFileCard as aJ, type DocumentFileCardProps as aK, DocumentFileLine as aL, type DocumentFileLineProps as aM, DocumentFileRow as aN, type DocumentFileRowProps as aO, type DocumentItemState as aP, type DocumentRequestActivityKind as aQ, type DocumentRequestAssigneeOption as aR, DocumentRequestCard as aS, type DocumentRequestCardProps as aT, DocumentRequestDetail as aU, type DocumentRequestDetailActivityEvent as aV, type DocumentRequestDetailComment as aW, type DocumentRequestDetailDoc as aX, type DocumentRequestDetailProps as aY, type DocumentRequestDetailTab as aZ, DocumentRequestField as a_, DataTableCellDue as aa, type DataTableCellDueProps as ab, DataTableCellId as ac, DataTableCellMono as ad, DataTableCellName as ae, type DataTableCellProps as af, DataTableCheckbox as ag, type DataTableCheckboxProps as ah, DataTableHead as ai, type DataTableHeadProps as aj, DataTableHeader as ak, type DataTableHeaderProps as al, type DataTableProps as am, DataTableResultsCount as an, type DataTableResultsCountProps as ao, DataTableRow as ap, type DataTableRowProps as aq, DataTableSearch as ar, type DataTableSearchProps as as, DataTableSpacer as at, type DataTableSpacerProps as au, DataTableToolbar as av, type DataTableToolbarProps as aw, DataTableView as ax, type DataTableViewColumn as ay, type DataTableViewFilter as az, type BadgeShape as b, type SignatureEditorProps as b$, type DocumentRequestItemSummary as b0, type DocumentRequestRequestedItem as b1, type DocumentRequestReviewStatusOption as b2, type DocumentRequestTone as b3, DocumentRequestUpload as b4, type DocumentRequestUploadFile as b5, type DocumentRequestUploadProps as b6, type DocumentSource as b7, DocumentSourceFilter as b8, type DocumentSourceFilterProps as b9, type KbdSlot as bA, type LabelSlot as bB, type LinkButtonSlot as bC, type MissingDocumentItem as bD, MissingDocumentsPanel as bE, type MissingDocumentsPanelProps as bF, MoneyCell as bG, NewMenu as bH, type NewMenuAction as bI, type NewMenuGroup as bJ, type NewMenuProps as bK, type PaginationSlot as bL, type PillStatus as bM, type PopoverSlot as bN, type PressableSlot as bO, type RadioGroupSlot as bP, SERVICE_TONES as bQ, Section as bR, SectionHead as bS, SectionHeader as bT, type ServiceTone as bU, type SheetSlot as bV, type ShellSlot as bW, type SideDrawerSlot as bX, type SidebarBrandSwitcherSlot as bY, type SidebarSlot as bZ, SignatureEditor as b_, type DocumentSourceFilterValue as ba, DocumentSourceTag as bb, type DocumentSourceTagProps as bc, DocumentsWorkspaceLayout as bd, type DocumentsWorkspaceLayoutProps as be, type DropdownMenuSlot as bf, EmailMessageCard as bg, type EmailMessageCardProps as bh, EmptyValue as bi, EngagementCard as bj, type EngagementCardProps as bk, EngagementTimeline as bl, type EngagementTimelineProps as bm, EngagementTimelineStep as bn, type EngagementTimelineStepProps as bo, type FieldSlot as bp, type FieldsetSlot as bq, FileChip as br, type FileChipProps as bs, type FileKind as bt, type HeadingSlot as bu, type IconButtonSlot as bv, type InlineSlot as bw, IntentBadge as bx, type IntentBadgeProps as by, type IntentTone as bz, type TableProps as c, type TimeLoggerPhase as c$, type SortDirection as c0, type StackSlot as c1, StagePill as c2, Stat as c3, type StatusBadgeSlot as c4, StatusPill as c5, type StatusPillProps as c6, SuggestionPills as c7, type SuggestionPillsProps as c8, type SurfaceSlot as c9, type TextSlot as cA, type ThemeBrand as cB, type ThemeDensity as cC, type ThemeDirection as cD, type ThemeScheme as cE, ThemeScope as cF, type ThemeScopeProps as cG, type ThemeScopeValue as cH, TimeLogger as cI, TimeLoggerActions as cJ, type TimeLoggerActionsProps as cK, TimeLoggerBillable as cL, type TimeLoggerBillableProps as cM, TimeLoggerContextRow as cN, type TimeLoggerContextRowProps as cO, TimeLoggerEntry as cP, TimeLoggerEntryList as cQ, type TimeLoggerEntryListProps as cR, type TimeLoggerEntryProps as cS, TimeLoggerField as cT, type TimeLoggerFieldProps as cU, TimeLoggerFooter as cV, type TimeLoggerFooterProps as cW, TimeLoggerHeader as cX, type TimeLoggerHeaderProps as cY, TimeLoggerNotes as cZ, type TimeLoggerNotesProps as c_, type SwitchSlot as ca, Table as cb, TableBody as cc, type TableBodyProps as cd, TableCaption as ce, type TableCaptionProps as cf, TableCell as cg, type TableCellAlign as ch, type TableCellCommonProps as ci, type TableCellProps as cj, TableFooter as ck, type TableFooterProps as cl, TableHead as cm, type TableHeadProps as cn, TableHeader as co, type TableHeaderProps as cp, type TableHeaderStyle as cq, TableRow as cr, type TableRowData as cs, type TableRowProps as ct, type TableSlot as cu, type TableSortDirection as cv, type TableStickyEdge as cw, type TableTone as cx, TagsCell as cy, TeamMemberSelect as cz, AIReceiptPanel as d, type TimeLoggerProps as d0, type TimeLoggerTier as d1, TimeLoggerTimer as d2, type TimeLoggerTimerProps as d3, type TimelineState as d4, type ToastSlot as d5, type TooltipSlot as d6, type UseStopwatchReturn as d7, badgeVariants as d8, formatClock as d9, formatCurrency as da, formatDuration as db, parseDuration as dc, resolveBadgeAppearance as dd, serviceToneLabel as de, serviceToneStyle as df, useStopwatch as dg, type AIReceiptPanelProps as e, type AIReceiptResult as f, AiDraftCard as g, type AiDraftCardProps as h, type AiDraftState as i, type AlertDialogSlot as j, Assignee as k, AttentionItem as l, type AttentionItemProps as m, type AttentionUrgency as n, Badge as o, type BadgeAppearance as p, type BadgeAppearanceInput as q, type BadgeLegacyVariant as r, type BadgeProps as s, type BadgeSlot as t, type BadgeVariant as u, type BadgeVariantsProps as v, Blockquote as w, BottomNav as x, type BottomNavProps as y, type BottomNavTab as z };