@praxisui/dynamic-form 3.0.0-beta.7 → 3.0.0-beta.9

package/README.md

@@ -137,6 +137,22 @@ Presentation/read-only note:
 - `praxis-dynamic-form` hospeda `FieldMetadata`, mas não é o resolvedor direto de `valuePresentation`.
 - quando campos entram em modo view/presentation, a semântica de apresentação vem do metadata do campo e é resolvida por `@praxisui/dynamic-fields`.
 
+## Canonical editorial resolution for field editors
+
+Para nome, descricao e icone do tipo de campo no configurador/layout editor e no titulo do metadata editor:
+
+- `@praxisui/dynamic-form` nao mantem mapa editorial local por `controlType`;
+- a resolucao canonica vem de `ComponentMetadataRegistry.resolveEditorial(..., { namespace: 'dynamicFields' })`;
+- aliases e normalizacao de `controlType` sao apenas ponte tecnica de lookup, nao fonte de copy;
+- quando nao existe descriptor canonico para aquele tipo, o fallback aceito e tecnico/neutro.
+
+Fronteira operacional:
+
+- package-owned fields de `@praxisui/dynamic-fields`: consomem descriptor editorial canonico da lib;
+- `ComponentDocMeta` desses fields e derivado, nao a origem semantica;
+- catalogo/showcase continua derivado;
+- custom types do host seguem suportados via `ComponentMetadataRegistry.register(ComponentDocMeta)`, sem exigir mapa local no form.
+
 ### Canonical DI contract for hosts
 
 `praxis-dynamic-form` does not register `GenericCrudService` internally.
@@ -537,6 +553,9 @@ Dicas
 - Editor integrado:
   - `Ações > Botões Customizados` permite editar `label`, `icon`, `color`, `variant`, `size`, `tooltip`, `shortcut`, `className`, `disabled`, `loading` e `style` (JSON).
   - `Seção > Cabeçalho` permite editar `headerActions[]` sem JSON manual, incluindo adicionar, remover e reordenar ações do header.
+  - No campo `action`, o editor sugere o catálogo global canônico do core e mantém fallback para ação customizada livre; o valor salvo continua compatível com `action` textual legado.
+  - Ações globais no header seguem o mesmo princípio operacional do restante da plataforma: dependem de executor no app (`ActionResolver`) e validam parâmetro obrigatório quando o catálogo exigir.
+  - Para `surface.open`, o editor expõe o authoring especializado da surface em vez de reduzir tudo a texto cru.
   - A mesma aba permite reordenar `actions.custom[]` pelos controles de mover para cima/baixo; a ordem salva é a mesma ordem renderizada no runtime, sempre depois de `submit/cancel/reset`.
 
 ### Tokens M3 obrigatórios (host)