@mozaic-ds/angular 2.0.44 → 2.0.46

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozaic-ds/angular",
-  "version": "2.0.44",
+  "version": "2.0.46",
   "type": "module",
   "peerDependencies": {
     "@angular/common": ">=20.3.15",

package/types/mozaic-ds-angular.d.ts

@@ -2314,6 +2314,65 @@ interface BulkDeleteEvent {
     rowSelection?: unknown;
 }
 
+/**
+ * Filter model — multi-condition filter builder with AND/OR combinators.
+ *
+ * Evaluation is left-associative (no operator precedence). Grouped / parenthesised
+ * conditions (`(a AND b) OR c`) are out of scope for the MVP; see docs.
+ */
+type FilterDataType = 'text' | 'number' | 'date' | 'set' | 'boolean';
+type TextOperator = 'contains' | 'notContains' | 'equals' | 'notEquals' | 'startsWith' | 'endsWith' | 'blank' | 'notBlank';
+type NumberOperator = 'equals' | 'notEquals' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'blank' | 'notBlank';
+type DateOperator = NumberOperator;
+type SetOperator = 'in' | 'notIn' | 'blank' | 'notBlank';
+type BooleanOperator = 'equals' | 'blank' | 'notBlank';
+type FilterOperator = TextOperator | NumberOperator | DateOperator | SetOperator | BooleanOperator;
+type FilterCombinator = 'and' | 'or';
+interface FilterValue {
+    /** Primary value. Absent / ignored for `blank` / `notBlank`. */
+    value?: unknown;
+    /** Upper bound for `between`. */
+    valueTo?: unknown;
+}
+interface FilterCondition {
+    /** Stable identifier — used for trackBy and drag-drop reordering. */
+    id: string;
+    /** Ignored for the first condition. Rendered as "Where" in the UI. */
+    combinator: FilterCombinator;
+    field: string;
+    operator: FilterOperator;
+    value: FilterValue;
+}
+interface FilterModel {
+    conditions: FilterCondition[];
+}
+type FilterChangeReason = 'add' | 'update' | 'remove' | 'reorder' | 'clear' | 'replace';
+/**
+ * Payload emitted whenever the filter model changes. Replaces the legacy
+ * `{ filters: ActiveFilter[] }` shape.
+ */
+interface FilterEvent {
+    /** Full model after mutation. */
+    model: FilterModel;
+    /** Condition concerned by the mutation. null for `clear` / `replace`. */
+    condition: FilterCondition | null;
+    /** Mutation kind. */
+    reason: FilterChangeReason;
+}
+type FilterApplyMode = 'auto' | 'manual';
+/** Minimal column info the builder needs to render labels, operators and value editors. */
+interface FilterColumnDescriptor {
+    field: string;
+    headerName: string;
+    filterType: FilterDataType;
+    operators: FilterOperator[];
+    options?: {
+        value: unknown;
+        label: string;
+    }[];
+    defaultOperator: FilterOperator;
+}
+
 type SortDirection = 'asc' | 'desc' | null;
 type CellEditorType = 'text' | 'number' | 'textarea' | 'select' | 'checkbox' | 'date' | 'toggle' | 'custom';
 interface ColumnDef<T = unknown> {
@@ -2341,6 +2400,20 @@ interface ColumnDef<T = unknown> {
     groupable?: boolean;
     /** Whether column supports filtering */
     filterable?: boolean;
+    /**
+     * Filter data type. When omitted, it is derived from `cellEditor`:
+     * `number → number`, `date → date`, `select → set`, anything else → `text`.
+     */
+    filterType?: FilterDataType;
+    /** Allowed operators — subset of the defaults for `filterType`. Optional. */
+    filterOperators?: FilterOperator[];
+    /** Default operator used when a condition is created for this column. */
+    defaultFilterOperator?: FilterOperator;
+    /** For `set` filters: the options shown in the value picker. */
+    filterOptions?: {
+        value: unknown;
+        label: string;
+    }[];
     /** Whether column is pinned/frozen ('start' | 'end' | null) */
     pinned?: 'start' | 'end' | null;
     /** Whether column is visible */
@@ -2455,13 +2528,16 @@ interface LoadMoreEvent {
     limit: number;
 }
 
-interface FilterEvent {
-    filters: ActiveFilter[];
-}
+/**
+ * Lightweight display descriptor for the "FILTERED BY" tag bar. Derived from
+ * the active filter model via `FilterEngine.toLabel()`; kept as a separate
+ * shape so the tag bar template does not depend on the full `FilterCondition`.
+ */
 interface ActiveFilter {
+    /** Condition id (not the column field — multiple conditions can target the same field). */
+    id: string;
     field: string;
     label: string;
-    value: unknown;
     removable: boolean;
 }
 interface GroupEvent {
@@ -2564,23 +2640,6 @@ interface GroupDrawerResult {
     groups: GroupEntry[];
 }
 
-interface FilterDef {
-    field: string;
-    type: 'text' | 'select' | 'range' | 'custom';
-    operator: 'contains' | 'equals' | 'startsWith' | 'gt' | 'lt' | 'between' | 'in';
-    value: unknown;
-}
-declare class FilterEngine<T = unknown> {
-    private readonly state;
-    setFilter(field: string, value: unknown, operator?: FilterDef['operator']): void;
-    removeFilter(field: string): void;
-    clearAllFilters(): void;
-    filterData(data: T[]): T[];
-    private matchFilter;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterEngine<any>, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<FilterEngine<any>>;
-}
-
 declare class GridStateManager<T = unknown> {
     readonly sourceData: _angular_core.WritableSignal<T[]>;
     readonly totalItems: _angular_core.WritableSignal<number>;
@@ -2591,8 +2650,11 @@ declare class GridStateManager<T = unknown> {
     readonly activeSorts: _angular_core.WritableSignal<SortDef[]>;
     readonly groupColumns: _angular_core.WritableSignal<GroupEntry[]>;
     readonly expandedGroups: _angular_core.WritableSignal<Set<string>>;
-    readonly activeFilters: _angular_core.WritableSignal<ActiveFilter[]>;
-    readonly filterDefs: _angular_core.WritableSignal<FilterDef[]>;
+    /**
+     * Unified filter state: single source of truth for the multi-condition
+     * builder. The tag-bar displays a derived view via `FilterEngine.toLabel()`.
+     */
+    readonly filterModel: _angular_core.WritableSignal<FilterModel>;
     readonly pageIndex: _angular_core.WritableSignal<number>;
     readonly pageSize: _angular_core.WritableSignal<number>;
     readonly visibleRowCount: _angular_core.WritableSignal<number>;
@@ -2719,6 +2781,49 @@ declare class MozGridToolbarDef {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MozGridToolbarDef, "[mozGridToolbarDef]", never, { "slot": { "alias": "mozGridToolbarDef"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Discriminator for the empty-state context.
+ * - `no-data`     : the source dataset is empty (no rows ever loaded).
+ * - `no-results`  : the dataset is non-empty but the active filter / search
+ *                   produced zero rows.
+ *
+ * A template registered without an explicit kind defaults to `no-data` and
+ * is also used as the fallback when `no-results` has no dedicated template.
+ */
+type GridEmptyKind = 'no-data' | 'no-results';
+/**
+ * Marks a `<ng-template>` projected into `<moz-grid>` as the renderer for
+ * the empty state. Register one or two templates:
+ *
+ * ```html
+ * <moz-grid [data]="rows">
+ *   <ng-template mozGridEmptyDef>
+ *     <p>Aucune donnée pour le moment</p>
+ *   </ng-template>
+ *
+ *   <ng-template mozGridEmptyDef="no-results" let-ctx>
+ *     <p>Aucun résultat pour vos filtres ({{ ctx.activeFilterCount }})</p>
+ *     <button (click)="ctx.clearFilters()">Réinitialiser</button>
+ *   </ng-template>
+ * </moz-grid>
+ * ```
+ *
+ * The implicit context (`let-ctx`) exposes `{ activeFilterCount, clearFilters }`.
+ */
+declare class MozGridEmptyDef {
+    readonly kind: _angular_core.InputSignal<GridEmptyKind>;
+    readonly template: TemplateRef<GridEmptyContext>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MozGridEmptyDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MozGridEmptyDef, "[mozGridEmptyDef]", never, { "kind": { "alias": "mozGridEmptyDef"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Context object passed to a `mozGridEmptyDef` template. */
+interface GridEmptyContext {
+    /** Number of active filter conditions; `0` when called with `no-data`. */
+    activeFilterCount: number;
+    /** Convenience callback to clear all filter conditions. */
+    clearFilters: () => void;
+}
+
 declare class MozGridComponent<T = unknown> {
     protected readonly state: GridStateManager<T>;
     private readonly gridEngine;
@@ -2745,6 +2850,7 @@ declare class MozGridComponent<T = unknown> {
     private readonly drawerService;
     private readonly columnDefs;
     private readonly toolbarDefs;
+    private readonly emptyDefs;
     readonly data: _angular_core.InputSignal<T[]>;
     readonly mode: _angular_core.InputSignal<"client" | "server">;
     readonly totalItems: _angular_core.InputSignal<number>;
@@ -2760,6 +2866,16 @@ declare class MozGridComponent<T = unknown> {
     readonly fullscreen: _angular_core.InputSignal<boolean>;
     readonly reorderable: _angular_core.InputSignal<boolean>;
     readonly stateKey: _angular_core.InputSignal<string | null>;
+    /** Title for the default "no data" empty state. */
+    readonly emptyDataTitle: _angular_core.InputSignal<string>;
+    /** Description for the default "no data" empty state. */
+    readonly emptyDataDescription: _angular_core.InputSignal<string>;
+    /** Title for the default "no results" empty state (active filters). */
+    readonly noResultsTitle: _angular_core.InputSignal<string>;
+    /** Description for the default "no results" empty state. */
+    readonly noResultsDescription: _angular_core.InputSignal<string>;
+    /** CTA label on the "no results" state. Empty disables the button. */
+    readonly noResultsActionLabel: _angular_core.InputSignal<string>;
     readonly exportable: _angular_core.InputSignal<boolean>;
     readonly horizontalVirtualScroll: _angular_core.InputSignal<boolean>;
     readonly loadingStrategy: _angular_core.InputSignal<LoadingStrategy>;
@@ -2782,7 +2898,42 @@ declare class MozGridComponent<T = unknown> {
     readonly settingsChange: _angular_core.OutputEmitterRef<GridSettingsResult>;
     protected readonly isFullscreen: _angular_core.WritableSignal<boolean>;
     protected readonly groupPanelOpen: _angular_core.WritableSignal<boolean>;
-    protected readonly filterPanelOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * Mode controlling how the builder emits `filterChange`:
+     *  - `auto`   : each mutation triggers an event (default in `client` mode).
+     *  - `manual` : only an explicit Apply emits (default in `server` mode).
+     */
+    readonly filterApplyMode: _angular_core.InputSignal<FilterApplyMode | null>;
+    protected readonly resolvedFilterApplyMode: _angular_core.Signal<FilterApplyMode>;
+    /** Display descriptors for the "FILTERED BY" tag bar. */
+    protected readonly activeFilters: _angular_core.Signal<ActiveFilter[]>;
+    protected readonly activeFilterCount: _angular_core.Signal<number>;
+    /**
+     * Kind of empty state to show, or `'none'` when rows are present:
+     *  - `'no-data'`    : no rows have been loaded (and the source is empty).
+     *  - `'no-results'` : the source has rows but the active filters yield 0.
+     *
+     * Loading and infinite-scroll loading-more states are *not* treated as
+     * empty (we let the loading indicator drive the UX instead).
+     */
+    protected readonly emptyStateKind: _angular_core.Signal<"none" | GridEmptyKind>;
+    /** Resolves the projected `<ng-template mozGridEmptyDef>` for the kind. */
+    protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<GridEmptyContext> | null>;
+    /** Context object exposed to projected empty-state templates. */
+    protected readonly emptyContext: _angular_core.Signal<GridEmptyContext>;
+    /**
+     * Wrap the empty context for `ngTemplateOutlet` so consumers can use
+     * either `let-ctx` (positional, via `$implicit`) or named bindings
+     * (`let-clearFilters="clearFilters"`) without having to choose at
+     * declaration time.
+     */
+    protected readonly emptyTemplateContext: _angular_core.Signal<{
+        activeFilterCount: number;
+        clearFilters: () => void;
+        $implicit: GridEmptyContext;
+    }>;
+    /** CTA label for the default no-results state — hidden when no filters. */
+    protected readonly resolvedNoResultsActionLabel: _angular_core.Signal<string>;
     protected readonly hasHiddenColumns: _angular_core.Signal<boolean>;
     protected readonly hiddenColumnsList: _angular_core.Signal<{
         field: string;
@@ -2836,8 +2987,11 @@ declare class MozGridComponent<T = unknown> {
     onToggleGroupSort(field: string): void;
     onSelectAllRows(): void;
     onClearSelection(): void;
-    onRemoveFilter(field: string): void;
+    /** Removes a single condition by id (tag "×" button). */
+    onRemoveFilter(id: string): void;
+    /** Clears the whole filter model ("Remove all" button). */
     onRemoveAllFilters(): void;
+    onFiltersClick(): void;
     onRestoreColumn(field: string): void;
     toggleFullscreen(): void;
     onRestoreAllColumns(): void;
@@ -2871,7 +3025,7 @@ declare class MozGridComponent<T = unknown> {
     private deleteSelectedRows;
     private coerceAndValidate;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MozGridComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozGridComponent<any>, "moz-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "rowSelection": { "alias": "rowSelection"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "rowIdField": { "alias": "rowIdField"; "required": false; "isSignal": true; }; "detailTemplate": { "alias": "detailTemplate"; "required": false; "isSignal": true; }; "fullscreen": { "alias": "fullscreen"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "exportable": { "alias": "exportable"; "required": false; "isSignal": true; }; "horizontalVirtualScroll": { "alias": "horizontalVirtualScroll"; "required": false; "isSignal": true; }; "loadingStrategy": { "alias": "loadingStrategy"; "required": false; "isSignal": true; }; "scrollThreshold": { "alias": "scrollThreshold"; "required": false; "isSignal": true; }; "plugins": { "alias": "plugins"; "required": false; "isSignal": true; }; }, { "sortChange": "sortChange"; "pageChange": "pageChange"; "loadMore": "loadMore"; "cellEdit": "cellEdit"; "cellEditCancel": "cellEditCancel"; "selectionChange": "selectionChange"; "cellSelectionChange": "cellSelectionChange"; "groupChange": "groupChange"; "filterChange": "filterChange"; "bulkEdit": "bulkEdit"; "bulkCopy": "bulkCopy"; "bulkPaste": "bulkPaste"; "bulkDelete": "bulkDelete"; "fillDown": "fillDown"; "settingsChange": "settingsChange"; }, ["columnDefs", "toolbarDefs"], ["[mozGridFilterTags]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozGridComponent<any>, "moz-grid", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "rowSelection": { "alias": "rowSelection"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; "rowIdField": { "alias": "rowIdField"; "required": false; "isSignal": true; }; "detailTemplate": { "alias": "detailTemplate"; "required": false; "isSignal": true; }; "fullscreen": { "alias": "fullscreen"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "emptyDataTitle": { "alias": "emptyDataTitle"; "required": false; "isSignal": true; }; "emptyDataDescription": { "alias": "emptyDataDescription"; "required": false; "isSignal": true; }; "noResultsTitle": { "alias": "noResultsTitle"; "required": false; "isSignal": true; }; "noResultsDescription": { "alias": "noResultsDescription"; "required": false; "isSignal": true; }; "noResultsActionLabel": { "alias": "noResultsActionLabel"; "required": false; "isSignal": true; }; "exportable": { "alias": "exportable"; "required": false; "isSignal": true; }; "horizontalVirtualScroll": { "alias": "horizontalVirtualScroll"; "required": false; "isSignal": true; }; "loadingStrategy": { "alias": "loadingStrategy"; "required": false; "isSignal": true; }; "scrollThreshold": { "alias": "scrollThreshold"; "required": false; "isSignal": true; }; "plugins": { "alias": "plugins"; "required": false; "isSignal": true; }; "filterApplyMode": { "alias": "filterApplyMode"; "required": false; "isSignal": true; }; }, { "sortChange": "sortChange"; "pageChange": "pageChange"; "loadMore": "loadMore"; "cellEdit": "cellEdit"; "cellEditCancel": "cellEditCancel"; "selectionChange": "selectionChange"; "cellSelectionChange": "cellSelectionChange"; "groupChange": "groupChange"; "filterChange": "filterChange"; "bulkEdit": "bulkEdit"; "bulkCopy": "bulkCopy"; "bulkPaste": "bulkPaste"; "bulkDelete": "bulkDelete"; "fillDown": "fillDown"; "settingsChange": "settingsChange"; }, ["columnDefs", "toolbarDefs", "emptyDefs"], ["[mozGridFilterTags]"], true, never>;
 }
 
 interface GroupRow<T = unknown> {
@@ -3198,6 +3352,44 @@ declare class GroupEngine<T = unknown> {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<GroupEngine<any>>;
 }
 
+declare class FilterEngine<T = unknown> {
+    private readonly state;
+    /** Latest mutation, used by the grid shell to emit `filterChange` once. */
+    private readonly lastChange;
+    readonly conditions: Signal<FilterCondition[]>;
+    readonly hasActiveFilters: Signal<boolean>;
+    readonly lastEvent: Signal<FilterEvent | null>;
+    /** Replaces the whole model in one go. Used by the drawer's Apply button. */
+    setModel(model: FilterModel, reason?: FilterChangeReason): void;
+    addCondition(condition: FilterCondition): void;
+    updateCondition(id: string, patch: Partial<FilterCondition>): void;
+    removeCondition(id: string): void;
+    reorderConditions(fromIndex: number, toIndex: number): void;
+    clearAll(): void;
+    /** Convenience: drop all conditions that target a given field. */
+    removeByField(field: string): void;
+    /**
+     * Evaluates the current model against the provided data. In `server` mode,
+     * the grid delegates filtering to the consumer so we return the input as-is.
+     */
+    filterData(data: T[]): T[];
+    /** Returns a human-readable label for a condition ("Status equals En stock"). */
+    toLabel(condition: FilterCondition): string;
+    /** Returns the filter data type inferred for a column. */
+    getFilterType(field: string): FilterDataType;
+    /**
+     * Builds the column descriptors consumed by the filter builder UI. The
+     * returned list includes only filterable columns.
+     */
+    describeFilterableColumns(): FilterColumnDescriptor[];
+    describeColumn(def: ColumnDef<T>): FilterColumnDescriptor;
+    /** Factory for new conditions created by the UI. */
+    makeCondition(field: string, isFirst: boolean, overrides?: Partial<FilterCondition>): FilterCondition;
+    private notify;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterEngine<any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<FilterEngine<any>>;
+}
+
 declare class ColumnReorderEngine<T = unknown> {
     private readonly state;
     reorder(previousIndex: number, newIndex: number): void;
@@ -3231,6 +3423,8 @@ interface PersistedGridState {
         pinned: 'start' | 'end' | null;
     }>;
     sorts: SortDef[];
+    /** Serialised filter conditions. `id` is regenerated on restore. */
+    filters?: Array<Omit<FilterCondition, 'id'>>;
 }
 declare class StatePersistenceEngine<T = unknown> {
     private readonly state;
@@ -3403,13 +3597,47 @@ declare class MozGridHeaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozGridHeaderComponent, "moz-grid-header", never, { "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "showExpand": { "alias": "showExpand"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; }, { "sortClick": "sortClick"; "menuAction": "menuAction"; "resizeStart": "resizeStart"; "selectAllToggle": "selectAllToggle"; "columnReorder": "columnReorder"; }, never, never, true, never>;
 }
 
+/**
+ * Programmatically opens a CDK overlay anchored on the host element that
+ * renders the filter builder. Unlike the action-listbox directive, the
+ * overlay does not toggle on click — the host is simply the anchor. Open
+ * the overlay by injecting this directive via a template ref (`#filter`)
+ * and calling `filter.open(options)`.
+ */
+declare class MozGridFilterOverlayDirective implements OnDestroy {
+    private readonly overlay;
+    private readonly host;
+    private readonly injector;
+    private readonly engine;
+    private overlayRef;
+    private componentRef;
+    /** Opens the overlay anchored on the host. No-op if already open. */
+    open(options: {
+        columns: FilterColumnDescriptor[];
+        model: FilterModel;
+        /** Optional pre-selected column to seed a new condition. */
+        seedField?: string;
+        onChange: (model: FilterModel) => void;
+    }): void;
+    close(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MozGridFilterOverlayDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MozGridFilterOverlayDirective, "[mozGridFilterOverlay]", ["mozGridFilterOverlay"], {}, {}, never, never, true, never>;
+}
+
 declare class MozGridHeaderCellComponent<T = unknown> {
     private readonly state;
+    private readonly filterEngine;
     readonly columnState: _angular_core.InputSignal<ColumnStateEntry>;
     readonly def: _angular_core.InputSignal<ColumnDef<T>>;
     readonly isLast: _angular_core.InputSignal<boolean>;
     readonly pinnedEnd: _angular_core.InputSignal<boolean>;
     readonly reorderable: _angular_core.InputSignal<boolean>;
+    protected readonly filterOverlay: _angular_core.Signal<MozGridFilterOverlayDirective | undefined>;
+    /** True when at least one active condition targets this column. */
+    readonly hasActiveFilter: _angular_core.Signal<boolean>;
+    /** Tooltip for the gear / filter button (count + short summary). */
+    readonly filterTooltip: _angular_core.Signal<string>;
     readonly resolvedMinWidth: _angular_core.Signal<number>;
     readonly isDragging: _angular_core.Signal<boolean>;
     readonly sortClick: _angular_core.OutputEmitterRef<{
@@ -3425,6 +3653,7 @@ declare class MozGridHeaderCellComponent<T = unknown> {
     readonly menuItems: _angular_core.Signal<MozActionListItem[]>;
     onHeaderClick(event: MouseEvent): void;
     onMenuItemClick(item: MozActionListItem): void;
+    private openFilterOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MozGridHeaderCellComponent<any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozGridHeaderCellComponent<any>, "moz-grid-header-cell", never, { "columnState": { "alias": "columnState"; "required": true; "isSignal": true; }; "def": { "alias": "def"; "required": true; "isSignal": true; }; "isLast": { "alias": "isLast"; "required": false; "isSignal": true; }; "pinnedEnd": { "alias": "pinnedEnd"; "required": false; "isSignal": true; }; "reorderable": { "alias": "reorderable"; "required": false; "isSignal": true; }; }, { "sortClick": "sortClick"; "menuAction": "menuAction"; "resizeStart": "resizeStart"; }, never, never, true, never>;
 }
@@ -4103,5 +4332,5 @@ declare class MozTreeNodeComponent<T = unknown> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozTreeNodeComponent<any>, "moz-tree-node", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; "depth": { "alias": "depth"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "nodeTemplates": { "alias": "nodeTemplates"; "required": false; "isSignal": true; }; "loadChildren": { "alias": "loadChildren"; "required": false; "isSignal": true; }; "ancestors": { "alias": "ancestors"; "required": false; "isSignal": true; }; "flat": { "alias": "flat"; "required": false; "isSignal": true; }; "noResultText": { "alias": "noResultText"; "required": false; "isSignal": true; }; }, { "expandChange": "expandChange"; "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
-export { ACTION_LISTBOX_CONFIG, ActionListboxContainerComponent, ActionListboxRef, BuiltInMenuComponent, CellSelectionEngine, CellValidationEngine, ColumnReorderEngine, ColumnResizeEngine, DEFAULT_ACTION_LISTBOX_CONFIG, DEFAULT_GRID_OPTIONS, DEFAULT_MODAL_CONFIG, DEFAULT_TOASTER_CONFIG, DRAWER_CONFIG, DRAWER_DATA, DrawerContainerComponent, ExpandableRowEngine, ExportEngine, FilterEngine, GridEngine, GridGroupDrawerComponent, GridSettingsDrawerComponent, GridStateManager, GroupEngine, HorizontalVirtualScrollEngine, InfiniteScrollEngine, InlineEditEngine, KeyboardEngine, MODAL_CONFIG, MODAL_DATA, MozAccordionComponent, MozAccordionContentComponent, MozAccordionHeaderComponent, MozAccordionPanelComponent, MozActionBottomBarComponent, MozActionListboxComponent, MozActionListboxTriggerDirective, MozAvatarComponent, MozBreadcrumbComponent, MozButtonComponent, MozCalloutComponent, MozCarouselComponent, MozCheckListMenuComponent, MozCheckboxComponent, MozCheckboxGroupComponent, MozCircularProgressBarComponent, MozComboboxComponent, MozComboboxHarness, MozComboboxOptionHarness, MozDatepickerComponent, MozDividerComponent, MozDrawerComponent, MozDrawerFooterDirective, MozDrawerRef, MozDrawerService, MozFieldComponent, MozFieldGroupComponent, MozFileUploaderComponent, MozFileUploaderItemComponent, MozFlagComponent, MozGridBodyComponent, MozGridCellComponent, MozGridColumnDef, MozGridColumnVisibilityPanelComponent, MozGridComponent, MozGridDetailRowComponent, MozGridFooterComponent, MozGridGroupRowComponent, MozGridHeaderCellComponent, MozGridHeaderComponent, MozGridHeaderMenuComponent, MozGridLoadingIndicatorComponent, MozGridRowComponent, MozGridToolbarDef, MozIconButtonComponent, MozKpiComponent, MozLinearProgressBarBufferComponent, MozLinearProgressBarPercentageComponent, MozLinkComponent, MozLoaderComponent, MozLoadingOverlayComponent, MozModalComponent, MozModalFooterDirective, MozModalRef, MozModalService, MozNavigationIndicatorComponent, MozNumberBadgeComponent, MozOverlayComponent, MozPageHeaderComponent, MozPaginationComponent, MozPasswordInputDirective, MozPhoneNumberComponent, MozPincodeInputComponent, MozPopoverComponent, MozPopoverFooterDirective, MozPopoverTriggerDirective, MozQuantitySelectorComponent, MozRadioComponent, MozRadioGroupComponent, MozSegmentedControlComponent, MozSelectComponent, MozSidebarComponent, MozStarRatingComponent, MozStatusBadgeComponent, MozStatusDotComponent, MozStatusMessageComponent, MozStatusNotificationComponent, MozStepperBottomBarComponent, MozStepperCompactComponent, MozStepperInlineComponent, MozStepperStackedComponent, MozTabComponent, MozTabsComponent, MozTagComponent, MozTextInput, MozTextarea, MozTileComponent, MozTileExpandableComponent, MozTileSelectableComponent, MozToasterComponent, MozToasterRef, MozToasterService, MozToggleComponent, MozTooltipComponent, MozTooltipDirective, MozTreeComponent, MozTreeNodeComponent, MozTreeNodeTemplateDirective, POPOVER_CONFIG, POPOVER_DATA, PaginationEngine, PopoverContainerComponent, PopoverRef, PopoverService, RowSelectionEngine, SortEngine, StatePersistenceEngine, TOASTER_CONFIG, TreeEngine, TreeKeyboardService, TreeSelectionService, TreeStateService, isSection, trackByField, trackDisplayRow };
-export type { ActionListboxConfig, ActionListboxPosition, ActiveFilter, BulkCopyEvent, BulkDeleteEvent, BulkEditEvent, BulkPasteEvent, CellCoord, CellEditCancelEvent, CellEditEvent, CellEditState, CellEditorType, CellError, CellRange, CellSelectionEvent, ColumnDef, ColumnFreezeEvent, ColumnReorderEvent, ColumnResizeEvent, ColumnSearchToggleEvent, ColumnStateEntry, ColumnVisibilityEvent, DisplayRow, ExportOptions, FillDownEvent, FilterDef, FilterEvent, FlatNode, GridDensity, GridEventMap, GridEventType, GridOptions, GridPlugin, GridSettingsData, GridSettingsResult, GridToolbarSlot, GroupDrawerData, GroupDrawerResult, GroupEntry, GroupEvent, GroupRow, HeaderMenuActionId, HeaderMenuConfig, KeyboardActions, LoadChildrenFn, LoadMoreEvent, LoadingStrategy, MozActionListItem, MozActionListItemAppearance, MozAvatarSize, MozBreadcrumbAppearance, MozBreadcrumbLink, MozBuiltInMenuItem, MozBuiltInMenuItemTarget, MozButtonAppearance, MozButtonIconPosition, MozButtonSize, MozButtonType, MozCalloutVariant, MozCheckListMenuItem, MozCircularProgessBarSize, MozComboboxItem, MozComboboxOption, MozComboboxSection, MozComboboxSize, MozDatepickerSize, MozDividerAppearance, MozDividerOrientation, MozDividerSize, MozDrawerConfig, MozDrawerPosition, MozFileUploaderFormat, MozFileUploaderItemFormat, MozFlagType, MozIconButtonAppearance, MozIconButtonSize, MozIconButtonType, MozKpiSize, MozKpiStatus, MozKpiTrend, MozLinearProgressBarBufferSize, MozLinkAppearance, MozLinkIconPosition, MozLinkSize, MozLoaderAppearance, MozLoaderSize, MozNavigationIndicatorAction, MozNumberBadgeAppearance, MozNumberBadgeSize, MozPageHeaderScope, MozPhoneNumberCountry, MozPhoneNumberSize, MozPhoneNumberValue, MozPincodeLength, MozPopoverAppearance, MozPopoverPosition, MozPopoverSize, MozQuantitySelectorSize, MozSegmentedControlSize, MozSegmentedItem, MozSelectOption, MozSelectSize, MozSelectValue, MozSidebarItem, MozSidebarSubItem, MozStarRatingAppearance, MozStarRatingSize, MozStatusBadgeStatus, MozStatusDotSize, MozStatusDotStatus, MozStatusMessageStatus, MozStatusNotificationStatus, MozStepperBottomBarStep, MozStepperInlineStep, MozStepperStackedStep, MozTabItem, MozTagSize, MozTagType, MozTextInputSize, MozTileAppearance, MozTileExpandableTrigger, MozTileInputPosition, MozTileInputVerticalPosition, MozTileSelectableAppearance, MozTileSelectableType, MozToasterPosition, MozToasterRole, MozToasterStatus, MozToggleSize, MozTooltipPosition, PageEvent, PaginationState, PersistedGridState, PopoverConfig, PopoverTriggerMode, RowSelectionEvent, SelectAllMode, SortDef, SortDirection, SortEvent, TreeDisplayRow, TreeNode, TreeNodeConfig, TreeNodeContext, TreeSelectionMode };
+export { ACTION_LISTBOX_CONFIG, ActionListboxContainerComponent, ActionListboxRef, BuiltInMenuComponent, CellSelectionEngine, CellValidationEngine, ColumnReorderEngine, ColumnResizeEngine, DEFAULT_ACTION_LISTBOX_CONFIG, DEFAULT_GRID_OPTIONS, DEFAULT_MODAL_CONFIG, DEFAULT_TOASTER_CONFIG, DRAWER_CONFIG, DRAWER_DATA, DrawerContainerComponent, ExpandableRowEngine, ExportEngine, FilterEngine, GridEngine, GridGroupDrawerComponent, GridSettingsDrawerComponent, GridStateManager, GroupEngine, HorizontalVirtualScrollEngine, InfiniteScrollEngine, InlineEditEngine, KeyboardEngine, MODAL_CONFIG, MODAL_DATA, MozAccordionComponent, MozAccordionContentComponent, MozAccordionHeaderComponent, MozAccordionPanelComponent, MozActionBottomBarComponent, MozActionListboxComponent, MozActionListboxTriggerDirective, MozAvatarComponent, MozBreadcrumbComponent, MozButtonComponent, MozCalloutComponent, MozCarouselComponent, MozCheckListMenuComponent, MozCheckboxComponent, MozCheckboxGroupComponent, MozCircularProgressBarComponent, MozComboboxComponent, MozComboboxHarness, MozComboboxOptionHarness, MozDatepickerComponent, MozDividerComponent, MozDrawerComponent, MozDrawerFooterDirective, MozDrawerRef, MozDrawerService, MozFieldComponent, MozFieldGroupComponent, MozFileUploaderComponent, MozFileUploaderItemComponent, MozFlagComponent, MozGridBodyComponent, MozGridCellComponent, MozGridColumnDef, MozGridColumnVisibilityPanelComponent, MozGridComponent, MozGridDetailRowComponent, MozGridEmptyDef, MozGridFooterComponent, MozGridGroupRowComponent, MozGridHeaderCellComponent, MozGridHeaderComponent, MozGridHeaderMenuComponent, MozGridLoadingIndicatorComponent, MozGridRowComponent, MozGridToolbarDef, MozIconButtonComponent, MozKpiComponent, MozLinearProgressBarBufferComponent, MozLinearProgressBarPercentageComponent, MozLinkComponent, MozLoaderComponent, MozLoadingOverlayComponent, MozModalComponent, MozModalFooterDirective, MozModalRef, MozModalService, MozNavigationIndicatorComponent, MozNumberBadgeComponent, MozOverlayComponent, MozPageHeaderComponent, MozPaginationComponent, MozPasswordInputDirective, MozPhoneNumberComponent, MozPincodeInputComponent, MozPopoverComponent, MozPopoverFooterDirective, MozPopoverTriggerDirective, MozQuantitySelectorComponent, MozRadioComponent, MozRadioGroupComponent, MozSegmentedControlComponent, MozSelectComponent, MozSidebarComponent, MozStarRatingComponent, MozStatusBadgeComponent, MozStatusDotComponent, MozStatusMessageComponent, MozStatusNotificationComponent, MozStepperBottomBarComponent, MozStepperCompactComponent, MozStepperInlineComponent, MozStepperStackedComponent, MozTabComponent, MozTabsComponent, MozTagComponent, MozTextInput, MozTextarea, MozTileComponent, MozTileExpandableComponent, MozTileSelectableComponent, MozToasterComponent, MozToasterRef, MozToasterService, MozToggleComponent, MozTooltipComponent, MozTooltipDirective, MozTreeComponent, MozTreeNodeComponent, MozTreeNodeTemplateDirective, POPOVER_CONFIG, POPOVER_DATA, PaginationEngine, PopoverContainerComponent, PopoverRef, PopoverService, RowSelectionEngine, SortEngine, StatePersistenceEngine, TOASTER_CONFIG, TreeEngine, TreeKeyboardService, TreeSelectionService, TreeStateService, isSection, trackByField, trackDisplayRow };
+export type { ActionListboxConfig, ActionListboxPosition, ActiveFilter, BulkCopyEvent, BulkDeleteEvent, BulkEditEvent, BulkPasteEvent, CellCoord, CellEditCancelEvent, CellEditEvent, CellEditState, CellEditorType, CellError, CellRange, CellSelectionEvent, ColumnDef, ColumnFreezeEvent, ColumnReorderEvent, ColumnResizeEvent, ColumnSearchToggleEvent, ColumnStateEntry, ColumnVisibilityEvent, DisplayRow, ExportOptions, FillDownEvent, FilterEvent, FlatNode, GridDensity, GridEmptyContext, GridEmptyKind, GridEventMap, GridEventType, GridOptions, GridPlugin, GridSettingsData, GridSettingsResult, GridToolbarSlot, GroupDrawerData, GroupDrawerResult, GroupEntry, GroupEvent, GroupRow, HeaderMenuActionId, HeaderMenuConfig, KeyboardActions, LoadChildrenFn, LoadMoreEvent, LoadingStrategy, MozActionListItem, MozActionListItemAppearance, MozAvatarSize, MozBreadcrumbAppearance, MozBreadcrumbLink, MozBuiltInMenuItem, MozBuiltInMenuItemTarget, MozButtonAppearance, MozButtonIconPosition, MozButtonSize, MozButtonType, MozCalloutVariant, MozCheckListMenuItem, MozCircularProgessBarSize, MozComboboxItem, MozComboboxOption, MozComboboxSection, MozComboboxSize, MozDatepickerSize, MozDividerAppearance, MozDividerOrientation, MozDividerSize, MozDrawerConfig, MozDrawerPosition, MozFileUploaderFormat, MozFileUploaderItemFormat, MozFlagType, MozIconButtonAppearance, MozIconButtonSize, MozIconButtonType, MozKpiSize, MozKpiStatus, MozKpiTrend, MozLinearProgressBarBufferSize, MozLinkAppearance, MozLinkIconPosition, MozLinkSize, MozLoaderAppearance, MozLoaderSize, MozNavigationIndicatorAction, MozNumberBadgeAppearance, MozNumberBadgeSize, MozPageHeaderScope, MozPhoneNumberCountry, MozPhoneNumberSize, MozPhoneNumberValue, MozPincodeLength, MozPopoverAppearance, MozPopoverPosition, MozPopoverSize, MozQuantitySelectorSize, MozSegmentedControlSize, MozSegmentedItem, MozSelectOption, MozSelectSize, MozSelectValue, MozSidebarItem, MozSidebarSubItem, MozStarRatingAppearance, MozStarRatingSize, MozStatusBadgeStatus, MozStatusDotSize, MozStatusDotStatus, MozStatusMessageStatus, MozStatusNotificationStatus, MozStepperBottomBarStep, MozStepperInlineStep, MozStepperStackedStep, MozTabItem, MozTagSize, MozTagType, MozTextInputSize, MozTileAppearance, MozTileExpandableTrigger, MozTileInputPosition, MozTileInputVerticalPosition, MozTileSelectableAppearance, MozTileSelectableType, MozToasterPosition, MozToasterRole, MozToasterStatus, MozToggleSize, MozTooltipPosition, PageEvent, PaginationState, PersistedGridState, PopoverConfig, PopoverTriggerMode, RowSelectionEvent, SelectAllMode, SortDef, SortDirection, SortEvent, TreeDisplayRow, TreeNode, TreeNodeConfig, TreeNodeContext, TreeSelectionMode };