spiderly 19.11.8 → 19.12.0

package/lib/components/spiderly-data-table/spiderly-data-table.component.d.ts

@@ -1,15 +1,17 @@
-import { AfterViewInit, EventEmitter, OnChanges, OnDestroy, OnInit, QueryList, TemplateRef } from '@angular/core';
+import { AfterViewInit, ErrorHandler, EventEmitter, OnChanges, OnDestroy, OnInit, QueryList, TemplateRef } from '@angular/core';
 import { ActivatedRoute, Router } from '@angular/router';
 import { TranslocoService } from '@jsverse/transloco';
-import { SelectItem, SortMeta } from 'primeng/api';
+import { SortMeta } from 'primeng/api';
 import { DialogService, DynamicDialogRef } from 'primeng/dynamicdialog';
-import { Table, TableFilterEvent, TableLazyLoadEvent } from 'primeng/table';
+import { Table, TableLazyLoadEvent } from 'primeng/table';
 import { Observable } from 'rxjs';
 import { CellTemplateContext, SpiderlyCellTemplateDirective } from '../../directives/spiderly-cell-template.directive';
 import { Filter } from '../../entities/filter';
 import { LazyLoadSelectedIdsResult } from '../../entities/lazy-load-selected-ids-result';
 import { PaginatedResult } from '../../entities/paginated-result';
 import { PrimengOption } from '../../entities/primeng-option';
+import { FilterSource, SortKeyLabel } from '../../filters/filter-store';
+import { SpiderlyFilterTemplateDirective } from '../../directives/spiderly-filter-template.directive';
 import { ConfigServiceBase } from '../../services/config.service.base';
 import { SpiderlyMessageService } from '../../services/spiderly-message.service';
 import { SpiderlyFormControl } from '../spiderly-form-control/spiderly-form-control';
@@ -21,9 +23,56 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     private messageService;
     private translocoService;
     private configService;
+    private errorHandler;
     private locale;
     private readonly destroy$;
     table: Table;
+    private readonly injector;
+    private readonly zone;
+    /**
+     * The selection column's declared share. Under the fixed layout this is a RATIO, not a width.
+     *
+     * 4rem, down from 6: the original reserved room for a five-digit select-all counter sitting at
+     * body text size beside the box, which is the widest thing it can ever hold and not what it
+     * holds on any ordinary screen. The counter is a smaller step now (see the SCSS), so the same
+     * five digits fit in two thirds of the space.
+     */
+    protected readonly selectionColumnWidth = "4rem";
+    /**
+     * The selection column's MEASURED width, which is what the frozen identity column offsets
+     * itself by. Declaring `6rem` on both looked like the one-telling answer and is wrong: widths
+     * are shares, so that column renders at whatever proportion of the table it gets — 148px for a
+     * declared 6rem in one spec — and the identity column would sit 52px inside it, overlapping the
+     * checkboxes the moment anyone scrolled. The spec caught it; nothing about the page would have.
+     */
+    protected frozenOffsetPx: number;
+    private selectionWidthObserver?;
+    /** Aborts an in-flight column resize's document listeners, from `onUp` or from teardown. */
+    private resizeAbort;
+    /**
+     * Whether this column is pinned against the left edge. Only the FIRST column, and only when it
+     * is `lockVisible`: a sticky column in the middle of the grid pins the wrong thing and leaves a
+     * hole where it used to be. Once the grid scrolls sideways a row otherwise loses its identity
+     * — "Intesa, plaćeno, 12.400" with no idea whose order it is — and NN/g's Data Tables is
+     * explicit that the leftmost header column must lock in place. `lockVisible` already names
+     * exactly that column in every table, so this needs no new API (CLAUDE.md -> decision 8).
+     */
+    isColumnFrozen(col: Column): boolean;
+    /**
+     * The rightmost pinned cell, which carries the seam's shadow. It is the identity column when
+     * there is one and the checkbox column otherwise — a fact only this side knows, which is why
+     * the SCSS asking for it as `:last-of-type` drew nothing at all.
+     */
+    isLastFrozenColumn(col: Column): boolean;
+    get isSelectionColumnLastFrozen(): boolean;
+    /** A frozen column starts after the checkbox column, when there is one. */
+    frozenColumnOffset(): string;
+    /**
+     * Tracks the selection column's rendered width. A ResizeObserver rather than a one-off read:
+     * every column drag and every window resize re-splits the shares, so the offset moves without
+     * anything about the selection column itself changing.
+     */
+    private observeSelectionWidth;
     /**
      * Custom toolbar content projected via `<ng-template spiderlyDataTableActions>`.
      * Rendered in the caption action area ahead of the built-in buttons.
@@ -41,12 +90,47 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     /** Paginator page-size choices; merge rules and persistence: CLAUDE.md → "Rows-per-page". */
     rowsPerPageOptions: number[];
     cols: Column[];
+    /**
+     * The consumer's filter store — the table's WHOLE filter surface, rendered as the chip bar. A
+     * table given none has no filtering at all (`Column.filterType` is only the value's shape; the
+     * legacy header-filter fallback was deleted — CLAUDE.md -> "Operator-owned view").
+     *
+     * READ ONCE, in ngOnInit — a store assigned later is silently ignored: the requery effect
+     * stays subscribed to the first store's `applied()`, and `resolvedStateKey` (which
+     * `additionalFilterIdLong` feeds) is never re-derived either. A consumer that must swap
+     * stores at runtime destroys and recreates the table around the swap — PACMS
+     * `integration-matching-products` nulls its view model for exactly this. Teaching
+     * ngOnChanges to re-arm both is the open upstream fix.
+     */
+    filters?: FilterSource;
+    /** Saved questions for this table, rendered as tabs above the bar. */
+    views?: TableView[];
+    /**
+     * The view currently selected. Seeded from the first view in `ngOnInit`, never left null on a
+     * table that has views: `viewScope` keys the layout off it, so an unseeded table writes its
+     * width and order to the SAME key an unmigrated table uses — orphaned the moment the operator
+     * clicks the first tab — and no tab reads as selected until they do.
+     */
+    activeViewId: string | null;
     /** Whether the paginator is shown. Pass only when `hasLazyLoad === false`. Defaults to `true`. */
     showPaginator: boolean;
     /** Whether the table is wrapped in a card container. Defaults to `false`. */
     showCardWrapper: boolean;
     readonly: boolean;
     idField: string;
+    /**
+     * Sizes the columns from their declared widths instead of from the rendered rows.
+     *
+     * The browser default is `table-layout: auto`, which computes every column from the content
+     * of the rows currently on screen — so a column is one width on this page and another on the
+     * next, and a filter (which narrows the variety of values in the column it filters) moves the
+     * whole grid. PrimeNG sets no `table-layout` of its own, so without this the table inherits
+     * that default. Bound to a field, never an object literal in the template: a literal is a new
+     * reference on every change-detection pass.
+     */
+    protected readonly tableStyle: {
+        'table-layout': string;
+    };
     totalRecords: number;
     onTotalRecordsChange: EventEmitter<number>;
     getPaginatedListObservableMethod: (tableFilter: Filter) => Observable<PaginatedResult>;
@@ -54,7 +138,7 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     deleteItemFromTableObservableMethod: (rowId: number) => Observable<any>;
     deleteListFromTableObservableMethod: (ids: number[]) => Observable<any>;
     lastLazyLoadEvent: TableLazyLoadEvent;
-    loading: boolean;
+    private loading;
     newlySelectedItems: number[];
     fakeSelectedItems: number[];
     currentPageSelectedItemsFromDb: number[];
@@ -71,8 +155,6 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     onIsAllSelectedChange: EventEmitter<AllClickEvent>;
     selectedLazyLoadObservableMethod: (tableFilter: Filter) => Observable<LazyLoadSelectedIdsResult>;
     additionalFilterIdLong: number;
-    matchModeDateOptions: SelectItem[];
-    matchModeNumberOptions: SelectItem[];
     /** Whether the "Add" button is shown. Defaults to `true`. */
     showAddButton: boolean;
     /** Whether the "Export to Excel" button is shown. Defaults to `true`. */
@@ -126,7 +208,7 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      * Example: 'details' will navigate to '/details/{rowId}'.
      */
     rowNavigationPath: string;
-    constructor(router: Router, dialogService: DialogService, route: ActivatedRoute, messageService: SpiderlyMessageService, translocoService: TranslocoService, configService: ConfigServiceBase, locale: string);
+    constructor(router: Router, dialogService: DialogService, route: ActivatedRoute, messageService: SpiderlyMessageService, translocoService: TranslocoService, configService: ConfigServiceBase, errorHandler: ErrorHandler, locale: string);
     ngAfterViewInit(): void;
     /**
      * The template that renders this column's cells, or null to use the built-in rendering.
@@ -155,12 +237,6 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      * default later flows through to every user who never touched that column.
      */
     private columnVisibilityOverrides;
-    /**
-     * Columns revealed by the load-time reconciliation. Kept apart from
-     * `columnVisibilityOverrides` so persisting a later unrelated toggle can't promote a
-     * transient safety reveal into a durable choice.
-     */
-    private revealedByConstraint;
     /** A data column shows values for a `field`; anything else (the actions column) always renders. */
     private static isDataColumn;
     /**
@@ -169,8 +245,46 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      * are a transient working set — different natural lifetimes.
      */
     private get columnsStateKey();
-    /** Actions columns always render; data columns follow reveal/override, then declared default. */
+    /** Actions columns always render; data columns follow the override, then declared default. */
     isColumnVisible(col: Column): boolean;
+    /**
+     * `cols` in the operator's order. A field the stored order has never seen — a column added in a
+     * later release — sorts to the END rather than displacing a layout someone built by hand
+     * (CLAUDE.md -> "Operator-owned view", decision 7); the sort is stable, so those keep their
+     * declared order among themselves. Actions columns carry no field and are always last, which is
+     * where every consumer already declares them.
+     */
+    private orderedCols;
+    /**
+     * Whether this column can move one place in `direction` (-1 left, 1 right). A locked column is
+     * the row's anchor — and, once the left edge freezes, the thing a horizontal scroll keeps in
+     * view — so it does not move and nothing moves in front of it.
+     */
+    canMoveColumn(col: Column, direction: -1 | 1): boolean;
+    moveMenuColumn(direction: -1 | 1): void;
+    /** The move itself, shared by the menu and the drag — two entry points, one rule. */
+    private placeColumn;
+    private dataColumnsInOrder;
+    /**
+     * Header drag, ours rather than PrimeNG's `pReorderableColumn`, for two reasons: its
+     * `onMouseDown` arms the th for anything that is not an INPUT, a TEXTAREA or its OWN resizer —
+     * so our menu chevron and our resize grip would each start a column drag, and reaching for a
+     * width would silently reorder the grid — and its `onColumnDrop` reorders blind, with no notion
+     * of a locked column (CLAUDE.md -> decision 6).
+     *
+     * A shortcut for neighbours, never the mechanism: HTML5 dnd has no edge auto-scroll, so a column
+     * scrolled off the right is unreachable this way, and there is no keyboard path at all. The menu
+     * carries both.
+     *
+     * This half is the arming rule; the drop rule is `canDropOn` below.
+     */
+    onHeaderMouseDown(event: MouseEvent): void;
+    onHeaderDragStart(col: Column, event: DragEvent): void;
+    onHeaderDragOver(col: Column, event: DragEvent): void;
+    onHeaderDrop(col: Column, event: DragEvent): void;
+    /** Nothing lands on, or in front of, the locked column. Enforced here as well as in the menu:
+     * a drop is a separate entry point, and the rule is about the grid rather than about a button. */
+    private canDropOn;
     private refreshVisibleCols;
     /**
      * Locked columns can't be toggled; the last visible data column can't be hidden — the
@@ -178,16 +292,56 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      */
     canToggleColumn(col: Column): boolean;
     toggleColumn(col: Column, visible: boolean): void;
-    /** Restores every column to its declared default and forgets the stored override. */
-    resetColumnVisibility(): void;
     /**
-     * A hidden column contributes nothing to filtering or sorting: the header is the only
-     * filter surface, so a kept constraint would restrict the data invisibly. Reloads (once)
-     * only when a constraint was actually cleared — plain hides don't need a server round-trip.
+     * Restores every column to its declared default and forgets the stored overrides — visibility,
+     * wrap, order and width alike. It undid visibility only until the header menu shipped three
+     * more gestures beside it, and a layout with no way back is worse than one with no knobs.
+     *
+     * Hiding — here or from the menu — never touches filters or sort: the chip bar names every
+     * applied filter and the sort chip names the sort, hidden column or not (decision 2b). The
+     * legacy "hidden contributes nothing" apparatus died with the header-filter path.
+     */
+    resetColumnLayout(): void;
+    /**
+     * Per-column wrap, by `field`. A SEPARATE key from the visibility overrides on purpose: folding
+     * both into one object would invalidate every layout already in an operator's localStorage, and
+     * this is the key the width and order overrides will join (decision 5).
+     */
+    private columnWrap;
+    /** Data-column fields in the operator's order. Empty means "as declared". */
+    private columnOrder;
+    /**
+     * Per-column width overrides, as SHARES in the same unit `getColWidth` emits — never pixels.
+     * Under the fixed layout the browser splits surplus in proportion to these, so a pixel would
+     * pin the column and stop it answering the window: the operator on a 1280 laptop and the one
+     * on a 2560 monitor would get the same frozen column (decision 4).
      */
-    private clearHiddenColumnConstraints;
-    /** Whether filter metadata (single or array) carries a real constraint, not just an empty slot. */
-    private static isActiveFilterMeta;
+    private columnWidths;
+    /**
+     * Layout keys carry the ACTIVE VIEW, which is what makes a view more than a saved filter: a
+     * picking view and a payments view want different COLUMNS, not just different rows. Global
+     * layout would re-create the original complaint one level up — the operator still re-picking
+     * columns every time the job changes.
+     *
+     * A table with no views has no segment, so the twenty-six tables that have not migrated keep
+     * reading exactly the keys they already wrote.
+     */
+    private get viewScope();
+    /**
+     * Where the applied filters live. Follows `stateStorage` rather than the layout's always-local
+     * rule, because that is where they lived before the bar took them off the header: PrimeNG's
+     * stateful table persisted them for free, and nothing replaced it — a refresh dropped every
+     * filter (Filip, on /tags). A filter is a question you are in the middle of asking, not a
+     * durable preference like a column's width.
+     */
+    private get filtersStateKey();
+    private get filterStorage();
+    private persistAppliedFilters;
+    private restoreAppliedFilters;
+    private get layoutStateKey();
+    /** One key for the whole layout — wrap now, widths next (decision 5). */
+    private persistColumnLayout;
+    private restoreColumnLayout;
     private persistColumnVisibility;
     private restoreColumnVisibility;
     /**
@@ -196,16 +350,9 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      */
     private persistedTableState;
     /**
-     * Guards the "hidden contributes nothing" invariant against state this component didn't
-     * write (older blobs, hand-edited storage): a hidden column the persisted table state
-     * still filters or sorts by is revealed rather than constraining the data invisibly.
-     * In-memory only — once the constraint is gone, the user's stored choice reapplies.
-     */
-    private reconcileVisibilityWithPersistedConstraints;
-    /**
-     * The declared default as PrimeNG sort meta, or null when none is declared — or when its
-     * column is hidden ("hidden contributes nothing"): the table then falls back to the
-     * backend's implicit Id DESC, exactly as if no default were declared.
+     * The declared default as PrimeNG sort meta, or null when none is declared. Applies even
+     * while its column is hidden: the sort chip names the ordering whether or not the column
+     * is on screen (decision 2b).
      */
     private defaultMultiSortMeta;
     private persistedMultiSortMeta;
@@ -220,10 +367,26 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      */
     private keepSortableMeta;
     private applyDefaultSortIfUnsorted;
+    onPageChange(container: HTMLElement): void;
+    /**
+     * The one pending predicate: PrimeNG's overlay and the container's `aria-busy` must never
+     * disagree about whether a fetch is in flight.
+     *
+     * It used to also test `items === undefined`, for the first load. That clause is dead now
+     * that `loading` initialises true and every lazyLoad raises it — except in the one state
+     * where it was actively wrong: a FAILED first load lowers the flag with `items` still
+     * undefined, which pinned the overlay up forever. Same stranded overlay this component was
+     * fixed for once already, through the other door.
+     */
+    get isPending(): boolean;
     lazyLoad(event: TableLazyLoadEvent): void;
+    /**
+     * Repaints the checkbox column for the page that just landed. Split out of the subscriber so
+     * the try/finally that guarantees the pending flag wraps an await, not fifty lines of
+     * selection algebra.
+     */
+    private reconcileSelectionForLoadedPage;
     clientLoad(): void;
-    private clientFilterCount;
-    filter(event: TableFilterEvent): void;
     private loadFormArrayItems;
     /**
      * Single source for whether a column header offers click-to-sort (drives both
@@ -233,11 +396,157 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
      * sort fields are rejected with a 400, a clickable header here would be a guaranteed error toast.
      */
     isColumnSortable(col: Column): boolean;
-    /** The column's declared {@link Column.minWidth}, or the default for its filter type. */
-    getColHeaderWidth(col: Column): string;
-    getColMatchModeOptions(filterType: string): SelectItem<any>[];
-    getColMatchMode(filterType: string): any;
-    isDropOrMulti(filterType: string): boolean;
+    /** The column the header menu is currently open for, and its header cell. */
+    menuColumn: Column | null;
+    private menuHeaderCell;
+    private draggedColumn;
+    /** False while a gesture that began on the menu chevron or the resize grip is in flight. */
+    private headerDragArmed;
+    /**
+     * A ViewChild rather than a template reference passed in from the header. The popover lives in
+     * the CAPTION template and the button that opens it in the HEADER one, and a reference variable
+     * does not cross an ng-template boundary — it arrived as undefined, and the click did nothing
+     * at all.
+     */
+    private readonly columnMenu;
+    private readonly filterBar;
+    /**
+     * Consumer-projected filter controls, forwarded to the bar. Collected here rather than by the
+     * bar itself because the bar is OURS: a consumer's template is projected at the table, and
+     * content queries only see what was projected into the component that declares them.
+     */
+    filterTemplates: QueryList<SpiderlyFilterTemplateDirective>;
+    private readonly selectionHeader;
+    openColumnMenu(col: Column, event: Event): void;
+    /**
+     * Switches to a view. Clears first, always: a view is a STATE rather than an addition, and two
+     * of them composed produce a question nobody asked. The clear runs through the store directly
+     * rather than through `clear(table)`, which would also wipe the sort and the persisted state a
+     * view is entitled to keep.
+     */
+    selectView(view: TableView): void;
+    /**
+     * The filter this column stands for. Defaults to the column's own `field`, because a store id
+     * IS a backend property name — `toFilterPayload` emits it straight into `Filter.filters`. So
+     * `filterId` is an escape hatch for the rare mismatch, not something every column restates:
+     * all eight of the first migrated table's declarations were the field name written a second
+     * time.
+     */
+    private filterIdFor;
+    /**
+     * Asks the STORE, not the column. Checking only that an id was declared let a typo through to
+     * `store.get(id)`, which reads `definitions[id].label` — so a mistyped id threw on click rather
+     * than greying the item out. With 195 declarations to migrate, that is the failure mode worth
+     * closing here rather than in each consumer.
+     */
+    canFilterColumn(col: Column): boolean;
+    /**
+     * Opens the bar's editor for this column's filter. The bar took the filter off the header and
+     * the header is still where an operator reaches for it, which is twenty-seven tables' worth of
+     * habit; this is the shortcut back rather than a second filter surface — it drives the same
+     * editor, on the same bar, that `+ Filter` opens.
+     */
+    filterMenuColumn(): void;
+    /**
+     * Sorts by this column in the NAMED direction. Clicking a header cycles asc, desc and off,
+     * which is fine for one column and a guess for a direction someone wants now — you click, look,
+     * and click again if it went the other way. This is also the only sort path that works from a
+     * keyboard.
+     *
+     * A column the generated paginator has no sort case for answers every load with a 400, so the
+     * items are disabled by the same predicate that keeps its header from being clickable.
+     */
+    sortMenuColumn(order: 1 | -1): void;
+    /**
+     * Sizes the column to the widest thing in it. The cheaper escape from a cramped column: no
+     * drag, no aim. Unlike a drag it does NOT trade with the neighbour — a minimum that grew is
+     * exactly the case decision 4 lets push the table past its container and start scrolling.
+     *
+     * Measures the CELL CONTENT, not the cell: the clamp lives on the inner span, so a `td` reports
+     * a scrollWidth that fits while the text inside it does not.
+     */
+    fitMenuColumn(): void;
+    /**
+     * The share that actually yields `needed` pixels — not `needed` scaled by the column's current
+     * px-per-share, which is the obvious answer and the wrong one. Shares are a PROPORTION of
+     * whatever width the table has, so growing this column's share also shrinks the realized width
+     * of every other column, and the naive figure lands short. The spec caught it as a cell that
+     * was still clipped after being told to fit.
+     *
+     * While the columns fit, the table keeps the container's width and the proportion has to solve
+     *   needed / tableWidth = newShare / (otherShares + newShare)
+     * with `otherShares` recovered from what this column currently renders at. Once `needed` is the
+     * whole container the proportional regime has no answer: the table is about to overrun its
+     * container and scroll (decision 4), and there a share IS its own length, so the pixels convert
+     * straight through the root font size.
+     */
+    private shareThatFits;
+    hideMenuColumn(): void;
+    /**
+     * Whether this column's cells give up the one-line clamp. The DEFAULT stays clamped
+     * (CLAUDE.md -> "Operator-owned view", decision 9); what changes is that the operator picks
+     * which column pays the row height, not whoever wrote `cols`.
+     *
+     * Lands on the td as `.cell-wrap`, whose inherited `--spiderly-cell-*` properties are how the
+     * toggle crosses into a projected `spiderlyCellTemplate` too — the contract's one telling is
+     * on that SCSS rule; a consumer clamp that hard-codes its values opts out.
+     */
+    isColumnWrapped(col: Column): boolean;
+    get isMenuColumnWrapped(): boolean;
+    toggleWrapForMenuColumn(): void;
+    /** Exposed for the template: actions columns carry no field and get no menu. */
+    isDataColumn(col: Column): boolean;
+    /**
+     * What the grid is ordered by, resolved to COLUMN NAMES for the bar. Read off PrimeNG's live
+     * meta rather than mirrored into a field, so it cannot fall out of step with the sort the table
+     * is actually applying. A field with no column left (hidden, or removed in a later release)
+     * falls back to its own name rather than vanishing from the list.
+     */
+    /**
+     * What the grid is ordered by, resolved to COLUMN NAMES for the bar.
+     *
+     * A field refreshed per fetch, not a getter: it is bound to the bar's `sort`, which is a SIGNAL
+     * input, so a freshly mapped array failed `Object.is` on every change-detection pass and marked
+     * the bar's consumers dirty forever — for a value that changes once per request. Same reason
+     * `tableStyle` is a field.
+     */
+    sortKeys: SortKeyLabel[];
+    /**
+     * Read off the last REQUEST's sort, not `table._multiSortMeta`. On a first load with a declared
+     * default that field is still null: `applyDefaultSortIfUnsorted` writes the default onto the
+     * lazy-load event, and PrimeNG fills its own meta only once someone clicks a header. Reading the
+     * table there showed no sort on exactly the tables that always have one. A field with no column
+     * left falls back to its own name rather than vanishing.
+     */
+    private refreshSortKeys;
+    /** This column's share, override first, then its declared width, then the per-type default. */
+    columnShare(col: Column): number;
+    /**
+     * A declared width expressed in SHARE units. rem IS the share unit and px converts; any other
+     * unit falls back to the per-type default rather than being read as a bare number.
+     *
+     * `parseFloat` alone shipped here first, so `width: '150px'` resolved to share 150 against
+     * neighbours at 12 — one column eating the grid on the first drag or fit. Every declared width
+     * in the consumer happens to be rem today, which is exactly why nothing would have caught it.
+     */
+    private shareOfDeclaredWidth;
+    private defaultShare;
+    /**
+     * Trades share between the column being dragged and the one on its right, so the table keeps
+     * its total: widening a column never starts a horizontal scroll by itself, which only happens
+     * once the SUM of the minimums stops fitting. The px delta is converted through the column's
+     * own rendered width, which is the only place the share-to-pixel scale is actually known.
+     */
+    startColumnResize(col: Column, event: MouseEvent, th: HTMLElement): void;
+    /**
+     * The column's declared {@link Column.width}, or the default for its filter type.
+     *
+     * A width, not a minimum: under the fixed layout {@link tableStyle} establishes, this is what
+     * the column is sized from, and the table shares its surplus in PROPORTION to these numbers.
+     * Columns declaring none would otherwise take an equal share, which throws away what the
+     * per-type defaults say — a boolean holds "Da"/"Ne", a text column holds a name.
+     */
+    getColWidth(col: Column): string;
     navigateToDetails(rowId: number): void;
     /**
      * Handle row click event. Arbitration between "this click navigates the row" and "this click
@@ -257,6 +566,19 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     ngOnDestroy(): void;
     get showSelectAllCheckbox(): boolean;
     private resetSelection;
+    /**
+     * A COMMITTED filter re-queries; a draft does not. Re-fetching per keystroke would be the same
+     * lie the chip bar exists to prevent, only paid for in requests rather than in credibility.
+     *
+     * Back to page one first, and off FRESH metadata rather than `reload()`: that one replays the
+     * cached lazy-load event, whose `first` was copied when the event was built, so a filter applied
+     * from page 3 would keep asking the server to skip 50 rows a narrower result set does not have.
+     * The grid comes back empty for a value that is definitely in it.
+     *
+     * The first run is PrimeNG's: it fires the initial lazy load itself, and re-querying here would
+     * make every table load twice.
+     */
+    private requeryOnAppliedFilters;
     reload(): void;
     showActions(): boolean;
     getStyleForBodyColumn(col: Column<any>): string;
@@ -267,6 +589,11 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     colTrackByFn(index: any, item: any): any;
     actionTrackByFn(index: any, item: Action): string;
     exportListToExcel(): void;
+    /**
+     * Clears everything that narrows the grid. With a store supplied it has to reach BOTH — the
+     * store holds the constraints and PrimeNG holds the persisted state and sort — or the bar goes
+     * empty while a reload brings the old filters back.
+     */
     clear(table: Table): void;
     setFakeIsAllSelected(): void;
     selectAll(checked: boolean): void;
@@ -299,7 +626,7 @@ export declare class SpiderlyDataTableComponent implements OnInit, OnChanges, Af
     rowUnselect(id: number): void;
     getFormArrayControlByIndex(formControlName: string, index: number): SpiderlyFormControl;
     static ɵfac: i0.ɵɵFactoryDeclaration<SpiderlyDataTableComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SpiderlyDataTableComponent, "spiderly-data-table", never, { "tableTitle": { "alias": "tableTitle"; "required": false; }; "tableIcon": { "alias": "tableIcon"; "required": false; }; "items": { "alias": "items"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; }; "cols": { "alias": "cols"; "required": false; }; "showPaginator": { "alias": "showPaginator"; "required": false; }; "showCardWrapper": { "alias": "showCardWrapper"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "idField": { "alias": "idField"; "required": false; }; "getPaginatedListObservableMethod": { "alias": "getPaginatedListObservableMethod"; "required": false; }; "exportListToExcelObservableMethod": { "alias": "exportListToExcelObservableMethod"; "required": false; }; "deleteItemFromTableObservableMethod": { "alias": "deleteItemFromTableObservableMethod"; "required": false; }; "deleteListFromTableObservableMethod": { "alias": "deleteListFromTableObservableMethod"; "required": false; }; "newlySelectedItems": { "alias": "newlySelectedItems"; "required": false; }; "unselectedItems": { "alias": "unselectedItems"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "selectedLazyLoadObservableMethod": { "alias": "selectedLazyLoadObservableMethod"; "required": false; }; "additionalFilterIdLong": { "alias": "additionalFilterIdLong"; "required": false; }; "showAddButton": { "alias": "showAddButton"; "required": false; }; "showExportToExcelButton": { "alias": "showExportToExcelButton"; "required": false; }; "showReloadTableButton": { "alias": "showReloadTableButton"; "required": false; }; "getFormArrayItems": { "alias": "getFormArrayItems"; "required": false; }; "hasLazyLoad": { "alias": "hasLazyLoad"; "required": false; }; "stateKey": { "alias": "stateKey"; "required": false; }; "stateStorage": { "alias": "stateStorage"; "required": false; }; "defaultSortField": { "alias": "defaultSortField"; "required": false; }; "defaultSortOrder": { "alias": "defaultSortOrder"; "required": false; }; "getAlreadySelectedItemIds": { "alias": "getAlreadySelectedItemIds"; "required": false; }; "getAlreadySelectedItems": { "alias": "getAlreadySelectedItems"; "required": false; }; "getFormControl": { "alias": "getFormControl"; "required": false; }; "additionalIndexes": { "alias": "additionalIndexes"; "required": false; }; "navigateOnRowClick": { "alias": "navigateOnRowClick"; "required": false; }; "rowNavigationPath": { "alias": "rowNavigationPath"; "required": false; }; }, { "onTotalRecordsChange": "onTotalRecordsChange"; "onLazyLoad": "onLazyLoad"; "onIsAllSelectedChange": "onIsAllSelectedChange"; "onRowSelect": "onRowSelect"; "onRowUnselect": "onRowUnselect"; }, ["actionsTemplate", "cellTemplates"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SpiderlyDataTableComponent, "spiderly-data-table", never, { "tableTitle": { "alias": "tableTitle"; "required": false; }; "tableIcon": { "alias": "tableIcon"; "required": false; }; "items": { "alias": "items"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; }; "cols": { "alias": "cols"; "required": false; }; "filters": { "alias": "filters"; "required": false; }; "views": { "alias": "views"; "required": false; }; "showPaginator": { "alias": "showPaginator"; "required": false; }; "showCardWrapper": { "alias": "showCardWrapper"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "idField": { "alias": "idField"; "required": false; }; "getPaginatedListObservableMethod": { "alias": "getPaginatedListObservableMethod"; "required": false; }; "exportListToExcelObservableMethod": { "alias": "exportListToExcelObservableMethod"; "required": false; }; "deleteItemFromTableObservableMethod": { "alias": "deleteItemFromTableObservableMethod"; "required": false; }; "deleteListFromTableObservableMethod": { "alias": "deleteListFromTableObservableMethod"; "required": false; }; "newlySelectedItems": { "alias": "newlySelectedItems"; "required": false; }; "unselectedItems": { "alias": "unselectedItems"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "selectedLazyLoadObservableMethod": { "alias": "selectedLazyLoadObservableMethod"; "required": false; }; "additionalFilterIdLong": { "alias": "additionalFilterIdLong"; "required": false; }; "showAddButton": { "alias": "showAddButton"; "required": false; }; "showExportToExcelButton": { "alias": "showExportToExcelButton"; "required": false; }; "showReloadTableButton": { "alias": "showReloadTableButton"; "required": false; }; "getFormArrayItems": { "alias": "getFormArrayItems"; "required": false; }; "hasLazyLoad": { "alias": "hasLazyLoad"; "required": false; }; "stateKey": { "alias": "stateKey"; "required": false; }; "stateStorage": { "alias": "stateStorage"; "required": false; }; "defaultSortField": { "alias": "defaultSortField"; "required": false; }; "defaultSortOrder": { "alias": "defaultSortOrder"; "required": false; }; "getAlreadySelectedItemIds": { "alias": "getAlreadySelectedItemIds"; "required": false; }; "getAlreadySelectedItems": { "alias": "getAlreadySelectedItems"; "required": false; }; "getFormControl": { "alias": "getFormControl"; "required": false; }; "additionalIndexes": { "alias": "additionalIndexes"; "required": false; }; "navigateOnRowClick": { "alias": "navigateOnRowClick"; "required": false; }; "rowNavigationPath": { "alias": "rowNavigationPath"; "required": false; }; }, { "onTotalRecordsChange": "onTotalRecordsChange"; "onLazyLoad": "onLazyLoad"; "onIsAllSelectedChange": "onIsAllSelectedChange"; "onRowSelect": "onRowSelect"; "onRowUnselect": "onRowUnselect"; }, ["actionsTemplate", "cellTemplates", "filterTemplates"], never, true, never>;
 }
 export declare class Action {
     name?: string;
@@ -325,14 +652,60 @@ export declare class Action {
         onClick?: (event: ActionClickEvent) => void;
     });
 }
+/**
+ * A saved question. The bar lets an operator BUILD one; a view is the one they ask every morning,
+ * asked in a click — and without them the whole column-and-filter rework is a pile of knobs
+ * someone re-sets daily (CLAUDE.md -> "Operator-owned view", decision 10).
+ *
+ * Declared in consumer code, not stored per user: with a handful of operators and a handful of
+ * fixed daily jobs, shared built-in views cover the work, while personal saved views would drift
+ * into five variants of the same question. Personal LAYOUT choices still persist on top, per view.
+ */
+export interface TableView<TFilters = any> {
+    id: string;
+    label: string;
+    /**
+     * Sets the filters this view asks for. Receives the table's own store, so a consumer writes it
+     * with the store's typing. Called on a CLEARED store: a view is a state, not an addition.
+     */
+    apply?: (filters: TFilters) => void;
+    /**
+     * A view whose `apply` is a function of NOW — "Danas primljene", "this week". Selecting it
+     * always re-runs `apply` instead of restoring what an earlier visit stored: under the normal
+     * stored-wins rule a relative-date view clicked yesterday would restore yesterday's date under
+     * a tab claiming "today". Layout (columns, widths, wrap) still persists per view as usual —
+     * transience is about the QUESTION, not the furniture.
+     */
+    transient?: boolean;
+}
 export declare class Column<T = any> {
     name?: string;
     field?: string & keyof T;
-    filterField?: string & keyof T;
+    /**
+     * The column's VALUE SHAPE: it sizes the column (`getColWidth`), picks the cell rendering
+     * (`getRowData`, the blob branch) and the numeric right-align. The name is a fossil of the
+     * header-filter era — filtering lives in the store handed to `[filters]` — kept because
+     * renaming it would be a 195-declaration migration for zero behavior.
+     */
     filterType?: 'text' | 'date' | 'multiselect' | 'boolean' | 'numeric' | 'blob';
-    filterPlaceholder?: string;
+    /**
+     * The id of the filter in the table's store that this column stands for, which is what the
+     * header menu's `Filter…` opens. A LINK, not a declaration: the filter exists in the store
+     * whether or not any column names it, and a column needs this only to offer the shortcut.
+     *
+     * Untyped against the store on purpose — a `Column<T>` knows its row type and nothing about
+     * which store it will be rendered beside, so the compile-time key check lives where the store
+     * is declared (`createFilterStore`), not here.
+     */
+    filterId?: string;
+    /**
+     * @deprecated Dead since the header-filter deletion: NOTHING reads it. It survives on the type
+     * only so details-table cols emitted by an OLDER Spiderly.SourceGenerators (which wrote
+     * `showMatchModes: true`) still compile against this library during a mixed-version window —
+     * a consumer on published NuGet generators plus an npm-linked library build. Delete it once
+     * every consumer regenerates with a generator from this release or later.
+     */
     showMatchModes?: boolean;
-    showAddButton?: boolean;
     dropdownOrMultiselectValues?: PrimengOption[];
     actions?: Action[];
     editable?: boolean;
@@ -351,12 +724,14 @@ export declare class Column<T = any> {
      */
     lockVisible?: boolean;
     /**
-     * CSS length overriding this column's default minimum width (e.g. `'8rem'`). The defaults are
-     * per filter type and sized for the HEADER — filter input plus match-mode dropdown — so they
-     * are generous for a column of short values. It is a MINIMUM, not a width: the table still
-     * distributes the leftover space.
+     * CSS length fixing this column's width (e.g. `'8rem'`). Overrides the per-type default,
+     * which is generous for a column of short values.
+     *
+     * Declare a width on the columns that must stay NARROW and leave the flexible one undeclared:
+     * the table distributes its surplus in proportion to the declared widths, so a column carrying
+     * the long values wants the larger number, not a cap.
      */
-    minWidth?: string;
+    width?: string;
     /**
      * Fired when this column's cell is clicked. Receives a {@link CellClickEvent} with the row id,
      * the column field, the full row, the raw and formatted cell value, the clicked `<td>` element
@@ -367,14 +742,12 @@ export declare class Column<T = any> {
      * Not applied to editable cells — those belong to their inline input.
      */
     onCellClick?: (event: CellClickEvent) => void;
-    constructor({ name, field, filterField, filterType, filterPlaceholder, showMatchModes, showAddButton, dropdownOrMultiselectValues, actions, editable, showTime, decimalPlaces, sortable, visible, lockVisible, minWidth, onCellClick, }?: {
+    constructor({ name, field, filterType, filterId, showMatchModes, dropdownOrMultiselectValues, actions, editable, showTime, decimalPlaces, sortable, visible, lockVisible, width, onCellClick, }?: {
         name?: string;
         field?: string & keyof T;
-        filterField?: string & keyof T;
         filterType?: 'text' | 'date' | 'multiselect' | 'boolean' | 'numeric' | 'blob';
-        filterPlaceholder?: string;
+        filterId?: string;
         showMatchModes?: boolean;
-        showAddButton?: boolean;
         dropdownOrMultiselectValues?: PrimengOption[];
         actions?: Action[];
         editable?: boolean;
@@ -383,7 +756,7 @@ export declare class Column<T = any> {
         sortable?: boolean;
         visible?: boolean;
         lockVisible?: boolean;
-        minWidth?: string;
+        width?: string;
         onCellClick?: (event: CellClickEvent) => void;
     });
 }