@praxisui/dynamic-fields 9.0.4-rc.2 → 9.0.4-rc.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.4-rc.2",
+  "version": "9.0.4-rc.21",
   "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.4-rc.2",
-    "@praxisui/cron-builder": "^9.0.4-rc.2"
+    "@praxisui/core": "^9.0.4-rc.21",
+    "@praxisui/cron-builder": "^9.0.4-rc.21"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

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

@@ -21,8 +21,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/inline-entity-lookup/inline-entity-lookup.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/components/material-async-select/material-async-select.component.ts"
   - "projects/praxis-core/src/lib/models/material-field-metadata.interface.ts"
-source_of_truth_last_verified: "2026-07-26"
-last_updated: "2026-07-26"
+source_of_truth_last_verified: "2026-08-03"
+last_updated: "2026-08-03"
 toc: true
 sidebar: true
 tags:
@@ -128,10 +128,19 @@ Este documento e a referencia canonica da API JSON de pdx-inline-entity-lookup.
 | `metadata.optionSource.display.secondaryPropertyPaths` | string[] | false | n/a | Active | Campos de subtitulo usados para diferenciar entidades parecidas. |
 | `metadata.optionSource.display.fields` | object[] | false | n/a | Active | Campos ricos semanticos exibidos na lista e no valor selecionado. Cada item aceita `key`, `propertyPath`, `label`, `icon`, `presentation`, `tone` e `format`. |
 | `metadata.optionSource.display.badgePropertyPaths` | string[] | false | n/a | Active | Campos publicados como badges/chips quando o backend tambem os materializa no payload de option. |
+| `metadata.optionSource.display.statusLabelMap` | Record<string, string> | false | n/a | Active | Traduz somente o rótulo visual do status; o código canônico continua governando seleção, filtros e tons. |
 | `metadata.searchable` | boolean | false | `true` para fontes nao categoricas | Active | Materializa a acao acessivel de busca no sufixo e abre o dialogo governado sem inserir controles interativos no listbox do `MatSelect`. |
 | `metadata.dialog` | object | false | configuracao derivada do campo | Active | Customiza titulo, tamanho, preview, colunas e acoes da busca governada. |
 | `metadata.dialog.enabled` | boolean | false | herda `metadata.searchable` | Active | `false` desativa explicitamente a superficie de busca; `true` a habilita mesmo quando `searchable=false`. |
 
+The governed search dialog owns a visible close action, focuses the search
+input when it opens, restores focus on close, constrains itself to the viewport,
+and presents remote failures with a retry action. Canonical search strategy
+`kind` values are translated into business-facing labels; internal strategy
+keys are not exposed as the primary copy. Remote option sources may require an
+authenticated host context. The component preserves that boundary and never
+falls back to an unprotected resource endpoint when authorization fails.
+
 ### Path audit
 
 Nenhum desvio de caminho foi identificado nesta revisao.
@@ -329,13 +338,14 @@ 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 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.detail.hrefTemplate` / `metadata.optionSource.detail.routeTemplate` | `string` | Legado | Navegacao usada somente quando o contrato nao declara surface governada. Uma falha ao materializar `detail.kind: "surface"` nunca degrada para rota/href, evitando 404, vazamento de endpoint ou mudanca inesperada de contexto. Quando somente os fallbacks legados existem, `routeTemplate` tem precedencia; `hrefTemplate` de `/api/**` e evidencia de recurso, nao destino de UX. |
 | `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`. |
 | `metadata.optionSource.display.secondaryPropertyPaths` | `string[]` | Ativo | Campos usados como subtitulo quando o payload local ou remoto preserva essas propriedades. O runtime tambem aceita `descriptionPropertyPaths` como fallback. |
 | `metadata.optionSource.display.fields` | `object[]` | Ativo | Subinformacoes ricas com `propertyPath`, `label`, `icon`, `presentation` (`text`, `chip`, `badge`, `date`, `currency`, `metric`), `tone` e `format`. Quando o endpoint materializa `OptionDTO.extra.richFields[]`, esses valores sao usados diretamente. |
 | `metadata.optionSource.display.badgePropertyPaths` | `string[]` | Ativo | Campos usados para badges/chips quando materializados no payload da option-source. |
+| `metadata.optionSource.display.statusLabelMap` | `Record<string, string>` | Ativo | Mapeia códigos canônicos para rótulos localizados sem alterar o valor usado por `selectionPolicy`. |
 | `metadata.resourcePath` | `string` | Ativo | Caminho operacional herdado. Para Entity Lookup de plataforma, preferir `metadata.optionSource.resourcePath`. |
 | `metadata.inlineAutoSize.*` | `object` | Ativo | Largura responsiva da pill lookup. |
 | `metadata.selectedLayout` | `"compact" | "inline" | "card" | "token"` | Ativo | Para `controlType: "entityLookup"`, `compact` e o default preservam altura de campo de formulario. `card` renderiza valor selecionado como cartao rico quando a superficie pedir revisao/detalhe. `token` preserva leitura compacta herdada. |
@@ -348,6 +358,7 @@ Use quando precisar:
 | `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 `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.statusLabelMap` | `Record<string, string>` | Ativo | Override local do mapa de rótulos; prefira `optionSource.display.statusLabelMap` como fonte governada. |
 | `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, `detailRoute` navegavel ou `detailHref` nao-API. `detailHref` de API nao abre nova aba para evitar link morto em hosts corporativos. Default: `true`. |
@@ -371,6 +382,8 @@ Resumo de composicao deste componente:
 - `metadata.optionSource.display` e a fonte preferencial de UX para a entidade; campos top-level como `selectedLayout`, `density`, `showAvatar` e `showStatus` funcionam como override local de host.
 - Opcoes podem mostrar linha secundaria (`subtitle`) para desambiguacao; em `entityLookup`, a linha rica tambem mostra avatar, campos ricos com icones/chips/datas, status visual, badges e motivo de bloqueio.
 - Com `metadata.optionSource.resourcePath`, busca emite termo no pipeline remoto de option-source; sem endpoint, filtra local.
+- Com fonte remota e `loadOn: "open"`, o seletor rapido permanece abrivel antes da primeira pagina para disparar a carga inicial. A opcao sentinela que viabiliza essa abertura e interna, invisivel e nao integra o contrato visual ou o valor do campo.
+- Ao confirmar uma opcao no seletor rapido, a selecao simples fecha o painel e devolve o foco ao campo; a selecao multipla preserva o painel aberto para continuidade da tarefa. Mouse e teclado seguem a mesma regra.
 - 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`.
 - 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.
@@ -434,6 +447,10 @@ Uso: lookup simples em lista local.
         "showCode": false,
         "showDescription": true,
         "showStatus": true,
+        "statusLabelMap": {
+          "ACTIVE": "Ativa",
+          "BLOCKED": "Bloqueada"
+        },
         "showBadges": true,
         "showResultCount": true
       }

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

@@ -843,6 +843,7 @@ declare abstract class SimpleBaseInputComponent implements ControlValueAccessor,
         params?: Record<string, any>;
     } | null | undefined, keySuffix: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     protected clearActionTooltip(): string | null;
+    protected openCalendarAriaLabel(): string;
     protected clearActionAriaLabel(): string;
     private resolveClearActionContextLabel;
     private interpolateValidationMessage;
@@ -2113,7 +2114,9 @@ declare class MaterialDateRangeComponent extends SimpleBaseInputComponent implem
     protected normalizeDateRangeValue(value: unknown): DateRangeValue | null;
     private coerceDateLike;
     private metadataAsField;
-    private resolveAdapterLocale;
+    protected syncDateAdapterLocale(): void;
+    protected resolveBuiltinPresetLabel(id: string, fallback: string, overrides: Record<string, string | undefined>): string;
+    protected resolveAdapterLocale(): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaterialDateRangeComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaterialDateRangeComponent, "pdx-material-date-range", never, { "readonlyMode": { "alias": "readonlyMode"; "required": false; }; "disabledMode": { "alias": "disabledMode"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "presentationMode": { "alias": "presentationMode"; "required": false; }; "metadataInput": { "alias": "metadata"; "required": false; }; }, { "validationChange": "validationChange"; }, never, never, true, never>;
 }
@@ -2846,6 +2849,7 @@ type InlineAsyncSelectMetadata = MaterialSelectMetadata & {
 declare class InlineAsyncSelectComponent extends MaterialAsyncSelectComponent {
     inlineMinWidthPx: number;
     inlineMaxWidthPx: number;
+    readonly isPanelOpen: _angular_core.WritableSignal<boolean>;
     private fieldLabelText;
     private staticOptions;
     private currentMetadata;
@@ -2899,6 +2903,7 @@ interface EntityLookupViewModel {
     label: string;
     description: string;
     status: string;
+    statusCode: string;
     statusTone: LookupStatusTone;
     selectable: boolean;
     selectionState: EntityLookupResultState;
@@ -2965,6 +2970,8 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private nextMetadataFunctionId;
     private readonly inlineSelectPanelClasses;
     private readonly fullFieldSelectPanelClasses;
+    private singleSelectionCloseTimer;
+    private singleSelectionCloseDestroyHookRegistered;
     private placeholderTextCacheSignature;
     private placeholderTextCache;
     set initialMetadata(metadata: MaterialEntityLookupMetadata | null | undefined);
@@ -3057,6 +3064,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     onTriggerIconMouseDown(event: MouseEvent): void;
     onQuickClear(event: MouseEvent): void;
     onOpenedChange(opened: boolean): void;
+    onQuickSelectionCommitted(): void;
     onSearchInput(term: string): void;
     showLoadMore(): boolean;
     showEndReachedMessage(): boolean;
@@ -3086,6 +3094,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     dialogOpenSupportingText(): string;
     dialogContextSupportingText(hasActiveFilters: boolean): string;
     dialogApplyActionText(): string;
+    dialogCurrentSelectionText(value: string): string;
     dialogFilterPanelToggleText(open: boolean): string;
     dialogFilterPlaceholderText(operator: LookupFilterOperator, type: LookupFilterFieldType): string;
     dialogFilterOperatorHintText(operator: LookupFilterOperator): string;
@@ -3100,6 +3109,14 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     dialogResultsAriaLabelText(): string;
     dialogFiltersAriaLabelText(): string;
     dialogPreviewAriaLabelText(): string;
+    dialogCloseAriaLabelText(): string;
+    dialogLoadErrorTitleText(): string;
+    dialogLoadErrorSupportingText(): string;
+    dialogRetryActionText(): string;
+    lookupSearchStrategyOptionText(strategy: {
+        key?: string;
+        kind?: string;
+    }): string;
     dialogResultOptionAriaLabel(item: EntityLookupViewModel): string;
     dialogCancelActionText(): string;
     dialogTitleText(): string;
@@ -3146,6 +3163,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private normalizeLookupTone;
     private classifyLookupSelectionState;
     private resolveStatusTone;
+    private resolveStatusLabel;
     private lookupSeparator;
     private normalizeLookupText;
     private normalizeLookupOptionalText;
@@ -3219,6 +3237,15 @@ declare class EntityLookupDialogComponent implements AfterViewInit {
     onSearchStrategyChange(event: Event): void;
     searchStrategyLabel(): string;
     searchStrategyDefaultLabel(): string;
+    searchStrategyOptionText(strategy: {
+        key?: string;
+        kind?: string;
+    }): string;
+    closeAriaLabel(): string;
+    errorStateTitle(): string;
+    errorStateSupporting(): string;
+    retryActionText(): string;
+    retryResults(): void;
     sortOptions(): _praxisui_core.LookupSortOptionMetadata[];
     trackLookupSortOption(index: number, option: {
         key?: string;