mn-angular-lib 1.0.146 → 1.0.148

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "mn-angular-lib",
-  "version": "1.0.146",
+  "version": "1.0.148",
   "peerDependencies": {
     "@angular/common": "^21.1.3",
     "@angular/core": "^21.1.3",
+    "@lucide/angular": "^1.18.0",
     "quill": "^2.0.3"
   },
   "peerDependenciesMeta": {

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

@@ -2912,6 +2912,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 +2940,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. */
@@ -3091,6 +3104,14 @@ declare class MnDropdown implements OnInit {
     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>;
     /**
      * Foreground class for an item: an explicit {@link MnDropdownAction.color}, else the
      * destructive red for a {@link MnDropdownAction.danger} item, else the default text.
@@ -4245,6 +4266,17 @@ 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
@@ -4254,21 +4286,33 @@ type ColumnSkeleton = Partial<MnSkeletonProps> | TemplateRef<unknown>;
  */
 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;
-    /** 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;
     /**
      * 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;
+    color?: MnRowValue<T, MnDropdownActionColor>;
     /** Renders the action in a destructive style (e.g. "Delete"). Shorthand for
      *  `color: 'danger'`. */
     danger?: boolean;
@@ -4661,24 +4705,36 @@ 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;
+    /** 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;
     /**
-     * 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.
+     * 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>): 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;
     /**
@@ -4686,12 +4742,12 @@ 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). */
     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. */
@@ -8438,4 +8494,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, 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 };