@assure-one/design-system 1.47.1 → 1.48.0

package/dist/suite/index.d.ts

@@ -1,11 +1,12 @@
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as ComboboxSize } from '../brand-scope-DwLzUrSY.js';
-export { B as BRAND_PRODUCTS, a as BrandProduct, b as brandLabel } from '../brand-scope-DwLzUrSY.js';
-import { c as ComingSoonMessages } from '../types-BTHIs2nk.js';
+import { C as ComboboxSize } from '../brand-scope-ObBYNT0J.js';
+export { B as BRAND_PRODUCTS, a as BrandProduct, b as brandLabel } from '../brand-scope-ObBYNT0J.js';
+import { c as ComingSoonMessages } from '../types-CKpkEBvW.js';
 import '../vocab-DornLJbW.js';
 import '../system-DfJIVBlJ.js';
+import '../option-izy_4w4Z.js';
 
 interface BrandIconProps extends React.SVGAttributes<SVGElement> {
     size?: number;
@@ -139,6 +140,30 @@ interface LogoProps {
 }
 declare function Logo({ size, href, showText, className, iconClassName, textClassName, productName, inverted, }: LogoProps): react_jsx_runtime.JSX.Element;
 
+/** The vendor keys, matching the products' catalogue keys in consuming apps. */
+type TaxSoftwareVendor = "cch_axcess" | "ultratax" | "atx" | "taxact" | "proconnect" | "proseries" | "lacerte" | "drake";
+/** Plate heights, on the `Avatar` size scale. */
+type TaxSoftwareLogoSize = "sm" | "md" | "lg";
+/** Props of `TaxSoftwareLogo`; everything else spreads onto the outer `<span>`. */
+interface TaxSoftwareLogoProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, "children" | "aria-label" | "aria-hidden" | "role"> {
+    /**
+     * The vendor. A key without an official mark (`cch_axcess`, `ultratax`,
+     * `atx`), an unknown key or none renders the initials `Avatar` fallback.
+     */
+    vendor?: TaxSoftwareVendor | undefined;
+    /** Plate height, from the `Avatar` size scale. Default `md`. */
+    size?: TaxSoftwareLogoSize;
+    /**
+     * Accessible name. Omit it (the default) when the vendor's name is shown
+     * beside the mark: the logo is then decorative (`aria-hidden`). Pass it when
+     * the mark stands alone for the product. Also names the fallback's initials
+     * for an unknown vendor.
+     */
+    label?: string;
+}
+/** The official mark of a tax-software vendor, or the initials `Avatar` fallback. */
+declare const TaxSoftwareLogo: React$1.ForwardRefExoticComponent<TaxSoftwareLogoProps & React$1.RefAttributes<HTMLSpanElement>>;
+
 /**
  * AgreementViewer — the chrome + navigation shell for a multi-step, branded
  * agreement / proposal (the "Signed Agreement Viewer"). It owns the header,
@@ -840,6 +865,15 @@ interface SidebarBrandSwitcherProps {
      * not bind to a framework-specific image element.
      */
     brand?: React$1.ReactNode;
+    /**
+     * The collapsed rail's glyph: rendered only while the sidebar is railed,
+     * centred in the icon column, in place of `brand` (which then shows only
+     * expanded). Pass the product mark here and the wordmark as `label`, and
+     * the brand row needs no state classes of its own — the usual cause of a
+     * rail with no logo at all is a hand-written `hidden …:block` toggle whose
+     * group selector matches nothing.
+     */
+    mark?: React$1.ReactNode;
     /** Wordmark / label rendered next to the brand glyph in the trigger. */
     label: React$1.ReactNode;
     /**
@@ -1001,4 +1035,4 @@ interface DocumentRowProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "t
 }
 declare const DocumentRow: React$1.ForwardRefExoticComponent<DocumentRowProps & React$1.RefAttributes<HTMLDivElement>>;
 
-export { type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, type BrandIconProps, ClientSelect, type ClientSelectOption, ComingSoon, type ComingSoonProps, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, DocumentRow, type DocumentRowProps, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Logo, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, QUESTION_TYPES, QUESTION_TYPE_CONTRACT_VERSION, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, Questions, type QuestionsProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, SidebarBrandSwitcherTile };
+export { type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, type BrandIconProps, ClientSelect, type ClientSelectOption, ComingSoon, type ComingSoonProps, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, DocumentRow, type DocumentRowProps, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Logo, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, QUESTION_TYPES, QUESTION_TYPE_CONTRACT_VERSION, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, Questions, type QuestionsProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, SidebarBrandSwitcherTile, TaxSoftwareLogo, type TaxSoftwareLogoProps, type TaxSoftwareLogoSize, type TaxSoftwareVendor };

package/dist/suite/index.js

@@ -1,6 +1,6 @@
 "use client";
-export { AgreementPaneHeading, AgreementViewer, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, BRAND_PRODUCTS, ClientSelect, ComingSoon, Grid, Logo, ProposalAddOn, ProposalBillingTerms, ProposalConsentGate, ProposalCustomPage, ProposalNote, ProposalPackageCard, ProposalPaymentCapture, ProposalPricingSummary, ProposalServiceRow, ProposalSignatureBlock, ProposalSignerList, QUESTION_TYPES, QUESTION_TYPE_CONTRACT_VERSION, Questions, SidebarBrandSwitcher, SidebarBrandSwitcherTile, brandLabel } from '../chunk-6CXI3KRG.js';
-export { DocumentDetailActions, DocumentDetailBody, DocumentDetailHeader, DocumentDetailMetaRow, DocumentDetailPanel, DocumentDetailRequester, DocumentDetailTitle, DocumentList, DocumentListSection, DocumentRow } from '../chunk-IIBDSTOG.js';
+export { AgreementPaneHeading, AgreementViewer, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, BRAND_PRODUCTS, ClientSelect, ComingSoon, Grid, Logo, ProposalAddOn, ProposalBillingTerms, ProposalConsentGate, ProposalCustomPage, ProposalNote, ProposalPackageCard, ProposalPaymentCapture, ProposalPricingSummary, ProposalServiceRow, ProposalSignatureBlock, ProposalSignerList, QUESTION_TYPES, QUESTION_TYPE_CONTRACT_VERSION, Questions, SidebarBrandSwitcher, SidebarBrandSwitcherTile, TaxSoftwareLogo, brandLabel } from '../chunk-FO2WSYUA.js';
+export { DocumentDetailActions, DocumentDetailBody, DocumentDetailHeader, DocumentDetailMetaRow, DocumentDetailPanel, DocumentDetailRequester, DocumentDetailTitle, DocumentList, DocumentListSection, DocumentRow } from '../chunk-HV24JSRN.js';
 import '../chunk-ARCWF2S3.js';
 import '../chunk-EUHGZA6Q.js';
 import '../chunk-YRHRVOLV.js';

package/dist/{types-BTHIs2nk.d.ts → types-CKpkEBvW.d.ts}

@@ -354,6 +354,20 @@ interface AppHeaderMessages {
 interface BulkActionBarMessages {
     /** The default accessible name of the clear button. Default `"Clear selection"`. */
     clearSelection: string;
+    /** The default accessible name of the toolbar. Default `"Bulk actions"`. */
+    toolbar: string;
+    /** The default count label, also announced politely. Default `"{count} selected"`. */
+    selected: (count: number) => string;
+    /** Announced when the selection is cleared (bars that stay mounted). Default `"Selection cleared"`. */
+    cleared: string;
+    /** The visible label of a `labelled` Clear. Default `"Clear"`. */
+    clear: string;
+    /** The key hint beside a `labelled` Clear. Default `"Esc"`. */
+    escapeKey: string;
+    /** The label of `BulkActionBarMore`. Default `"More"`. */
+    more: string;
+    /** Eligibility of a menu option across the selection. Default `"{eligible} of {total}"`. */
+    eligible: (eligible: number, total: number) => string;
 }
 /** The copy a `Table` renders. @experimental */
 interface TableMessages {
@@ -366,6 +380,22 @@ interface TableMessages {
     collapseSection: string;
     /** A `TableGroupRow`'s collapse toggle while closed. Default `"Expand section"`. */
     expandSection: string;
+    /**
+     * Screen-reader text of a multi-sorted header's rank (`TableHead sortIndex`),
+     * ascending. Default `"Sorted ascending, priority {rank}"`.
+     */
+    sortedAscending: (rank: number) => string;
+    /** As `sortedAscending`, descending. Default `"Sorted descending, priority {rank}"`. */
+    sortedDescending: (rank: number) => string;
+    /** The resize handle's accessible name when the header has no text label. Default `"Resize column"`. */
+    resizeColumn: string;
+    /** The resize handle's accessible name. Default `"Resize {label}"`. */
+    resizeColumnNamed: (label: string) => string;
+    /**
+     * A `TableGroupRow`'s count while only some of the group's rows are loaded
+     * (infinite mode). Default `"{loaded} of {total} loaded"`.
+     */
+    groupLoadedOf: (loaded: string, total: string) => string;
 }
 /** The copy a `TableDensityToggle` renders. @experimental */
 interface TableDensityMessages {
@@ -419,6 +449,36 @@ interface DataTableMessages {
     selectAll: string;
     /** The accessible name of a row's selection checkbox (W6-06). Default `"Select row"`. */
     selectRow: string;
+    /** A header menu trigger's accessible name. Default `"Column options for {label}"`. */
+    columnOptions: (label: string) => string;
+    /** Header menu item. Default `"Sort ascending"`. */
+    sortAscending: string;
+    /** Header menu item. Default `"Sort descending"`. */
+    sortDescending: string;
+    /** Header menu item. Default `"Clear sort"`. */
+    clearSort: string;
+    /** Header menu item. Default `"Move left"`. */
+    moveLeft: string;
+    /** Header menu item. Default `"Move right"`. */
+    moveRight: string;
+    /** Header menu item. Default `"Hide column"`. */
+    hideColumn: string;
+    /** Header menu item. Default `"Pin column"`. */
+    pinColumn: string;
+    /** Header menu item. Default `"Unpin column"`. */
+    unpinColumn: string;
+    /** Header menu item. Default `"Autosize column"`. */
+    autosizeColumn: string;
+    /** Header menu item. Default `"Reset columns"`. */
+    resetColumns: string;
+    /** `DataTableLoadMore`'s button. Default `"Load more"`. */
+    loadMore: string;
+    /** `DataTableLoadMore`'s status while a page loads. Default `"Loading more…"`. */
+    loadingMore: string;
+    /** `DataTableLoadMore`'s end-of-list status. Default `"All {count} loaded"`. */
+    allLoaded: (count: string) => string;
+    /** `DataTableLoadMore`'s progress status. Default `"{loaded} of {total} loaded"`. */
+    loadedOf: (loaded: string, total: string) => string;
 }
 /**
  * The copy a `ConfirmDialog` renders when the caller gives no label (W5-16);
@@ -446,6 +506,222 @@ interface ComingSoonMessages {
     /** The pill under the feature list. Default `"In Development"`. */
     badge: string;
 }
+/** The copy a `StatStrip` renders. @experimental */
+interface StatStripMessages {
+    /** The default accessible name of the strip. Default `"Summary"`. */
+    region: string;
+    /** The collapse chevron's name while expanded. Default `"Collapse summary"`. */
+    collapse: string;
+    /** The collapse chevron's name while collapsed. Default `"Expand summary"`. */
+    expand: string;
+}
+/**
+ * The copy a `DisplayMenu` renders around the consumer's own section labels
+ * (PR 3, table system). Owned by `display-menu.tsx`.
+ *
+ * @experimental
+ */
+interface DisplayMenuMessages {
+    /** The default trigger label. Default `"Display"`. */
+    trigger: string;
+    /** The default trigger tooltip. Default `"Filters, grouping, ordering, columns"`. */
+    tooltip: string;
+    /** The trigger's accessible name while customised. */
+    triggerCustomised: (label: string) => string;
+    /** The root search placeholder. Default `"Filter…"`. */
+    rootSearchPlaceholder: string;
+    /** The root search's accessible name. */
+    rootSearchLabel: string;
+    /** The reset action. Default `"Reset to default"`. */
+    reset: string;
+    /** Empty search result. Default `"No matches"`. */
+    noMatches: string;
+    /** A section with no options. Default `"Nothing to filter by"`. */
+    nothingToFilter: string;
+    /** A flyout's search placeholder. */
+    sectionSearchPlaceholder: (section: string) => string;
+    /** A flyout's search accessible name. */
+    sectionSearchLabel: (section: string) => string;
+    /** The flyout's clear action. */
+    clearSelected: (count: number) => string;
+    /** Heading over `group: "filter"` sections. Default `"Filter"`. */
+    groupFilter: string;
+    /** Heading over `group: "arrange"` sections. Default `"Arrange"`. */
+    groupArrange: string;
+    /** The trigger's accessible name while `activeCount` > 0. Default `"{label}, {count} active"`. */
+    activeFilters: (label: string, count: number) => string;
+    /** The match-all/any control's accessible name. Default `"Match"`. */
+    matchLabel: string;
+    /** The "match all" segment. Default `"All filters"`. */
+    matchAll: string;
+    /** The "match any" segment. Default `"Any filter"`. */
+    matchAny: string;
+    /** The saved-views picker's accessible name and list label. Default `"Views"`. */
+    views: string;
+    /** The picker's label when no view is active. Default `"Custom view"`. */
+    noView: string;
+    /** The save action. Default `"Save view"`. */
+    saveView: string;
+    /** Spoken with the dirty dot. Default `"unsaved changes"`. */
+    unsavedChanges: string;
+    /** Live announcement: an option was selected. */
+    announceSelected: (section: string, option: string) => string;
+    /** Live announcement: an option was deselected. */
+    announceDeselected: (section: string, option: string) => string;
+    /** Live announcement: a section was cleared. */
+    announceCleared: (section: string) => string;
+    /** Live announcement: everything was reset. Default `"Display reset to default"`. */
+    announceReset: string;
+    /** Live announcement: a saved view was applied. */
+    announceView: (view: string) => string;
+}
+/**
+ * The copy the typed `DisplayMenu` filter panels render (operators, date
+ * presets, number/text/boolean editors, sort and column panels). Owned by
+ * `display-menu-panels.tsx` / `display-menu-filters.ts`.
+ *
+ * @experimental
+ */
+interface DisplayMenuFiltersMessages {
+    /** The operator picker's accessible name. Default `"Operator"`. */
+    operator: string;
+    /** Operator labels of a value-list section. */
+    operatorIs: string;
+    operatorIsNot: string;
+    operatorIsAnyOf: string;
+    operatorIsNoneOf: string;
+    operatorIsEmpty: string;
+    operatorIsNotEmpty: string;
+    /** Overflow of a summarised value list ("Active, Draft +3"). */
+    more: (count: number) => string;
+    /** A flyout list's search field: accessible name. */
+    search: (section: string) => string;
+    /** A flyout list's search field: placeholder. */
+    searchPlaceholder: string;
+    /** A list or search with no matching option. */
+    noMatches: string;
+    /** The "clear this filter" action. */
+    clear: string;
+    /** Person section: the signed-in user, pinned first. */
+    me: string;
+    /** Person section: no assignee, pinned after "Me". */
+    unassigned: string;
+    /** Tags section: the any/all group's accessible name. */
+    tagMatch: string;
+    /** Tags section: a row needs any selected tag. */
+    tagMatchAny: string;
+    /** Tags section: a row needs every selected tag. */
+    tagMatchAll: string;
+    /** Tags summary prefix when matching all ("all of"). */
+    tagMatchAllSummary: (labels: string) => string;
+    /** Date section headings and preset labels. */
+    dateDue: string;
+    dateCalendar: string;
+    datePresets: string;
+    overdue: string;
+    dueToday: string;
+    dueNext7: string;
+    dueThisMonth: string;
+    noDate: string;
+    today: string;
+    last7: string;
+    last30: string;
+    thisMonth: string;
+    lastMonth: string;
+    thisQuarter: string;
+    lastQuarter: string;
+    ytd: string;
+    custom: string;
+    /** Custom range inputs. */
+    dateFrom: string;
+    dateTo: string;
+    /** Custom range summaries. */
+    dateBetween: (from: string, to: string) => string;
+    dateOnOrAfter: (from: string) => string;
+    dateOnOrBefore: (to: string) => string;
+    /** Number section: operator names (accessible) — symbols render visually. */
+    numberEq: string;
+    numberNe: string;
+    numberLt: string;
+    numberLte: string;
+    numberGt: string;
+    numberGte: string;
+    numberBetween: string;
+    /** Number inputs. */
+    numberValue: string;
+    numberMin: string;
+    numberMax: string;
+    /** Number input that does not parse. */
+    numberInvalid: string;
+    /** Number summary for `between`. */
+    numberBetweenSummary: (from: string, to: string) => string;
+    /** Text section operators and input. */
+    textContains: string;
+    textStartsWith: string;
+    textValue: string;
+    textContainsSummary: (text: string) => string;
+    textStartsWithSummary: (text: string) => string;
+    /** Boolean section. */
+    booleanAny: string;
+    booleanTrue: string;
+    booleanFalse: string;
+    /** Ordering section. */
+    sortBy: string;
+    sortThenBy: string;
+    sortField: (position: string) => string;
+    sortDirection: (field: string) => string;
+    ascending: string;
+    descending: string;
+    addSort: string;
+    chooseField: string;
+    removeSort: (field: string) => string;
+    makePrimary: (field: string) => string;
+    sortSummary: (fields: string) => string;
+    /** Columns section. */
+    columnsList: string;
+    showColumn: (column: string) => string;
+    moveUp: (column: string) => string;
+    moveDown: (column: string) => string;
+    locked: string;
+    resetColumns: string;
+    columnMoved: (column: string, position: number, total: number) => string;
+    columnShown: (column: string) => string;
+    columnHidden: (column: string) => string;
+    /** Ordering announcement. */
+    sortChanged: (summary: string) => string;
+}
+/** The copy a `FilterChips` row renders (PR 3, table system). @experimental */
+interface FilterChipsMessages {
+    /** The row's accessible name. Default `"Active filters"`. */
+    region: string;
+    /** A facet chip's text: `"Status: Active, Draft"`. */
+    facet: (label: string, summary: string) => string;
+    /** A facet chip's remove button. Default `"Remove {label} filter"`. */
+    remove: (label: string) => string;
+    /** A value's remove button in the overflow panel. Default `"Remove {value} from {label}"`. */
+    removeValue: (label: string, value: string) => string;
+    /** The collapsed chip's visible text. Default `"+{count}"`. */
+    more: (count: number) => string;
+    /** The collapsed chip's accessible name. Default `"{count} more filters"`. */
+    moreLabel: (count: number) => string;
+    /** The overflow panel's heading. Default `"Active filters ({count})"`. */
+    panelTitle: (count: number) => string;
+    /** The overflow panel's clear action. Default `"Clear filters"`. */
+    clearFilters: string;
+    /** The trailing clear action. Default `"Clear all"`. */
+    clearAll: string;
+}
+/** The copy a `ListPage` renders (PR 3, table system). @experimental */
+interface ListPageMessages {
+    /** The accessible name of the table scroll region. Default `"Results"`. */
+    tableRegion: string;
+    /** A paged count: `"1–20 of 239"`. */
+    range: (start: string, end: string, total: string) => string;
+    /** An infinite-list count: `"240 of 1,240 loaded"`. */
+    loaded: (loaded: string, total: string) => string;
+    /** A plain count. Default `"{total} results"`. */
+    total: (total: string) => string;
+}
 /**
  * The whole catalogue, one namespace per component. This is the type a
  * consumer's i18n lint can check for completeness.
@@ -501,6 +777,11 @@ interface DsMessages {
     spreadsheetPreview: SpreadsheetPreviewMessages;
     peoplePicker: PeoplePickerMessages;
     comingSoon: ComingSoonMessages;
+    statStrip: StatStripMessages;
+    displayMenu: DisplayMenuMessages;
+    displayMenuFilters: DisplayMenuFiltersMessages;
+    filterChips: FilterChipsMessages;
+    listPage: ListPageMessages;
 }
 /** A component namespace of the catalogue. @experimental */
 type DsMessageNamespace = keyof DsMessages;
@@ -514,4 +795,4 @@ type DsMessagesOverride = {
     [N in DsMessageNamespace]?: Partial<DsMessages[N]>;
 };
 
-export type { ComboboxMessages as C, DsMessageNamespace as D, ErrorStateMessages as E, FileUploadMessages as F, KeyboardShortcutsMessages as K, PaginationMessages as P, SelectMessages as S, TableMessages as T, DsMessages as a, DsMessagesOverride as b, ComingSoonMessages as c, CommandPaletteMessages as d, ConfirmMessages as e, CopyButtonMessages as f, PhoneFieldMessages as g, SearchInputMessages as h, TableDensityMessages as i, ToastMessages as j, FieldMessages as k, TableStatesMessages as l, DataTableMessages as m };
+export type { BulkActionBarMessages as B, ComboboxMessages as C, DsMessageNamespace as D, ErrorStateMessages as E, FileUploadMessages as F, KeyboardShortcutsMessages as K, ListPageMessages as L, PaginationMessages as P, SelectMessages as S, TableMessages as T, DsMessages as a, DsMessagesOverride as b, ComingSoonMessages as c, CommandPaletteMessages as d, ConfirmMessages as e, CopyButtonMessages as f, PhoneFieldMessages as g, SearchInputMessages as h, TableDensityMessages as i, ToastMessages as j, FieldMessages as k, TableStatesMessages as l, DisplayMenuMessages as m, DisplayMenuFiltersMessages as n, FilterChipsMessages as o, DataTableMessages as p, StatStripMessages as q };

package/docs/components.md

@@ -2,7 +2,7 @@
 
 <!-- Generated by `pnpm docs:catalogue` from api/*.api.md and docs/components.registry.json. Do not edit by hand; edit the registry and regenerate. -->
 
-Every public component of `@assure-one/design-system`, in one place: **524 component exports** — 183 component families with 229 compound parts, and 195 icons — plus the hooks, utilities, tokens and testing helpers the package exports. The list is derived from the API reports, so a public component cannot be missing from this page (`pnpm docs:catalogue --check` runs in `pnpm test:contracts`).
+Every public component of `@assure-one/design-system`, in one place: **543 component exports** — 189 component families with 243 compound parts, and 195 icons — plus the hooks, utilities, tokens and testing helpers the package exports. The list is derived from the API reports, so a public component cannot be missing from this page (`pnpm docs:catalogue --check` runs in `pnpm test:contracts`).
 
 **How to use this page.** Start from the ["Pick a component"](#pick-a-component) table with the UI need you have, or from ["Never hand-roll"](#never-hand-roll) with the raw element you were about to write; links land on the category section that holds the row. Every row links to the story that shows the states. The short rulebook for agents and new contributors is [`docs/for-ai-agents.md`](./for-ai-agents.md).
 
@@ -114,12 +114,13 @@ Things you press. Every clickable control is one of these; a `<button>`, `<a rol
 | **CopyButton**<br>since 0.0.0 | Copy a value to the clipboard with check-mark feedback (ids, codes, links). | The copy needs a confirmation toast or copies rich content — compose `IconButton` + `useToast`. | `navigator.clipboard.writeText + useState` | [IconButton](#actions), [ToastProvider](#feedback) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/copy-button.stories.tsx) |
 | **ConfirmActionButton**<br>since 0.3.0 | A destructive or irreversible action that needs a confirmation step: a trigger plus `ConfirmDialog`, retiring `window.confirm()`. `destructive={false}` (alias of `intent="brand"`) for a non-destructive confirm. | The confirmation is imperative (`useConfirm`) or the action is reversible (act, then offer undo in a toast). | `window.confirm()`, `useState + AlertDialog boilerplate` | [ConfirmDialog](#overlays), [AlertDialog](#overlays), [DangerAction](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/confirm-action-button.stories.tsx) |
 | **Intent actions**<br>parts: `SecondaryAction`, `DangerAction`, `LinkAction`, `IconAction`<br>since 0.3.0 | Intent-named `Button` wrappers for product code that reads by role: primary, secondary, danger, link-styled, icon-only. | You need the full variant × intent matrix or a size outside the defaults (`Button`, `IconButton`). | — | [Button](#actions), [IconButton](#actions), [LinkButton](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/intent-actions.stories.tsx) |
-| **BulkActionBar**<br>parts: `BulkActionBarAction`, `BulkActionBarSeparator`<br>since 0.15.0 | A floating bar that appears when rows are selected: selection count, actions, separators, clear. | Actions apply to one record (row menu via `DropdownMenu`) or belong to the page (`PageHeader` actions). | — | [DataTable](#data-display), [StickyActionBar](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/bulk-action-bar.stories.tsx) |
+| **BulkActionBar**<br>parts: `BulkActionBarAction`, `BulkActionBarSeparator`, `BulkActionBarMenu`, `BulkActionBarMenuRadioGroup`, `BulkActionBarMenuItem`, `BulkActionBarMenuSub`, `BulkActionBarMore`, `BulkActionBarPicker`<br>also: `sharedBulkValue`<br>since 0.15.0 | A bar that appears when rows are selected: count (live-announced) and scope, actions, two-tier menus (`BulkActionBarMenu` for enumerations, `BulkActionBarPicker` for searchable pickers), a `More` overflow, clear with Esc. `variant="floating"` for new list pages. | Actions apply to one record (row menu via `DropdownMenu`) or belong to the page (`PageHeader` actions). | — | [DataTable](#data-display), [StickyActionBar](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/bulk-action-bar.stories.tsx) |
 | **StickyActionBar**<br>since 1.3.0 | Save / Cancel that stays visible at the bottom of a long form or settings page, with an optional hint and mobile-nav offset. | The form fits the viewport (put the `SubmitButton` at the end) or the actions belong to a dialog (`DialogFooter`). | `<div class="sticky bottom-0">` | [SubmitButton](#actions), [BulkActionBar](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/sticky-action-bar.stories.tsx) |
 | **NewMenu** (deprecated) (`/legacy`)<br>since 1.2.0 | The "+ New" creation menu of an app: grouped actions with icons and shortcuts on a `DropdownMenu`. | The menu is contextual to one record (`DropdownMenu`) or has a single action (`Button`). | — | [DropdownMenu](#overlays), [AppHeader](#shell-screens) | [story](https://github.com/Assure-One/design-system/blob/main/src/legacy/new-menu.stories.tsx) |
-| **DisplayMenu**<br>since 1.25.0 | The Linear-style Display control of a list surface: filters, grouping, ordering and column visibility in one searchable menu, driven by a `sections` array. | There is one filter (`FilterChip`) or one multi-value filter (`MultiFilterPill`). | — | [Toolbar](#actions), [MultiFilterPill](#selection), [DataTableView](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/display-menu.stories.tsx) |
+| **DisplayMenu**<br>also: `detectDisplayMenuDatePreset`, `isDisplayMenuSectionActive`, `matchesDisplayMenuDate`, `matchesDisplayMenuNumber`, `matchesDisplayMenuOperator`, `matchesDisplayMenuTags`, `matchesDisplayMenuText`, `parseDisplayMenuNumber`, `resolveDisplayMenuDatePreset`, `summarizeDisplayMenuSection`<br>since 1.25.0 | The Linear-style Display control of a list surface: filters (value lists with operators and faceted counts, person, tags, date presets, number, text, boolean), ordering (multi-key sort), grouping, columns (show/hide, reorder) and density in one searchable menu with Filter / Arrange headings, driven by a `sections` array. Pair with `FilterChips` (`useDisplayMenuFilterChips`) for the active-filter row. | There is one filter (`FilterChip`) or one multi-value filter (`MultiFilterPill`). | — | [Toolbar](#actions), [MultiFilterPill](#selection), [DataTableView](#data-display), [FilterChips](#actions), [ListPage](#layout), [TableDensityToggle](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/display-menu.stories.tsx) |
 | **Toolbar**<br>parts: `FilterChip`<br>also: `filterChipVariants`<br>since 0.3.0 | The row of controls above a list or dashboard; `FilterChip` for a single-value filter toggle inside it. Controls share one control size so the row reads as one line. | The controls belong to a table card (`DataTableToolbar`) or the filter is multi-value (`MultiFilterPill`). | `<div class="flex items-center gap-2"> above a list` | [MultiFilterPill](#selection), [DisplayMenu](#actions), [DataTable](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/toolbar.stories.tsx) |
 | **SuggestionPills** (deprecated) (`/legacy`)<br>since 1.5.0 | A strip of AI quick-reply pills floated above a composer; renders nothing when empty and not loading, so mount it unconditionally. | The choices are a form value (`MultiSelectField`) or filters (`FilterChip`). | — | [MessageComposer](#forms), [AiDraftCard](#feedback) | [story](https://github.com/Assure-One/design-system/blob/main/src/legacy/suggestion-pills.stories.tsx) |
+| **FilterChips** (experimental)<br>also: `useDisplayMenuFilterChips`<br>since unreleased | The active-filter row right of a list's search box: one chip per facet ("Status: Active, Draft"); the chip body asks to edit the facet (reopen its Display flyout), × removes it; past `maxVisible` facets the rest collapse into a "+N" chip with a per-value popover; trailing "Clear all". Derive props from DisplayMenu sections with `useDisplayMenuFilterChips`. | A single on/off filter toggle in a toolbar (`FilterChip`) or a dismissible tag that is not a filter (`Chip` with `onRemove`). | `<div class="flex gap-1"> of hand-rolled filter pills with × buttons` | [DisplayMenu](#actions), [ListPage](#layout), [Chip](#selection), [Toolbar](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/filter-chips.stories.tsx) |
 
 ## Forms
 
@@ -265,6 +266,7 @@ Arrange content: stacks, surfaces, cards, separators, section and page framing.
 | **DashGrid** (deprecated) (`/legacy`)<br>since 1.2.0 | A dashboard of reorderable widgets in 2–4 columns with the order persisted under `storageKey`. | A static grid of cards (CSS grid of `Card`s). | — | [KpiCard](#data-display), [Card](#layout) | [story](https://github.com/Assure-One/design-system/blob/main/src/legacy/dash-grid.stories.tsx) |
 | **RouteTransition**<br>since 1.3.0 | Fade and slide a page panel in when `routeKey` changes; respects reduced motion. | Animating a component's own presence (the overlays already do) or a list (leave static). | — | [Shell](#shell-screens) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/route-transition.stories.tsx) |
 | **VisuallyHidden**<br>since 0.0.0 | Text for assistive technology that must not be seen: the name of an icon-only control you compose yourself, a live-region message. | Hiding from everyone (`hidden`) or an `IconButton` (it names itself). | `class="sr-only"` | [IconButton](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/visually-hidden.stories.tsx) |
+| **ListPage** (experimental)<br>parts: `ListPageToolbar`, `ListPageResultCount`, `ListPageTable`, `ListPageScroll`<br>since unreleased | A list screen: full available height and never scrolls itself; stats, a toolbar (search left, filter chips, spacer, result count, actions), a table card that is the only scroll region (sticky header, pinned footer, shrinks to short content) and a bulk bar. | A table embedded in a detail page or card (Table / DataTable directly), or a page whose body is not one list. | `<div class="flex h-full flex-col overflow-hidden"> around a toolbar and an overflow-auto table` | [DataTable](#data-display), [FilterChips](#actions), [DisplayMenu](#actions), [BulkActionBar](#actions), [Table](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/list-page.stories.tsx) |
 
 ## Typography
 
@@ -289,15 +291,16 @@ Show records and status: tables, key/value grids, badges, dots, avatars, lists a
 | **InfoHint** (experimental)<br>since unreleased | The ⓘ beside a label or a figure (W7-15): `label` names what the hint is about, `children` is the explanation, `presentation="tooltip"` (default) or `"popover"` for an explanation with a paragraph or a link. The trigger is a real `IconButton`, so the hint is reachable by keyboard and by touch. | The text belongs in the layout (`FieldDescription` under a field) or the surface is a rich hover preview (`HoverCard`). | `<svg title>`, `<span title>` | [Tooltip](#overlays), [Popover](#overlays), [IconButton](#actions), [FieldDescription](#forms) | [story](https://github.com/Assure-One/design-system/blob/main/src/patterns/display/info-hint.stories.tsx) |
 | **AvatarGroup**<br>since 1.38.0 | An overlapping stack of `Avatar`s with a `+N` overflow bubble: `max` caps the faces, `total` carries the real count, `size` cascades from Avatar's scale. | A single person (`Avatar`) or a list that needs names (`DescriptionList`). | `flex row of avatars with negative margins and a +N circle` | [Avatar](#data-display), [TeamMemberSelect](#selection) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/avatar-group.stories.tsx) |
 | **StarRating**<br>also: `starRatingVariants`<br>since 0.0.0 | A display-only rating: fractional stars, `max`, sized variants. | Capturing a rating (compose `RadioGroup` or `ToggleGroup` with star icons). | — | [Badge](#data-display), [KpiCard](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/star-rating.stories.tsx) |
-| **Table**<br>parts: `TableHeader`, `TableBody`, `TableFooter`, `TableRow`, `TableHead`, `TableCell`, `TableCaption`, `TableGroupRow`<br>since 0.0.0 | A bare semantic table with the design system's row, header and caption styling. | A records table with toolbar, sorting and pagination (`DataTable`, `DataTableView`) or an editable matrix (`Grid`). | `<table>`, `<tr>`, `<td>`, `<th>` | [DataTable](#data-display), [DataTableView](#data-display), [MetadataGrid](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/table.stories.tsx) |
+| **Table**<br>parts: `TableHeader`, `TableBody`, `TableFooter`, `TableRow`, `TableHead`, `TableCell`, `TableCaption`, `TableGroupRow`, `TableCellSecondary`<br>since 0.0.0 | A bare semantic table with the design system's row, header and caption styling. | A records table with toolbar, sorting and pagination (`DataTable`, `DataTableView`) or an editable matrix (`Grid`). | `<table>`, `<tr>`, `<td>`, `<th>` | [DataTable](#data-display), [DataTableView](#data-display), [MetadataGrid](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/table.stories.tsx) |
 | **TableDensityToggle** (experimental)<br>also: `useTableDensity`<br>since unreleased | A table's own toolbar control for row density — pairs with `useTableDensity` and `<Table density>`. Two icon items, "Detailed" and "Compact", each with an accessible name and a tooltip. | A generic view-mode switch unrelated to table rows (ToggleGroup directly, or SegmentedControl). | — | [Table](#data-display), [ToggleGroup](#selection) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/table-density-toggle.stories.tsx) |
-| **DataTable**<br>parts: `DataTableToolbar`, `DataTableSearch`, `DataTableSpacer`, `DataTableResultsCount`, `DataTableHead`, `DataTableHeader`, `DataTableBody`, `DataTableRow`, `DataTableCell`, `DataTableCellName`, `DataTableCellMono`, `DataTableCellId`, `DataTableCellDue`, `DataTableCheckbox`, `DataTablePagination`<br>since 0.3.0 | The composable records table: card frame, toolbar with search and count, sortable headers, typed cells (name, mono, id, due), row checkbox, pagination. | A config-driven table is enough (`DataTableView`) or the table is a plain semantic one (`Table`). | `<table> + hand-rolled toolbar and pager` | [DataTableView](#data-display), [Table](#data-display), [BulkActionBar](#actions), [LoadingRows](#feedback), [TableLoading](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table.stories.tsx) |
+| **DataTable**<br>parts: `DataTableToolbar`, `DataTableSearch`, `DataTableSpacer`, `DataTableResultsCount`, `DataTableHead`, `DataTableHeader`, `DataTableBody`, `DataTableRow`, `DataTableCell`, `DataTableCellName`, `DataTableCellMono`, `DataTableCellId`, `DataTableCellDue`, `DataTableCheckbox`, `DataTablePagination`, `DataTableCellSecondary`<br>since 0.3.0 | The composable records table: card frame, toolbar with search and count, sortable headers, typed cells (name, mono, id, due), row checkbox, pagination. | A config-driven table is enough (`DataTableView`) or the table is a plain semantic one (`Table`). | `<table> + hand-rolled toolbar and pager` | [DataTableView](#data-display), [Table](#data-display), [BulkActionBar](#actions), [LoadingRows](#feedback), [TableLoading](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table.stories.tsx) |
 | **TableLoading** (experimental)<br>since 1.38.0 | The `<tbody aria-busy>` of a data table while its rows load: skeleton rows sized to the columns. Slots in place of `DataTableBody`. | A list outside a table (`LoadingRows`) or a single shape (`Skeleton`). | `<tbody> of hand-rolled skeleton <td>s` | [TableEmpty](#data-display), [TableError](#data-display), [DataTable](#data-display), [LoadingRows](#feedback) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table-states.stories.tsx) |
 | **TableEmpty** (experimental)<br>since 1.38.0 | The `<tbody>` of a data table with no rows: one full-width row holding a compact `EmptyState`. | An empty panel outside a table (`EmptyState`). | `<tr><td colSpan> with centred grey text` | [TableLoading](#data-display), [TableError](#data-display), [EmptyState](#feedback), [DataTable](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table-states.stories.tsx) |
 | **TableError** (experimental)<br>since 1.38.0 | The `<tbody>` of a data table whose rows failed to load: one full-width row holding a compact `ErrorState` with retry. | An error panel outside a table (`ErrorState`). | `<tr><td colSpan> with an error message and a retry button` | [TableLoading](#data-display), [TableEmpty](#data-display), [ErrorState](#feedback), [DataTable](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table-states.stories.tsx) |
 | **DataTableView**<br>parts: `StagePill` (`/legacy`) (deprecated), `Assignee` (`/legacy`) (deprecated), `MoneyCell` (`/legacy`) (deprecated), `TagsCell` (`/legacy`), `Dash` (`/legacy`) (deprecated)<br>since 1.6.0 | A list screen as configuration: `columns` + `data` (+ filters, search keys, sort); owns search/filter/sort/pagination state. Cell renderers `StagePill`, `Assignee`, `MoneyCell`, `TagsCell`, `Dash` for `column.render`. | You need custom table composition (`DataTable`). | — | [DataTable](#data-display), [DisplayMenu](#actions), [Toolbar](#actions) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table-view.stories.tsx) |
 | **MetadataGrid**<br>parts: `DataItem`<br>since 0.4.1 | Label / value pairs on a detail surface as a semantic `<dl>`; `DataItem span={2}` for full-row values. | Tabular records (`Table`) or a stat tile (`KpiCard`). | `<dl>`, `two-column label/value divs` | [DetailGrid](#layout), [Table](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/metadata-grid.stories.tsx) |
 | **KpiCard**<br>parts: `SelectableKpiCard`<br>since 0.4.1 | A single-stat dashboard tile: label, value, optional tone, icon and hint; `SelectableKpiCard` when tiles act as filters. | A number inside running content (`Stat`) or a chart (`DonutChart`). | — | [Stat](#typography), [DashGrid](#layout), [Card](#layout) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/kpi-card.stories.tsx) |
+| **StatStrip** (experimental)<br>parts: `StatStripItem`<br>since unreleased | The headline numbers above a list or board: one joined card of cells (label, big value, optional meter, one-line caption), collapsible to one line and remembered per browser; cells can act as filter toggles. | A dashboard of independent tiles (`KpiCard` in a `DashGrid`) or one number inside running content (`Stat`). | `hand-rolled grid of KPI <div>s above a table` | [KpiCard](#data-display), [SelectableKpiCard](#data-display), [ProgressBar](#feedback), [DataTable](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/stat-strip.stories.tsx) |
 | **Badge**<br>also: `badgeVariants`, `resolveBadgeAppearance`<br>since 0.0.0 | A short static label or count: `variant` (solid, soft, outline) × `intent`. | A status with a shared vocabulary (`StatusBadge`), a removable token (`Chip`) or a machine-suggested intent (`IntentBadge`). | `<span class="rounded-full px-2 text-xs">` | [StatusBadge](#data-display), [Chip](#selection), [IntentBadge](#data-display), [StatusDot](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/badge.stories.tsx) |
 | **StatusBadge**<br>also: `defineStatusMap`<br>since 1.35.0 | The presentation of a status: soft badge, indicator dot, icon; define the product's statuses once with `defineStatusMap` and spread an entry onto it. | A count or neutral label (`Badge`) or a stage pill inside `DataTableView` (`StagePill`). | — | [Badge](#data-display), [StatusDot](#data-display), [StatusPill](#data-display), [DataTableView](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/status-badge.stories.tsx) |
 | **StatusPill** (`/legacy`)<br>since 1.2.0 | Only in code that already uses it: the fixed-vocabulary pill (`status`, optional dot) for authoritative state. | New code — `StatusBadge` with `defineStatusMap`. | — | [StatusBadge](#data-display), [IntentBadge](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/status-pill.stories.tsx) |
@@ -325,6 +328,8 @@ Show records and status: tables, key/value grids, badges, dots, avatars, lists a
 | **Proposal content** (`/suite`)<br>parts: `ProposalNote` (`/suite`), `ProposalCustomPage` (`/suite`)<br>since 1.12.0 | The content blocks of a proposal: signer list, notes, custom pages. | Anything outside a proposal. | — | [AgreementViewer](#shell-screens), [ProposalPackageCard](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/proposal-content.stories.tsx) |
 | **DataTable (compound)** (experimental)<br>since unreleased | A records table driven by `useDataTable`: the toolbar with a labelled search, filters and a column-visibility menu, the table on the `Table*` parts with sort and selection wired to the controller, bulk actions, the merged pager and the built-in loading / empty / error bodies. `classNames.search` and `--ds-data-table-search-width` size the search field. | A table with no state (the `Table` parts alone), the hand-written `DataTable*` parts a product already composes, or the config-driven convenience (`DataTableView`). | `hand-rolled toolbar + <table> + pager around per-table useState` | [useDataTable](#hooks-utilities), [Table](#data-display), [DataTable](#data-display), [DataTableView](#data-display), [Pagination](#navigation), [BulkActionBar](#actions), [TableLoading](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/patterns/data/data-table.stories.tsx) · [docs](https://github.com/Assure-One/design-system/blob/main/docs/data-tables.md) |
 | **EmptyValue** (experimental)<br>since unreleased | A table or detail cell has no value: renders the em dash placeholder consistently. | The value is genuinely empty text a user typed — render it as-is. | `<span>—</span>` | — | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/data-table-view.stories.tsx) |
+| **DataTableHeaderMenu** (experimental)<br>since unreleased | A column's options menu in a header cell's `menu` slot: sort ascending / descending / clear, move left / right, hide, pin, autosize, reset columns — each item only when its callback is given. | A table-wide column picker (DisplayMenu columns section) or row actions (DropdownMenu in a cell). | — | [Table](#data-display), [DataTable](#data-display), [DisplayMenu](#actions) | — |
+| **DataTableLoadMore** (experimental)<br>parts: `DataTableSpacerRow`<br>also: `useDataTableVirtualRows`, `useScrollRestoration`<br>since unreleased | The foot of a virtualised infinite list: an IntersectionObserver sentinel plus a visible "Load more" button and an end-of-list status; `useDataTableVirtualRows` windows the rows with spacer rows, `useScrollRestoration` returns the user to the same rows. | A paged list (DataTablePagination) or a short list that renders every row. | — | [DataTable](#data-display), [ListPage](#layout), [Table](#data-display) | — |
 
 ## Media
 
@@ -339,6 +344,7 @@ Charts, previews and brand artwork.
 | **PdfPreview**<br>since 1.7.0 | Render a PDF inline with paging and zoom. | A spreadsheet (`SpreadsheetPreview`) or just a file row (`AttachmentChip`). | — | [SpreadsheetPreview](#media), [AttachmentChip](#data-display), [AspectRatio](#layout) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/pdf-preview.stories.tsx) |
 | **SpreadsheetPreview**<br>since 1.7.0 | Render a spreadsheet's sheets and cells inline. | A PDF (`PdfPreview`) or an editable grid (`Grid`). | — | [PdfPreview](#media), [Table](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/spreadsheet-preview.stories.tsx) |
 | **Logo** (`/suite`)<br>since 0.0.0 | The Assure suite or product wordmark: official artwork with a glyph + text fallback; `assetPath` resolves the artwork base. | A small product mark alone (brand icon family). | `<img src="/brand/….svg">` | [Sidebar](#shell-screens), [assetPath](#hooks-utilities) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/logo.stories.tsx) |
+| **TaxSoftwareLogo** (`/suite`)<br>since 1.48.0 | Identifying a professional tax-software product (CCH Axcess, UltraTax CS, ATX, TaxAct, ProConnect, ProSeries, Lacerte, Drake) beside its name in a connect / import / export picker: the vendor's official mark on a white plate, initials `Avatar` fallback for vendors without one. | An Assure product mark (`Logo`, brand icon family), any other third-party brand, or a generic glyph (icon catalogue). | `<img src="…vendor-logo.svg">`, `<svg> (vendor mark)` | [Avatar](#data-display), [Logo](#media) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/tax-software-logo.stories.tsx) |
 
 ## Icons
 
@@ -382,7 +388,7 @@ The application frame and full-screen composites: shell, sidebar, header, brand
 | Component | Use when | Don't use when | Replaces raw HTML | Related | Links |
 | --- | --- | --- | --- | --- | --- |
 | **Shell**<br>parts: `Main`, `Content`<br>since 0.3.0 | The application frame: `Shell` holds the `Sidebar` and `Main`; `Main` holds `AppHeader` and `Content`. | A public or marketing page (`Section`). | `<div class="flex h-screen">` | [Sidebar](#shell-screens), [AppHeader](#shell-screens), [BrandScope](#shell-screens) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/shell.stories.tsx) |
-| **Sidebar**<br>parts: `SidebarProvider`, `SidebarTrigger`, `SidebarBrand`, `SidebarBrandText`, `SidebarSection`, `SidebarLinkGroup`, `SidebarLink`, `SidebarLinkLabel`, `SidebarLinkBadge`, `SidebarLinkAction`, `SidebarPinButton`, `SidebarUser`, `SidebarFooter`<br>also: `sidebarLinkBadgeVariants`, `useSidebarState`, `useSidebarPeekLock`<br>since 0.3.0 | The app navigation rail: expanded/collapsed/peek states from `SidebarProvider`, brand, sections, link groups with badges and actions, user and footer. | Mobile (`BottomNav`) or a rail of records (`ClientRailItem`). | `<aside> + <nav> hand-rolled` | [Shell](#shell-screens), [SidebarBrandSwitcher](#shell-screens), [BottomNav](#navigation), [SidebarDrawer](#shell-screens) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/sidebar.stories.tsx) |
+| **Sidebar**<br>parts: `SidebarProvider`, `SidebarTrigger`, `SidebarBrand`, `SidebarBrandText`, `SidebarSection`, `SidebarLinkGroup`, `SidebarLink`, `SidebarLinkLabel`, `SidebarLinkBadge`, `SidebarLinkAction`, `SidebarPinButton`, `SidebarUser`, `SidebarFooter`<br>also: `sidebarLinkBadgeVariants`, `useSidebarState`, `useSidebarPeekLock`<br>since 0.3.0 | The app navigation rail: two states (expanded / collapsed icon rail) from `SidebarProvider`, brand, sections, link groups with badges and actions, user and footer. | Mobile (`BottomNav`) or a rail of records (`ClientRailItem`). | `<aside> + <nav> hand-rolled` | [Shell](#shell-screens), [SidebarBrandSwitcher](#shell-screens), [BottomNav](#navigation), [SidebarDrawer](#shell-screens) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/sidebar.stories.tsx) |
 | **SidebarBrandSwitcher** (`/suite`)<br>parts: `SidebarBrandSwitcherTile` (`/suite`)<br>since 0.11.2 | Switch between Assure products from the sidebar brand slot: tiles for available, current and coming-soon products. | A single-product app (`SidebarBrand`). | — | [Sidebar](#shell-screens), [BrandScope](#shell-screens), [Logo](#media) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/sidebar-brand-switcher.stories.tsx) |
 | **AppHeader**<br>parts: `AppHeaderBreadcrumb`, `AppHeaderTitle`, `AppHeaderSearch`, `AppHeaderActions`<br>since 0.3.0 | The sticky 56px top bar inside `Main`: breadcrumb, title, search and actions slots in any order. | The page's own title block (`PageHeader`). | — | [Shell](#shell-screens), [PageHeader](#layout), [NewMenu](#actions), [NotificationPanel](#data-display) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/app-header.stories.tsx) |
 | **DesignSystemProvider** (experimental)<br>also: `useDsMessages`<br>since unreleased | Mount once in the root layout to configure the whole design system: `messages` overrides for the generic strings components render, `locale` (default `en-US`, pass the one your app knows server-side), `dir`, the portal container, the router `linkComponent` and `imageComponent` for `LinkButton` and `Logo`, the tooltip provider, and opt-in `toasts` / `confirm` regions. `useDsMessages(namespace, override?)` reads the resolved strings inside your own components. | You are on Next.js — `NextDesignSystemProvider` from `/next` fills in the adapters. Theming a subtree is `ThemeScope` / `BrandScope`, not a nested provider. | `hand-rolled i18n or router context for design-system strings and links` | [ThemeScope](#shell-screens), [BrandScope](#shell-screens), [Tooltip](#overlays), [LinkButton](#actions), [Logo](#media) | [story](https://github.com/Assure-One/design-system/blob/main/src/foundation/provider/design-system-provider.stories.tsx) |
@@ -403,6 +409,7 @@ Non-rendering exports: hooks, class-name helpers, formatters and token objects.
 | **QUESTION_TYPE_CONTRACT_VERSION** (experimental) (`/suite`)<br>since 1.39.0 | Check which version of the question-type contract the installed DS implements before trusting a stored questionnaire. | Rendering a question — use `Questions` / `QuestionnairePanel`. | — | [QUESTION_TYPES](#hooks-utilities), [Questions](#forms) | [story](https://github.com/Assure-One/design-system/blob/main/src/composites/questions.stories.tsx) |
 | **cn**<br>since 0.0.0 | Merge class names (clsx + tailwind-merge) when composing `className`; consumer classes still win by cascade, `cn` only dedupes. | Overriding a component part — pass `className`/`classNames` instead of rebuilding its classes. | — | [Button](#actions) | [docs](https://github.com/Assure-One/design-system/blob/main/docs/integration/css.md) |
 | **Data-table controller** (experimental)<br>also: `compareSortValues`, `nextSortDirection`<br>since unreleased | Building a data table: owns sorting, pagination, search, selection, column visibility and filters (each controllable or uncontrolled), derives the rows to render, and in `manual` mode only emits state for a server-driven table. | A static table with no state (the `Table` parts alone), or the data-driven convenience (`DataTableView`) once it is rebuilt on the hook. | — | [Table](#data-display), [DataTable](#data-display), [DataTableView](#data-display), [Pagination](#navigation) | [story](https://github.com/Assure-One/design-system/blob/main/src/primitives/behavior/data-table/use-data-table.stories.tsx) · [docs](https://github.com/Assure-One/design-system/blob/main/docs/data-tables.md) |
+| **Data-table grouping** (experimental)<br>also: `DATA_TABLE_NO_GROUPING`<br>since unreleased | A table grouped by one dimension (a DisplayMenu grouping section's value): partitions rows into groups, flattens group headers and the rows of open groups for `TableGroupRow` and `useDataTableVirtualRows`, with collapse state controllable or persisted per dimension. | An ungrouped table, or groups the server already returns as sections (render `TableGroupRow` from that data). | — | [useDataTable](#hooks-utilities), [TableGroupRow](#data-display), [DisplayMenu](#actions), [DataTableLoadMore](#data-display) | — |
 | **useFieldControl** (experimental)<br>since 1.32.0 | Building your own form control that should bind to `Field` like the design-system ones: returns ids, `aria-*`, invalid/disabled/required wiring; explicit props win. | Wrapping an existing element once (`FieldControl`). | — | [Field](#forms), [FieldControl](#forms) | [docs](https://github.com/Assure-One/design-system/blob/main/docs/adr/006-field-native-form-participation.md) |
 | **Date utilities**<br>also: `displayToIso`, `applyMask`, `applyYearMask`, `isoToDate`, `dateToIso`, `isoToYear`, `yearToIso`, `DATE_DISPLAY_PLACEHOLDER`, `YEAR_DISPLAY_PLACEHOLDER`<br>since 0.11.0 | Convert between ISO `YYYY-MM-DD`, the `MM/DD/YYYY` display format and JS `Date` the way `DatePicker` does, and apply its typing masks. | Locale-aware formatting for display text (`Intl.DateTimeFormat`). | — | [DatePicker](#forms), [DateRangePicker](#forms) | — |
 | **Country codes**<br>also: `getFlagEmoji`, `parsePhoneForEditing`<br>since 1.1.0 | The ISO country / dial-code table behind `PhoneCountryInput`, a flag emoji fallback, and splitting a stored phone string for editing. | Full phone validation (bring libphonenumber). | — | [PhoneField](#forms), [PhoneCountryInput](#forms) | — |
@@ -430,6 +437,8 @@ The raw element or pattern on the left already has a design-system component. Wr
 | `<div class="border-t">` | [Separator](#layout) |
 | `<div class="flex flex-col gap-4">` | [Stack](#layout) |
 | `<div class="flex flex-wrap items-center gap-2">` | [Inline](#layout) |
+| `<div class="flex gap-1"> of hand-rolled filter pills with × buttons` | [FilterChips](#actions) |
+| `<div class="flex h-full flex-col overflow-hidden"> around a toolbar and an overflow-auto table` | [ListPage](#layout) |
 | `<div class="flex h-screen">` | [Shell](#shell-screens) |
 | `<div class="flex items-center gap-2"> above a list` | [Toolbar](#actions) |
 | `<div class="flex items-center justify-between"><h1>` | [PageHeader](#layout) |
@@ -454,6 +463,7 @@ The raw element or pattern on the left already has a design-system component. Wr
 | `<hr>` | [Separator](#layout) |
 | `<img class="rounded-full">` | [Avatar](#data-display) |
 | `<img src="…logo.svg">` | [Brand icons](#icons) |
+| `<img src="…vendor-logo.svg">` | [TaxSoftwareLogo](#media) |
 | `<img src="/brand/….svg">` | [Logo](#media) |
 | `<input list> + <datalist>` | [Combobox](#selection) |
 | `<input type="button">` | [Button](#actions) |
@@ -499,6 +509,7 @@ The raw element or pattern on the left already has a design-system component. Wr
 | `<span>—</span>` | [EmptyValue](#data-display) |
 | `<svg title>` | [InfoHint](#data-display) |
 | `<svg>` | [Icons](#icons) |
+| `<svg> (vendor mark)` | [TaxSoftwareLogo](#media) |
 | `<table>` | [Table](#data-display) |
 | `<table> + hand-rolled toolbar and pager` | [DataTable](#data-display) |
 | `<table> of <input>s` | [Grid](#forms) |
@@ -528,6 +539,7 @@ The raw element or pattern on the left already has a design-system component. Wr
 | `flex row of avatars with negative margins and a +N circle` | [AvatarGroup](#data-display) |
 | `group of <button aria-pressed>` | [ToggleGroup](#selection) |
 | `hand-rolled assignee popover with checkboxes` | [PeoplePicker](#selection) |
+| `hand-rolled grid of KPI <div>s above a table` | [StatStrip](#data-display) |
 | `hand-rolled i18n or router context for design-system strings and links` | [DesignSystemProvider](#shell-screens) |
 | `hand-rolled toast portal` | [ToastProvider](#feedback) |
 | `hand-rolled toolbar + <table> + pager around per-table useState` | [DataTable (compound)](#data-display) |
@@ -555,7 +567,7 @@ The raw element or pattern on the left already has a design-system component. Wr
 
 ## Deprecated aliases and their replacements
 
-Every deprecated name keeps rendering exactly what it did (zero visual diff) until 3.0. The codemod column names the transform in [`codemods/README.md`](../codemods/README.md) that rewrites call sites (`node node_modules/@assure-one/design-system/codemods/run.mjs <id> src`); a dash means the change is a hand edit. Deprecated exports in the API report: `ArrowRightSmallIcon`, `CloseIcon`, `CountryFlag`, `CountrySelect`, `FormError`, `FormSection`, `FormSuccess`, `PhoneCountryInput`, `PhoneInput`, `SearchSelect`, `SideDrawer`.
+Every deprecated name keeps rendering exactly what it did (zero visual diff) until 3.0. The codemod column names the transform in [`codemods/README.md`](../codemods/README.md) that rewrites call sites (`node node_modules/@assure-one/design-system/codemods/run.mjs <id> src`); a dash means the change is a hand edit. Deprecated exports in the API report: `ArrowRightSmallIcon`, `CloseIcon`, `CountryFlag`, `CountrySelect`, `FormError`, `FormSection`, `FormSuccess`, `PhoneCountryInput`, `PhoneInput`, `SearchSelect`, `SideDrawer`, `useSidebarPeekLock`.
 
 | Deprecated | Use instead | Codemod | Contract |
 | --- | --- | --- | --- |