@flanksource/clicky-ui 0.3.15 → 0.3.17

package/dist/data/DataTable.d.ts

@@ -8,6 +8,7 @@ import { StaticIconComponent } from './Icon';
 import { TimestampOptions } from './cells/timestamp-format';
 import { TagActionsContextValue, TagsOptions } from './cells/tag-utils';
 import { BadgeStatus } from './Badge';
+import { DataTableGrouping } from './DataTable.grouping';
 export type { TimestampOptions, TagsOptions };
 export type DataTableColumnKind = "timestamp" | "tags" | "status";
 export type StatusOptions<T extends Record<string, unknown> = Record<string, unknown>> = {
@@ -122,9 +123,27 @@ export type DataTableRowSelection<T extends Record<string, unknown> = Record<str
     /** Toggle selection when the user clicks anywhere on a selectable row. */
     toggleOnRowClick?: boolean;
 };
+/** Passed to `selectionActions` while rows are selected. */
+export type DataTableSelectionContext<T extends Record<string, unknown> = Record<string, unknown>> = {
+    selectedRowIds: string[];
+    /** The selected rows currently loaded, in render order. */
+    selectedRows: T[];
+    /** Empties the selection through the same `onSelectionChange` callback. */
+    clearSelection: () => void;
+};
+/** Passed to a `footer` render function. */
+export type DataTableFooterContext = {
+    /** Rows left after filtering — what the table is showing. */
+    visibleRowCount: number;
+    /** Rows handed to the table before filtering. */
+    totalRowCount: number;
+    loading: boolean;
+};
 type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unknown>> = {
     /** Rows to render. The table does not fetch or mutate row data. */
     data: T[];
+    /** Error content rendered as an accessible full-width row in the table body. */
+    error?: ReactNode;
     /**
      * Column descriptors. Pass a bare string for a default column —
      * `"foo"` is equivalent to `{ key: "foo", label: "foo" }` — handy for
@@ -213,6 +232,28 @@ type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unkn
     getRowId?: (row: T, index: number) => string;
     /** Controlled checkbox selection for entity/bulk-action tables. */
     rowSelection?: DataTableRowSelection<T>;
+    /**
+     * Bulk action bar, pinned to the bottom of the table shell while
+     * `rowSelection` holds a non-empty selection. Ignored without `rowSelection`.
+     */
+    selectionActions?: (context: DataTableSelectionContext<T>) => ReactNode;
+    /**
+     * Extra classes for a row's `<tr>`, applied last so tailwind-merge lets the
+     * caller override the built-in hover / selected backgrounds.
+     */
+    getRowClassName?: (row: T) => string | undefined;
+    /**
+     * Replaces the default "N of M rows" strip below the table. When
+     * `pagination` is also set, this renders directly above the pager instead.
+     */
+    footer?: ReactNode | ((context: DataTableFooterContext) => ReactNode);
+    /**
+     * Splits the rendered rows into collapsible groups, each introduced by a
+     * full-width header row. Grouping presents what is already on screen: it
+     * runs after filtering, sorting and pagination, so it never reorders rows
+     * within a group and never pulls in rows from another page.
+     */
+    grouping?: DataTableGrouping<T>;
     /** Called when a clickable row is selected. */
     onRowClick?: (row: T) => void;
     /** Predicate controlling whether a row is clickable. */

package/dist/data/DataTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../src/data/DataTable.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../src/data/DataTable.tsx"],"names":[],"mappings":"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"}

package/dist/data/DataTable.grouping.cjs

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function groupRecords(records, getGroupKey) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    const key = getGroupKey(record);
+    const bucket = byKey.get(key);
+    if (bucket) bucket.push(record);
+    else byKey.set(key, [record]);
+  }
+  return Array.from(byKey, ([key, rows]) => ({ key, rows }));
+}
+function isGroupCollapsedByDefault(group, defaultCollapsed) {
+  if (typeof defaultCollapsed === "function") {
+    return defaultCollapsed(group.key, group.rows);
+  }
+  return defaultCollapsed === true;
+}
+exports.groupRecords = groupRecords;
+exports.isGroupCollapsedByDefault = isGroupCollapsedByDefault;
+//# sourceMappingURL=DataTable.grouping.cjs.map

package/dist/data/DataTable.grouping.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.grouping.cjs","sources":["../../src/data/DataTable.grouping.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\n\n/** One contiguous run of rows sharing a group key, in post-sort order. */\nexport type DataTableGroup<T> = {\n  key: string;\n  rows: T[];\n};\n\nexport type DataTableGrouping<T> = {\n  /** Groups rows by the returned key. */\n  getGroupKey: (row: T) => string;\n  /** Human label for a group header. Defaults to the group key. */\n  getGroupLabel?: (key: string, rows: T[]) => ReactNode;\n  /** Summary rendered at the trailing edge of the group header. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /** Whether a group starts collapsed. Defaults to expanded. */\n  defaultCollapsed?: boolean | ((key: string, rows: T[]) => boolean);\n  /** Reorders groups. Omit to keep first-appearance order, which follows the sort. */\n  compareGroups?: (a: DataTableGroup<T>, b: DataTableGroup<T>) => number;\n};\n\n/**\n * Buckets `records` by `getGroupKey`, preserving first-appearance order so\n * grouping never fights the active sort. Pure — no React, no DOM.\n */\nexport function groupRecords<T>(\n  records: readonly T[],\n  getGroupKey: (row: T) => string,\n): Array<DataTableGroup<T>> {\n  const byKey = new Map<string, T[]>();\n  for (const record of records) {\n    const key = getGroupKey(record);\n    const bucket = byKey.get(key);\n    if (bucket) bucket.push(record);\n    else byKey.set(key, [record]);\n  }\n  return Array.from(byKey, ([key, rows]) => ({ key, rows }));\n}\n\n/** Resolves `defaultCollapsed` for one group. */\nexport function isGroupCollapsedByDefault<T>(\n  group: DataTableGroup<T>,\n  defaultCollapsed: DataTableGrouping<T>[\"defaultCollapsed\"],\n): boolean {\n  if (typeof defaultCollapsed === \"function\") {\n    return defaultCollapsed(group.key, group.rows);\n  }\n  return defaultCollapsed === true;\n}\n"],"names":[],"mappings":";;AAyBO,SAAS,aACd,SACA,aAC0B;AAC1B,QAAM,4BAAY,IAAA;AAClB,aAAW,UAAU,SAAS;AAC5B,UAAM,MAAM,YAAY,MAAM;AAC9B,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,OAAQ,QAAO,KAAK,MAAM;AAAA,QACzB,OAAM,IAAI,KAAK,CAAC,MAAM,CAAC;AAAA,EAC9B;AACA,SAAO,MAAM,KAAK,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,EAAE,KAAK,KAAA,EAAO;AAC3D;AAGO,SAAS,0BACd,OACA,kBACS;AACT,MAAI,OAAO,qBAAqB,YAAY;AAC1C,WAAO,iBAAiB,MAAM,KAAK,MAAM,IAAI;AAAA,EAC/C;AACA,SAAO,qBAAqB;AAC9B;;;"}

package/dist/data/DataTable.grouping.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+/** One contiguous run of rows sharing a group key, in post-sort order. */
+export type DataTableGroup<T> = {
+    key: string;
+    rows: T[];
+};
+export type DataTableGrouping<T> = {
+    /** Groups rows by the returned key. */
+    getGroupKey: (row: T) => string;
+    /** Human label for a group header. Defaults to the group key. */
+    getGroupLabel?: (key: string, rows: T[]) => ReactNode;
+    /** Summary rendered at the trailing edge of the group header. */
+    getGroupMeta?: (key: string, rows: T[]) => ReactNode;
+    /** Whether a group starts collapsed. Defaults to expanded. */
+    defaultCollapsed?: boolean | ((key: string, rows: T[]) => boolean);
+    /** Reorders groups. Omit to keep first-appearance order, which follows the sort. */
+    compareGroups?: (a: DataTableGroup<T>, b: DataTableGroup<T>) => number;
+};
+/**
+ * Buckets `records` by `getGroupKey`, preserving first-appearance order so
+ * grouping never fights the active sort. Pure — no React, no DOM.
+ */
+export declare function groupRecords<T>(records: readonly T[], getGroupKey: (row: T) => string): Array<DataTableGroup<T>>;
+/** Resolves `defaultCollapsed` for one group. */
+export declare function isGroupCollapsedByDefault<T>(group: DataTableGroup<T>, defaultCollapsed: DataTableGrouping<T>["defaultCollapsed"]): boolean;
+//# sourceMappingURL=DataTable.grouping.d.ts.map

package/dist/data/DataTable.grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.grouping.d.ts","sourceRoot":"","sources":["../../src/data/DataTable.grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,EAAE,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,uCAAuC;IACvC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAChC,iEAAiE;IACjE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;IACtD,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;IACrD,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACnE,oFAAoF;IACpF,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;CACxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAC9B,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAS1B;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,GACzD,OAAO,CAKT"}

package/dist/data/DataTable.grouping.js

@@ -0,0 +1,21 @@
+function groupRecords(records, getGroupKey) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    const key = getGroupKey(record);
+    const bucket = byKey.get(key);
+    if (bucket) bucket.push(record);
+    else byKey.set(key, [record]);
+  }
+  return Array.from(byKey, ([key, rows]) => ({ key, rows }));
+}
+function isGroupCollapsedByDefault(group, defaultCollapsed) {
+  if (typeof defaultCollapsed === "function") {
+    return defaultCollapsed(group.key, group.rows);
+  }
+  return defaultCollapsed === true;
+}
+export {
+  groupRecords,
+  isGroupCollapsedByDefault
+};
+//# sourceMappingURL=DataTable.grouping.js.map

package/dist/data/DataTable.grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.grouping.js","sources":["../../src/data/DataTable.grouping.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\n\n/** One contiguous run of rows sharing a group key, in post-sort order. */\nexport type DataTableGroup<T> = {\n  key: string;\n  rows: T[];\n};\n\nexport type DataTableGrouping<T> = {\n  /** Groups rows by the returned key. */\n  getGroupKey: (row: T) => string;\n  /** Human label for a group header. Defaults to the group key. */\n  getGroupLabel?: (key: string, rows: T[]) => ReactNode;\n  /** Summary rendered at the trailing edge of the group header. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /** Whether a group starts collapsed. Defaults to expanded. */\n  defaultCollapsed?: boolean | ((key: string, rows: T[]) => boolean);\n  /** Reorders groups. Omit to keep first-appearance order, which follows the sort. */\n  compareGroups?: (a: DataTableGroup<T>, b: DataTableGroup<T>) => number;\n};\n\n/**\n * Buckets `records` by `getGroupKey`, preserving first-appearance order so\n * grouping never fights the active sort. Pure — no React, no DOM.\n */\nexport function groupRecords<T>(\n  records: readonly T[],\n  getGroupKey: (row: T) => string,\n): Array<DataTableGroup<T>> {\n  const byKey = new Map<string, T[]>();\n  for (const record of records) {\n    const key = getGroupKey(record);\n    const bucket = byKey.get(key);\n    if (bucket) bucket.push(record);\n    else byKey.set(key, [record]);\n  }\n  return Array.from(byKey, ([key, rows]) => ({ key, rows }));\n}\n\n/** Resolves `defaultCollapsed` for one group. */\nexport function isGroupCollapsedByDefault<T>(\n  group: DataTableGroup<T>,\n  defaultCollapsed: DataTableGrouping<T>[\"defaultCollapsed\"],\n): boolean {\n  if (typeof defaultCollapsed === \"function\") {\n    return defaultCollapsed(group.key, group.rows);\n  }\n  return defaultCollapsed === true;\n}\n"],"names":[],"mappings":"AAyBO,SAAS,aACd,SACA,aAC0B;AAC1B,QAAM,4BAAY,IAAA;AAClB,aAAW,UAAU,SAAS;AAC5B,UAAM,MAAM,YAAY,MAAM;AAC9B,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,OAAQ,QAAO,KAAK,MAAM;AAAA,QACzB,OAAM,IAAI,KAAK,CAAC,MAAM,CAAC;AAAA,EAC9B;AACA,SAAO,MAAM,KAAK,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,EAAE,KAAK,KAAA,EAAO;AAC3D;AAGO,SAAS,0BACd,OACA,kBACS;AACT,MAAI,OAAO,qBAAqB,YAAY;AAC1C,WAAO,iBAAiB,MAAM,KAAK,MAAM,IAAI;AAAA,EAC/C;AACA,SAAO,qBAAqB;AAC9B;"}

package/dist/data/DataTable.js

@@ -19,8 +19,11 @@ import { TagActionsProvider, TagList } from "./cells/TagList.js";
 import { tagActionsFromRecord, tagFilterTokens, normalizeTags, splitTagToken } from "./cells/tag-utils.js";
 import { StatusDot } from "./cells/StatusDot.js";
 import { normalizeStatus } from "./cells/status-mapping.js";
+import { groupRecords, isGroupCollapsedByDefault } from "./DataTable.grouping.js";
 import { UiEllipsis } from "../icons/components/UiEllipsis.js";
 import { UiFilterFilled, UiFilter } from "../icons/components/UiFilter.js";
+import { UiChevronRight } from "../icons/components/UiChevronRight.js";
+import { UiChevronDown } from "../icons/components/UiChevronDown.js";
 import { UiArrowLeft } from "../icons/components/UiArrowLeft.js";
 import { UiArrowRight } from "../icons/components/UiArrowRight.js";
 import { UiEyeClosed } from "../icons/components/UiEyeClosed.js";
@@ -59,6 +62,7 @@ const TIMESTAMP_RANGE_PRESETS = [
 ];
 function DataTableInner({
   data,
+  error,
   columns: columnsInput,
   loading = false,
   loadingMessage = "Loading results…",
@@ -83,6 +87,10 @@ function DataTableInner({
   pagination,
   getRowId,
   rowSelection,
+  selectionActions,
+  getRowClassName,
+  footer,
+  grouping,
   onRowClick,
   isRowClickable,
   getRowHref,
@@ -316,13 +324,13 @@ function DataTableInner({
       const fitsMulti = options.length >= 2 && options.length <= multiCap;
       if (column.kind === "tags" && fitsMulti) {
         const separator = ((_a = column.tags) == null ? void 0 : _a.separator) ?? "=";
-        const groups = groupTagOptions(options, separator);
-        if (groups.length >= 2) {
+        const groups2 = groupTagOptions(options, separator);
+        if (groups2.length >= 2) {
           return {
             column,
             kind: "nested-multi",
             options,
-            groups
+            groups: groups2
           };
         }
       }
@@ -623,6 +631,74 @@ function DataTableInner({
     selectableVisibleRows,
     selectedRowIDs
   ]);
+  const selectionBar = useMemo(() => {
+    if (!rowSelection || !selectionActions) return null;
+    const selected = rows.filter((record) => selectedRowIDs.has(record.id));
+    if (selected.length === 0) return null;
+    return selectionActions({
+      selectedRowIds: selected.map((record) => record.id),
+      selectedRows: selected.map((record) => record.row),
+      clearSelection: () => notifySelection(/* @__PURE__ */ new Set())
+    });
+  }, [notifySelection, rowSelection, rows, selectedRowIDs, selectionActions]);
+  const renderedFooter = error != null ? null : footer !== void 0 ? typeof footer === "function" ? footer({
+    visibleRowCount: sorted.length,
+    totalRowCount: data.length,
+    loading
+  }) : footer : pagination ? null : loading ? loadingMessage : `${sorted.length} of ${data.length} row${data.length === 1 ? "" : "s"}`;
+  const [collapsedGroups, setCollapsedGroups] = useState({});
+  const groups = useMemo(() => {
+    if (!grouping) return null;
+    const buckets = groupRecords(
+      visibleSorted,
+      (record) => grouping.getGroupKey(record.row)
+    );
+    const resolved = buckets.map((bucket) => ({
+      key: bucket.key,
+      records: bucket.rows,
+      rows: bucket.rows.map((record) => record.row)
+    }));
+    if (grouping.compareGroups) {
+      resolved.sort((a, b) => grouping.compareGroups(a, b));
+    }
+    return resolved.map((group) => {
+      var _a, _b;
+      return {
+        ...group,
+        label: ((_a = grouping.getGroupLabel) == null ? void 0 : _a.call(grouping, group.key, group.rows)) ?? group.key,
+        meta: (_b = grouping.getGroupMeta) == null ? void 0 : _b.call(grouping, group.key, group.rows),
+        collapsed: collapsedGroups[group.key] ?? isGroupCollapsedByDefault(group, grouping.defaultCollapsed)
+      };
+    });
+  }, [collapsedGroups, grouping, visibleSorted]);
+  const rowStream = useMemo(() => {
+    if (!groups) {
+      return visibleSorted.map((record) => ({ kind: "row", record }));
+    }
+    return groups.flatMap((group) => [
+      { kind: "group", group },
+      ...group.collapsed ? [] : group.records.map((record) => ({ kind: "row", record }))
+    ]);
+  }, [groups, visibleSorted]);
+  const toggleGroupSelection = useCallback(
+    (records) => {
+      if (!rowSelection) return;
+      const selectable = records.filter(
+        (record) => {
+          var _a;
+          return ((_a = rowSelection.isRowSelectable) == null ? void 0 : _a.call(rowSelection, record.row)) ?? true;
+        }
+      );
+      const next = new Set(selectedRowIDs);
+      const allSelected = selectable.length > 0 && selectable.every((record) => next.has(record.id));
+      for (const record of selectable) {
+        if (allSelected) next.delete(record.id);
+        else next.add(record.id);
+      }
+      notifySelection(next);
+    },
+    [notifySelection, rowSelection, selectedRowIDs]
+  );
   const revealSentinelRef = useCallback(
     (node) => {
       if (revealObserver.current) revealObserver.current.disconnect();
@@ -715,7 +791,7 @@ function DataTableInner({
   return /* @__PURE__ */ jsx(DensityValueProvider, { density: densityOverride ?? "comfortable", children: /* @__PURE__ */ jsxs(
     "div",
     {
-      className: cn("flex min-h-0 min-w-0 flex-1 flex-col gap-3", className),
+      className: cn("flex min-h-0 min-w-0 flex-1 flex-col gap-1", className),
       "data-density": densityOverride,
       children: [
         showFilterBar && /* @__PURE__ */ jsx(
@@ -735,7 +811,7 @@ function DataTableInner({
           }
         ),
         /* @__PURE__ */ jsxs("div", { className: "relative flex min-h-0 max-w-full flex-1 flex-col", children: [
-          loading ? /* @__PURE__ */ jsx(LoadingBar, { "data-testid": "data-table-loading-bar", className: "rounded-t-md" }) : null,
+          loading && error == null ? /* @__PURE__ */ jsx(LoadingBar, { "data-testid": "data-table-loading-bar", className: "rounded-t-md" }) : null,
           /* @__PURE__ */ jsx(
             "div",
             {
@@ -743,10 +819,10 @@ function DataTableInner({
                 "min-h-0 max-w-full flex-1 overflow-auto overscroll-x-contain rounded-md border border-border",
                 scrollContainerClassName
               ),
-              "aria-busy": loading || void 0,
+              "aria-busy": loading && error == null || void 0,
               children: /* @__PURE__ */ jsxs("table", { className: "w-max min-w-full table-auto text-left text-sm", children: [
                 /* @__PURE__ */ jsxs("colgroup", { children: [
-                  rowSelection ? /* @__PURE__ */ jsx("col", { className: "w-10" }) : null,
+                  rowSelection && error == null ? /* @__PURE__ */ jsx("col", { className: "w-10" }) : null,
                   visibleColumns.map((column) => /* @__PURE__ */ jsx(
                     "col",
                     {
@@ -757,7 +833,7 @@ function DataTableInner({
                   ))
                 ] }),
                 /* @__PURE__ */ jsx("thead", { className: "sticky top-0 z-10 bg-muted shadow-[0_1px_0_0_var(--tw-shadow-color)] shadow-border", children: /* @__PURE__ */ jsxs("tr", { className: "border-b border-border text-xs text-muted-foreground", children: [
-                  rowSelection ? /* @__PURE__ */ jsx(
+                  rowSelection && error == null ? /* @__PURE__ */ jsx(
                     "th",
                     {
                       className: cn(
@@ -852,7 +928,13 @@ function DataTableInner({
                   ))
                 ] }) }),
                 /* @__PURE__ */ jsxs("tbody", { children: [
-                  loading && visibleSorted.length === 0 ? /* @__PURE__ */ jsx(
+                  error != null ? /* @__PURE__ */ jsx(
+                    DataTableErrorRow,
+                    {
+                      colSpan: visibleColumns.length,
+                      error
+                    }
+                  ) : loading && visibleSorted.length === 0 ? /* @__PURE__ */ jsx(
                     DataTableLoadingRows,
                     {
                       columns: visibleColumns,
@@ -860,8 +942,43 @@ function DataTableInner({
                       message: loadingMessage,
                       selection: !!rowSelection
                     }
-                  ) : visibleSorted.map((record) => {
+                  ) : rowStream.map((item) => {
                     var _a;
+                    if (item.kind === "group") {
+                      return /* @__PURE__ */ jsx(
+                        DataTableGroupHeaderRow,
+                        {
+                          label: item.group.label,
+                          meta: item.group.meta,
+                          count: item.group.records.length,
+                          colSpan: visibleColumns.length + (rowSelection ? 1 : 0),
+                          collapsed: item.group.collapsed,
+                          onToggleCollapsed: () => setCollapsedGroups((current) => ({
+                            ...current,
+                            [item.group.key]: !item.group.collapsed
+                          })),
+                          ...rowSelection ? {
+                            selection: {
+                              selectableCount: item.group.records.filter(
+                                (record2) => {
+                                  var _a2;
+                                  return ((_a2 = rowSelection.isRowSelectable) == null ? void 0 : _a2.call(
+                                    rowSelection,
+                                    record2.row
+                                  )) ?? true;
+                                }
+                              ).length,
+                              selectedCount: item.group.records.filter(
+                                (record2) => selectedRowIDs.has(record2.id)
+                              ).length,
+                              onToggle: () => toggleGroupSelection(item.group.records)
+                            }
+                          } : {}
+                        },
+                        `group:${item.group.key}`
+                      );
+                    }
+                    const record = item.record;
                     const href = getRowHref == null ? void 0 : getRowHref(record.row);
                     const expanded = expandedRows[record.id] ?? false;
                     const expandedContent = (renderExpandedRow == null ? void 0 : renderExpandedRow(record.row, {
@@ -883,7 +1000,8 @@ function DataTableInner({
                           className: cn(
                             "relative border-b border-border/60 align-top",
                             clickable && "cursor-pointer hover:bg-accent/40",
-                            selectedRowIDs.has(record.id) && "bg-accent/50"
+                            selectedRowIDs.has(record.id) && "bg-accent/50",
+                            getRowClassName == null ? void 0 : getRowClassName(record.row)
                           ),
                           onClick: () => {
                             if (selectionClickEnabled) toggleRowSelection(record);
@@ -982,7 +1100,7 @@ function DataTableInner({
                       ) })
                     ] }, record.id);
                   }),
-                  hasMoreRows && /* @__PURE__ */ jsx("tr", { ref: revealSentinelRef, "aria-hidden": true, children: /* @__PURE__ */ jsx(
+                  error == null && hasMoreRows && /* @__PURE__ */ jsx("tr", { ref: revealSentinelRef, "aria-hidden": true, children: /* @__PURE__ */ jsx(
                     "td",
                     {
                       colSpan: visibleColumns.length + (rowSelection ? 1 : 0),
@@ -995,7 +1113,16 @@ function DataTableInner({
             }
           )
         ] }),
-        pagination ? /* @__PURE__ */ jsx(
+        error == null && selectionBar ? /* @__PURE__ */ jsx(
+          "div",
+          {
+            "data-testid": "data-table-selection-actions",
+            className: "sticky bottom-2 z-10 flex shrink-0 items-center justify-between gap-density-3 rounded-md border border-border bg-card p-density-2 shadow-md",
+            children: selectionBar
+          }
+        ) : null,
+        renderedFooter !== null && /* @__PURE__ */ jsx("div", { className: "shrink-0 px-1 text-xs text-muted-foreground", children: renderedFooter }),
+        error == null && pagination ? /* @__PURE__ */ jsx(
           DataTablePaginationFooter,
           {
             pagination,
@@ -1003,7 +1130,7 @@ function DataTableInner({
             loading,
             loadingMessage
           }
-        ) : /* @__PURE__ */ jsx("div", { className: "shrink-0 px-1 text-xs text-muted-foreground", children: loading ? loadingMessage : `${sorted.length} of ${data.length} row${data.length === 1 ? "" : "s"}` }),
+        ) : null,
         detailStyle === "dialog" && renderExpandedRow && /* @__PURE__ */ jsx(
           Modal,
           {
@@ -1122,6 +1249,57 @@ function DataTablePaginationFooter({
     ] })
   ] });
 }
+function DataTableGroupHeaderRow({
+  label,
+  meta,
+  count,
+  colSpan,
+  collapsed,
+  onToggleCollapsed,
+  selection
+}) {
+  const allSelected = !!selection && selection.selectableCount > 0 && selection.selectedCount === selection.selectableCount;
+  const someSelected = !!selection && selection.selectedCount > 0 && !allSelected;
+  const checkboxRef = useRef(null);
+  useEffect(() => {
+    if (checkboxRef.current) checkboxRef.current.indeterminate = someSelected;
+  }, [someSelected]);
+  return /* @__PURE__ */ jsx("tr", { className: "border-b border-border/60 bg-muted/40", children: /* @__PURE__ */ jsx("td", { colSpan, className: "px-density-2 py-density-1", children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+    selection ? /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref: checkboxRef,
+        type: "checkbox",
+        "aria-label": `Select group ${typeof label === "string" ? label : count}`,
+        checked: allSelected,
+        disabled: selection.selectableCount === 0,
+        onChange: selection.onToggle,
+        className: "size-3.5 rounded border-border accent-primary"
+      }
+    ) : null,
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        "aria-expanded": !collapsed,
+        onClick: onToggleCollapsed,
+        className: "flex min-w-0 flex-1 items-center gap-1.5 text-left text-xs font-semibold text-foreground hover:text-primary",
+        children: [
+          /* @__PURE__ */ jsx(
+            Icon,
+            {
+              icon: collapsed ? UiChevronRight : UiChevronDown,
+              className: "shrink-0 text-muted-foreground"
+            }
+          ),
+          /* @__PURE__ */ jsx("span", { className: "truncate", children: label }),
+          /* @__PURE__ */ jsx("span", { className: "shrink-0 font-normal text-muted-foreground", children: count })
+        ]
+      }
+    ),
+    meta ? /* @__PURE__ */ jsx("div", { className: "shrink-0 text-xs text-muted-foreground", children: meta }) : null
+  ] }) }) });
+}
 function DataTableLoadingRows({
   columns,
   rowCount,
@@ -1177,6 +1355,19 @@ function DataTableLoadingRows({
     ] }, rowIndex))
   ] });
 }
+function DataTableErrorRow({
+  colSpan,
+  error
+}) {
+  return /* @__PURE__ */ jsx("tr", { className: "border-b border-border/60", children: /* @__PURE__ */ jsx(
+    "td",
+    {
+      colSpan: Math.max(1, colSpan),
+      className: cn(DATA_TABLE_CELL_DENSITY_CLASS, "p-density-3"),
+      children: /* @__PURE__ */ jsx("div", { role: "alert", children: error })
+    }
+  ) });
+}
 function HeaderFilterButton({
   column,
   active,