@praxisui/dynamic-fields 9.0.5 → 9.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.5",
+  "version": "9.0.7",
   "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.5",
-    "@praxisui/cron-builder": "^9.0.5"
+    "@praxisui/core": "^9.0.7",
+    "@praxisui/cron-builder": "^9.0.7"
   },
   "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-08-11"
-last_updated: "2026-08-11"
+source_of_truth_last_verified: "2026-08-19"
+last_updated: "2026-08-19"
 toc: true
 sidebar: true
 tags:
@@ -112,8 +112,8 @@ Este documento e a referencia canonica da API JSON de pdx-material-async-select.
 | Path | Type | Required | Default | Status | Notes |
 | --- | --- | --- | --- | --- | --- |
 | `metadata` | object | true | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `readonlyMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `disabledMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
+| `readonlyMode` | boolean | false | n/a | Active | Mantém o trigger focalizável com `aria-readonly`, bloqueia mutações e oculta clear/chevron. |
+| `disabledMode` | boolean | false | n/a | Active | Aplica disabled nativo, `aria-disabled` e bloqueia interação. |
 | `visible` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 | `presentationMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 
@@ -339,6 +339,12 @@ Limites:
 - debounce de busca interno permanece fixo em `300ms`.
 - selecao multipla usa o overlay conectado com `listbox` multisselecao; ela nao
   projeta busca ou acoes dentro de `mat-select` e nao reutiliza o combobox simples.
+- tanto o combobox pesquisável quanto o ramo de coleção usam o frame canônico `mat-form-field` para label, outline, hint, erro, prefixo e sufixos.
+- o estado vazio não repete o label como valor; seleções múltiplas compactadas preservam todos os labels em tooltip e no nome acessível.
+- no ramo de coleção, valor e chevron/spinner ocupam colunas explícitas; ações trailing usam slots Material e não criam reserva fixa vazia.
+- tanto o combobox pesquisável quanto o ramo de coleção mantêm clear, seta/spinner e help em trilho trailing com separação entre adornos e inset final até o outline.
+- a troca entre spinner e chevron não altera a altura do frame Material nem o alinhamento da linha do formulário.
+- `readonly` não é materializado como disabled nativo: o trigger permanece focalizável, expõe `aria-readonly`, não oferece chevron/clear, não abre por teclado e possui bloqueio final contra mutação no runtime base.
 - ordenacao nao possui contrato dedicado nesta camada.
 - `loadOn` e `useCursor` dependem da capacidade do backend e da configuracao global.
 

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-07-06"
-last_updated: "2026-07-06"
+source_of_truth_last_verified: "2026-08-19"
+last_updated: "2026-08-19"
 toc: true
 sidebar: true
 tags:
@@ -326,6 +326,11 @@ Garantias:
 - input de busca esta presente na UI do componente.
 - carga remota e cascata seguem contrato base de select.
 - `multiple` e respeitado para alternar single/multiple.
+- label, outline, hint, erro, prefixo e sufixos usam o frame `mat-form-field` compartilhado com os demais campos Material.
+- o estado vazio não repete o label como valor; seleções múltiplas compactadas preservam todos os labels em tooltip e no nome acessível.
+- ações trailing ocupam slots Material reais; o trigger não reserva espaço quando clear/help estão ausentes.
+- clear/help presentes compartilham um único trilho trailing, com separação entre ações e inset final até o outline.
+- `readonly` permanece focalizável e expõe `aria-readonly`, sem ser convertido em disabled nativo, sem abrir o overlay e com bloqueio final de mutação no runtime base.
 
 Limites:
 

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

@@ -22,8 +22,8 @@ source_of_truth:
   - "projects/praxis-dynamic-fields/src/lib/components/material-select/material-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-08-11"
-last_updated: "2026-08-11"
+source_of_truth_last_verified: "2026-08-19"
+last_updated: "2026-08-19"
 toc: true
 sidebar: true
 tags:
@@ -113,8 +113,8 @@ Este documento e a referencia canonica da API JSON de pdx-material-select.
 | Path | Type | Required | Default | Status | Notes |
 | --- | --- | --- | --- | --- | --- |
 | `metadata` | object | true | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `readonlyMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
-| `disabledMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
+| `readonlyMode` | boolean | false | n/a | Active | Mantém o trigger focalizável com `aria-readonly`, bloqueia mutações e oculta clear/chevron. |
+| `disabledMode` | boolean | false | n/a | Active | Aplica disabled nativo, `aria-disabled` e bloqueia interação. |
 | `visible` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 | `presentationMode` | boolean | false | n/a | Partial | See Detailed API reference for runtime semantics. |
 
@@ -333,6 +333,12 @@ Garantias:
 - `metadata.selectOptions` e `metadata.resourcePath` sao consumidos no runtime.
 - valor e ciclo de mudanca integram com CVA/Reactive Forms.
 - opcao vazia e suporte a filtro remoto seguem o contrato base de select.
+- label, outline, hint, erro, prefixo e sufixos usam o mesmo frame `mat-form-field` dos demais campos Material.
+- o trigger usa colunas explícitas para valor e estado; não existe reserva fixa de espaço quando clear/help estão ausentes.
+- quando clear/help estão presentes, formam um único trilho trailing com separação entre ações e inset final até o outline.
+- o estado vazio não repete o label como valor; placeholder só aparece quando foi declarado.
+- valores truncados preservam o conteúdo integral em tooltip e no nome acessível do combobox.
+- `readonly` permanece semanticamente distinto de `disabled`: continua focalizável, expõe `aria-readonly`, não abre por ponteiro/teclado e possui bloqueio final contra mutação no runtime base.
 
 Limites:
 

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

@@ -265,6 +265,7 @@ interface PraxisDynamicFieldsI18nOverrides {
         endOfList?: PraxisDynamicFieldText;
         noOptionsAvailable?: PraxisDynamicFieldText;
         loadingOptionsAriaLabel?: PraxisDynamicFieldText;
+        triggerAriaLabel?: PraxisDynamicFieldText;
     };
     tree?: {
         expandNodeAriaLabel?: PraxisDynamicFieldText;
@@ -1151,6 +1152,12 @@ declare abstract class SimpleBaseSelectComponent<T = any> extends SimpleBaseInpu
     protected defaultPanelClass(): string | string[] | undefined;
     selectPanelClass(): string[];
     protected isInteractionDisabled(): boolean;
+    /**
+     * Native disabled state is intentionally distinct from readonly/presentation.
+     * Readonly collection controls remain focusable and expose `aria-readonly`, while
+     * this state alone removes the trigger from keyboard interaction.
+     */
+    protected isDisabledEffective(): boolean;
     protected normalizeMultipleControlValue(): void;
     setExternalControl(control: AbstractControl): void;
     /** Whether to show the clear button (if enabled in metadata) */
@@ -1197,6 +1204,7 @@ declare abstract class SimpleBaseSelectComponent<T = any> extends SimpleBaseInpu
     selectPanelActionsAriaLabel(): string;
     noOptionsAvailableLabel(): string;
     loadingOptionsAriaLabel(): string;
+    selectionTriggerAriaLabel(displayValue: string): string;
     /**
      * Ícone para estado "selecionado" em opções do painel.
      */
@@ -2579,6 +2587,7 @@ declare class MaterialSelectComponent extends SimpleBaseSelectComponent {
     private readonly collectionSearch;
     private readonly overlayTrigger;
     private readonly overlayOptions;
+    private pendingOverlayFocusIndex;
     protected defaultPanelClass(): string;
     setSelectMetadata(metadata: SimpleSelectMetadata<unknown>): void;
     ngOnInit(): void;
@@ -2595,7 +2604,8 @@ declare class MaterialSelectComponent extends SimpleBaseSelectComponent {
     onOptionKeydown(event: KeyboardEvent): void;
     hasSelectionValue(): boolean;
     materialDisplayText(): string;
-    labelId(): string;
+    materialFullDisplayText(): string;
+    materialTriggerTooltip(): string | null;
     panelId(): string;
     overlayId(): string;
     overlayPanelWidth(): string;
@@ -2702,6 +2712,7 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     protected readonly collectionSearch: _angular_core.Signal<PdxCollectionSearchComponent | undefined>;
     protected readonly overlayTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
     protected readonly overlayOptions: _angular_core.Signal<readonly ElementRef<HTMLButtonElement>[]>;
+    private pendingOverlayFocusIndex;
     private readonly store;
     readonly endReached: _angular_core.WritableSignal<boolean>;
     private initialLoadStrategy;
@@ -2730,7 +2741,7 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     onOptionKeydown(event: KeyboardEvent): void;
     hasSelectionValue(): boolean;
     materialDisplayText(): string;
-    labelId(): string;
+    materialFullDisplayText(): string;
     panelId(): string;
     overlayId(): string;
     overlayPanelWidth(): string;
@@ -2746,7 +2757,6 @@ declare class MaterialSearchableSelectComponent extends SimpleBaseSelectComponen
     private isLastPage;
     onLoadMoreInteraction(event: Event): void;
     onSearch(term: string): void;
-    protected registerMatSelect(select: MatSelect): void;
     private refocusSearchInput;
     protected focusOverlayOption(index: number): void;
     private resolveMaterialOptionLabel;
@@ -2857,6 +2867,7 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     private readonly materialCollectionSearch;
     private readonly materialOverlayTrigger;
     private readonly materialOverlayOptions;
+    private pendingMaterialOverlayFocusIndex;
     readonly termControl: FormControl<unknown>;
     materialSearchTerm(): string;
     readonly activeLookupFilters: _angular_core.WritableSignal<LookupFilterRequest[]>;
@@ -2892,7 +2903,7 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     onMaterialOptionKeydown(event: KeyboardEvent): void;
     hasMaterialSelection(): boolean;
     materialDisplayText(): string;
-    materialLabelId(): string;
+    materialFullDisplayText(): string;
     materialPanelId(): string;
     materialOverlayId(): string;
     materialOverlayPanelWidth(): string;
@@ -2950,7 +2961,6 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     private isLastPage;
     onLoadMoreInteraction(event: Event): void;
     retry(): void;
-    protected registerMatSelect(select: MatSelect): void;
     private refocusSearchInput;
     private focusMaterialOption;
     private resolveMaterialOptionLabel;
@@ -4500,6 +4510,7 @@ declare class InlineDateRangeComponent extends MaterialDateRangeComponent {
     inlineTextTruncated: boolean;
     private fieldLabelText;
     private resizeRafId;
+    private overlayPositionRafId;
     overlayOpen: boolean;
     private overlayCommittedInSession;
     private overlayBaseline;
@@ -4566,6 +4577,7 @@ declare class InlineDateRangeComponent extends MaterialDateRangeComponent {
     onInputClick(picker: MatDateRangePicker<Date>, event: Event): void;
     onFieldContainerClick(picker: MatDateRangePicker<Date>, event: MouseEvent): void;
     openPicker(picker: MatDateRangePicker<Date>, event: Event): void;
+    private resolvePickerXPosition;
     onOverlayOpened(): void;
     onOverlayClosed(): void;
     onOverlayApplyAction(): void;
@@ -4606,6 +4618,19 @@ declare class InlineDateRangeComponent extends MaterialDateRangeComponent {
     private parsePx;
     private scheduleOverlayActionsContainerSync;
     private syncOverlayActionsContainerClass;
+    /**
+     * Material positions the popup before projected actions are composed. Side shortcuts expand the
+     * content from the calendar width to the enterprise two-column width, so the connected overlay
+     * must be measured again after that DOM change. Delegating to the existing OverlayRef preserves
+     * Material's viewport margin, fallback positions, directionality, and scroll strategy.
+     */
+    private updatePickerOverlayPosition;
+    /**
+     * Material locks the first connected position so normal scrolling cannot make the popup jump.
+     * Praxis adds the shortcut rail after that first measurement, therefore we briefly unlock only
+     * while the CDK evaluates the final overlay dimensions and restore Material's default policy.
+     */
+    private remeasurePickerOverlay;
     private findOverlayActionsContainer;
     private syncQuickPresetComposition;
     private ensureQuickPresetRail;
@@ -4777,6 +4802,8 @@ interface TimeRangeValue {
     end: string | null;
 }
 declare class PdxMaterialTimeRangeComponent extends SimpleBaseInputComponent implements OnInit {
+    supportingTextId(): string;
+    supportingTextDescribedBy(): string | null;
     readonlyMode: boolean;
     disabledMode: boolean;
     visible: boolean;