@flanksource/clicky-ui 0.3.22 → 0.3.24

package/dist/data/DataTable.d.ts

@@ -9,7 +9,7 @@ import { TimestampOptions } from './cells/timestamp-format';
 import { CellFilterChange, CellFilterMode } from './cells/CellFilterActions';
 import { TagActionsContextValue, TagsOptions } from './cells/tag-utils';
 import { BadgeStatus } from './Badge';
-import { DataTableGrouping } from './DataTable.grouping';
+import { DataTableGrouping, DataTableGroupingMode } from './DataTable.grouping';
 export type { TimestampOptions, TagsOptions };
 export type DataTableColumnKind = "timestamp" | "tags" | "status";
 export type StatusOptions<T extends Record<string, unknown> = Record<string, unknown>> = {
@@ -359,6 +359,14 @@ type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unkn
      * within a group and never pulls in rows from another page.
      */
     grouping?: DataTableGrouping<T>;
+    /** Selectable grouping strategies rendered in the native FilterBar picker. */
+    groupingModes?: Array<DataTableGroupingMode<T>>;
+    /** Controlled grouping-mode value. Requires `onGroupingModeChange`. */
+    groupingMode?: string;
+    /** Initial grouping mode when DataTable owns the picker state. */
+    defaultGroupingMode?: string;
+    /** Called when the native grouping picker changes. */
+    onGroupingModeChange?: (value: string) => void;
     /** 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

@@ -1,5 +1,27 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DATA_TABLE_EMPTY_GROUP_KEY = "\0empty";
+const DATA_TABLE_EMPTY_GROUP_LABEL = "(empty)";
+function dataTableGroupLabel(key, emptyGroupLabel) {
+  if (key !== DATA_TABLE_EMPTY_GROUP_KEY) return key;
+  return emptyGroupLabel ?? DATA_TABLE_EMPTY_GROUP_LABEL;
+}
+function dataTableGroupKey(value) {
+  if (value === null || value === void 0 || value === "") {
+    return DATA_TABLE_EMPTY_GROUP_KEY;
+  }
+  switch (typeof value) {
+    case "string":
+    case "number":
+    case "boolean":
+    case "bigint":
+      return String(value);
+    default:
+      throw new Error(
+        `DataTable automatic grouping requires scalar values; received ${Array.isArray(value) ? "array" : typeof value}`
+      );
+  }
+}
 function groupRecords(records, getGroupKey) {
   const byKey = /* @__PURE__ */ new Map();
   for (const record of records) {
@@ -16,6 +38,10 @@ function isGroupCollapsedByDefault(group, defaultCollapsed) {
   }
   return defaultCollapsed === true;
 }
+exports.DATA_TABLE_EMPTY_GROUP_KEY = DATA_TABLE_EMPTY_GROUP_KEY;
+exports.DATA_TABLE_EMPTY_GROUP_LABEL = DATA_TABLE_EMPTY_GROUP_LABEL;
+exports.dataTableGroupKey = dataTableGroupKey;
+exports.dataTableGroupLabel = dataTableGroupLabel;
 exports.groupRecords = groupRecords;
 exports.isGroupCollapsedByDefault = isGroupCollapsedByDefault;
 //# sourceMappingURL=DataTable.grouping.cjs.map

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

@@ -1 +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 DataTableGroupMetaAlign = \"start\" | \"end\";\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 in the group header, placed by `metaAlign`. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * Where `getGroupMeta` sits in the header row. `\"end\"` (the default) pins it\n   * to the trailing edge; `\"start\"` puts it immediately after the label and\n   * count, which keeps a per-group aggregate next to the thing it aggregates\n   * instead of a table-width away from it.\n   */\n  metaAlign?: DataTableGroupMetaAlign;\n  /** Classes applied to the `getGroupMeta` wrapper. */\n  metaClassName?: string;\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":";;AAoCO,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;;;"}
+{"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 DataTableGroupMetaAlign = \"start\" | \"end\";\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 in the group header, placed by `metaAlign`. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * Where `getGroupMeta` sits in the header row. `\"end\"` (the default) pins it\n   * to the trailing edge; `\"start\"` puts it immediately after the label and\n   * count, which keeps a per-group aggregate next to the thing it aggregates\n   * instead of a table-width away from it.\n   */\n  metaAlign?: DataTableGroupMetaAlign;\n  /** Classes applied to the `getGroupMeta` wrapper. */\n  metaClassName?: string;\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\ntype DataTableGroupingModeBase = {\n  /** Stable value used by the grouping picker and controlled state. */\n  value: string;\n  /** Text shown in the grouping picker. */\n  label: string;\n};\n\nexport type DataTableGroupingCustomMode<T> = DataTableGroupingModeBase &\n  DataTableGrouping<T> & {\n    type: \"custom\";\n  };\n\nexport type DataTableGroupingColumnMode<T> = DataTableGroupingModeBase &\n  Omit<DataTableGrouping<T>, \"getGroupKey\"> & {\n    type: \"column\";\n    /** Column key whose scalar value becomes the group key. */\n    columnKey: string;\n    /** Label used for null, undefined, or empty-string values. */\n    emptyGroupLabel?: string;\n  };\n\nexport type DataTableGroupingNoneMode = DataTableGroupingModeBase & {\n  type: \"none\";\n};\n\n/** One selectable grouping strategy for DataTable's native picker. */\nexport type DataTableGroupingMode<T> =\n  | DataTableGroupingCustomMode<T>\n  | DataTableGroupingColumnMode<T>\n  | DataTableGroupingNoneMode;\n\n/**\n * Internal group key for null/undefined/empty column values. It is deliberately\n * not the `emptyGroupLabel`: a row whose column literally reads \"Unassigned\"\n * must not be bucketed with the rows that have no value at all. Rendered through\n * `dataTableGroupLabel`, so readers still see the configured label.\n */\nexport const DATA_TABLE_EMPTY_GROUP_KEY = \"\\u0000empty\";\n\n/** Header label for the empty group when a mode does not configure its own. */\nexport const DATA_TABLE_EMPTY_GROUP_LABEL = \"(empty)\";\n\n/**\n * Maps an automatic group key back to its header label: the internal empty key\n * becomes the configured label, every other key is already its own label.\n */\nexport function dataTableGroupLabel(\n  key: string,\n  emptyGroupLabel?: string,\n): string {\n  if (key !== DATA_TABLE_EMPTY_GROUP_KEY) return key;\n  return emptyGroupLabel ?? DATA_TABLE_EMPTY_GROUP_LABEL;\n}\n\n/** Converts an automatic column-group value to the stable string key DataTable requires. */\nexport function dataTableGroupKey(value: unknown): string {\n  if (value === null || value === undefined || value === \"\") {\n    return DATA_TABLE_EMPTY_GROUP_KEY;\n  }\n  switch (typeof value) {\n    case \"string\":\n    case \"number\":\n    case \"boolean\":\n    case \"bigint\":\n      return String(value);\n    default:\n      throw new Error(\n        `DataTable automatic grouping requires scalar values; received ${Array.isArray(value) ? \"array\" : typeof value}`,\n      );\n  }\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":";;AAqEO,MAAM,6BAA6B;AAGnC,MAAM,+BAA+B;AAMrC,SAAS,oBACd,KACA,iBACQ;AACR,MAAI,QAAQ,2BAA4B,QAAO;AAC/C,SAAO,mBAAmB;AAC5B;AAGO,SAAS,kBAAkB,OAAwB;AACxD,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACzD,WAAO;AAAA,EACT;AACA,UAAQ,OAAO,OAAA;AAAA,IACb,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,OAAO,KAAK;AAAA,IACrB;AACE,YAAM,IAAI;AAAA,QACR,iEAAiE,MAAM,QAAQ,KAAK,IAAI,UAAU,OAAO,KAAK;AAAA,MAAA;AAAA,EAChH;AAEN;AAMO,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

@@ -26,6 +26,43 @@ export type DataTableGrouping<T> = {
     /** Reorders groups. Omit to keep first-appearance order, which follows the sort. */
     compareGroups?: (a: DataTableGroup<T>, b: DataTableGroup<T>) => number;
 };
+type DataTableGroupingModeBase = {
+    /** Stable value used by the grouping picker and controlled state. */
+    value: string;
+    /** Text shown in the grouping picker. */
+    label: string;
+};
+export type DataTableGroupingCustomMode<T> = DataTableGroupingModeBase & DataTableGrouping<T> & {
+    type: "custom";
+};
+export type DataTableGroupingColumnMode<T> = DataTableGroupingModeBase & Omit<DataTableGrouping<T>, "getGroupKey"> & {
+    type: "column";
+    /** Column key whose scalar value becomes the group key. */
+    columnKey: string;
+    /** Label used for null, undefined, or empty-string values. */
+    emptyGroupLabel?: string;
+};
+export type DataTableGroupingNoneMode = DataTableGroupingModeBase & {
+    type: "none";
+};
+/** One selectable grouping strategy for DataTable's native picker. */
+export type DataTableGroupingMode<T> = DataTableGroupingCustomMode<T> | DataTableGroupingColumnMode<T> | DataTableGroupingNoneMode;
+/**
+ * Internal group key for null/undefined/empty column values. It is deliberately
+ * not the `emptyGroupLabel`: a row whose column literally reads "Unassigned"
+ * must not be bucketed with the rows that have no value at all. Rendered through
+ * `dataTableGroupLabel`, so readers still see the configured label.
+ */
+export declare const DATA_TABLE_EMPTY_GROUP_KEY = "\0empty";
+/** Header label for the empty group when a mode does not configure its own. */
+export declare const DATA_TABLE_EMPTY_GROUP_LABEL = "(empty)";
+/**
+ * Maps an automatic group key back to its header label: the internal empty key
+ * becomes the configured label, every other key is already its own label.
+ */
+export declare function dataTableGroupLabel(key: string, emptyGroupLabel?: string): string;
+/** Converts an automatic column-group value to the stable string key DataTable requires. */
+export declare function dataTableGroupKey(value: unknown): string;
 /**
  * Buckets `records` by `getGroupKey`, preserving first-appearance order so
  * grouping never fights the active sort. Pure — no React, no DOM.
@@ -33,4 +70,5 @@ export type DataTableGrouping<T> = {
 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;
+export {};
 //# sourceMappingURL=DataTable.grouping.d.ts.map

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

@@ -1 +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,uBAAuB,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,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,mEAAmE;IACnE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;IACrD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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"}
+{"version":3,"file":"DataTable.grouping.d.ts","sourceRoot":"","sources":["../../src/data/DataTable.grouping.ts"],"names":[],"mappings":"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"}

package/dist/data/DataTable.grouping.js

@@ -1,3 +1,25 @@
+const DATA_TABLE_EMPTY_GROUP_KEY = "\0empty";
+const DATA_TABLE_EMPTY_GROUP_LABEL = "(empty)";
+function dataTableGroupLabel(key, emptyGroupLabel) {
+  if (key !== DATA_TABLE_EMPTY_GROUP_KEY) return key;
+  return emptyGroupLabel ?? DATA_TABLE_EMPTY_GROUP_LABEL;
+}
+function dataTableGroupKey(value) {
+  if (value === null || value === void 0 || value === "") {
+    return DATA_TABLE_EMPTY_GROUP_KEY;
+  }
+  switch (typeof value) {
+    case "string":
+    case "number":
+    case "boolean":
+    case "bigint":
+      return String(value);
+    default:
+      throw new Error(
+        `DataTable automatic grouping requires scalar values; received ${Array.isArray(value) ? "array" : typeof value}`
+      );
+  }
+}
 function groupRecords(records, getGroupKey) {
   const byKey = /* @__PURE__ */ new Map();
   for (const record of records) {
@@ -15,6 +37,10 @@ function isGroupCollapsedByDefault(group, defaultCollapsed) {
   return defaultCollapsed === true;
 }
 export {
+  DATA_TABLE_EMPTY_GROUP_KEY,
+  DATA_TABLE_EMPTY_GROUP_LABEL,
+  dataTableGroupKey,
+  dataTableGroupLabel,
   groupRecords,
   isGroupCollapsedByDefault
 };

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

@@ -1 +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 DataTableGroupMetaAlign = \"start\" | \"end\";\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 in the group header, placed by `metaAlign`. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * Where `getGroupMeta` sits in the header row. `\"end\"` (the default) pins it\n   * to the trailing edge; `\"start\"` puts it immediately after the label and\n   * count, which keeps a per-group aggregate next to the thing it aggregates\n   * instead of a table-width away from it.\n   */\n  metaAlign?: DataTableGroupMetaAlign;\n  /** Classes applied to the `getGroupMeta` wrapper. */\n  metaClassName?: string;\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":"AAoCO,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;"}
+{"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 DataTableGroupMetaAlign = \"start\" | \"end\";\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 in the group header, placed by `metaAlign`. */\n  getGroupMeta?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * Where `getGroupMeta` sits in the header row. `\"end\"` (the default) pins it\n   * to the trailing edge; `\"start\"` puts it immediately after the label and\n   * count, which keeps a per-group aggregate next to the thing it aggregates\n   * instead of a table-width away from it.\n   */\n  metaAlign?: DataTableGroupMetaAlign;\n  /** Classes applied to the `getGroupMeta` wrapper. */\n  metaClassName?: string;\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\ntype DataTableGroupingModeBase = {\n  /** Stable value used by the grouping picker and controlled state. */\n  value: string;\n  /** Text shown in the grouping picker. */\n  label: string;\n};\n\nexport type DataTableGroupingCustomMode<T> = DataTableGroupingModeBase &\n  DataTableGrouping<T> & {\n    type: \"custom\";\n  };\n\nexport type DataTableGroupingColumnMode<T> = DataTableGroupingModeBase &\n  Omit<DataTableGrouping<T>, \"getGroupKey\"> & {\n    type: \"column\";\n    /** Column key whose scalar value becomes the group key. */\n    columnKey: string;\n    /** Label used for null, undefined, or empty-string values. */\n    emptyGroupLabel?: string;\n  };\n\nexport type DataTableGroupingNoneMode = DataTableGroupingModeBase & {\n  type: \"none\";\n};\n\n/** One selectable grouping strategy for DataTable's native picker. */\nexport type DataTableGroupingMode<T> =\n  | DataTableGroupingCustomMode<T>\n  | DataTableGroupingColumnMode<T>\n  | DataTableGroupingNoneMode;\n\n/**\n * Internal group key for null/undefined/empty column values. It is deliberately\n * not the `emptyGroupLabel`: a row whose column literally reads \"Unassigned\"\n * must not be bucketed with the rows that have no value at all. Rendered through\n * `dataTableGroupLabel`, so readers still see the configured label.\n */\nexport const DATA_TABLE_EMPTY_GROUP_KEY = \"\\u0000empty\";\n\n/** Header label for the empty group when a mode does not configure its own. */\nexport const DATA_TABLE_EMPTY_GROUP_LABEL = \"(empty)\";\n\n/**\n * Maps an automatic group key back to its header label: the internal empty key\n * becomes the configured label, every other key is already its own label.\n */\nexport function dataTableGroupLabel(\n  key: string,\n  emptyGroupLabel?: string,\n): string {\n  if (key !== DATA_TABLE_EMPTY_GROUP_KEY) return key;\n  return emptyGroupLabel ?? DATA_TABLE_EMPTY_GROUP_LABEL;\n}\n\n/** Converts an automatic column-group value to the stable string key DataTable requires. */\nexport function dataTableGroupKey(value: unknown): string {\n  if (value === null || value === undefined || value === \"\") {\n    return DATA_TABLE_EMPTY_GROUP_KEY;\n  }\n  switch (typeof value) {\n    case \"string\":\n    case \"number\":\n    case \"boolean\":\n    case \"bigint\":\n      return String(value);\n    default:\n      throw new Error(\n        `DataTable automatic grouping requires scalar values; received ${Array.isArray(value) ? \"array\" : typeof value}`,\n      );\n  }\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":"AAqEO,MAAM,6BAA6B;AAGnC,MAAM,+BAA+B;AAMrC,SAAS,oBACd,KACA,iBACQ;AACR,MAAI,QAAQ,2BAA4B,QAAO;AAC/C,SAAO,mBAAmB;AAC5B;AAGO,SAAS,kBAAkB,OAAwB;AACxD,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACzD,WAAO;AAAA,EACT;AACA,UAAQ,OAAO,OAAA;AAAA,IACb,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,OAAO,KAAK;AAAA,IACrB;AACE,YAAM,IAAI;AAAA,QACR,iEAAiE,MAAM,QAAQ,KAAK,IAAI,UAAU,OAAO,KAAK;AAAA,MAAA;AAAA,EAChH;AAEN;AAMO,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;"}