@praxisui/dynamic-form 9.0.4-rc.8 → 9.0.4

package/README.md

@@ -132,6 +132,20 @@ the runtime fails initialization instead of rendering a form from the wrong busi
 non-layout host/persisted concerns such as `actions`, `api`, `messages`, rules, hooks and rich
 blocks. Host-provided non-layout config has precedence over persisted config.
 
+For nested commands, `layoutPolicy.groupedCommand.contextFields` identifies request fields whose
+values are supplied by the surrounding surface (for example, the employee id inherited by a
+related-resource drawer). These fields remain schema-backed controls in the runtime form and are
+included in the submit payload, but are omitted from the interactive layout. The host must hydrate
+them through `initialValue` on create or through the entity read on edit; this policy must not hide
+values that the user is expected to choose.
+
+For generated command rows with two or more fields, the default
+`layoutPolicy.groupedCommand.partialRowStrategy = "preserve"` keeps published spans unchanged.
+Use `"fill-compatible"` when eligible controls should absorb the remaining 12-column space at
+each container breakpoint (for example, `4 + 4` projects to `6 + 6`). This is a transient runtime
+projection: schema `x-ui.width`, generated `sections` and authoring documents are not rewritten.
+Compact boolean/action controls, uploads and unknown control types remain at their canonical span.
+
 When `mode="view"` and the host does not provide `presentationModeGlobal`, a schema policy with
 `intent: "detail"` or `preset: "compactPresentation"` also enables presentation rendering. Hosts
 that need traditional disabled controls for the same schema can pass `[presentationModeGlobal]="false"`.
@@ -208,6 +222,7 @@ Recommended defaults:
 - detail/read-only: `layoutPolicy.source = "schema"`, `intent = "detail"`, `preset = "compactPresentation"`, `persistence = "transient"` and a response schema;
 - create/edit: `layoutPolicy.source = "schema"`, `intent = "command"`, `preset = "groupedCommand"`, `persistence = "transient"` and a request schema;
 - `groupedCommand` expands a single orphan `md`/`lg` field to the full row by default. Set `layoutPolicy.groupedCommand.orphanFieldExpansion = "preserve"` for intentionally compact rows, or `"all"` to expand orphan `xs`/`sm` fields too;
+- `layoutPolicy.groupedCommand.partialRowStrategy = "fill-compatible"` projects eligible partial rows to the canonical 12-column grid per container breakpoint, while the default `"preserve"` retains intentional whitespace;
 - dense command drawers: `helpPresentation.display = "auto"` with popover preference for select, checkbox, toggle, date and numeric controls;
 - operational input-heavy forms: `fieldIconPolicy = "presentation-only"` unless the icon is part of the actual affordance.
 
@@ -251,6 +266,11 @@ Common inputs:
 - `domainRules`
 - `editorialContext`
 
+In `edit` and `view`, `resourceId` identifies the remote entity to hydrate. In
+`create`, it is contextual only (for example, the employee targeted by an
+item-scoped command) and never starts an entity read; provide command defaults
+through `initialValue`.
+
 Common outputs:
 
 - `formSubmit`, `formCancel`, `formReset`