@rachelallyson/hero-hook-form 2.14.0 → 2.15.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.15.0] - 2026-02-02
+
+### Added
+
+- **ConfigProvider: autocomplete defaults** – `HeroHookFormDefaultsConfig` and `useHeroHookFormDefaults()` support `defaults.autocomplete`. `AutocompleteField` spreads these defaults so Autocomplete respects the same global styling (color, size, variant, radius, labelPlacement) as Input, Textarea, and Select when using `HeroHookFormProvider`.
+- **createFieldArrayCustomConfig: readOnly** – New `readOnly?: boolean` option. When true, the add button (and empty-state add block) is not rendered. `readOnly` is passed into each item’s props so custom `renderItem` / `getItemFieldConfig` can hide remove/reorder controls. Use instead of `renderAddButton: () => null` for display-only arrays.
+
+### Fixed
+
+- **ServerActionForm autocomplete options** – `AutocompleteItem` for autocomplete fields now receives `textValue={item.label ?? String(item.value)}` so options have a stable plain-text value for accessibility, type-to-select, and Cypress/automation even when using custom `renderItem`.
+
+### Changed
+
+- **AutocompleteField** – Uses `useHeroHookFormDefaults()` and spreads `defaults.autocomplete` so the control picks up provider styling (e.g. `HeroHookFormProvider` with `defaults.common` or `defaults.autocomplete`).
+- **Example: Custom Field Array Demo** – Uses `readOnly: true` instead of `renderAddButton: () => null`. E2E test added to assert “Add Item” is not shown when readOnly is true.
+
 ## [2.14.0] - 2026-01-29
 
 ### Added

package/dist/index.d.ts

@@ -4237,6 +4237,8 @@ interface FieldArrayItemRenderProps<TFieldValues extends FieldValues, TArrayPath
     onMoveUp: () => void;
     onMoveDown: () => void;
     onRemove: () => void;
+    /** When true, add/remove/reorder are hidden; use to hide your own buttons */
+    readOnly?: boolean;
 }
 /**
  * Options for creating a custom field array config
@@ -4270,6 +4272,8 @@ interface CreateFieldArrayCustomConfigOptions<TFieldValues extends FieldValues>
     max?: number;
     /** Enable reordering of array items */
     enableReordering?: boolean;
+    /** When true, no add button is shown; readOnly is passed to renderItem/getItemFieldConfig so you can hide remove/reorder */
+    readOnly?: boolean;
     /** Optional className */
     className?: string;
 }

package/dist/index.js

@@ -231,8 +231,14 @@ function useHeroHookFormDefaults() {
     size: "md",
     variant: "bordered"
   };
+  const autocompleteBase = {
+    radius: "md",
+    size: "md",
+    variant: "bordered"
+  };
   return {
     autocomplete: {
+      ...autocompleteBase,
       ...commonAutocomplete,
       ...cfg.autocomplete ?? {}
     },
@@ -486,11 +492,16 @@ function AutocompleteField(props) {
           { isDisabled, label },
           { allowsCustomValue }
         );
+        const autocompleteMerged = { ...defaults.autocomplete };
+        for (const [key, value] of Object.entries(rest)) {
+          if (value !== void 0) {
+            autocompleteMerged[key] = value;
+          }
+        }
         return /* @__PURE__ */ React2.createElement("div", { className }, /* @__PURE__ */ React2.createElement(
           Autocomplete,
           {
-            ...defaults.autocomplete,
-            ...rest,
+            ...autocompleteMerged,
             ...defaultItems && {
               defaultItems
             },
@@ -3193,7 +3204,14 @@ function ServerActionField({
           onInputChange: setValue,
           items
         },
-        items.map((item) => /* @__PURE__ */ React21.createElement(AutocompleteItem, { key: String(item.value) }, typeof stringConfig.renderItem === "function" ? stringConfig.renderItem(item) : item.label))
+        items.map((item) => /* @__PURE__ */ React21.createElement(
+          AutocompleteItem,
+          {
+            key: String(item.value),
+            textValue: item.label ?? String(item.value)
+          },
+          typeof stringConfig.renderItem === "function" ? stringConfig.renderItem(item) : item.label
+        ))
       );
     }
     case "slider": {
@@ -5823,6 +5841,7 @@ function createFieldArrayCustomConfig(options) {
     max = 10,
     min = 0,
     name,
+    readOnly = false,
     renderAddButton,
     renderItem
   } = options;
@@ -5885,7 +5904,8 @@ function createFieldArrayCustomConfig(options) {
         index,
         onMoveDown: () => handleMoveDown(index),
         onMoveUp: () => handleMoveUp(index),
-        onRemove: () => handleRemove(index)
+        onRemove: () => handleRemove(index),
+        readOnly
       });
       return /* @__PURE__ */ React27.createElement("div", { className }, /* @__PURE__ */ React27.createElement("div", { className: "space-y-4" }, fields.map((field2, index) => {
         if (getItemFieldConfig) {
@@ -5902,7 +5922,7 @@ function createFieldArrayCustomConfig(options) {
           );
         }
         return /* @__PURE__ */ React27.createElement(React27.Fragment, { key: field2.id }, renderItem(itemProps(index)));
-      }), fields.length === 0 && renderAddButton ? /* @__PURE__ */ React27.createElement("div", { className: "text-center py-8 text-gray-500" }, /* @__PURE__ */ React27.createElement("p", null, "No ", label?.toLowerCase() || "items", " added yet."), renderAddButton({ canAdd, onAdd: handleAdd })) : null, fields.length > 0 && renderAddButton ? renderAddButton({ canAdd, onAdd: handleAdd }) : canAdd && /* @__PURE__ */ React27.createElement(
+      }), !readOnly && fields.length === 0 && renderAddButton ? /* @__PURE__ */ React27.createElement("div", { className: "text-center py-8 text-gray-500" }, /* @__PURE__ */ React27.createElement("p", null, "No ", label?.toLowerCase() || "items", " added yet."), renderAddButton({ canAdd, onAdd: handleAdd })) : null, !readOnly && (fields.length > 0 && renderAddButton ? renderAddButton({ canAdd, onAdd: handleAdd }) : canAdd && /* @__PURE__ */ React27.createElement(
         Button6,
         {
           variant: "bordered",
@@ -5910,7 +5930,7 @@ function createFieldArrayCustomConfig(options) {
           className: "w-full"
         },
         "Add Item"
-      )));
+      ))));
     },
     type: "custom"
   };

package/package.json

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