@praxisui/dynamic-form 1.0.0-beta.59 → 1.0.0-beta.61

package/README.md

@@ -37,7 +37,7 @@ keywords:
   - "schema-driven"
   - "layout editor"
   - "settings integration"
-last_updated: "2026-03-07"
+last_updated: "2026-03-12"
 ---
 
 # @praxisui/dynamic-form
@@ -153,6 +153,145 @@ 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.formBlocksBeforeActions?: 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',
+    accountContext: {
+      user: {
+        name: 'Helena Costa',
+        email: 'helena.costa@praxis.demo',
+        role: 'Gestora financeira',
+      },
+      tenant: {
+        name: 'Praxis Holding',
+      },
+    },
+  },
+  formBlocksBefore: [
+    {
+      id: 'widget:hero-banner',
+      inputs: {
+        instanceId: 'editorial:before:hero:1',
+        title: 'Praxis Summit 2026',
+        subtitle: 'Inscricao institucional',
+        description: 'Experiencia institucional com composicao editorial hospedada antes do formulario.',
+        variant: 'event',
+      },
+    },
+    {
+      id: 'widget:rich-text-block',
+      inputs: {
+        instanceId: 'editorial:before:rich-text:1',
+        title: 'Antes de comecar',
+        subtitle: 'Contexto editorial',
+        icon: 'info',
+        contentFormat: 'markdown',
+        content: 'Confirme os dados abaixo antes do envio e consulte a [documentacao](https://example.com/docs) se precisar de suporte.',
+      },
+    },
+    {
+      id: 'widget:legal-notice',
+      inputs: {
+        instanceId: 'editorial:before:legal:1',
+        title: 'Uso de dados',
+        contentFormat: 'plain',
+        content: 'Ao participar, voce reconhece a politica institucional aplicavel.',
+        severity: 'info',
+      },
+    },
+  ],
+  formBlocksBeforeActions: [
+    {
+      id: 'form:user-context-summary',
+      inputs: {
+        instanceId: 'editorial:before-actions:user-context:1',
+        title: 'Conta atual',
+        source: 'context',
+        context: '${accountContext}',
+        fields: [
+          { label: 'Nome', valuePath: 'user.name', fallback: '-' },
+          { label: 'E-mail', valuePath: 'user.email', fallback: '-' },
+        ],
+      },
+    },
+  ],
+  formBlocksAfter: [
+    {
+      id: 'widget:footer-links',
+      inputs: {
+        instanceId: 'editorial:after:footer-links:1',
+        brandText: 'Praxis',
+        secondaryText: 'Todos os direitos reservados.',
+        links: [
+          { label: 'Docs', href: '/components/dynamic-form/docs/overview' },
+          { label: 'API', href: '/components/dynamic-form/api' },
+        ],
+      },
+    },
+  ],
+  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`, `formBlocksBeforeActions` e `formBlocksAfter` nao entram em `formData`.
+- `widgetEvent` reemite eventos dos widgets hospedados com `placement` (`before`, `beforeActions` ou `after`).
+- `editorialContext` deve ser tratado como imutavel; mutacoes in-place nao invalidam o cache do host.
+- A surface editorial ja suporta widgets reais compartilhados para hero, rich text, legal notice, user context summary e footer links.
+- `formBlocksBeforeActions` renderiza depois das secoes e antes da area principal de acoes, sendo o slot recomendado para blocos contextuais como `form:user-context-summary`.
+- `formBlocksAfter` permanece como slot de fechamento e continua renderizando depois do formulario inteiro, incluindo os CTAs.
+
 See public exports: `projects/praxis-dynamic-form/src/public-api.ts`.
 
 ## Documentacao Tecnica da Lib