@praxisui/table 8.0.0-beta.2 → 8.0.0-beta.20

package/index.d.ts

@@ -10,7 +10,7 @@ import { CdkDragDrop, CdkDragEnd, CdkDrag, CdkDropList } from '@angular/cdk/drag
 import { BehaviorSubject, Subscription, Observable } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
 import * as _praxisui_core from '@praxisui/core';
-import { TableConfig, LoggerService, PraxisI18nService, GlobalConfigService, AsyncConfigStorage, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ConnectionStorage, ResourceDiscoveryService, LoadingOrchestrator, PraxisLoadingRenderer, TableDetailRichListNode, TableDetailCardGridNode, TableDetailCardGridCardNode, TableDetailTimelineNode, JsonLogicDataRecord, TableDetailListItemAction, TableDetailActionBarNode, TableDetailActionBarAction, TableDetailRefNode, TableDetailTemplateRefNode, TableDetailDiagramEmbedNode, TableDetailEmbedAction, ResourceActionCatalogItem, JsonLogicExpression, GlobalActionSpec, IconPickerService, SurfaceOpenPayload, GlobalActionField, FieldDefinition, PraxisJsonLogicService, TableConfigService, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, AnalyticsSchemaContractService, AnalyticsPresentationResolver, RichPresenterNode, RichComposeNode, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import { TableConfig, LoggerService, PraxisI18nService, GlobalConfigService, AsyncConfigStorage, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ConnectionStorage, ResourceDiscoveryService, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, TableDetailRichListNode, TableDetailCardGridNode, TableDetailCardGridCardNode, TableDetailTimelineNode, JsonLogicDataRecord, TableDetailListItemAction, TableDetailActionBarNode, TableDetailActionBarAction, TableDetailRefNode, TableDetailTemplateRefNode, TableDetailDiagramEmbedNode, TableDetailEmbedAction, GlobalActionRef, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, JsonLogicExpression, GlobalActionCatalogEntry, IconPickerService, SurfaceOpenPayload, GlobalActionField, FieldDefinition, PraxisJsonLogicService, TableConfigService, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, AnalyticsSchemaContractService, AnalyticsPresentationResolver, RichPresenterNode, RichComposeNode, ComponentAuthoringManifest, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import { FormGroup, FormControl, FormBuilder } from '@angular/forms';
 import { MatDialog } from '@angular/material/dialog';
 import { CdkOverlayOrigin, ConnectedPosition } from '@angular/cdk/overlay';
@@ -46,11 +46,15 @@ declare class PraxisTableToolbar implements OnDestroy {
     showActionsGroup: boolean;
     showEndActions: boolean;
     showMobileActions: boolean;
+    exportBusy: boolean;
     evaluationContext: Record<string, any> | null;
     toolbarAction: EventEmitter<{
         action: string;
         actionConfig?: any;
     }>;
+    exportAction: EventEmitter<{
+        format: string;
+    }>;
     readonly getActionId: typeof getActionId;
     private readonly jsonLogic;
     private readonly validToolbarActionTypes;
@@ -65,6 +69,7 @@ declare class PraxisTableToolbar implements OnDestroy {
     constructor(hostRef?: ElementRef<HTMLElement> | null, logger?: LoggerService | undefined, i18n?: PraxisI18nService | undefined);
     getExportDataLabel(): string;
     getMoreActionsLabel(): string;
+    emitExportAction(event: Event, format: string): void;
     private tx;
     ngOnDestroy(): void;
     private getNestedPropertyValue;
@@ -112,7 +117,7 @@ declare class PraxisTableToolbar implements OnDestroy {
     private sortActions;
     getExportIcon(format: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTableToolbar, [null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableToolbar, "praxis-table-toolbar", never, { "config": { "alias": "config"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "showMain": { "alias": "showMain"; "required": false; }; "showActionsGroup": { "alias": "showActionsGroup"; "required": false; }; "showEndActions": { "alias": "showEndActions"; "required": false; }; "showMobileActions": { "alias": "showMobileActions"; "required": false; }; "evaluationContext": { "alias": "evaluationContext"; "required": false; }; }, { "toolbarAction": "toolbarAction"; }, never, ["[advancedFilter]", "[toolbar]", "[end-actions]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableToolbar, "praxis-table-toolbar", never, { "config": { "alias": "config"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "showMain": { "alias": "showMain"; "required": false; }; "showActionsGroup": { "alias": "showActionsGroup"; "required": false; }; "showEndActions": { "alias": "showEndActions"; "required": false; }; "showMobileActions": { "alias": "showMobileActions"; "required": false; }; "exportBusy": { "alias": "exportBusy"; "required": false; }; "evaluationContext": { "alias": "evaluationContext"; "required": false; }; }, { "toolbarAction": "toolbarAction"; "exportAction": "exportAction"; }, never, ["[advancedFilter]", "[toolbar]", "[end-actions]"], true, never>;
 }
 
 type ColumnDataType$1 = 'date' | 'number' | 'currency' | 'percentage' | 'string' | 'boolean' | 'custom';
@@ -739,6 +744,9 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
     private persistTags;
     private cleanFilterPayload;
     private upsertDtoValue;
+    private normalizeFilterFieldValue;
+    private getFilterFieldMetaByName;
+    private isEntityLookupFilterField;
     private isEffectivelyEmptyFilterValue;
     private syncFormsToDto;
     private updateDisplayedTags;
@@ -835,6 +843,7 @@ type RowActionRuntimeOptions = {
 type RuntimeRowAction = {
     id: string;
     action: string;
+    globalAction?: GlobalActionRef;
     label?: string;
     icon?: string;
     color?: string;
@@ -842,6 +851,7 @@ type RuntimeRowAction = {
     disabled?: boolean;
     overflow?: boolean;
     __praxisDiscoveredAction?: ResourceActionCatalogItem;
+    __praxisDiscoveredSurface?: ResourceSurfaceCatalogItem;
     __praxisCapabilityDenied?: boolean;
 };
 type ExpansionDetailRuntimeStatus = 'idle' | 'loading' | 'ready' | 'error' | 'blocked';
@@ -868,6 +878,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private resourceDiscovery;
     private componentKeys;
     private loadingOrchestrator;
+    private globalActions;
     private loadingRenderer?;
     private route?;
     private logger?;
@@ -900,6 +911,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     rowAction: EventEmitter<any>;
     toolbarAction: EventEmitter<any>;
     bulkAction: EventEmitter<any>;
+    exportAction: EventEmitter<any>;
     columnReorder: EventEmitter<any>;
     columnReorderAttempt: EventEmitter<any>;
     beforeDelete: EventEmitter<any>;
@@ -937,6 +949,8 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     readonly isExpansionDetailRow: (index: number, row: any) => boolean;
     columnReorderStatusMessage: string;
     columnReorderVisualStatusMessage: string;
+    exportBusy: boolean;
+    exportStatusMessage: string;
     private columnReorderStatusTimer;
     private columnReorderVisualStatusTimer;
     private columnReorderUndoSubscription;
@@ -976,6 +990,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private rowDiscoveryMarkForCheckScheduled;
     private lastRowDiscoveryScopeKey;
     private readonly i18n;
+    private readonly collectionExport;
     private readonly paginatorIntl;
     private schemaFieldsSnapshot;
     private runtimeSchemaMeta;
@@ -1130,7 +1145,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private ensureConfigDefaults;
     private setShowToolbar;
     private shouldExposeToolbar;
-    constructor(cdr: ChangeDetectorRef, settingsPanel: SettingsPanelService, crudService: GenericCrudService<any, any>, tableDefaultsProvider: TableDefaultsProvider, filterConfig: FilterConfigService, formattingService: DataFormattingService, pxDialog: PraxisDialog, snackBar: MatSnackBar, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, hostRef: ElementRef<HTMLElement>, global: GlobalConfigService, resourceDiscovery: ResourceDiscoveryService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, loadingRenderer?: PraxisLoadingRenderer | undefined, route?: ActivatedRoute | undefined, logger?: LoggerService | undefined);
+    constructor(cdr: ChangeDetectorRef, settingsPanel: SettingsPanelService, crudService: GenericCrudService<any, any>, tableDefaultsProvider: TableDefaultsProvider, filterConfig: FilterConfigService, formattingService: DataFormattingService, pxDialog: PraxisDialog, snackBar: MatSnackBar, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, hostRef: ElementRef<HTMLElement>, global: GlobalConfigService, resourceDiscovery: ResourceDiscoveryService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, globalActions: GlobalActionService, loadingRenderer?: PraxisLoadingRenderer | undefined, route?: ActivatedRoute | undefined, logger?: LoggerService | undefined);
     private ensureAiAdapterLoaded;
     openAiAssistant(): void;
     closeAiAssistant(): void;
@@ -1360,19 +1375,48 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private emitRowActionEvent;
     private showConfirmDialog;
     private executeDeleteAction;
+    private dispatchRowAction;
     private cloneForEmit;
     private interpolateActionMessageTemplate;
     private buildActionFeedbackContext;
     private resolveActionFeedbackMessage;
     private showActionFeedbackMessage;
     private emitEventWithActionFeedback;
+    private executeConfiguredGlobalAction;
+    private resolveConfiguredGlobalActionRef;
+    private resolveGlobalActionPayload;
+    private buildGlobalActionTemplateContext;
+    private resolveGlobalActionTemplateValue;
+    private isDeferredTemplateExpressionKey;
+    private interpolateGlobalActionTemplate;
+    private shouldEmitLocalForGlobalAction;
     private resolveBulkValidationMessage;
     private hasValidBulkSelectionCount;
     private showBulkConfirmDialog;
     onToolbarAction(event: {
         action: string;
         actionConfig?: any;
-    }): void;
+    }): Promise<void>;
+    private resolveBulkExportFormat;
+    private isBulkExportActionKey;
+    private normalizeExportFormat;
+    private isExportFormatEnabled;
+    private getFirstEnabledExportFormat;
+    onExportAction(event: {
+        format: string;
+    }): Promise<void>;
+    private shouldBlockSelectedExportWithoutSelection;
+    private buildTableExportRequest;
+    private resolveEffectiveExportScope;
+    private resolveTableExportLoadedItems;
+    private computeLocalExportRows;
+    private buildTableExportFields;
+    private downloadExportResult;
+    private triggerExportDownload;
+    private resolveExportFileName;
+    private getExportFileExtension;
+    private getExportMimeType;
+    private showExportFeedback;
     onAdvancedFilterSubmit(criteria: Record<string, any>): void;
     onAdvancedFilterChange(criteria: Record<string, any>): void;
     onAdvancedFilterClear(): void;
@@ -1519,6 +1563,10 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
      * 3. format (data formatting like dates, numbers, currency)
      */
     getCellValue(rowData: any, column: ColumnDefinition): any;
+    private normalizeReadonlyEntityLookupCellValue;
+    private toEntityLookupDisplayToken;
+    private isEntityLookupDisplayCandidate;
+    private toEntityLookupDisplayPrimitive;
     private resolveImplicitFormat;
     getCellClasses(rowData: any, column: ColumnDefinition): string[] | undefined;
     getCellNgStyle(rowData: any, column: ColumnDefinition): Record<string, string> | undefined;
@@ -1769,6 +1817,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private reconcileSelectionAfterDataChange;
     private getComparableRowIdentity;
     getIdField(): string;
+    private resolveConfigMetaIdField;
     private syncRuntimeSchemaMetaFromConfig;
     private getEffectiveMetadataSnapshot;
     getActionId(action: any): string;
@@ -1811,11 +1860,19 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private splitVisibleRowActionsFromVisible;
     private decorateConfiguredRowAction;
     private getDiscoveredRowWorkflowActions;
+    private getDiscoveredRowSurfaceActionsFromSnapshot;
     private getDiscoveredRowWorkflowActionsFromCatalog;
     private supportsRowCrudAction;
     private isCapabilityManagedCrudRowAction;
     private findItemWorkflowAction;
+    private findItemSurface;
+    private isRowSurfaceAction;
+    private isWritableRowSurface;
+    private isReadableRowSurface;
+    private getDiscoveredSurfaceIcon;
+    private getDiscoveredSurfaceColor;
     private getUnavailableWorkflowMessage;
+    private getUnavailableSurfaceMessage;
     private normalizeActionId;
     private isActionVisible;
     trackAction(index: number, item: any): any;
@@ -1829,8 +1886,8 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     getRowMenuIcon(): string;
     private scheduleRowDiscoveryMarkForCheck;
     ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTable, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTable, "praxis-table", never, { "config": { "alias": "config"; "required": false; }; "resourcePath": { "alias": "resourcePath"; "required": false; }; "data": { "alias": "data"; "required": false; }; "tableId": { "alias": "tableId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "autoDelete": { "alias": "autoDelete"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "crudContext": { "alias": "crudContext"; "required": false; }; "filterCriteria": { "alias": "filterCriteria"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "dense": { "alias": "dense"; "required": false; }; }, { "rowClick": "rowClick"; "rowDoubleClick": "rowDoubleClick"; "rowExpansionChange": "rowExpansionChange"; "rowAction": "rowAction"; "toolbarAction": "toolbarAction"; "bulkAction": "bulkAction"; "columnReorder": "columnReorder"; "columnReorderAttempt": "columnReorderAttempt"; "beforeDelete": "beforeDelete"; "afterDelete": "afterDelete"; "deleteError": "deleteError"; "beforeBulkDelete": "beforeBulkDelete"; "afterBulkDelete": "afterBulkDelete"; "bulkDeleteError": "bulkDeleteError"; "schemaStatusChange": "schemaStatusChange"; "metadataChange": "metadataChange"; "loadingStateChange": "loadingStateChange"; "collectionLinksChange": "collectionLinksChange"; "selectionChange": "selectionChange"; }, ["toolbar", "projectedFilter"], ["[advancedFilter]", "[toolbar]", "[advancedFilter]", "[toolbar]", "[advancedFilter]", "[toolbar]"], true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTable, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTable, "praxis-table", never, { "config": { "alias": "config"; "required": false; }; "resourcePath": { "alias": "resourcePath"; "required": false; }; "data": { "alias": "data"; "required": false; }; "tableId": { "alias": "tableId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "autoDelete": { "alias": "autoDelete"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "crudContext": { "alias": "crudContext"; "required": false; }; "filterCriteria": { "alias": "filterCriteria"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "dense": { "alias": "dense"; "required": false; }; }, { "rowClick": "rowClick"; "rowDoubleClick": "rowDoubleClick"; "rowExpansionChange": "rowExpansionChange"; "rowAction": "rowAction"; "toolbarAction": "toolbarAction"; "bulkAction": "bulkAction"; "exportAction": "exportAction"; "columnReorder": "columnReorder"; "columnReorderAttempt": "columnReorderAttempt"; "beforeDelete": "beforeDelete"; "afterDelete": "afterDelete"; "deleteError": "deleteError"; "beforeBulkDelete": "beforeBulkDelete"; "afterBulkDelete": "afterBulkDelete"; "bulkDeleteError": "bulkDeleteError"; "schemaStatusChange": "schemaStatusChange"; "metadataChange": "metadataChange"; "loadingStateChange": "loadingStateChange"; "collectionLinksChange": "collectionLinksChange"; "selectionChange": "selectionChange"; }, ["toolbar", "projectedFilter"], ["[advancedFilter]", "[toolbar]", "[advancedFilter]", "[toolbar]", "[advancedFilter]", "[toolbar]"], true, never>;
     static ngAcceptInputType_enableCustomization: unknown;
 }
 
@@ -1843,7 +1900,6 @@ interface EditorDocument<TConfig, TBindings = unknown> {
 type TableHorizontalScroll = 'auto' | 'wrap' | 'none';
 interface TableBindings {
     resourcePath?: string | null;
-    idField?: string;
     horizontalScroll?: TableHorizontalScroll;
 }
 interface TableAuthoringDocument extends EditorDocument<TableConfig, TableBindings> {
@@ -1900,7 +1956,6 @@ interface TableApplyPlan {
     };
     diff?: {
         resourcePathChanged?: boolean;
-        idFieldChanged?: boolean;
         horizontalScrollChanged?: boolean;
         requiresDataRefresh?: boolean;
     };
@@ -2373,6 +2428,7 @@ interface ToolbarAction {
     /** Material button appearance: filled (flat), outlined (stroked), elevated (raised), text, tonal */
     appearance?: 'filled' | 'outlined' | 'elevated' | 'text' | 'tonal';
     action: string;
+    globalAction?: GlobalActionRef;
     position: 'start' | 'end';
     order?: number;
     disabled?: boolean;
@@ -2388,6 +2444,7 @@ interface RowAction {
     label: string;
     icon: string;
     action: string;
+    globalAction?: GlobalActionRef;
     color?: 'primary' | 'accent' | 'warn';
     tooltip?: string;
     requiresConfirmation?: boolean;
@@ -2400,6 +2457,7 @@ interface BulkAction {
     label: string;
     icon: string;
     action: string;
+    globalAction?: GlobalActionRef;
     color?: 'primary' | 'accent' | 'warn';
     tooltip?: string;
     requiresConfirmation?: boolean;
@@ -2413,6 +2471,22 @@ interface ToolbarActionsChange {
     value: any;
     fullConfig: TableConfig;
 }
+type GlobalActionCatalogOption = GlobalActionCatalogEntry & {
+    param?: {
+        required?: boolean;
+        label?: string;
+        placeholder?: string;
+        hint?: string;
+    };
+};
+type EditableTableAction = {
+    id?: string;
+    label?: string;
+    action?: string;
+    globalAction?: GlobalActionRef;
+    position?: string;
+    appearance?: string;
+};
 type ToolbarShortcutScope = 'toolbar' | 'global';
 interface InternalActionSpec {
     id: string;
@@ -2433,14 +2507,14 @@ declare class ToolbarActionsEditorComponent implements OnInit, OnDestroy, OnChan
     editingToolbarActionIndex: number | null;
     editingRowActionIndex: number | null;
     editingBulkActionIndex: number | null;
-    readonly globalActionCatalog: GlobalActionSpec[];
+    private readonly i18n;
+    readonly globalActionCatalog: GlobalActionCatalogOption[];
     get internalActionCatalog(): InternalActionSpec[];
     readonly customActionValue = "__custom__";
     readonly validShortcutScopes: ToolbarShortcutScope[];
     private readonly actionFieldDrafts;
     private readonly actionFieldErrors;
     private readonly warnedInvalidShortcutScopes;
-    private readonly i18n;
     private destroy$;
     constructor(fb: FormBuilder, iconPicker: IconPickerService);
     tx(key: string, fallback: string): string;
@@ -2469,56 +2543,35 @@ declare class ToolbarActionsEditorComponent implements OnInit, OnDestroy, OnChan
     private removeAddToolbarAction;
     private syncAddFormFromActions;
     private updateConfig;
-    getActionSelectValue(value?: string): string;
-    getActionParam(value?: string): string;
-    getActionCustomValue(value?: string): string;
+    getActionSelectValue(action?: EditableTableAction): string;
+    getActionParam(action?: EditableTableAction): string;
+    isRequiredGlobalActionParamMissing(action: EditableTableAction, spec: GlobalActionCatalogOption): boolean;
+    getActionCustomValue(action?: EditableTableAction): string;
     isInternalAction(value?: string): boolean;
-    getActionSpecById(id: string): GlobalActionSpec | undefined;
-    onActionSelectChange(action: {
-        action?: string;
-    }, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
-    onActionParamChange(action: {
-        action?: string;
-    }, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
-    onActionCustomChange(action: {
-        action?: string;
-    }, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
+    getActionSpecById(id: string): GlobalActionCatalogOption | undefined;
+    onActionSelectChange(action: EditableTableAction, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
+    onActionParamChange(action: EditableTableAction, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
+    onActionCustomChange(action: EditableTableAction, value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
     private touchActionList;
-    private parseActionValue;
     isGlobalActionId(id?: string): boolean;
-    getGlobalActionSchema(action: {
-        action?: string;
-    }): _praxisui_core.GlobalActionUiSchema | undefined;
-    getSurfaceOpenActionPayload(action: {
-        action?: string;
-    }): SurfaceOpenPayload;
+    getGlobalActionSchema(action: EditableTableAction): _praxisui_core.GlobalActionUiSchema | undefined;
+    getSurfaceOpenActionPayload(action: EditableTableAction): SurfaceOpenPayload;
     onSurfaceOpenActionPayloadChange(action: {
         action?: string;
+        globalAction?: GlobalActionRef;
     }, payload: SurfaceOpenPayload, kind: 'toolbar' | 'row' | 'bulk'): void;
-    shouldShowGlobalActionField(action: {
-        action?: string;
-    }, field: GlobalActionField): boolean;
-    hasActionFieldError(action: {
-        action?: string;
-    }, key: string): boolean;
-    getActionFieldError(action: {
-        action?: string;
-    }, key: string): string;
-    getGlobalActionFieldValue(action: {
-        action?: string;
-    }, field: GlobalActionField): any;
-    onGlobalActionFieldChange(action: {
-        action?: string;
-    }, field: GlobalActionField, value: any, kind: 'toolbar' | 'row' | 'bulk'): void;
-    private getActionParamInfo;
-    private parseMethodAndUrl;
+    shouldShowGlobalActionField(action: EditableTableAction, field: GlobalActionField): boolean;
+    isGlobalActionFieldRequired(action: EditableTableAction, field: GlobalActionField): boolean;
+    isGlobalActionFieldMissing(action: EditableTableAction, field: GlobalActionField): boolean;
+    hasActionFieldError(action: EditableTableAction, key: string): boolean;
+    getActionFieldError(action: EditableTableAction, key: string): string;
+    getGlobalActionFieldValue(action: EditableTableAction, field: GlobalActionField): any;
+    onGlobalActionFieldChange(action: EditableTableAction, field: GlobalActionField, value: any, kind: 'toolbar' | 'row' | 'bulk'): void;
     private stringifyJson;
     private normalizeSurfaceOpenPayload;
     private setActionFieldError;
     private clearActionFieldError;
     private collectGlobalActionFieldValues;
-    private serializeGlobalActionParam;
-    private buildPrimaryParam;
     private buildGlobalActionPayload;
     getToolbarActionShortcutScope(action: ToolbarAction): ToolbarShortcutScope;
     onToolbarActionShortcutScopeChange(action: ToolbarAction, value: ToolbarShortcutScope | string): void;
@@ -3080,6 +3133,8 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
     private cdr;
     private configService;
     private readonly i18n;
+    private readonly globalActionCatalogSource;
+    private readonly globalActionCatalog;
     filterSettingsEditor?: FilterSettingsComponent;
     behaviorEditor?: BehaviorConfigEditorComponent;
     rulesEditor?: TableRulesEditorComponent;
@@ -3142,6 +3197,7 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
     private hasLocalDataInput;
     private filterDtoLoadSeq;
     private lastKnownFilterSettings;
+    private globalActionValidationIssues;
     private readonly panelData;
     private readonly crudService;
     private readonly panelRef;
@@ -3168,6 +3224,10 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
     onRulesConfigChange(newCfg: TableConfig): void;
     private updateColumnMetas;
     private updateCanSaveState;
+    private collectGlobalActionValidationIssues;
+    private collectGlobalActionValidationTargets;
+    private findGlobalActionCatalogEntry;
+    private buildGlobalActionCatalog;
     private subscribeCrudEditorChanges;
     private showSuccess;
     private showError;
@@ -3176,6 +3236,7 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
      * Normaliza uma configuração de tabela para comparação consistente
      * Remove propriedades undefined, ordena arrays e objetos de forma consistente
      */
+    private withCanonicalIdField;
     private normalizeTableConfig;
     /**
      * Realiza comparação profunda de objetos, ignorando ordem de propriedades
@@ -3397,6 +3458,15 @@ declare function buildTableApplyPlan(doc: TableAuthoringDocument, runtime?: Tabl
 }): TableApplyPlan;
 declare function serializeTableAuthoringDocument(doc: TableAuthoringDocument): unknown;
 
+/**
+ * Manifesto de authoring canônico para o componente praxis-table.
+ * Este arquivo define o contrato executável para que agentes de IA editem tabelas.
+ *
+ * @version 2.0.0
+ * @status COMPLIANT - Alinhado com o contrato v2 e TableConfig canônico.
+ */
+declare const PRAXIS_TABLE_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
 declare class PraxisTableInlineAuthoringEditorComponent implements OnChanges {
     private readonly i18n;
     config: TableConfig;
@@ -3643,7 +3713,6 @@ declare function providePraxisTableMetadata(): Provider;
 declare module '@praxisui/core' {
     interface AiCapabilityCategoryMap {
         meta: true;
-        bindings: true;
         columns: true;
         renderer: true;
         conditional: true;
@@ -3995,5 +4064,5 @@ declare function coerceTableComponentEditPlan(value: unknown): TableComponentEdi
 declare function compileTableComponentEditPlans(plans: TableComponentEditPlan[], currentConfig: TableConfig): TableComponentEditPlanCompileResult;
 declare function compileTableComponentEditPlan(plan: TableComponentEditPlan, currentConfig: TableConfig): TableComponentEditPlanCompileResult;
 
-export { AnalyticsTableConfigAdapterService, AnalyticsTableContractService, AnalyticsTableStatsApiService, BOOLEAN_PRESETS, BehaviorConfigEditorComponent, CURRENCY_PRESETS, ColumnsConfigEditorComponent, DATE_PRESETS, DataFormatterComponent, DataFormattingService, FORMULA_TEMPLATES, FilterConfigService, FilterSettingsComponent, FormulaGeneratorService, JsonConfigEditorComponent, MessagesLocalizationEditorComponent, NUMBER_PRESETS, PERCENTAGE_PRESETS, PRAXIS_FILTER_COMPONENT_METADATA, PRAXIS_TABLE_COMPONENT_METADATA, PraxisFilter, PraxisTable, PraxisTableConfigEditor, PraxisTableInlineAuthoringEditorComponent, PraxisTableToolbar, STRING_PRESETS, TABLE_AI_CAPABILITIES, TABLE_COMPONENT_AI_CAPABILITIES, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_KIND, TABLE_COMPONENT_EDIT_PLAN_VERSION, TASK_PRESETS, TableDefaultsProvider, TableRulesEditorComponent, ToolbarActionsEditorComponent, ValueMappingEditorComponent, VisualFormulaBuilderComponent, buildTableApplyPlan, coerceTableComponentEditPlan, coerceTableComponentEditPlans, compileTableComponentEditPlan, compileTableComponentEditPlans, createTableAuthoringDocument, getActionId, getEnum, getTableCapabilities, getTableComponentEditPlanCapabilities, isTableRendererSupportedByRichContentP0, mapTableRendererToRichContentP0, normalizeTableAuthoringDocument, parseLegacyOrTableDocument, providePraxisFilterMetadata, providePraxisTableMetadata, serializeTableAuthoringDocument, toCanonicalTableConfig, validateTableAuthoringDocument };
+export { AnalyticsTableConfigAdapterService, AnalyticsTableContractService, AnalyticsTableStatsApiService, BOOLEAN_PRESETS, BehaviorConfigEditorComponent, CURRENCY_PRESETS, ColumnsConfigEditorComponent, DATE_PRESETS, DataFormatterComponent, DataFormattingService, FORMULA_TEMPLATES, FilterConfigService, FilterSettingsComponent, FormulaGeneratorService, JsonConfigEditorComponent, MessagesLocalizationEditorComponent, NUMBER_PRESETS, PERCENTAGE_PRESETS, PRAXIS_FILTER_COMPONENT_METADATA, PRAXIS_TABLE_AUTHORING_MANIFEST, PRAXIS_TABLE_COMPONENT_METADATA, PraxisFilter, PraxisTable, PraxisTableConfigEditor, PraxisTableInlineAuthoringEditorComponent, PraxisTableToolbar, STRING_PRESETS, TABLE_AI_CAPABILITIES, TABLE_COMPONENT_AI_CAPABILITIES, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_KIND, TABLE_COMPONENT_EDIT_PLAN_VERSION, TASK_PRESETS, TableDefaultsProvider, TableRulesEditorComponent, ToolbarActionsEditorComponent, ValueMappingEditorComponent, VisualFormulaBuilderComponent, buildTableApplyPlan, coerceTableComponentEditPlan, coerceTableComponentEditPlans, compileTableComponentEditPlan, compileTableComponentEditPlans, createTableAuthoringDocument, getActionId, getEnum, getTableCapabilities, getTableComponentEditPlanCapabilities, isTableRendererSupportedByRichContentP0, mapTableRendererToRichContentP0, normalizeTableAuthoringDocument, parseLegacyOrTableDocument, providePraxisFilterMetadata, providePraxisTableMetadata, serializeTableAuthoringDocument, toCanonicalTableConfig, validateTableAuthoringDocument };
 export type { ActionLike, AnalyticsTableConfigAdapterOptions, AnalyticsTableContractDefinition, AnalyticsTableContractLoadOptions, AnalyticsTableContractLoadResult, AnalyticsTableContractSource, AnalyticsTableRow, AnalyticsTableViewModel, ArithmeticParams, BehaviorConfigChange, BooleanFormatterOptions, BulkAction, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, ColumnChange, ColumnDataType$1 as ColumnDataType, ConcatenationParams, ConditionalMappingParams, CurrencyFormatterOptions, DataFormattingOptions, DataMode, DateFormatterOptions, DefaultValueParams, EditorDiagnostic, EditorDocument, FieldSchema, FilterConfig, FilterTag, FormatPreset, FormatterConfig, FormulaDefinition, FormulaParameterSchema, FormulaParams, FormulaTemplate, FormulaType, I18n, JsonEditorEvent, JsonValidationResult, MessagesLocalizationChange, NestedPropertyParams, NumberFormatterOptions, PercentageFormatterOptions, ResourcePathIntent, RowAction, RowExpansionChangeBase, RowExpansionChangeEvent, RowExpansionReasonCode, RowExpansionTrigger, StringFormatterOptions, TableApplyPlan, TableAuthoringDocument, TableBindings, Capability as TableComponentCapability, CapabilityCatalog as TableComponentCapabilityCatalog, CapabilityCategory as TableComponentCapabilityCategory, TableComponentEditChangeKind, TableComponentEditPlan, TableComponentEditPlanCompileResult, ValueKind as TableComponentValueKind, TableHorizontalScroll, TableProjectionContext, TableRichContentP0Node, TableRuntimeContext, TableValidationContext, ToolbarAction, ToolbarActionsChange, ValueKind$1 as ValueKind, ValueMappingPair };

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.2",
+  "version": "8.0.0-beta.20",
   "description": "Advanced data table for Angular (Praxis UI) with editing, filtering, sorting, virtualization, and settings panel integration.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
-    "@praxisui/ai": "^8.0.0-beta.2",
-    "@praxisui/core": "^8.0.0-beta.2",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.2",
-    "@praxisui/dynamic-form": "^8.0.0-beta.2",
-    "@praxisui/metadata-editor": "^8.0.0-beta.2",
-    "@praxisui/rich-content": "^8.0.0-beta.2",
-    "@praxisui/settings-panel": "^8.0.0-beta.2",
-    "@praxisui/table-rule-builder": "^8.0.0-beta.2"
+    "@praxisui/ai": "^8.0.0-beta.20",
+    "@praxisui/core": "^8.0.0-beta.20",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.20",
+    "@praxisui/dynamic-form": "^8.0.0-beta.20",
+    "@praxisui/metadata-editor": "^8.0.0-beta.20",
+    "@praxisui/rich-content": "^8.0.0-beta.20",
+    "@praxisui/settings-panel": "^8.0.0-beta.20",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.20",
+    "@angular/cdk": "^20.0.0",
+    "@angular/forms": "^20.0.0",
+    "@angular/material": "^20.0.0",
+    "@angular/router": "^20.0.0",
+    "@praxisui/dialog": "^8.0.0-beta.20",
+    "rxjs": "~7.8.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"