@praxisui/dynamic-fields 9.0.0-beta.90 → 9.0.0-rc.2

package/package.json

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

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

@@ -266,7 +266,7 @@ Em conflito entre alias legado e path canonico, priorizar path canonico e regist
 ## Detailed API reference
 ### Preserved technical reference (normalized from previous revision)
 
-`pdx-material-async-select` e um select config-first para catalogos remotos grandes, com busca no painel, carregamento incremental e suporte opcional a cursor. Nao e um select local com fetch pontual; e um runtime metadata-driven para cenarios corporativos de alto volume.
+`pdx-material-async-select` e um controle config-first para catalogos remotos grandes, com combobox pesquisavel, carregamento incremental e suporte opcional a cursor. Nao e um select local com fetch pontual; e um runtime metadata-driven para cenarios corporativos de alto volume.
 
 ### Prova em 20 segundos
 
@@ -276,7 +276,7 @@ Em conflito entre alias legado e path canonico, priorizar path canonico e regist
   "metadata": {
     "name": "supplier",
     "label": "Fornecedor",
-    "controlType": "select",
+    "controlType": "async-select",
     "resourcePath": "suppliers/options",
     "optionLabelKey": "label",
     "optionValueKey": "id",
@@ -285,7 +285,8 @@ Em conflito entre alias legado e path canonico, priorizar path canonico e regist
 }
 ```
 
-- O runtime abre o painel com busca e carga progressiva de opcoes.
+- No modo simples pesquisavel, o runtime oferece um unico combobox com busca e
+  carga progressiva de opcoes.
 - O mesmo contrato escala para multi-selecao com `multiple`, `selectAll` e `maxSelections`.
 - A estrategia de carga pode alternar entre pagina tradicional e cursor sem trocar componente.
 
@@ -308,7 +309,7 @@ Em conflito entre alias legado e path canonico, priorizar path canonico e regist
 
 #### Promessa e limites
 
-**O que isso habilita:** select remoto com busca inline, pagina incremental e alternancia entre fluxo page/cursor.
+**O que isso habilita:** combobox remoto com busca inline, pagina incremental e alternancia entre fluxo page/cursor.
 
 **Quando usar:** catálogos remotos grandes com custo de carga alto e necessidade de UX progressiva.
 
@@ -316,18 +317,28 @@ Em conflito entre alias legado e path canonico, priorizar path canonico e regist
 
 Garantias:
 
-- input de busca e carga incremental estao habilitados no painel.
+- `searchable=true` e `multiple=false` materializam um unico combobox: o texto
+  pesquisado nunca substitui o valor canonico do `FormControl`.
+- selecionar uma opcao persiste `option.value`; abandonar a pesquisa restaura o
+  label da selecao vigente.
 - `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; 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.
+- no combobox simples pesquisavel, a proxima pagina e carregada
+  automaticamente quando o scroll se aproxima do fim da lista; nao existe
+  botao interativo dentro do `listbox`.
+- no caminho `MatSelect`, a acao opcional de carregar mais permanece irma
+  declarativa do select e fora do overlay.
 - 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.
 
 Limites:
 
 - debounce de busca interno permanece fixo em `300ms`.
+- selecao multipla permanece no caminho `MatSelect`; um composite multi-select
+  pesquisavel exige arquitetura propria de chips/listbox e nao reutiliza o
+  combobox simples.
 - ordenacao nao possui contrato dedicado nesta camada.
 - `loadOn` e `useCursor` dependem da capacidade do backend e da configuracao global.
 
@@ -356,6 +367,8 @@ Precedencia de comportamento:
 #### Checklist corporativo
 
 - alinhe backend para pesquisa por termo e include de selecionados.
+- valide que texto digitado, blur sem selecao e resposta remota tardia nao
+  contaminam o ID persistido.
 - retorne `totalPages` e `totalElements` consistentes para evitar chamadas extras de paginacao.
 - padronize `optionLabelKey`/`optionValueKey` entre dominios.
 - defina `dependencyLoadOnChange` conforme UX esperada em cascata.
@@ -382,7 +395,7 @@ Precedencia de comportamento:
 
 | Caminho JSON | Tipo | Status | Comportamento em runtime |
 | --- | --- | --- | --- |
-| `metadata.controlType` | `'select' \| 'multiSelect'` | Active | Contrato aceito para single/multiple. |
+| `metadata.controlType` | `'async-select'` | Active | Contrato canonico para opcoes remotas single/multiple. |
 | `metadata.selectOptions` | `Array<{ value; text; label?; disabled? }>` | Active | Fonte principal de opcoes locais. |
 | `metadata.options` | `Array<any>` | Runtime-extension | Alias legado quando `selectOptions` nao e informado. |
 | `metadata.multiple` | `boolean` | Active | Define branch single/multiple no template. |
@@ -393,7 +406,7 @@ Precedencia de comportamento:
 | `metadata.filterCriteria` | `Record<string, any>` | Active | Filtros base para consulta remota. |
 | `metadata.optionLabelKey` | `string` | Active | Chave de label no payload remoto. |
 | `metadata.optionValueKey` | `string` | Active | Chave de value no payload remoto. |
-| `metadata.searchable` | `boolean` | Partial | Campo existe no contrato, mas busca permanece habilitada neste componente. |
+| `metadata.searchable` | `boolean` | Active | Em single, escolhe entre combobox pesquisavel e `MatSelect`; em multiple, habilita a busca auxiliar do caminho multiplo. |
 | `metadata.loadOn` | `'open' \| 'init' \| 'none'` | Runtime-extension | Estrategia de primeira carga remota. |
 | `metadata.dependencyLoadOnChange` | `'respectLoadOn' \| 'immediate' \| 'manual'` | Runtime-extension | Regras de recarga por dependencia. |
 
@@ -493,7 +506,7 @@ Correcao: use `dependencyLoadOnChange='immediate'` ou dispare recarga no host.
   "metadata": {
     "name": "supplier",
     "label": "Fornecedor",
-    "controlType": "select",
+    "controlType": "async-select",
     "resourcePath": "suppliers/options",
     "optionLabelKey": "label",
     "optionValueKey": "id",

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

@@ -11,8 +11,8 @@ import * as _angular_material_core from '@angular/material/core';
 import { MatOptionSelectionChange, ErrorStateMatcher } from '@angular/material/core';
 import { MatDatepickerInputEvent, MatDateRangePicker, MatDatepicker } from '@angular/material/datepicker';
 import { ConnectedPosition } from '@angular/cdk/overlay';
+import { MatAutocompleteSelectedEvent, MatAutocompleteTrigger } from '@angular/material/autocomplete';
 import * as _praxisui_dynamic_fields from '@praxisui/dynamic-fields';
-import { MatAutocompleteTrigger } from '@angular/material/autocomplete';
 import { MatMenuTrigger } from '@angular/material/menu';
 import { NestedTreeControl } from '@angular/cdk/tree';
 import { MatTreeNestedDataSource } from '@angular/material/tree';
@@ -2625,6 +2625,7 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     loadNextPage(): void;
     showLoadMore(): boolean;
     onPanelSearchKeydown(event: KeyboardEvent): void;
+    panelActionsVisible(): boolean;
     shouldRenderOpenSentinel(): boolean;
     private isLastPage;
     onLoadMoreInteraction(event: Event): void;
@@ -2660,6 +2661,7 @@ declare class InlineSearchableSelectComponent extends MaterialSearchableSelectCo
     onSearchInputEvent(event: Event): void;
     showLoadMore(): boolean;
     onPanelSearchKeydown(event: KeyboardEvent): void;
+    panelActionsVisible(): boolean;
     showEndReachedMessage(): boolean;
     onLoadMoreClick(event: MouseEvent): void;
     placeholderText(): string;
@@ -2712,6 +2714,7 @@ interface AsyncSelectMetadata {
     dependencyLoadOnChange?: DependencyLoadMode;
 }
 declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
+    private readonly renderer;
     private lastConfiguredPath?;
     private initialLoadStrategy;
     private hasPerformedInitialLoad;
@@ -2720,12 +2723,17 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     visible: boolean;
     presentationMode: boolean;
     private searchInput?;
-    readonly termControl: FormControl<string | null>;
+    private autocomplete?;
+    readonly termControl: FormControl<unknown>;
     readonly activeLookupFilters: _angular_core.WritableSignal<LookupFilterRequest[]>;
     readonly selectedLookupSortKey: _angular_core.WritableSignal<string | null>;
     protected readonly remoteTotalElements: _angular_core.WritableSignal<number | null>;
+    private readonly queryTerm;
     private readonly store;
     readonly endReached: _angular_core.WritableSignal<boolean>;
+    private queryGeneration;
+    private activeControlValueSubscription;
+    private removeAutocompleteScrollListener;
     private cursorAfter;
     private cursorPageIndex;
     private dataVersion?;
@@ -2737,6 +2745,17 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     searchInputAriaLabel(): string;
     ngOnInit(): void;
     onOpened(opened: boolean): void;
+    usesSearchCombobox(): boolean;
+    comboboxInputAriaLabel(): string;
+    autocompletePanelClass(): string;
+    readonly displayComboboxOption: (value: unknown) => string;
+    onComboboxFocus(): void;
+    onComboboxBlur(): void;
+    onComboboxOpened(): void;
+    onComboboxClosed(): void;
+    onComboboxOptionSelected(event: MatAutocompleteSelectedEvent): void;
+    onClearClick(): void;
+    panelActionsVisible(): boolean;
     protected hasCompletedInitialLoad(): boolean;
     private getSelectedIds;
     private preloadSelected;
@@ -2757,6 +2776,15 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     clearLookupFilters(field?: string): void;
     replaceLookupFilters(filters: LookupFilterRequest[]): void;
     protected refreshLookupQueryState(): void;
+    private bindActiveControlValue;
+    protected onActiveControlChanged(previousControl: FormControl, currentControl: FormControl): void;
+    private syncComboboxDisplay;
+    private syncBusinessControlDisabledState;
+    private selectedComboboxOption;
+    private isRenderedOption;
+    private resetSearchSession;
+    private attachAutocompleteScrollListener;
+    private detachAutocompleteScrollListener;
     private runQuery;
     loadMore(): void;
     showLoadMore(): boolean;
@@ -2764,7 +2792,6 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     private isLastPage;
     onLoadMoreInteraction(event: Event): void;
     retry(): void;
-    handleKey(event: KeyboardEvent): void;
     protected registerMatSelect(select: MatSelect): void;
     private refocusSearchInput;
     reload(reset: boolean): void;
@@ -2779,6 +2806,7 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     protected areOptionValuesEqual(left: unknown, right: unknown): boolean;
     private normalizeRemoteOptionValue;
     protected hasRemoteOptionsContract(): boolean;
+    ngOnDestroy(): void;
     private clearRemoteConfiguration;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaterialAsyncSelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaterialAsyncSelectComponent, "pdx-material-async-select", never, { "readonlyMode": { "alias": "readonlyMode"; "required": false; }; "disabledMode": { "alias": "disabledMode"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "presentationMode": { "alias": "presentationMode"; "required": false; }; }, {}, never, never, true, never>;
@@ -2829,6 +2857,7 @@ declare class InlineAsyncSelectComponent extends MaterialAsyncSelectComponent {
     onSearchInput(term: string): void;
     showLoadMore(): boolean;
     onPanelSearchKeydown(event: KeyboardEvent): void;
+    panelActionsVisible(): boolean;
     showEndReachedMessage(): boolean;
     onLoadMoreClick(event: MouseEvent): void;
     placeholderText(): string;
@@ -2924,6 +2953,10 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private lastSelectMetadataSignature;
     private readonly metadataFunctionIds;
     private nextMetadataFunctionId;
+    private readonly inlineSelectPanelClasses;
+    private readonly fullFieldSelectPanelClasses;
+    private placeholderTextCacheSignature;
+    private placeholderTextCache;
     set initialMetadata(metadata: MaterialEntityLookupMetadata | null | undefined);
     private currentMetadata;
     setSelectMetadata(metadata: EntityLookupMetadata): void;
@@ -2936,8 +2969,8 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     selectPanelClasses(): string[];
     hasSelection(): boolean;
     selectedCount(): number;
+    panelActionsVisible(): boolean;
     displayText(): string;
-    private hasPendingLocalSelection;
     richLayoutEnabled(): boolean;
     selectedCardLayout(): boolean;
     selectedCompactLayout(): boolean;
@@ -3014,8 +3047,6 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     onTriggerIconMouseDown(event: MouseEvent): void;
     onQuickClear(event: MouseEvent): void;
     onOpenedChange(opened: boolean): void;
-    onSearchInputEvent(event: Event): void;
-    onSearchInputKeydown(event: KeyboardEvent): void;
     onSearchInput(term: string): void;
     showLoadMore(): boolean;
     showEndReachedMessage(): boolean;