@deijose/nix-js 2.0.2 → 2.2.0

package/README.md

@@ -44,7 +44,7 @@ This is optional: `import { ... } from "@deijose/nix-js"` remains fully supporte
 ## Quick Start
 
 ```typescript
-import { signal, html, NixTemplate, NixComponent, mount, createRouter, RouterView, Link, useRouter } from "@deijose/nix-js";
+import { signal, html, NixTemplate, NixComponent, mount, createRouter, RouterView, Link, nixRouter } from "@deijose/nix-js";
 
 // --- Pages as function components (NixTemplate) ---
 // Plain functions returning html`` are recommended for pages and
@@ -60,7 +60,7 @@ function HomePage(): NixTemplate {
 }
 
 function UserPage(): NixTemplate {
-  const router = useRouter();
+  const router = nixRouter();
   return html`<h1>User: ${() => router.params.value.id}</h1>`;
 }
 
@@ -112,8 +112,8 @@ Everything ships in a single zero-dependency import:
 | **Reactivity** | `signal`, `computed`, `effect`, `batch`, `watch`, `untrack`, `nextTick` |
 | **Templates** | `` html` ` ``, `repeat`, `ref`, `portal`, `transition`, `showWhen` |
 | **Components** | `NixTemplate` (function components), `NixComponent` (lifecycle class), `mount`, children & named slots |
-| **Router** | `createRouter`, `RouterView`, `Link`, `useRouter`, `RouterKey`, guards, nested routes, named routes (`name` + `navigate({ name })`), `mount(..., { router })` |
-| **Forms** | `useField`, `createForm`, built-in validators, Zod/Valibot interop |
+| **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 |
 | **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=e.computed(()=>{if(a.value)return a.value;if(!("input"===n?o.value||i.value:"submit"===n?s.value:i.value))return null;let e=l?.();for(let t of r){let r=t(u.value,e);if(r)return r}return null});return{value:u,error:f,touched:i,dirty:o,onInput:e=>{u.value=function(e){if(!e||!("value"in e))return t;let r=e;return"boolean"==typeof t?r.checked:"number"==typeof t?Number(r.value):r.value}(e.target),o.value=!0,a.value=null},onBlur:()=>{i.value=!0},reset:function(){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(){f.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].error.value)return!1;return!0}),v=e.computed(()=>{for(let e in l)if(l[e].dirty.value)return!0;return!1}),p=e.computed(()=>{for(let e in l)if(l[e].touched.value)return!0;return!1});function g(e){for(let t in e)l[t]?._setExternalError(e[t]??null)}return{fields:l,values:s,errors:f,valid:c,dirty:v,touched:p,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 g(t)}}for(let e in l)if(l[e].error.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:g,dispose:function(){s.dispose(),f.dispose(),c.dispose(),v.dispose(),p.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.pattern=i,exports.required=t,exports.useField=d,exports.useFieldArray=f,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 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)}),v=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}),p=e.computed(()=>("input"===n?o.value||i.value:"submit"===n?s.value:i.value)?v.value:null);return{value:u,error:p,rawError:v,touched:i,dirty:o,onInput:e=>{u.value=function(e){if(!e||!("value"in e))return t;let r=e;return"boolean"==typeof t?r.checked:"number"==typeof t?Number(r.value):r.value}(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(),p.dispose(),v.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}),v=e.computed(()=>{for(let e in l)if(l[e].error.value)return!1;return!0}),p=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:v,dirty:p,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(),v.dispose(),p.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;

package/dist/lib/form.js

@@ -1 +1 @@
-import{computed as e,signal as t}from"./signals.js";function n(e="Required"){return t=>null==t||""===t||Array.isArray(t)&&0===t.length?e:null}function r(e,t){return n=>"string"==typeof n&&n.length<e?t??`Minimum ${e} characters`:null}function i(e,t){return n=>"string"==typeof n&&n.length>e?t??`Maximum ${e} characters`:null}function a(e,t="Invalid format"){return n=>"string"!=typeof n||e.test(n)?null:t}function o(e="Invalid email"){return a(/^[^\s@]+@[^\s@]+\.[^\s@]+$/,e)}function s(e,t){return n=>"number"==typeof n&&n<e?t??`Minimum value is ${e}`:null}function c(e,t){return n=>"number"==typeof n&&n>e?t??`Maximum value is ${e}`:null}function l(e){return e}var u={required:n,minLength:r,maxLength:i,email:o,pattern:a,min:s,max:c};function d(e,t){return{...e,...t}}function f(n,r=[],l="blur",u){let i=t(n),a=t(!1),o=t(!1),s=t(null),f=t(!1),v=e(()=>{if(s.value)return s.value;if(!("input"===l?o.value||a.value:"submit"===l?f.value:a.value))return null;let e=u?.();for(let t of r){let n=t(i.value,e);if(n)return n}return null});return{value:i,error:v,touched:a,dirty:o,onInput:e=>{i.value=function(e){if(!e||!("value"in e))return n;let t=e;return"boolean"==typeof n?t.checked:"number"==typeof n?Number(t.value):t.value}(e.target),o.value=!0,s.value=null},onBlur:()=>{a.value=!0},reset:function(){i.value=n,a.value=!1,o.value=!1,s.value=null,f.value=!1},_setExternalError:function(e){s.value=e,e&&(a.value=!0)},_forceVisible:function(){a.value=!0,f.value=!0},_dispose:function(){v.dispose()}}}function p(n,r={},l="blur"){function u(e){let t={};for(let n in e){let u=r[n]??[];t[n]=f(e[n],u,l)}return t}let i=t(n.map(u)),a=e(()=>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 n in t[e])t[e][n]._dispose();i.value=t.filter((t,n)=>n!==e)}},move:function(e,t){let n=[...i.value];if(e<0||e>=n.length||t<0||t>=n.length||e===t)return;let[r]=n.splice(e,1);n.splice(t,0,r),i.value=n},replace:function(e,t){let n=[...i.value];if(!(e<0||e>=n.length)){for(let t in n[e])n[e][t]._dispose();n[e]=u(t),i.value=n}},length:a,reset:function(){for(let e of i.value)for(let t in e)e[t]._dispose();i.value=n.map(u)},_dispose:function(){for(let e of i.value)for(let t in e)e[t]._dispose();a.dispose()}}}function m(e){return"object"==typeof e&&!!e&&!Array.isArray(e)}function h(e,t="",n=[]){for(let[r,l]of Object.entries(e)){let e=t?`${t}.${r}`:r;m(l)&&Object.keys(l).length>0?h(l,e,n):n.push([e,l])}return n}function g(e,t,n){let r=t.split("."),l=e;for(let e=0;e<r.length-1;e++){let t=r[e];m(l[t])||(l[t]={}),l=l[t]}l[r[r.length-1]]=n}function _(n,r={}){let l=r.validateOn??"blur",u={},i=r.validators;function a(){let e={};for(let t in u)g(e,t,u[t].value.value);return e}for(let[e,t]of h(n))u[e]=f(t,i?.[e]??[],l,a);let o=t(!1),s=t(0),v=e(()=>a()),c=e(()=>{let e={};for(let t in u){let n=u[t].error.value;n&&(e[t]=n)}return e}),d=e(()=>{for(let e in u)if(u[e].error.value)return!1;return!0}),p=e(()=>{for(let e in u)if(u[e].dirty.value)return!0;return!1}),m=e(()=>{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:v,errors:c,valid:d,dirty:p,touched:m,isSubmitting:o,submitCount:s,handleSubmit:function(e){return t=>{t.preventDefault(),s.value++;for(let e in u)u[e]._forceVisible();let n=v.value;if(r.validate){let e=r.validate(n);if(e){let t={},n=!1;for(let r in e){let l=e[r],u=Array.isArray(l)?l[0]??null:l??null;u&&(t[r]=u,n=!0)}if(n)return void y(t)}}for(let e in u)if(u[e].error.value)return;let l=e(n);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(){v.dispose(),c.dispose(),d.dispose(),p.dispose(),m.dispose();for(let e in u)u[e]._dispose()}}}export{_ as createForm,l as createValidator,o as email,d as extendValidators,c as max,i as maxLength,s as min,r as minLength,a as pattern,n as required,f as useField,p as useFieldArray,u 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 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;return"boolean"==typeof l?t.checked:"number"==typeof l?Number(t.value):t.value}(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};

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, createRouter, RouterView, Link, useRouter, RouterKey, suspend, lazy, provide, inject, createInjectionKey, useField, useFieldArray, createForm, required, minLength, maxLength, email, pattern, min, max, createValidator, validators, extendValidators, } from "./nix";
+export { Signal, signal, effect, computed, batch, watch, untrack, nextTick, html, repeat, ref, showWhen, portal, createPortalOutlet, portalOutlet, provideOutlet, injectOutlet, createErrorBoundary, transition, mount, NixComponent, createStore, createRouter, RouterView, Link, nixRouter, RouterKey, 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, Router, NamedRouteLocation, RouteLocation, RouteRecord, RouterOptions, NavigationGuard, NavigationGuardResult, AfterEachHook, ResolvedRoute, ScrollPosition, ScrollBehavior, RouterMode, SuspenseOptions, InjectionKey, Validator, ValidateOn, FieldState, FieldArrayState, FieldErrors, FormState, FormOptions, ValidatorsBase, NixChildren, } from "./nix";

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

@@ -1,8 +1,18 @@
 import type { Signal } from "./reactivity";
 /**
- * A validator function. Return an error string, or null/undefined if valid.
+ * A validator function. Return an error string when invalid, or `null` /
+ * `undefined` when valid.
  *
- * `allValues` is optional and is provided when the validator runs inside `createForm`.
+ * `allValues` is provided when the validator runs inside `createForm`, enabling
+ * cross-field validation (e.g., "confirm password matches password").
+ *
+ * **Validators must be pure.** They are invoked reactively whenever the field
+ * value changes — potentially many times per keystroke in forms with
+ * cross-field rules — and may run inside computed signals that assume
+ * deterministic output. Do not perform I/O, mutate external state, or rely on
+ * `Date.now()` / `Math.random()` inside a validator. For asynchronous checks
+ * (uniqueness, server-side rules), submit the form and inject the result via
+ * {@link FormState.setErrors}.
  */
 export type Validator<T, AllValues = unknown> = (value: T, allValues?: AllValues) => string | null | undefined;
 export declare function required(message?: string): Validator<unknown>;
@@ -12,7 +22,7 @@ export declare function pattern(regex: RegExp, message?: string): Validator<stri
 export declare function email(message?: string): Validator<string>;
 export declare function min(n: number, message?: string): Validator<number>;
 export declare function max(n: number, message?: string): Validator<number>;
-/** Creates a typed custom validator compatible with `useField` and `createForm`. */
+/** Creates a typed custom validator compatible with `nixField` and `createForm`. */
 export declare function createValidator<T, AllValues = unknown>(fn: (value: T, allValues?: AllValues) => string | null | undefined): Validator<T, AllValues>;
 /** All built-in validators grouped as a namespace. Extensible via `extendValidators`. */
 export declare const validators: {
@@ -42,11 +52,13 @@ export type ValidateOn = "blur" | "input" | "submit";
 export interface FieldState<T> {
     /** Current value — read/write signal. */
     value: Signal<T>;
+    /** Error visible según validateOn. Para UI. */
+    readonly error: Signal<string | null>;
     /**
-     * Current error message, or null.
-     * Visibility depends on `validateOn` option.
+     * Error real, ignorando validateOn/touched/dirty.
+     * Para lógica de habilitación de botones, validez global, etc.
      */
-    readonly error: Signal<string | null>;
+    readonly rawError: Signal<string | null>;
     /** True after the input has lost focus at least once. */
     touched: Signal<boolean>;
     /** True after the user has typed at least once. */
@@ -68,7 +80,7 @@ export interface FieldState<T> {
     _dispose(): void;
 }
 /** Creates a standalone reactive form field with optional validators. */
-export declare function useField<T, AllValues = unknown>(initialValue: T, fieldValidators?: Validator<T, AllValues>[], validateOn?: ValidateOn, getAllValues?: () => AllValues): FieldState<T>;
+export declare function nixField<T, AllValues = unknown>(initialValue: T, fieldValidators?: Validator<T, AllValues>[], validateOn?: ValidateOn, getAllValues?: () => AllValues): FieldState<T>;
 /** Public state of a field array (dynamic list of field groups). */
 export interface FieldArrayState<T extends Record<string, unknown>> {
     /** Reactive list of field group states. */
@@ -97,13 +109,13 @@ export interface FieldArrayState<T extends Record<string, unknown>> {
  * Creates a reactive array of field groups for dynamic list forms.
  *
  * @example
- * const items = useFieldArray([{ name: "" }], {
+ * const items = nixFieldArray([{ name: "" }], {
  *     name: [required()],
  * });
  * items.append({ name: "nuevo" });
  * items.remove(0);
  */
-export declare function useFieldArray<T extends Record<string, unknown>>(initialItems: T[], fieldValidators?: {
+export declare function nixFieldArray<T extends Record<string, unknown>>(initialItems: T[], fieldValidators?: {
     [K in keyof T]?: Validator<T[K], unknown>[];
 }, validateOn?: ValidateOn): FieldArrayState<T>;
 /** Field-name map that supports top-level keys and dot-path nested keys. */
@@ -125,8 +137,43 @@ export interface FormState<T extends Record<string, unknown>> {
     readonly values: Signal<T>;
     /** Computed map of all currently visible field errors. */
     readonly errors: Signal<FieldErrors<T>>;
-    /** True when no field has a visible error (meaningful after submit / touch-all). */
+    /**
+     * True when no field has a *visible* error.
+     *
+     * Visibility follows `validateOn`, so this signal reflects what the user
+     * currently sees in the UI — not the underlying validity of the data.
+     * Use it to drive error summaries, banners, or any UI that should only
+     * react to errors the user has been shown.
+     *
+     * For enabling or disabling submit buttons, use {@link canSubmit} instead.
+     */
     readonly valid: Signal<boolean>;
+    /**
+     * True when every per-field validator passes against the current values,
+     * regardless of `touched`, `dirty`, or `validateOn`.
+     *
+     * This is the signal to bind to submit buttons:
+     *
+     * ```ts
+     * <button disabled=${() => !form.canSubmit.value || form.isSubmitting.value}>
+     *   Save
+     * </button>
+     * ```
+     *
+     * Unlike {@link valid}, `canSubmit` does not depend on whether errors are
+     * currently visible — a pristine form with empty required fields starts
+     * as `false` and flips to `true` the moment all validators pass.
+     *
+     * External errors injected via {@link setErrors} also flip `canSubmit` to
+     * `false` until the user edits the affected field.
+     *
+     * **Note:** `canSubmit` does not execute `options.validate` (schema-level
+     * validators such as Zod). Schema validation runs only on submit, by design,
+     * to keep per-keystroke cost predictable. If you need a schema rule to
+     * affect `canSubmit` reactively, express it as a per-field validator in
+     * `options.validators` instead.
+     */
+    readonly canSubmit: Signal<boolean>;
     /** True when at least one field has been modified. */
     readonly dirty: Signal<boolean>;
     /** True when at least one field has been touched (lost focus). */

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

@@ -8,11 +8,11 @@ export { NixComponent } from "./lifecycle";
 export type { NixChildren } from "./lifecycle";
 export { createStore } from "./store";
 export type { Store, StoreSignals } from "./store";
-export { createRouter, RouterView, Link, useRouter, RouterKey } from "./router";
+export { createRouter, RouterView, Link, nixRouter, RouterKey } from "./router";
 export type { Router, NamedRouteLocation, RouteLocation, RouteRecord, RouterOptions, NavigationGuard, NavigationGuardResult, AfterEachHook, ResolvedRoute, ScrollPosition, ScrollBehavior, RouterMode, } from "./router";
 export { suspend, lazy } from "./async";
 export type { SuspenseOptions } from "./async";
 export { provide, inject, createInjectionKey } from "./context";
 export type { InjectionKey } from "./context";
-export { useField, useFieldArray, createForm, required, minLength, maxLength, email, pattern, min, max, createValidator, validators, extendValidators, } from "./form";
+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";

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

@@ -144,7 +144,7 @@ export interface _RouterDebugInternal {
  */
 export declare function createRouter(routes: RouteRecord[], options?: RouterOptions): Router;
 /** Returns the active router singleton. */
-export declare function useRouter(): Router;
+export declare function nixRouter(): Router;
 /**
  * @internal — Resets the router singleton. Used by tests to avoid
  * "A router already exists" warnings between test cases.

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

@@ -1,24 +1,54 @@
-import { Signal } from "./reactivity";
-/** Maps each state property to its corresponding Signal. */
+import { Signal, type WatchOptions } from "./reactivity";
 export type StoreSignals<T extends Record<string, unknown>> = {
     readonly [K in keyof T]: Signal<T[K]>;
 };
-/** Subscriber callback used by `$subscribe`. */
-export type StoreSubscriber<T extends Record<string, unknown>> = (key: keyof T, newValue: T[keyof T], oldValue: T[keyof T] | undefined) => void;
-/** The store as seen by the consumer: signals + actions + getters + built-ins. */
-export type Store<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>> = StoreSignals<T> & A & G & {
-    /** The current state snapshot. Reactive. */
+export type ReadonlySignal<T> = Omit<Signal<T>, "value" | "update" | "dispose"> & {
+    readonly value: T;
+    readonly dispose: never;
+};
+export type StoreGetters<G extends Record<string, Signal<unknown>>> = {
+    readonly [K in keyof G]: ReadonlySignal<G[K] extends Signal<infer V> ? V : never>;
+};
+export type Store<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>> = StoreSignals<T> & A & StoreGetters<G> & {
+    readonly $id: string;
+    /** Current snapshot — reading inside effect/computed creates subscription. */
     readonly $state: T;
-    /** Resets all signals to their initial values. */
+    /**
+     * The computed Signal that backs $state.
+     * Plugins receive this to compose new reactive nodes on top.
+     * This is what makes the plugin system reactive-native:
+     * no hooks, just signals all the way down.
+     */
+    readonly $stateSignal: ReadonlySignal<T>;
+    /** Reset to initial values (batched). */
     $reset(): void;
-    /** Patches the store with a partial state. */
+    /** Partial update (batched). */
     $patch(partial: Partial<T>): void;
-    /** Subscribes to all store signal changes. Returns an unsubscribe function. */
-    $subscribe(listener: StoreSubscriber<T>): () => void;
+    /**
+     * Watches state changes. This is exactly watch() from reactivity.ts —
+     * no new primitive to learn.
+     */
+    $watch(cb: (next: T, prev: T | undefined) => void, options?: WatchOptions): () => void;
+    /** Disposes the store and runs all plugin cleanups. */
+    $dispose(): void;
 };
 /**
- * Creates a reactive global store. Each property becomes a Signal.
- * Optional `actionsFactory` receives the signals and returns action methods.
- * Optional `gettersFactory` receives the signals and returns derived getter signals.
+ * A NixPlugin is a function that receives the assembled store and
+ * optionally returns a cleanup function.
+ *
+ * There are NO lifecycle hooks. The plugin extends the signal graph directly:
+ *
+ *   watch(store.$stateSignal, ...)        — react to any state change
+ *   computed(() => store.someSignal.value) — derive new nodes
+ *   store.mySignal = signal(...)           — attach new reactive state
+ *   wrapMethod(store, '$patch', ...)       — intercept mutations
+ *
+ * Because plugins only use Nix.js primitives, they compose with each other
+ * naturally — one plugin can observe a signal that another plugin added.
  */
-export declare function createStore<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>>(initialState: T, actionsFactory?: (signals: StoreSignals<T>) => A, gettersFactory?: (signals: StoreSignals<T>) => G): Store<T, A, G>;
+export type NixPlugin<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>> = (store: Store<T, A, G>) => (() => void) | void;
+export interface CreateStoreOptions<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>> {
+    name?: string;
+    plugins?: NixPlugin<T, A, G>[];
+}
+export declare function createStore<T extends Record<string, unknown>, A extends Record<string, unknown> = Record<never, never>, G extends Record<string, Signal<unknown>> = Record<never, never>>(initialState: T, actionsFactory?: (signals: StoreSignals<T>) => A, gettersFactory?: (signals: StoreSignals<T>) => G, options?: CreateStoreOptions<T, A, G>): Store<T, A, G>;

package/dist/lib/nix-js.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs"),t=require("./template2.cjs"),n=require("./lifecycle.cjs"),r=require("./context.cjs"),i=require("./router.cjs"),a=require("./component.cjs"),o=require("./store.cjs"),s=require("./async.cjs"),c=require("./form.cjs");exports.Link=i.Link,exports.NixComponent=n.NixComponent,exports.RouterKey=i.RouterKey,exports.RouterView=i.RouterView,exports.Signal=e.Signal,exports.batch=e.batch,exports.computed=e.computed,exports.createErrorBoundary=t.t,exports.createForm=c.createForm,exports.createInjectionKey=r.createInjectionKey,exports.createPortalOutlet=t.n,exports.createRouter=i.createRouter,exports.createStore=o.createStore,exports.createValidator=c.createValidator,exports.effect=e.effect,exports.email=c.email,exports.extendValidators=c.extendValidators,exports.html=t.l,exports.inject=r.inject,exports.injectOutlet=t.r,exports.lazy=s.lazy,exports.max=c.max,exports.maxLength=c.maxLength,exports.min=c.min,exports.minLength=c.minLength,exports.mount=a.mount,exports.nextTick=e.nextTick,exports.pattern=c.pattern,exports.portal=t.i,exports.portalOutlet=t.a,exports.provide=r.provide,exports.provideOutlet=t.o,exports.ref=t.h,exports.repeat=t.d,exports.required=c.required,exports.showWhen=t.u,exports.signal=e.signal,exports.suspend=s.suspend,exports.transition=t.s,exports.untrack=e.untrack,exports.useField=c.useField,exports.useFieldArray=c.useFieldArray,exports.useRouter=i.useRouter,exports.validators=c.validators,exports.watch=e.watch;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs"),t=require("./template2.cjs"),n=require("./lifecycle.cjs"),r=require("./context.cjs"),i=require("./router.cjs"),a=require("./component.cjs"),o=require("./store.cjs"),s=require("./async.cjs"),c=require("./form.cjs");exports.Link=i.Link,exports.NixComponent=n.NixComponent,exports.RouterKey=i.RouterKey,exports.RouterView=i.RouterView,exports.Signal=e.Signal,exports.batch=e.batch,exports.computed=e.computed,exports.createErrorBoundary=t.t,exports.createForm=c.createForm,exports.createInjectionKey=r.createInjectionKey,exports.createPortalOutlet=t.n,exports.createRouter=i.createRouter,exports.createStore=o.createStore,exports.createValidator=c.createValidator,exports.effect=e.effect,exports.email=c.email,exports.extendValidators=c.extendValidators,exports.html=t.l,exports.inject=r.inject,exports.injectOutlet=t.r,exports.lazy=s.lazy,exports.max=c.max,exports.maxLength=c.maxLength,exports.min=c.min,exports.minLength=c.minLength,exports.mount=a.mount,exports.nextTick=e.nextTick,exports.nixField=c.nixField,exports.nixFieldArray=c.nixFieldArray,exports.nixRouter=i.nixRouter,exports.pattern=c.pattern,exports.portal=t.i,exports.portalOutlet=t.a,exports.provide=r.provide,exports.provideOutlet=t.o,exports.ref=t.h,exports.repeat=t.d,exports.required=c.required,exports.showWhen=t.u,exports.signal=e.signal,exports.suspend=s.suspend,exports.transition=t.s,exports.untrack=e.untrack,exports.validators=c.validators,exports.watch=e.watch;

package/dist/lib/nix-js.js

@@ -1 +1 @@
-import{Signal as e,batch as t,computed as n,effect as r,nextTick as i,signal as a,untrack as o,watch as s}from"./signals.js";import{a as c,d as l,h as u,i as d,l as f,n as p,o as m,r as h,s as g,t as _,u as v}from"./template2.js";import{NixComponent as y}from"./lifecycle.js";import{createInjectionKey as b,inject as x,provide as S}from"./context.js";import{Link as C,RouterKey as w,RouterView as T,createRouter as E,useRouter as D}from"./router.js";import{mount as O}from"./component.js";import{createStore as k}from"./store.js";import{lazy as A,suspend as j}from"./async.js";import{createForm as M,createValidator as N,email as P,extendValidators as F,max as I,maxLength as L,min as R,minLength as z,pattern as B,required as V,useField as H,useFieldArray as U,validators as W}from"./form.js";export{C as Link,y as NixComponent,w as RouterKey,T as RouterView,e as Signal,t as batch,n as computed,_ as createErrorBoundary,M as createForm,b as createInjectionKey,p as createPortalOutlet,E as createRouter,k as createStore,N as createValidator,r as effect,P as email,F as extendValidators,f as html,x as inject,h as injectOutlet,A as lazy,I as max,L as maxLength,R as min,z as minLength,O as mount,i as nextTick,B as pattern,d as portal,c as portalOutlet,S as provide,m as provideOutlet,u as ref,l as repeat,V as required,v as showWhen,a as signal,j as suspend,g as transition,o as untrack,H as useField,U as useFieldArray,D as useRouter,W as validators,s as watch};
+import{Signal as e,batch as t,computed as n,effect as r,nextTick as i,signal as a,untrack as o,watch as s}from"./signals.js";import{a as c,d as l,h as u,i as d,l as f,n as p,o as m,r as h,s as g,t as _,u as v}from"./template2.js";import{NixComponent as y}from"./lifecycle.js";import{createInjectionKey as b,inject as x,provide as S}from"./context.js";import{Link as C,RouterKey as w,RouterView as T,createRouter as E,nixRouter as D}from"./router.js";import{mount as O}from"./component.js";import{createStore as k}from"./store.js";import{lazy as A,suspend as j}from"./async.js";import{createForm as M,createValidator as N,email as P,extendValidators as F,max as I,maxLength as L,min as R,minLength as z,nixField as B,nixFieldArray as V,pattern as H,required as U,validators as W}from"./form.js";export{C as Link,y as NixComponent,w as RouterKey,T as RouterView,e as Signal,t as batch,n as computed,_ as createErrorBoundary,M as createForm,b as createInjectionKey,p as createPortalOutlet,E as createRouter,k as createStore,N as createValidator,r as effect,P as email,F as extendValidators,f as html,x as inject,h as injectOutlet,A as lazy,I as max,L as maxLength,R as min,z as minLength,O as mount,i as nextTick,B as nixField,V as nixFieldArray,D as nixRouter,H as pattern,d as portal,c as portalOutlet,S as provide,m as provideOutlet,u as ref,l as repeat,U as required,v as showWhen,a as signal,j as suspend,g as transition,o as untrack,W as validators,s as watch};

package/dist/lib/router.cjs

@@ -4,4 +4,4 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=requi
       href=${"hash"===n._mode?"#"+o:o}
       style=${()=>n.current.value===e?"color:#38bdf8;font-weight:700;text-decoration:none;cursor:pointer;padding:4px 10px;border-radius:4px;background:#0c2a3a":"color:#a3a3a3;text-decoration:none;cursor:pointer;padding:4px 10px;border-radius:4px"}
       @click=${t=>{t.preventDefault(),n.navigate(e)}}
-    >${r}</a>`}};exports.Link=D,exports.RouterKey=i,exports.RouterView=E,exports._debugGetRouterInternal=T,exports._resetRouter=w,exports.createRouter=S,exports.useRouter=C;
+    >${r}</a>`}};exports.Link=D,exports.RouterKey=i,exports.RouterView=E,exports._debugGetRouterInternal=T,exports._resetRouter=w,exports.createRouter=S,exports.nixRouter=C;

package/dist/lib/router.js

@@ -4,4 +4,4 @@ import{signal as e}from"./signals.js";import{l as t}from"./template2.js";import{
       href=${"hash"===n._mode?"#"+a:a}
       style=${()=>n.current.value===e?"color:#38bdf8;font-weight:700;text-decoration:none;cursor:pointer;padding:4px 10px;border-radius:4px;background:#0c2a3a":"color:#a3a3a3;text-decoration:none;cursor:pointer;padding:4px 10px;border-radius:4px"}
       @click=${t=>{t.preventDefault(),n.navigate(e)}}
-    >${r}</a>`}};export{O as Link,a as RouterKey,D as RouterView,E as _debugGetRouterInternal,T as _resetRouter,C as createRouter,w as useRouter};
+    >${r}</a>`}};export{O as Link,a as RouterKey,D as RouterView,E as _debugGetRouterInternal,T as _resetRouter,C as createRouter,w as nixRouter};

package/dist/lib/store.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs");function t(t,r,o){let n={},s=new Set(["$reset","$patch","$state","$subscribe"]);for(let r of Object.keys(t)){if(s.has(r))throw Error(`[Nix] Store key "${r}" is reserved.`);n[r]=e.signal(t[r])}let l=n;let i=Object.assign(Object.create(null),l,{$reset:function(){for(let e of Object.keys(t))n[e].value=t[e]},$patch:function(e){for(let t of Object.keys(e))t in n&&(n[t].value=e[t])},$subscribe:function(r){let o=[];for(let n of Object.keys(t)){let t=l[n],s=e.watch(t,(e,t)=>{r(n,e,t)});o.push(s)}return()=>{for(let e of o)e()}}});if(Object.defineProperty(i,"$state",{get(){let e={};for(let t in n)e[t]=n[t].value;return e},enumerable:!0,configurable:!1}),r){let e=r(l);for(let t of Object.keys(e))s.has(t)?console.warn(`[Nix] Store action name "${t}" is reserved and will be ignored.`):i[t]=e[t]}if(o){let e=o(l);for(let t of Object.keys(e))s.has(t)?console.warn(`[Nix] Store getter name "${t}" is reserved and will be ignored.`):i[t]=e[t]}return i}exports.createStore=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signals.cjs");var t=new Set(["$id","$state","$stateSignal","$reset","$patch","$watch","$dispose"]);function n(e){if("__proto__"===e||"constructor"===e||"prototype"===e)throw Error(`[Nix] Store key "${e}" is not allowed for security reasons.`);if(t.has(e))throw Error(`[Nix] Store key "${e}" is reserved.`)}function r(e,r){return!t.has(e)||(console.warn(`[Nix] Store ${r} "${e}" is reserved and will be ignored.`),!1)}function i(e,t){let r=Object.create(e);return Object.defineProperty(r,"dispose",{value:()=>{throw Error(`[Nix] Cannot dispose readonly getter "${t}". Dispose the store instead with store.$dispose().`)},writable:!1,configurable:!1}),Object.defineProperty(r,"value",{get:()=>e.value,set(){throw Error(`[Nix] "${t}" is read-only.`)},configurable:!1}),Object.defineProperty(r,"update",{value:()=>{throw Error(`[Nix] "${t}" is read-only.`)},writable:!1,configurable:!1}),r}function a(o,a,l,s={}){let{name:c="store",plugins:f=[]}=s,u=Object.keys(o),d={};for(let t of u)n(t),d[t]=e.signal(o[t]);let b,$=d,g=e.computed(()=>{let e={};for(let t of u)e[t]=d[t].value;return e}),p=i(g,`store "${c}".$stateSignal`);try{b=structuredClone(o)}catch(e){throw Error(`[Nix] Store "${c}" initialState contains non-serializable data (functions, DOM nodes, Symbols, or WeakRefs). Remove these before creating the store. Original error: ${e}`)}let h=Object.assign(Object.create(null),$,{$reset:function(){e.batch(()=>{for(let e of u)d[e].value=b[e]})},$patch:function(t){e.batch(()=>{for(let e of Object.keys(t))Object.prototype.hasOwnProperty.call(d,e)&&(d[e].value=t[e])})},$watch:function(t,r){return e.watch(g,t,r)}});Object.defineProperty(h,"$id",{value:c,writable:!1,enumerable:!1,configurable:!1}),Object.defineProperty(h,"$state",{get:()=>g.value,enumerable:!0,configurable:!1}),Object.defineProperty(h,"$stateSignal",{value:p,writable:!1,enumerable:!1,configurable:!1});let w=new Set([...u,...Array.from(t)]);if(a){let e=a($);for(let t of Object.keys(e))if(r(t,"action")){if(w.has(t)){console.warn(`[Nix] Store "${c}": action "${t}" collides with an existing signal or getter and will be ignored.`);continue}w.add(t),h[t]=e[t]}}if(l){let t=l($);for(let o of Object.keys(t)){if(!r(o,"getter"))continue;if(w.has(o)){console.warn(`[Nix] Store "${c}": getter "${o}" collides with an existing signal or action and will be ignored.`);continue}let n=t[o];if(!(n instanceof e.Signal))throw TypeError(`[Nix] Store "${c}": getter "${o}" must return a Signal (wrap it with computed()). Got: ${typeof n}`);w.add(o),h[o]=i(n,`getter "${o}" in store "${c}"`)}}let y=[()=>g.dispose()];for(let e of f)try{let t=e(h);"function"==typeof t&&y.push(t)}catch(e){console.error(`[Nix] Plugin initialization failed for store "${c}":`,e)}return h.$dispose=()=>{for(let e of y)e()},h}exports.createStore=a;

package/dist/lib/store.js

@@ -1 +1 @@
-import{signal as e,watch as t}from"./signals.js";function n(r,o,s){let n={},l=new Set(["$reset","$patch","$state","$subscribe"]);for(let t of Object.keys(r)){if(l.has(t))throw Error(`[Nix] Store key "${t}" is reserved.`);n[t]=e(r[t])}let a=n;let i=Object.assign(Object.create(null),a,{$reset:function(){for(let e of Object.keys(r))n[e].value=r[e]},$patch:function(e){for(let t of Object.keys(e))t in n&&(n[t].value=e[t])},$subscribe:function(e){let o=[];for(let s of Object.keys(r)){let r=a[s],n=t(r,(t,r)=>{e(s,t,r)});o.push(n)}return()=>{for(let e of o)e()}}});if(Object.defineProperty(i,"$state",{get(){let e={};for(let t in n)e[t]=n[t].value;return e},enumerable:!0,configurable:!1}),o){let e=o(a);for(let t of Object.keys(e))l.has(t)?console.warn(`[Nix] Store action name "${t}" is reserved and will be ignored.`):i[t]=e[t]}if(s){let e=s(a);for(let t of Object.keys(e))l.has(t)?console.warn(`[Nix] Store getter name "${t}" is reserved and will be ignored.`):i[t]=e[t]}return i}export{n as createStore};
+import{Signal as e,batch as t,computed as n,signal as r,watch as i}from"./signals.js";var a=new Set(["$id","$state","$stateSignal","$reset","$patch","$watch","$dispose"]);function o(e){if("__proto__"===e||"constructor"===e||"prototype"===e)throw Error(`[Nix] Store key "${e}" is not allowed for security reasons.`);if(a.has(e))throw Error(`[Nix] Store key "${e}" is reserved.`)}function s(e,t){return!a.has(e)||(console.warn(`[Nix] Store ${t} "${e}" is reserved and will be ignored.`),!1)}function c(e,t){let r=Object.create(e);return Object.defineProperty(r,"dispose",{value:()=>{throw Error(`[Nix] Cannot dispose readonly getter "${t}". Dispose the store instead with store.$dispose().`)},writable:!1,configurable:!1}),Object.defineProperty(r,"value",{get:()=>e.value,set(){throw Error(`[Nix] "${t}" is read-only.`)},configurable:!1}),Object.defineProperty(r,"update",{value:()=>{throw Error(`[Nix] "${t}" is read-only.`)},writable:!1,configurable:!1}),r}function l(l,f,u,d={}){let{name:$="store",plugins:b=[]}=d,g=Object.keys(l),p={};for(let e of g)o(e),p[e]=r(l[e]);let w,h=p,y=n(()=>{let e={};for(let t of g)e[t]=p[t].value;return e}),O=c(y,`store "${$}".$stateSignal`);try{w=structuredClone(l)}catch(e){throw Error(`[Nix] Store "${$}" initialState contains non-serializable data (functions, DOM nodes, Symbols, or WeakRefs). Remove these before creating the store. Original error: ${e}`)}let S=Object.assign(Object.create(null),h,{$reset:function(){t(()=>{for(let e of g)p[e].value=w[e]})},$patch:function(e){t(()=>{for(let t of Object.keys(e))Object.prototype.hasOwnProperty.call(p,t)&&(p[t].value=e[t])})},$watch:function(e,t){return i(y,e,t)}});Object.defineProperty(S,"$id",{value:$,writable:!1,enumerable:!1,configurable:!1}),Object.defineProperty(S,"$state",{get:()=>y.value,enumerable:!0,configurable:!1}),Object.defineProperty(S,"$stateSignal",{value:O,writable:!1,enumerable:!1,configurable:!1});let j=new Set([...g,...Array.from(a)]);if(f){let e=f(h);for(let t of Object.keys(e))if(s(t,"action")){if(j.has(t)){console.warn(`[Nix] Store "${$}": action "${t}" collides with an existing signal or getter and will be ignored.`);continue}j.add(t),S[t]=e[t]}}if(u){let t=u(h);for(let r of Object.keys(t)){if(!s(r,"getter"))continue;if(j.has(r)){console.warn(`[Nix] Store "${$}": getter "${r}" collides with an existing signal or action and will be ignored.`);continue}let o=t[r];if(!(o instanceof e))throw TypeError(`[Nix] Store "${$}": getter "${r}" must return a Signal (wrap it with computed()). Got: ${typeof o}`);j.add(r),S[r]=c(o,`getter "${r}" in store "${$}"`)}}let v=[()=>y.dispose()];for(let e of b)try{let t=e(S);"function"==typeof t&&v.push(t)}catch(e){console.error(`[Nix] Plugin initialization failed for store "${$}":`,e)}return S.$dispose=()=>{for(let e of v)e()},S}export{l as createStore};

package/package.json

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