mn-angular-lib 1.0.81 → 1.0.83

package/package.json

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

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

@@ -2451,6 +2451,13 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
     loadingMoreRows: boolean;
     currentPage: number;
     pageSize: number;
+    /**
+     * 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.
+     */
+    lockedMinHeight: number;
     protected readonly cdr: ChangeDetectorRef;
     protected readonly lang: MnLanguageService;
     /** Prefix used in validation error messages, e.g. `MnList`. Overridden by subclasses. */
@@ -2474,9 +2481,15 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
     /** Page-size options formatted for mn-select. */
     get pageSizeSelectOptions(): MnSelectOption<number>[];
     get visiblePages(): number[];
-    get skeletonRows(): number[];
+    /**
+     * Body container wrapping the skeleton/data swap region, used to measure its
+     * height for {@link lockBodyHeight}. Implemented by each component with a
+     * `@ViewChild('collectionBody')` so the template reference resolves there.
+     */
+    protected abstract collectionBody?: ElementRef<HTMLElement>;
     /** The toolbar template whose identity is watched in change detection. */
     protected abstract get trackedToolbarTemplate(): TemplateRef<unknown> | undefined;
+    get skeletonRows(): number[];
     ngOnInit(): void;
     ngDoCheck(): void;
     ngOnDestroy(): void;
@@ -2495,6 +2508,13 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
      * Subclasses override to resolve their own keys; call `super` to keep these.
      */
     protected resolveTranslationKeys(): void;
+    /**
+     * Captures the body container's current height into {@link lockedMinHeight} so it
+     * holds while a server reload swaps the data rows for skeletons. Must be called
+     * while the old rows are still rendered (before delegating to the consumer), and
+     * only locks when rows are present — the first load has nothing to preserve.
+     */
+    protected lockBodyHeight(): void;
     protected applyPagination(): void;
     /** Client-side search filtering shared by list and grid. */
     protected applySearchFilter(items: T[]): T[];
@@ -2641,6 +2661,7 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     columnFilters: ColumnFilterState;
     protected readonly componentName = "MnTable";
     protected get trackedToolbarTemplate(): TemplateRef<unknown> | undefined;
+    protected collectionBody?: ElementRef<HTMLElement>;
     /** Updates a column filter value and re-applies filtering. */
     onColumnFilter(columnKey: string, value: string): void;
     /** Filter options formatted for mn-select for a given column. */
@@ -4115,6 +4136,7 @@ declare class MnList<T = unknown> extends MnSelectableCollectionBase<T, ListData
     get skeletonLines(): Partial<MnSkeletonProps>[];
     onItemClick(item: T): void;
     protected get trackedToolbarTemplate(): TemplateRef<unknown> | undefined;
+    protected collectionBody?: ElementRef<HTMLElement>;
     protected applyFilter(searchForItems: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnList<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnList<any>, "mn-list", never, {}, { "itemClick": "itemClick"; }, never, never, true, never>;
@@ -4190,6 +4212,7 @@ declare class MnGrid<T = unknown> extends MnCollectionBase<T, GridDataSource<T>>
     /** Skeleton lines for the default/lines placeholder; null when a custom template is used. */
     get skeletonLines(): Partial<MnSkeletonProps>[];
     protected get trackedToolbarTemplate(): TemplateRef<unknown> | undefined;
+    protected collectionBody?: ElementRef<HTMLElement>;
     onItemClick(item: T): void;
     protected applyFilter(searchForItems: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnGrid<any>, never>;
@@ -4933,6 +4956,15 @@ 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.
+     * 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.
+     */
+    skeletonCount?: number;
 };
 
 /**
@@ -4956,6 +4988,11 @@ declare class MnTabComponent implements OnInit {
     activeChange: EventEmitter<MnTabItem>;
     /** The currently active tab item. */
     currentActive?: MnTabItem;
+    /**
+     * Index array sizing the loading skeleton: `skeletonCount` when provided,
+     * 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;
     /**