@praxisui/crud 10.0.0-rc.19 → 10.0.0-rc.21

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "10.0.0-rc.19",
+  "version": "10.0.0-rc.21",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/dynamic-form": "^10.0.0-rc.19",
-    "@praxisui/table": "^10.0.0-rc.19",
-    "@praxisui/core": "^10.0.0-rc.19",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.19",
-    "@praxisui/settings-panel": "^10.0.0-rc.19",
+    "@praxisui/dynamic-form": "^10.0.0-rc.21",
+    "@praxisui/table": "^10.0.0-rc.21",
+    "@praxisui/core": "^10.0.0-rc.21",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.21",
+    "@praxisui/settings-panel": "^10.0.0-rc.21",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.19",
+    "@praxisui/ai": "^10.0.0-rc.21",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud.d.ts

@@ -1,5 +1,5 @@
 import * as _praxisui_core from '@praxisui/core';
-import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, ResourceBulkExecutionContract, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, TableConfig, PraxisKpiBandConfig, PraxisDataQueryContext, FormConfig, ReactiveDeterminationExecutionEvent, DynamicDataRecord, PraxisResourceEvent, PraxisKpiBandCard, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, SurfaceDrawerRef, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider, ResourceActionCatalogItem, ResourceBulkTarget, ColumnDefinition, BulkProposalItemResult, BulkItemResult, ResourceBulkProposalDiagnostic } from '@praxisui/core';
+import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, ResourceBulkExecutionContract, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, TableConfig, PraxisKpiBandConfig, PraxisKpiBandCard, PraxisDataQueryContext, FormConfig, ReactiveDeterminationExecutionEvent, DynamicDataRecord, PraxisResourceEvent, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, SurfaceDrawerRef, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider, ColumnDefinition, ResourceActionCatalogItem, ResourceBulkTarget, BulkProposalItemResult, BulkItemResult, ResourceBulkProposalDiagnostic } from '@praxisui/core';
 export { BackConfig, DynamicDataCollection, DynamicDataRecord, createDynamicRecord, extractRecordId, isDynamicDataRecord, resolveDataField } from '@praxisui/core';
 import * as _angular_core from '@angular/core';
 import { NgZone, OnChanges, TemplateRef, EventEmitter, SimpleChanges, Injector, OnInit, AfterViewInit, Provider, OnDestroy } from '@angular/core';
@@ -50,6 +50,19 @@ declare class DialogService {
 
 type FormOpenMode = 'route' | 'modal' | 'drawer';
 type CrudInteractionMode = 'interactive' | 'inspect-only';
+type CrudKpiCardVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger';
+type CrudKpiCardConfig = PraxisKpiBandCard & {
+    variant?: CrudKpiCardVariant;
+};
+type CrudKpiBandConfig = Omit<PraxisKpiBandConfig, 'cards'> & {
+    cards?: CrudKpiCardConfig[];
+};
+interface CrudFilterBarQuickFilter {
+    id: string;
+    label: string;
+    filter: any;
+    icon?: string;
+}
 interface CrudActionRuntimeEvent {
     action?: string;
     actionConfig?: ToolbarAction | ResourceSurfaceCatalogItem | {
@@ -133,12 +146,7 @@ interface CrudFilterBarConfig {
     /** Campos do DTO de filtro a exibir inline fixos na barra de ferramentas */
     inlineFields?: string[];
     /** Habilitar filtros rápidos (true adota do schema, ou array explícito) */
-    quickFilters?: boolean | Array<{
-        id: string;
-        label: string;
-        filter: any;
-        icon?: string;
-    }>;
+    quickFilters?: boolean | CrudFilterBarQuickFilter[];
     /** Exibir botão para abrir o construtor de filtros avançados (padrão: true) */
     showAdvanced?: boolean;
 }
@@ -159,7 +167,7 @@ interface CrudMetadata {
     table?: CrudTableConfig;
     filterBar?: CrudFilterBarConfig;
     /** Configuração declarativa da faixa de resumo executivo e KPIs (Issue #33) */
-    kpiBand?: PraxisKpiBandConfig;
+    kpiBand?: CrudKpiBandConfig;
     queryContext?: PraxisDataQueryContext | null;
     filterCriteria?: Record<string, unknown> | null;
     form?: FormConfig;
@@ -367,6 +375,9 @@ declare class PraxisCrudComponent implements OnChanges {
     private resolveOpeningActionLabel;
     private hasExplicitOpenBinding;
     getCurrentTableConfigSnapshot(): TableConfig | null;
+    getMaterializedInputSnapshot(_inputNames: readonly string[]): Record<string, unknown>;
+    private cloneResolvedMetadataSnapshot;
+    private buildMaterializedEffectiveTableConfigSnapshot;
     onTableConfigChange(config: TableConfig): void;
     onTableMetadataChange(): void;
     onTableLoadingStateChange(state: LoadingState): void;
@@ -737,9 +748,12 @@ declare function findCrudAction(actions: CrudMetadata['actions'], actionName: st
 type CrudEditorActionKey = 'create' | 'view' | 'edit';
 type CrudEditorActionGroupKey = 'binding' | 'schema' | 'submit' | 'api';
 type CrudEditorParamTarget = CrudParamMapping['to'];
-type CrudEditorSectionKey = 'connection' | 'defaults' | 'actions' | 'table';
+type CrudEditorSectionKey = 'connection' | 'defaults' | 'actions' | 'kpis' | 'filters' | 'table';
 type CrudEditorSectionStatus = 'ready' | 'pending' | 'invalid';
 type CrudEditorHealthBucket = 'ready' | 'pending' | 'invalid';
+type CrudEditorKpiFilterMode = 'none' | 'clear' | 'condition';
+type CrudEditorQuickFilterMode = 'inherit' | 'disabled' | 'custom';
+type CrudEditorQuickConditionMode = 'clear' | 'fieldEquals' | 'expression';
 type CrudEditorDiagnosticIssue = ReturnType<typeof validateCrudAuthoringDocument>[number];
 type CrudEditorPayload = {
     document: CrudAuthoringDocument;
@@ -752,10 +766,12 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     readonly metadataInput: _angular_core.InputSignal<CrudMetadata | null>;
     readonly crudIdInput: _angular_core.InputSignal<string | null>;
     readonly readonlyInput: _angular_core.InputSignal<boolean>;
+    readonly effectiveTableConfigInput: _angular_core.InputSignal<_praxisui_core.TableConfigModern | null>;
     readonly isDirty$: BehaviorSubject<boolean>;
     readonly isValid$: BehaviorSubject<boolean>;
     readonly isBusy$: BehaviorSubject<boolean>;
     readonly actionKeys: CrudEditorActionKey[];
+    readonly sectionKeys: CrudEditorSectionKey[];
     readonly healthBuckets: CrudEditorHealthBucket[];
     readonly openModes: FormOpenMode[];
     readonly headerVariants: readonly ["ghost", "tonal", "outlined"];
@@ -763,14 +779,34 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     readonly modalDensities: readonly ["default", "compact"];
     readonly backStrategies: readonly ["auto", "close", "navigate"];
     readonly paramTargets: ("routeParam" | "query" | "input")[];
+    readonly kpiVariants: CrudKpiCardVariant[];
+    readonly kpiFilterModes: CrudEditorKpiFilterMode[];
+    readonly quickFilterModes: CrudEditorQuickFilterMode[];
+    readonly quickConditionModes: CrudEditorQuickConditionMode[];
+    readonly selectedTabIndex: _angular_core.WritableSignal<number>;
+    readonly inlineFieldDraft: _angular_core.WritableSignal<string>;
     private readonly initialValueDrafts;
+    private readonly kpiFilterJsonDrafts;
+    private readonly quickFilterExpressionDrafts;
+    private readonly schemaResolvedColumnsSignal;
+    private readonly schemaResolvedFilterFieldsSignal;
+    private readonly destroyRef;
+    private readonly hostRef;
+    private readonly crudService;
     private readonly injectedData;
     private readonly i18n;
     private readonly currentDocument;
     private readonly initialDocument;
     private lastExternalSignature;
+    private lastLoadedResourceSignature;
+    private schemaSub?;
+    private schemaScopeSignature;
+    private schemaGeneration;
+    private destroyed;
     readonly effectiveCrudId: _angular_core.Signal<string | null>;
     readonly isReadonly: _angular_core.Signal<boolean>;
+    readonly providedEffectiveTableConfig: _angular_core.Signal<_praxisui_core.TableConfigModern | null>;
+    private readonly providedSnapshotOwner;
     readonly diagnostics: _angular_core.Signal<_praxisui_crud.CrudEditorDiagnostic[]>;
     readonly errorCount: _angular_core.Signal<number>;
     readonly warningCount: _angular_core.Signal<number>;
@@ -779,6 +815,25 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     readonly resourcePath: _angular_core.Signal<string>;
     readonly resourceIdField: _angular_core.Signal<string>;
     readonly resourceEndpointKey: _angular_core.Signal<string>;
+    readonly resourceChangedSinceInit: _angular_core.Signal<boolean>;
+    readonly authoredTableColumns: _angular_core.Signal<ColumnDefinition[]>;
+    readonly resolvedInheritedColumns: _angular_core.Signal<ColumnDefinition[]>;
+    readonly effectiveTableColumns: _angular_core.Signal<ColumnDefinition[]>;
+    readonly isUsingInheritedResourceColumns: _angular_core.Signal<boolean>;
+    readonly effectiveTableConfigForEditor: _angular_core.Signal<_praxisui_core.TableConfigModern>;
+    readonly availableResourceFieldOptions: _angular_core.Signal<{
+        field: string;
+        header: string;
+    }[]>;
+    readonly effectiveKpiBand: _angular_core.Signal<CrudKpiBandConfig | null>;
+    readonly kpiBandEnabled: _angular_core.Signal<boolean>;
+    readonly kpiCards: _angular_core.Signal<CrudKpiCardConfig[]>;
+    readonly kpiBandPreviewConfig: _angular_core.Signal<CrudKpiBandConfig>;
+    readonly effectiveFilterBar: _angular_core.Signal<CrudFilterBarConfig | null>;
+    readonly filterBarShowAdvanced: _angular_core.Signal<boolean>;
+    readonly filterBarInlineFields: _angular_core.Signal<string[]>;
+    readonly filterBarQuickMode: _angular_core.Signal<CrudEditorQuickFilterMode>;
+    readonly filterBarQuickFilters: _angular_core.Signal<CrudFilterBarQuickFilter[]>;
     readonly defaultsOpenMode: _angular_core.Signal<FormOpenMode>;
     readonly headerShowBack: _angular_core.Signal<boolean>;
     readonly headerBackLabel: _angular_core.Signal<string>;
@@ -852,12 +907,20 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     backDefaultsNote(): string;
     actionsOverview(): string;
     actionsOverviewNote(): string;
+    kpisOverview(): string;
+    kpisOverviewNote(): string;
+    filtersOverview(): string;
+    filtersOverviewNote(): string;
     tableOverview(): string;
     tableOverviewNote(): string;
     tableStructureSummary(): string;
     tableBehaviorSummary(): string;
     tableStatesSummary(): string;
     tableEditingFlowSummary(): string;
+    inheritedColumnsCountLabel(): string;
+    inheritedColumnsNote(): string;
+    focusTableColumnsAuthoring(): void;
+    resetToInheritedColumns(): void;
     validationOverview(): string;
     validationOverviewNote(): string;
     jsonSectionSummary(): string;
@@ -877,6 +940,42 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     variantLabel(variant: (typeof HEADER_VARIANTS)[number]): string;
     modalDensityLabel(density: string): string;
     backStrategyLabel(strategy: string): string;
+    kpiCardTitle(index: number, card: CrudKpiCardConfig): string;
+    kpiVariantLabel(variant: CrudKpiCardVariant): string;
+    kpiFilterModeLabel(mode: CrudEditorKpiFilterMode): string;
+    kpiCardVariant(card: CrudKpiCardConfig): CrudKpiCardVariant;
+    kpiCardFilterMode(index: number): CrudEditorKpiFilterMode;
+    kpiCardFilterField(index: number): string;
+    kpiCardFilterValue(index: number): string;
+    kpiCardFilterJsonDraft(index: number): string;
+    setKpiBandEnabled(enabled: boolean): void;
+    addKpiCard(): void;
+    removeKpiCard(index: number): void;
+    moveKpiCard(index: number, delta: -1 | 1): void;
+    setKpiCardField(index: number, field: 'id' | 'label' | 'value' | 'caption' | 'icon', value: unknown): void;
+    setKpiCardVariant(index: number, variant: CrudKpiCardVariant): void;
+    setKpiCardFilterMode(index: number, mode: CrudEditorKpiFilterMode): void;
+    setKpiCardFilterCondition(index: number, field: string, rawValue: string): void;
+    setKpiCardFilterJson(index: number, raw: string): void;
+    quickFilterModeLabel(mode: CrudEditorQuickFilterMode): string;
+    quickConditionModeLabel(mode: CrudEditorQuickConditionMode): string;
+    setFilterBarShowAdvanced(showAdvanced: boolean): void;
+    addInlineFilterField(field: string): void;
+    addInlineFilterFieldFromDraft(): void;
+    removeInlineFilterField(field: string): void;
+    toggleInlineFilterField(field: string): void;
+    setFilterBarQuickMode(mode: CrudEditorQuickFilterMode): void;
+    addQuickFilter(): void;
+    removeQuickFilter(index: number): void;
+    moveQuickFilter(index: number, delta: -1 | 1): void;
+    setQuickFilterField(index: number, field: 'id' | 'label' | 'icon', value: unknown): void;
+    quickFilterConditionMode(index: number): CrudEditorQuickConditionMode;
+    setQuickFilterConditionMode(index: number, mode: CrudEditorQuickConditionMode): void;
+    quickFilterConditionField(index: number): string;
+    quickFilterConditionValue(index: number): string;
+    setQuickFilterFieldEquals(index: number, field: string, rawValue: string): void;
+    quickFilterExpressionDraft(index: number): string;
+    setQuickFilterExpression(index: number, raw: string): void;
     private actionInputsSummaryBadge;
     paramTargetLabel(target: CrudEditorParamTarget): string;
     diagnosticMessage(code: string, fallback: string): string;
@@ -894,6 +993,15 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     setActionBackField(actionName: CrudEditorActionKey, field: 'strategy' | 'returnTo' | 'confirmOnDirty', value: unknown): void;
     setActionApiUrlEntry(actionName: CrudEditorActionKey, raw: string): void;
     setTableConfig(config: TableConfig): void;
+    private updateKpiBand;
+    private patchKpiCard;
+    private clearKpiFilterJsonDraft;
+    private updateFilterBar;
+    private patchQuickFilter;
+    private resourceSchemaIdentity;
+    private synchronizeSchemaScope;
+    private invalidateSchemaScope;
+    private loadResourceSchemaColumns;
     private patchAction;
     private updateMetadata;
     private buildPayload;
@@ -909,7 +1017,7 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     private prioritizedActionKey;
     sectionDisplayLabel(section: CrudEditorSectionKey): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CrudMetadataEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CrudMetadataEditorComponent, "praxis-crud-metadata-editor", never, { "documentInput": { "alias": "document"; "required": false; "isSignal": true; }; "metadataInput": { "alias": "metadata"; "required": false; "isSignal": true; }; "crudIdInput": { "alias": "crudId"; "required": false; "isSignal": true; }; "readonlyInput": { "alias": "readonly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CrudMetadataEditorComponent, "praxis-crud-metadata-editor", never, { "documentInput": { "alias": "document"; "required": false; "isSignal": true; }; "metadataInput": { "alias": "metadata"; "required": false; "isSignal": true; }; "crudIdInput": { "alias": "crudId"; "required": false; "isSignal": true; }; "readonlyInput": { "alias": "readonly"; "required": false; "isSignal": true; }; "effectiveTableConfigInput": { "alias": "effectiveTableConfig"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface PraxisCrudWidgetEditorInputs {
@@ -927,6 +1035,7 @@ interface PraxisCrudWidgetEditorValue {
 }
 declare class PraxisCrudWidgetConfigEditor implements SettingsValueProvider, AfterViewInit, OnDestroy {
     inputs: PraxisCrudWidgetEditorInputs | null;
+    context: Record<string, unknown> | null;
     widgetKey?: string;
     crudEditor?: CrudMetadataEditorComponent;
     readonly isDirty$: BehaviorSubject<boolean>;
@@ -936,15 +1045,17 @@ declare class PraxisCrudWidgetConfigEditor implements SettingsValueProvider, Aft
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     get metadata(): CrudMetadata;
+    get effectiveTableConfig(): TableConfig | null;
     get effectiveCrudId(): string | null;
     getSettingsValue(): PraxisCrudWidgetEditorValue;
     onSave(): PraxisCrudWidgetEditorValue;
     reset(): void;
     private buildValue;
+    private sanitizePersistedContext;
     private createDocumentFromInputs;
     private extractDocument;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisCrudWidgetConfigEditor, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudWidgetConfigEditor, "praxis-crud-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudWidgetConfigEditor, "praxis-crud-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "context": { "alias": "context"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 type OpenCrudMetadataEditorOptions = {
@@ -953,6 +1064,7 @@ type OpenCrudMetadataEditorOptions = {
     titleIcon?: string;
     document?: CrudAuthoringDocument | null;
     metadata?: CrudMetadata | null;
+    effectiveTableConfig?: TableConfig | null;
     crudId?: string;
     readonly?: boolean;
 };
@@ -1313,4 +1425,4 @@ declare class PraxisBulkEditDialogComponent {
 }
 
 export { CRUD_AI_CAPABILITIES, CrudLauncherService, CrudMetadataEditorComponent, CrudPageHeaderComponent, DialogService, DynamicFormDialogHostComponent, PRAXIS_CRUD_AUTHORING_MANIFEST, PRAXIS_CRUD_COMPONENT_METADATA, PraxisBulkEditDialogComponent, PraxisBulkOperationDialogComponent, PraxisCrudComponent, PraxisCrudWidgetConfigEditor, PraxisKpiBandComponent, PraxisResourcePage, assertCrudMetadata, createCrudAuthoringDocument, findCrudAction, formatKpiValue, normalizeCrudAuthoringDocument, openCrudMetadataEditor, parseLegacyOrCrudDocument, providePraxisCrudMetadata, serializeCrudAuthoringDocument, validateCrudAuthoringDocument };
-export type { BulkDialogStep, BulkEditStep, Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudActionRuntimeEvent, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudFilterBarConfig, CrudFormReactiveDeterminationStabilityChange, CrudHeaderConfig, CrudHeaderVariant, CrudInteractionMode, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudReactiveDeterminationStabilityChange, CrudReactiveDeterminationStabilityStatus, CrudResource, CrudTableConfig, CrudValidationContext, DialogConfig, DialogRef, EvaluatedKpiCard, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisBulkEditDialogData, PraxisBulkOperationDialogData, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, PraxisResourceDomainBadge, PraxisResourceScopeBarConfig, ValueKind };
+export type { BulkDialogStep, BulkEditStep, Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudActionRuntimeEvent, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudFilterBarConfig, CrudFilterBarQuickFilter, CrudFormReactiveDeterminationStabilityChange, CrudHeaderConfig, CrudHeaderVariant, CrudInteractionMode, CrudKpiBandConfig, CrudKpiCardConfig, CrudKpiCardVariant, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudReactiveDeterminationStabilityChange, CrudReactiveDeterminationStabilityStatus, CrudResource, CrudTableConfig, CrudValidationContext, DialogConfig, DialogRef, EvaluatedKpiCard, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisBulkEditDialogData, PraxisBulkOperationDialogData, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, PraxisResourceDomainBadge, PraxisResourceScopeBarConfig, ValueKind };