rename auto to field

README.md

@@ -22,9 +22,9 @@ npm i formhero
 
 ### 👁 Demos
 
-- [__*Live Web*__](https://cupcakearmy.github.io/formhero/)
+- [**_Live Web_**](https://cupcakearmy.github.io/formhero/)
-- [__*Live Codesandbox*__](https://codesandbox.io/embed/formhero-simple-bdcx2?expanddevtools=1&fontsize=14)
+- [**_Live Codesandbox_**](https://codesandbox.io/embed/formhero-simple-bdcx2?expanddevtools=1&fontsize=14)
-- [__*Live React-Native*__](https://snack.expo.io/@cupcakearmy/useform)
+- [**_Live React-Native_**](https://snack.expo.io/@cupcakearmy/useform)
 
 ### Links
 
@@ -35,7 +35,7 @@ npm i formhero
     - [Validators](#validators)
     - [Options](#options)
   - Returns
-    - [auto](#auto)
+    - [field](#field)
     - [form](#form)
     - [errors](#errors)
     - [isValid](#isvalid)
@@ -54,8 +54,7 @@ import ReactDOM from 'react-dom'
 import { useForm } from 'formhero'
 
 const Form = () => {
-
+  const { field, form } = useForm({
-  const { auto, form } = useForm({
     username: '',
     password: '',
   })
@@ -68,9 +67,8 @@ const Form = () => {
   return (
     <div>
       <form onSubmit={_submit}>
-        
+        <input {...field('username')} />
-        <input {...auto('username')} />
+        <input {...field('password')} />
-        <input {...auto('password')} />
 
         <button type="submit">Go 🚀</button>
       </form>
@@ -85,12 +83,13 @@ const Form = () => {
 
 ```typescript
 const Form = () => {
-
+  const { field, form, errors } = useForm(
-  const { auto, form, errors } = useForm({
+    {
       username: '',
       email: '',
-    password: ''
+      password: '',
-  }, {
+    },
+    {
       username: value => value.length > 3,
       email: {
         validator: /@/,
@@ -99,29 +98,28 @@ const Form = () => {
       password: [
         {
           validator: /[A-Z]/,
-        message: 'Must contain an uppercase letter'
+          message: 'Must contain an uppercase letter',
         },
         {
           validator: /[\d]/,
-        message: 'Must contain a digit'
+          message: 'Must contain a digit',
         },
-    ]
+      ],
-  })
+    }
+  )
 
   return (
     <form>
-
       <h1>Errors & Validation</h1>
 
-      <input {...auto('username')} placeholder="Username" />
+      <input {...field('username')} placeholder="Username" />
       {errors.username && 'Must be longer than 3'}
 
-      <input {...auto('email')} placeholder="EMail" />
+      <input {...field('email')} placeholder="EMail" />
       {errors.email}
 
-      <input {...auto('password')} placeholder="Password" type="password" />
+      <input {...field('password')} placeholder="Password" type="password" />
       {errors.password}
-
     </form>
   )
 }
@@ -133,30 +131,32 @@ Often it happens that you use a specific input or framework, so the default gett
 
 ```typescript
 const Form = () => {
-
+  const { field, form, errors } = useForm({
-  const { auto, form, errors } = useForm({
     awesome: true,
   })
 
   return (
-    <form onSubmit={e => {
+    <form
+      onSubmit={e => {
         e.preventDefault()
         console.log(form)
-    }}>
+      }}
-
+    >
       <h1>Custom</h1>
 
       <label>
-        <input type="checkbox" {...auto('awesome', {
+        <input
+          type="checkbox"
+          {...field('awesome', {
             setter: 'checked',
             getter: 'onChange',
-          extractor: (e) => e.target.checked
+            extractor: e => e.target.checked,
-        })} />
+          })}
+        />
         Is it awesome?
       </label>
 
       <input type="submit" />
-
     </form>
   )
 }
@@ -167,7 +167,7 @@ const Form = () => {
 ### `useForm`
 
 ```typescript
-const {auto, errors, update, form, isValid} = useForm(initial, validators, options)
+const { field, errors, update, form, isValid } = useForm(initial, validators, options)
 ```
 
 ### Initial
@@ -213,7 +213,7 @@ const validators = {
   username: {
     validator: /^[A-z]*$/,
     message: 'My custom error message',
-  }
+  },
 }
 ```
 
@@ -227,12 +227,12 @@ const validators = {
       message: 'My custom error message',
     },
     /[\d]/,
-    async (value) => value.length > 0,
+    async value => value.length > 0,
     {
-      validator: (value) => true,
+      validator: value => true,
       message: 'Some other error',
-    }
+    },
-  ]
+  ],
 }
 ```
 
@@ -245,33 +245,30 @@ Sometimes it's practical to have some different default values when using for ex
 [Check the Expo Snack for a live preview](https://snack.expo.io/@cupcakearmy/useform)
 
 ```javascript
-import * as React from 'react';
+import * as React from 'react'
-import { Text, SafeAreaView, TextInput } from 'react-native';
+import { Text, SafeAreaView, TextInput } from 'react-native'
-import { useForm } from 'formhero';
+import { useForm } from 'formhero'
 
 const initial = {
   username: 'i am all lowercase',
-};
+}
-const validators = {};
+const validators = {}
 const options = {
   setter: 'value', // This is not stricly necessarry as 'value' would already be the default.
   getter: 'onChangeText',
   extractor: text => text.toLowerCase(),
-};
+}
 
 export default () => {
-  const { form, auto } = useForm(initial, validators, options);
+  const { form, field } = useForm(initial, validators, options)
 
   return (
     <SafeAreaView>
-      <TextInput
+      <TextInput style={{ height: 40, borderColor: 'gray', borderWidth: 2 }} {...field('username')} />
-        style={{ height: 40, borderColor: 'gray', borderWidth: 2 }}
-        {...auto('username')}
-      />
       <Text>{form.username}</Text>
     </SafeAreaView>
-  );
+  )
-};
+}
 ```
 
 ###### Example: React Native (Method 2 - Local overwrite)
@@ -280,15 +277,15 @@ export default () => {
 // ...
 
 export default () => {
-  const { form, auto } = useForm({
+  const { form, field } = useForm({
     username: 'i am all lowercase',
-  });
+  })
 
   return (
     <SafeAreaView>
       <TextInput
         style={{ height: 40, borderColor: 'gray', borderWidth: 2 }}
-        {...auto('username', {
+        {...field('username', {
           setter: 'value', // This is not stricly necessarry as 'value' would already be the default.
           getter: 'onChangeText',
           extractor: text => text.toLowerCase(),
@@ -296,33 +293,30 @@ export default () => {
       />
       <Text>{form.username}</Text>
     </SafeAreaView>
-  );
+  )
-};
+}
-
 ```
 
-### Auto
+### field
-
-The `auto` object is used to bind the form state to the input.
 
+The `field` object is used to bind the form state to the input.
 
 ###### Example: Simple
 
 ```javascript
-const { auto } = useForm()
+const { field } = useForm()
 
-<input {...auto('username')} />
+<input {...field('username')} />
 ```
 
-
 ###### Example: With custom options
 
 All are optional.
 
 ```javascript
-const { auto } = useForm()
+const { field } = useForm()
 
-<input {...auto('username', {
+<input {...field('username', {
   getter: 'onChage',
   setter: 'value',
   extractor: (e) => e.target.value

examples/custom.tsx

@@ -4,30 +4,32 @@ import ReactDOM from 'react-dom'
 import { useForm } from '../dist'
 
 const Index: React.FC = () => {
-
+  const { field, form, errors } = useForm({
-	const { auto, form, errors } = useForm({
     awesome: true,
   })
 
   return (
-		<form onSubmit={e => {
+    <form
+      onSubmit={e => {
         e.preventDefault()
         console.log(form)
-		}}>
+      }}
-
+    >
       <h1>Custom</h1>
 
       <label>
-				<input type="checkbox" {...auto('awesome', {
+        <input
+          type="checkbox"
+          {...field('awesome', {
             setter: 'checked',
             getter: 'onChange',
-					extractor: (e) => e.target.checked
+            extractor: e => e.target.checked,
-				})} />
+          })}
+        />
         Is it awesome?
       </label>
 
       <input type="submit" />
-
     </form>
   )
 }

examples/errorsAndValidation.tsx

@@ -4,12 +4,13 @@ import ReactDOM from 'react-dom'
 import { useForm } from '../'
 
 const Index: React.FC = () => {
-
+  const { field, form, errors, isValid } = useForm(
-	const { auto, form, errors, isValid } = useForm({
+    {
       username: '',
       email: '',
-		password: ''
+      password: '',
-	}, {
+    },
+    {
       username: value => value.length > 3,
       email: {
         validator: /@/,
@@ -18,34 +19,35 @@ const Index: React.FC = () => {
       password: [
         {
           validator: /[A-Z]/,
-				message: 'Must contain an uppercase letter'
+          message: 'Must contain an uppercase letter',
         },
         {
           validator: /[\d]/,
-				message: 'Must contain a digit'
+          message: 'Must contain a digit',
         },
-		]
+      ],
-	})
+    }
+  )
 
   return (
-		<form onSubmit={(e) => {
+    <form
+      onSubmit={e => {
         e.preventDefault()
         if (isValid) console.log(form)
-		}}>
+      }}
-
+    >
       <h1>Errors & Validation</h1>
 
-			<input {...auto('username')} placeholder="Username" />
+      <input {...field('username')} placeholder="Username" />
       {errors.username && 'Must be longer than 3'}
 
-			<input {...auto('email')} placeholder="EMail" />
+      <input {...field('email')} placeholder="EMail" />
       {errors.email}
 
-			<input {...auto('password')} placeholder="Password" type="password" />
+      <input {...field('password')} placeholder="Password" type="password" />
       {errors.password}
 
       <input type="submit" />
-
     </form>
   )
 }

examples/index.html

@@ -1,8 +1,7 @@
 <html lang="en">
-
+  <head>
-<head>
+    <meta charset="UTF-8" />
-	<meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-	<meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Form Hero</title>
     <style>
       body {
@@ -17,39 +16,38 @@
         margin: 1em auto;
         padding: 1em;
         background-color: #f3f3f3;
-			border-radius: .5em;
+        border-radius: 0.5em;
-			box-shadow: 0 8px 16px -16px rgba(0, 0, 0, .5);
+        box-shadow: 0 8px 16px -16px rgba(0, 0, 0, 0.5);
       }
 
       input {
         font-size: 1.25em;
         display: block;
-			padding: .5em 1em;
+        padding: 0.5em 1em;
-			margin-top: .5em;
+        margin-top: 0.5em;
         border-radius: 1em;
         width: 100%;
         outline: none;
-			border: .15em solid white;
+        border: 0.15em solid white;
       }
 
       input:focus,
       input:hover {
         border-color: #31def5;
-
       }
 
-		input[type="submit"] {
+      input[type='submit'] {
         cursor: pointer;
       }
 
-		input[type="checkbox"] {
+      input[type='checkbox'] {
         display: inline;
         width: initial;
       }
     </style>
-</head>
+  </head>
 
-<body>
+  <body>
     <section>
       <h3>Open the console to see the submitted data</h3>
     </section>
@@ -62,6 +60,5 @@
     <script src="./errorsAndValidation.tsx"></script>
     <script src="./select.tsx"></script>
     <script src="./custom.tsx"></script>
-</body>
+  </body>
-
 </html>

examples/select.tsx

@@ -4,20 +4,20 @@ import ReactDOM from 'react-dom'
 import { useForm } from '../dist'
 
 const Index: React.FC = () => {
-
+  const { field, form, errors } = useForm({
-	const { auto, form, errors } = useForm({
     type: 'formhero',
   })
 
   return (
-		<form onSubmit={e => {
+    <form
+      onSubmit={e => {
         e.preventDefault()
         console.log(form)
-		}}>
+      }}
-
+    >
       <h1>Select</h1>
 
-			<select {...auto('type')}>
+      <select {...field('type')}>
         <option value="redux-form">Redux-Form</option>
         <option value="react-hook-forms">React-Hook-Forms</option>
         <option value="formik">Formik</option>
@@ -25,7 +25,6 @@ const Index: React.FC = () => {
       </select>
 
       <input type="submit" />
-
     </form>
   )
 }

examples/simple.tsx

@@ -4,25 +4,24 @@ import ReactDOM from 'react-dom'
 import { useForm } from '../dist'
 
 const Index: React.FC = () => {
-
+  const { field, form, errors } = useForm({
-	const { auto, form, errors } = useForm({
     username: 'unicorn',
     password: '',
   })
 
   return (
-		<form onSubmit={e => {
+    <form
+      onSubmit={e => {
         e.preventDefault()
         console.log(form)
-		}}>
+      }}
-
+    >
       <h1>Simple</h1>
 
-			<input {...auto('username')} placeholder="Username" />
+      <input {...field('username')} placeholder="Username" />
-			<input {...auto('password')} placeholder="Password" type="password" />
+      <input {...field('password')} placeholder="Password" type="password" />
 
       <input type="submit" />
-
     </form>
   )
 }

lib/index.ts

@@ -88,10 +88,10 @@ export const useForm = <T, U extends { [key in keyof T]: useFormValidatorParamet
     _validate(key, extracted)
   }
 
-  const auto = (key: keyof T, opts: useFormOptions = {}) => ({
+  const field = (key: keyof T, opts: useFormOptions = {}) => ({
     [opts.getter || options.getter || 'onChange']: update(key, opts.extractor),
     [opts.setter || options.setter || 'value']: form[key] as any,
   })
 
-  return { form, update, auto, errors, isValid }
+  return { form, update, field, errors, isValid }
 }

test/test.tsx

@@ -6,7 +6,7 @@ import { useForm } from '../'
 const TextError: React.FC<{ error?: string }> = ({ error }) => (!error ? null : <div className="has-text-danger">{error}</div>)
 
 const Index: React.FC = () => {
-  const { auto, form, errors, isValid } = useForm(
+  const { field, form, errors, isValid } = useForm(
     {
       username: '',
       password: '',
@@ -40,20 +40,20 @@ const Index: React.FC = () => {
     <div>
       <form onSubmit={_submit}>
         <div>Username</div>
-        <input className="input" {...auto('username')} />
+        <input className="input" {...field('username')} />
         <TextError error={errors.username} />
         <br />
         <br />
 
         <div>Password</div>
-        <input className="input" {...auto('password')} />
+        <input className="input" {...field('password')} />
         <TextError error={errors.password} />
         <br />
         <br />
 
         <div>Which one to choose?</div>
         <div className="select">
-          <select {...auto('type')}>
+          <select {...field('type')}>
             <option value="redux-form">Redux-Form</option>
             <option value="react-hook-forms">React-Hook-Forms</option>
             <option value="formik">Formik</option>
@@ -66,7 +66,7 @@ const Index: React.FC = () => {
         <label className="checkbox">
           <input
             type="checkbox"
-            {...auto('awesome', {
+            {...field('awesome', {
               setter: 'checked',
               getter: 'onChange',
               extractor: e => e.target.checked,