stunk 2.7.1 → 2.8.0

package/dist/{core-C7jFiHdO.d.ts → core-DMY69lzg.d.cts}

@@ -1,5 +1,5 @@
 type Subscriber<T> = (newValue: T) => void;
-type Middleware<T> = (value: T, next: (newValue: T) => void) => void;
+type Middleware<T> = (value: T) => T | undefined;
 interface Chunk<T> {
     /** Get the current value of the chunk. */
     get: () => T;

package/dist/core-DMY69lzg.d.ts

@@ -0,0 +1,18 @@
+type Subscriber<T> = (newValue: T) => void;
+type Middleware<T> = (value: T) => T | undefined;
+interface Chunk<T> {
+    /** Get the current value of the chunk. */
+    get: () => T;
+    /** Set a new value for the chunk & Update existing value efficiently. */
+    set: (newValueOrUpdater: T | ((currentValue: T) => T)) => void;
+    /** Subscribe to changes in the chunk. Returns an unsubscribe function. */
+    subscribe: (callback: Subscriber<T>) => () => void;
+    /** Create a derived chunk based on this chunk's value. */
+    derive: <D>(fn: (value: T) => D) => Chunk<D>;
+    /** Reset the chunk to its initial value. */
+    reset: () => void;
+    /** Destroy the chunk and all its subscribers. */
+    destroy: () => void;
+}
+
+export type { Chunk as C, Middleware as M };

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var Y=Object.defineProperty;var Z=(e,a)=>{for(var r in a)Y(e,r,{get:a[r],enumerable:true});};function _(e){return e!==null}function ee(e){if(!e||typeof e!="object")return  false;let a=e;return ["get","set","subscribe","derive","reset","destroy"].every(t=>typeof a[t]=="function")}function te(e){let a=false,r;return ()=>(a||(r=e(),a=true),r)}function re(e){let a=Object.keys(e).reduce((n,u)=>(n[u]=null,n),{}),r={loading:Object.keys(e).length>0,error:null,errors:{},data:a},t=k(r);return Object.entries(e).forEach(([n,u])=>{u.subscribe(o=>{let c=t.get(),l=false,s=null,d={};Object.entries(e).forEach(([h,x])=>{let p=x.get();p.loading&&(l=true),p.error&&(s||(s=p.error),d[h]=p.error);}),t.set({loading:l,error:s,errors:d,data:{...c.data,[n]:o.data}});});}),t}function N(e,a){if(e===null)throw new Error("Value cannot be null.");let r=e,t=0;for(;t<a.length;){let n=a[t],u=typeof n=="function"?n:n.fn,o=typeof n=="function"?`index ${t}`:n.name||`index ${t}`,c=false,l=null;try{u(r,s=>{c=!0,l=s;});}catch(s){let d=s instanceof Error?s.message:String(s);throw new Error(`Middleware "${o}" threw an error: ${d}`)}if(!c)break;if(l===null)throw new Error(`Middleware at index ${t} returned null value.`);r=l,t++;}return r}function M(e,a){if(e===a)return  true;if(!e||!a||typeof e!=typeof a)return  false;if(Array.isArray(e)&&Array.isArray(a)){if(e.length!==a.length)return  false;for(let r=0;r<e.length;r++)if(e[r]!==a[r])return  false;return  true}if(typeof e=="object"&&typeof a=="object"){let r=Object.keys(e),t=Object.keys(a);if(r.length!==t.length)return  false;for(let n of r)if(!Object.prototype.hasOwnProperty.call(a,n)||e[n]!==a[n])return  false;return  true}return  false}function D(e,a,r=""){if(typeof e=="object"&&e!==null&&typeof a=="object"&&a!==null){if(Array.isArray(e)&&Array.isArray(a)){if(e.length>0&&typeof e[0]=="object")for(let t=0;t<a.length;t++)D(e[0],a[t],`${r}[${t}]`);}else if(!Array.isArray(e)&&!Array.isArray(a)){let t=Object.keys(e),n=Object.keys(a),u=n.filter(o=>!t.includes(o));u.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${r||"root"}': ${u.join(", ")}. This might cause bugs.`),console.error("Expected keys:",t),console.error("Received keys:",n));for(let o of t)D(e[o],a[o],r?`${r}.${o}`:o);}}}var V=false,R=new Set,O=new Map,ne=0;function ae(e){let a=V;V=true;try{e();}finally{if(!a){V=false;let r=Array.from(R);R.clear(),r.forEach(t=>{let n=O.get(t);n&&n.notify();});}}}function k(e,a=[]){if(e===null)throw new Error("Initial value cannot be null.");let r=e,t=new Set,n=ne++,u=()=>{t.forEach(p=>p(r));};O.set(n,{notify:u});let o=()=>{t.size!==0&&(V?R.add(n):u());},c=()=>r,l=p=>{let y;typeof p=="function"?y=p(r):y=p,D(r,y);let b=N(y,a);b!==r&&(r=b,o());},s=p=>{if(typeof p!="function")throw new Error("Callback must be a function.");return t.add(p),p(r),()=>t.delete(p)};return {get:c,set:l,subscribe:s,derive:p=>{if(typeof p!="function")throw new Error("Derive function must be a function.");let y=p(r),b=k(y),f=s(()=>{let E=p(r);b.set(E);}),g=b.destroy;return b.destroy=()=>{f(),g();},b},reset:()=>{r=e,o();},destroy:()=>{t.clear(),r=e,R.delete(n),O.delete(n);}}}function z(e,a={}){let{initialData:r=null,onError:t,retryCount:n=0,retryDelay:u=1e3,refresh:o={},pagination:c,enabled:l=true}=a,{staleTime:s=0,cacheTime:d=300*1e3,refetchInterval:h}=o,x=!!c,p=c?.mode||"replace",y=e.length>0,b={loading:l&&!y,error:null,data:r,lastFetched:void 0,pagination:x?{page:c.initialPage||1,pageSize:c.pageSize||10}:void 0},f=k(b),g={},E=null,v=null,L=()=>{let i=f.get();return !i.lastFetched||s===0?true:Date.now()-i.lastFetched>s},G=()=>{f.set({...f.get(),data:r,lastFetched:void 0});},Q=()=>{v&&clearTimeout(v),d>0&&(v=setTimeout(G,d));},m=async(i,T=n,A=false)=>{if(!l||(i!==void 0&&(g={...g,...i}),!A&&!L()&&f.get().data!==null))return;let C=f.get();f.set({...C,loading:true,error:null});try{let S={...g};x&&C.pagination&&(S.page=C.pagination.page,S.pageSize=C.pagination.pageSize);let P=y?await e(S):await e(),w,H,$;if(P&&typeof P=="object"&&"data"in P){let j=P;w=j.data,H=j.total,$=j.hasMore;}else w=P;x&&p==="accumulate"&&C.data&&Array.isArray(C.data)&&Array.isArray(w)&&(w=[...C.data,...w]);let X=Date.now();f.set({loading:!1,error:null,data:w,lastFetched:X,pagination:x?{...C.pagination,total:H,hasMore:$}:void 0}),Q();}catch(S){if(T>0)return await new Promise(w=>setTimeout(w,u)),m(i,T-1,A);let P=f.get();f.set({loading:false,error:S,data:P.data,lastFetched:P.lastFetched,pagination:P.pagination}),t&&t(S);}};h&&h>0&&l&&(E=setInterval(()=>{l&&m(void 0,0,false);},h)),l&&!y&&m();let F=()=>{E&&(clearInterval(E),E=null),v&&(clearTimeout(v),v=null);},I={...f,reload:async i=>{await m(i,n,true);},refresh:async i=>{await m(i,n,false);},mutate:i=>{let T=f.get(),A=i(T.data);f.set({...T,data:A});},reset:()=>{F(),g={},f.set({...b,loading:l&&!y}),l&&!y&&(m(),h&&h>0&&(E=setInterval(()=>{l&&m(void 0,0,false);},h)));},cleanup:F,setParams:i=>{g={...g,...i},l&&m(i,n,true);}};return x?{...I,nextPage:async()=>{let i=f.get();i.pagination&&i.pagination.hasMore!==false&&(f.set({...i,pagination:{...i.pagination,page:i.pagination.page+1}}),await m(g,n,true));},prevPage:async()=>{let i=f.get();!i.pagination||i.pagination.page<=1||(f.set({...i,pagination:{...i.pagination,page:i.pagination.page-1}}),await m(g,n,true));},goToPage:async i=>{let T=f.get();!T.pagination||i<1||(f.set({...T,pagination:{...T.pagination,page:i}}),await m(g,n,true));},resetPagination:async()=>{let i=f.get();if(!i.pagination)return;let T=c?.initialPage||1;f.set({...i,data:p==="accumulate"?r:i.data,pagination:{...i.pagination,page:T}}),await m(g,n,true);}}:I}function oe(e,a={}){let{pageSize:r=10,staleTime:t,cacheTime:n,retryCount:u,retryDelay:o,onError:c}=a;return z(e,{pagination:{pageSize:r,mode:"accumulate",initialPage:1},refresh:{staleTime:t,cacheTime:n},retryCount:u,retryDelay:o,onError:c})}function se(e,a){let r=e.map(s=>s.get()),t=a(...r),n=k(t),u=n.set,o=false,c=()=>{let s=false;for(let d=0;d<e.length;d++){let h=e[d].get();h!==r[d]&&(r[d]=h,s=true);}if(s){let d=a(...r);d!==t&&(typeof d!="object"||typeof t!="object"||!M(d,t))&&(t=d,u(d)),o=false;}},l=e.map(s=>s.subscribe(()=>{o=true,c();}));return {...n,get:()=>(o&&c(),t),recompute:c,isDirty:()=>o,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(s=>{typeof s.reset=="function"&&s.reset();}),o=true,c(),t),destroy:()=>{l.forEach(s=>s()),n.destroy?.();}}}function q(e,a,r={}){let{useShallowEqual:t=false}=r,n=e.get(),u=a(n),o=k(u),c=()=>{let s=e.get(),d=a(s);n=s,(t?!M(d,u):d!==u)&&(u=d,o.set(d));},l=e.subscribe(c);return {get:()=>o.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:o.subscribe,derive:s=>q(o,s,r),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),o.destroy();}}}var U={};Z(U,{logger:()=>K,nonNegativeValidator:()=>W,withHistory:()=>B,withPersistence:()=>J});var K=(e,a)=>{console.log("Setting value:",e),a(e);};var W=(e,a)=>{if(e<0)throw new Error("Value must be non-negative!");a(e);};function B(e,a={}){let{maxHistory:r=100}=a,t=[e.get()],n=0,u=false,o={...e,set:c=>{if(u){e.set(c);return}let l;if(typeof c=="function"){let s=e.get();l=c(s);}else l=c;if(t.splice(n+1),t.push(l),t.length>r){console.warn("History limit reached. Removing oldest entries.");let s=t.length-r;t.splice(0,s),n=Math.max(0,n-s);}n=t.length-1,e.set(l);},undo:()=>{o.canUndo()&&(u=true,n--,o.set(t[n]),u=false);},redo:()=>{o.canRedo()&&(u=true,n++,o.set(t[n]),u=false);},canUndo:()=>n>0,canRedo:()=>n<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let c=e.get();t.length=0,t.push(c),n=0;},destroy:()=>{t.length=0,e.destroy();}};return o}function J(e,a){let{key:r,storage:t=localStorage,serialize:n=JSON.stringify,deserialize:u=JSON.parse}=a;try{let o=t.getItem(r);if(o){let c=u(o);e.set(c);}}catch(o){console.error("Failed to load persisted state:",o);}return e.subscribe(o=>{try{let c=n(o);t.setItem(r,c);}catch(c){console.log("Failed to persist chunk",c);}}),e}exports.asyncChunk=z;exports.batch=ae;exports.chunk=k;exports.combineAsyncChunks=re;exports.computed=se;exports.infiniteAsyncChunk=oe;exports.isChunk=ee;exports.isValidChunkValue=_;exports.middleware=U;exports.once=te;exports.select=q;
+'use strict';var Y=Object.defineProperty;var Z=(e,o)=>{for(var r in o)Y(e,r,{get:o[r],enumerable:true});};function _(e){return e!==null}function ee(e){if(!e||typeof e!="object")return  false;let o=e;return ["get","set","subscribe","derive","reset","destroy"].every(t=>typeof o[t]=="function")}function te(e){let o=false,r;return ()=>(o||(r=e(),o=true),r)}function re(e){let o=Object.keys(e).reduce((n,u)=>(n[u]=null,n),{}),r={loading:Object.keys(e).length>0,error:null,errors:{},data:o},t=k(r);return Object.entries(e).forEach(([n,u])=>{u.subscribe(a=>{let s=t.get(),l=false,c=null,f={};Object.entries(e).forEach(([h,x])=>{let p=x.get();p.loading&&(l=true),p.error&&(c||(c=p.error),f[h]=p.error);}),t.set({loading:l,error:c,errors:f,data:{...s.data,[n]:a.data}});});}),t}function N(e,o){if(e===null)throw new Error("Value cannot be null.");let r=e;for(let t=0;t<o.length;t++){let n=o[t],u=typeof n=="function"?n:n.fn,a=typeof n=="function"?`index ${t}`:n.name||`index ${t}`;try{let s=u(r);if(s===void 0)break;if(s===null)throw new Error(`Middleware "${a}" returned null value.`);r=s;}catch(s){let l=s instanceof Error?s.message:String(s);throw new Error(`Middleware "${a}" threw an error: ${l}`)}}return r}function M(e,o){if(e===o)return  true;if(!e||!o||typeof e!=typeof o)return  false;if(Array.isArray(e)&&Array.isArray(o)){if(e.length!==o.length)return  false;for(let r=0;r<e.length;r++)if(e[r]!==o[r])return  false;return  true}if(typeof e=="object"&&typeof o=="object"){let r=Object.keys(e),t=Object.keys(o);if(r.length!==t.length)return  false;for(let n of r)if(!Object.prototype.hasOwnProperty.call(o,n)||e[n]!==o[n])return  false;return  true}return  false}function D(e,o,r=""){if(typeof e=="object"&&e!==null&&typeof o=="object"&&o!==null){if(Array.isArray(e)&&Array.isArray(o)){if(e.length>0&&typeof e[0]=="object")for(let t=0;t<o.length;t++)D(e[0],o[t],`${r}[${t}]`);}else if(!Array.isArray(e)&&!Array.isArray(o)){let t=Object.keys(e),n=Object.keys(o),u=n.filter(a=>!t.includes(a));u.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${r||"root"}': ${u.join(", ")}. This might cause bugs.`),console.error("Expected keys:",t),console.error("Received keys:",n));for(let a of t)D(e[a],o[a],r?`${r}.${a}`:a);}}}var V=false,R=new Set,O=new Map,ne=0;function oe(e){let o=V;V=true;try{e();}finally{if(!o){V=false;let r=Array.from(R);R.clear(),r.forEach(t=>{let n=O.get(t);n&&n.notify();});}}}function k(e,o=[]){if(e===null)throw new Error("Initial value cannot be null.");let r=e,t=new Set,n=ne++,u=()=>{t.forEach(p=>p(r));};O.set(n,{notify:u});let a=()=>{t.size!==0&&(V?R.add(n):u());},s=()=>r,l=p=>{let y;typeof p=="function"?y=p(r):y=p,D(r,y);let b=N(y,o);b!==r&&(r=b,a());},c=p=>{if(typeof p!="function")throw new Error("Callback must be a function.");return t.add(p),p(r),()=>t.delete(p)};return {get:s,set:l,subscribe:c,derive:p=>{if(typeof p!="function")throw new Error("Derive function must be a function.");let y=p(r),b=k(y),d=c(()=>{let w=p(r);b.set(w);}),g=b.destroy;return b.destroy=()=>{d(),g();},b},reset:()=>{r=e,a();},destroy:()=>{t.clear(),r=e,R.delete(n),O.delete(n);}}}function z(e,o={}){let{initialData:r=null,onError:t,retryCount:n=0,retryDelay:u=1e3,refresh:a={},pagination:s,enabled:l=true}=o,{staleTime:c=0,cacheTime:f=300*1e3,refetchInterval:h}=a,x=!!s,p=s?.mode||"replace",y=e.length>0,b={loading:l&&!y,error:null,data:r,lastFetched:void 0,pagination:x?{page:s.initialPage||1,pageSize:s.pageSize||10}:void 0},d=k(b),g={},w=null,v=null,L=()=>{let i=d.get();return !i.lastFetched||c===0?true:Date.now()-i.lastFetched>c},G=()=>{d.set({...d.get(),data:r,lastFetched:void 0});},Q=()=>{v&&clearTimeout(v),f>0&&(v=setTimeout(G,f));},m=async(i,T=n,A=false)=>{if(!l||(i!==void 0&&(g={...g,...i}),!A&&!L()&&d.get().data!==null))return;let C=d.get();d.set({...C,loading:true,error:null});try{let S={...g};x&&C.pagination&&(S.page=C.pagination.page,S.pageSize=C.pagination.pageSize);let P=y?await e(S):await e(),E,H,$;if(P&&typeof P=="object"&&"data"in P){let j=P;E=j.data,H=j.total,$=j.hasMore;}else E=P;x&&p==="accumulate"&&C.data&&Array.isArray(C.data)&&Array.isArray(E)&&(E=[...C.data,...E]);let X=Date.now();d.set({loading:!1,error:null,data:E,lastFetched:X,pagination:x?{...C.pagination,total:H,hasMore:$}:void 0}),Q();}catch(S){if(T>0)return await new Promise(E=>setTimeout(E,u)),m(i,T-1,A);let P=d.get();d.set({loading:false,error:S,data:P.data,lastFetched:P.lastFetched,pagination:P.pagination}),t&&t(S);}};h&&h>0&&l&&(w=setInterval(()=>{l&&m(void 0,0,false);},h)),l&&!y&&m();let F=()=>{w&&(clearInterval(w),w=null),v&&(clearTimeout(v),v=null);},I={...d,reload:async i=>{await m(i,n,true);},refresh:async i=>{await m(i,n,false);},mutate:i=>{let T=d.get(),A=i(T.data);d.set({...T,data:A});},reset:()=>{F(),g={},d.set({...b,loading:l&&!y}),l&&!y&&(m(),h&&h>0&&(w=setInterval(()=>{l&&m(void 0,0,false);},h)));},cleanup:F,setParams:i=>{g={...g,...i},l&&m(i,n,true);}};return x?{...I,nextPage:async()=>{let i=d.get();i.pagination&&i.pagination.hasMore!==false&&(d.set({...i,pagination:{...i.pagination,page:i.pagination.page+1}}),await m(g,n,true));},prevPage:async()=>{let i=d.get();!i.pagination||i.pagination.page<=1||(d.set({...i,pagination:{...i.pagination,page:i.pagination.page-1}}),await m(g,n,true));},goToPage:async i=>{let T=d.get();!T.pagination||i<1||(d.set({...T,pagination:{...T.pagination,page:i}}),await m(g,n,true));},resetPagination:async()=>{let i=d.get();if(!i.pagination)return;let T=s?.initialPage||1;d.set({...i,data:p==="accumulate"?r:i.data,pagination:{...i.pagination,page:T}}),await m(g,n,true);}}:I}function ae(e,o={}){let{pageSize:r=10,staleTime:t,cacheTime:n,retryCount:u,retryDelay:a,onError:s}=o;return z(e,{pagination:{pageSize:r,mode:"accumulate",initialPage:1},refresh:{staleTime:t,cacheTime:n},retryCount:u,retryDelay:a,onError:s})}function se(e,o){let r=e.map(c=>c.get()),t=o(...r),n=k(t),u=n.set,a=false,s=()=>{let c=false;for(let f=0;f<e.length;f++){let h=e[f].get();h!==r[f]&&(r[f]=h,c=true);}if(c){let f=o(...r);f!==t&&(typeof f!="object"||typeof t!="object"||!M(f,t))&&(t=f,u(f)),a=false;}},l=e.map(c=>c.subscribe(()=>{a=true,s();}));return {...n,get:()=>(a&&s(),t),recompute:s,isDirty:()=>a,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(c=>{typeof c.reset=="function"&&c.reset();}),a=true,s(),t),destroy:()=>{l.forEach(c=>c()),n.destroy?.();}}}function q(e,o,r={}){let{useShallowEqual:t=false}=r,n=e.get(),u=o(n),a=k(u),s=()=>{let c=e.get(),f=o(c);n=c,(t?!M(f,u):f!==u)&&(u=f,a.set(f));},l=e.subscribe(s);return {get:()=>a.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:a.subscribe,derive:c=>q(a,c,r),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),a.destroy();}}}var U={};Z(U,{logger:()=>K,nonNegativeValidator:()=>W,withHistory:()=>B,withPersistence:()=>J});var K=e=>(console.log("Setting value:",e),e);var W=e=>{if(e<0)throw new Error("Value must be non-negative!");return e};function B(e,o={}){let{maxHistory:r=100}=o,t=[e.get()],n=0,u=false,a={...e,set:s=>{if(u){e.set(s);return}let l;if(typeof s=="function"){let c=e.get();l=s(c);}else l=s;if(t.splice(n+1),t.push(l),t.length>r){console.warn("History limit reached. Removing oldest entries.");let c=t.length-r;t.splice(0,c),n=Math.max(0,n-c);}n=t.length-1,e.set(l);},undo:()=>{a.canUndo()&&(u=true,n--,a.set(t[n]),u=false);},redo:()=>{a.canRedo()&&(u=true,n++,a.set(t[n]),u=false);},canUndo:()=>n>0,canRedo:()=>n<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let s=e.get();t.length=0,t.push(s),n=0;},destroy:()=>{t.length=0,e.destroy();}};return a}function J(e,o){let{key:r,storage:t=localStorage,serialize:n=JSON.stringify,deserialize:u=JSON.parse}=o;try{let a=t.getItem(r);if(a){let s=u(a);e.set(s);}}catch(a){console.error("Failed to load persisted state:",a);}return e.subscribe(a=>{try{let s=n(a);t.setItem(r,s);}catch(s){console.log("Failed to persist chunk",s);}}),e}exports.asyncChunk=z;exports.batch=oe;exports.chunk=k;exports.combineAsyncChunks=re;exports.computed=se;exports.infiniteAsyncChunk=ae;exports.isChunk=ee;exports.isValidChunkValue=_;exports.middleware=U;exports.once=te;exports.select=q;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 type Subscriber<T> = (newValue: T) => void;
-type Middleware<T> = (value: T, next: (newValue: T) => void) => void;
+type Middleware<T> = (value: T) => T | undefined;
 type NamedMiddleware<T> = {
     name?: string;
     fn: Middleware<T>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type Subscriber<T> = (newValue: T) => void;
-type Middleware<T> = (value: T, next: (newValue: T) => void) => void;
+type Middleware<T> = (value: T) => T | undefined;
 type NamedMiddleware<T> = {
     name?: string;
     fn: Middleware<T>;

package/dist/index.js

@@ -1 +1 @@
-var Y=Object.defineProperty;var Z=(e,a)=>{for(var r in a)Y(e,r,{get:a[r],enumerable:true});};function _(e){return e!==null}function ee(e){if(!e||typeof e!="object")return  false;let a=e;return ["get","set","subscribe","derive","reset","destroy"].every(t=>typeof a[t]=="function")}function te(e){let a=false,r;return ()=>(a||(r=e(),a=true),r)}function re(e){let a=Object.keys(e).reduce((n,u)=>(n[u]=null,n),{}),r={loading:Object.keys(e).length>0,error:null,errors:{},data:a},t=k(r);return Object.entries(e).forEach(([n,u])=>{u.subscribe(o=>{let c=t.get(),l=false,s=null,d={};Object.entries(e).forEach(([h,x])=>{let p=x.get();p.loading&&(l=true),p.error&&(s||(s=p.error),d[h]=p.error);}),t.set({loading:l,error:s,errors:d,data:{...c.data,[n]:o.data}});});}),t}function N(e,a){if(e===null)throw new Error("Value cannot be null.");let r=e,t=0;for(;t<a.length;){let n=a[t],u=typeof n=="function"?n:n.fn,o=typeof n=="function"?`index ${t}`:n.name||`index ${t}`,c=false,l=null;try{u(r,s=>{c=!0,l=s;});}catch(s){let d=s instanceof Error?s.message:String(s);throw new Error(`Middleware "${o}" threw an error: ${d}`)}if(!c)break;if(l===null)throw new Error(`Middleware at index ${t} returned null value.`);r=l,t++;}return r}function M(e,a){if(e===a)return  true;if(!e||!a||typeof e!=typeof a)return  false;if(Array.isArray(e)&&Array.isArray(a)){if(e.length!==a.length)return  false;for(let r=0;r<e.length;r++)if(e[r]!==a[r])return  false;return  true}if(typeof e=="object"&&typeof a=="object"){let r=Object.keys(e),t=Object.keys(a);if(r.length!==t.length)return  false;for(let n of r)if(!Object.prototype.hasOwnProperty.call(a,n)||e[n]!==a[n])return  false;return  true}return  false}function D(e,a,r=""){if(typeof e=="object"&&e!==null&&typeof a=="object"&&a!==null){if(Array.isArray(e)&&Array.isArray(a)){if(e.length>0&&typeof e[0]=="object")for(let t=0;t<a.length;t++)D(e[0],a[t],`${r}[${t}]`);}else if(!Array.isArray(e)&&!Array.isArray(a)){let t=Object.keys(e),n=Object.keys(a),u=n.filter(o=>!t.includes(o));u.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${r||"root"}': ${u.join(", ")}. This might cause bugs.`),console.error("Expected keys:",t),console.error("Received keys:",n));for(let o of t)D(e[o],a[o],r?`${r}.${o}`:o);}}}var V=false,R=new Set,O=new Map,ne=0;function ae(e){let a=V;V=true;try{e();}finally{if(!a){V=false;let r=Array.from(R);R.clear(),r.forEach(t=>{let n=O.get(t);n&&n.notify();});}}}function k(e,a=[]){if(e===null)throw new Error("Initial value cannot be null.");let r=e,t=new Set,n=ne++,u=()=>{t.forEach(p=>p(r));};O.set(n,{notify:u});let o=()=>{t.size!==0&&(V?R.add(n):u());},c=()=>r,l=p=>{let y;typeof p=="function"?y=p(r):y=p,D(r,y);let b=N(y,a);b!==r&&(r=b,o());},s=p=>{if(typeof p!="function")throw new Error("Callback must be a function.");return t.add(p),p(r),()=>t.delete(p)};return {get:c,set:l,subscribe:s,derive:p=>{if(typeof p!="function")throw new Error("Derive function must be a function.");let y=p(r),b=k(y),f=s(()=>{let E=p(r);b.set(E);}),g=b.destroy;return b.destroy=()=>{f(),g();},b},reset:()=>{r=e,o();},destroy:()=>{t.clear(),r=e,R.delete(n),O.delete(n);}}}function z(e,a={}){let{initialData:r=null,onError:t,retryCount:n=0,retryDelay:u=1e3,refresh:o={},pagination:c,enabled:l=true}=a,{staleTime:s=0,cacheTime:d=300*1e3,refetchInterval:h}=o,x=!!c,p=c?.mode||"replace",y=e.length>0,b={loading:l&&!y,error:null,data:r,lastFetched:void 0,pagination:x?{page:c.initialPage||1,pageSize:c.pageSize||10}:void 0},f=k(b),g={},E=null,v=null,L=()=>{let i=f.get();return !i.lastFetched||s===0?true:Date.now()-i.lastFetched>s},G=()=>{f.set({...f.get(),data:r,lastFetched:void 0});},Q=()=>{v&&clearTimeout(v),d>0&&(v=setTimeout(G,d));},m=async(i,T=n,A=false)=>{if(!l||(i!==void 0&&(g={...g,...i}),!A&&!L()&&f.get().data!==null))return;let C=f.get();f.set({...C,loading:true,error:null});try{let S={...g};x&&C.pagination&&(S.page=C.pagination.page,S.pageSize=C.pagination.pageSize);let P=y?await e(S):await e(),w,H,$;if(P&&typeof P=="object"&&"data"in P){let j=P;w=j.data,H=j.total,$=j.hasMore;}else w=P;x&&p==="accumulate"&&C.data&&Array.isArray(C.data)&&Array.isArray(w)&&(w=[...C.data,...w]);let X=Date.now();f.set({loading:!1,error:null,data:w,lastFetched:X,pagination:x?{...C.pagination,total:H,hasMore:$}:void 0}),Q();}catch(S){if(T>0)return await new Promise(w=>setTimeout(w,u)),m(i,T-1,A);let P=f.get();f.set({loading:false,error:S,data:P.data,lastFetched:P.lastFetched,pagination:P.pagination}),t&&t(S);}};h&&h>0&&l&&(E=setInterval(()=>{l&&m(void 0,0,false);},h)),l&&!y&&m();let F=()=>{E&&(clearInterval(E),E=null),v&&(clearTimeout(v),v=null);},I={...f,reload:async i=>{await m(i,n,true);},refresh:async i=>{await m(i,n,false);},mutate:i=>{let T=f.get(),A=i(T.data);f.set({...T,data:A});},reset:()=>{F(),g={},f.set({...b,loading:l&&!y}),l&&!y&&(m(),h&&h>0&&(E=setInterval(()=>{l&&m(void 0,0,false);},h)));},cleanup:F,setParams:i=>{g={...g,...i},l&&m(i,n,true);}};return x?{...I,nextPage:async()=>{let i=f.get();i.pagination&&i.pagination.hasMore!==false&&(f.set({...i,pagination:{...i.pagination,page:i.pagination.page+1}}),await m(g,n,true));},prevPage:async()=>{let i=f.get();!i.pagination||i.pagination.page<=1||(f.set({...i,pagination:{...i.pagination,page:i.pagination.page-1}}),await m(g,n,true));},goToPage:async i=>{let T=f.get();!T.pagination||i<1||(f.set({...T,pagination:{...T.pagination,page:i}}),await m(g,n,true));},resetPagination:async()=>{let i=f.get();if(!i.pagination)return;let T=c?.initialPage||1;f.set({...i,data:p==="accumulate"?r:i.data,pagination:{...i.pagination,page:T}}),await m(g,n,true);}}:I}function oe(e,a={}){let{pageSize:r=10,staleTime:t,cacheTime:n,retryCount:u,retryDelay:o,onError:c}=a;return z(e,{pagination:{pageSize:r,mode:"accumulate",initialPage:1},refresh:{staleTime:t,cacheTime:n},retryCount:u,retryDelay:o,onError:c})}function se(e,a){let r=e.map(s=>s.get()),t=a(...r),n=k(t),u=n.set,o=false,c=()=>{let s=false;for(let d=0;d<e.length;d++){let h=e[d].get();h!==r[d]&&(r[d]=h,s=true);}if(s){let d=a(...r);d!==t&&(typeof d!="object"||typeof t!="object"||!M(d,t))&&(t=d,u(d)),o=false;}},l=e.map(s=>s.subscribe(()=>{o=true,c();}));return {...n,get:()=>(o&&c(),t),recompute:c,isDirty:()=>o,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(s=>{typeof s.reset=="function"&&s.reset();}),o=true,c(),t),destroy:()=>{l.forEach(s=>s()),n.destroy?.();}}}function q(e,a,r={}){let{useShallowEqual:t=false}=r,n=e.get(),u=a(n),o=k(u),c=()=>{let s=e.get(),d=a(s);n=s,(t?!M(d,u):d!==u)&&(u=d,o.set(d));},l=e.subscribe(c);return {get:()=>o.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:o.subscribe,derive:s=>q(o,s,r),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),o.destroy();}}}var U={};Z(U,{logger:()=>K,nonNegativeValidator:()=>W,withHistory:()=>B,withPersistence:()=>J});var K=(e,a)=>{console.log("Setting value:",e),a(e);};var W=(e,a)=>{if(e<0)throw new Error("Value must be non-negative!");a(e);};function B(e,a={}){let{maxHistory:r=100}=a,t=[e.get()],n=0,u=false,o={...e,set:c=>{if(u){e.set(c);return}let l;if(typeof c=="function"){let s=e.get();l=c(s);}else l=c;if(t.splice(n+1),t.push(l),t.length>r){console.warn("History limit reached. Removing oldest entries.");let s=t.length-r;t.splice(0,s),n=Math.max(0,n-s);}n=t.length-1,e.set(l);},undo:()=>{o.canUndo()&&(u=true,n--,o.set(t[n]),u=false);},redo:()=>{o.canRedo()&&(u=true,n++,o.set(t[n]),u=false);},canUndo:()=>n>0,canRedo:()=>n<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let c=e.get();t.length=0,t.push(c),n=0;},destroy:()=>{t.length=0,e.destroy();}};return o}function J(e,a){let{key:r,storage:t=localStorage,serialize:n=JSON.stringify,deserialize:u=JSON.parse}=a;try{let o=t.getItem(r);if(o){let c=u(o);e.set(c);}}catch(o){console.error("Failed to load persisted state:",o);}return e.subscribe(o=>{try{let c=n(o);t.setItem(r,c);}catch(c){console.log("Failed to persist chunk",c);}}),e}export{z as asyncChunk,ae as batch,k as chunk,re as combineAsyncChunks,se as computed,oe as infiniteAsyncChunk,ee as isChunk,_ as isValidChunkValue,U as middleware,te as once,q as select};
+var Y=Object.defineProperty;var Z=(e,o)=>{for(var r in o)Y(e,r,{get:o[r],enumerable:true});};function _(e){return e!==null}function ee(e){if(!e||typeof e!="object")return  false;let o=e;return ["get","set","subscribe","derive","reset","destroy"].every(t=>typeof o[t]=="function")}function te(e){let o=false,r;return ()=>(o||(r=e(),o=true),r)}function re(e){let o=Object.keys(e).reduce((n,u)=>(n[u]=null,n),{}),r={loading:Object.keys(e).length>0,error:null,errors:{},data:o},t=k(r);return Object.entries(e).forEach(([n,u])=>{u.subscribe(a=>{let s=t.get(),l=false,c=null,f={};Object.entries(e).forEach(([h,x])=>{let p=x.get();p.loading&&(l=true),p.error&&(c||(c=p.error),f[h]=p.error);}),t.set({loading:l,error:c,errors:f,data:{...s.data,[n]:a.data}});});}),t}function N(e,o){if(e===null)throw new Error("Value cannot be null.");let r=e;for(let t=0;t<o.length;t++){let n=o[t],u=typeof n=="function"?n:n.fn,a=typeof n=="function"?`index ${t}`:n.name||`index ${t}`;try{let s=u(r);if(s===void 0)break;if(s===null)throw new Error(`Middleware "${a}" returned null value.`);r=s;}catch(s){let l=s instanceof Error?s.message:String(s);throw new Error(`Middleware "${a}" threw an error: ${l}`)}}return r}function M(e,o){if(e===o)return  true;if(!e||!o||typeof e!=typeof o)return  false;if(Array.isArray(e)&&Array.isArray(o)){if(e.length!==o.length)return  false;for(let r=0;r<e.length;r++)if(e[r]!==o[r])return  false;return  true}if(typeof e=="object"&&typeof o=="object"){let r=Object.keys(e),t=Object.keys(o);if(r.length!==t.length)return  false;for(let n of r)if(!Object.prototype.hasOwnProperty.call(o,n)||e[n]!==o[n])return  false;return  true}return  false}function D(e,o,r=""){if(typeof e=="object"&&e!==null&&typeof o=="object"&&o!==null){if(Array.isArray(e)&&Array.isArray(o)){if(e.length>0&&typeof e[0]=="object")for(let t=0;t<o.length;t++)D(e[0],o[t],`${r}[${t}]`);}else if(!Array.isArray(e)&&!Array.isArray(o)){let t=Object.keys(e),n=Object.keys(o),u=n.filter(a=>!t.includes(a));u.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${r||"root"}': ${u.join(", ")}. This might cause bugs.`),console.error("Expected keys:",t),console.error("Received keys:",n));for(let a of t)D(e[a],o[a],r?`${r}.${a}`:a);}}}var V=false,R=new Set,O=new Map,ne=0;function oe(e){let o=V;V=true;try{e();}finally{if(!o){V=false;let r=Array.from(R);R.clear(),r.forEach(t=>{let n=O.get(t);n&&n.notify();});}}}function k(e,o=[]){if(e===null)throw new Error("Initial value cannot be null.");let r=e,t=new Set,n=ne++,u=()=>{t.forEach(p=>p(r));};O.set(n,{notify:u});let a=()=>{t.size!==0&&(V?R.add(n):u());},s=()=>r,l=p=>{let y;typeof p=="function"?y=p(r):y=p,D(r,y);let b=N(y,o);b!==r&&(r=b,a());},c=p=>{if(typeof p!="function")throw new Error("Callback must be a function.");return t.add(p),p(r),()=>t.delete(p)};return {get:s,set:l,subscribe:c,derive:p=>{if(typeof p!="function")throw new Error("Derive function must be a function.");let y=p(r),b=k(y),d=c(()=>{let w=p(r);b.set(w);}),g=b.destroy;return b.destroy=()=>{d(),g();},b},reset:()=>{r=e,a();},destroy:()=>{t.clear(),r=e,R.delete(n),O.delete(n);}}}function z(e,o={}){let{initialData:r=null,onError:t,retryCount:n=0,retryDelay:u=1e3,refresh:a={},pagination:s,enabled:l=true}=o,{staleTime:c=0,cacheTime:f=300*1e3,refetchInterval:h}=a,x=!!s,p=s?.mode||"replace",y=e.length>0,b={loading:l&&!y,error:null,data:r,lastFetched:void 0,pagination:x?{page:s.initialPage||1,pageSize:s.pageSize||10}:void 0},d=k(b),g={},w=null,v=null,L=()=>{let i=d.get();return !i.lastFetched||c===0?true:Date.now()-i.lastFetched>c},G=()=>{d.set({...d.get(),data:r,lastFetched:void 0});},Q=()=>{v&&clearTimeout(v),f>0&&(v=setTimeout(G,f));},m=async(i,T=n,A=false)=>{if(!l||(i!==void 0&&(g={...g,...i}),!A&&!L()&&d.get().data!==null))return;let C=d.get();d.set({...C,loading:true,error:null});try{let S={...g};x&&C.pagination&&(S.page=C.pagination.page,S.pageSize=C.pagination.pageSize);let P=y?await e(S):await e(),E,H,$;if(P&&typeof P=="object"&&"data"in P){let j=P;E=j.data,H=j.total,$=j.hasMore;}else E=P;x&&p==="accumulate"&&C.data&&Array.isArray(C.data)&&Array.isArray(E)&&(E=[...C.data,...E]);let X=Date.now();d.set({loading:!1,error:null,data:E,lastFetched:X,pagination:x?{...C.pagination,total:H,hasMore:$}:void 0}),Q();}catch(S){if(T>0)return await new Promise(E=>setTimeout(E,u)),m(i,T-1,A);let P=d.get();d.set({loading:false,error:S,data:P.data,lastFetched:P.lastFetched,pagination:P.pagination}),t&&t(S);}};h&&h>0&&l&&(w=setInterval(()=>{l&&m(void 0,0,false);},h)),l&&!y&&m();let F=()=>{w&&(clearInterval(w),w=null),v&&(clearTimeout(v),v=null);},I={...d,reload:async i=>{await m(i,n,true);},refresh:async i=>{await m(i,n,false);},mutate:i=>{let T=d.get(),A=i(T.data);d.set({...T,data:A});},reset:()=>{F(),g={},d.set({...b,loading:l&&!y}),l&&!y&&(m(),h&&h>0&&(w=setInterval(()=>{l&&m(void 0,0,false);},h)));},cleanup:F,setParams:i=>{g={...g,...i},l&&m(i,n,true);}};return x?{...I,nextPage:async()=>{let i=d.get();i.pagination&&i.pagination.hasMore!==false&&(d.set({...i,pagination:{...i.pagination,page:i.pagination.page+1}}),await m(g,n,true));},prevPage:async()=>{let i=d.get();!i.pagination||i.pagination.page<=1||(d.set({...i,pagination:{...i.pagination,page:i.pagination.page-1}}),await m(g,n,true));},goToPage:async i=>{let T=d.get();!T.pagination||i<1||(d.set({...T,pagination:{...T.pagination,page:i}}),await m(g,n,true));},resetPagination:async()=>{let i=d.get();if(!i.pagination)return;let T=s?.initialPage||1;d.set({...i,data:p==="accumulate"?r:i.data,pagination:{...i.pagination,page:T}}),await m(g,n,true);}}:I}function ae(e,o={}){let{pageSize:r=10,staleTime:t,cacheTime:n,retryCount:u,retryDelay:a,onError:s}=o;return z(e,{pagination:{pageSize:r,mode:"accumulate",initialPage:1},refresh:{staleTime:t,cacheTime:n},retryCount:u,retryDelay:a,onError:s})}function se(e,o){let r=e.map(c=>c.get()),t=o(...r),n=k(t),u=n.set,a=false,s=()=>{let c=false;for(let f=0;f<e.length;f++){let h=e[f].get();h!==r[f]&&(r[f]=h,c=true);}if(c){let f=o(...r);f!==t&&(typeof f!="object"||typeof t!="object"||!M(f,t))&&(t=f,u(f)),a=false;}},l=e.map(c=>c.subscribe(()=>{a=true,s();}));return {...n,get:()=>(a&&s(),t),recompute:s,isDirty:()=>a,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(c=>{typeof c.reset=="function"&&c.reset();}),a=true,s(),t),destroy:()=>{l.forEach(c=>c()),n.destroy?.();}}}function q(e,o,r={}){let{useShallowEqual:t=false}=r,n=e.get(),u=o(n),a=k(u),s=()=>{let c=e.get(),f=o(c);n=c,(t?!M(f,u):f!==u)&&(u=f,a.set(f));},l=e.subscribe(s);return {get:()=>a.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:a.subscribe,derive:c=>q(a,c,r),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),a.destroy();}}}var U={};Z(U,{logger:()=>K,nonNegativeValidator:()=>W,withHistory:()=>B,withPersistence:()=>J});var K=e=>(console.log("Setting value:",e),e);var W=e=>{if(e<0)throw new Error("Value must be non-negative!");return e};function B(e,o={}){let{maxHistory:r=100}=o,t=[e.get()],n=0,u=false,a={...e,set:s=>{if(u){e.set(s);return}let l;if(typeof s=="function"){let c=e.get();l=s(c);}else l=s;if(t.splice(n+1),t.push(l),t.length>r){console.warn("History limit reached. Removing oldest entries.");let c=t.length-r;t.splice(0,c),n=Math.max(0,n-c);}n=t.length-1,e.set(l);},undo:()=>{a.canUndo()&&(u=true,n--,a.set(t[n]),u=false);},redo:()=>{a.canRedo()&&(u=true,n++,a.set(t[n]),u=false);},canUndo:()=>n>0,canRedo:()=>n<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let s=e.get();t.length=0,t.push(s),n=0;},destroy:()=>{t.length=0,e.destroy();}};return a}function J(e,o){let{key:r,storage:t=localStorage,serialize:n=JSON.stringify,deserialize:u=JSON.parse}=o;try{let a=t.getItem(r);if(a){let s=u(a);e.set(s);}}catch(a){console.error("Failed to load persisted state:",a);}return e.subscribe(a=>{try{let s=n(a);t.setItem(r,s);}catch(s){console.log("Failed to persist chunk",s);}}),e}export{z as asyncChunk,oe as batch,k as chunk,re as combineAsyncChunks,se as computed,ae as infiniteAsyncChunk,ee as isChunk,_ as isValidChunkValue,U as middleware,te as once,q as select};

package/dist/middleware/index.cjs

@@ -0,0 +1 @@
+'use strict';var d=e=>(console.log("Setting value:",e),e);var u=e=>{if(e<0)throw new Error("Value must be non-negative!");return e};function g(e,a={}){let{maxHistory:s=100}=a,t=[e.get()],r=0,n=false,o={...e,set:i=>{if(n){e.set(i);return}let l;if(typeof i=="function"){let c=e.get();l=i(c);}else l=i;if(t.splice(r+1),t.push(l),t.length>s){console.warn("History limit reached. Removing oldest entries.");let c=t.length-s;t.splice(0,c),r=Math.max(0,r-c);}r=t.length-1,e.set(l);},undo:()=>{o.canUndo()&&(n=true,r--,o.set(t[r]),n=false);},redo:()=>{o.canRedo()&&(n=true,r++,o.set(t[r]),n=false);},canUndo:()=>r>0,canRedo:()=>r<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let i=e.get();t.length=0,t.push(i),r=0;},destroy:()=>{t.length=0,e.destroy();}};return o}function h(e,a){let{key:s,storage:t=localStorage,serialize:r=JSON.stringify,deserialize:n=JSON.parse}=a;try{let o=t.getItem(s);if(o){let i=n(o);e.set(i);}}catch(o){console.error("Failed to load persisted state:",o);}return e.subscribe(o=>{try{let i=r(o);t.setItem(s,i);}catch(i){console.log("Failed to persist chunk",i);}}),e}exports.logger=d;exports.nonNegativeValidator=u;exports.withHistory=g;exports.withPersistence=h;

package/dist/middleware/index.d.cts

@@ -0,0 +1,45 @@
+import { M as Middleware, C as Chunk } from '../core-DMY69lzg.cjs';
+
+declare const logger: Middleware<any>;
+
+declare const nonNegativeValidator: Middleware<number>;
+
+interface ChunkWithHistory<T> extends Chunk<T> {
+    /**
+   * Reverts to the previous state (if available).
+   */
+    undo: () => void;
+    /**
+     * Moves to the next state (if available).
+     */
+    redo: () => void;
+    /**
+     * Returns true if there is a previous state to revert to.
+     */
+    canUndo: () => boolean;
+    /**
+     * Returns true if there is a next state to move to.
+     */
+    canRedo: () => boolean;
+    /**
+     * Returns an array of all the values in the history.
+     */
+    getHistory: () => T[];
+    /**
+     * Clears the history, keeping only the current value.
+     */
+    clearHistory: () => void;
+}
+declare function withHistory<T>(baseChunk: Chunk<T>, options?: {
+    maxHistory?: number;
+}): ChunkWithHistory<T>;
+
+interface PersistOptions<T> {
+    key: string;
+    storage?: Storage;
+    serialize?: (value: T) => string;
+    deserialize?: (value: string) => T;
+}
+declare function withPersistence<T>(baseChunk: Chunk<T>, options: PersistOptions<T>): Chunk<T>;
+
+export { logger, nonNegativeValidator, withHistory, withPersistence };

package/dist/middleware/index.d.ts

@@ -1,4 +1,4 @@
-import { M as Middleware, C as Chunk } from '../core-C7jFiHdO.js';
+import { M as Middleware, C as Chunk } from '../core-DMY69lzg.js';
 
 declare const logger: Middleware<any>;
 

package/dist/middleware/index.js

@@ -1 +1 @@
-var d=(e,n)=>{console.log("Setting value:",e),n(e);};var u=(e,n)=>{if(e<0)throw new Error("Value must be non-negative!");n(e);};function g(e,n={}){let{maxHistory:l=100}=n,t=[e.get()],r=0,s=false,o={...e,set:i=>{if(s){e.set(i);return}let c;if(typeof i=="function"){let a=e.get();c=i(a);}else c=i;if(t.splice(r+1),t.push(c),t.length>l){console.warn("History limit reached. Removing oldest entries.");let a=t.length-l;t.splice(0,a),r=Math.max(0,r-a);}r=t.length-1,e.set(c);},undo:()=>{o.canUndo()&&(s=true,r--,o.set(t[r]),s=false);},redo:()=>{o.canRedo()&&(s=true,r++,o.set(t[r]),s=false);},canUndo:()=>r>0,canRedo:()=>r<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let i=e.get();t.length=0,t.push(i),r=0;},destroy:()=>{t.length=0,e.destroy();}};return o}function h(e,n){let{key:l,storage:t=localStorage,serialize:r=JSON.stringify,deserialize:s=JSON.parse}=n;try{let o=t.getItem(l);if(o){let i=s(o);e.set(i);}}catch(o){console.error("Failed to load persisted state:",o);}return e.subscribe(o=>{try{let i=r(o);t.setItem(l,i);}catch(i){console.log("Failed to persist chunk",i);}}),e}export{d as logger,u as nonNegativeValidator,g as withHistory,h as withPersistence};
+var d=e=>(console.log("Setting value:",e),e);var u=e=>{if(e<0)throw new Error("Value must be non-negative!");return e};function g(e,a={}){let{maxHistory:s=100}=a,t=[e.get()],r=0,n=false,o={...e,set:i=>{if(n){e.set(i);return}let l;if(typeof i=="function"){let c=e.get();l=i(c);}else l=i;if(t.splice(r+1),t.push(l),t.length>s){console.warn("History limit reached. Removing oldest entries.");let c=t.length-s;t.splice(0,c),r=Math.max(0,r-c);}r=t.length-1,e.set(l);},undo:()=>{o.canUndo()&&(n=true,r--,o.set(t[r]),n=false);},redo:()=>{o.canRedo()&&(n=true,r++,o.set(t[r]),n=false);},canUndo:()=>r>0,canRedo:()=>r<t.length-1,getHistory:()=>[...t],clearHistory:()=>{let i=e.get();t.length=0,t.push(i),r=0;},destroy:()=>{t.length=0,e.destroy();}};return o}function h(e,a){let{key:s,storage:t=localStorage,serialize:r=JSON.stringify,deserialize:n=JSON.parse}=a;try{let o=t.getItem(s);if(o){let i=n(o);e.set(i);}}catch(o){console.error("Failed to load persisted state:",o);}return e.subscribe(o=>{try{let i=r(o);t.setItem(s,i);}catch(i){console.log("Failed to persist chunk",i);}}),e}export{d as logger,u as nonNegativeValidator,g as withHistory,h as withPersistence};

package/dist/use-react/index.cjs

@@ -0,0 +1 @@
+'use strict';var react=require('react');var S=new Set,D=new Map,j=0;function P(e,r=[]){if(e===null)throw new Error("Initial value cannot be null.");let t=e,n=new Set,s=j++,i=()=>{n.forEach(f=>f(t));};D.set(s,{notify:i});let o=()=>{n.size!==0&&(i());},u=()=>t,l=f=>{let h;typeof f=="function"?h=f(t):h=f,b(t,h);let p=M(h,r);p!==t&&(t=p,o());},a=f=>{if(typeof f!="function")throw new Error("Callback must be a function.");return n.add(f),f(t),()=>n.delete(f)};return {get:u,set:l,subscribe:a,derive:f=>{if(typeof f!="function")throw new Error("Derive function must be a function.");let h=f(t),p=P(h),m=a(()=>{let k=f(t);p.set(k);}),d=p.destroy;return p.destroy=()=>{m(),d();},p},reset:()=>{t=e,o();},destroy:()=>{n.clear(),t=e,S.delete(s),D.delete(s);}}}function M(e,r){if(e===null)throw new Error("Value cannot be null.");let t=e;for(let n=0;n<r.length;n++){let s=r[n],i=typeof s=="function"?s:s.fn,o=typeof s=="function"?`index ${n}`:s.name||`index ${n}`;try{let u=i(t);if(u===void 0)break;if(u===null)throw new Error(`Middleware "${o}" returned null value.`);t=u;}catch(u){let l=u instanceof Error?u.message:String(u);throw new Error(`Middleware "${o}" threw an error: ${l}`)}}return t}function E(e,r){if(e===r)return  true;if(!e||!r||typeof e!=typeof r)return  false;if(Array.isArray(e)&&Array.isArray(r)){if(e.length!==r.length)return  false;for(let t=0;t<e.length;t++)if(e[t]!==r[t])return  false;return  true}if(typeof e=="object"&&typeof r=="object"){let t=Object.keys(e),n=Object.keys(r);if(t.length!==n.length)return  false;for(let s of t)if(!Object.prototype.hasOwnProperty.call(r,s)||e[s]!==r[s])return  false;return  true}return  false}function b(e,r,t=""){if(typeof e=="object"&&e!==null&&typeof r=="object"&&r!==null){if(Array.isArray(e)&&Array.isArray(r)){if(e.length>0&&typeof e[0]=="object")for(let n=0;n<r.length;n++)b(e[0],r[n],`${t}[${n}]`);}else if(!Array.isArray(e)&&!Array.isArray(r)){let n=Object.keys(e),s=Object.keys(r),i=s.filter(o=>!n.includes(o));i.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${t||"root"}': ${i.join(", ")}. This might cause bugs.`),console.error("Expected keys:",n),console.error("Received keys:",s));for(let o of n)b(e[o],r[o],t?`${t}.${o}`:o);}}}function x(e,r,t={}){let{useShallowEqual:n=false}=t,s=e.get(),i=r(s),o=P(i),u=()=>{let a=e.get(),c=r(a);s=a,(n?!E(c,i):c!==i)&&(i=c,o.set(c));},l=e.subscribe(u);return {get:()=>o.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:o.subscribe,derive:a=>x(o,a,t),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),o.destroy();}}}function C(e,r){let t=r?x(e,r):e,[n,s]=react.useState(()=>t.get());react.useEffect(()=>{let l=t.subscribe(a=>{s(()=>a);});return ()=>l()},[t]);let i=react.useCallback(l=>{e.set(l);},[e]),o=react.useCallback(()=>{e.reset();},[e]),u=react.useCallback(()=>{e.destroy();},[e]);return [n,i,o,u]}function F(e,r){let t=react.useRef(r);react.useEffect(()=>{t.current=r;},[r]);let n=react.useMemo(()=>e.derive(i=>t.current(i)),[e]),[s]=C(n);return s}function O(e,r){let t=e.map(a=>a.get()),n=r(...t),s=P(n),i=s.set,o=false,u=()=>{let a=false;for(let c=0;c<e.length;c++){let T=e[c].get();T!==t[c]&&(t[c]=T,a=true);}if(a){let c=r(...t);c!==n&&(typeof c!="object"||typeof n!="object"||!E(c,n))&&(n=c,i(c)),o=false;}},l=e.map(a=>a.subscribe(()=>{o=true,u();}));return {...s,get:()=>(o&&u(),n),recompute:u,isDirty:()=>o,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(a=>{typeof a.reset=="function"&&a.reset();}),o=true,u(),n),destroy:()=>{l.forEach(a=>a()),s.destroy?.();}}}function L(e,r){let t=react.useMemo(()=>O(e,r),[...e]),[n,s]=react.useState(()=>t.get());return react.useEffect(()=>{let i=t.subscribe(o=>{s(o);});return ()=>{i();}},[t]),n}function v(e,r){let[t]=C(e,r);return t}function G(e,r){let t=react.useMemo(()=>n=>n[r],[r]);return v(e,t)}function X(e){let[r,t]=react.useState(()=>e.map(n=>n.get()));return react.useEffect(()=>{let n=e.map((s,i)=>s.subscribe(o=>{t(u=>{let l=[...u];return l[i]=o,l});}));return ()=>{n.forEach(s=>s());}},[e]),r}function Z(e){return "nextPage"in e}function U(e){return "setParams"in e}function R(e,r){let{initialParams:t,fetchOnMount:n}=typeof r=="object"&&("initialParams"in r||"fetchOnMount"in r)?r:{initialParams:r,fetchOnMount:false},[s,i]=react.useState(()=>e.get());react.useEffect(()=>e.subscribe(k=>{i(k);}),[e]),react.useEffect(()=>{t&&U(e)?e.setParams(t):n&&!t&&e.reload();},[e]),react.useEffect(()=>()=>{e.cleanup();},[e]);let o=react.useCallback(d=>e.reload(d),[e]),u=react.useCallback(d=>e.refresh(d),[e]),l=react.useCallback(d=>e.mutate(d),[e]),a=react.useCallback(()=>e.reset(),[e]),c=react.useCallback(d=>{"setParams"in e&&e.setParams(d);},[e]),{data:T,loading:g,error:f,lastFetched:h,pagination:p}=s,m={data:T,loading:g,error:f,lastFetched:h,reload:o,refresh:u,mutate:l,reset:a};if(U(e)&&(m.setParams=c),Z(e)){let d=m;d.pagination=p,d.nextPage=react.useCallback(()=>e.nextPage(),[e]),d.prevPage=react.useCallback(()=>e.prevPage(),[e]),d.goToPage=react.useCallback(k=>e.goToPage(k),[e]),d.resetPagination=react.useCallback(()=>e.resetPagination(),[e]);}return m}function re(e,r={}){let{initialParams:t,autoLoad:n=true,threshold:s=1,...i}=r,o=react.useRef(null),u=R(e,{initialParams:{...t,page:1,pageSize:e.get().pagination?.pageSize||10},...i}),{loading:l,pagination:a,nextPage:c}=u;react.useEffect(()=>{if(!n)return;let g=new IntersectionObserver(h=>{h[0].isIntersecting&&!l&&a?.hasMore&&c();},{threshold:s}),f=o.current;return f&&g.observe(f),()=>{f&&g.unobserve(f);}},[l,a?.hasMore,c,n,s]);let T=react.useCallback(()=>{!l&&a?.hasMore&&c();},[l,a?.hasMore,c]);return {...u,loadMore:T,observerTarget:o,hasMore:a?.hasMore??false,isFetchingMore:l&&(u.data?.length??0)>0}}exports.useAsyncChunk=R;exports.useChunk=C;exports.useChunkProperty=G;exports.useChunkValue=v;exports.useChunkValues=X;exports.useComputed=L;exports.useDerive=F;exports.useInfiniteAsyncChunk=re;

package/dist/use-react/index.d.cts

@@ -0,0 +1,141 @@
+import { C as Chunk } from '../core-DMY69lzg.cjs';
+
+/**
+ * A lightweight hook that subscribes to a chunk and returns its current value, along with setters, selector, reset and destroy.
+ * Ensures reactivity and prevents unnecessary re-renders.
+ */
+declare function useChunk<T, S = T>(chunk: Chunk<T>, selector?: (value: T) => S): readonly [S, (valueOrUpdater: T | ((currentValue: T) => T)) => void, () => void, () => void];
+
+/**
+ * A hook for creating a read-only derived value from a chunk.
+ * Ensures reactivity and updates when the source chunk changes.
+ */
+declare function useDerive<T, D>(chunk: Chunk<T>, fn: (value: T) => D): D;
+
+type ChunkValue<T> = T extends Chunk<infer U> ? U : never;
+type DependencyValues<T extends Chunk<any>[]> = {
+    [K in keyof T]: T[K] extends Chunk<any> ? ChunkValue<T[K]> : never;
+};
+
+/**
+ * A hook that computes a value based on multiple chunks.
+ * Automatically re-computes when any dependency changes.
+ */
+declare function useComputed<TDeps extends Chunk<any>[], TResult>(dependencies: [...TDeps], computeFn: (...args: DependencyValues<TDeps>) => TResult): TResult;
+
+/**
+ * A lightweight hook that subscribes to a chunk and returns only its current value.
+ * Useful for read-only components that don't need to update the chunk.
+ */
+declare function useChunkValue<T, S = T>(chunk: Chunk<T>, selector?: (value: T) => S): S;
+
+/**
+ * A hook that subscribes to a specific property of a chunk.
+ * This optimizes renders by only updating when the selected property changes.
+ */
+declare function useChunkProperty<T, K extends keyof T>(chunk: Chunk<T>, property: K): T[K];
+
+/**
+ * Hook to read values from multiple chunks at once.
+ * Only re-renders when any of the chunk values change.
+ */
+declare function useChunkValues<T extends Chunk<any>[]>(chunks: [...T]): {
+    [K in keyof T]: T[K] extends Chunk<infer U> ? U : never;
+};
+
+interface AsyncState<T, E extends Error> {
+    loading: boolean;
+    error: E | null;
+    data: T | null;
+    lastFetched?: number;
+}
+interface PaginationState {
+    page: number;
+    pageSize: number;
+    total?: number;
+    hasMore?: boolean;
+}
+interface AsyncStateWithPagination<T, E extends Error> extends AsyncState<T, E> {
+    pagination?: PaginationState;
+}
+interface AsyncChunk<T, E extends Error = Error> extends Chunk<AsyncStateWithPagination<T, E>> {
+    /** Force reload data */
+    reload: (params?: any) => Promise<void>;
+    /** Smart refresh - respects stale time */
+    refresh: (params?: any) => Promise<void>;
+    /** Mutate data directly */
+    mutate: (mutator: (currentData: T | null) => T) => void;
+    /** Reset to initial state */
+    reset: () => void;
+    /** Clean up intervals */
+    cleanup: () => void;
+}
+interface PaginatedAsyncChunk<T, E extends Error = Error> extends AsyncChunk<T, E> {
+    /** Load next page */
+    nextPage: () => Promise<void>;
+    /** Load previous page */
+    prevPage: () => Promise<void>;
+    /** Go to specific page */
+    goToPage: (page: number) => Promise<void>;
+    /** Reset pagination to first page */
+    resetPagination: () => Promise<void>;
+}
+
+interface UseAsyncChunkResult<T, E extends Error, P extends Record<string, any>> {
+    data: T | null;
+    loading: boolean;
+    error: E | null;
+    lastFetched?: number;
+    reload: (params?: Partial<P>) => Promise<void>;
+    refresh: (params?: Partial<P>) => Promise<void>;
+    mutate: (mutator: (currentData: T | null) => T) => void;
+    reset: () => void;
+}
+interface UseAsyncChunkResultWithParams<T, E extends Error, P extends Record<string, any>> extends UseAsyncChunkResult<T, E, P> {
+    setParams: (params: Partial<P>) => void;
+}
+interface UseAsyncChunkResultWithPagination<T, E extends Error, P extends Record<string, any>> extends UseAsyncChunkResult<T, E, P> {
+    pagination?: PaginationState;
+    nextPage: () => Promise<void>;
+    prevPage: () => Promise<void>;
+    goToPage: (page: number) => Promise<void>;
+    resetPagination: () => Promise<void>;
+}
+interface UseAsyncChunkResultWithParamsAndPagination<T, E extends Error, P extends Record<string, any>> extends UseAsyncChunkResultWithParams<T, E, P>, Omit<UseAsyncChunkResultWithPagination<T, E, P>, keyof UseAsyncChunkResult<T, E, P>> {
+}
+/**
+ * A hook that handles asynchronous state with built-in reactivity.
+ * Provides loading, error, and data states with full asyncChunk functionality.
+ */
+interface UseAsyncChunkOptions<P extends Record<string, any> = {}> {
+    /** Initial parameters to pass to the fetcher */
+    initialParams?: Partial<P>;
+    /** Force fetch on mount, even without params (default: false) */
+    fetchOnMount?: boolean;
+}
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T, E> & {
+    setParams: (params: Partial<P>) => void;
+}, options?: UseAsyncChunkOptions<P> | Partial<P>): UseAsyncChunkResultWithParamsAndPagination<T, E, P>;
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T, E>, options?: UseAsyncChunkOptions<P> | Partial<P>): UseAsyncChunkResultWithPagination<T, E, P>;
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: AsyncChunk<T, E> & {
+    setParams: (params: Partial<P>) => void;
+}, options?: UseAsyncChunkOptions<P> | Partial<P>): UseAsyncChunkResultWithParams<T, E, P>;
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: AsyncChunk<T, E>, options?: UseAsyncChunkOptions<P> | Partial<P>): UseAsyncChunkResult<T, E, P>;
+
+interface UseInfiniteAsyncChunkOptions<P extends Record<string, any>> extends Omit<UseAsyncChunkOptions<P>, 'initialParams'> {
+    /** Initial parameters (page and pageSize added automatically) */
+    initialParams?: Omit<Partial<P>, 'page' | 'pageSize'>;
+    /** Enable auto-loading on scroll (default: true) */
+    autoLoad?: boolean;
+    /** Intersection observer threshold (default: 1.0) */
+    threshold?: number;
+}
+/**
+ * Hook for infinite scroll functionality.
+ * Automatically loads more data when scrolling to the bottom.
+ */
+declare function useInfiniteAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T[], E> & {
+    setParams: (params: Partial<P>) => void;
+}, options?: UseInfiniteAsyncChunkOptions<P>): any;
+
+export { useAsyncChunk, useChunk, useChunkProperty, useChunkValue, useChunkValues, useComputed, useDerive, useInfiniteAsyncChunk };

package/dist/use-react/index.d.ts

@@ -1,4 +1,4 @@
-import { C as Chunk } from '../core-C7jFiHdO.js';
+import { C as Chunk } from '../core-DMY69lzg.js';
 
 /**
  * A lightweight hook that subscribes to a chunk and returns its current value, along with setters, selector, reset and destroy.

package/dist/use-react/index.js

@@ -1 +1 @@
-import {useState,useEffect,useCallback,useRef,useMemo}from'react';var S=new Set,D=new Map,j=0;function P(e,r=[]){if(e===null)throw new Error("Initial value cannot be null.");let t=e,n=new Set,s=j++,i=()=>{n.forEach(f=>f(t));};D.set(s,{notify:i});let o=()=>{n.size!==0&&(i());},l=()=>t,c=f=>{let h;typeof f=="function"?h=f(t):h=f,b(t,h);let p=M(h,r);p!==t&&(t=p,o());},a=f=>{if(typeof f!="function")throw new Error("Callback must be a function.");return n.add(f),f(t),()=>n.delete(f)};return {get:l,set:c,subscribe:a,derive:f=>{if(typeof f!="function")throw new Error("Derive function must be a function.");let h=f(t),p=P(h),m=a(()=>{let k=f(t);p.set(k);}),d=p.destroy;return p.destroy=()=>{m(),d();},p},reset:()=>{t=e,o();},destroy:()=>{n.clear(),t=e,S.delete(s),D.delete(s);}}}function M(e,r){if(e===null)throw new Error("Value cannot be null.");let t=e,n=0;for(;n<r.length;){let s=r[n],i=typeof s=="function"?s:s.fn,o=typeof s=="function"?`index ${n}`:s.name||`index ${n}`,l=false,c=null;try{i(t,a=>{l=!0,c=a;});}catch(a){let u=a instanceof Error?a.message:String(a);throw new Error(`Middleware "${o}" threw an error: ${u}`)}if(!l)break;if(c===null)throw new Error(`Middleware at index ${n} returned null value.`);t=c,n++;}return t}function x(e,r){if(e===r)return  true;if(!e||!r||typeof e!=typeof r)return  false;if(Array.isArray(e)&&Array.isArray(r)){if(e.length!==r.length)return  false;for(let t=0;t<e.length;t++)if(e[t]!==r[t])return  false;return  true}if(typeof e=="object"&&typeof r=="object"){let t=Object.keys(e),n=Object.keys(r);if(t.length!==n.length)return  false;for(let s of t)if(!Object.prototype.hasOwnProperty.call(r,s)||e[s]!==r[s])return  false;return  true}return  false}function b(e,r,t=""){if(typeof e=="object"&&e!==null&&typeof r=="object"&&r!==null){if(Array.isArray(e)&&Array.isArray(r)){if(e.length>0&&typeof e[0]=="object")for(let n=0;n<r.length;n++)b(e[0],r[n],`${t}[${n}]`);}else if(!Array.isArray(e)&&!Array.isArray(r)){let n=Object.keys(e),s=Object.keys(r),i=s.filter(o=>!n.includes(o));i.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${t||"root"}': ${i.join(", ")}. This might cause bugs.`),console.error("Expected keys:",n),console.error("Received keys:",s));for(let o of n)b(e[o],r[o],t?`${t}.${o}`:o);}}}function E(e,r,t={}){let{useShallowEqual:n=false}=t,s=e.get(),i=r(s),o=P(i),l=()=>{let a=e.get(),u=r(a);s=a,(n?!x(u,i):u!==i)&&(i=u,o.set(u));},c=e.subscribe(l);return {get:()=>o.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:o.subscribe,derive:a=>E(o,a,t),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{c(),o.destroy();}}}function C(e,r){let t=r?E(e,r):e,[n,s]=useState(()=>t.get());useEffect(()=>{let c=t.subscribe(a=>{s(()=>a);});return ()=>c()},[t]);let i=useCallback(c=>{e.set(c);},[e]),o=useCallback(()=>{e.reset();},[e]),l=useCallback(()=>{e.destroy();},[e]);return [n,i,o,l]}function F(e,r){let t=useRef(r);useEffect(()=>{t.current=r;},[r]);let n=useMemo(()=>e.derive(i=>t.current(i)),[e]),[s]=C(n);return s}function V(e,r){let t=e.map(a=>a.get()),n=r(...t),s=P(n),i=s.set,o=false,l=()=>{let a=false;for(let u=0;u<e.length;u++){let T=e[u].get();T!==t[u]&&(t[u]=T,a=true);}if(a){let u=r(...t);u!==n&&(typeof u!="object"||typeof n!="object"||!x(u,n))&&(n=u,i(u)),o=false;}},c=e.map(a=>a.subscribe(()=>{o=true,l();}));return {...s,get:()=>(o&&l(),n),recompute:l,isDirty:()=>o,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(a=>{typeof a.reset=="function"&&a.reset();}),o=true,l(),n),destroy:()=>{c.forEach(a=>a()),s.destroy?.();}}}function L(e,r){let t=useMemo(()=>V(e,r),[...e]),[n,s]=useState(()=>t.get());return useEffect(()=>{let i=t.subscribe(o=>{s(o);});return ()=>{i();}},[t]),n}function v(e,r){let[t]=C(e,r);return t}function G(e,r){let t=useMemo(()=>n=>n[r],[r]);return v(e,t)}function X(e){let[r,t]=useState(()=>e.map(n=>n.get()));return useEffect(()=>{let n=e.map((s,i)=>s.subscribe(o=>{t(l=>{let c=[...l];return c[i]=o,c});}));return ()=>{n.forEach(s=>s());}},[e]),r}function Z(e){return "nextPage"in e}function O(e){return "setParams"in e}function R(e,r){let{initialParams:t,fetchOnMount:n}=typeof r=="object"&&("initialParams"in r||"fetchOnMount"in r)?r:{initialParams:r,fetchOnMount:false},[s,i]=useState(()=>e.get());useEffect(()=>e.subscribe(k=>{i(k);}),[e]),useEffect(()=>{t&&O(e)?e.setParams(t):n&&!t&&e.reload();},[e]),useEffect(()=>()=>{e.cleanup();},[e]);let o=useCallback(d=>e.reload(d),[e]),l=useCallback(d=>e.refresh(d),[e]),c=useCallback(d=>e.mutate(d),[e]),a=useCallback(()=>e.reset(),[e]),u=useCallback(d=>{"setParams"in e&&e.setParams(d);},[e]),{data:T,loading:g,error:f,lastFetched:h,pagination:p}=s,m={data:T,loading:g,error:f,lastFetched:h,reload:o,refresh:l,mutate:c,reset:a};if(O(e)&&(m.setParams=u),Z(e)){let d=m;d.pagination=p,d.nextPage=useCallback(()=>e.nextPage(),[e]),d.prevPage=useCallback(()=>e.prevPage(),[e]),d.goToPage=useCallback(k=>e.goToPage(k),[e]),d.resetPagination=useCallback(()=>e.resetPagination(),[e]);}return m}function re(e,r={}){let{initialParams:t,autoLoad:n=true,threshold:s=1,...i}=r,o=useRef(null),l=R(e,{initialParams:{...t,page:1,pageSize:e.get().pagination?.pageSize||10},...i}),{loading:c,pagination:a,nextPage:u}=l;useEffect(()=>{if(!n)return;let g=new IntersectionObserver(h=>{h[0].isIntersecting&&!c&&a?.hasMore&&u();},{threshold:s}),f=o.current;return f&&g.observe(f),()=>{f&&g.unobserve(f);}},[c,a?.hasMore,u,n,s]);let T=useCallback(()=>{!c&&a?.hasMore&&u();},[c,a?.hasMore,u]);return {...l,loadMore:T,observerTarget:o,hasMore:a?.hasMore??false,isFetchingMore:c&&(l.data?.length??0)>0}}export{R as useAsyncChunk,C as useChunk,G as useChunkProperty,v as useChunkValue,X as useChunkValues,L as useComputed,F as useDerive,re as useInfiniteAsyncChunk};
+import {useState,useEffect,useCallback,useRef,useMemo}from'react';var S=new Set,D=new Map,j=0;function P(e,r=[]){if(e===null)throw new Error("Initial value cannot be null.");let t=e,n=new Set,s=j++,i=()=>{n.forEach(f=>f(t));};D.set(s,{notify:i});let o=()=>{n.size!==0&&(i());},u=()=>t,l=f=>{let h;typeof f=="function"?h=f(t):h=f,b(t,h);let p=M(h,r);p!==t&&(t=p,o());},a=f=>{if(typeof f!="function")throw new Error("Callback must be a function.");return n.add(f),f(t),()=>n.delete(f)};return {get:u,set:l,subscribe:a,derive:f=>{if(typeof f!="function")throw new Error("Derive function must be a function.");let h=f(t),p=P(h),m=a(()=>{let k=f(t);p.set(k);}),d=p.destroy;return p.destroy=()=>{m(),d();},p},reset:()=>{t=e,o();},destroy:()=>{n.clear(),t=e,S.delete(s),D.delete(s);}}}function M(e,r){if(e===null)throw new Error("Value cannot be null.");let t=e;for(let n=0;n<r.length;n++){let s=r[n],i=typeof s=="function"?s:s.fn,o=typeof s=="function"?`index ${n}`:s.name||`index ${n}`;try{let u=i(t);if(u===void 0)break;if(u===null)throw new Error(`Middleware "${o}" returned null value.`);t=u;}catch(u){let l=u instanceof Error?u.message:String(u);throw new Error(`Middleware "${o}" threw an error: ${l}`)}}return t}function E(e,r){if(e===r)return  true;if(!e||!r||typeof e!=typeof r)return  false;if(Array.isArray(e)&&Array.isArray(r)){if(e.length!==r.length)return  false;for(let t=0;t<e.length;t++)if(e[t]!==r[t])return  false;return  true}if(typeof e=="object"&&typeof r=="object"){let t=Object.keys(e),n=Object.keys(r);if(t.length!==n.length)return  false;for(let s of t)if(!Object.prototype.hasOwnProperty.call(r,s)||e[s]!==r[s])return  false;return  true}return  false}function b(e,r,t=""){if(typeof e=="object"&&e!==null&&typeof r=="object"&&r!==null){if(Array.isArray(e)&&Array.isArray(r)){if(e.length>0&&typeof e[0]=="object")for(let n=0;n<r.length;n++)b(e[0],r[n],`${t}[${n}]`);}else if(!Array.isArray(e)&&!Array.isArray(r)){let n=Object.keys(e),s=Object.keys(r),i=s.filter(o=>!n.includes(o));i.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${t||"root"}': ${i.join(", ")}. This might cause bugs.`),console.error("Expected keys:",n),console.error("Received keys:",s));for(let o of n)b(e[o],r[o],t?`${t}.${o}`:o);}}}function x(e,r,t={}){let{useShallowEqual:n=false}=t,s=e.get(),i=r(s),o=P(i),u=()=>{let a=e.get(),c=r(a);s=a,(n?!E(c,i):c!==i)&&(i=c,o.set(c));},l=e.subscribe(u);return {get:()=>o.get(),set:()=>{throw new Error("Cannot set values directly on a selector. Modify the source chunk instead.")},subscribe:o.subscribe,derive:a=>x(o,a,t),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{l(),o.destroy();}}}function C(e,r){let t=r?x(e,r):e,[n,s]=useState(()=>t.get());useEffect(()=>{let l=t.subscribe(a=>{s(()=>a);});return ()=>l()},[t]);let i=useCallback(l=>{e.set(l);},[e]),o=useCallback(()=>{e.reset();},[e]),u=useCallback(()=>{e.destroy();},[e]);return [n,i,o,u]}function F(e,r){let t=useRef(r);useEffect(()=>{t.current=r;},[r]);let n=useMemo(()=>e.derive(i=>t.current(i)),[e]),[s]=C(n);return s}function O(e,r){let t=e.map(a=>a.get()),n=r(...t),s=P(n),i=s.set,o=false,u=()=>{let a=false;for(let c=0;c<e.length;c++){let T=e[c].get();T!==t[c]&&(t[c]=T,a=true);}if(a){let c=r(...t);c!==n&&(typeof c!="object"||typeof n!="object"||!E(c,n))&&(n=c,i(c)),o=false;}},l=e.map(a=>a.subscribe(()=>{o=true,u();}));return {...s,get:()=>(o&&u(),n),recompute:u,isDirty:()=>o,set:()=>{throw new Error("Cannot set values directly on computed. Modify the source chunk instead.")},reset:()=>(e.forEach(a=>{typeof a.reset=="function"&&a.reset();}),o=true,u(),n),destroy:()=>{l.forEach(a=>a()),s.destroy?.();}}}function L(e,r){let t=useMemo(()=>O(e,r),[...e]),[n,s]=useState(()=>t.get());return useEffect(()=>{let i=t.subscribe(o=>{s(o);});return ()=>{i();}},[t]),n}function v(e,r){let[t]=C(e,r);return t}function G(e,r){let t=useMemo(()=>n=>n[r],[r]);return v(e,t)}function X(e){let[r,t]=useState(()=>e.map(n=>n.get()));return useEffect(()=>{let n=e.map((s,i)=>s.subscribe(o=>{t(u=>{let l=[...u];return l[i]=o,l});}));return ()=>{n.forEach(s=>s());}},[e]),r}function Z(e){return "nextPage"in e}function U(e){return "setParams"in e}function R(e,r){let{initialParams:t,fetchOnMount:n}=typeof r=="object"&&("initialParams"in r||"fetchOnMount"in r)?r:{initialParams:r,fetchOnMount:false},[s,i]=useState(()=>e.get());useEffect(()=>e.subscribe(k=>{i(k);}),[e]),useEffect(()=>{t&&U(e)?e.setParams(t):n&&!t&&e.reload();},[e]),useEffect(()=>()=>{e.cleanup();},[e]);let o=useCallback(d=>e.reload(d),[e]),u=useCallback(d=>e.refresh(d),[e]),l=useCallback(d=>e.mutate(d),[e]),a=useCallback(()=>e.reset(),[e]),c=useCallback(d=>{"setParams"in e&&e.setParams(d);},[e]),{data:T,loading:g,error:f,lastFetched:h,pagination:p}=s,m={data:T,loading:g,error:f,lastFetched:h,reload:o,refresh:u,mutate:l,reset:a};if(U(e)&&(m.setParams=c),Z(e)){let d=m;d.pagination=p,d.nextPage=useCallback(()=>e.nextPage(),[e]),d.prevPage=useCallback(()=>e.prevPage(),[e]),d.goToPage=useCallback(k=>e.goToPage(k),[e]),d.resetPagination=useCallback(()=>e.resetPagination(),[e]);}return m}function re(e,r={}){let{initialParams:t,autoLoad:n=true,threshold:s=1,...i}=r,o=useRef(null),u=R(e,{initialParams:{...t,page:1,pageSize:e.get().pagination?.pageSize||10},...i}),{loading:l,pagination:a,nextPage:c}=u;useEffect(()=>{if(!n)return;let g=new IntersectionObserver(h=>{h[0].isIntersecting&&!l&&a?.hasMore&&c();},{threshold:s}),f=o.current;return f&&g.observe(f),()=>{f&&g.unobserve(f);}},[l,a?.hasMore,c,n,s]);let T=useCallback(()=>{!l&&a?.hasMore&&c();},[l,a?.hasMore,c]);return {...u,loadMore:T,observerTarget:o,hasMore:a?.hasMore??false,isFetchingMore:l&&(u.data?.length??0)>0}}export{R as useAsyncChunk,C as useChunk,G as useChunkProperty,v as useChunkValue,X as useChunkValues,L as useComputed,F as useDerive,re as useInfiniteAsyncChunk};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stunk",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "Stunk is a lightweight, framework-agnostic state management library for JavaScript and TypeScript. It uses chunk-based state units for efficient updates, reactivity, and performance optimization in React, Vue(WIP), Svelte(Coming soon), and Vanilla JS/TS applications.",
   "type": "module",
   "repository": {