@praxisui/metadata-editor 1.0.0-beta.60 → 1.0.0-beta.63

package/README.md

@@ -1,13 +1,19 @@
 # @praxisui/metadata-editor
 
-## 🔰 Exemplos / Quickstart
+Editores de metadados do Praxis UI para configuracao de campos, propriedades e regras de cascata em runtime.
 
-Para ver esta biblioteca em funcionamento em uma aplicação completa, utilize o projeto de exemplo (Quickstart):
+## Documentation
 
-- Repositório: https://github.com/codexrodrigues/praxis-ui-quickstart
-- O Quickstart demonstra a integração das bibliotecas `@praxisui/*` em um app Angular, incluindo instalação, configuração e uso em telas reais.
+- Official documentation: https://praxisui.dev
+- Quickstart reference app: https://github.com/codexrodrigues/praxis-ui-quickstart
+- Recommended for: hosts that need runtime metadata editing without coupling form rendering and editor concerns
 
-Editores de metadados (configurações de campos) do Praxis UI. Esta biblioteca não renderiza campos de formulário em runtime; ela oferece UI e serviços para editar as propriedades (metadata) dos campos, incluindo um renderizador dinâmico de editores e uma aba para gerir regras de cascata entre campos.
+## When to use
+
+- Editar propriedades e regras de campos em runtime
+- Separar a UI de edicao de metadata da renderizacao final dos componentes
+- Oferecer ferramentas internas de configuracao sem expor detalhes de implementacao ao host
+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`.
 

package/fesm2022/praxisui-metadata-editor.mjs

@@ -1254,13 +1254,14 @@ const radioProperties = [
     // Geral
     { name: 'label', label: 'Label', editorType: 'text', group: 'Geral' },
     { name: 'hint', label: 'Hint', editorType: 'text', group: 'Geral' },
+    { name: 'description', label: 'Descrição', editorType: 'textarea', group: 'Geral', hint: 'Texto de apoio adicional do grupo de radio.' },
     // Dados/Opções
     {
-        name: 'providerOptions',
+        name: 'options',
         label: 'Opções (estáticas)',
         editorType: 'textarea',
         group: 'Dados/Opções',
-        hint: 'JSON: [{ "value":1, "text":"Um" }] ou linhas: valor|rótulo. Apenas uma opção pode ser selecionada.',
+        hint: 'JSON: [{ "value":1, "text":"Um","description":"Ajuda","disabled":false }] ou linhas: valor|rótulo. Apenas uma opção pode ser selecionada.',
     },
     { name: 'optionLabelKey', label: 'Chave do rótulo (remoto)', editorType: 'text', group: 'Dados/Opções', hint: 'Campo exibido ao carregar via API.' },
     { name: 'optionValueKey', label: 'Chave do valor (remoto)', editorType: 'text', group: 'Dados/Opções', hint: 'Campo salvo como value vindo da API.' },
@@ -1268,6 +1269,19 @@ const radioProperties = [
     { name: 'resourcePath', label: 'Resource Path', editorType: 'text', group: 'Fonte Remota', hint: 'Endpoint para opções remotas.' },
     { name: 'filterCriteria', label: 'Critérios de filtro (JSON)', editorType: 'text', group: 'Fonte Remota', hint: '{ "active": true } — filtro inicial na busca remota.' },
     // Formato/Comportamento
+    { name: 'selectionMode', label: 'Modo de seleção', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'single', text: 'Escolha única' },
+        ], hint: 'Contrato canônico do radio group.' },
+    { name: 'variant', label: 'Variante', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'default', text: 'Default' },
+            { value: 'compact', text: 'Compacto' },
+            { value: 'tiles', text: 'Tiles' },
+        ] },
+    { name: 'density', label: 'Densidade', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'compact', text: 'Compacta' },
+            { value: 'comfortable', text: 'Confortável' },
+            { value: 'spacious', text: 'Espaçosa' },
+        ] },
     { name: 'layout', label: 'Layout', editorType: 'select', group: 'Formato/Comportamento', options: [
             { value: 'horizontal', text: 'Horizontal' },
             { value: 'vertical', text: 'Vertical' },
@@ -2998,15 +3012,31 @@ const checkboxGroupProperties = [
     // Geral
     { name: 'label', label: 'Label', editorType: 'text', group: 'Geral' },
     { name: 'hint', label: 'Hint', editorType: 'text', group: 'Geral', hint: 'Texto de ajuda exibido abaixo do campo.' },
+    { name: 'description', label: 'Descrição', editorType: 'textarea', group: 'Geral', hint: 'Texto de apoio adicional para checkbox booleano/consent.' },
     // Ícones
     // (sem ícones)
     // Dados/Opções
-    { name: 'options', label: 'Opções (JSON ou linhas valor|rótulo)', editorType: 'textarea', group: 'Dados/Opções', hint: 'Ex.: [{"value":1,"text":"Um"}] ou "1|Um" em cada linha.' },
+    { name: 'options', label: 'Opções (JSON ou linhas valor|rótulo)', editorType: 'textarea', group: 'Dados/Opções', hint: 'Ex.: [{"value":1,"text":"Um","description":"Ajuda","disabled":false}] ou "1|Um" em cada linha.' },
     { name: 'resourcePath', label: 'Recurso (remoto)', editorType: 'text', group: 'Dados/Opções', row: 'dados.remoto', inline: true, hint: 'Endpoint para carregar opções.' },
     { name: 'filterCriteria', label: 'Filtro (JSON)', editorType: 'textarea', group: 'Dados/Opções', hint: '{ "active": true } — filtro inicial remoto.' },
     { name: 'optionLabelKey', label: 'Chave rótulo', editorType: 'text', group: 'Dados/Opções', row: 'dados.keys', inline: true, hint: 'Campo exibido ao carregar da API.' },
     { name: 'optionValueKey', label: 'Chave valor', editorType: 'text', group: 'Dados/Opções', row: 'dados.keys', inline: true, hint: 'Campo salvo como value.' },
     // Formato/Comportamento
+    { name: 'selectionMode', label: 'Modo de seleção', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'boolean', text: 'Booleano simples' },
+            { value: 'multiple', text: 'Múltipla seleção' },
+        ], hint: 'Define a semântica do runtime. Sem valor, o legado infere pelo conjunto de opções.' },
+    { name: 'variant', label: 'Variante', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'default', text: 'Default' },
+            { value: 'consent', text: 'Consentimento' },
+            { value: 'compact', text: 'Compacto' },
+            { value: 'tiles', text: 'Tiles' },
+        ] },
+    { name: 'density', label: 'Densidade', editorType: 'select', group: 'Formato/Comportamento', options: [
+            { value: 'compact', text: 'Compacta' },
+            { value: 'comfortable', text: 'Confortável' },
+            { value: 'spacious', text: 'Espaçosa' },
+        ] },
     { name: 'searchable', label: 'Pesquisável', editorType: 'checkbox', group: 'Formato/Comportamento', hint: 'Mostra campo de busca (em remoto, filtra na API).' },
     { name: 'selectAll', label: 'Selecionar todos', editorType: 'checkbox', group: 'Formato/Comportamento', hint: 'Inclui opção para marcar todos.' },
     { name: 'maxSelections', label: 'Máx. seleções', editorType: 'number', group: 'Formato/Comportamento', hint: 'Limite de itens marcados (0 = sem limite).' },
@@ -3019,6 +3049,7 @@ const checkboxGroupProperties = [
             { value: 'after', text: 'Depois' },
         ] },
     { name: 'indeterminate', label: 'Indeterminado', editorType: 'checkbox', group: 'Formato/Comportamento', hint: 'Mostra estado parcial (ex.: dependente de filhos).' },
+    { name: 'links', label: 'Links ricos (JSON)', editorType: 'textarea', group: 'Formato/Comportamento', hint: 'Ex.: [{"label":"Política","href":"https://...","target":"_blank"}]. Usado em modo boolean/consent.' },
     { name: 'linkText', label: 'Texto do link', editorType: 'text', group: 'Formato/Comportamento', hint: 'Rótulo do link associado.' },
     { name: 'linkUrl', label: 'URL do link', editorType: 'text', group: 'Formato/Comportamento', hint: 'Ex.: https://dominio...' },
     { name: 'linkTarget', label: 'Alvo do link', editorType: 'select', group: 'Formato/Comportamento', options: [
@@ -3027,6 +3058,7 @@ const checkboxGroupProperties = [
         ] },
     // Validação
     { name: 'required', label: 'Obrigatório', editorType: 'checkbox', group: 'Validação' },
+    { name: 'requiredChecked', label: 'Exigir marcado', editorType: 'checkbox', group: 'Validação', hint: 'Para consentimentos e aceite obrigatório.' },
     { name: 'validators.requiredMessage', label: 'Mensagem: obrigatório', editorType: 'text', group: 'Validação' },
     // Ações
     // (sem ações adicionais)
@@ -5617,7 +5649,7 @@ class FieldMetadataEditorComponent {
             });
         }
         catch { }
-        // Inject default for providerOptions from seed.options when present (radio/editor-friendly name)
+        // Backward-compatible bridge: if a config still uses providerOptions, hydrate from seed.options.
         try {
             const hasProviderOptions = this.normalizedProps.some((p) => p.name === 'providerOptions');
             const seedOptions = this.seed?.options;
@@ -5970,6 +6002,12 @@ class FieldMetadataEditorComponent {
                 patch.inlineTimeTrackShifts = parsedTrackShifts;
             }
         }
+        if (typeof patch.links === 'string') {
+            const parsedLinks = this.parseArrayTextarea(patch.links);
+            if (parsedLinks) {
+                patch.links = parsedLinks;
+            }
+        }
     }
     /**
      * Interpreta textarea como lista simples de strings: