@praxisui/crud 9.0.0-beta.7 → 9.0.0-beta.71

package/README.md

@@ -26,7 +26,7 @@ npm i @praxisui/crud@latest
 Peer dependencies:
 
 - `@angular/common`, `@angular/core`, `@angular/forms`, `@angular/cdk`, `@angular/material`, `@angular/router` `^21.0.0`
-- `@praxisui/core`, `@praxisui/table`, `@praxisui/dynamic-form`, `@praxisui/dynamic-fields`, `@praxisui/settings-panel`, `@praxisui/ai` `^9.0.0-beta.4`
+- `@praxisui/core`, `@praxisui/table`, `@praxisui/dynamic-form`, `@praxisui/dynamic-fields`, `@praxisui/settings-panel`, `@praxisui/ai` `^9.0.0-beta.12`
 - `rxjs` `~7.8.0`
 
 ## Quick Start
@@ -127,22 +127,39 @@ Child component semantics stay with their owners:
 CRUD actions can open by route, modal, or drawer. `CrudLauncherService` resolves the final mode from persisted overrides, action metadata, and global/default configuration.
 
 ```ts
-const editAction = {
+const editAction: CrudAction = {
   id: 'edit',
-  label: 'Edit',
+  action: 'edit',
+  label: 'Edit employee',
   openMode: 'drawer',
-  route: '/employees/:id/edit',
+};
+```
+
+For canonical `create`, `view`, `edit`, and `delete` operations, prefer inferred
+contracts. The runtime resolves the stable form id, request schema, submit URL,
+and HTTP method from the resource path, capabilities, surfaces, and HATEOAS
+links. Use an explicit form contract only when the operation deliberately
+overrides that baseline:
+
+```ts
+const explicitEditAction: CrudAction = {
+  id: 'edit',
+  action: 'edit',
+  label: 'Edit employee',
+  openMode: 'drawer',
+  formId: 'employee-edit',
+  mode: 'explicit',
   form: {
-    formId: 'employee-edit',
     schemaUrl: '/api/employees/schemas/edit',
-    submitUrl: '/api/employees/:id',
-    submitMethod: 'PUT',
+    submitUrl: '/api/employees/{id}',
+    submitMethod: 'put',
   },
-  params: [{ from: 'row.id', to: 'path.id', name: 'id' }],
 };
 ```
 
-Hosts that use drawer mode must provide the drawer adapter expected by the CRUD launcher. Modal mode uses the package form dialog host.
+Drawer mode works without a host adapter: the package opens its standard form
+dialog host with drawer presentation. Provide `CRUD_DRAWER_ADAPTER` only when a
+host must replace that standard shell with a real corporate drawer implementation.
 
 ## Visual Authoring