@praxisui/dynamic-form 8.0.0-beta.1 → 8.0.0-beta.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -316,6 +316,19 @@ export class FormEditorLauncherComponent {
316
316
 
317
317
  Alternatively, when `enableCustomization` is true, `praxis-dynamic-form` renders a gear button that opens the editor internally.
318
318
 
319
+ ## Agentic Authoring & Manifest
320
+
321
+ `praxis-dynamic-form` supports executable authoring contracts through the `ComponentAuthoringManifest`. This allows AI agents to perform structured, safe, and deterministic edits to the form configuration.
322
+
323
+ - **Manifest:** `PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST`
324
+ - **Editable targets:** 10 target kinds: `field`, `section`, `row`, `column`, `formAction`, `formRule`, `message`, `layoutPlacement`, `localField`, `schemaBackedField`.
325
+ - **Operations:** Supports 22 operations covering field property updates, local field lifecycle, layout manipulation, rule management, and action configuration.
326
+ - **Validation:** 19 deterministic validators ensure uniqueness of IDs, layout integrity, local/schema-backed separation, destructive confirmation, and editor round-trip preservation.
327
+ - **Examples/evals:** 8 fixtures cover local transient fields, schema-backed relabeling, layout moves, visibility rules, unknown target rejection, destructive confirmation, and save/reopen without drift.
328
+ - **Round-trip:** Preserves editor state and ensures that AI-generated patches are compatible with the visual editor.
329
+
330
+ For more details on authoring manifests, see `docs/ai/agentic-authoring/component-authoring-contracts/README.md`.
331
+
319
332
  ## API Surface
320
333
 
321
334
  - Components: `PraxisDynamicForm`, `PraxisDynamicFormConfigEditor`, `JsonConfigEditorComponent`, `LayoutEditorComponent`
@@ -665,14 +678,14 @@ Cobertura ja estabilizada:
665
678
  - `JSON` com edicao real e bloqueio de payload invalido
666
679
  - `Hooks`
667
680
  - `Acoes` (`Botoes Padrao` e `Layout`)
668
- - `Acoes` customizadas profundas (`showAlert` simples e estruturado)
681
+ - `Acoes` customizadas profundas (`dialog.alert` com `globalAction` simples e estruturado)
669
682
  - `Comportamento`
670
683
  - `Mensagens`
671
684
  - `Dicas e Tooltips`
672
685
 
673
686
  Ajuste tecnico aplicado durante essa fase:
674
687
  - [praxis-dynamic-form-config-editor.ts](/mnt/d/Developer/praxis-plataform/praxis-ui-angular/projects/praxis-dynamic-form/src/lib/config-editor/praxis-dynamic-form-config-editor.ts) agora chama `this.jsonEditor?.updateJsonFromConfig(this.editedConfig)` em `onConfigChange(...)` para manter o editor JSON sincronizado com mudancas vindas de abas como `Hooks`.
675
- - [actions-editor.component.ts](/mnt/d/Developer/praxis-plataform/praxis-ui-angular/projects/praxis-dynamic-form/src/lib/actions-editor/actions-editor.component.ts) agora mescla catalogo legado + catalogo global do app para o editor de acoes customizadas.
688
+ - [actions-editor.component.ts](/mnt/d/Developer/praxis-plataform/praxis-ui-angular/projects/praxis-dynamic-form/src/lib/actions-editor/actions-editor.component.ts) agora usa o catalogo global canonico do app para o editor de acoes customizadas.
676
689
  - [actions-editor.component.ts](/mnt/d/Developer/praxis-plataform/praxis-ui-angular/projects/praxis-dynamic-form/src/lib/actions-editor/actions-editor.component.ts) agora preserva draft local dos campos globais e usa `track` estavel em `actions.custom`.
677
690
 
678
691
  Comando base usado para rerodar suites isoladas:
@@ -720,6 +733,7 @@ Apache-2.0 – see the `LICENSE` packaged with this library or the repository ro
720
733
  - Fluxo de Schema (ETag/304, schemaId, reconciliação): `projects/praxis-core/docs/schema-flow.md` (canônico) e `docs/schemas/fluxo-schema.md` (resumo operacional)
721
734
  - Guia de implementação e metadados da cascata: `docs/CASCADE-NATIVA.md`
722
735
  - Padrões de endpoints (Options vs Filter) para selects: `projects/praxis-dynamic-fields/docs/generic-crud-service.md` (canônico) e `docs/DEVS-GENERIC-CRUD-SERVICE.md` (resumo operacional)
736
+ - Recipe oficial de Entity Lookup corporativo com `RESOURCE_ENTITY`, `dependsOn`, `dependencyFilterMap`, reidratação por `by-ids` e política de seleção: `examples/ai-recipes/praxis-dynamic-form.entity-lookup-procurement.json`
723
737
 
724
738
  ## Verificação de Schema (ETag/If-None-Match)
725
739