@praxisui/crud 9.0.4-rc.25 → 9.0.4-rc.26

package/README.md

@@ -43,6 +43,7 @@ import { PraxisCrudComponent, CrudMetadata } from '@praxisui/crud';
     <praxis-crud
       crudId="employees-crud"
       [metadata]="metadata"
+      tableConfigPersistenceStrategy="input-first"
       [context]="context"
       [enableCustomization]="true"
       (afterSave)="reloadSummary()"
@@ -92,6 +93,7 @@ export class EmployeesCrudComponent {
 - `metadata`: `CrudMetadata | string`
 - `crudId`: stable instance id
 - `componentInstanceId`: optional host-level instance id
+- `tableConfigPersistenceStrategy`: controls persistence precedence for the internal table. Keep `local-first` for user-owned workspaces, use `input-first` for an authoritative governed contract, and use `volatile` for previews that must neither read nor write stored preferences.
 - `context`: host/runtime context passed into table and form flows
 - `enableCustomization`: enables the package authoring surface
 - `authoringCapability`: optionally requires the exact capability from `EnterpriseRuntimeContext.capabilities` before authoring controls, the CRUD editor, and its internal table authoring are available. This is a UX gate; governed persistence must enforce the same policy server-side.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-04T21:23:28.566Z",
+  "generatedAt": "2026-08-04T22:30:51.687Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "9.0.4-rc.25",
+  "packageVersion": "9.0.4-rc.26",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -29,6 +29,13 @@
           "required": false,
           "description": "Identificador opcional para múltiplas instâncias na mesma rota."
         },
+        {
+          "name": "tableConfigPersistenceStrategy",
+          "type": "'local-first' | 'input-first' | 'volatile'",
+          "required": false,
+          "description": "Política da tabela interna. Use input-first para contratos governados autoritativos e volatile para previews que não devem ler nem gravar preferências locais.",
+          "default": "local-first"
+        },
         {
           "name": "context",
           "type": "Record<string, unknown>",
@@ -5015,6 +5022,11 @@
             "type": "string",
             "description": "Optional stable host instance id for multiple CRUD widgets on the same route."
           },
+          {
+            "name": "tableConfigPersistenceStrategy",
+            "type": "'local-first' | 'input-first' | 'volatile'",
+            "description": "Persistence precedence forwarded to the internal Praxis Table. Governed previews should use input-first or volatile explicitly."
+          },
           {
             "name": "context",
             "type": "Record<string, unknown>",
@@ -7206,9 +7218,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - crudId (string)\n  - componentInstanceId (string)\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - rowClick ({ row: unknown; index: number })\n  - selectionChange (unknown)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
+          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - crudId (string)\n  - componentInstanceId (string)\n  - tableConfigPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - rowClick ({ row: unknown; index: number })\n  - selectionChange (unknown)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
           "sourcePointer": "projects/praxis-crud/src/lib/praxis-crud.metadata.ts",
-          "contentHash": "bdcc39d2237bf1cea3f5ec621aa5b6fac42f8da6c8467cdbe1682888c722f12d",
+          "contentHash": "a9d744b92ff6f475de4d870e57bc963200a7b68688a8ea5159cc02496a8967be",
           "sourceKind": "component_definition",
           "sourceId": "praxis-crud",
           "corpusVersion": "1.0.0"
@@ -7436,9 +7448,9 @@
         {
           "chunkIndex": 23,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-crud\",\"ownerPackage\":\"@praxisui/crud\",\"configSchemaId\":\"CrudMetadata\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"metadata\",\"type\":\"CrudMetadata | string\",\"description\":\"Canonical CRUD metadata or serialized metadata document.\"},{\"name\":\"crudId\",\"type\":\"string\",\"description\":\"Stable CRUD instance id used for table/form identity and persistence.\"},{\"name\":\"componentInstanceId\",\"type\":\"string\",\"description\":\"Optional stable host instance id for multiple CRUD widgets on the same route.\"},{\"name\":\"context\",\"type\":\"Record<string, unknown>\",\"description\":\"Opaque host context used for authoring seeds and launcher inputs.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Explicit host opt-in for CRUD authoring surfaces.\"},{\"name\":\"authoringCapability\",\"type\":\"string | null\",\"description\":\"Public runtime capability required before CRUD and delegated table authoring can open.\"},{\"name\":\"afterOpen\",\"type\":\"{ mode: FormOpenMode; action: string }\",\"description\":\"Emitted after a CRUD action opens.\"},{\"name\":\"afterSave\",\"type\":\"{ id: string | number; data: unknown }\",\"description\":\"Emitted after save; CRUD refetches the list.\"},{\"name\":\"afterDelete\",\"type\":\"{ id: string | number }\",\"description\":\"Emitted after delete; CRUD refetches the list.\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-crud\",\"ownerPackage\":\"@praxisui/crud\",\"configSchemaId\":\"CrudMetadata\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"metadata\",\"type\":\"CrudMetadata | string\",\"description\":\"Canonical CRUD metadata or serialized metadata document.\"},{\"name\":\"crudId\",\"type\":\"string\",\"description\":\"Stable CRUD instance id used for table/form identity and persistence.\"},{\"name\":\"componentInstanceId\",\"type\":\"string\",\"description\":\"Optional stable host instance id for multiple CRUD widgets on the same route.\"},{\"name\":\"tableConfigPersistenceStrategy\",\"type\":\"'local-first' | 'input-first' | 'volatile'\",\"description\":\"Persistence precedence forwarded to the internal Praxis Table. Governed previews should use input-first or volatile explicitly.\"},{\"name\":\"context\",\"type\":\"Record<string, unknown>\",\"description\":\"Opaque host context used for authoring seeds and launcher inputs.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Explicit host opt-in for CRUD authoring surfaces.\"},{\"name\":\"authoringCapability\",\"type\":\"string | null\",\"description\":\"Public runtime capability required before CRUD and delegated table authoring can open.\"},{\"name\":\"afterOpen\",\"type\":\"{ mode: FormOpenMode; action: string }\",\"description\":\"Emitted after a CRUD action opens.\"},{\"name\":\"afterSave\",\"type\":\"{ id: string | number; data: unknown }\",\"description\":\"Emitted after save; CRUD refetches the list.\"},{\"name\":\"afterDelete\",\"type\":\"{ id: string | number }\",\"description\":\"Emitted after delete; CRUD refetches the list.\"}]}",
           "sourcePointer": "projects/praxis-crud/src/lib/ai/praxis-crud-authoring-manifest.ts",
-          "contentHash": "cce406615018b96872557b8ccfe54f7c64d1bd40f8528ac4d62b094fbc27858b",
+          "contentHash": "068b8503236aa70e0543cc63c791a5c9cb192983b3e369285bb44732b3b646d8",
           "sourceKind": "component_definition",
           "sourceId": "praxis-crud",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-crud.mjs

@@ -3667,6 +3667,8 @@ class PraxisCrudComponent {
     metadata;
     crudId;
     componentInstanceId;
+    /** Controls whether the CRUD's internal table trusts host input or stored user configuration. */
+    tableConfigPersistenceStrategy = 'local-first';
     context;
     enableCustomization = false;
     /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
@@ -5247,7 +5249,7 @@ class PraxisCrudComponent {
         return Object.entries(params).reduce((current, [name, value]) => current.split(`{${name}}`).join(value), text);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisCrudComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { metadata: "metadata", crudId: "crudId", componentInstanceId: "componentInstanceId", context: "context", enableCustomization: "enableCustomization", authoringCapability: "authoringCapability" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error", rowClick: "rowClick", selectionChange: "selectionChange", tableRuntimeConfigChange: "tableRuntimeConfigChange", crudAuthoringDocumentApplied: "crudAuthoringDocumentApplied", crudAuthoringDocumentSaved: "crudAuthoringDocumentSaved" }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisCrudComponent, isStandalone: true, selector: "praxis-crud", inputs: { metadata: "metadata", crudId: "crudId", componentInstanceId: "componentInstanceId", tableConfigPersistenceStrategy: "tableConfigPersistenceStrategy", context: "context", enableCustomization: "enableCustomization", authoringCapability: "authoringCapability" }, outputs: { configureRequested: "configureRequested", afterOpen: "afterOpen", afterClose: "afterClose", afterSave: "afterSave", afterDelete: "afterDelete", error: "error", rowClick: "rowClick", selectionChange: "selectionChange", tableRuntimeConfigChange: "tableRuntimeConfigChange", crudAuthoringDocumentApplied: "crudAuthoringDocumentApplied", crudAuthoringDocumentSaved: "crudAuthoringDocumentSaved" }, providers: [
             providePraxisI18nConfig(RESOURCE_DISCOVERY_I18N_CONFIG),
             providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
         ], viewQueries: [{ propertyName: "table", first: true, predicate: PraxisTable, descendants: true }], usesOnChanges: true, ngImport: i0, template: `
@@ -5266,6 +5268,7 @@ class PraxisCrudComponent {
           [queryContext]="tableQueryContext"
           [filterCriteria]="tableFilterCriteria"
           [tableId]="crudId || 'default'"
+          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
           [crudContext]="tableCrudContext"
           [enableCustomization]="enableCustomization"
           [authoringCapability]="authoringCapability"
@@ -5313,6 +5316,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           [queryContext]="tableQueryContext"
           [filterCriteria]="tableFilterCriteria"
           [tableId]="crudId || 'default'"
+          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
           [crudContext]="tableCrudContext"
           [enableCustomization]="enableCustomization"
           [authoringCapability]="authoringCapability"
@@ -5346,6 +5350,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 args: [{ required: true }]
             }], componentInstanceId: [{
                 type: Input
+            }], tableConfigPersistenceStrategy: [{
+                type: Input
             }], context: [{
                 type: Input
             }], enableCustomization: [{
@@ -6305,6 +6311,12 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             type: 'string',
             description: 'Identificador opcional para múltiplas instâncias na mesma rota.',
         },
+        {
+            name: 'tableConfigPersistenceStrategy',
+            type: "'local-first' | 'input-first' | 'volatile'",
+            default: 'local-first',
+            description: 'Política da tabela interna. Use input-first para contratos governados autoritativos e volatile para previews que não devem ler nem gravar preferências locais.',
+        },
         {
             name: 'context',
             type: 'Record<string, unknown>',
@@ -6880,6 +6892,7 @@ const PRAXIS_CRUD_AUTHORING_MANIFEST = {
         { name: 'metadata', type: 'CrudMetadata | string', description: 'Canonical CRUD metadata or serialized metadata document.' },
         { name: 'crudId', type: 'string', description: 'Stable CRUD instance id used for table/form identity and persistence.' },
         { name: 'componentInstanceId', type: 'string', description: 'Optional stable host instance id for multiple CRUD widgets on the same route.' },
+        { name: 'tableConfigPersistenceStrategy', type: "'local-first' | 'input-first' | 'volatile'", description: 'Persistence precedence forwarded to the internal Praxis Table. Governed previews should use input-first or volatile explicitly.' },
         { name: 'context', type: 'Record<string, unknown>', description: 'Opaque host context used for authoring seeds and launcher inputs.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Explicit host opt-in for CRUD authoring surfaces.' },
         { name: 'authoringCapability', type: 'string | null', description: 'Public runtime capability required before CRUD and delegated table authoring can open.' },

package/package.json

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

package/types/praxisui-crud.d.ts

@@ -3,6 +3,7 @@ import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider, After
 import * as _praxisui_core from '@praxisui/core';
 import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
 export { BackConfig } from '@praxisui/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';
 import { ComponentType } from '@angular/cdk/portal';
@@ -170,6 +171,8 @@ declare class PraxisCrudComponent implements OnChanges {
     metadata: CrudMetadata | string;
     crudId: string;
     componentInstanceId?: string;
+    /** Controls whether the CRUD's internal table trusts host input or stored user configuration. */
+    tableConfigPersistenceStrategy: TableConfigPersistenceStrategy;
     context?: Record<string, unknown>;
     enableCustomization: boolean;
     /** Capability publica exigida para authoring governado do CRUD e da tabela interna. */
@@ -333,7 +336,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; }; "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"; "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; }; "authoringCapability": { "alias": "authoringCapability"; "required": false; }; }, { "configureRequested": "configureRequested"; "afterOpen": "afterOpen"; "afterClose": "afterClose"; "afterSave": "afterSave"; "afterDelete": "afterDelete"; "error": "error"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "tableRuntimeConfigChange": "tableRuntimeConfigChange"; "crudAuthoringDocumentApplied": "crudAuthoringDocumentApplied"; "crudAuthoringDocumentSaved": "crudAuthoringDocumentSaved"; }, never, never, true, never>;
 }
 
 type CrudDrawerResultType = 'save' | 'delete' | 'close';
@@ -692,6 +695,7 @@ interface PraxisCrudWidgetEditorInputs {
     metadata?: CrudMetadata | string | null;
     crudId?: string;
     componentInstanceId?: string;
+    tableConfigPersistenceStrategy?: TableConfigPersistenceStrategy;
     context?: Record<string, unknown>;
     enableCustomization?: boolean;
     authoringCapability?: string | null;