@praxisui/dynamic-form 9.0.4-rc.15 → 9.0.4-rc.16

package/fesm2022/praxisui-dynamic-form.mjs

@@ -6013,7 +6013,7 @@ function pruneUndefined(value) {
  * Manifesto de authoring canônico para o componente praxis-dynamic-form.
  * Este arquivo define as operações permitidas pela IA para editar formulários.
  *
- * @version 1.5.0
+ * @version 1.5.1
  * @status COMPLIANT - Alinhado com contrato v2, gate de aceitação e semântica local/schema-backed.
  */
 const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
@@ -6021,13 +6021,14 @@ const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
     componentId: 'praxis-dynamic-form',
     ownerPackage: '@praxisui/dynamic-form',
     configSchemaId: 'FormConfig',
-    manifestVersion: '1.5.0',
+    manifestVersion: '1.5.1',
     runtimeInputs: [
         { name: 'showAiAssistant', type: 'boolean', description: 'Mostra os gatilhos do copiloto semantico Praxis' },
         { name: 'config', type: 'FormConfig', description: 'Configuração do formulário; sections é opcional em forms schema-driven e não deve ser criado como array vazio apenas para satisfazer TypeScript.' },
         { name: 'resourcePath', type: 'string', description: 'Caminho do recurso (API)' },
         { name: 'readUrl', type: 'string', description: 'Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION' },
         { name: 'mode', type: 'string', allowedValues: ['create', 'edit', 'view'], description: 'Modo de operação' },
+        { name: 'configPersistenceStrategy', type: 'string', allowedValues: ['local-first', 'input-first'], description: 'Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.' },
         { name: 'generatedLayoutPreset', type: 'string', allowedValues: ['default', 'compactPresentation'], description: 'Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.' },
         { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; medium-and-wide e o default corporativo.' },
         { name: 'fieldIconPolicy', type: 'string', allowedValues: ['all', 'presentation-only', 'none'], description: 'Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.' },
@@ -11756,7 +11757,9 @@ class PraxisDynamicForm {
                 inputsLoadTimeout = setTimeout(finishInputsLoad, FORM_INPUT_PREFS_LOAD_TIMEOUT_MS);
                 this.asyncConfigStorage.loadConfig(inputsKey).pipe(take(1)).subscribe({
                     next: (inputsPref) => {
-                        if (inputsPref && typeof inputsPref === 'object') {
+                        if (this.configPersistenceStrategy !== 'input-first' &&
+                            inputsPref &&
+                            typeof inputsPref === 'object') {
                             if (inputsPref.mode === 'create' || inputsPref.mode === 'edit' || inputsPref.mode === 'view') {
                                 this.mode = inputsPref.mode;
                                 this.debugLog('🔧 Applied persisted input mode', { mode: this.mode });
@@ -30965,7 +30968,7 @@ const PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA = {
         { name: 'showAiAssistant', type: 'boolean', default: true, description: 'Mostra os gatilhos do copiloto semantico Praxis para esta instancia do formulario' },
         { name: 'formId', type: 'string', description: 'Chave para persistencia local da configuracao' },
         { name: 'componentInstanceId', type: 'string', description: 'Identificador estavel para instancias multiplas do formulario' },
-        { name: 'configPersistenceStrategy', type: "'local-first' | 'input-first'", default: 'local-first', description: 'Define se a configuracao local persistida ou a configuracao recebida por input tem precedencia na hidratacao.' },
+        { name: 'configPersistenceStrategy', type: "'local-first' | 'input-first'", default: 'local-first', description: 'Define se a configuracao local persistida ou os inputs do host tem precedencia; input-first preserva inclusive o mode explicito contra preferencias persistidas.' },
         { name: 'layout', type: 'FormLayout', description: 'Layout opcional em vez do gerado' },
         { name: 'generatedLayoutPreset', type: "'default' | 'compactPresentation'", default: 'default', description: 'Preset usado apenas ao criar a configuracao inicial a partir de metadata/schema.' },
         { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy | null', description: 'Politica opt-in para materializar layout a partir do schema sem persistir sections geradas por padrao.' },
@@ -34994,6 +34997,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
  */
 const ENUMS = {
     mode: ['create', 'edit', 'view'],
+    configPersistenceStrategy: ['local-first', 'input-first'],
     schemaSource: ['resource', 'filter'],
     generatedLayoutPreset: ['default', 'compactPresentation'],
     layoutPolicySource: ['authored', 'schema'],
@@ -35171,6 +35175,14 @@ const FORM_COMPONENT_AI_CAPABILITIES = {
             description: 'Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.',
             safetyNotes: 'Nao reprocessa layouts ja persistidos ou authorados.',
         },
+        {
+            path: 'inputs.configPersistenceStrategy',
+            category: 'inputs',
+            valueKind: 'enum',
+            allowedValues: ENUMS.configPersistenceStrategy,
+            description: 'Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.',
+            safetyNotes: 'Use input-first em commands e surfaces transitórias; isso impede que mode e estados operacionais antigos sobrescrevam o schema atual.',
+        },
         {
             path: 'inputs.layoutPolicy',
             category: 'inputs',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.4-rc.15",
+  "version": "9.0.4-rc.16",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.4-rc.15",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.15",
-    "@praxisui/metadata-editor": "^9.0.4-rc.15",
-    "@praxisui/rich-content": "^9.0.4-rc.15",
-    "@praxisui/settings-panel": "^9.0.4-rc.15",
-    "@praxisui/visual-builder": "^9.0.4-rc.15",
-    "@praxisui/core": "^9.0.4-rc.15",
+    "@praxisui/ai": "^9.0.4-rc.16",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.16",
+    "@praxisui/metadata-editor": "^9.0.4-rc.16",
+    "@praxisui/rich-content": "^9.0.4-rc.16",
+    "@praxisui/settings-panel": "^9.0.4-rc.16",
+    "@praxisui/visual-builder": "^9.0.4-rc.16",
+    "@praxisui/core": "^9.0.4-rc.16",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-dynamic-form.json-api.md

@@ -586,6 +586,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `enableCustomization` | `boolean` | `false` | Active | Habilita UX de customizacao do layout. |
 | `formId` | `string \| undefined` | `undefined` | Active | Chave de persistencia e identidade logica. |
 | `componentInstanceId` | `string \| undefined` | `undefined` | Active | Isola instancias com mesmo `formId`. |
+| `configPersistenceStrategy` | `'local-first' \| 'input-first'` | `'local-first'` | Active | Em `input-first`, os inputs fornecidos pelo host, inclusive `mode`, permanecem autoritativos sobre preferencias persistidas da mesma instancia. Combine com `layoutPolicy.persistence='transient'` em commands efemeros para nao carregar nem gravar layout local. |
 | `layout` | `FormLayout \| undefined` | `undefined` | Partial | Funciona como override estrutural em parte dos fluxos de layout/editor. |
 | `generatedLayoutPreset` | `'default' \| 'compactPresentation'` | `'default'` | Active | Usado apenas ao criar a configuracao inicial a partir de schema/metadata; nao reprocessa layouts persistidos ou authorados. |
 | `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |

package/types/praxisui-dynamic-form.d.ts

@@ -2776,7 +2776,7 @@ declare function buildDynamicFormRuleAuthoringContext(config: Pick<FormConfig, '
  * Manifesto de authoring canônico para o componente praxis-dynamic-form.
  * Este arquivo define as operações permitidas pela IA para editar formulários.
  *
- * @version 1.5.0
+ * @version 1.5.1
  * @status COMPLIANT - Alinhado com contrato v2, gate de aceitação e semântica local/schema-backed.
  */
 declare const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST: ComponentAuthoringManifest;