better-toast 0.2.0 → 0.2.1

package/types/better-toast.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Type, OnInit } from '@angular/core';
+import { Type } 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];
@@ -49,7 +49,7 @@ 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`),
+ * Each value is either an **Angular standalone component** class (rendered dynamically in the icon slot),
  * 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}
@@ -136,8 +136,8 @@ type ToastCancelMethodOptions = Omit<ToastOptions, 'icon' | 'classNames'> & {
 /**
  * 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}).
+ * **`toastId`** is always injected after your inputs. The component should declare `toastId` with `input()`.
+ * so the outlet can bind it (same requirement as {@link ToasterService.headless}).
  */
 interface CustomToastOptions extends ToastOptions {
     inputs?: Record<string, unknown>;
@@ -192,7 +192,7 @@ interface ToastOptions {
 }
 /**
  * Options for {@link ToasterService.headless}.
- * The component must be **standalone** (or otherwise valid for `NgComponentOutlet`).
+ * The component must be **standalone** (or otherwise valid for `ViewContainerRef.createComponent`).
  * Headless toasts ignore `<app-toaster [closeButton]>`: no dismiss control is rendered.
  *
  * Per-toast **`icon`** and **`style`** are omitted: the inner component owns visuals; use
@@ -205,8 +205,7 @@ interface ToastOptions {
  */
 interface HeadlessToastOptions extends Omit<ToastOptions, 'icon' | 'style'> {
     /**
-     * Values passed to the component’s `input()` / `@Input()` bindings
-     * (same shape as `NgComponentOutlet` `inputs`).
+     * Values passed to the component’s `input()` bindings.
      */
     inputs?: Record<string, unknown>;
 }
@@ -221,13 +220,13 @@ interface ToasterItem {
      * via {@link ToasterService.custom}.
      */
     readonly contentComponent?: Type<unknown>;
-    /** Bound to {@link ToasterItem.contentComponent} via `NgComponentOutlet` (includes auto **`toastId`**). */
+    /** Bound to {@link ToasterItem.contentComponent} by the toast outlet (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`. */
+    /** Bound to the headless component by the toast outlet. */
     readonly componentInputs?: Record<string, unknown>;
     /** Per-toast override; see {@link ToastOptions.icon}. */
     readonly icon?: Type<unknown> | null;
@@ -359,10 +358,10 @@ declare class ToasterService {
      * 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.
+     * Pass {@link CustomToastOptions.inputs} for `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 component The component class (must work with `ViewContainerRef.createComponent`).
      * @param options Optional configuration object {@link CustomToastOptions}.
      * @returns The toast ID, useful for programmatic dismissal.
      */
@@ -374,7 +373,7 @@ declare class ToasterService {
      * 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 component The component class (must work with `ViewContainerRef.createComponent`).
      * @param options Optional configuration object {@link HeadlessToastOptions}.
      * @returns The toast ID, useful for programmatic dismissal.
      */
@@ -428,6 +427,7 @@ declare class ToasterService {
      * Clear all toast notifications.
      */
     clear(): void;
+    private pushToast;
     private add;
     private addContentComponent;
     private addComponent;
@@ -437,6 +437,7 @@ declare class ToasterService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToasterService>;
 }
 
+declare function resolveToasterOffsetSide(offset: ToasterOffset | undefined, side: 'top' | 'right' | 'bottom' | 'left'): string | undefined;
 /**
  * Renders the toaster stack. Add once near the root of your app (e.g. in `App`).
  * With `[stacked]="true"` (default), extra toasts collapse into a 3-layer card stack (latest in front); hover, focus, or a press on touch expands the full list.
@@ -453,7 +454,7 @@ declare class ToasterService {
  * 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 {
+declare class BetterToaster {
     protected readonly toaster: ToasterService;
     /**
      * Default auto-dismiss time in ms for `show` / `success` / `error` / `info` / `warning` when the second argument omits `durationMs`.
@@ -528,22 +529,7 @@ declare class BetterToaster implements OnInit {
     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>;
+    protected readonly offsetSide: typeof resolveToasterOffsetSide;
     /**
      * `--index` is the stack depth: last item is 0 (front), older items count up.
      * Collapsed peek, scale, front, and hidden layers are CSS from that index / `:last-child`.
@@ -569,10 +555,6 @@ declare class BetterToaster implements OnInit {
     onStackFocusOut(event: FocusEvent): void;
     private pauseAllAutoDismiss;
     private resumeAllAutoDismiss;
-    /**
-     * 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; }; "stacked": { "alias": "stacked"; "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>;
 }