@masterteam/client-components 0.0.90 → 0.0.91

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/client-components",
-  "version": "0.0.90",
+  "version": "0.0.91",
   "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/components": "^0.0.283",
-    "@masterteam/dashboard-builder": "^0.0.88",
+    "@masterteam/components": "^0.0.284",
     "@masterteam/forms": "^0.0.147",
+    "@masterteam/dashboard-builder": "^0.0.88",
     "@masterteam/icons": "^0.0.17"
   },
   "dependencies": {

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

@@ -158,12 +158,27 @@ interface ClientListTableDisplayConfig {
      * host explicitly opts in with `[]`.
      */
     persistStateExclude?: ClientListTablePersistStateKey[];
+    /**
+     * Column key the table starts grouped by — rows of the same value collapse
+     * under one header, and the column itself stops repeating in every row.
+     *
+     * A starting point, not a lock: the user can regroup or clear it from the
+     * table's own menu, and their choice then survives for the life of the list.
+     * Applied only when the list first appears, so a re-render never yanks the
+     * grouping back from under them.
+     *
+     * The key must name a column that is actually rendered, and grouping only
+     * makes sense once every row of a group is loaded — with backend paging a
+     * group is split across pages and each page grows its own header.
+     */
+    groupBy?: string;
 }
 interface NormalizedClientListTableDisplayConfig {
     pageSize: number;
     searchable: boolean;
     exportable: boolean;
     persistStateExclude: ClientListTablePersistStateKey[];
+    groupBy: string | null;
 }
 interface ClientListFormConfiguration extends ClientListBaseConfiguration {
     type?: 'form';
@@ -1060,8 +1075,19 @@ interface ClientListToolbarBucket {
     filters: WritableSignal<TableFilters>;
     filterTerm: WritableSignal<string>;
     groupBy: WritableSignal<string | null>;
+    /**
+     * Sort mirrored into `mt-table`. PrimeNG only renders group headers while
+     * the sort field *is* the grouped column, so a grouped list has to carry the
+     * matching sort or it silently renders as an ordinary flat table.
+     */
+    sortField: WritableSignal<string | null>;
+    sortDirection: WritableSignal<'asc' | 'desc' | null>;
     activeTab: WritableSignal<any>;
 }
+/** Initial toolbar state, applied only when a bucket is first created. */
+interface ClientListToolbarDefaults {
+    groupBy?: string | null;
+}
 /**
  * Per-list toolbar state holder. Buckets are keyed by list `key` (see
  * `ClientListBaseState.key`) so switching between table and cards for the same
@@ -1071,11 +1097,24 @@ interface ClientListToolbarBucket {
  */
 declare class ClientListToolbarService {
     private readonly buckets;
-    forList(key: string): ClientListToolbarBucket;
+    /**
+     * Lists whose defaults have been applied. Tracked apart from the bucket
+     * itself because the bucket can be created by whichever view renders first —
+     * the cards view asks for one without defaults — and seeding on creation
+     * alone would then lose them for good.
+     */
+    private readonly seeded;
+    /**
+     * `defaults` are applied once per list and ignored on every later call.
+     * Re-applying them would fight the user: a host that asks for an initial
+     * grouping would otherwise re-impose it on each render, so regrouping or
+     * clearing it from the table menu would never stick.
+     */
+    forList(key: string, defaults?: ClientListToolbarDefaults): ClientListToolbarBucket;
     clear(key: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientListToolbarService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientListToolbarService>;
 }
 
 export { CLIENT_LIST_DEFAULT_INCLUDE_STATE, CLIENT_LIST_RECORD_ID_FILTER_KEY, CLIENT_LIST_RECORD_SOURCE_KEY, CLIENT_LIST_RECORD_STATE_KEY, ClientList, ClientListApiService, ClientListRuntimeActionsService, ClientListStateService, ClientListToolbarService, defaultResolveRecordId, findClientListSourceGroup, findClientListTotal, isClientListTotalIncomplete, readClientListRowSource };
-export type { ClientListAreaType, ClientListBaseConfiguration, ClientListBaseState, ClientListCard, ClientListCardModule, ClientListCardProperty, ClientListCardsPayload, ClientListCardsState, ClientListClickableItem, ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListDataLoadedHandler, ClientListFetchCardDisplayOrderItem, ClientListFetchCardGroup, ClientListFetchCatalog, ClientListFetchHierarchyScope, ClientListFetchProjection, ClientListFetchProjectionMeta, ClientListFetchPropertyMeta, ClientListFetchQueryRequest, ClientListFetchQueryResponse, ClientListFetchRecord, ClientListFetchRecordSource, ClientListFetchRecordState, ClientListFetchRequestDisplay, ClientListFetchRequestFilter, ClientListFetchSchema, ClientListFetchSourceGroup, ClientListFetchStateKey, ClientListFetchSum, ClientListFetchTableColumn, ClientListFetchValueCell, ClientListFormConfiguration, ClientListInformativeChartLink, ClientListInformativeConfiguration, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListItemClickedEvent, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListRecordEscalationState, ClientListRecordProjectionStatus, ClientListRecordWriteResult, ClientListReturnRecordRequest, ClientListRowsFetchResult, ClientListRuntimeContext, ClientListRuntimeRecordActionsConfig, ClientListRuntimeRecordActionsContext, ClientListState, ClientListTableDisplayConfig, ClientListTablePersistStateKey, 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, ClientListFetchHierarchyScope, ClientListFetchProjection, ClientListFetchProjectionMeta, ClientListFetchPropertyMeta, ClientListFetchQueryRequest, ClientListFetchQueryResponse, ClientListFetchRecord, ClientListFetchRecordSource, ClientListFetchRecordState, ClientListFetchRequestDisplay, ClientListFetchRequestFilter, ClientListFetchSchema, ClientListFetchSourceGroup, ClientListFetchStateKey, ClientListFetchSum, ClientListFetchTableColumn, ClientListFetchValueCell, ClientListFormConfiguration, ClientListInformativeChartLink, ClientListInformativeConfiguration, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListItemClickedEvent, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListRecordEscalationState, ClientListRecordProjectionStatus, ClientListRecordWriteResult, ClientListReturnRecordRequest, ClientListRowsFetchResult, ClientListRuntimeContext, ClientListRuntimeRecordActionsConfig, ClientListRuntimeRecordActionsContext, ClientListState, ClientListTableDisplayConfig, ClientListTablePersistStateKey, ClientListTableQuery, ClientListTableSettingsCatalogResponse, ClientListTableSettingsColumn, ClientListTableState, ClientListTableTransform, ClientListTableTransformResult, ClientListToolbarBucket, ClientListToolbarDefaults, ClientListType, NormalizedClientListConfiguration, NormalizedClientListTableDisplayConfig, Response, RuntimeEntityColumnDef, RuntimeTableDisplayRow, RuntimeTableRowsResponse };