@praxisui/crud 9.0.0-beta.8 → 9.0.0-beta.81

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
@@ -94,6 +94,7 @@ export class EmployeesCrudComponent {
 - `componentInstanceId`: optional host-level instance id
 - `context`: host/runtime context passed into table and form flows
 - `enableCustomization`: enables the package authoring surface
+- `authoringCapability`: optionally requires the exact capability from `EnterpriseRuntimeContext.capabilities` before authoring controls, the CRUD editor, and its internal table authoring are available. This is a UX gate; governed persistence must enforce the same policy server-side.
 
 It emits:
 
@@ -127,22 +128,76 @@ 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. The native drawer remains anchored to its
+configured viewport edge while applying initial or remembered size and while
+maximizing or restoring. The default edge is right/top; a configured left edge
+is preserved by the same lifecycle. `defaults.modal.edgeGap` controls the
+viewport inset while maximized. Provide `CRUD_DRAWER_ADAPTER` only when a
+host must replace that standard shell with a real corporate drawer implementation.
+
+For native edit drawers, the runtime presents the selected record's canonical
+`x-ui.resource.identity` above the command form when the table has materialized
+it. This is read-only context: immutable keys remain outside the request schema
+and are never added to the update payload. Custom drawer adapters retain their
+own presentation responsibility.
+
+## Empty collection state
+
+When collection creation is available, `PraxisCrudComponent` derives the initial
+empty state for its table from the resource label and the canonical `create`
+action. The compact state uses the shared `praxis-empty-state-card`, repeats the
+same create label/icon exposed by the toolbar, and invokes the same action path.
+
+Filtered or searched empty results remain distinct and use the table no-results
+copy without suggesting that the user create a duplicate record. An explicit
+`table.behavior.emptyState` always wins, allowing domain-specific read-only or
+guided states without host CSS or a parallel empty-state component.
+
+## Duplicate Draft
+
+`PraxisCrudComponent` recognizes the canonical optional `duplicate-draft`
+operation published by `praxis-metadata-starter`. When a selected row exposes
+`_links['duplicate-draft']`, the runtime:
+
+1. invokes the non-mutating draft endpoint;
+2. unwraps the returned draft DTO;
+3. opens the canonical `create` form with that DTO as `initialValue`;
+4. refreshes the table only after the user saves the new record.
+
+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.
 
 ## Visual Authoring