@malva-ui/core 0.1.13 → 0.1.14

package/types/malva-ui-core-toast.d.ts

@@ -0,0 +1,432 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, Injector, TemplateRef, Type, Signal, EnvironmentInjector, OnInit, OnDestroy, ElementRef } from '@angular/core';
+import { MlvTone, MlvRtlService } from '@malva-ui/cdk/utils';
+import { Observable } from 'rxjs';
+import { Overlay } from '@angular/cdk/overlay';
+import { LiveAnnouncer } from '@angular/cdk/a11y';
+import * as _malva_ui_core_toast from '@malva-ui/core/toast';
+import * as _malva_ui_i18n from '@malva-ui/i18n';
+
+/**
+ * Handle returned by `MlvToastService.show()` and `MlvToastService.open()`.
+ *
+ * It can be injected by component content, is exposed to template content, and
+ * guarantees that repeated close requests only reach the service once.
+ *
+ * @typeParam D - Type of the data supplied for this toast.
+ */
+declare class MlvToastRef<D = unknown> implements MlvBaseToastRef {
+    /** Unique ID assigned by the toast or notification service. */
+    readonly id: string;
+    /** Data supplied through the toast or notification configuration. */
+    readonly data: D;
+    /** @private Emits once when the toast has been removed by its service. */
+    private readonly _afterClosed;
+    /** @private Mutable backing state for the public `closed` signal. */
+    private readonly _closed;
+    /** @private Callback that routes closure through the owning service. */
+    private readonly _requestClose;
+    /** @private Prevents duplicate service close requests. */
+    private _closeRequested;
+    /** Whether this toast has finished its service-owned close lifecycle. */
+    readonly closed: i0.Signal<boolean>;
+    constructor(id: string, data: D, requestClose: () => void);
+    /** Requests programmatic dismissal of this toast. Safe to call repeatedly. */
+    close(): void;
+    /** Emits once when the owning service removes the toast, then completes. */
+    afterClosed(): Observable<void>;
+    /** @internal Completes this reference exactly once from the owning service. */
+    _markClosed(): void;
+}
+
+type MlvToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+type MlvToastTone = MlvTone | 'default';
+/**
+ * Outer shape of a toast item.
+ *
+ * - `'default'` — rectangle with the standard large corner radius.
+ * - `'pill'` — fully rounded, content-hugging compact bar.
+ */
+type MlvToastShape = 'default' | 'pill';
+declare const MLV_TOAST_CLOSE: InjectionToken<(id: string) => void>;
+/** Politeness used when announcing a toast/notification through `LiveAnnouncer`. */
+type MlvToastPoliteness = 'polite' | 'assertive';
+/**
+ * Maps a toast/notification tone to its default announcement politeness.
+ *
+ * High-urgency tones (`danger`, `warning`) announce assertively so assistive
+ * technology interrupts the user. Informational tones (`success`, `info`,
+ * `default`) announce politely, without interrupting the current context.
+ *
+ * Callers can override the result per item with `MlvBaseToastConfig.politeness`.
+ *
+ * @param tone - The resolved toast/notification tone.
+ * @returns `'assertive'` for danger/warning, otherwise `'polite'`.
+ */
+declare function resolveToastPoliteness(tone: string): MlvToastPoliteness;
+/**
+ * Joins the text fragments of a toast/notification into one announcement string.
+ *
+ * Blank and absent fragments are dropped rather than interpolated — otherwise an
+ * omitted description announces a stray separator, or the literal text
+ * "undefined". Trailing sentence punctuation is normalised so a description that
+ * already ends in a full stop does not produce a doubled one.
+ *
+ * @param parts - Fragments in reading order (title, description, action labels…).
+ * @returns The joined announcement, or `''` when nothing is announceable.
+ */
+declare function joinAnnouncementParts(parts: readonly (string | undefined | null)[]): string;
+interface MlvBaseToastConfig<D = unknown> {
+    position?: MlvToastPosition;
+    /** Arbitrary data available to dynamic content through the ref, token, and template context. */
+    data?: D;
+    /** Parent injector used for dynamically rendered template or component content. */
+    injector?: Injector;
+    /** Duration in ms before auto-close. 0 = never auto-close. Default: 4000 */
+    displayTime?: number;
+    /** Pause the timer when cursor is over the item, restart on leave. Default: true */
+    pauseOnHover?: boolean;
+    /** Show the X close button. When false, only displayTime can close it. Default: true */
+    closable?: boolean;
+    /**
+     * Politeness used when announcing this item through the CDK `LiveAnnouncer`.
+     * Defaults to `resolveToastPoliteness(tone)` — assertive for danger/warning,
+     * polite otherwise.
+     *
+     * The announcement is made from a single persistent live region owned by
+     * `LiveAnnouncer`, not from the rendered item. The item itself carries no
+     * `role`/`aria-live`, so nothing is announced twice and a stack of items does
+     * not create a stack of live regions.
+     */
+    politeness?: MlvToastPoliteness;
+}
+interface MlvInternalBaseToast {
+    id: string;
+    position: MlvToastPosition;
+    displayTime: number;
+    pauseOnHover: boolean;
+    closable: boolean;
+}
+interface MlvBaseToastRef {
+    readonly id: string;
+    close(): void;
+    afterClosed(): Observable<void>;
+}
+interface MlvToastConfig<D = unknown> extends MlvBaseToastConfig<D> {
+    title: string;
+    description?: string;
+    tone?: MlvToastTone;
+    /**
+     * Shows the tone-derived Lucide icon. Only the four semantic tones have one —
+     * with `tone: 'default'` this renders nothing. Default: false.
+     */
+    icon?: boolean;
+    /** Outer shape. Default: `'default'`. */
+    shape?: MlvToastShape;
+}
+/** Options for `MlvToastService.open()` where content is supplied separately. */
+interface MlvToastOpenConfig<D = unknown> extends MlvBaseToastConfig<D> {
+    description?: string;
+    tone?: MlvToastTone;
+    /**
+     * Shows the tone-derived Lucide icon. Applies only when `open()` receives
+     * string or `{ title, description }` content — template and component content
+     * own their own leading icon through `[mlvToastIcon]`, so the built-in icon is
+     * always suppressed for those branches. Default: false.
+     */
+    icon?: boolean;
+    /** Outer shape. Default: `'default'`. */
+    shape?: MlvToastShape;
+}
+/** Context exposed when `MlvToastService.open()` receives a `TemplateRef`. */
+interface MlvToastTemplateContext<D = unknown> {
+    $implicit: MlvToastRef<D>;
+    ref: MlvToastRef<D>;
+    data: D;
+    config: Readonly<MlvToastOpenConfig<D>>;
+}
+/** Content accepted by `MlvToastService.open()`. Strings are rendered as escaped text. */
+type MlvToastContent<D = unknown> = string | {
+    title?: string;
+    description?: string;
+} | TemplateRef<MlvToastTemplateContext<D>> | Type<unknown>;
+/** Data available to component content opened through `MlvToastService.open()`. */
+declare const TOAST_DATA: InjectionToken<unknown>;
+/** Configuration available to component content opened through `MlvToastService.open()`. */
+declare const TOAST_CONFIG: InjectionToken<Readonly<MlvToastOpenConfig<unknown>>>;
+interface MlvInternalToast extends MlvInternalBaseToast {
+    title: string;
+    description: string;
+    tone: MlvToastTone;
+    /**
+     * Resolved by `MlvToastService`, but kept optional like `icon` so that
+     * `MlvInternalNotification` — which reuses `MlvToastContainer`, whose generic is
+     * constrained to this interface — stays structurally compatible. Absent is
+     * treated as `'default'`.
+     */
+    shape?: MlvToastShape;
+    /** Dynamic template/component content; strings use the existing title rendering path. */
+    content?: Exclude<MlvToastContent, string>;
+    /** Context supplied to dynamic template content. */
+    contentContext?: MlvToastTemplateContext;
+    /** Per-item injector supplied to dynamic template/component content. */
+    contentInjector?: Injector;
+    icon?: boolean;
+}
+
+/**
+ * Manages a countdown that can be stopped and restarted.
+ * Shared between toast and notification item components.
+ *
+ * This timer does **not** track remaining time: stopping discards the countdown
+ * and the callback, and the item restarts the full `displayTime` when the pointer
+ * or focus leaves. That is deliberate — the reading clock restarts once the user
+ * stops interacting, rather than resuming a partly-elapsed one.
+ */
+declare class MlvToastTimer {
+    /** @private Handle to the active `setTimeout`, or `null` when no timer is running. */
+    private _timeoutId;
+    /** Start (or restart) the timer. Any previous timer is cleared automatically. */
+    start(duration: number, onExpire: () => void): void;
+    /**
+     * Stop the countdown, discarding it. Restart with `start()`.
+     *
+     * Alias of `clear()`, kept because `pause()` reads correctly at the call sites
+     * that stop the countdown on hover or focus.
+     */
+    pause(): void;
+    /** Clear and discard the timer. */
+    clear(): void;
+}
+
+interface MlvIAbstractToastComponent<T extends MlvInternalBaseToast = MlvInternalBaseToast> {
+    toast: Signal<T>;
+}
+/**
+ * Abstract base for toast/notification container components.
+ * Manages the ordered list of active items for a single overlay position.
+ * Extend this class and add the @Component decorator to create a concrete container.
+ */
+declare abstract class MlvAbstractToastContainerComponent<T extends MlvInternalBaseToast> {
+    /** The overlay position this container is responsible for. Set by the service. */
+    readonly position: i0.WritableSignal<MlvToastPosition>;
+    readonly toasts: i0.WritableSignal<T[]>;
+    abstract component: Type<MlvIAbstractToastComponent>;
+    /** @private Service-owned callback used by every item close source. */
+    private _closeHandler;
+    add(item: T): void;
+    remove(id: string): boolean;
+    isEmpty(): boolean;
+    setComponent(component: Type<MlvIAbstractToastComponent>): void;
+    /** Registers the service-owned close callback for timer, action, and dismiss-button requests. */
+    setCloseHandler(handler: (id: string) => void): void;
+    /** @protected Routes an item close request through the owning service. */
+    protected requestClose(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAbstractToastContainerComponent<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvAbstractToastContainerComponent<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+/** Position used when a config omits one. Single source of truth for subclasses. */
+declare const MLV_TOAST_DEFAULT_POSITION: MlvToastPosition;
+/**
+ * Abstract base service for toast/notification services.
+ * Manages CDK overlay refs (one per position) and container lifecycle.
+ * Extend this class and implement `containerType` and `buildItem()`.
+ */
+declare abstract class MlvAbstractToastService<TConfig extends MlvBaseToastConfig, TItem extends MlvInternalBaseToast, TItemComponent extends MlvIAbstractToastComponent, TRef extends MlvToastRef = MlvToastRef> {
+    /** @protected CDK overlay service used to create per-position toast panels. */
+    protected readonly _overlay: Overlay;
+    /**
+     * @protected Supplies the document direction to each toast stack overlay so
+     * its portaled pane mirrors instead of inheriting `<body>`'s default.
+     */
+    protected readonly _rtl: MlvRtlService;
+    /** @protected Environment injector used when attaching container portals. */
+    protected readonly _environmentInjector: EnvironmentInjector;
+    /**
+     * @protected Owns the single persistent ARIA live region used to announce
+     * items. Announcing from here rather than from a `role` on each rendered item
+     * means the region exists in the DOM before any message is inserted (screen
+     * readers miss content added together with its live region), one stacked item
+     * does not add one live region, and an assertive tone cannot silently
+     * override the caller's politeness choice.
+     */
+    protected readonly _liveAnnouncer: LiveAnnouncer;
+    /** @private Cleans up overlays, refs, and deferred disposal timers with the service. */
+    private readonly _destroyRef;
+    /** @private Active overlay refs keyed by position. */
+    private readonly _overlayRefs;
+    /** @private Active container instances keyed by position. */
+    private readonly _containers;
+    /** @private Active item references keyed by generated ID. */
+    private readonly _refs;
+    /** @private Deferred final-item overlay disposal timers keyed by position. */
+    private readonly _disposeTimers;
+    /** @private Monotonic counter used to generate unique toast ids. */
+    private _idCounter;
+    /** The concrete container component class to instantiate per position. */
+    protected abstract readonly containerType: Type<MlvAbstractToastContainerComponent<TItem>>;
+    /** The concrete toast item component class to instantiate per each toast. */
+    protected abstract readonly toastItemType: Type<TItemComponent>;
+    /** Build a fully-populated item from user config and the generated id. */
+    protected abstract buildItem(id: string, config: TConfig, ref: TRef): TItem;
+    /**
+     * The text announced to assistive technology for this item, and the politeness
+     * to announce it with. Return `null` to announce nothing — appropriate when
+     * the item's content is a template or component the service cannot read.
+     *
+     * @param config - The caller's config for this item.
+     */
+    protected abstract resolveAnnouncement(config: TConfig): {
+        message: string;
+        politeness: MlvToastPoliteness;
+    } | null;
+    constructor();
+    show(config: TConfig): TRef;
+    close(id: string, position?: MlvToastPosition): void;
+    /** @protected Creates the concrete reference returned for a new item. */
+    protected _createRef(id: string, position: MlvToastPosition, config: TConfig): TRef;
+    /** @private Returns the container for a position, creating the overlay on first use. */
+    private _ensureContainer;
+    /** @private Disposes the overlay for a position once its container is empty. */
+    private _disposePosition;
+    /** @private Defers final-item disposal so Angular's leave animation can finish. */
+    private _scheduleDisposePosition;
+    /** @private Cancels pending disposal when a new item reuses the same position. */
+    private _cancelDisposePosition;
+    /** @private Completes and releases the reference for a removed item. */
+    private _completeRef;
+    /** @private Builds the global position strategy for a toast position. */
+    private _getPositionStrategy;
+}
+
+declare abstract class MlvAbstractToastItem<T extends MlvInternalBaseToast = MlvInternalBaseToast> implements MlvIAbstractToastComponent<T>, OnInit, OnDestroy {
+    toast: i0.InputSignal<T>;
+    /** @protected Auto-dismiss countdown timer for this toast item. */
+    protected readonly timer: MlvToastTimer;
+    /** @protected Dismiss callback that closes this item by id. */
+    protected readonly _dismiss: (id: string) => void;
+    /**
+     * @protected Host element ref, used to detect whether focus stays within the
+     * item when handling `focusout` (so intra-item focus moves do not resume the
+     * timer prematurely).
+     */
+    protected readonly _elementRef: ElementRef<any>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** @protected Closes this toast item via the injected dismiss callback. */
+    protected onClose(): void;
+    /** @protected Pauses the auto-dismiss timer on pointer enter when `pauseOnHover` is set. */
+    protected onMouseEnter(): void;
+    /** @protected Resumes the auto-dismiss timer on pointer leave. */
+    protected onMouseLeave(): void;
+    /**
+     * @protected Pauses the auto-dismiss timer when keyboard focus enters the
+     * item, so keyboard users are not raced by the countdown (WCAG 2.2.1).
+     */
+    protected onFocusIn(): void;
+    /**
+     * @protected Resumes the auto-dismiss timer when focus leaves the item
+     * entirely. Focus moves between elements inside the same item are ignored.
+     */
+    protected onFocusOut(event: FocusEvent): void;
+    /**
+     * @private Restarts the countdown from the full `displayTime` when pausing is
+     * enabled and the item is auto-dismissable.
+     */
+    private _resumeTimer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvAbstractToastItem<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvAbstractToastItem<any>, never, never, { "toast": { "alias": "toast"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class MlvToastItem extends MlvAbstractToastItem<MlvInternalToast> implements OnInit, OnDestroy {
+    /** @protected The component's i18n strings signal. */
+    protected readonly _i18n: i0.Signal<_malva_ui_i18n.MlvToastI18n>;
+    /** @protected Template branch of dynamic content, when supplied. */
+    protected readonly _templateContent: i0.Signal<TemplateRef<_malva_ui_core_toast.MlvToastTemplateContext<unknown>> | null>;
+    /** @protected Component branch of dynamic content, when supplied. */
+    protected readonly _componentContent: i0.Signal<i0.Type<unknown> | null>;
+    /**
+     * @protected Whether to render the built-in, tone-derived Lucide icon.
+     *
+     * Only the four semantic tones map to an icon — `'default'` has none, so
+     * `icon: true` with that tone renders nothing. Dynamic content is excluded
+     * because template/component content owns its own leading icon through
+     * `[mlvToastIcon]`; the service already suppresses the flag for those
+     * branches, and this guard also covers direct use of `<mlv-toast-item>`.
+     */
+    protected readonly _showIcon: i0.Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvToastItem, "mlv-toast-item", never, {}, {}, never, never, true, never>;
+}
+
+declare class MlvToastContainer<T extends MlvInternalToast = MlvInternalToast> extends MlvAbstractToastContainerComponent<T> {
+    /**
+     * @protected Clearance applied above a top-anchored stack. `null` for bottom
+     * positions, where the anchored edge is the opposite one.
+     */
+    protected readonly _insetBlockStart: i0.Signal<"var(--mlv-toast-inset-block-start, 0px)" | null>;
+    /**
+     * @protected Clearance applied below a bottom-anchored stack, keeping it
+     * clear of a sticky page dock. `null` for top positions.
+     */
+    protected readonly _insetBlockEnd: i0.Signal<"var(--mlv-toast-inset-block-end, var(--mlv-page-dock-height, 0px))" | null>;
+    /** @private Parent injector used as the root for each toast item's injector. */
+    private readonly _injector;
+    /** @protected Per-item injector providing the `MLV_TOAST_CLOSE` callback to each rendered toast. */
+    protected readonly itemInjector: i0.DestroyableInjector;
+    component: typeof MlvToastItem;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastContainer<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvToastContainer<any>, "mlv-toast-container", never, {}, {}, never, never, true, never>;
+}
+
+declare class MlvToastService extends MlvAbstractToastService<MlvToastConfig, MlvInternalToast, MlvIAbstractToastComponent<MlvInternalToast>, MlvToastRef> {
+    /** @protected Per-position CDK overlay container component. */
+    protected readonly containerType: typeof MlvToastContainer;
+    protected readonly toastItemType: typeof MlvToastItem;
+    /**
+     * @protected Announces the title and description. Returns `null` for template
+     * and component content, whose rendered text the service cannot read — that
+     * content is responsible for announcing anything it needs to.
+     */
+    protected resolveAnnouncement(config: MlvToastConfig): {
+        message: string;
+        politeness: MlvToastPoliteness;
+    } | null;
+    /** @protected Builds a fully-resolved internal toast from user config, applying defaults. */
+    protected buildItem(id: string, config: MlvToastConfig, ref: MlvToastRef): MlvInternalToast;
+    /**
+     * Opens escaped string, template, or component content as a toast.
+     *
+     * Template content receives `MlvToastTemplateContext`; component content can
+     * inject `MlvToastRef`, `TOAST_DATA`, and `TOAST_CONFIG`.
+     */
+    open<D = unknown>(content: MlvToastContent<D>, config?: MlvToastOpenConfig<D>): MlvToastRef<D>;
+    private _isContentObject;
+    /** @protected Creates a data-aware reference for each toast. */
+    protected _createRef(id: string, position: MlvToastPosition, config: MlvToastConfig): MlvToastRef;
+    success(title: string, config?: Omit<MlvToastConfig, 'title' | 'tone'>): MlvToastRef;
+    error(title: string, config?: Omit<MlvToastConfig, 'title' | 'tone'>): MlvToastRef;
+    warning(title: string, config?: Omit<MlvToastConfig, 'title' | 'tone'>): MlvToastRef;
+    info(title: string, config?: Omit<MlvToastConfig, 'title' | 'tone'>): MlvToastRef;
+    /** Show a toast with the given tone (shorthand). */
+    tone(v: MlvToastTone, title: string, config?: Omit<MlvToastConfig, 'title' | 'tone'>): MlvToastRef;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MlvToastService>;
+}
+
+declare class MlvToastTitle {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvToastTitle, "[mlvToastTitle]", never, {}, {}, never, never, true, never>;
+}
+declare class MlvToastDescription {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastDescription, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvToastDescription, "[mlvToastDescription]", never, {}, {}, never, never, true, never>;
+}
+declare class MlvToastIcon {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvToastIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvToastIcon, "[mlvToastIcon]", never, {}, {}, never, never, true, never>;
+}
+
+export { MLV_TOAST_CLOSE, MLV_TOAST_DEFAULT_POSITION, MlvAbstractToastContainerComponent, MlvAbstractToastItem, MlvAbstractToastService, MlvToastContainer, MlvToastDescription, MlvToastIcon, MlvToastItem, MlvToastRef, MlvToastService, MlvToastTimer, MlvToastTitle, TOAST_CONFIG, TOAST_DATA, joinAnnouncementParts, resolveToastPoliteness };
+export type { MlvBaseToastConfig, MlvBaseToastRef, MlvIAbstractToastComponent, MlvInternalBaseToast, MlvInternalToast, MlvToastConfig, MlvToastContent, MlvToastOpenConfig, MlvToastPoliteness, MlvToastPosition, MlvToastShape, MlvToastTemplateContext, MlvToastTone };

package/types/malva-ui-core-tokenizer.d.ts

@@ -0,0 +1,217 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _malva_ui_i18n from '@malva-ui/i18n';
+import { MlvSignalFormControlBase, MlvFormControl } from '@malva-ui/core/form-utils';
+import { MlvSelectOption } from '@malva-ui/core/dropdown';
+
+/**
+ * The template context provided to `[mlvTokenTemplate]` templates.
+ * Use `let-option` to bind `$implicit` (the token's MlvSelectOption).
+ */
+interface MlvTokenTemplateContext<T = unknown> {
+    /** The token's MlvSelectOption value — also bound to `let-option`. */
+    $implicit: MlvSelectOption<T>;
+    /** Zero-based index of this token in the visible tokens list. */
+    index: number;
+    /** Whether the remove button is active (false when the tokenizer is disabled). */
+    removable: boolean;
+    /** Call this to programmatically remove the token. */
+    remove: () => void;
+}
+declare class MlvTokenTemplate<T = unknown> {
+    /** The template reference for the custom token rendering slot. */
+    readonly templateRef: TemplateRef<any>;
+    /**
+     * Type guard for correct template variable inference.
+     * Allows `let-option`, `let-index`, `let-removable`, and `let-remove` to be
+     * strongly-typed in the consuming template.
+     */
+    static ngTemplateContextGuard<T>(_dir: MlvTokenTemplate<T>, _ctx: unknown): _ctx is MlvTokenTemplateContext<T>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvTokenTemplate<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvTokenTemplate<any>, "[mlvTokenTemplate]", never, {}, {}, never, never, true, never>;
+}
+
+declare class MlvTokenizer<T = string> extends MlvSignalFormControlBase<MlvSelectOption<T>[]> implements MlvFormControl {
+    /** @protected The component's i18n strings signal. */
+    protected readonly _i18n: _angular_core.Signal<_malva_ui_i18n.MlvTokenizerI18n>;
+    /** The token collection used by all Angular forms APIs. */
+    readonly value: _angular_core.ModelSignal<MlvSelectOption<T>[]>;
+    /** Backwards-compatible two-way token binding kept in sync with `value`. */
+    readonly tokens: _angular_core.ModelSignal<MlvSelectOption<T>[]>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly showOverflow: _angular_core.InputSignal<boolean>;
+    readonly maxVisible: _angular_core.InputSignal<number | null>;
+    readonly allowDuplicates: _angular_core.InputSignal<boolean>;
+    /** Transforms a raw string from the input field into a MlvSelectOption. */
+    readonly createToken: _angular_core.InputSignal<(value: string) => MlvSelectOption<T>>;
+    /**
+     * Optional function to split user input into multiple values.
+     * e.g. `(v) => v.split(',')` to support comma-separated entry.
+     */
+    readonly splitFn: _angular_core.InputSignal<((value: string) => string[]) | null>;
+    /** @protected Custom token template projected via `[mlvTokenTemplate]`. */
+    protected readonly tokenTemplate: _angular_core.Signal<MlvTokenTemplate<any> | undefined>;
+    /** @private The rendered token components, driven by `FocusKeyManager`. */
+    private readonly _tokens;
+    /** @private Reference to the inner mlv-input used for token entry. */
+    private readonly _inputEl;
+    /** @private Accessor for the underlying native input element via mlv-input bare mode. */
+    private get _nativeInput();
+    /** @private FocusKeyManager driving roving-tabindex navigation across tokens. */
+    private _keyManager?;
+    /** @private Supplies the current inline direction to the horizontal key manager. */
+    private readonly _rtlService;
+    /** @private Subscription to the key manager's active-item changes. */
+    private _changeSub?;
+    /**
+     * @protected Whether the last token is "armed" — a visual-only selection
+     * (chip `primary` tone) driven by Backspace in the empty text input while DOM
+     * focus stays in the input. The first Backspace arms; the next Backspace (or
+     * Delete) removes the armed token and arms the new last one.
+     */
+    protected readonly _armed: _angular_core.WritableSignal<boolean>;
+    /**
+     * @protected Polite screen-reader announcement for the armed token. Rendered
+     * into a visually-hidden `aria-live="polite"` region so assistive tech learns
+     * which token is selected even though DOM focus never leaves the input.
+     */
+    protected readonly _srMessage: _angular_core.WritableSignal<string>;
+    /**
+     * @private The last committed tokens reference produced by an internal
+     * arm-driven deletion. Lets the external-change effect distinguish our own
+     * mutations (which must preserve/re-arm) from external ones (which disarm).
+     */
+    private _internalTokensRef;
+    /**
+     * @private The collection reference last propagated across `value` / `tokens`.
+     * `undefined` until the first sync, which is how the very first flush tells a
+     * seeded binding apart from an unbound alias sitting on its `[]` default.
+     */
+    private _syncedRef;
+    /** @protected The last token in the collection, or `null` when empty. */
+    protected readonly _lastToken: _angular_core.Signal<MlvSelectOption<T> | null>;
+    constructor();
+    /**
+     * @private Reconciles the `value` / `tokens` model pair from one effect run.
+     *
+     * Whichever surface no longer matches `_syncedRef` is the one that changed and
+     * therefore wins; the other is brought to it. On the first run nothing has been
+     * propagated yet, so a surface still holding the empty default counts as
+     * unchanged and cannot clobber a seeded sibling. `value` is canonical when both
+     * sides changed in the same flush.
+     */
+    private _syncModels;
+    /** @private Sets tabindex 0 on the active token and -1 on the rest. */
+    private _syncTokenTabIndices;
+    readonly visibleTokens: _angular_core.Signal<MlvSelectOption<T>[]>;
+    readonly overflowCount: _angular_core.Signal<number>;
+    focusInput(): void;
+    /**
+     * @protected Whether the given token is the currently armed one. Armed always
+     * targets the last token, matching the from-the-end deletion order.
+     */
+    protected _isTokenArmed(token: MlvSelectOption<T>): boolean;
+    onInputEnter(event: Event): void;
+    /**
+     * Handles Backspace in the text input. When the caret is inside typed text
+     * this is a native edit and is left alone. When the input is empty:
+     *  - the first press *arms* the last token (visual `primary` selection, no
+     *    deletion);
+     *  - each subsequent press removes the armed (last) token and arms the new
+     *    last one, walking deletion from the end one token per press.
+     * Removing the final token leaves the input focused and disarmed.
+     */
+    onInputBackspace(event: Event): void;
+    /**
+     * Handles Delete in the text input. Delete only acts on an already-armed
+     * token (parity with the second Backspace): it removes the armed token and
+     * arms the new last one. With nothing armed it is a no-op.
+     */
+    onInputDelete(event: Event): void;
+    onInputFocus(): void;
+    onInputBlur(): void;
+    /**
+     * @protected Clears the armed selection and its live-region announcement.
+     * Invoked on typing, caret movement, blur, pointer interaction, Enter, and
+     * external token changes.
+     */
+    protected _disarm(): void;
+    /**
+     * @private Removes the armed (last) token and re-arms the new last token,
+     * or disarms when the collection becomes empty. Records the resulting array
+     * reference so the external-change effect treats this as an internal mutation.
+     */
+    private _deleteArmedAndRearm;
+    /** @private Announces the armed token's label into the polite live region. */
+    private _announceArmed;
+    removeToken(token: MlvSelectOption<T>): void;
+    onTokenKeydown(event: KeyboardEvent): void;
+    /** Whether the control holds a clearable value — At least one token present. */
+    readonly hasValue: _angular_core.Signal<boolean>;
+    /** @private Commits one token collection to both public model surfaces. */
+    private _setTokens;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvTokenizer<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvTokenizer<any>, "mlv-tokenizer", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "tokens": { "alias": "tokens"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "showOverflow": { "alias": "showOverflow"; "required": false; "isSignal": true; }; "maxVisible": { "alias": "maxVisible"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "createToken": { "alias": "createToken"; "required": false; "isSignal": true; }; "splitFn": { "alias": "splitFn"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "tokens": "tokensChange"; }, ["tokenTemplate"], never, true, never>;
+}
+
+/**
+ * A single removable token rendered inside `mlv-tokenizer`. The token host is
+ * the keyboard focus target (a roving-tabindex `role="listitem"`); the inner
+ * `mlv-chip` provides the visual chrome and mouse close affordance but is kept
+ * out of the tab order via `chipTabIndex="-1"`.
+ */
+declare class MlvToken<T = unknown> {
+    /**
+     * @private Host element reference — the token host is the keyboard focus
+     * target that the parent tokenizer's `FocusKeyManager` drives.
+     */
+    private readonly _elementRef;
+    /** The option model this token represents. */
+    readonly value: _angular_core.InputSignal<MlvSelectOption<T> | undefined>;
+    /** Whether the token shows a remove (close) affordance. */
+    readonly removable: _angular_core.InputSignal<boolean>;
+    /** Whether the token is disabled — not removable and out of the tab order. */
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether the token is "armed" — a purely visual selection driven by the
+     * parent tokenizer's empty-input Backspace flow. An armed token renders with
+     * the chip's `primary` tone while DOM focus stays in the text input. It does
+     * not change the token's tabindex, role, or removal semantics.
+     */
+    readonly armed: _angular_core.InputSignal<boolean>;
+    /** Emits this token's option when the user removes it (click or Backspace/Delete). */
+    readonly removed: _angular_core.OutputEmitterRef<MlvSelectOption<T>>;
+    /**
+     * Roving tabindex applied to the token host (the single focus target). `0`
+     * for the active token, `-1` for the rest. Managed by `MlvTokenizer`.
+     */
+    readonly tabIndex: _angular_core.WritableSignal<number>;
+    /** @internal Accessible name for the token: its option label. */
+    readonly _ariaLabel: _angular_core.Signal<string | null>;
+    /**
+     * @private The chip component's i18n strings, reused to localize the base
+     * "Remove" verb of this token's close-button label.
+     */
+    private readonly _chipI18n;
+    /**
+     * @internal Descriptive accessible name for the inner chip's close button,
+     * composed as `"<Remove>: <label>"` (e.g. `"Remove: Angular"`) so the label
+     * names the specific token being removed rather than a generic "Remove".
+     * Falls back to the bare "Remove" verb when the token has no label.
+     */
+    readonly _closeAriaLabel: _angular_core.Signal<string>;
+    /**
+     * Moves focus to the token host. Adapts the token to CDK `FocusKeyManager`
+     * so the tokenizer can navigate tokens with the Arrow keys.
+     */
+    focus(): void;
+    /** @internal Removes the token on Backspace/Delete when it is removable. */
+    _onKeyRemove(event: Event): void;
+    /** @internal Emits `removed` with this token's option. */
+    onRemove(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvToken<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvToken<any>, "mlv-token", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "armed": { "alias": "armed"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
+}
+
+export { MlvToken, MlvTokenTemplate, MlvTokenizer };
+export type { MlvTokenTemplateContext };