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

package/README.md

@@ -35,7 +35,7 @@ keywords:
   - "open mode"
   - "drawer"
   - "modal"
-last_updated: "2026-03-07"
+last_updated: "2026-04-10"
 ---
 
 # @praxisui/crud
@@ -250,6 +250,102 @@ sequenceDiagram
 
 - `projects/praxis-crud/docs/host-crud-runtime-and-openmode.md`
 - `projects/praxis-crud/docs/adr/2026-03-drawer-adapter-light-entrypoint.md`
+- `projects/praxis-crud/docs/adr/2026-04-crud-authoring-surface.md`
+
+## Status de Authoring Visual
+
+O `@praxisui/crud` publica hoje a superficie canonica de runtime do fluxo CRUD:
+
+- shell `table + form`
+- `crudContext`
+- open modes `route`, `modal` e `drawer`
+- launcher e contratos explicitos de formulario por acao
+
+O `@praxisui/crud` tambem ja publica a Fase 1 da superficie canonica de authoring visual:
+
+- `CrudAuthoringDocument` e helpers canonicos de parse/normalize/serialize/validate
+- `CrudMetadataEditorComponent` como editor hospedavel da propria lib
+- `openCrudMetadataEditor(...)` para integracao canonica com `@praxisui/settings-panel`
+- round-trip minimo `abrir -> editar -> apply/save -> reabrir` para o documento canonico do CRUD
+- composicao canonica com a secao inline de tabela, sem empurrar um builder paralelo para o host
+
+Na Fase 2, essa superficie passou a cobrir um recorte mais util de `metadata.table` dentro do mesmo shell unico:
+
+- toolbar/header visual essencial da tabela, incluindo `toolbar.layout.height` e `toolbar.actionsBackgroundColor`
+- paginacao essencial
+- ordenacao essencial
+- mensagens de estado principais da lista
+- hierarquia visual `essentials + advanced table details`, sem criar um segundo entrypoint visivel
+
+Na Fase 3, essa superficie passou a aprofundar o authoring dos contratos de acao e formulario no proprio shell de CRUD:
+
+- agrupamento por acao entre `binding`, `schema`, `submit` e `api`
+- sinais canonicos de prontidao, pendencia e inconsistencias por grupo e por acao
+- resumos editoriais no strip, no header e no topo da shell para orientar troubleshooting sem depender do bloco JSON
+- disclosure inicial derivado, abrindo automaticamente acoes e blocos avancados que pedem atencao
+- acabamento editorial para acoes saudaveis, com menos redundancia entre strip, header e grupos internos
+
+Na Fase 4, essa superficie passou a cobrir o recorte minimo de apresentacao e defaults que o runtime de CRUD realmente consome:
+
+- `defaults.modal.density`
+- `defaults.modal.canMaximize`
+- `defaults.modal.rememberLastState`
+- `defaults.modal.startMaximized`
+- `defaults.modal.disableCloseOnEsc`
+- `defaults.modal.disableCloseOnBackdrop`
+- `defaults.modal.fullscreenBreakpoint`
+- `defaults.back.strategy`
+- `defaults.back.returnTo`
+- `defaults.back.confirmOnDirty`
+- `actions[].back.strategy`
+- `actions[].back.returnTo`
+- `actions[].back.confirmOnDirty`
+
+Fronteira fechada da Fase 4:
+
+- o launcher e o host canonico nao consomem hoje nenhum `action.modal/*` ou outro bloco de apresentacao por acao alem de `openMode`, `formId`, `route` e `back`
+- por isso a Fase 4 para aqui de forma intencional: ampliar alem disso exigiria inventar semantica nova de formulario dentro de `@praxisui/crud`, o que estaria errado para a plataforma
+
+O que ainda nao existe como superficie publica canonica completa da lib:
+
+- editor visual completo de toda a semantica de `TableConfig` e `FormConfig`
+- builder amplo de pagina ou workflow no nivel do `@praxisui/crud`
+- authoring visual de CRUD que cubra todos os recortes avancados alem das Fases 1, 2 e 3
+
+Direcao atual da proxima fase:
+
+- a proxima fase deve focar em input seeding e parameter mapping que o runtime de CRUD ja consome de forma canonica
+- isso cobre principalmente `actions[].params` e `actions[].form.initialValue`, porque o launcher ja usa esses campos para montar `inputs` e o host de formulario ja os injeta no runtime real
+- isso continua nao incluindo transformar `@praxisui/crud` em editor completo de `FormConfig`
+
+Na Fase 5, essa direcao foi consolidada na superficie canonica de authoring do proprio `@praxisui/crud`:
+
+- `actions[].params[]` com `from`, `to` e `name`
+- `actions[].form.initialValue`
+- separacao visual entre:
+  - valores derivados da linha selecionada
+  - seed fixo do formulario
+- resumos avancados que ficam detalhados enquanto `submit/API` ainda pedem atencao
+- resumos avancados curtos em acoes saudaveis
+- indicacao explicita de que `params` e `initialValue` sao inputs opcionais do launcher, e nao trabalho bloqueante do contrato avancado
+
+Fronteira fechada da Fase 5:
+
+- o recorte para em `actions[].params[]` e `actions[].form.initialValue`, que ja possuem consumo canonico real no launcher e no host de formulario
+- transformacoes arbitrarias de payload, authoring amplo de `FormConfig` e qualquer builder paralelo continuam fora de escopo
+
+Leitura correta para apps host:
+
+- se o objetivo e executar um CRUD, use o runtime da lib
+- se o objetivo e authoring visual de pagina, use `@praxisui/page-builder`
+- se o objetivo e authoring visual especifico de CRUD, use a superficie publica de `@praxisui/crud`; nao crie um builder local no app consumidor
+
+Direcao de plataforma:
+
+- o editor visual de CRUD nasce em `@praxisui/crud`
+- 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
+
 To build the library, run:
 
 ```bash

package/drawer-adapter/index.d.ts

@@ -71,7 +71,9 @@ interface CrudDrawerAdapter {
 interface DialogConfig<D = any> extends MatDialogConfig<D> {
     disableCloseOnBackdrop?: boolean;
     disableCloseOnEsc?: boolean;
+    density?: 'default' | 'compact';
     canMaximize?: boolean;
+    rememberLastState?: boolean;
     startMaximized?: boolean;
     fullscreenBreakpoint?: number;
 }