mn-angular-lib 1.0.154 → 1.0.156

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

@@ -78,6 +78,11 @@ type MnAlertConfig = {
     cssClasses?: Partial<Record<MnAlertKind, string>>;
     icons?: Partial<Record<MnAlertKind, unknown>>;
     fallbackDuration?: number | null;
+    /**
+     * How many alerts may be on screen at once. Showing one past this cap drops the oldest
+     * alert still visible, so a burst of alerts never grows into an unreadable stack.
+     */
+    maxVisible?: number;
     finalize?: (a: MnAlert) => MnAlert;
 };
 declare const MN_ALERT_CONFIG: InjectionToken<MnAlertConfig>;
@@ -116,9 +121,18 @@ declare class MnAlertService {
 declare class MnAlertStore {
     private readonly _alerts$;
     readonly alerts$: rxjs.Observable<MnAlert[]>;
+    /** Host configuration, when the app provided one. Only `maxVisible` is read here — the
+     *  per-kind durations are resolved by {@link MnAlertService} before an alert reaches the store. */
+    private readonly cfg;
+    /** In-flight auto-dismiss timers keyed by alert id, so an alert that leaves early (dismissed
+     *  by hand, or pushed out by the visible cap) never fires a stale timeout later. */
+    private readonly timers;
+    /** How many alerts stay on screen at once; showing more drops the oldest ones. */
+    private get maxVisible();
     show(partial: Omit<MnAlert, 'id'>): MnAlertId;
     dismiss(id: MnAlertId): void;
     clear(): void;
+    private clearTimer;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnAlertStore, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MnAlertStore>;
 }
@@ -205,6 +219,12 @@ declare class MnAlertOutletComponent {
     constructor();
     trackById: (_: number, v: MnAlertView) => string;
     getAlertClasses(a: MnAlert): string;
+    /**
+     * The lifetime (ms) to run the countdown bar over, or null when no bar should show: an alert
+     * that never auto-dismisses has nothing to count down, and one already leaving would only
+     * restart the animation mid-exit.
+     */
+    countdownDuration(v: MnAlertView): number | null;
     contextFor(a: MnAlert): {
         readonly $implicit: MnAlert;
         readonly alert: MnAlert;
@@ -1554,7 +1574,8 @@ declare class MnTextarea implements OnInit {
  * Mirrors the styling vocabulary of {@link mnInputFieldVariants} (size,
  * borderRadius, shadow, fullWidth, disabled) so a file input visually matches the
  * rest of the input family, and adds a `dropzone` toggle for the large dashed
- * drop area used by the default display mode.
+ * drop area used by the default display mode plus a `dragging` toggle for the
+ * "release to drop" state while files hover over that dropzone.
  */
 declare const mnFileInputVariants: tailwind_variants.TVReturnType<{
     /** Inner padding scale of the clickable control. */
@@ -1587,11 +1608,15 @@ declare const mnFileInputVariants: tailwind_variants.TVReturnType<{
     dropzone: {
         true: string;
     };
+    /** Highlighted "release to drop" appearance while files hover the dropzone. */
+    dragging: {
+        true: string;
+    };
     /** Dimmed, non-interactive appearance. */
     disabled: {
         true: string;
     };
-}, undefined, "bg-base-100 border-1 border-base-300 text-base-content text-sm outline-none transition-colors duration-300 ease-in-out", {
+}, undefined, "bg-base-100 border-1 border-base-300 text-base-content text-sm outline-none transition-all duration-300 ease-in-out", {
     /** Inner padding scale of the clickable control. */
     size: {
         sm: string;
@@ -1622,6 +1647,10 @@ declare const mnFileInputVariants: tailwind_variants.TVReturnType<{
     dropzone: {
         true: string;
     };
+    /** Highlighted "release to drop" appearance while files hover the dropzone. */
+    dragging: {
+        true: string;
+    };
     /** Dimmed, non-interactive appearance. */
     disabled: {
         true: string;
@@ -1657,11 +1686,15 @@ declare const mnFileInputVariants: tailwind_variants.TVReturnType<{
     dropzone: {
         true: string;
     };
+    /** Highlighted "release to drop" appearance while files hover the dropzone. */
+    dragging: {
+        true: string;
+    };
     /** Dimmed, non-interactive appearance. */
     disabled: {
         true: string;
     };
-}, undefined, "bg-base-100 border-1 border-base-300 text-base-content text-sm outline-none transition-colors duration-300 ease-in-out", unknown, unknown, undefined>>;
+}, undefined, "bg-base-100 border-1 border-base-300 text-base-content text-sm outline-none transition-all duration-300 ease-in-out", unknown, unknown, undefined>>;
 /** Variant prop types derived from {@link mnFileInputVariants}. */
 type MnFileInputVariants = VariantProps<typeof mnFileInputVariants>;
 
@@ -1674,7 +1707,9 @@ type MnFileInputErrorMessageData = string | MnErrorMessageFn;
  */
 type MnFileInputErrorMessagesData = Partial<Record<string, MnFileInputErrorMessageData>>;
 /**
- * Controls how the selected file(s) are presented.
+ * Controls how the selected file(s) are presented. Every mode but `compact`
+ * doubles as a drop target and shows a "release to drop" state while files are
+ * dragged over it.
  * - `dropzone` — large dashed drop area with icon + hint, previews/rows below (default).
  * - `thumbnail` — grid of image tiles (file icon for non-images), with an add tile.
  * - `list` — compact rows of file icon + name + size + remove.
@@ -1694,6 +1729,11 @@ type MnFileInputProps = {
     label?: string;
     /** Hint shown inside the empty dropzone (overrides config when provided). */
     dropzoneHint?: string;
+    /**
+     * Hint that replaces {@link dropzoneHint} while files are dragged over the
+     * dropzone (overrides config when provided).
+     */
+    dropActiveHint?: string;
     /** Label for the "choose/replace file" affordance (overrides config when provided). */
     replaceLabel?: string;
     /** Accessible label for the per-file remove button (overrides config when provided). */
@@ -1751,6 +1791,8 @@ type MnFileInputUIConfig = {
     ariaLabel?: string;
     /** Hint shown inside the empty dropzone. */
     dropzoneHint?: string;
+    /** Hint shown inside the dropzone while files are dragged over it. */
+    dropActiveHint?: string;
     /** Label for the "choose/replace file" affordance. */
     replaceLabel?: string;
     /** Accessible label for the per-file remove button. */
@@ -1782,6 +1824,10 @@ type MnFileDisplayItem = {
  * (and a file icon + name for non-images), supports single or multiple selection,
  * several display layouts, and client-side `accept` / `maxSize` / `maxFiles` limits.
  *
+ * Every display mode but `compact` is also a real drop target: dragging files
+ * over it switches the area to a highlighted "release to drop" state, and
+ * dropping runs the files through the same validation as the file picker.
+ *
  * The form control value is the plain selection: `File | null` (single) or
  * `File[]` (multiple). An optional `currentUrl`/`currentUrls` renders an
  * already-saved image; removing it leaves the value untouched and emits `cleared`.
@@ -1807,6 +1853,8 @@ declare class MnFileInput implements OnInit {
     protected uiConfig: MnFileInputUIConfig;
     /** Currently selected files (always an array internally). */
     protected readonly files: i0.WritableSignal<File[]>;
+    /** True while files are dragged over the dropzone ("release to drop" state). */
+    protected readonly isDragging: i0.WritableSignal<boolean>;
     /** Transient message for a rejected selection (accept/maxSize/maxFiles). */
     protected readonly internalError: i0.WritableSignal<string | null>;
     private readonly configService;
@@ -1824,6 +1872,11 @@ declare class MnFileInput implements OnInit {
     readonly displayItems: i0.Signal<MnFileDisplayItem[]>;
     /** Disabled state pushed by the forms API. */
     private formDisabled;
+    /**
+     * Nesting depth of the current drag, so that moving across child elements of
+     * the dropzone does not flicker {@link isDragging} off and on again.
+     */
+    private dragDepth;
     /**
      * Built-in default error messages in English.
      * Used when `useBuiltInErrorMessages` is true (default); overridable per-field.
@@ -1833,6 +1886,11 @@ declare class MnFileInput implements OnInit {
     constructor();
     /** The effective display mode. */
     get displayMode(): MnFileInputDisplayMode;
+    /**
+     * Whether the current display mode acts as a drop target. `compact` is an
+     * inline button sized for a form row, too small to aim a drag at.
+     */
+    get supportsDrop(): boolean;
     /** Whether the control is disabled (via props or the forms API). */
     get isDisabled(): boolean;
     /** Native `accept` attribute value, or null for no restriction when unset. */
@@ -1878,6 +1936,28 @@ declare class MnFileInput implements OnInit {
      * @param event The native change event from the hidden file input.
      */
     onFileSelected(event: Event): void;
+    /**
+     * Arms the "release to drop" state when a file drag enters the dropzone.
+     * @param event The native dragenter event.
+     */
+    onDragEnter(event: DragEvent): void;
+    /**
+     * Keeps the drop target alive; without a prevented dragover the browser never
+     * fires a drop event.
+     * @param event The native dragover event.
+     */
+    onDragOver(event: DragEvent): void;
+    /**
+     * Disarms the "release to drop" state once the drag has left the dropzone
+     * entirely (and not merely crossed into one of its children).
+     * @param event The native dragleave event.
+     */
+    onDragLeave(event: DragEvent): void;
+    /**
+     * Accepts the dropped files through the same validation as the file picker.
+     * @param event The native drop event.
+     */
+    onDrop(event: DragEvent): void;
     /**
      * Removes a newly-selected file by index.
      * @param index Index into the current selection.
@@ -1922,6 +2002,15 @@ declare class MnFileInput implements OnInit {
      * inputs: custom props > config > built-in > fallback > default.
      */
     private resolveMessage;
+    /**
+     * Whether a drag event should be treated as a file drop on this control.
+     * Ignores disabled controls, modes without a drop target, and drags that
+     * carry something other than files (selected text, a link, …) so the page
+     * keeps its default behaviour.
+     */
+    private acceptsDrag;
+    /** Clears the drag state and its nesting counter. */
+    private resetDrag;
     /** Checks a file against the configured `accept` filter (extensions and MIME globs). */
     private matchesAccept;
     /** Formats a byte count as a human-readable size. */
@@ -2759,8 +2848,14 @@ declare class MnMultiSelect implements OnInit {
     /** 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";
+    /** Layout classes for the invisible click shield rendered under the anchored panel.
+     *  One step below the panel's z-index so the panel itself stays clickable, and above
+     *  any modal/drawer chrome (which tops out well under 9998). */
+    readonly shieldClasses = "fixed inset-0 z-9998";
     /** The anchored popover panel currently moved into `document.body`, if any. */
     private movedPanel;
+    /** The click shield currently moved into `document.body`, if any. */
+    private movedShield;
     /** 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.
@@ -2804,6 +2899,11 @@ 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 click shield sitting under the anchored panel, portalled alongside it for the same
+     * reason: `position: fixed` must resolve against the viewport, not a transformed ancestor.
+     */
+    set shieldRef(ref: ElementRef<HTMLElement> | undefined);
     /** Currently selected values */
     selectedValues: unknown[];
     isOpen: boolean;
@@ -2849,6 +2949,15 @@ declare class MnMultiSelect implements OnInit {
      * otherwise auto-enabled once the option count reaches the threshold.
      */
     get isSearchable(): boolean;
+    /**
+     * Dismisses the anchored panel from a shield click, and stops the event there.
+     *
+     * Swallowing it is the point: the shield spans the viewport, so the click would otherwise
+     * land on whatever the panel was floating over. Inside a modal that is the modal's own
+     * backdrop, and "close the dropdown" would double as "throw away the modal". A first click
+     * that only dismisses the overlay is also how native selects and menus behave.
+     */
+    onShieldClick(event: Event): void;
     onDocumentClick(event: Event): void;
     /**
      * Records the sheet's opened height as its `min-height` floor. Measured on the next
@@ -3540,6 +3649,129 @@ declare class MnBottomSheet {
     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>;
 }
 
+/**
+ * Which keys a {@link MnKeyboard} renders.
+ *
+ * `alphanumeric` is the full QWERTY block with a digit row on top — the layout for
+ * a field that accepts either a membership number or a name. `numeric` is a phone-
+ * style 3x4 pad for digits only. `alpha` drops the digit row for name-only fields.
+ */
+type MnKeyboardLayout = 'alphanumeric' | 'numeric' | 'alpha';
+/**
+ * How a {@link MnKeyboard} presents itself.
+ *
+ * `inline` renders the keys in normal document flow. `sheet` mounts them in an
+ * {@link MnBottomSheet}, so the keyboard rises from the bottom of the screen over
+ * whatever the user was looking at and can be swiped away.
+ */
+type MnKeyboardPresentation = 'inline' | 'sheet';
+/**
+ * Labels for a {@link MnKeyboard}'s named keys.
+ *
+ * Supplied by the consumer rather than defaulted in the component: the library
+ * ships no user-facing English, so the host app translates these in its own
+ * bundles. The character keys need no labels — a digit and a letter read the same
+ * in every supported language.
+ */
+type MnKeyboardLabels = {
+    /** The backspace key (also its accessible name). */
+    backspace: string;
+    /** The clear-everything key. */
+    clear: string;
+    /** The space key. */
+    space: string;
+    /** The confirm/submit key. */
+    submit: string;
+    /** Accessible name for the keyboard as a whole. */
+    keyboard: string;
+};
+
+/**
+ * An on-screen keyboard for touch devices that have no keyboard of their own.
+ *
+ * It exists for unattended screens — a tablet on a wall, a kiosk by a door — where
+ * the OS keyboard is either unavailable or unwanted, and where the same field may
+ * need to take a membership number *or* a name. Hence one component with a
+ * {@link layout} switch rather than a separate number pad and text pad.
+ *
+ * It is a controlled component: it never owns the text. The host passes {@link value}
+ * and reacts to {@link valueChange}, exactly like a form control, so the same value
+ * can also be filled by a barcode scanner or a real keyboard without this component
+ * fighting it.
+ *
+ * With {@link presentation} set to `sheet` it mounts inside an {@link MnBottomSheet},
+ * rising from the bottom of the screen and swipeable away — the shape a kiosk wants
+ * so the keys do not permanently occupy half the display.
+ *
+ * The library ships no user-facing English, so every named key takes its caption
+ * from {@link labels}.
+ */
+declare class MnKeyboard {
+    /** The current text. This component never mutates it — see {@link valueChange}. */
+    value: string;
+    /** Which keys to render. */
+    layout: MnKeyboardLayout;
+    /** Whether the keys sit in the page or rise from the bottom as a sheet. */
+    presentation: MnKeyboardPresentation;
+    /**
+     * Captions and accessible names for the named keys.
+     *
+     * The defaults are language-neutral glyphs rather than words, so a consumer that
+     * forgets to translate still ships no English (or Dutch) from the library. The
+     * accessible name for the keyboard as a whole has no neutral glyph, so it
+     * defaults to empty and the attribute is simply omitted until a host supplies one.
+     */
+    labels: MnKeyboardLabels;
+    /** Whether letters are rendered (and typed) upper-case. */
+    uppercase: boolean;
+    /** Whether to offer a space key. Off for a field that can never contain one. */
+    allowSpace: boolean;
+    /** Whether to offer a submit key. */
+    showSubmit: boolean;
+    /** Whether the submit key is currently actionable. */
+    submitDisabled: boolean;
+    /** Hard cap on the text length, or null for none. */
+    maxLength: number | null;
+    /** Cap on the sheet height as a fraction of the viewport, in vh (sheet presentation only). */
+    sheetMaxHeightVh: number;
+    /** Emits the full text after every key press, so the host can drive its own field. */
+    valueChange: EventEmitter<string>;
+    /** Emits when the submit key is pressed. */
+    submitted: EventEmitter<string>;
+    /** Emits when a sheet-presented keyboard is swiped or tapped away. */
+    dismissed: EventEmitter<void>;
+    get hostClasses(): string;
+    /** The character rows to render, driven by {@link layout}. */
+    get rows(): readonly string[][];
+    /** Whether the space key should be offered (never on a digits-only pad). */
+    get spaceVisible(): boolean;
+    /**
+     * Appends a character, respecting {@link maxLength}.
+     * @param key The character pressed.
+     */
+    press(key: string): void;
+    /** Appends a space. */
+    pressSpace(): void;
+    /** Removes the last character. */
+    backspace(): void;
+    /** Empties the field. */
+    clear(): void;
+    /** Reports a submit press. The host decides what submitting means. */
+    submit(): void;
+    /** Reports that a sheet-presented keyboard was dismissed. */
+    onDismiss(): void;
+    /**
+     * Emits a new value, clamped to {@link maxLength}.
+     *
+     * Clamping happens here rather than in each key handler so a paste-like burst
+     * from a scanner and a tapped key are bounded the same way.
+     * @param next The candidate text.
+     */
+    private emit;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MnKeyboard, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnKeyboard, "mn-keyboard", never, { "value": { "alias": "value"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presentation": { "alias": "presentation"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "uppercase": { "alias": "uppercase"; "required": false; }; "allowSpace": { "alias": "allowSpace"; "required": false; }; "showSubmit": { "alias": "showSubmit"; "required": false; }; "submitDisabled": { "alias": "submitDisabled"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; "sheetMaxHeightVh": { "alias": "sheetMaxHeightVh"; "required": false; }; }, { "valueChange": "valueChange"; "submitted": "submitted"; "dismissed": "dismissed"; }, never, never, true, never>;
+}
+
 declare const mnSelectVariants: tailwind_variants.TVReturnType<{
     shadow: {
         true: string;
@@ -5706,6 +5938,8 @@ type FileFieldConfig<TModel = unknown> = {
     displayMode?: 'dropzone' | 'thumbnail' | 'list' | 'compact';
     /** Hint shown inside the empty dropzone */
     dropzoneHint?: string;
+    /** Hint shown inside the dropzone while files are dragged over it */
+    dropActiveHint?: string;
     /** Label for the "choose/replace file" affordance */
     replaceLabel?: string;
     /** Accessible label for the per-file remove button */
@@ -6462,6 +6696,7 @@ type FormFieldView<TModel> = FormFieldConfig<TModel> & {
     multiple?: boolean;
     displayMode?: 'dropzone' | 'thumbnail' | 'list' | 'compact';
     dropzoneHint?: string;
+    dropActiveHint?: string;
     replaceLabel?: string;
     removeLabel?: string;
     currentUrl?: string | null;
@@ -7238,6 +7473,7 @@ declare class CalendarViewComponent implements OnInit, OnDestroy {
     private readonly mnConfigRef;
     private readonly destroyRef;
     private readonly lang;
+    private readonly cdr;
     constructor();
     onResize(): void;
     ngOnInit(): void;
@@ -7443,6 +7679,7 @@ declare class CalendarDayComponent implements OnInit, OnDestroy {
  */
 declare class CalendarMonthComponent implements OnInit, OnDestroy {
     private readonly lang;
+    private readonly cdr;
     /**
      * Accessible name for this control. Resolved through the conventional
      * `mnCalendar.monthView` key so an app can translate it, falling back to English when the
@@ -7537,6 +7774,7 @@ declare class CalendarEventDefaultComponent implements CalendarEventData, OnInit
  */
 declare class UpcomingEventsComponent implements OnInit, OnChanges, OnDestroy {
     private readonly lang;
+    private readonly cdr;
     /**
      * Accessible name for this control. Resolved through the conventional
      * `mnCalendar.upcomingEvents` key so an app can translate it, falling back to English when the
@@ -7728,6 +7966,17 @@ declare class CalendarUtility {
 type MnTabItem = {
     /** Translation key or label text for the tab. */
     label: string;
+    /**
+     * Stable value this tab is written as in the URL while the tab bar mirrors
+     * its selection there (see {@link MnTabDataSource.urlParam}).
+     *
+     * Defaults to a slug of the last segment of {@link label}
+     * (`matches.hub.tab.entrants` → `entrants`, `members.tabMembers` →
+     * `tab-members`). Set it when that slug is not the URL you want to hand out,
+     * or when the label key may be renamed — a shared link is only as stable as
+     * the value in it.
+     */
+    id?: string;
     /** Callback invoked when this tab becomes active. */
     onClick?: () => void;
     /** Callback invoked when this tab is deactivated. */
@@ -7755,13 +8004,59 @@ type MnTabDataSource = {
      * (e.g. tabs that depend on data being fetched) to predict the final count.
      */
     skeletonCount?: number;
+    /**
+     * Query parameter the active tab is mirrored in, so a reload or a shared
+     * link lands on the tab the user was looking at. Defaults to `'tab'`; pass
+     * `false` to keep this tab bar out of the URL.
+     *
+     * Each tab bar that can be on screen at the same time as another needs its
+     * own parameter name — two bars sharing one name fight over it. Turn it off
+     * for a tab bar whose selection is not worth sharing, such as one inside a
+     * modal, which would otherwise write to the URL of the page behind it.
+     *
+     * Only user selections are written, so a page nobody has clicked a tab on
+     * keeps a clean URL and falls back to {@link defaultActive}. Restoring a tab
+     * from the URL runs that tab's {@link MnTabItem.onClick} and emits
+     * `activeChange`, so a consumer tracking the active tab itself hears about
+     * the restored one.
+     */
+    urlParam?: string | false;
 };
 
 /**
  * Tab component that renders a horizontal tab bar.
  * Supports translation keys for labels via MnTranslatePipe.
+ *
+ * The active tab is mirrored in the URL query string by default, so a reload,
+ * a back button or a shared link lands on the same tab; see
+ * {@link MnTabDataSource.urlParam} to rename that parameter or switch it off.
  */
 declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
+    /**
+     * Router the active tab is written to. Optional: a tab bar used outside a
+     * routed application still works, it just has no URL to mirror into.
+     */
+    private readonly router;
+    /** Route the tab value is read back from; absent for the same reason as {@link router}. */
+    private readonly route;
+    /** Watches the URL so a deep link, a back button or an in-app link moves the tab bar. */
+    private readonly queryParamsSub?;
+    /**
+     * URL keys of the current items, memoised on the items array so a slug is
+     * computed once per tab set rather than on every change-detection pass.
+     */
+    private urlKeyCache?;
+    /** URL key of {@link currentActive}, so a rebuilt tab set can be recognised as the same tab. */
+    private currentKey?;
+    /**
+     * Key of a selection whose URL write has not landed yet. Navigation is
+     * asynchronous, so a consumer that rebuilds its tabs in response to the click
+     * can be resolved against a URL that still names the previous tab; until the
+     * write completes, this is the truth about what the user picked.
+     */
+    private pendingKey?;
+    /** Set on destroy so a deferred restore can't announce a tab nobody is showing. */
+    private destroyed;
     /** The horizontally-scrolling wrapper the edge fade is painted onto. */
     private scrollContainer?;
     /** The tab row; queried for the active tab so the indicator can measure it. */
@@ -7819,6 +8114,7 @@ declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
      * otherwise the number of known items, falling back to a default when none.
      */
     get skeletonTabs(): number[];
+    constructor();
     /**
      * Re-resolves the active tab on every change-detection pass.
      *
@@ -7845,10 +8141,19 @@ declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
      */
     updateEdgeFades(): void;
     /**
-     * Sets the given tab item as active, invoking deactivate/activate callbacks.
+     * Sets the given tab item as active, invoking deactivate/activate callbacks,
+     * and records the selection in the URL so it survives a reload or a share.
      * @param item - The tab item to activate.
      */
     setActive(item: MnTabItem): void;
+    /**
+     * Moves the selection to `item` and tells the consumer about it: the
+     * deactivate/activate/emit sequence a click produces, shared by the click
+     * path and the URL-driven ones (deep link, back button), which owe the
+     * consumer the same notifications.
+     * @param item - The tab item to activate.
+     */
+    private activate;
     /**
      * Marks a click-driven slide as in progress and schedules the guard to lift
      * once the transition has finished. A timeout (not `transitionend`) so the
@@ -7876,10 +8181,54 @@ declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
     getBadge(item: MnTabItem): number | undefined;
     /**
      * Ensures {@link currentActive} references a tab that still exists in the data
-     * source, falling back to the configured default tab when the current
-     * selection is missing or stale (e.g. after the items array is replaced).
+     * source, preferring the tab named in the URL and falling back to the
+     * configured default tab when the current selection is missing or stale
+     * (e.g. after the items array is replaced).
      */
     private syncActiveTab;
+    /**
+     * Records `item` as the selection, remembering its URL key so the same tab is
+     * recognised after the consumer rebuilds the items array.
+     * @param item - The newly selected tab.
+     */
+    private select;
+    /**
+     * Runs the restored tab's callbacks a change-detection pass later, unless the
+     * selection moved on in the meantime (a click, or another tab set arriving).
+     * @param item - The tab restored from the URL.
+     */
+    private announceRestored;
+    /**
+     * Activates the tab a URL value names, when it is not the tab already on
+     * screen. Values naming no known tab are ignored: another tab bar on the page
+     * may own that parameter, and a stale link should leave the default standing.
+     * @param key - The value read from the query parameter, if any.
+     */
+    private activateUrlKey;
+    /**
+     * The query parameter this tab bar mirrors into, or undefined when there is
+     * nothing to mirror into (no router) or the consumer switched it off.
+     */
+    private urlParam;
+    /**
+     * The tab the current URL asks for, if it names one of `items`.
+     * @param items - The tab set to resolve the URL value against.
+     */
+    private itemFromUrl;
+    /**
+     * Records the active tab in the query string, replacing the current history
+     * entry: switching tabs is not a navigation to walk back through, and back
+     * should leave the page rather than retrace its tabs.
+     * @param item - The tab that just became active.
+     */
+    private writeUrl;
+    /**
+     * The URL key of every tab, in item order: the item's `id`, else a slug of
+     * its label. Repeats are numbered so each tab still round-trips through the
+     * URL; give such tabs an explicit `id` to choose the value yourself.
+     * @param items - The tab set to key.
+     */
+    private urlKeys;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnTabComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnTabComponent, "mn-tab", never, { "dataSource": { "alias": "dataSource"; "required": false; }; "scrollable": { "alias": "scrollable"; "required": false; }; "justified": { "alias": "justified"; "required": false; }; }, { "activeChange": "activeChange"; }, never, never, true, never>;
 }
@@ -8768,5 +9117,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_DROPDOWN_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, MnDropdown, 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, mnDropdownTriggerVariants, 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, MnActionIcon, 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, MnDropdownAction, MnDropdownActionColor, MnDropdownItem, MnDropdownProps, MnDropdownSeparator, MnDropdownTriggerVariants, MnDropdownUIConfig, 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, MnRowValue, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTableRowAction, 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_DROPDOWN_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, MnDropdown, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnKeyboard, 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, mnDropdownTriggerVariants, 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, MnActionIcon, 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, MnDropdownAction, MnDropdownActionColor, MnDropdownItem, MnDropdownProps, MnDropdownSeparator, MnDropdownTriggerVariants, MnDropdownUIConfig, 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, MnKeyboardLabels, MnKeyboardLayout, MnKeyboardPresentation, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnRowValue, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTableRowAction, 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 };