@praxisui/crud 10.0.0-rc.34 → 10.0.0-rc.35

package/README.md

@@ -400,12 +400,16 @@ The package publishes the CRUD-specific authoring surface:
 
 `CrudMetadataEditorComponent` provides guided authoring tabs for:
 
-- **Connection (`resource` / `data`)**: bind remote resource paths, `idField`, `endpointKey`, or inspect-only local rows.
+- **Connection (`resource` / `data` / `pageHeader`)**: bind remote resource paths, `idField`, `endpointKey`, or inspect-only local rows, and author the executive `pageHeader` (`title`, `subtitle`, `domain.label`, `domain.icon`, `domain.tone`) consumed by `PraxisResourcePage`.
 - **Opening & Return (`defaults`)**: configure modal/drawer presentation defaults, header options, and back navigation policy.
-- **Actions (`actions`)**: configure `create`, `view`, `edit`, and `delete` open modes, form bindings, parameter mappings, and initial value seeds.
-- **KPI Band (`kpiBand`)**: enable or disable the top summary band, author KPI cards (`id`, `label`, `value`, `variant`/`tone`), bind card click filters (`none`, clear filter `{}`, field equality `{ [field]: value }`, or custom JSON criteria), and preview the rendered band live.
-- **Filter Bar (`filterBar`)**: toggle advanced filter visibility (`showAdvanced`), select inline filter fields (`inlineFields`), and configure quick filter pills (`quickFilters` with `id`, `label`, `icon`, and `filter` criteria) without editing raw JSON.
+- **Actions (`actions`)**: configure `create`, `view`, `edit`, and `delete` open modes, form bindings, parameter mappings, and initial value seeds. Action expansion panels stay open while typing (`isActionPanelOpen`) until explicitly closed or reset.
+- **KPI Band (`kpiBand`)**: enable or disable the top summary band, author KPI cards (`id`, `label`, `value`, `valueExpr`, `captionExpr`, `variant`/`tone`), bind card click filters (`none`, clear filter `{}`, field equality `{ [field]: value }`, or custom JSON criteria), and preview the rendered band live with CSP-safe arithmetic and pipe evaluation.
+- **Filter Bar (`filterBar`)**: toggle advanced filter visibility (`showAdvanced`), select inline filter fields (`inlineFields`), configure quick filter pills (`quickFilters` with `id`, `label`, `icon`, and `filter` criteria), and control `placement` (`'table-toolbar'` or `'scope-bar'`) without editing raw JSON.
 - **Table (`table`)**: embedded `<praxis-table-inline-authoring-editor>` with explicit column inheritance awareness. When `metadata.table.columns` is `[]` and the CRUD resolves columns dynamically from the bound resource schema (`effectiveTableConfig`), the editor surfaces an inheritance banner showing the resolved resource columns, forwards those columns into the inline table editor for direct inspection/customization, preserves `columns: []` when only toolbar or pagination settings change, and provides a one-click reset back to inherited resource columns after customization.
+- **Form Layout Scope & Persistence (`layoutScope?: 'shared' | 'mode-only'`)**: when customizing an inner `praxis-dynamic-form` inside a CRUD dialog or drawer (`DynamicFormDialogHostComponent`), the **Comportamento & Contexto** tab exposes the layout scope selector (`[data-testid="dynamic-form-layout-scope-toggle"]`):
+  - `'shared'` (default): structural layout edits (`sections`, `rows`, `columns`) propagate across sibling modes (`create`, `edit`, `view`) while automatically protecting any sibling mode explicitly locked with `metadata.layoutScope === 'mode-only'`.
+  - `'mode-only'`: locks the structural layout exclusively to the active mode (`create`, `edit`, or `view`), isolating it from future shared updates or resets triggered from sibling modes.
+  - Both `crud-authoring:<id>` and `praxis-form-config-<id>:<mode>` keys persist seamlessly through `ASYNC_CONFIG_STORAGE` (local `LocalStorageConfigService` or remote `ApiConfigStorage` backed by `praxis-config-starter` at `/api/praxis/config/ui` with `If-Match` / `ETag` concurrency and automatic 412 conflict retry).
 
 Use this authoring surface to edit CRUD orchestration metadata. Do not build local CRUD editors in consuming apps when the needed behavior belongs to the package contract.