@mk-kit/ui 0.43.0 → 0.45.0

package/types/mk-kit-ui-locales-pl.d.ts

@@ -0,0 +1,42 @@
+import { Provider } from '@angular/core';
+import { MkBlockEditorStrings, MkDateNames, MkI18nStrings, MkValidationStrings, MkI18nOverrides } from '@mk-kit/ui/core';
+
+/**
+ * Picks the Polish plural form for a count: `one` for 1, `few` for 2–4
+ * (except 12–14), `many` otherwise — CLDR's `pl` rules for integers, which is
+ * all the library's counts ever are.
+ *
+ * ```ts
+ * mkPluralPl(1, 'wynik', 'wyniki', 'wyników');  // 'wynik'
+ * mkPluralPl(3, 'wynik', 'wyniki', 'wyników');  // 'wyniki'
+ * mkPluralPl(12, 'wynik', 'wyniki', 'wyników'); // 'wyników'
+ * ```
+ */
+declare function mkPluralPl(count: number, one: string, few: string, many: string): string;
+/** Polish month and weekday names (Sunday-first, lowercase as in `Intl`). */
+declare const MK_PL_DATE_NAMES: MkDateNames;
+/** Polish validation messages rendered by `mk-form-field`. */
+declare const MK_PL_VALIDATION: MkValidationStrings;
+/** Polish strings of the block editor's chrome. */
+declare const MK_PL_BLOCK_EDITOR: MkBlockEditorStrings;
+/**
+ * The complete Polish string map — every key of {@link MkI18nStrings},
+ * `locale: 'pl-PL'` and `currency: 'PLN'` for the formatting pipes.
+ * Provide it whole with {@link provideMkI18nPl}, or pass it as the base of
+ * `provideMkI18n(overrides, MK_PL_I18N)`.
+ */
+declare const MK_PL_I18N: MkI18nStrings;
+/**
+ * Provides the Polish strings — {@link MK_PL_I18N} with any `overrides`
+ * merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+ * `provideMkI18n`).
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideMkI18nPl({ noData: 'Nic tu nie ma' })],
+ * });
+ * ```
+ */
+declare function provideMkI18nPl(overrides?: MkI18nOverrides): Provider;
+
+export { MK_PL_BLOCK_EDITOR, MK_PL_DATE_NAMES, MK_PL_I18N, MK_PL_VALIDATION, mkPluralPl, provideMkI18nPl };

package/types/mk-kit-ui-table.d.ts

@@ -92,6 +92,29 @@ type MkTableAlign = 'start' | 'center' | 'end';
 type MkSortDirection = 'asc' | 'desc' | 'none';
 /** Row vertical density. */
 type MkTableDensity = 'comfortable' | 'compact';
+/** Which control a column's header filter renders (see {@link MkTableColumn.filter}). */
+type MkTableFilterKind = 'text' | 'select' | 'number' | 'date';
+/** One option of a `select` header filter. */
+interface MkTableFilterOption {
+    /** The value compared against the cell (by `String()` equality). */
+    value: unknown;
+    /** Visible option text. */
+    label: string;
+}
+/**
+ * An inclusive range accepted as the value of a `number` or `date` filter
+ * (dates as `YYYY-MM-DD`, `Date` or a timestamp). Either bound may be omitted.
+ */
+interface MkTableFilterRange<V = number | string | Date> {
+    min?: V | null;
+    max?: V | null;
+}
+/**
+ * Active header filters keyed by column key: a string for `text`, an option
+ * value for `select`, a number / date (`>=`) or a {@link MkTableFilterRange}
+ * for `number` and `date`. Empty strings and `null` mean "no filter".
+ */
+type MkTableFilters = Record<string, unknown>;
 /** Column definition for {@link MkTable}. */
 interface MkTableColumn<T = Record<string, unknown>> {
     /** Property key on each row object supplying the cell value. */
@@ -131,6 +154,26 @@ interface MkTableColumn<T = Record<string, unknown>> {
      *   an expandable row detail already repeats.
      */
     stack?: 'title' | 'footer' | 'hide';
+    /**
+     * The header-row filter control for this column (rendered when the table is
+     * {@link MkTable.filterable}). Omitted, a filterable table gives the column a
+     * text filter; `false` leaves its filter cell empty.
+     *
+     * - `'text'` — case-insensitive *contains* on the displayed (formatted) text.
+     * - `'select'` — equality against one of {@link filterOptions}; without
+     *   options, the distinct values found in `data`.
+     * - `'number'` / `'date'` — the control keeps rows whose value is **≥** the
+     *   entry. Set `{ min, max }` through {@link MkTable.filters} for an
+     *   inclusive range. Dates compare by local calendar day.
+     */
+    filter?: MkTableFilterKind | false;
+    /**
+     * Options of a `select` filter — strings / numbers, or `{ value, label }`.
+     * Omitted: every distinct value of the column in `data`, sorted.
+     */
+    filterOptions?: readonly (string | number | MkTableFilterOption)[];
+    /** Placeholder of the filter control (text: `i18n.filter`; number / date: `i18n.filterMin`). */
+    filterPlaceholder?: string;
 }
 /** Payload emitted by {@link MkTable.sortChange}. */
 interface MkSortChange {
@@ -204,6 +247,8 @@ interface MkTableExportOptions extends MkCsvExportOptions, MkTableExportRowsOpti
     /** Start the browser download (default `true`); `false` just returns the text. */
     download?: boolean;
 }
+/** Drop the empty entries of a filter map (`null` when nothing is left). */
+declare function mkCompactFilters(filters: MkTableFilters | null | undefined): MkTableFilters | null;
 /** One rendered tbody entry: either a group header or a data row. */
 type MkTableItem<T> = {
     kind: 'group';
@@ -236,8 +281,11 @@ declare class MkTable<T = Record<string, unknown>> {
      */
     protected readonly stacked: _angular_core.WritableSignal<boolean>;
     constructor();
-    /** Measures the thead and exposes it as the group rows' sticky offset. */
-    private applyGroupTop;
+    /**
+     * Measures the header row and the thead and exposes them as the sticky
+     * offsets of the filter row and of the group rows.
+     */
+    private applyStickyOffsets;
     /** Column definitions (order = display order). */
     readonly columns: _angular_core.InputSignal<MkTableColumn<T>[]>;
     /** Row objects to render. */
@@ -309,6 +357,50 @@ declare class MkTable<T = Record<string, unknown>> {
     readonly groupBy: _angular_core.InputSignal<string | ((row: T) => unknown) | null>;
     /** Formats a group header label; defaults to `String(value)`. */
     readonly groupLabel: _angular_core.InputSignal<((value: unknown, rows: T[]) => string) | null>;
+    /**
+     * Render only the rows in view (plus {@link overscan}) — for tables of
+     * thousands of rows. The `<table>` scrolls inside its own box sized by
+     * {@link height} / {@link maxHeight} (`max-height: 60vh` when neither is
+     * set) with the header pinned; spacer rows keep the scrollbar honest.
+     *
+     * Works with sorting, selection (select-all still covers every row), tree
+     * rows, grouping (group headers are rows too), expandable detail rows (their
+     * height is measured once rendered; an unmeasured detail counts as one row)
+     * and the header filter row. Falls back to the full render while stacked
+     * into cards. Export and select-all always see every row, not the window.
+     */
+    readonly virtual: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Height (px) of one row in virtual mode. Leave unset to have it measured
+     * from the first rendered row — which follows `density` and
+     * `data-mk-density` automatically — starting from 44 (comfortable).
+     */
+    readonly rowHeight: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    /** Rows rendered beyond each edge of the viewport in virtual mode. */
+    readonly overscan: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Fixed height of the scroll box (CSS length, or px as a number). */
+    readonly height: _angular_core.InputSignal<string | number | null>;
+    /** Maximum height of the scroll box (CSS length, or px as a number). */
+    readonly maxHeight: _angular_core.InputSignal<string | number | null>;
+    /**
+     * Render a second header row with a filter control per column — a text
+     * box, a select, a number or a date field as the column's
+     * {@link MkTableColumn.filter} says. Values live in {@link filters}.
+     */
+    readonly filterable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * The active filters, keyed by column key (`[(filters)]`; `filtersChange`
+     * emits the whole map on every edit). Text filters hold the typed string,
+     * select filters the chosen option value, number / date filters the lower
+     * bound or a `{ min, max }` range. Set programmatically to pre-filter.
+     */
+    readonly filters: _angular_core.ModelSignal<MkTableFilters>;
+    /**
+     * Filter rows in the browser (default). Turn off when the server applies
+     * the filters — `MkTableDataSource.setFilters($event)` on `filtersChange` —
+     * so the page it returns is shown as-is.
+     */
+    readonly clientFilter: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Emitted when the sort column/direction changes. */
     readonly sortChange: _angular_core.OutputEmitterRef<MkSortChange>;
     /** Emitted when a row is clicked (enable via `clickableRows`). */
@@ -434,6 +526,52 @@ declare class MkTable<T = Record<string, unknown>> {
      */
     /** Data sorted by the active column, or the input order when unsorted. */
     protected readonly sortedData: _angular_core.Signal<T[]>;
+    /** The filter control a column renders, or `null` for none. */
+    protected filterKind(col: MkTableColumn<T>): MkTableFilterKind | null;
+    /** One predicate per active filter, or `null` when nothing is filtered. */
+    private readonly rowPredicate;
+    /** Build the predicate for one column's filter value. */
+    private columnTest;
+    /**
+     * Tree mode: which rows survive the filters — a row is kept when it matches
+     * or any descendant does, so a matching child keeps its parents.
+     */
+    private readonly treeKeep;
+    /** The input rows with the active filters applied (input order). */
+    private readonly filteredData;
+    /** The child rows of `row` that survive the filters (tree mode). */
+    private visibleChildrenOf;
+    /** Options of every `select` filter, keyed by column (derived when unset). */
+    private readonly selectOptions;
+    /** The options a column's select filter offers. */
+    protected filterOptionsFor(col: MkTableColumn<T>): MkTableFilterOption[];
+    /** Whether `option` is the column's current select-filter value. */
+    protected isFilterOption(col: MkTableColumn<T>, option: MkTableFilterOption): boolean;
+    /** Whether a column has an active filter. */
+    protected hasFilter(key: string): boolean;
+    /** The text a column's filter box shows (a range shows its lower bound). */
+    protected filterText(key: string): string;
+    /** Accessible name of a column's filter control. */
+    protected filterLabel(col: MkTableColumn<T>): string;
+    /** Placeholder of a column's filter control. */
+    protected filterPlaceholder(col: MkTableColumn<T>): string;
+    /**
+     * Set one column's filter (`null` / `''` clears it). Updates
+     * {@link filters} and emits `filtersChange`; a no-op when unchanged.
+     */
+    setFilter(key: string, value: unknown): void;
+    /** Clear one column's filter. */
+    clearFilter(key: string): void;
+    /** Clear every filter. */
+    clearFilters(): void;
+    /** Text / number / date filter box input. */
+    protected onFilterInput(col: MkTableColumn<T>, event: Event): void;
+    /** Select filter change: map the option string back to its original value. */
+    protected onFilterSelect(col: MkTableColumn<T>, event: Event): void;
+    /** Escape in a filter box clears that filter (and stays in the box). */
+    protected onFilterKeydown(col: MkTableColumn<T>, event: KeyboardEvent): void;
+    /** Header rows above the body (for `aria-rowindex`). */
+    protected readonly headerRows: _angular_core.Signal<number>;
     /** Sort one sibling group by the active column (input order when unsorted). */
     private sortRows;
     /** `aria-sort` value for a header cell. */
@@ -488,6 +626,75 @@ declare class MkTable<T = Record<string, unknown>> {
     private pushRows;
     /** The child rows of `row` (tree mode), or an empty list. */
     private childrenOf;
+    /** The scroll box around the table. */
+    private readonly scroller;
+    /** Virtual mode in force (cards always render in full). */
+    protected readonly isVirtual: _angular_core.Signal<boolean>;
+    /** Current scroll offset of the scroll box (virtual mode). */
+    private readonly scrollTop;
+    /** Measured height of the scroll box (0 until measured / on the server). */
+    private readonly viewportHeight;
+    /** Measured height of the thead — the sticky header hides that much of the top. */
+    private readonly headHeight;
+    /** Row height read back from the first rendered row. */
+    private readonly measuredRowHeight;
+    /** Measured heights of expanded detail rows, by row key. */
+    private readonly detailHeights;
+    /** The row height virtual mode lays rows out with. */
+    protected readonly effectiveRowHeight: _angular_core.Signal<number>;
+    private cssLength;
+    /** `height` of the scroll box. */
+    protected readonly scrollHeight: _angular_core.Signal<string | null>;
+    /** `max-height` of the scroll box (60vh in virtual mode with no size given). */
+    protected readonly scrollMaxHeight: _angular_core.Signal<string | null>;
+    /**
+     * Top offset of every display item, or `null` while every item is exactly
+     * one row tall (the common case — then offsets are plain multiplication).
+     * Only expanded detail rows make heights vary.
+     */
+    private readonly itemOffsets;
+    /** Full height of the body, spacers included. */
+    private readonly totalHeight;
+    /** Top offset (px) of display item `index`. */
+    private offsetOf;
+    /** Index of the display item covering the body offset `y`. */
+    private indexAt;
+    /** The `[start, end)` slice of display items currently rendered. */
+    protected readonly windowRange: _angular_core.Signal<{
+        start: number;
+        end: number;
+    }>;
+    /** Display index of the first rendered item. */
+    protected readonly windowStart: _angular_core.Signal<number>;
+    /** The items the tbody renders: the window in virtual mode, else all. */
+    protected readonly renderedItems: _angular_core.Signal<MkTableItem<T>[]>;
+    /** Height (px) of the spacer above the window. */
+    protected readonly topSpace: _angular_core.Signal<number>;
+    /** Height (px) of the spacer below the window. */
+    protected readonly bottomSpace: _angular_core.Signal<number>;
+    /** Scroll box scrolled: move the window. */
+    protected onScroll(event: Event): void;
+    /**
+     * Read the viewport, thead, first-row and detail-row heights back from the
+     * DOM. Heights are accepted only when they move by more than a pixel:
+     * collapsed table borders make the same row measure 44 or 44.5 depending
+     * on where it sits, and letting that flip the row height would shift a
+     * 10,000-row body by thousands of pixels on every window change. A density
+     * change (44 → 36 or 52) still gets through.
+     */
+    private measureViewport;
+    /**
+     * Scroll a row into view. A number is the row's **display index** — its
+     * position among the rendered rows, group headers included, after sorting,
+     * filtering and tree expansion; anything else is a row key (the `trackKey`
+     * value, or the row object when there is none). Pass `'key'` to look a
+     * numeric key up. Returns `false` when the row is not currently displayed
+     * (filtered out, under a collapsed parent or group).
+     *
+     * In virtual mode the row lands at the top of the viewport, just under the
+     * header; otherwise it is scrolled to the nearest edge.
+     */
+    scrollToRow(target: unknown, by?: 'index' | 'key'): boolean;
     /** Keys of parent rows whose children are shown. */
     private readonly treeExpanded;
     /** Whether a parent row's children are currently shown (tree mode). */
@@ -501,7 +708,8 @@ declare class MkTable<T = Record<string, unknown>> {
     /**
      * The rows and columns an export writes — exactly what {@link exportCsv}
      * serialises, for other formats (XLSX, PDF, the clipboard, …): rows in
-     * display order with the current sort applied and tree children
+     * display order with the current sort and header {@link filters} applied
+     * (every matching row, never just the virtual window) and tree children
      * (`childrenKey`) flattened under their parent whether or not they are
      * expanded, optionally only the selected ones; columns in the table's
      * current order, restricted to `options.columns` when given, each carrying
@@ -517,8 +725,8 @@ declare class MkTable<T = Record<string, unknown>> {
     getExportRows(options?: MkTableExportRowsOptions): MkTableExportRows<T>;
     /**
      * The table's rows as CSV: current column order, column formatters applied,
-     * sorted the way they are shown, tree children flattened under their parent
-     * whether or not they are expanded. Downloads the file (default name
+     * sorted and filtered the way they are shown, tree children flattened under
+     * their parent whether or not they are expanded. Downloads the file (default name
      * `table.csv`) and returns the text. Built on {@link getExportRows}.
      */
     exportCsv(options?: MkTableExportOptions): string;
@@ -546,7 +754,7 @@ declare class MkTable<T = Record<string, unknown>> {
     /** Toggle a row's detail panel, honouring `singleExpand`. */
     protected toggleExpand(row: T, event?: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkTable<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTable<any>, "mk-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "hover": { "alias": "hover"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "stackAt": { "alias": "stackAt"; "required": false; "isSignal": true; }; "clickableRows": { "alias": "clickableRows"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "trackKey": { "alias": "trackKey"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "singleExpand": { "alias": "singleExpand"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "groupBy": { "alias": "groupBy"; "required": false; "isSignal": true; }; "groupLabel": { "alias": "groupLabel"; "required": false; "isSignal": true; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "sortChange": "sortChange"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "expandedChange": "expandedChange"; "columnResize": "columnResize"; "columnReorder": "columnReorder"; "cellEdit": "cellEdit"; "groupToggle": "groupToggle"; "treeToggle": "treeToggle"; }, ["rowDetail", "cellTemplates"], ["[mkTableEmpty]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTable<any>, "mk-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "hover": { "alias": "hover"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "stackAt": { "alias": "stackAt"; "required": false; "isSignal": true; }; "clickableRows": { "alias": "clickableRows"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "trackKey": { "alias": "trackKey"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "singleExpand": { "alias": "singleExpand"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "groupBy": { "alias": "groupBy"; "required": false; "isSignal": true; }; "groupLabel": { "alias": "groupLabel"; "required": false; "isSignal": true; }; "virtual": { "alias": "virtual"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "overscan": { "alias": "overscan"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "filterable": { "alias": "filterable"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "clientFilter": { "alias": "clientFilter"; "required": false; "isSignal": true; }; "childrenKey": { "alias": "childrenKey"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "filters": "filtersChange"; "sortChange": "sortChange"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "expandedChange": "expandedChange"; "columnResize": "columnResize"; "columnReorder": "columnReorder"; "cellEdit": "cellEdit"; "groupToggle": "groupToggle"; "treeToggle": "treeToggle"; }, ["rowDetail", "cellTemplates"], ["[mkTableEmpty]"], true, never>;
 }
 
 /** Context handed to an `[mkTableCell]` template. */
@@ -697,6 +905,12 @@ interface MkDataRequest {
     filter: string;
     /** Structured filter from `mk-query-builder` (`null` = none). Compacted: no empty groups or unfinished rules. */
     query: MkQueryGroup | null;
+    /**
+     * Per-column filters from `mk-table`'s header filter row (`null` = none),
+     * keyed by column key with empty entries dropped — see
+     * {@link MkTableDataSource.setFilters}.
+     */
+    filters: MkTableFilters | null;
 }
 /** One page of server data returned by a {@link MkDataFetcher}. */
 interface MkDataPage<T> {
@@ -810,6 +1024,7 @@ declare class MkTableDataSource<T> {
     private readonly _sort;
     private readonly _filter;
     private readonly _query;
+    private readonly _filters;
     /** Rows of the current page (`[]` until the first load lands). */
     readonly rows: Signal<T[]>;
     /** Total row count across all pages (feed to `mk-pagination`'s `total`). */
@@ -828,6 +1043,8 @@ declare class MkTableDataSource<T> {
     readonly filter: Signal<string>;
     /** Current structured query, or `null`. */
     readonly query: Signal<MkQueryGroup | null>;
+    /** Current per-column filters, or `null`. */
+    readonly filters: Signal<MkTableFilters | null>;
     /** True when a settled load reported no rows at all. */
     readonly empty: Signal<boolean>;
     /** Monotonic request id — settles from older epochs are discarded. */
@@ -863,6 +1080,15 @@ declare class MkTableDataSource<T> {
      * with nothing left is sent as `null`. Resets to page 1 and loads at once.
      */
     setQuery(query: MkQueryGroup | null): void;
+    /**
+     * Set (or clear with `null` / `{}`) the per-column filters from `mk-table`'s
+     * header filter row — bind `(filtersChange)="ds.setFilters($event)"` and
+     * turn the table's `clientFilter` off. Empty entries are dropped before the
+     * request; nothing left is sent as `null`. Resets to page 1 and loads at
+     * once (the table already debounces nothing, so debounce the fetcher if
+     * your API needs it). A no-op when unchanged.
+     */
+    setFilters(filters: MkTableFilters | null): void;
     /**
      * Re-run the current request immediately (e.g. after a mutation). Flushes a
      * pending debounced filter, since the request reads the live filter value.
@@ -892,5 +1118,5 @@ declare class MkTableDataSource<T> {
     private clearSub;
 }
 
-export { MkSort, MkSortHeader, MkTable, MkTableCell, MkTableDataSource, MkTableRowDetail, mkDownloadText, mkExportCsv, mkToCsv };
-export type { MkCellEdit, MkColumnResize, MkCsvColumn, MkCsvExportOptions, MkCsvOptions, MkDataFetcher, MkDataPage, MkDataRequest, MkGroupToggle, MkSortChange, MkSortDirection, MkSortState, MkSortable, MkTableAlign, MkTableCellContext, MkTableColumn, MkTableDataSourceOptions, MkTableDensity, MkTableExportOptions, MkTableExportRows, MkTableExportRowsOptions, MkTableGroup, MkTreeToggle };
+export { MkSort, MkSortHeader, MkTable, MkTableCell, MkTableDataSource, MkTableRowDetail, mkCompactFilters, mkDownloadText, mkExportCsv, mkToCsv };
+export type { MkCellEdit, MkColumnResize, MkCsvColumn, MkCsvExportOptions, MkCsvOptions, MkDataFetcher, MkDataPage, MkDataRequest, MkGroupToggle, MkSortChange, MkSortDirection, MkSortState, MkSortable, MkTableAlign, MkTableCellContext, MkTableColumn, MkTableDataSourceOptions, MkTableDensity, MkTableExportOptions, MkTableExportRows, MkTableExportRowsOptions, MkTableFilterKind, MkTableFilterOption, MkTableFilterRange, MkTableFilters, MkTableGroup, MkTreeToggle };

package/types/mk-kit-ui-testing.d.ts

@@ -306,6 +306,22 @@ declare class MkTableHarness extends MkHarness {
     /** Toggle the header "select all" checkbox. */
     toggleAll(): Promise<void>;
     isEmpty(): boolean;
+    /**
+     * Set a header-row filter (table is `filterable`). `value` is typed into
+     * a text / number / date box, or picked from a select by option label or
+     * value; `''` clears that filter.
+     */
+    setFilter(key: string, value: string): Promise<void>;
+    /** The current value of a header-row filter control (`''` when unset). */
+    filterValue(key: string): string;
+    /** Clear every header-row filter. */
+    clearFilters(): Promise<void>;
+    /**
+     * Scroll a `virtual` table so the row at display `index` is at the top of
+     * the viewport (drives the scroll box, so only the rows around it render).
+     */
+    scrollToRow(index: number): Promise<void>;
+    private filterControl;
     private headerCells;
 }