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

package/index.d.ts

@@ -10,16 +10,15 @@ 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, 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 { TableConfig, LoggerService, PraxisI18nService, GlobalConfigService, AsyncConfigStorage, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ConnectionStorage, ResourceDiscoveryService, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, TableDetailRichListNode, TableDetailCardGridNode, TableDetailCardGridCardNode, TableDetailTimelineNode, JsonLogicDataRecord, TableDetailListItemAction, TableDetailActionBarNode, TableDetailActionBarAction, TableDetailRefNode, TableDetailTemplateRefNode, TableDetailDiagramEmbedNode, TableDetailEmbedAction, GlobalActionRef, PraxisRuntimeGlobalActionEffect, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, JsonLogicExpression, GlobalActionCatalogEntry, IconPickerService, SurfaceOpenPayload, GlobalActionField, FieldDefinition, PraxisRuntimeConditionalEffectRule, PraxisJsonLogicService, TableConfigService, SettingsValueProvider as SettingsValueProvider$1, 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';
 import { PraxisDialog } from '@praxisui/dialog';
-import { PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
+import { PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
+import { HttpClient } from '@angular/common/http';
 import { MatTabChangeEvent } from '@angular/material/tabs';
-import * as _praxisui_table_rule_builder from '@praxisui/table-rule-builder';
 import { RuleEffectDefinition } from '@praxisui/table-rule-builder';
-import { HttpClient } from '@angular/common/http';
 import * as _angular_material_paginator_d_Zo1cMMo4 from '@angular/material/paginator.d-Zo1cMMo4';
 import { MatCheckboxChange } from '@angular/material/checkbox';
 
@@ -762,6 +761,49 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
 declare const PRAXIS_FILTER_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisFilterMetadata(): Provider;
 
+type AnalyticsTableRow = Record<string, string | number | boolean | null>;
+type AnalyticsTableContractSource = 'remote' | 'fallback';
+interface AnalyticsTableViewModel {
+    config: TableConfig;
+    data: AnalyticsTableRow[];
+}
+interface AnalyticsTableContractDefinition<TKey extends string = string> {
+    key: TKey;
+    projectionId: string;
+    path: string;
+    title: PraxisTextValue;
+    subtitle?: PraxisTextValue;
+    fallbackProjection: PraxisAnalyticsProjection;
+    fallbackRows?: AnalyticsTableRow[];
+}
+interface AnalyticsTableContractLoadOptions<TKey extends string = string> {
+    cacheNamespace?: string;
+    queryContexts?: Partial<Record<TKey, PraxisDataQueryContext | null>>;
+}
+interface AnalyticsTableContractLoadResult<TKey extends string = string> {
+    views: Record<TKey, AnalyticsTableViewModel>;
+    sources: Record<TKey, AnalyticsTableContractSource>;
+    errors: Partial<Record<TKey, string>>;
+}
+
+declare class AnalyticsTableStatsApiService {
+    private readonly http;
+    private readonly apiUrl;
+    private readonly statsBuilder;
+    constructor(http: HttpClient, apiUrl: ApiUrlConfig);
+    execute(projection: PraxisAnalyticsProjection, queryContext?: PraxisDataQueryContext | null): Promise<AnalyticsTableRow[]>;
+    private toTableRows;
+    private resolveTimeSeriesCategory;
+    private resolveBucketCategory;
+    private projectMetricValues;
+    private resolveMetricValue;
+    private buildStatsUrl;
+    private applyQueryContext;
+    private normalizeError;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AnalyticsTableStatsApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AnalyticsTableStatsApiService>;
+}
+
 type SchemaFieldHint = {
     name: string;
     label?: string;
@@ -844,6 +886,7 @@ type RuntimeRowAction = {
     id: string;
     action: string;
     globalAction?: GlobalActionRef;
+    effects?: PraxisRuntimeGlobalActionEffect[];
     label?: string;
     icon?: string;
     color?: string;
@@ -882,6 +925,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private loadingRenderer?;
     private route?;
     private logger?;
+    private analyticsStatsApi?;
     private static readonly CELL_ANIMATION_CHANGE_CACHE_LIMIT;
     private static readonly ROW_DISCOVERY_SUCCESS_CACHE_TTL_MS;
     private static readonly ROW_DISCOVERY_ERROR_CACHE_TTL_MS;
@@ -963,6 +1007,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private lastResolvedDataMode;
     private localFilterFieldMetadataCache;
     private localFilterFieldMetadataCacheKey;
+    private analyticsLoadSequence;
     private uncontrolledExpandedRowKeys;
     private readonly expansionOpaqueRefCacheLimit;
     private expansionOpaqueRefByRowKey;
@@ -1040,6 +1085,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     hasBottomPaginator(): boolean;
     hasExplicitResourcePath(): boolean;
     hasLocalDataInput(): boolean;
+    hasAnalyticsProjectionInput(): boolean;
     getDataMode(): DataMode;
     isRemoteMode(): boolean;
     isLocalMode(): boolean;
@@ -1096,7 +1142,9 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private aiAssistantController;
     private aiAssistantStateSubscription;
     private readonly aiApi;
+    private readonly assistantSessions;
     private readonly aiTurnOrchestrator;
+    private readonly aiAssistantSessionEffect;
     private computedContextCache;
     private computedFieldNames;
     private readonly jsonLogic;
@@ -1145,19 +1193,32 @@ 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, globalActions: GlobalActionService, 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, analyticsStatsApi?: AnalyticsTableStatsApiService | undefined);
     private ensureAiAdapterLoaded;
     openAiAssistant(): void;
+    aiAssistantTriggerTestId(position: string): string;
+    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;
     private emitLoadingState;
     private hasResolvedRemoteDataLoad;
     private isTableDataLoading;
@@ -1384,6 +1445,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private emitEventWithActionFeedback;
     private executeConfiguredGlobalAction;
     private resolveConfiguredGlobalActionRef;
+    private resolveActionGlobalActionRef;
     private resolveGlobalActionPayload;
     private buildGlobalActionTemplateContext;
     private resolveGlobalActionTemplateValue;
@@ -1551,6 +1613,8 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private pruneRowDiscoveryCaches;
     private pruneRowDiscoveryCache;
     private fetchData;
+    private resolveAnalyticsProjection;
+    private fetchAnalyticsProjectionData;
     private getEffectiveFilterCriteria;
     retryData(): void;
     reloadSchema(): void;
@@ -1570,6 +1634,19 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private resolveImplicitFormat;
     getCellClasses(rowData: any, column: ColumnDefinition): string[] | undefined;
     getCellNgStyle(rowData: any, column: ColumnDefinition): Record<string, string> | undefined;
+    private normalizeConditionalStyleRules;
+    private normalizeConditionalStyleRecord;
+    private normalizeConditionalStyleEffects;
+    private hasConditionalStyleEffectPayload;
+    private resolveConditionalStyleClasses;
+    private resolveConditionalStyleObject;
+    private compileConditionalStyleEffect;
+    private normalizeConditionalRendererRules;
+    private normalizeObjectRecord;
+    private buildColumnRendererOverrideFromEffects;
+    private buildColumnRendererFromEffect;
+    private resolveRuleAnimationFromEffects;
+    private resolveRowTooltipFromEffects;
     private resetComputedContextCache;
     private ensureEffectiveCellRenderCache;
     private ensureCellAnimationPreviousValuesByRowId;
@@ -1581,6 +1658,11 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private buildComputedSignature;
     private stringifyDependencyValue;
     private buildComputedValueMap;
+    private collectComputedColumns;
+    private evaluateCanonicalComputedColumns;
+    private collectComputedExpressionDependencies;
+    private collectJsonLogicVarDependencies;
+    private resolveJsonLogicVarPath;
     private buildEvaluationContext;
     private getJsonLogicEvaluationOptions;
     private resolveJsonLogicUserTimeZone;
@@ -1886,8 +1968,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, 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 ɵ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; }, { 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; }; "horizontalScroll": { "alias": "horizontalScroll"; "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;
 }
 
@@ -2429,6 +2511,7 @@ interface ToolbarAction {
     appearance?: 'filled' | 'outlined' | 'elevated' | 'text' | 'tonal';
     action: string;
     globalAction?: GlobalActionRef;
+    effects?: PraxisRuntimeGlobalActionEffect[];
     position: 'start' | 'end';
     order?: number;
     disabled?: boolean;
@@ -2436,7 +2519,7 @@ interface ToolbarAction {
     shortcut?: string;
     shortcutScope?: 'toolbar' | 'global';
     tooltip?: string;
-    visibleWhen?: string;
+    visibleWhen?: JsonLogicExpression | null;
     children?: ToolbarAction[];
 }
 interface RowAction {
@@ -2445,11 +2528,14 @@ interface RowAction {
     icon: string;
     action: string;
     globalAction?: GlobalActionRef;
+    effects?: PraxisRuntimeGlobalActionEffect[];
     color?: 'primary' | 'accent' | 'warn';
     tooltip?: string;
     requiresConfirmation?: boolean;
     autoDelete?: boolean;
     separator?: boolean;
+    visibleWhen?: JsonLogicExpression | null;
+    disabledWhen?: JsonLogicExpression | null;
     conditional?: string;
 }
 interface BulkAction {
@@ -2458,6 +2544,7 @@ interface BulkAction {
     icon: string;
     action: string;
     globalAction?: GlobalActionRef;
+    effects?: PraxisRuntimeGlobalActionEffect[];
     color?: 'primary' | 'accent' | 'warn';
     tooltip?: string;
     requiresConfirmation?: boolean;
@@ -2484,8 +2571,11 @@ type EditableTableAction = {
     label?: string;
     action?: string;
     globalAction?: GlobalActionRef;
+    effects?: PraxisRuntimeGlobalActionEffect[];
     position?: string;
     appearance?: string;
+    visibleWhen?: JsonLogicExpression | null;
+    disabledWhen?: JsonLogicExpression | null;
 };
 type ToolbarShortcutScope = 'toolbar' | 'global';
 interface InternalActionSpec {
@@ -2552,14 +2642,16 @@ declare class ToolbarActionsEditorComponent implements OnInit, OnDestroy, OnChan
     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;
+    getCanonicalGlobalActionRef(action?: EditableTableAction): GlobalActionRef | undefined;
+    private setCanonicalGlobalActionRef;
     private touchActionList;
+    getActionJsonLogicText(action: EditableTableAction, key: 'visibleWhen' | 'disabledWhen'): string;
+    onActionJsonLogicChange(action: EditableTableAction, key: 'visibleWhen' | 'disabledWhen', value: string, kind: 'toolbar' | 'row' | 'bulk'): void;
+    getActionConditionError(action: EditableTableAction, key: 'visibleWhen' | 'disabledWhen'): string;
     isGlobalActionId(id?: string): boolean;
     getGlobalActionSchema(action: EditableTableAction): _praxisui_core.GlobalActionUiSchema | undefined;
     getSurfaceOpenActionPayload(action: EditableTableAction): SurfaceOpenPayload;
-    onSurfaceOpenActionPayloadChange(action: {
-        action?: string;
-        globalAction?: GlobalActionRef;
-    }, payload: SurfaceOpenPayload, kind: 'toolbar' | 'row' | 'bulk'): void;
+    onSurfaceOpenActionPayloadChange(action: EditableTableAction, payload: SurfaceOpenPayload, kind: 'toolbar' | 'row' | 'bulk'): void;
     shouldShowGlobalActionField(action: EditableTableAction, field: GlobalActionField): boolean;
     isGlobalActionFieldRequired(action: EditableTableAction, field: GlobalActionField): boolean;
     isGlobalActionFieldMissing(action: EditableTableAction, field: GlobalActionField): boolean;
@@ -2926,12 +3018,10 @@ declare class RuleCompilerService {
     static ɵprov: i0.ɵɵInjectableDeclaration<RuleCompilerService>;
 }
 
-type RuleItem = {
-    condition: JsonLogicExpression;
+type RuleItem = Omit<PraxisRuntimeConditionalEffectRule<RuleEffectDefinition>, 'effects'> & {
     cssClass?: string;
     style?: Record<string, string>;
-    description?: string;
-    effects?: _praxisui_table_rule_builder.RuleEffectDefinition;
+    effects?: RuleEffectDefinition[];
     enabled?: boolean;
 };
 declare class TableRulesEditorComponent implements OnChanges, OnInit, OnDestroy {
@@ -3001,6 +3091,7 @@ declare class TableRulesEditorComponent implements OnChanges, OnInit, OnDestroy
     onColumnSelect(field: string): void;
     private initFromConfig;
     private loadColumnRules;
+    private normalizePersistedRules;
     rebuildCondition(): void;
     onDraftChange(): void;
     applyTextPreset(preset: string): void;
@@ -3027,6 +3118,8 @@ declare class TableRulesEditorComponent implements OnChanges, OnInit, OnDestroy
     onExportRules(): void;
     onImportRules(): void;
     private sanitizeRule;
+    private normalizeRuleEffects;
+    getPrimaryEffect(r: RuleItem | null | undefined): RuleEffectDefinition | undefined;
     getAnimationLabel(r: RuleItem): string | null;
     private normalizeRendererAnimation;
     private buildRendererOverrideFromRule;
@@ -3225,7 +3318,6 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
     private updateColumnMetas;
     private updateCanSaveState;
     private collectGlobalActionValidationIssues;
-    private collectGlobalActionValidationTargets;
     private findGlobalActionCatalogEntry;
     private buildGlobalActionCatalog;
     private subscribeCrudEditorChanges;
@@ -3299,6 +3391,107 @@ declare class PraxisTableConfigEditor implements OnInit, OnDestroy, SettingsValu
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableConfigEditor, "praxis-table-config-editor", never, {}, {}, never, never, true, never>;
 }
 
+interface PraxisTableWidgetEditorInputs {
+    config?: TableConfig | null;
+    resourcePath?: string | null;
+    horizontalScroll?: 'auto' | 'wrap' | 'none';
+    tableId?: string;
+    componentInstanceId?: string;
+    [key: string]: unknown;
+}
+interface PraxisTableWidgetEditorValue {
+    inputs: PraxisTableWidgetEditorInputs;
+}
+declare class PraxisTableWidgetConfigEditor implements SettingsValueProvider$1, AfterViewInit, OnDestroy {
+    inputs: PraxisTableWidgetEditorInputs | null;
+    widgetKey?: string;
+    tableEditor?: PraxisTableConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisTableWidgetEditorValue;
+    onSave(): PraxisTableWidgetEditorValue;
+    reset(): void;
+    private initializeChildEditor;
+    private buildValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTableWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableWidgetConfigEditor, "praxis-table-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+interface PraxisFilterWidgetEditorInputs {
+    resourcePath?: string | null;
+    fieldMetadata?: FieldMetadata[] | null;
+    filterId?: string;
+    formId?: string;
+    componentInstanceId?: string;
+    alwaysVisibleFields?: string[];
+    alwaysVisibleFieldMetadataOverrides?: Record<string, Record<string, unknown>>;
+    selectedFieldIds?: string[];
+    allowSaveTags?: boolean;
+    changeDebounceMs?: number;
+    placeBooleansInActions?: boolean;
+    showToggleLabels?: boolean;
+    alwaysMinWidth?: number;
+    alwaysColsMd?: number;
+    alwaysColsLg?: number;
+    confirmTagDelete?: boolean;
+    tagColor?: 'primary' | 'accent' | 'warn' | 'basic';
+    tagVariant?: 'filled' | 'outlined';
+    tagButtonColor?: 'primary' | 'accent' | 'warn' | 'basic';
+    actionsButtonColor?: 'primary' | 'accent' | 'warn' | 'basic';
+    actionsVariant?: 'standard' | 'outlined';
+    useInlineSearchableSelectVariant?: boolean;
+    useInlineRangeVariant?: boolean;
+    useInlineDateVariant?: boolean;
+    useInlineDateRangeVariant?: boolean;
+    useInlineTimeVariant?: boolean;
+    useInlineTimeRangeVariant?: boolean;
+    useInlineTreeSelectVariant?: boolean;
+    overlayVariant?: 'card' | 'frosted';
+    overlayBackdrop?: boolean;
+    advancedOpenMode?: 'modal' | 'drawer';
+    advancedClearButtonsEnabled?: boolean;
+    persistenceKey?: string;
+    showFilterSettings?: boolean;
+    enableCustomization?: boolean;
+    [key: string]: unknown;
+}
+interface PraxisFilterWidgetEditorValue {
+    inputs: PraxisFilterWidgetEditorInputs;
+}
+declare class PraxisFilterWidgetConfigEditor implements SettingsValueProvider$1, OnDestroy {
+    widgetKey?: string;
+    set inputs(value: PraxisFilterWidgetEditorInputs | null);
+    get inputs(): PraxisFilterWidgetEditorInputs | null;
+    set filterSettings(component: FilterSettingsComponent | undefined);
+    metadata: FieldMetadata[];
+    settings: FilterConfig;
+    configKey?: string;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private currentInputs;
+    private settingsEditor?;
+    private subscription;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisFilterWidgetEditorValue;
+    onSave(): PraxisFilterWidgetEditorValue;
+    reset(): void;
+    private buildValue;
+    private buildSettingsFromInputs;
+    private projectSettingsToInputs;
+    private normalizeSettings;
+    private normalizeAdvancedOpenMode;
+    private normalizeOverlayVariant;
+    private cloneStringArray;
+    private cloneRecord;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisFilterWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisFilterWidgetConfigEditor, "praxis-filter-widget-config-editor", never, { "widgetKey": { "alias": "widgetKey"; "required": false; }; "inputs": { "alias": "inputs"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare class DataFormatterComponent implements OnInit, OnChanges {
     private cdr;
     private formattingService;
@@ -3367,31 +3560,6 @@ declare class DataFormatterComponent implements OnInit, OnChanges {
     static ɵcmp: i0.ɵɵComponentDeclaration<DataFormatterComponent, "data-formatter", never, { "columnType": { "alias": "columnType"; "required": false; }; "currentFormat": { "alias": "currentFormat"; "required": false; }; }, { "formatChange": "formatChange"; }, never, never, true, never>;
 }
 
-type AnalyticsTableRow = Record<string, string | number | boolean | null>;
-type AnalyticsTableContractSource = 'remote' | 'fallback';
-interface AnalyticsTableViewModel {
-    config: TableConfig;
-    data: AnalyticsTableRow[];
-}
-interface AnalyticsTableContractDefinition<TKey extends string = string> {
-    key: TKey;
-    projectionId: string;
-    path: string;
-    title: PraxisTextValue;
-    subtitle?: PraxisTextValue;
-    fallbackProjection: PraxisAnalyticsProjection;
-    fallbackRows?: AnalyticsTableRow[];
-}
-interface AnalyticsTableContractLoadOptions<TKey extends string = string> {
-    cacheNamespace?: string;
-    queryContexts?: Partial<Record<TKey, PraxisDataQueryContext | null>>;
-}
-interface AnalyticsTableContractLoadResult<TKey extends string = string> {
-    views: Record<TKey, AnalyticsTableViewModel>;
-    sources: Record<TKey, AnalyticsTableContractSource>;
-    errors: Partial<Record<TKey, string>>;
-}
-
 interface AnalyticsTableConfigAdapterOptions {
     title?: PraxisTextValue;
     subtitle?: PraxisTextValue;
@@ -3405,24 +3573,6 @@ declare class AnalyticsTableConfigAdapterService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AnalyticsTableConfigAdapterService>;
 }
 
-declare class AnalyticsTableStatsApiService {
-    private readonly http;
-    private readonly apiUrl;
-    private readonly statsBuilder;
-    constructor(http: HttpClient, apiUrl: ApiUrlConfig);
-    execute(projection: PraxisAnalyticsProjection, queryContext?: PraxisDataQueryContext | null): Promise<AnalyticsTableRow[]>;
-    private toTableRows;
-    private resolveTimeSeriesCategory;
-    private resolveBucketCategory;
-    private projectMetricValues;
-    private resolveMetricValue;
-    private buildStatsUrl;
-    private applyQueryContext;
-    private normalizeError;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AnalyticsTableStatsApiService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AnalyticsTableStatsApiService>;
-}
-
 declare class AnalyticsTableContractService {
     private readonly analyticsSchema;
     private readonly resolver;
@@ -4064,5 +4214,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_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 };
+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, PraxisFilterWidgetConfigEditor, PraxisTable, PraxisTableConfigEditor, PraxisTableInlineAuthoringEditorComponent, PraxisTableToolbar, PraxisTableWidgetConfigEditor, 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, PraxisFilterWidgetEditorInputs, PraxisFilterWidgetEditorValue, PraxisTableWidgetEditorInputs, PraxisTableWidgetEditorValue, 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,23 +1,23 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.20",
+  "version": "8.0.0-beta.21",
   "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.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",
+    "@praxisui/ai": "^8.0.0-beta.21",
+    "@praxisui/core": "^8.0.0-beta.21",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.21",
+    "@praxisui/dynamic-form": "^8.0.0-beta.21",
+    "@praxisui/metadata-editor": "^8.0.0-beta.21",
+    "@praxisui/rich-content": "^8.0.0-beta.21",
+    "@praxisui/settings-panel": "^8.0.0-beta.21",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.21",
     "@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",
+    "@praxisui/dialog": "^8.0.0-beta.21",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-table.json-api.md

@@ -321,6 +321,11 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 
 ### Toolbar contract
 
+- Acoes globais de toolbar, row e bulk usam `effects[].kind = "global-action"` como envelope canonico de novo authoring.
+  O campo `globalAction` plano continua aceito como fallback compatibilidade, mas nao e a superficie preferida.
+- `payloadExpr` e escape avancado explicito de `GlobalActionRef`; visual authoring deve preferir `payload` estruturado e
+  preservar `payloadExpr` existente apenas quando a mesma `actionId` for mantida.
+
 - O bloco `toolbar` continua parte do contrato público principal.
 - Use `toolbar.actions[]` para quick actions e `toolbar.search` para busca quando o host não injeta shell própria.
 - Para localizar paths específicos de toolbar, complemente a leitura com o `Appendix: JSON path index`.
@@ -673,6 +678,11 @@ Snippets curtos (prontos para cards de overview):
 
 ### Internal route global action
 
+Configuracoes novas devem persistir a integracao em `effects[].globalAction`. O runtime e os validadores tambem
+leem `globalAction` plano para documentos existentes, mas editores e AI manifest devem tratar esse campo como
+compatibilidade. O adapter da Table preserva `payload`/`payloadExpr` ao reabrir e re-selecionar a mesma `actionId`,
+e limpa payloads ao trocar de global action para evitar semantica cruzada.
+
 ```json
 {
   "actions": {
@@ -800,7 +810,7 @@ Frontend (UI):
 | `praxis-table-toolbar` | Barra superior/inferior com acoes, bulk e export | `toolbar`, `actions`, `export`, `behavior.filtering.*` |
 | `praxis-filter` | Filtro avancado acoplado a toolbar | `behavior.filtering.advancedFilters.*`, `behavior.filtering.debounceTime`, `resourcePath` |
 | `praxis-empty-state-card` | Estado inicial quando nao ha conexao remota | exibido quando nao ha `resourcePath` valido |
-| `praxis-ai-assistant` | Assistente opcional nos slots de toolbar | habilitado pelo runtime (nao exposto no JSON) |
+| `PraxisAiAssistantShellComponent` | Copiloto semantico opcional nos slots de toolbar | habilitado pelo runtime com turn orchestration e contexto seguro (nao exposto no JSON) |
 | Angular Material + CDK | Base de tabela, menus, selecao e virtual scroll | `behavior.pagination.*`, `behavior.selection.*`, `behavior.virtualization.*`, `appearance.spacing.*` |
 
 Backend e contratos: