better-toast 0.0.1

package/types/better-toast.d.ts

@@ -0,0 +1,543 @@
+import * as _angular_core from '@angular/core';
+import { Type, OnInit } from '@angular/core';
+
+declare const TOASTER_POSITIONS: readonly ["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"];
+type ToasterPosition = (typeof TOASTER_POSITIONS)[number];
+/** Visual palette for the toast stack: follow the OS (`system`), or pin light / dark. */
+type ToasterTheme = 'light' | 'dark' | 'system';
+/**
+ * Viewport inset from `<app-toaster [offset]>` or `<app-toaster [mobileOffset]>`.
+ *
+ * Used with **`[offset]`** for `--toast-offset-*` (wide layout / shared vars) and **`[mobileOffset]`** for `--toast-offset-mobile-*` (narrow layout in `toaster.css`).
+ *
+ * - A **string** sets all four sides to the same CSS value (e.g. `"24px"`, `"1rem env(safe-area-inset-top)"`).
+ * - An **object** sets only the sides you pass; omitted sides keep the defaults from `toaster.css`.
+ */
+type ToasterOffset = string | {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+};
+/**
+ * Milliseconds as a number, or the literal string **`"Infinity"`** (manual dismiss only). No other string values are supported.
+ * Used by `<app-toaster [duration]>` and {@link ToastOptions.durationMs}.
+ */
+type ToasterDuration = number | 'Infinity';
+/** Default `aria-label` for the toaster live region (`<section>`). */
+declare const DEFAULT_TOASTER_ARIA_NOTIFICATIONS_REGION = "Notifications";
+/** Default `aria-label` for the per-toast dismiss (close) control. */
+declare const DEFAULT_TOASTER_ARIA_DISMISS_BUTTON = "Dismiss";
+/**
+ * Overrides for built-in English accessibility strings on `<better-toaster [accessibilityLabels]>`.
+ * Omitted keys keep the library defaults.
+ */
+interface ToasterAccessibilityLabels {
+    /**
+     * `aria-label` on the polite live region wrapper (`<section>`).
+     * Default {@link DEFAULT_TOASTER_ARIA_NOTIFICATIONS_REGION}.
+     */
+    notificationsRegion?: string;
+    /**
+     * `aria-label` on the dismiss control when `<better-toaster [closeButton]>` is true.
+     * Default {@link DEFAULT_TOASTER_ARIA_DISMISS_BUTTON}.
+     */
+    dismissButton?: string;
+}
+declare const TOAST_VARIANTS: readonly ["default", "description", "success", "error", "info", "warning", "loading"];
+type ToastVariant = (typeof TOAST_VARIANTS)[number];
+/**
+ * Per-variant icon overrides for `<app-toaster [icons]>`.
+ *
+ * Each value is either an **Angular standalone component** class (rendered with `NgComponentOutlet`),
+ * or **`null`** to show no icon for that variant. Omitted keys keep the library defaults.
+ *
+ * The **`default`** variant has no built-in icon; set `default` here (or pass {@link ToastOptions.icon}
+ * on a single toast) to show one. Omitting `default` keeps default toasts text-only.
+ */
+type ToasterIcons = Partial<Record<ToastVariant, Type<unknown> | null>>;
+/**
+ * Extra classes for host, message, and close control only.
+ * Used by {@link ToastOptions.classNames} and {@link HeadlessToastOptions.classNames}.
+ *
+ * Row button defaults (`.action-btn` / `.cancel-btn`) can be set on {@link ToasterToastOptions.classNames} ({@link ToastChromeClassNames})
+ * or overridden per call via {@link ToastActionChromeClassNames} / {@link ToastCancelChromeClassNames}.
+ *
+ * The library ships encapsulated styles (`toast-item.css`, etc.). Global rules for your class names often **lose to those defaults**, so properties you expect to change **usually need `!important`** (or stronger specificity) to actually apply.
+ */
+type ToastBaseChromeClassNames = Partial<Record<'toast' | 'message' | 'description' | 'closeButton', string>>;
+/**
+ * Merged shape after combining toaster defaults with a toast item (may include row-button keys when that toast has a row button).
+ * The library still uses this internally on {@link ToasterItem} and for `[class]` resolution.
+ */
+type ToastChromeClassNames = ToastBaseChromeClassNames & {
+    actionButton?: string;
+    cancelButton?: string;
+};
+/** `classNames` for {@link ToasterService.action} — includes `.action-btn` only among row buttons. */
+type ToastActionChromeClassNames = ToastBaseChromeClassNames & {
+    actionButton?: string;
+};
+/** `classNames` for {@link ToasterService.cancel} — includes `.cancel-btn` only among row buttons. */
+type ToastCancelChromeClassNames = ToastBaseChromeClassNames & {
+    cancelButton?: string;
+};
+/**
+ * Defaults for every toast from `<app-toaster [toastOptions]>`.
+ * Per-toast {@link ToastOptions} override these (e.g. `style` / `classNames` keys on a single toast win over the same keys here).
+ */
+interface ToasterToastOptions {
+    /**
+     * Inline CSS on each toast host (`li.toast` / `AppToastItem`).
+     * Merged with per-toast {@link ToastOptions.style}; toast-specific values override.
+     */
+    style?: Record<string, string | number | undefined>;
+    /**
+     * Extra CSS class strings merged onto toast chrome via Angular **`[class]`** bindings (from `<app-toaster [toastOptions]>`).
+     *
+     * - **`toast`** — list item host (`li.toast` / `AppToastItem`), alongside the built-in `toast` class.
+     * - **`message`** — the title line (`.msg`) when the toast is not a headless body or {@link ToasterItem.contentComponent} body.
+     * - **`description`** — the secondary line (`.description`) when {@link ToastOptions.description} is set or for the **`description`** variant.
+     * - **`closeButton`** — the dismiss control (`.close-btn`) when `<app-toaster [closeButton]>` is enabled.
+     * - **`actionButton`** / **`cancelButton`** — defaults for `.action-btn` / `.cancel-btn` when you use {@link ToasterService.action} / {@link ToasterService.cancel}; ignored on toasts without a row button.
+     *
+     * Per-toast {@link ToastOptions.classNames} cannot set row-button keys; override them on each {@link ToastActionMethodOptions} / {@link ToastCancelMethodOptions} call instead.
+     *
+     * Omitted keys add no extra classes for that part; values are typically space-separated class names (same as a static `class` attribute).
+     *
+     * **Overriding built-in look:** your CSS generally needs **`!important`** on the declarations that must win.
+     */
+    classNames?: ToastChromeClassNames;
+}
+/** Label + handler for {@link ToasterService.action} / {@link ToasterService.cancel}. */
+interface ToastMethodButtonConfig {
+    /** Visible button text; defaults to `"Action"` or `"Cancel"` depending on the method. */
+    label?: string;
+    /**
+     * Receives the row button click event. Call {@link Event.preventDefault} to keep the toast open
+     * (the library skips {@link ToasterService.dismiss} when `defaultPrevented` is true).
+     */
+    onClick: (event: Event) => void;
+}
+/**
+ * Options for {@link ToasterService.action} only. Use the `action` field (not available on {@link ToastOptions}).
+ */
+type ToastActionMethodOptions = Omit<ToastOptions, 'icon' | 'classNames'> & {
+    action: ToastMethodButtonConfig;
+    classNames?: ToastActionChromeClassNames;
+};
+/**
+ * Options for {@link ToasterService.cancel} only. Use the `cancel` field (not available on {@link ToastOptions}).
+ */
+type ToastCancelMethodOptions = Omit<ToastOptions, 'icon' | 'classNames'> & {
+    cancel: ToastMethodButtonConfig;
+    classNames?: ToastCancelChromeClassNames;
+};
+/**
+ * Options for {@link ToasterService.custom}.
+ * {@link CustomToastOptions.inputs} is merged into the body component (same pattern as {@link HeadlessToastOptions.inputs});
+ * **`toastId`** is always injected after your inputs. The component must declare a matching `input()` / `@Input()` for **`toastId`**
+ * so `NgComponentOutlet` can bind it (same requirement as {@link ToasterService.headless}).
+ */
+interface CustomToastOptions extends ToastOptions {
+    inputs?: Record<string, unknown>;
+}
+/**
+ * Options for the second argument of `show`, `success`, `error`, `info`, `warning`, `loading`,
+ * and {@link ToasterService#description}.
+ * {@link ToasterService.custom} uses {@link CustomToastOptions} instead.
+ * Not used by `ToasterService.promise()` (that API uses {@link ToastPromiseLabels}).
+ */
+interface ToastOptions {
+    /**
+     * Omit to use `<app-toaster [duration]>` (or the library default).
+     * Use the literal **`"Infinity"`**, `Number.POSITIVE_INFINITY`, or `TOAST_DURATION_MANUAL_DISMISS` to persist until dismissed; `0` is still accepted for the same behavior.
+     * `loading()` defaults to manual dismiss when `durationMs` is omitted.
+     */
+    durationMs?: ToasterDuration;
+    /**
+     * `undefined` = use global `[icons]` on `<app-toaster>` or built-in SVGs.
+     * `null` = no icon for this toast.
+     * Otherwise a standalone component class rendered like `[icons]` overrides.
+     */
+    icon?: Type<unknown> | null;
+    /**
+     * Inline CSS on the toast host (`li.toast` / `AppToastItem`).
+     * Merged after `<app-toaster [toastOptions]>` `style` (if any); per-toast keys override the same keys from the toaster.
+     */
+    style?: Record<string, string | number | undefined>;
+    /**
+     * Secondary line below {@link ToasterItem.message} in a column layout. Works on every toast helper
+     * (`show`, `success`, `error`, …). {@link ToasterService#description} uses the **`description`** variant
+     * (neutral chrome like `default`); you can still pass this on other variants for the same layout with their icons/colors.
+     */
+    description?: string;
+    /**
+     * Extra **`[class]`** strings for this toast only — same keys and **`!important`** guidance as {@link ToasterToastOptions.classNames}.
+     * Merged with `<app-toaster [toastOptions]>` `classNames` (if any); per-toast keys replace the same keys from the toaster.
+     *
+     * Row button keys (`actionButton` / `cancelButton`) are only valid on {@link ToastActionMethodOptions} / {@link ToastCancelMethodOptions}.
+     */
+    classNames?: ToastBaseChromeClassNames;
+    /**
+     * Called when the toast is removed for any reason other than auto-dismiss: close control, swipe,
+     * {@link ToasterService.dismiss}, or {@link ToasterService.clear}.
+     */
+    onDismiss?: () => void;
+    /**
+     * Called when the toast is removed because its auto-dismiss timer finished (including after hover
+     * pause when the remaining time elapses).
+     */
+    onAutoClose?: () => void;
+}
+/**
+ * Options for {@link ToasterService.headless}.
+ * The component must be **standalone** (or otherwise valid for `NgComponentOutlet`).
+ * Headless toasts ignore `<app-toaster [closeButton]>`: no dismiss control is rendered.
+ *
+ * Per-toast **`icon`** and **`style`** are omitted: the inner component owns visuals; use
+ * `<app-toaster [toastOptions]>` for shared host styling if needed. **`classNames`** still applies to the list-item host
+ * (and to `.msg` / `.close-btn` when that chrome exists).
+ *
+ * The host always passes a **`toastId`** input (same value as the id returned from `headless()`)
+ * so the component can call {@link ToasterService.dismiss} or read its own id. User `inputs` are
+ * merged first; **`toastId` always wins** if also present in `inputs`.
+ */
+interface HeadlessToastOptions extends Omit<ToastOptions, 'icon' | 'style'> {
+    /**
+     * Values passed to the component’s `input()` / `@Input()` bindings
+     * (same shape as `NgComponentOutlet` `inputs`).
+     */
+    inputs?: Record<string, unknown>;
+}
+interface ToasterItem {
+    readonly id: string;
+    readonly message: string;
+    /** Secondary line; see {@link ToastOptions.description}. */
+    readonly description?: string;
+    readonly variant: ToastVariant;
+    /**
+     * When set, the toast body is this standalone component rendered **inside** normal chrome (icon column when applicable, `.msg` host, close button),
+     * via {@link ToasterService.custom}.
+     */
+    readonly contentComponent?: Type<unknown>;
+    /** Bound to {@link ToasterItem.contentComponent} via `NgComponentOutlet` (includes auto **`toastId`**). */
+    readonly contentComponentInputs?: Record<string, unknown>;
+    /**
+     * When set (without {@link ToasterItem.contentComponent}), the toast body is this standalone component only — same stack and motion as other toasts, without host chrome or a close button.
+     */
+    readonly component?: Type<unknown>;
+    /** Bound to the headless component via `NgComponentOutlet`. */
+    readonly componentInputs?: Record<string, unknown>;
+    /** Per-toast override; see {@link ToastOptions.icon}. */
+    readonly icon?: Type<unknown> | null;
+    /** Per-toast host inline styles; see {@link ToastOptions.style}. */
+    readonly style?: Record<string, string | number | undefined>;
+    /** Per-toast extra classes; see {@link ToastOptions.classNames}. */
+    readonly classNames?: ToastChromeClassNames;
+    /** See {@link ToastOptions.onDismiss}. */
+    readonly onDismiss?: () => void;
+    /** See {@link ToastOptions.onAutoClose}. */
+    readonly onAutoClose?: () => void;
+    /**
+     * Primary row action from {@link ToasterService.action} or {@link ToasterService.cancel}.
+     * Renders a text button next to the message (no icon column).
+     */
+    readonly toastAction?: {
+        readonly role: 'action' | 'cancel';
+        readonly label: string;
+        /** Same contract as {@link ToastMethodButtonConfig.onClick}. */
+        readonly onClick: (event: Event) => void;
+    };
+}
+/**
+ * Labels for `ToasterService.promise` (loading vs settled states).
+ * `success` / `error` may be static strings or functions that receive the settled value / rejection reason.
+ */
+interface ToastPromiseLabels<T = unknown> {
+    readonly loading: string;
+    readonly success: string | ((data: T) => string);
+    readonly error: string | ((reason: unknown) => string);
+}
+
+/** Fallback when `<app-toaster [duration]>` is absent and a helper omits `durationMs`. */
+declare const DEFAULT_TOAST_DURATION_MS = 4000;
+/** Default label for {@link ToasterService.action} when {@link ToastMethodButtonConfig.label} is omitted. */
+declare const DEFAULT_TOAST_ACTION_LABEL = "Action";
+/** Default label for {@link ToasterService.cancel} when {@link ToastMethodButtonConfig.label} is omitted. */
+declare const DEFAULT_TOAST_CANCEL_LABEL = "Cancel";
+/**
+ * Use with `[duration]` or `options.durationMs` so a toast stays until manually dismissed.
+ * (`0` is still treated as non-auto-dismiss for backward compatibility.)
+ */
+declare const TOAST_DURATION_MANUAL_DISMISS: number;
+declare class ToasterService {
+    private readonly _toasts;
+    private readonly autoDismissByToastId;
+    /** Updated by `<better-toaster [duration]>`; initial value is {@link DEFAULT_TOAST_DURATION_MS}. */
+    private defaultDurationMs;
+    /** Active messages, oldest first. */
+    readonly toasts: _angular_core.Signal<readonly ToasterItem[]>;
+    /**
+     * Synced from `<better-toaster [duration]>`; used when a service call omits `durationMs`.
+     * Does not change timers on toasts already shown.
+     */
+    setDefaultDurationMs(ms: number): void;
+    private resolveDuration;
+    /**
+     * Stops any auto-dismiss for this toast: clears a running timeout if present and drops timer state.
+     */
+    private cancelAutoDismiss;
+    /**
+     * (Re)starts auto-dismiss from a concrete duration in milliseconds.
+     * Idempotent per toast: always cancels any existing timer first.
+     * Manual dismiss (`Infinity`) and non-positive values do not schedule a timer.
+     */
+    private scheduleAutoDismiss;
+    /**
+     * Pauses the auto-dismiss timer while the pointer is over the toast (e.g. hover).
+     * No-op if the toast has no active auto-dismiss.
+     *
+     * @param id The toast ID.
+     */
+    pauseAutoDismiss(id: string): void;
+    /**
+     * Resumes a paused auto-dismiss with the remaining time from {@link pauseAutoDismiss}.
+     *
+     * @param id The toast ID.
+     */
+    resumeAutoDismiss(id: string): void;
+    /**
+     * Display a neutral (default) toast notification.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    show(message: string, options?: ToastOptions): string;
+    /**
+     * Display a toast using the **`description`** variant: same neutral chrome as **`default`**.
+     *
+     * @param message Title line.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    description(message: string, options?: ToastOptions): string;
+    /**
+     * Display a success toast notification.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    success(message: string, options?: ToastOptions): string;
+    /**
+     * Display an error toast notification.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    error(message: string, options?: ToastOptions): string;
+    /**
+     * Display an info toast notification.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    info(message: string, options?: ToastOptions): string;
+    /**
+     * Display a warning toast notification.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    warning(message: string, options?: ToastOptions): string;
+    /**
+     * Show a toast whose **message area** is a standalone Angular component while keeping normal toast chrome
+     * (surface, icon column when applicable, close button, stack motion).
+     *
+     * Pass {@link CustomToastOptions.inputs} for `input()` / `@Input()` on that component.
+     * The component also receives **`toastId`** (matches the returned id) for programmatic dismiss.
+     *
+     * @param component The component class (must be usable with `NgComponentOutlet`).
+     * @param options Optional configuration object {@link CustomToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    custom(component: Type<unknown>, options?: CustomToastOptions): string;
+    /**
+     * Show a toast whose body is a **standalone** Angular component on a headless host: no default border,
+     * padding, shadow, or surface color — only stack position and enter/leave animations; the component supplies all visuals.
+     *
+     * Pass {@link HeadlessToastOptions.inputs} to feed `input()` on that component.
+     * The component also automatically receives **`toastId`** (matches the returned id) for programmatic dismiss inside the component.
+     *
+     * @param component The component class (must be usable with `NgComponentOutlet`).
+     * @param options Optional configuration object {@link HeadlessToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    headless(component: Type<unknown>, options?: HeadlessToastOptions): string;
+    /**
+     * Display a loading toast notification.
+     *
+     * If `options.durationMs` is omitted, the toast stays until you dismiss or replace it (same as {@link TOAST_DURATION_MANUAL_DISMISS}).
+     * Passing a finite positive `durationMs` schedules auto-dismiss for loading toasts like other variants.
+     * The literal **`"Infinity"`** (or {@link TOAST_DURATION_MANUAL_DISMISS} / `0`) keeps the toast until dismissed.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    loading(message: string, options?: ToastOptions): string;
+    /**
+     * Toast with message and a single **action** button. Default action button label is {@link DEFAULT_TOAST_ACTION_LABEL}.
+     * Pass `action.label` and `action.onClick` in {@link ToastActionMethodOptions} to customize the action button.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastActionMethodOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    action(message: string, options: ToastActionMethodOptions): string;
+    /**
+     * Toast with message and a **cancel**-style button. Default cancel button label is {@link DEFAULT_TOAST_CANCEL_LABEL}.
+     * Pass `cancel.label` and `cancel.onClick` in {@link ToastCancelMethodOptions} to customize the cancel button.
+     *
+     * @param message The toast content.
+     * @param options Optional configuration object {@link ToastCancelMethodOptions}.
+     * @returns The toast ID, useful for programmatic dismissal.
+     */
+    cancel(message: string, options: ToastCancelMethodOptions): string;
+    /**
+     * Shows one toast: loading until `userPromise` settles, then the same toast updates to success or error.
+     * Returns the same promise (fulfillment/rejection preserved for callers).
+     *
+     * @param userPromise The promise to display.
+     * @param labels The labels for the loading, success, and error states.
+     * @returns The promise (fulfillment/rejection preserved for callers).
+     */
+    promise<T>(userPromise: PromiseLike<T>, labels: ToastPromiseLabels<T>): Promise<T>;
+    /**
+     * Dismiss a toast notification.
+     *
+     * @param id The toast ID.
+     */
+    dismiss(id: string): void;
+    /**
+     * Clear all toast notifications.
+     */
+    clear(): void;
+    private add;
+    private addContentComponent;
+    private addComponent;
+    private updateToast;
+    private removeToast;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToasterService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToasterService>;
+}
+
+/**
+ * Renders the toaster stack. Add once near the root of your app (e.g. in `App`).
+ * Variant-colored surfaces are off by default; set `[richColors]="true"` to enable them.
+ * Set `[duration]` for auto-dismiss when service helpers omit their duration argument.
+ * Use **`duration="Infinity"`** (that exact literal) or `[duration]="…"` with a number / {@link TOAST_DURATION_MANUAL_DISMISS} for persist until dismissed; `0` still works.
+ * Pass `[icons]` with optional **standalone** components for `default` / `description` / `success` / `error` / `info` / `warning` / `loading`:
+ * replace the default artwork (or add an icon for the neutral `default` variant), or use **`null`** to hide that variant’s icon.
+ * Each component should render an **SVG** (import its class where you configure `[icons]`).
+ * Set `[closeButton]="false"` to hide the per-toast dismiss button.
+ * Set `[accessibilityLabels]` to override default English `aria-label` strings (live region and dismiss control).
+ * Set `[offset]` for `--toast-offset-*` and `[mobileOffset]` for `--toast-offset-mobile-*` (string all sides, or per-side object).
+ * Set `[theme]` to `light`, `dark`, or `system` (default): semantic colors follow the chosen mode; `system` uses `prefers-color-scheme`.
+ * {@link ToasterService.action} / {@link ToasterService.cancel} render a message plus one text button (no icon column).
+ */
+declare class BetterToaster implements OnInit {
+    protected readonly toaster: ToasterService;
+    /**
+     * Default auto-dismiss time in ms for `show` / `success` / `error` / `info` / `warning` when the second argument omits `durationMs`.
+     * Bind **`duration="Infinity"`** (literal only) or a numeric ms value via `[duration]`; {@link TOAST_DURATION_MANUAL_DISMISS} is accepted as a number.
+     * `0` still works. Does not apply to `loading()`. Defaults to the library default (4000ms).
+     */
+    readonly durationMs: _angular_core.InputSignalWithTransform<number, ToasterDuration>;
+    /** Where the stack is anchored on the viewport. */
+    readonly position: _angular_core.InputSignal<"top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right">;
+    /**
+     * Viewport inset for the toast stack: a single CSS value for all sides, or an object with any of `top` / `right` / `bottom` / `left`.
+     * Binds `--toast-offset-top` / `right` / `bottom` / `left` on `.toast-container`.
+     */
+    readonly offset: _angular_core.InputSignal<ToasterOffset | undefined>;
+    /**
+     * Viewport inset for narrow layouts: binds `--toast-offset-mobile-top` / `right` / `bottom` / `left` on `.toast-container`.
+     * Same shape as {@link offset}.
+     */
+    readonly mobileOffset: _angular_core.InputSignal<ToasterOffset | undefined>;
+    /**
+     * When true, success/error/info/warning use semantic background and border colors.
+     */
+    readonly richColors: _angular_core.InputSignal<boolean>;
+    /**
+     * Color palette for the stack. `system` (default) follows `prefers-color-scheme`; `light` / `dark` pin the palette regardless of OS.
+     * Reflected as `data-theme` on the toast container (`<ol class="toast-container">`).
+     */
+    readonly theme: _angular_core.InputSignal<ToasterTheme>;
+    /**
+     * Optional per-variant **standalone** components that replace the default SVG (or loading indicator).
+     * Import each icon component in the host and pass its class here; each one should render an SVG
+     * (e.g. root `<svg>` with `stroke="currentColor"` / `fill="currentColor"` where appropriate).
+     * Omitted keys keep the built-in icons (the `default` variant has none unless you set `default` here).
+     * **`null`** for a variant hides that variant’s icon.
+     */
+    readonly icons: _angular_core.InputSignal<Partial<Record<"default" | "description" | "success" | "error" | "info" | "warning" | "loading", _angular_core.Type<unknown> | null>> | undefined>;
+    /**
+     * Defaults for every toast — shape is {@link ToasterToastOptions}.
+     *
+     * - **`style`** — merged onto each toast host with per-toast {@link ToastOptions.style}; identical keys from the service call win.
+     * - **`classNames`** — extra classes on host / `.msg` / `.description` / `.close-btn` / row buttons via **`[class]`**; see {@link ToasterToastOptions.classNames} (**`!important`** is usually required for overrides). Per-toast {@link ToastOptions.classNames} replaces host/message/close keys; row overrides come from {@link ToasterService.action} / {@link ToasterService.cancel}.
+     */
+    readonly toastOptions: _angular_core.InputSignal<ToasterToastOptions | undefined>;
+    /** When true, each toast shows a dismiss button. */
+    readonly closeButton: _angular_core.InputSignal<boolean>;
+    /**
+     * Overrides for built-in English `aria-label` values (live region and per-toast dismiss).
+     * Omitted keys keep {@link DEFAULT_TOASTER_ARIA_NOTIFICATIONS_REGION} and {@link DEFAULT_TOASTER_ARIA_DISMISS_BUTTON}.
+     */
+    readonly accessibilityLabels: _angular_core.InputSignal<ToasterAccessibilityLabels | undefined>;
+    /** Measured height in px per toast id, updated when a toast item reports `heightChange`. */
+    readonly heights: _angular_core.WritableSignal<Record<string, number>>;
+    /** Resolved `aria-label` for the outer `<section>` live region. */
+    protected readonly notificationsRegionAriaLabel: _angular_core.Signal<string>;
+    /** Resolved `aria-label` for each toast’s dismiss control. */
+    protected readonly dismissButtonAriaLabel: _angular_core.Signal<string>;
+    /** Vertical offset in px for the toast stack. */
+    protected readonly offsetTop: _angular_core.Signal<string | undefined>;
+    /** Horizontal offset in px for the toast stack. */
+    protected readonly offsetRight: _angular_core.Signal<string | undefined>;
+    /** Vertical offset in px for the toast stack. */
+    protected readonly offsetBottom: _angular_core.Signal<string | undefined>;
+    /** Horizontal offset in px for the toast stack. */
+    protected readonly offsetLeft: _angular_core.Signal<string | undefined>;
+    /** Vertical offset in px for the toast stack on narrow layouts. */
+    protected readonly mobileOffsetTop: _angular_core.Signal<string | undefined>;
+    /** Horizontal offset in px for the toast stack on narrow layouts. */
+    protected readonly mobileOffsetRight: _angular_core.Signal<string | undefined>;
+    /** Vertical offset in px for the toast stack on narrow layouts. */
+    protected readonly mobileOffsetBottom: _angular_core.Signal<string | undefined>;
+    /** Horizontal offset in px for the toast stack on narrow layouts. */
+    protected readonly mobileOffsetLeft: _angular_core.Signal<string | undefined>;
+    /**
+     * Vertical offset in px for each toast id so stacked toasts do not overlap.
+     * Walks newest-to-oldest (end of the list first): the latest toast has offset 0; each older toast sits above by the sum of heights below plus the inter-toast gap.
+     */
+    readonly offsets: _angular_core.Signal<Record<string, number>>;
+    /** Merges a toast item’s reported height into `heights` so `offsets` can recompute. */
+    onHeightChange(toastId: string, height: number): void;
+    /**
+     * Initializes the toaster service with the default duration.
+     */
+    ngOnInit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BetterToaster, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BetterToaster, "better-toaster", never, { "durationMs": { "alias": "duration"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; "mobileOffset": { "alias": "mobileOffset"; "required": false; "isSignal": true; }; "richColors": { "alias": "richColors"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; "icons": { "alias": "icons"; "required": false; "isSignal": true; }; "toastOptions": { "alias": "toastOptions"; "required": false; "isSignal": true; }; "closeButton": { "alias": "closeButton"; "required": false; "isSignal": true; }; "accessibilityLabels": { "alias": "accessibilityLabels"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { BetterToaster, DEFAULT_TOASTER_ARIA_DISMISS_BUTTON, DEFAULT_TOASTER_ARIA_NOTIFICATIONS_REGION, DEFAULT_TOAST_ACTION_LABEL, DEFAULT_TOAST_CANCEL_LABEL, DEFAULT_TOAST_DURATION_MS, TOASTER_POSITIONS, TOAST_DURATION_MANUAL_DISMISS, TOAST_VARIANTS, ToasterService };
+export type { CustomToastOptions, HeadlessToastOptions, ToastActionChromeClassNames, ToastActionMethodOptions, ToastBaseChromeClassNames, ToastCancelChromeClassNames, ToastCancelMethodOptions, ToastChromeClassNames, ToastMethodButtonConfig, ToastOptions, ToastPromiseLabels, ToastVariant, ToasterAccessibilityLabels, ToasterDuration, ToasterIcons, ToasterItem, ToasterOffset, ToasterPosition, ToasterTheme, ToasterToastOptions };