@praxisui/list 8.0.0-beta.0 → 8.0.0-beta.100

package/{index.d.ts → types/praxisui-list.d.ts}

@@ -1,13 +1,15 @@
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
+import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, AfterViewInit, 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 { BaseAiAdapter, PatchResult } from '@praxisui/ai';
+import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { BaseAiAdapter, AiResponseCompileResult, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
+import * as _praxisui_list from '@praxisui/list';
 
 type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'html' | 'slot' | 'metric' | 'compose' | 'component';
 interface TemplateDef {
@@ -117,6 +119,31 @@ interface ListExpansionSectionDef {
 }
 type ListTemplatingSlot = 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'identity' | 'balance' | 'limit' | 'risk' | 'alerts' | 'owner';
 type ListRowLayoutSlot = ListTemplatingSlot | 'actions' | 'expand';
+interface ListItemStyleEffect {
+    kind?: 'item-style';
+    class?: string;
+    style?: string;
+    border?: string;
+    background?: string;
+}
+interface ListSlotOverrideEffect {
+    kind?: 'slot-override';
+    template?: TemplateDef;
+    class?: string;
+    style?: string;
+    hide?: boolean;
+}
+interface ListItemStyleRule extends Omit<PraxisRuntimeConditionalEffectRule<ListItemStyleEffect>, 'condition' | 'effects'>, ListItemStyleEffect {
+    id: string;
+    condition?: JsonLogicExpression | null;
+    effects?: ListItemStyleEffect[];
+}
+interface ListSlotOverrideRule extends Omit<PraxisRuntimeConditionalEffectRule<ListSlotOverrideEffect>, 'condition' | 'effects'>, ListSlotOverrideEffect {
+    id: string;
+    slot: ListTemplatingSlot;
+    condition?: JsonLogicExpression | null;
+    effects?: ListSlotOverrideEffect[];
+}
 interface PraxisListConfig {
     id?: string;
     dataSource?: {
@@ -176,6 +203,7 @@ interface PraxisListConfig {
         compareBy?: string;
         return?: 'value' | 'item' | 'id';
     };
+    export?: PraxisListExportConfig;
     interaction?: {
         expandable?: boolean;
         expandTrigger?: 'row' | 'icon' | 'row+icon';
@@ -210,23 +238,8 @@ interface PraxisListConfig {
         };
     };
     rules?: {
-        itemStyles?: Array<{
-            id: string;
-            condition?: JsonLogicExpression | null;
-            class?: string;
-            style?: string;
-            border?: string;
-            background?: string;
-        }>;
-        slotOverrides?: Array<{
-            id: string;
-            slot: ListTemplatingSlot;
-            condition?: JsonLogicExpression | null;
-            template?: TemplateDef;
-            class?: string;
-            style?: string;
-            hide?: boolean;
-        }>;
+        itemStyles?: ListItemStyleRule[];
+        slotOverrides?: ListSlotOverrideRule[];
     };
     expansion?: {
         sections?: ListExpansionSectionDef[];
@@ -277,8 +290,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 +322,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,10 +390,18 @@ 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 buildRequestSignature;
     private buildLocalDataSignature;
     private ensureObjectId;
     private safeSerialize;
@@ -381,17 +414,32 @@ declare class ListDataService<T = any> {
 declare class ListAiAdapter extends BaseAiAdapter<PraxisListConfig> {
     private list;
     componentName: string;
+    componentId: string;
+    componentType: string;
     constructor(list: PraxisList);
     getCurrentConfig(): PraxisListConfig;
     getCapabilities(): AiCapability[];
     getRuntimeState(): Record<string, any>;
+    getDataProfile(): Record<string, any>;
+    getSchemaFields(): Record<string, any>[];
+    getAuthoringContext(): Record<string, any>;
     createSnapshot(): PraxisListConfig;
+    compileAiResponse(response: Record<string, unknown>): AiResponseCompileResult | null;
     restoreSnapshot(snapshot: PraxisListConfig): Promise<void>;
     applyPatch(patch: Partial<PraxisListConfig>, _intent?: string): Promise<PatchResult>;
     private applyConfig;
     private smartMergeListConfig;
     private sanitizePatch;
     private cloneConfig;
+    private coerceComponentEditPlanOperations;
+    private coerceOperationInput;
+    private applyManifestEffects;
+    private resolveSetValue;
+    private mergeAtPath;
+    private setAtPath;
+    private readAtPath;
+    private asRecord;
+    private trimToUndefined;
 }
 
 interface ListRowLayoutColumnViewModel {
@@ -404,6 +452,11 @@ interface ListRowLayoutColumnViewModel {
     class?: string;
     style?: string;
 }
+interface ListCardDetailSlotViewModel {
+    slot: ListTemplatingSlot;
+    label: string;
+    node: Record<string, any>;
+}
 declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private static nextSkinScopeId;
     private customizationEnabled;
@@ -411,12 +464,17 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     config: PraxisListConfig;
     listId: string;
     componentInstanceId?: string;
+    configPersistenceStrategy: 'local-first' | 'input-first';
+    private runtimeQueryContext?;
+    set queryContext(value: PraxisDataQueryContext | null | undefined);
+    get queryContext(): PraxisDataQueryContext | null | undefined;
     form?: FormGroup | null;
     set enableCustomization(value: boolean);
     get enableCustomization(): boolean;
     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>;
@@ -427,6 +485,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
         sort?: string[];
     }>;
     private lastQuery;
+    private lastRuntimeQueryContextSignature;
     private search$;
     get layoutLines(): number;
     boundControl: FormControl<unknown | unknown[] | null>;
@@ -435,6 +494,13 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     inlineCss: string;
     readonly cspNonce: string | null;
     aiAdapter: ListAiAdapter;
+    aiAssistantOpen: boolean;
+    aiAssistantPrompt: string;
+    aiAssistantViewState: PraxisAssistantTurnViewState | null;
+    aiAssistantLayout: PraxisAssistantShellLayout;
+    readonly aiAssistantLabels: Partial<PraxisAssistantShellLabels>;
+    private aiAssistantController;
+    private aiAssistantStateSubscription;
     private readonly storage;
     private readonly skin;
     private inferredForPath;
@@ -448,6 +514,14 @@ 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;
+    private readonly aiApi;
+    private readonly assistantSessions;
+    private readonly aiTurnOrchestrator;
+    private readonly aiAssistantSessionEffect;
+    readonly paginatorSelectConfig: MatPaginatorSelectConfig;
     private readonly logContext;
     private readonly route;
     private readonly globalActions;
@@ -464,6 +538,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;
@@ -495,6 +571,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     itemRuleStyle(item: any): string | undefined;
     rowLayoutItemStyle(item: any): string | undefined;
     rowLayoutItemClass(item: any): string | undefined;
+    private resolveItemStyleEffect;
+    private resolveSlotOverrideEffect;
+    private firstConditionalEffect;
     hasRowLayoutGrid(): boolean;
     rowLayoutColumns(): ListRowLayoutColumnViewModel[];
     rowLayoutTrackColumn(index: number, column: ListRowLayoutColumnViewModel): string;
@@ -503,6 +582,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     rowLayoutColumnClass(column: ListRowLayoutColumnViewModel): string | undefined;
     rowLayoutColumnStyle(column: ListRowLayoutColumnViewModel): string | undefined;
     rowLayoutSlot(item: any, slot: string): Record<string, any> | null;
+    cardDetailSlots(item: any): ListCardDetailSlotViewModel[];
+    private humanizeSlotLabel;
+    private hasDisplayableNodeValue;
     rowLayoutHasSlot(slot: ListRowLayoutSlot): boolean;
     rowLayoutImageAlt(slot: string): string;
     simpleRichContentNodes(node: Record<string, any> | null | undefined, options?: {
@@ -535,6 +617,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private buildMetricView;
     private buildComposeView;
     private buildMetricProgress;
+    private isEmptyComposeNode;
     private metricLayout;
     private metricAlign;
     private metricIconPosition;
@@ -561,8 +644,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 +664,65 @@ 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;
+    openAiAssistant(): void;
+    openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
+    closeAiAssistant(): void;
+    onAiAssistantPromptChange(prompt: string): void;
+    onAiAssistantSubmit(prompt: string): void;
+    onAiAssistantApply(): void;
+    onAiAssistantRetry(): void;
+    onAiAssistantCancel(): void;
+    onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    onAiAssistantEditMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantResendMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantLayoutChange(layout: PraxisAssistantShellLayout): void;
+    private initializeAiAssistantController;
+    private buildAiAssistantContextItems;
+    private buildAiAssistantContextSnapshot;
+    private syncAiAssistantSession;
+    private hasAiAssistantSessionState;
+    private resolveAiAssistantSessionId;
+    private resolveAiAssistantOwnerId;
+    private resolveAiAssistantRouteKey;
+    private resolveAiAssistantSummary;
+    private resolveAiAssistantBadge;
+    private resolveAiAssistantIcon;
     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,8 +735,12 @@ 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 applyRuntimeQueryContext;
     private buildListEditorRuntimeContext;
     private executeListEditorApplyPlan;
     private storageKey;
@@ -615,6 +750,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private executeSchemaInferenceForPlan;
     private evalSlot;
     private resolveSlotTemplate;
+    private resolveLocalDataFallbackTemplate;
+    private isLocalDataPreviewItem;
+    private firstPresentItemKey;
     private evaluateTemplateNode;
     private buildUnsupportedComposeNode;
     private buildRuntimeComponentView;
@@ -659,7 +797,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     ratingIconStyle(def?: any): string;
     ratingRange(def?: any): number[];
     trackBySection: (_: number, s: ListSection<any>) => string | number;
-    trackByItem: (i: number, it: any) => any;
+    trackByItem: (i: number, it: any) => string | number | boolean;
     isActionLoading(actionId: string, item: any, index: number): boolean;
     private evaluateActionVisibility;
     private evaluateRuntimeCondition;
@@ -669,19 +807,21 @@ 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;
+    private itemStableKey;
+    private isStablePrimitiveKey;
+    t(key: string, fallback: string): string;
+    private tWithLocale;
     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; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "queryContext": { "alias": "queryContext"; "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 +1434,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 +1511,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;
@@ -1382,6 +1533,35 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListConfigEditor, "praxis-list-config-editor", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+interface PraxisListWidgetEditorInputs {
+    config?: PraxisListConfig | null;
+    listId?: string;
+    [key: string]: unknown;
+}
+interface PraxisListWidgetEditorValue {
+    inputs: PraxisListWidgetEditorInputs;
+}
+declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, AfterViewInit, OnDestroy {
+    inputs: PraxisListWidgetEditorInputs | null;
+    widgetKey?: string;
+    listEditor?: PraxisListConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    get config(): PraxisListConfig;
+    get listId(): string | undefined;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisListWidgetEditorValue;
+    onSave(): PraxisListWidgetEditorValue;
+    reset(): void;
+    private initializeChildEditor;
+    private buildValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListWidgetConfigEditor, "praxis-list-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare function createListAuthoringDocument(source: {
     config?: unknown;
 }): ListAuthoringDocument;
@@ -1424,8 +1604,9 @@ interface TemplateEvaluatorOptions {
 declare function evalExpr(expr: string, ctx: any, options?: TemplateEvaluatorOptions): string;
 /**
  * Evaluate a template definition with basic pipe support.
- * Supported pipes:
+ * Supported top-level pipes:
  *  - bool:TrueLabel:FalseLabel  (maps truthy/falsey values to provided labels)
+ *  - map:key=Label,...          (maps scalar values to labels)
  */
 declare function evaluateTemplate(def: TemplateDef | undefined, item: any, options?: TemplateEvaluatorOptions): {
     type: string;
@@ -1458,10 +1639,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 +1662,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';
@@ -1606,7 +1793,7 @@ declare class PraxisListDocPageComponent {
                 rowLayout?: {
                     type?: "grid" | "flex";
                     columns?: Array<{
-                        slot: ListRowLayoutSlot;
+                        slot: _praxisui_list.ListRowLayoutSlot;
                         width?: string;
                         minWidth?: string;
                         maxWidth?: string;
@@ -1642,61 +1829,47 @@ declare class PraxisListDocPageComponent {
                 class?: string;
                 inlineStyle?: string;
             } | undefined;
-            id?: string;
-            interaction?: {
-                expandable?: boolean;
-                expandTrigger?: "row" | "icon" | "row+icon";
-                expandMode?: "single" | "multiple";
-                expandPlacement?: "expand" | "trailing";
-            };
-            templating?: {
-                leading?: TemplateDef;
-                primary?: TemplateDef;
-                secondary?: TemplateDef;
-                meta?: TemplateDef;
-                trailing?: TemplateDef;
-                identity?: TemplateDef;
-                balance?: TemplateDef;
-                limit?: TemplateDef;
-                risk?: TemplateDef;
-                alerts?: TemplateDef;
-                owner?: TemplateDef;
+            templating: {
+                statusPosition: "top-right";
+                leading?: _praxisui_list.TemplateDef;
+                primary?: _praxisui_list.TemplateDef;
+                secondary?: _praxisui_list.TemplateDef;
+                meta?: _praxisui_list.TemplateDef;
+                trailing?: _praxisui_list.TemplateDef;
+                identity?: _praxisui_list.TemplateDef;
+                balance?: _praxisui_list.TemplateDef;
+                limit?: _praxisui_list.TemplateDef;
+                risk?: _praxisui_list.TemplateDef;
+                alerts?: _praxisui_list.TemplateDef;
+                owner?: _praxisui_list.TemplateDef;
                 metaPlacement?: "side" | "line";
                 metaPrefixIcon?: string;
-                statusPosition?: "inline" | "top-right";
                 chipColorMap?: Record<string, string>;
                 chipLabelMap?: Record<string, string>;
                 iconColorMap?: Record<string, string>;
-                features?: TemplatingFeatureDef[];
+                features?: _praxisui_list.TemplatingFeatureDef[];
                 featuresVisible?: boolean;
                 featuresMode?: "icons+labels" | "icons-only" | "labels-only";
-                sectionHeader?: TemplateDef;
-                emptyState?: TemplateDef;
+                sectionHeader?: _praxisui_list.TemplateDef;
+                emptyState?: _praxisui_list.TemplateDef;
                 skeleton?: {
                     count?: number;
                 };
             };
+            id?: string;
+            export?: _praxisui_list.PraxisListExportConfig;
+            interaction?: {
+                expandable?: boolean;
+                expandTrigger?: "row" | "icon" | "row+icon";
+                expandMode?: "single" | "multiple";
+                expandPlacement?: "expand" | "trailing";
+            };
             rules?: {
-                itemStyles?: Array<{
-                    id: string;
-                    condition?: _praxisui_core.JsonLogicExpression | null;
-                    class?: string;
-                    style?: string;
-                    border?: string;
-                    background?: string;
-                }>;
-                slotOverrides?: Array<{
-                    id: string;
-                    slot: ListTemplatingSlot;
-                    condition?: _praxisui_core.JsonLogicExpression | null;
-                    template?: TemplateDef;
-                    class?: string;
-                    style?: string;
-                    hide?: boolean;
-                }>;
+                itemStyles?: _praxisui_list.ListItemStyleRule[];
+                slotOverrides?: _praxisui_list.ListSlotOverrideRule[];
             };
             expansion?: {
-                sections?: ListExpansionSectionDef[];
+                sections?: _praxisui_list.ListExpansionSectionDef[];
                 dataSource?: {
                     mode?: "inline" | "resource" | "resourcePath";
                     resource?: {
@@ -1731,8 +1904,8 @@ declare class PraxisListDocPageComponent {
                     padding?: string;
                     class?: string;
                     style?: string;
-                    loadingTemplate?: TemplateDef;
-                    errorTemplate?: TemplateDef;
+                    loadingTemplate?: _praxisui_list.TemplateDef;
+                    errorTemplate?: _praxisui_list.TemplateDef;
                 };
             };
             actions?: Array<{
@@ -1744,8 +1917,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";
@@ -1755,7 +1927,7 @@ declare class PraxisListDocPageComponent {
                     type?: "danger" | "warning" | "info";
                 };
             }>;
-            i18n?: PraxisListI18nConfig;
+            i18n?: _praxisui_list.PraxisListI18nConfig;
             ui?: {
                 showSearch?: boolean;
                 searchField?: string;
@@ -1777,6 +1949,7 @@ declare class PraxisListDocPageComponent {
                 itemClick?: string;
                 actionClick?: string;
                 selectionChange?: string;
+                exportAction?: string;
                 loaded?: string;
             };
         };
@@ -1813,6 +1986,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 +2018,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 +2052,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";
@@ -2033,7 +2213,7 @@ declare const PRAXIS_LIST_EN_US: {
 };
 
 declare const PRAXIS_LIST_I18N_NAMESPACE = "praxis-list";
-declare function providePraxisListI18n(): i0.Provider;
+declare function providePraxisListI18n(): i0.Provider[];
 
 declare const PRAXIS_LIST_PT_BR: {
     readonly configEdit: "Editar configurações";
@@ -2041,6 +2221,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 +2253,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 +2287,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 +2447,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, PraxisListWidgetConfigEditor, 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, ListItemStyleEffect, ListItemStyleRule, ListProjectionContext, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListSlotOverrideEffect, ListSlotOverrideRule, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, PraxisListWidgetEditorInputs, PraxisListWidgetEditorValue, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };