mn-angular-lib 1.0.93 → 1.0.95

package/package.json

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

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

@@ -2604,6 +2604,23 @@ 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}).
+ *
+ * Because the components are zoneless and OnPush, 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 +2645,19 @@ 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, controlling loading / error / empty rendering.
+     * Defaults to {@link MnCollectionState.RETRIEVED} when not set.
+     */
+    state?: MnCollectionState;
     /** 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. */
@@ -2839,7 +2866,7 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
      * Measured pixel height of the body container, applied as a `min-height` floor
      * while a server reload is in flight so the container can't collapse when the
      * data rows are swapped for skeletons. Released in {@link ngDoCheck} the moment
-     * `isDataLoading` clears. `0` means no lock.
+     * the loading state clears. `0` means no lock.
      */
     lockedMinHeight: number;
     /**
@@ -2864,6 +2891,16 @@ 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}, defaulting to RETRIEVED when unset.
+     * Every internal loading check routes through this.
+     */
+    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;
@@ -5449,10 +5486,13 @@ type MnTabDataSource = {
     items: MnTabItem[];
     /** Index of the tab that should be active by default. */
     defaultActive: number;
-    /** When true, the tab bar renders a loading skeleton instead of the real tabs. */
-    isDataLoading?: boolean;
     /**
-     * Number of placeholder tabs to render while {@link isDataLoading} is true.
+     * Lifecycle state of the tab set. When {@link MnCollectionState.LOADING} the tab
+     * bar renders a loading skeleton; any other state renders the real tabs.
+     */
+    state?: MnCollectionState;
+    /**
+     * Number of placeholder tabs to render while {@link state} is LOADING.
      * Defaults to the number of known `items`, falling back to 3 when no items are
      * known yet. Set this only when the real tabs are not yet known at load time
      * (e.g. tabs that depend on data being fetched) to predict the final count.
@@ -5481,6 +5521,11 @@ declare class MnTabComponent implements DoCheck {
     activeChange: EventEmitter<MnTabItem>;
     /** The currently active tab item. */
     currentActive?: MnTabItem;
+    /**
+     * Whether the tab bar is loading and should render skeleton tabs, from
+     * {@link MnTabDataSource.state}.
+     */
+    get isLoadingState(): boolean;
     /**
      * Index array sizing the loading skeleton: `skeletonCount` when provided,
      * otherwise the number of known items, falling back to a default when none.
@@ -6070,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 };