mn-angular-lib 1.0.148 → 1.0.149

package/package.json

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

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

@@ -0,0 +1,58 @@
+/* Each alert is wrapped in a grid so its row can collapse from 1fr → 0fr, letting the
+   siblings glide up smoothly instead of jumping when one leaves. The card's transform and
+   opacity are driven from the component (swipe drag, fling, drag-fade); the exit fade and
+   height-collapse are owned here so every dismissal path — swipe, close button, auto-timeout
+   — animates out rather than vanishing instantly. */
+
+:host {
+  --mn-alert-exit: 320ms;
+}
+
+.mn-alert-item {
+  display: grid;
+  grid-template-rows: 1fr;
+  margin-bottom: 0.75rem;
+  /* `touch-action` is set from the component per platform (pan-y for the horizontal swipe
+     axis, pan-x for the vertical one); this is only the pre-hydration fallback. */
+  touch-action: pan-y;
+  cursor: grab;
+  transition:
+    transform 280ms cubic-bezier(0.22, 1, 0.36, 1),
+    opacity var(--mn-alert-exit) ease,
+    grid-template-rows var(--mn-alert-exit) cubic-bezier(0.4, 0, 0.2, 1),
+    margin-bottom var(--mn-alert-exit) cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.mn-alert-item:last-child {
+  margin-bottom: 0;
+}
+
+.mn-alert-item.dragging {
+  /* Track the finger 1:1 — no easing while a drag is live. */
+  transition: none;
+  cursor: grabbing;
+  user-select: none;
+}
+
+.mn-alert-inner {
+  /* Required for the grid row to actually shrink its content on collapse. */
+  min-height: 0;
+}
+
+.mn-alert-item.leaving {
+  grid-template-rows: 0fr;
+  opacity: 0;
+  margin-bottom: 0;
+  pointer-events: none;
+}
+
+.mn-alert-item.leaving .mn-alert-inner {
+  /* Clip the card as its row collapses; kept visible otherwise so the card's shadow shows. */
+  overflow: hidden;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .mn-alert-item {
+    transition: none;
+  }
+}

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

@@ -4,7 +4,7 @@ export { TemplateRef, Type } from '@angular/core';
 import * as tailwind_variants from 'tailwind-variants';
 import { VariantProps } from 'tailwind-variants';
 import * as rxjs from 'rxjs';
-import { Observable, BehaviorSubject, Subject } from 'rxjs';
+import { BehaviorSubject, Observable, Subject } from 'rxjs';
 import * as mn_angular_lib from 'mn-angular-lib';
 import * as _angular_forms from '@angular/forms';
 import { ValidationErrors, NgControl, AbstractControl, ValidatorFn, AsyncValidatorFn, FormGroup } from '@angular/forms';
@@ -128,8 +128,57 @@ type MnAlertTemplateContext = {
     alert: MnAlert;
     dismiss: () => void;
 };
+/**
+ * A view-owned wrapper around a single {@link MnAlert}. The store's list is the source
+ * of truth for which alerts *exist*; this outlet mirrors it into `views` so a removed
+ * alert can play a leave animation (swipe-fling or fade + height-collapse) before its
+ * node is actually dropped, rather than vanishing instantly.
+ */
+type MnAlertView = {
+    alert: MnAlert;
+    /** True once the alert has left the store — the node is animating out and will be removed. */
+    leaving: boolean;
+    /** True while the user is actively dragging this card (disables the snap transition). */
+    dragging: boolean;
+    /** Live drag offset (px) along the active swipe axis while swiping. */
+    drag: number;
+    /** Final offset (px) along the swipe axis the card flings to when a swipe dismisses it. */
+    fling: number;
+};
 declare class MnAlertOutletComponent {
     private readonly lang;
+    private readonly store;
+    private readonly destroyRef;
+    /** Drag distance (px) past which a release dismisses regardless of speed. */
+    private static readonly SWIPE_DISMISS_THRESHOLD;
+    /** 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 leave wait; kept a touch longer than the CSS exit so removal never
+     *  preempts the animation. Mirrored by the `--mn-alert-exit` duration in the stylesheet. */
+    private static readonly EXIT_MS;
+    /** Opacity floor a card fades to at the dismiss threshold, for drag feedback. */
+    private static readonly DRAG_OPACITY_FLOOR;
+    /**
+     * How the dismiss swipe is oriented:
+     * - `'auto'` (default) matches the host platform's convention — Apple platforms
+     *   (iOS/iPadOS/macOS) flick a top banner *upward*, so we swipe vertically; Android (and
+     *   every other platform) dismisses toasts *to the right*, so we swipe horizontally.
+     *
+     * Either axis is one-directional: only an upward (vertical) or rightward (horizontal)
+     * drag dismisses; dragging the opposite way springs the card back.
+     * - `'vertical'` / `'horizontal'` force the axis regardless of platform. Useful when the
+     *   host can't be sniffed reliably (e.g. Chrome DevTools *Responsive* mode does not spoof
+     *   the user agent, so `'auto'` there resolves to the desktop/Android horizontal axis).
+     */
+    swipeAxis: 'auto' | 'vertical' | 'horizontal';
+    /** Whether the running device is an Apple platform. Sniffed once from `navigator` at
+     *  construction (the UA is read at page load and does not change mid-session). */
+    private readonly isApple;
+    /** The resolved swipe axis: the explicit {@link swipeAxis} override, or the platform
+     *  default when left on `'auto'`. */
+    private get vertical();
     /**
      * Accessible name for this control. Resolved through the conventional
      * `mnAlert.close` key so an app can translate it, falling back to English when the
@@ -137,19 +186,62 @@ declare class MnAlertOutletComponent {
      */
     get closeLabel(): string;
     template?: TemplateRef<MnAlertTemplateContext>;
-    private store;
-    alerts$: Observable<MnAlert[]>;
+    /** The view-layer mirror of the store's alerts, retaining alerts mid-leave. A signal so
+     *  writes from the (external) store subscription and leave timers schedule change
+     *  detection in a zoneless app. */
+    readonly views: i0.WritableSignal<MnAlertView[]>;
+    /**
+     * `touch-action` for the swipe wrapper: reserve the swipe axis for our gesture while
+     * leaving the cross-axis to the browser. Vertical swipe (Apple) claims the Y axis
+     * (`pan-x`); horizontal swipe (Android/other) claims the X axis (`pan-y`).
+     */
+    get touchAction(): string;
+    /** In-flight leave-removal timers, keyed by alert id, cleared on destroy so a fired
+     *  timer never touches a torn-down view. */
+    private readonly exitTimers;
+    /** The single active swipe, or null. Only one card is dragged at a time. `startCoord`
+     *  and the samples are taken along the active axis (Y when vertical, else X). */
+    private activeDrag;
     constructor();
-    dismissAlert(id: string): void;
-    trackById: (_: number, a: MnAlert) => string;
+    trackById: (_: number, v: MnAlertView) => string;
     getAlertClasses(a: MnAlert): string;
     contextFor(a: MnAlert): {
         readonly $implicit: MnAlert;
         readonly alert: MnAlert;
         readonly dismiss: () => void;
     };
+    /** Dismisses via the store; the store's removal is turned into a leave animation by
+     *  {@link sync}. Used by the close button and the custom-template `dismiss` context. */
+    dismissAlert(id: MnAlertId): void;
+    /** Reconciles the view list against the store: appends new alerts, updates the alert
+     *  reference for still-present ones, and marks vanished ones as leaving (they stay in the
+     *  list, animating out, until their removal timer fires). */
+    private sync;
+    /** Flags a view as leaving and schedules its removal once the exit animation has run.
+     *  Idempotent: a card already leaving (e.g. flung by a swipe) is left untouched, so a
+     *  synchronous store re-emit cannot overwrite the swipe direction with the default fade. */
+    private beginLeave;
+    private removeView;
+    onPointerDown(event: PointerEvent, v: MnAlertView): void;
+    onPointerMove(event: PointerEvent, v: MnAlertView): void;
+    onPointerUp(event: PointerEvent, v: MnAlertView): void;
+    private shouldDismiss;
+    /** Offset transform for a card: the fling target while leaving via swipe, otherwise the
+     *  live drag offset, translated along the active axis. Returns null when neither applies,
+     *  letting the stylesheet own the default (fade-in-place) leave. */
+    itemTransform(v: MnAlertView): string | null;
+    /** Fades a card toward a floor as it is dragged toward the dismiss threshold. Null (CSS
+     *  owns opacity) when at rest or leaving. */
+    itemOpacity(v: MnAlertView): number | null;
+    private translate;
+    private axisCoord;
+    private viewportExtent;
+    /** Whether the current device runs an Apple OS (iOS/iPadOS/macOS). iPadOS 13+ masquerades
+     *  as a Mac, so it is caught by the touch-capable-Mac branch. */
+    private detectApple;
+    private prefersReducedMotion;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnAlertOutletComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MnAlertOutletComponent, "mn-alert-outlet", never, { "template": { "alias": "template"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnAlertOutletComponent, "mn-alert-outlet", never, { "swipeAxis": { "alias": "swipeAxis"; "required": false; }; "template": { "alias": "template"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare const mnBadgeVariants: tailwind_variants.TVReturnType<{
@@ -2958,16 +3050,40 @@ type MnDropdownAction = {
     /** Renders the item in a destructive style (e.g. a "Delete" action). Shorthand for
      *  the red foreground; equivalent to `color: 'danger'`. */
     danger?: boolean;
+    /**
+     * Extra text the search filter matches against, beyond the visible label — a summary,
+     * synonyms, a category. Only consulted when the menu is {@link MnDropdownProps.searchable}.
+     * Lets search find a command by more than its label, e.g. a help search that matches a
+     * topic's title *and* its summary.
+     */
+    keywords?: string;
+};
+/**
+ * A divider between commands, rendered as an `<hr>`. Group related actions — e.g. a
+ * destructive "Logout" set off from a profile menu's navigation, or a name header above
+ * its items. Non-interactive: it is skipped by keyboard nav and hidden while a
+ * {@link MnDropdownProps.searchable} filter is active (a divider stranded between hidden
+ * results is meaningless).
+ */
+type MnDropdownSeparator = {
+    separator: true;
 };
+/** An entry in a {@link MnDropdownProps.actions} list: a command or a {@link MnDropdownSeparator}. */
+type MnDropdownItem = MnDropdownAction | MnDropdownSeparator;
 /**
- * Configuration for {@link MnDropdown}. Everything is passed through the single
- * `props` input, mirroring mn-select / mn-multi-select.
+ * Configuration for {@link MnDropdown}, passed through its single `datasource` input.
+ * (The type keeps the `Props` name; only the input binding is `datasource`.)
  */
 type MnDropdownProps = {
-    /** Unique identifier, required for the trigger/menu accessibility wiring. */
-    id: string;
-    /** The commands rendered in the menu, in order. */
-    actions: MnDropdownAction[];
+    /**
+     * Unique identifier for the trigger/menu accessibility wiring. Optional — a stable one is
+     * generated when omitted, so the leanest dropdown is just `{ actions: [...] }`. Set it
+     * explicitly only to target this instance from {@link MnConfigService} `#id` overrides.
+     */
+    id?: string;
+    /** The commands rendered in the menu, in order. May include {@link MnDropdownSeparator}
+     *  entries (`{ separator: true }`) to divide the list into groups. */
+    actions: MnDropdownItem[];
     /**
      * Text shown inside the trigger button, turning the ⋯ icon into a labelled control
      * (e.g. "Actions"). When set, {@link triggerIcon} defaults to a trailing chevron
@@ -2979,9 +3095,29 @@ type MnDropdownProps = {
     /**
      * Which glyph the trigger shows. Defaults to `'dots-vertical'` (⋮) for an icon-only
      * trigger, or `'chevron'` (▾) when a {@link triggerLabel} is set. Use `'none'` for a
-     * text-only trigger, or `'dots-horizontal'` (⋯) for the horizontal ellipsis.
-     */
-    triggerIcon?: 'dots-vertical' | 'dots-horizontal' | 'chevron' | 'none';
+     * text-only trigger.
+     *
+     * Beyond the three built-in glyphs, this also accepts a custom {@link MnActionIcon} — a
+     * `TemplateRef` (full control: an `<mn-icon>`, an emoji, a bespoke `<svg>`) or lucide
+     * icon *data* such as `LucideFilter.icon`, rendered by the component at trigger size.
+     * The same convention the per-item {@link MnDropdownAction.icon} uses. (For a horizontal
+     * ellipsis ⋯, pass `LucideEllipsis.icon` here.)
+     */
+    triggerIcon?: 'dots-vertical' | 'chevron' | 'none' | MnActionIcon;
+    /**
+     * Styles the trigger as a full {@link MnButtonTypes} button instead of the default ghost
+     * ⋯ affordance — `variant`, `color`, `size`, `borderRadius`, `shape`, etc. Merged over
+     * the default `{ size: 'sm', variant: 'text', color: 'gray' }`, so a partial config only
+     * changes what you name (e.g. `{ variant: 'fill', color: 'primary' }` for a solid button).
+     *
+     * When set, mn-button owns the trigger's look entirely: the trigger's own {@link size}
+     * and {@link borderRadius} props no longer apply (use this config's), and mn-button's
+     * `borderRadius` default (`lg`) takes over. Composes with {@link triggerIcon} and
+     * {@link triggerLabel} — the glyph/label render inside the styled button. For a square
+     * icon-only button, set `shape: 'square'` (or `'circle'`) here; otherwise a filled
+     * icon-only trigger is a small padded box rather than a fixed square.
+     */
+    triggerButton?: Partial<MnButtonTypes>;
     /** Accessible label for the trigger button. Falls back to a translated default.
      *  Ignored for name purposes when {@link triggerLabel} provides visible text. */
     ariaLabel?: string;
@@ -2999,6 +3135,23 @@ type MnDropdownProps = {
      * to true; set false to keep the trigger-anchored popover on mobile too.
      */
     mobileSheet?: boolean;
+    /**
+     * Shows a filter input at the top of the menu (and the mobile sheet), narrowing the
+     * actions as the user types. Each action matches on its resolved label and its
+     * {@link MnDropdownAction.keywords}, case-insensitively. On desktop the input is
+     * focused on open; pressing Enter runs the first still-visible, enabled action —
+     * mirroring a help search that opens the top hit. Defaults to false.
+     */
+    searchable?: boolean;
+    /** Placeholder for the search input. Falls back to a translated default ("Search..."). */
+    searchPlaceholder?: string;
+    /** Translation key for {@link searchPlaceholder}. Resolved via MnLanguageService. */
+    searchPlaceholderKey?: string;
+    /** Text shown in place of the list when the filter matches no actions. Falls back to
+     *  a translated default ("No results"). */
+    searchEmptyLabel?: string;
+    /** Translation key for {@link searchEmptyLabel}. Resolved via MnLanguageService. */
+    searchEmptyLabelKey?: string;
     /** Size variant of the ⋯ trigger (default: 'md'). */
     size?: MnDropdownTriggerVariants['size'];
     /** Border-radius variant of the ⋯ trigger (default: 'md'). */
@@ -3015,6 +3168,10 @@ type MnDropdownUIConfig = {
     menuLabel?: string;
     /** Accessible label for the mobile sheet's close button (falls back to "Close"). */
     closeLabel?: string;
+    /** Default placeholder for the search input (falls back to "Search..."). */
+    searchPlaceholder?: string;
+    /** Default empty-state text when the filter matches nothing (falls back to "No results"). */
+    searchEmptyLabel?: string;
 };
 
 declare const MN_DROPDOWN_CONFIG: InjectionToken<MnDropdownUIConfig>;
@@ -3030,7 +3187,7 @@ declare const MN_DROPDOWN_CONFIG: InjectionToken<MnDropdownUIConfig>;
  * the multi-select applies.
  */
 declare class MnDropdown implements OnInit {
-    props: MnDropdownProps;
+    datasource: MnDropdownProps;
     protected uiConfig: MnDropdownUIConfig;
     private readonly configService;
     private readonly sectionPath;
@@ -3044,9 +3201,14 @@ declare class MnDropdown implements OnInit {
      *  `ElementRef` because `button[mnButton]` is a component — the default query would
      *  otherwise return the MnButton instance, which has no `nativeElement`. */
     triggerRef: ElementRef<HTMLElement>;
-    /** Layout classes for the anchored popover panel. The mobile sheet is rendered by
-     *  mn-bottom-sheet instead, so it needs no branch here. */
-    readonly panelClasses = "fixed z-9999 min-w-48 max-w-[min(20rem,90vw)] bg-base-100 border border-base-300 rounded-md shadow-lg py-1 max-h-[60vh] overflow-auto -translate-x-full";
+    /**
+     * Layout classes for the anchored popover panel. Searchable menus become a flex column
+     * so the search box can be pinned (`shrink-0`) above a single scrolling list region —
+     * paired with {@link panelFloorPx}, that keeps the popover a fixed height while the
+     * filter runs, instead of the panel resizing on every keystroke. The mobile sheet is
+     * rendered by mn-bottom-sheet instead, so it needs no branch here.
+     */
+    get panelClasses(): string;
     /** Tailwind's `sm` breakpoint — below this the menu renders as a bottom sheet.
      *  Kept in step with the same constant in mn-bottom-sheet / mn-multi-select. */
     private static readonly SHEET_MAX_WIDTH;
@@ -3062,11 +3224,30 @@ declare class MnDropdown implements OnInit {
     private sheetMediaListener;
     /** `document.body`'s inline `overflow` before the sheet locked it, restored on close. */
     private previousBodyOverflow;
+    /**
+     * The anchored popover's opened height, locked so a shorter filtered list cannot resize
+     * it mid-type. Captured on the frame after the panel appears (with the full, unfiltered
+     * list), so applying it is jump-free — it only stops a later shrink. Null while closed
+     * or when the menu is not searchable, leaving the plain content-height popover untouched.
+     */
+    panelFloorPx: number | null;
+    /**
+     * The mobile sheet's opened height, applied as a `min-height` floor for the same reason
+     * as {@link panelFloorPx} — mirroring mn-multi-select's sheet floor. Null while anchored,
+     * closed, or non-searchable.
+     */
+    sheetFloorPx: number | null;
     /** Watches the trigger while open, so the panel closes if the trigger is hidden. */
     private visibilityObserver;
     /** Capture-phase scroll listener installed while open, closing on any ancestor scroll. */
     private scrollCapture;
     isOpen: boolean;
+    /** Stable fallback id, used when {@link MnDropdownProps.id} is omitted. Generated once per
+     *  instance so the a11y wiring (menu id, `aria-controls`, the search input) stays valid. */
+    private readonly autoId;
+    /** Current text in the search input, cleared on close. Only meaningful when the menu
+     *  is {@link MnDropdownProps.searchable}. */
+    searchTerm: string;
     /** Popover position computed from the trigger's bounding rect. */
     dropdownStyle: {
         top: string;
@@ -3093,6 +3274,26 @@ declare class MnDropdown implements OnInit {
     get isSheet(): boolean;
     /** Fires an action and closes. Ignores disabled items defensively. */
     select(action: MnDropdownAction): void;
+    /** Whether the filter input is shown — the explicit `searchable` prop, off by default. */
+    get isSearchable(): boolean;
+    /**
+     * Records the current filter text as the search input changes. The input's
+     * ControlValueAccessor emits `null` for an empty field (its text adapter maps `''` to
+     * `null`), so coerce to `''` — otherwise clearing or backspacing the box would leave
+     * `searchTerm` null and {@link filteredActions}'s `.trim()` would throw, freezing the menu.
+     */
+    onSearch(term: string | null): void;
+    /**
+     * The actions currently passing the filter, in their declared order. Every action when
+     * the menu is not searchable or the box is empty; otherwise those whose resolved label
+     * or {@link MnDropdownAction.keywords} contain the (case-insensitive) query.
+     */
+    get filteredActions(): MnDropdownItem[];
+    /**
+     * Runs the first still-visible, enabled action — the Enter key's target, matching a
+     * help search where Enter opens the top hit. Skips separators. No-op when nothing matches.
+     */
+    selectFirstVisible(): void;
     private updateDropdownPosition;
     private startWatchingTrigger;
     private stopWatchingTrigger;
@@ -3101,6 +3302,20 @@ declare class MnDropdown implements OnInit {
     onWindowScrollOrResize(): void;
     private lockBodyScroll;
     private unlockBodyScroll;
+    /**
+     * Records the anchored popover's opened height and locks it via {@link panelFloorPx}.
+     * 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
+     * value equals the current height, so applying it is jump-free — it only stops a later,
+     * shorter filtered list from shrinking the panel.
+     */
+    private capturePanelFloor;
+    /**
+     * Records the sheet's opened height as its `min-height` floor, on the same next-frame
+     * basis as {@link capturePanelFloor}. `hostEl` is the portalled mn-bottom-sheet host
+     * (`display: contents`), so the height is read from its `.mn-sheet-container` child.
+     */
+    private captureSheetFloor;
     private portal;
     /** The label shown for an action, preferring a resolved translation key. */
     actionLabel(action: MnDropdownAction): string;
@@ -3112,6 +3327,16 @@ declare class MnDropdown implements OnInit {
      * @returns True when the icon is a template the caller owns.
      */
     isTemplateRef(value: unknown): value is TemplateRef<unknown>;
+    /** Whether a list entry is a {@link MnDropdownSeparator} rather than a command. */
+    isSeparator(item: MnDropdownItem): item is MnDropdownSeparator;
+    /**
+     * Narrows a list entry to a command, or null for a separator. Used as `@if (asAction(item);
+     * as action)` in the template so the item loop gets a reliably-typed {@link MnDropdownAction}
+     * without depending on template narrowing of the {@link isSeparator} guard.
+     * @param item The list entry to narrow.
+     * @returns The command, or null when the entry is a separator.
+     */
+    asAction(item: MnDropdownItem): MnDropdownAction | null;
     /**
      * Foreground class for an item: an explicit {@link MnDropdownAction.color}, else the
      * destructive red for a {@link MnDropdownAction.danger} item, else the default text.
@@ -3121,17 +3346,43 @@ declare class MnDropdown implements OnInit {
     get triggerAriaLabel(): string;
     /** The visible text on the trigger, or null for an icon-only ⋯ trigger. */
     get triggerLabelText(): string | null;
-    /** Which glyph the trigger renders: an explicit choice, else a chevron when the
-     *  trigger is labelled and the vertical dots when it is icon-only. */
-    get resolvedTriggerIcon(): 'dots-vertical' | 'dots-horizontal' | 'chevron' | 'none';
+    /**
+     * The trigger's glyph, normalised to a single representation so the template renders it
+     * one way — the same template-or-lucide-data path the menu items use — with no per-preset
+     * switch. Resolves, in order: an explicit `'none'` (no glyph); a caller's custom template
+     * or lucide data ({@link MnActionIcon}); otherwise a built-in preset mapped to its own
+     * lucide data (a labelled trigger defaults to the chevron, an icon-only one to the dots).
+     * @returns A template glyph, an icon-data glyph with its render size, or null for none.
+     */
+    private resolveTriggerGlyph;
+    /** The trigger glyph when it is a caller's template, else null. Split from
+     *  {@link triggerIconData} so the template narrows without a discriminated union. */
+    get triggerIconTemplate(): TemplateRef<unknown> | null;
+    /** The trigger glyph when it is lucide data (a preset or caller data), with its render
+     *  size and dim flag, else null. */
+    get triggerIconData(): {
+        data: LucideIconData;
+        size: number;
+        dim: boolean;
+    } | null;
     /** Heading shown above the menu/sheet, or null when none is configured. */
     get menuLabel(): string | null;
     /** Accessible label for the sheet's close button. */
     get closeLabel(): string;
+    /** Placeholder shown in the search input, preferring a resolved translation key. */
+    get searchPlaceholder(): string;
+    /** Text shown in place of the list when the filter matches no actions. */
+    get searchEmptyLabel(): string;
+    /** The ghost look the trigger has always used; a bare or partial `triggerButton` merges
+     *  over this, so opting in without overriding anything keeps the current appearance. */
+    private static readonly DEFAULT_TRIGGER_BUTTON;
+    /** mn-button config for the trigger: the ghost default, overlaid with any
+     *  {@link MnDropdownProps.triggerButton} the caller supplied. */
+    get triggerData(): Partial<MnButtonTypes>;
     get triggerClasses(): string;
     get resolvedId(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnDropdown, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MnDropdown, "mn-lib-dropdown", never, { "props": { "alias": "props"; "required": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnDropdown, "mn-lib-dropdown", never, { "datasource": { "alias": "datasource"; "required": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -4280,8 +4531,7 @@ type MnRowValue<T, V> = V | ((row: T) => V);
 /**
  * A per-row command rendered in an actions column (see {@link ColumnBase.actions}).
  * Unlike a cell it carries no display value — choosing it invokes {@link run} with the
- * row. The table renders actions inline as buttons and, when there are
- * {@link ColumnBase.actionsCollapseThreshold} or more, collapses them into a ⋯ menu
+ * row. The table renders actions inline as buttons and collapses them into a ⋯ menu
  * (mn-dropdown) once the table is narrower than 450px.
  */
 type MnTableRowAction<T> = {
@@ -4332,16 +4582,9 @@ type ColumnBase<T> = {
     /**
      * Turns this column into an actions column: per-row command buttons rendered inline,
      * automatically collapsing into a ⋯ menu (mn-dropdown) once the table is narrower than
-     * 450px **and** there are at least {@link actionsCollapseThreshold} actions. When set,
-     * {@link cell} is ignored.
+     * 450px. When set, {@link cell} is ignored.
      */
     actions?: MnTableRowAction<T>[];
-    /**
-     * Number of {@link actions} at or above which the inline buttons collapse to a ⋯ menu
-     * on a narrow table. Defaults to 3 — one or two buttons still fit on a phone, a longer
-     * list does not.
-     */
-    actionsCollapseThreshold?: number;
     /**
      * How each inline action button is presented on a wide table:
      * - `'both'` (default) — icon (when provided) followed by the label;
@@ -4709,14 +4952,6 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     visibleRowActions(column: ColumnDefinition<T>, row: T): MnTableRowAction<T>[];
     /** Whether a row has any visible actions at all; when false its cell is left empty. */
     hasRowActions(column: ColumnDefinition<T>, row: T): boolean;
-    /**
-     * Whether a row's actions should offer the collapsing ⋯ variant: only when it has at
-     * least its threshold's worth of *visible* actions (default 3). Below that, the inline
-     * buttons stay put at every width — one or two fit on a phone. The width switch itself
-     * is a pure container query in the template; this only decides whether to render the ⋯
-     * path at all, per row.
-     */
-    shouldCollapseActions(column: ColumnDefinition<T>, row: T): boolean;
     /**
      * Resolves a {@link MnRowValue}: either the fixed value, or the accessor applied to
      * the row. Every per-row presentation field goes through here so the fixed and derived
@@ -8494,4 +8729,4 @@ 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, MnDropdownProps, 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 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 };