Modes, placement, and navigation

Interaction mode

Set mode="edit" or mode="readonly". Read-only forms can expose an edit toggle with allowReadOnlyEditToggle; use readOnlyEditToggleDisabledReason when the host application must explain why editing is unavailable.

showPrimaryActionsInViewMode controls whether disabled primary actions remain visible in view mode.

Placement

formPlacement accepts:

• form-page for normal page content;
• form-modal for modal presentation;
• form-spotlight for a drawer or spotlight presentation.

For overlays, provide onRequestClose. autoCloseOverlayOnSubmit closes the overlay after a successful synchronous submission or after the returned submission promise resolves. Discard confirmation includes renderer changes and externalDirty.

Layout and navigation

• labelPosition accepts top or side.
• labelWidthPercent controls the label column in side layout.
• formWidth accepts a CSS width value.
• forceShowNavigationPanel keeps section navigation visible when it would normally collapse.
• simplifiedMode presents one field at a time; onSimplifiedNavigation observes movement.

Sections, repeatable entries, validation navigation, focus handling, and keyboard actions are managed by FormRenderer. Keep conditional behavior in the schema rather than duplicating it in React state.