@arsedizioni/ars-utils 22.6.86 → 22.6.89

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

@@ -1,25 +1,24 @@
-import { Observable } from 'rxjs';
-import * as _angular_core from '@angular/core';
-
+import { Observable } from "rxjs";
+import * as i0 from "@angular/core";
 /**
  * Content of a shell message.
  *
  * Deliberately a subset of `InfoDialogData`: the shell speaks before a route exists, so it
  * says one thing and offers one way out. Anything richer belongs to `DialogService`.
  */
-interface ShellMessageData {
-    /** Heading shown above the message. */
-    title?: string;
-    /** HTML body of the message. */
-    message: string;
-    /** Optional technical detail (a log, a stack trace) shown in a secondary panel. */
-    details?: string;
-    /** Label of the dismiss button. */
-    okCaption?: string;
-    /** Auto-dismiss delay in milliseconds; the message stays until dismissed when omitted. */
-    dismissAfter?: number;
-    /** Maximum width of the panel in pixels. */
-    width?: number;
+export interface ShellMessageData {
+  /** Heading shown above the message. */
+  title?: string;
+  /** HTML body of the message. */
+  message: string;
+  /** Optional technical detail (a log, a stack trace) shown in a secondary panel. */
+  details?: string;
+  /** Label of the dismiss button. */
+  okCaption?: string;
+  /** Auto-dismiss delay in milliseconds; the message stays until dismissed when omitted. */
+  dismissAfter?: number;
+  /** Maximum width of the panel in pixels. */
+  width?: number;
 }
 /**
  * Handle over an open shell message.
@@ -28,28 +27,27 @@ interface ShellMessageData {
  * uses of one are the same, and mean the same thing, so moving a call site between
  * `DialogService` and `ShellService` does not change how its result is awaited.
  */
-interface ShellMessageRef {
-    /**
-     * Closes the message. Does nothing when it has already been closed.
-     * @returns void
-     */
-    close(): void;
-    /**
-     * Emits once and completes when the message has been taken off the screen, whichever way it
-     * was dismissed — the button, Escape, the backdrop, the auto-dismiss timer, or a `close()`.
-     *
-     * Like `MatDialogRef.afterClosed()`, and like it in the corner case too: subscribing after
-     * the message is already gone completes without emitting, so it is not a way to ask whether
-     * it was closed.
-     * @returns An observable of the dismissal.
-     */
-    afterClosed(): Observable<void>;
+export interface ShellMessageRef {
+  /**
+   * Closes the message. Does nothing when it has already been closed.
+   * @returns void
+   */
+  close(): void;
+  /**
+   * Emits once and completes when the message has been taken off the screen, whichever way it
+   * was dismissed — the button, Escape, the backdrop, the auto-dismiss timer, or a `close()`.
+   *
+   * Like `MatDialogRef.afterClosed()`, and like it in the corner case too: subscribing after
+   * the message is already gone completes without emitting, so it is not a way to ask whether
+   * it was closed.
+   * @returns An observable of the dismissal.
+   */
+  afterClosed(): Observable<void>;
 }
-
 /** Visual style of the busy indicator. */
-type ShellBusyType = 'bar' | 'spinner' | 'wait' | 'hourglass';
+export type ShellBusyType = 'bar' | 'spinner' | 'wait' | 'hourglass';
 /** Progress mode of the bar and of the spinner. */
-type ShellBusyMode = 'determinate' | 'indeterminate';
+export type ShellBusyMode = 'determinate' | 'indeterminate';
 /**
  * Overlay that blocks interaction while an operation is running, in the four styles the
  * applications use: progress bar, spinner, hourglass and bare wait.
@@ -61,57 +59,56 @@ type ShellBusyMode = 'determinate' | 'indeterminate';
  * The instance is created once by {@link ShellService} and then reused: showing and hiding is a
  * class on the host, never a `createComponent`, so the 40-odd calls a screen costs nothing.
  */
-declare class ShellBusyComponent {
-    private readonly themeService;
-    /**
-     * True when the panel must paint itself dark.
-     *
-     * Read from {@link ThemeService} and not from `prefers-color-scheme`, because the two do not
-     * always agree: the service is what the user chose, and it may be forcing dark on a machine
-     * that is on light. Following the OS instead would leave this panel the only light thing on a
-     * dark screen.
-     */
-    protected readonly dark: _angular_core.WritableSignal<boolean>;
-    /**
-     * Keeps {@link dark} in step with the service, now and at every later change.
-     *
-     * `'auto'` is resolved through `getTheme()`, which is the only thing that knows what the
-     * operating system is currently on.
-     * @returns void
-     */
-    private followTheme;
-    /** Whether the overlay is on screen. Hidden with `display: none`, so it costs no layout. */
-    readonly visible: _angular_core.WritableSignal<boolean>;
-    /** Visual style of the indicator. */
-    readonly type: _angular_core.WritableSignal<ShellBusyType>;
-    /** Current progress value (0-100), used when {@link progressMode} is `'determinate'`. */
-    readonly progress: _angular_core.WritableSignal<number>;
-    /** Progress mode of the bar and of the spinner. */
-    readonly progressMode: _angular_core.WritableSignal<ShellBusyMode>;
-    /** Message displayed above the indicator. */
-    readonly message: _angular_core.WritableSignal<string>;
-    /** Circumference of the spinner circle, bound to `stroke-dasharray`. */
-    protected readonly circumference: number;
-    constructor();
-    /** Length of the spinner arc still to be drawn, derived from {@link progress}. */
-    protected readonly dashOffset: _angular_core.Signal<number>;
-    /**
-     * Updates the overlay state.
-     *
-     * Same contract as the `BusyDialogComponent` it replaces, down to the two implicit rules that
-     * callers rely on: an empty message keeps the previous text (so `wait()` does not wipe it), and
-     * a progress above zero forces `'determinate'` whatever the caller passed.
-     * @param message      - New message to display. An empty string preserves the current one.
-     * @param progress     - Current progress value (0-100). Above zero it forces determinate mode.
-     * @param progressMode - Progress mode to use. Defaults to `'indeterminate'`.
-     * @param type         - Visual style to use. Defaults to `'bar'`.
-     * @returns void
-     */
-    set(message: string, progress: number, progressMode?: ShellBusyMode, type?: ShellBusyType): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellBusyComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ShellBusyComponent, "ars-shell-busy", never, {}, {}, never, never, true, never>;
+export declare class ShellBusyComponent {
+  private readonly themeService;
+  /**
+   * True when the panel must paint itself dark.
+   *
+   * Read from {@link ThemeService} and not from `prefers-color-scheme`, because the two do not
+   * always agree: the service is what the user chose, and it may be forcing dark on a machine
+   * that is on light. Following the OS instead would leave this panel the only light thing on a
+   * dark screen.
+   */
+  protected readonly dark: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * Keeps {@link dark} in step with the service, now and at every later change.
+   *
+   * `'auto'` is resolved through `getTheme()`, which is the only thing that knows what the
+   * operating system is currently on.
+   * @returns void
+   */
+  private followTheme;
+  /** Whether the overlay is on screen. Hidden with `display: none`, so it costs no layout. */
+  readonly visible: import("@angular/core").WritableSignal<boolean>;
+  /** Visual style of the indicator. */
+  readonly type: import("@angular/core").WritableSignal<ShellBusyType>;
+  /** Current progress value (0-100), used when {@link progressMode} is `'determinate'`. */
+  readonly progress: import("@angular/core").WritableSignal<number>;
+  /** Progress mode of the bar and of the spinner. */
+  readonly progressMode: import("@angular/core").WritableSignal<ShellBusyMode>;
+  /** Message displayed above the indicator. */
+  readonly message: import("@angular/core").WritableSignal<string>;
+  /** Circumference of the spinner circle, bound to `stroke-dasharray`. */
+  protected readonly circumference: number;
+  constructor();
+  /** Length of the spinner arc still to be drawn, derived from {@link progress}. */
+  protected readonly dashOffset: import("@angular/core").Signal<number>;
+  /**
+   * Updates the overlay state.
+   *
+   * Same contract as the `BusyDialogComponent` it replaces, down to the two implicit rules that
+   * callers rely on: an empty message keeps the previous text (so `wait()` does not wipe it), and
+   * a progress above zero forces `'determinate'` whatever the caller passed.
+   * @param message      - New message to display. An empty string preserves the current one.
+   * @param progress     - Current progress value (0-100). Above zero it forces determinate mode.
+   * @param progressMode - Progress mode to use. Defaults to `'indeterminate'`.
+   * @param type         - Visual style to use. Defaults to `'bar'`.
+   * @returns void
+   */
+  set(message: string, progress: number, progressMode?: ShellBusyMode, type?: ShellBusyType): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShellBusyComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ShellBusyComponent, "ars-shell-busy", never, {}, {}, never, never, true, never>;
 }
-
 /**
  * Everything the application can say to the user without asking anything back: a message, an
  * error, and the wait overlay. No Angular Material behind any of it.
@@ -142,190 +139,189 @@ declare class ShellBusyComponent {
  * still there and still correct: it is what orders the overlays on a browser without the Popover
  * API, where the CDK does not use it either.
  */
-declare class ShellService {
-    private readonly appRef;
-    private readonly environmentInjector;
-    private messageRef?;
-    private messageKind?;
-    private messageClosed?;
-    private previousOverflow?;
-    private previouslyFocused?;
-    private busyRef?;
-    private busyVisible;
-    private busyActionSubscription?;
-    private clearBusyTimer?;
-    /** Cached answer of {@link supportsTopLayer}, resolved the first time an overlay is shown. */
-    private topLayerSupport?;
-    /**
-     * Shows an informational message.
-     * @param message      - HTML message to display.
-     * @param title        - Heading. Defaults to `'Informazioni'`.
-     * @param okCaption    - Dismiss button label. Defaults to `'Ok'`.
-     * @param width        - Maximum panel width in pixels. Defaults to `500`.
-     * @param dismissAfter - Auto-close delay in milliseconds (optional).
-     * @param details      - Optional secondary details text.
-     * @returns A handle over the open message, or `null` outside the browser.
-     */
-    info(message: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number, details?: string): ShellMessageRef | null;
-    /**
-     * Shows an error message. When one is already on screen its content is replaced in place: a
-     * failing API answers many requests at once, and each of them must not add a panel of its own.
-     * @param message      - HTML error message to display.
-     * @param log          - Optional technical log or stack trace shown in the details panel.
-     * @param title        - Heading. Defaults to `'Errore'`.
-     * @param okCaption    - Dismiss button label. Defaults to `'Ok'`.
-     * @param width        - Maximum panel width in pixels. Defaults to `500`.
-     * @param dismissAfter - Auto-close delay in milliseconds (optional).
-     * @returns A handle over the open message, or `null` outside the browser.
-     */
-    error(message: string, log?: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number): ShellMessageRef | null;
-    /**
-     * Closes the message currently on screen, if any. Does not touch the busy overlay.
-     * @returns void
-     */
-    closeMessage(): void;
-    /**
-     * Opens the message panel, or updates the one already open when it is showing the same kind of
-     * message.
-     * @param kind - Whether this is an informational or an error message.
-     * @param data - The content to display.
-     * @returns A handle over the open message, or `null` outside the browser.
-     */
-    private showMessage;
-    /**
-     * Builds the handle returned to callers.
-     *
-     * The subject is captured now rather than read at call time, so `afterClosed()` keeps
-     * answering about the message this handle was given for, even once another one has taken
-     * its place on screen.
-     * @returns The handle over the message currently on screen.
-     */
-    private messageHandle;
-    /**
-     * Shows or updates the busy overlay.
-     *
-     * Called dozens of times per screen, so it creates nothing after the first time: the component
-     * is built once and then kept, and showing it again is a class on the host element. The state
-     * is written to signals and checked synchronously before returning, so the message on screen is
-     * always the last one asked for — a second `busy()` in the same task never leaves the previous
-     * text behind.
-     * @param message      - Text to display. An empty string keeps the current one.
-     * @param progress     - Progress value (`-1` = indeterminate). Defaults to `-1`.
-     * @param progressMode - Progress mode. Defaults to `'indeterminate'`.
-     * @param type         - Visual style of the overlay. Defaults to `'bar'`.
-     * @param action       - Optional observable; the overlay is dismissed when it first emits. It
-     *                       replaces the one passed to a previous call, which is unsubscribed.
-     * @returns `true` if the overlay was brought up by this call, `false` if it was already up.
-     */
-    setBusy(message: string, progress?: number, progressMode?: ShellBusyMode, type?: ShellBusyType, 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 mode. Defaults to `'indeterminate'`.
-     * @param action       - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if the overlay was brought up by this call.
-     */
-    busy(message: string, progress?: number, progressMode?: ShellBusyMode, 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 the overlay was brought up by this call.
-     */
-    busySpinner(message: string, progress?: number, progressMode?: ShellBusyMode, action?: Observable<unknown>): boolean;
-    /**
-     * 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 the overlay was brought up by this call.
-     */
-    busyHourglass(message: string, action?: Observable<unknown>): boolean;
-    /**
-     * Shows a bare wait indicator, with no panel and no message.
-     * @param action - Optional observable; the overlay is dismissed when it emits.
-     * @returns `true` if the overlay was brought up by this call.
-     */
-    wait(action?: Observable<unknown>): boolean;
-    /**
-     * Returns a {@link BusyTimer} that brings the overlay up only if the operation is still running
-     * 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 timer that must be disposed with `clear()` when the operation ends.
-     */
-    busyTimer(message?: string, due?: number): BusyTimer;
-    /**
-     * Takes the busy overlay away.
-     *
-     * By default it waits a short grace period, so that a chain of quick operations does not make
-     * the overlay blink between one and the next; any `setBusy()` in the meantime cancels the
-     * pending removal. Pass `true` when something is about to be drawn underneath it and the wait
-     * would be visible — that is what `DialogService.open()` does.
-     * @param immediate - When `true`, removes the overlay without waiting for the grace period.
-     * @returns void
-     */
-    clearBusy(immediate?: boolean): void;
-    /**
-     * Hides the busy overlay without destroying it, so the next call can reuse the instance.
-     * @returns void
-     */
-    private hideBusy;
-    /**
-     * Returns the busy component, creating and attaching it the first time it is needed.
-     * @returns The reused busy component reference.
-     */
-    private ensureBusy;
-    /**
-     * Brings the message currently on screen back to the front of the top layer, if there is one.
-     *
-     * Called by `DialogService` after opening a dialog: an error the user has not dismissed yet
-     * must stay above whatever is opened underneath it.
-     * @returns void
-     */
-    raiseMessage(): void;
-    /**
-     * Whether the browser can promote an element to the top layer through the Popover API.
-     *
-     * Angular CDK 22 opens every overlay as `popover="manual"`, so a Material dialog does not sit
-     * at z-index 1000 any more: it sits in the top layer, which is painted above the whole page
-     * whatever the z-index of the page says. The only way to put something above it is to be in
-     * the top layer too. Where the API is missing the overlays fall back to their z-index, which
-     * is also the CDK's own fallback and therefore still the right order.
-     * @returns `true` when `showPopover()` is available.
-     */
-    private supportsTopLayer;
-    /**
-     * Promotes an overlay to the top layer, marking it as a manual popover the first time.
-     *
-     * `manual` and not `auto`: an `auto` popover is light-dismissed by a click anywhere and closed
-     * by Escape without telling anyone, which would take the panel off the screen behind the back
-     * of the component that owns it.
-     * @param el - The host element of the overlay. Ignored when undefined.
-     * @returns void
-     */
-    private enterTopLayer;
-    /**
-     * Takes an overlay out of the top layer.
-     * @param el - The host element of the overlay. Ignored when undefined.
-     * @returns void
-     */
-    private leaveTopLayer;
-    /**
-     * Moves an overlay back to the front of the top layer.
-     *
-     * The top layer is a stack ordered by promotion, so the only way to raise an element already
-     * in it is to take it out and put it back.
-     * @param el - The host element of the overlay. Ignored when undefined.
-     * @returns void
-     */
-    private raiseTopLayer;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
+export declare class ShellService {
+  private readonly appRef;
+  private readonly environmentInjector;
+  private messageRef?;
+  private messageKind?;
+  private messageClosed?;
+  private previousOverflow?;
+  private previouslyFocused?;
+  private busyRef?;
+  private busyVisible;
+  private busyActionSubscription?;
+  private clearBusyTimer?;
+  /** Cached answer of {@link supportsTopLayer}, resolved the first time an overlay is shown. */
+  private topLayerSupport?;
+  /**
+   * Shows an informational message.
+   * @param message      - HTML message to display.
+   * @param title        - Heading. Defaults to `'Informazioni'`.
+   * @param okCaption    - Dismiss button label. Defaults to `'Ok'`.
+   * @param width        - Maximum panel width in pixels. Defaults to `500`.
+   * @param dismissAfter - Auto-close delay in milliseconds (optional).
+   * @param details      - Optional secondary details text.
+   * @returns A handle over the open message, or `null` outside the browser.
+   */
+  info(message: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number, details?: string): ShellMessageRef | null;
+  /**
+   * Shows an error message. When one is already on screen its content is replaced in place: a
+   * failing API answers many requests at once, and each of them must not add a panel of its own.
+   * @param message      - HTML error message to display.
+   * @param log          - Optional technical log or stack trace shown in the details panel.
+   * @param title        - Heading. Defaults to `'Errore'`.
+   * @param okCaption    - Dismiss button label. Defaults to `'Ok'`.
+   * @param width        - Maximum panel width in pixels. Defaults to `500`.
+   * @param dismissAfter - Auto-close delay in milliseconds (optional).
+   * @returns A handle over the open message, or `null` outside the browser.
+   */
+  error(message: string, log?: string, title?: string, okCaption?: string, width?: number, dismissAfter?: number): ShellMessageRef | null;
+  /**
+   * Closes the message currently on screen, if any. Does not touch the busy overlay.
+   * @returns void
+   */
+  closeMessage(): void;
+  /**
+   * Opens the message panel, or updates the one already open when it is showing the same kind of
+   * message.
+   * @param kind - Whether this is an informational or an error message.
+   * @param data - The content to display.
+   * @returns A handle over the open message, or `null` outside the browser.
+   */
+  private showMessage;
+  /**
+   * Builds the handle returned to callers.
+   *
+   * The subject is captured now rather than read at call time, so `afterClosed()` keeps
+   * answering about the message this handle was given for, even once another one has taken
+   * its place on screen.
+   * @returns The handle over the message currently on screen.
+   */
+  private messageHandle;
+  /**
+   * Shows or updates the busy overlay.
+   *
+   * Called dozens of times per screen, so it creates nothing after the first time: the component
+   * is built once and then kept, and showing it again is a class on the host element. The state
+   * is written to signals and checked synchronously before returning, so the message on screen is
+   * always the last one asked for — a second `busy()` in the same task never leaves the previous
+   * text behind.
+   * @param message      - Text to display. An empty string keeps the current one.
+   * @param progress     - Progress value (`-1` = indeterminate). Defaults to `-1`.
+   * @param progressMode - Progress mode. Defaults to `'indeterminate'`.
+   * @param type         - Visual style of the overlay. Defaults to `'bar'`.
+   * @param action       - Optional observable; the overlay is dismissed when it first emits. It
+   *                       replaces the one passed to a previous call, which is unsubscribed.
+   * @returns `true` if the overlay was brought up by this call, `false` if it was already up.
+   */
+  setBusy(message: string, progress?: number, progressMode?: ShellBusyMode, type?: ShellBusyType, 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 mode. Defaults to `'indeterminate'`.
+   * @param action       - Optional observable; the overlay is dismissed when it emits.
+   * @returns `true` if the overlay was brought up by this call.
+   */
+  busy(message: string, progress?: number, progressMode?: ShellBusyMode, 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 the overlay was brought up by this call.
+   */
+  busySpinner(message: string, progress?: number, progressMode?: ShellBusyMode, action?: Observable<unknown>): boolean;
+  /**
+   * 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 the overlay was brought up by this call.
+   */
+  busyHourglass(message: string, action?: Observable<unknown>): boolean;
+  /**
+   * Shows a bare wait indicator, with no panel and no message.
+   * @param action - Optional observable; the overlay is dismissed when it emits.
+   * @returns `true` if the overlay was brought up by this call.
+   */
+  wait(action?: Observable<unknown>): boolean;
+  /**
+   * Returns a {@link BusyTimer} that brings the overlay up only if the operation is still running
+   * 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 timer that must be disposed with `clear()` when the operation ends.
+   */
+  busyTimer(message?: string, due?: number): BusyTimer;
+  /**
+   * Takes the busy overlay away.
+   *
+   * By default it waits a short grace period, so that a chain of quick operations does not make
+   * the overlay blink between one and the next; any `setBusy()` in the meantime cancels the
+   * pending removal. Pass `true` when something is about to be drawn underneath it and the wait
+   * would be visible — that is what `DialogService.open()` does.
+   * @param immediate - When `true`, removes the overlay without waiting for the grace period.
+   * @returns void
+   */
+  clearBusy(immediate?: boolean): void;
+  /**
+   * Hides the busy overlay without destroying it, so the next call can reuse the instance.
+   * @returns void
+   */
+  private hideBusy;
+  /**
+   * Returns the busy component, creating and attaching it the first time it is needed.
+   * @returns The reused busy component reference.
+   */
+  private ensureBusy;
+  /**
+   * Brings the message currently on screen back to the front of the top layer, if there is one.
+   *
+   * Called by `DialogService` after opening a dialog: an error the user has not dismissed yet
+   * must stay above whatever is opened underneath it.
+   * @returns void
+   */
+  raiseMessage(): void;
+  /**
+   * Whether the browser can promote an element to the top layer through the Popover API.
+   *
+   * Angular CDK 22 opens every overlay as `popover="manual"`, so a Material dialog does not sit
+   * at z-index 1000 any more: it sits in the top layer, which is painted above the whole page
+   * whatever the z-index of the page says. The only way to put something above it is to be in
+   * the top layer too. Where the API is missing the overlays fall back to their z-index, which
+   * is also the CDK's own fallback and therefore still the right order.
+   * @returns `true` when `showPopover()` is available.
+   */
+  private supportsTopLayer;
+  /**
+   * Promotes an overlay to the top layer, marking it as a manual popover the first time.
+   *
+   * `manual` and not `auto`: an `auto` popover is light-dismissed by a click anywhere and closed
+   * by Escape without telling anyone, which would take the panel off the screen behind the back
+   * of the component that owns it.
+   * @param el - The host element of the overlay. Ignored when undefined.
+   * @returns void
+   */
+  private enterTopLayer;
+  /**
+   * Takes an overlay out of the top layer.
+   * @param el - The host element of the overlay. Ignored when undefined.
+   * @returns void
+   */
+  private leaveTopLayer;
+  /**
+   * Moves an overlay back to the front of the top layer.
+   *
+   * The top layer is a stack ordered by promotion, so the only way to raise an element already
+   * in it is to take it out and put it back.
+   * @param el - The host element of the overlay. Ignored when undefined.
+   * @returns void
+   */
+  private raiseTopLayer;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShellService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /**
  * Shows the busy overlay only if the operation is still running after a debounce delay, so that
  * an operation that answers in 30 ms never makes the screen flash.
@@ -333,24 +329,23 @@ declare class ShellService {
  * Whoever creates one owns it: {@link clear} must be called when the operation ends, otherwise
  * the overlay appears after the fact and stays.
  */
-declare class BusyTimer {
-    private readonly shellService;
-    private readonly subscription;
-    /**
-     * Arms the timer.
-     * @param shellService - The service that owns the overlay. A `DialogService` is accepted too,
-     *                       since it extends `ShellService`.
-     * @param due          - Delay in milliseconds before the overlay appears. Defaults to `100`.
-     * @param message      - Text to display. Defaults to `'Operazione in corso...'`.
-     */
-    constructor(shellService: ShellService, due?: number, message?: string);
-    /**
-     * Disarms the timer and takes the overlay away.
-     * @returns void
-     */
-    clear(): void;
+export declare class BusyTimer {
+  private readonly shellService;
+  private readonly subscription;
+  /**
+   * Arms the timer.
+   * @param shellService - The service that owns the overlay. A `DialogService` is accepted too,
+   *                       since it extends `ShellService`.
+   * @param due          - Delay in milliseconds before the overlay appears. Defaults to `100`.
+   * @param message      - Text to display. Defaults to `'Operazione in corso...'`.
+   */
+  constructor(shellService: ShellService, due?: number, message?: string);
+  /**
+   * Disarms the timer and takes the overlay away.
+   * @returns void
+   */
+  clear(): void;
 }
-
 /**
  * The shell's message panel: a modal that looks like a Material dialog and owes nothing to
  * Material.
@@ -365,100 +360,99 @@ declare class BusyTimer {
  * Instantiated imperatively by {@link ShellService}, never declared in a template: that is
  * what lets an interceptor open it.
  */
-declare class ShellMessageComponent {
-    /** Emitted when the user dismisses the message, whichever way they did it. */
-    readonly closed: _angular_core.OutputEmitterRef<void>;
-    private readonly themeService;
-    private readonly panel;
-    private readonly okButton;
-    /** Unique id tying the panel to its heading for assistive technology. */
-    protected readonly titleId: string;
-    /** Unique id tying the details panel to the header that opens it. */
-    protected readonly detailsId: string;
-    /**
-     * Whether the technical details are open.
-     *
-     * Closed on arrival, and closed again by every {@link setData}: the message is what the user is
-     * meant to read, and a stack trace unfolded under it is noise until they ask for it.
-     */
-    protected readonly detailsOpen: _angular_core.WritableSignal<boolean>;
-    /** Current content, with the defaults the shell relies on already applied. */
-    protected readonly data: _angular_core.WritableSignal<ShellMessageData>;
-    /** True for a moment after a successful copy, so the button can acknowledge it. */
-    protected readonly copied: _angular_core.WritableSignal<boolean>;
-    private dismissTimer?;
-    private copiedTimer?;
-    private closing;
-    /**
-     * True when the panel must paint itself dark.
-     *
-     * Read from {@link ThemeService} and not from `prefers-color-scheme`, because the two do not
-     * always agree: the service is what the user chose, and it may be forcing dark on a machine
-     * that is on light. Following the OS instead would leave this panel the only light thing on a
-     * dark screen.
-     */
-    protected readonly dark: _angular_core.WritableSignal<boolean>;
-    /**
-     * Keeps {@link dark} in step with the service, now and at every later change.
-     *
-     * `'auto'` is resolved through `getTheme()`, which is the only thing that knows what the
-     * operating system is currently on.
-     * @returns void
-     */
-    private followTheme;
-    constructor();
-    /**
-     * Replaces the content shown by the panel and restarts the auto-dismiss timer.
-     *
-     * Called on an already open panel by `ShellService.error()` so that a burst of failures
-     * updates one message instead of stacking modals nobody can dismiss.
-     * @param data - The new content to display.
-     * @returns void
-     */
-    setData(data: ShellMessageData): void;
-    /**
-     * Opens or closes the technical details panel.
-     * @returns void
-     */
-    protected toggleDetails(): void;
-    /**
-     * Dismisses the panel. Safe to call more than once: only the first call is announced.
-     * @returns void
-     */
-    close(): void;
-    /**
-     * Closes the panel on Escape, mirroring a Material dialog opened with the default config.
-     * @param e - The keyboard event captured at document level.
-     * @returns void
-     */
-    protected onKeydown(e: KeyboardEvent): void;
-    /**
-     * Keeps Tab inside the panel while the message is up.
-     *
-     * A hand-rolled two-element version of what `cdk/a11y` does, which is all this panel needs:
-     * it never holds more than the copy button and the dismiss button.
-     * @param e - The Tab keydown event.
-     * @returns void
-     */
-    private trapFocus;
-    /**
-     * (Re)schedules the auto-dismiss timer, cancelling any pending one so a timer armed for an
-     * earlier message can never close a newer one.
-     * @param dismissAfter - Delay in milliseconds; no-op when falsy.
-     * @returns void
-     */
-    private scheduleDismiss;
-    /**
-     * Copies the message and its details to the clipboard, as both HTML and plain text.
-     *
-     * Unlike `InfoDialogComponent` there is no toast to report the outcome — the shell has no
-     * toast — so the button itself acknowledges it for a moment.
-     * @returns A promise that resolves once the copy has been attempted.
-     */
-    protected copy(): Promise<void>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellMessageComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ShellMessageComponent, "ars-shell-message", never, {}, { "closed": "closed"; }, never, never, true, never>;
-}
-
-export { BusyTimer, ShellBusyComponent, ShellMessageComponent, ShellService };
-export type { ShellBusyMode, ShellBusyType, ShellMessageData, ShellMessageRef };
+export declare class ShellMessageComponent {
+  /** Emitted when the user dismisses the message, whichever way they did it. */
+  readonly closed: import("@angular/core").OutputEmitterRef<void>;
+  private readonly themeService;
+  private readonly panel;
+  private readonly okButton;
+  /** Unique id tying the panel to its heading for assistive technology. */
+  protected readonly titleId: string;
+  /** Unique id tying the details panel to the header that opens it. */
+  protected readonly detailsId: string;
+  /**
+   * Whether the technical details are open.
+   *
+   * Closed on arrival, and closed again by every {@link setData}: the message is what the user is
+   * meant to read, and a stack trace unfolded under it is noise until they ask for it.
+   */
+  protected readonly detailsOpen: import("@angular/core").WritableSignal<boolean>;
+  /** Current content, with the defaults the shell relies on already applied. */
+  protected readonly data: import("@angular/core").WritableSignal<ShellMessageData>;
+  /** True for a moment after a successful copy, so the button can acknowledge it. */
+  protected readonly copied: import("@angular/core").WritableSignal<boolean>;
+  private dismissTimer?;
+  private copiedTimer?;
+  private closing;
+  /**
+   * True when the panel must paint itself dark.
+   *
+   * Read from {@link ThemeService} and not from `prefers-color-scheme`, because the two do not
+   * always agree: the service is what the user chose, and it may be forcing dark on a machine
+   * that is on light. Following the OS instead would leave this panel the only light thing on a
+   * dark screen.
+   */
+  protected readonly dark: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * Keeps {@link dark} in step with the service, now and at every later change.
+   *
+   * `'auto'` is resolved through `getTheme()`, which is the only thing that knows what the
+   * operating system is currently on.
+   * @returns void
+   */
+  private followTheme;
+  constructor();
+  /**
+   * Replaces the content shown by the panel and restarts the auto-dismiss timer.
+   *
+   * Called on an already open panel by `ShellService.error()` so that a burst of failures
+   * updates one message instead of stacking modals nobody can dismiss.
+   * @param data - The new content to display.
+   * @returns void
+   */
+  setData(data: ShellMessageData): void;
+  /**
+   * Opens or closes the technical details panel.
+   * @returns void
+   */
+  protected toggleDetails(): void;
+  /**
+   * Dismisses the panel. Safe to call more than once: only the first call is announced.
+   * @returns void
+   */
+  close(): void;
+  /**
+   * Closes the panel on Escape, mirroring a Material dialog opened with the default config.
+   * @param e - The keyboard event captured at document level.
+   * @returns void
+   */
+  protected onKeydown(e: KeyboardEvent): void;
+  /**
+   * Keeps Tab inside the panel while the message is up.
+   *
+   * A hand-rolled two-element version of what `cdk/a11y` does, which is all this panel needs:
+   * it never holds more than the copy button and the dismiss button.
+   * @param e - The Tab keydown event.
+   * @returns void
+   */
+  private trapFocus;
+  /**
+   * (Re)schedules the auto-dismiss timer, cancelling any pending one so a timer armed for an
+   * earlier message can never close a newer one.
+   * @param dismissAfter - Delay in milliseconds; no-op when falsy.
+   * @returns void
+   */
+  private scheduleDismiss;
+  /**
+   * Copies the message and its details to the clipboard, as both HTML and plain text.
+   *
+   * Unlike `InfoDialogComponent` there is no toast to report the outcome — the shell has no
+   * toast — so the button itself acknowledges it for a moment.
+   * @returns A promise that resolves once the copy has been attempted.
+   */
+  protected copy(): Promise<void>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShellMessageComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ShellMessageComponent, "ars-shell-message", never, {}, {
+    "closed": "closed";
+  }, never, never, true, never>;
+}