@praxisui/metadata-editor 8.0.0-beta.7 → 8.0.0-beta.70

package/README.md

@@ -16,6 +16,7 @@ Editores de metadados do Praxis UI para configuracao de campos, propriedades e r
 Esta biblioteca não renderiza campos de formulario em runtime; ela oferece UI e servicos para editar propriedades de campos, incluindo um renderizador dinamico de editores e uma aba para gerir regras de cascata entre campos.
 
 Documentação de arquitetura: `projects/praxis-metadata-editor/docs/architecture.praxis.md`.
+Authoring de coleções editáveis: `projects/praxis-metadata-editor/docs/editable-collection-authoring.praxis.md`.
 
 ## Instalação
 
@@ -79,6 +80,14 @@ this.settings.open({
 
 Emite patches apenas com mudanças relevantes (delta), adequados para persistência.
 
+Para `controlType: "array"`, o editor renderiza `array.itemSchema.fields`
+como uma lista visual estruturada de `FieldMetadata[]`. O fluxo preserva
+propriedades avançadas dos subcampos, como `options`, `optionSource`,
+validadores e `submitPolicy`, mesmo quando a superfície visual edita apenas
+nome, label, tipo de controle e obrigatoriedade.
+Subcampos sem nome ou com nomes duplicados bloqueiam `Apply`, `Save`,
+`apply()` e `getSettingsValue()`.
+
 ### Cascade Manager Tab (gerenciador de cascata)
 
 Aba para declarar dependências entre campos e como popular filtros/valores quando um campo dependente muda.
@@ -113,6 +122,32 @@ Funcionalidades:
 - `SchemaNormalizerService` — normaliza defaults, converte valores e aplica opções de provider.
 - `ContextValidatorRegistryService` — registrador de validadores contextuais.
 
+## Agentic Authoring Contract
+
+`praxis-metadata-editor` publica um manifesto executavel em `PRAXIS_METADATA_EDITOR_AUTHORING_MANIFEST`.
+
+Esse contrato governa a edicao estrutural de metadata:
+
+- propriedades canonicas de `FieldMetadata`
+- troca de `controlType` com descoberta em dynamic-fields
+- `optionSource`
+- cascatas e `dependencyFilterMap`
+- cobertura do renderer visual
+- regras de validacao
+- hints/contexto
+- normalizacao de schema
+
+O manifesto nao cria shapes paralelos para hosts. Quando a metadata vier de backend `x-ui`, a edicao deve preservar a semantica canonica, especialmente `x-ui.optionSource.dependsOn` e `x-ui.optionSource.dependencyFilterMap`. Suporte apenas por JSON cru nao e aceito quando a propriedade exige cobertura visual no editor.
+
+Regras do contrato:
+
+- `FieldMetadata` e o documento canonico editado.
+- `controlType` precisa existir na descoberta de dynamic-fields e na cobertura visual do metadata-editor.
+- cascatas devem preservar campos existentes, evitar ciclos e manter a distincao entre a forma backend `x-ui.optionSource.dependsOn`/`dependencyFilterMap` e o contrato de save do editor em `dependencyFields`/`dependencyFilterMap`.
+- normalizacao nao pode remover propriedades canonicas avancadas.
+- round-trip deve preservar abrir, editar, aplicar/salvar, reabrir e consumo runtime.
+- cada operacao declara target, resolver, ambiguity policy, preconditions, validators, effects, affected paths e `submissionImpact` tipado.
+
 ## Build e Publicação
 
 ```bash