@praxisui/list 8.0.0-beta.1 → 8.0.0-beta.12

package/index.d.ts

@@ -3,9 +3,10 @@ import { BehaviorSubject, Observable } from 'rxjs';
 import * as i0 from '@angular/core';
 import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
 import { MatSelectionListChange } from '@angular/material/list';
+import { MatPaginatorSelectConfig, PageEvent } from '@angular/material/paginator';
 import { FormGroup, FormControl } from '@angular/forms';
 import * as _praxisui_core from '@praxisui/core';
-import { JsonLogicExpression, LocalizationConfig, AiCapability, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog } from '@praxisui/core';
+import { PraxisExportFormat, PraxisExportScope, JsonLogicExpression, GlobalActionRef, LocalizationConfig, AiCapability, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
 import { BaseAiAdapter, PatchResult } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 
@@ -176,6 +177,7 @@ interface PraxisListConfig {
         compareBy?: string;
         return?: 'value' | 'item' | 'id';
     };
+    export?: PraxisListExportConfig;
     interaction?: {
         expandable?: boolean;
         expandTrigger?: 'row' | 'icon' | 'row+icon';
@@ -277,8 +279,7 @@ interface PraxisListConfig {
         buttonVariant?: 'stroked' | 'raised' | 'flat';
         showIf?: JsonLogicExpression | null;
         emitPayload?: 'item' | 'id' | 'value';
-        command?: string;
-        globalPayload?: any;
+        globalAction?: GlobalActionRef;
         emitLocal?: boolean;
         showLoading?: boolean;
         placement?: 'actions' | 'trailing';
@@ -310,9 +311,22 @@ interface PraxisListConfig {
         itemClick?: string;
         actionClick?: string;
         selectionChange?: string;
+        exportAction?: string;
         loaded?: string;
     };
 }
+interface PraxisListExportConfig {
+    enabled?: boolean;
+    formats?: PraxisExportFormat[];
+    general?: {
+        scope?: PraxisExportScope;
+        includeHeaders?: boolean;
+        maxRows?: number;
+        defaultFileName?: string;
+        includeFields?: string[] | 'all';
+        applyFormatting?: boolean;
+    };
+}
 interface ListItemEvent {
     item: any;
     index: number;
@@ -365,8 +379,15 @@ declare class ListDataService<T = any> {
     nextPage(): void;
     prevPage(): void;
     setPageSize(size: number): void;
+    setPage(pageNumber: number, pageSize: number): void;
     setSort(sort: string[]): void;
     setQuery(q: Record<string, any>): void;
+    getPageStateSnapshot(): {
+        pageNumber: number;
+        pageSize: number;
+        sort?: string[];
+    };
+    getQuerySnapshot(): Record<string, any>;
     groupedStream(): Observable<ListSection<T>[]>;
     private buildConfigSignature;
     private buildLocalDataSignature;
@@ -417,6 +438,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     itemClick: EventEmitter<ListItemEvent>;
     actionClick: EventEmitter<ListActionEvent>;
     selectionChange: EventEmitter<ListSelectionEvent>;
+    exportAction: EventEmitter<any>;
     items$: rxjs.Observable<any[]>;
     sections$: rxjs.Observable<ListSection<any>[]>;
     loading$: rxjs.Observable<boolean>;
@@ -448,6 +470,10 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly logger;
     private readonly jsonLogic;
     private readonly i18n;
+    private readonly collectionExport;
+    private readonly paginatorIntl;
+    private readonly snackBar;
+    readonly paginatorSelectConfig: MatPaginatorSelectConfig;
     private readonly logContext;
     private readonly route;
     private readonly globalActions;
@@ -464,6 +490,8 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly destroy$;
     actionLoadingState: Record<string, boolean>;
     private expandedItemKeys;
+    exportBusy: boolean;
+    exportStatusMessage: string;
     private readonly listRuleContextOptions;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -561,8 +589,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
         buttonVariant?: "stroked" | "raised" | "flat";
         showIf?: JsonLogicExpression | null;
         emitPayload?: "item" | "id" | "value";
-        command?: string;
-        globalPayload?: any;
+        globalAction?: GlobalActionRef;
         emitLocal?: boolean;
         showLoading?: boolean;
         placement?: "actions" | "trailing";
@@ -582,16 +609,42 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     expansionRegionAriaLabel(item: any): string;
     emptyStateLabel(): string;
     onActionClick(ev: MouseEvent, actionId: string, item: any, index: number): Promise<void>;
-    private isGlobalCommand;
     private resolveActionPayload;
     private resolveTemplate;
+    private isDeferredTemplateExpressionKey;
     private resolveStringTemplate;
     private lookup;
     onSelectionChange(_change: MatSelectionListChange): void;
+    listExportFormats(): PraxisExportFormat[];
+    exportIcon(format: PraxisExportFormat): string;
+    onExportAction(format: PraxisExportFormat): Promise<void>;
+    private buildListExportRequest;
+    private resolveEffectiveExportScope;
+    private buildListExportSelection;
+    private resolveListExportLoadedItems;
+    private buildListExportFields;
+    private collectListExportFieldKeys;
+    private normalizeListSelectionValue;
+    private resolveListSelectionKey;
+    private hasListExportQuery;
+    private getListQuerySnapshot;
+    private getListPageStateSnapshot;
+    private resolveListExportTotal;
+    private parseListExportSort;
+    private downloadExportResult;
+    private triggerExportDownload;
+    private showExportFeedback;
+    private resolveExportFileName;
+    private getExportFileExtension;
+    private getExportMimeType;
+    private cloneForExportEvent;
     openConfigEditor(): void;
     nextPage(): void;
     prevPage(): void;
     setPageSize(ps: number): void;
+    onPageChange(event: PageEvent): void;
+    listPageSizeOptions(): number[];
+    remoteTotalLabel(total: number | null | undefined): string;
     onSortChange(val: string): void;
     onSearchInput(val: string): void;
     sortOptionValue(op: any): string;
@@ -604,6 +657,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
         pageNumber: number;
         pageSize: number;
     }, total: number): number;
+    private syncPaginatorIntl;
+    private formatPaginatorRangeLabel;
+    private isEnglishLocaleValue;
     applyConfigFromAdapter(newCfg: PraxisListConfig): void;
     private applyAuthoringPayload;
     private buildListEditorRuntimeContext;
@@ -669,19 +725,18 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private mergePlainObjects;
     private buildActionLoadingKey;
     private ensureActionItemObjectId;
-    private warnGlobalCommandUnavailableOnce;
     private buildLogOptions;
     private toggleExpanded;
     private syncExpansionState;
     private itemExpansionKey;
-    private t;
+    t(key: string, fallback: string): string;
     private ensureExpansionItemObjectId;
     private sanitizeDomId;
     private evaluateExpansionExpr;
     private normalizeExpansionItems;
     private normalizeKeyValueItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "exportAction": "exportAction"; }, never, never, true, never>;
     static ngAcceptInputType_enableCustomization: unknown;
 }
 
@@ -1294,18 +1349,24 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     ensureConfirmation(action: any): void;
     setConfirmationField(action: any, field: 'title' | 'message', value: string): void;
     applyConfirmationPreset(action: any, type?: 'danger' | 'warning' | 'info' | ''): void;
-    isGlobalPayloadInvalid(payload: any): boolean;
-    applyGlobalPayloadExample(action: any): void;
-    globalPayloadExampleHint(action: any): string;
-    globalPayloadSchemaTooltip(action: any): string;
+    applyGlobalActionPayloadExample(action: any): void;
+    globalActionPayloadExampleHint(action: any): string;
+    globalActionPayloadSchemaTooltip(action: any): string;
+    onActionGlobalActionIdChange(action: any, actionId: string): void;
+    getGlobalActionPayloadText(action: {
+        globalAction?: GlobalActionRef;
+    }): string;
+    onGlobalActionPayloadTextChange(action: any, value: string): void;
+    isGlobalActionPayloadInvalid(action: {
+        globalAction?: GlobalActionRef;
+    }): boolean;
     isSurfaceOpenCommand(action: {
-        command?: string;
+        globalAction?: GlobalActionRef;
     }): boolean;
-    getSurfaceOpenGlobalPayload(action: {
-        command?: string;
-        globalPayload?: string;
+    getSurfaceOpenGlobalActionPayload(action: {
+        globalAction?: GlobalActionRef;
     }): SurfaceOpenPayload;
-    onSurfaceOpenGlobalPayloadChange(action: any, payload: SurfaceOpenPayload): void;
+    onSurfaceOpenGlobalActionPayloadChange(action: any, payload: SurfaceOpenPayload): void;
     onGlobalActionSelected(id?: string): void;
     private addGlobalActionFromCatalog;
     metaTypeConfig(type?: string): {
@@ -1365,6 +1426,11 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private getGlobalActionEntryLabel;
     private getGlobalActionEntryDescription;
     private getGlobalActionSchema;
+    getGlobalActionId(action: {
+        globalAction?: GlobalActionRef;
+    }): string;
+    private parseGlobalActionPayloadText;
+    private looksLikeJsonPayload;
     private normalizeSurfaceOpenPayload;
     verify(): void;
     inferFromFields(): void;
@@ -1458,10 +1524,14 @@ declare function providePraxisListMetadata(): Provider;
 declare module '@praxisui/core' {
     interface AiCapabilityCategoryMap {
         meta: true;
+        export: true;
         skin: true;
         selection: true;
         templating: true;
         actions: true;
+        interaction: true;
+        expansion: true;
+        rules: true;
         ui: true;
         i18n: true;
         a11y: true;
@@ -1477,6 +1547,8 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const LIST_AI_CAPABILITIES: CapabilityCatalog;
 
+declare const PRAXIS_LIST_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
 type DemoScenario = 'operations' | 'executive-expansion' | 'catalog' | 'empty';
 type DemoVariant = 'list' | 'cards' | 'tiles';
 type DemoDensity = 'default' | 'comfortable' | 'compact';
@@ -1643,6 +1715,7 @@ declare class PraxisListDocPageComponent {
                 inlineStyle?: string;
             } | undefined;
             id?: string;
+            export?: PraxisListExportConfig;
             interaction?: {
                 expandable?: boolean;
                 expandTrigger?: "row" | "icon" | "row+icon";
@@ -1744,8 +1817,7 @@ declare class PraxisListDocPageComponent {
                 buttonVariant?: "stroked" | "raised" | "flat";
                 showIf?: _praxisui_core.JsonLogicExpression | null;
                 emitPayload?: "item" | "id" | "value";
-                command?: string;
-                globalPayload?: any;
+                globalAction?: _praxisui_core.GlobalActionRef;
                 emitLocal?: boolean;
                 showLoading?: boolean;
                 placement?: "actions" | "trailing";
@@ -1777,6 +1849,7 @@ declare class PraxisListDocPageComponent {
                 itemClick?: string;
                 actionClick?: string;
                 selectionChange?: string;
+                exportAction?: string;
                 loaded?: string;
             };
         };
@@ -1813,6 +1886,13 @@ declare const PRAXIS_LIST_EN_US: {
     readonly collapseDetails: "Collapse details";
     readonly itemDetails: "Item details";
     readonly emptyState: "No items available";
+    readonly 'pagination.itemsPerPage': "Items per page:";
+    readonly 'pagination.nextPage': "Next page";
+    readonly 'pagination.previousPage': "Previous page";
+    readonly 'pagination.firstPage': "First page";
+    readonly 'pagination.lastPage': "Last page";
+    readonly 'pagination.total': "Total";
+    readonly 'export.button': "Export";
     readonly Data: "Data";
     readonly Actions: "Actions";
     readonly Layout: "Layout";
@@ -1838,7 +1918,7 @@ declare const PRAXIS_LIST_EN_US: {
     readonly 'Global action (Praxis)': "Global action (Praxis)";
     readonly '-- Select --': "-- Select --";
     readonly 'No global action registered.': "No global action registered.";
-    readonly 'Select to add with a global `command`.': "Select to add with a global `command`.";
+    readonly 'Select to add with a structured global action.': "Select to add with a structured global action.";
     readonly 'Action type': "Action type";
     readonly Icon: "Icon";
     readonly Button: "Button";
@@ -1872,7 +1952,7 @@ declare const PRAXIS_LIST_EN_US: {
     readonly 'Emit local event too': "Emit local event too";
     readonly JSON: "JSON";
     readonly ID: "ID";
-    readonly 'Command (global)': "Command (global)";
+    readonly 'Global action': "Global action";
     readonly Catalog: "Catalog";
     readonly Danger: "Danger";
     readonly Warning: "Warning";
@@ -2041,6 +2121,13 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly collapseDetails: "Recolher detalhes";
     readonly itemDetails: "Detalhes do item";
     readonly emptyState: "Nenhum item disponível";
+    readonly 'pagination.itemsPerPage': "Itens por página:";
+    readonly 'pagination.nextPage': "Próxima página";
+    readonly 'pagination.previousPage': "Página anterior";
+    readonly 'pagination.firstPage': "Primeira página";
+    readonly 'pagination.lastPage': "Última página";
+    readonly 'pagination.total': "Total";
+    readonly 'export.button': "Exportar";
     readonly Data: "Dados";
     readonly Actions: "Ações";
     readonly Layout: "Layout";
@@ -2066,7 +2153,7 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Global action (Praxis)': "Ação global (Praxis)";
     readonly '-- Select --': "-- Selecionar --";
     readonly 'No global action registered.': "Nenhuma ação global registrada.";
-    readonly 'Select to add with a global `command`.': "Selecione para adicionar com `command` global.";
+    readonly 'Select to add with a structured global action.': "Selecione para adicionar com uma ação global estruturada.";
     readonly 'Action type': "Tipo de ação";
     readonly Icon: "Ícone";
     readonly Button: "Botão";
@@ -2100,7 +2187,7 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Emit local event too': "Emitir evento local também";
     readonly JSON: "JSON";
     readonly ID: "ID";
-    readonly 'Command (global)': "Comando (global)";
+    readonly 'Global action': "Ação global";
     readonly Catalog: "Catálogo";
     readonly Danger: "Perigo";
     readonly Warning: "Aviso";
@@ -2260,5 +2347,5 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'CSS class example (add this to your global styles):': "Exemplo de classe CSS (adicione isto aos seus estilos globais):";
 };
 
-export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListProjectionContext, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListI18nConfig, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };
+export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_AUTHORING_MANIFEST, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
+export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListProjectionContext, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@praxisui/list",
-  "version": "8.0.0-beta.1",
+  "version": "8.0.0-beta.12",
   "description": "List components and helpers for Praxis UI.",
   "peerDependencies": {
     "@angular/common": ">=16 <21",
     "@angular/core": ">=16 <21",
     "@angular/material": ">=16 <21",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.1",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.12",
     "rxjs": ">=7 <9"
   },
   "dependencies": {