npm - @praxisui/dynamic-fields - Versions diffs - 9.0.59 → 9.0.60 - Mend

@praxisui/dynamic-fields 9.0.59 → 9.0.60

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.

Files changed (10) hide show

package/README.md +1 -1
package/ai/component-registry.json +21425 -311
package/docs/dynamic-fields-inline-components-guide.md +8 -7
package/docs/dynamic-fields-inline-filter-runtime-contract.md +2 -0
package/fesm2022/praxisui-dynamic-fields.mjs +4157 -1584
package/package.json +3 -3
package/src/lib/components/inline-currency-range/pdx-inline-currency-range.json-api.md +12 -5
package/src/lib/components/inline-distance-radius/pdx-inline-distance-radius.json-api.md +140 -485
package/src/lib/components/inline-rating/pdx-inline-rating.json-api.md +127 -438
package/types/praxisui-dynamic-fields.d.ts +118 -14

package/src/lib/components/inline-distance-radius/pdx-inline-distance-radius.json-api.md CHANGED Viewed

@@ -7,7 +7,7 @@ document_kind: "json-api-canonical"
 reference_mode: "canonical"
 contract_format: "json"
 contract_source: "runtime-and-code"
-description: "Referencia canonica do contrato JSON do componente pdx-inline-distance-radius."
+description: "Contrato canônico do filtro inline de distância e raio, incluindo authoring, confirmação explícita e unidades."
 category: "components"
 sub_category: "dynamic-fields"
 audience:
@@ -18,11 +18,11 @@ level: "advanced"
 status: "active"
 owner: "praxis-ui"
 source_of_truth:
-  - "projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts"
-  - "projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts"
   - "projects/praxis-core/src/lib/models/material-field-metadata.interface.ts"
-source_of_truth_last_verified: "2026-03-06"
-last_updated: "2026-03-06"
+  - "projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts"
+  - "projects/praxis-metadata-editor/src/lib/config/inline-distance-radius.config.ts"
+source_of_truth_last_verified: "2026-09-04"
+last_updated: "2026-09-04"
 toc: true
 sidebar: true
 tags:
@@ -32,556 +32,239 @@ tags:
 api_stability: "canonical"
 schema_verified: true
 runtime_verified: true
-editor_coverage_verified: false
+editor_coverage_verified: true
 runtime_scope: "public"
 legacy_paths_present: true
-has_known_mismatches: false
+has_known_mismatches: true
 related_components:
   - "praxis-table"
   - "pdx-inline-range-slider"
-  - "pdx-material-range-slider"
-  - "pdx-base-input-runtime-contract"
+  - "pdx-material-chips"
 ---
 # pdx-inline-distance-radius
-Este documento e a referencia canonica da API JSON de pdx-inline-distance-radius.
+Filtro compacto de distância para toolbars corporativas. Suporta raio único ou intervalo, conversão visual entre unidades, marcadores, presets e confirmação explícita sem expor o rascunho ao filtro aplicado.
 ## Summary
-- Tipo documental: API reference canonica de contrato JSON.
-- Source of truth: runtime e codigo declarados no frontmatter.
-- Objetivo operacional: consulta rapida, auditavel e deterministica sob pressao.
-- Resumo funcional: Contrato JSON metadata-driven com comportamento definido por runtime e schema associado.
+- O valor canônico é armazenado em `distanceBaseUnit`.
+- `mode`, `min`, `max` e `step` são os paths canônicos herdados do range slider.
+- Em modo explícito, alterações no painel permanecem locais até Aplicar.
+- O editor visual cobre presets escalares; presets estruturados continuam disponíveis pelo editor JSON.
 ## Purpose and scope
-- O componente consome payload JSON metadata-driven e expoe comportamento runtime configuravel por contrato.
-- Esta referencia cobre contrato publico, classificacao de paths e semantica de cobertura (runtime/schema/editor).
-- Fora de escopo: quickstart, tutorial narrativo e notas arquiteturais que nao alteram contrato publico.
+Use para filtros geográficos ou operacionais em que a distância participa da consulta. O componente materializa metadados; não calcula rotas, geocodificação, permissões ou regras de negócio.
 ## Consulta rapida (obrigatorio)
-| Regra/tema | Observado | Canonico desejado | Status | Evidencia |
-| --- | --- | --- | --- | --- |
-| Component id | `pdx-inline-distance-radius` | Manter ID canonico estavel e versionado por contrato | Active | frontmatter.component |
-| Primary contract source | `runtime-and-code` | Runtime, schema e docs devem permanecer rastreaveis | Partial | frontmatter.contract_source + source_of_truth |
-| Runtime coverage | `true` | Comportamentos runtime criticos devem ficar explicitamente verificados | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts` |
-| Schema/type coverage | `true` | Tipos e schema devem refletir paths publicos do contrato | Active | source_of_truth + Detailed API reference |
-| Editor/tooling coverage | `false` | Editor/tooling deve espelhar somente contrato publico suportado | Partial | `projects/praxis-core/src/lib/utils/inline-filter-controls.util.ts`, `projects/praxis-dynamic-fields/src/lib/services/component-registry/component-registry.service.ts` |
-| Path hygiene | `true` | Manter consistencia entre contrato canonico e caminhos documentados | Partial | frontmatter.legacy_paths_present |
-| Known mismatches | `false` | Registrar observed vs desired de forma auditavel | Active | frontmatter.has_known_mismatches |
+| Tema | Contrato | Status |
+| --- | --- | --- |
+| Modo | `metadata.mode: single ou range` | Active |
+| Limites | `metadata.min`, `metadata.max`, `metadata.step` | Active |
+| Valor persistido | número ou `{ start, end }`, em `distanceBaseUnit` | Active |
+| Confirmação | `metadata.inlineOverlay.applyMode` | Active |
+| Presets escalares no editor visual | `metadata.distancePresets: number[]` | Active |
+| Presets estruturados no editor visual | objetos com `label`, `icon`, `start` e `end` | Partial |
 ## Source of truth
-| Source | Kind | Notes |
-| --- | --- | --- |
-| projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts | runtime-code | Arquivo presente no repositorio e usado como evidencia de contrato. |
-| projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts | runtime-code | Arquivo presente no repositorio e usado como evidencia de contrato. |
-| projects/praxis-core/src/lib/models/material-field-metadata.interface.ts | schema-types | Arquivo presente no repositorio e usado como evidencia de contrato. |
+| Fonte | Responsabilidade |
+| --- | --- |
+| `material-field-metadata.interface.ts` | Tipo público e nomes canônicos |
+| `inline-distance-radius.component.ts` | Normalização, interação e valor runtime |
+| `inline-distance-radius.config.ts` | Cobertura do editor visual |
 ## Support legend
-- **Active**: suportado em runtime e liberado para uso externo.
-- **Partial**: suporte parcial, com restricoes, lacunas ou validacao incompleta.
-- **Declared-only**: declarado em tipos/schema sem evidencia operacional completa.
-- **Schema-only**: presente em schema/tipos sem cobertura runtime confirmada.
+- **Active:** suportado e coberto por runtime ou editor focal.
+- **Partial:** preservado, mas ainda sem representação visual completa.
+- **Deprecated:** aceito apenas para migração de consumidores existentes.
 ## Contract status snapshot
-| Item | Value | Notes |
+| Superfície | Estado | Observação |
 | --- | --- | --- |
-| Reference mode | `canonical` | Deve permanecer canonico |
-| Contract format | `json` | Contrato metadata-driven |
-| Contract source | `runtime-and-code` | Alinhar com source_of_truth |
-| Runtime scope | `public` | Escopo publicado para consumidores |
-| Runtime verified | `true` | Revisar sempre com evidencia de runtime |
-| Schema verified | `true` | Revisar sempre com evidencia de tipos/schema |
-| Editor coverage verified | `false` | Revisar sempre com evidencia de editor/tooling |
-| Current path hygiene | `true` | Segregar consistencia do contrato canonico |
-| Has known mismatches | `false` | Divergencias devem aparecer em secao dedicada |
+| Runtime | Active | Single, range, unidades, marks, presets e gradiente |
+| Schema/type | Active | Interface pública especializada |
+| Editor visual | Partial | Cobertura ampla; objetos de preset usam JSON |
+| Table/filter | Active | Valor confirmado é promovido ao filtro |
+| Persistência corporativa | Host-owned | Depende do `AsyncConfigStorage` configurado pelo host |
 ## Contract classification (obrigatorio)
 ### Canonical paths (public contract)
-| Path | Type | Required | Default | Status | Notes |
-| --- | --- | --- | --- | --- | --- |
-| `metadata` | object | true | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.mode` | string | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.distanceMode` | string | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.radiusMode` | string | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.distanceUnits` | array | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.units` | array | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.availableUnits` | array | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `metadata.distanceUnit` | unknown | false | n/a | Partial | See Detailed API reference for runtime semantics. |
+| Path | Tipo | Default | Cobertura |
+| --- | --- | --- | --- |
+| `metadata.controlType` | `inlineDistanceRadius` | obrigatório | Runtime/editor |
+| `metadata.mode` | `single ou range` | inferido pelo valor | Runtime/editor |
+| `metadata.min` | number | `1` | Runtime/editor |
+| `metadata.max` | number | `150` | Runtime/editor |
+| `metadata.step` | number | `1` | Runtime/editor |
+| `metadata.distanceStart` | number/null | vazio | Runtime/editor |
+| `metadata.distanceEnd` | number/null | vazio | Runtime/editor |
+| `metadata.distanceUnit` | `km ou mi` | `km` | Runtime/editor |
+| `metadata.distanceBaseUnit` | `km ou mi` | `km` | Runtime/editor |
+| `metadata.distanceUnits` | array/string | `[km, mi]` | Runtime/editor |
+| `metadata.distanceUnitLabels` | object/string | códigos das unidades | Runtime/editor |
+| `metadata.distancePresets` | array/string | presets internos | Runtime/editor parcial |
+| `metadata.distanceRadialRings` | number | `5` | Runtime/editor |
+| `metadata.distanceGradientLowColor` | CSS color | token semântico | Runtime/editor |
+| `metadata.distanceGradientMidColor` | CSS color | token semântico | Runtime/editor |
+| `metadata.distanceGradientHighColor` | CSS color | token semântico | Runtime/editor |
+| `metadata.inlineOverlay` | object | modo compartilhado | Runtime/editor |
+| `metadata.inlineAutoSize` | object | tokens responsivos | Runtime/editor |
 ### Path audit
-| Historical path | Canonical replacement | Support window | Runtime behavior | Notes |
-| --- | --- | --- | --- | --- |
-| `metadata.distanceMode` | `metadata.mode` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.distanceUnits` | `metadata.units` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.distanceUnit` | `metadata.unit` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.distancePresets` | `metadata.quickPresets` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.distanceRadialRings` | `metadata.radialRings` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.inlinePanelSubtitle` | `metadata.distanceSubtitle` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.distanceMin` | `metadata.min` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
-| `metadata.radiusMin` | `metadata.min` | not-yet-defined | accepted for backward compatibility | Alias inferido da evidencia preservada; validar em runtime. |
+| Path legado | Substituição | Estado |
+| --- | --- | --- |
+| `radiusMode` | `mode` | Deprecated |
+| `radiusMin` | `min` | Deprecated |
+| `radiusMax` | `max` | Deprecated |
+| `radiusStep` | `step` | Deprecated |
+| `unit` / `defaultUnit` | `distanceUnit` | Deprecated |
+| `baseUnit` | `distanceBaseUnit` | Deprecated |
+| `units` / `availableUnits` | `distanceUnits` | Deprecated |
+| `quickPresets` | `distancePresets` | Deprecated |
+| `radialRings` | `distanceRadialRings` | Deprecated |
+`distanceMode`, `distanceMin`, `distanceMax` e `distanceStep` não fazem parte do contrato canônico.
 ### Internal-only paths
-Nao ha paths internal-only confirmados no contrato publico desta revisao.
+Estados de painel, controles de formulário temporários, cache de presets e cores interpoladas não são persistíveis.
 ### Experimental paths
-Nao ha paths experimentais confirmados no contrato publico desta revisao.
+Não há paths experimentais publicados.
 ## Public contract surface (obrigatorio)
 ### Top-level configuration blocks
-| Block | Purpose | Required | Merge strategy | Notes |
-| --- | --- | --- | --- | --- |
-| `metadata` | Payload declarativo principal do componente | true | deep-merge | runtime linkage verified for core flows (component specs, 2026-03-06). |
-| `value` | Configuracao especifica de runtime | false | override | runtime linkage verified for core flows (component specs, 2026-03-06). |
-| `readonlyMode` | Override de readonly no host/runtime | false | override | runtime linkage verified for core flows (component specs, 2026-03-06). |
-| `disabledMode` | Override de disabled no host/runtime | false | override | runtime linkage verified for core flows (component specs, 2026-03-06). |
-| `visible` | Override de visibilidade no host/runtime | false | override | runtime linkage verified for core flows (component specs, 2026-03-06). |
-| `presentationMode` | Renderizacao de apresentacao sem interacao | false | override | runtime linkage verified for core flows (component specs, 2026-03-06). |
+O host fornece um `FieldMetadata` com `name`, `controlType` e propriedades de apresentação/validação. O valor pertence ao `FormControl`/CVA.
 ### Nested configuration blocks
-| Path | Type | Required | Default | Constraints | Notes |
-| --- | --- | --- | --- | --- | --- |
-| `metadata.mode` | string | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.distanceMode` | string | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.radiusMode` | string | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.distanceUnits` | array | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.units` | array | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.availableUnits` | array | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.distanceUnit` | unknown | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.unit` | unknown | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.defaultUnit` | unknown | false | n/a | component-defined | Partial; verify per source_of_truth. |
-| `metadata.distanceAllowUnitToggle` | unknown | false | n/a | component-defined | Partial; verify per source_of_truth. |
+- `inlineOverlay.actions.apply|cancel|clear` configura labels, aparência e papel de cor.
+- `inlineAutoSize` configura limites do trigger e do painel.
+- `distanceUnitLabels` preserva exatamente os labels authorados.
 ### Input bindings (inbound data)
-| Binding/Path | Type | Required | Source | Runtime normalization | Notes |
-| --- | --- | --- | --- | --- | --- |
-| `metadata` | object | true | host-json | component-defined | Primary inbound contract payload. |
-| `readonlyMode` | boolean | false | host-runtime | not-yet-verified | Host-level behavioral override. |
-| `disabledMode` | boolean | false | host-runtime | not-yet-verified | Host-level behavioral override. |
-| `visible` | boolean | false | host-runtime | not-yet-verified | Host-level behavioral override. |
-| `presentationMode` | boolean | false | host-runtime | not-yet-verified | Host-level behavioral override. |
+Metadados, controle externo e estados globais `disabled`, `readonly`, `loading` e `visible` são herdados do runtime de Dynamic Fields.
 ### Output events
-| Event | Payload | Trigger | Stability | Notes |
-| --- | --- | --- | --- | --- |
-| `valueChange` | unknown | runtime-event | Experimental | Validate payload shape against source_of_truth. |
-| `focusChange` | unknown | runtime-event | Experimental | Validate payload shape against source_of_truth. |
-| `nativeBlur` | unknown | runtime-event | Experimental | Validate payload shape against source_of_truth. |
-| `nativeChange` | unknown | runtime-event | Experimental | Validate payload shape against source_of_truth. |
+O componente usa o contrato CVA/`FormControl`. Em modo explícito, somente Aplicar ou Limpar confirmam uma alteração.
 ### External side channels
-| Channel | Direction | Contract | Failure mode | Notes |
-| --- | --- | --- | --- | --- |
-| `host/services/storage` | bidirectional | component-defined | component-defined | Side channels variam por componente e host; verificar em source_of_truth. |
+Não há armazenamento ou chamada HTTP interna. Persistência e serialização do filtro são responsabilidades do host.
 ### Host/runtime dependencies
-| Dependency | Required | Environment | Purpose | Notes |
-| --- | --- | --- | --- | --- |
-| `inline-distance-radius.component.ts` | true | browser/dev/prod/ssr | contract resolution | Refer to `projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts`. |
-| `inline-range-slider.component.ts` | true | browser/dev/prod/ssr | contract resolution | Refer to `projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts`. |
-| `material-field-metadata.interface.ts` | true | browser/dev/prod/ssr | contract resolution | Refer to `projects/praxis-core/src/lib/models/material-field-metadata.interface.ts`. |
+Requer providers padrão de `@praxisui/core`, Dynamic Fields e Angular Material/CDK.
 ## Coverage by surface (obrigatorio)
 ### Coverage matrix (runtime, schema/type, editor/tooling)
-| Surface | Verified | Coverage status | Evidence | Notes |
-| --- | --- | --- | --- | --- |
-| Runtime | `true` | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts` | Core runtime flows verified via focused component specs on 2026-03-06; editor/tooling coverage remains independent. |
-| Schema/Types | `true` | Active | source_of_truth + Detailed API reference | Reconcile schema/types with canonical paths during follow-up when needed. |
-| Editor/Tooling | `false` | Partial | `projects/praxis-core/src/lib/utils/inline-filter-controls.util.ts`, `projects/praxis-dynamic-fields/src/lib/services/component-registry/component-registry.service.ts` | Alias/selector tooling linkage verified for inline filters; visual editor end-to-end coverage remains not-yet-verified. |
+| Capacidade | Runtime | Tipo | Editor visual |
+| --- | --- | --- | --- |
+| Single/range e step | Sim | Sim | Sim |
+| Unidades e labels | Sim | Sim | Sim |
+| Gradiente de três stops | Sim | Sim | Sim |
+| Presets numéricos | Sim | Sim | Sim |
+| Presets estruturados | Sim | Sim | JSON |
+| Apply/Cancel/Clear | Sim | Sim | Sim |
 ### Runtime coverage boundaries
-- Ambientes suportados: browser/dev/prod; SSR/hydration appears to be component-dependent unless explicitly verified.
-- Pre-condicoes: payload JSON valido, bindings de host consistentes e dependencias descritas no source_of_truth.
-- Fora de cobertura confirmada: caminhos internos, experimentais ou aliases nao enumerados formalmente.
+Conversão de unidade é apenas apresentação. O valor emitido continua na unidade base.
 ### Editor and tooling notes
-- Evidencia de tooling: aliases `pdx-inline-*` resolvidos por `inline-filter-controls.util.ts` e consumidos no `ComponentRegistryService`; editor visual E2E permanece not-yet-verified.
-- O que esta exposto no editor visual depende da cobertura real do workspace e nao deve ser inferido como suporte runtime total.
-- Campos disponiveis apenas via JSON/manual devem continuar no contrato, com rotulo explicito de cobertura parcial.
-- Quando houver divergencia entre editor e runtime, manter mismatch rastreavel em secao dedicada.
+O campo de chips aceita valores livres e normaliza tokens numéricos antes de emitir o patch. Objetos de preset permanecem preservados pelo editor JSON até existir um editor visual de coleção estruturada.
 ## Resolution and precedence model (obrigatorio)
 ### Merge order
-1. defaults do componente
-2. contrato JSON recebido
-3. overrides de host/runtime
-4. normalizacoes internas
+Schema canônico → override persistido do filtro → preview aplicado na sessão.
 ### Fallback order
-contrato explicito -> aliases historicos (quando suportados) -> defaults internos -> comportamento seguro
+Paths canônicos → aliases `radius*` documentados → defaults do componente.
 ### Override points
-- inputs publicos do componente
-- configuracao JSON de runtime
-- integracoes de host (servicos/tokens/adapters)
+Metadados podem alterar escala, unidade, labels, presets, marks, gradiente, ações e limites responsivos.
 ### Runtime normalization
-Alias e defaults devem convergir para paths canonicos; onde nao houver evidencia, manter not-yet-verified de forma explicita.
+Valores são limitados a `min/max`, encaixados em `step` e normalizados para `distanceBaseUnit`.
 ### Precedence rules
-Em conflito entre caminho historico e path canonico, priorizar path canonico e registrar janela de migracao do historico.
+No modo explícito, painel e radial usam o rascunho; trigger, tooltip, ARIA e payload usam o valor confirmado até Aplicar.
 ## Validation and error semantics (obrigatorio)
 ### Validation model
-| Path/Rule | Validation phase | Behavior on fail | Error code / warning | Notes |
-| --- | --- | --- | --- | --- |
-| canonical-paths | parse/runtime | component-defined (warn/reject/default) | not-yet-standardized | Semantica detalhada preservada na referencia tecnica por componente. |
+`min < max`, `step > 0`, limites ordenados e cores CSS válidas. Presets inválidos são descartados durante a normalização.
 ### Invalid and unknown field handling
-- Campos desconhecidos: comportamento component-defined (ignore, warn ou reject).
-- Tipos invalidos: pode haver fallback, warning ou falha, conforme runtime especifico.
-- Valores fora de dominio: registrar observed vs desired em Known limitations and mismatches.
+Paths desconhecidos são preservados pelo documento de metadata, mas não ganham comportamento runtime implicitamente.
 ### Fail-open / fail-closed behavior
-| Condition | Mode | Runtime behavior | Consumer impact |
-| --- | --- | --- | --- |
-| invalid-or-unknown-field | component-defined | not-yet-verified | Pode gerar warning, fallback silencioso ou rejeicao; validar por componente. |
+Metadados visuais inválidos usam defaults seguros. Valores inválidos não devem ser confirmados pelo painel.
 ### Runtime warnings vs hard failures
-| Condition | Severity | Observability | Consumer action |
-| --- | --- | --- | --- |
-| partial-or-declared-only-coverage | warning | logs/eventos do componente | Confirmar ligacao runtime antes de uso critico. |
-| mismatch-confirmed | error-or-warning | componente/host observability | Planejar migracao e corrigir contrato/runtime. |
+Erros de configuração devem aparecer em diagnostics/editor; indisponibilidade de integração geográfica pertence ao host.
 ## Detailed API reference
-### Preserved technical reference (normalized from previous revision)
-### 1. Visao Geral e Quando Usar
-`pdx-inline-distance-radius` e um filtro de distancia/raio com visual radial, slider (single/range), presets e troca de unidade.
-Use quando precisar:
-- filtro geografico por raio;
-- alternar unidade (`km`/`mi`) com conversao em runtime;
-- trabalhar com presets de distancia em UX corporativa.
-### 2. API do Componente (Inputs/Outputs)
-| Propriedade | Tipo | Padrao | Obrigatorio | Comportamento |
-| --- | --- | --- | --- | --- |
-| `metadata` | `MaterialRangeSliderMetadata` | - | Sim | Contrato principal de distancia inline. |
-| `readonlyMode/disabledMode/visible/presentationMode` | `boolean` | `false/false/true/false` | Nao | Estados de host do campo inline. |
-| `valueChange` | `number \| {start:number,end:number}` | - | Output herdado | Valor de distancia (single/range). |
-### 3. Matriz de Cobertura JSON (Completa)
-#### 3.1 Campos especificos do componente
-| Caminho JSON | Tipo | Status | Comportamento em runtime |
-| --- | --- | --- | --- |
-| `metadata.mode` / `metadata.distanceMode` / `metadata.radiusMode` | `'single'\|'range'` | Ativo | Define slider unico ou intervalo. |
-| `metadata.min/max/step` e aliases `distance*`/`radius*` | `number` | Ativo | Limites e passo da escala base. |
-| `metadata.distanceUnits` / `metadata.units` / `metadata.availableUnits` | `array` | Ativo | Lista de unidades permitidas no toggle. |
-| `metadata.distanceUnit` / `metadata.unit` / `metadata.defaultUnit` | `string` | Ativo | Unidade inicial ativa. |
-| `metadata.distanceAllowUnitToggle` | `boolean` | Ativo | Liga/desliga botoes de unidade. |
-| `metadata.distancePresets` / `metadata.quickPresets` | `array` | Ativo | Presets de distancia/range no painel. |
-| `metadata.distanceRadialRings` / `metadata.radialRings` | `number` | Ativo | Quantidade de aneis no visual radial. |
-| `metadata.distanceDisplayDecimals` e variantes `distanceDecimals*` | `number` | Ativo | Casas decimais por unidade para exibicao. |
-| `metadata.distanceSubtitle` / `metadata.inlinePanelSubtitle` | `string` | Ativo | Subtitulo do painel. |
-| `metadata.distanceAccentColor/ringColor/trackColor/glowColor` | `string` | Ativo | Tokens visuais base do radial e trilha. |
-| `metadata.distanceGradientLowColor/midColor/highColor` | `string` | Ativo | Paleta semantica do gradiente radial (baixo/medio/alto). |
-| `metadata.distanceRangeBandOpacity` | `number` | Ativo | Opacidade fixa (0-1) da faixa radial no modo range. |
-| `metadata.inlineAutoSize.*` | `object` | Ativo | Larguras da pill/painel por viewport. |
-| `metadata.inlineOverlay.applyMode` | `'auto'\|'explicit'` | Ativo | Em `explicit`, slider e presets ficam em rascunho ate Aplicar. |
-| `metadata.inlineOverlay.actions.apply/cancel/clear` | `object` | Ativo | Labels, aria, aparencia, cor semantica e icones das acoes do painel. |
-#### 3.2 Campos herdados compartilhados (exaustivo)
-- `projects/praxis-dynamic-fields/src/lib/components/inlineRange/pdx-inline-range-slider.json-api.md`
-- `projects/praxis-dynamic-fields/src/lib/components/material-range-slider/pdx-material-range-slider.json-api.md`
-- `projects/praxis-dynamic-fields/src/lib/base/pdx-base-input-runtime-contract.json-api.md`
-Resumo de composicao deste componente:
-- `Ativo`: unidade dinamica, presets, radial visual e slider de distancia.
-- `Extensao de runtime`: aliases `distance*`/`radius*` para manter compatibilidade de contratos.
-### 4. Mapeamento de Comportamento
-- Valores sao mantidos em unidade base e convertidos para unidade ativa apenas na exibicao.
-- Presets aceitam formas single (`value`) e range (`start/end`).
-- Em range mode, chip e painel mostram intervalo com unidade ativa.
-- UI radial usa proporcao do valor selecionado sobre `min/max`.
-- Cores do radial seguem gradiente semantico (baixo/medio/alto), com customizacao por metadata.
-- `inlineOverlay.applyMode="explicit"` padroniza confirmacao: Aplicar comita, Cancelar/Esc/fora descarta rascunho.
-### 5. Exemplo Minimo (JSON + Uso)
-```json
-{
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "radius",
-    "label": "Raio",
-    "controlType": "rangeSlider",
-    "mode": "single",
-    "min": 0,
-    "max": 50,
-    "step": 1,
-    "distanceUnits": ["km", "mi"],
-    "distanceUnit": "km"
-  }
-}
-```
-Uso: filtro de raio simples com troca de unidade.
-### 6. Exemplo Corporativo (JSON + Uso)
-```json
-{
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "coverageRadius",
-    "label": "Cobertura",
-    "controlType": "rangeSlider",
-    "distanceMode": "range",
-    "distanceMin": 0,
-    "distanceMax": 300,
-    "distanceStep": 5,
-    "distanceUnits": ["km", "mi"],
-    "distanceUnit": "km",
-    "distanceAllowUnitToggle": true,
-    "distancePresets": [
-      { "id": "near", "label": "Ate 25 km", "start": 0, "end": 25 },
-      { "id": "mid", "label": "25-80 km", "start": 25, "end": 80 }
-    ],
-    "distanceSubtitle": "Defina a area de atendimento",
-    "distanceAccentColor": "#2563eb",
-    "distanceGradientLowColor": "#22c55e",
-    "distanceGradientMidColor": "#f59e0b",
-    "distanceGradientHighColor": "#ef4444",
-    "distanceRangeBandOpacity": 0.42,
-    "distanceTrackColor": "#93c5fd",
-    "inlineAutoSize": { "minWidth": 188, "maxWidth": 340 }
-  }
-}
-```
-Uso: filtro de cobertura territorial com semantica geoespacial.
-### 7. Troubleshooting e Armadilhas Comuns
-1. Unidade nao troca.
-Correcao: revisar `distanceUnits` e `distanceAllowUnitToggle`.
-2. Preset nao aplica valor.
-Correcao: validar payload (`value` ou `start/end`) e limites min/max.
-3. Modo range nao abre dois thumbs.
-Correcao: definir `mode`/`distanceMode` como `range`.
-4. Visual radial desproporcional.
-Correcao: conferir escalas `min/max` e valor atual do controle.
-5. Texto de distancia com casas erradas.
-Correcao: ajustar `distanceDisplayDecimals` ou `distanceDecimalsKm/Mi`.
-### 8. Cross-links
-- `projects/praxis-dynamic-fields/src/lib/components/inlineRange/pdx-inline-range-slider.json-api.md`
-- `projects/praxis-dynamic-fields/src/lib/components/material-range-slider/pdx-material-range-slider.json-api.md`
-### 9. Relatorio de Validacao Estrutural
-- Visao geral: PASS
-- API (inputs/outputs): PASS
-- Cobertura JSON completa (especifico + herdado): PASS
-- Mapeamento de comportamento: PASS
-- Exemplo minimo: PASS
-- Exemplo corporativo: PASS
-- Troubleshooting: PASS
+O componente usa as propriedades comuns de `MaterialRangeSliderMetadata` e `inlineOverlay`. Os paths especializados estão no índice abaixo.
 ## JSON path index (obrigatorio)
-| Path | Type | Required | Default | Status | Notes |
-| --- | --- | --- | --- | --- | --- |
-| `metadata` | object | true | n/a | Partial | See Detailed API reference. |
-| `metadata.mode` | string | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceMode` | string | false | n/a | Partial | See Detailed API reference. |
-| `metadata.radiusMode` | string | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceUnits` | array | false | n/a | Partial | See Detailed API reference. |
-| `metadata.units` | array | false | n/a | Partial | See Detailed API reference. |
-| `metadata.availableUnits` | array | false | n/a | Partial | See Detailed API reference. |
-| `metadata.inlineOverlay.applyMode` | string | false | auto | Active | Shared inline overlay commit mode. |
-| `metadata.inlineOverlay.actions.apply` | object | false | n/a | Active | Theme-aware Apply action metadata. |
-| `metadata.inlineOverlay.actions.cancel` | object | false | n/a | Active | Theme-aware Cancel action metadata. |
-| `metadata.inlineOverlay.actions.clear` | object | false | n/a | Active | Theme-aware Clear action metadata. |
-| `metadata.distanceUnit` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.unit` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.defaultUnit` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceAllowUnitToggle` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distancePresets` | array | false | n/a | Partial | See Detailed API reference. |
-| `metadata.quickPresets` | array | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceRadialRings` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.radialRings` | unknown | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceDisplayDecimals` | number | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceSubtitle` | string | false | n/a | Partial | See Detailed API reference. |
-| `metadata.inlinePanelSubtitle` | string | false | n/a | Partial | See Detailed API reference. |
-| `metadata.distanceRangeBandOpacity` | number | false | n/a | Partial | See Detailed API reference. |
-| `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
+`mode`, `min`, `max`, `step`, `distanceStart`, `distanceEnd`, `distanceUnit`, `distanceBaseUnit`, `distanceUnits`, `distanceAllowUnitToggle`, `distanceUnitLabels`, `distanceDisplayDecimals`, `distanceDecimalsKm`, `distanceDecimalsMi`, `distancePresets`, `distanceSubtitle`, `distanceRadialRings`, `distanceAccentColor`, `distanceRingColor`, `distanceTrackColor`, `distanceGlowColor`, `distanceGradientLowColor`, `distanceGradientMidColor`, `distanceGradientHighColor`, `distanceRangeBandOpacity`, `marks`, `showTicks`, `discrete`, `inlineOverlay`, `inlineAutoSize`.
 ## Events reference (obrigatorio)
-| Event | Payload | Trigger | Stability | Notes |
-| --- | --- | --- | --- | --- |
-| `valueChange` | unknown | runtime-event | Experimental | Check component/runtime implementation. |
-| `focusChange` | unknown | runtime-event | Experimental | Check component/runtime implementation. |
-| `nativeBlur` | unknown | runtime-event | Experimental | Check component/runtime implementation. |
-| `nativeChange` | unknown | runtime-event | Experimental | Check component/runtime implementation. |
+| Ação | Efeito no rascunho | Efeito confirmado |
+| --- | --- | --- |
+| Arrastar/teclado/preset | Atualiza painel | Nenhum |
+| Aplicar | Mantém e fecha | Atualiza FormControl |
+| Cancelar/Escape | Descarta e fecha | Nenhum |
+| Limpar + Aplicar | Esvazia | Confirma valor vazio |
 ## Styling API (obrigatorio quando aplicavel)
-| Token/Class | Scope | Purpose | Notes |
-| --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+Use tokens `--pdx-inline-field-*`, `--pdx-inline-panel-*` e `--pdx-inline-distance-*`. Não sobrescreva z-index localmente; camadas pertencem à escala compartilhada do core.
 ## Examples (obrigatorio)
-| Example | Scenario | Validates | Notes |
-| --- | --- | --- | --- |
-| `Minimal valid` | baseline payload | required contract blocks | Extracted from preserved technical reference when available. |
-| `Common setup` | common component usage | standard runtime behavior | Validate against host integration path. |
-| `Advanced setup` | richer config with overrides | precedence and normalization | Requires runtime confirmation for edge cases. |
-| `Enterprise scenario` | governance/legacy/migration context | auditability and compatibility boundaries | Include tenant-specific constraints when applicable. |
 ### Minimal valid
 ```json
 {
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "radius",
-    "label": "Raio",
-    "controlType": "rangeSlider",
-    "mode": "single",
-    "min": 0,
-    "max": 50,
-    "step": 1,
-    "distanceUnits": [
-      "km",
-      "mi"
-    ],
-    "distanceUnit": "km"
-  },
-  "readonlyMode": false
-}
-```
-### Common setup
-```json
-{
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "coverageRadius",
-    "label": "Cobertura",
-    "controlType": "rangeSlider",
-    "distanceMode": "range",
-    "distanceMin": 0,
-    "distanceMax": 300,
-    "distanceStep": 5,
-    "distanceUnits": [
-      "km",
-      "mi"
-    ],
-    "distanceUnit": "km",
-    "distanceAllowUnitToggle": true,
-    "distancePresets": [
-      {
-        "id": "near",
-        "label": "Ate 25 km",
-        "start": 0,
-        "end": 25
-      },
-      {
-        "id": "mid",
-        "label": "25-80 km",
-        "start": 25,
-        "end": 80
-      }
-    ],
-    "distanceSubtitle": "pdx-inline-distance-radius-common",
-    "distanceAccentColor": "#2563eb",
-    "distanceGradientLowColor": "#22c55e",
-    "distanceGradientMidColor": "#f59e0b",
-    "distanceGradientHighColor": "#ef4444",
-    "distanceRangeBandOpacity": 0.42,
-    "distanceTrackColor": "#93c5fd",
-    "inlineAutoSize": {
-      "minWidth": 188,
-      "maxWidth": 340
-    }
-  }
-}
-```
-### Advanced setup
-```json
-{
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "coverageRadius",
-    "label": "Cobertura",
-    "controlType": "rangeSlider",
-    "distanceMode": "range",
-    "distanceMin": 0,
-    "distanceMax": 300,
-    "distanceStep": 5,
-    "distanceUnits": [
-      "km",
-      "mi"
-    ],
-    "distanceUnit": "km",
-    "distanceAllowUnitToggle": true,
-    "distancePresets": [
-      {
-        "id": "near",
-        "label": "Ate 25 km",
-        "start": 0,
-        "end": 25
-      },
-      {
-        "id": "mid",
-        "label": "25-80 km",
-        "start": 25,
-        "end": 80
-      }
-    ],
-    "distanceSubtitle": "Defina a area de atendimento",
-    "distanceAccentColor": "#2563eb",
-    "distanceGradientLowColor": "#22c55e",
-    "distanceGradientMidColor": "#f59e0b",
-    "distanceGradientHighColor": "#ef4444",
-    "distanceRangeBandOpacity": 0.42,
-    "distanceTrackColor": "#93c5fd",
-    "inlineAutoSize": {
-      "minWidth": 188,
-      "maxWidth": 340
-    },
-    "distanceDisplayDecimals": 5
-  },
-  "readonlyMode": false,
-  "disabledMode": false
+  "name": "serviceRadius",
+  "controlType": "inlineDistanceRadius",
+  "mode": "single",
+  "min": 0,
+  "max": 100,
+  "step": 5,
+  "distanceUnit": "km",
+  "distanceBaseUnit": "km"
 }
 ```
@@ -589,68 +272,40 @@ Correcao: ajustar `distanceDisplayDecimals` ou `distanceDecimalsKm/Mi`.
 ```json
 {
-  "componentId": "pdx-inline-distance-radius",
-  "metadata": {
-    "name": "coverageRadius",
-    "label": "Cobertura",
-    "controlType": "rangeSlider",
-    "distanceMode": "range",
-    "distanceMin": 0,
-    "distanceMax": 300,
-    "distanceStep": 5,
-    "distanceUnits": [
-      "km",
-      "mi"
-    ],
-    "distanceUnit": "km",
-    "distanceAllowUnitToggle": true,
-    "distancePresets": [
-      {
-        "id": "near",
-        "label": "Ate 25 km",
-        "start": 0,
-        "end": 25
-      },
-      {
-        "id": "mid",
-        "label": "25-80 km",
-        "start": 25,
-        "end": 80
-      }
-    ],
-    "distanceSubtitle": "Defina a area de atendimento",
-    "distanceAccentColor": "#2563eb",
-    "distanceGradientLowColor": "#22c55e",
-    "distanceGradientMidColor": "#f59e0b",
-    "distanceGradientHighColor": "#ef4444",
-    "distanceRangeBandOpacity": 0.42,
-    "distanceTrackColor": "#93c5fd",
-    "inlineAutoSize": {
-      "minWidth": 188,
-      "maxWidth": 340
+  "name": "coverageRadius",
+  "label": "Raio de atendimento",
+  "controlType": "inlineDistanceRadius",
+  "mode": "range",
+  "min": 0,
+  "max": 300,
+  "step": 5,
+  "distanceUnit": "km",
+  "distanceBaseUnit": "km",
+  "distanceUnits": ["km", "mi"],
+  "distanceUnitLabels": { "km": "km", "mi": "mi" },
+  "distancePresets": [10, 25, 50, { "id": "regional", "label": "Regional", "start": 50, "end": 150 }],
+  "inlineOverlay": {
+    "applyMode": "explicit",
+    "actions": {
+      "apply": { "label": "Aplicar", "appearance": "filled", "colorRole": "primary" },
+      "cancel": { "label": "Cancelar", "appearance": "text", "colorRole": "neutral" },
+      "clear": { "label": "Limpar", "appearance": "outlined", "colorRole": "neutral" }
     }
-  },
-  "presentationMode": true,
-  "visible": true
+  }
 }
 ```
 ## Compatibility and migration notes (recomendado)
-| Concern | Affected versions | Migration action | Deadline | Notes |
-| --- | --- | --- | --- | --- |
-| Historical aliases coexist with canonical paths | Active consumers using legacy JSON keys | Keep canonical paths for new usage and map aliases in migration backlog | not-yet-defined | Track via component-level migration issue |
+Migre `distanceMode/distanceMin/distanceMax/distanceStep` para `mode/min/max/step`. Aliases `radius*` continuam apenas como compatibilidade legada explícita.
 ## Known limitations and mismatches (recomendado)
-| Path/Behavior | Observed behavior (runtime) | Desired behavior | Impact | Tracking issue | Target fix |
-| --- | --- | --- | --- | --- | --- |
-| Canonical contract parity | No confirmed mismatch in this revision; runtime linkage verified for core flows (2026-03-06), with editor/tooling coverage pending | Keep runtime/schema/editor alignment evidence updated | Low | n/a | Monitor in periodic audit |
+O editor visual adiciona e remove presets escalares. Presets estruturados são suportados pelo runtime e pelo JSON, mas ainda não possuem editor visual de linhas/objetos.
 ## Source references (obrigatorio)
-| Source type | Path/URL | Why it is source of truth | Last verified (YYYY-MM-DD) | Notes |
-| --- | --- | --- | --- | --- |
-| runtime-code | projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts | Primary source of truth for contract and behavior. | 2026-03-06 | verified-path |
-| runtime-code | projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.component.ts | Primary source of truth for contract and behavior. | 2026-03-06 | verified-path |
-| schema-types | projects/praxis-core/src/lib/models/material-field-metadata.interface.ts | Primary source of truth for contract and behavior. | 2026-03-06 | verified-path |
+- `projects/praxis-core/src/lib/models/material-field-metadata.interface.ts`
+- `projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.ts`
+- `projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.component.spec.ts`
+- `projects/praxis-metadata-editor/src/lib/config/inline-distance-radius.config.ts`