@arsedizioni/ars-utils 22.6.86 → 22.6.89

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

@@ -1,354 +1,350 @@
-import * as i0 from '@angular/core';
-import { ComponentType } from '@angular/cdk/portal';
-import { MatDialogConfig, MatDialogRef } from '@angular/material/dialog';
-import { MatSnackBarRef } from '@angular/material/snack-bar';
-import { DialogResult, DialogOption, SelectDialogData, PromptDialogType } from '@arsedizioni/ars-utils/ui';
-import { SendToDialogComponent, SelectTreeDialogComponent, SelectDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.select';
-import { SelectPictureDialogComponent, SelectFileDialogComponent } from '@arsedizioni/ars-utils/ui.files';
-import { PromptDialogComponent, PromptDateDialogComponent, PromptTimeDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.prompt';
-import { PromptOtpDialogComponent } from '@arsedizioni/ars-utils/ui.dialogs.auth';
-import { ShellService } from '@arsedizioni/ars-utils/ui.shell';
-import * as _angular_forms_signals from '@angular/forms/signals';
-import { SignalsUtils } from '@arsedizioni/ars-utils/core.validators';
-import { MatFormFieldAppearance } from '@angular/material/form-field';
-
-interface ConfirmDialogOption extends DialogOption {
+import { ComponentType } from "@angular/cdk/portal";
+import { MatDialogConfig, MatDialogRef } from "@angular/material/dialog";
+import { MatSnackBarRef } from "@angular/material/snack-bar";
+import { DialogOption, DialogResult, PromptDialogType, SelectDialogData } from "@arsedizioni/ars-utils/ui";
+import { SelectDialogComponent, SelectTreeDialogComponent, SendToDialogComponent } from "@arsedizioni/ars-utils/ui.dialogs.select";
+import { SelectFileDialogComponent, SelectPictureDialogComponent } from "@arsedizioni/ars-utils/ui.files";
+import { PromptDateDialogComponent, PromptDialogComponent, PromptTimeDialogComponent } from "@arsedizioni/ars-utils/ui.dialogs.prompt";
+import { PromptOtpDialogComponent } from "@arsedizioni/ars-utils/ui.dialogs.auth";
+import { ShellService } from "@arsedizioni/ars-utils/ui.shell";
+import * as i0 from "@angular/core";
+import { SignalsUtils } from "@arsedizioni/ars-utils/core.validators";
+import { MatFormFieldAppearance } from "@angular/material/form-field";
+export interface ConfirmDialogOption extends DialogOption {}
+export interface ConfirmDialogData {
+  title?: string;
+  message: string;
+  okCaption?: string;
+  cancelCaption?: string;
+  otherCaption?: string;
+  options?: ConfirmDialogOption[];
+  details?: string;
 }
-interface ConfirmDialogData {
-    title?: string;
-    message: string;
-    okCaption?: string;
-    cancelCaption?: string;
-    otherCaption?: string;
-    options?: ConfirmDialogOption[];
-    details?: string;
+export declare class ConfirmDialogComponent {
+  /** Emitted when the user makes a choice. Carries the selected result and any option state. */
+  readonly choosen: import("@angular/core").OutputEmitterRef<DialogResult>;
+  private readonly dialogRef;
+  /** Dialog configuration, with sensible defaults applied at construction time. */
+  protected readonly dialogData: import("@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: i0.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialogComponent, "ng-component", never, {}, {
+    "choosen": "choosen";
+  }, never, never, true, never>;
 }
-declare class ConfirmDialogComponent {
-    /** Emitted when the user makes a choice. Carries the selected result and any option state. */
-    readonly choosen: i0.OutputEmitterRef<DialogResult>;
-    private readonly dialogRef;
-    /** Dialog configuration, with sensible defaults applied at construction time. */
-    protected readonly dialogData: i0.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: i0.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+export declare enum DeleteDialogConfirmMode {
+  None = 0,
+  Simple = 1,
+  Strong = 2
 }
-
-declare enum DeleteDialogConfirmMode {
-    None = 0,
-    Simple = 1,
-    Strong = 2
+export interface DeleteDialogData {
+  title?: string;
+  message: string;
+  confirmMode: DeleteDialogConfirmMode;
+  okCaption?: string;
+  cancelCaption?: string;
+  details?: string;
+  appearance?: MatFormFieldAppearance;
 }
-interface DeleteDialogData {
-    title?: string;
-    message: string;
-    confirmMode: DeleteDialogConfirmMode;
-    okCaption?: string;
-    cancelCaption?: string;
-    details?: string;
-    appearance?: MatFormFieldAppearance;
+export declare class DeleteDialogComponent {
+  /** Error text of a field: the message declared in the schema, or the shared fallback. */
+  protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
+  /** Emitted when the user makes a choice. Carries the selected result. */
+  readonly choosen: import("@angular/core").OutputEmitterRef<DialogResult>;
+  private readonly dialogRef;
+  /** Dialog configuration with defaults applied at construction time. */
+  protected readonly dialogData: import("@angular/core").WritableSignal<DeleteDialogData>;
+  /**
+   * Model backing the signal form: `confirmed` starts as `true` for all modes
+   * except `Simple`, which requires explicit checkbox confirmation, and
+   * `confirmValue` is the strong-confirmation text.
+   */
+  private readonly model;
+  /**
+   * Signal form for the confirmation. In `Simple` mode the checkbox must be
+   * checked; in `Strong` mode the text must be exactly the word "elimina".
+   */
+  protected readonly form: import("@angular/forms/signals").FieldTree<{
+    confirmed: boolean;
+    confirmValue: string;
+  }, string | number, "writable">;
+  /**
+   * Confirms the deletion, emitting `'ok'` and closing the dialog.
+   */
+  ok(): void;
+  /**
+   * Cancels the operation, emitting `'cancel'` and closing the dialog.
+   */
+  cancel(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<DeleteDialogComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<DeleteDialogComponent, "ng-component", never, {}, {
+    "choosen": "choosen";
+  }, never, never, true, never>;
 }
-declare class DeleteDialogComponent {
-    /** Error text of a field: the message declared in the schema, or the shared fallback. */
-    protected readonly getErrorMessage: typeof SignalsUtils.getFieldErrorMessage;
-    /** Emitted when the user makes a choice. Carries the selected result. */
-    readonly choosen: i0.OutputEmitterRef<DialogResult>;
-    private readonly dialogRef;
-    /** Dialog configuration with defaults applied at construction time. */
-    protected readonly dialogData: i0.WritableSignal<DeleteDialogData>;
-    /**
-     * Model backing the signal form: `confirmed` starts as `true` for all modes
-     * except `Simple`, which requires explicit checkbox confirmation, and
-     * `confirmValue` is the strong-confirmation text.
-     */
-    private readonly model;
-    /**
-     * Signal form for the confirmation. In `Simple` mode the checkbox must be
-     * checked; in `Strong` mode the text must be exactly the word "elimina".
-     */
-    protected readonly form: _angular_forms_signals.FieldTree<{
-        confirmed: boolean;
-        confirmValue: string;
-    }, string | number, "writable">;
-    /**
-     * Confirms the deletion, emitting `'ok'` and closing the dialog.
-     */
-    ok(): void;
-    /**
-     * Cancels the operation, emitting `'cancel'` and closing the dialog.
-     */
-    cancel(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DeleteDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DeleteDialogComponent, "ng-component", never, {}, { "choosen": "choosen"; }, never, never, true, never>;
+export interface ToastData {
+  message: string;
+  icon?: string;
+  actionCaption?: string;
 }
-
-interface ToastData {
-    message: string;
-    icon?: string;
-    actionCaption?: string;
+export declare class ToastComponent {
+  /** Emitted when the user clicks the optional action button. */
+  readonly action: import("@angular/core").OutputEmitterRef<void>;
+  /** Snack-bar payload with a safe fallback to an empty message when no data is injected. */
+  protected readonly dialogData: import("@angular/core").WritableSignal<ToastData>;
+  /**
+   * Emits the `action` event to notify the caller that the action button was clicked.
+   */
+  protected do(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ToastComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, {
+    "action": "action";
+  }, never, never, true, never>;
 }
-declare class ToastComponent {
-    /** Emitted when the user clicks the optional action button. */
-    readonly action: i0.OutputEmitterRef<void>;
-    /** Snack-bar payload with a safe fallback to an empty message when no data is injected. */
-    protected readonly dialogData: i0.WritableSignal<ToastData>;
-    /**
-     * Emits the `action` event to notify the caller that the action button was clicked.
-     */
-    protected do(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ToastComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToastComponent, "ng-component", never, {}, { "action": "action"; }, never, never, true, never>;
-}
-
-interface IDialogService {
-}
-declare class DialogService extends ShellService {
-    private readonly 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.
-     *
-     * Held by delegation and no longer by inheritance: this service now extends `ShellService`,
-     * which knows nothing about Material and must not, so the two members every caller uses of
-     * `UIService` are re-exposed here.
-     */
-    readonly appearance: i0.WritableSignal<"fill" | "outline">;
-    /**
-     * Updates the global form-field appearance.
-     * @param value - The new appearance value. Falls back to `'fill'` when `undefined` is passed.
-     * @returns void
-     */
-    setAppearance(value: 'fill' | 'outline' | undefined): void;
-    private readonly dialog;
-    private readonly snackBar;
-    private readonly location;
-    private readonly popHistory;
-    private popState;
-    private poppingState;
-    constructor();
-    /**
-     * Lets the next `popstate` through without closing the topmost dialog.
-     *
-     * Back closing the dialog on top is the rule of this service, and its listener is registered in
-     * the constructor — so nothing attached later can get in front of it. A caller that owns a
-     * dismissable state of its own INSIDE a dialog (a full-screen editor, a picker covering the
-     * dialog, a wizard step) needs Back to unwind that state first, and this is the only way to ask
-     * for it: push a history entry, call this, and handle the pop.
-     *
-     * The suspension lasts exactly one `popstate` and is consumed whether or not the caller pushed
-     * an entry, so it can not leave the service permanently deaf to the Back button.
-     */
-    suspendBackClose(): void;
-    /**
-     * 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;
-    /**
-     * 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;
-    /**
-     * 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.
-     */
-    delete(message: string, title?: string, confirmMode?: DeleteDialogConfirmMode, okCaption?: string, cancelCaption?: string, width?: number, details?: string): MatDialogRef<DeleteDialogComponent> | null;
-    /**
-     * 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): Promise<MatDialogRef<SendToDialogComponent, any> | null>;
-    /**
-     * 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): Promise<MatDialogRef<SelectTreeDialogComponent, any> | null>;
-    /**
-     * 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): Promise<MatDialogRef<SelectPictureDialogComponent, any> | null>;
-    /**
-     * 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): Promise<MatDialogRef<SelectFileDialogComponent, any> | null>;
-    /**
-     * 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): Promise<MatDialogRef<SelectDialogComponent, any> | null>;
-    /**
-     * 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): Promise<MatDialogRef<PromptDialogComponent> | null>;
-    /**
-     * 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): Promise<MatDialogRef<PromptDateDialogComponent> | null>;
-    /**
-     * 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): Promise<MatDialogRef<PromptTimeDialogComponent> | null>;
-    /**
-     * 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): Promise<MatDialogRef<PromptOtpDialogComponent> | null>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DialogService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
-}
-
-export { ConfirmDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, ToastComponent };
-export type { ConfirmDialogData, ConfirmDialogOption, DeleteDialogData, IDialogService, ToastData };
+export interface IDialogService {}
+export declare class DialogService extends ShellService {
+  private readonly 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.
+   *
+   * Held by delegation and no longer by inheritance: this service now extends `ShellService`,
+   * which knows nothing about Material and must not, so the two members every caller uses of
+   * `UIService` are re-exposed here.
+   */
+  readonly appearance: import("@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.
+   * @returns void
+   */
+  setAppearance(value: 'fill' | 'outline' | undefined): void;
+  private readonly dialog;
+  private readonly snackBar;
+  private readonly location;
+  private readonly popHistory;
+  private popState;
+  private poppingState;
+  constructor();
+  /**
+   * Lets the next `popstate` through without closing the topmost dialog.
+   *
+   * Back closing the dialog on top is the rule of this service, and its listener is registered in
+   * the constructor — so nothing attached later can get in front of it. A caller that owns a
+   * dismissable state of its own INSIDE a dialog (a full-screen editor, a picker covering the
+   * dialog, a wizard step) needs Back to unwind that state first, and this is the only way to ask
+   * for it: push a history entry, call this, and handle the pop.
+   *
+   * The suspension lasts exactly one `popstate` and is consumed whether or not the caller pushed
+   * an entry, so it can not leave the service permanently deaf to the Back button.
+   */
+  suspendBackClose(): void;
+  /**
+   * 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;
+  /**
+   * 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;
+  /**
+   * 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.
+   */
+  delete(message: string, title?: string, confirmMode?: DeleteDialogConfirmMode, okCaption?: string, cancelCaption?: string, width?: number, details?: string): MatDialogRef<DeleteDialogComponent> | null;
+  /**
+   * 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): Promise<MatDialogRef<SendToDialogComponent, any> | null>;
+  /**
+   * 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): Promise<MatDialogRef<SelectTreeDialogComponent, any> | null>;
+  /**
+   * 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): Promise<MatDialogRef<SelectPictureDialogComponent, any> | null>;
+  /**
+   * 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): Promise<MatDialogRef<SelectFileDialogComponent, any> | null>;
+  /**
+   * 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): Promise<MatDialogRef<SelectDialogComponent, any> | null>;
+  /**
+   * 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): Promise<MatDialogRef<PromptDialogComponent> | null>;
+  /**
+   * 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): Promise<MatDialogRef<PromptDateDialogComponent> | null>;
+  /**
+   * 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): Promise<MatDialogRef<PromptTimeDialogComponent> | null>;
+  /**
+   * 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): Promise<MatDialogRef<PromptOtpDialogComponent> | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<DialogService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}