@praxisui/dynamic-fields 9.0.0-beta.41 → 9.0.0-beta.42

package/package.json

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

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

@@ -22,8 +22,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/material-async-select/material-async-select.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/base/simple-base-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-07-06"
+last_updated: "2026-07-06"
 toc: true
 sidebar: true
 tags:
@@ -319,6 +319,10 @@ Garantias:
 - input de busca e carga incremental estao habilitados no painel.
 - `loadOn` controla a primeira carga (`open`, `init`, `none`).
 - `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.
+- 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:
 
@@ -351,6 +355,7 @@ Precedencia de comportamento:
 #### Checklist corporativo
 
 - alinhe backend para pesquisa por termo e include de selecionados.
+- retorne `totalPages` e `totalElements` consistentes para evitar chamadas extras de paginacao.
 - padronize `optionLabelKey`/`optionValueKey` entre dominios.
 - defina `dependencyLoadOnChange` conforme UX esperada em cascata.
 - use `maxSelections` quando multi-select exigir limite de negocio.
@@ -396,6 +401,8 @@ 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`.
 - `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.
+- `loadMore` incrementa pagina somente quando ja existe pagina remota carregada e `endReached=false`.
 
 Contrato compartilhado completo:
 

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

@@ -22,8 +22,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/material-searchable-select/material-searchable-select.component.ts"
   - "projects/praxis-dynamic-fields/src/lib/base/simple-base-select.component.ts"
   - "projects/praxis-core/src/lib/models/material-field-metadata.interface.ts"
-source_of_truth_last_verified: "2026-04-27"
-last_updated: "2026-04-27"
+source_of_truth_last_verified: "2026-07-06"
+last_updated: "2026-07-06"
 toc: true
 sidebar: true
 tags:
@@ -347,6 +347,9 @@ Precedencia de comportamento:
 2. `options` atua como alias legado quando `selectOptions` nao e enviado.
 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.
+7. fontes locais (`selectOptions`/`options`) e `loadOn='none'` antes da primeira carga nao exibem acao de paginacao.
 
 #### Status model
 
@@ -357,6 +360,7 @@ Precedencia de comportamento:
 #### Checklist corporativo
 
 - alinhe backend para pesquisa por termo e include de selecionados.
+- retorne `totalPages` e `totalElements` consistentes para evitar chamadas extras de paginacao.
 - para lookups metadata-driven, publique `optionSource.dependsOn` e `optionSource.dependencyFilterMap` no schema canonico.
 - padronize `optionLabelKey`/`optionValueKey` entre dominios.
 - defina `dependencyLoadOnChange` conforme UX esperada em cascata.
@@ -406,6 +410,9 @@ Notas de runtime:
 - em remoto, `loadOptions` usa filtro com include de selecionados na pagina 0.
 - com `optionSource`, `loadOptions` chama `filterOptionSourceOptions` e envia termo de busca como `search`, nao como campo de filtro textual.
 - `onSearch` limpa estado local e reinicia pagina para novo termo.
+- `loadNextPage` nao inicia a primeira carga remota; a primeira pagina respeita `loadOn`, abertura do painel, reload explicito ou mudanca de dependencia.
+- `loadNextPage` incrementa pagina somente quando ja existe pagina remota carregada e `endReached=false`.
+- em paginacao numerada, `endReached` usa `totalPages`/`totalElements` quando fornecidos pelo backend; se ausentes, usa `content.length < pageSize` como fallback.
 - estados governados bloqueiam busca, abertura, selecao, reload, clear e `loadNextPage`.
 
 Contrato compartilhado completo:

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

@@ -2603,8 +2603,14 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     private refreshOptions;
     protected loadOptions(page?: number, searchTerm?: string, criteria?: Record<string, unknown>): void;
     loadNextPage(): void;
+    showLoadMore(): boolean;
+    shouldRenderOpenSentinel(): boolean;
+    private isLastPage;
+    onLoadMorePointerDown(event: Event): void;
+    onLoadMoreInteraction(event: Event): void;
     onSearch(term: string): void;
     protected registerMatSelect(select: MatSelect): void;
+    private refocusSearchInput;
     reload(reset: boolean): void;
     protected onDependenciesChanged(): void;
     private syncDisabledModeControlState;
@@ -2730,9 +2736,15 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     protected refreshLookupQueryState(): void;
     private runQuery;
     loadMore(): void;
+    showLoadMore(): boolean;
+    shouldRenderOpenSentinel(): boolean;
+    private isLastPage;
+    onLoadMorePointerDown(event: Event): void;
+    onLoadMoreInteraction(event: Event): void;
     retry(): void;
     handleKey(event: KeyboardEvent): void;
     protected registerMatSelect(select: MatSelect): void;
+    private refocusSearchInput;
     reload(reset: boolean): void;
     protected setupRemoteSelectionHydration(): void;
     protected onDependenciesChanged(): void;