@sinequa/atomic-angular 1.7.2 → 1.9.0

package/index.d.ts

@@ -4,7 +4,7 @@ import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable, Subject } from 'rxjs';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _sinequa_atomic from '@sinequa/atomic';
-import { Article as Article$1, LegacyFilter, KeyOf, Query, QueryParams as QueryParams$1, AggregationItem, TreeAggregationNode, Aggregation, TreeAggregation, Conversion, CCApp, CCColumn, CCQuery, CCWebService, Principal, SpellingCorrectionMode, AuditEvents, CustomHighlights, Result, AuditEventType, AuditEventTypeValues, Suggestion, PreviewData, TextLocation, TextChunk, UserProfile, CCSortingChoice, LinkResult, ExportQueryModel, ExportOutputFormat, FilterOperator } from '@sinequa/atomic';
+import { Article as Article$1, LegacyFilter, KeyOf, Query, QueryParams as QueryParams$1, AggregationItem, TreeAggregationNode, Aggregation, TreeAggregation, Conversion, CCApp, CCColumn, CCQuery, CCWebService, Principal, SpellingCorrectionMode, AuditEvents, CustomHighlights, Result, AuditEventType, AuditEventTypeValues, Suggestion, Filter as Filter$2, PreviewData, TextLocation, TextChunk, UserProfile, CCSortingChoice, LinkResult, ExportQueryModel, ExportOutputFormat, FilterOperator } from '@sinequa/atomic';
 import { Router, Params, Route, NavigationEnd, CanActivateFn, ResolveFn } from '@angular/router';
 import * as _sinequa_atomic_angular from '@sinequa/atomic-angular';
 import * as _sinequa_ui from '@sinequa/ui';
@@ -397,7 +397,7 @@ declare class MissingTermsComponent {
 }
 
 declare const multiSelectionToolbarVariants: (props?: ({
-    variant?: "dark" | "light" | "glassy" | null | undefined;
+    variant?: "light" | "dark" | "glassy" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type MultiSelectionToolbarVariants = VariantProps<typeof multiSelectionToolbarVariants>;
 declare class MultiSelectionToolbarComponent {
@@ -786,7 +786,7 @@ declare class MultiSelectionToolbarComponent {
         feedback?: _sinequa_atomic_angular.CFeedback;
     } | undefined;
     readonly class: _angular_core.InputSignal<string>;
-    readonly variant: _angular_core.InputSignal<"dark" | "light" | "glassy" | null | undefined>;
+    readonly variant: _angular_core.InputSignal<"light" | "dark" | "glassy" | null | undefined>;
     readonly updatedCollections: _angular_core.OutputEmitterRef<void>;
     readonly count: _angular_core.Signal<number>;
     readonly variants: _angular_core.Signal<string>;
@@ -1296,6 +1296,35 @@ type AggregationTreeEx = TreeAggregation & {
     items: AggregationListItem[];
 };
 type AggregationEx = AggregationListEx | AggregationTreeEx;
+/**
+ * Controlled selection for the `<Aggregation>` family of components.
+ *
+ * - `values`: selected item values (list aggregations)
+ * - `paths`: selected tree paths in the `"/A/B/*"` format — the same format used
+ *   by the `values` of the stored tree filters
+ * - `option`: a selected date option (date aggregations) — the `value` of the
+ *   aggregation item (the real filter value, e.g. `"this-week"`), never its
+ *   `display`. The component re-selects that option directly, which is robust
+ *   across days for presets whose bounds are computed relative to today.
+ * - `range`: a custom date range (date aggregations) — the `from`/`to` bounds.
+ *
+ * `option` and `range` are mutually exclusive: a date selection is either a
+ * preset or a custom range, never both.
+ */
+type AggregationSelection = {
+    kind: "values";
+    values: string[];
+} | {
+    kind: "paths";
+    paths: string[];
+} | {
+    kind: "option";
+    option: string;
+} | {
+    kind: "range";
+    from?: string;
+    to?: string;
+};
 
 type Autocomplete = {
     bookmarks?: number;
@@ -2158,7 +2187,7 @@ declare const PrincipalStore: _angular_core.Type<{
     param9: _angular_core.Signal<string>;
     param10: _angular_core.Signal<string>;
     userOverrideActive: _angular_core.Signal<boolean>;
-    state: _angular_core.Signal<"error" | "initial" | "loading" | "loaded">;
+    state: _angular_core.Signal<"initial" | "loading" | "loaded" | "error">;
     allowUserOverride: _angular_core.Signal<boolean>;
     isOverridingUser: _angular_core.Signal<boolean>;
     initials: _angular_core.Signal<string>;
@@ -2517,7 +2546,7 @@ declare const UserSettingsStore: _angular_core.Type<{
     alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
     collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
     language?: _angular_core.Signal<string | undefined> | undefined;
-    userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+    userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
     agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
     isDebugMode: _angular_core.Signal<boolean>;
     isDarkMode: _angular_core.Signal<boolean>;
@@ -3159,10 +3188,25 @@ declare class AggregationsService {
     }>;
     nonSearchableColumns: string[];
     protected API_URL: string;
-    loadMore(query: Partial<Query>, aggregation: Aggregation, audit?: AuditEvents): Observable<Aggregation>;
-    open(query: Partial<Query>, aggregation: TreeAggregation, item: TreeAggregationNode): Observable<TreeAggregation>;
+    loadMore(query: Partial<Query>, aggregation: Aggregation, audit?: AuditEvents, options?: {
+        count?: number;
+    }): Observable<Aggregation>;
+    open(query: Partial<Query>, aggregation: TreeAggregation, item: TreeAggregationNode, options?: {
+        guardFree?: boolean;
+    }): Observable<TreeAggregation>;
     getAggregation(name: string, column: string | null): AggEx | null | undefined;
     processAggregation(name: string, column: string | null): AggEx | null | undefined;
+    /**
+     * Applies the app-level customization (custom JSON display/icon/hidden/searchable,
+     * non-searchable columns) and marks the `$selected` items on the given aggregation.
+     *
+     * @param agg - The aggregation to enrich (mutated in place and returned).
+     * @param selectionValues - Controlled selection: the selected values (list) or
+     * `"/A/B/*"` paths (tree). When `undefined`, the selection is derived from the
+     * shared `QueryParamsStore` filters (default behavior). An empty array means
+     * "nothing selected" and skips the store read entirely.
+     */
+    enrichAggregation(agg: AggEx, selectionValues?: string[]): AggEx;
     /**
      * Converts an `AggregationItem` to a `LegacyFilter`.
      *
@@ -3206,6 +3250,17 @@ declare class AggregationsService {
         column: string;
         name: string;
     }[];
+    /**
+     * Removes the aggregations flagged `hidden: true` in the `filters` custom JSON
+     * configuration (the administrator does not want them displayed).
+     *
+     * Exposed for consumers that build their own aggregation list without going through
+     * {@link getAuthorizedFilters} (e.g. the aside filters drawer).
+     *
+     * @param aggregations - The aggregations to filter.
+     * @returns The aggregations that are not flagged hidden.
+     */
+    rejectHidden(aggregations: Aggregation[]): Aggregation[];
     /**
      * Determines whether a custom JSON filter refers to the given aggregation.
      *
@@ -3220,6 +3275,7 @@ declare class AggregationsService {
     private getFilterCriteria;
     private getHomepageFilterCriteria;
     private getLeftOnlyFilterCriteria;
+    private getHiddenFilterCriteria;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AggregationsService>;
 }
@@ -3272,7 +3328,7 @@ declare class ApplicationService {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -3344,7 +3400,7 @@ declare class ApplicationService {
         param9: _angular_core.Signal<string>;
         param10: _angular_core.Signal<string>;
         userOverrideActive: _angular_core.Signal<boolean>;
-        state: _angular_core.Signal<"error" | "initial" | "loading" | "loaded">;
+        state: _angular_core.Signal<"initial" | "loading" | "loaded" | "error">;
         allowUserOverride: _angular_core.Signal<boolean>;
         isOverridingUser: _angular_core.Signal<boolean>;
         initials: _angular_core.Signal<string>;
@@ -4139,7 +4195,7 @@ declare class AutocompleteService {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -4617,6 +4673,23 @@ declare class InlineWorker {
     terminate(): void;
 }
 
+/**
+ * Converts a `LegacyFilter` to the structured `Filter` model, built with the
+ * `filter.*` helpers of `@sinequa/atomic`. The result is assignable as-is to
+ * `query.filters` / `fetchQuery({ filters })`.
+ *
+ * Covers the shapes produced by the aggregation components when applying
+ * filters (`toFilter`, `getFiltersForTree`, `getFormValueFilter`,
+ * `buildAppliedFilter`): `in` values, `and`/`or` expression trees, `between`
+ * ranges, scalar leaves (`eq`/`contains`/`gte`/`lte`/…) and the operator-less
+ * `{ field, value }` form (treated as `eq`).
+ *
+ * Returns `undefined` for an absent filter or a degenerate shape (leaf without
+ * `field`/`value`, empty combinator) — consistent with the `filter.and`/`or`
+ * collapsing rules and with an absent `query.filters`.
+ */
+declare function legacyFilterToFilter(legacy: LegacyFilter | undefined): Filter$2 | undefined;
+
 /**
  * Retrieves the query name from the current route.
  *
@@ -5456,7 +5529,7 @@ declare class SavedSearchesService {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -5766,7 +5839,7 @@ declare class SearchService {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -6440,6 +6513,78 @@ declare class SourceComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SourceComponent, "source, Source", never, { "collection": { "alias": "collection"; "required": false; "isSignal": true; }; "connector": { "alias": "connector"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Context of a projected `<ng-template aggregationItem>` — the content/label
+ * region of a single item in `<aggregation-list>` / `<aggregation-tree>`.
+ * The host owns only the content; the component keeps the checkbox,
+ * click-to-select, count, virtualization and (tree) chevron/indentation/recursion.
+ *
+ * The `level` / `expanded` / `hasChildren` fields are **tree-only**: they are
+ * populated by `<aggregation-tree>` and left `undefined` by `<aggregation-list>`
+ * (hence optional — a single directive serves both). See {@link AggregationTreeItemContext}
+ * for the tree-specialized (all-required) shape, if you prefer to annotate `let-*` manually.
+ */
+interface AggregationItemContext {
+    /** The aggregation item (list) or node (tree). */
+    $implicit: AggregationListItem;
+    /** The aggregation column. */
+    field: string | null | undefined;
+    /** Whether the item is currently selected. */
+    selected: boolean;
+    /** The item's document count. */
+    count: number;
+    /** The localized display label (`display || value`, run through `syslang`). */
+    name: string;
+    /** The current search-within-facet text — re-apply `highlightWord` with it if needed. */
+    searchText: string;
+    /** Tree only — depth level of the node (drives indentation in the default template). */
+    level?: number;
+    /** Tree only — whether the node is expanded. */
+    expanded?: boolean;
+    /** Tree only — whether the node has (or may lazily load) children. */
+    hasChildren?: boolean;
+}
+/**
+ * Tree-specialized context: same as {@link AggregationItemContext} but with the
+ * structural fields required. `<aggregation-tree>` always populates them; use this
+ * type to annotate `let-*` when you want them non-optional in a tree template.
+ */
+interface AggregationTreeItemContext extends AggregationItemContext {
+    level: number;
+    expanded: boolean;
+    hasChildren: boolean;
+}
+/**
+ * Marker directive: project a custom template for the content/label region of
+ * each aggregation item. Put it on an `<ng-template>` inside `<aggregation-list>`
+ * or `<aggregation-tree>`:
+ *
+ * ```html
+ * <aggregation-list name="Languages" column="language" [aggregation]="agg">
+ *   <ng-template aggregationItem let-item let-count="count" let-selected="selected">
+ *     <span>{{ item.display }}</span>
+ *     <span class="badge">{{ count }}</span>
+ *   </ng-template>
+ * </aggregation-list>
+ * ```
+ *
+ * When no template is projected, the component renders its default row content.
+ * The `let-*` variables are typed under `strictTemplates` via
+ * {@link AggregationItemDirective.ngTemplateContextGuard}; the host must import
+ * this directive in its component `imports`.
+ */
+declare class AggregationItemDirective {
+    readonly template: TemplateRef<AggregationItemContext>;
+    /**
+     * Narrows the `let-*` of `<ng-template aggregationItem>` under `strictTemplates`.
+     * Tree-only fields (`level`/`expanded`/`hasChildren`) are typed as optional; a tree
+     * template can re-annotate them via {@link AggregationTreeItemContext} if desired.
+     */
+    static ngTemplateContextGuard(_dir: AggregationItemDirective, ctx: unknown): ctx is AggregationItemContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationItemDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AggregationItemDirective, "[aggregationItem]", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * Directive to mark a child element for special processing.
  * This can be used to apply specific styles or behaviors to child elements.
@@ -6523,7 +6668,7 @@ declare class ShowBookmarkDirective {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -7571,16 +7716,61 @@ declare class AggregationDateComponent {
      * @default true
      */
     syncUrl: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Controlled query. When set, the component's own operations run against this
+     * query instead of reading the shared `QueryParamsStore`. Use to target a query
+     * not tied to the current app, without mutating the shared store or the URL.
+     *
+     * @default undefined — read `QueryParamsStore.getQuery()` (current behavior)
+     */
+    controlledQuery: _angular_core.InputSignal<Query | undefined>;
+    /**
+     * Controlled data. When set, the component renders this aggregation object
+     * instead of reading it from the shared `AggregationsStore`.
+     *
+     * @default undefined — read `AggregationsStore` (current behavior)
+     */
+    controlledAggregation: _angular_core.InputSignal<Aggregation | undefined>;
+    /**
+     * Controlled selection. When set, the date form is derived from this value
+     * instead of the shared `QueryParamsStore` filters:
+     * `{ kind: "option", option }` re-selects the date option whose aggregation
+     * item `value` matches (the real filter value, never the `display`);
+     * `{ kind: "range", from, to }` fills the custom range from the bounds.
+     * The two kinds are mutually exclusive — a date selection is either a preset
+     * or a custom range.
+     *
+     * @default undefined — derive from `QueryParamsStore` filters (current behavior)
+     */
+    controlledSelection: _angular_core.InputSignal<AggregationSelection | undefined>;
     readonly title: _angular_core.InputSignal<AggregationTitle>;
     readonly displayEmptyDistributionIntervals: _angular_core.InputSignal<boolean>;
     onSelect: _angular_core.OutputEmitterRef<AggregationItem[]>;
     onApply: _angular_core.OutputEmitterRef<void>;
     onClear: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits the new selection (`{ kind: "option" }` preset or `{ kind: "range" }`
+     * custom range) in controlled mode. The counterpart of the `[selection]` input,
+     * emitted before `filtersChange`. Date is a radio list, so this fires **live at
+     * selection time** — picking a preset radio, or confirming a date in the custom
+     * range picker — not on an apply click (the custom-range radio alone, with no
+     * date picked, emits nothing). Also emitted on clear. In controlled mode this is
+     * the only way changes surface: nothing is written to the shared stores or the URL.
+     */
+    selectionChange: _angular_core.OutputEmitterRef<AggregationSelection>;
+    /**
+     * Emits the selection as a structured `Filter` (the exact filter the default
+     * mode would write to the store), ready for `fetchQuery({ filters })`.
+     * `undefined` on clear. Controlled mode only — emitted right after
+     * `selectionChange` (see its live-emission timing).
+     */
+    filtersChange: _angular_core.OutputEmitterRef<Filter$2 | undefined>;
     isCollapsed: _angular_core.WritableSignal<boolean>;
     expanded: _angular_core.Signal<"" | null>;
     protected readonly searchText: _angular_core.ModelSignal<string>;
     private readonly searchInput;
     private readonly base;
+    readonly isControlled: _angular_core.Signal<boolean>;
     readonly aggregationsService: _sinequa_atomic_angular.AggregationsService;
     readonly queryParamsStore: {
         name?: _angular_core.Signal<string | undefined> | undefined;
@@ -7650,7 +7840,7 @@ declare class AggregationDateComponent {
         }) => Partial<LegacyFilter & {
             count: number;
         }> | null;
-        getQuery: () => _sinequa_atomic.Query;
+        getQuery: () => Query;
     } & _ngrx_signals.StateSource<{
         name?: string | undefined;
         text?: string | undefined;
@@ -7689,6 +7879,13 @@ declare class AggregationDateComponent {
     readonly transloco: TranslocoService;
     protected readonly selection: _angular_core.WritableSignal<boolean>;
     protected readonly validSelection: _angular_core.WritableSignal<boolean>;
+    /**
+     * Guards live emission while the form is seeded programmatically from the
+     * `[selection]` input (see the seeding effect below). `form.setValue`/`patchValue`
+     * emit `valueChanges` synchronously; without this flag a controlled host that
+     * re-feeds `[selection]` from `selectionChange` would loop indefinitely.
+     */
+    private seedingForm;
     readonly aggregation: _angular_core.Signal<AggEx | null>;
     readonly isEmpty: _angular_core.Signal<boolean>;
     readonly items: _angular_core.Signal<AggregationItem[]>;
@@ -7706,6 +7903,13 @@ declare class AggregationDateComponent {
     protected readonly customRangeFrom: _angular_core.Signal<string>;
     protected readonly customRangeTo: _angular_core.Signal<string>;
     constructor();
+    /**
+     * Emits the current form selection through `selectionChange` then `filtersChange`
+     * (controlled mode). Shared by `apply()` and the live emission paths so both
+     * produce identical payloads. Throws if the form is not a valid selection
+     * (`getFormValueFilter`) — callers decide how to surface it.
+     */
+    private emitCurrentSelection;
     select(): void;
     apply(): void;
     clear(notify?: boolean): void;
@@ -7713,10 +7917,39 @@ declare class AggregationDateComponent {
     protected selectAndOpenDialog(): void;
     protected onRangeSelected(range: DateRange): void;
     private updateForm;
+    /**
+     * Derives the form from a controlled selection.
+     * `{ kind: "option" }` re-selects the date option whose item `value` matches —
+     * no operator/value matching, so presets whose bounds are computed relative to
+     * today survive a round-trip across days; a value unknown to the aggregation
+     * resets the form. `{ kind: "range" }` fills the custom range from the bounds.
+     */
+    private updateFormFromSelection;
+    /**
+     * The date option codes (what `form.option` holds) are the items' `display`
+     * with a fallback on their `value` (see `translateAggregationToDateOptions`).
+     * The controlled selection persists the item `value` — the real filter value —
+     * so these two helpers convert between the option code and the item value.
+     */
+    private optionToItemValue;
+    private itemValueToOption;
+    /**
+     * Converts a controlled `{ kind: "range" }` selection to the `LegacyFilter`
+     * shape `updateForm` expects (which only reads `operator`/`value`/`filters`).
+     * Returns `undefined` for an empty or non-range selection, which resets the form.
+     */
+    private rangeToLegacyFilter;
+    /**
+     * Converts the applied `LegacyFilter` to a `{ kind: "range" }` selection
+     * (the shape emitted through `selectionChange` in controlled mode).
+     * Mirrors the operator handling of `updateForm`. Presets whose operator is not
+     * a range operator (e.g. `eq`) collapse to `from = to = value`.
+     */
+    private toRangeSelection;
     private toEndOfDay;
     private getFormValueFilter;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationDateComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationDateComponent, "aggregation-date, AggregationDate, aggregationdate", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "displayEmptyDistributionIntervals": { "alias": "displayEmptyDistributionIntervals"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "searchText": "searchTextChange"; }, never, ["label"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationDateComponent, "aggregation-date, AggregationDate, aggregationdate", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "controlledQuery": { "alias": "query"; "required": false; "isSignal": true; }; "controlledAggregation": { "alias": "aggregation"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "selection"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "displayEmptyDistributionIntervals": { "alias": "displayEmptyDistributionIntervals"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "selectionChange": "selectionChange"; "filtersChange": "filtersChange"; "searchText": "searchTextChange"; }, never, ["label"], true, never>;
 }
 
 /**
@@ -8581,7 +8814,7 @@ declare class SignedOutComponent {
 }
 
 declare class BookmarkButtonComponent {
-    variant: _angular_core.InputSignal<"default" | "icon" | "primary" | "secondary" | "destructive" | "ai" | "link" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "none" | null | undefined>;
+    variant: _angular_core.InputSignal<"default" | "link" | "primary" | "secondary" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "destructive" | "icon" | "ai" | "none" | null | undefined>;
     size: _angular_core.InputSignal<"icon" | "xs" | "sm" | "md" | "lg" | null | undefined>;
     readonly article: _angular_core.InputSignal<Partial<Article$1>>;
     private readonly userSettingsStore;
@@ -10167,7 +10400,7 @@ declare class SearchFeedbackComponent {
     onClose: _angular_core.OutputEmitterRef<void>;
     readonly feedbackDialog: _angular_core.Signal<FeedbackDialogComponent | undefined>;
     pages: _angular_core.InputSignal<any>;
-    variant: _angular_core.InputSignal<"default" | "icon" | "primary" | "secondary" | "destructive" | "ai" | "link" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "none" | null | undefined>;
+    variant: _angular_core.InputSignal<"default" | "link" | "primary" | "secondary" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "destructive" | "icon" | "ai" | "none" | null | undefined>;
     solid: _angular_core.InputSignal<boolean | null | undefined>;
     readonly auditService: AuditService;
     protected readonly queryParamsStore: {
@@ -10300,6 +10533,14 @@ declare class AggregationTreeComponent {
     collapsed: _angular_core.InputSignal<boolean>;
     searchable: _angular_core.InputSignal<boolean | undefined>;
     showFiltersCount: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Whether to render the per-node checkbox. When `false`, the checkbox is hidden
+     * but selection still toggles on row click — pair it with a custom `aggregationItem`
+     * template that reflects the `selected` context to convey selection.
+     *
+     * @default true
+     */
+    showCheckbox: _angular_core.InputSignalWithTransform<boolean, unknown>;
     expandedLevel: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
     /**
      * When `false`, applying or clearing filters updates the store without
@@ -10308,15 +10549,63 @@ declare class AggregationTreeComponent {
      * @default true
      */
     syncUrl: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Controlled query. When set, the component's own operations (load-more,
+     * search-within-facet, tree-expand) run against this query instead of reading
+     * the shared `QueryParamsStore`. Use to target a query not tied to the current
+     * app, without mutating the shared store or the URL.
+     *
+     * @default undefined — read `QueryParamsStore.getQuery()` (current behavior)
+     */
+    controlledQuery: _angular_core.InputSignal<Query | undefined>;
+    /**
+     * Controlled data. When set, the component renders this aggregation object
+     * instead of reading it from the shared `AggregationsStore`.
+     *
+     * @default undefined — read `AggregationsStore` (current behavior)
+     */
+    controlledAggregation: _angular_core.InputSignal<Aggregation | undefined>;
+    /**
+     * Controlled selection. When set, item `$selected` state is derived from this
+     * value (`paths` in the `"/A/B/*"` format) instead of the shared
+     * `QueryParamsStore` filters.
+     *
+     * @default undefined — derive from `QueryParamsStore` filters (current behavior)
+     */
+    controlledSelection: _angular_core.InputSignal<AggregationSelection | undefined>;
     onSelect: _angular_core.OutputEmitterRef<AggregationItem[]>;
     onApply: _angular_core.OutputEmitterRef<void>;
     onClear: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits the new selection (`"/A/B/*"` paths) when the user applies or clears
+     * filters in controlled mode. The counterpart of the `[selection]` input —
+     * emitted before `filtersChange` and `onApply`/`onClear`. In controlled mode
+     * this is the only way changes surface: nothing is written to the shared
+     * stores or the URL.
+     */
+    selectionChange: _angular_core.OutputEmitterRef<AggregationSelection>;
+    /**
+     * Emits the applied selection as a structured `Filter` (the exact filter the
+     * default mode would write to the store), ready for `fetchQuery({ filters })`.
+     * `undefined` on clear. Controlled mode only — emitted after `selectionChange`,
+     * before `onApply`/`onClear`.
+     */
+    filtersChange: _angular_core.OutputEmitterRef<Filter$2 | undefined>;
     virtualItems: _angular_core.Signal<readonly ElementRef<HTMLDivElement>[]>;
     scrollElement: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    protected readonly itemDirective: _angular_core.Signal<AggregationItemDirective | undefined>;
+    /**
+     * Item content template relayed by the `<Aggregation>` wrapper (which cannot
+     * project content into this component). Also usable directly as a `TemplateRef`
+     * input. A directive projected straight onto this component takes precedence.
+     */
+    readonly itemTemplateInput: _angular_core.InputSignal<TemplateRef<AggregationItemContext> | undefined>;
+    protected readonly resolvedItemTemplate: _angular_core.Signal<TemplateRef<AggregationItemContext> | undefined>;
     selection: _angular_core.WritableSignal<boolean>;
     isAllSelected: _angular_core.WritableSignal<boolean>;
     searchText: _angular_core.ModelSignal<string>;
     private readonly base;
+    readonly isControlled: _angular_core.Signal<boolean>;
     readonly aggregationsStore: {
         aggregations: _angular_core.Signal<Aggregation[]>;
         update: (aggregations: Aggregation[]) => void;
@@ -10394,7 +10683,7 @@ declare class AggregationTreeComponent {
         }) => Partial<LegacyFilter & {
             count: number;
         }> | null;
-        getQuery: () => _sinequa_atomic.Query;
+        getQuery: () => Query;
     } & _ngrx_signals.StateSource<{
         name?: string | undefined;
         text?: string | undefined;
@@ -10750,14 +11039,14 @@ declare class AggregationTreeComponent {
     readonly suggests: _angular_core.WritableSignal<_sinequa_atomic.Suggestion[]>;
     readonly hasFilters: _angular_core.Signal<boolean>;
     readonly filtersCount: _angular_core.Signal<number>;
-    readonly query: _sinequa_atomic.Query;
+    readonly query: Query;
     readonly filters: _angular_core.WritableSignal<LegacyFilter[]>;
     readonly showCount: _angular_core.Signal<boolean>;
     readonly quickFilter: _angular_core.Signal<boolean | undefined>;
     readonly isDate: _angular_core.Signal<boolean>;
     readonly virtualizer: _tanstack_angular_virtual.AngularVirtualizer<HTMLDivElement, Element>;
     readonly linkChildren: _angular_core.Signal<boolean | undefined>;
-    aggregation: _angular_core.Signal<_sinequa_atomic_angular.AggEx | null>;
+    aggregation: _angular_core.Signal<AggEx | null>;
     items: _angular_core.Signal<AggregationListItem[]>;
     isEmpty: _angular_core.Signal<boolean>;
     readonly searchedItems: _angular_core.Signal<TreeAggregationNode[] | {
@@ -10798,7 +11087,7 @@ declare class AggregationTreeComponent {
     private expandItems;
     private traverse;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationTreeComponent, "AggregationTree, aggregation-tree, aggregationtree", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "expandedLevel": { "alias": "expandedLevel"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "searchText": "searchTextChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationTreeComponent, "AggregationTree, aggregation-tree, aggregationtree", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "expandedLevel": { "alias": "expandedLevel"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "controlledQuery": { "alias": "query"; "required": false; "isSignal": true; }; "controlledAggregation": { "alias": "aggregation"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "selection"; "required": false; "isSignal": true; }; "itemTemplateInput": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "selectionChange": "selectionChange"; "filtersChange": "filtersChange"; "searchText": "searchTextChange"; }, ["itemDirective"], never, true, never>;
 }
 
 declare class AggregationListComponent {
@@ -10811,6 +11100,14 @@ declare class AggregationListComponent {
     collapsed: _angular_core.InputSignal<boolean>;
     searchable: _angular_core.InputSignal<boolean | undefined>;
     showFiltersCount: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
+    /**
+     * Whether to render the per-item checkbox. When `false`, the checkbox is hidden
+     * but selection still toggles on row click — pair it with a custom `aggregationItem`
+     * template that reflects the `selected` context to convey selection.
+     *
+     * @default true
+     */
+    showCheckbox: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * When `false`, applying or clearing filters updates the store without
      * synchronizing the URL (no browser history entry, not shareable/restorable).
@@ -10818,14 +11115,61 @@ declare class AggregationListComponent {
      * @default true
      */
     syncUrl: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Controlled query. When set, the component's own operations (load-more,
+     * search-within-facet) run against this query instead of reading the shared
+     * `QueryParamsStore`. Use to target a query not tied to the current app,
+     * without mutating the shared store or the URL.
+     *
+     * @default undefined — read `QueryParamsStore.getQuery()` (current behavior)
+     */
+    controlledQuery: _angular_core.InputSignal<Query | undefined>;
+    /**
+     * Controlled data. When set, the component renders this aggregation object
+     * instead of reading it from the shared `AggregationsStore`.
+     *
+     * @default undefined — read `AggregationsStore` (current behavior)
+     */
+    controlledAggregation: _angular_core.InputSignal<Aggregation | undefined>;
+    /**
+     * Controlled selection. When set, item `$selected` state is derived from this
+     * value instead of the shared `QueryParamsStore` filters.
+     *
+     * @default undefined — derive from `QueryParamsStore` filters (current behavior)
+     */
+    controlledSelection: _angular_core.InputSignal<AggregationSelection | undefined>;
     onSelect: _angular_core.OutputEmitterRef<AggregationItem[]>;
     onApply: _angular_core.OutputEmitterRef<void>;
     onClear: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits the new selection (item values) when the user applies or clears
+     * filters in controlled mode. The counterpart of the `[selection]` input —
+     * emitted before `filtersChange` and `onApply`/`onClear`. In controlled mode
+     * this is the only way changes surface: nothing is written to the shared
+     * stores or the URL.
+     */
+    selectionChange: _angular_core.OutputEmitterRef<AggregationSelection>;
+    /**
+     * Emits the applied selection as a structured `Filter` (the exact filter the
+     * default mode would write to the store), ready for `fetchQuery({ filters })`.
+     * `undefined` on clear. Controlled mode only — emitted after `selectionChange`,
+     * before `onApply`/`onClear`.
+     */
+    filtersChange: _angular_core.OutputEmitterRef<Filter$2 | undefined>;
     scrollElement: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    protected readonly itemDirective: _angular_core.Signal<AggregationItemDirective | undefined>;
+    /**
+     * Item content template relayed by the `<Aggregation>` wrapper (which cannot
+     * project content into this component). Also usable directly as a `TemplateRef`
+     * input. A directive projected straight onto this component takes precedence.
+     */
+    readonly itemTemplateInput: _angular_core.InputSignal<TemplateRef<AggregationItemContext> | undefined>;
+    protected readonly resolvedItemTemplate: _angular_core.Signal<TemplateRef<AggregationItemContext> | undefined>;
     selection: _angular_core.WritableSignal<boolean>;
     isAllSelected: _angular_core.WritableSignal<boolean>;
     searchText: _angular_core.ModelSignal<string>;
     private readonly base;
+    readonly isControlled: _angular_core.Signal<boolean>;
     readonly aggregationsStore: {
         aggregations: _angular_core.Signal<Aggregation[]>;
         update: (aggregations: Aggregation[]) => void;
@@ -10903,7 +11247,7 @@ declare class AggregationListComponent {
         }) => Partial<LegacyFilter & {
             count: number;
         }> | null;
-        getQuery: () => _sinequa_atomic.Query;
+        getQuery: () => Query;
     } & _ngrx_signals.StateSource<{
         name?: string | undefined;
         text?: string | undefined;
@@ -11257,14 +11601,14 @@ declare class AggregationListComponent {
     readonly suggests: _angular_core.WritableSignal<_sinequa_atomic.Suggestion[]>;
     readonly hasFilters: _angular_core.Signal<boolean>;
     readonly filtersCount: _angular_core.Signal<number>;
-    readonly query: _sinequa_atomic.Query;
+    readonly query: Query;
     readonly filters: _angular_core.WritableSignal<LegacyFilter[]>;
     readonly showCount: _angular_core.Signal<boolean>;
     readonly quickFilter: _angular_core.Signal<boolean | undefined>;
     readonly isDate: _angular_core.Signal<boolean>;
     private readonly cdr;
     readonly virtualizer: _tanstack_angular_virtual.AngularVirtualizer<HTMLDivElement, Element>;
-    aggregation: _angular_core.Signal<_sinequa_atomic_angular.AggEx | null>;
+    aggregation: _angular_core.Signal<AggEx | null>;
     items: _angular_core.Signal<AggregationListItem[]>;
     isEmpty: _angular_core.Signal<boolean>;
     searchedItems: _angular_core.Signal<AggregationItem[]>;
@@ -11282,7 +11626,7 @@ declare class AggregationListComponent {
     protected getFilters(): LegacyFilter[];
     private addCurrentFiltersToItems;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationListComponent, "AggregationList, aggregation-list, aggregationlist", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "searchText": "searchTextChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationListComponent, "AggregationList, aggregation-list, aggregationlist", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "controlledQuery": { "alias": "query"; "required": false; "isSignal": true; }; "controlledAggregation": { "alias": "aggregation"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "selection"; "required": false; "isSignal": true; }; "itemTemplateInput": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "searchText": { "alias": "searchText"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "selectionChange": "selectionChange"; "filtersChange": "filtersChange"; "searchText": "searchTextChange"; }, ["itemDirective"], never, true, never>;
 }
 
 /**
@@ -11492,8 +11836,8 @@ declare class AggregationComponent {
         isDateColumn: (column: string) => boolean;
         isTabSearch: (queryName: string) => boolean;
         getAggregationCount: (queryName: string | undefined, aggregationName: string) => number;
-        getAuthorizedFilters: () => _sinequa_atomic.Aggregation[];
-        getAuthorized: (filters: Pick<_sinequa_atomic_angular.CFilter, "column" | "name">[]) => _sinequa_atomic.Aggregation[];
+        getAuthorizedFilters: () => Aggregation[];
+        getAuthorized: (filters: Pick<_sinequa_atomic_angular.CFilter, "column" | "name">[]) => Aggregation[];
         getNamedCustomizationJson: (name: string) => unknown | undefined;
         getAggregationIcon: (column: string) => string | undefined;
         getAggregationItemsCustomization: (column: string) => _sinequa_atomic_angular.CFilterItem[] | undefined;
@@ -11618,18 +11962,24 @@ declare class AggregationComponent {
         columnMap?: Record<string, _sinequa_atomic.CCColumn> | undefined;
     }>;
     aggregationsStore: {
-        aggregations: _angular_core.Signal<_sinequa_atomic.Aggregation[]>;
-        update: (aggregations: _sinequa_atomic.Aggregation[]) => void;
-        updateAggregation: (aggregation: _sinequa_atomic.Aggregation) => void;
+        aggregations: _angular_core.Signal<Aggregation[]>;
+        update: (aggregations: Aggregation[]) => void;
+        updateAggregation: (aggregation: Aggregation) => void;
         clear: () => void;
-        getAggregation: (name: string, kind?: "column" | "name") => _sinequa_atomic.Aggregation | undefined;
+        getAggregation: (name: string, kind?: "column" | "name") => Aggregation | undefined;
     } & _ngrx_signals.StateSource<{
-        aggregations: _sinequa_atomic.Aggregation[];
+        aggregations: Aggregation[];
     }>;
     aggregationsService: AggregationsService;
     aggregationDate: _angular_core.Signal<AggregationDateComponent | undefined>;
     aggregationTree: _angular_core.Signal<AggregationTreeComponent | undefined>;
     aggregationList: _angular_core.Signal<AggregationListComponent | undefined>;
+    /**
+     * Host-projected `<ng-template aggregationItem>`, relayed to the active list/tree
+     * sub-component (the wrapper has no `<ng-content>`, so the sub-component's own
+     * `contentChild` cannot see it). See {@link AggregationItemDirective}.
+     */
+    protected readonly itemDirective: _angular_core.Signal<AggregationItemDirective | undefined>;
     class: _angular_core.InputSignal<string>;
     /**
      * The name of the <details> element. When you provide the same id, the component work as an accordion
@@ -11673,6 +12023,13 @@ declare class AggregationComponent {
      * "Undefined" and not "false" because this input overrides the custom json settings
      */
     searchable: _angular_core.InputSignal<undefined>;
+    /**
+     * Whether to render the per-item checkbox (list/tree). When `false`, the checkbox
+     * is hidden but selection still toggles on row click. Ignored by the date variant.
+     *
+     * @default true
+     */
+    showCheckbox: _angular_core.InputSignalWithTransform<boolean, unknown>;
     expandedLevel: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
     /**
      * Controls whether applying or clearing a filter synchronizes the URL.
@@ -11684,12 +12041,64 @@ declare class AggregationComponent {
      * @default true
      */
     syncUrl: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Controlled query. When set, the aggregation's own operations (load-more,
+     * search-within-facet, tree-expand) run against this query instead of reading
+     * the shared `QueryParamsStore`. Use to target a query not tied to the current
+     * app, without mutating the shared store or the URL.
+     *
+     * @default undefined — read `QueryParamsStore.getQuery()` (current behavior)
+     */
+    controlledQuery: _angular_core.InputSignal<Query | undefined>;
+    /**
+     * Controlled data. When set, the component renders this aggregation object
+     * (name/column/items) instead of reading it from the shared `AggregationsStore`.
+     *
+     * @default undefined — read `AggregationsStore` (current behavior)
+     */
+    controlledAggregation: _angular_core.InputSignal<Aggregation | undefined>;
+    /**
+     * Controlled selection. When set, item `$selected` state is derived from this
+     * value (list: item values; tree: `"/A/B/*"` paths; date: the range) instead
+     * of the shared `QueryParamsStore` filters.
+     *
+     * @default undefined — derive from `QueryParamsStore` filters (current behavior)
+     */
+    controlledSelection: _angular_core.InputSignal<AggregationSelection | undefined>;
+    /**
+     * Which sub-component renders the aggregation.
+     *
+     * `"auto"` (default) keeps the current heuristic: a date column of the app
+     * (`AppStore.isDateColumn`) renders `<AggregationDate>`, a tree aggregation
+     * renders `<AggregationTree>`, anything else `<AggregationList>`. Set an
+     * explicit value in controlled mode when the heuristic cannot apply — e.g. a
+     * date facet of a query not attached to the current app, whose column is
+     * unknown to the app's column map.
+     *
+     * @default "auto"
+     */
+    type: _angular_core.InputSignal<"auto" | "list" | "tree" | "date">;
     /**
      * An output event that emits an array of selected `AggregationItem` objects when the user selects items in the aggregation component. This allows parent components to listen for selection changes and react accordingly, such as applying filters or updating the UI based on the selected items.
      */
     onSelect: _angular_core.OutputEmitterRef<AggregationItem[]>;
     onApply: _angular_core.OutputEmitterRef<void>;
     onClear: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits the new selection when the user applies or clears filters in
+     * controlled mode (list: item values; tree: `"/A/B/*"` paths; date: option or
+     * range). The counterpart of the `[selection]` input — emitted before
+     * `filtersChange` and `onApply`/`onClear`. In controlled mode this is the only
+     * way changes surface: nothing is written to the shared stores or the URL.
+     */
+    selectionChange: _angular_core.OutputEmitterRef<AggregationSelection>;
+    /**
+     * Emits the applied selection as a structured `Filter` (the exact filter the
+     * default mode would write to the store), ready for `fetchQuery({ filters })`.
+     * `undefined` on clear. Controlled mode only — emitted after `selectionChange`,
+     * before `onApply`/`onClear`.
+     */
+    filtersChange: _angular_core.OutputEmitterRef<Filter$2 | undefined>;
     /**
      * A computed property that retrieves the items to be displayed in the aggregation component. It checks for the presence of date, tree, or list aggregation components and returns their respective items. If none of these components are present, it returns an empty array. This allows the component to dynamically display the appropriate items based on the type of aggregation being rendered.
      *
@@ -11702,7 +12111,12 @@ declare class AggregationComponent {
      * @returns An array of selected items from the aggregation component.
      */
     protected selectedItems: _angular_core.Signal<AggregationItem[]>;
-    protected aggregation: _angular_core.Signal<_sinequa_atomic_angular.AggEx | undefined>;
+    protected aggregation: _angular_core.Signal<Aggregation | undefined>;
+    /**
+     * The sub-component to render: the explicit `type` input, or the current
+     * date/tree/list heuristic when `type` is `"auto"`.
+     */
+    protected resolvedType: _angular_core.Signal<"list" | "tree" | "date">;
     /**
      * Checks if the specified column is a date filter.
      *
@@ -11711,7 +12125,7 @@ declare class AggregationComponent {
      */
     protected isDate(column: string | undefined): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AggregationComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationComponent, "Aggregation, aggregation", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "expandedLevel": { "alias": "expandedLevel"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AggregationComponent, "Aggregation, aggregation", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "showFiltersCount": { "alias": "showFiltersCount"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "expandedLevel": { "alias": "expandedLevel"; "required": false; "isSignal": true; }; "syncUrl": { "alias": "syncUrl"; "required": false; "isSignal": true; }; "controlledQuery": { "alias": "query"; "required": false; "isSignal": true; }; "controlledAggregation": { "alias": "aggregation"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "selection"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; "onApply": "onApply"; "onClear": "onClear"; "selectionChange": "selectionChange"; "filtersChange": "filtersChange"; }, ["itemDirective"], never, true, never>;
 }
 
 declare class AggregationPanelComponent {
@@ -11750,18 +12164,37 @@ declare class AggregationPanelComponent {
 declare class AsideFiltersComponent {
     cn: typeof cn;
     class: _angular_core.InputSignal<string | undefined>;
-    position: _angular_core.InputSignal<"left" | "both" | undefined>;
-    private readonly appStore;
-    asideFilters: _angular_core.Signal<Aggregation[]>;
     /**
-     * Checks if the specified column is a date filter.
+     * Explicit, developer-defined list of aggregations to display.
      *
-     * @param column The column name to check.
-     * @returns True if the column is a date filter, false otherwise.
+     * Each entry is an aggregation **name** (preferred) or **column** — e.g.
+     * `['Authors', 'Sources', 'Geo']`. Although typed as `string[]`, this is the list of
+     * aggregations to render, not a list of raw column keys.
+     *
+     * When provided, it fully bypasses the JSON `filters` configuration (neither
+     * `position`, `getAuthorized`, nor the admin `hidden` rule are applied): the listed
+     * aggregations are rendered as-is, in the given order, provided they exist in the
+     * {@link AggregationsStore}. When empty (default), the component falls back to the
+     * JSON-driven behavior (`position: 'left' | 'both'`, excluding `hidden` aggregations).
+     *
+     * Resolution tries by `name` first — the canonical, unambiguous identifier, since a
+     * `column` can be shared by several aggregations with distinct names — then falls back
+     * to the first aggregation matching the given column. Prefer passing names.
      */
-    protected isDate(column: string): boolean;
+    aggregations: _angular_core.InputSignal<string[]>;
+    /**
+     * When `true` (default), every section shares the same `id`, producing a native
+     * `<details name>` accordion where a single section is open at a time. When `false`,
+     * each section gets a unique id (based on the aggregation `name`) and expands
+     * independently — closer to a typical SBA v2 "Facets List".
+     */
+    exclusive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly appStore;
+    private readonly aggregationsStore;
+    private readonly aggregationsService;
+    asideFilters: _angular_core.Signal<Pick<Aggregation, "name" | "column">[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AsideFiltersComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AsideFiltersComponent, "aside-filters, AsideFilters, asidefilters", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AsideFiltersComponent, "aside-filters, AsideFilters, asidefilters", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "aggregations": { "alias": "aggregations"; "required": false; "isSignal": true; }; "exclusive": { "alias": "exclusive"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type CFilterEx = CFilter & {
@@ -11779,7 +12212,7 @@ declare class FilterButtonComponent {
     position: _angular_core.InputSignal<Placement>;
     offset: _angular_core.InputSignal<number>;
     expandedLevel: _angular_core.InputSignalWithTransform<number | undefined, unknown>;
-    protected variant: _angular_core.WritableSignal<"default" | "icon" | "primary" | "secondary" | "destructive" | "ai" | "link" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "none" | null | undefined>;
+    protected variant: _angular_core.WritableSignal<"default" | "link" | "primary" | "secondary" | "outline" | "accent" | "tertiary" | "ghost" | "light-accent" | "destructive" | "icon" | "ai" | "none" | null | undefined>;
     protected filter: _angular_core.WritableSignal<CFilterEx>;
     popoverRef: _angular_core.Signal<PopoverComponent | undefined>;
     protected nativeElement: any;
@@ -13231,465 +13664,26 @@ declare class FiltersBarComponent {
 }
 
 declare class MoreComponent {
-    cn: typeof cn;
     count: _angular_core.InputSignal<number>;
     includedFilters: _angular_core.InputSignal<string[]>;
     excludedFilters: _angular_core.InputSignal<string[]>;
     aggregations: _angular_core.InputSignal<Aggregation[] | undefined>;
     homepage: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    appStore: {
-        name: _angular_core.Signal<string>;
-        description?: _angular_core.Signal<string | undefined> | undefined;
-        versionId: _angular_core.Signal<string>;
-        queries: _angular_core.Signal<Record<string, _sinequa_atomic.CCQuery>>;
-        rfms: _angular_core.Signal<Record<string, _sinequa_atomic.CCRFM>>;
-        indexes: _angular_core.Signal<{
-            _: _sinequa_atomic.CCIndex;
-        } & Record<string, _sinequa_atomic.CCIndex>>;
-        lists: _angular_core.Signal<Record<string, _sinequa_atomic.CCList>>;
-        webServices: _angular_core.Signal<Record<string, _sinequa_atomic.CCWebService>>;
-        queryNames: _angular_core.Signal<string>;
-        labels: _angular_core.Signal<string>;
-        preview: _angular_core.Signal<string>;
-        autocomplete: _angular_core.Signal<string>;
-        sponsoredLinks: _angular_core.Signal<string>;
-        queryExport: _angular_core.Signal<string>;
-        queryRssEnabled: _angular_core.Signal<boolean>;
-        data: _angular_core.Signal<Record<string, unknown> & _sinequa_atomic_angular.CJson & {
-            filters?: _sinequa_atomic_angular.CAggregation[];
-            autocomplete?: _sinequa_atomic_angular.Autocomplete;
-            tabs?: Record<string, {
-                filters: string[];
-                overviews?: Record<string, {
-                    minRelevance: number;
-                }>;
-            }>;
-            sources?: _sinequa_atomic_angular.CSources;
-            features?: {
-                [key: string]: boolean | {
-                    [key: string]: string | boolean | string[] | undefined;
-                } | undefined;
-                allowChangePassword?: boolean;
-                editablepartition?: boolean;
-                advancedSearch?: boolean;
-                allowChatDrawer?: boolean;
-                filterLinkChildren?: boolean;
-                expandPreview?: boolean;
-                quickFilter?: boolean;
-                showAggregationItemCount?: boolean;
-                assistant?: {
-                    usePrefixName?: boolean;
-                };
-                filters?: {
-                    homepage?: boolean;
-                };
-                userProfile?: {
-                    enabled?: boolean;
-                    data?: string[];
-                    customData?: string[];
-                };
-                previewMultiConversion?: boolean;
-                persistFiltersAcrossTabs?: boolean;
-            };
-            allowAdvancedFilters?: boolean;
-            general?: {
-                name?: string;
-                logo?: {
-                    alt?: string;
-                    light?: {
-                        small?: string;
-                        large?: string;
-                        sidebar?: string;
-                    };
-                    dark?: {
-                        small?: string;
-                        large?: string;
-                        sidebar?: string;
-                    };
-                };
-                features?: {
-                    [key: string]: boolean | {
-                        [key: string]: string | boolean | string[] | undefined;
-                    } | undefined;
-                    allowChangePassword?: boolean;
-                    editablepartition?: boolean;
-                    advancedSearch?: boolean;
-                    allowChatDrawer?: boolean;
-                    filterLinkChildren?: boolean;
-                    expandPreview?: boolean;
-                    quickFilter?: boolean;
-                    showAggregationItemCount?: boolean;
-                    assistant?: {
-                        usePrefixName?: boolean;
-                    };
-                    filters?: {
-                        homepage?: boolean;
-                    };
-                    userProfile?: {
-                        enabled?: boolean;
-                        data?: string[];
-                        customData?: string[];
-                    };
-                    previewMultiConversion?: boolean;
-                    persistFiltersAcrossTabs?: boolean;
-                };
-                converters?: _sinequa_atomic_angular.CConverter[];
-                feedback?: _sinequa_atomic_angular.CFeedback;
-            };
-            documentsUploadSettings?: {
-                enabled?: boolean;
-            };
-        }>;
-        customJSONs: _angular_core.Signal<{
-            name: string;
-            data: Record<string, unknown>;
-        }[] & _sinequa_atomic_angular.SideCJson[]>;
-        apiVersion: _angular_core.Signal<string>;
-        workspaceApp: _angular_core.Signal<string>;
-        defaultQueryName: _angular_core.Signal<string>;
-        auditEnabled?: _angular_core.Signal<boolean | undefined> | undefined;
-        dataSets?: _angular_core.Signal<string | undefined> | undefined;
-        revision?: _angular_core.Signal<number | undefined> | undefined;
-        runnableModels?: _angular_core.Signal<string | undefined> | undefined;
-        authorizationLevel?: _angular_core.Signal<string | undefined> | undefined;
-        columnMap?: _angular_core.Signal<Record<string, _sinequa_atomic.CCColumn> | undefined> | undefined;
-        customizationJson: _angular_core.Signal<_sinequa_atomic_angular.CJsonMint>;
-        sources: _angular_core.Signal<_sinequa_atomic_angular.CSources>;
-        filters: _angular_core.Signal<CFilter[]>;
-        general: _angular_core.Signal<{
-            name?: string;
-            logo?: {
-                alt?: string;
-                light?: {
-                    small?: string;
-                    large?: string;
-                    sidebar?: string;
-                };
-                dark?: {
-                    small?: string;
-                    large?: string;
-                    sidebar?: string;
-                };
-            };
-            features?: {
-                [key: string]: boolean | {
-                    [key: string]: string | boolean | string[] | undefined;
-                } | undefined;
-                allowChangePassword?: boolean;
-                editablepartition?: boolean;
-                advancedSearch?: boolean;
-                allowChatDrawer?: boolean;
-                filterLinkChildren?: boolean;
-                expandPreview?: boolean;
-                quickFilter?: boolean;
-                showAggregationItemCount?: boolean;
-                assistant?: {
-                    usePrefixName?: boolean;
-                };
-                filters?: {
-                    homepage?: boolean;
-                };
-                userProfile?: {
-                    enabled?: boolean;
-                    data?: string[];
-                    customData?: string[];
-                };
-                previewMultiConversion?: boolean;
-                persistFiltersAcrossTabs?: boolean;
-            };
-            converters?: _sinequa_atomic_angular.CConverter[];
-            feedback?: _sinequa_atomic_angular.CFeedback;
-        } | undefined>;
-        assistants: _angular_core.Signal<{
-            [x: string]: _sinequa_atomic_angular.AssistantDetails;
-        }>;
-        agents: _angular_core.Signal<{
-            [x: string]: {
-                defaultAgent: string;
-            };
-        }>;
-        initialize: () => Promise<void>;
-        initializeWithAppName: (appName: string) => Promise<void>;
-        update: (app: Partial<_sinequa_atomic_angular.CCAppState>) => void;
-        getWebServiceByType: (type: _sinequa_atomic.CCWebService["webServiceType"]) => _sinequa_atomic.CCWebService | undefined;
-        getLabels: () => {
-            private: string;
-            public: string;
-        };
-        getQueryByName: (name: string) => _sinequa_atomic.CCQuery | undefined;
-        getQueryByIndex: (index: number) => _sinequa_atomic.CCQuery | undefined;
-        getDefaultQuery: () => _sinequa_atomic.CCQuery | undefined;
-        allowEmptySearch: (queryName: string) => boolean;
-        enableFieldedSearch: (queryName: string) => boolean;
-        allowLabels: () => boolean;
-        getColumnAlias: (column: string) => string;
-        getColumn: (columnOrAlias: string) => _sinequa_atomic.CCColumn | undefined;
-        isDateColumn: (column: string) => boolean;
-        isTabSearch: (queryName: string) => boolean;
-        getAggregationCount: (queryName: string | undefined, aggregationName: string) => number;
-        getAuthorizedFilters: () => Aggregation[];
-        getAuthorized: (filters: Pick<CFilter, "column" | "name">[]) => Aggregation[];
-        getNamedCustomizationJson: (name: string) => unknown | undefined;
-        getAggregationIcon: (column: string) => string | undefined;
-        getAggregationItemsCustomization: (column: string) => _sinequa_atomic_angular.CFilterItem[] | undefined;
-        getAggregationCustomization: (aggColumn: string, aggName?: string) => CFilter | undefined;
-        isAssistantAllowed: (assistantName: string) => boolean;
-        isAgentAllowed: (agentName: string) => boolean;
-    } & _ngrx_signals.StateSource<{
-        name: string;
-        description?: string | undefined;
-        versionId: string;
-        queries: Record<string, _sinequa_atomic.CCQuery>;
-        rfms: Record<string, _sinequa_atomic.CCRFM>;
-        indexes: {
-            _: _sinequa_atomic.CCIndex;
-        } & Record<string, _sinequa_atomic.CCIndex>;
-        lists: Record<string, _sinequa_atomic.CCList>;
-        webServices: Record<string, _sinequa_atomic.CCWebService>;
-        queryNames: string;
-        labels: string;
-        preview: string;
-        autocomplete: string;
-        sponsoredLinks: string;
-        queryExport: string;
-        queryRssEnabled: boolean;
-        data: Record<string, unknown> & _sinequa_atomic_angular.CJson & {
-            filters?: _sinequa_atomic_angular.CAggregation[];
-            autocomplete?: _sinequa_atomic_angular.Autocomplete;
-            tabs?: Record<string, {
-                filters: string[];
-                overviews?: Record<string, {
-                    minRelevance: number;
-                }>;
-            }>;
-            sources?: _sinequa_atomic_angular.CSources;
-            features?: {
-                [key: string]: boolean | {
-                    [key: string]: string | boolean | string[] | undefined;
-                } | undefined;
-                allowChangePassword?: boolean;
-                editablepartition?: boolean;
-                advancedSearch?: boolean;
-                allowChatDrawer?: boolean;
-                filterLinkChildren?: boolean;
-                expandPreview?: boolean;
-                quickFilter?: boolean;
-                showAggregationItemCount?: boolean;
-                assistant?: {
-                    usePrefixName?: boolean;
-                };
-                filters?: {
-                    homepage?: boolean;
-                };
-                userProfile?: {
-                    enabled?: boolean;
-                    data?: string[];
-                    customData?: string[];
-                };
-                previewMultiConversion?: boolean;
-                persistFiltersAcrossTabs?: boolean;
-            };
-            allowAdvancedFilters?: boolean;
-            general?: {
-                name?: string;
-                logo?: {
-                    alt?: string;
-                    light?: {
-                        small?: string;
-                        large?: string;
-                        sidebar?: string;
-                    };
-                    dark?: {
-                        small?: string;
-                        large?: string;
-                        sidebar?: string;
-                    };
-                };
-                features?: {
-                    [key: string]: boolean | {
-                        [key: string]: string | boolean | string[] | undefined;
-                    } | undefined;
-                    allowChangePassword?: boolean;
-                    editablepartition?: boolean;
-                    advancedSearch?: boolean;
-                    allowChatDrawer?: boolean;
-                    filterLinkChildren?: boolean;
-                    expandPreview?: boolean;
-                    quickFilter?: boolean;
-                    showAggregationItemCount?: boolean;
-                    assistant?: {
-                        usePrefixName?: boolean;
-                    };
-                    filters?: {
-                        homepage?: boolean;
-                    };
-                    userProfile?: {
-                        enabled?: boolean;
-                        data?: string[];
-                        customData?: string[];
-                    };
-                    previewMultiConversion?: boolean;
-                    persistFiltersAcrossTabs?: boolean;
-                };
-                converters?: _sinequa_atomic_angular.CConverter[];
-                feedback?: _sinequa_atomic_angular.CFeedback;
-            };
-            documentsUploadSettings?: {
-                enabled?: boolean;
-            };
-        };
-        customJSONs: {
-            name: string;
-            data: Record<string, unknown>;
-        }[] & _sinequa_atomic_angular.SideCJson[];
-        apiVersion: string;
-        workspaceApp: string;
-        defaultQueryName: string;
-        auditEnabled?: boolean | undefined;
-        dataSets?: string | undefined;
-        revision?: number | undefined;
-        runnableModels?: string | undefined;
-        authorizationLevel?: string | undefined;
-        columnMap?: Record<string, _sinequa_atomic.CCColumn> | undefined;
-    }>;
-    aggregationsStore: {
-        aggregations: _angular_core.Signal<Aggregation[]>;
-        update: (aggregations: Aggregation[]) => void;
-        updateAggregation: (aggregation: Aggregation) => void;
-        clear: () => void;
-        getAggregation: (name: string, kind?: "column" | "name") => Aggregation | undefined;
-    } & _ngrx_signals.StateSource<{
-        aggregations: Aggregation[];
-    }>;
-    queryParamsStore: {
-        name?: _angular_core.Signal<string | undefined> | undefined;
-        text?: _angular_core.Signal<string | undefined> | undefined;
-        action?: _angular_core.Signal<"" | "open" | "search" | "aggregate" | undefined> | undefined;
-        select?: _angular_core.Signal<_sinequa_atomic.Select[] | undefined> | undefined;
-        open?: _angular_core.Signal<_sinequa_atomic.Open[] | undefined> | undefined;
-        page?: _angular_core.Signal<number | undefined> | undefined;
-        pageSize?: _angular_core.Signal<number | undefined> | undefined;
-        tab?: _angular_core.Signal<string | undefined> | undefined;
-        scope?: _angular_core.Signal<string | undefined> | undefined;
-        sort?: _angular_core.Signal<string | undefined> | undefined;
-        basket?: _angular_core.Signal<string | undefined> | undefined;
-        isFirstPage?: _angular_core.Signal<boolean | undefined> | undefined;
-        strictRefine?: _angular_core.Signal<boolean | undefined> | undefined;
-        globalRelevance?: _angular_core.Signal<number | undefined> | undefined;
-        questionLanguage?: _angular_core.Signal<string | undefined> | undefined;
-        questionDefaultLanguage?: _angular_core.Signal<string | undefined> | undefined;
-        spellingCorrectionMode?: _angular_core.Signal<_sinequa_atomic.SpellingCorrectionMode | undefined> | undefined;
-        spellingCorrectionFilter?: _angular_core.Signal<string | undefined> | undefined;
-        documentWeight?: _angular_core.Signal<string | undefined> | undefined;
-        textPartWeights?: _angular_core.Signal<string | undefined> | undefined;
-        relevanceTransforms?: _angular_core.Signal<string | undefined> | undefined;
-        removeDuplicates?: _angular_core.Signal<boolean | undefined> | undefined;
-        queryId?: _angular_core.Signal<string | undefined> | undefined;
-        aggregations?: _angular_core.Signal<string[] | Record<string, _sinequa_atomic.AggregationOptions> | undefined> | undefined;
-        orderBy?: _angular_core.Signal<string | undefined> | undefined;
-        groupBy?: _angular_core.Signal<string | undefined> | undefined;
-        neuralSearch?: _angular_core.Signal<boolean | undefined> | undefined;
-        path?: _angular_core.Signal<string | undefined> | undefined;
-        filters: _angular_core.Signal<_sinequa_atomic.LegacyFilter[]>;
-        id?: _angular_core.Signal<string | undefined> | undefined;
-        setFromUrl: (href: string) => void;
-        getQueryParams: () => {
-            f?: string;
-            p?: number;
-            s?: string;
-            t?: string;
-            q?: string;
-            b?: string;
-            n?: string;
-        };
-        addFilter: (filter: _sinequa_atomic.LegacyFilter, audit?: _sinequa_atomic.AuditEvents, options?: {
-            syncUrl?: boolean;
-        }) => void;
-        updateFilter: (newFilter: _sinequa_atomic.LegacyFilter, audit?: _sinequa_atomic.AuditEvents, options?: {
-            syncUrl?: boolean;
-        }) => void;
-        removeFilter: (field?: string, options?: {
-            syncUrl?: boolean;
-        }) => void;
-        removeFilterByName: (name?: string, column?: string, options?: {
-            syncUrl?: boolean;
-        }) => void;
-        clearFilters: (options?: {
-            syncUrl?: boolean;
-        }) => void;
-        clearBasket: (options?: {
-            syncUrl?: boolean;
-        }) => void;
-        patch: (params: Partial<_sinequa_atomic.QueryParams>, audit?: _sinequa_atomic.AuditEvents, options?: {
-            syncUrl?: boolean;
-        }) => void;
-        getFilter: ({ field, name }: {
-            field: string | undefined;
-            name: string | undefined;
-        }) => Partial<_sinequa_atomic.LegacyFilter & {
-            count: number;
-        }> | null;
-        getQuery: () => _sinequa_atomic.Query;
-    } & _ngrx_signals.StateSource<{
-        name?: string | undefined;
-        text?: string | undefined;
-        action?: "" | "search" | "open" | "aggregate" | undefined;
-        select?: _sinequa_atomic.Select[] | undefined;
-        open?: _sinequa_atomic.Open[] | undefined;
-        page?: number | undefined;
-        pageSize?: number | undefined;
-        tab?: string | undefined;
-        scope?: string | undefined;
-        sort?: string | undefined;
-        basket?: string | undefined;
-        isFirstPage?: boolean | undefined;
-        strictRefine?: boolean | undefined;
-        globalRelevance?: number | undefined;
-        questionLanguage?: string | undefined;
-        questionDefaultLanguage?: string | undefined;
-        spellingCorrectionMode?: _sinequa_atomic.SpellingCorrectionMode | undefined;
-        spellingCorrectionFilter?: string | undefined;
-        documentWeight?: string | undefined;
-        textPartWeights?: string | undefined;
-        relevanceTransforms?: string | undefined;
-        removeDuplicates?: boolean | undefined;
-        queryId?: string | undefined;
-        aggregations?: (Record<string, _sinequa_atomic.AggregationOptions> | string[]) | undefined;
-        orderBy?: string | undefined;
-        groupBy?: string | undefined;
-        neuralSearch?: boolean | undefined;
-        path?: string | undefined;
-        filters: _sinequa_atomic.LegacyFilter[];
-        id?: string | undefined;
-    }>;
     aggregationsService: AggregationsService;
     /**
-     * Signal containing an array of extended filter objects.
+     * The overflow filters rendered as accordions: the authorized filters beyond the
+     * first `count` (which are already shown in the bar).
      *
      * @remarks
-     * This signal holds the current state of filters that can be applied to data.
-     * The filters are of type CFilterEx[], which extends the base filter functionality.
-     *
+     * Pure display wiring — authorization (and the admin `hidden` rule) is handled by
+     * {@link AggregationsService.getAuthorizedFilters}; `toSpliced` just drops the
+     * filters already shown in the bar.
      */
-    filters: _angular_core.WritableSignal<CFilterEx[]>;
-    /**
-     * Computed property that returns an array of filters that are currently visible.
-     * Filters out any filters where the `hidden` property is set to true.
-     *
-     * @returns An array of filters that are not hidden
-     */
-    visibleFilters: _angular_core.Signal<CFilterEx[]>;
-    constructor();
-    clearFilter(field: string): void;
-    updateFilters(): void;
-    /**
-     * Checks whether there are active filters for the current aggregation column.
-     *
-     * if True, the clear button is shown.
-     *
-     * @returns {boolean} `true` if the filter count for the aggregation column is greater than 0, otherwise `false`.
-     */
-    hasFilters(aggregation: Aggregation): boolean;
+    filters: _angular_core.Signal<{
+        field: string;
+        column: string;
+        name: string;
+    }[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MoreComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MoreComponent, "more, More", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "includedFilters": { "alias": "includedFilters"; "required": false; "isSignal": true; }; "excludedFilters": { "alias": "excludedFilters"; "required": false; "isSignal": true; }; "aggregations": { "alias": "aggregations"; "required": false; "isSignal": true; }; "homepage": { "alias": "homepage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -14208,7 +14202,7 @@ declare class RecentSearchesComponent {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -14397,7 +14391,7 @@ declare class SavedSearchesComponent {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -14492,7 +14486,7 @@ declare class UserProfileFormComponent {
         param9: _angular_core.Signal<string>;
         param10: _angular_core.Signal<string>;
         userOverrideActive: _angular_core.Signal<boolean>;
-        state: _angular_core.Signal<"error" | "initial" | "loading" | "loaded">;
+        state: _angular_core.Signal<"initial" | "loading" | "loaded" | "error">;
         allowUserOverride: _angular_core.Signal<boolean>;
         isOverridingUser: _angular_core.Signal<boolean>;
         initials: _angular_core.Signal<string>;
@@ -14536,7 +14530,7 @@ declare class UserProfileFormComponent {
         alerts: _angular_core.Signal<_sinequa_atomic_angular.Alert[]>;
         collapseAssistant?: _angular_core.Signal<boolean | undefined> | undefined;
         language?: _angular_core.Signal<string | undefined> | undefined;
-        userTheme: _angular_core.Signal<"dark" | "light" | "system" | undefined>;
+        userTheme: _angular_core.Signal<"light" | "dark" | "system" | undefined>;
         agents: _angular_core.Signal<_sinequa_atomic_angular.AgentUserSettings | undefined>;
         isDebugMode: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
@@ -15499,5 +15493,5 @@ type AppFeatures = {
  */
 declare const APP_FEATURES: InjectionToken<AppFeatures>;
 
-export { AGGREGATIONS_NAMES, AGGREGATIONS_NAMES_PRESET_DEFAULT, APP_FEATURES, AdvancedFiltersComponent, AdvancedSearch, AdvancedSearchComponent, AggregationComponent, AggregationDateComponent, AggregationDateRangeDialogComponent, AggregationListComponent, AggregationPanelComponent, AggregationTreeComponent, AggregationsService, AggregationsStore, Alert, AlertDialog, AlertsComponent, AppService, AppStore, ApplicationService, ApplicationStore, ArticleEntities, ArticleExtracts, ArticleLabels, ArticleSimilarDocuments, AsideFiltersComponent, AuditFeedbackType, AuditService, AuthGuard, AuthPageComponent, AutocompleteService, BOOKMARKS_CONFIG, BOOKMARKS_OPTIONS, BackdropComponent, BackdropService, BookmarkButtonComponent, BookmarksComponent, COLLECTIONS_CONFIG, COLLECTIONS_OPTIONS, COMPONENTS_FOR_DOCUMENT_TYPE, ChangePasswordComponent, ChildMarkerDirective, CollectionsComponent, CollectionsDialog, DRAWER_COMPONENT, DRAWER_STACK_MAX_COUNT, DateComponent, DeleteCollectionDialog, DidYouMeanComponent, DocumentLocatorComponent, DrawerAdvancedFiltersComponent, DrawerComponent, DrawerNavbarComponent, DrawerPreviewComponent, DrawerService, DrawerStackComponent, DrawerStackService, DropdownInputComponent, DropdownListComponent, ErrorComponent, ExportDialog, ExportService, FILTERS_BREAKPOINT, FILTER_DATE_ALLOW_CUSTOM_RANGE, FeatureFlagsDialogComponent, FeedbackDialogComponent, FileSizePipe, FilterButtonComponent, FiltersBarComponent, HIGHLIGHTS, HighlightWordPipe, InfinityScrollDirective, InlineWorker, JsonMethodPluginService, KeyboardNavigatorDirective, LabelService, LabelsEditDialog, LoadingComponent, MetadataComponent, MissingTermsComponent, MoreButtonComponent, MoreComponent, MultiSelectLabelsComponent, MultiSelectionToolbarComponent, NON_SEARCHABLE_COLUMNS, NON_SEARCHABLE_DEFAULTS, NavbarTabsComponent, NavigationService, NoResultComponent, OpenArticleOnCtrlEnterDirective, OperatorPipe, OverflowItemDirective, OverflowManagerDirective, OverflowStopDirective, OverrideUserDialogComponent, PREVIEW_CONFIG, PagerComponent, PreviewNavigator, PreviewService, PrincipalService, PrincipalStore, QueryParamsStore, QueryService, RECENT_SEARCHES_CONFIG, RECENT_SEARCHES_OPTIONS, ROUTE_COMPONENTS, RecentSearchesComponent, ResetUserSettingsDialogComponent, SAVED_SEARCHES_CONFIG, SAVED_SEARCHES_OPTIONS, SavedSearchDialog, SavedSearchesComponent, SavedSearchesService, SearchFeedbackComponent, SearchInputFooter, SearchService, SelectArticleDirective, SelectArticleOnClickDirective, SelectionHistoryService, SelectionService, SelectionStore, ShowBookmarkDirective, SidebarNavComponent, SignInComponent, SignedOutComponent, SortSelectorComponent, SourceComponent, SourceIconPipe, SponsoredResultsComponent, SyslangPipe, THEMES, TextChunkService, ThemeProviderDirective, ThemeSelectorComponent, ThemeStore, ThemeToggleComponent, TranslocoDateImpurePipe, UserProfileDialog, UserProfileFormComponent, UserProfileService, UserSettingsStore, applyThemeToNativeElement, auditInterceptorFn, authInterceptorFn, bodyInterceptorFn, bootstrapApp, buildQuery, debouncedSignal, errorInterceptorFn, getCurrentPath, getCurrentQueryName, getQueryNameFromRoute, injectRouteNavigation, processCssVars, queryNameResolver, signIn, themeColorNameToCssVariable, themeColorsToCssVariables, toastInterceptorFn, withAggregationsFeatures, withAlertsFeatures, withAppFeatures, withApplicationFeatures, withAssistantFeatures, withBasketsFeatures, withBookmarkFeatures, withBootstrapApp, withExtractsFeatures, withFetch, withMultiSelectionFeatures, withPrincipalFeatures, withQueryParamsFeatures, withRecentSearchesFeatures, withSavedSearchesFeatures, withSelectionFeatures, withThemeBodyHook, withThemes, withThemesFeatures, withUserSettingsFeatures };
-export type { AgentUserSettings, AggEx, AggregationEx, AggregationListEx, AggregationListItem, AggregationTitle, AggregationTreeEx, AggregationsState, AppCJson, AppFeatures, ApplicationState, ArticleMetadata, AssistantDetails, Autocomplete, Basket, Bookmark, BookmarksConfig, CAggregation, CAggregationItem, CCAppState, CCWebServiceLabels, CConverter, CFeedback, CFilter, CFilterEx, CFilterItem, CJ, CJson, CJsonMint, CSources, CollectionsConfig, ComponentMapping, CssVars, DateRange, DocumentOffsets, DocumentPages, DocumentTypeMap, DropdownItem, ExportQueryOptions, Extract, FilterDropdown, KeyboardNavigationOnSelectionHandlers, KeyboardNavigatorOptions, LabelsConfig, MultiSelectionState, MultiSelectionToolbarVariants, NavRouteTab, PageConfiguration, PreviewEvents, PreviewHighlight, PreviewHighlightName, PreviewHighlights, PrincipalState, SearchItem, SearchOptions, SearchesConfig, SelectionHistoryEvent, SelectionState, SelectionStrategy, SideCJson, SortingChoice, Theme, ThemeBodyHookParameters, ThemeScope, ThemeStoreState, UserSettingsState };
+export { AGGREGATIONS_NAMES, AGGREGATIONS_NAMES_PRESET_DEFAULT, APP_FEATURES, AdvancedFiltersComponent, AdvancedSearch, AdvancedSearchComponent, AggregationComponent, AggregationDateComponent, AggregationDateRangeDialogComponent, AggregationItemDirective, AggregationListComponent, AggregationPanelComponent, AggregationTreeComponent, AggregationsService, AggregationsStore, Alert, AlertDialog, AlertsComponent, AppService, AppStore, ApplicationService, ApplicationStore, ArticleEntities, ArticleExtracts, ArticleLabels, ArticleSimilarDocuments, AsideFiltersComponent, AuditFeedbackType, AuditService, AuthGuard, AuthPageComponent, AutocompleteService, BOOKMARKS_CONFIG, BOOKMARKS_OPTIONS, BackdropComponent, BackdropService, BookmarkButtonComponent, BookmarksComponent, COLLECTIONS_CONFIG, COLLECTIONS_OPTIONS, COMPONENTS_FOR_DOCUMENT_TYPE, ChangePasswordComponent, ChildMarkerDirective, CollectionsComponent, CollectionsDialog, DRAWER_COMPONENT, DRAWER_STACK_MAX_COUNT, DateComponent, DeleteCollectionDialog, DidYouMeanComponent, DocumentLocatorComponent, DrawerAdvancedFiltersComponent, DrawerComponent, DrawerNavbarComponent, DrawerPreviewComponent, DrawerService, DrawerStackComponent, DrawerStackService, DropdownInputComponent, DropdownListComponent, ErrorComponent, ExportDialog, ExportService, FILTERS_BREAKPOINT, FILTER_DATE_ALLOW_CUSTOM_RANGE, FeatureFlagsDialogComponent, FeedbackDialogComponent, FileSizePipe, FilterButtonComponent, FiltersBarComponent, HIGHLIGHTS, HighlightWordPipe, InfinityScrollDirective, InlineWorker, JsonMethodPluginService, KeyboardNavigatorDirective, LabelService, LabelsEditDialog, LoadingComponent, MetadataComponent, MissingTermsComponent, MoreButtonComponent, MoreComponent, MultiSelectLabelsComponent, MultiSelectionToolbarComponent, NON_SEARCHABLE_COLUMNS, NON_SEARCHABLE_DEFAULTS, NavbarTabsComponent, NavigationService, NoResultComponent, OpenArticleOnCtrlEnterDirective, OperatorPipe, OverflowItemDirective, OverflowManagerDirective, OverflowStopDirective, OverrideUserDialogComponent, PREVIEW_CONFIG, PagerComponent, PreviewNavigator, PreviewService, PrincipalService, PrincipalStore, QueryParamsStore, QueryService, RECENT_SEARCHES_CONFIG, RECENT_SEARCHES_OPTIONS, ROUTE_COMPONENTS, RecentSearchesComponent, ResetUserSettingsDialogComponent, SAVED_SEARCHES_CONFIG, SAVED_SEARCHES_OPTIONS, SavedSearchDialog, SavedSearchesComponent, SavedSearchesService, SearchFeedbackComponent, SearchInputFooter, SearchService, SelectArticleDirective, SelectArticleOnClickDirective, SelectionHistoryService, SelectionService, SelectionStore, ShowBookmarkDirective, SidebarNavComponent, SignInComponent, SignedOutComponent, SortSelectorComponent, SourceComponent, SourceIconPipe, SponsoredResultsComponent, SyslangPipe, THEMES, TextChunkService, ThemeProviderDirective, ThemeSelectorComponent, ThemeStore, ThemeToggleComponent, TranslocoDateImpurePipe, UserProfileDialog, UserProfileFormComponent, UserProfileService, UserSettingsStore, applyThemeToNativeElement, auditInterceptorFn, authInterceptorFn, bodyInterceptorFn, bootstrapApp, buildQuery, debouncedSignal, errorInterceptorFn, getCurrentPath, getCurrentQueryName, getQueryNameFromRoute, injectRouteNavigation, legacyFilterToFilter, processCssVars, queryNameResolver, signIn, themeColorNameToCssVariable, themeColorsToCssVariables, toastInterceptorFn, withAggregationsFeatures, withAlertsFeatures, withAppFeatures, withApplicationFeatures, withAssistantFeatures, withBasketsFeatures, withBookmarkFeatures, withBootstrapApp, withExtractsFeatures, withFetch, withMultiSelectionFeatures, withPrincipalFeatures, withQueryParamsFeatures, withRecentSearchesFeatures, withSavedSearchesFeatures, withSelectionFeatures, withThemeBodyHook, withThemes, withThemesFeatures, withUserSettingsFeatures };
+export type { AgentUserSettings, AggEx, AggregationEx, AggregationItemContext, AggregationListEx, AggregationListItem, AggregationSelection, AggregationTitle, AggregationTreeEx, AggregationTreeItemContext, AggregationsState, AppCJson, AppFeatures, ApplicationState, ArticleMetadata, AssistantDetails, Autocomplete, Basket, Bookmark, BookmarksConfig, CAggregation, CAggregationItem, CCAppState, CCWebServiceLabels, CConverter, CFeedback, CFilter, CFilterEx, CFilterItem, CJ, CJson, CJsonMint, CSources, CollectionsConfig, ComponentMapping, CssVars, DateRange, DocumentOffsets, DocumentPages, DocumentTypeMap, DropdownItem, ExportQueryOptions, Extract, FilterDropdown, KeyboardNavigationOnSelectionHandlers, KeyboardNavigatorOptions, LabelsConfig, MultiSelectionState, MultiSelectionToolbarVariants, NavRouteTab, PageConfiguration, PreviewEvents, PreviewHighlight, PreviewHighlightName, PreviewHighlights, PrincipalState, SearchItem, SearchOptions, SearchesConfig, SelectionHistoryEvent, SelectionState, SelectionStrategy, SideCJson, SortingChoice, Theme, ThemeBodyHookParameters, ThemeScope, ThemeStoreState, UserSettingsState };