feature-form 0.0.59 → 0.1.0

package/dist/cjs/create-form.js

@@ -1 +1 @@
-"use strict";var g=require("@blgc/utils"),y=require("feature-state"),k=require("./form-field/create-form-field.js"),E=require("./form-field/is-form-field.js"),h=require("./types/form-field.js"),P=Object.defineProperty,M=Object.getOwnPropertySymbols,C=Object.prototype.hasOwnProperty,D=Object.prototype.propertyIsEnumerable,j=(s,l,i)=>l in s?P(s,l,{enumerable:!0,configurable:!0,writable:!0,value:i}):s[l]=i,w=(s,l)=>{for(var i in l||(l={}))C.call(l,i)&&j(s,i,l[i]);if(M)for(var i of M(l))D.call(l,i)&&j(s,i,l[i]);return s},p=(s,l,i)=>new Promise((V,v)=>{var F=o=>{try{u(i.next(o))}catch(e){v(e)}},S=o=>{try{u(i.throw(o))}catch(e){v(e)}},u=o=>o.done?V(o.value):Promise.resolve(o.value).then(F,S);u((i=i.apply(s,l)).next())});function I(s){const{fields:l,collectErrorMode:i="firstError",disabled:V=!1,validateMode:v=g.bitwiseFlag(h.FormFieldValidateMode.OnSubmit),reValidateMode:F=g.bitwiseFlag(h.FormFieldReValidateMode.OnBlur,h.FormFieldReValidateMode.OnSubmit),onValidSubmit:S,onInvalidSubmit:u,notifyOnStatusChange:o=!0}=s;return g.withNew({_features:[],_config:{disabled:V},_validSubmitCallbacks:S!=null?[S]:[],_invalidSubmitCallbacks:u!=null?[u]:[],fields:Object.fromEntries(Object.entries(l).map(([e,t])=>{var r,b,m,d;return[e,E.isFormField(t)?t:k.createFormField(t.defaultValue,{key:e,validator:t.validator,collectErrorMode:(r=t.collectErrorMode)!=null?r:i,validateMode:(b=t.validateMode)!=null?b:v,reValidateMode:(m=t.reValidateMode)!=null?m:F,editable:(d=t.editable)!=null?d:!0,notifyOnStatusChange:o})]})),isValid:y.createState(!1),isValidating:y.createState(!1),isSubmitted:y.createState(!1),isSubmitting:y.createState(!1),_new(){for(const e of Object.values(this.fields))e.status.listen(()=>p(this,null,function*(){yield this._revalidate(!0)}),{key:"form_revalidate"})},_revalidate(e=!1){return p(this,null,function*(){const t=Object.values(this.fields);return e||(this.isValidating.set(!0),yield Promise.all(t.map(r=>r.validate())),this.isValidating.set(!1)),this.isValid.set(t.every(r=>r.isValid())),this.isValid.get()})},submit(){return p(this,arguments,function*(e={}){const{context:t,assignToInitial:r=!1,onInvalidSubmit:b,onValidSubmit:m,postSubmitCallback:d}=e;this.isSubmitting.set(!0);const _=[];for(const a of Object.values(this.fields))a.isSubmitting.set(!0),(a.isSubmitted.get()&&a._config.reValidateMode.has(h.FormFieldReValidateMode.OnSubmit)||!a.isSubmitted.get()&&a._config.validateMode.has(h.FormFieldValidateMode.OnSubmit))&&_.push(a.validate());yield Promise.all(_),this._revalidate(!0);const c=this.getValidData(),f=[];if(c!=null){for(const a of this._validSubmitCallbacks)f.push(a(c,t));typeof m=="function"&&f.push(m(c,t))}else{const a=this.getErrors();for(const n of this._invalidSubmitCallbacks)f.push(n(a,t));typeof b=="function"&&f.push(b(a,t))}let O=null;d!=null?O=(yield Promise.all(f)).reduce((a,n)=>n!=null&&typeof n=="object"?w(w({},a),n):a,{}):yield Promise.all(f);for(const[a,n]of Object.entries(this.fields))c!=null&&Object.prototype.hasOwnProperty.call(c,a)&&r&&(n._intialValue=g.deepCopy(c[a])),n.isSubmitted.set(!0),n.isSubmitting.set(!1);return this.isSubmitted.set(!0),this.isSubmitting.set(!1),d==null||d(this,O!=null?O:{}),this.isValid.get()})},validate(){return p(this,null,function*(){return this._revalidate(!1)})},getField(e){return this.fields[e]},getValidData(){if(!this.isValid.get())return null;const e={};for(const[t,r]of Object.entries(this.fields))e[t]=r.get();return e},getErrors(){const e={};for(const[t,r]of Object.entries(this.fields))switch(r.status._v.type){case"INVALID":e[t]=r.status._v.errors;break;case"UNVALIDATED":e[t]=[{code:"unvalidated",message:`${t.toString()} was not yet validated!`,path:t}];break}return e},reset(){for(const e of Object.values(this.fields))e.reset();this.isSubmitted.set(!1),this._revalidate(!0)}})}exports.createForm=I;
+"use strict";var k=require("feature-core"),h=require("feature-state"),V=require("./create-form-field.js"),j=require("./lib/deep-copy.js"),I=require("./lib/standard-schema.js"),q=require("./lib/validation-status.js"),P=Object.defineProperty,w=Object.defineProperties,D=Object.getOwnPropertyDescriptors,O=Object.getOwnPropertySymbols,x=Object.prototype.hasOwnProperty,R=Object.prototype.propertyIsEnumerable,F=(t,i,e)=>i in t?P(t,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):t[i]=e,M=(t,i)=>{for(var e in i||(i={}))x.call(i,e)&&F(t,e,i[e]);if(O)for(var e of O(i))R.call(i,e)&&F(t,e,i[e]);return t},C=(t,i)=>w(t,D(i)),m=(t,i,e)=>new Promise((l,n)=>{var c=o=>{try{d(e.next(o))}catch(u){n(u)}},s=o=>{try{d(e.throw(o))}catch(u){n(u)}},d=o=>o.done?l(o.value):Promise.resolve(o.value).then(c,s);d((e=e.apply(t,i)).next())});function T(t){const{fields:i,validator:e,validateOn:l=["submit"],revalidateOn:n=["submit","change"],collectErrorMode:c="firstError",onInvalidSubmit:s,onValidSubmit:d}=t,o=e==null?{type:"valid"}:{type:"unvalidated"},u=k.createFeatureHost({_validation:e==null?void 0:{validator:e,config:{validateOn:l,revalidateOn:n,collectErrorMode:c}},_validationRunId:0,_formValidatorStatus:o,_callbacks:{invalidSubmit:s==null?[]:[s],validSubmit:d==null?[]:[d]},status:h.createState(o).with(h.isEqualFeature(q.areValidationStatusesEqual)),isValidating:h.createState(!1),isSubmitted:h.createState(!1),isSubmitting:h.createState(!1),fields:Object.fromEntries(Object.entries(i).map(([a,r])=>{var b,v,p;return[a,V.isFormField(r)?r:V.createFormField(r.defaultValue,{key:a,validator:r.validator,collectErrorMode:(b=r.collectErrorMode)!=null?b:c,revalidateOn:(v=r.revalidateOn)!=null?v:n,validateOn:(p=r.validateOn)!=null?p:l})]})),onValidSubmit(a){return this._callbacks.validSubmit.push(a),()=>{const r=this._callbacks.validSubmit.indexOf(a);r!==-1&&this._callbacks.validSubmit.splice(r,1)}},onInvalidSubmit(a){return this._callbacks.invalidSubmit.push(a),()=>{const r=this._callbacks.invalidSubmit.indexOf(a);r!==-1&&this._callbacks.invalidSubmit.splice(r,1)}},submit(){return m(this,arguments,function*(a={}){this.isSubmitting.set(!0);try{yield S(this,{shouldValidateField:v=>v._validation!=null&&(v.isSubmitted.get()?v._validation.config.revalidateOn.includes("submit"):v._validation.config.validateOn.includes("submit")),shouldValidateForm:this._validation!=null&&(this.isSubmitted.get()?this._validation.config.revalidateOn.includes("submit"):this._validation.config.validateOn.includes("submit"))});for(const v of f(this.fields))v.isSubmitted.set(!0);this.isSubmitted.set(!0);const r=this.getValidData();if(r!=null){if(a.updateDefaultValues)for(const[v,p]of _(this.fields))p.defaultValue=j.deepCopy(r[v]);return yield E(a.onValidSubmit!=null?[...this._callbacks.validSubmit,a.onValidSubmit]:this._callbacks.validSubmit,r,a.context),!0}const b=this.getErrors();return yield E(a.onInvalidSubmit!=null?[...this._callbacks.invalidSubmit,a.onInvalidSubmit]:this._callbacks.invalidSubmit,b,a.context),!1}finally{this.isSubmitting.set(!1)}})},validate(){return m(this,null,function*(){return S(this,{shouldValidateField:a=>a._validation!=null,shouldValidateForm:this._validation!=null})})},reset(){for(const a of f(this.fields))a.reset();this._validationRunId++,y(this,this._validation==null?{type:"valid"}:{type:"unvalidated"}),this.status.set(g(this)),this.isValidating.set(!1),this.isSubmitted.set(!1),this.isSubmitting.set(!1)},getField(a){return this.fields[a]},getData(){return Object.fromEntries(_(this.fields).map(([a,r])=>[a,r.get()]))},getValidData(){return this.status.get().type!=="valid"?null:this.getData()},getErrors(){return{fields:G(this.fields),form:this._formValidatorStatus.type==="invalid"?this._formValidatorStatus.errors:[]}}});return y(u,u._formValidatorStatus),u.status.set(g(u)),B(u),u}function B(t){for(const i of f(t.fields))i.status.listen(()=>{t.status.set(g(t))}),i.onBlur(({wasTouched:e})=>{t._validation!=null&&(t.isSubmitted.get()?t._validation.config.revalidateOn.includes("blur"):t._validation.config.validateOn.includes("blur")||!e&&t._validation.config.validateOn.includes("touched"))&&S(t,{shouldValidateField:()=>!1,shouldValidateForm:!0})}),i.listen(({source:e})=>{e===V.formFieldResetSourceKey||!(t._validation!=null&&(t.isSubmitted.get()?t._validation.config.revalidateOn.includes("change"):t._validation.config.validateOn.includes("change")||t._validation.config.validateOn.includes("touched")&&i.isTouched.get()))||S(t,{shouldValidateField:()=>!1,shouldValidateForm:!0})})}function S(t,i){return m(this,null,function*(){const{shouldValidateField:e,shouldValidateForm:l}=i,n=f(t.fields).filter(e).map(o=>o.validate()),c=n.length>0||l,s=c?++t._validationRunId:null;c&&t.isValidating.set(!0);try{yield Promise.all([...n,...l&&s!=null?[K(t,s)]:[]])}finally{s!=null&&s===t._validationRunId&&t.isValidating.set(!1)}const d=g(t);return t.status.set(d),d.type==="valid"})}function K(t,i){return m(this,null,function*(){if(t._validation==null){y(t,{type:"valid"});return}let e={type:"valid"};try{e=yield I.validateStandardSchema(t._validation.validator,t.getData(),t._validation.config.collectErrorMode)}catch(l){e={type:"invalid",errors:[{message:l instanceof Error?l.message:String(l),path:["form"]}]}}i===t._validationRunId&&y(t,e)})}function g(t){const i=[];let e=!1;for(const l of f(t.fields)){const n=l.status.get();n.type==="invalid"?i.push(...n.errors):n.type==="unvalidated"&&(e=!0)}return t._formValidatorStatus.type==="invalid"?i.push(...t._formValidatorStatus.errors):t._formValidatorStatus.type==="unvalidated"&&(e=!0),i.length>0?{type:"invalid",errors:i}:e?{type:"unvalidated"}:{type:"valid"}}function y(t,i){var e,l;if(i.type!=="invalid"){t._formValidatorStatus=i;for(const s of f(t.fields))s._applyFormValidatorErrors([]);return}const n={},c=[];for(const s of i.errors){const d=s.path;if(d==null){c.push(s);continue}const o=d[0];if(typeof o!="string"||!(o in t.fields)){c.push(s);continue}const u=d.slice(1);n[o]=[...(e=n[o])!=null?e:[],C(M({},s),{path:u.length>0?u:void 0})]}t._formValidatorStatus=c.length>0?{type:"invalid",errors:c}:{type:"valid"};for(const[s,d]of _(t.fields))d._applyFormValidatorErrors((l=n[s])!=null?l:[])}function G(t){const i={};for(const[e,l]of _(t)){const n=l.status.get();n.type==="invalid"&&(i[e]=n.errors)}return i}function E(t,i,e){return m(this,null,function*(){yield Promise.all(t.map(l=>l(i,e)))})}function f(t){return Object.values(t)}function _(t){return Object.entries(t)}exports.createForm=T;

package/dist/cjs/features/dirty.js

@@ -0,0 +1 @@
+"use strict";var p=require("feature-core"),l=require("feature-state"),j=require("../lib/deep-copy.js"),O=(e,t,r)=>new Promise((u,i)=>{var s=o=>{try{n(r.next(o))}catch(c){i(c)}},a=o=>{try{n(r.throw(o))}catch(c){i(c)}},n=o=>o.done?u(o.value):Promise.resolve(o.value).then(s,a);n((r=r.apply(e,t)).next())});function m(e={}){const{isEqual:t=f}=e;return p.defineFeature({key:"dirty",overrides:["submit"],install(r){const u=l.createState(y(r,t)),i=l.createState(d(u.get())),s=()=>{const n=y(r,t);g(u.get(),n)||u.set(n),i.set(d(n))},a=r.submit.bind(r);for(const n of v(r.fields))n.listen(s);return{isDirty:i,dirtyFields:u,resetDirty(){for(const n of v(r.fields))n.defaultValue=j.deepCopy(n.get());s()},submit(n){return O(this,null,function*(){try{return yield a(n)}finally{s()}})}}}})}function y(e,t){return Object.fromEntries(h(e.fields).map(([r,u])=>[r,!t(u.get(),u.defaultValue)]))}function d(e){return Object.values(e).some(t=>t)}function g(e,t){for(const r of Object.keys(t))if(e[r]!==t[r])return!1;return!0}function f(e,t){if(Object.is(e,t))return!0;if(Array.isArray(e)&&Array.isArray(t))return e.length!==t.length?!1:e.every((i,s)=>f(i,t[s]));if(!b(e)||!b(t))return!1;const r=Object.keys(e),u=Object.keys(t);return r.length!==u.length?!1:r.every(i=>i in t&&f(e[i],t[i]))}function b(e){return typeof e=="object"&&e!=null&&Object.getPrototypeOf(e)===Object.prototype}function v(e){return Object.values(e)}function h(e){return Object.entries(e)}exports.dirtyFeature=m;

package/dist/cjs/index.js

@@ -1 +1 @@
-"use strict";var e=require("@blgc/utils"),t=require("./create-form.js"),i=require("./form-field/create-form-field.js"),a=require("./form-field/create-status.js"),F=require("./form-field/is-form-field.js"),o=require("./form-field/is-form-field-status.js"),m=require("./helper/from-validator.js"),d=require("./helper/has-form-changed.js"),u=require("./helper/reset-form-submitted.js"),s=require("./is-form-with-features.js"),r=require("./types/form-field.js");Object.defineProperty(exports,"BitwiseFlag",{enumerable:!0,get:function(){return e.BitwiseFlag}}),Object.defineProperty(exports,"bitwiseFlag",{enumerable:!0,get:function(){return e.bitwiseFlag}}),exports.createForm=t.createForm,exports.createFormField=i.createFormField,exports.createStatus=a.createStatus,exports.isFormField=F.isFormField,exports.isFormFieldStatus=o.isFormFieldStatus,exports.fromValidator=m.fromValidator,exports.hasFormChanged=d.hasFormChanged,exports.resetFormSubmitted=u.resetFormSubmitted,exports.isFormWithFeatures=s.isFormWithFeatures,exports.FormFieldReValidateMode=r.FormFieldReValidateMode,exports.FormFieldValidateMode=r.FormFieldValidateMode;
+"use strict";var r=require("./create-form.js"),F=require("./features/dirty.js"),e=require("./create-form-field.js");exports.createForm=r.createForm,exports.dirtyFeature=F.dirtyFeature,exports.createFormField=e.createFormField,exports.formFieldResetSourceKey=e.formFieldResetSourceKey,exports.isFormField=e.isFormField;

package/dist/cjs/lib/deep-copy.js

@@ -0,0 +1 @@
+"use strict";function o(e){if(typeof e!="object"||e==null)return e;if(Array.isArray(e))return e.map(r=>o(r));if(Object.getPrototypeOf(e)!==Object.prototype)return e;const t={};for(const r of Object.keys(e))t[r]=o(e[r]);return t}exports.deepCopy=o;

package/dist/cjs/lib/standard-schema.js

@@ -0,0 +1 @@
+"use strict";var o=(e,t,n)=>new Promise((r,l)=>{var c=a=>{try{i(n.next(a))}catch(s){l(s)}},u=a=>{try{i(n.throw(a))}catch(s){l(s)}},i=a=>a.done?r(a.value):Promise.resolve(a.value).then(c,u);i((n=n.apply(e,t)).next())});function h(e,t,n){return o(this,null,function*(){const{issues:r}=yield e["~standard"].validate(t);return r!=null&&r.length?{type:"invalid",errors:(n==="firstError"?r.slice(0,1):r).map(l=>({message:l.message,path:d(l.path)}))}:{type:"valid"}})}function d(e){if(e!=null&&e.length)return e.map(t=>typeof t=="object"&&"key"in t?t.key:t)}exports.validateStandardSchema=h;

package/dist/cjs/lib/validation-status.js

@@ -0,0 +1 @@
+"use strict";function s(t,e){return t.type!==e.type?!1:t.type!=="invalid"||e.type!=="invalid"?!0:i(t.errors,e.errors)}function i(t,e){return t.length!==e.length?!1:t.every((n,r)=>{var l,u;return n.message===((l=e[r])==null?void 0:l.message)&&a(n.path,(u=e[r])==null?void 0:u.path)})}function a(t,e){return t==null||e==null?t==null&&e==null:t.length!==e.length?!1:t.every((n,r)=>Object.is(n,e[r]))}exports.areValidationStatusesEqual=s;

package/dist/esm/create-form-field.js

@@ -0,0 +1 @@
+import{hasFeature as f,defineFeature as _}from"feature-core";import{createState as d,isEqualFeature as m}from"feature-state";import{deepCopy as v}from"./lib/deep-copy.js";import{validateStandardSchema as g}from"./lib/standard-schema.js";import{areValidationStatusesEqual as p}from"./lib/validation-status.js";var y=(t,e,s)=>new Promise((n,r)=>{var i=o=>{try{l(s.next(o))}catch(c){r(c)}},a=o=>{try{l(s.throw(o))}catch(c){r(c)}},l=o=>o.done?n(o.value):Promise.resolve(o.value).then(i,a);l((s=s.apply(t,e)).next())});function V(t,e){const{key:s,validator:n,validateOn:r=["submit"],revalidateOn:i=["submit","change"],collectErrorMode:a="firstError"}=e,l=d(t).with(S({key:s,validation:n==null?void 0:{validator:n,config:{validateOn:r,revalidateOn:i,collectErrorMode:a}}}));return E(l),l}function b(t){return f(t,"form-field")}function S(t){const{key:e,validation:s}=t;return _({key:"form-field",install(n){const r=s==null?{type:"valid"}:{type:"unvalidated"};return{_validation:s,_validationRunId:0,_fieldValidatorStatus:r,_formValidatorErrors:[],_callbacks:{blur:[]},key:e,defaultValue:v(n._v),isTouched:d(!1),isSubmitted:d(!1),isValidating:d(!1),status:d(r).with(m(p)),_applyFormValidatorErrors(i){this._formValidatorErrors=i,this.status.set(u(this))},validate(){return y(this,null,function*(){if(this._validation==null)return this._fieldValidatorStatus={type:"valid"},this.status.set(u(this)),this.status.get().type==="valid";const i=++this._validationRunId;let a={type:"valid"};this.isValidating.set(!0);try{a=yield g(this._validation.validator,this.get(),this._validation.config.collectErrorMode)}catch(l){a={type:"invalid",errors:[{message:l instanceof Error?l.message:String(l)}]}}finally{i===this._validationRunId&&this.isValidating.set(!1)}return i!==this._validationRunId?this.status.get().type==="valid":(this._fieldValidatorStatus=a,this.status.set(u(this)),this.status.get().type==="valid")})},onBlur(i){return this._callbacks.blur.push(i),()=>{const a=this._callbacks.blur.indexOf(i);a!==-1&&this._callbacks.blur.splice(a,1)}},blur(){const i=this.isTouched.get();this._validation!=null&&(this.isSubmitted.get()?this._validation.config.revalidateOn.includes("blur"):this._validation.config.validateOn.includes("blur")||this._validation.config.validateOn.includes("touched")&&!i)&&this.validate(),this.isTouched.set(!0);for(const a of this._callbacks.blur)a({wasTouched:i})},reset(){this.set(v(this.defaultValue),{listenerContext:{source:h}}),this._validationRunId++,this.isTouched.set(!1),this.isSubmitted.set(!1),this.isValidating.set(!1),this._formValidatorErrors=[],this._fieldValidatorStatus=this._validation==null?{type:"valid"}:{type:"unvalidated"},this.status.set(u(this))}}}})}const h="formFieldReset";function E(t){t.listen(({source:e})=>{e!==h&&t._validation!=null&&(t.isSubmitted.get()?t._validation.config.revalidateOn.includes("change"):t._validation.config.validateOn.includes("change")||t._validation.config.validateOn.includes("touched")&&t.isTouched.get())&&t.validate()})}function u(t){const e=t._fieldValidatorStatus.type==="invalid"?[...t._fieldValidatorStatus.errors,...t._formValidatorErrors]:t._formValidatorErrors;return e.length>0?{type:"invalid",errors:e}:t._fieldValidatorStatus}export{V as createFormField,h as formFieldResetSourceKey,b as isFormField};

package/dist/esm/create-form.js

@@ -1 +1 @@
-import{bitwiseFlag as j,withNew as E,deepCopy as P}from"@blgc/utils";import{createState as p}from"feature-state";import{createFormField as C}from"./form-field/create-form-field.js";import{isFormField as D}from"./form-field/is-form-field.js";import{FormFieldValidateMode as w,FormFieldReValidateMode as V}from"./types/form-field.js";var I=Object.defineProperty,M=Object.getOwnPropertySymbols,x=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable,F=(r,s,i)=>s in r?I(r,s,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[s]=i,k=(r,s)=>{for(var i in s||(s={}))x.call(s,i)&&F(r,i,s[i]);if(M)for(var i of M(s))A.call(s,i)&&F(r,i,s[i]);return r},g=(r,s,i)=>new Promise((y,h)=>{var S=o=>{try{u(i.next(o))}catch(t){h(t)}},v=o=>{try{u(i.throw(o))}catch(t){h(t)}},u=o=>o.done?y(o.value):Promise.resolve(o.value).then(S,v);u((i=i.apply(r,s)).next())});function N(r){const{fields:s,collectErrorMode:i="firstError",disabled:y=!1,validateMode:h=j(w.OnSubmit),reValidateMode:S=j(V.OnBlur,V.OnSubmit),onValidSubmit:v,onInvalidSubmit:u,notifyOnStatusChange:o=!0}=r;return E({_features:[],_config:{disabled:y},_validSubmitCallbacks:v!=null?[v]:[],_invalidSubmitCallbacks:u!=null?[u]:[],fields:Object.fromEntries(Object.entries(s).map(([t,e])=>{var a,b,m,d;return[t,D(e)?e:C(e.defaultValue,{key:t,validator:e.validator,collectErrorMode:(a=e.collectErrorMode)!=null?a:i,validateMode:(b=e.validateMode)!=null?b:h,reValidateMode:(m=e.reValidateMode)!=null?m:S,editable:(d=e.editable)!=null?d:!0,notifyOnStatusChange:o})]})),isValid:p(!1),isValidating:p(!1),isSubmitted:p(!1),isSubmitting:p(!1),_new(){for(const t of Object.values(this.fields))t.status.listen(()=>g(this,null,function*(){yield this._revalidate(!0)}),{key:"form_revalidate"})},_revalidate(t=!1){return g(this,null,function*(){const e=Object.values(this.fields);return t||(this.isValidating.set(!0),yield Promise.all(e.map(a=>a.validate())),this.isValidating.set(!1)),this.isValid.set(e.every(a=>a.isValid())),this.isValid.get()})},submit(){return g(this,arguments,function*(t={}){const{context:e,assignToInitial:a=!1,onInvalidSubmit:b,onValidSubmit:m,postSubmitCallback:d}=t;this.isSubmitting.set(!0);const _=[];for(const l of Object.values(this.fields))l.isSubmitting.set(!0),(l.isSubmitted.get()&&l._config.reValidateMode.has(V.OnSubmit)||!l.isSubmitted.get()&&l._config.validateMode.has(w.OnSubmit))&&_.push(l.validate());yield Promise.all(_),this._revalidate(!0);const f=this.getValidData(),c=[];if(f!=null){for(const l of this._validSubmitCallbacks)c.push(l(f,e));typeof m=="function"&&c.push(m(f,e))}else{const l=this.getErrors();for(const n of this._invalidSubmitCallbacks)c.push(n(l,e));typeof b=="function"&&c.push(b(l,e))}let O=null;d!=null?O=(yield Promise.all(c)).reduce((l,n)=>n!=null&&typeof n=="object"?k(k({},l),n):l,{}):yield Promise.all(c);for(const[l,n]of Object.entries(this.fields))f!=null&&Object.prototype.hasOwnProperty.call(f,l)&&a&&(n._intialValue=P(f[l])),n.isSubmitted.set(!0),n.isSubmitting.set(!1);return this.isSubmitted.set(!0),this.isSubmitting.set(!1),d==null||d(this,O!=null?O:{}),this.isValid.get()})},validate(){return g(this,null,function*(){return this._revalidate(!1)})},getField(t){return this.fields[t]},getValidData(){if(!this.isValid.get())return null;const t={};for(const[e,a]of Object.entries(this.fields))t[e]=a.get();return t},getErrors(){const t={};for(const[e,a]of Object.entries(this.fields))switch(a.status._v.type){case"INVALID":t[e]=a.status._v.errors;break;case"UNVALIDATED":t[e]=[{code:"unvalidated",message:`${e.toString()} was not yet validated!`,path:e}];break}return t},reset(){for(const t of Object.values(this.fields))t.reset();this.isSubmitted.set(!1),this._revalidate(!0)}})}export{N as createForm};
+import{createFeatureHost as E}from"feature-core";import{createState as p,isEqualFeature as k}from"feature-state";import{isFormField as j,createFormField as I,formFieldResetSourceKey as P}from"./create-form-field.js";import{deepCopy as w}from"./lib/deep-copy.js";import{validateStandardSchema as x}from"./lib/standard-schema.js";import{areValidationStatusesEqual as D}from"./lib/validation-status.js";var R=Object.defineProperty,M=Object.defineProperties,T=Object.getOwnPropertyDescriptors,V=Object.getOwnPropertySymbols,q=Object.prototype.hasOwnProperty,B=Object.prototype.propertyIsEnumerable,O=(t,i,a)=>i in t?R(t,i,{enumerable:!0,configurable:!0,writable:!0,value:a}):t[i]=a,C=(t,i)=>{for(var a in i||(i={}))q.call(i,a)&&O(t,a,i[a]);if(V)for(var a of V(i))B.call(i,a)&&O(t,a,i[a]);return t},K=(t,i)=>M(t,T(i)),m=(t,i,a)=>new Promise((l,n)=>{var c=o=>{try{d(a.next(o))}catch(u){n(u)}},r=o=>{try{d(a.throw(o))}catch(u){n(u)}},d=o=>o.done?l(o.value):Promise.resolve(o.value).then(c,r);d((a=a.apply(t,i)).next())});function G(t){const{fields:i,validator:a,validateOn:l=["submit"],revalidateOn:n=["submit","change"],collectErrorMode:c="firstError",onInvalidSubmit:r,onValidSubmit:d}=t,o=a==null?{type:"valid"}:{type:"unvalidated"},u=E({_validation:a==null?void 0:{validator:a,config:{validateOn:l,revalidateOn:n,collectErrorMode:c}},_validationRunId:0,_formValidatorStatus:o,_callbacks:{invalidSubmit:r==null?[]:[r],validSubmit:d==null?[]:[d]},status:p(o).with(k(D)),isValidating:p(!1),isSubmitted:p(!1),isSubmitting:p(!1),fields:Object.fromEntries(Object.entries(i).map(([e,s])=>{var h,f,b;return[e,j(s)?s:I(s.defaultValue,{key:e,validator:s.validator,collectErrorMode:(h=s.collectErrorMode)!=null?h:c,revalidateOn:(f=s.revalidateOn)!=null?f:n,validateOn:(b=s.validateOn)!=null?b:l})]})),onValidSubmit(e){return this._callbacks.validSubmit.push(e),()=>{const s=this._callbacks.validSubmit.indexOf(e);s!==-1&&this._callbacks.validSubmit.splice(s,1)}},onInvalidSubmit(e){return this._callbacks.invalidSubmit.push(e),()=>{const s=this._callbacks.invalidSubmit.indexOf(e);s!==-1&&this._callbacks.invalidSubmit.splice(s,1)}},submit(){return m(this,arguments,function*(e={}){this.isSubmitting.set(!0);try{yield g(this,{shouldValidateField:f=>f._validation!=null&&(f.isSubmitted.get()?f._validation.config.revalidateOn.includes("submit"):f._validation.config.validateOn.includes("submit")),shouldValidateForm:this._validation!=null&&(this.isSubmitted.get()?this._validation.config.revalidateOn.includes("submit"):this._validation.config.validateOn.includes("submit"))});for(const f of v(this.fields))f.isSubmitted.set(!0);this.isSubmitted.set(!0);const s=this.getValidData();if(s!=null){if(e.updateDefaultValues)for(const[f,b]of _(this.fields))b.defaultValue=w(s[f]);return yield F(e.onValidSubmit!=null?[...this._callbacks.validSubmit,e.onValidSubmit]:this._callbacks.validSubmit,s,e.context),!0}const h=this.getErrors();return yield F(e.onInvalidSubmit!=null?[...this._callbacks.invalidSubmit,e.onInvalidSubmit]:this._callbacks.invalidSubmit,h,e.context),!1}finally{this.isSubmitting.set(!1)}})},validate(){return m(this,null,function*(){return g(this,{shouldValidateField:e=>e._validation!=null,shouldValidateForm:this._validation!=null})})},reset(){for(const e of v(this.fields))e.reset();this._validationRunId++,S(this,this._validation==null?{type:"valid"}:{type:"unvalidated"}),this.status.set(y(this)),this.isValidating.set(!1),this.isSubmitted.set(!1),this.isSubmitting.set(!1)},getField(e){return this.fields[e]},getData(){return Object.fromEntries(_(this.fields).map(([e,s])=>[e,s.get()]))},getValidData(){return this.status.get().type!=="valid"?null:this.getData()},getErrors(){return{fields:z(this.fields),form:this._formValidatorStatus.type==="invalid"?this._formValidatorStatus.errors:[]}}});return S(u,u._formValidatorStatus),u.status.set(y(u)),H(u),u}function H(t){for(const i of v(t.fields))i.status.listen(()=>{t.status.set(y(t))}),i.onBlur(({wasTouched:a})=>{t._validation!=null&&(t.isSubmitted.get()?t._validation.config.revalidateOn.includes("blur"):t._validation.config.validateOn.includes("blur")||!a&&t._validation.config.validateOn.includes("touched"))&&g(t,{shouldValidateField:()=>!1,shouldValidateForm:!0})}),i.listen(({source:a})=>{a===P||!(t._validation!=null&&(t.isSubmitted.get()?t._validation.config.revalidateOn.includes("change"):t._validation.config.validateOn.includes("change")||t._validation.config.validateOn.includes("touched")&&i.isTouched.get()))||g(t,{shouldValidateField:()=>!1,shouldValidateForm:!0})})}function g(t,i){return m(this,null,function*(){const{shouldValidateField:a,shouldValidateForm:l}=i,n=v(t.fields).filter(a).map(o=>o.validate()),c=n.length>0||l,r=c?++t._validationRunId:null;c&&t.isValidating.set(!0);try{yield Promise.all([...n,...l&&r!=null?[N(t,r)]:[]])}finally{r!=null&&r===t._validationRunId&&t.isValidating.set(!1)}const d=y(t);return t.status.set(d),d.type==="valid"})}function N(t,i){return m(this,null,function*(){if(t._validation==null){S(t,{type:"valid"});return}let a={type:"valid"};try{a=yield x(t._validation.validator,t.getData(),t._validation.config.collectErrorMode)}catch(l){a={type:"invalid",errors:[{message:l instanceof Error?l.message:String(l),path:["form"]}]}}i===t._validationRunId&&S(t,a)})}function y(t){const i=[];let a=!1;for(const l of v(t.fields)){const n=l.status.get();n.type==="invalid"?i.push(...n.errors):n.type==="unvalidated"&&(a=!0)}return t._formValidatorStatus.type==="invalid"?i.push(...t._formValidatorStatus.errors):t._formValidatorStatus.type==="unvalidated"&&(a=!0),i.length>0?{type:"invalid",errors:i}:a?{type:"unvalidated"}:{type:"valid"}}function S(t,i){var a,l;if(i.type!=="invalid"){t._formValidatorStatus=i;for(const r of v(t.fields))r._applyFormValidatorErrors([]);return}const n={},c=[];for(const r of i.errors){const d=r.path;if(d==null){c.push(r);continue}const o=d[0];if(typeof o!="string"||!(o in t.fields)){c.push(r);continue}const u=d.slice(1);n[o]=[...(a=n[o])!=null?a:[],K(C({},r),{path:u.length>0?u:void 0})]}t._formValidatorStatus=c.length>0?{type:"invalid",errors:c}:{type:"valid"};for(const[r,d]of _(t.fields))d._applyFormValidatorErrors((l=n[r])!=null?l:[])}function z(t){const i={};for(const[a,l]of _(t)){const n=l.status.get();n.type==="invalid"&&(i[a]=n.errors)}return i}function F(t,i,a){return m(this,null,function*(){yield Promise.all(t.map(l=>l(i,a)))})}function v(t){return Object.values(t)}function _(t){return Object.entries(t)}export{G as createForm};

package/dist/esm/features/dirty.js

@@ -0,0 +1 @@
+import{defineFeature as p}from"feature-core";import{createState as a}from"feature-state";import{deepCopy as j}from"../lib/deep-copy.js";var O=(e,t,r)=>new Promise((o,i)=>{var u=s=>{try{n(r.next(s))}catch(l){i(l)}},f=s=>{try{n(r.throw(s))}catch(l){i(l)}},n=s=>s.done?o(s.value):Promise.resolve(s.value).then(u,f);n((r=r.apply(e,t)).next())});function v(e={}){const{isEqual:t=c}=e;return p({key:"dirty",overrides:["submit"],install(r){const o=a(y(r,t)),i=a(b(o.get())),u=()=>{const n=y(r,t);g(o.get(),n)||o.set(n),i.set(b(n))},f=r.submit.bind(r);for(const n of d(r.fields))n.listen(u);return{isDirty:i,dirtyFields:o,resetDirty(){for(const n of d(r.fields))n.defaultValue=j(n.get());u()},submit(n){return O(this,null,function*(){try{return yield f(n)}finally{u()}})}}}})}function y(e,t){return Object.fromEntries(h(e.fields).map(([r,o])=>[r,!t(o.get(),o.defaultValue)]))}function b(e){return Object.values(e).some(t=>t)}function g(e,t){for(const r of Object.keys(t))if(e[r]!==t[r])return!1;return!0}function c(e,t){if(Object.is(e,t))return!0;if(Array.isArray(e)&&Array.isArray(t))return e.length!==t.length?!1:e.every((i,u)=>c(i,t[u]));if(!m(e)||!m(t))return!1;const r=Object.keys(e),o=Object.keys(t);return r.length!==o.length?!1:r.every(i=>i in t&&c(e[i],t[i]))}function m(e){return typeof e=="object"&&e!=null&&Object.getPrototypeOf(e)===Object.prototype}function d(e){return Object.values(e)}function h(e){return Object.entries(e)}export{v as dirtyFeature};

package/dist/esm/index.js

@@ -1 +1 @@
-import{BitwiseFlag as o,bitwiseFlag as t}from"@blgc/utils";import{createForm as i}from"./create-form.js";import{createFormField as a}from"./form-field/create-form-field.js";import{createStatus as f}from"./form-field/create-status.js";import{isFormField as x}from"./form-field/is-form-field.js";import{isFormFieldStatus as s}from"./form-field/is-form-field-status.js";import{fromValidator as c}from"./helper/from-validator.js";import{hasFormChanged as h}from"./helper/has-form-changed.js";import{resetFormSubmitted as V}from"./helper/reset-form-submitted.js";import{isFormWithFeatures as w}from"./is-form-with-features.js";import{FormFieldReValidateMode as n,FormFieldValidateMode as B}from"./types/form-field.js";export{o as BitwiseFlag,n as FormFieldReValidateMode,B as FormFieldValidateMode,t as bitwiseFlag,i as createForm,a as createFormField,f as createStatus,c as fromValidator,h as hasFormChanged,x as isFormField,s as isFormFieldStatus,w as isFormWithFeatures,V as resetFormSubmitted};
+import{createForm as o}from"./create-form.js";import{dirtyFeature as m}from"./features/dirty.js";import{createFormField as i,formFieldResetSourceKey as d,isFormField as f}from"./create-form-field.js";export{o as createForm,i as createFormField,m as dirtyFeature,d as formFieldResetSourceKey,f as isFormField};

package/dist/esm/lib/deep-copy.js

@@ -0,0 +1 @@
+function o(e){if(typeof e!="object"||e==null)return e;if(Array.isArray(e))return e.map(r=>o(r));if(Object.getPrototypeOf(e)!==Object.prototype)return e;const t={};for(const r of Object.keys(e))t[r]=o(e[r]);return t}export{o as deepCopy};

package/dist/esm/lib/standard-schema.js

@@ -0,0 +1 @@
+var c=(t,e,a)=>new Promise((r,l)=>{var o=n=>{try{i(a.next(n))}catch(s){l(s)}},u=n=>{try{i(a.throw(n))}catch(s){l(s)}},i=n=>n.done?r(n.value):Promise.resolve(n.value).then(o,u);i((a=a.apply(t,e)).next())});function h(t,e,a){return c(this,null,function*(){const{issues:r}=yield t["~standard"].validate(e);return r!=null&&r.length?{type:"invalid",errors:(a==="firstError"?r.slice(0,1):r).map(l=>({message:l.message,path:p(l.path)}))}:{type:"valid"}})}function p(t){if(t!=null&&t.length)return t.map(e=>typeof e=="object"&&"key"in e?e.key:e)}export{h as validateStandardSchema};

package/dist/esm/lib/validation-status.js

@@ -0,0 +1 @@
+function s(n,e){return n.type!==e.type?!1:n.type!=="invalid"||e.type!=="invalid"?!0:i(n.errors,e.errors)}function i(n,e){return n.length!==e.length?!1:n.every((t,r)=>{var l,u;return t.message===((l=e[r])==null?void 0:l.message)&&o(t.path,(u=e[r])==null?void 0:u.path)})}function o(n,e){return n==null||e==null?n==null&&e==null:n.length!==e.length?!1:n.every((t,r)=>Object.is(t,e[r]))}export{s as areValidationStatusesEqual};

package/dist/types/create-form-field.d.ts

@@ -0,0 +1,18 @@
+import { type TFormField, type TFormFieldValidationConfig, type TFormFieldValidator } from './types';
+/**
+ * Creates a standalone reactive form field.
+ *
+ * Use this when a field should exist independently of a specific form, for example a shared
+ * search input or a field composed into different forms. Pass the result directly into
+ * `createForm`'s `fields` config.
+ */
+export declare function createFormField<GValue>(defaultValue: GValue, config: TCreateFormFieldConfig<GValue>): TFormField<GValue>;
+export interface TCreateFormFieldConfig<GValue> extends Partial<TFormFieldValidationConfig> {
+    /** Stable field key used in validation contexts and form error paths. */
+    key: string;
+    /** Optional field-level Standard Schema validator. */
+    validator?: TFormFieldValidator<GValue>;
+}
+export declare function isFormField<GValue = unknown>(value: unknown): value is TFormField<GValue>;
+/** Identifies listener events caused by field reset so validation can ignore reset changes. */
+export declare const formFieldResetSourceKey = "formFieldReset";

package/dist/types/create-form.d.ts

@@ -1,35 +1,54 @@
-import { type BitwiseFlag } from '@blgc/utils';
-import { TCollectErrorMode } from 'validation-adapter';
-import { FormFieldReValidateMode, FormFieldValidateMode, TFormField, type TForm, type TFormConfig, type TFormData, type TFormFieldStateConfig, type TFormFieldValidator, type TInvalidSubmitCallback, type TValidSubmitCallback } from './types';
+import { type TForm, type TFormData, type TFormField, type TFormFieldKey, type TFormFieldValidationConfig, type TFormFieldValidator, type TFormInvalidSubmitCallback, type TFormValidationConfig, type TFormValidator, type TFormValidSubmitCallback } from './types';
+/**
+ * Creates a reactive form.
+ *
+ * Each field is a reactive state with its own `status`, `isTouched`, and `isSubmitted` states.
+ * Field configs in `fields` are upgraded to reactive form fields automatically.
+ * Validators must implement the Standard Schema interface (Zod, Valibot, or custom).
+ * Extend the form with features using `.with(feature())`.
+ */
+export declare function createForm<GFields extends TCreateFormFieldsInput>(config: TCreateFormConfig<TCreateFormDataFromFields<GFields>> & {
+    fields: GFields;
+}): TForm<TCreateFormDataFromFields<GFields>, []>;
+/** Creates a form from field configs or existing form fields. */
 export declare function createForm<GFormData extends TFormData>(config: TCreateFormConfig<GFormData>): TForm<GFormData, []>;
-export interface TCreateFormConfig<GFormData extends TFormData> extends Partial<TFormConfig> {
-    /**
-     * Form fields
-     */
+export interface TCreateFormConfig<GFormData extends TFormData> {
+    /** Field configs or pre-built form fields keyed by form data property. */
     fields: TCreateFormConfigFormFields<GFormData>;
-    /**
-     * Error collection mode. 'firstError' gathers only the first error per field, 'all' gathers all errors.
-     */
-    collectErrorMode?: TCollectErrorMode;
-    /**
-     * Validation strategy **before** submitting.
-     */
-    validateMode?: BitwiseFlag<FormFieldValidateMode>;
-    /**
-     * Validation strategy **after** submitting.
-     */
-    reValidateMode?: BitwiseFlag<FormFieldReValidateMode>;
-    /**
-     * Whether to notify the form field if its status has changed
-     */
-    notifyOnStatusChange?: boolean;
-    onInvalidSubmit?: TInvalidSubmitCallback<GFormData>;
-    onValidSubmit?: TValidSubmitCallback<GFormData>;
+    /** Optional form-level validator for cross-field constraints. */
+    validator?: TFormValidator<NoInfer<GFormData>>;
+    /** Default validation triggers for the form validator and fields that do not override them. */
+    validateOn?: TFormValidationConfig['validateOn'];
+    /** Default revalidation triggers for the form validator and fields that do not override them. */
+    revalidateOn?: TFormValidationConfig['revalidateOn'];
+    /** Default error collection mode for the form validator and fields that do not override it. */
+    collectErrorMode?: TFormValidationConfig['collectErrorMode'];
+    /** Called on every valid submit. Per-call overrides can be passed directly to `submit()`. */
+    onValidSubmit?: TFormValidSubmitCallback<GFormData>;
+    /** Called on every invalid submit. Per-call overrides can be passed directly to `submit()`. */
+    onInvalidSubmit?: TFormInvalidSubmitCallback<GFormData>;
 }
+/** Maps each form data property to a form field config or an existing form field. */
 export type TCreateFormConfigFormFields<GFormData extends TFormData> = {
-    [Key in keyof GFormData]: TCreateFormConfigFormField<GFormData[Key]> | TFormField<GFormData[Key]>;
+    [Key in TFormFieldKey<GFormData>]: TCreateFormConfigFormField<GFormData[Key]> | TFormField<GFormData[Key]>;
 };
-export interface TCreateFormConfigFormField<GValue> extends Partial<TFormFieldStateConfig> {
-    defaultValue?: GValue;
-    validator?: TFormFieldValidator<GValue>;
+/** Infers form data from field configs and existing form fields passed to `createForm()`. */
+export type TCreateFormDataFromFields<GFields extends TCreateFormFieldsInput> = {
+    [Key in Extract<keyof GFields, string>]: GFields[Key] extends TFormField<infer GValue> ? GValue : GFields[Key] extends {
+        defaultValue: infer GValue;
+    } ? GValue : never;
+};
+export type TCreateFormFieldsInput = Record<string, TCreateFormConfigFormField<unknown> | TFormField<unknown>>;
+/** Configures one form field when `createForm()` should create the field. */
+export interface TCreateFormConfigFormField<GValue> {
+    /** Initial value for the created field. Also restored by `reset()`. */
+    defaultValue: GValue;
+    /** Optional field-level Standard Schema validator. */
+    validator?: TFormFieldValidator<NoInfer<GValue>>;
+    /** Overrides the form default for this field. */
+    collectErrorMode?: TFormFieldValidationConfig['collectErrorMode'];
+    /** Overrides the form default for this field after first submit. */
+    revalidateOn?: TFormFieldValidationConfig['revalidateOn'];
+    /** Overrides the form default for this field before first submit. */
+    validateOn?: TFormFieldValidationConfig['validateOn'];
 }

package/dist/types/features/dirty.d.ts

@@ -0,0 +1,33 @@
+import { type TFeature } from 'feature-core';
+import { type TState } from 'feature-state';
+import { type TForm, type TFormData, type TFormFieldKey } from '../types';
+/**
+ * Adds `isDirty`, `dirtyFields`, and `resetDirty()` to a form.
+ *
+ * Tracks whether each field differs from its `defaultValue` using deep structural equality.
+ * `isDirty` and `dirtyFields` are reactive states. `resetDirty()` makes the current values
+ * the new baseline without clearing them. Dirty state clears automatically when
+ * `submit({ updateDefaultValues: true })` succeeds.
+ */
+export declare function dirtyFeature<GFormData extends TFormData = TFormData>(config?: TDirtyFeatureConfig): TDirtyFeature<GFormData>;
+export interface TDirtyFeatureConfig {
+    /** Custom equality function. Defaults to deep structural equality. */
+    isEqual?: TDirtyFieldComparator;
+}
+/** Returns `true` when a current field value matches its default value. */
+export type TDirtyFieldComparator = (value: unknown, defaultValue: unknown) => boolean;
+export type TDirtyFeature<GFormData extends TFormData = TFormData> = TFeature<'dirty', {
+    /** True when at least one field differs from its default value. */
+    isDirty: TState<boolean, []>;
+    /** Field-keyed reactive map where `true` means the field differs from its default value. */
+    dirtyFields: TState<TDirtyFields<GFormData>, []>;
+    /** Makes the current field values the new default values without clearing the form. */
+    resetDirty(): void;
+    /** Updates dirty state after the original submit flow completes. */
+    submit: TForm<GFormData, []>['submit'];
+}, [
+], 'submit'>;
+/** Field-keyed dirty map where `true` means the field differs from its default value. */
+export type TDirtyFields<GFormData extends TFormData> = {
+    [Key in TFormFieldKey<GFormData>]: boolean;
+};

package/dist/types/features/index.d.ts

@@ -0,0 +1 @@
+export * from './dirty';

package/dist/types/index.d.ts

@@ -1,6 +1,4 @@
-export { BitwiseFlag, bitwiseFlag } from '@blgc/utils';
 export * from './create-form';
-export * from './form-field';
-export * from './helper';
-export * from './is-form-with-features';
+export * from './features';
+export * from './create-form-field';
 export * from './types';

package/dist/types/lib/deep-copy.d.ts

@@ -0,0 +1,2 @@
+/** Deeply copies plain objects and arrays. Non-plain objects (class instances, Date, Map, etc.) are returned by reference. */
+export declare function deepCopy<GValue>(value: GValue): GValue;

package/dist/types/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './deep-copy';
+export * from './standard-schema';
+export * from './validation-status';

package/dist/types/lib/standard-schema.d.ts

@@ -0,0 +1,4 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import { type TCollectErrorMode, type TValidationStatusValue } from '../types';
+/** Runs a Standard Schema validator and converts its issues into a validation status. */
+export declare function validateStandardSchema<GValue>(schema: StandardSchemaV1<GValue, unknown>, value: GValue, collectErrorMode: TCollectErrorMode): Promise<TValidationStatusValue>;

package/dist/types/lib/validation-status.d.ts

@@ -0,0 +1,3 @@
+import { type TValidationStatusValue } from '../types';
+/** Compares validation statuses so reactive status state can skip equivalent updates. */
+export declare function areValidationStatusesEqual(current: TValidationStatusValue, next: TValidationStatusValue): boolean;

package/dist/types/types.d.ts

@@ -0,0 +1,198 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import { type TAnyFeature, type TFeature, type TFeatureHost } from 'feature-core';
+import { type TIsEqualFeature, type TState } from 'feature-state';
+/** Form object returned by `createForm()`. */
+export type TForm<GFormData extends TFormData, GFeatures extends TAnyFeature[] = []> = TFeatureHost<TFormBase<GFormData>, GFeatures>;
+/**
+ * Core form API used by feature installers.
+ * Use this type when a feature only needs the base methods,
+ * regardless of which other features are already installed on the host.
+ */
+export interface TFormBase<GFormData extends TFormData> {
+    /** @internal */
+    _validation?: TFormValidation<GFormData>;
+    /** @internal Increments to prevent stale async validation runs from committing after reset or newer validation. */
+    _validationRunId: number;
+    /** @internal Stores form-level validator status after field-path errors have been routed to fields. */
+    _formValidatorStatus: TValidationStatusValue;
+    /** @internal */
+    _callbacks: TFormCallbacks<GFormData>;
+    /** Reactive aggregate validation status for the whole form. */
+    status: TFormStatus;
+    /** True while any async validator is running. */
+    isValidating: TState<boolean, []>;
+    /** True after the first submit attempt, regardless of validity. */
+    isSubmitted: TState<boolean, []>;
+    /** True while the submit handler is executing. */
+    isSubmitting: TState<boolean, []>;
+    /** Map of field keys to their reactive `TFormField` instances. */
+    fields: TFormFields<GFormData>;
+    /** Registers a callback for every valid submit. Returns an unsubscribe function. */
+    onValidSubmit(callback: TFormValidSubmitCallback<GFormData>): () => void;
+    /** Registers a callback for every invalid submit. Returns an unsubscribe function. */
+    onInvalidSubmit(callback: TFormInvalidSubmitCallback<GFormData>): () => void;
+    /** Runs all validators (including async), fires submit callbacks, and returns `true` if the form was valid. */
+    submit(options?: TFormSubmitOptions<GFormData>): Promise<boolean>;
+    /** Runs all validators and returns true if valid, false otherwise. */
+    validate(): Promise<boolean>;
+    /** Resets all fields to their default values and clears validation state. */
+    reset(): void;
+    /** Returns the `TFormField` for the given key. */
+    getField<GKey extends TFormFieldKey<GFormData>>(key: GKey): TFormFields<GFormData>[GKey];
+    /** Returns current field values without checking validity. */
+    getData(): Readonly<GFormData>;
+    /** Returns current field values when the form is valid, otherwise `null`. */
+    getValidData(): Readonly<GFormData> | null;
+    /** Returns current field and form-level validation errors. */
+    getErrors(): TFormErrors<GFormData>;
+}
+export type TFormData = object;
+export type TFormFieldKey<GFormData extends TFormData> = Extract<keyof GFormData, string>;
+/** Maps each form data property to its reactive field. */
+export type TFormFields<GFormData extends TFormData> = {
+    [Key in TFormFieldKey<GFormData>]: TFormField<GFormData[Key]>;
+};
+/** Aggregate validation status for the whole form, including field and form-level errors. */
+export type TFormStatus = TValidationStatus;
+export interface TFormCallbacks<GFormData extends TFormData> {
+    validSubmit: TFormValidSubmitCallback<GFormData>[];
+    invalidSubmit: TFormInvalidSubmitCallback<GFormData>[];
+}
+export interface TFormSubmitOptions<GFormData extends TFormData> {
+    /** One-time valid-submit callback for this call, in addition to registered listeners. */
+    onValidSubmit?: TFormValidSubmitCallback<GFormData>;
+    /** One-time invalid-submit callback for this call, in addition to registered listeners. */
+    onInvalidSubmit?: TFormInvalidSubmitCallback<GFormData>;
+    /** Arbitrary data forwarded to all submit callbacks as the second argument. */
+    context?: TFormSubmitContext;
+    /** Updates field default values after a successful submit so future resets return to submitted data. */
+    updateDefaultValues?: boolean;
+}
+/** Receives typed form data after a successful submit. */
+export type TFormValidSubmitCallback<GFormData extends TFormData> = (formData: Readonly<GFormData>, context?: TFormSubmitContext) => Promise<void> | void;
+/** Receives collected form and field errors after an invalid submit. */
+export type TFormInvalidSubmitCallback<GFormData extends TFormData> = (errors: TFormErrors<GFormData>, context?: TFormSubmitContext) => Promise<void> | void;
+/** Metadata forwarded to submit callbacks. */
+export interface TFormSubmitContext {
+    [key: string]: unknown;
+    /** The HTML submit event, if the form was submitted via a DOM form element. */
+    event?: unknown;
+}
+export interface TFormValidation<GFormData extends TFormData> {
+    validator: TFormValidator<GFormData>;
+    config: TFormValidationConfig;
+}
+/** Controls form-level validation timing and error collection. */
+export interface TFormValidationConfig {
+    /** Validation triggers used before the first submit. */
+    validateOn: readonly TValidateTrigger[];
+    /** Validation triggers used after the first submit. */
+    revalidateOn: readonly TRevalidateTrigger[];
+    /** `'firstError'` stops after the first error; `'all'` collects every error. */
+    collectErrorMode: TCollectErrorMode;
+}
+/** Validates the full form data for cross-field and form-level constraints. */
+export type TFormValidator<GFormData extends TFormData> = StandardSchemaV1<GFormData, unknown>;
+export interface TFormErrors<GFormData extends TFormData> {
+    /** Field-level errors keyed by field, including form-level validator errors routed by field path. */
+    fields: TFormFieldErrors<GFormData>;
+    /** Pathless form-level validator errors, plus errors whose path does not match a field. */
+    form: readonly TFormError[];
+}
+export type TFormError = TValidationError;
+export type TFormFieldErrors<GFormData extends TFormData> = {
+    [Key in TFormFieldKey<GFormData>]?: readonly TFormFieldError[];
+};
+export type TFormFieldError = TValidationError;
+/** Form field object returned by `createFormField()`. */
+export type TFormField<GValue> = TState<GValue, [TFormFieldFeature<GValue>]>;
+export type TFormFieldFeature<GValue> = TFeature<'form-field', {
+    /** @internal */
+    _validation?: TFormFieldValidation<GValue>;
+    /** @internal Increments to prevent stale async validation runs from committing after reset or newer validation. */
+    _validationRunId: number;
+    /** @internal Stores the field validator result before routed form-level errors are merged into `status`. */
+    _fieldValidatorStatus: TValidationStatusValue;
+    /** @internal Form-level validator errors routed to this field by path. */
+    _formValidatorErrors: readonly TValidationError[];
+    /** @internal */
+    _callbacks: TFormFieldCallbacks;
+    /** The field's key within the form data shape. */
+    key: string;
+    /** The value this field resets to. Updated by `resetDirty()` or a successful `submit({ updateDefaultValues: true })`. */
+    defaultValue: GValue;
+    /** True after the field has been blurred at least once. */
+    isTouched: TState<boolean, []>;
+    /** True after the standalone field or parent form has been submitted. */
+    isSubmitted: TState<boolean, []>;
+    /** True while an async field validator is running. */
+    isValidating: TState<boolean, []>;
+    /** Field display status, including this field's validator errors and routed form-level errors. */
+    status: TFormFieldStatus;
+    /** @internal Updates routed form-level errors and syncs the public field status. */
+    _applyFormValidatorErrors: (errors: readonly TValidationError[]) => void;
+    /** Runs the field validator and updates `status`. */
+    validate: () => Promise<boolean>;
+    /** Registers a callback for future blur events. Returns an unsubscribe function. */
+    onBlur: (callback: TFormFieldBlurCallback) => () => void;
+    /** Marks the field as touched and runs blur validation when configured. */
+    blur: () => void;
+    /** Resets the field to `defaultValue` and clears validation state. */
+    reset: () => void;
+}>;
+export type TFormFieldStatus = TValidationStatus;
+/** Stores a field-level validator with its timing and error collection config. */
+export interface TFormFieldValidation<GValue> {
+    validator: TFormFieldValidator<GValue>;
+    config: TFormFieldValidationConfig;
+}
+/** Controls field-level validation timing and error collection. */
+export interface TFormFieldValidationConfig {
+    /** Validation triggers used before the field is submitted. */
+    validateOn: readonly TValidateTrigger[];
+    /** Validation triggers used after the field is submitted. */
+    revalidateOn: readonly TRevalidateTrigger[];
+    /** `'firstError'` stops after the first error; `'all'` collects every error. */
+    collectErrorMode: TCollectErrorMode;
+}
+/** Validates one field value with Standard Schema. */
+export type TFormFieldValidator<GValue> = StandardSchemaV1<GValue, unknown>;
+export interface TFormFieldCallbacks {
+    blur: TFormFieldBlurCallback[];
+}
+export type TFormFieldBlurCallback = (context: TFormFieldBlurContext) => void;
+export interface TFormFieldBlurContext {
+    /** True if the field was already touched before this blur. */
+    wasTouched: boolean;
+}
+/** Controls whether validation keeps the first issue or all issues returned by Standard Schema. */
+export type TCollectErrorMode = 'firstError' | 'all';
+/** Validation event names. `touched` runs after the first blur and then on later changes. */
+export type TValidateTrigger = 'blur' | 'change' | 'submit' | 'touched';
+/** Revalidation runs after submit, where `touched` no longer applies. */
+export type TRevalidateTrigger = Exclude<TValidateTrigger, 'touched'>;
+/** Validation status state used by forms and fields. */
+export type TValidationStatus = TState<TValidationStatusValue, [
+    TIsEqualFeature<TValidationStatusValue>
+]>;
+export type TValidationStatusValue = TInvalidValidationStatus | TValidValidationStatus | TUnvalidatedValidationStatus;
+/** Validation failed with one or more errors. */
+export interface TInvalidValidationStatus {
+    type: 'invalid';
+    errors: readonly TValidationError[];
+}
+export interface TValidationError {
+    /** Human-readable error description. */
+    message: string;
+    /** Standard Schema-compatible path associated with the error. */
+    path?: TValidationPath;
+}
+/** Standard Schema-compatible validation path segments. */
+export type TValidationPath = readonly PropertyKey[];
+export interface TValidValidationStatus {
+    type: 'valid';
+}
+/** Validation has not run yet. */
+export interface TUnvalidatedValidationStatus {
+    type: 'unvalidated';
+}

package/package.json

@@ -1,9 +1,24 @@
 {
   "name": "feature-form",
-  "version": "0.0.59",
+  "version": "0.1.0",
   "private": false,
-  "description": "Straightforward, typesafe, and feature-based form library for ReactJs",
-  "keywords": [],
+  "description": "Framework-agnostic reactive form state with Standard Schema validation and per-field triggers",
+  "keywords": [
+    "form",
+    "form-state",
+    "form-validation",
+    "reactive-form",
+    "reactive",
+    "validation",
+    "standard-schema",
+    "zod",
+    "valibot",
+    "arktype",
+    "validation-timing",
+    "dirty-state",
+    "framework-agnostic",
+    "typescript"
+  ],
   "homepage": "https://builder.group/?utm_source=package-json",
   "bugs": {
     "url": "https://github.com/builder-group/community/issues"
@@ -20,17 +35,17 @@
   "types": "./dist/types/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "MIGRATION.md"
   ],
   "dependencies": {
-    "@blgc/types": "0.0.22",
-    "@blgc/utils": "0.0.62",
-    "feature-state": "0.0.66",
-    "validation-adapter": "0.0.28"
+    "@standard-schema/spec": "^1.1.0",
+    "feature-core": "0.0.2",
+    "feature-state": "0.1.0"
   },
   "devDependencies": {
-    "rollup-presets": "0.0.27",
-    "@blgc/config": "0.0.41"
+    "@blgc/config": "0.1.0",
+    "rollup-presets": "0.0.27"
   },
   "size-limit": [
     {
@@ -42,7 +57,7 @@
     "build:prod": "export NODE_ENV=production && pnpm build",
     "clean": "shx rm -rf dist && shx rm -rf .turbo && shx rm -rf node_modules",
     "install:clean": "pnpm run clean && pnpm install",
-    "lint": "eslint . --fix",
+    "lint": "eslint .",
     "publish:patch": "pnpm build:prod && pnpm version patch && pnpm publish --no-git-checks --access=public",
     "size": "size-limit --why",
     "start:dev": "tsc -w",

package/dist/cjs/form-field/create-form-field-validation-context.js

@@ -1 +0,0 @@
-"use strict";function t(r){return{config:{collectErrorMode:r._config.collectErrorMode,name:r.key},value:r.get(),isValue(e){return!0},hasError(){var e;return((e=r.status._nextValue)==null?void 0:e.type)==="INVALID"},registerError(e){r.status.registerNextError({code:e.code,message:e.message,path:e.path})}}}exports.createFormFieldValidationContext=t;

package/dist/cjs/form-field/create-form-field.js

@@ -1 +0,0 @@
-"use strict";var d=require("@blgc/utils"),r=require("feature-state"),_=require("validation-adapter"),t=require("../types/form-field.js"),M=require("./create-form-field-validation-context.js"),S=require("./create-status.js"),v=(o,u,a)=>new Promise((n,l)=>{var h=e=>{try{s(a.next(e))}catch(i){l(i)}},c=e=>{try{s(a.throw(e))}catch(i){l(i)}},s=e=>e.done?n(e.value):Promise.resolve(e.value).then(h,c);s((a=a.apply(o,u)).next())});function y(o,u){const{key:a,validator:n=_.createValidator([]),editable:l=!0,reValidateMode:h=d.bitwiseFlag(t.FormFieldReValidateMode.OnBlur),validateMode:c=d.bitwiseFlag(t.FormFieldValidateMode.OnSubmit),collectErrorMode:s="firstError",notifyOnStatusChange:e=!0}=u,i=r.createState(o),V={_config:{editable:l,validateMode:c,reValidateMode:h,collectErrorMode:s},_intialValue:d.deepCopy(i._v),_validator:n,key:a,isTouched:r.createState(!1),isSubmitted:r.createState(!1),isSubmitting:r.createState(!1),isValidating:r.createState(!1),status:S.createStatus({type:"UNVALIDATED"}),validate(){return v(this,null,function*(){const f=M.createFormFieldValidationContext(this);return this.isValidating.set(!0),yield this._validator.validate(f),this.isValidating.set(!1),this.status._nextValue==null?this.status.set({type:"VALID"}):this.status.set(this.status._nextValue),this.status._nextValue=void 0,this.status.get().type==="VALID"})},isValid(){return this.status.get().type==="VALID"},blur(){(this.isSubmitted.get()&&this._config.reValidateMode.has(t.FormFieldReValidateMode.OnBlur)||!this.isSubmitted.get()&&(this._config.validateMode.has(t.FormFieldValidateMode.OnBlur)||this._config.validateMode.has(t.FormFieldValidateMode.OnTouched)&&!this.isTouched.get()))&&this.validate(),this.isTouched.set(!0)},reset(){this.set(this._intialValue,{listenerContext:{source:"form-field_reset"}}),this.isTouched.set(!1),this.isSubmitted.set(!1),this.isSubmitting.set(!1),this.status.set({type:"UNVALIDATED"})}},g=Object.assign(i,V);return g._features.push("form-field"),d.withNew(Object.assign(g,{_new(f){f&&this.status.listen(m=>{i._notify({listenerContext:{source:"form-field_status-change",status:m.value}})},{key:"form-field_status-change"}),this.listen(m=>v(this,[m],function*({source:F}){F!=="form-field_reset"&&(this.isSubmitted.get()&&this._config.reValidateMode.has(t.FormFieldReValidateMode.OnChange)||!this.isSubmitted.get()&&this._config.validateMode.has(t.FormFieldValidateMode.OnChange)||this._config.validateMode.has(t.FormFieldValidateMode.OnTouched)&&this.isTouched.get())&&(yield this.validate())}),{key:"form-field_validate"})}}),e)}exports.createFormField=y;

package/dist/cjs/form-field/create-status.js

@@ -1 +0,0 @@
-"use strict";var u=require("feature-state");function i(s){const a=u.createState(s),t=Object.assign(a,{_nextValue:void 0,registerNextError(e){var r;((r=this._nextValue)==null?void 0:r.type)==="INVALID"?this._nextValue.errors.push(e):this._nextValue={type:"INVALID",errors:[e]}}});return t._features.push("form-field-status"),t}exports.createStatus=i;

package/dist/cjs/form-field/is-form-field-status.js

@@ -1 +0,0 @@
-"use strict";function r(e){return typeof e=="object"&&e!=null&&"_features"in e&&Array.isArray(e._features)&&e._features.includes("form-field-status")}exports.isFormFieldStatus=r;