mn-angular-lib 1.0.92 → 1.0.94

package/package.json

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

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

@@ -2604,6 +2604,24 @@ type OffsetPaginationStrategy = {
     pageSize: number;
     totalItems?: number;
 } & PaginationStrategy;
+/**
+ * Lifecycle state of a collection's data, driving which chrome the component
+ * renders: skeleton placeholders ({@link LOADING}), the rows or empty state
+ * ({@link RETRIEVED}), or an error placeholder ({@link ERROR}).
+ *
+ * Preferred over the legacy boolean {@link MnCollectionDataSource.isDataLoading}.
+ * Because the components are zoneless, a consumer that flips `state` to `ERROR`
+ * (or `RETRIEVED`) must also emit on `dataRows` (e.g. `dataRows.next([])`) so the
+ * component runs change detection and re-reads the new state.
+ */
+declare enum MnCollectionState {
+    /** Data is being (re)loaded; skeleton placeholders are shown. */
+    LOADING = "LOADING",
+    /** Data has loaded (possibly empty); rows or the empty state are shown. */
+    RETRIEVED = "RETRIEVED",
+    /** Loading failed; the error placeholder is shown. */
+    ERROR = "ERROR"
+}
 type PaginationMode = 'none' | 'load-more' | 'paginated' | 'client-side-pagination' | 'infinite-scroll';
 type MnCollectionLabels = {
     loadMore?: string;
@@ -2628,9 +2646,25 @@ type MnCollectionDataSource<T> = {
     /** Translation key for the empty message. When set, the component resolves it via MnLanguageService. */
     emptyMessageKey?: string;
     emptyTemplate?: TemplateRef<unknown>;
-    isDataLoading: boolean;
+    /**
+     * Lifecycle state of the data. Preferred over {@link isDataLoading}; when set it
+     * fully controls loading / error / empty rendering. Defaults to RETRIEVED when
+     * neither `state` nor `isDataLoading` is provided.
+     */
+    state?: MnCollectionState;
+    /**
+     * @deprecated Use {@link state} instead. Legacy boolean loading flag, still
+     * honoured when {@link state} is not set (`true` ⇒ LOADING, `false` ⇒ RETRIEVED).
+     */
+    isDataLoading?: boolean;
     /** Number of placeholder rows rendered while data is loading. Defaults to 5. */
     skeletonRowCount?: number;
+    /** Message shown in the error placeholder when {@link state} is ERROR. */
+    errorMessage?: string;
+    /** Translation key for {@link errorMessage}; resolved via MnLanguageService. */
+    errorMessageKey?: string;
+    /** Custom template rendered in place of the default error placeholder. */
+    errorTemplate?: TemplateRef<unknown>;
     canSearch: boolean;
     searchPlaceholder?: string;
     /** Translation key for the search placeholder. When set, the component resolves it via MnLanguageService. */
@@ -2864,6 +2898,17 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
     /** Tracks the previous toolbar template reference for change detection. */
     private previousToolbarTemplate?;
     constructor();
+    /**
+     * Single source of truth for the data lifecycle: the explicit
+     * {@link MnCollectionDataSource.state} when provided, otherwise derived from the
+     * legacy {@link MnCollectionDataSource.isDataLoading} boolean. Every internal
+     * loading check routes through this so both APIs stay in lockstep.
+     */
+    get collectionState(): MnCollectionState;
+    /** Whether the collection is currently loading (skeleton placeholders shown). */
+    get isLoadingState(): boolean;
+    /** Whether loading failed (the error placeholder is shown instead of rows/empty). */
+    get isErrorState(): boolean;
     /** Whether the component delegates search to the consumer (server-side). */
     get isServerSearched(): boolean;
     get isPaginated(): boolean;
@@ -5464,7 +5509,7 @@ type MnTabDataSource = {
  * Tab component that renders a horizontal tab bar.
  * Supports translation keys for labels via MnTranslatePipe.
  */
-declare class MnTabComponent implements OnInit {
+declare class MnTabComponent implements DoCheck {
     /** Data source containing tab items and default active index. */
     dataSource: MnTabDataSource;
     /**
@@ -5486,18 +5531,32 @@ declare class MnTabComponent implements OnInit {
      * otherwise the number of known items, falling back to a default when none.
      */
     get skeletonTabs(): number[];
-    /** Initializes the default active tab based on the data source configuration. */
-    ngOnInit(): void;
     /**
-     * Returns the resolved badge value for a tab item, supporting both plain numbers and Signal<number>.
-     * @param item - The tab item whose badge to resolve.
+     * Re-resolves the active tab on every change-detection pass.
+     *
+     * The data source is often populated or rebuilt asynchronously (tabs that
+     * depend on fetched data or permissions). Resolving the active tab only once
+     * at init would leave {@link currentActive} pointing at a stale item — the
+     * tab bar would then highlight nothing and swallow the first click — so the
+     * selection is kept in sync with whatever the data source currently holds.
      */
-    getBadge(item: MnTabItem): number | undefined;
+    ngDoCheck(): void;
     /**
      * Sets the given tab item as active, invoking deactivate/activate callbacks.
      * @param item - The tab item to activate.
      */
     setActive(item: MnTabItem): void;
+    /**
+     * Returns the resolved badge value for a tab item, supporting both plain numbers and Signal<number>.
+     * @param item - The tab item whose badge to resolve.
+     */
+    getBadge(item: MnTabItem): number | undefined;
+    /**
+     * Ensures {@link currentActive} references a tab that still exists in the data
+     * source, falling back to the configured default tab when the current
+     * selection is missing or stale (e.g. after the items array is replaced).
+     */
+    private syncActiveTab;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnTabComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnTabComponent, "mn-tab", never, { "dataSource": { "alias": "dataSource"; "required": false; }; "scrollable": { "alias": "scrollable"; "required": false; }; "justified": { "alias": "justified"; "required": false; }; }, { "activeChange": "activeChange"; }, never, never, true, never>;
 }
@@ -6056,5 +6115,5 @@ type MnPreviewMessage = {
  */
 declare function enableMnPreviewMode(configService: MnConfigService, langService: MnLanguageService, allowedOrigins?: string[]): void;
 
-export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, 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, defaultTextAdapter, enableMnPreviewMode, isTranslatable, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig };
+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_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, 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, defaultTextAdapter, enableMnPreviewMode, isTranslatable, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig };
 export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DatetimeFieldConfig, 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, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPreviewMessage, MnQueryParams, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, 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 };