@flanksource/clicky-ui 0.3.17 → 0.3.18

package/dist/data/DataTable.d.ts

@@ -6,6 +6,7 @@ import { ModalSize } from '../overlay/Modal';
 import { FilterBarFilter, FilterBarProps, FilterBarRangeProps, FilterBarSearchProps } from '../components/FilterBar';
 import { StaticIconComponent } from './Icon';
 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';
@@ -42,6 +43,12 @@ export type DataTableColumn<T extends Record<string, unknown> = Record<string, u
     sortable?: boolean;
     /** Enables a generated column filter when `autoFilter` is true. */
     filterable?: boolean;
+    /** Native server-filter parameter associated with this rendered column. */
+    filterKey?: string;
+    /** Converts the raw cell value to the exact scalar sent to the native server filter. */
+    serverFilterValue?: (value: unknown, row: T) => unknown;
+    /** Converts the raw cell value to the label shown by server-filter actions. */
+    serverFilterLabel?: (value: unknown, row: T) => string;
     /** Prefer allocating extra width to this column. */
     grow?: boolean;
     /** Prefer keeping this column compact. */
@@ -93,12 +100,48 @@ export type DataTablePagination = {
     pageSize: number;
     /** Total row count if known; enables "Page X of Y". */
     total?: number;
-    /** Called when the user moves to another page. */
-    onPageChange: (page: number) => void;
+    /**
+     * Whether `total` is a count ("eq") or a lower bound ("gte"). A backend that
+     * stops counting past a threshold reports a bound, and rendering it as a
+     * count would state a number nobody promised.
+     */
+    totalRelation?: "eq" | "gte";
+    /**
+     * The server's answer for whether rows follow this page. Preferred over
+     * inferring the end of the data from a short page: the two are different
+     * facts, and only the server knows which one happened.
+     */
+    hasMore?: boolean;
+    /**
+     * Called when the user moves to another page. Absent when the surface cannot
+     * name a position past its first page — an operation with no offset or cursor
+     * parameter. Such a table still counts and still resizes; it just has nowhere
+     * to step to, so the step controls are not rendered.
+     */
+    onPageChange?: (page: number) => void;
     /** Called when the page size select changes. */
     onPageSizeChange: (pageSize: number) => void;
     /** Available page sizes. Defaults to [25, 50, 100, 200]. */
     pageSizeOptions?: number[];
+    /**
+     * Cursor paging. When present the footer steps through the cursors the
+     * server minted instead of by page number — a cursor names a position in an
+     * ordered result, so there is no cursor for a page nobody has visited and
+     * the page-number jump is not offered.
+     */
+    cursor?: DataTableCursorPagination;
+};
+/**
+ * DataTableCursorPagination is the caller's half of a cursor walk. The tokens
+ * are opaque: they are handed back unchanged and never parsed.
+ */
+export type DataTableCursorPagination = {
+    /** The cursor this page was fetched with; undefined on the first page. */
+    current?: string;
+    /** The cursor that resumes after this page; absent when the data is exhausted. */
+    next?: string;
+    /** Fetch the page at this cursor; undefined returns to the first page. */
+    onCursorChange: (cursor: string | undefined) => void;
 };
 export type DataTableMenuAction = {
     id: string;
@@ -178,7 +221,13 @@ type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unkn
     scrollContainerClassName?: string;
     /** Generate filters from filterable columns. */
     autoFilter?: boolean;
-    /** Show the global search input. */
+    /**
+     * Show the built-in global search input. Defaults to `autoFilter` — the box
+     * narrows rows client-side, so it only mounts by default where DataTable
+     * already owns filtering. Set it explicitly to search a table that generates
+     * no column filters; combine with `manualFilter` plus `globalFilter` /
+     * `onGlobalFilterChange` (or use `externalSearch`) to drive a source query.
+     */
     showGlobalFilter?: boolean;
     /** Controlled global search value. */
     globalFilter?: string;
@@ -197,6 +246,13 @@ type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unkn
     onSortChange?: (sort: SortState | null) => void;
     /** When true, header sorting updates state but does not reorder `data`. */
     manualSort?: boolean;
+    /**
+     * When true, filters update state but do NOT narrow `data`. The mirror of
+     * `manualSort`: the source owns filtering and DataTable only renders the
+     * controls. Suppresses the client-side filter pass, the built-in search's row
+     * narrowing, and the column-derived time range.
+     */
+    manualFilter?: boolean;
     /** Extra props forwarded to the internal FilterBar. */
     filterBarProps?: Omit<FilterBarProps, "search" | "filters">;
     /**
@@ -221,6 +277,10 @@ type DataTableInnerProps<T extends Record<string, unknown> = Record<string, unkn
      * column filters so the caller's natural ordering wins.
      */
     externalFilters?: FilterBarFilter[];
+    /** Current modes for native server-backed cell filters. */
+    cellFilters?: Record<string, Record<string, CellFilterMode>>;
+    /** Called when a cell's include/exclude hover action changes. */
+    onCellFilterChange?: (change: CellFilterChange) => void;
     /**
      * Server-side pagination footer. When provided, a small page-size / prev /
      * next strip is rendered below the table; the DataTable does NOT slice

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":"AAAA,OAAO,EASL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AACf,OAAO,EAAW,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAoB,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIlE,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAIL,KAAK,eAAe,EAGpB,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAcjC,OAAO,EAAQ,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAuBxD,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAKL,KAAK,sBAAsB,EAE3B,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,mFAAmF;IACnF,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,WAAW,GAAG,IAAI,CAAC;IACnD,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;CAC1C,CAAC;AAEF,KAAK,WAAW,GACZ,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAkErC,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAC/D,CAAC;AAcF,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IACxD,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IACvD,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;IAC/C,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IAChD,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,WAAW,CAAC;IACtD,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAEhC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,gDAAgD;IAChD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;0DAEsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,uEAAuE;IACvE,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,uEAAuE;IACvE,iBAAiB,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IACzE,2DAA2D;IAC3D,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IACtC,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2DAA2D;IAC3D,YAAY,EAAE,CAAC,EAAE,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,mBAAmB,CACtB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD;IACF,mEAAmE;IACnE,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,OAAO,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,+CAA+C;IAC/C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B;IAC1B,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7D,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,mEAAmE;IACnE,YAAY,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACxE;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,sBAAsB,KAAK,SAAS,CAAC,CAAC;IACtE;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;IACrC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5C,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,CAClB,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAClC,SAAS,CAAC;IACf;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC;IACxD,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+CAA+C;IAC/C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mDAAmD;IACnD,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG;IACnD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAw9FF,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3D,KAAK,EAAE,SAAoB,EAC3B,aAAa,EACb,gBAAwB,EACxB,qBAA6B,EAC7B,eAAyB,EACzB,qBAAgD,EAChD,SAAS,EACT,cAAc,EACd,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,CAAC,CAAC,2CAiEnB"}

package/dist/data/DataTable.js

@@ -11,11 +11,13 @@ import { useEscapeLayer } from "../overlay/modalStack.js";
 import { FilterBar, FilterBarFilterPanel, FilterBarRangePanel } from "../components/FilterBar.js";
 import { isFilterBarFilterActive, clearFilterBarFilter } from "../components/filter-bar-utils.js";
 import { resolveColumnValue, getFilterTokens, resolvePath, getFilterCandidate, prettifyKey } from "./data-table-utils.js";
+import { assertDataTableFilterProps } from "./data-table-server-filters.js";
 import { Icon } from "./Icon.js";
 import { SortableHeader } from "./SortableHeader.js";
 import { Timestamp } from "./cells/Timestamp.js";
 import { parseTimestamp, chooseTimestampFormat, modeToFormat, resolveDateMath } from "./cells/timestamp-format.js";
 import { TagActionsProvider, TagList } from "./cells/TagList.js";
+import { CellFilterActions } from "./cells/CellFilterActions.js";
 import { tagActionsFromRecord, tagFilterTokens, normalizeTags, splitTagToken } from "./cells/tag-utils.js";
 import { StatusDot } from "./cells/StatusDot.js";
 import { normalizeStatus } from "./cells/status-mapping.js";
@@ -67,12 +69,13 @@ function DataTableInner({
   loading = false,
   loadingMessage = "Loading results…",
   loadingRowCount = 8,
-  emptyMessage: _emptyMessage = "No data",
+  emptyMessage = "No data",
   clientReveal,
   className,
   scrollContainerClassName,
   autoFilter = false,
-  showGlobalFilter = true,
+  showGlobalFilter,
+  manualFilter = false,
   globalFilter,
   onGlobalFilterChange,
   globalFilterPlaceholder = "Search all columns…",
@@ -84,6 +87,8 @@ function DataTableInner({
   externalSearch,
   externalTimeRange,
   externalFilters,
+  cellFilters,
+  onCellFilterChange,
   pagination,
   getRowId,
   rowSelection,
@@ -282,14 +287,14 @@ function DataTableInner({
   const showTablePreferencesControl = showColumnVisibilityControl || resolvedShowDensityControl || showThemeControl || hasMenuActions;
   const densityOverride = densityControlled ? density : localDensityOverride;
   const timeRangeColumn = useMemo(() => {
-    if (filterBarProps == null ? void 0 : filterBarProps.timeRange) return null;
+    if (manualFilter || externalTimeRange || (filterBarProps == null ? void 0 : filterBarProps.timeRange)) return null;
     return effectiveColumns.find(
       (column) => {
         var _a;
         return column.kind === "timestamp" && column.filterable !== false && ((_a = column.timestamp) == null ? void 0 : _a.autoRangeFilter) !== false;
       }
     ) ?? null;
-  }, [effectiveColumns, filterBarProps == null ? void 0 : filterBarProps.timeRange]);
+  }, [effectiveColumns, externalTimeRange, filterBarProps == null ? void 0 : filterBarProps.timeRange, manualFilter]);
   const filterableColumns = useMemo(
     () => effectiveColumns.filter((column) => {
       if (column.filterable === false) return false;
@@ -428,10 +433,23 @@ function DataTableInner({
     }),
     [generatedFilters, multiFilters, numberFilters, textFilters]
   );
-  const nativeFilterByColumn = useMemo(
-    () => new Map(nativeFilters.map((filter) => [filter.key, filter])),
-    [nativeFilters]
+  const serverFilterByKey = useMemo(
+    () => new Map((externalFilters ?? []).map((filter) => [filter.key, filter])),
+    [externalFilters]
   );
+  const headerFilterByColumn = useMemo(() => {
+    const bound = /* @__PURE__ */ new Map();
+    for (const column of effectiveColumns) {
+      const native = nativeFilters.find((filter) => filter.key === column.key);
+      if (native) {
+        bound.set(column.key, native);
+        continue;
+      }
+      const server = column.filterKey ? serverFilterByKey.get(column.filterKey) : void 0;
+      if (server) bound.set(column.key, server);
+    }
+    return bound;
+  }, [effectiveColumns, nativeFilters, serverFilterByKey]);
   const hasCustomFilterBarContent = Boolean(
     (filterBarProps == null ? void 0 : filterBarProps.leading) || (filterBarProps == null ? void 0 : filterBarProps.children) || (filterBarProps == null ? void 0 : filterBarProps.trailing) || (filterBarProps == null ? void 0 : filterBarProps.timeRange) || (filterBarProps == null ? void 0 : filterBarProps.dateRange)
   );
@@ -458,7 +476,15 @@ function DataTableInner({
     }
     return next;
   }, [timeRangeColumn, timeRangeFilter.from, timeRangeFilter.to]);
-  const showFilterBar = autoFilter && (showGlobalFilter || nativeFilters.length > 0) || !!autoTimeRange || !!externalSearch || !!externalTimeRange || externalFilters && externalFilters.length > 0 || hasCustomFilterBarContent || showTablePreferencesControl;
+  const resolvedShowGlobalFilter = showGlobalFilter ?? autoFilter;
+  assertDataTableFilterProps({
+    autoFilter,
+    manualFilter,
+    showGlobalFilter: resolvedShowGlobalFilter,
+    globalFilterControlled: globalFilter !== void 0 || onGlobalFilterChange !== void 0,
+    hasExternalSearch: externalSearch !== void 0
+  });
+  const showFilterBar = resolvedShowGlobalFilter || nativeFilters.length > 0 || !!autoTimeRange || !!externalSearch || !!externalTimeRange || externalFilters && externalFilters.length > 0 || hasCustomFilterBarContent || showTablePreferencesControl;
   const setDensityOverride = (next) => {
     if (!densityControlled) setLocalDensityOverride(next);
     onDensityChange == null ? void 0 : onDensityChange(next);
@@ -472,8 +498,9 @@ function DataTableInner({
       }
     )
   ] }) : filterBarProps == null ? void 0 : filterBarProps.trailing;
-  const showHeaderFilterControls = showHeaderFilters && (autoFilter || !!autoTimeRange);
+  const showHeaderFilterControls = showHeaderFilters && (headerFilterByColumn.size > 0 || !!autoTimeRange);
   const filteredRows = useMemo(() => {
+    if (manualFilter) return rows;
     const globalNeedle = effectiveGlobalFilter.trim().toLowerCase();
     const now = /* @__PURE__ */ new Date();
     const rangeFromDate = timeRangeColumn ? resolveDateMath(timeRangeFilter.from, now) : null;
@@ -534,6 +561,7 @@ function DataTableInner({
     effectiveGlobalFilter,
     filterableColumns,
     generatedFilters,
+    manualFilter,
     multiFilters,
     numberFilters,
     rows,
@@ -560,6 +588,7 @@ function DataTableInner({
     ...onSortChange ? { onSortChange } : {},
     ...(defaultSort == null ? void 0 : defaultSort.key) ? { defaultKey: defaultSort.key } : {}
   });
+  const pageLocalSort = !!pagination && !onSortChange;
   const revealEnabled = !!clientReveal && !pagination;
   const revealBatchSize = (clientReveal == null ? void 0 : clientReveal.batchSize) ?? 0;
   const [visibleCount, setVisibleCount] = useState(revealBatchSize);
@@ -798,7 +827,7 @@ function DataTableInner({
           FilterBar,
           {
             ...filterBarProps,
-            ...externalSearch ? { search: externalSearch } : autoFilter && showGlobalFilter ? {
+            ...externalSearch ? { search: externalSearch } : resolvedShowGlobalFilter ? {
               search: {
                 value: effectiveGlobalFilter,
                 onChange: setEffectiveGlobalFilter,
@@ -816,7 +845,7 @@ function DataTableInner({
             "div",
             {
               className: cn(
-                "min-h-0 max-w-full flex-1 overflow-auto overscroll-x-contain rounded-md border border-border",
+                "min-h-0 max-w-full flex-1 overflow-auto overscroll-x-contain rounded-md border border-border bg-background",
                 scrollContainerClassName
               ),
               "aria-busy": loading && error == null || void 0,
@@ -875,7 +904,15 @@ function DataTableInner({
                               resizableColumns && column.resizable !== false && "pr-2"
                             ),
                             children: [
-                              /* @__PURE__ */ jsx("span", { className: "min-w-0", children: column.sortable === false ? /* @__PURE__ */ jsx("span", { children: column.label }) : /* @__PURE__ */ jsx(
+                              /* @__PURE__ */ jsx("span", { className: "min-w-0", children: column.sortable === false || pageLocalSort ? /* @__PURE__ */ jsx(
+                                "span",
+                                {
+                                  ...pageLocalSort && column.sortable !== false ? {
+                                    title: "Sorting is served by the query while this table is paged by the server"
+                                  } : {},
+                                  children: column.label
+                                }
+                              ) : /* @__PURE__ */ jsx(
                                 SortableHeader,
                                 {
                                   active: (sort == null ? void 0 : sort.key) === column.key,
@@ -885,12 +922,12 @@ function DataTableInner({
                                   children: column.label
                                 }
                               ) }),
-                              showHeaderFilterControls && (nativeFilterByColumn.has(column.key) || autoTimeRange && (timeRangeColumn == null ? void 0 : timeRangeColumn.key) === column.key) && /* @__PURE__ */ jsx(
+                              showHeaderFilterControls && (headerFilterByColumn.has(column.key) || autoTimeRange && (timeRangeColumn == null ? void 0 : timeRangeColumn.key) === column.key) && /* @__PURE__ */ jsx(
                                 HeaderFilterButton,
                                 {
                                   column,
-                                  active: nativeFilterByColumn.has(column.key) ? isFilterBarFilterActive(
-                                    nativeFilterByColumn.get(column.key)
+                                  active: headerFilterByColumn.has(column.key) ? isFilterBarFilterActive(
+                                    headerFilterByColumn.get(column.key)
                                   ) : Boolean(
                                     timeRangeFilter.from || timeRangeFilter.to
                                   ),
@@ -942,7 +979,14 @@ function DataTableInner({
                       message: loadingMessage,
                       selection: !!rowSelection
                     }
-                  ) : rowStream.map((item) => {
+                  ) : filteredRows.length === 0 ? /* @__PURE__ */ jsx("tr", { children: /* @__PURE__ */ jsx(
+                    "td",
+                    {
+                      colSpan: visibleColumns.length + (rowSelection ? 1 : 0),
+                      className: "px-4 py-10 text-center text-sm text-muted-foreground",
+                      children: emptyMessage
+                    }
+                  ) }) : rowStream.map((item) => {
                     var _a;
                     if (item.kind === "group") {
                       return /* @__PURE__ */ jsx(
@@ -1043,11 +1087,40 @@ function DataTableInner({
                               }
                             ) : null,
                             visibleColumns.map((column, index) => {
+                              var _a2;
                               const rawValue = resolveColumnValue(
                                 record.row,
                                 column
                               );
                               let content = column.render ? column.render(rawValue, record.row) : formatCell(rawValue);
+                              const serverFilterValue = resolveServerFilterValue(
+                                rawValue,
+                                record.row,
+                                column
+                              );
+                              const serverFilterDisplayValue = resolveCellFilterDisplayValue(
+                                rawValue,
+                                record.row,
+                                column
+                              );
+                              const hasCellFilterActions = !!column.filterKey && !!onCellFilterChange && serverFilterValue !== void 0;
+                              if (column.filterKey && onCellFilterChange && serverFilterValue !== void 0) {
+                                const filterKey = column.filterKey;
+                                content = /* @__PURE__ */ jsx(
+                                  CellFilterActions,
+                                  {
+                                    value: serverFilterValue,
+                                    ...serverFilterDisplayValue !== void 0 ? { displayValue: serverFilterDisplayValue } : {},
+                                    mode: (_a2 = cellFilters == null ? void 0 : cellFilters[filterKey]) == null ? void 0 : _a2[serverFilterValue],
+                                    onChange: (mode) => onCellFilterChange({
+                                      key: filterKey,
+                                      value: serverFilterValue,
+                                      mode
+                                    }),
+                                    children: content
+                                  }
+                                );
+                              }
                               if (column.kind === "tags" && filterActionsByColumn[column.key]) {
                                 content = /* @__PURE__ */ jsx(
                                   TagActionsProvider,
@@ -1075,10 +1148,14 @@ function DataTableInner({
                                         // overlay stretches across the whole (relative)
                                         // row: right/middle-click give native "open in
                                         // new tab", plain left-click routes client-side.
+                                        // The overlay paints over the cell, so a cell
+                                        // with filter actions lifts them above it —
+                                        // otherwise the link swallows the hover that
+                                        // reveals the include/exclude buttons.
                                         renderLink({
                                           to: href,
                                           className: "hover:underline after:absolute after:inset-0 after:content-['']",
-                                          children: content
+                                          children: hasCellFilterActions ? /* @__PURE__ */ jsx("span", { className: "relative z-10 inline-flex min-w-0 items-center", children: content }) : content
                                         })
                                       ) : content
                                     }
@@ -1170,7 +1247,7 @@ function DataTableInner({
         headerFilterMenu && /* @__PURE__ */ jsx(
           HeaderFilterMenu,
           {
-            filter: nativeFilterByColumn.get(headerFilterMenu.columnKey ?? ""),
+            filter: headerFilterByColumn.get(headerFilterMenu.columnKey ?? ""),
             ...autoTimeRange && (timeRangeColumn == null ? void 0 : timeRangeColumn.key) === headerFilterMenu.columnKey ? { timeRange: autoTimeRange } : {},
             anchor: headerFilterMenu,
             onClose: () => setHeaderFilterMenu(null)
@@ -1180,28 +1257,81 @@ function DataTableInner({
     }
   ) });
 }
+function resolveServerFilterValue(rawValue, row, column) {
+  const value = column.serverFilterValue ? column.serverFilterValue(rawValue, row) : rawValue;
+  switch (typeof value) {
+    case "string":
+      return value || void 0;
+    case "number":
+    case "boolean":
+      return String(value);
+    default:
+      return void 0;
+  }
+}
+function resolveCellFilterDisplayValue(rawValue, row, column) {
+  const value = column.serverFilterLabel ? column.serverFilterLabel(rawValue, row) : rawValue;
+  switch (typeof value) {
+    case "string":
+      return value || void 0;
+    case "number":
+    case "boolean":
+      return String(value);
+    default:
+      return void 0;
+  }
+}
 const DEFAULT_PAGE_SIZE_OPTIONS = [5, 10, 25, 50, 100, 200];
+function useCursorTrail(cursor) {
+  const [trail, setTrail] = useState([]);
+  const current = cursor == null ? void 0 : cursor.current;
+  const index = current == null ? 0 : Math.max(trail.indexOf(current) + 1, 1);
+  return {
+    page: index,
+    push: (next) => setTrail((previous) => [...previous.slice(0, index), next]),
+    previous: () => index <= 1 ? void 0 : trail[index - 2]
+  };
+}
 function DataTablePaginationFooter({
   pagination,
   visibleRowCount,
   loading,
   loadingMessage
 }) {
-  const { page, pageSize, total, onPageChange, onPageSizeChange } = pagination;
+  const { page, pageSize, total, totalRelation, cursor, onPageChange, onPageSizeChange } = pagination;
   const options = Array.from(
     /* @__PURE__ */ new Set([
       ...pagination.pageSizeOptions ?? DEFAULT_PAGE_SIZE_OPTIONS,
       pageSize
     ])
   ).sort((a, b) => a - b);
-  const safePage = Math.max(0, page);
-  const totalPages = total != null && pageSize > 0 ? Math.max(1, Math.ceil(total / pageSize)) : void 0;
+  const trail = useCursorTrail(cursor);
+  const safePage = cursor ? trail.page : Math.max(0, page);
+  const approximate = totalRelation === "gte";
+  const totalPages = total != null && pageSize > 0 && !approximate && !cursor ? Math.max(1, Math.ceil(total / pageSize)) : void 0;
   const atFirst = safePage === 0;
-  const atLast = totalPages != null ? safePage >= totalPages - 1 : visibleRowCount < pageSize;
+  const atLast = cursor ? cursor.next == null : pagination.hasMore != null ? !pagination.hasMore : totalPages != null ? safePage >= totalPages - 1 : visibleRowCount < pageSize;
   const hasVisibleRows = visibleRowCount > 0;
   const rangeStart = total === 0 || !hasVisibleRows ? 0 : safePage * pageSize + 1;
-  const rangeEnd = total != null && hasVisibleRows ? Math.min(total, rangeStart + Math.max(visibleRowCount - 1, 0)) : visibleRowCount;
-  const rangeLabel = total != null ? `${rangeStart}-${rangeEnd} of ${total}` : `${visibleRowCount} row${visibleRowCount === 1 ? "" : "s"}`;
+  const rangeEnd = total != null && hasVisibleRows ? Math.min(approximate ? Infinity : total, rangeStart + Math.max(visibleRowCount - 1, 0)) : visibleRowCount;
+  const rangeLabel = total != null ? `${rangeStart}-${rangeEnd} of ${approximate ? `~${total}+` : total}` : `${visibleRowCount} row${visibleRowCount === 1 ? "" : "s"}`;
+  const steppable = cursor != null || onPageChange != null;
+  const goPrevious = () => {
+    if (!cursor) {
+      onPageChange == null ? void 0 : onPageChange(Math.max(0, safePage - 1));
+      return;
+    }
+    cursor.onCursorChange(trail.previous());
+  };
+  const goNext = () => {
+    if (!cursor) {
+      onPageChange == null ? void 0 : onPageChange(safePage + 1);
+      return;
+    }
+    if (cursor.next == null) return;
+    trail.push(cursor.next);
+    cursor.onCursorChange(cursor.next);
+  };
   return /* @__PURE__ */ jsxs("div", { className: "flex min-h-9 shrink-0 flex-row items-stretch gap-3 border-t border-border/70 px-1 pt-2 text-xs text-muted-foreground sm:flex-row sm:flex-wrap sm:items-center sm:justify-between", children: [
     /* @__PURE__ */ jsx("div", { "aria-live": "polite", children: loading ? loadingMessage : rangeLabel }),
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap  items-center gap-2 sm:gap-3", children: [
@@ -1217,35 +1347,37 @@ function DataTablePaginationFooter({
           }
         )
       ] }),
-      /* @__PURE__ */ jsxs("span", { className: "min-w-20 text-center", children: [
-        "Page ",
-        safePage + 1,
-        totalPages != null ? ` of ${totalPages}` : ""
-      ] }),
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          className: "inline-flex h-7 w-7 items-center justify-center rounded-md border border-border bg-background text-foreground hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50",
-          "aria-label": "Previous page",
-          title: "Previous page",
-          disabled: atFirst,
-          onClick: () => onPageChange(Math.max(0, safePage - 1)),
-          children: /* @__PURE__ */ jsx(Icon, { icon: UiArrowLeft })
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          className: "inline-flex h-7 w-7 items-center justify-center rounded-md border border-border bg-background text-foreground hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50",
-          "aria-label": "Next page",
-          title: "Next page",
-          disabled: atLast,
-          onClick: () => onPageChange(safePage + 1),
-          children: /* @__PURE__ */ jsx(Icon, { icon: UiArrowRight })
-        }
-      )
+      steppable ? /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsxs("span", { className: "min-w-20 text-center", children: [
+          "Page ",
+          safePage + 1,
+          totalPages != null ? ` of ${totalPages}` : ""
+        ] }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "inline-flex h-7 w-7 items-center justify-center rounded-md border border-border bg-background text-foreground hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50",
+            "aria-label": "Previous page",
+            title: "Previous page",
+            disabled: atFirst,
+            onClick: goPrevious,
+            children: /* @__PURE__ */ jsx(Icon, { icon: UiArrowLeft })
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "inline-flex h-7 w-7 items-center justify-center rounded-md border border-border bg-background text-foreground hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50",
+            "aria-label": "Next page",
+            title: "Next page",
+            disabled: atLast,
+            onClick: goNext,
+            children: /* @__PURE__ */ jsx(Icon, { icon: UiArrowRight })
+          }
+        )
+      ] }) : null
     ] })
   ] });
 }