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

package/README.md

@@ -288,7 +288,7 @@ actions: [
 - `showIf`: use Json Logic. Example: `{ "==": [{ "var": "row.status" }, "active"] }`.
 - `emitPayload`: authoring field in the config/editor; current runtime `actionClick` emission does not change shape based on this field.
 
-### Global actions (command)
+### Global actions
 
 ```ts
 actions: [
@@ -296,13 +296,15 @@ actions: [
     id: 'favorite',
     icon: 'favorite',
     label: 'Favorite',
-    command: 'global:api.post',
-    globalPayload: { url: '/api/favorite', body: { id: '${item.id}' } }
+    globalAction: {
+      actionId: 'api.post',
+      payload: { url: '/api/favorite', body: { id: '${item.id}' } }
+    }
   }
 ]
 ```
 
-When `command` is set, `actionClick` is **not emitted** by default. Use `emitLocal: true` to emit both.
+When `globalAction` is set, `actionClick` is **not emitted** by default. Use `emitLocal: true` to emit both.
 
 ### Confirmation and loading
 
@@ -312,14 +314,16 @@ actions: [
     id: 'delete',
     icon: 'delete',
     label: 'Delete',
-    command: 'global:api.patch',
+    globalAction: {
+      actionId: 'api.patch',
+      payload: { url: '/api/items/${item.id}', body: { active: false } },
+    },
     showLoading: true,
     confirmation: {
       title: 'Confirm deletion',
       message: 'Are you sure you want to delete this item?',
       type: 'danger',
     },
-    globalPayload: { url: '/api/items/${item.id}', body: { active: false } },
   }
 ]
 ```
@@ -337,6 +341,18 @@ Outputs:
 - `(actionClick)`: `{ actionId, item, index }`
 - `(selectionChange)`: `{ mode, value, items, ids? }`
 
+## Agentic Authoring & Manifest
+
+`@praxisui/list` publishes `PRAXIS_LIST_AUTHORING_MANIFEST` as the executable authoring contract for list/card configuration.
+
+- **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.
+- **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
 
 1. `layout.virtualScroll` and `layout.stickySectionHeader` exist in the contract/editor, but have no runtime implementation.