stunk 2.6.0 → 2.7.1

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -118,6 +118,37 @@ declare function asyncChunk<T, E extends Error = Error, P extends Record<string,
     refresh: (params?: Partial<P>) => Promise<void>;
 };
 
+interface InfiniteAsyncChunkOptions<T, E extends Error> {
+    /** Initial page size (default: 10) */
+    pageSize?: number;
+    /** Time in ms after which data becomes stale */
+    staleTime?: number;
+    /** Time in ms to cache data */
+    cacheTime?: number;
+    /** Retry count on error */
+    retryCount?: number;
+    /** Delay between retries in ms */
+    retryDelay?: number;
+    /** Error callback */
+    onError?: (error: E) => void;
+}
+/**
+ * Create an infinite scroll async chunk with accumulate mode.
+ * Automatically handles pagination in accumulate mode for infinite scrolling.
+ */
+declare function infiniteAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(fetcher: (params: P & {
+    page: number;
+    pageSize: number;
+}) => Promise<{
+    data: T[];
+    hasMore?: boolean;
+    total?: number;
+}>, options?: InfiniteAsyncChunkOptions<T, E>): PaginatedAsyncChunk<T[], E> & {
+    setParams: (params: Partial<P>) => void;
+    reload: (params?: Partial<P>) => Promise<void>;
+    refresh: (params?: Partial<P>) => Promise<void>;
+};
+
 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;
@@ -209,4 +240,4 @@ declare namespace index {
   export { index_logger as logger, index_nonNegativeValidator as nonNegativeValidator, index_withHistory as withHistory, index_withPersistence as withPersistence };
 }
 
-export { type Chunk, type Middleware, asyncChunk, batch, chunk, combineAsyncChunks, computed, isChunk, isValidChunkValue, index as middleware, once, select };
+export { type AsyncChunk, type AsyncState, type AsyncStateWithPagination, type Chunk, type Middleware, type PaginatedAsyncChunk, asyncChunk, batch, chunk, combineAsyncChunks, computed, infiniteAsyncChunk, isChunk, isValidChunkValue, index as middleware, once, select };

package/dist/index.d.ts

@@ -118,6 +118,37 @@ declare function asyncChunk<T, E extends Error = Error, P extends Record<string,
     refresh: (params?: Partial<P>) => Promise<void>;
 };
 
+interface InfiniteAsyncChunkOptions<T, E extends Error> {
+    /** Initial page size (default: 10) */
+    pageSize?: number;
+    /** Time in ms after which data becomes stale */
+    staleTime?: number;
+    /** Time in ms to cache data */
+    cacheTime?: number;
+    /** Retry count on error */
+    retryCount?: number;
+    /** Delay between retries in ms */
+    retryDelay?: number;
+    /** Error callback */
+    onError?: (error: E) => void;
+}
+/**
+ * Create an infinite scroll async chunk with accumulate mode.
+ * Automatically handles pagination in accumulate mode for infinite scrolling.
+ */
+declare function infiniteAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(fetcher: (params: P & {
+    page: number;
+    pageSize: number;
+}) => Promise<{
+    data: T[];
+    hasMore?: boolean;
+    total?: number;
+}>, options?: InfiniteAsyncChunkOptions<T, E>): PaginatedAsyncChunk<T[], E> & {
+    setParams: (params: Partial<P>) => void;
+    reload: (params?: Partial<P>) => Promise<void>;
+    refresh: (params?: Partial<P>) => Promise<void>;
+};
+
 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;
@@ -209,4 +240,4 @@ declare namespace index {
   export { index_logger as logger, index_nonNegativeValidator as nonNegativeValidator, index_withHistory as withHistory, index_withPersistence as withPersistence };
 }
 
-export { type Chunk, type Middleware, asyncChunk, batch, chunk, combineAsyncChunks, computed, isChunk, isValidChunkValue, index as middleware, once, select };
+export { type AsyncChunk, type AsyncState, type AsyncStateWithPagination, type Chunk, type Middleware, type PaginatedAsyncChunk, asyncChunk, batch, chunk, combineAsyncChunks, computed, infiniteAsyncChunk, isChunk, isValidChunkValue, index as middleware, once, select };

package/dist/index.js

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

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

@@ -122,4 +122,20 @@ declare function useAsyncChunk<T, E extends Error = Error, P extends Record<stri
 }, 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>;
 
-export { useAsyncChunk, useChunk, useChunkProperty, useChunkValue, useChunkValues, useComputed, useDerive };
+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.js

@@ -1 +1 @@
-import {useState,useEffect,useCallback,useRef,useMemo}from'react';var R=new Set,S=new Map,O=0;function P(e,r=[]){if(e===null)throw new Error("Initial value cannot be null.");let t=e,n=new Set,s=O++,u=()=>{n.forEach(f=>f(t));};S.set(s,{notify:u});let o=()=>{n.size!==0&&(u());},l=()=>t,c=f=>{let h;typeof f=="function"?h=f(t):h=f,C(t,h);let T=D(h,r);T!==t&&(t=T,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),T=P(h),m=a(()=>{let k=f(t);T.set(k);}),d=T.destroy;return T.destroy=()=>{m(),d();},T},reset:()=>{t=e,o();},destroy:()=>{n.clear(),t=e,R.delete(s),S.delete(s);}}}function D(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],u=typeof s=="function"?s:s.fn,o=typeof s=="function"?`index ${n}`:s.name||`index ${n}`,l=false,c=null;try{u(t,a=>{l=!0,c=a;});}catch(a){let i=a instanceof Error?a.message:String(a);throw new Error(`Middleware "${o}" threw an error: ${i}`)}if(!l)break;if(c===null)throw new Error(`Middleware at index ${n} returned null value.`);t=c,n++;}return t}function b(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 C(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++)C(e[0],r[n],`${t}[${n}]`);}else if(!Array.isArray(e)&&!Array.isArray(r)){let n=Object.keys(e),s=Object.keys(r),u=s.filter(o=>!n.includes(o));u.length>0&&(console.error(`\u{1F6A8} Stunk: Unknown properties detected at '${t||"root"}': ${u.join(", ")}. This might cause bugs.`),console.error("Expected keys:",n),console.error("Received keys:",s));for(let o of n)C(e[o],r[o],t?`${t}.${o}`:o);}}}function x(e,r,t={}){let{useShallowEqual:n=false}=t,s=e.get(),u=r(s),o=P(u),l=()=>{let a=e.get(),i=r(a);s=a,(n?!b(i,u):i!==u)&&(u=i,o.set(i));},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=>x(o,a,t),reset:()=>{throw new Error("Cannot reset a selector chunk. Reset the source chunk instead.")},destroy:()=>{c(),o.destroy();}}}function g(e,r){let t=r?x(e,r):e,[n,s]=useState(()=>t.get());useEffect(()=>{let c=t.subscribe(a=>{s(()=>a);});return ()=>c()},[t]);let u=useCallback(c=>{e.set(c);},[e]),o=useCallback(()=>{e.reset();},[e]),l=useCallback(()=>{e.destroy();},[e]);return [n,u,o,l]}function N(e,r){let t=useRef(r);useEffect(()=>{t.current=r;},[r]);let n=useMemo(()=>e.derive(u=>t.current(u)),[e]),[s]=g(n);return s}function V(e,r){let t=e.map(a=>a.get()),n=r(...t),s=P(n),u=s.set,o=false,l=()=>{let a=false;for(let i=0;i<e.length;i++){let p=e[i].get();p!==t[i]&&(t[i]=p,a=true);}if(a){let i=r(...t);i!==n&&(typeof i!="object"||typeof n!="object"||!b(i,n))&&(n=i,u(i)),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 z(e,r){let t=useMemo(()=>V(e,r),[...e]),[n,s]=useState(()=>t.get());return useEffect(()=>{let u=t.subscribe(o=>{s(o);});return ()=>{u();}},[t]),n}function A(e,r){let[t]=g(e,r);return t}function G(e,r){let t=useMemo(()=>n=>n[r],[r]);return A(e,t)}function Q(e){let[r,t]=useState(()=>e.map(n=>n.get()));return useEffect(()=>{let n=e.map((s,u)=>s.subscribe(o=>{t(l=>{let c=[...l];return c[u]=o,c});}));return ()=>{n.forEach(s=>s());}},[e]),r}function Y(e){return "nextPage"in e}function U(e){return "setParams"in e}function Z(e,r){let{initialParams:t,fetchOnMount:n}=typeof r=="object"&&("initialParams"in r||"fetchOnMount"in r)?r:{initialParams:r,fetchOnMount:false},[s,u]=useState(()=>e.get());useEffect(()=>e.subscribe(k=>{u(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]),l=useCallback(d=>e.refresh(d),[e]),c=useCallback(d=>e.mutate(d),[e]),a=useCallback(()=>e.reset(),[e]),i=useCallback(d=>{"setParams"in e&&e.setParams(d);},[e]),{data:p,loading:w,error:f,lastFetched:h,pagination:T}=s,m={data:p,loading:w,error:f,lastFetched:h,reload:o,refresh:l,mutate:c,reset:a};if(U(e)&&(m.setParams=i),Y(e)){let d=m;d.pagination=T,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}export{Z as useAsyncChunk,g as useChunk,G as useChunkProperty,A as useChunkValue,Q as useChunkValues,z as useComputed,N as useDerive};
+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};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stunk",
-  "version": "2.6.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, Svelte, and Vanilla JS/TS applications.",
+  "version": "2.7.1",
+  "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": {
     "type": "git",
@@ -67,8 +67,12 @@
       "url": "https://github.com/I-am-abdulazeez"
     },
     {
-      "name": "AbdulAzeez",
-      "url": "https://github.com/I-am-abdulazeez"
+      "name": "Chiboy",
+      "url": "https://github.com/chibx"
+    },
+    {
+      "name": "Idris",
+      "url": "https://github.com/Dreezy305"
     }
   ],
   "license": "MIT",