@dmitryvim/form-builder 0.3.1 → 0.3.2

package/README.md

@@ -289,6 +289,32 @@ Download and serve the `dist/` folder contents.
 
 See [Integration Guide](docs/integration.md) for detailed setup instructions.
 
+## Hosting Requirements
+
+### Mounting inside hidden or deferred-layout containers
+
+`text` and `textarea` (with `autoExpand: true`) fields measure their content height on mount to set an initial size. If the host mounts the form inside a container that has **no real layout at that moment** — e.g. `display: none`, `visibility: hidden`, `width: 0`, an inactive tab, a collapsed accordion, a not-yet-opened modal — the initial measurement reads `scrollHeight === 0` and the textarea would otherwise collapse to its borders (~2 px).
+
+**Since v0.3.2 the library recovers automatically**: a width-keyed `ResizeObserver` is attached to every auto-expanding textarea and re-runs the height calculation when the host reveals the container (width transitions `0 → real`) or resizes its column.
+
+You still get the smoothest UX by mounting the form **after** the container has its final layout. Two reliable patterns:
+
+```javascript
+// Pattern A — mount on tab/modal open, not on page load
+modal.addEventListener("shown", () => {
+  formBuilder.renderForm(rootElement, schema, prefill);
+});
+
+// Pattern B — already mounted? Force a re-measure by re-applying prefill.
+//             Each updateField call dispatches an `input` event that re-runs
+//             the height calculation, even outside of ResizeObserver support.
+panel.addEventListener("visible", () => {
+  formBuilder.setFormData(currentValues);
+});
+```
+
+If you are stuck on a browser without `ResizeObserver` (very old) and cannot defer mounting, calling `formBuilder.setFormData(...)` once the form becomes visible is the supported workaround — it triggers a fresh measurement of every text/textarea field.
+
 ## Complete Feature Set
 
 ### Field Types
@@ -848,12 +874,12 @@ A display-only element that renders markdown as safe HTML. It never appears in `
 
 **Properties:**
 
-| Property    | Type     | Required | Description                                              |
-| ----------- | -------- | -------- | -------------------------------------------------------- |
-| `type`      | `string` | Yes      | Must be `"markdown"`                                     |
-| `content`   | `string` | Yes      | Markdown source text                                     |
-| `key`       | `string` | No       | Optional identifier; field never contributes to form data |
-| `enableIf`  | object   | No       | Conditional visibility (same as other field types)       |
+| Property   | Type     | Required | Description                                               |
+| ---------- | -------- | -------- | --------------------------------------------------------- |
+| `type`     | `string` | Yes      | Must be `"markdown"`                                      |
+| `content`  | `string` | Yes      | Markdown source text                                      |
+| `key`      | `string` | No       | Optional identifier; field never contributes to form data |
+| `enableIf` | object   | No       | Conditional visibility (same as other field types)        |
 
 **Supported markdown syntax:**