mn-angular-lib 1.0.3 → 1.0.5

package/package.json

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

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

@@ -1848,7 +1848,7 @@ interface TableDataSource<T> {
     searchPlaceholder?: string;
     isInSearch?: (row: T, searchValue: string) => boolean;
     searchForAdditionalItems?: (searchValue: string) => Promise<T[]>;
-    paginationMode?: 'none' | 'load-more' | 'paginated' | 'infinite-scroll';
+    paginationMode?: 'none' | 'load-more' | 'paginated' | 'client-side-pagination' | 'infinite-scroll';
     paginationStrategy?: PaginationStrategy;
     loadAdditionalRows?: () => Promise<T[]>;
     /** Number of rows per page when paginationMode is 'paginated'. Defaults to 10. */
@@ -1857,6 +1857,28 @@ interface TableDataSource<T> {
     pageSizeOptions?: number[];
     /** Callback invoked when the user changes the page size via the dropdown. */
     onPageSizeChange?: (newSize: number) => void;
+    /**
+     * Total number of items on the server.
+     * When set, pagination and infinite-scroll use this instead of filteredItems.length.
+     */
+    totalItems?: number;
+    /**
+     * Callback invoked when the user navigates to a different page.
+     * When provided, the table delegates pagination to the consumer (server-side).
+     * The consumer is responsible for fetching the new page data and updating dataRows.
+     */
+    onPageChange?: (page: number) => void;
+    /**
+     * Callback invoked when the user types in the search box (server-side search).
+     * When provided, the table skips client-side filtering and delegates to the consumer.
+     */
+    onServerSearch?: (searchValue: string) => void;
+    /**
+     * Callback invoked when the user scrolls to the bottom in infinite-scroll mode.
+     * When provided, the table delegates loading more rows to the consumer (server-side).
+     * The consumer is responsible for appending new data to dataRows.
+     */
+    onLoadMore?: () => void;
     defaultSort?: SortState;
     selectionMode?: 'none' | 'single' | 'multi';
     selectedRows?: BehaviorSubject<T[]>;
@@ -3163,9 +3185,9 @@ declare class MnTable<T = any> implements OnInit, OnDestroy, DoCheck {
      * by Angular's default change detection (e.g. toolbarTemplate).
      */
     ngDoCheck(): void;
-    ngOnInit(): void;
+    get showLoadMore(): boolean;
     ngOnDestroy(): void;
-    onSearch(searchString: string): void;
+    get isPaginated(): boolean;
     /** Whether any column has filtering enabled. */
     get hasColumnFilters(): boolean;
     /** Updates a column filter value and re-applies filtering. */
@@ -3180,10 +3202,16 @@ declare class MnTable<T = any> implements OnInit, OnDestroy, DoCheck {
     get hasSelection(): boolean;
     get isMultiSelect(): boolean;
     onRowClick(row: T): void;
-    loadMoreRows(): void;
-    get showLoadMore(): boolean;
-    get isPaginated(): boolean;
+    /** Whether the table delegates pagination to the consumer (server-side). */
+    get isServerPaginated(): boolean;
+    /** Whether the table delegates search to the consumer (server-side). */
+    get isServerSearched(): boolean;
+    /** Total number of items, accounting for server-side pagination. */
+    get totalItemCount(): number;
     get totalPages(): number;
+    ngOnInit(): void;
+    onSearch(searchString: string): void;
+    loadMoreRows(): void;
     get resolvedPageSizeOptions(): number[];
     goToPage(page: number): void;
     onPageSizeChange(newSize: number): void;
@@ -3199,6 +3227,7 @@ declare class MnTable<T = any> implements OnInit, OnDestroy, DoCheck {
     private applyFilterAndSort;
     private applySorting;
     private processLoadedRows;
+    private validateDataSource;
     private emitSelection;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnTable<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnTable<any>, "mn-table", never, { "dataSource": { "alias": "dataSource"; "required": false; }; }, { "sortChange": "sortChange"; "selectionChange": "selectionChange"; "rowClick": "rowClick"; }, never, never, true, never>;
@@ -3247,13 +3276,35 @@ interface ListDataSource<T> {
     searchPlaceholder?: string;
     isInSearch?: (row: T, searchValue: string) => boolean;
     searchForAdditionalItems?: (searchValue: string) => Promise<T[]>;
-    paginationMode?: 'none' | 'load-more' | 'paginated' | 'infinite-scroll';
+    paginationMode?: 'none' | 'load-more' | 'paginated' | 'client-side-pagination' | 'infinite-scroll';
     paginationStrategy?: PaginationStrategy;
     loadAdditionalRows?: () => Promise<T[]>;
     /** Number of items per page when paginationMode is 'paginated'. Defaults to 10. */
     pageSize?: number;
     /** Options for the page-size selector dropdown. Defaults to [5, 10, 25, 50]. */
     pageSizeOptions?: number[];
+    /** Callback invoked when the user changes the page size via the dropdown. */
+    onPageSizeChange?: (newSize: number) => void;
+    /**
+     * Total number of items on the server.
+     * When set, pagination and infinite-scroll use this instead of filteredItems.length.
+     */
+    totalItems?: number;
+    /**
+     * Callback invoked when the user navigates to a different page.
+     * When provided, the list delegates pagination to the consumer (server-side).
+     */
+    onPageChange?: (page: number) => void;
+    /**
+     * Callback invoked when the user types in the search box (server-side search).
+     * When provided, the list skips client-side filtering and delegates to the consumer.
+     */
+    onServerSearch?: (searchValue: string) => void;
+    /**
+     * Callback invoked when the user scrolls to the bottom in infinite-scroll mode.
+     * When provided, the list delegates loading more rows to the consumer (server-side).
+     */
+    onLoadMore?: () => void;
     selectionMode?: 'none' | 'single' | 'multi';
     selectedRows?: BehaviorSubject<T[]>;
     /** IDs to pre-select when the list initializes. */
@@ -3286,9 +3337,9 @@ declare class MnList<T = any> implements OnInit, OnDestroy, DoCheck {
     /** Tracks the previous toolbar template reference for change detection. */
     private previousToolbarTemplate?;
     ngDoCheck(): void;
-    ngOnInit(): void;
+    get showLoadMore(): boolean;
     ngOnDestroy(): void;
-    onSearch(searchString: string): void;
+    get isPaginated(): boolean;
     isSelected(item: T): boolean;
     toggleItem(item: T): void;
     toggleAll(): void;
@@ -3296,10 +3347,14 @@ declare class MnList<T = any> implements OnInit, OnDestroy, DoCheck {
     get hasSelection(): boolean;
     get isMultiSelect(): boolean;
     onItemClick(item: T): void;
-    loadMoreRows(): void;
-    get showLoadMore(): boolean;
-    get isPaginated(): boolean;
+    /** Whether the list is in server-side paginated mode (always true when paginated or load-more). */
+    get isServerPaginated(): boolean;
+    /** Total number of items, accounting for server-side pagination. */
+    get totalItemCount(): number;
     get totalPages(): number;
+    ngOnInit(): void;
+    onSearch(searchString: string): void;
+    loadMoreRows(): void;
     get resolvedPageSizeOptions(): number[];
     goToPage(page: number): void;
     onPageSizeChange(newSize: number): void;
@@ -3309,6 +3364,7 @@ declare class MnList<T = any> implements OnInit, OnDestroy, DoCheck {
     private applyPagination;
     private applyFilter;
     private processLoadedRows;
+    private validateDataSource;
     private emitSelection;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnList<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnList<any>, "mn-list", never, { "dataSource": { "alias": "dataSource"; "required": false; }; }, { "selectionChange": "selectionChange"; "itemClick": "itemClick"; }, never, never, true, never>;