mn-angular-lib 1.0.147 → 1.0.149

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<{
@@ -2912,6 +3004,18 @@ declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
 }, undefined, "inline-flex items-center justify-center gap-x-1.5 text-base-content/80 cursor-pointer", unknown, unknown, undefined>>;
 type MnDropdownTriggerVariants = VariantProps<typeof mnDropdownTriggerVariants>;
 
+/**
+ * The leading icon of a command — either a `TemplateRef` (full control over the icon
+ * set: an `<mn-icon>`, an emoji, a bespoke `<svg>`) or lucide icon *data*, i.e. a
+ * lucide icon's static `.icon` (e.g. `LucidePencil.icon`), which the component renders
+ * itself at the right size for its slot.
+ *
+ * The data form exists so an action can be declared in plain TypeScript — a shared
+ * action factory, a config array, a service — without the host component having to
+ * carry an `<ng-template>` stub and a `@ViewChild` for every glyph. Same convention as
+ * {@link MnCollectionDataSource.emptyIcon}.
+ */
+type MnActionIcon = TemplateRef<unknown> | LucideIconData;
 /** Theme colour tokens an action item can be tinted with, mirroring mn-button's palette. */
 type MnDropdownActionColor = 'primary' | 'secondary' | 'danger' | 'warning' | 'success' | 'accent' | 'gray';
 /**
@@ -2928,10 +3032,11 @@ type MnDropdownAction = {
      */
     labelKey?: string;
     /**
-     * Optional leading icon, supplied as a template so the consumer keeps full control
-     * over which icon set is used (a lucide `<svg>`, an `<mn-icon>`, an emoji…).
+     * Optional leading icon: a template, so the consumer keeps full control over which
+     * icon set is used (an `<mn-icon>`, an emoji…), or lucide icon data such as
+     * `LucidePencil.icon` for a template-free declaration. See {@link MnActionIcon}.
      */
-    icon?: TemplateRef<unknown>;
+    icon?: MnActionIcon;
     /** Invoked when the item is chosen. The menu closes immediately afterwards. */
     run: () => void;
     /** When true the item is shown dimmed and cannot be chosen. */
@@ -2945,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;
 };
 /**
- * Configuration for {@link MnDropdown}. Everything is passed through the single
- * `props` input, mirroring mn-select / mn-multi-select.
+ * 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}, 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
@@ -2966,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;
@@ -2986,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'). */
@@ -3002,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>;
@@ -3017,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;
@@ -3031,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;
@@ -3049,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;
@@ -3080,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;
@@ -3088,9 +3302,41 @@ 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;
+    /**
+     * Whether an icon was supplied as a `TemplateRef` rather than lucide icon data, which
+     * decides how the template renders it. Kept as a method (not a pipe) so the narrowing
+     * is available inline in the item loop.
+     * @param value The icon to test.
+     * @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.
@@ -3100,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>;
 }
 
 /**
@@ -4245,20 +4517,35 @@ type MnColumnFilter = {
  * skeleton at 75% width is used (matching the previous default).
  */
 type ColumnSkeleton = Partial<MnSkeletonProps> | TemplateRef<unknown>;
+/**
+ * A presentation value that is either fixed for the whole column or derived per row.
+ *
+ * The function form is what lets one action cover a state that flips — an
+ * activate/deactivate toggle, a pin/unpin — instead of declaring two actions and hiding
+ * one of them per row. It is only for *presentation*: visibility stays with `hidden` and
+ * interactivity with `disabled`, both of which are always predicates.
+ *
+ * Resolved on every change detection, so the accessor must be cheap and side-effect free.
+ */
+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> = {
     /** Visible label. Falls back to `labelKey`'s resolved text when omitted. */
-    label?: string;
+    label?: MnRowValue<T, string>;
     /** Translation key for the label, resolved via MnLanguageService and kept updated on locale change. */
-    labelKey?: string;
-    /** Optional leading icon, supplied as a template (a lucide `<svg>`, an `<mn-icon>`, …). */
-    icon?: TemplateRef<unknown>;
+    labelKey?: MnRowValue<T, string>;
+    /**
+     * Optional leading icon: a template (an `<mn-icon>`, a bespoke `<svg>`, …), or lucide
+     * icon data such as `LucidePencil.icon`, which the table renders itself. The data form
+     * lets an action be declared without an `<ng-template>` stub and a `@ViewChild` per
+     * glyph, which is what makes shared action factories practical.
+     */
+    icon?: MnRowValue<T, MnActionIcon>;
     /** Invoked with the row when the action is chosen. */
     run: (row: T) => void;
     /**
@@ -4275,7 +4562,7 @@ type MnTableRowAction<T> = {
      * `'danger'` when {@link danger} is set), matching the built-in look. Whatever colour
      * an action shows inline is carried into the collapsed bottom-sheet item too.
      */
-    color?: MnDropdownActionColor;
+    color?: MnRowValue<T, MnDropdownActionColor>;
     /** Renders the action in a destructive style (e.g. "Delete"). Shorthand for
      *  `color: 'danger'`. */
     danger?: boolean;
@@ -4295,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;
@@ -4673,23 +4953,23 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     /** 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.
+     * 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
+     * forms can never drift apart.
      */
-    shouldCollapseActions(column: ColumnDefinition<T>, row: T): boolean;
+    private resolveRowValue;
     /** The resolved label for an inline action button (translation key wins once resolved). */
-    rowActionLabel(action: MnTableRowAction<T>): string;
+    rowActionLabel(action: MnTableRowAction<T>, row: T): string;
+    /** The resolved leading icon for an action on a given row, if it has one. */
+    rowActionIcon(action: MnTableRowAction<T>, row: T): MnActionIcon | undefined;
     /** Whether an inline action button should render its icon. */
-    showActionIcon(column: ColumnDefinition<T>, action: MnTableRowAction<T>): boolean;
+    showActionIcon(column: ColumnDefinition<T>, action: MnTableRowAction<T>, row: T): boolean;
     /**
      * Whether an inline action button should render its text label. In `'icon'` mode the
      * label is hidden — unless the action has no icon, in which case it is shown anyway so
      * the button is never blank.
      */
-    showActionLabel(column: ColumnDefinition<T>, action: MnTableRowAction<T>): boolean;
+    showActionLabel(column: ColumnDefinition<T>, action: MnTableRowAction<T>, row: T): boolean;
     /** Whether an action is disabled for the given row. */
     isRowActionDisabled(action: MnTableRowAction<T>, row: T): boolean;
     /**
@@ -4697,7 +4977,7 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
      * collapsed ⋯-menu item so the two never diverge: an explicit `color`, else `'danger'`
      * for a destructive action, else the default `'secondary'`.
      */
-    rowActionColor(action: MnTableRowAction<T>): MnDropdownActionColor;
+    rowActionColor(action: MnTableRowAction<T>, row: T): MnDropdownActionColor;
     /** Invokes an action for a row. */
     runRowAction(action: MnTableRowAction<T>, row: T): void;
     /** A stable, unique element id for a row's actions dropdown (aria wiring). */
@@ -8449,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, 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, 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 };