@praxisui/dynamic-fields 9.0.0-beta.80 → 9.0.0-beta.81

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.0-beta.80",
+  "version": "9.0.0-beta.81",
   "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": "^9.0.0-beta.80",
-    "@praxisui/cron-builder": "^9.0.0-beta.80"
+    "@praxisui/core": "^9.0.0-beta.81",
+    "@praxisui/cron-builder": "^9.0.0-beta.81"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

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

@@ -311,7 +311,7 @@ Resumo de composicao deste componente:
 
 ### 4. Mapeamento de Comportamento
 - Trigger em pill + badge de quantidade quando multiplo.
-- Painel com busca em tempo real (termControl) e acoes `Carregar mais`/`Fim de lista`.
+- Painel com busca em tempo real (`termControl`) e rodape compartilhado: o rodape e materializado como irmao do `listbox` no overlay, nunca como opcao. `Carregar mais` e um botao real de largura total e alvo minimo de 44 px; durante a paginacao ele permanece visivel, ocupado e desabilitado. `Tab` transfere o foco da busca para a primeira acao habilitada; `Fim de lista` e um status, fora da semantica de opcoes.
 - Se `resourcePath` ausente, busca opera sobre snapshot local.
 
 ### 5. Exemplo Minimo (JSON + Uso)
@@ -416,7 +416,11 @@ Correcao: ajustar limites em `inlineAutoSize`.
 
 | Token/Class | Scope | Purpose | Notes |
 | --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+| `--pdx-select-panel-actions-surface` / `--pdx-select-panel-actions-on-surface` / `--pdx-select-panel-actions-muted` | overlay footer | Superficie, texto principal e texto secundario | Definir na classe de tema que alcanca o CDK Overlay. Tokens inline e `--pdx-overlay-*` continuam como fallbacks compativeis. |
+| `--pdx-select-panel-actions-outline` / `--pdx-select-panel-actions-accent` | overlay footer | Separador, bordas e cor de acao/foco | Fallbacks Material: divider/outline e primary. |
+| `--pdx-select-panel-action-hover-surface` / `--pdx-select-panel-action-focus-ring` | overlay footer | Estados hover e foco visivel | O host deve preservar contraste AA em temas claro e escuro. |
+| `--pdx-select-panel-load-more-surface` / `--pdx-select-panel-load-more-outline` | overlay footer | Tratamento do botao `Carregar mais` | Permite distinguir a acao sem acoplamento a internals MDC. |
+| `--pdx-select-panel-actions-gap` / `--pdx-select-panel-actions-padding` / `--pdx-select-panel-action-min-height` / `--pdx-select-panel-action-padding` / `--pdx-select-panel-action-radius` / `--pdx-select-panel-action-disabled-opacity` | overlay footer | Densidade, geometria e estado desabilitado | Altura default de 44 px preserva alvo corporativo acessivel. |
 
 ## Examples (obrigatorio)
 

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

@@ -324,7 +324,7 @@ Use quando precisar:
 | `metadata.optionSource.detail.surfaceId` | `string` | Ativo | Id da surface item-level preferida para o detalhe. Quando ausente, o runtime escolhe `detail`, `view` ou a primeira surface item-level de leitura disponivel. |
 | `metadata.optionSource.detail.presentation` | `"drawer" | "modal"` | Ativo | Apresentacao desejada para `surface.open`. Default vem do preset/host de surface. |
 | `metadata.optionSource.detail.preferredWidget` / `metadata.optionSource.detail.mode` | `string` | Documental | Hints semanticos para autoria/discovery. A materializacao final vem da surface descoberta e do `ResourceSurfaceOpenAdapterService`. |
-| `metadata.optionSource.detail.hrefTemplate` / `metadata.optionSource.detail.routeTemplate` | `string` | Legado | Fallback para abrir detalhe por link quando nao houver contrato de surface ou servico global disponivel. Nao deve ser a fonte primaria em novos lookups de plataforma. |
+| `metadata.optionSource.detail.hrefTemplate` / `metadata.optionSource.detail.routeTemplate` | `string` | Legado | Fallback quando nao houver surface governada. Quando ambos existem, `routeTemplate` tem precedencia por representar a rota navegavel do host. `hrefTemplate` que aponta para `/api/**` e tratado como evidencia de recurso, nao como destino de UX, e nao habilita a acao Detalhe isoladamente. |
 | `metadata.optionSource.display.preset` | `"compact" | "rich" | "directory" | "status" | "reference" | "hierarchical"` | Ativo | Define a intencao visual canonica. `directory` e recomendado para pessoas/equipes; `reference` para codigo + descricao; `status` para entidades com estado operacional forte. |
 | `metadata.optionSource.display.usage` | `"form" | "filter" | "table-cell" | "dashboard" | "wizard" | "review"` | Ativo | Indica onde a option-source costuma aparecer. O runtime pode ajustar densidade e acoes sem duplicar regra por host. |
 | `metadata.optionSource.display.density` | `"compact" | "comfortable" | "rich"` | Ativo | Densidade preferencial. Campos de formulario usam `comfortable`; filtros inline e celulas de tabela tendem a `compact`; revisoes podem usar `rich`. |
@@ -341,11 +341,11 @@ Use quando precisar:
 | `metadata.showAvatar` | `boolean` | Ativo | Controla exibicao de avatar por iniciais. Default: `true`. |
 | `metadata.showBadges` | `boolean` | Ativo | Controla exibicao de badges auxiliares vindos de `badges`, `tags`, `riskLevel`, `homologationStatus` ou `badgeKeys`. Default: `true`. |
 | `metadata.showDisabledReason` | `boolean` | Ativo | Controla exibicao do motivo de bloqueio quando `selectable=false`. Default: `true`. |
-| `metadata.showResultCount` | `boolean` | Ativo | Controla contador de resultados no painel de busca. Quando o backend pagina com `totalElements`, mostra o total remoto; em fontes locais/cursor, mostra o total carregado. Default: `true`. |
+| `metadata.showResultCount` | `boolean` | Ativo | Controla contador de resultados no painel de busca. Quando `totalElements` remoto for maior que os itens carregados, mostra `carregados de total` para deixar claro que a lista visivel ainda e uma pagina parcial; em fontes locais/cursor, mostra o total carregado. Default: `true`. |
 | `metadata.statusToneMap` | `Record<string, "success" | "warning" | "danger" | "neutral">` | Ativo | Permite mapear status de dominio para tom visual governado. |
 | `metadata.badgeKeys` | `string[]` | Ativo | Chaves adicionais lidas do valor de entidade para compor badges auxiliares. |
 | `metadata.maxVisibleBadges` | `number` | Ativo | Limita quantidade de badges auxiliares exibidos. Default: `3`. |
-| `metadata.actions.showDetail` | `boolean` | Ativo | Controla acao de detalhe quando houver surface canonica ou fallback `detailHref`/`detailRoute`. Default: `true`. |
+| `metadata.actions.showDetail` | `boolean` | Ativo | Controla acao de detalhe quando houver surface canonica, `detailRoute` navegavel ou `detailHref` nao-API. `detailHref` de API nao abre nova aba para evitar link morto em hosts corporativos. Default: `true`. |
 | `metadata.actions.showChange` | `boolean` | Ativo | Controla acao de troca no cartao selecionado. Default: `true`. |
 | `metadata.actions.showCopyCode` | `boolean` | Ativo | Controla acao de copiar codigo/id. Default: `true`. |
 | `metadata.actions.showClear` | `boolean` | Ativo | Controla acao de limpar em conjunto com `clearButton`/clearable herdado. |
@@ -368,7 +368,9 @@ Resumo de composicao deste componente:
 - Com `metadata.optionSource.resourcePath`, busca emite termo no pipeline remoto de option-source; sem endpoint, filtra local.
 - Em uso standalone de shell/topbar autenticado, o componente aceita `FormControl` externo com `initialMetadata` estático e `options` locais. Um valor inicial já selecionado no controle deve materializar o texto da opção local sem bloquear a montagem da rota nem realimentar change detection quando a metadata recebida for semanticamente equivalente.
 - `metadata.resourcePath` continua aceito como configuracao operacional herdada, mas nao substitui a semantica canonica de entidade publicada em `metadata.optionSource`.
-- Opcao de reset limpa filtro sem fechar contexto de trabalho.
+- As acoes de painel ficam em um rodape materializado como irmao do `listbox` no overlay: `Limpar selecao` e uma acao secundaria alinhada ao inicio; `Carregar mais` e uma acao de largura total, com alvo minimo de 44 px, estado ocupado e foco visivel. `Tab` transfere o foco da busca para a primeira acao habilitada. Nenhuma delas participa da navegacao semantica de opcoes.
+- A reidratacao por IDs preserva o valor selecionado, mas nao conta como carga da pagina zero. No primeiro `open`, o runtime consulta a pagina zero antes de habilitar `Carregar mais`; o contador remoto e a lista visivel permanecem coerentes.
+- Durante busca digitada, a lista visivel mostra apenas resultados retornados pela pagina remota filtrada. O selecionado reidratado por ID nao e injetado como falso resultado, embora continue preservado para display fechado e reabertura sem termo.
 - `OptionDTO.extra.selectable === false` desabilita a opcao e permite exibir `disabledReason` sem remover a entidade da lista ou da reidratacao.
 
 ### 5. Exemplo Minimo (JSON + Uso)
@@ -378,7 +380,7 @@ Resumo de composicao deste componente:
   "metadata": {
     "name": "employee",
     "label": "Funcionario",
-    "controlType": "select",
+    "controlType": "inlineEntityLookup",
     "lookupIdKey": "employeeId",
     "lookupLabelKey": "fullName",
     "selectOptions": [
@@ -409,7 +411,7 @@ Uso: lookup simples em lista local.
       "statusPropertyPath": "status",
       "detail": {
         "kind": "surface",
-        "surfaceId": "view",
+        "surfaceId": "detail",
         "presentation": "drawer",
         "preferredWidget": "praxis-dynamic-form",
         "mode": "view"
@@ -507,7 +509,22 @@ Correcao: ajustar `inlineAutoSize.minWidth/maxWidth`.
 
 | Token/Class | Scope | Purpose | Notes |
 | --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+| `.pdx-entity-lookup-rich` | trigger | Ativa a geometria de campo corporativo | Preserva label Material, subscript e zona de seta com altura integral. |
+| `.pdx-select-panel-actions` | overlay footer | Agrupa acoes auxiliares fora da lista de opcoes | Primitiva interna compartilhada pela familia de selects; nao deve ser transformada em `mat-option`. |
+| `.pdx-select-panel-action.is-clear` | overlay footer | Limpa a selecao atual | Acao secundaria alinhada ao inicio, alvo minimo de 44 px e foco visivel. |
+| `.pdx-select-panel-action.is-load-more` | overlay footer | Solicita a proxima pagina | Acao de largura total com estados normal, hover, focus e loading/disabled. |
+| `.pdx-select-panel-end` | overlay footer | Comunica fim da paginacao | Estado informativo com `role="status"`; nao e interativo. |
+| `--pdx-inline-panel-surface` / `--pdx-inline-panel-surface-raised` | overlay | Superficie base e superficie de estado/selecionado | Definir globalmente no escopo de tema do host, pois o painel vive no CDK Overlay. Fallbacks: `--md-sys-color-surface-container-highest/high`. |
+| `--pdx-inline-panel-on-surface` / `--pdx-inline-panel-on-surface-muted` | overlay | Texto principal e texto auxiliar | Devem manter contraste nos temas claro e escuro. Fallbacks: `--md-sys-color-on-surface/-variant`. |
+| `--pdx-inline-panel-outline` | overlay | Borda e separadores do painel | Fallback: `--md-sys-color-outline-variant`. |
+| `--pdx-entity-lookup-avatar-size` / `--pdx-entity-lookup-avatar-large-size` / `--pdx-entity-lookup-avatar-compact-size` / `--pdx-entity-lookup-avatar-radius` | trigger/panel | Geometria dos avatares por iniciais | Permite ajustar densidade corporativa sem colar icone/texto ou quebrar alinhamento vertical do select. |
+| `--pdx-entity-lookup-avatar-surface` / `--pdx-entity-lookup-avatar-text` | trigger/panel | Cor de avatar por iniciais | Fallbacks usam primary Material com `color-mix`; hosts podem calibrar claro/escuro por tema. |
+| `--pdx-entity-lookup-selected-compact-padding` / `--pdx-entity-lookup-selected-compact-inline-start` | trigger | Respiro do valor selecionado compacto | Deve manter o avatar afastado da borda esquerda, preservar a zona de seta alinhada ao select Material e respeitar o `inline-size` do container em drawers estreitos. |
+| `--pdx-entity-lookup-success-surface` / `--pdx-entity-lookup-success-text` / `--pdx-entity-lookup-warning-surface` / `--pdx-entity-lookup-warning-text` / `--pdx-entity-lookup-warning-outline` / `--pdx-entity-lookup-danger-surface` / `--pdx-entity-lookup-danger-text` / `--pdx-entity-lookup-danger-outline` | trigger/panel | Tons de status, badges e notas de bloqueio/legado | Fallbacks derivam de tokens Material (`primary`, `tertiary`, `error`) para funcionar em temas claro e escuro; hosts regulados podem substituir todos os tons. |
+| `--pdx-select-panel-actions-surface` / `--pdx-select-panel-actions-on-surface` / `--pdx-select-panel-actions-muted` | overlay footer | Superficie, texto principal e texto secundario do rodape | Contrato canonico; os tokens inline acima sao preservados como fallback e transferidos quando definidos no painel. |
+| `--pdx-select-panel-actions-outline` / `--pdx-select-panel-actions-accent` | overlay footer | Separador, bordas e cor de acao/foco | Fallbacks Material: divider/outline e primary. |
+| `--pdx-select-panel-action-hover-surface` / `--pdx-select-panel-action-focus-ring` / `--pdx-select-panel-load-more-surface` / `--pdx-select-panel-load-more-outline` | overlay footer | Estados interativos de limpar/carregar mais | Customizar na classe de tema que alcanca o CDK Overlay e validar contraste claro/escuro. |
+| `--pdx-select-panel-actions-gap` / `--pdx-select-panel-actions-padding` / `--pdx-select-panel-action-min-height` / `--pdx-select-panel-action-padding` / `--pdx-select-panel-action-radius` / `--pdx-select-panel-action-disabled-opacity` | overlay footer | Densidade, geometria e estado desabilitado | Altura default de 44 px preserva alvo corporativo acessivel. |
 
 ## Examples (obrigatorio)
 
@@ -526,7 +543,7 @@ Correcao: ajustar `inlineAutoSize.minWidth/maxWidth`.
   "metadata": {
     "name": "employee",
     "label": "Funcionario",
-    "controlType": "select",
+    "controlType": "inlineEntityLookup",
     "lookupIdKey": "employeeId",
     "lookupLabelKey": "fullName",
     "selectOptions": [
@@ -549,7 +566,7 @@ Correcao: ajustar `inlineAutoSize.minWidth/maxWidth`.
   "metadata": {
     "name": "costCenterOwner",
     "label": "Responsavel",
-    "controlType": "select",
+    "controlType": "inlineEntityLookup",
     "resourcePath": "employees/options",
     "lookupIdKey": "matricula",
     "lookupLabelKey": "nome",

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

@@ -308,6 +308,7 @@ Resumo de composicao deste componente:
 - `Extensao de runtime`: `searchPlaceholder` e `inlineAutoSize.*`.
 
 ### 4. Mapeamento de Comportamento
+- A paginacao usa o rodape compartilhado da familia de selects, materializado como irmao do `listbox` no overlay: botao `Carregar mais` com alvo minimo de 44 px, estado ocupado sem salto de layout e acesso por `Tab` a partir da busca. A acao nao participa da semantica de opcoes.
 - Trigger exibe label e, em modo multiplo, badge de quantidade.
 - Painel contem input de busca e estados de loading/fim de lista.
 - Quando sem `resourcePath`, usa filtragem local da lista estatica.
@@ -418,7 +419,11 @@ Correcao: quick-clear respeita estados readonly/disabled/presentation.
 
 | Token/Class | Scope | Purpose | Notes |
 | --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+| `--pdx-select-panel-actions-surface` / `--pdx-select-panel-actions-on-surface` / `--pdx-select-panel-actions-muted` | overlay footer | Superficie, texto principal e texto secundario | Definir na classe de tema que alcanca o CDK Overlay. Tokens inline e `--pdx-overlay-*` continuam como fallbacks compativeis. |
+| `--pdx-select-panel-actions-outline` / `--pdx-select-panel-actions-accent` | overlay footer | Separador, bordas e cor de acao/foco | Fallbacks Material: divider/outline e primary. |
+| `--pdx-select-panel-action-hover-surface` / `--pdx-select-panel-action-focus-ring` | overlay footer | Estados hover e foco visivel | O host deve preservar contraste AA em temas claro e escuro. |
+| `--pdx-select-panel-load-more-surface` / `--pdx-select-panel-load-more-outline` | overlay footer | Tratamento do botao `Carregar mais` | Permite distinguir a acao sem acoplamento a internals MDC. |
+| `--pdx-select-panel-actions-gap` / `--pdx-select-panel-actions-padding` / `--pdx-select-panel-action-min-height` / `--pdx-select-panel-action-padding` / `--pdx-select-panel-action-radius` / `--pdx-select-panel-action-disabled-opacity` | overlay footer | Densidade, geometria e estado desabilitado | Altura default de 44 px preserva alvo corporativo acessivel. |
 
 ## Examples (obrigatorio)
 

package/src/lib/components/material-async-select/pdx-material-async-select.json-api.md

@@ -318,9 +318,10 @@ Garantias:
 
 - input de busca e carga incremental estao habilitados no painel.
 - `loadOn` controla a primeira carga (`open`, `init`, `none`).
+- Uma falha na carga inicial nao marca o campo como carregado: com `loadOn='open'`, reabrir o painel tenta novamente; somente uma resposta processada com sucesso conclui a carga inicial.
 - `useCursor` pode trocar estrategia de pagina quando backend suporta cursor.
 - Com `resourcePath` e `loadOn='open'`, o painel abre mesmo antes da primeira pagina remota para disparar a carga inicial; a opcao sentinela usada para isso e interna, invisivel e nao compoe contrato visual publico.
-- `Carregar mais` so aparece depois de uma primeira pagina remota carregada com sucesso e com proxima pagina disponivel.
+- `Carregar mais` so aparece depois de uma primeira pagina remota carregada com sucesso e com proxima pagina disponivel; durante a paginacao permanece visivel, ocupado e desabilitado para evitar requisicoes duplicadas e salto de layout. A acao usa o rodape compartilhado, materializado como irmao do `listbox` no overlay, tem alvo minimo de 44 px, recebe foco por `Tab` a partir da busca e nao participa da semantica de opcoes.
 - fontes locais (`selectOptions`/`options`) e `loadOn='none'` antes da primeira carga nao exibem acao de paginacao.
 - em paginacao numerada, o fim usa `totalPages`/`totalElements` quando fornecidos pelo backend; se ausentes, usa `content.length < pageSize` como fallback.
 
@@ -399,7 +400,8 @@ Precedencia de comportamento:
 Notas de runtime:
 
 - em remoto generico, `loadOptions` pode usar `includeIds` na pagina 0.
-- em `optionSource`, o filtro envia `includeIds` somente quando `optionSource.includeIds=true`; quando ausente ou `false`, valores selecionados sao reidratados por `/option-sources/{sourceKey}/options/by-ids`.
+- em `optionSource`, o filtro envia `includeIds` somente quando `optionSource.includeIds=true` e nao ha termo de busca ativo; quando ausente, `false` ou durante busca digitada, valores selecionados sao reidratados por `/option-sources/{sourceKey}/options/by-ids`.
+- durante busca digitada, a lista visivel usa apenas os itens da pagina remota filtrada. Opcoes reidratadas por ID preservam o display fechado, mas nao podem substituir ou inflar o resultado da busca.
 - em `optionSource`, dependencias declaradas por `dependsOn` e `dependencyFilterMap` sao materializadas como filtros estruturados `equals` no envelope canonico de opcoes.
 - `onSearch` limpa estado local e reinicia pagina para novo termo.
 - `loadMore` nao inicia a primeira carga remota; a primeira pagina respeita `loadOn`, abertura do painel, reload explicito ou mudanca de dependencia.
@@ -425,8 +427,8 @@ Correcao: revise `loadOn`, `resourcePath` e permissao de endpoint.
 3. Filtro remoto usa campo errado.
 Correcao: alinhe `optionLabelKey` e `optionValueKey` ao payload real.
 
-4. Item selecionado some apos nova busca.
-Correcao: para `optionSource.includeIds=false`, backend deve suportar reidratacao por `/by-ids`; para remoto generico ou `optionSource.includeIds=true`, pode suportar include de ids selecionados na pagina inicial.
+4. Item selecionado aparece como unico resultado de uma busca que deveria retornar outro item.
+Correcao: durante busca, nao envie `includeIds` nem force `ensureVisible` do selecionado; a lista deve refletir a pagina remota filtrada. O selecionado continua preservado pela reidratacao `/by-ids` para display fechado e reabertura sem termo.
 
 5. Cascata nao atualiza automaticamente.
 Correcao: use `dependencyLoadOnChange='immediate'` ou dispare recarga no host.
@@ -468,7 +470,11 @@ Correcao: use `dependencyLoadOnChange='immediate'` ou dispare recarga no host.
 
 | Token/Class | Scope | Purpose | Notes |
 | --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+| `--pdx-select-panel-actions-surface` / `--pdx-select-panel-actions-on-surface` / `--pdx-select-panel-actions-muted` | overlay footer | Superficie, texto principal e texto secundario | Definir na classe de tema que alcanca o CDK Overlay. Tokens `--pdx-overlay-*` e inline continuam como fallbacks compativeis. |
+| `--pdx-select-panel-actions-outline` / `--pdx-select-panel-actions-accent` | overlay footer | Separador, bordas e cor de acao/foco | Fallbacks Material: divider/outline e primary. |
+| `--pdx-select-panel-action-hover-surface` / `--pdx-select-panel-action-focus-ring` | overlay footer | Estados hover e foco visivel | O host deve preservar contraste AA em temas claro e escuro. |
+| `--pdx-select-panel-load-more-surface` / `--pdx-select-panel-load-more-outline` | overlay footer | Tratamento do botao `Carregar mais` | Permite distinguir a acao sem acoplamento a internals MDC. |
+| `--pdx-select-panel-actions-gap` / `--pdx-select-panel-actions-padding` / `--pdx-select-panel-action-min-height` / `--pdx-select-panel-action-padding` / `--pdx-select-panel-action-radius` / `--pdx-select-panel-action-disabled-opacity` | overlay footer | Densidade, geometria e estado desabilitado | Altura default de 44 px preserva alvo corporativo acessivel. |
 
 ## Examples (obrigatorio)
 

package/src/lib/components/material-searchable-select/pdx-material-searchable-select.json-api.md

@@ -348,7 +348,7 @@ Precedencia de comportamento:
 3. `optionSource` ativa consulta remota pelo endpoint canonico `/option-sources/{key}/options/filter`.
 4. `resourcePath` ativa consulta remota paginada legada com termo de busca.
 5. Com `resourcePath` e `loadOn='open'`, o painel abre mesmo antes da primeira pagina remota para disparar a carga inicial; a opcao sentinela usada para isso e interna, invisivel e nao compoe contrato visual publico.
-6. `Carregar mais` so aparece depois de uma primeira pagina remota carregada com sucesso e com proxima pagina disponivel.
+6. `Carregar mais` so aparece depois de uma primeira pagina remota carregada com sucesso e com proxima pagina disponivel; durante a paginacao permanece visivel, ocupado e desabilitado para evitar requisicoes duplicadas e salto de layout. A acao usa o rodape compartilhado, materializado como irmao do `listbox` no overlay, tem alvo minimo de 44 px, recebe foco por `Tab` a partir da busca e nao participa da semantica de opcoes.
 7. fontes locais (`selectOptions`/`options`) e `loadOn='none'` antes da primeira carga nao exibem acao de paginacao.
 
 #### Status model
@@ -478,7 +478,11 @@ Correcao: use `dependencyLoadOnChange='immediate'` ou dispare recarga no host.
 
 | Token/Class | Scope | Purpose | Notes |
 | --- | --- | --- | --- |
-| `not-yet-verified` | component | Styling contract not yet verified | Use Detailed API reference for component-specific styling notes. |
+| `--pdx-select-panel-actions-surface` / `--pdx-select-panel-actions-on-surface` / `--pdx-select-panel-actions-muted` | overlay footer | Superficie, texto principal e texto secundario | Definir na classe de tema que alcanca o CDK Overlay. Tokens `--pdx-overlay-*` e inline continuam como fallbacks compativeis. |
+| `--pdx-select-panel-actions-outline` / `--pdx-select-panel-actions-accent` | overlay footer | Separador, bordas e cor de acao/foco | Fallbacks Material: divider/outline e primary. |
+| `--pdx-select-panel-action-hover-surface` / `--pdx-select-panel-action-focus-ring` | overlay footer | Estados hover e foco visivel | O host deve preservar contraste AA em temas claro e escuro. |
+| `--pdx-select-panel-load-more-surface` / `--pdx-select-panel-load-more-outline` | overlay footer | Tratamento do botao `Carregar mais` | Permite distinguir a acao sem acoplamento a internals MDC. |
+| `--pdx-select-panel-actions-gap` / `--pdx-select-panel-actions-padding` / `--pdx-select-panel-action-min-height` / `--pdx-select-panel-action-padding` / `--pdx-select-panel-action-radius` / `--pdx-select-panel-action-disabled-opacity` | overlay footer | Densidade, geometria e estado desabilitado | Altura default de 44 px preserva alvo corporativo acessivel. |
 
 ## Examples (obrigatorio)
 

package/types/praxisui-dynamic-fields.d.ts

@@ -1189,6 +1189,7 @@ declare abstract class SimpleBaseSelectComponent<T = any> extends SimpleBaseInpu
     loadingOptionsLabel(): string;
     loadMoreOptionsLabel(): string;
     endOfOptionsLabel(): string;
+    selectPanelActionsAriaLabel(): string;
     noOptionsAvailableLabel(): string;
     loadingOptionsAriaLabel(): string;
     /**
@@ -1315,6 +1316,7 @@ declare class OptionStore<ID = string | number> {
     ensureVisible(ids: ID[]): void;
     clearPages(): void;
     get items(): OptionDTO<ID>[];
+    get pageItems(): OptionDTO<ID>[];
 }
 
 declare const PRAXIS_DYNAMIC_FIELDS_PT_BR: PraxisI18nDictionary;
@@ -2620,9 +2622,9 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     protected loadOptions(page?: number, searchTerm?: string, criteria?: Record<string, unknown>): void;
     loadNextPage(): void;
     showLoadMore(): boolean;
+    onPanelSearchKeydown(event: KeyboardEvent): void;
     shouldRenderOpenSentinel(): boolean;
     private isLastPage;
-    onLoadMorePointerDown(event: Event): void;
     onLoadMoreInteraction(event: Event): void;
     onSearch(term: string): void;
     protected registerMatSelect(select: MatSelect): void;
@@ -2655,6 +2657,7 @@ declare class InlineSearchableSelectComponent extends MaterialSearchableSelectCo
     onSearchInput(term: string): void;
     onSearchInputEvent(event: Event): void;
     showLoadMore(): boolean;
+    onPanelSearchKeydown(event: KeyboardEvent): void;
     showEndReachedMessage(): boolean;
     onLoadMoreClick(event: MouseEvent): void;
     placeholderText(): string;
@@ -2732,9 +2735,11 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     searchInputAriaLabel(): string;
     ngOnInit(): void;
     onOpened(opened: boolean): void;
+    protected hasCompletedInitialLoad(): boolean;
     private getSelectedIds;
     private preloadSelected;
     private refreshOptions;
+    private hasSearchTerm;
     protected currentLookupFiltering(): LookupFilteringMetadata | null;
     lookupSortOptions(): LookupSortOptionMetadata[];
     lookupFilterDefinitions(): LookupFilterDefinitionMetadata[];
@@ -2755,7 +2760,6 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     showLoadMore(): boolean;
     shouldRenderOpenSentinel(): boolean;
     private isLastPage;
-    onLoadMorePointerDown(event: Event): void;
     onLoadMoreInteraction(event: Event): void;
     retry(): void;
     handleKey(event: KeyboardEvent): void;
@@ -2822,6 +2826,7 @@ declare class InlineAsyncSelectComponent extends MaterialAsyncSelectComponent {
     onSearchInputEvent(event: Event): void;
     onSearchInput(term: string): void;
     showLoadMore(): boolean;
+    onPanelSearchKeydown(event: KeyboardEvent): void;
     showEndReachedMessage(): boolean;
     onLoadMoreClick(event: MouseEvent): void;
     placeholderText(): string;
@@ -2922,6 +2927,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     setSelectMetadata(metadata: EntityLookupMetadata): void;
     protected setMetadata(metadata: MaterialSelectMetadata): void;
     onComponentInit(): void;
+    onLookupHostClick(event: MouseEvent): void;
     onViewportResize(): void;
     errorStateMatcher(): _angular_material_core.ErrorStateMatcher;
     protected getSpecificCssClasses(): string[];
@@ -2983,6 +2989,8 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     selectionLimitReachedText(maxSelections: number | null | undefined): string;
     onDetailAction(event: MouseEvent, item: EntityLookupViewModel): void;
     private openDetailSurface;
+    private hasNavigableDetailHref;
+    private navigableDetailHref;
     private tryOpenGovernedDetailSurface;
     private itemSurfacesHref;
     private selectDetailSurface;
@@ -2996,6 +3004,8 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     optionSecondaryText(option: LookupOption): string;
     protected resolveRemoteOptionValue(option: OptionDTO<string | number>): EntityLookupResult<string | number>;
     resetOptionText(): string;
+    fieldLabel(): string;
+    panelActionsAriaLabel(): string;
     showQuickClear(): boolean;
     onResetOptionClick(event: MouseEvent): void;
     onTriggerIconMouseDown(event: MouseEvent): void;
@@ -3068,6 +3078,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private humanizeLookupDependencyField;
     private lookupFilterValueText;
     inlineTooltipText(): string;
+    inlineTooltipDisabled(): boolean;
     private resolveLookupText;
     private lookupViewFromValue;
     private findKnownLookupOption;