Values, snapshots, and submission
Initial state and restoration
Use initialValues for an ordinary record seed. overrideValues take precedence and suit
authoritative host values. For complete restoration, prefer initialSnapshot:
Code
The snapshot keeps raw values, nested repeatable entries, and timestamps together:
Code
onSnapshotChange(snapshot, meta) first reports { kind: "seed", dirty: false }; later user
changes use { kind: "change", dirty }.
Save drafts or submit records
Set primaryActionMode="save" and provide onSave(snapshot, meta) for a validation-tolerant draft
action. meta contains the current validation summary and dirty state.
The default submit action validates first. onSubmit(record, meta) receives the structured record
described in Output and records, plus raw values, repeatable state,
timestamps, and the validation summary.
The binding does not persist or synchronize either payload. Store snapshots locally, upload records, retry failures, and resolve conflicts in the host application.