mn-angular-lib 1.0.152 → 1.0.155

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mn-angular-lib",
-  "version": "1.0.152",
+  "version": "1.0.155",
   "peerDependencies": {
     "@angular/common": "^21.1.3",
     "@angular/core": "^21.1.3",

package/src/lib/features/mn-alert/mn-alert-outlet/mn-alert-outlet.css

@@ -51,6 +51,44 @@
   overflow: hidden;
 }
 
+/* Countdown bar: a hairline track pinned to the card's bottom edge whose fill drains over the
+   alert's lifetime, so the remaining time is visible rather than guessed. The bar runs the full
+   width and the card clips it (`overflow-hidden` on the card in the template), so its ends taper
+   along the card's rounded corners instead of cutting straight across them. The track's own
+   `overflow: hidden` is what clips the draining fill. */
+
+.mn-alert-progress {
+  position: absolute;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  height: 3px;
+  overflow: hidden;
+  background-color: color-mix(in srgb, currentColor 18%, transparent);
+  pointer-events: none;
+}
+
+.mn-alert-progress-bar {
+  display: block;
+  height: 100%;
+  background-color: currentColor;
+  opacity: 0.55;
+  transform-origin: left center;
+  /* Duration is bound per alert from the component; the rest of the timing lives here. */
+  animation-name: mn-alert-countdown;
+  animation-timing-function: linear;
+  animation-fill-mode: forwards;
+}
+
+@keyframes mn-alert-countdown {
+  from {
+    transform: scaleX(1);
+  }
+  to {
+    transform: scaleX(0);
+  }
+}
+
 @media (prefers-reduced-motion: reduce) {
   .mn-alert-item {
     transition: none;

package/src/lib/features/mn-keyboard/mn-keyboard.component.css

@@ -0,0 +1,14 @@
+/* The keys are sized by Tailwind utilities in the template; this file exists for
+   the touch affordances that have no utility equivalent. */
+:host {
+  display: block;
+}
+
+/* A kiosk key is hit with a fingertip, often repeatedly and fast. Suppressing the
+   long-press selection and the tap highlight keeps a rapid entry from selecting
+   the caption text or flashing a native overlay on every press. */
+.mn-keyboard-key {
+  -webkit-tap-highlight-color: transparent;
+  user-select: none;
+  touch-action: manipulation;
+}

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. */
@@ -2692,6 +2781,18 @@ type MnMultiSelectProps<TValue = unknown> = {
      * while collapsing is active, `"{count} selected"` is used as the fallback.
      */
     collapsePlaceholder?: string;
+    /**
+     * Summary text shown when **every** option is selected, in place of the count summary.
+     *
+     * "Everything" is a meaningful state at any option count, so setting this collapses the
+     * trigger as soon as the full set is selected regardless of `collapseThreshold` — without
+     * it, a three-option select could never say so under the default threshold of 5.
+     *
+     * Setting this enables collapsing on its own. The `{count}` token is replaced the same way
+     * it is in `collapsePlaceholder`. Ignored while the select has no options at all, where
+     * "all of them" would be a claim about nothing.
+     */
+    allSelectedPlaceholder?: string;
     /** Size variant of the multi-select (default: 'md') */
     size?: MnMultiSelectVariants['size'];
     /** Border radius variant (default: 'md') */
@@ -2747,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.
@@ -2792,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;
@@ -2837,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
@@ -2902,26 +3023,31 @@ declare class MnMultiSelect implements OnInit {
     get filteredOptions(): MnMultiSelectOption[];
     get selectedOptions(): MnMultiSelectOption[];
     /**
-     * Whether the collapse-to-summary feature is opted into. Active when either
-     * `collapsePlaceholder` or `collapseThreshold` is supplied; existing usages
-     * with neither prop are unaffected.
+     * Whether the collapse-to-summary feature is opted into. Active when any of
+     * `collapsePlaceholder`, `collapseThreshold` or `allSelectedPlaceholder` is
+     * supplied; existing usages with none of them are unaffected.
      */
     get collapseEnabled(): boolean;
+    /**
+     * Whether every available option is currently selected. False for an empty select, where
+     * "all of them" would be a claim about nothing.
+     */
+    get allSelected(): boolean;
     /**
      * The threshold above which the trigger collapses. Defaults to 5 when collapsing
      * is enabled via `collapsePlaceholder` alone (no explicit `collapseThreshold`).
      */
     get effectiveCollapseThreshold(): number;
     /**
-     * Whether the trigger should currently render the count summary instead of the
-     * individual chips: only when collapsing is enabled and the number of selected
-     * options exceeds the effective threshold.
+     * Whether the trigger should currently render a summary instead of the individual
+     * chips: when the number of selected options exceeds the effective threshold, or
+     * when every option is selected and a summary for that case was supplied.
      */
     get isCollapsed(): boolean;
     /**
      * The summary text shown while collapsed, with the `{count}` token replaced by
-     * the number of selected options. Falls back to `"{count} selected"` when no
-     * `collapsePlaceholder` is provided.
+     * the number of selected options. `allSelectedPlaceholder` wins while everything
+     * is selected, then `collapsePlaceholder`, then `"{count} selected"`.
      */
     get collapseSummaryText(): string;
     handleBlur(): void;
@@ -3523,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;
@@ -5536,9 +5785,20 @@ type MultiSelectFieldConfig<TModel = unknown, TValue = unknown> = {
     options: SelectOption<TValue>[];
     validators?: ValidatorFn[];
     asyncValidators?: AsyncValidatorFn[];
+    /** Placeholder shown in the trigger while nothing is selected. */
+    placeholder?: string;
     searchable?: boolean;
     searchPlaceholder?: string;
     maxSelections?: number;
+    /**
+     * Forwarded to the underlying multi-select: once more than this many options are selected the
+     * trigger collapses to a summary instead of rendering every chip.
+     */
+    collapseThreshold?: number;
+    /** Forwarded summary text for the collapsed trigger; `{count}` is interpolated. */
+    collapsePlaceholder?: string;
+    /** Forwarded summary text shown when every option is selected. */
+    allSelectedPlaceholder?: string;
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
@@ -5678,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 */
@@ -6424,6 +6686,9 @@ type FormFieldView<TModel> = FormFieldConfig<TModel> & {
     searchable?: boolean;
     searchPlaceholder?: string;
     maxSelections?: number;
+    collapseThreshold?: number;
+    collapsePlaceholder?: string;
+    allSelectedPlaceholder?: string;
     swatches?: string[];
     showValue?: boolean;
     unit?: string;
@@ -6431,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;
@@ -8737,5 +9003,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 };