@praxisui/list 8.0.0-beta.11 → 8.0.0-beta.13

package/README.md

@@ -96,6 +96,7 @@ import { PraxisList } from '@praxisui/list';
       (itemClick)="onItem($event)"
       (actionClick)="onAction($event)"
       (selectionChange)="onSelection($event)"
+      (exportAction)="onExport($event)"
     />
   `,
 })
@@ -122,14 +123,31 @@ export class ListDemoComponent {
       { id: 'favorite', icon: 'favorite', label: 'Like' },
       { id: 'buy', icon: 'shopping_cart', kind: 'button', buttonVariant: 'stroked', label: 'Buy' },
     ],
+    export: {
+      enabled: true,
+      formats: ['csv', 'json'],
+      general: { scope: 'auto', includeFields: ['id', 'name', 'price'] },
+    },
   } satisfies import('@praxisui/list').PraxisListConfig;
 
   onItem(e: any) { console.log('itemClick', e); }
   onAction(e: any) { console.log('actionClick', e); }
   onSelection(e: any) { console.log('selectionChange', e); }
+  onExport(e: any) { console.log('exportAction', e); }
 }
 ```
 
+## Collection Export
+
+`@praxisui/list` uses the shared collection export contract from `@praxisui/core`, the same platform surface used by table exports.
+
+- `export.enabled` renders the export action menu.
+- `export.formats` accepts `csv`, `json`, `excel`, `pdf`, and `print`.
+- `export.general.scope` accepts `auto`, `selected`, `filtered`, `currentPage`, and `all`.
+- Local CSV/JSON exports run in the browser with formula escaping from `PraxisCollectionExportService`.
+- Remote `filtered`/`all` exports and advanced formats require a host-level `PRAXIS_COLLECTION_EXPORT_PROVIDER`.
+- Deferred exports and provider failures surface visible feedback through snackbar and live-region status.
+
 ## Runtime Contract (Data Mode and Precedence)
 
 Effective data mode resolution follows `ListDataService.stream()`:
@@ -151,6 +169,8 @@ Decision matrix (runtime today):
 
 Important behavior:
 - pagination/search/sort controls from `ui.*` are rendered only when `dataSource.resourcePath` is defined.
+- remote pagination uses Angular Material `mat-paginator` to keep the same paginator chrome and accessibility behavior used by the dynamic table.
+- when `ui.showRange` is `false`, the Material range text is hidden but the remote footer still exposes the total count.
 - remote mode uses `GenericCrudService.filter(query, pageable)` and falls back to `getAll()` when `/filter` fails.
 
 ## Runtime Status Matrix (High-Impact Paths)
@@ -347,10 +367,10 @@ Outputs:
 
 - **Component ID:** `praxis-list`
 - **Config Schema:** `PraxisListConfig`
-- **Editable targets:** 20 target kinds: `itemTemplate`, `primaryText`, `secondaryText`, `avatar`, `badge`, `itemAction`, `emptyState`, `selection`, `layout`, `rowLayout`, `dataBinding`, `interaction`, `expansion`, `rules`, `meta`, `skin`, `toolbarUi`, `localization`, `accessibility`, `eventMapping`.
-- **Operation families:** 29 operations covering every path published in `LIST_AI_CAPABILITIES`, including metadata, local/remote data, layout, row layout, skin, selection, interaction/expansion, rules, executive template slots, features, skeleton, item actions, toolbar UI, i18n, accessibility, and declarative event mappings.
-- **Validation:** 30 deterministic validators cover field binding, stable action/rule/section IDs, destructive action removal, remote resource binding, local/remote precedence, enum support, row layout placement reachability, expansion schema safety, Json Logic, global actions, declared-only runtime warnings, and editor round-trip preservation.
-- **Examples/evals:** 30 fixtures cover every operation family, including title/subtitle binding, action creation/update/removal, status badge, selection mode, missing field rejection, skin, toolbar, accessibility, event mapping, row layout, expansion, data modes, i18n, empty state and conditional row styling.
+- **Editable targets:** the manifest exposes explicit targets for template slots, text, avatar, badge, item actions, empty state, selection, layout, row layout, data binding, interaction, expansion, rules, metadata, skin, toolbar UI, collection export, localization, accessibility and declarative event mappings.
+- **Operation families:** operations cover the required list authoring brief plus supported extensions for metadata, local/remote data, row layout, skin, interaction/expansion, conditional rules, executive template slots, features, skeleton, toolbar UI, export, i18n, accessibility and declarative event mappings.
+- **Validation:** deterministic validators cover field binding, stable action/rule/section IDs, destructive action removal, remote resource binding, local/remote precedence, enum support, query/sort support, row layout placement reachability, expansion schema safety, Json Logic, global actions, declared-only runtime warnings and editor round-trip preservation.
+- **Examples/evals:** fixtures cover every operation family in the manifest, including title/subtitle binding, action creation/update/removal, status badge, selection mode, missing field rejection, skin, toolbar, export, accessibility, event mapping, row layout, expansion, data modes, i18n, empty state and conditional row styling.
 - **Declared-only semantics:** fields documented as declared-only remain authorable only as config/editor round-trip fields and are guarded by `declared-only-runtime-warning`; the manifest does not claim runtime behavior that the component does not implement.
 
 ## Known limitations and mismatches