react-hook-form 7.81.0 → 7.83.0

package/dist/types/watch.d.ts

@@ -13,7 +13,7 @@ export type UseWatchProps<TFieldValues extends FieldValues = FieldValues> = {
 };
 export type WatchDefaultValue<TFieldName, TFieldValues extends FieldValues = FieldValues> = TFieldName extends FieldPath<TFieldValues> ? FieldPathValue<TFieldValues, TFieldName> : DeepPartialSkipArrayKey<TFieldValues>;
 export type WatchName<TFieldValues extends FieldValues> = FieldPath<TFieldValues> | FieldPath<TFieldValues>[] | readonly FieldPath<TFieldValues>[] | undefined;
-export type WatchValue<TFieldName, TFieldValues extends FieldValues = FieldValues> = TFieldName extends FieldPath<TFieldValues>[] | readonly FieldPath<TFieldValues>[] ? FieldPathValues<TFieldValues, TFieldName> : TFieldName extends FieldPath<TFieldValues> ? FieldPathValue<TFieldValues, TFieldName> : TFieldValues;
+export type WatchValue<TFieldName, TFieldValues extends FieldValues = FieldValues> = TFieldName extends readonly FieldPath<TFieldValues>[] ? FieldPathValues<TFieldValues, TFieldName> : TFieldName extends FieldPath<TFieldValues> ? FieldPathValue<TFieldValues, TFieldName> : TFieldValues;
 export type WatchRenderValue<TFieldName, TFieldValues extends FieldValues, TComputeValue> = TComputeValue extends undefined ? WatchValue<TFieldName, TFieldValues> : TComputeValue;
 export type WatchProps<TFieldName extends WatchName<TFieldValues>, TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues, TComputeValue = undefined> = {
     control?: Control<TFieldValues, TContext, TTransformedValues>;

package/dist/types/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/types/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,MAAM,MAAM,aAAa,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IAAI;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EACD,SAAS,CAAC,YAAY,CAAC,GACvB,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,KAAK,YAAY,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,UAAU,EACV,YAAY,SAAS,WAAW,GAAG,WAAW,IAE9C,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,GACtC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,GACxC,uBAAuB,CAAC,YAAY,CAAC,CAAC;AAE5C,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,WAAW,IAClD,SAAS,CAAC,YAAY,CAAC,GACvB,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,GAClC,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,CACpB,UAAU,EACV,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,UAAU,SACV,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,GAClC,eAAe,CAAC,YAAY,EAAE,UAAU,CAAC,GACzC,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,GACxC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,GACxC,YAAY,CAAC;AAEnB,MAAM,MAAM,gBAAgB,CAC1B,UAAU,EACV,YAAY,SAAS,WAAW,EAChC,aAAa,IACX,aAAa,SAAS,SAAS,GAC/B,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,GACpC,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,CACpB,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,EAC1C,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,EACjC,aAAa,GAAG,SAAS,IACvB;IACF,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC9D;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,KAAK,aAAa,CAAC;IACzE,MAAM,EAAE,CACN,KAAK,EAAE,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,KAC7D,SAAS,GAAG,SAAS,EAAE,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/types/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,MAAM,MAAM,aAAa,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IAAI;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EACD,SAAS,CAAC,YAAY,CAAC,GACvB,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,KAAK,YAAY,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,UAAU,EACV,YAAY,SAAS,WAAW,GAAG,WAAW,IAE9C,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,GACtC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,GACxC,uBAAuB,CAAC,YAAY,CAAC,CAAC;AAE5C,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,WAAW,IAClD,SAAS,CAAC,YAAY,CAAC,GACvB,SAAS,CAAC,YAAY,CAAC,EAAE,GACzB,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,GAClC,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,CACpB,UAAU,EACV,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,UAAU,SAAS,SAAS,SAAS,CAAC,YAAY,CAAC,EAAE,GACrD,eAAe,CAAC,YAAY,EAAE,UAAU,CAAC,GACzC,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,GACxC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,GACxC,YAAY,CAAC;AAEnB,MAAM,MAAM,gBAAgB,CAC1B,UAAU,EACV,YAAY,SAAS,WAAW,EAChC,aAAa,IACX,aAAa,SAAS,SAAS,GAC/B,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,GACpC,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,CACpB,UAAU,SAAS,SAAS,CAAC,YAAY,CAAC,EAC1C,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,EACjC,aAAa,GAAG,SAAS,IACvB;IACF,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC9D;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,KAAK,aAAa,CAAC;IACzE,MAAM,EAAE,CACN,KAAK,EAAE,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,KAC7D,SAAS,GAAG,SAAS,EAAE,CAAC;CAC9B,CAAC"}

package/dist/useFormContext.d.ts

@@ -61,5 +61,5 @@ export declare const useFormContext: <TFieldValues extends FieldValues, TContext
  * }
  * ```
  */
-export declare const FormProvider: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, handleSubmit, unregister, control, register, setFocus, subscribe, }: FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+export declare const FormProvider: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
 //# sourceMappingURL=useFormContext.d.ts.map

package/dist/useFormContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormContext.d.ts","sourceRoot":"","sources":["../src/useFormContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACd,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,SAAS,WAAW,EAChC,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,OAC9B,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAK1D,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY,GACvB,YAAY,SAAS,WAAW,EAChC,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,EACjC,qMAmBC,iBAAiB,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,sBAiD/D,CAAC"}
+{"version":3,"file":"useFormContext.d.ts","sourceRoot":"","sources":["../src/useFormContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACd,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,SAAS,WAAW,EAChC,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,OAC9B,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAK1D,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY,GACvB,YAAY,SAAS,WAAW,EAChC,QAAQ,GAAG,GAAG,EACd,kBAAkB,GAAG,YAAY,EACjC,yNAoBC,iBAAiB,CAAC,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,sBAqD/D,CAAC"}

package/dist/useFormState.d.ts

@@ -1,11 +1,11 @@
 import type { FieldValues, UseFormStateProps, UseFormStateReturn } from './types';
 /**
- * This custom hook allows you to subscribe to each form state, and isolate the re-render at the custom hook level. It has its scope in terms of form state subscription, so it would not affect other useFormState and useForm. Using this hook can reduce the re-render impact on large and complex form application.
+ * Subscribes to each form state and isolates re-renders at the custom hook level. It has its own scope for form state subscriptions, so it will not affect other useFormState or useForm instances. Using this hook can reduce the re-render impact on large and complex form applications.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useformstate) • [Demo](https://codesandbox.io/s/useformstate-75xly)
  *
- * @param props - include options on specify fields to subscribe. {@link UseFormStateReturn}
+ * @param props - Include options to specify fields to subscribe to. {@link UseFormStateReturn}
  *
  * @example
  * ```tsx

package/dist/useWatch.d.ts

@@ -1,12 +1,12 @@
 import type { Control, DeepPartialSkipArrayKey, FieldPath, FieldPathValue, FieldPathValues, FieldValues } from './types';
 /**
- * Subscribe to the entire form values change and re-render at the hook level.
+ * Subscribes to all form value changes and re-renders at the hook level.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-usewatch-h9i5e)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -29,13 +29,13 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute?: undefined;
 }): DeepPartialSkipArrayKey<TFieldValues>;
 /**
- * Custom hook to subscribe to field change and isolate re-rendering at the component level.
+ * Custom hook to subscribe to field changes and isolate re-rendering at the component level.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-usewatch-h9i5e)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -57,13 +57,13 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute?: undefined;
 }): FieldPathValue<TFieldValues, TFieldName>;
 /**
- * Custom hook to subscribe to field change and compute function to produce state update
+ * Custom hook to subscribe to field changes and use a compute function to produce state updates.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -83,13 +83,13 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute: (formValues: TFieldValues) => TComputeValue;
 }): TComputeValue;
 /**
- * Custom hook to subscribe to field change and compute function to produce state update
+ * Custom hook to subscribe to field changes and use a compute function to produce state updates.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -112,13 +112,13 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute: (fieldValue: FieldPathValue<TFieldValues, TFieldName>) => TComputeValue;
 }): TComputeValue;
 /**
- * Custom hook to subscribe to field change and isolate re-rendering at the component level.
+ * Custom hook to subscribe to field changes and isolate re-rendering at the component level.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-usewatch-h9i5e)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -143,13 +143,13 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute?: undefined;
 }): FieldPathValues<TFieldValues, TFieldNames>;
 /**
- * Custom hook to subscribe to field change and compute function to produce state update
+ * Custom hook to subscribe to field changes and use a compute function to produce state updates.
  *
  * @remarks
  *
  * [API](https://react-hook-form.com/docs/usewatch)
  *
- * @param props - defaultValue, disable subscription and match exact name.
+ * @param props - DefaultValue, disabled subscription, and exact name matching.
  *
  * @example
  * ```tsx
@@ -175,7 +175,7 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
     compute: (fieldValue: FieldPathValues<TFieldValues, TFieldNames>) => TComputeValue;
 }): TComputeValue;
 /**
- * Custom hook to subscribe to field change and isolate re-rendering at the component level.
+ * Custom hook to subscribe to field changes and isolate re-rendering at the component level.
  *
  * @remarks
  *
@@ -183,7 +183,7 @@ export declare function useWatch<TFieldValues extends FieldValues = FieldValues,
  *
  * @example
  * ```tsx
- * // can skip passing down the control into useWatch if the form is wrapped with the FormProvider
+ * // Can skip passing down the control into useWatch if the form is wrapped with FormProvider
  * const values = useWatch()
  * ```
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-hook-form",
   "description": "Performant, flexible and extensible forms library for React Hooks",
-  "version": "7.81.0",
+  "version": "7.83.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.mjs",
   "umd:main": "dist/index.umd.js",
@@ -44,15 +44,15 @@
     "test:type": "tsc -p src/__typetest__/tsconfig.json",
     "bench": "tsx scripts/bench.ts",
     "bench:compare": "tsx scripts/bench-compare.ts",
-    "e2e": "cypress run",
-    "e2e:watch": "cypress open",
+    "e2e": "playwright test",
+    "e2e:watch": "playwright test --ui",
     "api-extractor": "api-extractor run --local",
     "api-extractor:build": "pnpm build:esm && pnpm api-extractor",
     "api-extractor:ci": "node scripts/apiExtractor.js",
     "postversion": "git push && git push origin v$npm_package_version",
     "prepublishOnly": "pnpm install && pnpm lint:fix && pnpm type && pnpm test && pnpm build",
     "bundlewatch": "pnpm build:modern && bundlewatch",
-    "start": "pnpm build:esm && pnpm --dir ./app install && pnpm --dir ./app run dev",
+    "start": "pnpm build:esm && cd ./app && pnpm install && pnpm run dev",
     "csb:install": "npm i -g pnpm@8 && pnpm i"
   },
   "keywords": [
@@ -75,6 +75,7 @@
   "devDependencies": {
     "@eslint/compat": "^1.4.1",
     "@microsoft/api-extractor": "^7.58.9",
+    "@playwright/test": "^1.61.1",
     "@rollup/plugin-commonjs": "^28.0.9",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^0.4.4",
@@ -87,10 +88,9 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "bundlewatch": "^0.4.2",
-    "cypress": "^15.17.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-cypress": "^5.4.0",
+    "eslint-plugin-playwright": "^2.10.5",
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
@@ -118,7 +118,7 @@
     "files": [
       {
         "path": "./dist/index.cjs.js",
-        "maxSize": "12.6 kB"
+        "maxSize": "14.0 kB"
       }
     ]
   },