@praxisui/crud 8.0.0-beta.0 → 8.0.0-beta.100

package/README.md

@@ -240,12 +240,19 @@ sequenceDiagram
 ### Pontos-Chave do Runtime
 
 1. **`crudContext` precisa ser estavel**: o componente nao usa getter dinamico no template; ele memoiza o contexto quando o metadata muda.
-2. **`PraxisCrudComponent` pode completar a UX da tabela**: ele injeta automaticamente toolbar add e row actions quando o metadata declara acoes e o host nao configurou a tabela explicitamente.
+2. **`PraxisCrudComponent` pode completar a UX da tabela**: ele injeta automaticamente toolbar add e row actions quando o metadata declara acoes e o host nao configurou a tabela explicitamente. Row actions geradas pelo CRUD limitam duas acoes primarias inline por padrao e mantem descobertas/contextuais no menu overflow para preservar densidade corporativa.
 3. **A validacao estrutural do metadata e estrita, mas aceita bindings diferidos**: `route` e `formId` podem ser completados por overrides persistidos imediatamente antes da abertura.
 4. **O `CrudLauncherService` e a fonte de verdade para `openMode`**: ele mescla overrides persistidos, defaults do metadata e GlobalConfig antes de decidir `route`, `modal` ou `drawer`.
 5. **Modal e drawer nao sao equivalentes internamente**: o ramo modal usa `DynamicFormDialogHostComponent`; o ramo drawer depende do adapter provido pelo host.
 6. **Save e delete geram refetch automatico da lista**: esse side effect faz parte do contrato atual do shell CRUD.
 
+Nota de fronteira para formularios:
+
+- `@praxisui/crud` nao redefine payload de formulario nem filtra campos locais.
+- Campos locais/transientes pertencem ao contrato de `@praxisui/dynamic-form` via `fieldMetadata[].source`, `fieldMetadata[].transient` e `fieldMetadata[].submitPolicy`.
+- No fluxo modal, `DynamicFormDialogHostComponent` recebe `formSubmit.formData` ja filtrado para persistencia. Valores completos de UI ficam em `formSubmit.rawFormData`.
+- `actions[].form.initialValue` e `inputs` continuam sendo seed/contexto de abertura, nao campos automaticamente persistiveis.
+
 ## Documentacao Tecnica da Lib
 
 - `projects/praxis-crud/docs/host-crud-runtime-and-openmode.md`
@@ -346,6 +353,39 @@ Direcao de plataforma:
 - a semantica canonica continua cobrindo metadata, tabela interna, formulario, actions, open modes e persistencia/reabertura
 - hosts consumidores devem permanecer como demonstradores do contrato, nao como donos de um editor paralelo
 
+## Agentic Authoring Contract
+
+`PRAXIS_CRUD_AUTHORING_MANIFEST` is the executable AI authoring contract for `@praxisui/crud`.
+
+The manifest owns CRUD orchestration only:
+
+- `resource.path`, `resourceKey`, `idField`, endpoint key and query context binding
+- list surface orchestration and stable `crudContext`
+- create/edit/view action open mode, route, form binding, params, `initialValue` and back policy
+- delete enablement, confirmation, canonical submit contract and capability policy
+- dialog/drawer/route defaults consumed by `CrudLauncherService`
+- permissions derived from resource capabilities
+
+The manifest does not own child component semantics:
+
+- `TableConfig` edits must delegate to `praxis-table`
+- `FormConfig` and `FieldMetadata` edits must delegate to `praxis-dynamic-form` or `praxis-metadata-editor`
+- dialog shell changes outside CRUD defaults must delegate to `praxis-dialog` or `praxis-settings-panel`
+
+Governed operation families:
+
+- `resource.bind`
+- `list.surface.configure`
+- `surface.create.configure`
+- `surface.edit.configure`
+- `surface.view.configure`
+- `delete.enabled.set`
+- `dialog.size.set`
+- `permissions.set`
+- `form.childOperation.delegate`
+
+Stable identities are resource path/key, `crudId`, action id and child operation id. Array indexes are not canonical identities. Destructive delete behavior requires explicit confirmation and backend capability support.
+
 To build the library, run:
 
 ```bash

package/drawer-adapter/package.json

@@ -1,3 +1,4 @@
 {
-  "module": "../fesm2022/praxisui-crud-drawer-adapter.mjs"
+  "module": "../fesm2022/praxisui-crud-drawer-adapter.mjs",
+  "typings": "../types/praxisui-crud-drawer-adapter.d.ts"
 }