mn-angular-lib 1.0.145 → 1.0.147

package/package.json

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

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

@@ -2848,9 +2848,9 @@ declare class MnMultiSelect implements OnInit {
 }
 
 /**
- * Layout variants for the ⋯ trigger button. Kept deliberately small: the trigger is
- * an icon affordance, so it only exposes the knobs a consumer realistically retunes
- * (size and border radius). Colour/hover come from the underlying mn-button.
+ * Layout variants for the trigger button. An icon-only trigger (the default ⋯) is a
+ * square affordance; a trigger with a text label grows to fit its content with
+ * horizontal padding instead. The `labeled` axis switches between the two.
  */
 declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
     size: {
@@ -2858,6 +2858,10 @@ declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
         md: string;
         lg: string;
     };
+    labeled: {
+        true: string;
+        false: string;
+    };
     borderRadius: {
         none: string;
         xs: string;
@@ -2867,12 +2871,16 @@ declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
         xl: string;
         full: string;
     };
-}, undefined, "inline-flex items-center justify-center text-base-content/70 cursor-pointer", {
+}, undefined, "inline-flex items-center justify-center gap-x-1.5 text-base-content/80 cursor-pointer", {
     size: {
         sm: string;
         md: string;
         lg: string;
     };
+    labeled: {
+        true: string;
+        false: string;
+    };
     borderRadius: {
         none: string;
         xs: string;
@@ -2888,6 +2896,10 @@ declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
         md: string;
         lg: string;
     };
+    labeled: {
+        true: string;
+        false: string;
+    };
     borderRadius: {
         none: string;
         xs: string;
@@ -2897,9 +2909,11 @@ declare const mnDropdownTriggerVariants: tailwind_variants.TVReturnType<{
         xl: string;
         full: string;
     };
-}, undefined, "inline-flex items-center justify-center text-base-content/70 cursor-pointer", unknown, unknown, undefined>>;
+}, 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>;
 
+/** Theme colour tokens an action item can be tinted with, mirroring mn-button's palette. */
+type MnDropdownActionColor = 'primary' | 'secondary' | 'danger' | 'warning' | 'success' | 'accent' | 'gray';
 /**
  * A single command in a {@link MnDropdownProps} menu. Unlike a select option it holds
  * no value — choosing it fires {@link run} and closes the menu. This is a *command*
@@ -2922,7 +2936,14 @@ type MnDropdownAction = {
     run: () => void;
     /** When true the item is shown dimmed and cannot be chosen. */
     disabled?: boolean;
-    /** Renders the item in a destructive style (e.g. a "Delete" action). */
+    /**
+     * Tints the item's label and icon. When omitted the item uses the default foreground
+     * ({@link danger} still forces the destructive red). Lets a host carry a per-item
+     * colour — e.g. an mn-table actions column keeps the same colours it shows inline.
+     */
+    color?: MnDropdownActionColor;
+    /** Renders the item in a destructive style (e.g. a "Delete" action). Shorthand for
+     *  the red foreground; equivalent to `color: 'danger'`. */
     danger?: boolean;
 };
 /**
@@ -2934,7 +2955,22 @@ type MnDropdownProps = {
     id: string;
     /** The commands rendered in the menu, in order. */
     actions: MnDropdownAction[];
-    /** Accessible label for the ⋯ trigger button. Falls back to a translated default. */
+    /**
+     * 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
+     * instead of the dots. Omit for the icon-only ⋯ trigger.
+     */
+    triggerLabel?: string;
+    /** Translation key for {@link triggerLabel}. Resolved via MnLanguageService. */
+    triggerLabelKey?: string;
+    /**
+     * 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';
+    /** Accessible label for the trigger button. Falls back to a translated default.
+     *  Ignored for name purposes when {@link triggerLabel} provides visible text. */
     ariaLabel?: string;
     /** Translation key for {@link ariaLabel}. Resolved via MnLanguageService. */
     ariaLabelKey?: string;
@@ -3055,8 +3091,18 @@ declare class MnDropdown implements OnInit {
     private portal;
     /** The label shown for an action, preferring a resolved translation key. */
     actionLabel(action: MnDropdownAction): string;
+    /**
+     * Foreground class for an item: an explicit {@link MnDropdownAction.color}, else the
+     * destructive red for a {@link MnDropdownAction.danger} item, else the default text.
+     */
+    actionColorClass(action: MnDropdownAction): string;
     /** Accessible name for the ⋯ trigger button. */
     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';
     /** Heading shown above the menu/sheet, or null when none is configured. */
     get menuLabel(): string | null;
     /** Accessible label for the sheet's close button. */
@@ -4215,9 +4261,23 @@ type MnTableRowAction<T> = {
     icon?: TemplateRef<unknown>;
     /** Invoked with the row when the action is chosen. */
     run: (row: T) => void;
-    /** Predicate deciding whether the action is disabled for a given row. */
+    /**
+     * Predicate deciding whether the action is hidden for a given row. A hidden action is
+     * dropped entirely for that row (not shown, not counted). When every action is hidden
+     * for a row its cell is left empty — no buttons and no ⋯ menu. Use this for "row 1 has
+     * actions, row 2 doesn't", or per-permission actions (e.g. only admins can delete).
+     */
+    hidden?: (row: T) => boolean;
+    /** Predicate deciding whether the action is disabled (shown but non-interactive) for a row. */
     disabled?: (row: T) => boolean;
-    /** Renders the action in a destructive style (e.g. "Delete"). */
+    /**
+     * Tints the action's button and its ⋯-menu item. Defaults to `'secondary'` (or
+     * `'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;
+    /** Renders the action in a destructive style (e.g. "Delete"). Shorthand for
+     *  `color: 'danger'`. */
     danger?: boolean;
 };
 /** Everything about a column that is independent of filtering. */
@@ -4245,6 +4305,18 @@ type ColumnBase<T> = {
      * 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;
+     * - `'icon'` — icon only; the label becomes the button's accessible name and hover
+     *   tooltip. An action without an icon falls back to showing its label so it is never
+     *   blank;
+     * - `'label'` — text only, no icon.
+     *
+     * The collapsed ⋯ menu always lists full labels regardless of this setting, so
+     * `'icon'` still reads clearly once the actions move into the bottom sheet on mobile.
+     */
+    actionsInline?: 'icon' | 'label' | 'both';
     /** Alternative cell renderer shown below the given breakpoint. When set, `cell` is hidden below this breakpoint and `cellSm` is shown instead. */
     cellSm?: {
         below: 'sm' | 'md' | 'lg';
@@ -4596,23 +4668,41 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     getCellValue(column: ColumnDefinition<T>, row: T): string;
     /** Returns the small-screen cell value for a column with cellSm defined. */
     getCellSmValue(column: ColumnDefinition<T>, row: T): string;
-    /**
-     * Whether an actions column should offer the collapsing ⋯ variant: only when it has at
-     * least its threshold's worth of 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.
-     */
-    shouldCollapseActions(column: ColumnDefinition<T>): boolean;
+    /** The actions visible for a given row — those whose `hidden(row)` is not true. */
+    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;
     /** The resolved label for an inline action button (translation key wins once resolved). */
     rowActionLabel(action: MnTableRowAction<T>): string;
+    /** Whether an inline action button should render its icon. */
+    showActionIcon(column: ColumnDefinition<T>, action: MnTableRowAction<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;
     /** Whether an action is disabled for the given row. */
     isRowActionDisabled(action: MnTableRowAction<T>, row: T): boolean;
+    /**
+     * The effective colour for an action, used identically by the inline button and the
+     * 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;
     /** 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). */
     actionsDropdownId(column: ColumnDefinition<T>, row: T): string;
-    /** Maps a column's actions to mn-dropdown commands, binding the row into each. */
+    /** Maps a row's visible actions to mn-dropdown commands, binding the row into each. */
     rowDropdownActions(column: ColumnDefinition<T>, row: T): MnDropdownAction[];
     trackByKey: (_index: number, column: ColumnDefinition<T>) => string;
     /** True when the table is narrower than the filter-collapse breakpoint. */
@@ -8359,4 +8449,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, 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, 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 };