@arsedizioni/ars-utils 22.1.5 → 22.5.1

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

@@ -1,13 +1,9 @@
+import { Searchable, INode, DateInterval, SearchBag, NameValueItem } from '@arsedizioni/ars-utils/core';
+import { MatFormFieldAppearance } from '@angular/material/form-field';
 import { MatPaginatorIntl } from '@angular/material/paginator';
 import * as _angular_core from '@angular/core';
-import { ElementRef, TemplateRef, InjectionToken, Signal, Renderer2 } from '@angular/core';
-import { ComponentType } from '@angular/cdk/portal';
-import { MatDialogConfig, MatDialogRef } from '@angular/material/dialog';
-import { MatSnackBarRef } from '@angular/material/snack-bar';
+import { TemplateRef, InjectionToken, Signal, ElementRef, Renderer2 } from '@angular/core';
 import { Observable } from 'rxjs';
-import { MatFormFieldAppearance } from '@angular/material/form-field';
-import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
-import { PasswordStrength } from '@arsedizioni/ars-utils/core';
 
 interface DialogResult {
     result?: 'ok' | 'cancel' | 'other';
@@ -38,592 +34,233 @@ interface CredentialsDialogResult {
     code?: string;
 }
 
-/** Italian localisation for the Material paginator labels. */
-declare class PaginatorIntl extends MatPaginatorIntl {
-    itemsPerPageLabel: string;
-    nextPageLabel: string;
-    previousPageLabel: string;
-    lastPageLabel: string;
-    firstPageLabel: string;
-    /**
-     * Returns the human-readable range label shown inside the paginator.
-     * @param page     - Zero-based index of the current page.
-     * @param pageSize - Number of items displayed per page.
-     * @param length   - Total number of items, or `-1` when the total is still being calculated.
-     * @returns A formatted string such as `"1 - 25 di 100"`.
-     */
-    getRangeLabel: (page: number, pageSize: number, length: number) => string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorIntl, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PaginatorIntl>;
+interface SelectDialogResult {
+    selectedItems: SelectableItem[];
 }
-
-interface ConfirmDialogOption extends DialogOption {
+interface SelectTreeDialogResult {
+    selectedItems: ItemNode[];
 }
-interface ConfirmDialogData {
-    title?: string;
-    message: string;
-    okCaption?: string;
-    cancelCaption?: string;
-    otherCaption?: string;
-    options?: ConfirmDialogOption[];
-    details?: string;
+interface SelectDialogLookup {
+    items: SelectableItem[];
+    filter?: string;
+    params?: any;
+    owner?: any;
 }
-declare class ConfirmDialogComponent {
-    /** Emitted when the user makes a choice. Carries the selected result and any option state. */
-    readonly choosen: _angular_core.OutputEmitterRef<DialogResult>;
-    private readonly dialogRef;
-    /** Dialog configuration, with sensible defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<ConfirmDialogData>;
-    constructor();
-    /**
-     * Confirms the dialog, emitting `'ok'` together with the current option selections.
-     */
-    ok(): void;
-    /**
-     * Cancels the dialog, emitting `'cancel'`.
-     */
-    cancel(): void;
-    /**
-     * Triggers the tertiary action, emitting `'other'`.
-     */
-    other(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+interface SelectDialogFilter {
+    items?: SelectableItem[];
+    filter?: string;
+    filterOption?: SelectableFilter;
+    owner?: any;
 }
-
-interface InfoDialogData {
-    title?: string;
-    message: string;
-    details?: string;
-    okCaption?: string;
-    dismissAfter?: number;
-    onNavigate?: (url: string) => void;
+interface SelectDialogAppend {
+    items: SelectableItem[];
+    owner?: any;
 }
-declare class InfoDialogComponent {
-    private readonly dialogService;
-    private readonly dialogRef;
-    private dismissTimer?;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<InfoDialogData>;
-    constructor();
-    /**
-     * (Re)schedules the auto-dismiss timer, cancelling any pending one so that
-     * an earlier (shorter) timer can never close a newer message.
-     * @param dismissAfter - Delay in milliseconds; no-op when falsy.
-     */
-    private scheduleDismiss;
-    /**
-     * Replaces the dialog data at runtime (e.g. after an async operation resolves).
-     * Also re-schedules the auto-dismiss timer if `dismissAfter` is set.
-     * @param data - The new dialog data to display.
-     */
-    setData(data: InfoDialogData): void;
-    /**
-     * Invokes the optional navigation callback provided by the caller.
-     * @param url - The URL to navigate to.
-     */
-    protected navigate(url: string): void;
-    /**
-     * Copy to clipboard
-     */
-    protected copy(): Promise<void>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<InfoDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<InfoDialogComponent, "ng-component", never, {}, {}, never, never, true, never>;
+interface SelectDialogEdit extends SelectDialogAppend {
+    item: SelectableItem;
 }
-
-interface ToastData {
-    message: string;
-    icon?: string;
-    actionCaption?: string;
+interface SelectDialogDelete {
+    items: SelectableItem[];
+    selectedItems: SelectableItem[];
+    owner?: any;
 }
-declare class ToastComponent {
-    /** Emitted when the user clicks the optional action button. */
-    readonly action: _angular_core.OutputEmitterRef<void>;
-    /** Snack-bar payload with a safe fallback to an empty message when no data is injected. */
-    protected readonly dialogData: _angular_core.WritableSignal<ToastData>;
-    /**
-     * Emits the `action` event to notify the caller that the action button was clicked.
-     */
-    protected do(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, { "action": "action"; }, never, never, true, never>;
+interface SelectFileOption {
+    description: string;
+    value: boolean;
+}
+interface SelectFile {
+    file: File;
+    options?: SelectFileOption[];
+}
+interface SelectableFilter {
+    divider?: boolean;
+    description?: string;
+    group?: number;
+    groupName?: string;
+    radio?: boolean;
+    checked?: boolean;
+    value?: any;
+    icon?: string;
+    title?: string;
 }
-
-declare class UIService {
-    /**
-     * The default Material form-field appearance used across dialogs and forms.
-     * Defaults to `'fill'`.
-     */
-    readonly appearance: _angular_core.WritableSignal<"fill" | "outline">;
-    /**
-     * Updates the global form-field appearance.
-     * @param value - The new appearance value. Falls back to `'fill'` when `undefined` is passed.
-     */
-    setAppearance(value: 'fill' | 'outline' | undefined): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UIService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<UIService>;
+interface SelectDialogData {
+    title: string;
+    description?: string;
+    okCaption?: string;
+    maxItems?: number;
+    multipleSelection?: boolean;
+    mustSelect?: boolean;
+    width?: number;
+    filter?: string;
+    filters?: SelectableFilter[];
+    items?: SelectableItem[];
+    lookupFields?: NameValueItem<string>[];
+    lookupOnInit?: boolean;
+    emptyMessage?: string;
+    canLookupWithOptions?: boolean;
+    canLookupWithInlineOptions?: boolean;
+    canLookup?: boolean;
+    canDelete?: boolean;
+    canAppend?: boolean;
+    canEdit?: boolean;
+    canView?: boolean;
+    canFilter?: boolean;
+    canPaginate?: boolean;
+    pageSize?: number;
+    appearance?: MatFormFieldAppearance;
+    header?: string;
+    searchLabel?: string;
+    searchButtonLabel?: string;
 }
-
-declare enum DeleteDialogConfirmMode {
-    None = 0,
-    Simple = 1,
-    Strong = 2
+interface SelectTreeDialogData {
+    title: string;
+    description?: string;
+    okCaption?: string;
+    nodes?: ItemNode[];
+    initialFilter?: string;
+    appearance?: MatFormFieldAppearance;
+    owner?: any;
+    canAppend?: boolean;
 }
-interface DeleteDialogData {
-    title?: string;
-    message: string;
-    confirmMode: DeleteDialogConfirmMode;
+interface SelectFileDialogData {
+    title: string;
+    description?: string;
     okCaption?: string;
-    cancelCaption?: string;
-    details?: string;
+    helpLink?: string;
+    helpCaption?: string;
+    maxSize?: number;
+    options?: any;
+    owner?: any;
+    accept?: string;
     appearance?: MatFormFieldAppearance;
 }
-declare class DeleteDialogComponent {
-    /** Emitted when the user makes a choice. Carries the selected result. */
-    readonly choosen: _angular_core.OutputEmitterRef<DialogResult>;
-    private readonly dialogRef;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<DeleteDialogData>;
-    /**
-     * Whether the user has confirmed the deletion.
-     * Starts as `true` for all modes except `Simple`, which requires explicit checkbox confirmation.
-     */
-    protected readonly confirmed: _angular_core.WritableSignal<boolean>;
-    /** Current value typed into the strong-confirmation text field. */
-    protected confirmValue?: string;
-    /**
-     * Confirms the deletion, emitting `'ok'` and closing the dialog.
-     */
-    ok(): void;
-    /**
-     * Cancels the operation, emitting `'cancel'` and closing the dialog.
-     */
-    cancel(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeleteDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeleteDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+interface SelectPictureFileDialogData extends SelectFileDialogData {
+    maxWidth?: number;
+    maxHeight?: number;
 }
-
-interface IDialogService {
+interface ISelectableItem extends Searchable {
+    bag: any;
+    template: string;
 }
-declare class BusyTimer {
-    private readonly dialogService;
-    private readonly subscription;
-    constructor(dialogService: DialogService, due?: number, message?: string);
-    /** Dispose object */
-    clear(): void;
+declare class SelectableItem implements ISelectableItem {
+    bag: any;
+    template: string;
+    /** Searchable index bag. */
+    searchBag: SearchBag;
 }
-declare class DialogService extends UIService {
-    /**
-     * Shares the SAME `appearance` signal instance as the root `UIService`:
-     * `uiService.setAppearance('outline')` is immediately visible here and in
-     * every dialog opened by this service.
-     */
-    readonly appearance: _angular_core.WritableSignal<"fill" | "outline">;
-    private readonly dialog;
-    private readonly overlay;
-    private readonly snackBar;
-    private readonly location;
-    private busyDialogRef?;
-    private busyComponentRef?;
-    private clearBusyTimer?;
-    private errorDialogRef?;
-    private readonly popHistory;
-    private popState;
-    private poppingState;
-    constructor();
-    /**
-     * Removes trailing `#` characters from the current URL (e.g. after a page reload).
-     * @param resetPoppingState - When `true`, resets the internal popping-state flag.
-     */
-    clearUrl(resetPoppingState?: boolean): void;
-    /**
-     * Close all dialogs
-     */
-    closeAll(): void;
-    /**
-     * Opens a Material dialog. Returns `null` when not running in a browser.
-     * @param component - The component to open as a dialog.
-     * @param config   - The dialog configuration.
-     * @returns The dialog reference, or `null` outside the browser.
-     */
-    open<T>(component: ComponentType<T>, config: MatDialogConfig<unknown>): MatDialogRef<T> | null;
-    /**
-     * Internal helper that wraps `MatDialog.open`, subscribes to lifecycle hooks
-     * and manages browser-history push/pop entries.
-     * @param component - The component to open.
-     * @param config   - The dialog configuration.
-     * @returns The dialog reference.
-     */
-    private openDialog;
-    /**
-     * Returns the element height including margins
-     * @param element - element
-     * @returns the height
-     */
-    private outerHeight;
-    /**
-     * Return current dialog height
-     */
-    getCurrentDialogHeight(): number;
-    /**
-     * Returns the scrollable content area height for the topmost open dialog.
-     * @param fixedPartsClassName - CSS class names of fixed (non-scrollable) elements whose heights are subtracted.
-     * @param minimalHeight       - Minimum height floor to use when the dialog height is smaller.
-     * @returns The computed scrollable height in pixels.
-     */
-    getCurrentDialogScrollableHeight(fixedPartsClassName: string[], minimalHeight: number): number;
-    /**
-     * Push a dialog into the browser history
-     */
-    private pushDialog;
-    /**
-     * Pop a dialog from the history
-     */
-    private popDialog;
-    /**
-     * Creates the CDK overlay used to host the busy indicator.
-     * @returns The new `OverlayRef`.
-     */
-    private createBusy;
-    /**
-     * Clears the busy overlay after a short grace delay (lets very fast
-     * operations avoid a visible flicker). The pending detach is cancelled by
-     * any new `setBusy()` call, so it can never kill a freshly opened overlay.
-     */
-    clearBusy(): void;
-    /**
-     * Shows or updates the busy overlay.
-     * @param message      - Text to display inside the overlay.
-     * @param progress     - Progress value (`-1` = indeterminate). Defaults to `-1`.
-     * @param progressMode - Progress bar mode. Defaults to `'indeterminate'`.
-     * @param type         - Visual style of the overlay. Defaults to `'bar'`.
-     * @param action       - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if a new overlay was created, `false` if an existing one was updated.
-     */
-    setBusy(message: string, progress?: number, progressMode?: 'determinate' | 'indeterminate', type?: 'bar' | 'spinner' | 'wait' | 'hourglass', action?: Observable<unknown>): boolean;
-    /**
-     * Shows or updates the busy overlay using the progress-bar style.
-     * @param message      - Text to display inside the overlay.
-     * @param progress     - Progress value (`-1` = indeterminate). Defaults to `-1`.
-     * @param progressMode - Progress bar mode. Defaults to `'indeterminate'`.
-     * @param action       - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if a new overlay was created.
-     */
-    busy(message: string, progress?: number, progressMode?: 'determinate' | 'indeterminate', action?: Observable<unknown>): boolean;
-    /**
-     * Returns a `BusyTimer` that shows the busy overlay after a debounce delay.
-     * @param message - Text to display. Defaults to `'Operazione in corso...'`.
-     * @param due     - Delay in milliseconds before the overlay appears. Defaults to `100`.
-     * @returns A `BusyTimer` that must be disposed with `clear()` when the operation ends.
-     */
-    busyTimer(message?: string, due?: number): BusyTimer;
-    /**
-     * Shows or updates the busy overlay using the hourglass style.
-     * @param message - Text to display inside the overlay.
-     * @param action  - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if a new overlay was created.
-     */
-    busyHourglass(message: string, action?: Observable<unknown>): boolean;
-    /**
-     * Shows or updates the busy overlay using the spinner style.
-     * @param message      - Text to display inside the overlay.
-     * @param progress     - Progress value (`-1` = indeterminate). Defaults to `-1`.
-     * @param progressMode - Progress mode. Defaults to `'indeterminate'`.
-     * @param action       - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if a new overlay was created.
-     */
-    busySpinner(message: string, progress?: number, progressMode?: 'determinate' | 'indeterminate', action?: Observable<unknown>): boolean;
-    /**
-     * Shows a minimal wait spinner overlay.
-     * @param action - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if a new overlay was created.
-     */
-    wait(action?: Observable<unknown>): boolean;
-    /**
-     * Opens an informational dialog.
-     * @param message      - HTML message to display.
-     * @param title        - Dialog title. Defaults to `'Informazioni'`.
-     * @param okCaption    - Confirmation button label. Defaults to `'Ok'`.
-     * @param width        - Maximum dialog width in pixels. Defaults to `500`.
-     * @param dismissAfter - Auto-close delay in milliseconds (optional).
-     * @param details      - Optional secondary details text.
-     * @param onNavigate   - Optional navigation callback invoked when the user clicks a link.
-     * @returns The dialog reference, or `null` outside the browser.
-     */
-    info(message: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number, details?: string, onNavigate?: (url: string) => void): MatDialogRef<InfoDialogComponent> | null;
-    /**
-     * Opens an error dialog. If one is already open, its content is updated in place.
-     * @param message      - HTML error message to display.
-     * @param log          - Optional technical log / stack trace shown in the details panel.
-     * @param title        - Dialog title. Defaults to `'Errore'`.
-     * @param okCaption    - Confirmation button label. Defaults to `'Ok'`.
-     * @param width        - Maximum dialog width in pixels. Defaults to `500`.
-     * @param dismissAfter - Auto-close delay in milliseconds (optional).
-     * @returns The dialog reference, or `null` outside the browser.
-     */
-    error(message: string, log?: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number): MatDialogRef<InfoDialogComponent> | null;
-    /**
-     * Shows a snack-bar toast notification.
-     * @param message       - HTML message to display.
-     * @param duration      - Visible duration in milliseconds. Defaults to `2000`.
-     * @param icon          - Material icon name shown beside the message. Defaults to `'check'`.
-     * @param actionCaption - Optional label for the action button.
-     * @returns The snack-bar reference.
-     */
-    toast(message: string, duration?: number, icon?: string, actionCaption?: string): MatSnackBarRef<ToastComponent>;
-    /**
-     * Opens a confirmation dialog.
-     * @param message       - HTML message to display.
-     * @param title         - Dialog title. Defaults to `'Conferma'`.
-     * @param okCaption     - Primary action button label. Defaults to `'Si'`.
-     * @param cancelCaption - Cancel button label. Defaults to `'No'`.
-     * @param otherCaption  - Optional tertiary action button label.
-     * @param options       - Optional list of checkbox options shown to the user.
-     * @param width         - Maximum dialog width in pixels. Defaults to `500`.
-     * @param details       - Optional secondary details text.
-     * @returns The dialog reference, or `null` outside the browser.
-     */
-    confirm(message: string, title?: string, okCaption?: string, cancelCaption?: string, otherCaption?: string, options?: ConfirmDialogOption[], width?: number, details?: string): MatDialogRef<ConfirmDialogComponent> | null;
+declare class ItemNode implements INode {
+    id: string;
+    name: string;
+    count?: number;
+    parent?: INode;
+    children?: INode[];
+    bag?: any;
+}
+declare class SelectableNode extends ItemNode implements Searchable {
+    expandable: boolean;
+    level: number;
+    /** Searchable index bag. */
+    searchBag: SearchBag;
     /**
-     * Opens a deletion-confirmation dialog.
-     * @param message       - HTML message to display.
-     * @param title         - Dialog title. Defaults to `'Attenzione'`.
-     * @param confirmMode   - Confirmation mode (none / checkbox / type-to-confirm). Defaults to `None`.
-     * @param okCaption     - Primary action button label. Defaults to `'Si'`.
-     * @param cancelCaption - Cancel button label. Defaults to `'No'`.
-     * @param width         - Maximum dialog width in pixels. Defaults to `500`.
-     * @param details       - Optional secondary details text.
-     * @returns The dialog reference, or `null` outside the browser.
+     * 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.
      */
-    delete(message: string, title?: string, confirmMode?: DeleteDialogConfirmMode, okCaption?: string, cancelCaption?: string, width?: number, details?: string): MatDialogRef<DeleteDialogComponent> | null;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DialogService>;
+    constructor(item: ItemNode, level: number);
 }
-
 /**
- * Overlay dialog that blocks interaction while a background operation is in progress.
- * Supports four visual styles: progress bar, spinner, hourglass, and wait icon.
+ * Minimal contract exposed by the send-to dialog to its host.
+ * Declared here (and not on the component) so that `ui` never depends on
+ * `ui.dialogs.select`, which would create a circular entry point dependency.
  */
-declare class BusyDialogComponent {
-    /** Visual style of the busy indicator. */
-    readonly type: _angular_core.WritableSignal<"bar" | "spinner" | "wait" | "hourglass">;
-    /** Current progress value (0–100). Used when `progressMode` is `'determinate'`. */
-    readonly progress: _angular_core.WritableSignal<number>;
-    /** Progress mode passed to the Material progress components. */
-    readonly progressMode: _angular_core.WritableSignal<"determinate" | "indeterminate">;
-    /** Message displayed above the progress indicator. */
-    readonly message: _angular_core.WritableSignal<string>;
-    /**
-     * Updates the busy dialog state.
-     * @param message      - New message to display. Ignored when empty, preserving the previous text.
-     * @param progress     - Current progress value (0–100). A value > 0 forces `'determinate'` mode.
-     * @param progressMode - Progress bar/spinner mode (default: `'indeterminate'`).
-     * @param type         - Visual style to use (default: `'bar'`).
-     */
-    set(message: string, progress: number, progressMode?: 'determinate' | 'indeterminate', type?: 'bar' | 'spinner' | 'wait' | 'hourglass'): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BusyDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BusyDialogComponent, "ng-component", never, {}, {}, never, never, true, never>;
-}
-
-interface CredentialsDialogData {
-    title?: string;
-    message?: string;
-    remember?: boolean;
-    recoverPassword?: boolean;
-    recoverPasswordUrl?: string;
-    user?: string;
+interface ISendToDialog {
+    /**
+     * Replaces the recipient list shown in the dialog.
+     * @param recipients - The semicolon separated recipient list.
+     */
+    updateRecipients(recipients: string): void;
+}
+interface SendToPopulateData {
+    item: SendToDialogResult;
+    source: ISendToDialog;
+}
+interface SendToDialogResult {
+    recipients?: string;
+    subject?: string;
+    text?: string;
+    options?: any;
+}
+interface PromptDialogResult {
+    value?: string;
+    type?: PromptDialogType;
+    options?: any;
+}
+interface PromptDateDialogResult {
+    value?: Date | DateInterval;
+    type?: PromptDialogType;
+    options?: any;
+}
+interface PromptOtpDialogResult {
+    value?: string;
+}
+declare enum PromptDialogType {
+    Default = 0,
+    Date = 1,
+    Number = 2,
+    Text = 3,
+    DateInterval = 4,
+    List = 5,
+    Time = 6
+}
+interface PromptDialogData {
+    title: string;
+    type: PromptDialogType;
+    description?: string;
     okCaption?: string;
-    mode?: 'email' | 'user' | 'otp';
-    appearance?: MatFormFieldAppearance;
-}
-declare class CredentialsDialogComponent {
-    /** Emitted when the user submits the form. Carries the entered credentials. */
-    readonly done: _angular_core.OutputEmitterRef<CredentialsDialogResult>;
-    /** Emitted when the user requests a password-recovery flow. */
-    readonly recoveringPassword: _angular_core.OutputEmitterRef<CredentialsDialogResult>;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<CredentialsDialogData>;
-    /** Current form model, pre-filled with the user name from dialog data when provided. */
-    protected item: CredentialsDialogResult;
-    /** Whether the password field is currently shown as plain text. */
-    protected readonly showPassword: _angular_core.WritableSignal<boolean>;
-    /**
-     * Switches the input mode of the dialog at runtime (e.g. from login to OTP).
-     * Intended to be called from outside via the dialog component reference.
-     * @param mode    - The new input mode (`'email'`, `'user'`, or `'otp'`).
-     * @param message - Optional new message to display above the form.
-     */
-    changeMode(mode: 'email' | 'user' | 'otp', message?: string): void;
-    /**
-     * Emits the current form result and closes the dialog.
-     */
-    protected ok(): void;
-    /**
-     * Emits the current form result for the password-recovery flow and optionally
-     * opens the recovery URL in a new tab.
-     */
-    protected recoverPassword(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CredentialsDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CredentialsDialogComponent, "ng-component", never, {}, { "done": "done"; "recoveringPassword": "recoveringPassword"; }, never, never, true, never>;
-}
-
-interface RecoverPasswordDialogData {
-    appearance?: MatFormFieldAppearance;
-}
-declare class RecoverPasswordDialogComponent {
-    /** Emitted when the user submits the recovery request. Carries the entered email and recaptcha state. */
-    readonly done: _angular_core.OutputEmitterRef<RecoverPasswordDialogResult>;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<RecoverPasswordDialogData>;
-    /** Current form model bound to the template inputs. */
-    protected item: RecoverPasswordDialogResult;
-    /**
-     * Emits the current form result to trigger the password-recovery flow.
-     */
-    protected ok(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RecoverPasswordDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RecoverPasswordDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
-}
-
-type ResetPasswordDialogMode = 'admin' | 'old' | 'otp' | 'forgot';
-interface ResetPasswordDialogData {
-    mode: ResetPasswordDialogMode;
-    userId?: number;
-    userEmail?: string;
+    cancelCaption?: string;
+    initialValue?: any;
+    minValue?: number;
+    maxValue?: number;
+    required?: boolean;
     appearance?: MatFormFieldAppearance;
+    options?: any;
 }
-declare class ResetPasswordDialogComponent {
-    /** Emitted when the user submits the new password. Carries the entered password data. */
-    readonly done: _angular_core.OutputEmitterRef<ResetPasswordDialogResult>;
-    private readonly dialogService;
-    private readonly dialogRef;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: _angular_core.WritableSignal<ResetPasswordDialogData>;
-    /** Current form model bound to the template inputs. */
-    protected item: ResetPasswordDialogResult;
-    /** Whether the old-password field is currently shown as plain text. */
-    protected readonly showOldPassword: _angular_core.WritableSignal<boolean>;
-    /** Whether the new-password field is currently shown as plain text. */
-    protected readonly showPassword: _angular_core.WritableSignal<boolean>;
-    /** Whether the confirm-password field is currently shown as plain text. */
-    protected readonly showPassword2: _angular_core.WritableSignal<boolean>;
-    constructor();
-    /**
-     * Emits the current form result to trigger the password-reset flow.
-     */
-    protected ok(): void;
-    /**
-     * Generates a random password and populates both password fields with it.
-     */
-    protected generatePassword(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ResetPasswordDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ResetPasswordDialogComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
+interface PromptTimeDialogData extends PromptDialogData {
+    slots?: string;
 }
 
-declare class OtpInputComponent implements ControlValueAccessor, Validator {
-    /** Signal-based query for all individual OTP digit input elements. */
-    readonly otpFields: _angular_core.Signal<readonly ElementRef<HTMLInputElement>[]>;
-    /** `true` when every digit slot contains a valid single decimal digit. */
-    readonly isValid: _angular_core.Signal<boolean>;
-    /** Array of per-digit values backing the OTP display. */
-    readonly otpArray: _angular_core.WritableSignal<string[]>;
-    /** Whether the control is currently disabled. */
-    readonly disabled: _angular_core.WritableSignal<boolean>;
-    private onChange;
-    private onTouched;
-    /**
-     * Writes a new value into the control from the model.
-     * @param value - A string of up to 6 digits to pre-fill the OTP fields.
-     */
-    writeValue(value: string): void;
-    /**
-     * Registers the callback invoked when the control value changes.
-     * @param fn - The callback function.
-     */
-    registerOnChange(fn: (val: string) => void): void;
-    /**
-     * Registers the callback invoked when the control is touched.
-     * @param fn - The callback function.
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Enables or disables the control.
-     * @param isDisabled - `true` to disable all OTP inputs.
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /**
-     * Validates the OTP value: an empty code is left to `required`, while a
-     * PARTIAL code (e.g. "12") is reported as invalid. Without this, the joined
-     * value "12" was a non-empty string and `required` let the form submit
-     * with an incomplete OTP.
-     * @param control - The form control bound to this component.
-     * @returns `null` when empty or complete (6 digits), `{ otp: true }` otherwise.
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    /**
-     * Marks the control as touched when an OTP field loses focus.
-     */
-    onBlur(): void;
-    /**
-     * Blocks non-digit characters before they are inserted.
-     * @param event - The `beforeinput` event from the input element.
-     */
-    onBeforeInput(event: InputEvent): void;
-    /**
-       * Handles digit input, sanitizes it, syncs the DOM, updates the OTP array, and advances focus.
-       * @param event - The `input` event from the digit field.
-       * @param index - Zero-based index of the field that received input.
-       */
-    onInput(event: Event, index: number): void;
-    /**
-     * Handles the Backspace key by moving focus to the previous field when the current one is empty.
-     * @param event - The `keydown` event.
-     * @param index - Zero-based index of the field that received the keydown.
-     */
-    onKeyDown(event: KeyboardEvent, index: number): void;
-    /**
-     * Handles paste events by extracting up to 6 digits and distributing them across the OTP fields.
-     * @param event - The `ClipboardEvent` from the paste action.
-     */
-    onPaste(event: ClipboardEvent): void;
-    /**
-     * Clears every digit field, propagates the empty value to the form model and
-     * moves focus back to the first field. Does not mark the control as touched,
-     * so no validation error is shown right after the reset.
-     */
-    clear(): void;
-    /**
-     * Moves focus to the OTP field at the given index.
-     * @param index - Zero-based index of the target field.
-     */
-    private focusField;
+/** Italian localisation for the Material paginator labels. */
+declare class PaginatorIntl extends MatPaginatorIntl {
+    itemsPerPageLabel: string;
+    nextPageLabel: string;
+    previousPageLabel: string;
+    lastPageLabel: string;
+    firstPageLabel: string;
     /**
-     * Notifies the form model of the current OTP value and marks the control as touched.
+     * Returns the human-readable range label shown inside the paginator.
+     * @param page     - Zero-based index of the current page.
+     * @param pageSize - Number of items displayed per page.
+     * @param length   - Total number of items, or `-1` when the total is still being calculated.
+     * @returns A formatted string such as `"1 - 25 di 100"`.
      */
-    private updateModel;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "otp-input", never, {}, {}, never, never, true, never>;
+    getRangeLabel: (page: number, pageSize: number, length: number) => string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorIntl, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PaginatorIntl>;
 }
 
-/**
- * Displays a password-strength indicator for the provided password string.
- * Uses `SystemUtils.calculatePasswordStrength` to derive the score and label.
- */
-declare class PasswordStrengthComponent {
-    /** The password to evaluate. An empty string renders the default (score 0) state. */
-    readonly password: _angular_core.InputSignal<string>;
+declare class UIService {
     /**
-     * Computed strength result for the current password.
-     * Falls back to `DEFAULT_STRENGTH` when the password is empty.
+     * The default Material form-field appearance used across dialogs and forms.
+     * Defaults to `'fill'`.
      */
-    protected readonly strength: _angular_core.Signal<PasswordStrength>;
+    readonly appearance: _angular_core.WritableSignal<"fill" | "outline">;
     /**
-     * CSS class applied to the label element based on the numeric score (1–6 bands).
-     * Scores ≤ 2 → `'score-2'`, ≤ 3 → `'score-3'`, etc.
+     * Updates the global form-field appearance.
+     * @param value - The new appearance value. Falls back to `'fill'` when `undefined` is passed.
      */
-    protected readonly scoreClass: _angular_core.Signal<string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PasswordStrengthComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordStrengthComponent, "password-strength", never, { "password": { "alias": "password"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    setAppearance(value: 'fill' | 'outline' | undefined): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UIService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<UIService>;
 }
 
 declare class IfBpDirective {
@@ -1292,5 +929,5 @@ declare class FlexLayoutModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<FlexLayoutModule>;
 }
 
-export { ALIAS_FAMILIES, BS5_BREAKPOINTS, BusyDialogComponent, BusyTimer, CANONICAL_ALIASES, ConfirmDialogComponent, CredentialsDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, InfoDialogComponent, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, OtpInputComponent, PaginatorIntl, PasswordStrengthComponent, RecoverPasswordDialogComponent, ResetPasswordDialogComponent, ResponsiveBaseDirective, ToastComponent, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, validateBasis, validateLayoutValue, validateWrapValue };
-export type { BpValues, BreakpointAlias, CanonicalKey, ConfirmDialogData, ConfirmDialogOption, CredentialsDialogData, CredentialsDialogResult, DeleteDialogData, DialogOption, DialogResult, IDialogService, InfoDialogData, NcValues, NonCanonicalKey, RecoverPasswordDialogData, RecoverPasswordDialogResult, ResetPasswordDialogData, ResetPasswordDialogMode, ResetPasswordDialogResult, ToastData };
+export { ALIAS_FAMILIES, BS5_BREAKPOINTS, CANONICAL_ALIASES, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, ItemNode, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, PaginatorIntl, PromptDialogType, ResponsiveBaseDirective, SelectableItem, SelectableNode, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, validateBasis, validateLayoutValue, validateWrapValue };
+export type { BpValues, BreakpointAlias, CanonicalKey, CredentialsDialogResult, DialogOption, DialogResult, ISelectableItem, ISendToDialog, NcValues, NonCanonicalKey, PromptDateDialogResult, PromptDialogData, PromptDialogResult, PromptOtpDialogResult, PromptTimeDialogData, RecoverPasswordDialogResult, ResetPasswordDialogResult, SelectDialogAppend, SelectDialogData, SelectDialogDelete, SelectDialogEdit, SelectDialogFilter, SelectDialogLookup, SelectDialogResult, SelectFile, SelectFileDialogData, SelectFileOption, SelectPictureFileDialogData, SelectTreeDialogData, SelectTreeDialogResult, SelectableFilter, SendToDialogResult, SendToPopulateData };