@praxisui/crud 9.0.5-rc.9 → 9.0.6

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.5-rc.9",
+  "version": "9.0.6",
   "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": "^9.0.5-rc.9",
-    "@praxisui/table": "^9.0.5-rc.9",
-    "@praxisui/core": "^9.0.5-rc.9",
-    "@praxisui/dynamic-fields": "^9.0.5-rc.9",
-    "@praxisui/settings-panel": "^9.0.5-rc.9",
+    "@praxisui/dynamic-form": "^9.0.6",
+    "@praxisui/table": "^9.0.6",
+    "@praxisui/core": "^9.0.6",
+    "@praxisui/dynamic-fields": "^9.0.6",
+    "@praxisui/settings-panel": "^9.0.6",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.5-rc.9",
+    "@praxisui/ai": "^9.0.6",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud-drawer-adapter.d.ts

@@ -51,12 +51,37 @@ interface CrudDrawerResult {
     type: CrudDrawerResultType;
     data?: Record<string, unknown>;
 }
+/** Minimal structural evidence contract kept local to the light entrypoint. */
+interface CrudReactiveDeterminationExecutionEvent {
+    determinationId: string;
+    operationId: string;
+    status: 'pending' | 'success' | 'skipped' | 'error';
+    sourcePaths: string[];
+    targetPaths: string[];
+    appliedTargetPaths?: string[];
+    correlationId: string;
+    durationMs: number;
+    reason?: string;
+    provenance: {
+        kind: 'platform' | 'host';
+        source: string;
+        version?: string;
+    };
+}
+/** Minimal structural stability contract kept local to the light entrypoint. */
+interface CrudReactiveDeterminationStabilityChange {
+    status: 'pending' | 'settled-satisfied' | 'settled-unsatisfied';
+    pending: boolean;
+    unsatisfied: boolean;
+}
 interface CrudDrawerOpenConfig {
     action: CrudAction;
     metadata: CrudMetadata;
     inputs: Record<string, unknown>;
     /** Read-only record context for existing-record drawers. It is never part of form inputs or submit payloads. */
     resourceIdentity?: MaterializedResourceIdentity | null;
+    /** Presentation-only preference. Defaults to true; false hides the record identity key while preserving its title. */
+    showResourceIdentityKey?: boolean;
     /** Read-only task scope for related operations. It is never part of form inputs or submit payloads. */
     contextIdentity?: MaterializedResourceIdentity | null;
     /**
@@ -68,6 +93,12 @@ interface CrudDrawerOpenConfig {
      * Hosts podem propagar `save/delete/close` para sincronizar telemetria/eventos.
      */
     onResult?: (result: CrudDrawerResult) => void;
+    /** Bind to the child form's metadata-only determination evidence. */
+    onReactiveDetermination?: (event: CrudReactiveDeterminationExecutionEvent) => void;
+    /** Bind to pending state and refuse every adapter-owned close/submit while true. */
+    onReactiveDeterminationPendingChange?: (pending: boolean) => void;
+    /** Report aggregate success/unsatisfied stability without form values. */
+    onReactiveDeterminationStabilityChange?: (stability: CrudReactiveDeterminationStabilityChange) => void;
 }
 interface CrudDrawerAdapter {
     open(config: CrudDrawerOpenConfig): Promise<void> | void;
@@ -84,4 +115,4 @@ interface DialogConfig<D = any> extends MatDialogConfig<D> {
 declare const CRUD_DRAWER_ADAPTER: InjectionToken<CrudDrawerAdapter>;
 
 export { CRUD_DRAWER_ADAPTER };
-export type { CrudAction, CrudDefaults, CrudDrawerAdapter, CrudDrawerOpenConfig, CrudDrawerResult, CrudDrawerResultType, CrudHeaderConfig, CrudMetadata, CrudParamMapping, CrudResource, DialogConfig, FormOpenMode };
+export type { CrudAction, CrudDefaults, CrudDrawerAdapter, CrudDrawerOpenConfig, CrudDrawerResult, CrudDrawerResultType, CrudHeaderConfig, CrudMetadata, CrudParamMapping, CrudReactiveDeterminationExecutionEvent, CrudReactiveDeterminationStabilityChange, CrudResource, DialogConfig, FormOpenMode };

package/types/praxisui-crud.d.ts

@@ -1,8 +1,8 @@
-import * as _angular_core from '@angular/core';
-import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, AfterViewInit, Provider, OnDestroy } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
-import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, SurfaceDrawerRef, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
+import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ReactiveDeterminationExecutionEvent, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, PraxisResourceEvent, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, SurfaceDrawerRef, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
 export { BackConfig } from '@praxisui/core';
+import * as _angular_core from '@angular/core';
+import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, AfterViewInit, Provider, OnDestroy } from '@angular/core';
 import { TableConfigPersistenceStrategy } from '@praxisui/table';
 import { MatDialogConfig, MatDialogRef, MatDialog } from '@angular/material/dialog';
 export { MAT_DIALOG_DATA as DIALOG_DATA } from '@angular/material/dialog';
@@ -48,6 +48,17 @@ declare class DialogService {
 }
 
 type FormOpenMode = 'route' | 'modal' | 'drawer';
+type CrudReactiveDeterminationStabilityStatus = 'pending' | 'settled-satisfied' | 'settled-unsatisfied';
+/** Value-free stability evidence for the Dynamic Form opened by one CRUD action. */
+interface CrudFormReactiveDeterminationStabilityChange {
+    status: CrudReactiveDeterminationStabilityStatus;
+    pending: boolean;
+    unsatisfied: boolean;
+}
+/** Public CRUD output enriched with the action that owns the open form. */
+interface CrudReactiveDeterminationStabilityChange extends CrudFormReactiveDeterminationStabilityChange {
+    action: string;
+}
 interface CrudParamMapping {
     from: string;
     to: 'routeParam' | 'query' | 'input';
@@ -177,6 +188,8 @@ declare class PraxisCrudComponent implements OnChanges {
     tableConfigPersistenceStrategy: TableConfigPersistenceStrategy;
     context?: Record<string, unknown>;
     enableCustomization: boolean;
+    /** Controls whether existing-record hosts expose the canonical identity key. */
+    showResourceIdentityKey: boolean;
     /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
     authoringCapability: string | null;
     configureRequested: EventEmitter<void>;
@@ -192,11 +205,23 @@ declare class PraxisCrudComponent implements OnChanges {
     afterDelete: EventEmitter<{
         id: string | number;
     }>;
+    /** Metadata-only Reactive Determination evidence from an open form host. */
+    reactiveDeterminationExecuted: EventEmitter<{
+        action: string;
+        event: ReactiveDeterminationExecutionEvent;
+    }>;
+    reactiveDeterminationPendingChange: EventEmitter<{
+        action: string;
+        pending: boolean;
+    }>;
+    reactiveDeterminationStabilityChange: EventEmitter<CrudReactiveDeterminationStabilityChange>;
     error: EventEmitter<unknown>;
     rowClick: EventEmitter<unknown>;
     /** Emits the canonical table row-action envelope before the CRUD handles its surface/action. */
     rowAction: EventEmitter<CrudActionRuntimeEvent>;
     selectionChange: EventEmitter<unknown>;
+    /** Forwards the canonical resource interaction envelope emitted by the internal table. */
+    readonly resourceEvent: _angular_core.OutputEmitterRef<PraxisResourceEvent<unknown>>;
     tableRuntimeConfigChange: EventEmitter<_praxisui_core.TableConfigModern>;
     crudAuthoringDocumentApplied: EventEmitter<CrudAuthoringWidgetPersistenceEvent>;
     crudAuthoringDocumentSaved: EventEmitter<CrudAuthoringWidgetPersistenceEvent>;
@@ -218,11 +243,13 @@ declare class PraxisCrudComponent implements OnChanges {
     private readonly snack;
     private readonly dialog;
     private readonly i18n;
+    private readonly logger;
     private readonly injector;
     private resourceDiscoveryInstance?;
     private actionOpenAdapterInstance?;
     private surfaceOpenAdapterInstance?;
     private materializedRefreshSequence;
+    private surfaceOpenAttemptSequence;
     private readonly global;
     private readonly surfaceService;
     private readonly surfaceOutlets;
@@ -230,6 +257,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private readonly route;
     private warnedMissingId;
     private lastEmittedTableRuntimeConfigJson;
+    private lastTableRuntimeConfigSnapshot;
     private lastAssignedTableConfigJson;
     private lastAssignedTableCrudContextJson;
     private lastAppliedResourceIdentity;
@@ -249,6 +277,7 @@ declare class PraxisCrudComponent implements OnChanges {
     onResetPreferences(): void;
     onTableRowClick(event: unknown): void;
     onTableSelectionChange(event: unknown): void;
+    onTableResourceEvent(event: PraxisResourceEvent<unknown>): void;
     onBulkAction(event: CrudActionRuntimeEvent): Promise<void>;
     onToolbarAction(event: CrudActionRuntimeEvent): Promise<void>;
     ngOnChanges(changes: SimpleChanges): void;
@@ -258,6 +287,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private resolveOpeningActionLabel;
     private hasExplicitOpenBinding;
     getCurrentTableConfigSnapshot(): TableConfig | null;
+    onTableConfigChange(config: TableConfig): void;
     onTableMetadataChange(): void;
     onTableLoadingStateChange(state: LoadingState): void;
     onCollectionLinksChange(links: RestApiLinks | null | undefined): void;
@@ -279,6 +309,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private unwrapRestData;
     private extractCollectionData;
     private emitTableRuntimeConfigSnapshot;
+    private cloneTableConfigSnapshot;
     private applyResolvedCrudState;
     private assignTableConfigForBinding;
     private assignTableCrudContext;
@@ -302,6 +333,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private resolveDiscoveredSurfaceCatalog;
     private tryOpenDiscoveredWorkflowAction;
     private notifySurfaceNavigationFailure;
+    private reportDiscoveredSurfaceOpenFailure;
     private resolveDiscoveredActionCatalog;
     private selectDiscoveredWorkflowAction;
     private resolveProvidedWorkflowAction;
@@ -351,7 +383,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private txWithParams;
     private interpolateTranslationParams;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisCrudComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudComponent, "praxis-crud", never, { "metadata": { "alias": "metadata"; "required": true; }; "crudId": { "alias": "crudId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "tableConfigPersistenceStrategy": { "alias": "tableConfigPersistenceStrategy"; "required": false; }; "context": { "alias": "context"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapability": { "alias": "authoringCapability"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; "rowClick": "rowClick"; "rowAction": "rowAction"; "selectionChange": "selectionChange"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; "crudAuthoringDocumentApplied": "crudAuthoringDocumentApplied"; "crudAuthoringDocumentSaved": "crudAuthoringDocumentSaved"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisCrudComponent, "praxis-crud", never, { "metadata": { "alias": "metadata"; "required": true; }; "crudId": { "alias": "crudId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "tableConfigPersistenceStrategy": { "alias": "tableConfigPersistenceStrategy"; "required": false; }; "context": { "alias": "context"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showResourceIdentityKey": { "alias": "showResourceIdentityKey"; "required": false; }; "authoringCapability": { "alias": "authoringCapability"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "reactiveDeterminationExecuted": "reactiveDeterminationExecuted"; "reactiveDeterminationPendingChange": "reactiveDeterminationPendingChange"; "reactiveDeterminationStabilityChange": "reactiveDeterminationStabilityChange"; "error": "error"; "rowClick": "rowClick"; "rowAction": "rowAction"; "selectionChange": "selectionChange"; "resourceEvent": "resourceEvent"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; "crudAuthoringDocumentApplied": "crudAuthoringDocumentApplied"; "crudAuthoringDocumentSaved": "crudAuthoringDocumentSaved"; }, never, never, true, never>;
 }
 
 type CrudDrawerResultType = 'save' | 'delete' | 'close';
@@ -359,12 +391,48 @@ interface CrudDrawerResult {
     type: CrudDrawerResultType;
     data?: Record<string, unknown>;
 }
+interface CrudDrawerOpenConfig {
+    action: CrudAction;
+    metadata: CrudMetadata;
+    inputs: Record<string, unknown>;
+    /** Read-only record context for existing-record drawers. It is never part of form inputs or submit payloads. */
+    resourceIdentity?: MaterializedResourceIdentity | null;
+    /** Presentation-only preference. Defaults to true; false hides the record identity key while preserving its title. */
+    showResourceIdentityKey?: boolean;
+    /** Read-only task scope for related operations. It is never part of form inputs or submit payloads. */
+    contextIdentity?: MaterializedResourceIdentity | null;
+    /**
+     * Ephemeral focus policy resolved for this opening. A host adapter must
+     * forward it to its native overlay and must never persist, clone, or put it
+     * into form inputs or submit payloads. When a responsive render replaces a
+     * detached HTMLElement, an adapter should recover the matching
+     * `data-praxis-focus-key` element before focusing it.
+     */
+    restoreFocus?: boolean | string | HTMLElement;
+    /**
+     * Notifica fechamento do drawer (cancelamento/fechamento externo/resultado finalizado).
+     */
+    onClose?: () => void;
+    /**
+     * Notifica resultado semântico do fluxo em drawer.
+     * Hosts podem propagar `save/delete/close` para sincronizar telemetria/eventos.
+     */
+    onResult?: (result: CrudDrawerResult) => void;
+    /** Bind to the child Dynamic Form metadata-only execution event. */
+    onReactiveDetermination?: (event: ReactiveDeterminationExecutionEvent) => void;
+    /** Bind to the child pending event and guard every adapter-owned close/submit. */
+    onReactiveDeterminationPendingChange?: (pending: boolean) => void;
+    /** Report aggregate settled-success/settled-unsatisfied state without form values. */
+    onReactiveDeterminationStabilityChange?: (stability: CrudFormReactiveDeterminationStabilityChange) => void;
+}
 
 interface CrudLaunchRuntime {
     capabilities?: ResourceCapabilitySnapshot | null;
     links?: RestApiLinks | null;
     resourceIdentity?: MaterializedResourceIdentity | null;
     contextIdentity?: MaterializedResourceIdentity | null;
+    /** Presentation-only preference for the existing-record identity key. */
+    showResourceIdentityKey?: boolean;
     /** Active runtime drawer session. It is never persisted in CRUD metadata. */
     surfaceRuntime?: SurfaceDrawerRef | null;
     /** Stable runtime trigger for restoring focus after a form overlay closes. */
@@ -383,6 +451,9 @@ declare class CrudLauncherService {
     launch(action: CrudAction, row: Record<string, unknown> | undefined, metadata: CrudMetadata, componentKeyId?: string | null, drawerCallbacks?: {
         onClose?: () => void;
         onResult?: (result: CrudDrawerResult) => void;
+        onReactiveDetermination?: CrudDrawerOpenConfig['onReactiveDetermination'];
+        onReactiveDeterminationPendingChange?: CrudDrawerOpenConfig['onReactiveDeterminationPendingChange'];
+        onReactiveDeterminationStabilityChange?: CrudDrawerOpenConfig['onReactiveDeterminationStabilityChange'];
     }, runtime?: CrudLaunchRuntime): Promise<{
         mode: FormOpenMode;
         ref?: DialogRef<any>;
@@ -428,6 +499,9 @@ declare class DynamicFormDialogHostComponent implements OnInit, AfterViewInit {
     private configStorage;
     private readonly surfaceRef;
     formComp?: PraxisDynamicForm;
+    reactiveDeterminationExecuted: EventEmitter<ReactiveDeterminationExecutionEvent>;
+    reactiveDeterminationPendingChange: EventEmitter<boolean>;
+    reactiveDeterminationStabilityChange: EventEmitter<CrudFormReactiveDeterminationStabilityChange>;
     modal: any;
     presentation: 'modal' | 'drawer' | 'surface-frame';
     maximized: boolean;
@@ -439,11 +513,13 @@ declare class DynamicFormDialogHostComponent implements OnInit, AfterViewInit {
     private terminalClose;
     private destroyRef;
     private readonly i18n;
+    private reactiveDeterminationStabilitySignature;
     resourcePath?: string;
     resourceId?: string | number;
     initialValue?: Record<string, unknown> | null;
     resourceIdentity: MaterializedResourceIdentity | null;
     contextIdentity: MaterializedResourceIdentity | null;
+    showResourceIdentityKey: boolean;
     schemaUrl?: string | null;
     submitUrl?: string | null;
     submitMethod?: string | null;
@@ -479,6 +555,10 @@ declare class DynamicFormDialogHostComponent implements OnInit, AfterViewInit {
     ngAfterViewInit(): void;
     onSave(result: unknown): void;
     onCancel(): void;
+    onReactiveDeterminationExecuted(event: ReactiveDeterminationExecutionEvent): void;
+    onReactiveDeterminationPendingChange(pending: boolean): void;
+    private emitReactiveDeterminationStability;
+    private continueCancel;
     private canLeaveSurfaceFrame;
     toggleMaximize(initial?: boolean): void;
     private resolveOverlayPane;
@@ -488,7 +568,7 @@ declare class DynamicFormDialogHostComponent implements OnInit, AfterViewInit {
     private updateHostPosition;
     private resolveMaximizedDrawerPosition;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicFormDialogHostComponent, [{ optional: true; }, { optional: true; }, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicFormDialogHostComponent, "praxis-dynamic-form-dialog-host", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicFormDialogHostComponent, "praxis-dynamic-form-dialog-host", never, {}, { "reactiveDeterminationExecuted": "reactiveDeterminationExecuted"; "reactiveDeterminationPendingChange": "reactiveDeterminationPendingChange"; "reactiveDeterminationStabilityChange": "reactiveDeterminationStabilityChange"; }, never, never, true, never>;
 }
 
 /** Metadata for PraxisCrudComponent */
@@ -626,6 +706,7 @@ declare class CrudMetadataEditorComponent implements SettingsValueProvider {
     actionParams(actionName: CrudEditorActionKey): CrudParamMapping[];
     actionInitialValueDraft(actionName: CrudEditorActionKey): string;
     actionLabel(actionName: CrudEditorActionKey): string;
+    actionUsesRoute(actionName: CrudEditorActionKey): boolean;
     actionSummary(actionName: CrudEditorActionKey): string;
     actionEffectiveBindingSummary(actionName: CrudEditorActionKey): string;
     actionSubmitSummary(actionName: CrudEditorActionKey): string;
@@ -770,4 +851,4 @@ type OpenCrudMetadataEditorOptions = {
 declare function openCrudMetadataEditor(settings: SettingsPanelService, opts?: OpenCrudMetadataEditorOptions): _praxisui_settings_panel.SettingsPanelRef;
 
 export { CRUD_AI_CAPABILITIES, CrudLauncherService, CrudMetadataEditorComponent, CrudPageHeaderComponent, DialogService, DynamicFormDialogHostComponent, PRAXIS_CRUD_AUTHORING_MANIFEST, PRAXIS_CRUD_COMPONENT_METADATA, PraxisCrudComponent, PraxisCrudWidgetConfigEditor, assertCrudMetadata, createCrudAuthoringDocument, findCrudAction, normalizeCrudAuthoringDocument, openCrudMetadataEditor, parseLegacyOrCrudDocument, providePraxisCrudMetadata, serializeCrudAuthoringDocument, validateCrudAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudHeaderConfig, CrudHeaderVariant, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudResource, CrudValidationContext, DialogConfig, DialogRef, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, ValueKind };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudFormReactiveDeterminationStabilityChange, CrudHeaderConfig, CrudHeaderVariant, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudReactiveDeterminationStabilityChange, CrudReactiveDeterminationStabilityStatus, CrudResource, CrudValidationContext, DialogConfig, DialogRef, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, ValueKind };