@praxisui/list 9.0.8 → 9.0.10

package/README.md

@@ -29,41 +29,31 @@ Runtime dependency included by the package:
 ## Minimal Local List
 
 ```ts
-import { Component } from '@angular/core';
-import { PraxisList, type PraxisListConfig } from '@praxisui/list';
+import { Component } from "@angular/core";
+import { PraxisList, type PraxisListConfig } from "@praxisui/list";
 
 @Component({
-  selector: 'app-products-list',
+  selector: "app-products-list",
   standalone: true,
   imports: [PraxisList],
-  template: `
-    <praxis-list
-      listId="products-list"
-      [config]="config"
-      (itemClick)="onItem($event)"
-      (actionClick)="onAction($event)"
-      (selectionChange)="onSelection($event)"
-    />
-  `,
+  template: ` <praxis-list listId="products-list" [config]="config" (itemClick)="onItem($event)" (actionClick)="onAction($event)" (selectionChange)="onSelection($event)" /> `,
 })
 export class ProductsListComponent {
   readonly config: PraxisListConfig = {
-    id: 'products-list',
+    id: "products-list",
     dataSource: {
       data: [
-        { id: 1, name: 'Phone', price: 699 },
-        { id: 2, name: 'Laptop', price: 1499 },
+        { id: 1, name: "Phone", price: 699 },
+        { id: 2, name: "Laptop", price: 1499 },
       ],
     },
-    layout: { variant: 'list', lines: 2, dividers: 'between' },
-    selection: { mode: 'single', return: 'item', compareBy: 'id' },
+    layout: { variant: "list", lines: 2, dividers: "between" },
+    selection: { mode: "single", return: "item", compareBy: "id" },
     templating: {
-      primary: { type: 'text', expr: '${item.name}' },
-      secondary: { type: 'currency', expr: '${item.price}|USD' },
+      primary: { type: "text", expr: "${item.name}" },
+      secondary: { type: "currency", expr: "${item.price}|USD" },
     },
-    actions: [
-      { id: 'details', icon: 'open_in_new', label: 'Details' },
-    ],
+    actions: [{ id: "details", icon: "open_in_new", label: "Details" }],
   };
 
   onItem(event: unknown): void {}
@@ -94,7 +84,7 @@ Data mode resolution is deterministic:
 - `dataSource.resourcePath` uses remote mode when no local data is present.
 - no local data and no resource path renders the empty state.
 
-Remote controls are rendered when `resourcePath` is present. The runtime uses `/filter` through `GenericCrudService.filter(query, pageable)` and falls back to `getAll()` when `/filter` fails.
+In remote mode, search, sort and export share a collection toolbar above the items; pagination remains attached to the collection footer. A configured `resourcePath` does not activate remote controls when local `data` is also present. The runtime uses `/filter` through `GenericCrudService.filter(query, pageable)`. Synchronous changes projected from one `queryContext` are coalesced into a single request. If that endpoint fails with an empty query, the compatibility path may fall back to `getAll()`. With active criteria, the list fails closed, preserves the filter context and exposes a read-only, retryable error stream instead of displaying unfiltered records.
 
 ## Main Inputs And Outputs
 
@@ -112,6 +102,7 @@ Remote controls are rendered when `resourcePath` is present. The runtime uses `/
 - Layout variants: `list`, `cards`, `tiles`.
 - Runtime-active layout fields include `lines`, `dividers`, `groupBy`, `pageSize`, `density` and `model`.
 - Templating slots include `leading`, `primary`, `secondary`, `meta`, `trailing`, `features`, `sectionHeader` and `emptyState`.
+- In `layout.rowLayout`, canonical semantic slots keep the configured desktop grid and reflow into ordered, non-overlapping rows at narrow viewports; extended operational slots stack without requiring host CSS.
 - Template expressions use `${item.field}`. Currency/date/number templates can use config i18n defaults.
 - Selection supports `none`, `single` and `multiple`, with return modes `value`, `item` or `id`.
 - Item actions can emit local events or delegate to `GlobalActionService`; collection export uses the shared `@praxisui/core` contract for `csv`, `json`, `excel`, `pdf` and `print`.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-20T18:11:26.392Z",
+  "generatedAt": "2026-08-21T13:43:24.944Z",
   "packageName": "@praxisui/list",
-  "packageVersion": "9.0.8",
+  "packageVersion": "9.0.10",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/docs/2026-08-collection-toolbar-runtime-note.md

@@ -0,0 +1,22 @@
+# Collection toolbar and remote runtime — August 2026
+
+## Scope
+
+This beta migration aligns the collection toolbar with the canonical data-mode precedence and makes governed query projection atomic.
+
+## Runtime decisions
+
+- Local `data` remains authoritative when `data` and `resourcePath` coexist.
+- Search, sort and pagination are rendered only for the resolved remote mode.
+- The active sort is reflected by the Material select. When an authored initial sort is missing from `sortOptions`, the runtime exposes its canonical value instead of showing a false placeholder.
+- Synchronous query, sort and page mutations are coalesced into one remote request.
+- Filtered failures remain fail-closed. `error$` is read-only to consumers and retry continues through `refresh()`.
+- The collection controls use group semantics because the component does not implement the arrow-key navigation required by an ARIA toolbar.
+
+## Responsive behavior
+
+Search, sort and export share the upper collection surface. At narrow widths, sort occupies a full row and command controls wrap without overflowing the collection. Pagination remains a separate footer responsibility.
+
+## Migration note
+
+Consumers that previously called `ListDataService.error$.next(...)` must stop mutating internal runtime state. Subscribe to `error$` and invoke `refresh()` for user-initiated recovery.