@praxisui/dynamic-fields 9.0.4-rc.18 → 9.0.4-rc.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.4-rc.18",
+  "version": "9.0.4-rc.19",
   "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.18",
-    "@praxisui/cron-builder": "^9.0.4-rc.18"
+    "@praxisui/core": "^9.0.4-rc.19",
+    "@praxisui/cron-builder": "^9.0.4-rc.19"
   },
   "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.
@@ -336,6 +345,7 @@ Use quando precisar:
 | `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`. |
@@ -434,6 +445,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

@@ -2114,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>;
 }
@@ -2901,6 +2903,7 @@ interface EntityLookupViewModel {
     label: string;
     description: string;
     status: string;
+    statusCode: string;
     statusTone: LookupStatusTone;
     selectable: boolean;
     selectionState: EntityLookupResultState;
@@ -3088,6 +3091,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;
@@ -3102,6 +3106,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;
@@ -3148,6 +3160,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private normalizeLookupTone;
     private classifyLookupSelectionState;
     private resolveStatusTone;
+    private resolveStatusLabel;
     private lookupSeparator;
     private normalizeLookupText;
     private normalizeLookupOptionalText;
@@ -3221,6 +3234,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;