@praxisui/dynamic-form 1.0.0-beta.58 → 1.0.0-beta.60

package/README.md

@@ -153,6 +153,91 @@ Alternatively, when `editModeEnabled` is true, `praxis-dynamic-form` renders a g
 - Utilities: form rule converters, normalize date arrays, **FormRulesService** (aplica regras de propriedades)
 - Metadata helpers: `providePraxisDynamicFormMetadata`
 
+## Editorial Hosting (Foundation)
+
+O `@praxisui/dynamic-form` agora aceita uma surface fundacional para hospedar blocos editoriais ao redor do formulario, sem misturar esses blocos com `fieldMetadata` nem com `formData`.
+
+Inputs relevantes:
+- `config.formBlocksBefore?: WidgetDefinition[]`
+- `config.formBlocksAfter?: WidgetDefinition[]`
+- `config.editorialContext?: Record<string, unknown>`
+- `[editorialContext]?: Record<string, unknown>`
+
+Precedencia de contexto editorial:
+1. runtime base do form
+2. `config.editorialContext`
+3. input host `[editorialContext]`
+
+As camadas posteriores sobrescrevem as anteriores.
+
+Exemplo minimo:
+
+```ts
+import type { FormConfig } from '@praxisui/core';
+
+const formConfig: FormConfig = {
+  editorialContext: {
+    accountName: 'Helena Costa',
+    accountRole: 'Gestora financeira',
+  },
+  formBlocksBefore: [
+    {
+      id: 'praxis-wizard-content',
+      inputs: {
+        blockId: 'editorial:before:hero:1',
+        title: 'Praxis Summit 2026',
+        subtitle: 'Inscricao institucional',
+        text: 'Placeholder fundacional para hero/rich text enquanto os widgets editoriais definitivos ainda nao existem.',
+      },
+    },
+  ],
+  formBlocksAfter: [
+    {
+      id: 'praxis-wizard-inline-notice',
+      inputs: {
+        blockId: 'editorial:after:legal:1',
+        tone: 'info',
+        text: 'Placeholder fundacional para legal-notice.',
+      },
+    },
+  ],
+  sections: [
+    {
+      id: 'registration',
+      title: 'Dados da inscricao',
+      rows: [
+        {
+          columns: [
+            { fields: ['fullName'] },
+            { fields: ['workEmail'] },
+          ],
+        },
+      ],
+    },
+  ],
+  fieldMetadata: [
+    { name: 'fullName', label: 'Nome completo', controlType: 'input', required: true },
+    { name: 'workEmail', label: 'E-mail corporativo', controlType: 'email', required: true },
+  ],
+};
+```
+
+Uso no host:
+
+```html
+<praxis-dynamic-form
+  [config]="formConfig"
+  [editorialContext]="{ accountName: 'Helena Costa', accountRole: 'Host override' }"
+  (widgetEvent)="onWidgetEvent($event)"
+></praxis-dynamic-form>
+```
+
+Notas:
+- `formBlocksBefore` e `formBlocksAfter` nao entram em `formData`.
+- `widgetEvent` reemite eventos dos widgets hospedados com `placement` (`before` ou `after`).
+- `editorialContext` deve ser tratado como imutavel; mutacoes in-place nao invalidam o cache do host.
+- No ciclo fundacional, exemplos podem usar widgets existentes como placeholders visuais para hero, rich text, legal notice, user context summary e footer links.
+
 See public exports: `projects/praxis-dynamic-form/src/public-api.ts`.
 
 ## Documentacao Tecnica da Lib