@masterteam/client-components 0.0.53 → 0.0.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/client-components",
-  "version": "0.0.53",
+  "version": "0.0.55",
   "publishConfig": {
     "directory": "../../../dist/masterteam/client-components",
     "linkDirectory": true,
@@ -16,9 +16,9 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/forms": "^0.0.108",
-    "@masterteam/components": "^0.0.213",
-    "@masterteam/dashboard-builder": "^0.0.40",
+    "@masterteam/forms": "^0.0.109",
+    "@masterteam/dashboard-builder": "^0.0.51",
+    "@masterteam/components": "^0.0.216",
     "@masterteam/icons": "^0.0.17"
   },
   "dependencies": {

package/types/masterteam-client-components-client-list.d.ts

@@ -10,6 +10,7 @@ import { Observable } from 'rxjs';
 type ClientListMode = 'auto' | 'override';
 type ClientListAreaType = 'table' | 'cards';
 type ClientListType = 'form' | 'informative';
+type ClientListTablePersistStateKey = 'pageSize' | 'pagePosition' | 'sort' | 'selection' | 'groupBy';
 interface Response<T> {
     endpoint: string;
     status: number;
@@ -108,11 +109,18 @@ interface ClientListTableDisplayConfig {
     pageSize?: number;
     searchable?: boolean;
     exportable?: boolean;
+    /**
+     * mt-table storage keys to exclude when this list provides a storageKey.
+     * Defaults to `['pagePosition']`, so current page is not restored unless the
+     * host explicitly opts in with `[]`.
+     */
+    persistStateExclude?: ClientListTablePersistStateKey[];
 }
 interface NormalizedClientListTableDisplayConfig {
     pageSize: number;
     searchable: boolean;
     exportable: boolean;
+    persistStateExclude: ClientListTablePersistStateKey[];
 }
 interface ClientListFormConfiguration extends ClientListBaseConfiguration {
     type?: 'form';
@@ -122,8 +130,21 @@ interface ClientListFormConfiguration extends ClientListBaseConfiguration {
     filters?: ClientListFetchRequestFilter[];
     mode?: ClientListMode;
     columnKeys?: string[];
+    /**
+     * Defaults to true. Paginated tables use backend page/pageSize requests and
+     * render a paginator. Set false only for bounded local datasets that should
+     * render through virtual scroll.
+     */
     isPaginated?: boolean;
+    /**
+     * Backend page size when `isPaginated` is true. For local virtual-scroll
+     * tables (`isPaginated: false`), this is the explicit fetch cap.
+     */
     take?: number;
+    /**
+     * Presentation settings. `pageSize` controls visible table rows/paginator
+     * size; it is not used as the local fetch cap when `isPaginated` is false.
+     */
     table?: ClientListTableDisplayConfig;
     /**
      * Host hook to reshape built columns/rows before render — see
@@ -406,6 +427,7 @@ declare class ClientListStateService {
     setConfigs(configs: ClientListState[]): void;
     setLoading(key: string, loading: boolean): void;
     setError(key: string, message: string | null): void;
+    setTablePaging(key: string, skip: number, take: number): void;
     setRowsResult(key: string, response: RuntimeTableRowsResponse, config: NormalizedClientListConfiguration, skip: number, take: number): void;
     setCardsResult(key: string, response: ClientListCardsPayload, config: NormalizedClientListConfiguration): void;
     setInformativeResult(key: string, response: ClientListInformativeDashboardPayload | null, config: NormalizedClientListConfiguration): void;
@@ -494,6 +516,8 @@ declare class ClientList implements OnDestroy {
     private resolveTableDisplayConfig;
     private clampSpan;
     private resolvePositiveInteger;
+    private resolveDefaultTake;
+    private resolveNonNegativeInteger;
     private cleanupStaleResources;
     private notifyDataLoaded;
     private maybeEagerLoadRuntimeActions;
@@ -593,4 +617,4 @@ declare class ClientListToolbarService {
 }
 
 export { ClientList, ClientListApiService, ClientListRuntimeActionsService, ClientListStateService, ClientListToolbarService, defaultResolveRecordId };
-export type { ClientListAreaType, ClientListBaseConfiguration, ClientListBaseState, ClientListCard, ClientListCardModule, ClientListCardProperty, ClientListCardsPayload, ClientListCardsState, ClientListClickableItem, ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListDataLoadedHandler, ClientListFetchCardDisplayOrderItem, ClientListFetchCardGroup, ClientListFetchCatalog, ClientListFetchProjection, ClientListFetchProjectionMeta, ClientListFetchPropertyMeta, ClientListFetchQueryRequest, ClientListFetchQueryResponse, ClientListFetchRecord, ClientListFetchRequestDisplay, ClientListFetchRequestFilter, ClientListFetchSchema, ClientListFetchTableColumn, ClientListFetchValueCell, ClientListFormConfiguration, ClientListInformativeChartLink, ClientListInformativeConfiguration, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListItemClickedEvent, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListRuntimeContext, ClientListRuntimeRecordActionsConfig, ClientListRuntimeRecordActionsContext, ClientListState, ClientListTableDisplayConfig, ClientListTableQuery, ClientListTableSettingsCatalogResponse, ClientListTableSettingsColumn, ClientListTableState, ClientListTableTransform, ClientListTableTransformResult, ClientListToolbarBucket, ClientListType, NormalizedClientListConfiguration, NormalizedClientListTableDisplayConfig, Response, RuntimeEntityColumnDef, RuntimeTableDisplayRow, RuntimeTableRowsResponse };
+export type { ClientListAreaType, ClientListBaseConfiguration, ClientListBaseState, ClientListCard, ClientListCardModule, ClientListCardProperty, ClientListCardsPayload, ClientListCardsState, ClientListClickableItem, ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListDataLoadedHandler, ClientListFetchCardDisplayOrderItem, ClientListFetchCardGroup, ClientListFetchCatalog, ClientListFetchProjection, ClientListFetchProjectionMeta, ClientListFetchPropertyMeta, ClientListFetchQueryRequest, ClientListFetchQueryResponse, ClientListFetchRecord, ClientListFetchRequestDisplay, ClientListFetchRequestFilter, ClientListFetchSchema, ClientListFetchTableColumn, ClientListFetchValueCell, ClientListFormConfiguration, ClientListInformativeChartLink, ClientListInformativeConfiguration, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListItemClickedEvent, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListRuntimeContext, ClientListRuntimeRecordActionsConfig, ClientListRuntimeRecordActionsContext, ClientListState, ClientListTableDisplayConfig, ClientListTablePersistStateKey, ClientListTableQuery, ClientListTableSettingsCatalogResponse, ClientListTableSettingsColumn, ClientListTableState, ClientListTableTransform, ClientListTableTransformResult, ClientListToolbarBucket, ClientListType, NormalizedClientListConfiguration, NormalizedClientListTableDisplayConfig, Response, RuntimeEntityColumnDef, RuntimeTableDisplayRow, RuntimeTableRowsResponse };