@dmitryvim/form-builder 0.5.4 → 0.7.0

package/README.md

@@ -322,7 +322,7 @@ If you are stuck on a browser without `ResizeObserver` (very old) and cannot def
 - **Text**: Single-line with pattern validation, length limits
 - **Textarea**: Multi-line with configurable rows
 - **Number**: Numeric input with min/max/step/decimals (no `decimals` → value is kept as typed; set `decimals` to round on extraction)
-- **Select**: Dropdown with options and default values
+- **Select**: Dropdown with options and default values. Renders a leading empty option (label: `placeholder` or a localized "Select…"); with no selection the field extracts as `null`, and `required` fails until an option is chosen (v0.6.0)
 - **Switcher**: Segmented button group (all options visible, ≤4) — same data model as Select
 - **Colour**: Colour picker with hex values (single or palette)
 - **Slider**: Range slider with linear/exponential scales (v0.2.7+)
@@ -389,6 +389,12 @@ const form = createFormBuilder({
   // v0.2.4: Verbose error logging
   verboseErrors?: boolean, // Default: false (memory leak warnings, validation details)
 
+  // v0.6.0: postMessage opt-in for submitForm()/saveDraft().
+  // null (default) = never post. Set the parent frame's origin — or "*" to
+  // knowingly broadcast — to receive {type: "formSubmit"|"formDraft", data, schema}
+  // messages on window.parent. (Before 0.6.0 the library always broadcast with "*".)
+  postMessageTarget?: string | null,
+
   // v0.2.0: CSS theming
   theme?: {
     primaryColor?: string,
@@ -402,9 +408,14 @@ const form = createFormBuilder({
 // Render form
 form.renderForm(rootElement, schema, prefillData);
 
-// Get form data
+// Get form data — a silent read, safe to poll (v0.7.0: never paints errors)
 const result = form.getFormData(); // { valid, errors, data }
 
+// v0.7.0: on the submit click, paint every error next to its field ...
+const checked = form.showErrors(); // same { valid, errors, data }
+// ... and scroll to / focus the first one (does not validate itself)
+if (!checked.valid) form.focusFirstError(); // returns false when nothing is marked
+
 // v0.2.0: Update data without re-rendering
 form.setFormData({ name: 'John', email: 'john@example.com' });
 form.updateField('email', 'newemail@example.com');