react-simple-formkit 2.4.0 → 2.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +34 -3
- package/dist/react-simple-formkit.js +4 -4
- package/dist/react-simple-formkit.mjs +531 -545
- package/dist/react-simple-formkit.umd.js +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -24,6 +24,9 @@ A lightweight library for managing forms as uncontrolled. State updates only whe
|
|
|
24
24
|
- [Managing errors](#managing-errors)
|
|
25
25
|
- [Get field error](#get-field-error)
|
|
26
26
|
- [Set field error](#set-field-error)
|
|
27
|
+
- [Grouping fields (nested object)](#grouping-fields-nested-object)
|
|
28
|
+
- [Utilities](#utilities)
|
|
29
|
+
- [restoreFromDotNotation](#restoreFromDotNotation)
|
|
27
30
|
- [APIs](#apis)
|
|
28
31
|
- [useForm](#useForm)
|
|
29
32
|
- [Form](#form)
|
|
@@ -55,7 +58,7 @@ A lightweight library for managing forms as uncontrolled. State updates only whe
|
|
|
55
58
|
- [Managing form state](#managing-form-state): isDirty, isError, dirtyFields, touchedFields, errorFields, ...
|
|
56
59
|
- [Managing field states](#managing-field-states): isDirty, isTouched, isError, custom states, ...
|
|
57
60
|
- [Managing errors](#managing-errors): form errors, field errors, ...
|
|
58
|
-
- [
|
|
61
|
+
- [Grouping fields (nested object)](#grouping-fields-nested-object): Supports nested fields with dot notation.
|
|
59
62
|
|
|
60
63
|
# Quick start
|
|
61
64
|
|
|
@@ -175,7 +178,7 @@ Example `fieldState`:
|
|
|
175
178
|
|
|
176
179
|
## Watching for updates
|
|
177
180
|
|
|
178
|
-
State updates only when observed via `watch()`, `useWatch()`, `subscribe()`, or by tracking changes through the Form component's `onChange`, `onBlur` callbacks. You can watch Values, Form States, Field States, and Errors through the same interface.
|
|
181
|
+
State updates only when observed via `watch()`, `useWatch()`, `subscribe()`, or by tracking changes through the Form component's `onChange`, `onBlur` callbacks. You can watch Values, Form States, Field States, and Errors through the same name interface.
|
|
179
182
|
|
|
180
183
|
- [watch(name)](#watch) will trigger a re-render at the form level.
|
|
181
184
|
- [useWatch({ name })](#usewatch) will trigger a re-render only in the component where it is called.
|
|
@@ -375,7 +378,11 @@ return (
|
|
|
375
378
|
)
|
|
376
379
|
```
|
|
377
380
|
|
|
378
|
-
#
|
|
381
|
+
# Grouping fields (nested object)
|
|
382
|
+
|
|
383
|
+
- **Use cases**: When you need to group multiple fields into an object. By registering these fields with dot notation, you can manage these fieldStates, errors, values as a nested object.
|
|
384
|
+
|
|
385
|
+
- **Example**: Suppose an address has two fields, line1 and line2. You want to track their individual states (fieldStates, errors, values) separately, but you also need to group them under a single address object for easier management and form submission.
|
|
379
386
|
|
|
380
387
|
## Registering
|
|
381
388
|
|
|
@@ -393,6 +400,8 @@ return (
|
|
|
393
400
|
/>
|
|
394
401
|
```
|
|
395
402
|
|
|
403
|
+
> **Rule\***: Nested fields must be registered using dot notation through inputs or Controllers `name` prop. If not registered, the field will be treated as a regular field with an object type value.
|
|
404
|
+
|
|
396
405
|
## Watching
|
|
397
406
|
|
|
398
407
|
```
|
|
@@ -413,6 +422,28 @@ actions.setFieldState("address.line1", "disabled", true)
|
|
|
413
422
|
actions.setFieldState("address.line1", "custom", { hello: "world" })
|
|
414
423
|
```
|
|
415
424
|
|
|
425
|
+
> **Rule\***: If nested field is registered, all the fieldState, error, and value will be stored in the bottom level fields (leaf nodes). You cannot set a primitive value for a parent field.
|
|
426
|
+
|
|
427
|
+
# Utilities
|
|
428
|
+
|
|
429
|
+
## restoreFromDotNotation(object)
|
|
430
|
+
|
|
431
|
+
Convert dot notation objects to nested objects
|
|
432
|
+
|
|
433
|
+
```
|
|
434
|
+
import { restoreFromDotNotation } from "react-simple-formkit";
|
|
435
|
+
|
|
436
|
+
const dotNotationObject = watch(["errors.email", "errors.password"])
|
|
437
|
+
const nestedObject = restoreFromDotNotation(dotNotationObject)
|
|
438
|
+
// Output:
|
|
439
|
+
// {
|
|
440
|
+
// "errors": {
|
|
441
|
+
// "email": "Email is required",
|
|
442
|
+
// "password": "Password is required",
|
|
443
|
+
// }
|
|
444
|
+
// }
|
|
445
|
+
```
|
|
446
|
+
|
|
416
447
|
# APIs
|
|
417
448
|
|
|
418
449
|
## useForm
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react");var ne={exports:{}},H={};/**
|
|
2
2
|
* @license React
|
|
3
3
|
* react-jsx-runtime.production.js
|
|
4
4
|
*
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* This source code is licensed under the MIT license found in the
|
|
8
8
|
* LICENSE file in the root directory of this source tree.
|
|
9
|
-
*/var
|
|
9
|
+
*/var ie;function ke(){if(ie)return H;ie=1;var u=Symbol.for("react.transitional.element"),t=Symbol.for("react.fragment");function o(i,a,f){var c=null;if(f!==void 0&&(c=""+f),a.key!==void 0&&(c=""+a.key),"key"in a){f={};for(var b in a)b!=="key"&&(f[b]=a[b])}else f=a;return a=f.ref,{$$typeof:u,type:i,key:c,ref:a!==void 0?a:null,props:f}}return H.Fragment=t,H.jsx=o,H.jsxs=o,H}var X={};/**
|
|
10
10
|
* @license React
|
|
11
11
|
* react-jsx-runtime.development.js
|
|
12
12
|
*
|
|
@@ -14,9 +14,9 @@
|
|
|
14
14
|
*
|
|
15
15
|
* This source code is licensed under the MIT license found in the
|
|
16
16
|
* LICENSE file in the root directory of this source tree.
|
|
17
|
-
*/var
|
|
17
|
+
*/var fe;function ye(){return fe||(fe=1,process.env.NODE_ENV!=="production"&&function(){function u(r){if(r==null)return null;if(typeof r=="function")return r.$$typeof===ue?null:r.displayName||r.name||null;if(typeof r=="string")return r;switch(r){case v:return"Fragment";case j:return"Profiler";case F:return"StrictMode";case oe:return"Suspense";case Z:return"SuspenseList";case Q:return"Activity"}if(typeof r=="object")switch(typeof r.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),r.$$typeof){case S:return"Portal";case M:return(r.displayName||"Context")+".Provider";case N:return(r._context.displayName||"Context")+".Consumer";case U:var g=r.render;return r=r.displayName,r||(r=g.displayName||g.name||"",r=r!==""?"ForwardRef("+r+")":"ForwardRef"),r;case B:return g=r.displayName||null,g!==null?g:u(r.type)||"Memo";case y:g=r._payload,r=r._init;try{return u(r(g))}catch{}}return null}function t(r){return""+r}function o(r){try{t(r);var g=!1}catch{g=!0}if(g){g=console;var p=g.error,_=typeof Symbol=="function"&&Symbol.toStringTag&&r[Symbol.toStringTag]||r.constructor.name||"Object";return p.call(g,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",_),t(r)}}function i(r){if(r===v)return"<>";if(typeof r=="object"&&r!==null&&r.$$typeof===y)return"<...>";try{var g=u(r);return g?"<"+g+">":"<...>"}catch{return"<...>"}}function a(){var r=J.A;return r===null?null:r.getOwner()}function f(){return Error("react-stack-top-frame")}function c(r){if(K.call(r,"key")){var g=Object.getOwnPropertyDescriptor(r,"key").get;if(g&&g.isReactWarning)return!1}return r.key!==void 0}function b(r,g){function p(){re||(re=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",g))}p.isReactWarning=!0,Object.defineProperty(r,"key",{get:p,configurable:!0})}function d(){var r=u(this.type);return x[r]||(x[r]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),r=this.props.ref,r!==void 0?r:null}function m(r,g,p,_,W,D,q,G){return p=D.ref,r={$$typeof:O,type:r,key:g,props:D,_owner:W},(p!==void 0?p:null)!==null?Object.defineProperty(r,"ref",{enumerable:!1,get:d}):Object.defineProperty(r,"ref",{enumerable:!1,value:null}),r._store={},Object.defineProperty(r._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(r,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(r,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:q}),Object.defineProperty(r,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:G}),Object.freeze&&(Object.freeze(r.props),Object.freeze(r)),r}function l(r,g,p,_,W,D,q,G){var A=g.children;if(A!==void 0)if(_)if(ee(A)){for(_=0;_<A.length;_++)R(A[_]);Object.freeze&&Object.freeze(A)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else R(A);if(K.call(g,"key")){A=u(r);var e=Object.keys(g).filter(function(E){return E!=="key"});_=0<e.length?"{key: someKey, "+e.join(": ..., ")+": ...}":"{key: someKey}",z[A+_]||(e=0<e.length?"{"+e.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
|
|
18
18
|
let props = %s;
|
|
19
19
|
<%s {...props} />
|
|
20
20
|
React keys must be passed directly to JSX without using spread:
|
|
21
21
|
let props = %s;
|
|
22
|
-
<%s key={someKey} {...props} />`,_,s,d,s),K[s+_]=!0)}if(s=null,k!==void 0&&(o(k),s=""+k),c(m)&&(o(m.key),s=""+m.key),"key"in m){k={};for(var g in m)g!=="key"&&(k[g]=m[g])}else k=m;return s&&h(k,typeof r=="function"?r.displayName||r.name||"Unknown":r),E(r,s,D,x,a(),k,q,e)}function R(r){typeof r=="object"&&r!==null&&r.$$typeof===w&&r._store&&(r._store.validated=1)}var y=u,w=Symbol.for("react.transitional.element"),C=Symbol.for("react.portal"),S=Symbol.for("react.fragment"),T=Symbol.for("react.strict_mode"),p=Symbol.for("react.profiler"),N=Symbol.for("react.consumer"),M=Symbol.for("react.context"),I=Symbol.for("react.forward_ref"),H=Symbol.for("react.suspense"),Y=Symbol.for("react.suspense_list"),v=Symbol.for("react.memo"),L=Symbol.for("react.lazy"),tr=Symbol.for("react.activity"),sr=Symbol.for("react.client.reference"),U=y.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,P=Object.prototype.hasOwnProperty,nr=Array.isArray,B=console.createTask?console.createTask:function(){return null};y={"react-stack-bottom-frame":function(r){return r()}};var W,X={},Z=y["react-stack-bottom-frame"].bind(y,b)(),Q=B(l(b)),K={};z.Fragment=S,z.jsx=function(r,m,k,_,x){var D=1e4>U.recentlyCreatedOwnerStacks++;return f(r,m,k,!1,_,x,D?Error("react-stack-top-frame"):Z,D?B(l(r)):Q)},z.jsxs=function(r,m,k,_,x){var D=1e4>U.recentlyCreatedOwnerStacks++;return f(r,m,k,!0,_,x,D?Error("react-stack-top-frame"):Z,D?B(l(r)):Q)}}()),z}var fr;function vr(){return fr||(fr=1,process.env.NODE_ENV==="production"?rr.exports=kr():rr.exports=yr()),rr.exports}var dr=vr();const F=()=>{},gr=u.createContext({ref:null,watch:F,actions:{reset:F,resetField:F,setValue:F,getValues:F,getErrors:F,getFieldStates:F,getFormStates:F,setError:F,clearError:F,clearErrors:F,checkValidity:F,getNumberFields:F,getFieldValidity:F,getDefaultValues:F,setFieldState:F,resetFieldState:F,getControlledFields:F},registerController:F,registerHookWatcher:F,lastReloadedAt:F,loadFormValues:F,getWatchValue:F,channels:{}}),ar=()=>u.useContext(gr),Fr=({id:n,control:t,method:o,action:l,children:a,onChange:b,onBlur:c,onSubmit:h=()=>{},onInput:i=()=>{},onReset:E=()=>{},numberFields:f=[],className:R,...y})=>{const w=u.useCallback(C=>{t.ref&&(t.ref.current=C,t.ref.current&&t.initForm())},[t]);return u.useEffect(()=>{let C=()=>{},S=()=>{};return b&&(C=t.channels.subscribe("onChange",b)),c&&(S=t.channels.subscribe("onBlur",c)),()=>{C(),S()}},[t.lastReloadedAt]),dr.jsx(gr.Provider,{value:t,children:dr.jsx("form",{id:n,ref:w,action:l,method:o,className:R,onInput:i,onSubmit:C=>{o||C.preventDefault();const S=t.loadFormValues();h(S)},onChange:C=>{const S=C.target.name;!S||t.actions.getControlledFields().has(S)||t.actions.setValue(S,C.target.value)},onBlur:C=>{const S=C.target.name;if(!S||t.actions.getControlledFields().has(S))return;const T=C.target.value;t.channels.publish("onBlur",S,T,t.actions.getValues())},onReset:C=>{t.actions.reset(),E(C)},...y,children:a},t.lastReloadedAt)})},cr={isDirty:!1,isTouched:!1,error:null},br={lastReset:null,isDirty:!1,isError:!1,errorFields:[],dirtyFields:[],touchedFields:[]},pr={},A=(n={},t="")=>t.split(".").reduce((o,l)=>o&&o[l]!==void 0?o[l]:void 0,n),V=(n={},t="",o)=>{const l={...n};let a=l;const b=t.split(".");return b.forEach((c,h)=>{h<b.length-1?(a[c]=a[c]?{...a[c]}:{},a=a[c]):a[c]=o}),l},G=(n,t)=>{const o=A(n,t);return typeof o=="object"&&!Array.isArray(o)},Tr=["errors","fieldStates","formState"],$=n=>Tr.some(t=>n.startsWith(t))?n:"values."+n,_r=["badInput","customError","patternMismatch","rangeOverflow","rangeUnderflow","stepMismatch","tooLong","tooShort","typeMismatch","valueMissing"],Er=n=>{typeof n.setCustomValidity=="function"&&n.setCustomValidity("");let t=n.validity,o=_r.find(l=>t[l]);if(o)return{type:o,message:n.validationMessage}},wr=({control:n,name:t,compute:o})=>{const{getWatchValue:l,registerHookWatcher:a}=n||ar(),b=l({name:t,compute:o}),[c,h]=u.useState(b);return u.useEffect(()=>a({name:t,compute:o,value:c,setValue:h}),[]),c},hr=({control:n,name:t,defaultValue:o})=>{const{actions:l,registerController:a,channels:b,getWatchValue:c}=n||ar(),h=u.useRef(),i=u.useRef(),E=A(l.getDefaultValues(),t)||o||"",[f,R]=u.useState(E),[y,w]=u.useState({}),C=u.useCallback((T,{shouldDirty:p=!0,shouldOnChange:N=!0}={})=>{var I;let M=T;((I=T==null?void 0:T.target)==null?void 0:I.value)!==void 0&&(M=T.target.value),R(M),l.setValue(t,M,{shouldDirty:p,shouldOnChange:N})},[l.setValue]),S=u.useCallback(T=>{const p=l.getValues(),N=T??A(p,t);b.publish("onBlur",t,N,p)},[]);return u.useEffect(()=>{const T=a(t,R);return()=>{T(),i.current&&i.current()}},[]),new Proxy({ref:h,name:t,defaultValue:E,value:f,onChange:C,onBlur:S,fieldState:y},{get(T,p,N){return typeof p=="string"&&p==="fieldState"&&(i.current&&i.current(),i.current=l.subscribe(`fieldStates.${t}`,()=>{w(c({name:`fieldStates.${t}`}))})),Reflect.get(T,p,N)}})},Ar=({name:n,control:t,defaultValue:o,render:l=({ref:a,name:b,defaultValue:c,value:h,onChange:i,onBlur:E,fieldState:f})=>null})=>{const a=hr({name:n,defaultValue:o,control:t});return l(a)},Or=()=>{const[n,t]=u.useState(),o=u.useCallback(()=>t(new Date().toString()),[]);return[n,o]},jr=()=>{const[,n]=u.useState({});return u.useCallback(()=>n({}),[])},Pr=({channels:n,getWatchValue:t})=>{const o=jr(),l=u.useCallback(c=>{if(!c)return n.subscribeWatch("values",()=>o()),t();if(typeof c=="string"){const h=$(c);n.subscribeWatch(h,(i,E)=>{i!==E&&o()})}return Array.isArray(c)&&c.forEach(h=>{const i=$(h);n.subscribeWatch(i,(E,f)=>{E!==f&&o()})}),t({name:c})},[]),a=u.useCallback(({name:c,compute:h,setValue:i})=>{if(typeof h=="function")return n.subscribe("values",()=>{const f=t({compute:h});i(f)});if(!c)return n.subscribe("values",()=>{i(t())});if(typeof c=="string"){const E=$(c);return n.subscribe(E,()=>{const R=t({name:c});i(R)})}if(Array.isArray(c)){const E=[];return c.forEach(f=>{const R=$(f),y=n.subscribe(R,()=>{const w=t({name:c});i(w)});E.push(y)}),()=>E.forEach(f=>f())}throw new Error("Parameters of name must be string or array of string or compute must be a function")},[]),b=u.useCallback((c,h)=>{if(!c)return n.subscribe("values",()=>h(t()));if(["onChange","onBlur"].includes(c))return n.subscribe(c,h);if(typeof c=="string"){const i=$(c);return n.subscribe(i,()=>h(t({name:c})))}if(Array.isArray(c)){const i=[];return c.forEach(E=>{const f=$(E),R=n.subscribe(f,()=>{h(t({name:c}))});i.push(R)}),()=>i.forEach(E=>E())}throw new Error("Parameters of name must be string or array of string")},[]);return{watch:l,registerHookWatcher:a,getWatchValue:t,subscribe:b}},Dr=({getWatchValue:n})=>{const t=u.useRef(new Map),o=u.useRef(new Map),l=u.useCallback(()=>o.current,[]),a=u.useCallback(()=>t.current,[]),b=u.useCallback(()=>{t.current.clear(),o.current.clear()},[]),c=u.useCallback((f,...R)=>{const y=t.current.get(f),w=o.current.get(f);y&&y.forEach(C=>C(...R)),w&&w.forEach(C=>C(...R)),t.current.forEach((C,S)=>{if(S!==f&&f.startsWith(S)){const T=n({name:S.replace("values.","").replace("values","")});C.forEach(p=>p(V(T,f.replace(`${S}.`,""),R[0])))}}),o.current.forEach((C,S)=>{if(S!==f&&f.startsWith(S)){const T=n({name:S.replace("values.","").replace("values","")});C.forEach(p=>p(V(T,f.replace(`${S}.`,""),R[0])))}})},[]),h=u.useCallback(f=>{t.current.forEach((R,y)=>{y.startsWith(f)&&R.forEach(w=>w(n({name:y.replace("values.","").replace("values","")})))}),o.current.forEach((R,y)=>{y.startsWith(f)&&R.forEach(w=>w(n({name:y.replace("values.","").replace("values","")})))})},[]),i=u.useCallback((f,R)=>(t.current.has(f)||t.current.set(f,new Set),t.current.get(f).add(R),()=>{var y;return(y=t.current.get(f))==null?void 0:y.delete(R)}),[]),E=u.useCallback((f,R)=>{o.current.has(f)||(o.current.set(f,new Set),o.current.get(f).add(R))},[]);return{reset:b,publish:c,subscribe:i,subscribeWatch:E,getEvents:a,getWatchEvents:l,trigger:h}},mr=(n,t={},o="")=>!!Object.keys(t).find(l=>{const a=t[l];return G(n,o+l)?mr(n,a,o+l+"."):!!a.isDirty}),er=(n,t={},o="")=>!!Object.keys(t).find(l=>{const a=t[l];return G(n,o+l)?er(n,a,o+l+"."):!!a}),Rr=(n,t={},o="")=>Object.keys(t).reduce((l,a)=>{const b=t[a];return G(n,o+a)?[...l,...Rr(n,b,o+a+".")]:b.isDirty?[...l,o+a]:l},[]),Sr=(n,t={},o="")=>Object.keys(t).reduce((l,a)=>{const b=t[a];return G(n,o+a)?[...l,...Sr(n,b,o+a+".")]:b.isTouched?[...l,o+a]:l},[]),Cr=(n,t={},o="")=>Object.keys(t).reduce((l,a)=>{const b=t[a];return G(n,o+a)?[...l,...Cr(n,b,o+a+".")]:b?[...l,o+a]:l},[]),Nr=({defaultValues:n=pr,shouldUnRegister:t=!1}={})=>{const[o,l]=Or(),a=u.useRef(),b=u.useRef(new Map),c=u.useRef({}),h=u.useRef({}),i=u.useRef({...br}),E=u.useRef({...n}),f=u.useRef({...n}),R=u.useCallback((e,s=f.current)=>Object.keys(s).reduce((d,g)=>{if(typeof s[g]=="object")return{...d,[g]:R(e,s[g])};const O={...e?{}:h.current[g]||{},...cr};return{...d,[g]:O}},{}),[]),y=u.useCallback((e={},{clearCustomFormStates:s=!1,clearCustomFieldStates:d=!1}={})=>{f.current={...f.current,...e},E.current={...f.current},b.current.forEach((g,O)=>{g(A(f.current,O)??"")}),c.current={},i.current={...s?{}:i.current,...br},b.current=new Map,v.reset(),h.current=R(d),l()},[]),w=u.useCallback(()=>{let e=Object.fromEntries(new FormData(a.current));b.current.forEach((d,g)=>{e=V(e,g,A(E.current,g))});let s={...E.current,...e};return Object.keys(s).forEach(d=>{if(d.includes(".")){const g=A(s,d);s=V(s,d,g||""),delete s[d]}}),s},[]),C=u.useCallback(e=>Er(e.target),[]),S=u.useCallback(()=>f.current,[]),T=u.useCallback(()=>b.current,[]),p=u.useCallback((e,s)=>s?Array.isArray(s)?s.reduce((d,g)=>({...d,[g]:A(e,g)}),{}):A(e,s):{...e},[]),N=u.useCallback(e=>p(E.current,e),[p]),M=u.useCallback(e=>p(c.current,e),[p]),I=u.useCallback(e=>p(h.current,e),[p]),H=u.useCallback(e=>p({...i.current,lastReset:o},e),[o]),Y=u.useCallback(({name:e,compute:s}={})=>{if(!e&&!s||e==="values")return N();if(typeof s=="function")return s(N());if(Array.isArray(e)){const d={};return e.forEach(g=>{d[g]=Y({name:g})}),d}return A({...E.current,errors:c.current,fieldStates:h.current,formState:H()},e)},[]),v=Dr({getWatchValue:Y}),{watch:L,registerHookWatcher:tr,subscribe:sr}=Pr({getWatchValue:Y,channels:v}),U=u.useCallback((e,s)=>{const d=i.current,g=A(d,e);g!==s&&(i.current=V(i.current,e,s),v.publish(`formState.${e}`,s,g))},[]),P=u.useCallback((e,s,d)=>{try{const g=A(h.current,e)||{...cr},O=A(g,s);if(O!==d){if(h.current=V(h.current,`${e}.${s}`,d),v.publish(`fieldStates.${e}.${s}`,d,O),s==="error"){const j=Cr(E.current,c.current);i.current.errorFields=j,v.publish("formState.errorFields",j)}if(s==="isDirty"){const j=Rr(E.current,h.current);i.current.dirtyFields=j,v.publish("formState.dirtyFields",j)}if(s==="isTouched"){const j=Sr(E.current,h.current);i.current.touchedFields=j,v.publish("formState.touchedFields",j)}}}catch(g){console.log(g)}},[]),nr=u.useCallback(e=>{P(e,"isDirty",!1),P(e,"isTouched",!1),P(e,"error",null)},[]),B=u.useCallback((e,s)=>{try{const d=A(c.current,e);if(d===s)return;c.current=V(c.current,e,s),v.publish(`errors.${e}`,s,d),P(e,"error",s);const g=er(E.current,c.current);if(i.current.isError!==g){const O=i.current.isError;i.current.isError=g,v.publish("formState.isError",g,O)}}catch(d){console.error(d)}},[]),W=u.useCallback(e=>{try{const s=A(c.current,e);if(!s)return;c.current=V(c.current,e,null),v.publish(`errors.${e}`,null,s),P(e,"error",null);const d=er(E.current,c.current);if(i.current.isError!==d){const g=i.current.isError;i.current.isError=d,v.publish("formState.isError",d,g)}}catch(s){console.error(s)}},[]),X=u.useCallback(()=>{if(!i.current.isError)return;Object.keys(c.current).forEach(s=>W(s)),c.current={};const e=er(E.current,c.current);if(i.current.isError!==e){const s=i.current.isError;i.current.isError=e,v.publish("formState.isError",e,s)}},[]),Z=u.useCallback(e=>{const s=Er(e.target);s?B(e.target.name,s):W(e.target.name)},[]),Q=u.useCallback((e,s,{shouldDirty:d=!0,shouldOnChange:g=!0}={})=>{const O=A(E.current,e);if(s===O)return;if(P(e,"isTouched",!0),d){const ur=s!==(A(f.current,e)||"");P(e,"isDirty",ur)}E.current=V(E.current,e,s),v.publish(`values.${e}`,s,O);const j=b.current.get(e);j&&j(s),g&&v.publish("onChange",e,s,E.current);const or=mr(E.current,h.current);if(i.current.isDirty!==or){const ur=i.current.isDirty;i.current.isDirty=or,v.publish("formState.isDirty",or,ur)}},[]),K=u.useCallback((e,s)=>(b.current.set(e,s),h.current=V(h.current,e,{...cr}),()=>{t&&b.current.delete(e)}),[]),r=u.useCallback((e,{keepError:s,keepDirty:d,keepTouched:g,defaultValue:O})=>{const j=b.current.get(e);if(!j)throw new Error(`Cannot reset "${e}" because it's uncontrolled field`);f.current[e]=O,E.current[e]=O,j&&j(O),s||W(e),d||P(e,"isDirty",!1),g||P(e,"isTouched",!1)},[]),m=u.useCallback(e=>{if(!e)return v.trigger("values");if(!Array.isArray(e)){const s=$(e);v.trigger(s);return}e.forEach(s=>{const d=$(s);v.trigger(d)})},[]),k=u.useCallback((e,s=_.getValues(e))=>{v.publish("onBlur",e,s,_.getValues())},[]),_=u.useMemo(()=>({subscribe:sr,reset:y,trigger:m,reload:l,resetField:r,setValue:Q,getValues:N,getErrors:M,getFieldStates:I,getFormState:H,setError:B,clearError:W,clearErrors:X,checkValidity:Z,getFieldValidity:C,getDefaultValues:S,setFieldState:P,triggerFieldBlur:k,resetFieldState:nr,getControlledFields:T,setFormState:U,getEvents:v.getEvents,getWatchEvents:v.getWatchEvents}),[o]),x=u.useCallback(()=>{[...a.current.querySelectorAll("[name]")].forEach(d=>{const g=d.name;!d.defaultValue&&!b.current.has(g)&&A(f.current,g)&&(d.defaultValue=A(f.current,g))});const s=w();E.current={...s},f.current={...s}},[]),D=u.useMemo(()=>({ref:a,watch:L,actions:_,initForm:x,registerController:K,registerHookWatcher:tr,lastReloadedAt:o,loadFormValues:w,getWatchValue:Y,channels:v}),[o]),q=u.useMemo(()=>({control:D,actions:_,watch:L}),[o]);return u.useLayoutEffect(()=>{a.current&&x()},[o]),u.useLayoutEffect(()=>{h.current=R(!1)},[]),q};exports.Controller=Ar;exports.Form=Fr;exports.useController=hr;exports.useForm=Nr;exports.useFormContext=ar;exports.useWatch=wr;
|
|
22
|
+
<%s key={someKey} {...props} />`,_,A,e,A),z[A+_]=!0)}if(A=null,p!==void 0&&(o(p),A=""+p),c(g)&&(o(g.key),A=""+g.key),"key"in g){p={};for(var n in g)n!=="key"&&(p[n]=g[n])}else p=g;return A&&b(p,typeof r=="function"?r.displayName||r.name||"Unknown":r),m(r,A,D,W,a(),p,q,G)}function R(r){typeof r=="object"&&r!==null&&r.$$typeof===O&&r._store&&(r._store.validated=1)}var C=s,O=Symbol.for("react.transitional.element"),S=Symbol.for("react.portal"),v=Symbol.for("react.fragment"),F=Symbol.for("react.strict_mode"),j=Symbol.for("react.profiler"),N=Symbol.for("react.consumer"),M=Symbol.for("react.context"),U=Symbol.for("react.forward_ref"),oe=Symbol.for("react.suspense"),Z=Symbol.for("react.suspense_list"),B=Symbol.for("react.memo"),y=Symbol.for("react.lazy"),Q=Symbol.for("react.activity"),ue=Symbol.for("react.client.reference"),J=C.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,K=Object.prototype.hasOwnProperty,ee=Array.isArray,Y=console.createTask?console.createTask:function(){return null};C={"react-stack-bottom-frame":function(r){return r()}};var re,x={},te=C["react-stack-bottom-frame"].bind(C,f)(),se=Y(i(f)),z={};X.Fragment=v,X.jsx=function(r,g,p,_,W){var D=1e4>J.recentlyCreatedOwnerStacks++;return l(r,g,p,!1,_,W,D?Error("react-stack-top-frame"):te,D?Y(i(r)):se)},X.jsxs=function(r,g,p,_,W){var D=1e4>J.recentlyCreatedOwnerStacks++;return l(r,g,p,!0,_,W,D?Error("react-stack-top-frame"):te,D?Y(i(r)):se)}}()),X}var de;function Fe(){return de||(de=1,process.env.NODE_ENV==="production"?ne.exports=ke():ne.exports=ye()),ne.exports}var be=Fe();const k=()=>{},he=s.createContext({ref:null,watch:k,actions:{reset:k,resetField:k,setValue:k,getValues:k,getErrors:k,getFieldStates:k,getFormStates:k,setError:k,clearError:k,clearErrors:k,checkValidity:k,getNumberFields:k,getFieldValidity:k,getDefaultValues:k,setFieldState:k,resetFieldState:k,getControlledFields:k},registerController:k,registerHookWatcher:k,lastReloadedAt:k,loadFormValues:k,getWatchValue:k,channels:{}}),le=()=>s.useContext(he),Te=({id:u,control:t,method:o,action:i,children:a,onChange:f,onBlur:c,onSubmit:b=()=>{},onInput:d=()=>{},onReset:m=()=>{},numberFields:l=[],className:R,...C})=>{const O=s.useCallback(S=>{t.ref&&(t.ref.current=S,t.ref.current&&t.initForm())},[t]);return s.useEffect(()=>{let S=()=>{},v=()=>{};return f&&(S=t.channels.subscribe("onChange",f)),c&&(v=t.channels.subscribe("onBlur",c)),()=>{S(),v()}},[t.lastReloadedAt]),be.jsx(he.Provider,{value:t,children:be.jsx("form",{id:u,ref:O,action:i,method:o,className:R,onInput:d,onSubmit:S=>{o||S.preventDefault();const v=t.loadFormValues();b(v)},onChange:S=>{const v=S.target.name;!v||t.actions.getControlledFields().has(v)||t.actions.setValue(v,S.target.value)},onBlur:S=>{const v=S.target.name;if(!v||t.actions.getControlledFields().has(v))return;const F=S.target.value;t.channels.publish("onBlur",v,F,t.actions.getValues())},onReset:S=>{t.actions.reset(),m(S)},...C,children:a},t.lastReloadedAt)})},ae={isDirty:!1,isTouched:!1,error:null},Ee={lastReset:null,isDirty:!1,isError:!1,errorFields:[],dirtyFields:[],touchedFields:[]},_e={},Ae=["badInput","customError","patternMismatch","rangeOverflow","rangeUnderflow","stepMismatch","tooLong","tooShort","typeMismatch","valueMissing"],P=(u={},t="")=>t.split(".").reduce((o,i)=>o&&o[i]!==void 0?o[i]:void 0,u),$=(u={},t="",o)=>{const i={...u};let a=i;const f=t.split(".");return f.forEach((c,b)=>{b<f.length-1?(a[c]||(a[c]={}),Array.isArray(a[c])?a[c]=[...a[c]]:a[c]={...a[c]},a=a[c]):a[c]=o}),i},me=u=>{let t={...u};return Object.keys(t).forEach(o=>{if(o.includes(".")){const i=P(t,o);t=$(t,o,i||""),delete t[o]}}),t},Oe=["errors","fieldStates","formState"],L=u=>Oe.some(t=>u.startsWith(t))?u:"values."+u,ge=u=>{typeof u.setCustomValidity=="function"&&u.setCustomValidity("");let t=u.validity,o=Ae.find(i=>t[i]);if(o)return{type:o,message:u.validationMessage}},Re=(u=new Set,t={},o="")=>Object.keys(t).reduce((i,a)=>{const f=t[a];return u.has(o+a)?[...i,...Re(u,f,o+a+".")]:f.isDirty?[...i,o+a]:i},[]),ve=(u=new Set,t={},o="")=>Object.keys(t).reduce((i,a)=>{const f=t[a];return u.has(o+a)?[...i,...ve(u,f,o+a+".")]:f.isTouched?[...i,o+a]:i},[]),Se=(u=new Set,t={},o="")=>Object.keys(t).reduce((i,a)=>{const f=t[a];return u.has(o+a)?[...i,...Se(u,f,o+a+".")]:f?[...i,o+a]:i},[]),je=({control:u,name:t,compute:o})=>{const{getWatchValue:i,registerHookWatcher:a}=u||le(),f=i({name:t,compute:o}),[c,b]=s.useState(f);return s.useEffect(()=>a({name:t,compute:o,value:c,setValue:b}),[]),c},Ce=({control:u,name:t,defaultValue:o})=>{const{actions:i,registerController:a,channels:f,getWatchValue:c}=u||le(),b=s.useRef(),d=s.useRef(),m=P(i.getDefaultValues(),t)||o||"",[l,R]=s.useState(m),[C,O]=s.useState({}),S=s.useCallback((F,{shouldDirty:j=!0,shouldOnChange:N=!0}={})=>{var U;let M=F;((U=F==null?void 0:F.target)==null?void 0:U.value)!==void 0&&(M=F.target.value),R(M),i.setValue(t,M,{shouldDirty:j,shouldOnChange:N})},[i.setValue]),v=s.useCallback(F=>{const j=i.getValues(),N=F??P(j,t);f.publish("onBlur",t,N,j)},[]);return s.useEffect(()=>{const F=a(t,R);return()=>{F(),d.current&&d.current()}},[]),new Proxy({ref:b,name:t,defaultValue:m,value:l,onChange:S,onBlur:v,fieldState:C},{get(F,j,N){return typeof j=="string"&&j==="fieldState"&&(d.current&&d.current(),d.current=i.subscribe(`fieldStates.${t}`,()=>{O(c({name:`fieldStates.${t}`}))})),Reflect.get(F,j,N)}})},we=({name:u,control:t,defaultValue:o,render:i=({ref:a,name:f,defaultValue:c,value:b,onChange:d,onBlur:m,fieldState:l})=>null})=>{const a=Ce({name:u,defaultValue:o,control:t});return i(a)},Pe=()=>{const[u,t]=s.useState(),o=s.useCallback(()=>t(new Date().toString()),[]);return[u,o]},Ne=()=>{const[,u]=s.useState({});return s.useCallback(()=>u({}),[])},De=({channels:u,getWatchValue:t})=>{const o=Ne(),i=s.useCallback(c=>{if(!c)return u.subscribeWatch("values",()=>o()),t();if(typeof c=="string"){const b=L(c);u.subscribeWatch(b,(d,m)=>{d!==m&&o()})}return Array.isArray(c)&&c.forEach(b=>{const d=L(b);u.subscribeWatch(d,(m,l)=>{m!==l&&o()})}),t({name:c})},[]),a=s.useCallback(({name:c,compute:b,setValue:d})=>{if(typeof b=="function")return u.subscribe("values",()=>{const l=t({compute:b});d(l)});if(!c)return u.subscribe("values",()=>{d(t())});if(typeof c=="string"){const m=L(c);return u.subscribe(m,()=>{const R=t({name:c});d(R)})}if(Array.isArray(c)){const m=[];return c.forEach(l=>{const R=L(l),C=u.subscribe(R,()=>{const O=t({name:c});d(O)});m.push(C)}),()=>m.forEach(l=>l())}throw new Error("Parameters of name must be string or array of string or compute must be a function")},[]),f=s.useCallback((c,b)=>{if(!c)return u.subscribe("values",()=>b(t()));if(["onChange","onBlur"].includes(c))return u.subscribe(c,b);if(typeof c=="string"){const d=L(c);return u.subscribe(d,()=>b(t({name:c})))}if(Array.isArray(c)){const d=[];return c.forEach(m=>{const l=L(m),R=u.subscribe(l,()=>{b(t({name:c}))});d.push(R)}),()=>d.forEach(m=>m())}throw new Error("Parameters of name must be string or array of string")},[]);return{watch:i,registerHookWatcher:a,getWatchValue:t,subscribe:f}},xe=({getWatchValue:u})=>{const t=s.useRef(new Map),o=s.useRef(new Map),i=s.useCallback(()=>o.current,[]),a=s.useCallback(()=>t.current,[]),f=s.useCallback(()=>{t.current.clear(),o.current.clear()},[]),c=s.useCallback((l,...R)=>{const C=t.current.get(l),O=o.current.get(l);C&&C.forEach(S=>S(...R)),O&&O.forEach(S=>S(...R)),t.current.forEach((S,v)=>{if(v!==l&&l.startsWith(v)){const F=u({name:v.replace("values.","").replace("values","")});S.forEach(j=>j($(F,l.replace(`${v}.`,""),R[0])))}}),o.current.forEach((S,v)=>{if(v!==l&&l.startsWith(v)){const F=u({name:v.replace("values.","").replace("values","")});S.forEach(j=>j($(F,l.replace(`${v}.`,""),R[0])))}})},[]),b=s.useCallback(l=>{t.current.forEach((R,C)=>{C.startsWith(l)&&R.forEach(O=>O(u({name:C.replace("values.","").replace("values","")})))}),o.current.forEach((R,C)=>{C.startsWith(l)&&R.forEach(O=>O(u({name:C.replace("values.","").replace("values","")})))})},[]),d=s.useCallback((l,R)=>(t.current.has(l)||t.current.set(l,new Set),t.current.get(l).add(R),()=>{var C;return(C=t.current.get(l))==null?void 0:C.delete(R)}),[]),m=s.useCallback((l,R)=>{o.current.has(l)||(o.current.set(l,new Set),o.current.get(l).add(R))},[]);return{reset:f,publish:c,subscribe:d,subscribeWatch:m,getEvents:a,getWatchEvents:i,trigger:b}},$e=({defaultValues:u=_e,shouldUnRegister:t=!1}={})=>{const[o,i]=Pe(),a=s.useRef(),f=s.useRef(new Map),c=s.useRef({}),b=s.useRef({}),d=s.useRef({...Ee}),m=s.useRef({...u}),l=s.useRef({...u}),R=s.useRef(new Set),C=s.useCallback((e,n=l.current)=>Object.keys(n).reduce((E,h)=>{if(typeof n[h]=="object")return{...E,[h]:C(e,n[h])};const w={...e?{}:b.current[h]||{},...ae};return{...E,[h]:w}},{}),[]),O=s.useCallback((e={},{clearCustomFormStates:n=!1,clearCustomFieldStates:E=!1}={})=>{l.current={...l.current,...e},m.current={...l.current},f.current.forEach((h,w)=>{h(P(l.current,w)??"")}),c.current={},f.current=new Map,d.current={...n?{}:d.current,...Ee},b.current=C(E),y.reset(),i()},[]),S=s.useCallback(()=>{let e=Object.fromEntries(new FormData(a.current));f.current.forEach((E,h)=>{e=$(e,h,P(m.current,h))});let n={...m.current,...e};return me(n)},[]),v=s.useCallback(e=>ge(e.target),[]),F=s.useCallback(()=>l.current,[]),j=s.useCallback(()=>f.current,[]),N=s.useCallback((e,n)=>n?Array.isArray(n)?n.reduce((E,h)=>({...E,[h]:P(e,h)}),{}):P(e,n):{...e},[]),M=s.useCallback(e=>N(m.current,e),[N]),U=s.useCallback(e=>N(c.current,e),[N]),oe=s.useCallback(e=>N(b.current,e),[N]),Z=s.useCallback(e=>N({...d.current,lastReset:o},e),[o]),B=s.useCallback(({name:e,compute:n}={})=>!e&&!n||e==="values"?M():typeof n=="function"?n(M()):Array.isArray(e)?e.reduce((E,h)=>({...E,[h]:B({name:h})}),{}):P({...m.current,errors:c.current,fieldStates:b.current,formState:Z()},e),[]),y=xe({getWatchValue:B}),{watch:Q,registerHookWatcher:ue,subscribe:J}=De({getWatchValue:B,channels:y}),K=s.useCallback((e,n)=>{const E=d.current,h=P(E,e);h!==n&&(d.current=$(d.current,e,n),y.publish(`formState.${e}`,n,h))},[]),ee=s.useCallback((e,n)=>{x(e,"error",n)},[]),Y=s.useCallback(e=>{x(e,"error",null)},[]),re=s.useCallback(()=>{d.current.isError&&Object.keys(c.current).forEach(e=>Y(e))},[]),x=s.useCallback((e,n,E)=>{try{if(typeof E=="function"&&(E=E(B({name:e}))),R.current.has(e))if(typeof E=="object"&&E!==null){Object.keys(E).forEach(T=>{x(`${e}.${T}`,n,E[T])});return}else return console.error(`Cannot set primitive value for nested parent field "${e}". Please set value for its children or provide an object.`);const h=P(b.current,e)||{...ae},w=P(h,n);if(w!==E){if(b.current=$(b.current,`${e}.${n}`,E),y.publish(`fieldStates.${e}.${n}`,E,w),n==="error"){const T=P(c.current,e),I=E||null;T!==I&&(c.current=$(c.current,e,I),y.publish(`errors.${e}`,I,T));const V=Se(R.current,c.current);d.current.errorFields=V,y.publish("formState.errorFields",V);const ce=V.length>0;if(d.current.isError!==ce){const pe=d.current.isError;d.current.isError=ce,y.publish("formState.isError",ce,pe)}}if(n==="isDirty"){const T=Re(R.current,b.current);d.current.dirtyFields=T,y.publish("formState.dirtyFields",T);const I=T.length>0;if(d.current.isDirty!==I){const V=d.current.isDirty;d.current.isDirty=I,y.publish("formState.isDirty",I,V)}}if(n==="isTouched"){const T=ve(R.current,b.current);d.current.touchedFields=T,y.publish("formState.touchedFields",T)}}}catch(h){console.log(h)}},[]),te=s.useCallback(e=>{x(e,"isDirty",!1),x(e,"isTouched",!1),x(e,"error",!1)},[]),se=s.useCallback(e=>{const n=ge(e.target);n?ee(e.target.name,n):Y(e.target.name)},[]),z=s.useCallback((e,n,{shouldDirty:E=!0,shouldOnChange:h=!0}={})=>{if(typeof n=="function"&&(n=n(M(e))),R.current.has(e)){typeof n=="object"&&n!==null?Object.keys(n).forEach(V=>{z(`${e}.${V}`,n[V],{shouldDirty:E,shouldOnChange:h})}):console.error(`Cannot set primitive value for nested parent field "${e}". Please set value for its children or provide an object.`);return}const w=P(m.current,e);if(n===w)return;m.current=$(m.current,e,n),y.publish(`values.${e}`,n,w);const T=f.current.get(e);T&&T(n),n&&x(e,"isTouched",!0);const I=n!==(P(l.current,e)||"");E&&x(e,"isDirty",I),h&&y.publish("onChange",e,n,w)},[]),r=s.useCallback(e=>{const n=e.split(".");let E="";n.forEach((h,w)=>{w<n.length-1&&(E=E?`${E}.${h}`:h,R.current.add(E))})},[]),g=s.useCallback((e="",n)=>(f.current.set(e,n),b.current=$(b.current,e,{...ae}),e.includes(".")&&r(e),()=>{t&&f.current.delete(e)}),[]),p=s.useCallback((e,{keepError:n,keepDirty:E,keepTouched:h,defaultValue:w})=>{const T=f.current.get(e);if(!T)throw new Error(`Cannot reset "${e}" because it's uncontrolled field`);l.current=$(l.current,e,w),m.current=$(m.current,e,w),T&&T(w),n||Y(e),E||x(e,"isDirty",!1),h||x(e,"isTouched",!1)},[]),_=s.useCallback(e=>{if(!e)return y.trigger("values");if(!Array.isArray(e)){const n=L(e);y.trigger(n);return}e.forEach(n=>{const E=L(n);y.trigger(E)})},[]),W=s.useCallback((e,n=D.getValues(e))=>{y.publish("onBlur",e,n,D.getValues())},[]),D=s.useMemo(()=>({subscribe:J,reset:O,trigger:_,reload:i,resetField:p,setValue:z,getValues:M,getErrors:U,getFieldStates:oe,getFormState:Z,setError:ee,clearError:Y,clearErrors:re,checkValidity:se,getFieldValidity:v,getDefaultValues:F,setFieldState:x,triggerFieldBlur:W,resetFieldState:te,getControlledFields:j,setFormState:K,getEvents:y.getEvents,getWatchEvents:y.getWatchEvents}),[o]),q=s.useCallback(()=>{[...a.current.querySelectorAll("[name]")].forEach(E=>{const h=E.name||"";h.includes(".")&&r(h),!E.defaultValue&&!f.current.has(h)&&P(l.current,h)&&(E.defaultValue=P(l.current,h))});const n=S();m.current={...n},l.current={...n}},[]),G=s.useMemo(()=>({ref:a,watch:Q,actions:D,initForm:q,registerController:g,registerHookWatcher:ue,lastReloadedAt:o,loadFormValues:S,getWatchValue:B,channels:y}),[o]),A=s.useMemo(()=>({control:G,actions:D,watch:Q}),[o]);return s.useLayoutEffect(()=>{a.current&&q()},[o]),s.useLayoutEffect(()=>{b.current=C(!1)},[]),A};exports.Controller=we;exports.Form=Te;exports.restoreFromDotNotation=me;exports.useController=Ce;exports.useForm=$e;exports.useFormContext=le;exports.useWatch=je;
|