@praxisui/dynamic-fields 9.0.4-rc.8 → 9.0.4

package/README.md

@@ -176,6 +176,14 @@ The package also exports inline field components for compact filter and toolbar
 
 Inline filter support has its own runtime and discovery contract. Use the official docs and catalog when choosing a compact filter control.
 
+## Collection Selection Overlay
+
+Select controls that need search, pagination or panel actions use the public `PdxCollectionOverlayComponent` and `PdxCollectionSearchComponent` primitives. The trigger remains a single accessible combobox control; search, listbox options and footer actions are sibling regions inside the connected CDK overlay. No input, button, status row or footer action may be projected as option content inside `mat-select`.
+
+The overlay is attached only while open, prefers the space below the trigger, falls back above it, constrains itself to the viewport and owns scrolling in the options region. Closing by selection, `Escape`, outside click or detach restores the trigger/focus contract implemented by each control. Footer actions exist only while the overlay is attached and never participate in option keyboard navigation.
+
+Collection search styling is shared with `@praxisui/table` through the Core `--praxis-collection-search-*` contract. In particular, `--praxis-collection-search-radius` supports square (`0`), intermediate (for example `8px`) and pill (`999px`) themes without component-specific aliases.
+
 ## AI Authoring
 
 `PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST` governs the field-control family. It separates:
@@ -201,6 +209,7 @@ Main exports:
 - `providePraxisDynamicFieldsNoDefaults`
 - base components such as `SimpleBaseInputComponent`, `SimpleBaseSelectComponent`, `SimpleBaseButtonComponent`
 - Material and inline field components
+- shared `PdxCollectionOverlayComponent`, `PdxCollectionOverlayTriggerDirective`, and `PdxCollectionSearchComponent` primitives
 - component metadata exports
 - `DYNAMIC_FIELDS_PLAYGROUND_CATALOG`
 - `PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST`

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-02T14:11:23.065Z",
+  "generatedAt": "2026-08-11T17:36:05.628Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.4-rc.8",
+  "packageVersion": "9.0.4",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 76,

package/docs/dynamic-fields-inline-filter-catalog.md

@@ -39,7 +39,7 @@ keywords:
   - "inlineDateRange"
   - "inlineTreeSelect"
   - "inlineRelativePeriod"
-last_updated: "2026-05-26"
+last_updated: "2026-08-03"
 ---
 
 # Dynamic Fields Inline Filter Catalog
@@ -360,6 +360,8 @@ Para hosts oficiais:
 ```
 
 - UX note: shortcuts nao podem mascarar o shape final enviado ao backend
+- I18n note: os atalhos built-in e o calendario seguem o locale ativo de `PraxisI18nService`; `i18nShortcuts` continua sendo a sobreposicao governada para copy especifica do dominio.
+- Responsive note: quando os atalhos ocupam a lateral, a raia reserva altura para cinco opcoes recorrentes e preserva scroll vertical acessivel em viewports menores ou catalogos maiores.
 - Domain note: periodos corporativos chegam resolvidos por metadata; o frontend nao calcula regras eleitorais, fiscais, juridicas, feriados ou dias contaveis.
 - Docs relacionadas: `dynamic-filter-range-filters-guide`