@assure-one/design-system 1.47.1 → 1.49.0

package/docs/components.registry.json

@@ -653,9 +653,18 @@
       "category": "actions",
       "parts": [
         "BulkActionBarAction",
-        "BulkActionBarSeparator"
+        "BulkActionBarSeparator",
+        "BulkActionBarMenu",
+        "BulkActionBarMenuRadioGroup",
+        "BulkActionBarMenuItem",
+        "BulkActionBarMenuSub",
+        "BulkActionBarMore",
+        "BulkActionBarPicker"
       ],
-      "useWhen": "A floating bar that appears when rows are selected: selection count, actions, separators, clear.",
+      "helpers": [
+        "sharedBulkValue"
+      ],
+      "useWhen": "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.",
       "dontUseWhen": "Actions apply to one record (row menu via `DropdownMenu`) or belong to the page (`PageHeader` actions).",
       "related": [
         "DataTable",
@@ -688,14 +697,29 @@
     },
     "DisplayMenu": {
       "category": "actions",
-      "useWhen": "The Linear-style Display control of a list surface: filters, grouping, ordering and column visibility in one searchable menu, driven by a `sections` array.",
+      "useWhen": "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.",
       "dontUseWhen": "There is one filter (`FilterChip`) or one multi-value filter (`MultiFilterPill`).",
       "related": [
         "Toolbar",
         "MultiFilterPill",
-        "DataTableView"
+        "DataTableView",
+        "FilterChips",
+        "ListPage",
+        "TableDensityToggle"
       ],
-      "since": "1.25.0"
+      "since": "1.25.0",
+      "helpers": [
+        "detectDisplayMenuDatePreset",
+        "isDisplayMenuSectionActive",
+        "matchesDisplayMenuDate",
+        "matchesDisplayMenuNumber",
+        "matchesDisplayMenuOperator",
+        "matchesDisplayMenuTags",
+        "matchesDisplayMenuText",
+        "parseDisplayMenuNumber",
+        "resolveDisplayMenuDatePreset",
+        "summarizeDisplayMenuSection"
+      ]
     },
     "Toolbar": {
       "category": "actions",
@@ -1809,7 +1833,7 @@
         "DropdownMenuSubTrigger",
         "DropdownMenuSubContent"
       ],
-      "useWhen": "A menu of actions from a button: items, checkbox and radio items, groups, shortcuts, submenus; `/testing` ships `openMenu`.",
+      "useWhen": "A menu of actions from a button: items, checkbox and radio items, groups, shortcuts, submenus; `/testing` ships `openMenu`. Radio items that lead with their own glyph (a status dot, an icon) take `indicator=\"check\"`.",
       "dontUseWhen": "Choosing a form value (`Select`), right-click (`ContextMenu`) or a form inside (`Popover`).",
       "replacesRawHtml": [
         "<ul> shown on click",
@@ -2403,7 +2427,8 @@
         "TableHead",
         "TableCell",
         "TableCaption",
-        "TableGroupRow"
+        "TableGroupRow",
+        "TableCellSecondary"
       ],
       "useWhen": "A bare semantic table with the design system's row, header and caption styling.",
       "dontUseWhen": "A records table with toolbar, sorting and pagination (`DataTable`, `DataTableView`) or an editable matrix (`Grid`).",
@@ -2451,7 +2476,8 @@
         "DataTableCellId",
         "DataTableCellDue",
         "DataTableCheckbox",
-        "DataTablePagination"
+        "DataTablePagination",
+        "DataTableCellSecondary"
       ],
       "useWhen": "The composable records table: card frame, toolbar with search and count, sortable headers, typed cells (name, mono, id, due), row checkbox, pagination.",
       "dontUseWhen": "A config-driven table is enough (`DataTableView`) or the table is a plain semantic one (`Table`).",
@@ -2561,6 +2587,25 @@
       ],
       "since": "0.4.1"
     },
+    "StatStrip": {
+      "category": "data display",
+      "status": "experimental",
+      "parts": [
+        "StatStripItem"
+      ],
+      "useWhen": "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.",
+      "dontUseWhen": "A dashboard of independent tiles (`KpiCard` in a `DashGrid`) or one number inside running content (`Stat`).",
+      "replacesRawHtml": [
+        "hand-rolled grid of KPI <div>s above a table"
+      ],
+      "related": [
+        "KpiCard",
+        "SelectableKpiCard",
+        "ProgressBar",
+        "DataTable"
+      ],
+      "since": "unreleased"
+    },
     "Badge": {
       "category": "data display",
       "helpers": [
@@ -3041,6 +3086,20 @@
       ],
       "since": "0.0.0"
     },
+    "TaxSoftwareLogo": {
+      "category": "media",
+      "useWhen": "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.",
+      "dontUseWhen": "An Assure product mark (`Logo`, brand icon family), any other third-party brand, or a generic glyph (icon catalogue).",
+      "replacesRawHtml": [
+        "<img src=\"…vendor-logo.svg\">",
+        "<svg> (vendor mark)"
+      ],
+      "related": [
+        "Avatar",
+        "Logo"
+      ],
+      "since": "1.48.0"
+    },
     "Shell": {
       "category": "shell/screens",
       "parts": [
@@ -3083,7 +3142,7 @@
         "useSidebarState",
         "useSidebarPeekLock"
       ],
-      "useWhen": "The app navigation rail: expanded/collapsed/peek states from `SidebarProvider`, brand, sections, link groups with badges and actions, user and footer.",
+      "useWhen": "The app navigation rail: two states (expanded / collapsed icon rail) from `SidebarProvider`, brand, sections, link groups with badges and actions, user and footer.",
       "dontUseWhen": "Mobile (`BottomNav`) or a rail of records (`ClientRailItem`).",
       "replacesRawHtml": [
         "<aside> + <nav> hand-rolled"
@@ -3237,6 +3296,22 @@
         "docs/data-tables.md"
       ]
     },
+    "useDataTableGrouping": {
+      "category": "hooks/utilities",
+      "label": "Data-table grouping",
+      "helpers": [
+        "DATA_TABLE_NO_GROUPING"
+      ],
+      "useWhen": "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.",
+      "dontUseWhen": "An ungrouped table, or groups the server already returns as sections (render `TableGroupRow` from that data).",
+      "related": [
+        "useDataTable",
+        "TableGroupRow",
+        "DisplayMenu",
+        "DataTableLoadMore"
+      ],
+      "since": "unreleased"
+    },
     "useFieldControl": {
       "category": "hooks/utilities",
       "useWhen": "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.",
@@ -3407,6 +3482,75 @@
         "SidebarDrawer"
       ],
       "since": "unreleased"
+    },
+    "FilterChips": {
+      "category": "actions",
+      "hooks": [
+        "useDisplayMenuFilterChips"
+      ],
+      "useWhen": "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`.",
+      "dontUseWhen": "A single on/off filter toggle in a toolbar (`FilterChip`) or a dismissible tag that is not a filter (`Chip` with `onRemove`).",
+      "replacesRawHtml": [
+        "<div class=\"flex gap-1\"> of hand-rolled filter pills with × buttons"
+      ],
+      "related": [
+        "DisplayMenu",
+        "ListPage",
+        "Chip",
+        "Toolbar"
+      ],
+      "since": "unreleased"
+    },
+    "DataTableHeaderMenu": {
+      "category": "data display",
+      "useWhen": "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.",
+      "dontUseWhen": "A table-wide column picker (DisplayMenu columns section) or row actions (DropdownMenu in a cell).",
+      "related": [
+        "Table",
+        "DataTable",
+        "DisplayMenu"
+      ],
+      "since": "unreleased"
+    },
+    "DataTableLoadMore": {
+      "category": "data display",
+      "parts": [
+        "DataTableSpacerRow"
+      ],
+      "hooks": [
+        "useDataTableVirtualRows",
+        "useScrollRestoration"
+      ],
+      "useWhen": "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.",
+      "dontUseWhen": "A paged list (DataTablePagination) or a short list that renders every row.",
+      "related": [
+        "DataTable",
+        "ListPage",
+        "Table"
+      ],
+      "since": "unreleased"
+    },
+    "ListPage": {
+      "category": "layout",
+      "parts": [
+        "ListPageToolbar",
+        "ListPageResultCount",
+        "ListPageTable",
+        "ListPageScroll"
+      ],
+      "useWhen": "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.",
+      "dontUseWhen": "A table embedded in a detail page or card (Table / DataTable directly), or a page whose body is not one list.",
+      "replacesRawHtml": [
+        "<div class=\"flex h-full flex-col overflow-hidden\"> around a toolbar and an overflow-auto table"
+      ],
+      "related": [
+        "DataTable",
+        "FilterChips",
+        "DisplayMenu",
+        "BulkActionBar",
+        "Table"
+      ],
+      "since": "unreleased"
     }
   },
   "entries": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assure-one/design-system",
-  "version": "1.47.1",
+  "version": "1.49.0",
   "description": "Assure One design system — tokens, primitives, and patterns for the Assure Suite.",
   "license": "UNLICENSED",
   "private": false,
@@ -116,6 +116,7 @@
     "@radix-ui/react-toolbar": "^1.1.11",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@radix-ui/react-visually-hidden": "^1.2.4",
+    "@tanstack/react-virtual": "^3.14.13",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",