@masterteam/client-components 0.0.4 → 0.0.5

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

@@ -1,9 +1,13 @@
 import * as _angular_core from '@angular/core';
 import { TemplateRef, OnDestroy } from '@angular/core';
+import { DashboardBuilderData } from '@masterteam/dashboard-builder';
+import { EntityData, EntityConfiguration } from '@masterteam/components/entities';
 import { ColumnDef } from '@masterteam/components/table';
 import { Observable } from 'rxjs';
 
 type ClientListMode = 'auto' | 'override';
+type ClientListAreaType = 'table' | 'cards';
+type ClientListType = 'form' | 'informative';
 interface Response<T> {
     endpoint: string;
     status: number;
@@ -20,6 +24,8 @@ interface ClientListConfiguration {
     levelDataId?: number;
     moduleId?: number;
     title?: string;
+    type?: ClientListType;
+    areaType?: ClientListAreaType;
     mode?: ClientListMode;
     columnKeys?: string[];
     isPaginated?: boolean;
@@ -42,7 +48,7 @@ interface ClientListLayoutConfig {
     tableSpan?: number;
     endSpan?: number;
 }
-interface ClientListQuery {
+interface ClientListTableQuery {
     mode: ClientListMode;
     columnKeys?: string[];
     skip: number;
@@ -50,14 +56,33 @@ interface ClientListQuery {
 }
 interface RuntimeTableColumn {
     columnKey: string;
-    sourceType: number;
+    sourceType: string;
     order: number;
     isVisible: boolean;
-    configuration?: Record<string, unknown>;
+    id?: number;
+    propertyId?: number;
+    key?: string;
+    normalizedKey?: string;
+    name?: string;
+    viewType?: string;
+    configuration?: string;
+    type?: string;
 }
-interface RuntimeTableRow {
-    entityId: number;
-    values: Record<string, unknown>;
+/** Raw row as returned by the API, flat object keyed by column keys */
+type RuntimeTableApiRow = Record<string, unknown>;
+/** A single cell value enriched with its column metadata */
+interface RuntimeTableCell extends RuntimeTableColumn {
+    value: unknown;
+}
+/** Display row: Id stays plain, every other key holds a RuntimeTableCell */
+type RuntimeTableDisplayRow = Record<string, unknown | RuntimeTableCell>;
+/** Column definition extended with full runtime column metadata and forced entity type */
+interface RuntimeEntityColumnDef extends ColumnDef, Omit<RuntimeTableColumn, 'type'> {
+    key: string;
+    label: string;
+    /** Original API column type (e.g. CustomProperty) preserved as runtimeType */
+    runtimeType?: RuntimeTableColumn['type'];
+    type: 'entity';
 }
 interface RuntimeTablePagination {
     skip: number;
@@ -71,27 +96,109 @@ interface RuntimeTableRowsResponse {
     moduleKey: string;
     surfaceKey: string;
     columns: RuntimeTableColumn[];
-    rows: RuntimeTableRow[];
+    rows: RuntimeTableApiRow[];
     pagination: RuntimeTablePagination;
 }
-interface ClientListTableState {
+interface ClientListCardModule {
+    id: number;
+    key?: string;
+    name: string;
+    order?: number;
+    typeGroup?: string;
+}
+interface ClientListCardProperty {
+    id?: number;
+    propertyId?: number;
+    key: string;
+    normalizedKey: string;
+    name: string;
+    rawValue?: string;
+    value: EntityData['value'];
+    viewType: EntityData['viewType'];
+    configuration?: Record<string, unknown>;
+    type?: string;
+    [key: string]: unknown;
+}
+interface ClientListCard {
+    id: number;
+    name: string;
+    module?: ClientListCardModule;
+    levelDataId?: number;
+    properties: ClientListCardProperty[];
+    displayProperties?: Record<string, unknown>;
+    entities: EntityData[];
+}
+interface ClientListCardDisplayProperty {
+    propertyKey: string;
+    areaKey: string;
+    order: number;
+    configuration: EntityConfiguration;
+}
+interface ClientListCardDisplayConfiguration {
+    contextKey: string;
+    moduleId?: number;
+    levelId?: number;
+    properties: ClientListCardDisplayProperty[];
+}
+interface ClientListCardsDetailsBlock {
+    module?: ClientListCardModule;
+    data: Omit<ClientListCard, 'entities'>[];
+}
+interface ClientListCardsPayload {
+    details?: ClientListCardsDetailsBlock[];
+    displayConfigurations?: ClientListCardDisplayConfiguration[];
+}
+interface ClientListInformativeChartLink {
+    id?: number;
+    chartComponentId?: string;
+    configuration?: Record<string, any>;
+    order?: number;
+}
+interface ClientListInformativeDashboardPayload {
+    moduleId: number;
+    ignoreQueryFilter: boolean;
+    filters: Record<string, any>;
+    extraInfo: Record<string, any>;
+    versionNumber: number;
+    chartLinks: ClientListInformativeChartLink[];
+}
+interface ClientListBaseState {
     key: string;
     config: NormalizedClientListConfiguration;
+    type: ClientListType;
+    areaType: ClientListAreaType;
     loading: boolean;
     error: string | null;
     title: string;
     moduleKey: string;
-    columns: ColumnDef[];
-    rows: RuntimeTableRow[];
+    totalCount: number;
+    columns: RuntimeEntityColumnDef[];
+    rows: RuntimeTableDisplayRow[];
+    cards: ClientListCard[];
     skip: number;
     take: number;
-    totalCount: number;
     expanded: boolean;
+    dashboardData: DashboardBuilderData | null;
+}
+interface ClientListTableState extends ClientListBaseState {
+    type: 'form';
+    areaType: 'table';
+}
+interface ClientListCardsState extends ClientListBaseState {
+    type: 'form';
+    areaType: 'cards';
+}
+interface ClientListInformativeState extends ClientListBaseState {
+    type: 'informative';
+    areaType: 'table';
 }
+type ClientListState = ClientListTableState | ClientListCardsState | ClientListInformativeState;
 interface NormalizedClientListConfiguration {
     levelId: number;
     levelDataId: number;
     moduleId: number;
+    type: ClientListType;
+    areaType: ClientListAreaType;
     mode: ClientListMode;
     isPaginated: boolean;
     take: number;
@@ -105,8 +212,8 @@ interface NormalizedClientListConfiguration {
     contentEnd?: TemplateRef<ClientListContentTemplateContext>;
 }
 interface ClientListContentTemplateContext {
-    $implicit: ClientListTableState;
-    table: ClientListTableState;
+    $implicit: ClientListState;
+    table: ClientListState;
 }
 interface ClientListLazyLoadEvent {
     pageSize?: number;
@@ -115,14 +222,30 @@ interface ClientListLazyLoadEvent {
 }
 
 declare class ClientListStateService {
-    readonly tablesByKey: _angular_core.WritableSignal<Record<string, ClientListTableState>>;
-    readonly tables: _angular_core.Signal<ClientListTableState[]>;
-    setConfigs(configs: ClientListTableState[]): void;
+    readonly itemsByKey: _angular_core.WritableSignal<Record<string, ClientListState>>;
+    readonly items: _angular_core.Signal<ClientListState[]>;
+    setConfigs(configs: ClientListState[]): void;
     setLoading(key: string, loading: boolean): void;
     setError(key: string, message: string | null): 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;
     toggleExpanded(key: string): void;
+    private mergeItemState;
+    private getVisibleColumns;
     private toColumnDefs;
+    /**
+     * Enriches each flat API row so that every cell value becomes a
+     * RuntimeTableCell carrying both the original value and the full
+     * column metadata.  The `Id` key is preserved as-is.
+     */
+    private toDisplayRows;
+    private toCell;
+    private toCards;
+    private toDashboardData;
+    private buildDisplayConfigurationLookup;
+    private mapEntities;
+    private getPropertyConfiguration;
     private toLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientListStateService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientListStateService>;
@@ -138,40 +261,51 @@ declare class ClientList implements OnDestroy {
         key: string;
         message: string;
     }>;
-    protected readonly tables: _angular_core.Signal<ClientListTableState[]>;
-    protected readonly gridTemplateColumns = "repeat(12, minmax(0, 1fr))";
+    protected readonly items: _angular_core.Signal<ClientListState[]>;
     private readonly subscriptions;
     private readonly inFlightRequestSignatures;
     private readonly fulfilledRequestSignatures;
     constructor();
-    onLazyLoad(tableKey: string, event: ClientListLazyLoadEvent): void;
-    reload(tableKey?: string): void;
-    reloadByKey(tableKey: string): void;
+    onLazyLoad(itemKey: string, event: ClientListLazyLoadEvent): void;
+    reload(itemKey?: string): void;
+    reloadByKey(itemKey: string): void;
     toggleExpanded(key: string): void;
-    slotGridSpan(span: number): string;
-    templateContext(table: ClientListTableState): ClientListContentTemplateContext;
+    templateContext(item: ClientListState): ClientListContentTemplateContext;
+    defaultTitle(item: ClientListState): string;
     ngOnDestroy(): void;
-    private configureTables;
+    private configureItems;
+    private loadItem;
     private loadTable;
+    private loadCards;
+    private loadInformative;
+    private resolveAreaType;
+    private resolveType;
     private resolveMode;
     private toNormalizedConfig;
     private resolveLayout;
     private clampSpan;
     private cleanupStaleResources;
-    private toQuery;
-    private createRequestSignature;
+    private toTableQuery;
+    private createTableRequestSignature;
+    private createCardsRequestSignature;
+    private createInformativeRequestSignature;
     private hasValidIdentifiers;
+    private getMissingIdentifiersMessage;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientList, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClientList, "mt-client-list", never, { "configurations": { "alias": "configurations"; "required": true; "isSignal": true; }; "defaultTake": { "alias": "defaultTake"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "errored": "errored"; }, never, never, true, never>;
 }
 
 declare class ClientListApiService {
     private readonly http;
-    private readonly baseUrl;
-    getRows(levelId: number, levelDataId: number, moduleId: number, query: ClientListQuery): Observable<Response<RuntimeTableRowsResponse>>;
+    private readonly tablesBaseUrl;
+    private readonly cardsBaseUrl;
+    private readonly informativeBaseUrl;
+    getRows(levelId: number, levelDataId: number, moduleId: number, query: ClientListTableQuery): Observable<Response<RuntimeTableRowsResponse>>;
+    getCards(levelDataId: number, moduleId: number): Observable<Response<ClientListCardsPayload>>;
+    getInformativeDashboard(moduleId: number): Observable<Response<ClientListInformativeDashboardPayload>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientListApiService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientListApiService>;
 }
 
 export { ClientList, ClientListApiService, ClientListStateService };
-export type { ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListQuery, ClientListTableState, NormalizedClientListConfiguration, Response, RuntimeTableColumn, RuntimeTablePagination, RuntimeTableRow, RuntimeTableRowsResponse };
+export type { ClientListAreaType, ClientListBaseState, ClientListCard, ClientListCardDisplayConfiguration, ClientListCardDisplayProperty, ClientListCardModule, ClientListCardProperty, ClientListCardsDetailsBlock, ClientListCardsPayload, ClientListCardsState, ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListInformativeChartLink, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListState, ClientListTableQuery, ClientListTableState, ClientListType, NormalizedClientListConfiguration, Response, RuntimeEntityColumnDef, RuntimeTableApiRow, RuntimeTableCell, RuntimeTableColumn, RuntimeTableDisplayRow, RuntimeTablePagination, RuntimeTableRowsResponse };