schummar-table 1.0.0-beta.0 → 1.0.0-beta.3

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2021-2026 Marco Schumacher
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,4 +1,225 @@
 # schummar-table
 
 [![](https://badgen.net/npm/v/schummar-table)](https://www.npmjs.com/package/schummar-table)
+[![](https://badgen.net/npm/v/schummar-table/next)](https://www.npmjs.com/package/schummar-table/v/next)
 [![](https://badgen.net/bundlephobia/minzip/schummar-table)](https://bundlephobia.com/package/schummar-table)
+
+A fast, fully typed table for React. Sorting, filtering, selection, trees, column resizing,
+virtualization, persistence and exports work out of the box. Every piece of state can be left to
+the table or controlled from outside.
+
+- **Typed end to end.** Column values flow into `renderCell`, `sortBy` and `filterBy`, and filters
+  are type checked against the column they sit on.
+- **Fast.** Rows and cells are memoized, virtualization uses
+  [TanStack Virtual](https://tanstack.com/virtual), and expensive cells can render progressively.
+- **Unopinionated styling.** Plain class names or emotion styles for every part, with built-in
+  styles that your overrides always win against. Themes for MUI 4 and 5 are included.
+
+**[Live examples](https://schummar.github.io/schummar-table/)**
+
+## Installation
+
+```bash
+npm install schummar-table @emotion/react
+```
+
+React 19 or newer is required. `write-excel-file` is only needed for the Excel exporter, `@mui/material` or
+`@material-ui/core` only for the matching theme.
+
+## Quick start
+
+```tsx
+import { Table, selectFilter, textFilter } from 'schummar-table';
+
+interface Person {
+  id: number;
+  name: string;
+  job: string;
+  birthday: Date;
+}
+
+export function People({ people }: { people: Person[] }) {
+  return (
+    <Table
+      items={people}
+      id="id"
+      columns={(col) => [
+        col((person) => person.name, { header: 'Name', filter: textFilter() }),
+        col((person) => person.job, { header: 'Job', filter: selectFilter() }),
+        col((person) => person.birthday, {
+          header: 'Birthday',
+          renderCell: (birthday) => birthday.toLocaleDateString(),
+        }),
+      ]}
+    />
+  );
+}
+```
+
+`col(value, options)` infers the column value from its first argument, so `birthday` above is a
+`Date` everywhere.
+
+## Columns
+
+```tsx
+col((person) => person.birthday, {
+  id: 'birthday', // stable id for persistence and controlled state; defaults to the index
+  header: 'Birthday',
+  renderCell: (birthday, person) => birthday.toLocaleDateString(),
+  sortBy: [(birthday) => birthday.getTime()],
+  exportCell: (birthday) => birthday.toISOString(),
+  width: '12ch', // any CSS grid width; defaults to max-content
+  displaySize: 'desktop', // only show on some screen sizes
+});
+```
+
+Columns can be hidden by the user (`enableColumnSelection`, on by default) and resized by dragging
+the header separators (`enableColumnResize`).
+
+## Filters
+
+A filter is created with a factory and put on a column. Its UI opens from the column header.
+
+```tsx
+col((person) => person.name, { filter: textFilter({ compare: 'prefix' }) });
+col((person) => person.tags, { filter: selectFilter() }); // string[] works too
+col((person) => person.age, { filter: rangeFilter({ min: 0 }) });
+col((person) => person.birthday, { filter: dateFilter({ maxDate: new Date() }) });
+```
+
+| Filter         | Accepts                                      |
+| -------------- | -------------------------------------------- |
+| `textFilter`   | `string`, `number`, `bigint`                 |
+| `selectFilter` | anything; `options`, `render` etc. narrow it |
+| `rangeFilter`  | `number`, `bigint`                           |
+| `dateFilter`   | `Date`, `DateRange`, ISO date strings        |
+
+Each also accepts `null`/`undefined`, arrays and Sets (an item matches if one of the values
+does). A filter that doesn't fit the column value is a type error. Use `filterBy` to filter by
+something else:
+
+```tsx
+col((person) => person.birthday, {
+  filterBy: (birthday) => birthday.getFullYear(),
+  filter: rangeFilter(),
+});
+```
+
+Every filter takes `defaultValue`, `value` and `onChange` (typed by the filter's own value), and
+`external` to leave the actual filtering to you, e.g. on the server. All filter values can also be
+controlled at once with `filterValues` / `onFilterValuesChange` on the table.
+
+Custom filters are made with `defineFilter`:
+
+```tsx
+const flagFilter = defineFilter<boolean, boolean>({
+  isActive: (value) => value,
+  test: (value, input) => input === value,
+  Component: ({ value, onChange }) => (
+    <label>
+      <input type="checkbox" checked={!!value} onChange={(e) => onChange(e.target.checked)} />
+      Only flagged
+    </label>
+  ),
+});
+```
+
+## State
+
+The table manages its state on its own. Every part can be initialized or controlled instead, the
+same way as React inputs:
+
+| State          | Initial                | Controlled      | Change                  |
+| -------------- | ---------------------- | --------------- | ----------------------- |
+| Sort           | `defaultSort`          | `sort`          | `onSortChange`          |
+| Selection      | `defaultSelection`     | `selection`     | `onSelectionChange`     |
+| Expanded rows  | `defaultExpanded`      | `expanded`      | `onExpandedChange`      |
+| Hidden columns | `defaultHiddenColumns` | `hiddenColumns` | `onHiddenColumnsChange` |
+| Filter values  | `defaultFilterValues`  | `filterValues`  | `onFilterValuesChange`  |
+
+Use `externalSort` when the items arrive sorted already. A `ref` gives imperative access, and
+`useTableActions()` / `useTableContext()` do the same from components inside the table.
+
+## Trees and row details
+
+```tsx
+<Table items={items} id="id" parentId="parentId" columns={columns} />
+```
+
+Items with a `parentId` become collapsible children of their parent. `hasDeferredChildren` marks
+items whose children load on expand, and `revealFiltered` expands parents of matching children.
+`rowDetails` renders an expandable area below each row instead.
+
+## Large tables
+
+```tsx
+<Table virtual items={items} ... />
+<Table virtual={{ rowHeight: 40, overscan: 10, deferCells: true }} items={items} ... />
+```
+
+`virtual` only renders the rows in view. It works inside any scroll container or with the window.
+`deferCells` renders expensive cells progressively: rows that don't fit the frame budget show a
+placeholder first, and visible rows are revealed first. Use `deferred` on single columns instead.
+
+## Persistence
+
+```tsx
+<Table persist={{ storage: localStorage, id: 'people' }} ... />
+```
+
+Sort, selection, expanded rows, hidden columns, column widths and filter values are saved and
+restored. `include` and `exclude` narrow this down, including single filters with
+`{ filterValues: ['name'] }`. Any storage with `getItem`/`setItem`/`removeItem` works, including
+async ones like localForage.
+
+## Export
+
+`enableExport` adds copy and download buttons for the visible (or selected) rows as CSV. More
+exporters are registered through a provider:
+
+```tsx
+import ExcelExporter from 'schummar-table/excelExporter';
+
+<TableSettingsProvider
+  additionalExporters={[{ action: 'download', exporter: new ExcelExporter() }]}
+>
+  <App />
+</TableSettingsProvider>;
+```
+
+## Styling and themes
+
+Every part accepts class names and emotion styles, per table or per column:
+
+```tsx
+<Table
+  classes={{ table: 'people', headerCell: 'people-header', evenCell: 'even' }}
+  styles={{ cell: { padding: '0.5em 1em' } }}
+  ...
+/>
+```
+
+The built-in styles are inserted before all other styles, so an override of equal specificity
+always wins. `classes.row/cell` and `styles.row/cell` also take a function of the item. Prefer
+class names or constant styles there: function styles run for every cell render.
+
+Components, icons, texts and colors are replaced through a theme, per table or for all tables via
+`TableSettingsProvider`. MUI themes ship as separate entry points:
+
+```tsx
+import { Mui5TableThemeProvider } from 'schummar-table/mui5Theme';
+
+<Mui5TableThemeProvider>
+  <App />
+</Mui5TableThemeProvider>;
+```
+
+## Upgrading from 0.x
+
+1.0 changes the filter API, the `virtual` options and a few others. The package ships an agent
+skill that walks through the migration: point your coding agent at
+`node_modules/schummar-table/skills/schummar-table-upgrade/SKILL.md`.
+
+## License
+
+ISC

package/dist/csvExporter.d.cts

@@ -1,4 +1,4 @@
-import { i as StringExporter, t as BlobExporter } from "./exporter-BT2ehIIU.cjs";
+import { i as StringExporter, t as BlobExporter } from "./exporter-Dv2Vqqth.cjs";
 //#region src/exporters/csvExporter.d.ts
 export interface CsvExporterOptions {
   sepPrefix?: boolean;

package/dist/csvExporter.d.ts

@@ -1,4 +1,4 @@
-import { i as StringExporter, t as BlobExporter } from "./exporter-BT2ehIIU.js";
+import { i as StringExporter, t as BlobExporter } from "./exporter-Dv2Vqqth.js";
 //#region src/exporters/csvExporter.d.ts
 export interface CsvExporterOptions {
   sepPrefix?: boolean;

package/dist/excelExporter.cjs

@@ -1,16 +1,19 @@
-let xlsx = require("xlsx");
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+let write_excel_file_browser = require("write-excel-file/browser");
+write_excel_file_browser = require_rolldown_runtime.__toESM(write_excel_file_browser, 1);
 //#region src/exporters/excelExporter.ts
 var ExcelExporter = class {
-	constructor() {
+	constructor(options = {}) {
+		this.options = options;
 		this.type = "xlsx";
 		this.fileEnding = "xlsx";
 	}
 	exportToBlob(columns, rows) {
-		const worksheet = xlsx.utils.aoa_to_sheet([columns, ...rows]);
-		const workbook = xlsx.utils.book_new();
-		xlsx.utils.book_append_sheet(workbook, worksheet, "Sheet1");
-		const data = (0, xlsx.write)(workbook, { type: "buffer" });
-		return new Blob([data], { type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" });
+		const { dateFormat = "yyyy-mm-dd", sheet = "Sheet1" } = this.options;
+		return (0, write_excel_file_browser.default)([columns, ...rows], {
+			sheet,
+			dateFormat
+		}).toBlob();
 	}
 };
 //#endregion

package/dist/excelExporter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"excelExporter.cjs","names":["utils","write"],"sources":["../src/exporters/excelExporter.ts"],"sourcesContent":["import { utils, write } from 'xlsx';\nimport { BlobExporter } from './exporter';\n\nexport default class ExcelExporter implements BlobExporter {\n  readonly type = 'xlsx';\n  readonly fileEnding = 'xlsx';\n\n  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob {\n    const worksheet = utils.aoa_to_sheet([columns, ...rows]);\n    const workbook = utils.book_new();\n    utils.book_append_sheet(workbook, worksheet, 'Sheet1');\n\n    const data = write(workbook, { type: 'buffer' });\n    return new Blob([data], {\n      type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    });\n  }\n}\n"],"mappings":";;AAGA,IAAqB,gBAArB,MAA2D;;EACzC,KAAA,OAAA;EACM,KAAA,aAAA;;CAEtB,aAAa,SAAqC,MAA0C;EAC1F,MAAM,YAAYA,KAAAA,MAAM,aAAa,CAAC,SAAS,GAAG,IAAI,CAAC;EACvD,MAAM,WAAWA,KAAAA,MAAM,SAAS;EAChC,KAAA,MAAM,kBAAkB,UAAU,WAAW,QAAQ;EAErD,MAAM,QAAA,GAAOC,KAAAA,MAAAA,CAAM,UAAU,EAAE,MAAM,SAAS,CAAC;EAC/C,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,EACtB,MAAM,oEACR,CAAC;CACH;AACF"}
+{"version":3,"file":"excelExporter.cjs","names":["writeXlsxFile"],"sources":["../src/exporters/excelExporter.ts"],"sourcesContent":["import writeXlsxFile from 'write-excel-file/browser';\nimport type { BlobExporter } from './exporter';\n\nexport interface ExcelExporterOptions {\n  /** Excel number format for date cells.\n   * @default 'yyyy-mm-dd'\n   */\n  dateFormat?: string;\n  /** @default 'Sheet1' */\n  sheet?: string;\n}\n\nexport default class ExcelExporter implements BlobExporter {\n  readonly type = 'xlsx';\n  readonly fileEnding = 'xlsx';\n\n  constructor(private readonly options: ExcelExporterOptions = {}) {}\n\n  exportToBlob(\n    columns: (string | number | Date)[],\n    rows: (string | number | Date)[][],\n  ): Promise<Blob> {\n    const { dateFormat = 'yyyy-mm-dd', sheet = 'Sheet1' } = this.options;\n    return writeXlsxFile([columns, ...rows], { sheet, dateFormat }).toBlob();\n  }\n}\n"],"mappings":";;;;AAYA,IAAqB,gBAArB,MAA2D;CAIzD,YAAY,UAAiD,CAAC,GAAG;EAApC,KAAA,UAAA;EAHb,KAAA,OAAA;EACM,KAAA,aAAA;CAE4C;CAElE,aACE,SACA,MACe;EACf,MAAM,EAAE,aAAa,cAAc,QAAQ,aAAa,KAAK;EAC7D,QAAA,GAAOA,yBAAAA,QAAAA,CAAc,CAAC,SAAS,GAAG,IAAI,GAAG;GAAE;GAAO;EAAW,CAAC,CAAC,CAAC,OAAO;CACzE;AACF"}

package/dist/excelExporter.d.cts

@@ -1,9 +1,19 @@
-import { t as BlobExporter } from "./exporter-BT2ehIIU.cjs";
+import { t as BlobExporter } from "./exporter-Dv2Vqqth.cjs";
 //#region src/exporters/excelExporter.d.ts
-declare class ExcelExporter implements BlobExporter {
+export interface ExcelExporterOptions {
+  /** Excel number format for date cells.
+   * @default 'yyyy-mm-dd'
+   */
+  dateFormat?: string;
+  /** @default 'Sheet1' */
+  sheet?: string;
+}
+export default class ExcelExporter implements BlobExporter {
+  private readonly options;
   readonly type = "xlsx";
   readonly fileEnding = "xlsx";
-  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob;
+  constructor(options?: ExcelExporterOptions);
+  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Promise<Blob>;
 }
-export = ExcelExporter;
+//#endregion
 //# sourceMappingURL=excelExporter.d.cts.map

package/dist/excelExporter.d.ts

@@ -1,9 +1,19 @@
-import { t as BlobExporter } from "./exporter-BT2ehIIU.js";
+import { t as BlobExporter } from "./exporter-Dv2Vqqth.js";
 //#region src/exporters/excelExporter.d.ts
+export interface ExcelExporterOptions {
+  /** Excel number format for date cells.
+   * @default 'yyyy-mm-dd'
+   */
+  dateFormat?: string;
+  /** @default 'Sheet1' */
+  sheet?: string;
+}
 export default class ExcelExporter implements BlobExporter {
+  private readonly options;
   readonly type = "xlsx";
   readonly fileEnding = "xlsx";
-  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob;
+  constructor(options?: ExcelExporterOptions);
+  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Promise<Blob>;
 }
 //#endregion
 //# sourceMappingURL=excelExporter.d.ts.map

package/dist/excelExporter.js

@@ -1,16 +1,17 @@
-import { utils, write } from "xlsx";
+import writeXlsxFile from "write-excel-file/browser";
 //#region src/exporters/excelExporter.ts
 var ExcelExporter = class {
-	constructor() {
+	constructor(options = {}) {
+		this.options = options;
 		this.type = "xlsx";
 		this.fileEnding = "xlsx";
 	}
 	exportToBlob(columns, rows) {
-		const worksheet = utils.aoa_to_sheet([columns, ...rows]);
-		const workbook = utils.book_new();
-		utils.book_append_sheet(workbook, worksheet, "Sheet1");
-		const data = write(workbook, { type: "buffer" });
-		return new Blob([data], { type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" });
+		const { dateFormat = "yyyy-mm-dd", sheet = "Sheet1" } = this.options;
+		return writeXlsxFile([columns, ...rows], {
+			sheet,
+			dateFormat
+		}).toBlob();
 	}
 };
 //#endregion

package/dist/excelExporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"excelExporter.js","names":[],"sources":["../src/exporters/excelExporter.ts"],"sourcesContent":["import { utils, write } from 'xlsx';\nimport { BlobExporter } from './exporter';\n\nexport default class ExcelExporter implements BlobExporter {\n  readonly type = 'xlsx';\n  readonly fileEnding = 'xlsx';\n\n  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob {\n    const worksheet = utils.aoa_to_sheet([columns, ...rows]);\n    const workbook = utils.book_new();\n    utils.book_append_sheet(workbook, worksheet, 'Sheet1');\n\n    const data = write(workbook, { type: 'buffer' });\n    return new Blob([data], {\n      type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    });\n  }\n}\n"],"mappings":";;AAGA,IAAqB,gBAArB,MAA2D;;EACzC,KAAA,OAAA;EACM,KAAA,aAAA;;CAEtB,aAAa,SAAqC,MAA0C;EAC1F,MAAM,YAAY,MAAM,aAAa,CAAC,SAAS,GAAG,IAAI,CAAC;EACvD,MAAM,WAAW,MAAM,SAAS;EAChC,MAAM,kBAAkB,UAAU,WAAW,QAAQ;EAErD,MAAM,OAAO,MAAM,UAAU,EAAE,MAAM,SAAS,CAAC;EAC/C,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,EACtB,MAAM,oEACR,CAAC;CACH;AACF"}
+{"version":3,"file":"excelExporter.js","names":[],"sources":["../src/exporters/excelExporter.ts"],"sourcesContent":["import writeXlsxFile from 'write-excel-file/browser';\nimport type { BlobExporter } from './exporter';\n\nexport interface ExcelExporterOptions {\n  /** Excel number format for date cells.\n   * @default 'yyyy-mm-dd'\n   */\n  dateFormat?: string;\n  /** @default 'Sheet1' */\n  sheet?: string;\n}\n\nexport default class ExcelExporter implements BlobExporter {\n  readonly type = 'xlsx';\n  readonly fileEnding = 'xlsx';\n\n  constructor(private readonly options: ExcelExporterOptions = {}) {}\n\n  exportToBlob(\n    columns: (string | number | Date)[],\n    rows: (string | number | Date)[][],\n  ): Promise<Blob> {\n    const { dateFormat = 'yyyy-mm-dd', sheet = 'Sheet1' } = this.options;\n    return writeXlsxFile([columns, ...rows], { sheet, dateFormat }).toBlob();\n  }\n}\n"],"mappings":";;AAYA,IAAqB,gBAArB,MAA2D;CAIzD,YAAY,UAAiD,CAAC,GAAG;EAApC,KAAA,UAAA;EAHb,KAAA,OAAA;EACM,KAAA,aAAA;CAE4C;CAElE,aACE,SACA,MACe;EACf,MAAM,EAAE,aAAa,cAAc,QAAQ,aAAa,KAAK;EAC7D,OAAO,cAAc,CAAC,SAAS,GAAG,IAAI,GAAG;GAAE;GAAO;EAAW,CAAC,CAAC,CAAC,OAAO;CACzE;AACF"}

package/dist/{exporter-BT2ehIIU.d.ts → exporter-Dv2Vqqth.d.cts}

@@ -6,7 +6,7 @@ interface StringExporter {
 interface BlobExporter {
   type: string;
   fileEnding: string;
-  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob;
+  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob | Promise<Blob>;
 }
 type ExporterEntry = {
   action: 'copy';
@@ -21,4 +21,4 @@ interface ExportOptions {
 }
 //#endregion
 export { StringExporter as i, ExportOptions as n, ExporterEntry as r, BlobExporter as t };
-//# sourceMappingURL=exporter-BT2ehIIU.d.ts.map
+//# sourceMappingURL=exporter-Dv2Vqqth.d.cts.map

package/dist/{exporter-BT2ehIIU.d.cts → exporter-Dv2Vqqth.d.ts}

@@ -6,7 +6,7 @@ interface StringExporter {
 interface BlobExporter {
   type: string;
   fileEnding: string;
-  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob;
+  exportToBlob(columns: (string | number | Date)[], rows: (string | number | Date)[][]): Blob | Promise<Blob>;
 }
 type ExporterEntry = {
   action: 'copy';
@@ -21,4 +21,4 @@ interface ExportOptions {
 }
 //#endregion
 export { StringExporter as i, ExportOptions as n, ExporterEntry as r, BlobExporter as t };
-//# sourceMappingURL=exporter-BT2ehIIU.d.cts.map
+//# sourceMappingURL=exporter-Dv2Vqqth.d.ts.map

package/dist/index.cjs

@@ -1,41 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
 const require_tableTheme = require("./tableTheme-CSqMIpLB.cjs");
 let react = require("react");
 let _emotion_react_jsx_runtime = require("@emotion/react/jsx-runtime");
 let _emotion_react = require("@emotion/react");
 let _emotion_cache = require("@emotion/cache");
-_emotion_cache = __toESM(_emotion_cache, 1);
+_emotion_cache = require_rolldown_runtime.__toESM(_emotion_cache, 1);
 let _emotion_serialize = require("@emotion/serialize");
 let _emotion_utils = require("@emotion/utils");
 let react_dom = require("react-dom");
@@ -191,7 +161,7 @@ const Button = ({ startIcon, children, variant = "text", ...props }) => {
 };
 //#endregion
 //#region src/misc/helpers.ts
-var helpers_exports = /* @__PURE__ */ __exportAll({
+var helpers_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	asNumber: () => asNumber,
 	asNumberOrArray: () => asNumberOrArray,
 	asString: () => asString,
@@ -269,8 +239,9 @@ const getDescendants = (...items) => {
 const identity$1 = (x) => x;
 const asString = (x) => {
 	if (Array.isArray(x)) return x.map(asString).join(", ");
+	if (x === null || x === void 0) return "";
 	if (x instanceof Object) return JSON.stringify(x);
-	return String(x ?? "");
+	return String(x);
 };
 const asStringOrArray = (x) => {
 	if (Array.isArray(x)) return x.map(asString);
@@ -2109,18 +2080,20 @@ const isActiveFilter = (filter, value) => filter !== void 0 && value !== void 0
 function filteredColumns(props, visibleColumns) {
 	return props.enableHiddenColumnFilters ? props.columns : visibleColumns;
 }
+/** Adds controlled values and defaults. Returns `stored` itself when there are none. */
+function withFilterDefaults(stored, columns) {
+	let result = stored;
+	for (const { id, filter } of columns) {
+		const value = filter?.value !== void 0 || stored.has(id) ? filter?.value : filter?.defaultValue;
+		if (value === void 0) continue;
+		if (result === stored) result = new Map(stored);
+		result.set(id, value);
+	}
+	return result;
+}
 function useFilters(props, visibleColumns, items) {
 	const [stored, setFilterValues, setFilterValuesInternal] = useControllableState(props.filterValues, () => props.defaultFilterValues ?? /* @__PURE__ */ new Map(), props.onFilterValuesChange);
-	const filterValues = (0, react.useMemo)(() => {
-		let result = stored;
-		for (const { id, filter } of props.columns) {
-			const value = filter?.value !== void 0 || stored.has(id) ? filter?.value : filter?.defaultValue;
-			if (value === void 0) continue;
-			if (result === stored) result = new Map(stored);
-			result.set(id, value);
-		}
-		return result;
-	}, [stored, props.columns]);
+	const filterValues = (0, react.useMemo)(() => withFilterDefaults(stored, props.columns), [stored, props.columns]);
 	const applied = filteredColumns(props, visibleColumns);
 	return {
 		stored,
@@ -2388,7 +2361,7 @@ const defaultProps = {
 	} }
 };
 const identity = (value) => value;
-const defaultSortBy = (v) => typeof v === "number" || v instanceof Date ? v : v === null || v === void 0 ? "" : String(v);
+const defaultSortBy = (v) => typeof v === "number" || v instanceof Date ? v : asString(v);
 function normalizeId(id) {
 	return id instanceof Function ? id : (item) => item[id];
 }
@@ -3545,9 +3518,10 @@ function Export() {
 		const rows = exportedItems.map((item) => activeColumns.map((column) => column.exportCell(column.value(item.value), item.value)));
 		if (action === "copy") {
 			const data = exporter.exportToString(columns, rows);
-			navigator.clipboard.writeText(data);
-		} else {
-			const blob = exporter.exportToBlob(columns, rows);
+			navigator.clipboard.writeText(data).catch((error) => {
+				console.error("Failed to copy the export to the clipboard:", error);
+			});
+		} else Promise.resolve(exporter.exportToBlob(columns, rows)).then((blob) => {
 			const url = URL.createObjectURL(blob);
 			const a = document.createElement("a");
 			a.href = url;
@@ -3556,7 +3530,9 @@ function Export() {
 			a.click();
 			a.remove();
 			URL.revokeObjectURL(url);
-		}
+		}).catch((error) => {
+			console.error("Failed to export:", error);
+		});
 	}
 	return /* @__PURE__ */ (0, _emotion_react_jsx_runtime.jsxs)(_emotion_react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _emotion_react_jsx_runtime.jsx)(IconButton, {
 		onClick: (event) => setAnchor(anchor ? null : event.currentTarget),
@@ -3746,6 +3722,7 @@ function useScrollRoot(tableRef, probe) {
 	return root;
 }
 function VirtualWindow({ virtualizer, renderRow, measure }) {
+	"use no memo";
 	const items = virtualizer.getVirtualItems();
 	const scheduler = (0, react.useContext)(CellSchedulerContext);
 	(0, react.useLayoutEffect)(() => {
@@ -3777,6 +3754,7 @@ function virtualizerOptions({ count, getKey, options, scrollMargin }) {
 	};
 }
 function ElementRows(props) {
+	"use no memo";
 	const virtualizer = (0, _tanstack_react_virtual.useVirtualizer)({
 		...virtualizerOptions(props),
 		getScrollElement: () => props.root
@@ -3788,6 +3766,7 @@ function ElementRows(props) {
 	});
 }
 function WindowRows(props) {
+	"use no memo";
 	const virtualizer = (0, _tanstack_react_virtual.useWindowVirtualizer)(virtualizerOptions(props));
 	return /* @__PURE__ */ (0, _emotion_react_jsx_runtime.jsx)(VirtualWindow, {
 		virtualizer,