@scania-nl/tegel-angular-extensions 0.0.4 → 0.0.6

package/index.d.ts

@@ -1,4 +1,547 @@
-export * from './lib/toast/provide-toast';
-export * from './lib/toast/toast.config';
-export * from './lib/toast/toast.service';
-export * from './lib/toast/models/toast.model';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+import z$1, { z } from 'zod';
+import { zx } from '@traversable/zod';
+import { Subject } from 'rxjs';
+
+/**
+ * List of available toast types (inherited from Tegel)
+ */
+declare const TOAST_TYPES: readonly ["success", "information", "warning", "error"];
+/**
+ * Type representing valid toast type values.
+ */
+type ToastType = (typeof TOAST_TYPES)[number];
+
+/**
+ * Global default configuration for toast behavior.
+ * Used when individual toast properties are not explicitly set.
+ */
+interface ToastConfig {
+    /**
+     * Default toast type (e.g., 'success', 'information', etc.).
+     */
+    type: ToastType;
+    /**
+     * Default title to use when none is provided.
+     */
+    title: string;
+    /**
+     * Default description to use when none is provided.
+     */
+    description: string;
+    /**
+     * Default duration (ms) before auto-dismiss.
+     * Use `0` for persistent toasts.
+     */
+    duration: number;
+    /**
+     * Default duration (ms) for the fade-out animation.
+     */
+    closeDuration: number;
+    /**
+     * Whether toasts are closable by default.
+     */
+    closable: boolean;
+}
+declare const TOAST_CONFIG: InjectionToken<ToastConfig>;
+declare const DEFAULT_TOAST_CONFIG: Required<ToastConfig>;
+
+declare function provideToast(config?: Partial<ToastConfig>): EnvironmentProviders;
+
+/**
+ * Represents the current lifecycle state of a toast.
+ */
+declare enum ToastState {
+    /**
+     * The toast is fully visible and active.
+     */
+    Open = "open",
+    /**
+     * The toast is transitioning out (e.g., fading out).
+     */
+    Closing = "closing",
+    /**
+     * The toast is fully removed or dismissed.
+     */
+    Closed = "closed"
+}
+
+/**
+ * Defines the base structure for a toast message.
+ */
+interface ToastOptions {
+    /**
+     * The visual style of the toast (e.g., success, error).
+     */
+    type: ToastType;
+    /**
+     * The main title text displayed in the toast.
+     */
+    title: string;
+    /**
+     * Optional description text providing additional context.
+     */
+    description?: string;
+    /**
+     * Duration in milliseconds before the toast auto-dismisses.
+     * Use `0` for persistent toasts.
+     */
+    duration: number;
+    /**
+     * Duration in milliseconds for the fade-out transition.
+     */
+    closeDuration: number;
+    /**
+     * Whether the toast can be manually closed by the user.
+     */
+    closable?: boolean;
+    /**
+     * Optional router link to navigate to when the toast is clicked.
+     */
+    link?: string;
+    /**
+     * Custom link text shown if a link is provided.
+     */
+    linkText?: string;
+    /**
+     * Optional callback triggered when the linkText is clicked.
+     * Used as an alternative to `link` for invoking custom behavior.
+     */
+    action?: () => void;
+    /**
+     * Optional callback triggered when the toast is created.
+     * @param toast The created toast instance.
+     */
+    onCreated?: (toast: Toast) => void;
+    /**
+     * Optional callback triggered when the toast begins to close.
+     * @param toast The toast that is closing.
+     */
+    onClose?: (toast: Toast) => void;
+    /**
+     * Optional callback triggered when the toast has been fully removed.
+     * @param toast The removed toast instance.
+     */
+    onRemoved?: (toast: Toast) => void;
+}
+/**
+ * Represents a fully instantiated toast, including unique ID and current state.
+ */
+interface Toast extends ToastOptions {
+    /**
+     * Unique identifier for the toast instance.
+     */
+    id: number;
+    /**
+     * The current state of the toast (open, closing, or closed).
+     */
+    state: ToastState;
+}
+
+/**
+ * Service for creating, managing, and removing toast notifications.
+ * Supports automatic dismissal, manual control, and lifecycle hooks.
+ */
+declare class ToastService {
+    private readonly config;
+    /** Internal ID tracker for unique toast IDs */
+    private id;
+    /** Signal state holding all toasts */
+    private readonly _toasts;
+    /** Public signal of all toasts */
+    readonly toasts: _angular_core.Signal<Toast[]>;
+    /** Signal of toasts that are not yet closed (open or closing) */
+    readonly activeToasts: _angular_core.Signal<Toast[]>;
+    /** Internal stream for auto-closing toasts */
+    private readonly autoCloseSubject;
+    /** Internal stream for fade-out/removal of toasts */
+    private readonly closeSubject;
+    constructor();
+    /**
+     * Creates and adds a new toast.
+     * @param toastOptions Partial toast definition.
+     * @returns The toast's unique ID.
+     */
+    create(toastOptions: Partial<ToastOptions>): number;
+    /**
+     * Initiates the fade-out transition for a toast.
+     * @param id The toast ID.
+     */
+    close(id: number): void;
+    /**
+     * Immediately marks a toast as closed and removes it from display.
+     * @param id The toast ID.
+     */
+    remove(id: number): void;
+    /**
+     * Closes and removes all toasts immediately without fade-out.
+     */
+    removeAll(): void;
+    /**
+     * Initiates closing process for all open toasts.
+     */
+    closeAll(): void;
+    /**
+     * Gets a toast by ID.
+     * @param id The toast ID.
+     * @returns The toast instance or undefined.
+     */
+    getToast(id: number): Toast | undefined;
+    /** Whether the toast is eligible for auto-closing */
+    private shouldAutoClose;
+    /** Whether the toast is eligible for final removal */
+    private shouldRemove;
+    /** Add toast to signal list */
+    private addToast;
+    /**
+     * Updates the state of a toast.
+     * @param id Toast ID
+     * @param state New state
+     * @returns The updated toast or undefined
+     */
+    private updateToastState;
+    /**
+     * Creates a unique id
+     * @returns New id
+     */
+    private createId;
+    /**
+     * Creates a success toast.
+     * @param props Toast props without type.
+     */
+    readonly success: (props?: Partial<Omit<ToastOptions, "type">>) => number;
+    /**
+     * Creates an error toast.
+     * @param props Toast props without type.
+     */
+    readonly error: (props?: Partial<Omit<ToastOptions, "type">>) => number;
+    /**
+     * Creates a warning toast.
+     * @param props Toast props without type.
+     */
+    readonly warning: (props?: Partial<Omit<ToastOptions, "type">>) => number;
+    /**
+     * Creates an informational toast.
+     * @param props Toast props without type.
+     */
+    readonly info: (props?: Partial<Omit<ToastOptions, "type">>) => number;
+    /**
+     * Creates a random toast for testing/demo purposes.
+     * @param props Optional overrides
+     */
+    readonly createRandomToast: (props?: Partial<ToastOptions>) => number;
+    private normalizeDuration;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToastService>;
+}
+
+/**
+ * Extracts the **output type** (validated runtime shape)
+ * from a Zod object schema — e.g. `z.output<typeof MySchema>`.
+ */
+type SchemaOutput<S extends z.ZodObject<z.ZodRawShape>> = z.output<S>;
+/**
+ * Represents a **development-time static environment** configuration.
+ * - `production` is always `false`.
+ * - Runtime-required keys (e.g. API URLs) are **optional** and may be set for local dev.
+ */
+type DevStaticEnvFrom<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof SchemaOutput<S>)[]> = Omit<SchemaOutput<S>, K[number]> & {
+    production: false;
+} & Partial<Pick<SchemaOutput<S>, K[number]>>;
+/**
+ * Represents a **production-time static environment** configuration.
+ * - `production` is always `true`.
+ * - Runtime-required keys are **forbidden** here and must be provided at runtime.
+ */
+type ProdStaticEnvFrom<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof SchemaOutput<S>)[]> = Omit<SchemaOutput<S>, K[number]> & {
+    production: true;
+} & {
+    [P in K[number]]?: never;
+};
+/**
+ * Union type combining both development and production static environments.
+ * Used by `environment.ts` and `environment.prod.ts` to ensure correct key rules per mode.
+ */
+type StaticEnvFrom<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof SchemaOutput<S>)[]> = DevStaticEnvFrom<S, K> | ProdStaticEnvFrom<S, K>;
+/**
+ * Represents the **base default environment** for development builds.
+ * - Contains all common defaults.
+ * - Excludes runtime-required keys entirely from its type.
+ * - `production` is fixed to `false`.
+ */
+type DevDefaultsFrom<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof SchemaOutput<S>)[]> = Omit<SchemaOutput<S>, K[number]> & {
+    production: false;
+};
+/**
+ * Generic interface returned by `createEnvKit`.
+ * Defines all helper methods and static typing for a fully type-safe environment configuration system.
+ */
+interface EnvKit<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof SchemaOutput<S>)[]> {
+    /** Full Zod schema provided by the consumer */
+    schema: S;
+    /** Deep-partial schema (created via `zx.deepPartial(schema)`) used for runtime override validation */
+    runtimeOverridesSchema: zx.deepPartial.Semantic<S>;
+    /** List of top-level keys that must be defined at runtime when `production=true` */
+    runtimeRequiredKeys: K;
+    /** Parse raw `.env` content into a validated, deep-partial override object */
+    parseRuntimeOverridesAsync(raw: Record<string, unknown>): Promise<Partial<SchemaOutput<S>>>;
+    /** Merge static environment + runtime overrides, then validate using the Zod schema (async) */
+    mergeAndValidateAsync(staticEnv: StaticEnvFrom<S, K>, overrides?: Partial<SchemaOutput<S>>): Promise<SchemaOutput<S>>;
+    /** Type tokens (erased at runtime) for compile-time inference convenience */
+    types: {
+        /** The full validated config type (Zod output) */
+        EnvConfig: SchemaOutput<S>;
+        /** The dev-only defaults type (no runtime-required keys) */
+        DevDefaults: DevDefaultsFrom<S, K>;
+        /** Dev environment type (runtime keys optional) */
+        DevStaticEnv: DevStaticEnvFrom<S, K>;
+        /** Prod environment type (runtime keys forbidden) */
+        ProdStaticEnv: ProdStaticEnvFrom<S, K>;
+        /** Combined type of all static envs */
+        StaticEnv: StaticEnvFrom<S, K>;
+        /** The union of all runtime-required key names */
+        RuntimeRequired: K[number];
+    };
+}
+
+/**
+ * Builds a **type-safe environment kit** around a Zod schema.
+ *
+ * This utility encapsulates all environment configuration logic in a reusable,
+ * strongly-typed structure that:
+ * - Validates **deep-partial** runtime overrides using `zx.deepPartial(schema)`.
+ * - Ensures that **runtime-required keys** are provided when `production=true`.
+ * - Merges static defaults with runtime overrides and validates the **final config** asynchronously.
+ *
+ * @typeParam S - The Zod schema type describing the full environment configuration.
+ * @typeParam K - The list of top-level keys that must be supplied at runtime in production builds.
+ *
+ * @param params.schema - The full Zod schema defining the configuration structure.
+ * @param params.runtimeRequiredKeys - Keys that must be present in runtime overrides for production.
+ *
+ * @returns A fully-typed {@link EnvKit} instance exposing validation helpers, runtime parsers, and type tokens.
+ */
+declare function createEnvKit<S extends z.ZodObject<z.ZodRawShape>, K extends readonly (keyof z.output<S>)[]>(params: {
+    /** The full Zod schema describing the app's configuration shape. */
+    schema: S;
+    /** Keys that must be provided at runtime when `production=true`. */
+    runtimeRequiredKeys: K;
+}): EnvKit<S, K>;
+
+/**
+ * Parses the contents of a `.env`-style file into a nested JavaScript object.
+ *
+ * Each line in the input string is expected to follow the format `KEY=VALUE`.
+ * Nested keys can be created using a configurable delimiter (default: `"__"`).
+ * Lines starting with `#` or containing only whitespace are ignored.
+ *
+ * Examples:
+ * ```env
+ * API_URL=https://api.local
+ * LOG__LEVEL=debug
+ * DB__CONNECTION__TIMEOUT=30
+ * ```
+ * Produces:
+ * ```ts
+ * {
+ *   API_URL: "https://api.local",
+ *   LOG: { LEVEL: "debug" },
+ *   DB: { CONNECTION: { TIMEOUT: "30" } }
+ * }
+ * ```
+ *
+ * @param raw - The raw `.env` file content as a string.
+ * @param delimiter - The delimiter used to represent nested keys (default: `"__"`).
+ * @returns A nested object representing all parsed key-value pairs.
+ */
+declare function parseEnvFile(raw: string, delimiter?: string): Record<string, unknown>;
+
+/**
+ * Options for configuring the Angular runtime-config provider.
+ *
+ * @property envPath
+ * The URL (or path) to the runtime `.env` file that will be fetched at app start.
+ * Defaults to `"/env/runtime.env"`.
+ *
+ * @property debug
+ * Enables verbose console logging when `true`. Defaults to `false`.
+ *
+ * @property stopOnError
+ * If `true`, any failure while loading/parsing/validating the runtime config
+ * will reject the app initializer and **abort boot** (recommended for prod).
+ * If `false`, the provider falls back to the static environment only.
+ * Defaults to `true`.
+ *
+ * @property token
+ * Optional `InjectionToken` used to expose the validated configuration
+ * via Angular dependency injection. If omitted, the provider will create one
+ * automatically named `ENV_CONFIG`.
+ */
+interface ProvideRuntimeConfigOptions<S extends z$1.ZodObject<z$1.ZodRawShape>> {
+    /** Path to the runtime env file (default: /env/runtime.env) */
+    envPath?: string;
+    /** Log debug info to console */
+    debug?: boolean;
+    /** Throw on error to stop app boot (default: true) */
+    stopOnError?: boolean;
+    /** Injection token used to provide the validated config via Angular DI */
+    token?: InjectionToken<SchemaOutput<S>>;
+}
+/**
+ * Registers providers that:
+ * - Fetch a runtime `.env` file at startup,
+ * - Parse it to a deep-partial structure via the kit,
+ * - Enforce runtime-required keys when appropriate,
+ * - Merge with the static environment,
+ * - Validate the **final** configuration against the Zod schema,
+ * - Expose the resulting config via a generated `InjectionToken`.
+ *
+ * @typeParam S - Zod schema type describing the full config shape.
+ * @typeParam K - List of runtime-required top-level keys.
+ *
+ * @param kit
+ * The `EnvKit` created by `createEnvKit(schema, runtimeRequiredKeys)`.
+ *
+ * @param options
+ * Runtime loading behavior and DI token description. See {@link ProvideRuntimeConfigOptions}.
+ *
+ * @returns The `EnvironmentProviders` to be added to `appConfig.providers`,
+ *
+ * @remarks
+ * - This uses an Angular **functional app initializer** to perform the load step.
+ * - If the server returns an HTML SPA fallback (instead of the `.env` file), the provider
+ *   quietly uses the static environment (no runtime overrides).
+ */
+declare function provideRuntimeConfig<S extends z$1.ZodObject<z$1.ZodRawShape>, K extends readonly (keyof z$1.output<S>)[]>(kit: EnvKit<S, K>, staticEnv: StaticEnvFrom<S, K>, { envPath, debug, stopOnError, token, }?: ProvideRuntimeConfigOptions<S>): EnvironmentProviders;
+
+/**
+ * Options for configuring the Angular static-config provider.
+ *
+ * @property token
+ * A required `InjectionToken<T>` under which the static environment
+ * configuration will be registered. Angular resolves providers exclusively
+ * by **token instance identity**, not by token name or description, so the
+ * caller must supply the exact `InjectionToken<T>` that consumers will use
+ * when injecting the configuration.
+ */
+type ProvideStaticConfigOptions<T> = {
+    token: InjectionToken<T>;
+};
+/**
+ * Registers providers that:
+ * - Expose a **static** environment configuration object via Angular DI,
+ * - Perform **no** runtime `.env` fetching or asynchronous initialization,
+ * - Mirror Angular’s standard build-time pattern:
+ *
+ *     { provide: SOME_TOKEN, useValue: environment }
+ *
+ * This is intended for applications that:
+ * - Use only `environment.ts` build-time configuration,
+ * - Do not require runtime overrides or external `.env` files,
+ * - Wish to keep bootstrap logic minimal and predictable,
+ * - Or are running in unit tests where a fixed static config is sufficient.
+ *
+ * @typeParam T - The shape of the static configuration object.
+ *
+ * @param env
+ * The static configuration instance to expose via DI. Defaults to an empty
+ * object if omitted, enabling callers to provide minimal configuration
+ * without boilerplate.
+ *
+ * @param options
+ * A `ProvideStaticConfigOptions<T>` containing the **required**
+ * `InjectionToken<T>` under which the configuration will be registered.
+ * Angular DI resolves providers solely by token instance identity, so the
+ * caller must supply the exact token that consumers will inject.
+ *
+ * @returns The `EnvironmentProviders` to be added to `appConfig.providers`.
+ *
+ * @remarks
+ * The static provider is intentionally minimal, offering a lightweight
+ * counterpart to `provideRuntimeConfig` for apps that rely on build-time
+ * environment values only.
+ */
+declare function provideStaticConfig<T>(env: T | undefined, options: ProvideStaticConfigOptions<T>): EnvironmentProviders;
+
+/**
+ * Directive that triggers a hard page refresh when the host element is clicked
+ * a specified number of times within a configurable time window.
+ *
+ * This is useful for adding developer-oriented shortcuts, diagnostics entry points,
+ * hidden "triple-click to reload" behaviors, or fallback mechanisms in production.
+ *
+ * Usage:
+ * ```html
+ * <div taeHardRefresh [clicksRequired]="3" [clickWindowMs]="500">...</div>
+ * ```
+ */
+declare class HardRefreshDirective {
+    /**
+     * The number of rapid consecutive clicks required to trigger a hard refresh.
+     * A "rapid" click is one that occurs within `clickWindowMs` of the previous click.
+     *
+     * @default 3
+     */
+    readonly clicksRequired: _angular_core.InputSignal<number>;
+    /**
+     * The maximum time interval (in milliseconds) allowed between consecutive clicks
+     * for them to be considered part of the same "streak".
+     *
+     * If the interval between two clicks exceeds this value, the streak resets.
+     *
+     * @default 500
+     */
+    readonly clickWindowMs: _angular_core.InputSignal<number>;
+    /**
+     * Internal click event stream used to build the rapid-click detection pipeline.
+     * Emits one value per host click (via the `(click)` host listener).
+     */
+    protected readonly clicks$: Subject<void>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<HardRefreshDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<HardRefreshDirective, "[taeHardRefresh]", never, { "clicksRequired": { "alias": "clicksRequired"; "required": false; "isSignal": true; }; "clickWindowMs": { "alias": "clickWindowMs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * An enhanced standalone footer component based on the Tegel `TdsFooterComponent`.
+ *
+ * `TaeFooterComponent` maintains the same visual style as the original
+ * Tegel footer, but adds two key improvements:
+ *
+ * - A **compact “small” variant** for layouts where vertical space is limited.
+ * - Optional **version display**, allowing applications to show their
+ *   build or release version directly in the footer.
+ *
+ * Example:
+ * ```html
+ * <tae-footer variant="small" version="v1.0.0" />
+ * ```
+ */
+declare class TaeFooterComponent {
+    /**
+     * Determines the visual layout of the footer.
+     *
+     * - `"normal"` displays the standard footer layout (aligned to tds-footer)
+     * - `"small"` produces a more compact version suitable for tight layouts
+     *
+     * @default 'normal'
+     */
+    readonly variant: _angular_core.InputSignal<"normal" | "small">;
+    /**
+     * Optional application version string to display in the footer.
+     *
+     * When provided, it appears left of the Scania logo.
+     * If omitted or `undefined`, the version section is not shown.
+     */
+    readonly version: _angular_core.InputSignal<string | undefined>;
+    /**
+     * The current year used in the copyright section.
+     */
+    readonly currentYear: number;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TaeFooterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TaeFooterComponent, "tae-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "version": { "alias": "version"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { DEFAULT_TOAST_CONFIG, HardRefreshDirective, TOAST_CONFIG, TaeFooterComponent, ToastService, createEnvKit, parseEnvFile, provideRuntimeConfig, provideStaticConfig, provideToast };
+export type { Toast, ToastConfig, ToastOptions };

package/package.json

@@ -1,22 +1,34 @@
 {
   "name": "@scania-nl/tegel-angular-extensions",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@angular/common": "^19.0.0",
-    "@angular/core": "^19.0.0",
-    "@angular/router": "^19.0.0",
-    "@scania/tegel-angular-17": "^1.0.0",
-    "rxjs": "~7.8.0"
+    "@angular/common": ">=19",
+    "@angular/core": ">=19",
+    "@angular/router": ">=19",
+    "@scania/tegel-angular-17": ">=1.0.0",
+    "@traversable/zod": "^0.0.57",
+    "rxjs": ">=7.8.0",
+    "zod": "^4.1.12"
   },
   "sideEffects": false,
   "author": {
     "name": "Patrick Groot Koerkamp",
     "email": "patrick.groot.koerkamp@scania.com"
   },
+  "bin": {
+    "docker-entrypoint": "bin/docker-entrypoint.sh"
+  },
+  "files": [
+    "fesm2022/",
+    "esm2022/",
+    "bin/",
+    "docker/",
+    "index.d.ts"
+  ],
   "module": "esm2022/scania-nl-tegel-angular-extensions.mjs",
   "typings": "index.d.ts",
   "exports": {

package/lib/toast/models/toast-state.enum.d.ts

@@ -1,17 +0,0 @@
-/**
- * Represents the current lifecycle state of a toast.
- */
-export declare enum ToastState {
-    /**
-     * The toast is fully visible and active.
-     */
-    Open = "open",
-    /**
-     * The toast is transitioning out (e.g., fading out).
-     */
-    Closing = "closing",
-    /**
-     * The toast is fully removed or dismissed.
-     */
-    Closed = "closed"
-}

package/lib/toast/models/toast-type.d.ts

@@ -1,8 +0,0 @@
-/**
- * List of available toast types (inherited from Tegel)
- */
-export declare const TOAST_TYPES: readonly ["success", "information", "warning", "error"];
-/**
- * Type representing valid toast type values.
- */
-export type ToastType = (typeof TOAST_TYPES)[number];

package/lib/toast/models/toast.model.d.ts

@@ -1,73 +0,0 @@
-import { ToastState } from './toast-state.enum';
-import { ToastType } from './toast-type';
-/**
- * Defines the base structure for a toast message.
- */
-export interface ToastOptions {
-    /**
-     * The visual style of the toast (e.g., success, error).
-     */
-    type: ToastType;
-    /**
-     * The main title text displayed in the toast.
-     */
-    title: string;
-    /**
-     * Optional description text providing additional context.
-     */
-    description?: string;
-    /**
-     * Duration in milliseconds before the toast auto-dismisses.
-     * Use `0` for persistent toasts.
-     */
-    duration: number;
-    /**
-     * Duration in milliseconds for the fade-out transition.
-     */
-    closeDuration: number;
-    /**
-     * Whether the toast can be manually closed by the user.
-     */
-    closable?: boolean;
-    /**
-     * Optional router link to navigate to when the toast is clicked.
-     */
-    link?: string;
-    /**
-     * Custom link text shown if a link is provided.
-     */
-    linkText?: string;
-    /**
-     * Optional callback triggered when the linkText is clicked.
-     * Used as an alternative to `link` for invoking custom behavior.
-     */
-    action?: () => void;
-    /**
-     * Optional callback triggered when the toast is created.
-     * @param toast The created toast instance.
-     */
-    onCreated?: (toast: Toast) => void;
-    /**
-     * Optional callback triggered when the toast begins to close.
-     * @param toast The toast that is closing.
-     */
-    onClose?: (toast: Toast) => void;
-    /**
-     * Optional callback triggered when the toast has been fully removed.
-     * @param toast The removed toast instance.
-     */
-    onRemoved?: (toast: Toast) => void;
-}
-/**
- * Represents a fully instantiated toast, including unique ID and current state.
- */
-export interface Toast extends ToastOptions {
-    /**
-     * Unique identifier for the toast instance.
-     */
-    id: number;
-    /**
-     * The current state of the toast (open, closing, or closed).
-     */
-    state: ToastState;
-}