@praxisui/table 9.0.5-rc.8 → 9.0.5-rc.9

package/README.md

@@ -244,6 +244,39 @@ const config: TableConfig = {
 };
 ```
 
+### Adaptive toolbar composition
+
+`PraxisTableToolbar` materializes the toolbar as semantic regions rather than one wrapping row:
+
+- **identity** — title, subtitle and table context;
+- **query** — quick filters, always-visible dynamic filters and projected query shortcuts;
+- **commands** — collection/business actions, table utilities and authoring entrypoints.
+
+The runtime owns the responsive composition through container queries. This is important when a table
+is rendered inside a drawer, split pane or dashboard card: behavior follows the width actually available
+to the table, not only the browser viewport. At wide widths, identity and commands share the first band
+and query controls use a stable second band. At compact widths, the regions move as complete units and
+commands are consolidated under one localized `Mais ações` entrypoint without losing export, column or
+density controls.
+
+Authoring guidance:
+
+- use `toolbar.filters.quickFilters` for a small governed scope switch, not as a substitute for every filter;
+- use `advancedFilters.settings.alwaysVisibleFields` for frequent editable criteria;
+- keep one clear collection/business action primary; export, columns and density are utilities;
+- project custom shortcuts through the toolbar slots, but do not target internal layout classes from the host;
+- validate the component container at `1440`, `1024`, `768`, `480` and `320` px, including long localized labels, zoom and keyboard focus.
+
+Adding filters or actions never requires a host breakpoint. When the command set grows, the compact menu
+preserves capability parity and keyboard order while the query region remains independently scroll-free at
+the page level.
+
+The existing `toolbar.layout` fields are materialized by the same runtime: `alignment` aligns the identity
+and command regions, `padding` and `backgroundColor` project governed chrome, `height` defines the minimum
+toolbar height, and `showSeparator` adds the boundary with the data surface. `toolbar.appearance.tokens.bg`
+remains the most specific background override, followed by `toolbar.layout.backgroundColor` and the legacy
+`actionsBackgroundColor` projection.
+
 ## Filtering And Row Actions
 
 The package exports both the table runtime and `PraxisFilter` integration surfaces.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-12T14:05:00.897Z",
+  "generatedAt": "2026-08-12T21:17:33.309Z",
   "packageName": "@praxisui/table",
-  "packageVersion": "9.0.5-rc.8",
+  "packageVersion": "9.0.5-rc.9",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,