@praxisui/dynamic-fields 8.0.0-beta.99 → 9.0.0-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "8.0.0-beta.99",
+  "version": "9.0.0-beta.0",
   "description": "Angular Material-based dynamic form fields for Praxis UI with lazy loading and metadata-driven rendering.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -11,8 +11,8 @@
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
     "rxjs": "^7.8.0",
-    "@praxisui/core": "^8.0.0-beta.99",
-    "@praxisui/cron-builder": "^8.0.0-beta.99"
+    "@praxisui/core": "^9.0.0-beta.0",
+    "@praxisui/cron-builder": "^9.0.0-beta.0"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

package/src/lib/base/pdx-base-input-runtime-contract.json-api.md

@@ -86,7 +86,7 @@ Este documento e a referencia canonica da API JSON de pdx-base-input-runtime-con
 | `metadata.id` | `string` | not-specified | n/a | Active | Aplica `id` no elemento nativo. |
 | `metadata.label` | `string` | not-specified | n/a | Active | Mapeado para label visivel do campo. |
 | `metadata.placeholder` | `string` | not-specified | n/a | Active | Mapeado para placeholder quando diferente do label. |
-| `metadata.required` | `boolean` | not-specified | n/a | Active | `Validators.required` + `aria-required`. |
+| `metadata.required` | `boolean` | not-specified | n/a | Active | Controle interno textual aplica `Validators.required` + `aria-required`; controle externo preserva validadores do host e materializa estado acessivel. Boolean/toggle usa presença no `DynamicFormService`; use `requiredTrue` quando `true` for obrigatório. |
 | `metadata.disabled` | `boolean` | not-specified | n/a | Active | Atualiza estado disabled do controle. |
 | `metadata.readonly` | `boolean` | not-specified | n/a | Active | Aplica atributo `readonly` nativo. |
 | `metadata.readOnly` | `boolean` | not-specified | n/a | Partial | Compat legado (dependente de uso no metadata final). |
@@ -135,7 +135,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `metadata.id` | `string` | not-specified | n/a | component-defined | Aplica `id` no elemento nativo. |
 | `metadata.label` | `string` | not-specified | n/a | component-defined | Mapeado para label visivel do campo. |
 | `metadata.placeholder` | `string` | not-specified | n/a | component-defined | Mapeado para placeholder quando diferente do label. |
-| `metadata.required` | `boolean` | not-specified | n/a | component-defined | `Validators.required` + `aria-required`. |
+| `metadata.required` | `boolean` | not-specified | n/a | component-defined | Controle interno textual aplica `Validators.required` + `aria-required`; controle externo preserva validadores do host e materializa estado acessivel. Boolean/toggle usa presença no `DynamicFormService`; use `requiredTrue` quando `true` for obrigatório. |
 | `metadata.disabled` | `boolean` | not-specified | n/a | component-defined | Atualiza estado disabled do controle. |
 | `metadata.readonly` | `boolean` | not-specified | n/a | component-defined | Aplica atributo `readonly` nativo. |
 | `metadata.readOnly` | `boolean` | not-specified | n/a | component-defined | Compat legado (dependente de uso no metadata final). |
@@ -325,7 +325,7 @@ Limites:
 | `metadata.id` | `string` | Active | Aplica `id` no elemento nativo. |
 | `metadata.label` | `string` | Active | Mapeado para label visivel do campo. |
 | `metadata.placeholder` | `string` | Active | Mapeado para placeholder quando diferente do label. |
-| `metadata.required` | `boolean` | Active | `Validators.required` + `aria-required`. |
+| `metadata.required` | `boolean` | Active | Controle interno textual aplica `Validators.required` + `aria-required`; controle externo preserva validadores do host e materializa estado acessivel. Boolean/toggle usa presença no `DynamicFormService`; use `requiredTrue` quando `true` for obrigatório. |
 | `metadata.disabled` | `boolean` | Active | Atualiza estado disabled do controle. |
 | `metadata.readonly` | `boolean` | Active | Aplica atributo `readonly` nativo. |
 | `metadata.readOnly` | `boolean` | Partial | Compat legado (dependente de uso no metadata final). |
@@ -439,7 +439,7 @@ internos do Angular Material e podem mudar entre versoes.
 | `metadata.id` | `string` | not-specified | n/a | Active | Aplica `id` no elemento nativo. |
 | `metadata.label` | `string` | not-specified | n/a | Active | Mapeado para label visivel do campo. |
 | `metadata.placeholder` | `string` | not-specified | n/a | Active | Mapeado para placeholder quando diferente do label. |
-| `metadata.required` | `boolean` | not-specified | n/a | Active | `Validators.required` + `aria-required`. |
+| `metadata.required` | `boolean` | not-specified | n/a | Active | Controle interno textual aplica `Validators.required` + `aria-required`; controle externo preserva validadores do host e materializa estado acessivel. Boolean/toggle usa presença no `DynamicFormService`; use `requiredTrue` quando `true` for obrigatório. |
 | `metadata.disabled` | `boolean` | not-specified | n/a | Active | Atualiza estado disabled do controle. |
 | `metadata.readonly` | `boolean` | not-specified | n/a | Active | Aplica atributo `readonly` nativo. |
 | `metadata.readOnly` | `boolean` | not-specified | n/a | Partial | Compat legado (dependente de uso no metadata final). |

package/src/lib/components/inline-color-label/pdx-inline-color-label.json-api.md

@@ -300,6 +300,10 @@ Use quando precisar:
 | `metadata.colorLabelColorKey` / `metadata.optionColorKey` | `string` | Ativo | Chave do payload usada para cor da opcao. |
 | `metadata.colorLabelPalette` / `metadata.palette` | `array \| string(csv/json)` | Ativo | Paleta fallback para cards sem cor explicita. |
 | `metadata.colorLabelTexts` / `metadata.inlineTexts` | `object \| string(JSON)` | Ativo | Textos de aria, empty state, subtitle e labels de acao; templates devem usar `{{label}}` no contrato canonico, com compatibilidade legada para `{label}` em metadata. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | Ativo | Define se cards e badges comitam imediatamente ou ficam em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply` | `object` | Ativo | Configura label, aria-label, icone, `appearance` e `colorRole` da acao de commit. |
+| `metadata.inlineOverlay.actions.cancel` | `object` | Ativo | Configura a acao que descarta rascunho e fecha o painel. |
+| `metadata.inlineOverlay.actions.clear` | `object` | Ativo | Configura a acao que remove a selecao aplicada/rascunho usando tokens do tema. |
 | `metadata.prefixIcon` / `metadata.colorLabelIcon` | `string` | Ativo | Icone do trigger e cabecalho do painel. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura da pill e do painel (desktop/mobile). |
 | `metadata.searchable` | `boolean` | Parcial | Ignorado no template; componente usa grade dedicada sem busca textual. |
@@ -317,6 +321,7 @@ Resumo de composicao deste componente:
 - Em multiplo, respeita `maxSelections` herdado do base select.
 - Em single, pode fechar automaticamente via `colorLabelCloseOnSelect`.
 - Cores seguem ordem: chave custom > `color/tint` > paleta configurada > paleta default interna.
+- Quando `inlineOverlay.applyMode` e `"explicit"`, selecoes no painel alteram apenas o rascunho; `Aplicar` comita, `Cancelar`, `Esc` e clique externo descartam, e `Limpar` remove a selecao.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -359,11 +364,19 @@ Uso: filtro visual simples por cor.
       "panelMinWidth": 320,
       "panelMaxWidth": 560
     },
-    "clearButton": { "enabled": true, "showOnlyWhenFilled": true }
+    "clearButton": { "enabled": true, "showOnlyWhenFilled": true },
+    "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" }
+      }
+    }
   }
 }
 ```
-Uso: filtro corporativo de risco com multi-selecao visual.
+Uso: filtro corporativo de risco com multi-selecao visual e confirmacao explicita antes de aplicar.
 
 ### 7. Troubleshooting e Armadilhas Comuns
 1. Cards sem cor esperada.
@@ -412,6 +425,10 @@ Correcao: validar `multiple=true` e `colorLabelShowSelectedBadges`.
 | `metadata.palette` | array | false | n/a | Partial | See Detailed API reference. |
 | `metadata.colorLabelTexts` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineTexts` | unknown | false | n/a | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.applyMode` | string | false | `auto` | Active | `explicit` mantém rascunho até commit. |
+| `metadata.inlineOverlay.actions.apply` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Apply. |
+| `metadata.inlineOverlay.actions.cancel` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Cancel. |
+| `metadata.inlineOverlay.actions.clear` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Clear. |
 | `metadata.prefixIcon` | string | false | n/a | Partial | See Detailed API reference. |
 | `metadata.colorLabelIcon` | string | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
@@ -509,6 +526,14 @@ Correcao: validar `multiple=true` e `colorLabelShowSelectedBadges`.
     "clearButton": {
       "enabled": true,
       "showOnlyWhenFilled": true
+    },
+    "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" }
+      }
     }
   },
   "resourcePath": "pdx-inline-color-label-common"
@@ -547,6 +572,14 @@ Correcao: validar `multiple=true` e `colorLabelShowSelectedBadges`.
     "clearButton": {
       "enabled": true,
       "showOnlyWhenFilled": true
+    },
+    "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" }
+      }
     }
   },
   "readonlyMode": false,
@@ -586,6 +619,14 @@ Correcao: validar `multiple=true` e `colorLabelShowSelectedBadges`.
     "clearButton": {
       "enabled": true,
       "showOnlyWhenFilled": true
+    },
+    "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,

package/src/lib/components/inline-currency-range/pdx-inline-currency-range.json-api.md

@@ -300,6 +300,9 @@ Use quando precisar:
 | --- | --- | --- | --- |
 | `metadata.min` / `metadata.max` | `number` | Ativo | Limites globais da faixa. |
 | `metadata.step` | `number` | Ativo | Incremento do slider (`default=100`). |
+| `metadata.showTicks` | `boolean \| "auto"` | Ativo | Exibe ticks no trilho; `marks` tambem ativa ticks. |
+| `metadata.marks` | `array \| string` | Ativo | Marcadores monetarios compactos; ate tres labels visiveis no popover inline. |
+| `metadata.semanticBands` | `array \| string` | Ativo | Faixas semanticas compactas renderizadas junto ao trilho. |
 | `metadata.discrete` | `boolean` | Ativo | Liga modo discreto no `mat-slider`. |
 | `metadata.currency` / `metadata.locale` / `metadata.decimalPlaces` | `string/number` | Ativo | Formata valores da faixa e bordas. |
 | `metadata.allowNegative` | `boolean` | Ativo | Permite faixa negativa quando habilitado. |
@@ -308,6 +311,10 @@ Use quando precisar:
 | `metadata.distribution` / `metadata.rangeDistribution` | `object \| array \| string` | Ativo | Alias para distribuicao inline. |
 | `metadata.histogram` / `metadata.rangeHistogram` | `object \| array \| string` | Ativo | Alias de histograma aceito em runtime. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura da pill e painel no modo inline. |
+| `metadata.inlineOverlay.applyMode` | `"explicit" \| "auto"` | Ativo | Modo de commit do painel inline; default pratico do componente e `explicit`. |
+| `metadata.inlineOverlay.actions.apply` | `object` | Ativo | Configura label, aria, icone, aparencia e papel de cor da acao Aplicar/Concluir. |
+| `metadata.inlineOverlay.actions.cancel` | `object` | Ativo | Configura label, aria, icone, aparencia e papel de cor da acao Cancelar. |
+| `metadata.inlineOverlay.actions.clear` | `object` | Ativo | Configura label, aria, icone, aparencia, visibilidade e papel de cor da acao Limpar no painel. |
 | `metadata.validators.*` | `object` | Parcial | Mensagens custom parciais; erros principais de faixa usam texto interno no componente. |
 
 #### 3.2 Campos herdados compartilhados (exaustivo)
@@ -323,6 +330,7 @@ Resumo de composicao deste componente:
 - Selecao respeita clamp por min/max e snap por `step`.
 - Distribuicao calcula visual adaptativo (altura, gap, opacidade, agregacao de bins).
 - `clearButton` limpa ambos os extremos com quick-clear no trigger.
+- `inlineOverlay.actions.*` materializa acoes do painel com tokens de tema; `applyMode="auto"` comita durante a interacao e oculta Cancelar.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -418,10 +426,17 @@ Correcao: ajustar `inlineAutoSize.panelMinWidth/panelMaxWidth`.
 | `metadata.decimalPlaces` | number | false | n/a | Partial | See Detailed API reference. |
 | `metadata.allowNegative` | boolean | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlinePanelTitle` | string | false | n/a | Partial | See Detailed API reference. |
+| `metadata.showTicks` | boolean \| "auto" | false | n/a | Partial | See Detailed API reference. |
+| `metadata.marks` | unknown | false | n/a | Partial | See Detailed API reference. |
+| `metadata.semanticBands` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineDistribution` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.distribution` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.rangeDistribution` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.histogram` | unknown | false | n/a | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.applyMode` | "explicit" \| "auto" | false | explicit | Active | Controls draft/apply behavior for the inline panel. |
+| `metadata.inlineOverlay.actions.apply` | object | false | n/a | Active | Theme-aware Apply/Done 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.rangeHistogram` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
 | `metadata.validators.*` | object | false | n/a | Partial | See Detailed API reference. |

package/src/lib/components/inline-date/pdx-inline-date.json-api.md

@@ -21,8 +21,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/inline-date/inline-date.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/components/material-datepicker/material-datepicker.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"
+source_of_truth_last_verified: "2026-06-16"
+last_updated: "2026-06-16"
 toc: true
 sidebar: true
 tags:
@@ -114,6 +114,9 @@ Este documento e a referencia canonica da API JSON de pdx-inline-date.
 | `metadata.touchUi` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 | `metadata.clearButton` | object | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference for runtime semantics. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | false | `auto` | Active | Em `explicit`, o datepicker exibe ações de rodapé e mantém a seleção em rascunho até `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply.*` | object | false | n/a | Active | Label, aria, appearance e colorRole canônicos do botão Aplicar. |
+| `metadata.inlineOverlay.actions.cancel.*` | object | false | n/a | Active | Label, aria, appearance e colorRole canônicos do botão Cancelar. |
 
 ### Path audit
 
@@ -151,6 +154,9 @@ Nao ha paths experimentais confirmados no contrato publico desta revisao.
 | `metadata.touchUi` | boolean | false | n/a | component-defined | Partial; verify per source_of_truth. |
 | `metadata.clearButton` | object | false | n/a | component-defined | Partial; verify per source_of_truth. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | component-defined | Partial; verify per source_of_truth. |
+| `metadata.inlineOverlay.applyMode` | string | false | `auto` | `auto`, `explicit`, `confirm` | Shared inline overlay commit mode; `confirm` is accepted as explicit compatibility. |
+| `metadata.inlineOverlay.actions.apply` | object | false | n/a | component-defined | Theme-aware Apply action metadata. |
+| `metadata.inlineOverlay.actions.cancel` | object | false | n/a | component-defined | Theme-aware Cancel action metadata. |
 | `metadata.ariaLabel` | string | false | n/a | component-defined | Partial; verify per source_of_truth. |
 | `inlineAutoSize.*` | object | false | n/a | component-defined | Partial; verify per source_of_truth. |
 
@@ -203,6 +209,8 @@ Nao ha paths experimentais confirmados no contrato publico desta revisao.
 - 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.
+- Com `metadata.inlineOverlay.applyMode: "explicit"`, o componente projeta `mat-datepicker-actions`; `Aplicar` confirma a data selecionada e `Cancelar`, `Esc` ou fechamento externo descartam a seleção pendente conforme semântica nativa do Angular Material.
+- Labels, aria-labels, `appearance` e `colorRole` do rodapé devem vir de `metadata.inlineOverlay.actions.apply` e `metadata.inlineOverlay.actions.cancel`, materializando tokens do tema em vez de CSS ad hoc do host.
 
 ### Editor and tooling notes
 

package/src/lib/components/inline-date-range/pdx-inline-date-range.json-api.md

@@ -21,8 +21,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/inline-date-range/inline-date-range.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/components/material-date-range/material-date-range.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"
+source_of_truth_last_verified: "2026-06-13"
+last_updated: "2026-06-13"
 toc: true
 sidebar: true
 tags:
@@ -195,7 +195,7 @@ Nao ha paths experimentais confirmados no contrato publico desta revisao.
 
 | Surface | Verified | Coverage status | Evidence | Notes |
 | --- | --- | --- | --- | --- |
-| Runtime | `true` | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-date-range/inline-date-range.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/material-date-range/material-date-range.component.ts` | Core runtime flows verified via focused component specs on 2026-03-06; editor/tooling coverage remains independent. |
+| Runtime | `true` | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-date-range/inline-date-range.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/material-date-range/material-date-range.component.ts` | Core runtime flows verified via focused component specs on 2026-06-13; 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. |
 
@@ -296,7 +296,10 @@ Use quando precisar:
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Autoajuste de largura da pill. |
 | `metadata.inlineChipDisplay` | `"value" \| "label-value"` | Ativo | Exibicao compacta do chip preenchido: somente valor ou label + valor. |
 | `metadata.clearButton` | `boolean \| object` | Ativo | Botao de limpeza rapida no trigger. |
-| `metadata.inlineQuickPresets*` | `object/array` | Ativo | Presets/acoes no overlay (labels, ARIA, apply/cancel). |
+| `metadata.inlineQuickPresets*` | `object/array` | Ativo | Presets/acoes especificos do date-range. `inlineQuickPresetsApplyMode` permanece como compatibilidade quando `inlineOverlay.applyMode` nao e declarado. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | Ativo | Contrato compartilhado de commit do overlay: automatico ou rascunho ate Aplicar. |
+| `metadata.inlineOverlay.actions.apply.*` | `object` | Ativo | Label, aria, appearance e colorRole canonicos do botao Aplicar. |
+| `metadata.inlineOverlay.actions.cancel.*` | `object` | Ativo | Label, aria, appearance e colorRole canonicos do botao Cancelar. |
 | `metadata.inlinePanelTitle` | `string` | Ativo | Titulo do painel de calendario inline. |
 
 Campos de range (min/max/startView/touchUi/shortcuts/timezone etc.) seguem o contrato base do `pdx-material-date-range`.
@@ -311,10 +314,14 @@ Resumo de composicao deste componente:
 
 ### 4. Mapeamento de Comportamento
 - Trigger em pill mostra estado vazio, parcial ou completo do intervalo.
+- Clicar em qualquer area acionavel da pill, incluindo os inputs internos de inicio/fim, abre o calendario; apenas o botao de limpeza rapida fica isolado para limpar sem abrir o overlay.
 - Overlay de calendario inclui presets e botoes de aplicar/cancelar.
 - Entrada manual em ambos os campos sincroniza com o valor consolidado do range.
-- Em `inlineQuickPresetsApplyMode: "auto"`, selecao manual no calendario aplica pendencias imediatamente para manter o valor do chip inline sincronizado.
-- Em `inlineQuickPresetsApplyMode: "confirm"`, o chip inline mostra o intervalo em rascunho enquanto o overlay esta aberto; o commit de negocio continua ocorrendo apenas em `Aplicar`.
+- Em `inlineOverlay.applyMode: "auto"`, selecao manual no calendario aplica pendencias imediatamente para manter o valor do chip inline sincronizado.
+- Em `inlineOverlay.applyMode: "explicit"`, o chip inline mostra o intervalo em rascunho enquanto o overlay esta aberto; o commit de negocio continua ocorrendo apenas em `Aplicar`, enquanto `Cancelar`, `Esc` ou fechamento externo restauram o valor confirmado.
+- O rodape `Aplicar`/`Cancelar` e materializado pelo contrato `inlineOverlay` mesmo quando nao ha `inlineQuickPresets`, para que confirmacao explicita nao dependa de atalhos rapidos.
+- `inlineQuickPresetsApplyMode: "auto" | "confirm"` continua suportado como fallback legado especifico do `inlineDateRange`.
+- Labels, aria, `appearance` e `colorRole` dos botoes do rodape devem ser authorados em `inlineOverlay.actions.apply` e `inlineOverlay.actions.cancel`; os campos `inlineQuickPresets*Label` sao fallback legado.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -347,6 +354,13 @@ Uso: filtro inline de intervalo de datas.
       { "id": "today", "label": "Hoje", "start": "today", "end": "today" },
       { "id": "last7", "label": "Ultimos 7 dias", "start": "-7d", "end": "today" }
     ],
+    "inlineOverlay": {
+      "applyMode": "explicit",
+      "actions": {
+        "apply": { "label": "Aplicar", "appearance": "filled", "colorRole": "primary" },
+        "cancel": { "label": "Cancelar", "appearance": "text", "colorRole": "neutral" }
+      }
+    },
     "clearButton": { "enabled": true, "showOnlyWhenFilled": true }
   }
 }
@@ -366,13 +380,16 @@ Correcao: garantir que o componente esteja usando a sincronizacao de pendencias
 4. Botao limpar indisponivel.
 Correcao: verificar `clearButton` e estado readonly/disabled.
 
-5. Largura do chip estoura em mobile.
+5. Calendario nao abre ao clicar no texto da pill preenchida.
+Correcao: garantir que o clique nos inputs internos de inicio/fim encaminha para `openPicker`; esses inputs ocupam a maior parte da area visual do chip em cenarios densos de toolbar.
+
+6. Largura do chip estoura em mobile.
 Correcao: ajustar limites no bloco `inlineAutoSize`.
 
-6. ARIA de inicio/fim nao refletida.
+7. ARIA de inicio/fim nao refletida.
 Correcao: preencher `startAriaLabel/endAriaLabel` explicitamente.
 
-7. Layout muda entre apps com densidade diferente.
+8. Layout muda entre apps com densidade diferente.
 Correcao: usar `metadata.materialDesign.density` (`dense` ou `default`) e validar no overlay se `gap/padding` foram aplicados no bloco `.mat-datepicker-actions` com classe de densidade `pdx-inline-date-range-overlay-actions-container--*`.
 
 ### 8. Cross-links

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

@@ -310,6 +310,8 @@ Use quando precisar:
 | `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`
@@ -326,6 +328,7 @@ Resumo de composicao deste componente:
 - 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
@@ -418,6 +421,10 @@ Correcao: ajustar `distanceDisplayDecimals` ou `distanceDecimalsKm/Mi`.
 | `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. |

package/src/lib/components/inline-multi-select/pdx-inline-multi-select.json-api.md

@@ -21,8 +21,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/inline-multi-select/inline-multi-select.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/components/material-multi-select/material-multi-select.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"
+source_of_truth_last_verified: "2026-06-16"
+last_updated: "2026-06-16"
 toc: true
 sidebar: true
 tags:
@@ -154,6 +154,10 @@ Nao ha paths experimentais confirmados no contrato publico desta revisao.
 | `metadata.options` | array | false | n/a | component-defined | Partial; verify per source_of_truth. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | component-defined | Partial; verify per source_of_truth. |
 | `metadata.clearButton` | object | false | n/a | component-defined | Partial; verify per source_of_truth. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | false | `auto` | component-defined | Em `explicit`, selecoes no painel ficam em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply.*` | object | false | n/a | component-defined | Label, aria, appearance e colorRole canonicos do botao Aplicar. |
+| `metadata.inlineOverlay.actions.cancel.*` | object | false | n/a | component-defined | Label, aria, appearance e colorRole canonicos do botao Cancelar. |
+| `metadata.inlineOverlay.actions.clear.*` | object | false | n/a | component-defined | Label, aria, appearance e colorRole canonicos do botao Limpar no painel. |
 
 ### Input bindings (inbound data)
 
@@ -197,7 +201,7 @@ Nao ha paths experimentais confirmados no contrato publico desta revisao.
 
 | Surface | Verified | Coverage status | Evidence | Notes |
 | --- | --- | --- | --- | --- |
-| Runtime | `true` | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-multi-select/inline-multi-select.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/material-multi-select/material-multi-select.component.ts` | Core runtime flows verified via focused component specs on 2026-03-06; editor/tooling coverage remains independent. |
+| Runtime | `true` | Active | `projects/praxis-dynamic-fields/src/lib/components/inline-multi-select/inline-multi-select.component.ts`, `projects/praxis-dynamic-fields/src/lib/components/material-multi-select/material-multi-select.component.ts` | Core runtime flows verified via focused component specs on 2026-06-16; 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. |
 
@@ -301,6 +305,10 @@ Use quando precisar:
 | `metadata.selectOptions` / `metadata.options` | `array` | Ativo | Fonte estatica de opcoes. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura minima/maxima da pill. |
 | `metadata.clearButton` | `boolean \| object` | Ativo | Quick-clear no trigger quando ha selecao. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | Ativo | `explicit` mantem selecoes do painel em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply.*` | `object` | Ativo | Label, aria, appearance e colorRole do botao Aplicar. |
+| `metadata.inlineOverlay.actions.cancel.*` | `object` | Ativo | Label, aria, appearance e colorRole do botao Cancelar. |
+| `metadata.inlineOverlay.actions.clear.*` | `object` | Ativo | Label, aria, appearance e colorRole do botao Limpar no painel. |
 
 #### 3.2 Campos herdados compartilhados (exaustivo)
 - `projects/praxis-dynamic-fields/src/lib/components/material-multi-select/pdx-material-multi-select.json-api.md`
@@ -315,6 +323,8 @@ Resumo de composicao deste componente:
 - Painel opcionalmente inclui busca no topo (`searchable=true`).
 - `showOptionDisabled()` bloqueia novas escolhas quando `maxSelections` e atingido.
 - Sem `resourcePath`, busca filtra lista local; com endpoint, usa pipeline remoto.
+- Em `inlineOverlay.applyMode: "explicit"`, clique em opcoes, remocao e `Limpar` do painel alteram apenas o rascunho; `Aplicar` emite `valueChange/selectionChange`, enquanto `Cancelar`, `Esc` ou fechamento externo restauram a selecao confirmada.
+- O quick-clear no trigger continua sendo uma acao explicita fora do painel e comita imediatamente.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -349,6 +359,14 @@ Uso: filtro multiplo local com pill compacta.
     "optionLabelKey": "label",
     "optionValueKey": "id",
     "inlineAutoSize": { "minWidth": 150, "maxWidth": 380 },
+    "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" }
+      }
+    },
     "clearButton": { "enabled": true, "showOnlyWhenFilled": true }
   }
 }
@@ -371,6 +389,9 @@ Correcao: habilitar `selectAll=true` e conferir permissao de interacao.
 5. Layout muito largo.
 Correcao: calibrar `inlineAutoSize` para desktop/mobile.
 
+6. Selecao aplicada antes de revisar.
+Correcao: usar `inlineOverlay.applyMode="explicit"` para manter alteracoes do painel em rascunho ate `Aplicar`.
+
 ### 8. Cross-links
 - `projects/praxis-dynamic-fields/src/lib/components/material-multi-select/pdx-material-multi-select.json-api.md`
 - `projects/praxis-dynamic-fields/src/lib/base/pdx-base-select-runtime-contract.json-api.md`

package/src/lib/components/inline-pipeline-status/pdx-inline-pipeline-status.json-api.md

@@ -303,6 +303,10 @@ Use quando precisar:
 | `metadata.pipelineColors/statusColors/palette` | `array \| string` | Ativo | Paleta usada em barra e cards. |
 | `metadata.pipelineGradientLowColor/midColor/highColor` | `string` | Ativo | Define gradiente fallback semantico (baixo/medio/alto) para barra/cards. |
 | `metadata.pipelineTexts` | `object \| string(JSON)` | Ativo | Customiza textos, labels de acao e aria; templates canonicos devem usar `{{label}}` e `{{count}}`, com compatibilidade legada para `{label}` e `{count}` em metadata. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit"` | Ativo | Define se cards e acoes internas comitam imediatamente ou ficam em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply` | `object` | Ativo | Configura label, aria-label, icone, `appearance` e `colorRole` da acao de commit. |
+| `metadata.inlineOverlay.actions.cancel` | `object` | Ativo | Configura a acao que descarta rascunho e fecha o painel. |
+| `metadata.inlineOverlay.actions.clear` | `object` | Ativo | Configura a acao que remove a selecao aplicada/rascunho usando tokens do tema. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Larguras da pill e painel (desktop/mobile). |
 
 #### 3.2 Campos herdados compartilhados (exaustivo)
@@ -318,6 +322,7 @@ Resumo de composicao deste componente:
 - Em multiplo, `maxSelections` herdado continua sendo respeitado.
 - Barra segmentada reflete distribuicao e itens selecionados.
 - Busca filtra cards no painel antes da selecao.
+- Com `inlineOverlay.applyMode: "explicit"`, cards, selecionar todos e limpar selecao alteram apenas o rascunho; `Aplicar` comita, `Cancelar`, `Esc` e clique externo descartam.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -361,6 +366,14 @@ Uso: filtro de estagio com barra visual basica.
       "pipelineClearActionText": "Limpar",
       "barAriaSelected": "{{label}} com {{count}} itens selecionados"
     },
+    "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" }
+      }
+    },
     "inlineAutoSize": { "minWidth": 188, "maxWidth": 420, "panelMinWidth": 360, "panelMaxWidth": 620 }
   }
 }
@@ -412,6 +425,10 @@ Correcao: ajustar `inlineAutoSize.panelMinWidth/panelMaxWidth`.
 | `metadata.pipelineShowClearAction` | boolean | false | n/a | Partial | See Detailed API reference. |
 | `metadata.pipelineChipMaxVisible` | number | false | n/a | Partial | See Detailed API reference. |
 | `metadata.pipelineTexts` | unknown | false | n/a | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.applyMode` | string | false | `auto` | Active | Controls draft versus immediate commit behavior. |
+| `metadata.inlineOverlay.actions.apply` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Apply. |
+| `metadata.inlineOverlay.actions.cancel` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Cancel. |
+| `metadata.inlineOverlay.actions.clear` | object | false | n/a | Active | Label, aria, icon, appearance and colorRole for Clear. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
 | `readonlyMode` | boolean | false | n/a | Partial | See Detailed API reference. |
 | `disabledMode` | boolean | false | n/a | Partial | See Detailed API reference. |

package/src/lib/components/inline-range-slider/pdx-inline-range-slider.json-api.md

@@ -292,6 +292,9 @@ Use quando precisar:
 | `metadata.quickPresetsLabels` | `object \| string(JSON)` | Ativo | Textos custom para presets auto. |
 | `metadata.inlineDistribution/distribution/histogram` | `object \| array \| string` | Ativo | Fonte de barras de distribuicao visual. |
 | `metadata.inlineTexts` | `object \| string(JSON)` | Ativo | Labels de min/max/valor/presets. |
+| `metadata.inlineOverlay.applyMode` | `'auto'\|'explicit'` | Ativo | Em `explicit`, painel mantém slider/inputs/presets em rascunho até Aplicar. |
+| `metadata.inlineOverlay.actions.apply` | `object` | Ativo | Label, aria, aparência, cor semântica e ícone do botão Aplicar/Concluir. |
+| `metadata.inlineOverlay.actions.cancel` | `object` | Ativo | Label, aria, aparência, cor semântica e ícone do botão Cancelar em modo explícito. |
 | `metadata.numericFormat/numberFormat/uiFormat/dataFormat` | `string \| object` | Ativo | Regras de formatacao numerica (percent/currency/number). |
 | `metadata.currency/currencyCode/locale/decimalPlaces` | `string/number` | Ativo | Parametros de formatacao para exibicao. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura do trigger e do painel no modo inline. |
@@ -301,12 +304,13 @@ Use quando precisar:
 - `projects/praxis-dynamic-fields/src/lib/base/pdx-base-input-runtime-contract.json-api.md`
 
 Resumo de composicao deste componente:
-- `Ativo`: range/single, presets, distribuicao, validacoes e formatacao numerica.
+- `Ativo`: range/single, presets, distribuicao, validacoes, formatacao numerica e commit explicito via `inlineOverlay`.
 - `Extensao de runtime`: aliases amplos de formato e histograma para compatibilidade.
 
 ### 4. Mapeamento de Comportamento
 - `mode=range` sincroniza `rangeGroup` (`start/end`) com o control principal.
 - Presets podem vir do JSON ou ser auto-gerados conforme escala.
+- `inlineOverlay.applyMode=explicit` separa rascunho e valor aplicado; `Aplicar` comita, `Cancelar`/`Esc`/fora do painel descartam.
 - Distribuicao suporta compactacao automatica para preservar performance visual.
 - Formato de exibicao prioriza `displayWith` e depois pipeline de `numericFormat/numberFormat`.
 
@@ -396,6 +400,9 @@ Correcao: ajustar `inlineAutoSize` para o contexto da toolbar.
 | `metadata.quickPresetsAuto` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.quickPresetsLabels` | unknown | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineTexts` | unknown | false | n/a | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.applyMode` | string | false | auto | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.actions.apply.*` | object | false | n/a | Partial | Theme-tokenized action metadata. |
+| `metadata.inlineOverlay.actions.cancel.*` | object | false | n/a | Partial | Theme-tokenized action metadata. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
 | `readonlyMode` | boolean | false | n/a | Partial | See Detailed API reference. |
 | `disabledMode` | boolean | false | n/a | Partial | See Detailed API reference. |

package/src/lib/components/inline-rating/pdx-inline-rating.json-api.md

@@ -301,6 +301,8 @@ Use quando precisar:
 | `metadata.ratingGradientLowColor/midColor/highColor` | `string` | Ativo | Gradiente semantico aplicado na escala visual das estrelas. |
 | `metadata.ratingBadgeColor/ratingIndicatorColor` | `string` | Ativo | Cor de badges e indicador de escala. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura do trigger e painel de rating. |
+| `metadata.inlineOverlay.applyMode` | `'auto'\|'explicit'` | Ativo | Define se slider, inputs e presets comitam durante a interacao ou ficam em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply/cancel/clear` | `object` | Ativo | Labels, aria, icones, `appearance` e `colorRole` das acoes do painel, materializados por tokens do tema. |
 | `metadata.quickPresets` | `array` | Ativo | Presets herdados do range inline para faixa de rating. |
 
 #### 3.2 Campos herdados compartilhados (exaustivo)
@@ -316,6 +318,7 @@ Resumo de composicao deste componente:
 - Estrelas mudam tom conforme banda (`low/mid/high`) e selecao atual.
 - Resolucao de passo prioriza `allowHalf`/`ratingAllowHalf`.
 - Presets e slider usam clamp por `min/max` com snap por `step`.
+- Com `inlineOverlay.applyMode: "explicit"`, estrelas, badges, inputs e presets refletem o rascunho do painel; `Aplicar` comita, enquanto `Cancelar`, `Esc` e fechamento externo restauram o valor anterior.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -349,6 +352,14 @@ Uso: filtro de rating inteiro (1 a 5).
     "ratingToneMidColor": "#f59e0b",
     "ratingToneHighColor": "#16a34a",
     "ratingBadgeColor": "#f59e0b",
+    "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" }
+      }
+    },
     "inlineAutoSize": { "minWidth": 176, "maxWidth": 320, "panelMinWidth": 280, "panelMaxWidth": 400 },
     "quickPresets": [
       { "id": "detractors", "label": "Detratores", "start": 0, "end": 6 },
@@ -397,6 +408,8 @@ Correcao: preencher `ratingIcon` ou `prefixIcon`.
 | `metadata.ratingIcon` | string | false | n/a | Partial | See Detailed API reference. |
 | `metadata.prefixIcon` | string | false | n/a | Partial | See Detailed API reference. |
 | `metadata.inlineAutoSize.*` | object | false | n/a | Partial | See Detailed API reference. |
+| `metadata.inlineOverlay.applyMode` | `'auto'\|'explicit'` | false | `auto` | Active | Controls draft versus immediate commit behavior. |
+| `metadata.inlineOverlay.actions.*` | object | false | n/a | Active | Panel action labels, aria, icons and theme roles. |
 | `metadata.quickPresets` | array | false | n/a | Partial | See Detailed API reference. |
 | `readonlyMode` | boolean | false | n/a | Partial | See Detailed API reference. |
 | `disabledMode` | boolean | false | n/a | Partial | See Detailed API reference. |

package/src/lib/components/inline-relative-period/pdx-inline-relative-period.json-api.md

@@ -300,6 +300,10 @@ Use quando precisar:
 | `metadata.relativePeriodIconKey/optionIconKey` | `string` | Ativo | Chave do icone por opcao. |
 | `metadata.relativePeriodSubtitleKey/optionSubtitleKey` | `string` | Ativo | Chave de subtitulo por opcao. |
 | `metadata.relativePeriodTexts` / `inlineTexts` | `object \| string(JSON)` | Ativo | Textos de labels, empty state e aria; templates canonicos devem usar `{{label}}` e `{{percent}}` quando houver interpolacao, com compatibilidade legada para `{...}` em metadata. |
+| `metadata.inlineOverlay.applyMode` | `"auto" \| "explicit" \| "confirm"` | Ativo | Quando `explicit`/`confirm`, selecoes ficam em rascunho ate `Aplicar`. |
+| `metadata.inlineOverlay.actions.apply.*` | `object` | Ativo | Label, aria, icon, appearance e colorRole do commit. |
+| `metadata.inlineOverlay.actions.cancel.*` | `object` | Ativo | Label, aria, icon, appearance e colorRole do descarte. |
+| `metadata.inlineOverlay.actions.clear.*` | `object` | Ativo | Label, aria, icon, appearance, colorRole e visibilidade da limpeza explicita. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Controle de largura da pill e painel. |
 
 #### 3.2 Campos herdados compartilhados (exaustivo)
@@ -315,6 +319,7 @@ Resumo de composicao deste componente:
 - Em single mode, pode fechar automaticamente por `relativePeriodCloseOnSelect`.
 - Barra de progresso calcula posicao da opcao selecionada no conjunto.
 - Busca filtra opcoes por label/subtitulo antes da selecao.
+- Com `inlineOverlay.applyMode: "explicit"` ou `"confirm"`, clique em card altera apenas o rascunho do painel; `Aplicar` comita, enquanto `Cancelar`, `Esc`, detach ou clique externo descartam.
 
 ### 5. Exemplo Minimo (JSON + Uso)
 ```json
@@ -357,6 +362,14 @@ Uso: filtro temporal relativo em modo single.
       "relativePeriodEmptyStateText": "Nenhum preset disponivel",
       "progressAriaLabel": "{{label}} em {{percent}} por cento"
     },
+    "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" }
+      }
+    },
     "inlineAutoSize": { "minWidth": 188, "maxWidth": 360, "panelMinWidth": 320, "panelMaxWidth": 560 }
   }
 }