@rachelallyson/hero-hook-form 2.8.0 → 2.9.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.9.0] - 2026-01-22
+
+### Added
+
+- **Documentation: Memory-Safe Forms Guide**: Comprehensive guide for preventing Cypress memory leaks
+  - Complete migration guide from problematic to memory-safe conditional field arrays
+  - Working code examples and best practices
+  - Troubleshooting section for memory issues
+  - Performance optimization recommendations
+
+- **Examples: Question Form Demo**: Working demonstration of memory-safe conditional field arrays
+  - Interactive example showing MULTIPLE_CHOICE question types
+  - Before/after code comparisons
+  - Real-world implementation patterns
+  - Cypress e2e test coverage
+
+- **Enhanced Testing**: Additional test coverage and refinements
+  - Question form e2e tests demonstrating memory safety
+  - Updated Cypress test patterns for memory optimization
+  - Comprehensive validation of conditional field array behavior
+
+### Fixed
+
+- **Test File Naming**: Corrected Cypress test file extensions (`.cy.ts` vs `.spec.ts`)
+- **Conditional Rendering**: Improved formatting and error handling in conditional field components
+
 ## [2.8.0] - 2026-01-22
 
 ### Added

package/dist/index.js

@@ -400,22 +400,30 @@ function ConditionalField({
   const form = useFormContext();
   const formValues = useWatch({ control });
   const shouldShow = condition(formValues);
-  if (!shouldShow) {
+  const isAlwaysRegisteredFieldArray = field2 && typeof field2 === "object" && "type" in field2 && field2.type === "fieldArray" && "alwaysRegistered" in field2 && field2.alwaysRegistered === true;
+  if (!shouldShow && !isAlwaysRegisteredFieldArray) {
     return null;
   }
-  return /* @__PURE__ */ React5.createElement("div", { className }, /* @__PURE__ */ React5.createElement(
-    FormField,
+  return /* @__PURE__ */ React5.createElement(
+    "div",
     {
-      config: field2,
-      form,
-      submissionState: {
-        error: void 0,
-        isSubmitted: false,
-        isSubmitting: false,
-        isSuccess: false
+      className,
+      style: !shouldShow && isAlwaysRegisteredFieldArray ? { display: "none" } : void 0
+    },
+    /* @__PURE__ */ React5.createElement(
+      FormField,
+      {
+        config: field2,
+        form,
+        submissionState: {
+          error: void 0,
+          isSubmitted: false,
+          isSubmitting: false,
+          isSuccess: false
+        }
       }
-    }
-  ));
+    )
+  );
 }
 
 // src/fields/ContentField.tsx
@@ -1363,8 +1371,13 @@ function FormFieldComponent({
       );
     }
   }
+  let shouldRenderConditionalField = true;
   if ("condition" in fieldConfig && fieldConfig.condition && !fieldConfig.condition(watchedValues)) {
-    return null;
+    if ("field" in fieldConfig && fieldConfig.field && typeof fieldConfig.field === "object" && "type" in fieldConfig.field && fieldConfig.field.type === "fieldArray" && "alwaysRegistered" in fieldConfig.field && fieldConfig.field.alwaysRegistered === true) {
+      shouldRenderConditionalField = true;
+    } else {
+      return null;
+    }
   }
   if ("dependsOn" in fieldConfig && fieldConfig.dependsOn) {
     const dependentValue = get(watchedValues, fieldConfig.dependsOn);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rachelallyson/hero-hook-form",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Typed form helpers that combine React Hook Form and HeroUI components.",
   "author": "Rachel Higley",
   "homepage": "https://rachelallyson.github.io/hero-hook-form/",