@praxisui/crud 10.0.0-rc.13 → 10.0.0-rc.15

package/README.md

@@ -344,6 +344,33 @@ The host does not need to call `HttpClient`, rebuild create schema URLs, or own
 a second launcher. Absence of the HATEOAS link keeps the operation unavailable;
 the runtime does not infer permission from labels, tags, or frontend flags.
 
+## Governed Two-Phase Bulk Operations
+
+`PraxisCrudComponent` discovers governed two-phase bulk operations published by
+`praxis-metadata-starter` on collection capabilities (`actions[].execution.bulk`
+for `DOMAIN_COMMAND` and `operations['bulk-update'].bulk` for `UNIFORM_UPDATE`)
+and materializes them in the contextual bulk selection toolbar:
+
+1. **Pre-evaluation gates**: validates `limits.maxTargets` before evaluation and
+   resolves `expectedVersion` (`ETag`) via `_links.self` only when
+   `preconditions.resourceVersion === 'REQUIRED'`.
+2. **Phase 1 — Immutable Proposal (`PraxisBulkOperationDialogComponent` / `PraxisBulkEditDialogComponent`)**:
+   hydrates command parameters (unwrapping `/properties/parameters` and OpenAPI
+   `$ref` definitions with a resource-and-action-scoped `formId`) or
+   `@BulkEditable` fields (`SET` / `CLEAR`), submits the evaluation request, and
+   renders target eligibility totals (`executable`, `blocked`) and per-item
+   diagnostics.
+3. **Phase 2 — Transactional Confirmation & Reconciliation**: confirms the
+   approved `proposalId` with an `Idempotency-Key`, polls asynchronous
+   executions until terminal state (`COMPLETED`, `COMPLETED_WITH_ERRORS`,
+   `CANCELLED`, `STOPPED`, `RECONCILIATION_REQUIRED`), aggregates all rejection
+   categories (`denied`, `invalid`, `conflict`, `notProcessed`, `unknown`),
+   clears table selection, refreshes the collection, and re-fetches capabilities
+   when `refresh.capabilities === true`.
+
+Unavailable bulk operations (`availability.allowed === false`) remain visible
+but disabled in the bulk toolbar with their canonical translated reason tooltip.
+
 ## Visual Authoring
 
 The package publishes the CRUD-specific authoring surface:
@@ -377,6 +404,7 @@ The manifest owns CRUD orchestration only. It delegates table, form, field, and
 Main exports:
 
 - `PraxisCrudComponent`
+- `PraxisBulkOperationDialogComponent`, `PraxisBulkEditDialogComponent`
 - `CrudLauncherService`
 - `DynamicFormDialogHostComponent`
 - `CrudMetadata`, `CrudActionFormContract`, `CrudDefaults`, `CrudParamMapping`

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T09:51:43.880Z",
+  "generatedAt": "2026-10-14T16:04:24.084Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "10.0.0-rc.13",
+  "packageVersion": "10.0.0-rc.15",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,