@bolttech/form-engine 3.1.1-beta.3 → 3.1.1

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## [3.1.1] - 2025-06-19
+
+### Bug Fixes
+
+- **onFormMount infinite loop**: Fixed an issue where `onFormMount` would fire repeatedly when the parent component re-renders with new callback references (e.g. Builder.io symbol rehydration). A `formMountHasRunRef` guard now ensures the callback executes exactly once per form lifecycle, preventing the setState → rerender → re-subscribe → re-fire loop.
+- **onFormMount condition check**: Fixed incorrect condition in `mountCallback` that checked `formValuesCallbackRefs.current.onMount` (field-level prop) instead of `formValuesCallbackRefs.current.onFormMount` (form-level prop), causing `onFormMount` to never fire.
+
+### Notes
+
+- Field-level `onMount` (via `ON_FIELD_MOUNT` event) remains **unguarded** — it continues to fire every time a field becomes visible through visibility conditions, preserving the expected behavior for conditional fields.
+
+## [3.1.0] - 2025-06-02
+
+### Features
+
+- **SSR support**: Form instances are now created synchronously during render via `useMemo`, allowing the component tree to produce meaningful HTML on the server
+- **`prefetchedData` prop**: Pass pre-fetched API data to `<Form />` so fields with API configurations have their response caches populated before mount
+- **`iVars` and `initialValues` at creation time**: These are now passed during form instance creation (not just in `useEffect`), making them available for the `FormCore` constructor during SSR
+- **Package metadata**: Added `"sideEffects": false` and `"exports"` field for proper tree-shaking and RSC compatibility
+- **Test infrastructure**: Added Jest configuration and SSR test suite (12 tests)
+
+### How SSR works
+
+During server render, the `<Form />` component creates the `FormCore` instance synchronously in `useMemo`. Fields are registered when `AsFormFieldBuilder` mounts on the client via `useEffect`. Static props (non-template) render immediately; template props are stripped by `filterProps` and resolve after hydration when `refreshTemplates` runs.
+
+### What renders during SSR
+
+| Content | SSR behavior |
+|---------|-------------|
+| Form structure (`<form>`) | ✅ Rendered |
+| Static props (label, placeholder) | ✅ Rendered |
+| Template props (`${iVars.*}`) | Stripped, resolved after hydration |
+| `visibility: false` fields | ✅ Correctly hidden |
+| Field interactivity | Activates after hydration |