ng-hub-ui-toast 22.0.0

package/README.md

@@ -0,0 +1,201 @@
+# ng-hub-ui-toast
+
+[![NPM Version](https://img.shields.io/npm/v/ng-hub-ui-toast.svg)](https://www.npmjs.com/package/ng-hub-ui-toast)
+[![Angular](https://img.shields.io/badge/Angular-22-red.svg)](https://angular.dev)
+[![License](https://img.shields.io/npm/l/ng-hub-ui-toast.svg)](LICENSE)
+
+> Angular 22 standalone toast notification service built on Signals — part of the [ng-hub-ui](https://hubui.dev/) ecosystem.
+
+## Features
+
+- **Signal-driven stack** — active toasts live in a `signal<HubToastData[]>`; works with `OnPush` and zoneless apps.
+- **Lazy container mounting** — `ToastContainerComponent` is appended to `document.body` only on the first call; nothing runs at startup.
+- **`HubToastRef`** — every call returns a ref with `onShown`, `onHidden`, `onTap` observables and `manualClose()` / `resetTimeout()`.
+- **Per-call overrides** — set defaults globally with `provideToast()` and override any option individually.
+- **Six positions** — `toast-top-right`, `toast-top-left`, `toast-top-center`, `toast-bottom-right`, `toast-bottom-left`, `toast-bottom-center`.
+- **Progress bar & close button** — built-in configurable dismiss controls.
+- **CSS variable theming** — every colour, radius, shadow, and dimension is a `--hub-toast-*` token.
+- **Built-in semantic types** — `success`, `error`, `warning`, `info` each inherit the matching DS `--hub-sys-color-*` accent family.
+
+## Installation
+
+```bash
+npm install ng-hub-ui-toast
+```
+
+## Quick start
+
+```typescript
+// app.config.ts
+import { provideToast } from 'ng-hub-ui-toast';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideToast({ progressBar: true, timeOut: 4000 })
+  ]
+};
+```
+
+```typescript
+// any component or service
+import { ToastService } from 'ng-hub-ui-toast';
+
+@Component({ ... })
+export class SaveComponent {
+  private toast = inject(ToastService);
+
+  save() {
+    this.toast.success('Record saved.', 'Success');
+  }
+}
+```
+
+## API
+
+### `provideToast(config?)`
+
+Call once in `ApplicationConfig.providers`. All options are optional.
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `timeOut` | `number` | `5000` | Auto-dismiss delay (ms). `0` = persistent. |
+| `extendedTimeOut` | `number` | `2500` | Extra ms added while the user hovers. |
+| `closeButton` | `boolean` | `true` | Show a × close button. |
+| `progressBar` | `boolean` | `false` | Show a countdown progress bar. |
+| `tapToDismiss` | `boolean` | `true` | Dismiss on click. |
+| `disableTimeOut` | `boolean \| 'timeOut' \| 'extendedTimeOut'` | `false` | Disable the auto-dismiss timer. |
+| `newestOnTop` | `boolean` | `true` | Stack newest toasts at the top. |
+| `positionClass` | `HubToastPosition` | `'toast-top-right'` | Container position on screen. |
+| `maxOpened` | `number` | `0` | Max simultaneous toasts (`0` = unlimited). |
+| `autoDismiss` | `boolean` | `false` | Auto-remove oldest when `maxOpened` is reached. |
+| `preventDuplicates` | `boolean` | `false` | Drop new toasts with a matching visible message. |
+
+### `ToastService`
+
+| Method | Signature | Description |
+|---|---|---|
+| `success` | `(message, title?, config?) → HubToastRef` | Show a success toast. |
+| `error` | `(message, title?, config?) → HubToastRef` | Show an error toast. |
+| `warning` | `(message, title?, config?) → HubToastRef` | Show a warning toast. |
+| `info` | `(message, title?, config?) → HubToastRef` | Show an info toast. |
+| `show` | `(message, title?, config?, type?) → HubToastRef` | Show a toast with any type (including custom strings). |
+| `remove` | `(toastId: number) → void` | Remove one toast by id. |
+| `clear` | `() → void` | Remove all active toasts. |
+| `toasts` | `Signal<HubToastData[]>` | Read-only signal of the current stack. |
+
+### `HubToastRef`
+
+```typescript
+interface HubToastRef {
+  readonly toastId: number;
+  readonly onShown:  Observable<void>;   // fires once when toast enters DOM
+  readonly onHidden: Observable<void>;   // fires once when toast leaves DOM
+  readonly onTap:    Observable<void>;   // fires each time user clicks toast body
+  manualClose(): void;                   // removes immediately
+  resetTimeout(): void;                  // restarts the auto-dismiss timer
+}
+```
+
+### Lifecycle example
+
+```typescript
+const ref = this.toast.success('Upload complete', 'Done', { timeOut: 0 });
+
+ref.onTap.subscribe(() => this.router.navigate(['/uploads']));
+ref.onHidden.subscribe(() => console.log('toast gone'));
+
+// close it programmatically later
+someButton.addEventListener('click', () => ref.manualClose());
+```
+
+## Positions
+
+| Class | Location |
+|---|---|
+| `toast-top-right` | Top-right corner (default) |
+| `toast-top-left` | Top-left corner |
+| `toast-top-center` | Top-center |
+| `toast-bottom-right` | Bottom-right corner |
+| `toast-bottom-left` | Bottom-left corner |
+| `toast-bottom-center` | Bottom-center |
+
+```typescript
+// per-call override
+this.toast.info('Message', '', { positionClass: 'toast-bottom-center' });
+```
+
+## CSS Variables
+
+Override any token from your stylesheet — no component re-configuration needed.
+
+### Toast element
+
+| Variable | Default | Description |
+|---|---|---|
+| `--hub-toast-bg` | `var(--hub-sys-surface-page, #fff)` | Background colour. |
+| `--hub-toast-color` | `var(--hub-sys-text-primary, #212529)` | Text colour. |
+| `--hub-toast-border` | `var(--hub-sys-border-color-default, #dee2e6)` | Border colour. |
+| `--hub-toast-accent` | `var(--hub-sys-border-color-default, #dee2e6)` | Left accent border colour. |
+| `--hub-toast-accent-width` | `0.25rem` | Left accent border thickness. |
+| `--hub-toast-min-width` | `18rem` | Minimum width. |
+| `--hub-toast-max-width` | `26rem` | Maximum width. |
+| `--hub-toast-padding-x` | `var(--hub-ref-space-3, 1rem)` | Horizontal padding. |
+| `--hub-toast-padding-y` | `var(--hub-ref-space-3, 1rem)` | Vertical padding. |
+| `--hub-toast-border-radius` | `var(--hub-ref-radius-md, 0.375rem)` | Border radius. |
+| `--hub-toast-border-width` | `var(--hub-ref-border-width, 1px)` | Border width. |
+| `--hub-toast-shadow` | `var(--hub-sys-shadow-md, 0 0.25rem 0.75rem rgba(0,0,0,.1))` | Box shadow. |
+| `--hub-toast-gap` | `var(--hub-ref-space-1, 0.25rem)` | Gap between title and message. |
+| `--hub-toast-font-size` | `var(--hub-ref-font-size-base, 1rem)` | Message font size. |
+| `--hub-toast-title-font-size` | `var(--hub-ref-font-size-base, 1rem)` | Title font size. |
+| `--hub-toast-title-font-weight` | `600` | Title font weight. |
+| `--hub-toast-progress-height` | `0.25rem` | Progress bar height. |
+| `--hub-toast-progress-bg` | `color-mix(in srgb, var(--hub-toast-accent) 30%, transparent)` | Progress bar colour. |
+| `--hub-toast-close-opacity` | `0.5` | Close button opacity. |
+| `--hub-toast-close-opacity-hover` | `1` | Close button hover opacity. |
+
+### Container
+
+| Variable | Default | Description |
+|---|---|---|
+| `--hub-toast-container-gap` | `var(--hub-ref-space-2, 0.5rem)` | Gap between stacked toasts. |
+| `--hub-toast-container-offset` | `var(--hub-ref-space-3, 1rem)` | Distance from screen edges. |
+| `--hub-toast-container-z-index` | `1050` | Stack order. |
+
+### Theming example
+
+```css
+/* global dark toast for all types */
+:root {
+  --hub-toast-bg: #1e1e1e;
+  --hub-toast-color: #f5f5f5;
+  --hub-toast-border-radius: 0.5rem;
+  --hub-toast-container-offset: 1.5rem;
+}
+```
+
+## Custom toast types
+
+Pass any string as the `type` argument to `show()`. Set `--hub-toast-accent` on the calling element to drive the automatic colour derivation:
+
+```typescript
+this.toast.show('Sync queued.', 'Offline', { timeOut: 0 }, 'offline');
+```
+
+```css
+/* set the accent for your custom type */
+hub-toast[data-type='offline'] {
+  --hub-toast-accent: #6c757d;
+}
+```
+
+## Peer dependencies
+
+| Package | Version |
+|---|---|
+| `@angular/core` | `>=22.0.0` |
+| `@angular/common` | `>=22.0.0` |
+| `@angular/animations` | `>=22.0.0` |
+
+## License
+
+MIT © [Carlos Morcillo](https://www.carlosmorcillo.com)

package/fesm2022/ng-hub-ui-toast.mjs

@@ -0,0 +1,450 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, Injectable, ApplicationRef, signal, createComponent, input, output, computed, effect, ChangeDetectionStrategy, Component } from '@angular/core';
+import { Subject } from 'rxjs';
+import { trigger, state, style, transition, animate, keyframes } from '@angular/animations';
+
+/** Default configuration applied to every toast unless overridden. */
+const HUB_TOAST_DEFAULT_CONFIG = {
+    timeOut: 5000,
+    extendedTimeOut: 2500,
+    closeButton: true,
+    progressBar: false,
+    tapToDismiss: true,
+    disableTimeOut: false,
+    newestOnTop: true,
+    positionClass: 'toast-top-right',
+    maxOpened: 0,
+    autoDismiss: false,
+    preventDuplicates: false
+};
+/** Injection token for the global toast configuration. */
+const HUB_TOAST_CONFIG = new InjectionToken('HUB_TOAST_CONFIG');
+/**
+ * Registers the toast library providers.
+ * Call inside `ApplicationConfig.providers` or a route's `providers` array.
+ *
+ * @param config - Partial global defaults merged over {@link HUB_TOAST_DEFAULT_CONFIG}.
+ *
+ * @example
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [provideToast({ timeOut: 3000, progressBar: true })]
+ * };
+ * ```
+ */
+function provideToast(config = {}) {
+    return [{ provide: HUB_TOAST_CONFIG, useValue: config }];
+}
+/**
+ * Resolves per-toast config by merging global defaults, the provider override,
+ * and any per-call overrides. Injected by `ToastService`.
+ */
+class ToastConfigService {
+    _override = inject(HUB_TOAST_CONFIG, { optional: true }) ?? {};
+    /** Returns the merged global config (default ← provider override). */
+    get defaults() {
+        return { ...HUB_TOAST_DEFAULT_CONFIG, ...this._override };
+    }
+    /**
+     * Merges global defaults with per-call overrides into a final config.
+     *
+     * @param perCall - Per-call partial overrides.
+     * @returns Fully resolved config for one toast.
+     */
+    resolve(perCall = {}) {
+        return { ...this.defaults, ...perCall };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastConfigService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastConfigService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastConfigService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/** Monotonically increasing id counter. */
+let nextId = 0;
+/**
+ * Core service for displaying toast notifications.
+ * Manages the active toast stack as a signal and lazily mounts the
+ * container overlay on the first toast call.
+ *
+ * @example
+ * ```typescript
+ * constructor(private toastr: ToastService) {}
+ *
+ * save() {
+ *   this.toastr.success('Record saved', 'Success');
+ * }
+ * ```
+ */
+class ToastService {
+    _config = inject(ToastConfigService);
+    _appRef = inject(ApplicationRef);
+    /** Read-only signal of all currently active toasts. */
+    toasts = signal([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "toasts" }] : /* istanbul ignore next */ []));
+    _containerMounted = false;
+    /** Reference to the lazily created container, kept for explicit CD triggers. */
+    _containerRef = null;
+    // ─── Public shorthand methods ───────────────────────────────────────────
+    /**
+     * Shows a success toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    success(message, title = '', config = {}) {
+        return this.show(message, title, config, 'success');
+    }
+    /**
+     * Shows an error toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    error(message, title = '', config = {}) {
+        return this.show(message, title, config, 'error');
+    }
+    /**
+     * Shows a warning toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    warning(message, title = '', config = {}) {
+        return this.show(message, title, config, 'warning');
+    }
+    /**
+     * Shows an informational toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    info(message, title = '', config = {}) {
+        return this.show(message, title, config, 'info');
+    }
+    /**
+     * Shows a toast with a custom or built-in type.
+     * The type string is applied as `data-type` on the toast host element
+     * and drives the SCSS `@each` accent loop.
+     *
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     * @param type - Semantic type or any custom string.
+     */
+    show(message, title = '', config = {}, type = 'info') {
+        const resolved = this._config.resolve(config);
+        if (resolved.preventDuplicates) {
+            const duplicate = this.toasts().some((t) => t.message === message && t.type === type);
+            if (duplicate) {
+                return this._refForExisting(message, type);
+            }
+        }
+        if (resolved.maxOpened > 0 && this.toasts().length >= resolved.maxOpened) {
+            if (resolved.autoDismiss) {
+                const oldest = resolved.newestOnTop ? this.toasts()[this.toasts().length - 1] : this.toasts()[0];
+                this._removeById(oldest.toastId);
+            }
+            else {
+                return this._buildRef({ toastId: -1 });
+            }
+        }
+        const data = {
+            toastId: ++nextId,
+            type,
+            message,
+            title,
+            config: resolved,
+            onShown$: new Subject(),
+            onHidden$: new Subject(),
+            onTap$: new Subject()
+        };
+        if (resolved.newestOnTop) {
+            this.toasts.update((list) => [data, ...list]);
+        }
+        else {
+            this.toasts.update((list) => [...list, data]);
+        }
+        this._ensureContainerMounted();
+        this._syncContainer();
+        return this._buildRef(data);
+    }
+    /**
+     * Removes a specific toast by id.
+     * @param toastId - The id returned by the show method.
+     */
+    remove(toastId) {
+        this._removeById(toastId);
+    }
+    /** Removes all active toasts immediately. */
+    clear() {
+        this.toasts().forEach((t) => {
+            t.onHidden$.next();
+            t.onHidden$.complete();
+        });
+        this.toasts.set([]);
+        this._syncContainer();
+    }
+    // ─── Internal helpers ────────────────────────────────────────────────────
+    _removeById(toastId) {
+        const toast = this.toasts().find((t) => t.toastId === toastId);
+        if (toast) {
+            toast.onHidden$.next();
+            toast.onHidden$.complete();
+            this.toasts.update((list) => list.filter((t) => t.toastId !== toastId));
+            this._syncContainer();
+        }
+    }
+    _refForExisting(message, type) {
+        const existing = this.toasts().find((t) => t.message === message && t.type === type);
+        return existing ? this._buildRef(existing) : this._buildRef({ toastId: -1 });
+    }
+    _buildRef(data) {
+        const svc = this;
+        return {
+            toastId: data.toastId,
+            onShown: data.onShown$?.asObservable() ?? new Subject().asObservable(),
+            onHidden: data.onHidden$?.asObservable() ?? new Subject().asObservable(),
+            onTap: data.onTap$?.asObservable() ?? new Subject().asObservable(),
+            manualClose() {
+                svc.remove(data.toastId);
+            },
+            resetTimeout() {
+                const toast = svc.toasts().find((t) => t.toastId === data.toastId);
+                if (toast) {
+                    toast.onShown$.next();
+                }
+            }
+        };
+    }
+    /**
+     * Lazily mounts the `ToastContainerComponent` via Angular's `createComponent`.
+     * Called on the first toast — subsequent calls are no-ops.
+     */
+    _ensureContainerMounted() {
+        if (this._containerMounted) {
+            return;
+        }
+        this._containerMounted = true;
+        Promise.resolve().then(function () { return toastContainer_component; }).then(({ ToastContainerComponent }) => {
+            const ref = createComponent(ToastContainerComponent, {
+                environmentInjector: this._appRef.injector
+            });
+            this._containerRef = ref;
+            this._appRef.attachView(ref.hostView);
+            document.body.appendChild(ref.location.nativeElement);
+            // Initial render: signal may already hold toasts queued before the import resolved.
+            ref.changeDetectorRef.detectChanges();
+        });
+    }
+    /**
+     * Explicitly runs change detection on the container.
+     *
+     * Views created via `createComponent` + `attachView` are not reachable by
+     * Angular's signal-based "mark ancestors dirty" traversal, so they do not
+     * update automatically when a signal changes. Calling `detectChanges()`
+     * directly on the container's `ChangeDetectorRef` is the reliable alternative.
+     */
+    _syncContainer() {
+        this._containerRef?.changeDetectorRef.detectChanges();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Slide-in/out animation for individual toasts.
+ * Enter: slides in from the inline-end edge with a fade.
+ * Leave: fades out with a slight upward shift.
+ */
+const toastAnimation = trigger('toastState', [
+    state('in', style({ opacity: 1, transform: 'translateX(0)' })),
+    transition(':enter', [
+        animate('200ms ease-out', keyframes([
+            style({ opacity: 0, transform: 'translateX(100%)', offset: 0 }),
+            style({ opacity: 1, transform: 'translateX(0)', offset: 1 })
+        ]))
+    ]),
+    transition(':leave', [
+        animate('150ms ease-in', keyframes([
+            style({ opacity: 1, transform: 'translateY(0)', offset: 0 }),
+            style({ opacity: 0, transform: 'translateY(-0.5rem)', offset: 1 })
+        ]))
+    ])
+]);
+
+/** Built-in type names that have exact DS token coverage via `@each`. */
+const BUILT_IN_TYPES = new Set(['success', 'error', 'warning', 'info']);
+/**
+ * Renders a single toast notification.
+ *
+ * Driven by a {@link HubToastData} input. Manages its own auto-dismiss timer
+ * via `signal` + `effect` and emits `(closed)` with the toast id when done.
+ *
+ * The `data-type` host attribute drives the `@each` SCSS accent loop;
+ * `--hub-toast-accent` is set inline only for custom types.
+ */
+class ToastComponent {
+    /** Toast data provided by `ToastContainerComponent`. */
+    data = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "data" }] : /* istanbul ignore next */ []));
+    /** Emits the toast id when this toast should be dismissed. */
+    closed = output();
+    /** Remaining progress as a percentage (100 → 0). Used by the progress bar. */
+    progress = signal(100, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "progress" }] : /* istanbul ignore next */ []));
+    /**
+     * Inline accent token. Null for built-in types (covered by `@each`);
+     * `var(--hub-sys-color-<type>)` for custom types so `color-mix` derives
+     * the other tokens automatically.
+     */
+    accentToken = computed(() => {
+        const type = this.data().type;
+        return BUILT_IN_TYPES.has(type) ? null : `var(--hub-sys-color-${type})`;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "accentToken" }] : /* istanbul ignore next */ []));
+    _timerId = null;
+    _intervalId = null;
+    constructor() {
+        effect(() => {
+            const cfg = this.data().config;
+            this._clearTimers();
+            if (cfg.disableTimeOut === true || cfg.disableTimeOut === 'timeOut') {
+                return;
+            }
+            if (cfg.timeOut > 0) {
+                this._startTimer(cfg.timeOut);
+            }
+        });
+        effect(() => {
+            this.data().onShown$.next();
+        });
+    }
+    /** Called by `(mouseenter)` binding in the template. */
+    onMouseEnter() {
+        const cfg = this.data().config;
+        if (cfg.disableTimeOut !== 'extendedTimeOut') {
+            this._clearTimers();
+        }
+    }
+    /** Called by `(mouseleave)` binding in the template. */
+    onMouseLeave() {
+        const cfg = this.data().config;
+        if (cfg.extendedTimeOut > 0 && cfg.disableTimeOut !== 'extendedTimeOut') {
+            this._startTimer(cfg.extendedTimeOut);
+        }
+    }
+    /** Called by the host `(click)` binding. */
+    onTap() {
+        const cfg = this.data().config;
+        this.data().onTap$.next();
+        if (cfg.tapToDismiss) {
+            this._dismiss();
+        }
+    }
+    /** Called by the close button in the template. */
+    onClose(event) {
+        event.stopPropagation();
+        this._dismiss();
+    }
+    ngOnDestroy() {
+        this._clearTimers();
+    }
+    _startTimer(duration) {
+        const cfg = this.data().config;
+        const start = Date.now();
+        if (cfg.progressBar) {
+            this._intervalId = setInterval(() => {
+                const elapsed = Date.now() - start;
+                this.progress.set(Math.max(0, 100 - (elapsed / duration) * 100));
+            }, 50);
+        }
+        this._timerId = setTimeout(() => {
+            this._dismiss();
+        }, duration);
+    }
+    _dismiss() {
+        this._clearTimers();
+        this.closed.emit(this.data().toastId);
+    }
+    _clearTimers() {
+        if (this._timerId !== null) {
+            clearTimeout(this._timerId);
+            this._timerId = null;
+        }
+        if (this._intervalId !== null) {
+            clearInterval(this._intervalId);
+            this._intervalId = null;
+        }
+        this.progress.set(100);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.1", type: ToastComponent, isStandalone: true, selector: "hub-toast", inputs: { data: { classPropertyName: "data", publicName: "data", isSignal: true, isRequired: true, transformFunction: null } }, outputs: { closed: "closed" }, host: { listeners: { "click": "onTap()" }, properties: { "@toastState": "\"in\"", "attr.data-type": "data().type", "style.--hub-toast-accent": "accentToken()" }, classAttribute: "hub-toast" }, ngImport: i0, template: "<div\n\tclass=\"hub-toast__body\"\n\t(mouseenter)=\"onMouseEnter()\"\n\t(mouseleave)=\"onMouseLeave()\"\n>\n\t@if (data().title) {\n\t\t<div class=\"hub-toast__title\">{{ data().title }}</div>\n\t}\n\t<div class=\"hub-toast__message\">{{ data().message }}</div>\n</div>\n\n@if (data().config.closeButton) {\n\t<button\n\t\ttype=\"button\"\n\t\tclass=\"hub-toast__close\"\n\t\taria-label=\"Close\"\n\t\t(click)=\"onClose($event)\"\n\t>\n\t\t<span aria-hidden=\"true\">&times;</span>\n\t</button>\n}\n\n@if (data().config.progressBar) {\n\t<div\n\t\tclass=\"hub-toast__progress\"\n\t\trole=\"progressbar\"\n\t\t[attr.aria-valuenow]=\"progress()\"\n\t\taria-valuemin=\"0\"\n\t\taria-valuemax=\"100\"\n\t>\n\t\t<div class=\"hub-toast__progress-bar\" [style.width.%]=\"progress()\"></div>\n\t</div>\n}\n", styles: [":where(:host){--hub-toast-min-width: 18rem;--hub-toast-max-width: 26rem;--hub-toast-padding-x: var(--hub-ref-space-3, 1rem);--hub-toast-padding-y: var(--hub-ref-space-3, 1rem);--hub-toast-border-radius: var(--hub-ref-radius-md, .375rem);--hub-toast-border-width: var(--hub-ref-border-width, 1px);--hub-toast-shadow: var(--hub-sys-shadow-md, 0 .25rem .75rem rgba(0, 0, 0, .1));--hub-toast-gap: var(--hub-ref-space-1, .25rem);--hub-toast-accent-width: .25rem;--hub-toast-font-size: var(--hub-ref-font-size-base, 1rem);--hub-toast-title-font-size: var(--hub-ref-font-size-base, 1rem);--hub-toast-title-font-weight: 600;--hub-toast-bg: var(--hub-sys-surface-page, #fff);--hub-toast-color: var(--hub-sys-text-primary, #212529);--hub-toast-border: var(--hub-sys-border-color-default, #dee2e6);--hub-toast-accent: var(--hub-sys-border-color-default, #dee2e6);--hub-toast-progress-bg: color-mix(in srgb, var(--hub-toast-accent) 30%, transparent);--hub-toast-progress-height: .25rem;--hub-toast-close-opacity: .5;--hub-toast-close-opacity-hover: 1}:where(:host[data-type]){--hub-toast-bg: color-mix(in srgb, var(--hub-toast-accent) 14%, var(--hub-sys-surface-page, #fff));--hub-toast-color: color-mix(in srgb, var(--hub-toast-accent) 72%, var(--hub-sys-text-primary, #212529));--hub-toast-border: color-mix(in srgb, var(--hub-toast-accent) 30%, transparent)}:where(:host[data-type=success]){--hub-toast-bg: var(--hub-sys-color-success-subtle);--hub-toast-color: var(--hub-sys-color-success-emphasis);--hub-toast-border: var(--hub-sys-color-success-border-subtle);--hub-toast-accent: var(--hub-sys-color-success)}:where(:host[data-type=warning]){--hub-toast-bg: var(--hub-sys-color-warning-subtle);--hub-toast-color: var(--hub-sys-color-warning-emphasis);--hub-toast-border: var(--hub-sys-color-warning-border-subtle);--hub-toast-accent: var(--hub-sys-color-warning)}:where(:host[data-type=info]){--hub-toast-bg: var(--hub-sys-color-info-subtle);--hub-toast-color: var(--hub-sys-color-info-emphasis);--hub-toast-border: var(--hub-sys-color-info-border-subtle);--hub-toast-accent: var(--hub-sys-color-info)}:where(:host[data-type=error]){--hub-toast-bg: var(--hub-sys-color-danger-subtle);--hub-toast-color: var(--hub-sys-color-danger-emphasis);--hub-toast-border: var(--hub-sys-color-danger-border-subtle);--hub-toast-accent: var(--hub-sys-color-danger)}:host{position:relative;display:flex;align-items:flex-start;min-width:var(--hub-toast-min-width);max-width:var(--hub-toast-max-width);padding:var(--hub-toast-padding-y) var(--hub-toast-padding-x);border-radius:var(--hub-toast-border-radius);border:var(--hub-toast-border-width) solid var(--hub-toast-border);border-inline-start-width:var(--hub-toast-accent-width);border-inline-start-color:var(--hub-toast-accent);background:var(--hub-toast-bg);color:var(--hub-toast-color);box-shadow:var(--hub-toast-shadow);cursor:default;overflow:hidden}.hub-toast__body{flex:1;display:flex;flex-direction:column;gap:var(--hub-toast-gap)}.hub-toast__title{font-size:var(--hub-toast-title-font-size);font-weight:var(--hub-toast-title-font-weight);line-height:1.25}.hub-toast__message{font-size:var(--hub-toast-font-size);line-height:1.5}.hub-toast__close{flex:0 0 auto;padding:0;margin-inline-start:var(--hub-toast-padding-x);background:none;border:none;cursor:pointer;font-size:1.25rem;line-height:1;color:inherit;opacity:var(--hub-toast-close-opacity);transition:opacity .15s ease}.hub-toast__close:hover{opacity:var(--hub-toast-close-opacity-hover)}.hub-toast__progress{position:absolute;inset-inline:0;bottom:0;height:var(--hub-toast-progress-height);background:transparent}.hub-toast__progress-bar{height:100%;background:var(--hub-toast-progress-bg);transition:width 50ms linear}\n"], animations: [toastAnimation], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'hub-toast', changeDetection: ChangeDetectionStrategy.OnPush, animations: [toastAnimation], host: {
+                        class: 'hub-toast',
+                        '[@toastState]': '"in"',
+                        '[attr.data-type]': 'data().type',
+                        '[style.--hub-toast-accent]': 'accentToken()',
+                        '(click)': 'onTap()'
+                    }, template: "<div\n\tclass=\"hub-toast__body\"\n\t(mouseenter)=\"onMouseEnter()\"\n\t(mouseleave)=\"onMouseLeave()\"\n>\n\t@if (data().title) {\n\t\t<div class=\"hub-toast__title\">{{ data().title }}</div>\n\t}\n\t<div class=\"hub-toast__message\">{{ data().message }}</div>\n</div>\n\n@if (data().config.closeButton) {\n\t<button\n\t\ttype=\"button\"\n\t\tclass=\"hub-toast__close\"\n\t\taria-label=\"Close\"\n\t\t(click)=\"onClose($event)\"\n\t>\n\t\t<span aria-hidden=\"true\">&times;</span>\n\t</button>\n}\n\n@if (data().config.progressBar) {\n\t<div\n\t\tclass=\"hub-toast__progress\"\n\t\trole=\"progressbar\"\n\t\t[attr.aria-valuenow]=\"progress()\"\n\t\taria-valuemin=\"0\"\n\t\taria-valuemax=\"100\"\n\t>\n\t\t<div class=\"hub-toast__progress-bar\" [style.width.%]=\"progress()\"></div>\n\t</div>\n}\n", styles: [":where(:host){--hub-toast-min-width: 18rem;--hub-toast-max-width: 26rem;--hub-toast-padding-x: var(--hub-ref-space-3, 1rem);--hub-toast-padding-y: var(--hub-ref-space-3, 1rem);--hub-toast-border-radius: var(--hub-ref-radius-md, .375rem);--hub-toast-border-width: var(--hub-ref-border-width, 1px);--hub-toast-shadow: var(--hub-sys-shadow-md, 0 .25rem .75rem rgba(0, 0, 0, .1));--hub-toast-gap: var(--hub-ref-space-1, .25rem);--hub-toast-accent-width: .25rem;--hub-toast-font-size: var(--hub-ref-font-size-base, 1rem);--hub-toast-title-font-size: var(--hub-ref-font-size-base, 1rem);--hub-toast-title-font-weight: 600;--hub-toast-bg: var(--hub-sys-surface-page, #fff);--hub-toast-color: var(--hub-sys-text-primary, #212529);--hub-toast-border: var(--hub-sys-border-color-default, #dee2e6);--hub-toast-accent: var(--hub-sys-border-color-default, #dee2e6);--hub-toast-progress-bg: color-mix(in srgb, var(--hub-toast-accent) 30%, transparent);--hub-toast-progress-height: .25rem;--hub-toast-close-opacity: .5;--hub-toast-close-opacity-hover: 1}:where(:host[data-type]){--hub-toast-bg: color-mix(in srgb, var(--hub-toast-accent) 14%, var(--hub-sys-surface-page, #fff));--hub-toast-color: color-mix(in srgb, var(--hub-toast-accent) 72%, var(--hub-sys-text-primary, #212529));--hub-toast-border: color-mix(in srgb, var(--hub-toast-accent) 30%, transparent)}:where(:host[data-type=success]){--hub-toast-bg: var(--hub-sys-color-success-subtle);--hub-toast-color: var(--hub-sys-color-success-emphasis);--hub-toast-border: var(--hub-sys-color-success-border-subtle);--hub-toast-accent: var(--hub-sys-color-success)}:where(:host[data-type=warning]){--hub-toast-bg: var(--hub-sys-color-warning-subtle);--hub-toast-color: var(--hub-sys-color-warning-emphasis);--hub-toast-border: var(--hub-sys-color-warning-border-subtle);--hub-toast-accent: var(--hub-sys-color-warning)}:where(:host[data-type=info]){--hub-toast-bg: var(--hub-sys-color-info-subtle);--hub-toast-color: var(--hub-sys-color-info-emphasis);--hub-toast-border: var(--hub-sys-color-info-border-subtle);--hub-toast-accent: var(--hub-sys-color-info)}:where(:host[data-type=error]){--hub-toast-bg: var(--hub-sys-color-danger-subtle);--hub-toast-color: var(--hub-sys-color-danger-emphasis);--hub-toast-border: var(--hub-sys-color-danger-border-subtle);--hub-toast-accent: var(--hub-sys-color-danger)}:host{position:relative;display:flex;align-items:flex-start;min-width:var(--hub-toast-min-width);max-width:var(--hub-toast-max-width);padding:var(--hub-toast-padding-y) var(--hub-toast-padding-x);border-radius:var(--hub-toast-border-radius);border:var(--hub-toast-border-width) solid var(--hub-toast-border);border-inline-start-width:var(--hub-toast-accent-width);border-inline-start-color:var(--hub-toast-accent);background:var(--hub-toast-bg);color:var(--hub-toast-color);box-shadow:var(--hub-toast-shadow);cursor:default;overflow:hidden}.hub-toast__body{flex:1;display:flex;flex-direction:column;gap:var(--hub-toast-gap)}.hub-toast__title{font-size:var(--hub-toast-title-font-size);font-weight:var(--hub-toast-title-font-weight);line-height:1.25}.hub-toast__message{font-size:var(--hub-toast-font-size);line-height:1.5}.hub-toast__close{flex:0 0 auto;padding:0;margin-inline-start:var(--hub-toast-padding-x);background:none;border:none;cursor:pointer;font-size:1.25rem;line-height:1;color:inherit;opacity:var(--hub-toast-close-opacity);transition:opacity .15s ease}.hub-toast__close:hover{opacity:var(--hub-toast-close-opacity-hover)}.hub-toast__progress{position:absolute;inset-inline:0;bottom:0;height:var(--hub-toast-progress-height);background:transparent}.hub-toast__progress-bar{height:100%;background:var(--hub-toast-progress-bg);transition:width 50ms linear}\n"] }]
+        }], ctorParameters: () => [], propDecorators: { data: [{ type: i0.Input, args: [{ isSignal: true, alias: "data", required: true }] }], closed: [{ type: i0.Output, args: ["closed"] }] } });
+
+/**
+ * Fixed-corner container that renders all active toasts.
+ *
+ * Mounted once by `ToastService._ensureContainerMounted()` and appended
+ * directly to `document.body` — never declared in user templates.
+ * The `positionClass` from the first toast's config drives the CSS class
+ * that positions the container in the viewport corner.
+ */
+class ToastContainerComponent {
+    toastService = inject(ToastService);
+    /** Active toast list from the service signal. */
+    toasts = this.toastService.toasts;
+    /**
+     * Position class derived from the first active toast's config.
+     * Uses the first toast so the container position stays stable across updates.
+     */
+    positionClass = () => {
+        const list = this.toasts();
+        return list.length > 0 ? list[0].config.positionClass : 'toast-top-right';
+    };
+    /** Delegates toast removal to `ToastService`. */
+    onClosed(toastId) {
+        this.toastService.remove(toastId);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastContainerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.1", type: ToastContainerComponent, isStandalone: true, selector: "hub-toast-container", host: { properties: { "class": "positionClass()" }, classAttribute: "hub-toast-container" }, ngImport: i0, template: "@for (toast of toasts(); track toast.toastId) {\n\t<hub-toast [data]=\"toast\" (closed)=\"onClosed($event)\" />\n}\n", styles: [":host{--hub-toast-container-gap: var(--hub-ref-space-2, .5rem);--hub-toast-container-z-index: 1050;--hub-toast-container-offset: var(--hub-ref-space-3, 1rem)}:host{position:fixed;z-index:var(--hub-toast-container-z-index);display:flex;flex-direction:column;gap:var(--hub-toast-container-gap);pointer-events:none}:host hub-toast{pointer-events:all}:host.toast-top-right{top:var(--hub-toast-container-offset);inset-inline-end:var(--hub-toast-container-offset);align-items:flex-end}:host.toast-top-left{top:var(--hub-toast-container-offset);inset-inline-start:var(--hub-toast-container-offset);align-items:flex-start}:host.toast-top-center{top:var(--hub-toast-container-offset);left:50%;transform:translate(-50%);align-items:center}:host.toast-bottom-right{bottom:var(--hub-toast-container-offset);inset-inline-end:var(--hub-toast-container-offset);align-items:flex-end;flex-direction:column-reverse}:host.toast-bottom-left{bottom:var(--hub-toast-container-offset);inset-inline-start:var(--hub-toast-container-offset);align-items:flex-start;flex-direction:column-reverse}:host.toast-bottom-center{bottom:var(--hub-toast-container-offset);left:50%;transform:translate(-50%);align-items:center;flex-direction:column-reverse}\n"], dependencies: [{ kind: "component", type: ToastComponent, selector: "hub-toast", inputs: ["data"], outputs: ["closed"] }], animations: [toastAnimation], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.1", ngImport: i0, type: ToastContainerComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'hub-toast-container', changeDetection: ChangeDetectionStrategy.OnPush, animations: [toastAnimation], imports: [ToastComponent], host: {
+                        class: 'hub-toast-container',
+                        '[class]': 'positionClass()'
+                    }, template: "@for (toast of toasts(); track toast.toastId) {\n\t<hub-toast [data]=\"toast\" (closed)=\"onClosed($event)\" />\n}\n", styles: [":host{--hub-toast-container-gap: var(--hub-ref-space-2, .5rem);--hub-toast-container-z-index: 1050;--hub-toast-container-offset: var(--hub-ref-space-3, 1rem)}:host{position:fixed;z-index:var(--hub-toast-container-z-index);display:flex;flex-direction:column;gap:var(--hub-toast-container-gap);pointer-events:none}:host hub-toast{pointer-events:all}:host.toast-top-right{top:var(--hub-toast-container-offset);inset-inline-end:var(--hub-toast-container-offset);align-items:flex-end}:host.toast-top-left{top:var(--hub-toast-container-offset);inset-inline-start:var(--hub-toast-container-offset);align-items:flex-start}:host.toast-top-center{top:var(--hub-toast-container-offset);left:50%;transform:translate(-50%);align-items:center}:host.toast-bottom-right{bottom:var(--hub-toast-container-offset);inset-inline-end:var(--hub-toast-container-offset);align-items:flex-end;flex-direction:column-reverse}:host.toast-bottom-left{bottom:var(--hub-toast-container-offset);inset-inline-start:var(--hub-toast-container-offset);align-items:flex-start;flex-direction:column-reverse}:host.toast-bottom-center{bottom:var(--hub-toast-container-offset);left:50%;transform:translate(-50%);align-items:center;flex-direction:column-reverse}\n"] }]
+        }] });
+
+var toastContainer_component = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    ToastContainerComponent: ToastContainerComponent
+});
+
+/*
+ * Public API Surface of ng-hub-ui-toast
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { HUB_TOAST_CONFIG, HUB_TOAST_DEFAULT_CONFIG, ToastComponent, ToastConfigService, ToastContainerComponent, ToastService, provideToast };
+//# sourceMappingURL=ng-hub-ui-toast.mjs.map

package/fesm2022/ng-hub-ui-toast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-hub-ui-toast.mjs","sources":["../../../projects/toast/src/lib/services/toast-config.service.ts","../../../projects/toast/src/lib/services/toast.service.ts","../../../projects/toast/src/lib/animations/toast.animations.ts","../../../projects/toast/src/lib/components/toast/toast.component.ts","../../../projects/toast/src/lib/components/toast/toast.component.html","../../../projects/toast/src/lib/components/toast-container/toast-container.component.ts","../../../projects/toast/src/lib/components/toast-container/toast-container.component.html","../../../projects/toast/src/public-api.ts","../../../projects/toast/src/ng-hub-ui-toast.ts"],"sourcesContent":["import { inject, Injectable, InjectionToken, Provider } from '@angular/core';\nimport type { HubToastConfig, HubToastPosition } from '../models/toast.types';\n\n/** Default configuration applied to every toast unless overridden. */\nexport const HUB_TOAST_DEFAULT_CONFIG: HubToastConfig = {\n\ttimeOut: 5000,\n\textendedTimeOut: 2500,\n\tcloseButton: true,\n\tprogressBar: false,\n\ttapToDismiss: true,\n\tdisableTimeOut: false,\n\tnewestOnTop: true,\n\tpositionClass: 'toast-top-right' as HubToastPosition,\n\tmaxOpened: 0,\n\tautoDismiss: false,\n\tpreventDuplicates: false\n};\n\n/** Injection token for the global toast configuration. */\nexport const HUB_TOAST_CONFIG = new InjectionToken<Partial<HubToastConfig>>('HUB_TOAST_CONFIG');\n\n/**\n * Registers the toast library providers.\n * Call inside `ApplicationConfig.providers` or a route's `providers` array.\n *\n * @param config - Partial global defaults merged over {@link HUB_TOAST_DEFAULT_CONFIG}.\n *\n * @example\n * ```typescript\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideToast({ timeOut: 3000, progressBar: true })]\n * };\n * ```\n */\nexport function provideToast(config: Partial<HubToastConfig> = {}): Provider[] {\n\treturn [{ provide: HUB_TOAST_CONFIG, useValue: config }];\n}\n\n/**\n * Resolves per-toast config by merging global defaults, the provider override,\n * and any per-call overrides. Injected by `ToastService`.\n */\n@Injectable({ providedIn: 'root' })\nexport class ToastConfigService {\n\tprivate readonly _override = inject(HUB_TOAST_CONFIG, { optional: true }) ?? {};\n\n\t/** Returns the merged global config (default ← provider override). */\n\tget defaults(): HubToastConfig {\n\t\treturn { ...HUB_TOAST_DEFAULT_CONFIG, ...this._override };\n\t}\n\n\t/**\n\t * Merges global defaults with per-call overrides into a final config.\n\t *\n\t * @param perCall - Per-call partial overrides.\n\t * @returns Fully resolved config for one toast.\n\t */\n\tresolve(perCall: Partial<HubToastConfig> = {}): HubToastConfig {\n\t\treturn { ...this.defaults, ...perCall };\n\t}\n}\n","import { ApplicationRef, ComponentRef, createComponent, inject, Injectable, signal } from '@angular/core';\nimport { Subject } from 'rxjs';\nimport type { HubToastConfig, HubToastData, HubToastRef, HubToastType } from '../models/toast.types';\nimport { ToastConfigService } from './toast-config.service';\n\n/** Monotonically increasing id counter. */\nlet nextId = 0;\n\n/**\n * Core service for displaying toast notifications.\n * Manages the active toast stack as a signal and lazily mounts the\n * container overlay on the first toast call.\n *\n * @example\n * ```typescript\n * constructor(private toastr: ToastService) {}\n *\n * save() {\n *   this.toastr.success('Record saved', 'Success');\n * }\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class ToastService {\n\tprivate readonly _config = inject(ToastConfigService);\n\tprivate readonly _appRef = inject(ApplicationRef);\n\n\t/** Read-only signal of all currently active toasts. */\n\treadonly toasts = signal<HubToastData[]>([]);\n\n\tprivate _containerMounted = false;\n\t/** Reference to the lazily created container, kept for explicit CD triggers. */\n\tprivate _containerRef: ComponentRef<unknown> | null = null;\n\n\t// ─── Public shorthand methods ───────────────────────────────────────────\n\n\t/**\n\t * Shows a success toast.\n\t * @param message - Notification body.\n\t * @param title - Optional heading.\n\t * @param config - Per-call config overrides.\n\t */\n\tsuccess(message: string, title = '', config: Partial<HubToastConfig> = {}): HubToastRef {\n\t\treturn this.show(message, title, config, 'success');\n\t}\n\n\t/**\n\t * Shows an error toast.\n\t * @param message - Notification body.\n\t * @param title - Optional heading.\n\t * @param config - Per-call config overrides.\n\t */\n\terror(message: string, title = '', config: Partial<HubToastConfig> = {}): HubToastRef {\n\t\treturn this.show(message, title, config, 'error');\n\t}\n\n\t/**\n\t * Shows a warning toast.\n\t * @param message - Notification body.\n\t * @param title - Optional heading.\n\t * @param config - Per-call config overrides.\n\t */\n\twarning(message: string, title = '', config: Partial<HubToastConfig> = {}): HubToastRef {\n\t\treturn this.show(message, title, config, 'warning');\n\t}\n\n\t/**\n\t * Shows an informational toast.\n\t * @param message - Notification body.\n\t * @param title - Optional heading.\n\t * @param config - Per-call config overrides.\n\t */\n\tinfo(message: string, title = '', config: Partial<HubToastConfig> = {}): HubToastRef {\n\t\treturn this.show(message, title, config, 'info');\n\t}\n\n\t/**\n\t * Shows a toast with a custom or built-in type.\n\t * The type string is applied as `data-type` on the toast host element\n\t * and drives the SCSS `@each` accent loop.\n\t *\n\t * @param message - Notification body.\n\t * @param title - Optional heading.\n\t * @param config - Per-call config overrides.\n\t * @param type - Semantic type or any custom string.\n\t */\n\tshow(\n\t\tmessage: string,\n\t\ttitle = '',\n\t\tconfig: Partial<HubToastConfig> = {},\n\t\ttype: HubToastType | (string & {}) = 'info'\n\t): HubToastRef {\n\t\tconst resolved = this._config.resolve(config);\n\n\t\tif (resolved.preventDuplicates) {\n\t\t\tconst duplicate = this.toasts().some((t) => t.message === message && t.type === type);\n\t\t\tif (duplicate) {\n\t\t\t\treturn this._refForExisting(message, type);\n\t\t\t}\n\t\t}\n\n\t\tif (resolved.maxOpened > 0 && this.toasts().length >= resolved.maxOpened) {\n\t\t\tif (resolved.autoDismiss) {\n\t\t\t\tconst oldest = resolved.newestOnTop ? this.toasts()[this.toasts().length - 1] : this.toasts()[0];\n\t\t\t\tthis._removeById(oldest.toastId);\n\t\t\t} else {\n\t\t\t\treturn this._buildRef({ toastId: -1 } as any);\n\t\t\t}\n\t\t}\n\n\t\tconst data: HubToastData = {\n\t\t\ttoastId: ++nextId,\n\t\t\ttype,\n\t\t\tmessage,\n\t\t\ttitle,\n\t\t\tconfig: resolved,\n\t\t\tonShown$: new Subject<void>(),\n\t\t\tonHidden$: new Subject<void>(),\n\t\t\tonTap$: new Subject<void>()\n\t\t};\n\n\t\tif (resolved.newestOnTop) {\n\t\t\tthis.toasts.update((list) => [data, ...list]);\n\t\t} else {\n\t\t\tthis.toasts.update((list) => [...list, data]);\n\t\t}\n\n\t\tthis._ensureContainerMounted();\n\t\tthis._syncContainer();\n\t\treturn this._buildRef(data);\n\t}\n\n\t/**\n\t * Removes a specific toast by id.\n\t * @param toastId - The id returned by the show method.\n\t */\n\tremove(toastId: number): void {\n\t\tthis._removeById(toastId);\n\t}\n\n\t/** Removes all active toasts immediately. */\n\tclear(): void {\n\t\tthis.toasts().forEach((t) => {\n\t\t\tt.onHidden$.next();\n\t\t\tt.onHidden$.complete();\n\t\t});\n\t\tthis.toasts.set([]);\n\t\tthis._syncContainer();\n\t}\n\n\t// ─── Internal helpers ────────────────────────────────────────────────────\n\n\tprivate _removeById(toastId: number): void {\n\t\tconst toast = this.toasts().find((t) => t.toastId === toastId);\n\t\tif (toast) {\n\t\t\ttoast.onHidden$.next();\n\t\t\ttoast.onHidden$.complete();\n\t\t\tthis.toasts.update((list) => list.filter((t) => t.toastId !== toastId));\n\t\t\tthis._syncContainer();\n\t\t}\n\t}\n\n\tprivate _refForExisting(message: string, type: string): HubToastRef {\n\t\tconst existing = this.toasts().find((t) => t.message === message && t.type === type);\n\t\treturn existing ? this._buildRef(existing) : this._buildRef({ toastId: -1 } as any);\n\t}\n\n\tprivate _buildRef(data: HubToastData): HubToastRef {\n\t\tconst svc = this;\n\t\treturn {\n\t\t\ttoastId: data.toastId,\n\t\t\tonShown: data.onShown$?.asObservable() ?? new Subject<void>().asObservable(),\n\t\t\tonHidden: data.onHidden$?.asObservable() ?? new Subject<void>().asObservable(),\n\t\t\tonTap: data.onTap$?.asObservable() ?? new Subject<void>().asObservable(),\n\t\t\tmanualClose() {\n\t\t\t\tsvc.remove(data.toastId);\n\t\t\t},\n\t\t\tresetTimeout() {\n\t\t\t\tconst toast = svc.toasts().find((t) => t.toastId === data.toastId);\n\t\t\t\tif (toast) {\n\t\t\t\t\ttoast.onShown$.next();\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t}\n\n\t/**\n\t * Lazily mounts the `ToastContainerComponent` via Angular's `createComponent`.\n\t * Called on the first toast — subsequent calls are no-ops.\n\t */\n\tprivate _ensureContainerMounted(): void {\n\t\tif (this._containerMounted) {\n\t\t\treturn;\n\t\t}\n\t\tthis._containerMounted = true;\n\n\t\timport('../components/toast-container/toast-container.component').then(({ ToastContainerComponent }) => {\n\t\t\tconst ref = createComponent(ToastContainerComponent, {\n\t\t\t\tenvironmentInjector: this._appRef.injector\n\t\t\t});\n\t\t\tthis._containerRef = ref;\n\t\t\tthis._appRef.attachView(ref.hostView);\n\t\t\tdocument.body.appendChild(ref.location.nativeElement);\n\t\t\t// Initial render: signal may already hold toasts queued before the import resolved.\n\t\t\tref.changeDetectorRef.detectChanges();\n\t\t});\n\t}\n\n\t/**\n\t * Explicitly runs change detection on the container.\n\t *\n\t * Views created via `createComponent` + `attachView` are not reachable by\n\t * Angular's signal-based \"mark ancestors dirty\" traversal, so they do not\n\t * update automatically when a signal changes. Calling `detectChanges()`\n\t * directly on the container's `ChangeDetectorRef` is the reliable alternative.\n\t */\n\tprivate _syncContainer(): void {\n\t\tthis._containerRef?.changeDetectorRef.detectChanges();\n\t}\n}\n","import { animate, keyframes, state, style, transition, trigger } from '@angular/animations';\n\n/**\n * Slide-in/out animation for individual toasts.\n * Enter: slides in from the inline-end edge with a fade.\n * Leave: fades out with a slight upward shift.\n */\nexport const toastAnimation = trigger('toastState', [\n\tstate('in', style({ opacity: 1, transform: 'translateX(0)' })),\n\ttransition(':enter', [\n\t\tanimate(\n\t\t\t'200ms ease-out',\n\t\t\tkeyframes([\n\t\t\t\tstyle({ opacity: 0, transform: 'translateX(100%)', offset: 0 }),\n\t\t\t\tstyle({ opacity: 1, transform: 'translateX(0)', offset: 1 })\n\t\t\t])\n\t\t)\n\t]),\n\ttransition(':leave', [\n\t\tanimate(\n\t\t\t'150ms ease-in',\n\t\t\tkeyframes([\n\t\t\t\tstyle({ opacity: 1, transform: 'translateY(0)', offset: 0 }),\n\t\t\t\tstyle({ opacity: 0, transform: 'translateY(-0.5rem)', offset: 1 })\n\t\t\t])\n\t\t)\n\t])\n]);\n","import {\n\tChangeDetectionStrategy,\n\tComponent,\n\tcomputed,\n\teffect,\n\tinput,\n\tOnDestroy,\n\toutput,\n\tsignal\n} from '@angular/core';\nimport { toastAnimation } from '../../animations/toast.animations';\nimport { HubToastData, HubToastType } from '../../models/toast.types';\n\n/** Built-in type names that have exact DS token coverage via `@each`. */\nconst BUILT_IN_TYPES = new Set<string>(['success', 'error', 'warning', 'info']);\n\n/**\n * Renders a single toast notification.\n *\n * Driven by a {@link HubToastData} input. Manages its own auto-dismiss timer\n * via `signal` + `effect` and emits `(closed)` with the toast id when done.\n *\n * The `data-type` host attribute drives the `@each` SCSS accent loop;\n * `--hub-toast-accent` is set inline only for custom types.\n */\n@Component({\n\tselector: 'hub-toast',\n\ttemplateUrl: './toast.component.html',\n\tstyleUrl: './toast.component.scss',\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n\tanimations: [toastAnimation],\n\thost: {\n\t\tclass: 'hub-toast',\n\t\t'[@toastState]': '\"in\"',\n\t\t'[attr.data-type]': 'data().type',\n\t\t'[style.--hub-toast-accent]': 'accentToken()',\n\t\t'(click)': 'onTap()'\n\t}\n})\nexport class ToastComponent implements OnDestroy {\n\t/** Toast data provided by `ToastContainerComponent`. */\n\treadonly data = input.required<HubToastData>();\n\n\t/** Emits the toast id when this toast should be dismissed. */\n\treadonly closed = output<number>();\n\n\t/** Remaining progress as a percentage (100 → 0). Used by the progress bar. */\n\treadonly progress = signal(100);\n\n\t/**\n\t * Inline accent token. Null for built-in types (covered by `@each`);\n\t * `var(--hub-sys-color-<type>)` for custom types so `color-mix` derives\n\t * the other tokens automatically.\n\t */\n\treadonly accentToken = computed<string | null>(() => {\n\t\tconst type = this.data().type;\n\t\treturn BUILT_IN_TYPES.has(type) ? null : `var(--hub-sys-color-${type})`;\n\t});\n\n\tprivate _timerId: ReturnType<typeof setTimeout> | null = null;\n\tprivate _intervalId: ReturnType<typeof setInterval> | null = null;\n\n\tconstructor() {\n\t\teffect(() => {\n\t\t\tconst cfg = this.data().config;\n\t\t\tthis._clearTimers();\n\t\t\tif (cfg.disableTimeOut === true || cfg.disableTimeOut === 'timeOut') {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (cfg.timeOut > 0) {\n\t\t\t\tthis._startTimer(cfg.timeOut);\n\t\t\t}\n\t\t});\n\n\t\teffect(() => {\n\t\t\tthis.data().onShown$.next();\n\t\t});\n\t}\n\n\t/** Called by `(mouseenter)` binding in the template. */\n\tonMouseEnter(): void {\n\t\tconst cfg = this.data().config;\n\t\tif (cfg.disableTimeOut !== 'extendedTimeOut') {\n\t\t\tthis._clearTimers();\n\t\t}\n\t}\n\n\t/** Called by `(mouseleave)` binding in the template. */\n\tonMouseLeave(): void {\n\t\tconst cfg = this.data().config;\n\t\tif (cfg.extendedTimeOut > 0 && cfg.disableTimeOut !== 'extendedTimeOut') {\n\t\t\tthis._startTimer(cfg.extendedTimeOut);\n\t\t}\n\t}\n\n\t/** Called by the host `(click)` binding. */\n\tonTap(): void {\n\t\tconst cfg = this.data().config;\n\t\tthis.data().onTap$.next();\n\t\tif (cfg.tapToDismiss) {\n\t\t\tthis._dismiss();\n\t\t}\n\t}\n\n\t/** Called by the close button in the template. */\n\tonClose(event: Event): void {\n\t\tevent.stopPropagation();\n\t\tthis._dismiss();\n\t}\n\n\tngOnDestroy(): void {\n\t\tthis._clearTimers();\n\t}\n\n\tprivate _startTimer(duration: number): void {\n\t\tconst cfg = this.data().config;\n\t\tconst start = Date.now();\n\n\t\tif (cfg.progressBar) {\n\t\t\tthis._intervalId = setInterval(() => {\n\t\t\t\tconst elapsed = Date.now() - start;\n\t\t\t\tthis.progress.set(Math.max(0, 100 - (elapsed / duration) * 100));\n\t\t\t}, 50);\n\t\t}\n\n\t\tthis._timerId = setTimeout(() => {\n\t\t\tthis._dismiss();\n\t\t}, duration);\n\t}\n\n\tprivate _dismiss(): void {\n\t\tthis._clearTimers();\n\t\tthis.closed.emit(this.data().toastId);\n\t}\n\n\tprivate _clearTimers(): void {\n\t\tif (this._timerId !== null) {\n\t\t\tclearTimeout(this._timerId);\n\t\t\tthis._timerId = null;\n\t\t}\n\t\tif (this._intervalId !== null) {\n\t\t\tclearInterval(this._intervalId);\n\t\t\tthis._intervalId = null;\n\t\t}\n\t\tthis.progress.set(100);\n\t}\n}\n","<div\n\tclass=\"hub-toast__body\"\n\t(mouseenter)=\"onMouseEnter()\"\n\t(mouseleave)=\"onMouseLeave()\"\n>\n\t@if (data().title) {\n\t\t<div class=\"hub-toast__title\">{{ data().title }}</div>\n\t}\n\t<div class=\"hub-toast__message\">{{ data().message }}</div>\n</div>\n\n@if (data().config.closeButton) {\n\t<button\n\t\ttype=\"button\"\n\t\tclass=\"hub-toast__close\"\n\t\taria-label=\"Close\"\n\t\t(click)=\"onClose($event)\"\n\t>\n\t\t<span aria-hidden=\"true\">&times;</span>\n\t</button>\n}\n\n@if (data().config.progressBar) {\n\t<div\n\t\tclass=\"hub-toast__progress\"\n\t\trole=\"progressbar\"\n\t\t[attr.aria-valuenow]=\"progress()\"\n\t\taria-valuemin=\"0\"\n\t\taria-valuemax=\"100\"\n\t>\n\t\t<div class=\"hub-toast__progress-bar\" [style.width.%]=\"progress()\"></div>\n\t</div>\n}\n","import { ChangeDetectionStrategy, Component, inject } from '@angular/core';\nimport { toastAnimation } from '../../animations/toast.animations';\nimport { ToastService } from '../../services/toast.service';\nimport { ToastComponent } from '../toast/toast.component';\n\n/**\n * Fixed-corner container that renders all active toasts.\n *\n * Mounted once by `ToastService._ensureContainerMounted()` and appended\n * directly to `document.body` — never declared in user templates.\n * The `positionClass` from the first toast's config drives the CSS class\n * that positions the container in the viewport corner.\n */\n@Component({\n\tselector: 'hub-toast-container',\n\ttemplateUrl: './toast-container.component.html',\n\tstyleUrl: './toast-container.component.scss',\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n\tanimations: [toastAnimation],\n\timports: [ToastComponent],\n\thost: {\n\t\tclass: 'hub-toast-container',\n\t\t'[class]': 'positionClass()'\n\t}\n})\nexport class ToastContainerComponent {\n\tprotected readonly toastService = inject(ToastService);\n\n\t/** Active toast list from the service signal. */\n\tprotected readonly toasts = this.toastService.toasts;\n\n\t/**\n\t * Position class derived from the first active toast's config.\n\t * Uses the first toast so the container position stays stable across updates.\n\t */\n\tprotected readonly positionClass = () => {\n\t\tconst list = this.toasts();\n\t\treturn list.length > 0 ? list[0].config.positionClass : 'toast-top-right';\n\t};\n\n\t/** Delegates toast removal to `ToastService`. */\n\tprotected onClosed(toastId: number): void {\n\t\tthis.toastService.remove(toastId);\n\t}\n}\n","@for (toast of toasts(); track toast.toastId) {\n\t<hub-toast [data]=\"toast\" (closed)=\"onClosed($event)\" />\n}\n","/*\n * Public API Surface of ng-hub-ui-toast\n */\n\nexport { ToastService } from './lib/services/toast.service';\nexport { ToastConfigService, provideToast, HUB_TOAST_CONFIG, HUB_TOAST_DEFAULT_CONFIG } from './lib/services/toast-config.service';\nexport { ToastComponent } from './lib/components/toast/toast.component';\nexport { ToastContainerComponent } from './lib/components/toast-container/toast-container.component';\nexport type { HubToastRef, HubToastConfig, HubToastType, HubToastData, HubToastPosition } from './lib/models/toast.types';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "ng-hub-ui-toast",
+  "version": "22.0.0",
+  "description": "Standalone Angular 22 toast/notification library, part of the ng-hub-ui family.",
+  "author": "Carlos Morcillo <carlos.morcillo@me.com> (https://www.carlosmorcillo.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/carlos-morcillo/ng-hub-ui-toast.git"
+  },
+  "bugs": {
+    "url": "https://github.com/carlos-morcillo/ng-hub-ui-toast/issues",
+    "email": "carlos.morcillo@me.com"
+  },
+  "homepage": "https://hubui.dev/",
+  "keywords": [
+    "angular",
+    "toast",
+    "notification",
+    "ui-component",
+    "ng-hub-ui",
+    "signals",
+    "standalone"
+  ],
+  "peerDependencies": {
+    "@angular/animations": ">=22.0.0",
+    "@angular/common": ">=22.0.0",
+    "@angular/core": ">=22.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/ng-hub-ui-toast.mjs",
+  "typings": "types/ng-hub-ui-toast.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/ng-hub-ui-toast.d.ts",
+      "default": "./fesm2022/ng-hub-ui-toast.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/ng-hub-ui-toast.d.ts

@@ -0,0 +1,281 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, Provider, OnDestroy } from '@angular/core';
+import * as rxjs from 'rxjs';
+import { Subject } from 'rxjs';
+import * as ng_hub_ui_toast from 'ng-hub-ui-toast';
+
+/**
+ * Built-in semantic toast types. Each maps to the matching
+ * `--hub-sys-color-<type>-*` design-system token family.
+ */
+type HubToastType = 'success' | 'error' | 'warning' | 'info';
+/**
+ * Position of the toast container on screen.
+ */
+type HubToastPosition = 'toast-top-right' | 'toast-top-left' | 'toast-top-center' | 'toast-bottom-right' | 'toast-bottom-left' | 'toast-bottom-center';
+/**
+ * Per-toast configuration. All fields are optional — missing fields
+ * fall back to the global defaults set via `provideToast()`.
+ */
+interface HubToastConfig {
+    /** Duration in ms before auto-dismiss. 0 = persistent. @default 5000 */
+    timeOut: number;
+    /** Extra ms added while the user hovers. @default 2500 */
+    extendedTimeOut: number;
+    /** Show a close button. @default true */
+    closeButton: boolean;
+    /** Show a progress bar counting down to dismissal. @default false */
+    progressBar: boolean;
+    /** Close on click anywhere on the toast. @default true */
+    tapToDismiss: boolean;
+    /**
+     * Disable auto-dismiss.
+     * - `true` / `'timeOut'`: disable the initial timer.
+     * - `'extendedTimeOut'`: disable the hover extension only.
+     * @default false
+     */
+    disableTimeOut: boolean | 'timeOut' | 'extendedTimeOut';
+    /** Newest toast appears at the top of the stack. @default true */
+    newestOnTop: boolean;
+    /** Container position. @default 'toast-top-right' */
+    positionClass: HubToastPosition | string;
+    /** Max simultaneous toasts. 0 = unlimited. @default 0 */
+    maxOpened: number;
+    /** When maxOpened is reached, auto-remove the oldest. @default false */
+    autoDismiss: boolean;
+    /** Ignore duplicate messages already visible. @default false */
+    preventDuplicates: boolean;
+}
+/**
+ * Internal representation of one active toast.
+ * Created by `ToastService` and consumed by `ToastComponent`.
+ */
+interface HubToastData {
+    /** Monotonically increasing identifier. */
+    toastId: number;
+    /** Semantic or custom type string. */
+    type: HubToastType | (string & {});
+    /** Notification body text. */
+    message: string;
+    /** Optional heading. */
+    title?: string;
+    /** Resolved config for this specific toast. */
+    config: HubToastConfig;
+    /** Subject fired once when the toast enters the DOM. */
+    onShown$: Subject<void>;
+    /** Subject fired once when the toast leaves the DOM. */
+    onHidden$: Subject<void>;
+    /** Subject fired when the user taps the toast. */
+    onTap$: Subject<void>;
+}
+/**
+ * Handle returned to callers of `ToastService`. Provides reactive
+ * observables for the toast lifecycle and imperative control methods.
+ */
+interface HubToastRef {
+    /** Unique id of this toast instance. */
+    readonly toastId: number;
+    /** Emits once when the toast becomes visible. */
+    readonly onShown: rxjs.Observable<void>;
+    /** Emits once when the toast is removed from the DOM. */
+    readonly onHidden: rxjs.Observable<void>;
+    /** Emits each time the user clicks on the toast body. */
+    readonly onTap: rxjs.Observable<void>;
+    /** Immediately removes the toast. */
+    manualClose(): void;
+    /** Restart the auto-dismiss timer from zero. */
+    resetTimeout(): void;
+}
+
+/**
+ * Core service for displaying toast notifications.
+ * Manages the active toast stack as a signal and lazily mounts the
+ * container overlay on the first toast call.
+ *
+ * @example
+ * ```typescript
+ * constructor(private toastr: ToastService) {}
+ *
+ * save() {
+ *   this.toastr.success('Record saved', 'Success');
+ * }
+ * ```
+ */
+declare class ToastService {
+    private readonly _config;
+    private readonly _appRef;
+    /** Read-only signal of all currently active toasts. */
+    readonly toasts: i0.WritableSignal<HubToastData[]>;
+    private _containerMounted;
+    /** Reference to the lazily created container, kept for explicit CD triggers. */
+    private _containerRef;
+    /**
+     * Shows a success toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    success(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef;
+    /**
+     * Shows an error toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    error(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef;
+    /**
+     * Shows a warning toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    warning(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef;
+    /**
+     * Shows an informational toast.
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     */
+    info(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef;
+    /**
+     * Shows a toast with a custom or built-in type.
+     * The type string is applied as `data-type` on the toast host element
+     * and drives the SCSS `@each` accent loop.
+     *
+     * @param message - Notification body.
+     * @param title - Optional heading.
+     * @param config - Per-call config overrides.
+     * @param type - Semantic type or any custom string.
+     */
+    show(message: string, title?: string, config?: Partial<HubToastConfig>, type?: HubToastType | (string & {})): HubToastRef;
+    /**
+     * Removes a specific toast by id.
+     * @param toastId - The id returned by the show method.
+     */
+    remove(toastId: number): void;
+    /** Removes all active toasts immediately. */
+    clear(): void;
+    private _removeById;
+    private _refForExisting;
+    private _buildRef;
+    /**
+     * Lazily mounts the `ToastContainerComponent` via Angular's `createComponent`.
+     * Called on the first toast — subsequent calls are no-ops.
+     */
+    private _ensureContainerMounted;
+    /**
+     * Explicitly runs change detection on the container.
+     *
+     * Views created via `createComponent` + `attachView` are not reachable by
+     * Angular's signal-based "mark ancestors dirty" traversal, so they do not
+     * update automatically when a signal changes. Calling `detectChanges()`
+     * directly on the container's `ChangeDetectorRef` is the reliable alternative.
+     */
+    private _syncContainer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ToastService>;
+}
+
+/** Default configuration applied to every toast unless overridden. */
+declare const HUB_TOAST_DEFAULT_CONFIG: HubToastConfig;
+/** Injection token for the global toast configuration. */
+declare const HUB_TOAST_CONFIG: InjectionToken<Partial<HubToastConfig>>;
+/**
+ * Registers the toast library providers.
+ * Call inside `ApplicationConfig.providers` or a route's `providers` array.
+ *
+ * @param config - Partial global defaults merged over {@link HUB_TOAST_DEFAULT_CONFIG}.
+ *
+ * @example
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [provideToast({ timeOut: 3000, progressBar: true })]
+ * };
+ * ```
+ */
+declare function provideToast(config?: Partial<HubToastConfig>): Provider[];
+/**
+ * Resolves per-toast config by merging global defaults, the provider override,
+ * and any per-call overrides. Injected by `ToastService`.
+ */
+declare class ToastConfigService {
+    private readonly _override;
+    /** Returns the merged global config (default ← provider override). */
+    get defaults(): HubToastConfig;
+    /**
+     * Merges global defaults with per-call overrides into a final config.
+     *
+     * @param perCall - Per-call partial overrides.
+     * @returns Fully resolved config for one toast.
+     */
+    resolve(perCall?: Partial<HubToastConfig>): HubToastConfig;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ToastConfigService>;
+}
+
+/**
+ * Renders a single toast notification.
+ *
+ * Driven by a {@link HubToastData} input. Manages its own auto-dismiss timer
+ * via `signal` + `effect` and emits `(closed)` with the toast id when done.
+ *
+ * The `data-type` host attribute drives the `@each` SCSS accent loop;
+ * `--hub-toast-accent` is set inline only for custom types.
+ */
+declare class ToastComponent implements OnDestroy {
+    /** Toast data provided by `ToastContainerComponent`. */
+    readonly data: i0.InputSignal<HubToastData>;
+    /** Emits the toast id when this toast should be dismissed. */
+    readonly closed: i0.OutputEmitterRef<number>;
+    /** Remaining progress as a percentage (100 → 0). Used by the progress bar. */
+    readonly progress: i0.WritableSignal<number>;
+    /**
+     * Inline accent token. Null for built-in types (covered by `@each`);
+     * `var(--hub-sys-color-<type>)` for custom types so `color-mix` derives
+     * the other tokens automatically.
+     */
+    readonly accentToken: i0.Signal<string | null>;
+    private _timerId;
+    private _intervalId;
+    constructor();
+    /** Called by `(mouseenter)` binding in the template. */
+    onMouseEnter(): void;
+    /** Called by `(mouseleave)` binding in the template. */
+    onMouseLeave(): void;
+    /** Called by the host `(click)` binding. */
+    onTap(): void;
+    /** Called by the close button in the template. */
+    onClose(event: Event): void;
+    ngOnDestroy(): void;
+    private _startTimer;
+    private _dismiss;
+    private _clearTimers;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastComponent, "hub-toast", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; }, { "closed": "closed"; }, never, never, true, never>;
+}
+
+/**
+ * Fixed-corner container that renders all active toasts.
+ *
+ * Mounted once by `ToastService._ensureContainerMounted()` and appended
+ * directly to `document.body` — never declared in user templates.
+ * The `positionClass` from the first toast's config drives the CSS class
+ * that positions the container in the viewport corner.
+ */
+declare class ToastContainerComponent {
+    protected readonly toastService: ToastService;
+    /** Active toast list from the service signal. */
+    protected readonly toasts: i0.WritableSignal<ng_hub_ui_toast.HubToastData[]>;
+    /**
+     * Position class derived from the first active toast's config.
+     * Uses the first toast so the container position stays stable across updates.
+     */
+    protected readonly positionClass: () => string;
+    /** Delegates toast removal to `ToastService`. */
+    protected onClosed(toastId: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastContainerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastContainerComponent, "hub-toast-container", never, {}, {}, never, never, true, never>;
+}
+
+export { HUB_TOAST_CONFIG, HUB_TOAST_DEFAULT_CONFIG, ToastComponent, ToastConfigService, ToastContainerComponent, ToastService, provideToast };
+export type { HubToastConfig, HubToastData, HubToastPosition, HubToastRef, HubToastType };