@arsedizioni/ars-utils 21.2.295 → 21.2.297

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "21.2.295",
+  "version": "21.2.297",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1020,7 +1020,7 @@ declare class ClipperDocumentMenuComponent {
     /** Internal counter incremented on each external selection-model change to drive signal re-evaluation. */
     private readonly selectionChangeTick;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"selection" | "none" | "bag">;
+    readonly selectionSource: _angular_core.InputSignal<"bag" | "selection" | "none">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

package/types/arsedizioni-ars-utils-core.d.ts

@@ -368,6 +368,12 @@ declare class SystemUtils {
      * @returns : the string UUID
      */
     static generateUUID(): string;
+    /**
+     * Reconstruct a standard UUID (with dashes) from a 32-char hex string without dashes.
+     * @param value : 32-character hex string
+     * @returns     : the formatted UUID or the original string if it doesn't match the expected format
+     */
+    static inflateUUID(value: string): string;
     /**
      * Parse a text and return true if is a valid email or null
      * @param value : email

package/types/arsedizioni-ars-utils-ui.application.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy, AfterContentInit, DoCheck, ElementRef } from '@angular/core';
+import { OnInit, OnDestroy, DoCheck, ElementRef } from '@angular/core';
 import { Searchable, SearchBag, NameValueItem, DateInterval, SearchFilterMetadata, FileInfo } from '@arsedizioni/ars-utils/core';
 import { MatFormFieldAppearance, MatFormFieldControl } from '@angular/material/form-field';
 import { MatDialogRef } from '@angular/material/dialog';
@@ -853,7 +853,7 @@ declare class ArsUIApplicationModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<ArsUIApplicationModule>;
 }
 
-declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValueAccessor {
+declare class ButtonSelectorComponent implements OnDestroy, ControlValueAccessor {
     ngControl: NgControl;
     /** Emitted whenever the selected value changes (including programmatic resets). */
     readonly changed: _angular_core.OutputEmitterRef<NameValueItem<any>>;
@@ -863,17 +863,21 @@ declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValue
     private focused;
     private _value;
     set value(value: NameValueItem<any> | undefined);
+    /** The current value as the selected item. */
     get value(): NameValueItem<any> | undefined;
-    private _disabled;
+    /** @internal Input signal for the disabled state (bound via the `[disabled]` attribute). */
+    protected readonly _disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** @internal Internal signal tracking the current disabled state. */
+    private readonly _disabled;
+    /** True when the control is disabled, either via `[disabled]` input or via the Angular form layer. */
     get disabled(): boolean;
-    set disabled(value: boolean);
     private propagateChange;
     private propagateTouched;
     id: string;
     describedBy: string;
-    private renderer;
+    private readonly renderer;
     /** Currently selected item, kept in sync with the form control value. */
-    protected current: _angular_core.WritableSignal<NameValueItem<any>>;
+    protected readonly current: _angular_core.WritableSignal<NameValueItem<any>>;
     /** Width of the trigger button in pixels. Use `-1` for 100 %, `0` for `auto`. */
     readonly width: _angular_core.InputSignal<number>;
     /** Border thickness override. Use `-1` to inherit. */
@@ -889,7 +893,6 @@ declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValue
     /** When `true`, the first available option is pre-selected on init. */
     readonly autoSelect: _angular_core.InputSignal<boolean>;
     constructor(ngControl: NgControl);
-    ngOnInit(): void;
     ngOnDestroy(): void;
     /**
      * Writes a new value to the component (called by the form layer).
@@ -906,8 +909,19 @@ declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValue
      * @param fn - Callback to invoke when the control is touched.
      */
     registerOnTouched(fn: () => void): void;
+    /**
+     * Sets the ARIA described-by IDs for accessibility.
+     * @param ids - The list of element IDs to associate with this control.
+     */
     setDescribedByIds(ids: string[]): void;
-    setDisabledState?(isDisabled: boolean): void;
+    /**
+     * Updates the disabled state when the Angular form layer changes it.
+     * @param isDisabled - Whether the control should be disabled.
+     */
+    setDisabledState(isDisabled: boolean): void;
+    /**
+     * Handles a click on the container element, focusing it and marking it as touched.
+     */
     onContainerClick(): void;
     /**
      * Selects an option and optionally emits the `selected` output event.
@@ -918,7 +932,7 @@ declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValue
     /** Clears the current selection and resets the control to an empty state. */
     reset(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonSelectorComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonSelectorComponent, "button-selector", never, { "disabled": { "alias": "disabled"; "required": false; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "border": { "alias": "border"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelSelected": { "alias": "labelSelected"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "autoSelect": { "alias": "autoSelect"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "selected": "selected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonSelectorComponent, "button-selector", never, { "_disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "border": { "alias": "border"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelSelected": { "alias": "labelSelected"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "autoSelect": { "alias": "autoSelect"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "selected": "selected"; }, never, never, true, never>;
 }
 
 interface ButtonToggleInfo {
@@ -928,8 +942,6 @@ interface ButtonToggleInfo {
 declare class ButtonToggleComponent {
     /** Emitted each time the button is clicked. Carries the current `value` and the new `toggled` state. */
     readonly changed: _angular_core.OutputEmitterRef<ButtonToggleInfo>;
-    /** Tracks whether the button has been toggled (opposite of the current `value` input). */
-    protected readonly toggled: _angular_core.WritableSignal<boolean>;
     /** Current value bound from the parent. Drives label and icon selection. */
     readonly value: _angular_core.InputSignal<boolean>;
     /** Width of the button in pixels. Use `-1` for automatic sizing. */
@@ -974,12 +986,12 @@ declare class CalendarEmptyHeader<D> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CalendarEmptyHeader<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentInit, ControlValueAccessor {
+declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor {
     ngControl: NgControl;
     /** Emitted when the selection changes. Carries the new array of selected items, or `undefined` when cleared. */
     readonly changed: _angular_core.OutputEmitterRef<NameValueItem<any>[]>;
     protected readonly containerId: string;
-    protected containerWidth: _angular_core.WritableSignal<number>;
+    protected readonly containerWidth: _angular_core.WritableSignal<number>;
     private focused;
     private readonly stateChanges;
     private readonly destroyRef;
@@ -1007,34 +1019,37 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
     readonly stacked: _angular_core.InputSignal<boolean>;
     /** Chips below this index receive extra padding to align with other UI elements. */
     readonly padAt: _angular_core.InputSignal<number>;
+    /** When `true`, the control is required. */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Placeholder text shown when no value is selected. */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** @internal Input signal for the disabled state (bound via the `[disabled]` attribute). */
+    protected readonly _disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** @internal Internal signal tracking the current disabled state (updated by the form layer and the input). */
+    private readonly _disabled;
+    /** True when the control is disabled, either via `[disabled]` input or via the Angular form layer. */
+    get disabled(): boolean;
+    id: string;
+    describedBy: string;
+    /** True when the label should float above the field (focused or has a value). */
+    get shouldLabelFloat(): boolean;
     private _value?;
     set value(value: NameValueItem<any>[] | undefined);
+    /** The current value as an array of selected items. */
     get value(): NameValueItem<any>[] | undefined;
+    /** True when no item is selected. */
     get empty(): boolean;
+    /** True when the control has validation errors and has been touched. */
     get errorState(): boolean;
-    private _required;
-    get required(): boolean;
-    set required(value: boolean);
-    private _disabled;
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private _placeholder;
-    get placeholder(): string;
-    set placeholder(value: string);
     private propagateChange;
     private propagateTouched;
-    id: string;
-    get shouldLabelFloat(): boolean;
-    describedBy: string;
-    private renderer;
+    private readonly renderer;
     /** Currently selected items (may contain multiple entries when `multiple` is `true`). */
     protected selection: NameValueItem<any>[];
     /** The single selected item — used in `button` collapsed-display mode. */
     protected singleSelection?: NameValueItem<any>;
     constructor(ngControl: NgControl);
-    ngOnInit(): void;
     ngOnDestroy(): void;
-    ngAfterContentInit(): void;
     /**
      * Measures the container (or window) width and updates the `containerWidth` signal,
      * retrying after 100 ms if the element is not yet laid out.
@@ -1054,6 +1069,7 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
      * Returns `true` when the given item can be selected in the current mode.
      * In single-select mode an already-selected item is not re-selectable.
      * @param item - The item to check.
+     * @returns True when the item is selectable.
      */
     isSelectable(item: NameValueItem<any>): boolean;
     /**
@@ -1071,8 +1087,19 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
      * @param fn - Callback to invoke when the control is touched.
      */
     registerOnTouched(fn: () => void): void;
+    /**
+     * Sets the ARIA described-by IDs for accessibility.
+     * @param ids - The list of element IDs to associate with this control.
+     */
     setDescribedByIds(ids: string[]): void;
-    setDisabledState?(isDisabled: boolean): void;
+    /**
+     * Updates the disabled state when the Angular form layer changes it.
+     * @param isDisabled - Whether the control should be disabled.
+     */
+    setDisabledState(isDisabled: boolean): void;
+    /**
+     * Handles a click on the container element, focusing it and marking it as touched.
+     */
     onContainerClick(): void;
     /**
      * Clears the current selection and stops the event from bubbling.
@@ -1085,12 +1112,13 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
      */
     select(item?: NameValueItem<any>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChipsSelectorComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChipsSelectorComponent, "chips-selector", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; "collapsedDisplayMode": { "alias": "collapsedDisplayMode"; "required": false; "isSignal": true; }; "collapseAt": { "alias": "collapseAt"; "required": false; "isSignal": true; }; "collapseAtContainer": { "alias": "collapseAtContainer"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "mustSelect": { "alias": "mustSelect"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "padAt": { "alias": "padAt"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; }, { "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChipsSelectorComponent, "chips-selector", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; "collapsedDisplayMode": { "alias": "collapsedDisplayMode"; "required": false; "isSignal": true; }; "collapseAt": { "alias": "collapseAt"; "required": false; "isSignal": true; }; "collapseAtContainer": { "alias": "collapseAtContainer"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "mustSelect": { "alias": "mustSelect"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "padAt": { "alias": "padAt"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "_disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
 }
 
-declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormFieldControl<FileInfo>, ControlValueAccessor {
+declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldControl<FileInfo>, ControlValueAccessor {
     ngControl: NgControl;
-    __file: ElementRef;
+    /** Reference to the hidden native file input element. */
+    protected readonly __file: _angular_core.Signal<ElementRef<any>>;
     private readonly renderer;
     private readonly uiService;
     static nextId: number;
@@ -1102,29 +1130,42 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormF
     protected readonly canCapture: _angular_core.WritableSignal<boolean>;
     /** Size in MB of the currently selected file. */
     protected readonly fileSize: _angular_core.WritableSignal<number>;
-    private readonly _placeholder;
+    /** Internal placeholder text, derived from the input and camera availability. */
+    protected readonly _placeholder: _angular_core.WritableSignal<string>;
     private _value;
     set value(value: FileInfo);
+    /** The current FileInfo value. */
     get value(): FileInfo;
-    get size(): any;
-    private _required;
-    get required(): boolean;
-    set required(value: boolean);
-    private _disabled;
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    get placeholder(): string;
-    set placeholder(value: string);
-    fileName?: string;
+    /** Size of the current file in bytes. */
+    get size(): number | undefined;
+    /** The currently displayed file name. Can be bound from outside or updated by file selection. */
+    readonly fileName: _angular_core.ModelSignal<string>;
     readonly maxSizeMb: _angular_core.InputSignal<number>;
     readonly minSizeMb: _angular_core.InputSignal<number>;
     readonly isNew: _angular_core.InputSignal<boolean>;
     readonly canPreview: _angular_core.InputSignal<boolean>;
     readonly appearance: _angular_core.InputSignal<"fill" | "outline">;
     readonly accept: _angular_core.InputSignal<string>;
+    /** @internal Input signal for the required state (bound via the `[required]` attribute). */
+    protected readonly _requiredInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** True when the control is required (implements `MatFormFieldControl.required`). */
+    get required(): boolean;
+    /** @internal Input signal for the placeholder text (bound via the `[placeholder]` attribute). */
+    protected readonly _placeholderInput: _angular_core.InputSignal<string>;
+    /** The effective placeholder label shown in the form field (implements `MatFormFieldControl.placeholder`). */
+    get placeholder(): string;
+    /** @internal Input signal for the disabled state (bound via the `[disabled]` attribute). */
+    protected readonly _disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** @internal Internal signal tracking the current disabled state. */
+    private readonly _disabled;
+    /** True when the control is disabled, either via `[disabled]` input or via the Angular form layer. */
+    get disabled(): boolean;
+    /** True when no file is selected. */
     get empty(): boolean;
+    /** True when the control has validation errors and has been touched. */
     get errorState(): boolean;
     id: string;
+    /** True when the label should float above the field. */
     get shouldLabelFloat(): boolean;
     describedBy: string;
     readonly changed: _angular_core.OutputEmitterRef<FileInfo>;
@@ -1133,13 +1174,12 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormF
     private propagateChange;
     private propagateTouched;
     constructor(ngControl: NgControl);
-    ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    ngDoCheck(): void;
     /**
-     * Detects camera availability and updates the placeholder accordingly.
+     * Detects camera availability and sets the default placeholder when none is explicitly provided.
      */
     private setupDevices;
-    ngOnDestroy(): void;
-    ngDoCheck(): void;
     /**
      * Writes a new value to the component (called by the form layer).
      * @param value - The new file info to display.
@@ -1161,10 +1201,10 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormF
      */
     setDescribedByIds(ids: string[]): void;
     /**
-     * Updates the disabled state of the underlying native element.
+     * Updates the disabled state when the Angular form layer changes it.
      * @param isDisabled - Whether the control should be disabled.
      */
-    setDisabledState?(isDisabled: boolean): void;
+    setDisabledState(isDisabled: boolean): void;
     /** Focuses the native input element and marks the control as touched. */
     onContainerClick(): void;
     /**
@@ -1194,7 +1234,7 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormF
      */
     protected previewFile(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileInputComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileInputComponent, "file-input", never, { "required": { "alias": "required"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "fileName": { "alias": "fileName"; "required": false; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "isNew": { "alias": "isNew"; "required": false; "isSignal": true; }; "canPreview": { "alias": "canPreview"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "download": "download"; "preview": "preview"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileInputComponent, "file-input", never, { "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "isNew": { "alias": "isNew"; "required": false; "isSignal": true; }; "canPreview": { "alias": "canPreview"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "_requiredInput": { "alias": "required"; "required": false; "isSignal": true; }; "_placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "_disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "fileName": "fileNameChange"; "changed": "changed"; "download": "download"; "preview": "preview"; }, never, never, true, never>;
 }
 
 interface FilePreviewDialogData {
@@ -1226,16 +1266,14 @@ declare class FilePreviewComponent {
 }
 
 declare class FilterBarComponent {
+    /** Emitted whenever any filter value changes. */
     readonly changed: _angular_core.OutputEmitterRef<CurrentFilterChanged>;
-    readonly filters: _angular_core.InputSignal<any>;
-    readonly canFilterByFlt1: _angular_core.WritableSignal<boolean>;
-    readonly canFilterByFlt2: _angular_core.WritableSignal<boolean>;
-    readonly canFilterByFlt3: _angular_core.WritableSignal<boolean>;
-    readonly canFilterByFlt4: _angular_core.WritableSignal<boolean>;
-    readonly canFilterByFlt5: _angular_core.WritableSignal<boolean>;
+    /** The list of filter groups to display. */
+    readonly filters: _angular_core.InputSignal<FilterGroup[]>;
     readonly canFilterByText: _angular_core.InputSignal<boolean>;
     readonly canFilterByText2: _angular_core.InputSignal<boolean>;
     readonly canFilterByText3: _angular_core.InputSignal<boolean>;
+    /** Initial text values for the search inputs — synced into the model signals on change. */
     readonly initialText: _angular_core.InputSignal<string>;
     readonly initialText2: _angular_core.InputSignal<string>;
     readonly initialText3: _angular_core.InputSignal<string>;
@@ -1247,17 +1285,36 @@ declare class FilterBarComponent {
     readonly text3Length: _angular_core.InputSignal<string>;
     readonly showTextSearchButton: _angular_core.InputSignal<boolean>;
     readonly appearance: _angular_core.InputSignal<"fill" | "outline">;
-    protected text?: string;
-    protected text2?: string;
-    protected text3?: string;
-    protected flt1: FilterGroup | undefined;
-    protected flt2: FilterGroup | undefined;
-    protected flt3: FilterGroup | undefined;
-    protected flt4: FilterGroup | undefined;
-    protected flt5: FilterGroup | undefined;
+    /** Two-way bindable text filter values. */
+    protected readonly text: _angular_core.ModelSignal<string>;
+    protected readonly text2: _angular_core.ModelSignal<string>;
+    protected readonly text3: _angular_core.ModelSignal<string>;
+    /** Filter group for slot 1, derived reactively from the `filters` input. */
+    protected readonly flt1: _angular_core.Signal<FilterGroup>;
+    /** Filter group for slot 2, derived reactively from the `filters` input. */
+    protected readonly flt2: _angular_core.Signal<FilterGroup>;
+    /** Filter group for slot 3, derived reactively from the `filters` input. */
+    protected readonly flt3: _angular_core.Signal<FilterGroup>;
+    /** Filter group for slot 4, derived reactively from the `filters` input. */
+    protected readonly flt4: _angular_core.Signal<FilterGroup>;
+    /** Filter group for slot 5, derived reactively from the `filters` input. */
+    protected readonly flt5: _angular_core.Signal<FilterGroup>;
+    /** True when filter slot 1 has an action or item list. */
+    protected readonly canFilterByFlt1: _angular_core.Signal<boolean>;
+    /** True when filter slot 2 has an action or item list. */
+    protected readonly canFilterByFlt2: _angular_core.Signal<boolean>;
+    /** True when filter slot 3 has an action or item list. */
+    protected readonly canFilterByFlt3: _angular_core.Signal<boolean>;
+    /** True when filter slot 4 has an action or item list. */
+    protected readonly canFilterByFlt4: _angular_core.Signal<boolean>;
+    /** True when filter slot 5 has an action or item list. */
+    protected readonly canFilterByFlt5: _angular_core.Signal<boolean>;
     readonly currentFilter: CurrentFilter;
     constructor();
-    /** Reads the `filters` input and populates the filter group fields and capability signals. */
+    /**
+     * No-op kept for API compatibility.
+     * Filter groups are now computed reactively from the `filters()` input.
+     */
     initializeFilters(): void;
     /**
      * Applies the selected filter item to the current filter state and emits the change.
@@ -1281,17 +1338,19 @@ declare class FilterBarComponent {
     clearAllFilters(): void;
     /**
      * Returns `true` when more than one filter type is active, showing the "clear all" button.
+     * @returns True when the clear-all button should be visible.
      */
     canClearAllFilters(): boolean;
     /**
      * Returns the filter group matching the given id, or `undefined` if not found.
      * @param id - The group id to look up.
+     * @returns The matching `FilterGroup`, or `undefined`.
      */
     private getFilterGroup;
     /** Synchronises the filter bar display with the values currently stored in `currentFilter`. */
     syncFilter(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterBarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "filter-bar", never, { "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "canFilterByText": { "alias": "canFilterByText"; "required": false; "isSignal": true; }; "canFilterByText2": { "alias": "canFilterByText2"; "required": false; "isSignal": true; }; "canFilterByText3": { "alias": "canFilterByText3"; "required": false; "isSignal": true; }; "initialText": { "alias": "initialText"; "required": false; "isSignal": true; }; "initialText2": { "alias": "initialText2"; "required": false; "isSignal": true; }; "initialText3": { "alias": "initialText3"; "required": false; "isSignal": true; }; "textName": { "alias": "textName"; "required": false; "isSignal": true; }; "text2Name": { "alias": "text2Name"; "required": false; "isSignal": true; }; "text3Name": { "alias": "text3Name"; "required": false; "isSignal": true; }; "textLength": { "alias": "textLength"; "required": false; "isSignal": true; }; "text2Length": { "alias": "text2Length"; "required": false; "isSignal": true; }; "text3Length": { "alias": "text3Length"; "required": false; "isSignal": true; }; "showTextSearchButton": { "alias": "showTextSearchButton"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "filter-bar", never, { "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "canFilterByText": { "alias": "canFilterByText"; "required": false; "isSignal": true; }; "canFilterByText2": { "alias": "canFilterByText2"; "required": false; "isSignal": true; }; "canFilterByText3": { "alias": "canFilterByText3"; "required": false; "isSignal": true; }; "initialText": { "alias": "initialText"; "required": false; "isSignal": true; }; "initialText2": { "alias": "initialText2"; "required": false; "isSignal": true; }; "initialText3": { "alias": "initialText3"; "required": false; "isSignal": true; }; "textName": { "alias": "textName"; "required": false; "isSignal": true; }; "text2Name": { "alias": "text2Name"; "required": false; "isSignal": true; }; "text3Name": { "alias": "text3Name"; "required": false; "isSignal": true; }; "textLength": { "alias": "textLength"; "required": false; "isSignal": true; }; "text2Length": { "alias": "text2Length"; "required": false; "isSignal": true; }; "text3Length": { "alias": "text3Length"; "required": false; "isSignal": true; }; "showTextSearchButton": { "alias": "showTextSearchButton"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "text2": { "alias": "text2"; "required": false; "isSignal": true; }; "text3": { "alias": "text3"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "text": "textChange"; "text2": "text2Change"; "text3": "text3Change"; }, never, never, true, never>;
 }
 
 export { ApplicationDialogService, ArsUIApplicationModule, ButtonSelectorComponent, ButtonToggleComponent, CalendarEmptyHeader, ChipsSelectorComponent, CurrentFilter, CurrentFilterChanged, CurrentFilterItem, FileInputComponent, FilePreviewComponent, FilterBarComponent, Filters, ItemNode, PromptDateDialogComponent, PromptDialogComponent, PromptDialogType, PromptOtpDialogComponent, PromptTimeDialogComponent, ResizeTableColumnDirective, SelectDialogComponent, SelectFileDialogComponent, SelectPictureDialogComponent, SelectTreeDialogComponent, SelectableItem, SelectableNode, SendToDialogComponent, TreeDataSource };