@arsedizioni/ars-utils 21.2.208 → 21.2.220

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

@@ -1,30 +1,43 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy, DoCheck, OnChanges, ElementRef, SimpleChanges, AfterContentInit } from '@angular/core';
-import { NgForm, ControlValueAccessor, NgControl } from '@angular/forms';
+import { OnInit, OnDestroy, DoCheck, ElementRef, AfterContentInit } 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';
+import { DialogService } from '@arsedizioni/ars-utils/ui';
 import { FlatTreeControl } from '@angular/cdk/tree';
 import { MatTreeFlatDataSource } from '@angular/material/tree';
 import { BehaviorSubject, Subject } from 'rxjs';
+import { NgForm, ControlValueAccessor, NgControl } from '@angular/forms';
 import { MatCheckboxChange } from '@angular/material/checkbox';
 import { MatSelectionList, MatSelectionListChange } from '@angular/material/list';
 import { MatPaginator, PageEvent } from '@angular/material/paginator';
-import { MatDialogRef } from '@angular/material/dialog';
-import { DialogService } from '@arsedizioni/ars-utils/ui';
 
-declare class ResizeTableColumnDirective implements OnInit {
+declare class ResizeTableColumnDirective {
+    /** Whether this column is resizable. Bound via the `resizeColumn` attribute. */
     readonly resizable: _angular_core.InputSignal<boolean>;
+    /** Zero-based index of this column in the table, used to resize body cells. */
     readonly index: _angular_core.InputSignal<number>;
     private readonly renderer;
     private readonly elementRef;
     private startX;
     private startWidth;
-    private column;
+    private readonly column;
     private table;
     private pressed;
-    ngOnInit(): void;
+    constructor();
+    /**
+     * Record the drag start position and initial column width.
+     * @param e - The mousedown event.
+     */
     onMouseDown: (e: MouseEvent) => void;
+    /**
+     * Resize the column header and all body cells while dragging.
+     * @param e - The mousemove event.
+     */
     onMouseMove: (e: MouseEvent) => void;
+    /**
+     * End the drag and remove the resizing CSS class from the table.
+     */
     onMouseUp: () => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ResizeTableColumnDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ResizeTableColumnDirective, "[resizeColumn]", never, { "resizable": { "alias": "resizeColumn"; "required": false; "isSignal": true; }; "index": { "alias": "index"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -40,24 +53,27 @@ interface SendToDialogData {
     appearance?: MatFormFieldAppearance;
     options?: any;
 }
-declare class SendToDialogComponent implements OnInit {
+declare class SendToDialogComponent {
+    /** Emitted when the user confirms and sends the message. */
     readonly done: _angular_core.OutputEmitterRef<SendToDialogResult>;
+    /** Emitted when the user requests to populate the recipient list. */
     readonly populate: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    private changeDetector;
-    protected dialogData: SendToDialogData;
+    /** Dialog configuration, injected and exposed as a signal. */
+    protected readonly dialogData: _angular_core.WritableSignal<SendToDialogData>;
+    /** Form model for the send-to form fields. */
     protected item: SendToDialogResult;
-    ngOnInit(): void;
     /**
-     * Submit
+     * Confirm the form and emit the result.
      */
     protected ok(): void;
     /**
-     * Populate recipients
+     * Request the host to populate the recipient list.
+     * Only emits if `canPopulate` is enabled in the dialog data.
      */
     protected populateRecipients(): void;
     /**
-     * Update recipients
-     * @param recipients the new recipients value
+     * Update the recipient list from an external caller.
+     * @param recipients - The new recipients string (semicolon-separated).
      */
     updateRecipients(recipients: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SendToDialogComponent, never>;
@@ -175,9 +191,7 @@ interface ISelectableItem extends Searchable {
 declare class SelectableItem implements ISelectableItem {
     bag: any;
     template: string;
-    /**
-     * Searchable
-     */
+    /** Searchable index bag. */
     searchBag: SearchBag;
 }
 declare class ItemNode {
@@ -191,10 +205,13 @@ declare class ItemNode {
 declare class SelectableNode extends ItemNode implements Searchable {
     expandable: boolean;
     level: number;
+    /** Searchable index bag. */
+    searchBag: SearchBag;
     /**
-     * Searchable
+     * Create a flattened tree node from a source ItemNode.
+     * @param item - The source tree node.
+     * @param level - The depth level of this node in the tree.
      */
-    searchBag: SearchBag;
     constructor(item: ItemNode, level: number);
 }
 interface SendToPopulateData {
@@ -202,9 +219,9 @@ interface SendToPopulateData {
     source: SendToDialogComponent;
 }
 interface SendToDialogResult {
-    recipients: string;
-    subject: string;
-    text: string;
+    recipients: string | null;
+    subject: string | undefined;
+    text: string | undefined;
     options?: any;
 }
 interface PromptDialogResult {
@@ -246,6 +263,7 @@ interface PromptTimeDialogData extends PromptDialogData {
     slots?: string;
 }
 
+/** Constants identifying each filter group slot and text filter channels. */
 declare const Filters: {
     FLT_1: number;
     FLT_2: number;
@@ -257,6 +275,7 @@ declare const Filters: {
     FLT_TEXT_2: number;
     FLT_TEXT_3: number;
 };
+/** Describes a top-level filter group with optional items or a custom action. */
 interface FilterGroup {
     group?: number;
     title?: string;
@@ -264,6 +283,7 @@ interface FilterGroup {
     items?: FilterItem[];
     action?: any;
 }
+/** A single selectable entry within a FilterGroup. */
 interface FilterItem {
     group?: number;
     title?: string;
@@ -272,10 +292,14 @@ interface FilterItem {
     divider?: boolean;
     value?: any;
 }
+/** Event payload emitted when an active filter changes. */
 declare class CurrentFilterChanged {
+    /** The updated filter state. */
     filter: CurrentFilter;
+    /** The group slot that changed (see Filters constants). */
     group: number;
 }
+/** Holds the current state of all active filters for a filter-bar component. */
 declare class CurrentFilter {
     flt1?: any;
     flt1Name?: string;
@@ -291,16 +315,21 @@ declare class CurrentFilter {
     text2?: string;
     text3?: string;
     /**
-     * Update filtered value
+     * Returns true if any filter slot or text field is currently active.
+     * @returns Whether at least one filter is applied.
      */
     filtered(): boolean;
 }
+/** Holds the selected value and display state for a single typed filter slot. */
 declare class CurrentFilterItem<T> {
     items?: any[];
     value?: T;
     enabled?: boolean;
     title?: string;
     selectedTitle?: string;
+    /**
+     * Reset the filter to its empty state.
+     */
     clear(): void;
 }
 
@@ -310,29 +339,31 @@ declare class TreeDataSource implements OnDestroy {
     ngOnDestroy(): void;
     initialize(data: ItemNode[]): void;
     /**
-     * Find a node by id recursively
-     * @param node: the source node
-     * @param id : the id to search for
+     * Find a node by id recursively.
+     * @param node - The source node to search from, or null to search from root.
+     * @param id - The id to search for.
+     * @returns The matching node, or undefined if not found.
      */
-    findNode(node: ItemNode, id: string): ItemNode;
+    findNode(node: ItemNode | null, id: string): ItemNode | undefined;
     /**
-     * Remove a node
-     * @param id : the node id to remove
+     * Remove a node from the tree.
+     * @param id - The id of the node to remove.
      */
     removeNode(id: string): void;
     /**
-     * Insert a new node
-     * @param node : the new node
+     * Insert a new node at the top of its parent (or root).
+     * @param node - The new node to insert.
      */
     insertNode(node: ItemNode): void;
     /**
-     * Rename a node
-     * @param id : the node id
-     * @param name : the new node name
+     * Rename a node in the tree.
+     * @param id - The id of the node to rename.
+     * @param name - The new name for the node.
+     * @returns The renamed node, or undefined if not found.
      */
-    renameNode(id: string, name: string): ItemNode;
+    renameNode(id: string, name: string): ItemNode | undefined;
     /**
-     * Update data
+     * Notify all subscribers of the current data state.
      */
     update(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeDataSource, never>;
@@ -343,21 +374,24 @@ interface SelectTreeDialogAppend {
     owner?: any;
 }
 declare class SelectTreeDialogComponent implements OnInit {
+    /** Emitted when the user confirms a selection. */
     readonly done: _angular_core.OutputEmitterRef<SelectTreeDialogResult>;
+    /** Emitted when the user requests to append a new node. */
     readonly append: _angular_core.OutputEmitterRef<SelectTreeDialogAppend>;
     private readonly destroyRef;
-    private readonly changeDetector;
     private readonly dialogRef;
-    protected dialogData: SelectTreeDialogData;
-    private tree;
+    /** Dialog configuration, injected and exposed as a signal. */
+    protected readonly dialogData: _angular_core.WritableSignal<SelectTreeDialogData>;
+    private readonly tree;
     private treeFlattener;
     protected treeControl: FlatTreeControl<SelectableNode>;
     protected treeData: MatTreeFlatDataSource<ItemNode, SelectableNode>;
-    protected currentNode: ItemNode;
+    /** Currently selected tree node. */
+    protected readonly currentNode: _angular_core.WritableSignal<SelectableNode>;
     protected filterText: string;
     protected filteredItems: SelectableNode[];
     protected filterIndex: number;
-    protected canAppend: _angular_core.WritableSignal<boolean>;
+    protected readonly canAppend: _angular_core.WritableSignal<boolean>;
     /**
      * Manage flat tree view
      */
@@ -368,41 +402,41 @@ declare class SelectTreeDialogComponent implements OnInit {
     protected transformer: (item: ItemNode, level: number) => SelectableNode;
     ngOnInit(): void;
     /**
-     * Submit selection
+     * Confirm the current selection and close the dialog.
      */
     protected ok(): void;
     /**
-     * Select  a node
-     * @param e : the event
-     * @param node : the
+     * Toggle selection of a tree node. Clicking the already-selected node deselects it.
+     * @param e - The mouse event (propagation is stopped).
+     * @param node - The node that was clicked.
      */
     protected select(e: MouseEvent, node: SelectableNode): void;
     /**
-     * Clear filter
+     * Clear the active filter text.
      */
     protected clearFilter(): void;
     /**
-     * Apply filter
-     * @param text : the text to filter
+     * Filter the tree nodes by name.
+     * @param text - Optional text to set as the filter before applying.
      */
     protected doFilter(text?: string): void;
     /**
-     * Goto next filtered item
+     * Advance to the next matching filtered node and scroll it into view.
      */
     protected nextFiltered(): void;
     /**
-     * Expand a node and all its parents
-     * @param node : the selectable node to expand
+     * Expand a node and all of its parent nodes.
+     * @param node - The selectable node to expand.
      */
     expand(node: SelectableNode): boolean;
     /**
-     * Append a node to the tree
-     * @param node : the nodo to append
+     * Append a new node to the tree.
+     * @param node - The node to insert.
      */
     appendNode(node: ItemNode): void;
     /**
-   * Append
-   */
+     * Emit an append request with the currently selected node as the parent.
+     */
     protected doAppend(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectTreeDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectTreeDialogComponent, "ng-component", never, {}, { "done": "done"; "append": "append"; }, never, never, true, never>;
@@ -410,46 +444,57 @@ declare class SelectTreeDialogComponent implements OnInit {
 
 declare class SelectPictureDialogComponent {
     readonly done: _angular_core.OutputEmitterRef<SelectFile>;
-    private readonly changeDetector;
     private readonly dialogService;
     private readonly dialogRef;
-    protected dialogData: SelectPictureFileDialogData;
-    protected file?: File;
+    protected readonly dialogData: _angular_core.WritableSignal<SelectPictureFileDialogData>;
+    protected readonly file: _angular_core.WritableSignal<File>;
     protected fileClass: _angular_core.WritableSignal<"selectpicture-file" | "selectpicture-file-drop">;
     protected pictureWidth: _angular_core.WritableSignal<number>;
     protected pictureHeight: _angular_core.WritableSignal<number>;
     protected picturePreview: _angular_core.WritableSignal<any>;
     /**
-     * Update preview
-     * @param e : the event
+     * Handles the native file input change event and delegates to `selectFile`.
+     * @param e - The DOM change event from the file input.
      */
-    protected update(e: any): void;
+    protected update(e: Event): void;
     /**
-     * Select a file
-     * @param file : the file to select
+     * Validates the file size and type, then reads it as a data URL to generate a preview.
+     * @param file - The `File` object to validate and preview.
      */
     private selectFile;
     /**
-     * Format size
-     * @param size the file size
+     * Formats a byte count into a human-readable size string.
+     * @param size - File size in bytes.
+     * @returns A formatted size string (e.g. "1.2 MB").
      */
     protected size(size: number): string;
-    /**
-     * Submit selection
-     */
+    /** Emits the selected file and options, then closes the dialog. */
     protected ok(): void;
-    /**
-  * Drag & drop functions
-  */
+    /** Highlights the drop zone when a dragged item is over it.
+     * @param e - The drag event.
+     */
     protected onDragOver(e: DragEvent): void;
+    /** Highlights the drop zone when a dragged item enters.
+     * @param e - The drag event.
+     */
     protected onDragEnter(e: DragEvent): void;
+    /** Resets the drop zone style when dragging ends.
+     * @param e - The drag event.
+     */
     protected onDragEnd(e: DragEvent): void;
+    /** Resets the drop zone style when a dragged item leaves.
+     * @param e - The drag event.
+     */
     protected onDragLeave(e: DragEvent): void;
+    /**
+     * Handles a file drop event, extracting and processing the dropped image.
+     * @param e - The drop event.
+     */
     protected onDrop(e: DragEvent): void;
     /**
-  * Add files
-  * @param files : the files to add
-  */
+     * Picks the first file from the list and passes it to `selectFile`.
+     * @param files - The `FileList` from the drag-and-drop event.
+     */
     private addFiles;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectPictureDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectPictureDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
@@ -459,112 +504,118 @@ declare class SelectFileDialogComponent {
     readonly done: _angular_core.OutputEmitterRef<SelectFile>;
     private readonly dialogService;
     private readonly dialogRef;
-    protected dialogData: SelectFileDialogData;
-    protected file?: File;
+    protected readonly dialogData: _angular_core.WritableSignal<SelectFileDialogData>;
+    protected readonly file: _angular_core.WritableSignal<File>;
     protected fileClass: _angular_core.WritableSignal<"selectfile-file" | "selectfile-file-drop">;
     /**
-     * Update preview
-     * @param e : the event
+     * Handles the native file input change event and delegates to `selectFile`.
+     * @param e - The DOM change event from the file input.
      */
-    protected update(e: any): void;
+    protected update(e: Event): void;
     /**
-     * Select a file
-     * @param file : the file to select
-    
+     * Validates and sets the selected file, showing an error if size or type constraints are violated.
+     * @param file - The `File` object to validate and store.
      */
     private selectFile;
     /**
-     * Format size
-     * @param size the file size
+     * Formats a byte count into a human-readable size string.
+     * @param size - File size in bytes.
+     * @returns A formatted size string (e.g. "1.2 MB").
      */
     protected size(size: number): string;
-    /**
-     * Submit selection
-     */
+    /** Emits the selected file and options, then closes the dialog. */
     protected ok(): void;
-    /**
-   * Drag & drop functions
-   */
+    /** Highlights the drop zone when a drag enters the area.
+     * @param e - The drag event.
+     */
     protected onDragOver(e: DragEvent): void;
+    /** Highlights the drop zone when a dragged item enters.
+     * @param e - The drag event.
+     */
     protected onDragEnter(e: DragEvent): void;
+    /** Resets the drop zone style when dragging ends.
+     * @param e - The drag event.
+     */
     protected onDragEnd(e: DragEvent): void;
+    /** Resets the drop zone style when a dragged item leaves the area.
+     * @param e - The drag event.
+     */
     protected onDragLeave(e: DragEvent): void;
+    /**
+     * Handles a file drop event, extracting and processing the dropped files.
+     * @param e - The drop event.
+     */
     protected onDrop(e: DragEvent): void;
     /**
-  * Add files
-  * @param files : the files to add
-  */
+     * Picks the first file from the list and passes it to `selectFile`.
+     * @param files - The `FileList` from the drag-and-drop event.
+     */
     private addFiles;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectFileDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectFileDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class PromptDialogComponent implements OnInit {
+declare class PromptDialogComponent {
     readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
-    protected dialogData: PromptDialogData;
-    protected value?: any;
-    ngOnInit(): void;
+    protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
+    protected value: any;
     /**
-     * Done
+     * Validates the form and emits the result, or shows an error if validation fails.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PromptDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PromptDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class PromptDateDialogComponent implements OnInit {
+declare class PromptDateDialogComponent {
     readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDateDialogResult>;
     private readonly dialogService;
-    protected dialogData: PromptDialogData;
-    protected value?: any;
-    ngOnInit(): void;
+    protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
+    protected value: any;
     /**
-     * Done
+     * Validates the form and emits the result, or shows an error if validation fails.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PromptDateDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PromptDateDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class PromptOtpDialogComponent implements OnInit {
+declare class PromptOtpDialogComponent {
     readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptOtpDialogResult>;
     private readonly dialogService;
-    protected dialogData: PromptDialogData;
-    protected value?: any;
-    ngOnInit(): void;
+    protected readonly dialogData: _angular_core.WritableSignal<PromptDialogData>;
+    protected value: any;
     /**
-     * Done
+     * Validates the form and emits the OTP result, or shows an error if validation fails.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PromptOtpDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PromptOtpDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class PromptTimeDialogComponent implements OnInit {
+declare class PromptTimeDialogComponent {
     readonly f: _angular_core.Signal<NgForm>;
     readonly done: _angular_core.OutputEmitterRef<PromptDialogResult>;
     private readonly dialogService;
-    protected dialogData: PromptTimeDialogData;
-    protected value?: any;
-    ngOnInit(): void;
+    protected readonly dialogData: _angular_core.WritableSignal<PromptTimeDialogData>;
+    protected value: any;
     /**
-     * Done
+     * Validates the form and emits the result, or shows an error if validation fails.
      */
     protected ok(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PromptTimeDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PromptTimeDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
 }
 
-declare class SelectDialogComponent implements OnInit {
+declare class SelectDialogComponent {
     readonly paginator: _angular_core.Signal<MatPaginator>;
     readonly selection: _angular_core.Signal<MatSelectionList>;
-    private readonly changeDetector;
     private readonly dialogRef;
-    protected dialogData: SelectDialogData;
+    protected readonly dialogData: _angular_core.WritableSignal<SelectDialogData>;
     readonly done: _angular_core.OutputEmitterRef<SelectDialogResult>;
     readonly edit: _angular_core.OutputEmitterRef<SelectDialogEdit>;
     readonly view: _angular_core.OutputEmitterRef<SelectableItem>;
@@ -589,100 +640,80 @@ declare class SelectDialogComponent implements OnInit {
     protected selectionMasterIndeterminate: _angular_core.WritableSignal<boolean>;
     protected selectionMasterChecked: _angular_core.WritableSignal<boolean>;
     protected total: _angular_core.WritableSignal<number>;
+    constructor();
     ngOnInit(): void;
     /**
-     * Mark for check
-     * @param newTotal: the optional new total
+     * Updates the total item count signal, triggering UI refresh.
+     * @param newTotal - The new total count; defaults to 0 if omitted.
      */
     notifyChanges(newTotal?: number): void;
-    /**
-     * Check if every element are selected
-     */
+    /** Returns `true` when every list item is currently selected. */
     private isAllSelected;
-    /**
-     * Checks if exists a selection
-     */
+    /** Returns `true` when at least one list item is selected. */
     private hasSelection;
     /**
-     * Master selection toggle
-     * @param e: the event
+     * Selects or deselects all items based on the master checkbox state.
+     * @param e - The checkbox change event.
      */
     protected masterSelectionToggle(e: MatCheckboxChange): void;
     /**
-     * Handle selection/deselection of an item
-     * @param e: the event
+     * Handles selection or deselection of a list item.
+     * @param e - The selection list change event.
      */
     protected select(e: MatSelectionListChange): void;
-    /**
-     * Update selection info
-     */
+    /** Refreshes the selection info label shown in the dialog footer. */
     private updateSelectionInfo;
-    /**
-     * Clear current selection
-     */
+    /** Deselects all items and resets the master checkbox state. */
     clearSelection(): void;
-    /**
-     * Submit selection
-     */
+    /** Emits the current selection and closes the dialog. */
     protected ok(): void;
-    /**
-     * Clear filter
-     */
+    /** Clears the current filter text input. */
     protected clearFilter(): void;
     /**
-     * Set filter text
-     * @param text : the new value
+     * Sets the filter text programmatically.
+     * @param text - The new filter string to apply.
      */
     setFilter(text: string): void;
     /**
-     * Gt the current filter text
-     * @returns the filter text
+     * Returns the current filter text.
+     * @returns The active filter string.
      */
     getFilter(): string;
-    /**
-     * Show filter options
-     */
+    /** Emits the `lookupOptions` output event to open the filter options panel. */
     protected showFilterOptions(): void;
     /**
-     * Apply filter
-     * @param text : the string to filter to
+     * Applies the given text filter, emitting a lookup when enabled.
+     * @param text - Optional filter string; populates `filterText` when provided.
+     * @param e - Optional keyboard event; lookup only fires on Enter.
      */
     protected doFilter(text?: string, e?: KeyboardEvent): void;
     /**
-     * Apply filter using filter options
-     * @param filterOption : the current filter option
+     * Applies a structured filter option, emitting the filter output event.
+     * @param filterOption - The selected filter option object.
      */
     protected doFilterByOptions(filterOption: any): void;
     /**
-     * Apply filter. This is accessible from public
-     * @param params : the object with current parameters
+     * Triggers a server-side lookup with the given parameters (public API).
+     * @param params - An object containing the lookup query parameters.
      */
     doLookup(params: any): void;
     /**
-     * Update lookup paginatro
-     * @param total : the new total items
+     * Updates the paginator length and resets it to the first page.
+     * @param total - The new total number of items.
      */
     protected updateLookupPaginator(total: number): void;
     /**
-    * Apply filter
-    * @param e : the MatPaginator PageEvent data
-    */
-    protected doLookupPage(e: PageEvent): void;
-    /**
-     * Append
+     * Handles a paginator page change and triggers a new lookup.
+     * @param e - The paginator page change event.
      */
+    protected doLookupPage(e: PageEvent): void;
+    /** Emits the `append` output event to open the add-item flow. */
     protected doAppend(): void;
-    /**
-     * Edit
-     */
+    /** Emits the `edit` output event for the currently selected item. */
     protected doEdit(): void;
-    /**
-     * View
-     */
+    /** Emits the `view` output event for the currently selected item. */
     protected doView(): void;
-    /**
-     * Delete
-     */
+    /** Emits the `delete` output event with all currently selected items. */
     protected doDelete(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectDialogComponent, "ng-component", never, {}, { "done": "done"; "edit": "edit"; "view": "view"; "append": "append"; "delete": "delete"; "lookup": "lookup"; "lookupOptions": "lookupOptions"; "filter": "filter"; }, never, never, true, never>;
@@ -690,104 +721,114 @@ declare class SelectDialogComponent implements OnInit {
 
 declare class ApplicationDialogService extends DialogService {
     /**
-  * Sent to
-  * @param title : title
-  * @param text : text
-  * @param subject : subject
-  * @param canPopulate: true if the populate fuction is allowed
-  * @param count : elements to send or null
-  * @param options : checkable option list
-  * @param width: the preferred width
-  */
+     * Open a send-to-email dialog.
+     * @param title - Dialog title.
+     * @param text - Pre-filled message body.
+     * @param subject - Pre-filled subject line.
+     * @param canPopulate - Whether the populate-recipients action is available.
+     * @param count - Number of documents being sent.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @returns The opened dialog reference.
+     */
     sendTo(title?: string, text?: string, subject?: string, canPopulate?: boolean, count?: number, options?: any, width?: number): MatDialogRef<SendToDialogComponent, any>;
     /**
-   * Select a tree node
-   * @param nodes : tree nodes
-   * @param title : title
-   * @param description : description
-   * @param initialFilter : initial filter
-   * @param width: the preferred width
-   * @param okCaption : ok catpion button
-   */
+     * Open a tree-node selection dialog.
+     * @param nodes - The tree nodes to display.
+     * @param title - Dialog title.
+     * @param description - Optional description shown below the title.
+     * @param initialFilter - Pre-applied filter text.
+     * @param width - Maximum dialog width in pixels.
+     * @param okCaption - Label for the confirm button.
+     * @param canAppend - Whether the append-node action is available.
+     * @returns The opened dialog reference.
+     */
     selectTree(nodes: any, title?: string, description?: string, initialFilter?: string, width?: number, okCaption?: string, canAppend?: boolean): MatDialogRef<SelectTreeDialogComponent, any>;
     /**
-  * Display a select a picture dialog
-  * @param title : dialog title
-  * @param descritpion : brief description
-  * @param okCaption : ok button caption
-  * @param options : checkable option list
-  * @param width: the preferred width
-  * @param maxSize: the maximum file size accepted in mb
-  * @param maxPictureWidth: the maximum picture width accepted
-  * @param maxPictureHeight: the maximum picture height accepted
-  */
-    selectPicture(title?: string, descritpion?: string, okCaption?: string, options?: any, width?: number, maxSize?: number, maxPictureWidth?: number, maxPictureHeight?: number): MatDialogRef<SelectPictureDialogComponent, any>;
-    /**
-    * Display a select a file dialog
-    * @param title : dialog title
-    * @param descritpion : brief description
-    * @param okCaption : ok button caption
-    * @param helpLink : help link url
-    * @param helpCaption : help link caption
-    * @param options : checkable option list
-    * @param width: the preferred width
-    * @param maxSize: the maximum file size accepted in mb
-    * @param accept: the accepted file extensions
-    */
-    selectFile(title?: string, descritpion?: string, okCaption?: string, helpLink?: string, helpCaption?: string, options?: any, width?: number, maxSize?: number, accept?: string): MatDialogRef<SelectFileDialogComponent, any>;
-    /**
-   * Display a multipourpose selection and CRUD dialog
-   * @param data : the dialog configuration model
-   * @param disableClose : dialog disable close param
-   * @param closeOnNavigation : dialog close on navigation param
-   */
+     * Open a picture-selection dialog.
+     * @param title - Dialog title.
+     * @param description - Brief description shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param maxSize - Maximum accepted file size in MB.
+     * @param maxPictureWidth - Maximum accepted picture width in pixels.
+     * @param maxPictureHeight - Maximum accepted picture height in pixels.
+     * @returns The opened dialog reference.
+     */
+    selectPicture(title?: string, description?: string, okCaption?: string, options?: any, width?: number, maxSize?: number, maxPictureWidth?: number, maxPictureHeight?: number): MatDialogRef<SelectPictureDialogComponent, any>;
+    /**
+     * Open a file-selection dialog.
+     * @param title - Dialog title.
+     * @param description - Brief description shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param helpLink - URL for the help link.
+     * @param helpCaption - Display text for the help link.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param maxSize - Maximum accepted file size in MB.
+     * @param accept - Accepted file extensions (e.g. `.pdf,.docx`).
+     * @returns The opened dialog reference.
+     */
+    selectFile(title?: string, description?: string, okCaption?: string, helpLink?: string, helpCaption?: string, options?: any, width?: number, maxSize?: number, accept?: string): MatDialogRef<SelectFileDialogComponent, any>;
+    /**
+     * Open a multipurpose selection and CRUD dialog.
+     * @param data - The dialog configuration model.
+     * @param disableClose - Whether the dialog can be closed by clicking outside.
+     * @param closeOnNavigation - Whether the dialog closes on route navigation.
+     * @returns The opened dialog reference.
+     */
     select(data: SelectDialogData, disableClose?: boolean, closeOnNavigation?: boolean): MatDialogRef<SelectDialogComponent, any>;
     /**
-    * Prompt user to insert a value
-    * @param title : the dialog title
-    * @param type : the input type
-    * @param description : the placeholder description
-    * @param initialValue : the initial value
-    * @param okCaption : ok button caption
-    * @param cancelCaption : cancel button caption
-    * @param options : checkable option list
-    * @param width: the preferred width
-    * @param required: true if the input is required
-    */
+     * Prompt the user to enter a value.
+     * @param title - Dialog title.
+     * @param type - The input type (default, text, number, etc.).
+     * @param description - Placeholder or description text.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
+     */
     prompt(title: string, type?: PromptDialogType, description?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): MatDialogRef<PromptDialogComponent>;
     /**
-     * Prompt user to insert a date or date interval
-     * @param title : the dialog title
-     * @param type : Date or DateInterval
-     * @param description : the placeholder description
-     * @param initialValue : the initial value
-     * @param okCaption : ok button caption
-     * @param cancelCaption : cancel button caption
-     * @param options : checkable option list
-     * @param width: the preferred width
-     * @param required: true if the input is required
+     * Prompt the user to enter a date or date interval.
+     * @param title - Dialog title.
+     * @param type - Date or DateInterval.
+     * @param description - Placeholder or description text.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
      */
     promptDate(title: string, type?: PromptDialogType.Date | PromptDialogType.DateInterval, description?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): MatDialogRef<PromptDateDialogComponent>;
     /**
-     * Prompt user to insert a time value
-     * @param title : the dialog title
-     * @param description : the placeholder description
-     * @param slots : time slots (optional)
-     * @param initialValue : the initial value
-     * @param okCaption : ok button caption
-     * @param cancelCaption : cancel button caption
-     * @param options : checkable option list
-     * @param width: the preferred width
-     * @param required: true if the input is required
+     * Prompt the user to enter a time value.
+     * @param title - Dialog title.
+     * @param description - Placeholder or description text.
+     * @param slots - Optional time slots string.
+     * @param initialValue - Pre-filled value.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param options - Checkable option list.
+     * @param width - Maximum dialog width in pixels.
+     * @param required - Whether the input is required.
+     * @returns The opened dialog reference.
      */
     promptTime(title: string, description?: string, slots?: string, initialValue?: any, okCaption?: string, cancelCaption?: string, options?: any, width?: number, required?: boolean): MatDialogRef<PromptTimeDialogComponent>;
     /**
-     * Prompt user to insert an OTP code
-     * @param title : the dialog title
-     * @param description : the description text
-     * @param okCaption : ok button caption
-     * @param cancelCaption : cancel button caption
-     * @param width: the preferred width
+     * Prompt the user to enter an OTP code.
+     * @param title - Dialog title.
+     * @param description - Description text shown in the dialog.
+     * @param okCaption - Label for the confirm button.
+     * @param cancelCaption - Label for the cancel button.
+     * @param width - Maximum dialog width in pixels.
+     * @returns The opened dialog reference.
      */
     promptOtp(title?: string, description?: string, okCaption?: string, cancelCaption?: string, width?: number): MatDialogRef<PromptOtpDialogComponent>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ApplicationDialogService, never>;
@@ -800,19 +841,21 @@ declare class ArsUIApplicationModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<ArsUIApplicationModule>;
 }
 
-declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, OnChanges, MatFormFieldControl<FileInfo>, ControlValueAccessor {
+declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, MatFormFieldControl<FileInfo>, ControlValueAccessor {
     ngControl: NgControl;
     __file: ElementRef;
     private readonly renderer;
     private readonly uiService;
-    private readonly changeDetector;
     static nextId: number;
     readonly stateChanges: Subject<void>;
     private previousNativeValue;
     controlType: string;
     focused: boolean;
-    protected fileSize: number;
-    protected canCapture: boolean;
+    /** Whether the device supports camera capture. */
+    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;
     private _value;
     set value(value: FileInfo);
     get value(): FileInfo;
@@ -823,7 +866,6 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, OnChange
     private _disabled;
     get disabled(): boolean;
     set disabled(value: boolean);
-    private _placeholder;
     get placeholder(): string;
     set placeholder(value: string);
     fileName?: string;
@@ -846,39 +888,63 @@ declare class FileInputComponent implements OnInit, OnDestroy, DoCheck, OnChange
     constructor(ngControl: NgControl);
     ngOnInit(): Promise<void>;
     /**
-     * Setup capture devices
+     * Detects camera availability and updates the placeholder accordingly.
      */
-    setupDevices(): Promise<void>;
+    private setupDevices;
     ngOnDestroy(): void;
     ngDoCheck(): void;
-    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Writes a new value to the component (called by the form layer).
+     * @param value - The new file info to display.
+     */
     writeValue(value: any): void;
+    /**
+     * Registers the on-change callback (called by the form layer).
+     * @param fn - Callback to invoke whenever the value changes.
+     */
     registerOnChange(fn: any): void;
+    /**
+     * Registers the on-touched callback (called by the form layer).
+     * @param fn - Callback to invoke when the control is touched.
+     */
     registerOnTouched(fn: any): void;
+    /**
+     * Sets the ARIA describedby attribute from the given element IDs.
+     * @param ids - Array of element IDs that describe this control.
+     */
     setDescribedByIds(ids: string[]): void;
+    /**
+     * Updates the disabled state of the underlying native element.
+     * @param isDisabled - Whether the control should be disabled.
+     */
     setDisabledState?(isDisabled: boolean): void;
+    /** Focuses the native input element and marks the control as touched. */
     onContainerClick(): void;
+    /**
+     * Checks whether the value has changed since the last dirty check and emits `stateChanges` if needed.
+     */
     protected updateInputDirtyCheck(): void;
     /**
-     * Select a file
-     * @param e : event
+     * Handles file selection from the native input element.
+     * @param e - The DOM change event from the file input.
      */
-    protected selectFile(e: any): void;
+    protected selectFile(e: Event): void;
     /**
-     * Check if a file has been selected
+     * Checks whether a file is currently selected.
+     * @returns `true` if a file is attached to the current value.
      */
     protected hasFile(): boolean;
     /**
-     * Clear file
+     * Clears the currently selected file and resets the control.
      */
     protected clearFile(): void;
     /**
-     * Download
+     * Emits the `download` output event if the file is not newly added.
      */
     protected downloadFile(): void;
     /**
-   * Preview
-   */
+     * Emits the `preview` output event if the file is not new and preview is enabled.
+     */
     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>;
@@ -889,33 +955,31 @@ interface FilePreviewDialogData {
     embed?: boolean;
     authToken?: string;
 }
-declare class FilePreviewComponent implements OnInit, OnDestroy {
+declare class FilePreviewComponent {
     readonly iframe: _angular_core.Signal<ElementRef<any>>;
     private readonly httpClient;
     private readonly dialogService;
     protected readonly dialogData: FilePreviewDialogData;
     protected readonly url: _angular_core.WritableSignal<string>;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
+    constructor();
     /**
-     * Load completed
+     * Handles the iframe load event: scrolls to the top and centers a single image when present.
      */
     protected loaded(): void;
     /**
-     * Download manually
+     * Opens the current file URL in a new browser tab for manual download.
      */
     protected download(): void;
     /**
-     * Troubles with pdf?
+     * Displays a help dialog with browser-specific instructions for enabling PDF preview.
      */
     protected troubles(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilePreviewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilePreviewComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-declare class FilterBarComponent implements OnInit {
+declare class FilterBarComponent {
     readonly changed: _angular_core.OutputEmitterRef<CurrentFilterChanged>;
-    private readonly changeDetector;
     readonly filters: _angular_core.InputSignal<any>;
     readonly canFilterByFlt1: _angular_core.WritableSignal<boolean>;
     readonly canFilterByFlt2: _angular_core.WritableSignal<boolean>;
@@ -939,58 +1003,54 @@ declare class FilterBarComponent implements OnInit {
     protected text?: string;
     protected text2?: string;
     protected text3?: string;
-    protected flt1: FilterGroup;
-    protected flt2: FilterGroup;
-    protected flt3: FilterGroup;
-    protected flt4: FilterGroup;
-    protected flt5: FilterGroup;
+    protected flt1: FilterGroup | undefined;
+    protected flt2: FilterGroup | undefined;
+    protected flt3: FilterGroup | undefined;
+    protected flt4: FilterGroup | undefined;
+    protected flt5: FilterGroup | undefined;
     readonly currentFilter: CurrentFilter;
     constructor();
-    ngOnInit(): void;
-    initializeFilters(): void;
+    /** Reads the `filters` input and populates the filter group fields and capability signals. */
+    private initializeFilters;
     /**
-     * Apply a filter
-     * @param filter : the filter to apply
+     * Applies the selected filter item to the current filter state and emits the change.
+     * @param filter - The filter item to apply.
      */
     applyFilter(filter: FilterItem): void;
     /**
-     * Apply a filter action
-     * @param filter : the filter to apply
-     * @param clear : true if the filter mus be removed
-     * @param event : the click event
+     * Executes the action associated with a filter group, or clears the filter.
+     * @param group - The filter group number.
+     * @param clear - When `true`, clears the filter instead of triggering its action.
      */
     applyFilterAction(group: number, clear?: boolean): void;
-    /**
-     * Apply text filter
-     */
+    /** Commits the current text inputs to the filter state and emits the change. */
     applyTextFilter(): void;
     /**
-     * Clear a filter
-     * @param group : the filter group
+     * Clears the active filter for the specified group and emits the change if it was set.
+     * @param group - The filter group number to clear.
      */
     clearFilter(group: number): void;
-    /**
-     * Clear all filters
-     */
+    /** Resets all active filters and text inputs, then emits the change. */
     clearAllFilters(): void;
     /**
-     * Check if can clear all filters button cab be showed
+     * Returns `true` when more than one filter type is active, showing the "clear all" button.
      */
     canClearAllFilters(): boolean;
     /**
-     * Get the filter group
-     * @param id : the filter id
+     * Returns the filter group matching the given id, or `undefined` if not found.
+     * @param id - The group id to look up.
      */
     private getFilterGroup;
-    /**
-     * Update filter bar using current search params
-     * @param params : search params
-     */
+    /** 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>;
 }
 
+/**
+ * A blank calendar header that hides the month/year navigation controls.
+ * Used when an inline calendar should render without any navigation UI.
+ */
 declare class CalendarEmptyHeader<D> {
     private readonly destroyRef;
     private readonly calendar;
@@ -1002,25 +1062,36 @@ declare class CalendarEmptyHeader<D> {
 
 declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentInit, 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>;
     private focused;
     private readonly stateChanges;
     private readonly destroyRef;
-    private readonly changeDetector;
     private changesEnabled;
+    /** List of available options to display as chips. */
     readonly options: _angular_core.InputSignal<NameValueItem<any>[]>;
+    /** Minimum width in pixels when collapsed. Use `-1` for automatic. */
     readonly collapsedWidth: _angular_core.InputSignal<number>;
+    /** Display mode used when the selector is in collapsed state. */
     readonly collapsedDisplayMode: _angular_core.InputSignal<"button" | "dropdown">;
+    /** Pixel threshold below which the selector collapses. Use `-1` to disable. */
     readonly collapseAt: _angular_core.InputSignal<number>;
+    /** When `true`, `collapseAt` is compared against the container width rather than the window width. */
     readonly collapseAtContainer: _angular_core.InputSignal<boolean>;
     protected readonly collapsed: _angular_core.Signal<boolean>;
+    /** Label shown in the dropdown / above the chip list. */
     readonly label: _angular_core.InputSignal<string>;
+    /** When `true`, multiple chips can be selected simultaneously. */
     readonly multiple: _angular_core.InputSignal<boolean>;
+    /** When `true`, at least one item must remain selected. */
     readonly mustSelect: _angular_core.InputSignal<boolean>;
-    readonly mode: _angular_core.InputSignal<"collapsed" | "dynamic">;
+    /** Layout mode: `'collapsed'` forces dropdown mode, `'dynamic'` collapses based on `collapseAt`. */
+    readonly mode: _angular_core.InputSignal<"dynamic" | "collapsed">;
+    /** When `true`, chips are stacked vertically instead of wrapping horizontally. */
     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>;
     private _value?;
     set value(value: NameValueItem<any>[] | undefined);
@@ -1042,41 +1113,62 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
     get shouldLabelFloat(): boolean;
     describedBy: string;
     private 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;
     /**
-     * Update container width
+     * Measures the container (or window) width and updates the `containerWidth` signal,
+     * retrying after 100 ms if the element is not yet laid out.
      */
     private updateContainerWidth;
     /**
-     * Get current selection
-     * @returns current selection
+     * Resolves the effective selection array for the current display mode.
+     * In single-select collapsed button mode the `singleSelection` item is wrapped in an array.
+     * @returns The array of currently selected items.
      */
     private getSelection;
     /**
-     * Update current value with a little delay
+     * Schedules a value update after a short delay, giving the template time to sync `ngModel`.
      */
     updateValue(): void;
     /**
-     * Check if a item is selectable
-     * @param item: the item to check
+     * 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.
      */
     isSelectable(item: NameValueItem<any>): boolean;
+    /**
+     * Writes a new value to the component (called by the form layer).
+     * @param value - The new selection to display.
+     */
     writeValue(value: any): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
+    /**
+     * Registers the on-change callback (called by the form layer).
+     * @param fn - Callback to invoke whenever the value changes.
+     */
+    registerOnChange(fn: (_: any) => void): void;
+    /**
+     * Registers the on-touched callback (called by the form layer).
+     * @param fn - Callback to invoke when the control is touched.
+     */
+    registerOnTouched(fn: () => void): void;
     setDescribedByIds(ids: string[]): void;
     setDisabledState?(isDisabled: boolean): void;
     onContainerClick(): void;
     /**
-     * Clear selection
-     * @param e : the click event
+     * Clears the current selection and stops the event from bubbling.
+     * @param e - The originating click event.
      */
     clear(e: Event): void;
+    /**
+     * Selects a single item, replacing any existing selection.
+     * @param item - The item to select. Does nothing when `undefined`.
+     */
     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>;
@@ -1084,9 +1176,10 @@ declare class ChipsSelectorComponent implements OnInit, OnDestroy, AfterContentI
 
 declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValueAccessor {
     ngControl: NgControl;
+    /** Emitted whenever the selected value changes (including programmatic resets). */
     readonly changed: _angular_core.OutputEmitterRef<NameValueItem<any>>;
+    /** Emitted when the user explicitly picks an item from the menu. */
     readonly selected: _angular_core.OutputEmitterRef<NameValueItem<any>>;
-    private readonly changeDetector;
     private readonly stateChanges;
     private focused;
     private _value;
@@ -1100,29 +1193,50 @@ declare class ButtonSelectorComponent implements OnInit, OnDestroy, ControlValue
     id: string;
     describedBy: string;
     private renderer;
+    /** Currently selected item, kept in sync with the form control value. */
     protected 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. */
     readonly border: _angular_core.InputSignal<number>;
+    /** CSS border-radius of the trigger button. Defaults to a pill shape. */
     readonly borderRadius: _angular_core.InputSignal<string>;
+    /** Placeholder label shown when nothing is selected. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Label shown above the selected value (replaces `label` when an item is selected). */
     readonly labelSelected: _angular_core.InputSignal<string>;
+    /** List of selectable options. */
     readonly options: _angular_core.InputSignal<NameValueItem<any>[]>;
+    /** 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).
+     * @param value - The new value to display.
+     */
     writeValue(value: any): void;
-    registerOnChange(fn: any): void;
-    registerOnTouched(fn: any): void;
+    /**
+     * Registers the on-change callback (called by the form layer).
+     * @param fn - Callback to invoke whenever the value changes.
+     */
+    registerOnChange(fn: (_: any) => void): void;
+    /**
+     * Registers the on-touched callback (called by the form layer).
+     * @param fn - Callback to invoke when the control is touched.
+     */
+    registerOnTouched(fn: () => void): void;
     setDescribedByIds(ids: string[]): void;
     setDisabledState?(isDisabled: boolean): void;
     onContainerClick(): void;
     /**
-   * Select an element
-   * @param item : the item to select
-   * @param notify: true if selection notification must be rised. Default is true
-   */
+     * Selects an option and optionally emits the `selected` output event.
+     * @param item   - The item to select.
+     * @param notify - When `true` (default), emits the `selected` event.
+     */
     select(item: NameValueItem<any>, notify?: boolean): void;
+    /** 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>;
@@ -1133,20 +1247,36 @@ interface ButtonToggleInfo {
     toggled: boolean;
 }
 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>;
-    protected readonly current: _angular_core.Signal<boolean>;
-    toggled: boolean;
+    /** 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. */
     readonly width: _angular_core.InputSignal<number>;
+    /** Border thickness override in pixels. Use `-1` to inherit. */
     readonly border: _angular_core.InputSignal<number>;
+    /** Label shown when `value` is `true`. */
     readonly labelOn: _angular_core.InputSignal<string>;
+    /** Label shown when `value` is `false`. */
     readonly labelOff: _angular_core.InputSignal<string>;
+    /** Material icon name shown when `value` is `true`. */
     readonly iconOn: _angular_core.InputSignal<string>;
+    /** Material icon name shown when `value` is `false`. */
     readonly iconOff: _angular_core.InputSignal<string>;
+    /** CSS class applied to the button at all breakpoints. */
     readonly cssClass: _angular_core.InputSignal<string>;
+    /** CSS class applied to the button on `xs` screens. */
     readonly cssClassSmall: _angular_core.InputSignal<string>;
+    /** Resolves the appropriate label for the current value state. */
     protected readonly label: _angular_core.Signal<string>;
+    /** Resolves the appropriate icon name for the current value state. */
     protected readonly icon: _angular_core.Signal<string>;
+    /**
+     * Toggles the button state and emits the `changed` event.
+     * The emitted `toggled` value is the logical inverse of the current `value`.
+     */
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonToggleComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonToggleComponent, "button-toggle", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "border": { "alias": "border"; "required": false; "isSignal": true; }; "labelOn": { "alias": "labelOn"; "required": false; "isSignal": true; }; "labelOff": { "alias": "labelOff"; "required": false; "isSignal": true; }; "iconOn": { "alias": "iconOn"; "required": false; "isSignal": true; }; "iconOff": { "alias": "iconOff"; "required": false; "isSignal": true; }; "cssClass": { "alias": "cssClass"; "required": false; "isSignal": true; }; "cssClassSmall": { "alias": "cssClassSmall"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;