@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/datatable/headless/export/exportModel.d.ts

@@ -0,0 +1,180 @@
+/**
+ * DataTable — export model (issue #256, epic #238).
+ *
+ * Turns "this table, as the user is currently looking at it" into a CSV file.
+ * Built entirely against the COLUMN CONTRACT (`types.ts`), never against
+ * DataGrid: `GridToolbarExport` would serialize the grid's own rows, which
+ * exist in one renderer out of two and would silently produce a different file
+ * on a phone. One code path serves all three layouts.
+ *
+ * ## The three rules that make an export trustworthy
+ *
+ * 1. **`value`, never `render`.** A column whose cell is a `<Chip>` exports the
+ *    scalar behind the chip. Serializing a ReactNode is either impossible or
+ *    (worse) accidentally lossy — `[object Object]`, or the chip's label
+ *    without its meaning. This is the whole reason `render` and `value` are two
+ *    fields in the column contract.
+ * 2. **Only what is on screen.** The columns are the ones the user currently has
+ *    visible (#255), minus any column declaring `exportable: false`.
+ * 3. **Only what the API already returned.** The export never re-queries with
+ *    elevated access, and never reaches for a field the table was not handed.
+ *    "Current page" serializes the loaded rows; "all matching rows" replays the
+ *    page's OWN fetch callback, so it is subject to exactly the same
+ *    authorization and the same active filters as the table itself.
+ */
+import type { DataTableColumn, DataTableExportFetchPage } from '../types.js';
+/**
+ * Hard ceiling on an "all matching rows" export.
+ *
+ * A bound, not a preference: without one, a single click against a 150 000-item
+ * library issues 1 500 requests and builds a ~100 MB string in a tab that then
+ * dies. 10 000 rows is far past any spreadsheet anyone actually reads and still
+ * finishes in seconds.
+ *
+ * @stability experimental
+ */
+export declare const DATA_TABLE_EXPORT_MAX_ROWS = 10000;
+/**
+ * Page size used when replaying the page's fetch callback.
+ *
+ * Deliberately larger than any UI page size (the fetch is headless, so the MIT
+ * DataGrid's 100-row page cap does not apply here) and small enough that the
+ * progress indicator moves and a cancel lands promptly.
+ *
+ * @stability experimental
+ */
+export declare const DATA_TABLE_EXPORT_FETCH_PAGE_SIZE = 250;
+/**
+ * Whether a column may appear in an export at all.
+ *
+ * Defaults to `true`: most columns carry a scalar and a table that silently
+ * dropped columns from its CSV would be worse than one that exports an empty
+ * cell. `exportable: false` is the opt-out, and it is what #259/#260 will set on
+ * share tokens and PAT material so a credential can never leave through this
+ * door.
+ *
+ * @stability experimental
+ */
+export declare function isExportableColumn<Row>(column: DataTableColumn<Row>): boolean;
+/**
+ * The columns an export writes, in declaration order.
+ *
+ * `visibleColumnIds` is the USER's resolved visibility (#255) — deliberately
+ * layout-independent. A `detail` column folded into the tablet row expander is
+ * still shown to the user, just somewhere else, so the CSV must not change
+ * because the window happens to be 900px wide today and 1400px tomorrow. A
+ * column the user actually unchecked is a different thing, and is excluded.
+ *
+ * Omitting `visibleColumnIds` means "nothing is hidden" — what a caller outside
+ * `DataTable` gets.
+ *
+ * @stability experimental
+ */
+export declare function exportColumns<Row>(columns: DataTableColumn<Row>[], visibleColumnIds?: ReadonlySet<string>): DataTableColumn<Row>[];
+/**
+ * A header row plus one array of scalars per row, ready for serialization.
+ *
+ * @stability experimental
+ */
+export interface ExportMatrix {
+    /** The header row: one label per exported column. */
+    header: string[];
+    /** The body rows: one cell per exported column. */
+    body: (string | number | null)[][];
+}
+/**
+ * Build the scalar matrix for a set of rows.
+ *
+ * `extractColumnValue` is the same extractor the grid's `valueGetter` and the
+ * card's field text use, so a CSV cell can never disagree with what the table
+ * sorted or displayed for that column.
+ *
+ * @stability experimental
+ */
+export declare function buildExportMatrix<Row>(columns: DataTableColumn<Row>[], rows: readonly Row[]): ExportMatrix;
+/**
+ * The complete CSV file text (BOM included) for a set of rows.
+ *
+ * @stability experimental
+ */
+export declare function buildCsvForRows<Row>(columns: DataTableColumn<Row>[], rows: readonly Row[], visibleColumnIds?: ReadonlySet<string>): string;
+/**
+ * `Enrichment jobs` → `enrichment-jobs`. Empty input falls back to `export`.
+ *
+ * @stability experimental
+ */
+export declare function slugifyExportName(name: string | undefined | null): string;
+/**
+ * `jobs-2026-08-05.csv`.
+ *
+ * Dated because an export is a snapshot: two files downloaded a week apart must
+ * not collide in a Downloads folder, and `jobs (3).csv` tells nobody anything.
+ *
+ * @stability experimental
+ */
+export declare function exportFilename(base: string | undefined | null, now?: Date): string;
+/**
+ * Hand a CSV string to the browser as a file download.
+ *
+ * A Blob + object URL + synthetic anchor click, which is the only approach that
+ * works without a server round trip and without `data:` URI length limits.
+ * Returns `false` when the environment cannot do it (jsdom without a
+ * `createObjectURL` stub, an ancient browser) rather than throwing — a failed
+ * download must not take a render down with it.
+ *
+ * @stability experimental
+ */
+export declare function downloadCsv(content: string, filename: string): boolean;
+/**
+ * Options of {@link collectAllRows}.
+ *
+ * @stability experimental
+ */
+export interface CollectAllRowsOptions<Row> {
+    /** The page's own fetch callback. The component cannot know the endpoint. */
+    fetchPage: DataTableExportFetchPage<Row>;
+    /** Rows per request. Default {@link DATA_TABLE_EXPORT_FETCH_PAGE_SIZE}. */
+    pageSize?: number;
+    /** Hard ceiling. Default {@link DATA_TABLE_EXPORT_MAX_ROWS}. */
+    maxRows?: number;
+    /** Called after every page with the running total. */
+    onProgress?: (fetched: number) => void;
+    /** Aborts the collection when it fires. */
+    signal?: AbortSignal;
+}
+/**
+ * What {@link collectAllRows} resolves to.
+ *
+ * @stability experimental
+ */
+export interface CollectAllRowsResult<Row> {
+    /** The rows collected. */
+    rows: Row[];
+    /** `true` when the ceiling stopped the walk before the server ran out. */
+    capped: boolean;
+}
+/**
+ * Thrown when an in-flight export is cancelled by the user.
+ *
+ * @stability experimental
+ */
+export declare class ExportCancelledError extends Error {
+    constructor();
+}
+/**
+ * Walk the page's fetch callback until it runs dry or the ceiling is reached.
+ *
+ * Page numbers are ZERO-BASED, matching `DataTablePaginationConfig` — the owning
+ * page already converts at its own fetch boundary, and handing it a second
+ * convention here would guarantee an off-by-one nobody notices until row 251 is
+ * missing.
+ *
+ * Termination is defensive on purpose: a short page, an empty page, the row
+ * ceiling, or `MAX_FETCH_PAGES` (200), whichever comes first. A callback that
+ * ignores `page` and keeps returning the same full page would otherwise loop
+ * until the tab dies.
+ *
+ * @stability experimental
+ */
+export declare function collectAllRows<Row>({ fetchPage, pageSize, maxRows, onProgress, signal, }: CollectAllRowsOptions<Row>): Promise<CollectAllRowsResult<Row>>;
+//# sourceMappingURL=exportModel.d.ts.map

package/dist/datatable/headless/export/exportModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportModel.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAQ7E;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AASrD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAC/B,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,eAAe,CAAC,GAAG,CAAC,EAAE,CAKxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EACnC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,YAAY,CAKd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EACjC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,MAAM,CAIR;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAG9F;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoBtE;AAMD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,GAAG;IACxC,6EAA6E;IAC7E,SAAS,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG;IACvC,0BAA0B;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,EACxC,SAAS,EACT,QAA4C,EAC5C,OAAoC,EACpC,UAAU,EACV,MAAM,GACP,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CA6BjE"}

package/dist/datatable/headless/export/exportModel.js

@@ -0,0 +1,230 @@
+/**
+ * DataTable — export model (issue #256, epic #238).
+ *
+ * Turns "this table, as the user is currently looking at it" into a CSV file.
+ * Built entirely against the COLUMN CONTRACT (`types.ts`), never against
+ * DataGrid: `GridToolbarExport` would serialize the grid's own rows, which
+ * exist in one renderer out of two and would silently produce a different file
+ * on a phone. One code path serves all three layouts.
+ *
+ * ## The three rules that make an export trustworthy
+ *
+ * 1. **`value`, never `render`.** A column whose cell is a `<Chip>` exports the
+ *    scalar behind the chip. Serializing a ReactNode is either impossible or
+ *    (worse) accidentally lossy — `[object Object]`, or the chip's label
+ *    without its meaning. This is the whole reason `render` and `value` are two
+ *    fields in the column contract.
+ * 2. **Only what is on screen.** The columns are the ones the user currently has
+ *    visible (#255), minus any column declaring `exportable: false`.
+ * 3. **Only what the API already returned.** The export never re-queries with
+ *    elevated access, and never reaches for a field the table was not handed.
+ *    "Current page" serializes the loaded rows; "all matching rows" replays the
+ *    page's OWN fetch callback, so it is subject to exactly the same
+ *    authorization and the same active filters as the table itself.
+ */
+import { extractColumnValue } from '../columns.js';
+import { toCsvFile } from './csv.js';
+// ---------------------------------------------------------------------------
+// Bounds
+// ---------------------------------------------------------------------------
+/**
+ * Hard ceiling on an "all matching rows" export.
+ *
+ * A bound, not a preference: without one, a single click against a 150 000-item
+ * library issues 1 500 requests and builds a ~100 MB string in a tab that then
+ * dies. 10 000 rows is far past any spreadsheet anyone actually reads and still
+ * finishes in seconds.
+ *
+ * @stability experimental
+ */
+export const DATA_TABLE_EXPORT_MAX_ROWS = 10_000;
+/**
+ * Page size used when replaying the page's fetch callback.
+ *
+ * Deliberately larger than any UI page size (the fetch is headless, so the MIT
+ * DataGrid's 100-row page cap does not apply here) and small enough that the
+ * progress indicator moves and a cancel lands promptly.
+ *
+ * @stability experimental
+ */
+export const DATA_TABLE_EXPORT_FETCH_PAGE_SIZE = 250;
+/** Guard against a callback that keeps returning rows forever. */
+const MAX_FETCH_PAGES = 200;
+// ---------------------------------------------------------------------------
+// Columns
+// ---------------------------------------------------------------------------
+/**
+ * Whether a column may appear in an export at all.
+ *
+ * Defaults to `true`: most columns carry a scalar and a table that silently
+ * dropped columns from its CSV would be worse than one that exports an empty
+ * cell. `exportable: false` is the opt-out, and it is what #259/#260 will set on
+ * share tokens and PAT material so a credential can never leave through this
+ * door.
+ *
+ * @stability experimental
+ */
+export function isExportableColumn(column) {
+    return column.exportable !== false;
+}
+/**
+ * The columns an export writes, in declaration order.
+ *
+ * `visibleColumnIds` is the USER's resolved visibility (#255) — deliberately
+ * layout-independent. A `detail` column folded into the tablet row expander is
+ * still shown to the user, just somewhere else, so the CSV must not change
+ * because the window happens to be 900px wide today and 1400px tomorrow. A
+ * column the user actually unchecked is a different thing, and is excluded.
+ *
+ * Omitting `visibleColumnIds` means "nothing is hidden" — what a caller outside
+ * `DataTable` gets.
+ *
+ * @stability experimental
+ */
+export function exportColumns(columns, visibleColumnIds) {
+    return columns.filter((column) => isExportableColumn(column) && (!visibleColumnIds || visibleColumnIds.has(column.id)));
+}
+/**
+ * Build the scalar matrix for a set of rows.
+ *
+ * `extractColumnValue` is the same extractor the grid's `valueGetter` and the
+ * card's field text use, so a CSV cell can never disagree with what the table
+ * sorted or displayed for that column.
+ *
+ * @stability experimental
+ */
+export function buildExportMatrix(columns, rows) {
+    return {
+        header: columns.map((column) => column.label),
+        body: rows.map((row) => columns.map((column) => extractColumnValue(column, row))),
+    };
+}
+/**
+ * The complete CSV file text (BOM included) for a set of rows.
+ *
+ * @stability experimental
+ */
+export function buildCsvForRows(columns, rows, visibleColumnIds) {
+    const cols = exportColumns(columns, visibleColumnIds);
+    const { header, body } = buildExportMatrix(cols, rows);
+    return toCsvFile(header, body);
+}
+// ---------------------------------------------------------------------------
+// Filename
+// ---------------------------------------------------------------------------
+/**
+ * `Enrichment jobs` → `enrichment-jobs`. Empty input falls back to `export`.
+ *
+ * @stability experimental
+ */
+export function slugifyExportName(name) {
+    const slug = (name ?? '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64);
+    return slug.length > 0 ? slug : 'export';
+}
+/**
+ * `jobs-2026-08-05.csv`.
+ *
+ * Dated because an export is a snapshot: two files downloaded a week apart must
+ * not collide in a Downloads folder, and `jobs (3).csv` tells nobody anything.
+ *
+ * @stability experimental
+ */
+export function exportFilename(base, now = new Date()) {
+    const iso = Number.isNaN(now.getTime()) ? '' : `-${now.toISOString().slice(0, 10)}`;
+    return `${slugifyExportName(base)}${iso}.csv`;
+}
+// ---------------------------------------------------------------------------
+// Download
+// ---------------------------------------------------------------------------
+/**
+ * Hand a CSV string to the browser as a file download.
+ *
+ * A Blob + object URL + synthetic anchor click, which is the only approach that
+ * works without a server round trip and without `data:` URI length limits.
+ * Returns `false` when the environment cannot do it (jsdom without a
+ * `createObjectURL` stub, an ancient browser) rather than throwing — a failed
+ * download must not take a render down with it.
+ *
+ * @stability experimental
+ */
+export function downloadCsv(content, filename) {
+    if (typeof document === 'undefined' || typeof URL === 'undefined')
+        return false;
+    if (typeof URL.createObjectURL !== 'function')
+        return false;
+    const blob = new Blob([content], { type: 'text/csv;charset=utf-8;' });
+    const url = URL.createObjectURL(blob);
+    try {
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = filename;
+        anchor.rel = 'noopener';
+        anchor.style.display = 'none';
+        document.body.appendChild(anchor);
+        anchor.click();
+        anchor.remove();
+        return true;
+    }
+    finally {
+        // Deferred: revoking synchronously can cancel the download in some browsers.
+        setTimeout(() => URL.revokeObjectURL(url), 0);
+    }
+}
+/**
+ * Thrown when an in-flight export is cancelled by the user.
+ *
+ * @stability experimental
+ */
+export class ExportCancelledError extends Error {
+    constructor() {
+        super('Export cancelled');
+        this.name = 'ExportCancelledError';
+    }
+}
+/**
+ * Walk the page's fetch callback until it runs dry or the ceiling is reached.
+ *
+ * Page numbers are ZERO-BASED, matching `DataTablePaginationConfig` — the owning
+ * page already converts at its own fetch boundary, and handing it a second
+ * convention here would guarantee an off-by-one nobody notices until row 251 is
+ * missing.
+ *
+ * Termination is defensive on purpose: a short page, an empty page, the row
+ * ceiling, or `MAX_FETCH_PAGES` (200), whichever comes first. A callback that
+ * ignores `page` and keeps returning the same full page would otherwise loop
+ * until the tab dies.
+ *
+ * @stability experimental
+ */
+export async function collectAllRows({ fetchPage, pageSize = DATA_TABLE_EXPORT_FETCH_PAGE_SIZE, maxRows = DATA_TABLE_EXPORT_MAX_ROWS, onProgress, signal, }) {
+    const collected = [];
+    let page = 0;
+    let capped = false;
+    while (page < MAX_FETCH_PAGES) {
+        if (signal?.aborted)
+            throw new ExportCancelledError();
+        const batch = await fetchPage({ page, pageSize, signal });
+        if (signal?.aborted)
+            throw new ExportCancelledError();
+        const rows = Array.isArray(batch) ? batch : [];
+        if (rows.length === 0)
+            break;
+        for (const row of rows) {
+            if (collected.length >= maxRows) {
+                capped = true;
+                break;
+            }
+            collected.push(row);
+        }
+        onProgress?.(collected.length);
+        if (capped || rows.length < pageSize)
+            break;
+        page += 1;
+    }
+    return { rows: collected, capped };
+}
+//# sourceMappingURL=exportModel.js.map

package/dist/datatable/headless/export/exportModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportModel.js","sourceRoot":"","sources":["../../../../src/datatable/headless/export/exportModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAErD,kEAAkE;AAClE,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAM,MAA4B;IAClE,OAAO,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA+B,EAC/B,gBAAsC;IAEtC,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,EAAE,CACT,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CACvF,CAAC;AACJ,CAAC;AAkBD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA+B,EAC/B,IAAoB;IAEpB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7C,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B,EAC/B,IAAoB,EACpB,gBAAsC;IAEtC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+B,EAAE,MAAY,IAAI,IAAI,EAAE;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACpF,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;AAChD,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAgB;IAC3D,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,GAAG,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAE5D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;QAClB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,MAAM,CAAC,GAAG,GAAG,UAAU,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,6EAA6E;QAC7E,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAoCD;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;QACE,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAM,EACxC,SAAS,EACT,QAAQ,GAAG,iCAAiC,EAC5C,OAAO,GAAG,0BAA0B,EACpC,UAAU,EACV,MAAM,GACqB;IAC3B,MAAM,SAAS,GAAU,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO,IAAI,GAAG,eAAe,EAAE,CAAC;QAC9B,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAEtD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAEtD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QAE7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;gBAChC,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,UAAU,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ;YAAE,MAAM;QAC5C,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC"}

package/dist/datatable/headless/filter/filterMatch.d.ts

@@ -0,0 +1,37 @@
+/**
+ * DataTable — client-side filter matching, for pages that need it.
+ *
+ * The table NEVER filters the rows it is given: filtering is the server's.
+ * These helpers exist for the places that have no server to ask — a mock
+ * endpoint in a test, a fixture-backed Storybook page, a page that filters an
+ * already-loaded list — and they use the same per-type rules a registered
+ * filter type declares (`DataTableFilterTypeDef.matches`), so a custom type is
+ * matched the way its author defined.
+ */
+import type { DataTableColumn, DataTableFilterModel, DataTableFilterValue, FilterOperator } from '../types.js';
+/**
+ * Whether a value satisfies one comparison under a filter type's rules.
+ *
+ * @param type - the filter type id.
+ * @param value - the scalar behind the cell.
+ * @param operator - the operator.
+ * @param operand - the operand.
+ * @returns `true` when it matches; `false` for an unregistered type.
+ *
+ * @stability experimental
+ */
+export declare function matchesFilterValue(type: string, value: unknown, operator: FilterOperator, operand: DataTableFilterValue): boolean;
+/**
+ * Whether a row satisfies every filter of a model (they are AND-ed). A filter
+ * naming a column the table no longer declares is ignored, as the chips do.
+ *
+ * @param row - the row.
+ * @param columns - the table's columns.
+ * @param model - the filter model.
+ * @returns `true` when the row matches all of them.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function matchesFilters<Row>(row: Row, columns: DataTableColumn<Row>[], model: DataTableFilterModel): boolean;
+//# sourceMappingURL=filterMatch.d.ts.map

package/dist/datatable/headless/filter/filterMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterMatch.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/filterMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAmB,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIhI;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAGT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAMnH"}

package/dist/datatable/headless/filter/filterMatch.js

@@ -0,0 +1,49 @@
+/**
+ * DataTable — client-side filter matching, for pages that need it.
+ *
+ * The table NEVER filters the rows it is given: filtering is the server's.
+ * These helpers exist for the places that have no server to ask — a mock
+ * endpoint in a test, a fixture-backed Storybook page, a page that filters an
+ * already-loaded list — and they use the same per-type rules a registered
+ * filter type declares (`DataTableFilterTypeDef.matches`), so a custom type is
+ * matched the way its author defined.
+ */
+import { extractColumnValue } from '../columns.js';
+import { getDataTableFilterType } from './filterTypes.js';
+import { filterTypeOf } from './operators.js';
+/**
+ * Whether a value satisfies one comparison under a filter type's rules.
+ *
+ * @param type - the filter type id.
+ * @param value - the scalar behind the cell.
+ * @param operator - the operator.
+ * @param operand - the operand.
+ * @returns `true` when it matches; `false` for an unregistered type.
+ *
+ * @stability experimental
+ */
+export function matchesFilterValue(type, value, operator, operand) {
+    const def = getDataTableFilterType(type);
+    return def ? def.matches(value, operator, operand) : false;
+}
+/**
+ * Whether a row satisfies every filter of a model (they are AND-ed). A filter
+ * naming a column the table no longer declares is ignored, as the chips do.
+ *
+ * @param row - the row.
+ * @param columns - the table's columns.
+ * @param model - the filter model.
+ * @returns `true` when the row matches all of them.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function matchesFilters(row, columns, model) {
+    return model.every((filter) => {
+        const column = columns.find((candidate) => candidate.id === filter.columnId);
+        if (!column)
+            return true;
+        return matchesFilterValue(filterTypeOf(column), extractColumnValue(column, row), filter.operator, filter.value);
+    });
+}
+//# sourceMappingURL=filterMatch.js.map

package/dist/datatable/headless/filter/filterMatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterMatch.js","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/filterMatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAc,EACd,QAAwB,EACxB,OAA6B;IAE7B,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAM,GAAQ,EAAE,OAA+B,EAAE,KAA2B;IACxG,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,MAAuB,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/datatable/headless/filter/filterModel.d.ts

@@ -0,0 +1,114 @@
+/**
+ * DataTable — normalized filter model helpers.
+ *
+ * Pure functions over `DataTableFilterModel`. No React, no MUI: the model is
+ * data a page owns, and everything that reads or writes it — the panel, the
+ * chips, the URL helper, and a calling page mapping filters onto query params —
+ * shares these primitives so "what counts as a complete filter" has exactly one
+ * definition.
+ */
+import type { DataTableColumn, DataTableFilter, DataTableFilterModel, DataTableFilterValue } from '../types.js';
+import { operatorArity } from './operators.js';
+/**
+ * Find the column a filter targets, if the table still declares it.
+ *
+ * @stability experimental
+ */
+export declare function columnForFilter<Row>(columns: DataTableColumn<Row>[], filter: DataTableFilter): DataTableColumn<Row> | undefined;
+/**
+ * The blank operand for a fresh filter: `null` for a 0-arity operator, an empty
+ * pair for `between`, an empty set for `isAnyOf`, `''` otherwise.
+ *
+ * `between` starts as `['', '']` rather than `null` so the two inputs stay
+ * controlled from the first render (a React input that switches from
+ * uncontrolled to controlled warns, and worse, drops the first keystroke).
+ *
+ * @stability experimental
+ */
+export declare function blankValueFor(arity: ReturnType<typeof operatorArity>): DataTableFilterValue;
+/**
+ * A fresh, not-yet-complete filter targeting `column`.
+ *
+ * @stability experimental
+ */
+export declare function draftFilterFor<Row>(column: DataTableColumn<Row>): DataTableFilter;
+/**
+ * Whether a filter carries enough information to be sent to the server.
+ *
+ * The panel keeps an incomplete filter as a LOCAL draft and never emits it —
+ * emitting `{ columnId: 'status', operator: 'is', value: '' }` would make the
+ * page refetch with a meaningless param on the first click of "Add filter".
+ *
+ * @stability experimental
+ */
+export declare function isFilterComplete(filter: DataTableFilter): boolean;
+/**
+ * Structural identity, used to key React lists and to reject exact duplicates.
+ *
+ * @stability experimental
+ */
+export declare function filterKey(filter: DataTableFilter): string;
+/**
+ * Whether two filters are the same predicate (same column, operator and value).
+ *
+ * @param a - one filter.
+ * @param b - another.
+ * @returns `true` when they are equal.
+ *
+ * @stability experimental
+ */
+export declare function sameFilter(a: DataTableFilter, b: DataTableFilter): boolean;
+/**
+ * Whether `model` already contains an identical filter.
+ *
+ * @stability experimental
+ */
+export declare function containsFilter(model: DataTableFilterModel, filter: DataTableFilter): boolean;
+/**
+ * Human-readable operand, used in chip labels.
+ *
+ * @stability experimental
+ */
+export declare function describeFilterValue<Row>(filter: DataTableFilter, column: DataTableColumn<Row> | undefined): string;
+/**
+ * The chip label: `"Status is Failed"`.
+ *
+ * Falls back to the raw `columnId` when the table no longer declares that
+ * column — a filter restored from a URL after a column was renamed should read
+ * as something removable, not crash the chip strip.
+ *
+ * @stability experimental
+ */
+export declare function filterChipLabel<Row>(filter: DataTableFilter, columns: DataTableColumn<Row>[]): string;
+/**
+ * A filter model with `filter` added, unless an identical one is already in it.
+ *
+ * @param model - the current model.
+ * @param filter - the filter to add.
+ * @returns the new model (the same array when nothing changed).
+ *
+ * @stability experimental
+ */
+export declare function addFilter(model: DataTableFilterModel, filter: DataTableFilter): DataTableFilterModel;
+/**
+ * A filter model without the filter at `index`.
+ *
+ * @param model - the current model.
+ * @param index - the position to remove.
+ * @returns the new model.
+ *
+ * @stability experimental
+ */
+export declare function removeFilterAt(model: DataTableFilterModel, index: number): DataTableFilterModel;
+/**
+ * A filter model with the filter at `index` replaced.
+ *
+ * @param model - the current model.
+ * @param index - the position to replace.
+ * @param filter - the replacement.
+ * @returns the new model.
+ *
+ * @stability experimental
+ */
+export declare function replaceFilterAt(model: DataTableFilterModel, index: number, filter: DataTableFilter): DataTableFilterModel;
+//# sourceMappingURL=filterModel.d.ts.map

package/dist/datatable/headless/filter/filterModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterModel.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/filter/filterModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAIL,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EACjC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,EAC/B,MAAM,EAAE,eAAe,GACtB,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAElC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GAAG,oBAAoB,CAK3F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CASjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAcjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EACrC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,GACvC,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EACjC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GAC9B,MAAM,CAMR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,eAAe,GACtB,oBAAoB,CAGtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAEtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GACtB,oBAAoB,CAEtB"}