@siyahi/ui 0.0.0-stage → 0.1.0-next.3

package/dist/components/registry/niko-table/lib/constants.js

@@ -0,0 +1,123 @@
+//#region src/components/registry/niko-table/lib/constants.ts
+const JOIN_OPERATORS = {
+	/** Logical AND (all filters must match) */
+	AND: "and",
+	/** Logical OR (any filter can match) */
+	OR: "or",
+	/** Mixed logic (combination of AND/OR) */
+	MIXED: "mixed"
+};
+/**
+* Filter operator constants defining the comparison logic.
+* Naming follows SQL/PostgREST standards (ilike, eq, ne, etc.).
+*/
+const FILTER_OPERATORS = {
+	/** SQL ILIKE (Case-insensitive search) */
+	ILIKE: "ilike",
+	/** SQL NOT ILIKE */
+	NOT_ILIKE: "not.ilike",
+	/** SQL EQUAL (=) */
+	EQ: "eq",
+	/** SQL NOT EQUAL (!=) */
+	NEQ: "neq",
+	/** SQL IN (one of) */
+	IN: "in",
+	/** SQL NOT IN (none of) */
+	NOT_IN: "not.in",
+	/** Value is null or empty string */
+	EMPTY: "empty",
+	/** Value is not null and not empty string */
+	NOT_EMPTY: "not.empty",
+	/** SQL LESS THAN (<) */
+	LT: "lt",
+	/** SQL LESS THAN OR EQUAL (<=) */
+	LTE: "lte",
+	/** SQL GREATER THAN (>) */
+	GT: "gt",
+	/** SQL GREATER THAN OR EQUAL (>=) */
+	GTE: "gte",
+	/** SQL BETWEEN (range) */
+	BETWEEN: "between",
+	/** Relative date calculation (e.g., "today", "last-7-days") */
+	RELATIVE: "relative"
+};
+/**
+* Filter variant constants defining the UI control type.
+*/
+const FILTER_VARIANTS = {
+	/** Standard text input */
+	TEXT: "text",
+	/** Numeric input */
+	NUMBER: "number",
+	/** Two-value range input */
+	RANGE: "range",
+	/** Single date picker */
+	DATE: "date",
+	/** Date range picker */
+	DATE_RANGE: "dateRange",
+	/** Single select dropdown */
+	SELECT: "select",
+	/** Multi-select dropdown */
+	MULTI_SELECT: "multiSelect",
+	/** Checkbox or toggle */
+	BOOLEAN: "boolean"
+};
+/** Global default values */
+const DEFAULT_VALUES = {
+	JOIN_OPERATOR: JOIN_OPERATORS.AND,
+	PAGE_SIZE: 10,
+	PAGE_INDEX: 0
+};
+/** System column IDs - used for smart pinning and feature detection */
+const SYSTEM_COLUMN_IDS = {
+	/** Row selection checkbox column */
+	SELECT: "select",
+	/** Row expand/collapse column */
+	EXPAND: "expand",
+	/** Row actions column (edit, delete, etc.) */
+	ACTIONS: "actions"
+};
+/** Array of all system column IDs for filtering */
+const SYSTEM_COLUMN_ID_LIST = [SYSTEM_COLUMN_IDS.SELECT, SYSTEM_COLUMN_IDS.EXPAND];
+/** UI-related constraints and settings */
+const UI_CONSTANTS = {
+	/** Max characters allowed for a filter ID */
+	FILTER_ID_MAX_LENGTH: 100,
+	/** Default max height for scrollable filter popovers */
+	MAX_FILTER_DISPLAY_HEIGHT: 300,
+	/** Default debounce delay in milliseconds for search inputs */
+	DEBOUNCE_DELAY: 300
+};
+/** Default keyboard shortcut key mappings */
+const KEYBOARD_SHORTCUTS = {
+	/** Open/Toggle filter menu */
+	FILTER_TOGGLE: "f",
+	/** Remove active filter (usually combined with Shift) */
+	FILTER_REMOVE: "f",
+	/** Close active UI elements */
+	ESCAPE: "escape",
+	/** Confirm or submit active action */
+	ENTER: "enter",
+	/** Remove character or navigate back */
+	BACKSPACE: "backspace",
+	/** Item deletion */
+	DELETE: "delete"
+};
+/**
+* Default column width bounds when a column omits `minSize` / `maxSize`.
+* Shared by `DataTableRoot` (defaultColumn) and the resize handle clamp —
+* keep these in constants so root does not import the resize-handle module.
+*/
+const DEFAULT_MIN_COLUMN_SIZE = 40;
+const DEFAULT_MAX_COLUMN_SIZE = 1e3;
+/** Standard internalized error messages */
+const ERROR_MESSAGES = {
+	/** Thrown when using the old global operator pattern */
+	DEPRECATED_GLOBAL_JOIN_OPERATOR: "Global join operator is deprecated. Use individual filter join operators.",
+	/** General configuration error */
+	INVALID_FILTER_CONFIGURATION: "Invalid filter configuration provided.",
+	/** Thrown when mandatory metadata is missing from columns */
+	MISSING_COLUMN_META: "Column metadata is required for filtering."
+};
+//#endregion
+export { DEFAULT_MAX_COLUMN_SIZE, DEFAULT_MIN_COLUMN_SIZE, DEFAULT_VALUES, ERROR_MESSAGES, FILTER_OPERATORS, FILTER_VARIANTS, JOIN_OPERATORS, KEYBOARD_SHORTCUTS, SYSTEM_COLUMN_IDS, SYSTEM_COLUMN_ID_LIST, UI_CONSTANTS };

package/dist/components/registry/niko-table/lib/create-scroll-handler.d.ts

@@ -0,0 +1,35 @@
+//#region src/components/registry/niko-table/lib/create-scroll-handler.d.ts
+export interface ScrollEvent {
+  scrollTop: number;
+  scrollHeight: number;
+  clientHeight: number;
+  isTop: boolean;
+  isBottom: boolean;
+  percentage: number;
+}
+/**
+ * Builds the body-scroll listener used by every data-table body
+ * (regular, virtualized, virtualized-DnD ×2). Reads the scroll
+ * container's metrics on each event and dispatches:
+ *
+ * - `onScroll` with a `ScrollEvent` snapshot
+ * - `onScrolledTop` when at the top
+ * - `onScrolledBottom` when within `scrollThreshold` of the bottom
+ *
+ * The body shipped four byte-for-byte copies of this — extracted so
+ * scroll-math changes propagate to all four bodies and so consumers
+ * get one canonical attach point. The returned listener is intended
+ * to be passed to `addEventListener("scroll", handler, { passive: true })`.
+ *
+ * Why a factory instead of `useCallback` per body: the closure deps
+ * are stable across renders (the consumer-supplied callbacks +
+ * threshold are passed as args once), and bodies that wrap this in
+ * a `useEffect` already key on those callbacks via their own deps.
+ */
+export declare function createScrollHandler({ onScroll, onScrolledTop, onScrolledBottom, scrollThreshold }: {
+  onScroll?: (event: ScrollEvent) => void;
+  onScrolledTop?: () => void;
+  onScrolledBottom?: () => void;
+  scrollThreshold?: number;
+}): (event: Event) => void;
+//#endregion

package/dist/components/registry/niko-table/lib/create-scroll-handler.js

@@ -0,0 +1,63 @@
+//#region src/components/registry/niko-table/lib/create-scroll-handler.ts
+/**
+* Builds the body-scroll listener used by every data-table body
+* (regular, virtualized, virtualized-DnD ×2). Reads the scroll
+* container's metrics on each event and dispatches:
+*
+* - `onScroll` with a `ScrollEvent` snapshot
+* - `onScrolledTop` when at the top
+* - `onScrolledBottom` when within `scrollThreshold` of the bottom
+*
+* The body shipped four byte-for-byte copies of this — extracted so
+* scroll-math changes propagate to all four bodies and so consumers
+* get one canonical attach point. The returned listener is intended
+* to be passed to `addEventListener("scroll", handler, { passive: true })`.
+*
+* Why a factory instead of `useCallback` per body: the closure deps
+* are stable across renders (the consumer-supplied callbacks +
+* threshold are passed as args once), and bodies that wrap this in
+* a `useEffect` already key on those callbacks via their own deps.
+*/
+function createScrollHandler({ onScroll, onScrolledTop, onScrolledBottom, scrollThreshold = 50 }) {
+	/**
+	* Edge-transition gating only — no rAF coalescing.
+	*
+	* Edge gating: `onScrolledTop` / `onScrolledBottom` previously fired on
+	* EVERY scroll event while sitting at the edge — pinning at the bottom
+	* while data streamed in re-fired `onScrolledBottom` dozens of times per
+	* second. Tracking previous edge state limits firing to the leading edge
+	* (false→true) and is the actual source of the perf win.
+	*
+	* No rAF: iOS Safari pauses `requestAnimationFrame` during momentum
+	* scroll, which delayed edge callbacks until the finger lifted and
+	* momentum settled — broke infinite-scroll triggering on touch.
+	* Dispatch synchronously instead; the scroll math is cheap and edge
+	* gating already prevents redundant consumer renders. rAF is better
+	* reserved for DOM writes (row virtualization translateY), not
+	* consumer callbacks.
+	*/
+	let prevAtTop = false;
+	let prevAtBottom = false;
+	return (event) => {
+		const element = event.currentTarget;
+		if (!element) return;
+		const { scrollHeight, scrollTop, clientHeight } = element;
+		const isTop = scrollTop === 0;
+		const isBottom = scrollHeight - scrollTop - clientHeight < scrollThreshold;
+		const percentage = scrollHeight - clientHeight > 0 ? scrollTop / (scrollHeight - clientHeight) * 100 : 0;
+		onScroll?.({
+			scrollTop,
+			scrollHeight,
+			clientHeight,
+			isTop,
+			isBottom,
+			percentage
+		});
+		if (isTop && !prevAtTop) onScrolledTop?.();
+		if (isBottom && !prevAtBottom) onScrolledBottom?.();
+		prevAtTop = isTop;
+		prevAtBottom = isBottom;
+	};
+}
+//#endregion
+export { createScrollHandler };

package/dist/components/registry/niko-table/lib/data-table-features.d.ts

@@ -0,0 +1,218 @@
+import { RowData } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/lib/data-table-features.d.ts
+/**
+ * Feature groups — the composable unit of the engine layer.
+ *
+ * Each group is a plain object holding the features, row models and named
+ * functions one capability needs. Spread the ones your tables use into
+ * `tableFeatures({ … })` and the rest never enters the bundle. That is the
+ * engine-side mirror of installing only the `DataTable*` pieces you need —
+ * you compose by listing what you want, not by toggling flags.
+ *
+ * @example
+ * // A read-only table: columns, sorting, nothing else.
+ * export const features = tableFeatures({
+ *   ...coreFeatures,
+ *   ...sortingFeatures,
+ * })
+ */
+/** Column visibility, ordering, pinning, sizing and resizing. Always useful. */
+export declare const coreFeatures: {
+  readonly columnOrderingFeature: import("@tanstack/react-table").TableFeature;
+  readonly columnPinningFeature: import("@tanstack/react-table").TableFeature;
+  readonly columnResizingFeature: import("@tanstack/react-table").TableFeature;
+  readonly columnSizingFeature: import("@tanstack/react-table").TableFeature;
+  readonly columnVisibilityFeature: import("@tanstack/react-table").TableFeature;
+};
+/** Column + global filtering, faceting, and the row models they need. */
+export declare const filteringFeatures: {
+  readonly columnFacetingFeature: import("@tanstack/react-table").TableFeature;
+  readonly columnFilteringFeature: import("@tanstack/react-table").TableFeature;
+  readonly globalFilteringFeature: import("@tanstack/react-table").TableFeature;
+  readonly facetedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  readonly facetedUniqueValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+  readonly facetedMinMaxValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => undefined | [number, number];
+  readonly filteredRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  readonly filterFns: {
+    readonly extended: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly numberRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly dateRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+  };
+};
+/**
+ * Sorting, plus the sort functions a column may name in `sortFn`.
+ *
+ * `'auto'` resolves only what is registered here, so drop any your tables
+ * never reference.
+ */
+export declare const sortingFeatures: {
+  readonly rowSortingFeature: import("@tanstack/react-table").TableFeature;
+  readonly sortedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, RowData>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, RowData>;
+  readonly sortFns: {
+    readonly alphanumeric: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly alphanumericCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly basic: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly datetime: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly text: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly textCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+  };
+};
+/** Row expansion — sub-rows and expanded content. Grouping requires it. */
+export declare const expandingFeatures: {
+  readonly rowExpandingFeature: import("@tanstack/react-table").TableFeature;
+  readonly expandedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+};
+/**
+ * Grouping and aggregation, plus the aggregation functions a column may name
+ * in `aggregationFn`. Includes `expandingFeatures`, because a group that
+ * cannot collapse is not a group.
+ *
+ * Pairs with `<DataTableGroupedRows>` on the UI side — compose both, or
+ * neither.
+ */
+export declare const groupingFeatures: {
+  readonly rowExpandingFeature: import("@tanstack/react-table").TableFeature;
+  readonly expandedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  readonly columnGroupingFeature: import("@tanstack/react-table").TableFeature;
+  readonly rowAggregationFeature: import("@tanstack/react-table").TableFeature;
+  readonly groupedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  readonly aggregationFns: {
+    readonly count: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly extent: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, [(number | Date) | undefined, (number | Date) | undefined]>;
+    readonly first: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly last: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly max: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly mean: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly median: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly min: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly sum: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly unique: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown[]>;
+    readonly uniqueCount: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+  };
+};
+/** Client-side pagination. Omit it for server-driven or infinite tables. */
+export declare const paginationFeatures: {
+  readonly rowPaginationFeature: import("@tanstack/react-table").TableFeature;
+  readonly paginatedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+};
+/** Row selection — checkboxes, the selection bar, bulk actions. */
+export declare const selectionFeatures: {
+  readonly rowSelectionFeature: import("@tanstack/react-table").TableFeature;
+};
+/**
+ * Batteries-included default: every group above.
+ *
+ * It exists so a fresh install and every copy-paste example work with no
+ * setup. It is a starting point, not a recommendation — replace it with the
+ * groups your tables actually use and the rest drops out of the bundle.
+ */
+export declare const features: {
+  columnOrderingFeature: import("@tanstack/react-table").TableFeature;
+  columnPinningFeature: import("@tanstack/react-table").TableFeature;
+  columnResizingFeature: import("@tanstack/react-table").TableFeature;
+  columnSizingFeature: import("@tanstack/react-table").TableFeature;
+  columnVisibilityFeature: import("@tanstack/react-table").TableFeature;
+  columnFacetingFeature: import("@tanstack/react-table").TableFeature;
+  columnFilteringFeature: import("@tanstack/react-table").TableFeature;
+  globalFilteringFeature: import("@tanstack/react-table").TableFeature;
+  facetedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  facetedUniqueValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+  facetedMinMaxValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => undefined | [number, number];
+  filteredRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  filterFns: {
+    readonly extended: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly numberRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly dateRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+  };
+  rowSortingFeature: import("@tanstack/react-table").TableFeature;
+  sortedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, RowData>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, RowData>;
+  sortFns: {
+    readonly alphanumeric: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly alphanumericCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly basic: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly datetime: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly text: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly textCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+  };
+  rowExpandingFeature: import("@tanstack/react-table").TableFeature;
+  expandedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  columnGroupingFeature: import("@tanstack/react-table").TableFeature;
+  rowAggregationFeature: import("@tanstack/react-table").TableFeature;
+  groupedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  aggregationFns: {
+    readonly count: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly extent: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, [(number | Date) | undefined, (number | Date) | undefined]>;
+    readonly first: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly last: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly max: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly mean: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly median: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly min: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly sum: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly unique: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown[]>;
+    readonly uniqueCount: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+  };
+  rowPaginationFeature: import("@tanstack/react-table").TableFeature;
+  paginatedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  rowSelectionFeature: import("@tanstack/react-table").TableFeature;
+};
+export type DataTableFeatures = typeof features;
+/**
+ * Pre-bound column helper for DataTable. TanStack v9's `createColumnHelper`
+ * needs the features generic first (`createColumnHelper<DataTableFeatures, TData>()`);
+ * this wraps that the same way `DataTableColumnDef<TData>` pre-binds features.
+ *
+ * Prefer the helper when you want typed `getValue()` in cells. Prefer a plain
+ * `DataTableColumnDef<TData>[]` array for dynamic columns and copy-paste examples.
+ */
+export declare function createDataTableColumnHelper<TData extends RowData>(): import("@tanstack/react-table").ColumnHelper<{
+  columnOrderingFeature: import("@tanstack/react-table").TableFeature;
+  columnPinningFeature: import("@tanstack/react-table").TableFeature;
+  columnResizingFeature: import("@tanstack/react-table").TableFeature;
+  columnSizingFeature: import("@tanstack/react-table").TableFeature;
+  columnVisibilityFeature: import("@tanstack/react-table").TableFeature;
+  columnFacetingFeature: import("@tanstack/react-table").TableFeature;
+  columnFilteringFeature: import("@tanstack/react-table").TableFeature;
+  globalFilteringFeature: import("@tanstack/react-table").TableFeature;
+  facetedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  facetedUniqueValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+  facetedMinMaxValues: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>, columnId: string) => () => undefined | [number, number];
+  filteredRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  filterFns: {
+    readonly extended: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly numberRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+    readonly dateRange: import("@tanstack/react-table").FilterFn<import("@tanstack/react-table").TableFeatures, RowData>;
+  };
+  rowSortingFeature: import("@tanstack/react-table").TableFeature;
+  sortedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, RowData>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, RowData>;
+  sortFns: {
+    readonly alphanumeric: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly alphanumericCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly basic: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly datetime: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly text: import("@tanstack/react-table").CreatedSortFn<any, any>;
+    readonly textCaseSensitive: import("@tanstack/react-table").CreatedSortFn<any, any>;
+  };
+  rowExpandingFeature: import("@tanstack/react-table").TableFeature;
+  expandedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  columnGroupingFeature: import("@tanstack/react-table").TableFeature;
+  rowAggregationFeature: import("@tanstack/react-table").TableFeature;
+  groupedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  aggregationFns: {
+    readonly count: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly extent: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, [(number | Date) | undefined, (number | Date) | undefined]>;
+    readonly first: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly last: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown>;
+    readonly max: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly mean: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly median: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number | undefined>;
+    readonly min: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, (number | Date) | undefined>;
+    readonly sum: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+    readonly unique: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, unknown[]>;
+    readonly uniqueCount: import("@tanstack/react-table").AggregationFnDef<any, any, unknown, number>;
+  };
+  rowPaginationFeature: import("@tanstack/react-table").TableFeature;
+  paginatedRowModel: (table: import("@tanstack/react-table").Table<import("@tanstack/react-table").TableFeatures, any>) => () => import("@tanstack/react-table").RowModel<import("@tanstack/react-table").TableFeatures, any>;
+  rowSelectionFeature: import("@tanstack/react-table").TableFeature;
+}, TData>;
+//#endregion

package/dist/components/registry/niko-table/lib/data-table-features.js

@@ -0,0 +1,127 @@
+import { dateRangeFilter, extendedFilter, numberRangeFilter } from "./filter-functions.js";
+import { aggregationFn_count, aggregationFn_extent, aggregationFn_first, aggregationFn_last, aggregationFn_max, aggregationFn_mean, aggregationFn_median, aggregationFn_min, aggregationFn_sum, aggregationFn_unique, aggregationFn_uniqueCount, columnFacetingFeature, columnFilteringFeature, columnGroupingFeature, columnOrderingFeature, columnPinningFeature, columnResizingFeature, columnSizingFeature, columnVisibilityFeature, createColumnHelper, createExpandedRowModel, createFacetedMinMaxValues, createFacetedRowModel, createFacetedUniqueValues, createFilteredRowModel, createGroupedRowModel, createPaginatedRowModel, createSortedRowModel, globalFilteringFeature, rowAggregationFeature, rowExpandingFeature, rowPaginationFeature, rowSelectionFeature, rowSortingFeature, sortFn_alphanumeric, sortFn_alphanumericCaseSensitive, sortFn_basic, sortFn_datetime, sortFn_text, sortFn_textCaseSensitive, tableFeatures } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/lib/data-table-features.ts
+/**
+* Feature groups — the composable unit of the engine layer.
+*
+* Each group is a plain object holding the features, row models and named
+* functions one capability needs. Spread the ones your tables use into
+* `tableFeatures({ … })` and the rest never enters the bundle. That is the
+* engine-side mirror of installing only the `DataTable*` pieces you need —
+* you compose by listing what you want, not by toggling flags.
+*
+* @example
+* // A read-only table: columns, sorting, nothing else.
+* export const features = tableFeatures({
+*   ...coreFeatures,
+*   ...sortingFeatures,
+* })
+*/
+/** Column visibility, ordering, pinning, sizing and resizing. Always useful. */
+const coreFeatures = {
+	columnOrderingFeature,
+	columnPinningFeature,
+	columnResizingFeature,
+	columnSizingFeature,
+	columnVisibilityFeature
+};
+/** Column + global filtering, faceting, and the row models they need. */
+const filteringFeatures = {
+	columnFacetingFeature,
+	columnFilteringFeature,
+	globalFilteringFeature,
+	facetedRowModel: createFacetedRowModel(),
+	facetedUniqueValues: createFacetedUniqueValues(),
+	facetedMinMaxValues: createFacetedMinMaxValues(),
+	filteredRowModel: createFilteredRowModel(),
+	filterFns: {
+		extended: extendedFilter,
+		numberRange: numberRangeFilter,
+		dateRange: dateRangeFilter
+	}
+};
+/**
+* Sorting, plus the sort functions a column may name in `sortFn`.
+*
+* `'auto'` resolves only what is registered here, so drop any your tables
+* never reference.
+*/
+const sortingFeatures = {
+	rowSortingFeature,
+	sortedRowModel: createSortedRowModel(),
+	sortFns: {
+		alphanumeric: sortFn_alphanumeric,
+		alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,
+		basic: sortFn_basic,
+		datetime: sortFn_datetime,
+		text: sortFn_text,
+		textCaseSensitive: sortFn_textCaseSensitive
+	}
+};
+/** Row expansion — sub-rows and expanded content. Grouping requires it. */
+const expandingFeatures = {
+	rowExpandingFeature,
+	expandedRowModel: createExpandedRowModel()
+};
+/**
+* Grouping and aggregation, plus the aggregation functions a column may name
+* in `aggregationFn`. Includes `expandingFeatures`, because a group that
+* cannot collapse is not a group.
+*
+* Pairs with `<DataTableGroupedRows>` on the UI side — compose both, or
+* neither.
+*/
+const groupingFeatures = {
+	...expandingFeatures,
+	columnGroupingFeature,
+	rowAggregationFeature,
+	groupedRowModel: createGroupedRowModel(),
+	aggregationFns: {
+		count: aggregationFn_count,
+		extent: aggregationFn_extent,
+		first: aggregationFn_first,
+		last: aggregationFn_last,
+		max: aggregationFn_max,
+		mean: aggregationFn_mean,
+		median: aggregationFn_median,
+		min: aggregationFn_min,
+		sum: aggregationFn_sum,
+		unique: aggregationFn_unique,
+		uniqueCount: aggregationFn_uniqueCount
+	}
+};
+/** Client-side pagination. Omit it for server-driven or infinite tables. */
+const paginationFeatures = {
+	rowPaginationFeature,
+	paginatedRowModel: createPaginatedRowModel()
+};
+/** Row selection — checkboxes, the selection bar, bulk actions. */
+const selectionFeatures = { rowSelectionFeature };
+/**
+* Batteries-included default: every group above.
+*
+* It exists so a fresh install and every copy-paste example work with no
+* setup. It is a starting point, not a recommendation — replace it with the
+* groups your tables actually use and the rest drops out of the bundle.
+*/
+const features = tableFeatures({
+	...coreFeatures,
+	...filteringFeatures,
+	...sortingFeatures,
+	...groupingFeatures,
+	...paginationFeatures,
+	...selectionFeatures
+});
+/**
+* Pre-bound column helper for DataTable. TanStack v9's `createColumnHelper`
+* needs the features generic first (`createColumnHelper<DataTableFeatures, TData>()`);
+* this wraps that the same way `DataTableColumnDef<TData>` pre-binds features.
+*
+* Prefer the helper when you want typed `getValue()` in cells. Prefer a plain
+* `DataTableColumnDef<TData>[]` array for dynamic columns and copy-paste examples.
+*/
+function createDataTableColumnHelper() {
+	return createColumnHelper();
+}
+//#endregion
+export { coreFeatures, createDataTableColumnHelper, expandingFeatures, features, filteringFeatures, groupingFeatures, paginationFeatures, selectionFeatures, sortingFeatures };

package/dist/components/registry/niko-table/lib/filter-functions.d.ts

@@ -0,0 +1,47 @@
+import { ExtendedColumnFilter, FilterOperator } from "../types/index.js";
+import { FilterFn, RowData, TableFeatures } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/lib/filter-functions.d.ts
+/**
+ * Feature-agnostic filter fn typing for shared Niko filter helpers: these only
+ * read the row, so they stay assignable whatever feature set a table registers.
+ */
+type AnyFilterFn<TData extends RowData = RowData> = FilterFn<TableFeatures, TData>;
+/**
+ * Custom filter function that handles our extended filter operators
+ */
+export declare const extendedFilter: AnyFilterFn;
+/**
+ * Global filter with operator precedence. Supports plain string search,
+ * pure OR, and mixed AND/OR (AND has higher precedence than OR — splits
+ * filters into OR-separated AND-groups).
+ */
+/**
+ * Whether a `globalFilter` value represents a search the reader actually made.
+ *
+ * A whitespace-only string does not: it is invisible in the search input, so
+ * treating it as active makes the UI insist something is filtered while showing
+ * nothing that could be. The advanced filter payload is an object and always
+ * counts.
+ */
+export declare function isGlobalFilterActive(value: unknown): boolean;
+export declare const globalFilter: AnyFilterFn;
+/**
+ * Filter function for number range (slider) filters
+ * Handles array values [min, max] for range filtering
+ */
+export declare const numberRangeFilter: AnyFilterFn;
+/**
+ * Filter function for date range filters
+ * Handles both single date (timestamp) and date range [from, to] (timestamps)
+ */
+export declare const dateRangeFilter: AnyFilterFn;
+/**
+ * Helper function to create filter value with operator
+ *
+ * @param operator - The filter operator to apply
+ * @param value - The value to filter by
+ * @returns ExtendedColumnFilter object with default properties
+ */
+export declare const createFilterValue: <TData = RowData>(operator: FilterOperator, value: string | number | boolean | null | undefined | string[]) => ExtendedColumnFilter<TData>;
+//#endregion
+export {};