@masterteam/client-components 0.0.9 → 0.0.10

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

@@ -18,19 +18,11 @@ interface Response<T> {
     data: T;
     cacheSession?: string;
 }
-interface ClientListConfiguration {
+type ClientListRuntimeContext = string;
+interface ClientListBaseConfiguration {
     key?: string;
-    levelId?: number;
-    levelDataId?: number;
-    moduleId?: number;
     title?: string;
     showHeader?: boolean;
-    type?: ClientListType;
-    areaType?: ClientListAreaType;
-    mode?: ClientListMode;
-    columnKeys?: string[];
-    isPaginated?: boolean;
-    take?: number;
     collapse?: ClientListCollapseConfig;
     layout?: ClientListLayoutConfig;
     headerStart?: TemplateRef<ClientListContentTemplateContext>;
@@ -41,6 +33,22 @@ interface ClientListConfiguration {
     rowActions?: TableAction[];
     dataLoaded?: ClientListDataLoadedHandler;
 }
+interface ClientListFormConfiguration extends ClientListBaseConfiguration {
+    type?: 'form';
+    areaType?: ClientListAreaType;
+    contextKey: ClientListRuntimeContext;
+    instanceId?: number;
+    mode?: ClientListMode;
+    columnKeys?: string[];
+    isPaginated?: boolean;
+    take?: number;
+}
+interface ClientListInformativeConfiguration extends ClientListBaseConfiguration {
+    type: 'informative';
+    moduleId: number;
+    areaType?: 'table';
+}
+type ClientListConfiguration = ClientListFormConfiguration | ClientListInformativeConfiguration;
 interface ClientListCollapseConfig {
     enabled?: boolean;
     expandedByDefault?: boolean;
@@ -58,100 +66,134 @@ interface ClientListTableQuery {
     skip: number;
     take: number;
 }
-interface RuntimeTableColumn {
-    columnKey: string;
-    sourceType: string;
-    order: number;
-    isVisible: boolean;
-    id?: number;
-    propertyId?: number;
+type ClientListFetchProjection = 'Card' | 'Table';
+interface ClientListFetchRequestFilter {
+    key: string;
+    operator: 'Equals';
+    value: string;
+}
+interface ClientListFetchRequestDisplay {
+    areas: string[];
+}
+interface ClientListFetchQueryRequest {
+    contextKey: string;
+    projection: ClientListFetchProjection;
+    propertyKeys?: string[];
+    filters?: ClientListFetchRequestFilter[];
+    page?: number;
+    pageSize?: number;
+    surfaceKey?: string;
+    display?: ClientListFetchRequestDisplay;
+}
+interface ClientListTableSettingsColumn {
     key?: string;
-    normalizedKey?: string;
-    name?: string;
-    viewType?: string;
-    configuration?: string;
-    type?: string;
+    propertyKey?: string;
+    order?: number;
+    visible?: boolean;
 }
-/** 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;
+interface ClientListTableSettingsCatalogResponse {
+    effectiveColumns?: Array<ClientListTableSettingsColumn | string>;
 }
-/** 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'> {
+interface ClientListFetchPropertyMeta {
+    id: number;
     key: string;
+    normalizedKey: string;
     label: string;
-    /** Original API column type (e.g. CustomProperty) preserved as runtimeType */
-    runtimeType?: RuntimeTableColumn['type'];
-    type: 'entity';
+    viewType: string;
+    configuration: Record<string, unknown> | null;
+    source?: string;
+    order: number;
+    isRequired?: boolean;
+    isSystem?: boolean;
 }
-interface RuntimeTablePagination {
-    skip: number;
-    take: number;
-    totalCount: number;
+interface ClientListFetchValueCell {
+    raw: unknown;
+    value: unknown;
+    display?: string | null;
+    [key: string]: unknown;
 }
-interface RuntimeTableRowsResponse {
-    levelId: number;
-    levelDataId: number;
-    moduleId: number;
-    moduleKey: string;
-    surfaceKey: string;
-    columns: RuntimeTableColumn[];
-    rows: RuntimeTableApiRow[];
-    pagination: RuntimeTablePagination;
+interface ClientListFetchRecord {
+    id: number;
+    name?: string;
+    schemaId?: number;
+    values: Record<string, ClientListFetchValueCell>;
 }
-interface ClientListCardModule {
+interface ClientListFetchSchema {
     id: number;
-    key?: string;
+    key: string;
     name: string;
     order?: number;
     typeGroup?: string;
 }
-interface ClientListCardProperty {
-    id?: number;
-    propertyId?: number;
+interface ClientListFetchCatalog {
+    properties: ClientListFetchPropertyMeta[];
+}
+interface ClientListFetchTableColumn {
     key: string;
-    normalizedKey: string;
+    label: string;
+    viewType: string;
+    order: number;
+    visible: boolean;
+    configuration: Record<string, unknown> | null;
+}
+interface ClientListFetchCardDisplayOrderItem {
+    contextKey: string;
+    areaKey: string;
+    propertyKey: string;
+    order: number;
+    configuration?: EntityConfiguration | null;
+}
+interface ClientListFetchCardGroup {
+    schemaId: number;
+    recordIds: number[];
+}
+interface ClientListFetchProjectionMeta {
+    kind: string;
+    columns?: ClientListFetchTableColumn[];
+    displayOrder?: ClientListFetchCardDisplayOrderItem[];
+    groups?: ClientListFetchCardGroup[];
+}
+interface ClientListFetchQueryResponse {
+    contextKey: string;
+    schemas?: ClientListFetchSchema[];
+    catalog?: ClientListFetchCatalog;
+    records?: ClientListFetchRecord[];
+    pagination?: {
+        page: number;
+        pageSize: number;
+        totalCount: number;
+    };
+    projectionMeta?: ClientListFetchProjectionMeta;
+}
+interface RuntimeEntityColumnDef extends ColumnDef {
+    key: string;
+    label: string;
+    type: 'entity';
+    viewType?: string;
+    order?: number;
+    visible?: boolean;
+    configuration?: Record<string, unknown> | null;
+}
+type RuntimeTableDisplayRow = Record<string, unknown | EntityData>;
+type RuntimeTableRowsResponse = ClientListFetchQueryResponse;
+interface ClientListCardModule {
+    id: number;
+    key?: string;
     name: string;
-    rawValue?: string;
-    value: EntityData['value'];
-    viewType: EntityData['viewType'];
-    configuration?: Record<string, unknown>;
-    type?: string;
-    [key: string]: unknown;
+    order?: number;
+    typeGroup?: string;
 }
+type ClientListCardProperty = EntityData;
 interface ClientListCard {
     id: number;
     name: string;
     module?: ClientListCardModule;
-    levelDataId?: number;
+    instanceId?: 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[];
-}
+type ClientListCardsPayload = ClientListFetchQueryResponse;
 interface ClientListInformativeChartLink {
     id?: number;
     chartComponentId?: string;
@@ -198,9 +240,16 @@ interface ClientListInformativeState extends ClientListBaseState {
     areaType: 'table';
 }
 type ClientListState = ClientListTableState | ClientListCardsState | ClientListInformativeState;
+type ClientListClickableItem = RuntimeTableDisplayRow | ClientListCard;
+interface ClientListItemClickedEvent {
+    key: string;
+    areaType: 'table' | 'cards';
+    item: ClientListClickableItem;
+    state: ClientListState;
+}
 interface NormalizedClientListConfiguration {
-    levelId: number;
-    levelDataId: number;
+    contextKey: ClientListRuntimeContext | null;
+    instanceId: number | null;
     moduleId: number;
     type: ClientListType;
     areaType: ClientListAreaType;
@@ -246,21 +295,10 @@ declare class ClientListStateService {
     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 orderRecords;
+    private toEntityData;
     private toDashboardData;
-    private buildDisplayConfigurationLookup;
-    private mapEntities;
-    private getPropertyConfiguration;
-    private toLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientListStateService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientListStateService>;
 }
@@ -275,6 +313,7 @@ declare class ClientList implements OnDestroy {
         key: string;
         message: string;
     }>;
+    readonly itemClicked: _angular_core.OutputEmitterRef<ClientListItemClickedEvent>;
     protected readonly items: _angular_core.Signal<ClientListState[]>;
     private readonly subscriptions;
     private readonly inFlightRequestSignatures;
@@ -284,6 +323,8 @@ declare class ClientList implements OnDestroy {
     reload(itemKey?: string): void;
     reloadByKey(itemKey: string): void;
     toggleExpanded(key: string): void;
+    onTableRowClick(item: ClientListState, row: RuntimeTableDisplayRow): void;
+    onCardClick(item: ClientListState, card: ClientListCard): void;
     templateContext(item: ClientListState): ClientListContentTemplateContext;
     defaultTitle(item: ClientListState): string;
     ngOnDestroy(): void;
@@ -296,6 +337,7 @@ declare class ClientList implements OnDestroy {
     private resolveType;
     private resolveMode;
     private toNormalizedConfig;
+    private createItemKey;
     private resolveLayout;
     private clampSpan;
     private cleanupStaleResources;
@@ -306,21 +348,30 @@ declare class ClientList implements OnDestroy {
     private createInformativeRequestSignature;
     private hasValidIdentifiers;
     private getMissingIdentifiersMessage;
+    private isInformativeConfig;
+    private asInformativeConfig;
+    private asFormConfig;
     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>;
+    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"; "itemClicked": "itemClicked"; }, never, never, true, never>;
 }
 
 declare class ClientListApiService {
     private readonly http;
-    private readonly tablesBaseUrl;
-    private readonly cardsBaseUrl;
+    private readonly runtimeFetchBaseUrl;
+    private readonly tableSettingsBaseUrl;
     private readonly informativeBaseUrl;
-    getRows(levelId: number, levelDataId: number, moduleId: number, query: ClientListTableQuery): Observable<Response<RuntimeTableRowsResponse>>;
-    getCards(levelDataId: number, moduleId: number): Observable<Response<ClientListCardsPayload>>;
+    getRows(contextKey: ClientListRuntimeContext, instanceId: number, query: ClientListTableQuery): Observable<Response<RuntimeTableRowsResponse>>;
+    getCards(contextKey: ClientListRuntimeContext, instanceId?: number | null): Observable<Response<ClientListCardsPayload>>;
     getInformativeDashboard(moduleId: number): Observable<Response<ClientListInformativeDashboardPayload>>;
+    private queryRuntime;
+    private resolveTablePropertyKeys;
+    private buildInstanceFilters;
+    private toPage;
+    private toEffectiveColumnKeys;
+    private readTableSettingsContext;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientListApiService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ClientListApiService>;
 }
 
 export { ClientList, ClientListApiService, ClientListStateService };
-export type { ClientListAreaType, ClientListBaseState, ClientListCard, ClientListCardDisplayConfiguration, ClientListCardDisplayProperty, ClientListCardModule, ClientListCardProperty, ClientListCardsDetailsBlock, ClientListCardsPayload, ClientListCardsState, ClientListCollapseConfig, ClientListConfiguration, ClientListContentTemplateContext, ClientListDataLoadedHandler, ClientListInformativeChartLink, ClientListInformativeDashboardPayload, ClientListInformativeState, ClientListLayoutConfig, ClientListLazyLoadEvent, ClientListMode, ClientListState, ClientListTableQuery, ClientListTableState, ClientListType, NormalizedClientListConfiguration, Response, RuntimeEntityColumnDef, RuntimeTableApiRow, RuntimeTableCell, RuntimeTableColumn, RuntimeTableDisplayRow, RuntimeTablePagination, 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, ClientListState, ClientListTableQuery, ClientListTableSettingsCatalogResponse, ClientListTableSettingsColumn, ClientListTableState, ClientListType, NormalizedClientListConfiguration, Response, RuntimeEntityColumnDef, RuntimeTableDisplayRow, RuntimeTableRowsResponse };