@praxisui/dynamic-fields 1.0.0-beta.48 → 1.0.0-beta.52

package/README.md

@@ -1,3 +1,49 @@
+---
+title: "Dynamic Fields"
+slug: "dynamic-fields-overview"
+description: "Visao geral do @praxisui/dynamic-fields com renderizacao metadata-driven, registro lazy de componentes, tokens M3 e campos enterprise."
+doc_type: "reference"
+document_kind: "component-overview"
+component: "dynamic-fields"
+category: "components"
+audience:
+  - "frontend"
+  - "host"
+  - "architect"
+level: "intermediate"
+status: "active"
+owner: "praxis-ui"
+tags:
+  - "dynamic-fields"
+  - "metadata"
+  - "forms"
+  - "runtime"
+  - "material"
+order: 32
+icon: "toc"
+toc: true
+sidebar: true
+search_boost: 1.0
+reading_time: 16
+estimated_setup_time: 25
+version: "1.0"
+related_docs:
+  - "dynamic-fields-field-catalog"
+  - "dynamic-fields-field-selection-guide"
+  - "dynamic-fields-host-custom-field-guide"
+  - "dynamic-fields-host-custom-field-troubleshooting"
+  - "dynamic-fields-inline-filter-catalog"
+  - "dynamic-fields-filter-inline-components-guide"
+  - "host-integration-guide"
+  - "consumer-integration-quickstart"
+keywords:
+  - "dynamic field loader"
+  - "metadata-driven fields"
+  - "material controls"
+  - "runtime registry"
+last_updated: "2026-03-07"
+---
+
 # @praxisui/dynamic-fields — Dynamic Form Fields
 
 ## 🔰 Exemplos / Quickstart
@@ -87,36 +133,32 @@ const isRegistered = registry.isRegistered(FieldControlType.INPUT);
 
 ## 📄 Documentacao Tecnica da Lib
 
-- `projects/praxis-dynamic-fields/docs/filter-inline-components-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inventory.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-field-catalog.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-field-selection-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-host-custom-field-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-host-custom-field-troubleshooting.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-inventory.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-catalog.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-selection-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-runtime-contract.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-custom-component-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-inline-filter-troubleshooting.md`
+- `projects/praxis-dynamic-fields/docs/filter-inline-components-guide.md` (slug: `dynamic-fields-filter-inline-components-guide`)
 - `projects/praxis-dynamic-fields/docs/generic-crud-service.md`
 
 ### Componentes Suportados
 
-O sistema usa as constantes do `@praxisui/core` para garantir consistência:
-
-- `FieldControlType.INPUT` - Campo de texto Material Design
-- `FieldControlType.TEXTAREA` - Área de texto Material Design
-- `FieldControlType.SELECT` - Campo de seleção Material Design
-- `FieldControlType.CHECKBOX` - Caixa de seleção Material Design
-- `FieldControlType.RADIO` - Botão de rádio Material Design
-- `FieldControlType.DATE_PICKER` - Seletor de data Material Design
-- `FieldControlType.EMAIL_INPUT` - Campo de email
-- `FieldControlType.PASSWORD` - Campo de senha
-- `FieldControlType.CURRENCY_INPUT` - Campo monetário
-- `FieldControlType.NUMERIC_TEXT_BOX` - Campo numérico
-- `FieldControlType.MULTI_SELECT` - Seleção múltipla
-- `FieldControlType.AUTO_COMPLETE` - Auto completar (busca habilitada por padrão)
-- `FieldControlType.DATE_TIME_PICKER` - Data e hora
-- `FieldControlType.DATE_RANGE` - Intervalo de datas
-- `FieldControlType.FILE_UPLOAD` - Upload de arquivos
-- `FieldControlType.TOGGLE` - Interruptor Material Design
-- `FieldControlType.SLIDER` - Slider Material Design
-- `FieldControlType.TIME_PICKER` - Seletor de horário
-- `FieldControlType.RATING` - Classificação por estrelas
-- `FieldControlType.COLOR_PICKER` - Seletor de cores
-- `FieldControlType.AVATAR` - Avatar visual (imagem/ícone/iniciais)
-
-Campos com `FieldControlType.AUTO_COMPLETE` utilizam internamente o `MaterialSearchableSelectComponent`, habilitando busca automaticamente.
+A fonte de verdade do suporte default e o `ComponentRegistryService`.
+
+Use os documentos governados abaixo em vez de manter listas textuais soltas:
+
+- inventario auditavel do runtime: `dynamic-fields-inventory.md`
+- catalogo principal de fields de formulario: `dynamic-fields-field-catalog.md`
+- guia de escolha do field correto: `dynamic-fields-field-selection-guide.md`
+- extensao do host: `dynamic-fields-host-custom-field-guide.md`
+- troubleshooting de extensao: `dynamic-fields-host-custom-field-troubleshooting.md`
+- trilha especializada de filtros compactos: `dynamic-fields-inline-filter-catalog.md`
 
 ## 🧩 MaterialSelectComponent
 
@@ -391,6 +433,18 @@ _Sistema desenvolvido seguindo diretrizes de simplicidade e foco no essencial._
 
 ## 🔌 Extensão pelo App Host (registrando seu próprio componente)
 
+Resumo executivo:
+
+- `ComponentRegistryService.register(...)`: registra o componente que o runtime carrega.
+- `ComponentMetadataRegistry.register(...)`: registra nome/ícone/superfície editorial.
+- `controlType` do contrato deve bater com `ComponentDocMeta.id`.
+- Hot metadata funciona melhor quando o componente expõe `setInputMetadata(...)` e/ou signal de metadata.
+
+Para o guia governado completo, consulte:
+
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-host-custom-field-guide.md`
+- `projects/praxis-dynamic-fields/docs/dynamic-fields-host-custom-field-troubleshooting.md`
+
 Aplicações host podem registrar componentes próprios para uso no DynamicFieldLoader e expor metadados para título/ícone amigáveis no editor.
 
 ### 1) Registrar o componente no runtime (DynamicFieldLoader)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "1.0.0-beta.48",
+  "version": "1.0.0-beta.52",
   "description": "Angular Material-based dynamic form fields for Praxis UI with lazy loading and metadata-driven rendering.",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
@@ -10,10 +10,10 @@
     "@angular/cdk": "^20.1.0",
     "@angular/router": "^20.1.0",
     "rxjs": "^7.8.0",
-    "@praxisui/specification-core": "^1.0.0-beta.48",
-    "@praxisui/core": "^1.0.0-beta.48",
-    "@praxisui/cron-builder": "^1.0.0-beta.48",
-    "@praxisui/dialog": "^1.0.0-beta.48"
+    "@praxisui/specification-core": "^1.0.0-beta.52",
+    "@praxisui/core": "^1.0.0-beta.52",
+    "@praxisui/cron-builder": "^1.0.0-beta.52",
+    "@praxisui/dialog": "^1.0.0-beta.52"
   },
   "dependencies": {
     "tslib": "^2.3.0"