@deijose/nix-js 2.5.4 → 2.6.0

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm version](https://img.shields.io/npm/v/@deijose/nix-js.svg)](https://www.npmjs.com/package/@deijose/nix-js)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/tests-524%20passing-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-583%20passing-brightgreen.svg)]()
 [![Coverage](https://img.shields.io/badge/coverage-95.86%25-brightgreen.svg)]()
-[![Bundle size](https://img.shields.io/badge/min%2Bgzip-~12%20KB-orange.svg)]()
+[![Bundle size](https://img.shields.io/badge/min%2Bgzip-~14%20KB-orange.svg)]()
 [![Zero Dependencies](https://img.shields.io/badge/dependencies-0-success.svg)]()
 [![Website](https://img.shields.io/badge/website-nix--js-indigo.svg)](https://nix-js.dev/)
 
@@ -13,7 +13,7 @@ A lightweight, fully reactive micro-framework for building modern web UIs — no
 **[→ Documentation & Live Demo](https://nix-js.dev/)**
 
 ```
-~24 KB minified · ~12 KB gzipped · zero dependencies · TypeScript-first · ES2022
+~24 KB minified · ~14 KB gzipped · zero dependencies · TypeScript-first · ES2022
 ```
 
 ## Installation
@@ -113,7 +113,7 @@ Everything ships in a single zero-dependency import:
 | **Templates** | `` html` ` ``, `repeat`, `ref`, `portal`, `transition`, `showWhen` |
 | **Components** | `NixTemplate` (function components), `NixComponent` (lifecycle class), `mount`, children & named slots |
 | **Router** | `createRouter`, `RouterView`, `Link`, `nixRouter`, `RouterKey`, guards, nested routes, named routes (`name` + `navigate({ name })`), `mount(..., { router })` |
-| **Forms** | `nixField`, `createForm`, built-in validators, Zod/Valibot interop |
+| **Forms** | `nixField`, `createForm`, `nixFieldArray`, built-in validators, programmatic value setting, Zod/Valibot interop |
 | **State** | `createStore`, `provide`, `inject`, `createInjectionKey` |
 | **Async** | `suspend` (with `invalidate` for re-fetching), `lazy` |
 | **Error handling** | `createErrorBoundary` |

package/dist/lib/form.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs");function t(e="Required"){return t=>null==t||""===t||Array.isArray(t)&&0===t.length?e:null}function n(e,t){return r=>"string"==typeof r&&r.length<e?t??`Minimum ${e} characters`:null}function r(e,t){return r=>"string"==typeof r&&r.length>e?t??`Maximum ${e} characters`:null}function i(e,t="Invalid format"){return r=>"string"!=typeof r||e.test(r)?null:t}function a(e="Invalid email"){return i(/^[^\s@]+@[^\s@]+\.[^\s@]+$/,e)}function o(e,t){return r=>"number"==typeof r&&r<e?t??`Minimum value is ${e}`:null}function s(e,t){return r=>"number"==typeof r&&r>e?t??`Maximum value is ${e}`:null}function c(e){return e}var l={required:t,minLength:n,maxLength:r,email:a,pattern:i,min:o,max:s};function u(e,t){return{...e,...t}}function d(t,r=[],n="blur",l){let u=e.signal(t),i=e.signal(!1),o=e.signal(!1),a=e.signal(null),s=e.signal(!1),f=!0,c=e.effect(()=>{u.value,f?f=!1:null!==a.peek()&&(a.value=null)}),p=e.computed(()=>{if(a.value)return a.value;let e=l?.();for(let t of r){let r=t(u.value,e);if(r)return r}return null}),v=e.computed(()=>("input"===n?o.value||i.value:"submit"===n?s.value:i.value)?p.value:null);return{value:u,error:v,rawError:p,touched:i,dirty:o,onInput:e=>{u.value=function(e){if(!e||!("value"in e))return t;let r=e,n=r.value;return"boolean"==typeof t?!0===r.checked||!function(e){return"checkbox"===e.type||"radio"===e.type}(r)&&("true"===n||"1"===n||"false"!==n&&"0"!==n&&""!==n&&t):"number"==typeof t?""===n?NaN:Number(n):n}(e.target),o.value=!0},onBlur:()=>{i.value=!0},reset:function(){e.batch(()=>{u.value=t,i.value=!1,o.value=!1,a.value=null,s.value=!1})},_setExternalError:function(e){a.value=e,e&&(i.value=!0)},_forceVisible:function(){i.value=!0,s.value=!0},_dispose:function(){c(),v.dispose(),p.dispose()}}}function f(t,r={},n="blur"){function l(e){let t={};for(let l in e){let u=r[l]??[];t[l]=d(e[l],u,n)}return t}let u=e.signal(t.map(l)),i=e.computed(()=>u.value.length);return{fields:u,append:function(e){u.value=[...u.value,l(e)]},remove:function(e){let t=u.value;if(!(e<0||e>=t.length)){for(let r in t[e])t[e][r]._dispose();u.value=t.filter((t,r)=>r!==e)}},move:function(e,t){let r=[...u.value];if(e<0||e>=r.length||t<0||t>=r.length||e===t)return;let[n]=r.splice(e,1);r.splice(t,0,n),u.value=r},replace:function(e,t){let r=[...u.value];if(!(e<0||e>=r.length)){for(let t in r[e])r[e][t]._dispose();r[e]=l(t),u.value=r}},length:i,reset:function(){for(let e of u.value)for(let t in e)e[t]._dispose();u.value=t.map(l)},_dispose:function(){for(let e of u.value)for(let t in e)e[t]._dispose();i.dispose()}}}function p(e){return"object"==typeof e&&!!e&&!Array.isArray(e)}function m(e,t="",r=[]){for(let[n,l]of Object.entries(e)){let e=t?`${t}.${n}`:n;p(l)&&Object.keys(l).length>0?m(l,e,r):r.push([e,l])}return r}function h(e,t,r){let n=t.split("."),l=e;for(let e=0;e<n.length-1;e++){let t=n[e];p(l[t])||(l[t]={}),l=l[t]}l[n[n.length-1]]=r}function g(t,r={}){let n=r.validateOn??"blur",l={},u=r.validators;function i(){let e={};for(let t in l)h(e,t,l[t].value.value);return e}for(let[e,r]of m(t))l[e]=d(r,u?.[e]??[],n,i);let o=e.signal(!1),a=e.signal(0),s=e.computed(()=>i()),f=e.computed(()=>{let e={};for(let t in l){let r=l[t].error.value;r&&(e[t]=r)}return e}),c=e.computed(()=>{for(let e in l)if(l[e].rawError.value)return!1;return!0}),p=e.computed(()=>{for(let e in l)if(l[e].error.value)return!1;return!0}),v=e.computed(()=>{for(let e in l)if(l[e].dirty.value)return!0;return!1}),g=e.computed(()=>{for(let e in l)if(l[e].touched.value)return!0;return!1});function x(e){for(let t in e)l[t]?._setExternalError(e[t]??null)}return{fields:l,values:s,errors:f,canSubmit:c,valid:p,dirty:v,touched:g,isSubmitting:o,submitCount:a,handleSubmit:function(e){return t=>{t.preventDefault(),a.value++;for(let e in l)l[e]._forceVisible();let n=s.value;if(r.validate){let e=r.validate(n);if(e){let t={},r=!1;for(let n in e){let l=e[n],u=Array.isArray(l)?l[0]??null:l??null;u&&(t[n]=u,r=!0)}if(r)return void x(t)}}for(let e in l)if(l[e].rawError.value)return;let u=e(n);u instanceof Promise&&(o.value=!0,u.finally(()=>{o.value=!1}).catch(()=>{}))}},reset:function(){for(let e in l)l[e].reset();o.value=!1,a.value=0},setErrors:x,dispose:function(){s.dispose(),f.dispose(),c.dispose(),p.dispose(),v.dispose(),g.dispose();for(let e in l)l[e]._dispose()}}}exports.createForm=g,exports.createValidator=c,exports.email=a,exports.extendValidators=u,exports.max=s,exports.maxLength=r,exports.min=o,exports.minLength=n,exports.nixField=d,exports.nixFieldArray=f,exports.pattern=i,exports.required=t,exports.validators=l;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs");function t(e="Required"){return t=>null==t||""===t||Array.isArray(t)&&0===t.length?e:null}function n(e,t){return l=>"string"==typeof l&&l.length<e?t??`Minimum ${e} characters`:null}function r(e,t){return l=>"string"==typeof l&&l.length>e?t??`Maximum ${e} characters`:null}function i(e,t="Invalid format"){return l=>"string"!=typeof l||e.test(l)?null:t}function a(e="Invalid email"){return i(/^[^\s@]+@[^\s@]+\.[^\s@]+$/,e)}function o(e,t){return l=>"number"==typeof l&&l<e?t??`Minimum value is ${e}`:null}function s(e,t){return l=>"number"==typeof l&&l>e?t??`Maximum value is ${e}`:null}function c(e){return e}var l={required:t,minLength:n,maxLength:r,email:a,pattern:i,min:o,max:s};function u(e,t){return{...e,...t}}function d(t,l=[],r="blur",n){let u=e.signal(t),i=e.signal(!1),o=e.signal(!1),a=e.signal(null),s=e.signal(!1),f=t,c=!0,v=e.effect(()=>{u.value,c?c=!1:null!==a.peek()&&(a.value=null)}),d=e.computed(()=>{if(a.value)return a.value;let e=n?.();for(let t of l){let l=t(u.value,e);if(l)return l}return null}),p=e.computed(()=>("input"===r?o.value||i.value:"submit"===r?s.value:i.value)?d.value:null);return{value:u,error:p,rawError:d,touched:i,dirty:o,onInput:e=>{u.value=function(e){if(!e||!("value"in e))return t;let l=e,r=l.value;return"boolean"==typeof t?!0===l.checked||!function(e){return"checkbox"===e.type||"radio"===e.type}(l)&&("true"===r||"1"===r||"false"!==r&&"0"!==r&&""!==r&&t):"number"==typeof t?""===r?NaN:Number(r):r}(e.target),o.value=!0},onBlur:()=>{i.value=!0},reset:function(){e.batch(()=>{u.value=f,i.value=!1,o.value=!1,a.value=null,s.value=!1})},setValue:function(t,l={}){let{shouldTouch:r=!1,shouldDirty:n=!0,shouldValidate:a=!0}=l;e.batch(()=>{u.value=t,n&&(o.value=!0),r&&(i.value=!0),a&&(s.value=!0)})},_setExternalError:function(e){a.value=e,e&&(i.value=!0)},_forceVisible:function(){i.value=!0,s.value=!0},_setInitialValue:function(e){f=e},_dispose:function(){v(),p.dispose(),d.dispose()}}}function f(t,l={},r="blur"){function n(e){let t={};for(let n in e){let u=l[n]??[];t[n]=d(e[n],u,r)}return t}let u=e.signal(t.map(n)),i=t,o=e.computed(()=>u.value.length);return{fields:u,append:function(e){u.value=[...u.value,n(e)]},remove:function(e){let t=u.value;if(!(e<0||e>=t.length)){for(let l in t[e])t[e][l]._dispose();u.value=t.filter((t,l)=>l!==e)}},move:function(e,t){let l=[...u.value];if(e<0||e>=l.length||t<0||t>=l.length||e===t)return;let[r]=l.splice(e,1);l.splice(t,0,r),u.value=l},replace:function(e,t){let l=[...u.value];if(!(e<0||e>=l.length)){for(let t in l[e])l[e][t]._dispose();l[e]=n(t),u.value=l}},length:o,setValues:function(e){for(let e of u.value)for(let t in e)e[t]._dispose();u.value=e.map(n)},patchValues:function(e){let t=[...u.value];for(let l=0;l<e.length;l++){let r=e[l];if(l>=t.length){t.push(n(r));continue}let u=t[l];for(let[e,t]of Object.entries(r))u[e]&&u[e].setValue(t,{shouldDirty:!1,shouldTouch:!1,shouldValidate:!1})}u.value=t},reset:function(e){e&&(i=e);for(let e of u.value)for(let t in e)e[t]._dispose();u.value=i.map(n)},_dispose:function(){for(let e of u.value)for(let t in e)e[t]._dispose();o.dispose()}}}function p(e){return"object"==typeof e&&!!e&&!Array.isArray(e)}function m(e,t="",l=[]){for(let[r,n]of Object.entries(e)){let e=t?`${t}.${r}`:r;p(n)&&Object.keys(n).length>0?m(n,e,l):l.push([e,n])}return l}function h(e,t,l){let r=t.split("."),n=e;for(let e=0;e<r.length-1;e++){let t=r[e];p(n[t])||(n[t]={}),n=n[t]}n[r[r.length-1]]=l}function g(t,l={}){let r=l.validateOn??"blur",n={},u=l.validators;function i(){let e={};for(let t in n)h(e,t,n[t].value.value);return e}for(let[e,l]of m(t))n[e]=d(l,u?.[e]??[],r,i);let o=e.signal(!1),a=e.signal(0),s=e.computed(()=>i()),f=e.computed(()=>{let e={};for(let t in n){let l=n[t].error.value;l&&(e[t]=l)}return e}),c=e.computed(()=>{for(let e in n)if(n[e].rawError.value)return!1;return!0}),v=e.computed(()=>{for(let e in n)if(n[e].error.value)return!1;return!0}),p=e.computed(()=>{for(let e in n)if(n[e].dirty.value)return!0;return!1}),g=e.computed(()=>{for(let e in n)if(n[e].touched.value)return!0;return!1});function y(e){for(let t in e)n[t]?._setExternalError(e[t]??null)}return{fields:n,values:s,errors:f,canSubmit:c,valid:v,dirty:p,touched:g,isSubmitting:o,submitCount:a,handleSubmit:function(e){return t=>{t.preventDefault(),a.value++;for(let e in n)n[e]._forceVisible();let r=s.value;if(l.validate){let e=l.validate(r);if(e){let t={},l=!1;for(let r in e){let n=e[r],u=Array.isArray(n)?n[0]??null:n??null;u&&(t[r]=u,l=!0)}if(l)return void y(t)}}for(let e in n)if(n[e].rawError.value)return;let u=e(r);u instanceof Promise&&(o.value=!0,u.finally(()=>{o.value=!1}).catch(()=>{}))}},reset:function(e){if(e)for(let[t,l]of m(e)){let e=n[t];e&&e._setInitialValue(l)}for(let e in n)n[e].reset();o.value=!1,a.value=0},setValue:function(e,t,l={}){let r=n[e];r&&r.setValue(t,l)},setValues:function(t,l={}){let{keepDirty:r=!1,keepTouched:u=!1,keepErrors:i=!0}=l;e.batch(()=>{for(let[e,l]of m(t)){let t=n[e];t&&(t.setValue(l,{shouldDirty:!r,shouldTouch:!1,shouldValidate:!i}),u||(t.touched.value=!1))}})},setErrors:y,dispose:function(){s.dispose(),f.dispose(),c.dispose(),v.dispose(),p.dispose(),g.dispose();for(let e in n)n[e]._dispose()}}}exports.createForm=g,exports.createValidator=c,exports.email=a,exports.extendValidators=u,exports.max=s,exports.maxLength=r,exports.min=o,exports.minLength=n,exports.nixField=d,exports.nixFieldArray=f,exports.pattern=i,exports.required=t,exports.validators=l;

package/dist/lib/form.js

@@ -1 +1 @@
-import{batch as e,computed as t,effect as n,signal as r}from"./signals.js";function i(e="Required"){return t=>null==t||""===t||Array.isArray(t)&&0===t.length?e:null}function a(e,t){return r=>"string"==typeof r&&r.length<e?t??`Minimum ${e} characters`:null}function o(e,t){return r=>"string"==typeof r&&r.length>e?t??`Maximum ${e} characters`:null}function s(e,t="Invalid format"){return r=>"string"!=typeof r||e.test(r)?null:t}function c(e="Invalid email"){return s(/^[^\s@]+@[^\s@]+\.[^\s@]+$/,e)}function l(e,t){return r=>"number"==typeof r&&r<e?t??`Minimum value is ${e}`:null}function u(e,t){return r=>"number"==typeof r&&r>e?t??`Maximum value is ${e}`:null}function d(e){return e}var f={required:i,minLength:a,maxLength:o,email:c,pattern:s,min:l,max:u};function p(e,t){return{...e,...t}}function m(l,u=[],i="blur",a){let o=r(l),s=r(!1),f=r(!1),v=r(null),c=r(!1),d=!0,p=n(()=>{o.value,d?d=!1:null!==v.peek()&&(v.value=null)}),m=t(()=>{if(v.value)return v.value;let e=a?.();for(let t of u){let r=t(o.value,e);if(r)return r}return null}),h=t(()=>("input"===i?f.value||s.value:"submit"===i?c.value:s.value)?m.value:null);return{value:o,error:h,rawError:m,touched:s,dirty:f,onInput:e=>{o.value=function(e){if(!e||!("value"in e))return l;let t=e,r=t.value;return"boolean"==typeof l?!0===t.checked||!function(e){return"checkbox"===e.type||"radio"===e.type}(t)&&("true"===r||"1"===r||"false"!==r&&"0"!==r&&""!==r&&l):"number"==typeof l?""===r?NaN:Number(r):r}(e.target),f.value=!0},onBlur:()=>{s.value=!0},reset:function(){e(()=>{o.value=l,s.value=!1,f.value=!1,v.value=null,c.value=!1})},_setExternalError:function(e){v.value=e,e&&(s.value=!0)},_forceVisible:function(){s.value=!0,c.value=!0},_dispose:function(){p(),h.dispose(),m.dispose()}}}function h(e,n={},l="blur"){function u(e){let t={};for(let r in e){let u=n[r]??[];t[r]=m(e[r],u,l)}return t}let i=r(e.map(u)),a=t(()=>i.value.length);return{fields:i,append:function(e){i.value=[...i.value,u(e)]},remove:function(e){let t=i.value;if(!(e<0||e>=t.length)){for(let r in t[e])t[e][r]._dispose();i.value=t.filter((t,r)=>r!==e)}},move:function(e,t){let r=[...i.value];if(e<0||e>=r.length||t<0||t>=r.length||e===t)return;let[n]=r.splice(e,1);r.splice(t,0,n),i.value=r},replace:function(e,t){let r=[...i.value];if(!(e<0||e>=r.length)){for(let t in r[e])r[e][t]._dispose();r[e]=u(t),i.value=r}},length:a,reset:function(){for(let e of i.value)for(let t in e)e[t]._dispose();i.value=e.map(u)},_dispose:function(){for(let e of i.value)for(let t in e)e[t]._dispose();a.dispose()}}}function g(e){return"object"==typeof e&&!!e&&!Array.isArray(e)}function _(e,t="",r=[]){for(let[n,l]of Object.entries(e)){let e=t?`${t}.${n}`:n;g(l)&&Object.keys(l).length>0?_(l,e,r):r.push([e,l])}return r}function v(e,t,r){let n=t.split("."),l=e;for(let e=0;e<n.length-1;e++){let t=n[e];g(l[t])||(l[t]={}),l=l[t]}l[n[n.length-1]]=r}function y(e,n={}){let l=n.validateOn??"blur",u={},i=n.validators;function a(){let e={};for(let t in u)v(e,t,u[t].value.value);return e}for(let[t,r]of _(e))u[t]=m(r,i?.[t]??[],l,a);let o=r(!1),s=r(0),f=t(()=>a()),c=t(()=>{let e={};for(let t in u){let r=u[t].error.value;r&&(e[t]=r)}return e}),d=t(()=>{for(let e in u)if(u[e].rawError.value)return!1;return!0}),p=t(()=>{for(let e in u)if(u[e].error.value)return!1;return!0}),h=t(()=>{for(let e in u)if(u[e].dirty.value)return!0;return!1}),g=t(()=>{for(let e in u)if(u[e].touched.value)return!0;return!1});function y(e){for(let t in e)u[t]?._setExternalError(e[t]??null)}return{fields:u,values:f,errors:c,canSubmit:d,valid:p,dirty:h,touched:g,isSubmitting:o,submitCount:s,handleSubmit:function(e){return t=>{t.preventDefault(),s.value++;for(let e in u)u[e]._forceVisible();let r=f.value;if(n.validate){let e=n.validate(r);if(e){let t={},r=!1;for(let n in e){let l=e[n],u=Array.isArray(l)?l[0]??null:l??null;u&&(t[n]=u,r=!0)}if(r)return void y(t)}}for(let e in u)if(u[e].rawError.value)return;let l=e(r);l instanceof Promise&&(o.value=!0,l.finally(()=>{o.value=!1}).catch(()=>{}))}},reset:function(){for(let e in u)u[e].reset();o.value=!1,s.value=0},setErrors:y,dispose:function(){f.dispose(),c.dispose(),d.dispose(),p.dispose(),h.dispose(),g.dispose();for(let e in u)u[e]._dispose()}}}export{y as createForm,d as createValidator,c as email,p as extendValidators,u as max,o as maxLength,l as min,a as minLength,m as nixField,h as nixFieldArray,s as pattern,i as required,f as validators};
+import{batch as e,computed as t,effect as n,signal as r}from"./signals.js";function i(e="Required"){return t=>null==t||""===t||Array.isArray(t)&&0===t.length?e:null}function a(e,t){return l=>"string"==typeof l&&l.length<e?t??`Minimum ${e} characters`:null}function o(e,t){return l=>"string"==typeof l&&l.length>e?t??`Maximum ${e} characters`:null}function s(e,t="Invalid format"){return l=>"string"!=typeof l||e.test(l)?null:t}function c(e="Invalid email"){return s(/^[^\s@]+@[^\s@]+\.[^\s@]+$/,e)}function l(e,t){return l=>"number"==typeof l&&l<e?t??`Minimum value is ${e}`:null}function u(e,t){return l=>"number"==typeof l&&l>e?t??`Maximum value is ${e}`:null}function d(e){return e}var f={required:i,minLength:a,maxLength:o,email:c,pattern:s,min:l,max:u};function p(e,t){return{...e,...t}}function m(l,u=[],i="blur",a){let o=r(l),s=r(!1),f=r(!1),c=r(null),v=r(!1),d=l,p=!0,h=n(()=>{o.value,p?p=!1:null!==c.peek()&&(c.value=null)}),m=t(()=>{if(c.value)return c.value;let e=a?.();for(let t of u){let l=t(o.value,e);if(l)return l}return null}),g=t(()=>("input"===i?f.value||s.value:"submit"===i?v.value:s.value)?m.value:null);return{value:o,error:g,rawError:m,touched:s,dirty:f,onInput:e=>{o.value=function(e){if(!e||!("value"in e))return l;let t=e,r=t.value;return"boolean"==typeof l?!0===t.checked||!function(e){return"checkbox"===e.type||"radio"===e.type}(t)&&("true"===r||"1"===r||"false"!==r&&"0"!==r&&""!==r&&l):"number"==typeof l?""===r?NaN:Number(r):r}(e.target),f.value=!0},onBlur:()=>{s.value=!0},reset:function(){e(()=>{o.value=d,s.value=!1,f.value=!1,c.value=null,v.value=!1})},setValue:function(t,l={}){let{shouldTouch:r=!1,shouldDirty:n=!0,shouldValidate:u=!0}=l;e(()=>{o.value=t,n&&(f.value=!0),r&&(s.value=!0),u&&(v.value=!0)})},_setExternalError:function(e){c.value=e,e&&(s.value=!0)},_forceVisible:function(){s.value=!0,v.value=!0},_setInitialValue:function(e){d=e},_dispose:function(){h(),g.dispose(),m.dispose()}}}function h(e,l={},n="blur"){function u(e){let t={};for(let r in e){let u=l[r]??[];t[r]=m(e[r],u,n)}return t}let i=r(e.map(u)),a=e,o=t(()=>i.value.length);return{fields:i,append:function(e){i.value=[...i.value,u(e)]},remove:function(e){let t=i.value;if(!(e<0||e>=t.length)){for(let l in t[e])t[e][l]._dispose();i.value=t.filter((t,l)=>l!==e)}},move:function(e,t){let l=[...i.value];if(e<0||e>=l.length||t<0||t>=l.length||e===t)return;let[r]=l.splice(e,1);l.splice(t,0,r),i.value=l},replace:function(e,t){let l=[...i.value];if(!(e<0||e>=l.length)){for(let t in l[e])l[e][t]._dispose();l[e]=u(t),i.value=l}},length:o,setValues:function(e){for(let e of i.value)for(let t in e)e[t]._dispose();i.value=e.map(u)},patchValues:function(e){let t=[...i.value];for(let l=0;l<e.length;l++){let r=e[l];if(l>=t.length){t.push(u(r));continue}let n=t[l];for(let[e,t]of Object.entries(r))n[e]&&n[e].setValue(t,{shouldDirty:!1,shouldTouch:!1,shouldValidate:!1})}i.value=t},reset:function(e){e&&(a=e);for(let e of i.value)for(let t in e)e[t]._dispose();i.value=a.map(u)},_dispose:function(){for(let e of i.value)for(let t in e)e[t]._dispose();o.dispose()}}}function g(e){return"object"==typeof e&&!!e&&!Array.isArray(e)}function _(e,t="",l=[]){for(let[r,n]of Object.entries(e)){let e=t?`${t}.${r}`:r;g(n)&&Object.keys(n).length>0?_(n,e,l):l.push([e,n])}return l}function v(e,t,l){let r=t.split("."),n=e;for(let e=0;e<r.length-1;e++){let t=r[e];g(n[t])||(n[t]={}),n=n[t]}n[r[r.length-1]]=l}function y(l,n={}){let u=n.validateOn??"blur",i={},a=n.validators;function o(){let e={};for(let t in i)v(e,t,i[t].value.value);return e}for(let[e,t]of _(l))i[e]=m(t,a?.[e]??[],u,o);let s=r(!1),f=r(0),c=t(()=>o()),d=t(()=>{let e={};for(let t in i){let l=i[t].error.value;l&&(e[t]=l)}return e}),p=t(()=>{for(let e in i)if(i[e].rawError.value)return!1;return!0}),h=t(()=>{for(let e in i)if(i[e].error.value)return!1;return!0}),g=t(()=>{for(let e in i)if(i[e].dirty.value)return!0;return!1}),y=t(()=>{for(let e in i)if(i[e].touched.value)return!0;return!1});function b(e){for(let t in e)i[t]?._setExternalError(e[t]??null)}return{fields:i,values:c,errors:d,canSubmit:p,valid:h,dirty:g,touched:y,isSubmitting:s,submitCount:f,handleSubmit:function(e){return t=>{t.preventDefault(),f.value++;for(let e in i)i[e]._forceVisible();let l=c.value;if(n.validate){let e=n.validate(l);if(e){let t={},l=!1;for(let r in e){let n=e[r],u=Array.isArray(n)?n[0]??null:n??null;u&&(t[r]=u,l=!0)}if(l)return void b(t)}}for(let e in i)if(i[e].rawError.value)return;let r=e(l);r instanceof Promise&&(s.value=!0,r.finally(()=>{s.value=!1}).catch(()=>{}))}},reset:function(e){if(e)for(let[t,l]of _(e)){let e=i[t];e&&e._setInitialValue(l)}for(let e in i)i[e].reset();s.value=!1,f.value=0},setValue:function(e,t,l={}){let r=i[e];r&&r.setValue(t,l)},setValues:function(t,l={}){let{keepDirty:r=!1,keepTouched:n=!1,keepErrors:u=!0}=l;e(()=>{for(let[e,l]of _(t)){let t=i[e];t&&(t.setValue(l,{shouldDirty:!r,shouldTouch:!1,shouldValidate:!u}),n||(t.touched.value=!1))}})},setErrors:b,dispose:function(){c.dispose(),d.dispose(),p.dispose(),h.dispose(),g.dispose(),y.dispose();for(let e in i)i[e]._dispose()}}}export{y as createForm,d as createValidator,c as email,p as extendValidators,u as max,o as maxLength,l as min,a as minLength,m as nixField,h as nixFieldArray,s as pattern,i as required,f as validators};

package/dist/lib/index.d.ts

@@ -1,2 +1,2 @@
 export { Signal, signal, effect, computed, batch, watch, untrack, nextTick, html, repeat, ref, showWhen, portal, createPortalOutlet, portalOutlet, provideOutlet, injectOutlet, createErrorBoundary, transition, mount, NixComponent, createStore, persistPlugin, loggerPlugin, guardPlugin, bridgePlugin, createRouter, RouterView, Link, nixRouter, RouterKey, _hasActiveRouter, suspend, lazy, provide, inject, createInjectionKey, nixField, nixFieldArray, createForm, required, minLength, maxLength, email, pattern, min, max, createValidator, validators, extendValidators, } from "./nix";
-export type { WatchOptions, NixTemplate, NixMountHandle, MountOptions, KeyedList, NixRef, PortalOutlet, ErrorFallback, TransitionOptions, TransitionContent, Store, StoreSignals, NixPlugin, Router, NamedRouteLocation, RouteLocation, RouteRecord, RouterOptions, NavigationGuard, NavigationGuardResult, AfterEachHook, ResolvedRoute, ScrollPosition, ScrollBehavior, RouterMode, NavigationDirection, NavigationIntent, NavigationAction, NavigateOptions, SuspenseOptions, InjectionKey, Validator, ValidateOn, FieldState, FieldArrayState, FieldErrors, FormState, FormOptions, ValidatorsBase, NixChildren, } from "./nix";
+export type { WatchOptions, NixTemplate, NixMountHandle, MountOptions, KeyedList, NixRef, PortalOutlet, ErrorFallback, TransitionOptions, TransitionContent, Store, StoreSignals, NixPlugin, Router, NamedRouteLocation, RouteLocation, RouteRecord, RouterOptions, NavigationGuard, NavigationGuardResult, AfterEachHook, ResolvedRoute, ScrollPosition, ScrollBehavior, RouterMode, NavigationDirection, NavigationIntent, NavigationAction, NavigateOptions, SuspenseOptions, InjectionKey, DeepPartial, Validator, ValidateOn, FieldState, FieldArrayState, FieldErrors, FormState, FormOptions, ValidatorsBase, NixChildren, } from "./nix";

package/dist/lib/nix/form.d.ts

@@ -69,6 +69,18 @@ export interface FieldState<T> {
     readonly onBlur: () => void;
     /** Reset to initial value and clear touched/dirty/error state. */
     reset(): void;
+    /**
+     * Set the field value programmatically.
+     *
+     * @param value — new value for the field.
+     * @param options — control whether to touch/dirty the field and whether to force
+     *   validation visibility.
+     */
+    setValue(value: T, options?: {
+        shouldTouch?: boolean;
+        shouldDirty?: boolean;
+        shouldValidate?: boolean;
+    }): void;
     /**
      * @internal — inject an external error message (server / schema validator).
      * The error clears automatically when the user next edits the field.
@@ -76,6 +88,8 @@ export interface FieldState<T> {
     _setExternalError(msg: string | null): void;
     /** @internal — force error visibility (e.g., on submit). */
     _forceVisible(): void;
+    /** @internal — update the stored initial value so a later reset() returns here. */
+    _setInitialValue(value: T): void;
     /** @internal — dispose computed signals. */
     _dispose(): void;
 }
@@ -100,8 +114,12 @@ export interface FieldArrayState<T extends Record<string, unknown>> {
     replace(index: number, value: T): void;
     /** Number of items in the array. Reactive. */
     readonly length: Signal<number>;
-    /** Resets the array to its initial value. */
-    reset(): void;
+    /** Replaces the whole array with a new list of items. */
+    setValues(items: T[]): void;
+    /** Patches existing items and appends any extras without touching untouched items. */
+    patchValues(items: Partial<T>[]): void;
+    /** Resets the array to its initial value, optionally updating that initial value. */
+    reset(items?: T[]): void;
     /** @internal */
     _dispose(): void;
 }
@@ -130,6 +148,9 @@ export type FieldErrors<T extends Record<string, unknown>> = {
 export type FormValidators<T extends Record<string, unknown>> = {
     [K in keyof T]?: Validator<T[K], T>[];
 } & Record<string, Validator<any, any>[] | undefined>;
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
 export interface FormState<T extends Record<string, unknown>> {
     /** Individual field states — access value, error, event handlers. */
     fields: FormFields<T>;
@@ -191,8 +212,30 @@ export interface FormState<T extends Record<string, unknown>> {
      * 5. Manages `isSubmitting` across async callbacks
      */
     handleSubmit(fn: (values: T) => void | Promise<void>): (e: Event) => void;
-    /** Reset all fields to their initial values. */
-    reset(): void;
+    /**
+     * Reset all fields to their initial values. If `newInitialValues` is provided,
+     * it becomes the new baseline and subsequent reset() calls will use it.
+     */
+    reset(newInitialValues?: T): void;
+    /**
+     * Set a single field value by its path (top-level or nested dot-path).
+     */
+    setValue(path: string, value: unknown, options?: {
+        shouldTouch?: boolean;
+        shouldDirty?: boolean;
+        shouldValidate?: boolean;
+    }): void;
+    /**
+     * Set multiple field values at once.
+     *
+     * @param values — partial object with top-level and/or nested values.
+     * @param options — control whether to preserve existing touched/dirty/error state.
+     */
+    setValues(values: DeepPartial<T>, options?: {
+        keepDirty?: boolean;
+        keepTouched?: boolean;
+        keepErrors?: boolean;
+    }): void;
     /**
      * Inject external errors (e.g., from a server response) into specific fields.
      * Each field's error clears automatically the next time the user edits it.

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

@@ -16,4 +16,4 @@ export type { SuspenseOptions } from "./async";
 export { provide, inject, createInjectionKey } from "./context";
 export type { InjectionKey } from "./context";
 export { nixField, nixFieldArray, createForm, required, minLength, maxLength, email, pattern, min, max, createValidator, validators, extendValidators, } from "./form";
-export type { Validator, ValidateOn, FieldState, FieldArrayState, FieldErrors, FormState, FormOptions, ValidatorsBase } from "./form";
+export type { DeepPartial, Validator, ValidateOn, FieldState, FieldArrayState, FieldErrors, FormState, FormOptions, ValidatorsBase } from "./form";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deijose/nix-js",
-  "version": "2.5.4",
+  "version": "2.6.0",
   "description": "A lightweight, fully reactive micro-framework — no virtual DOM, no compiler, just signals and tagged templates.",
   "license": "MIT",
   "author": "Deiver Vasquez",