mn-angular-lib 1.0.140 → 1.0.142

package/types/mn-angular-lib.d.ts

@@ -11,6 +11,7 @@ import { ValidationErrors, NgControl, AbstractControl, ValidatorFn, AsyncValidat
 import { LucideIconData } from '@lucide/angular';
 export { LucideIconData } from '@lucide/angular';
 import { SafeHtml } from '@angular/platform-browser';
+import * as tailwind_merge from 'tailwind-merge';
 import { HttpStatusCode, HttpHeaders, HttpErrorResponse, HttpClient, HttpResponse, HttpParams } from '@angular/common/http';
 
 declare const mnAlertVariants: tailwind_variants.TVReturnType<{
@@ -2651,10 +2652,11 @@ declare class MnMultiSelect implements OnInit {
     private readonly cdr;
     /** Reference to the trigger element for positioning the dropdown */
     triggerRef: ElementRef<HTMLElement>;
-    /** The panel element currently moved into `document.body`, if any. */
+    /** Layout classes for the anchored popover panel. The mobile sheet is rendered by
+     *  mn-bottom-sheet instead, so it no longer needs a branch here. */
+    readonly panelClasses = "fixed z-9999 bg-base-100 border border-base-300 rounded-md shadow-lg max-h-60 overflow-auto";
+    /** The anchored popover panel currently moved into `document.body`, if any. */
     private movedPanel;
-    /** The sheet backdrop element currently moved into `document.body`, if any. */
-    private movedBackdrop;
     /** Option count at which the search input auto-enables when `searchable` is unset. */
     private static readonly DEFAULT_SEARCH_THRESHOLD;
     /** Tailwind's `sm` breakpoint — below this the panel renders as a bottom sheet.
@@ -2687,6 +2689,8 @@ declare class MnMultiSelect implements OnInit {
      * card) used to leave the portalled panel floating at its stale coordinates.
      */
     private scrollCapture;
+    /** The bottom-sheet host currently moved into `document.body`, if any. */
+    private movedSheet;
     /**
      * The dropdown panel element, queried while it is rendered by the `@if` block.
      * The setter relocates the panel to `document.body` so that its `position: fixed`
@@ -2696,12 +2700,6 @@ declare class MnMultiSelect implements OnInit {
      * broken on iOS). Cleanup is handled when the query clears on close/destroy.
      */
     set dropdownRef(ref: ElementRef<HTMLElement> | undefined);
-    /**
-     * The dimming backdrop rendered behind the mobile sheet. Portalled alongside the
-     * panel for the same reason — a `position: fixed` backdrop left inside a transformed
-     * ancestor would cover that ancestor rather than the viewport.
-     */
-    set sheetBackdropRef(ref: ElementRef<HTMLElement> | undefined);
     /** Currently selected values */
     selectedValues: unknown[];
     isOpen: boolean;
@@ -2717,7 +2715,13 @@ declare class MnMultiSelect implements OnInit {
     private onTouched;
     private readonly builtInErrorMessages;
     constructor();
-    ngOnInit(): void;
+    /**
+     * The bottom-sheet host, read as an `ElementRef` so it can be relocated to
+     * `document.body` — its `position: fixed` children (backdrop + container) must anchor
+     * to the viewport, not to any transformed/filtered ancestor of this component. On open
+     * its container height is captured as the sheet's `min-height` floor.
+     */
+    set sheetRef(ref: ElementRef<HTMLElement> | undefined);
     /**
      * Tracks the sheet breakpoint through `matchMedia` rather than reading `innerWidth`
      * once, so rotating the device switches layout instead of leaving a panel positioned
@@ -2727,7 +2731,7 @@ declare class MnMultiSelect implements OnInit {
     private startWatchingViewport;
     /** Tears down the breakpoint listener. Idempotent. */
     private stopWatchingViewport;
-    onDocumentClick(event: Event): void;
+    ngOnInit(): void;
     private resolveConfig;
     writeValue(val: unknown): void;
     registerOnChange(fn: (val: unknown) => void): void;
@@ -2741,14 +2745,16 @@ declare class MnMultiSelect implements OnInit {
      * otherwise auto-enabled once the option count reaches the threshold.
      */
     get isSearchable(): boolean;
-    /** Layout classes for the panel — a bottom-anchored sheet, or the trigger-anchored popover. */
-    get panelClasses(): string;
+    onDocumentClick(event: Event): void;
     /**
      * Records the sheet's opened height as its `min-height` floor. Measured on the next
      * frame so the read reflects the fully-rendered, unfiltered list (the search box is
      * empty on open) and never forces a reflow mid change-detection. The floor equals the
      * content height at that instant, so applying it triggers no resize — it only stops a
      * later, shorter filtered list from pulling the sheet down.
+     *
+     * `hostEl` is the portalled mn-bottom-sheet host (`display: contents`), so the height
+     * is read from its `.mn-sheet-container` child rather than the host itself.
      */
     private captureSheetFloor;
     /** Closes the dropdown on Escape for keyboard accessibility. */
@@ -2841,6 +2847,135 @@ declare class MnMultiSelect implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<MnMultiSelect, "mn-lib-multi-select", never, { "props": { "alias": "props"; "required": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * A viewport-anchored bottom sheet — the mobile presentation shared by the modal
+ * shell and the multi-select dropdown.
+ *
+ * It owns only the sheet *chrome and gestures*: a bottom-anchored, full-width,
+ * rounded-top surface with an optional dimming backdrop and drag grabber, a
+ * slide-up entrance, swipe/flick-to-dismiss, and a promise-based slide-down exit.
+ * It is deliberately presentational: the body is projected via `<ng-content>`, and
+ * dismissal is reported through {@link dismiss} for the host to act on (run a close
+ * guard, tear down its overlay, …) rather than being handled here.
+ *
+ * Positioning is `position: fixed` against the viewport, so a consumer whose sheet
+ * lives inside a `transform`/`filter` ancestor (which would otherwise become the
+ * containing block) must relocate this host to `document.body` — as the
+ * multi-select does with its portal helper.
+ */
+declare class MnBottomSheet {
+    /** Tailwind's `sm` breakpoint — at or below this the swipe gesture is armed.
+     *  Kept in step with the same constant in the modal shell and multi-select. */
+    private static readonly SHEET_MAX_WIDTH;
+    /** Drag distance (px) past which a release dismisses regardless of speed. */
+    private static readonly SWIPE_DISMISS_THRESHOLD;
+    /** Downward release speed (px/ms) above which a short drag still dismisses — a "flick". */
+    private static readonly FLICK_VELOCITY;
+    /** Minimum drag distance (px) a flick must cover, so an incidental fast tap never dismisses. */
+    private static readonly FLICK_MIN_DISTANCE;
+    /** Upper bound for the exit wait if no `transitionend` fires (e.g. animation suppressed). */
+    private static readonly CLOSE_FALLBACK_MS;
+    /** Whether to render the dimming backdrop behind the sheet (default: true).
+     *  A host that already paints its own backdrop (the modal shell) sets this false. */
+    showBackdrop: boolean;
+    /** Whether to render the drag grabber handle that arms swipe-to-dismiss (default: true). */
+    showGrabber: boolean;
+    /** Whether the sheet can be dismissed by the user via swipe/flick or backdrop tap
+     *  (default: true). When false the gestures are inert and the backdrop is non-closing. */
+    dismissible: boolean;
+    /** Optional `min-height` floor (px) for the container, so filtering its content
+     *  shorter cannot shrink the sheet mid-interaction. Null leaves it content-sized. */
+    minHeightPx: number | null;
+    /** Cap on the sheet height as a fraction of the viewport, in vh (default: 80). */
+    maxHeightVh: number;
+    /** Extra class(es) applied to the sheet container, so a host can attach the hooks
+     *  its own CSS depends on (e.g. the modal shell's `modal-container`). */
+    containerClass: string;
+    /** Accessible name for the sheet dialog. */
+    ariaLabel?: string;
+    /** Id of the element that labels this dialog (takes precedence over `ariaLabel`). */
+    ariaLabelledby?: string;
+    /**
+     * When true, the sheet grows to its `maxHeightVh` while the host app marks the soft
+     * keyboard open (a `.mn-keyboard-open` class on a document ancestor), guaranteeing
+     * scroll room to lift a focused field above an overlaying keyboard. Off by default so
+     * a keyboard opened over an unrelated sheet (a multi-select search) does not resize it.
+     */
+    growWithKeyboard: boolean;
+    /**
+     * Optional async gate consulted before a user-initiated dismissal (swipe/flick/backdrop
+     * tap) is committed. Resolving false aborts the dismissal and springs the sheet back —
+     * used by the modal to run its close guard (e.g. an unsaved-changes prompt). A
+     * programmatic {@link startClosing} bypasses it.
+     */
+    dismissGuard?: () => boolean | Promise<boolean>;
+    /**
+     * Emitted once the user has dismissed the sheet — after the slide-down exit has
+     * finished, so the host can remove the sheet from the DOM without cutting the
+     * animation short. The host decides what dismissal means (close, run a guard, …).
+     */
+    dismiss: EventEmitter<void>;
+    /** Current downward drag offset (px) applied to the sheet while swiping. */
+    sheetDragY: number;
+    /** True while the user is actively dragging the grabber (disables the snap transition). */
+    isDraggingSheet: boolean;
+    /** True once a dismissal has committed — the sheet glides off-screen via its transition. */
+    isDismissing: boolean;
+    private readonly cdr;
+    private readonly el;
+    /** The sheet container element, used to measure its height and drive the exit. */
+    private readonly containerRef;
+    private dragStartY;
+    /** The two most recent (y, timestamp) pointer samples, for estimating flick velocity.
+     *  `t` uses the event timestamp (monotonic), so no wall-clock is read. */
+    private lastSample;
+    private prevSample;
+    /** In-flight exit animation, so a swipe-dismiss and a follow-up programmatic
+     *  {@link startClosing} share one glide instead of re-triggering it. */
+    private exitPromise;
+    get hostClasses(): string;
+    /** Whether the viewport is currently narrow enough for the sheet to accept a swipe. */
+    private get isNarrow();
+    onSheetPointerDown(event: PointerEvent): void;
+    onSheetPointerMove(event: PointerEvent): void;
+    onSheetPointerUp(): void;
+    onBackdropClick(): void;
+    /**
+     * Plays the slide-down exit and resolves once it has finished. Exposed so a host that
+     * dismisses the sheet programmatically (not via a gesture) can await the same exit
+     * before tearing the sheet down. Idempotent: a swipe-dismiss already in flight and a
+     * subsequent programmatic close share the one glide rather than restarting it.
+     */
+    startClosing(): Promise<void>;
+    /**
+     * Runs the optional {@link dismissGuard}, then either commits the dismissal (glide out
+     * + emit) or springs the sheet back if the guard rejects. A non-dismissible sheet never
+     * gets here from a gesture, but the guard is still short-circuited defensively.
+     */
+    private attemptDismiss;
+    /** Whether the release should dismiss: a long-enough drag OR a fast downward flick. */
+    private shouldDismiss;
+    /** Downward release speed (px/ms) from the last two pointer samples; 0 when unusable. */
+    private releaseVelocity;
+    /** Springs the sheet back to its resting position after a drag that didn't dismiss. */
+    private snapBack;
+    /**
+     * Commits a dismissal: glides the sheet the rest of the way off-screen, then emits
+     * {@link dismiss} once the exit animation settles. Continuing the gesture (rather than
+     * snapping back to 0 first) keeps a swipe feeling like one unbroken motion.
+     */
+    private commitDismiss;
+    /** Commits the exit animation exactly once and returns the shared in-flight promise.
+     *  Short-circuits under reduced motion and falls back to a timeout if no event fires. */
+    private playExit;
+    /** Waits for the container's exit transition to end, with a reduced-motion short-circuit
+     *  and a fallback timeout so it always resolves. */
+    private awaitExit;
+    private prefersReducedMotion;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MnBottomSheet, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnBottomSheet, "mn-bottom-sheet", never, { "showBackdrop": { "alias": "showBackdrop"; "required": false; }; "showGrabber": { "alias": "showGrabber"; "required": false; }; "dismissible": { "alias": "dismissible"; "required": false; }; "minHeightPx": { "alias": "minHeightPx"; "required": false; }; "maxHeightVh": { "alias": "maxHeightVh"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaLabelledby": { "alias": "ariaLabelledby"; "required": false; }; "growWithKeyboard": { "alias": "growWithKeyboard"; "required": false; }; "dismissGuard": { "alias": "dismissGuard"; "required": false; }; }, { "dismiss": "dismiss"; }, never, ["*"], true, never>;
+}
+
 declare const mnSelectVariants: tailwind_variants.TVReturnType<{
     shadow: {
         true: string;
@@ -5494,9 +5629,6 @@ declare class MnModalShellComponent<TResult = unknown> implements OnInit, AfterV
     get closeModalLabel(): string;
     private el;
     private cdr;
-    /** Downward release speed (px/ms) above which a short drag still dismisses — a "flick".
-     *  Native sheets dismiss on a quick flick regardless of distance, not just a long drag. */
-    private static readonly FLICK_VELOCITY;
     config: ModalConfig<TResult>;
     modalRef: MnModalRef<TResult>;
     isClosing: boolean;
@@ -5511,6 +5643,8 @@ declare class MnModalShellComponent<TResult = unknown> implements OnInit, AfterV
     readonly ModalKind: typeof ModalKind;
     /** The rendered wizard body, when this modal is a wizard — used to read the active step title. */
     private readonly wizardBody;
+    /** Tailwind's `sm` breakpoint — below this the modal presents as a bottom sheet. */
+    private static readonly SHEET_MAX_WIDTH;
     /**
      * Title of the wizard's current step, or undefined for non-wizard modals.
      * The template appends it to the modal title on small screens, where the
@@ -5521,69 +5655,66 @@ declare class MnModalShellComponent<TResult = unknown> implements OnInit, AfterV
     private focusTrapListener;
     private pollingTimer;
     private pollAttempts;
-    ngOnInit(): void;
-    /** Minimum drag distance (px) that must accompany a flick, so an incidental fast tap
-     *  on the grabber never dismisses. Below the distance threshold, only a flick dismisses. */
-    private static readonly FLICK_MIN_DISTANCE;
-    ngOnDestroy(): void;
+    /** Upper bound for the close wait if no animation/transition end event fires
+     *  (e.g. an animation was suppressed). Must stay longer than the slowest close
+     *  path so it never preempts. */
+    private static readonly CLOSE_FALLBACK_MS;
+    /** Live match of the sheet breakpoint, so the modal switches between the centered dialog
+     *  and the bottom sheet when the viewport crosses it (e.g. an orientation change). */
+    readonly isNarrow: i0.WritableSignal<boolean>;
+    /** The bottom sheet presenting this modal on mobile, absent on the desktop dialog path. */
+    private readonly bottomSheet;
+    /** Optional native haptic engine. Absent on the web — every call is null-guarded. */
+    private haptics;
+    private sheetMedia;
+    private sheetMediaListener;
+    /** Whether this modal is allowed to present as a bottom sheet on small screens (default: true). */
+    get isMobileSheet(): boolean;
+    /** Whether the modal should currently render as a bottom sheet (mobile) rather than the
+     *  centered dialog (desktop). */
+    get showMobileSheet(): boolean;
+    get hostClasses(): string;
     private setupFocusTrap;
     private removeFocusTrap;
     asWizard(config: ModalConfig<TResult>): WizardModalConfig;
     asForm(config: ModalConfig<TResult>): FormModalConfig;
     asConfirmation(config: ModalConfig<TResult>): ConfirmationModalConfig;
     asCustom(config: ModalConfig<TResult>): CustomModalConfig;
-    private static readonly SWIPE_DISMISS_THRESHOLD;
-    /** Optional native haptic engine. Absent on the web — every call is null-guarded. */
-    private haptics;
-    /** The two most recent (y, timestamp) pointer samples, used to estimate the release
-     *  velocity for flick-to-dismiss. `t` uses the event timestamp (monotonic, no Date). */
-    private lastSample;
-    /** Upper bound for the close wait if no animation/transition end event fires
-     *  (e.g. an animation was suppressed). Must stay longer than the slowest close
-     *  path (mobile sheet slide-down 0.45s, swipe glide 0.3s) so it never preempts. */
-    private static readonly CLOSE_FALLBACK_MS;
-    /** Whether this modal renders as a bottom sheet on small screens (default: true). */
-    get isMobileSheet(): boolean;
+    /** Whether the modal can be dismissed at all (drives the sheet's swipe/backdrop arming). */
+    get canClose(): boolean;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
     /**
      * Triggers the closing animation and resolves once it has actually finished.
      *
-     * Deferred via setTimeout to avoid NG0100 when called during a CD cycle.
-     * Rather than guess a fixed duration (the old hardcoded 150ms truncated the
-     * mobile slide-down, which runs 250ms — and the swipe glide, 300ms), we wait
-     * for the container's `animationend`/`transitionend` and tear down then. A
-     * fallback timeout guarantees resolution if no such event fires, and we
-     * short-circuit entirely under reduced motion (the CSS collapses to instant).
+     * Deferred via setTimeout to avoid NG0100 when called during a CD cycle. On mobile the
+     * exit is owned by the bottom sheet, so we delegate to its `startClosing()` (idempotent
+     * with a swipe-dismiss already in flight); on desktop we wait for the dialog container's
+     * `animationend`/`transitionend`. A fallback timeout guarantees resolution if no event
+     * fires, and we short-circuit under reduced motion (the CSS collapses to instant).
      */
     startClosing(): Promise<void>;
     private prefersReducedMotion;
     onEscapeKey(event: Event): void;
     onBackdropClick(): void;
     onCloseButtonClick(): void;
-    /** True once a swipe has crossed the dismiss threshold — slides the sheet off-screen
-     *  via the transform transition instead of replaying the slide-up keyframe. */
-    swipeDismissing: boolean;
-    /** Current downward drag offset (px) applied to the sheet while swiping. */
-    sheetDragY: number;
-    /** True while the user is actively dragging the grabber (disables snap transition). */
-    isDraggingSheet: boolean;
-    private prevSample;
-    get hostClasses(): string;
-    private dragStartY;
-    /** Whether the sheet can be dismissed at all (drives whether the swipe is armed). */
-    private get canClose();
-    /** Tailwind's `sm` breakpoint — below this the modal renders as a bottom sheet. */
-    private static readonly SHEET_MAX_WIDTH;
+    /**
+     * Guard consulted by the bottom sheet before it commits a swipe/flick/backdrop dismissal.
+     * Mirrors the DISABLED/GUARDED rules of {@link handleClose} so a swipe cannot escape a
+     * modal that a button close could not. Bound as a field so the template passes it directly.
+     */
+    readonly sheetDismissGuard: () => Promise<boolean>;
+    /**
+     * Handles the sheet's `(dismiss)` — emitted only after its guard passed and its exit
+     * animation finished. Dismisses the modal (no re-guard) with a confirming haptic.
+     */
+    onSheetDismiss(): void;
     ngAfterViewInit(): void;
-    onSheetPointerDown(event: PointerEvent): void;
-    onSheetPointerMove(event: PointerEvent): void;
-    onSheetPointerUp(): Promise<void>;
-    /** Whether the release should dismiss: a long-enough drag OR a fast downward flick. */
-    private shouldDismissSheet;
-    /** Downward release speed (px/ms) from the last two pointer samples. Positive means
-     *  moving down. Returns 0 when there is no usable sample window. */
-    private releaseVelocity;
-    /** Springs the sheet back to its resting position after a drag that didn't dismiss. */
-    private snapBack;
+    /** Tracks the sheet breakpoint through `matchMedia` so the dialog/sheet fork re-renders
+     *  when the viewport crosses it. */
+    private startWatchingViewport;
+    /** Tears down the breakpoint listener. Idempotent. */
+    private stopWatchingViewport;
     /** Attempts to dismiss the modal. Resolves true if it was actually dismissed,
      *  false if blocked by a DISABLED close mode or a rejected close guard. */
     private handleClose;
@@ -7279,6 +7410,184 @@ declare class MnIconAttributes {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MnIconAttributes, "mn-icon[mnIconPistol]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * A single crumb in the breadcrumb trail.
+ *
+ * A crumb becomes a link when it carries an {@link href}; otherwise it renders
+ * as a button that only emits {@link MnBreadcrumbs.crumbClick} / runs
+ * {@link onClick}. The library stays router-agnostic — an app wires SPA
+ * navigation through `onClick`/`crumbClick`, or lets the `href` anchor navigate.
+ */
+type MnBreadcrumbItem = {
+    /** Translation key or literal label for the crumb. */
+    label: string;
+    /** Optional link target; when set the crumb renders as an `<a href>`. */
+    href?: string;
+    /** Optional callback invoked on click (fires alongside `crumbClick`). */
+    onClick?: () => void;
+};
+/**
+ * Data source for {@link MnBreadcrumbs}.
+ *
+ * When {@link items} holds crumbs the component renders a linkable trail whose
+ * **last** item is the current page (never a link). When `items` is empty the
+ * component degrades to a single "Back" control: it navigates to
+ * {@link backHref} when given, otherwise steps back through browser history.
+ */
+type MnBreadcrumbsData = {
+    /** Ordered crumbs root → current. Empty ⇒ the "Back" fallback renders instead. */
+    items: MnBreadcrumbItem[];
+    /** Fallback "Back" target. Set ⇒ renders `<a href>`; unset ⇒ `history.back()`. */
+    backHref?: string;
+    /** Translation key or literal for the "Back" label. Defaults to `'back'`. */
+    backLabel?: string;
+    /** Visual scale. Defaults to `'md'`. */
+    size?: 'sm' | 'md';
+};
+
+/**
+ * A flexible breadcrumb trail.
+ *
+ * Given crumbs it renders a linkable trail (`root › … › current`) where the last
+ * crumb is the current page and is never a link. Given no crumbs it degrades to
+ * a single "Back" control — the two are mutually exclusive. "Flexible" here is
+ * input-driven, not viewport-driven: there is deliberately no responsive
+ * collapse, no scroll machinery — it is a list of links plus a fallback.
+ *
+ * Navigation stays router- and history-agnostic where possible: a crumb (or the
+ * Back control) with an `href` renders a plain `<a>` and navigates natively;
+ * otherwise clicks emit outputs for the app to handle. Only the Back fallback
+ * with no `href` reaches for `history.back()`.
+ */
+declare class MnBreadcrumbs {
+    /** Trail crumbs and Back-fallback configuration. */
+    data: MnBreadcrumbsData;
+    /** Emits the crumb that was clicked (non-current crumbs only). */
+    crumbClick: EventEmitter<MnBreadcrumbItem>;
+    /** Emits when the fallback "Back" control is activated. */
+    back: EventEmitter<void>;
+    /** Default translation key / literal for the Back control's label. */
+    private static readonly DEFAULT_BACK_LABEL;
+    /** Resolved tailwind-variants slot functions for the current size. */
+    get styles(): {
+        root: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        list: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        link: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        current: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        separator: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        back: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+    } & {
+        root: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        list: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        link: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        current: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        separator: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+        back: (slotProps?: ({
+            size?: "sm" | "md" | undefined;
+        } & tailwind_variants.ClassProp<tailwind_merge.ClassNameValue>) | undefined) => string;
+    } & {};
+    /** Whether a linkable trail should render (vs the Back fallback). */
+    get hasTrail(): boolean;
+    /** Label for the Back control — the configured key/literal, or the default. */
+    get backLabel(): string;
+    /** The last crumb is the current page and is rendered as plain text. */
+    isCurrent(index: number): boolean;
+    /** Runs a crumb's own callback and notifies listeners of the click. */
+    onCrumb(item: MnBreadcrumbItem): void;
+    /**
+     * Fallback Back action. Always emits `back` for listeners; when no `backHref`
+     * anchor is carrying the navigation, steps back through browser history.
+     */
+    onBack(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MnBreadcrumbs, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnBreadcrumbs, "mn-breadcrumbs", never, { "data": { "alias": "data"; "required": false; }; }, { "crumbClick": "crumbClick"; "back": "back"; }, never, never, true, never>;
+}
+
+/**
+ * Styling for {@link MnBreadcrumbs}, expressed as tailwind-variants slots so the
+ * template can pull one class string per role. Theme tokens only, so the trail
+ * reads correctly in both light and dark. Links and the Back control are native
+ * `<button>`/`<a>` elements reset to look like plain text with a hover accent.
+ */
+declare const mnBreadcrumbsVariants: tailwind_variants.TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, undefined, {
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, tailwind_variants.TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            list: string;
+        };
+        md: {
+            root: string;
+            list: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    link: string;
+    current: string;
+    separator: string;
+    back: string;
+}, undefined, unknown, unknown, undefined>>;
+type MnBreadcrumbsVariants = VariantProps<typeof mnBreadcrumbsVariants>;
+
 /**
  * Types for mn-lib configuration.
  */
@@ -7772,5 +8081,5 @@ type MnPreviewMessage = {
  */
 declare function enableMnPreviewMode(configService: MnConfigService, langService: MnLanguageService, allowedOrigins?: string[]): void;
 
-export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnRichTextEditor, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
-export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };
+export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnBottomSheet, MnBreadcrumbs, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnRichTextEditor, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnBreadcrumbsVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
+export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnBreadcrumbItem, MnBreadcrumbsData, MnBreadcrumbsVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };