@stacksjs/composables 0.75.515 → 0.75.518

package/dist/useToggle.js

@@ -1 +1 @@
-import{ref}from"@stacksjs/stx";export function useToggle(initialValue=!1){const state=typeof initialValue==="boolean"?ref(initialValue):initialValue;function toggle(value){if(typeof value==="boolean")state.value=value;else state.value=!state.value;return state.value}return[state,toggle]}
+import{ref}from"@stacksjs/stx";export function useToggle(initialValue=false){const state=typeof initialValue==="boolean"?ref(initialValue):initialValue;function toggle(value){if(typeof value==="boolean"){state.value=value}else{state.value=!state.value}return state.value}return[state,toggle]}

package/dist/useTransition.js

@@ -1 +1 @@
-import{onUnmounted,ref,watch}from"@stacksjs/stx";import{unref}from"./_shared";export const TransitionPresets={linear:(t)=>t,easeInQuad:(t)=>t*t,easeOutQuad:(t)=>t*(2-t),easeInOutQuad:(t)=>t<0.5?2*t*t:-1+(4-2*t)*t,easeInCubic:(t)=>t*t*t,easeOutCubic:(t)=>--t*t*t+1,easeInOutCubic:(t)=>t<0.5?4*t*t*t:(t-1)*(2*t-2)*(2*t-2)+1};export function useTransition(source,options={}){const{duration=300,transition=TransitionPresets.linear,delay=0,onFinished,onStarted}=options,output=ref(unref(source));let rafId=null;function startTransition(from,to){if(rafId!==null)cancelAnimationFrame(rafId);const start=performance.now()+delay;onStarted?.();function tick(now){const elapsed=now-start;if(elapsed<0){rafId=requestAnimationFrame(tick);return}const progress=Math.min(elapsed/duration,1),eased=transition(progress);output.value=from+(to-from)*eased;if(progress<1)rafId=requestAnimationFrame(tick);else{rafId=null;output.value=to;onFinished?.()}}rafId=requestAnimationFrame(tick)}if(typeof source==="object"&&source&&"value"in source&&"subscribe"in source)watch(source,(newValue)=>{if(typeof requestAnimationFrame<"u")startTransition(output.value,newValue);else output.value=newValue});try{onUnmounted(()=>{if(rafId!==null)cancelAnimationFrame(rafId)})}catch{}return output}export function executeTransition(_from,_to,options={}){return new Promise((resolve)=>{const{duration=300,transition=TransitionPresets.linear,delay=0,onFinished,onStarted}=options;if(typeof requestAnimationFrame>"u"){onFinished?.();resolve();return}const start=performance.now()+delay;onStarted?.();function tick(now){const elapsed=now-start;if(elapsed<0){requestAnimationFrame(tick);return}if(Math.min(elapsed/duration,1)>=1){onFinished?.();resolve()}else requestAnimationFrame(tick)}requestAnimationFrame(tick)})}
+import{onUnmounted,ref,watch}from"@stacksjs/stx";import{unref}from"./_shared";export const TransitionPresets={linear:(t)=>t,easeInQuad:(t)=>t*t,easeOutQuad:(t)=>t*(2-t),easeInOutQuad:(t)=>t<0.5?2*t*t:-1+(4-2*t)*t,easeInCubic:(t)=>t*t*t,easeOutCubic:(t)=>--t*t*t+1,easeInOutCubic:(t)=>t<0.5?4*t*t*t:(t-1)*(2*t-2)*(2*t-2)+1};export function useTransition(source,options={}){const{duration=300,transition=TransitionPresets.linear,delay=0,onFinished,onStarted}=options;const output=ref(unref(source));let rafId=null;function startTransition(from,to){if(rafId!==null)cancelAnimationFrame(rafId);const start=performance.now()+delay;onStarted?.();function tick(now){const elapsed=now-start;if(elapsed<0){rafId=requestAnimationFrame(tick);return}const progress=Math.min(elapsed/duration,1);const eased=transition(progress);output.value=from+(to-from)*eased;if(progress<1){rafId=requestAnimationFrame(tick)}else{rafId=null;output.value=to;onFinished?.()}}rafId=requestAnimationFrame(tick)}if(typeof source==="object"&&source&&"value"in source&&"subscribe"in source){watch(source,(newValue)=>{if(typeof requestAnimationFrame!=="undefined")startTransition(output.value,newValue);else output.value=newValue})}try{onUnmounted(()=>{if(rafId!==null)cancelAnimationFrame(rafId)})}catch{}return output}export function executeTransition(_from,_to,options={}){return new Promise((resolve)=>{const{duration=300,transition=TransitionPresets.linear,delay=0,onFinished,onStarted}=options;if(typeof requestAnimationFrame==="undefined"){onFinished?.();resolve();return}const start=performance.now()+delay;onStarted?.();function tick(now){const elapsed=now-start;if(elapsed<0){requestAnimationFrame(tick);return}const progress=Math.min(elapsed/duration,1);if(progress>=1){onFinished?.();resolve()}else{requestAnimationFrame(tick)}}requestAnimationFrame(tick)})}

package/dist/useUrlSearchParams.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";import{defaultWindow}from"./_shared";export function useUrlSearchParams(mode="history",options){const win=defaultWindow(),{initialValue}=options??{};function readParams(){if(!win)return{...initialValue};let search="";if(mode==="hash"){const hash=win.location.hash,idx=hash.indexOf("?");search=idx>=0?hash.slice(idx+1):""}else search=win.location.search.slice(1);const result={...initialValue};new URLSearchParams(search).forEach((value,key)=>{result[key]=value});return result}const params=ref(readParams());function writeParams(){if(!win)return;const searchParams=new URLSearchParams;for(const[key,value]of Object.entries(params.value))if(value!==void 0&&value!==null&&value!=="")searchParams.set(key,value);const query=searchParams.toString();if(mode==="hash"){const basePath=win.location.hash.split("?")[0]||"#";win.location.hash=query?`${basePath}?${query}`:basePath}else{const url=query?`${win.location.pathname}?${query}`:win.location.pathname;win.history.replaceState(win.history.state,"",url)}}function get(key){return params.value[key]??null}function set(key,value){const current={...params.value};current[key]=value;params.value=current;writeParams()}function del(key){const current={...params.value};delete current[key];params.value=current;writeParams()}if(win){const onPopState=()=>{params.value=readParams()},onHashChange=()=>{if(mode==="hash")params.value=readParams()};win.addEventListener("popstate",onPopState);win.addEventListener("hashchange",onHashChange);onUnmounted(()=>{win.removeEventListener("popstate",onPopState);win.removeEventListener("hashchange",onHashChange)})}return{params,get,set,delete:del}}
+import{onUnmounted,ref}from"@stacksjs/stx";import{defaultWindow}from"./_shared";export function useUrlSearchParams(mode="history",options){const win=defaultWindow();const{initialValue}=options??{};function readParams(){if(!win)return{...initialValue};let search="";if(mode==="hash"){const hash=win.location.hash;const idx=hash.indexOf("?");search=idx>=0?hash.slice(idx+1):""}else{search=win.location.search.slice(1)}const result={...initialValue};const searchParams=new URLSearchParams(search);searchParams.forEach((value,key)=>{result[key]=value});return result}const params=ref(readParams());function writeParams(){if(!win)return;const searchParams=new URLSearchParams;for(const[key,value]of Object.entries(params.value)){if(value!==undefined&&value!==null&&value!==""){searchParams.set(key,value)}}const query=searchParams.toString();if(mode==="hash"){const basePath=win.location.hash.split("?")[0]||"#";win.location.hash=query?`${basePath}?${query}`:basePath}else{const url=query?`${win.location.pathname}?${query}`:win.location.pathname;win.history.replaceState(win.history.state,"",url)}}function get(key){return params.value[key]??null}function set(key,value){const current={...params.value};current[key]=value;params.value=current;writeParams()}function del(key){const current={...params.value};delete current[key];params.value=current;writeParams()}if(win){const onPopState=()=>{params.value=readParams()};const onHashChange=()=>{if(mode==="hash"){params.value=readParams()}};win.addEventListener("popstate",onPopState);win.addEventListener("hashchange",onHashChange);onUnmounted(()=>{win.removeEventListener("popstate",onPopState);win.removeEventListener("hashchange",onHashChange)})}return{params,get,set,delete:del}}

package/dist/useVibrate.js

@@ -1 +1 @@
-import{ref}from"@stacksjs/stx";export function useVibrate(options={}){const{pattern=200}=options,isSupported=ref(typeof navigator<"u"&&"vibrate"in navigator);function vibrate(p){if(!isSupported.value)return!1;return navigator.vibrate(p??pattern)}function stop(){if(isSupported.value)navigator.vibrate(0)}return{isSupported,vibrate,stop}}
+import{ref}from"@stacksjs/stx";export function useVibrate(options={}){const{pattern=200}=options;const isSupported=ref(typeof navigator!=="undefined"&&"vibrate"in navigator);function vibrate(p){if(!isSupported.value)return false;return navigator.vibrate(p??pattern)}function stop(){if(isSupported.value)navigator.vibrate(0)}return{isSupported,vibrate,stop}}

package/dist/useVirtualList.js

@@ -1 +1 @@
-import{ref,watch}from"@stacksjs/stx";import{unref}from"./_shared";export function useVirtualList(source,options){const{itemHeight,overscan=5}=options,list=ref([]),containerHeight=ref(0),scrollTop=ref(0),wrapperProps=ref({style:{width:"100%",height:"0px",marginTop:"0px"}});function getItems(){return unref(source)}function update(){const items=getItems(),totalHeight=items.length*itemHeight,startIndex=Math.max(0,Math.floor(scrollTop.value/itemHeight)-overscan),endIndex=Math.min(items.length,Math.ceil((scrollTop.value+containerHeight.value)/itemHeight)+overscan),visibleItems=[];for(let i=startIndex;i<endIndex;i++){const data=items[i];if(data===void 0&&!(i in items))continue;visibleItems.push({data,index:i})}list.value=visibleItems;wrapperProps.value={style:{width:"100%",height:`${totalHeight-startIndex*itemHeight}px`,marginTop:`${startIndex*itemHeight}px`}}}const onScroll=(e)=>{const target=e.target;scrollTop.value=target.scrollTop;containerHeight.value=target.clientHeight;update()};update();if(typeof source==="object"&&source&&"value"in source&&"subscribe"in source)watch(source,()=>update());function scrollTo(index){scrollTop.value=index*itemHeight;update()}return{list,containerProps:{onScroll,style:{overflow:"auto",position:"relative"}},wrapperProps,scrollTo}}
+import{ref,watch}from"@stacksjs/stx";import{unref}from"./_shared";export function useVirtualList(source,options){const{itemHeight,overscan=5}=options;const list=ref([]);const containerHeight=ref(0);const scrollTop=ref(0);const wrapperProps=ref({style:{width:"100%",height:"0px",marginTop:"0px"}});function getItems(){return unref(source)}function update(){const items=getItems();const totalHeight=items.length*itemHeight;const startIndex=Math.max(0,Math.floor(scrollTop.value/itemHeight)-overscan);const endIndex=Math.min(items.length,Math.ceil((scrollTop.value+containerHeight.value)/itemHeight)+overscan);const visibleItems=[];for(let i=startIndex;i<endIndex;i++){const data=items[i];if(data===undefined&&!(i in items))continue;visibleItems.push({data,index:i})}list.value=visibleItems;wrapperProps.value={style:{width:"100%",height:`${totalHeight-startIndex*itemHeight}px`,marginTop:`${startIndex*itemHeight}px`}}}const onScroll=(e)=>{const target=e.target;scrollTop.value=target.scrollTop;containerHeight.value=target.clientHeight;update()};update();if(typeof source==="object"&&source&&"value"in source&&"subscribe"in source){watch(source,()=>update())}function scrollTo(index){scrollTop.value=index*itemHeight;update()}return{list,containerProps:{onScroll,style:{overflow:"auto",position:"relative"}},wrapperProps,scrollTo}}

package/dist/useWakeLock.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";export function useWakeLock(){const isSupported=ref(typeof navigator<"u"&&"wakeLock"in navigator),isActive=ref(!1);let sentinel=null;async function request(){if(!isSupported.value)return;try{sentinel=await navigator.wakeLock.request("screen");isActive.value=!0;sentinel.addEventListener("release",()=>{isActive.value=!1;sentinel=null})}catch{isActive.value=!1}}async function release(){if(sentinel){await sentinel.release();sentinel=null;isActive.value=!1}}try{onUnmounted(()=>{release()})}catch{}return{isSupported,isActive,request,release}}
+import{onUnmounted,ref}from"@stacksjs/stx";export function useWakeLock(){const isSupported=ref(typeof navigator!=="undefined"&&"wakeLock"in navigator);const isActive=ref(false);let sentinel=null;async function request(){if(!isSupported.value)return;try{sentinel=await navigator.wakeLock.request("screen");isActive.value=true;sentinel.addEventListener("release",()=>{isActive.value=false;sentinel=null})}catch{isActive.value=false}}async function release(){if(sentinel){await sentinel.release();sentinel=null;isActive.value=false}}try{onUnmounted(()=>{release()})}catch{}return{isSupported,isActive,request,release}}

package/dist/useWebNotification.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";export function useWebNotification(options={}){const isSupported=ref(typeof Notification<"u"),notification=ref(null),permissionGranted=ref(isSupported.value&&Notification.permission==="granted"),onClick=ref(null),onShow=ref(null),onError=ref(null),onClose=ref(null);async function show(overrideOptions){if(!isSupported.value)return;if(Notification.permission!=="granted"){const result=await Notification.requestPermission();permissionGranted.value=result==="granted";if(!permissionGranted.value)return}const opts={...options,...overrideOptions},title=opts.title??"",n=new Notification(title,{body:opts.body,icon:opts.icon,dir:opts.dir,lang:opts.lang,tag:opts.tag,requireInteraction:opts.requireInteraction});notification.value=n;n.onclick=(e)=>onClick.value?.(e);n.onshow=(e)=>onShow.value?.(e);n.onerror=(e)=>onError.value?.(e);n.onclose=(e)=>{onClose.value?.(e);notification.value=null};return n}function close(){notification.value?.close();notification.value=null}try{onUnmounted(()=>close())}catch{}return{isSupported,notification,permissionGranted,show,close,onClick,onShow,onError,onClose}}
+import{onUnmounted,ref}from"@stacksjs/stx";export function useWebNotification(options={}){const isSupported=ref(typeof Notification!=="undefined");const notification=ref(null);const permissionGranted=ref(isSupported.value&&Notification.permission==="granted");const onClick=ref(null);const onShow=ref(null);const onError=ref(null);const onClose=ref(null);async function show(overrideOptions){if(!isSupported.value)return;if(Notification.permission!=="granted"){const result=await Notification.requestPermission();permissionGranted.value=result==="granted";if(!permissionGranted.value)return}const opts={...options,...overrideOptions};const title=opts.title??"";const n=new Notification(title,{body:opts.body,icon:opts.icon,dir:opts.dir,lang:opts.lang,tag:opts.tag,requireInteraction:opts.requireInteraction});notification.value=n;n.onclick=(e)=>onClick.value?.(e);n.onshow=(e)=>onShow.value?.(e);n.onerror=(e)=>onError.value?.(e);n.onclose=(e)=>{onClose.value?.(e);notification.value=null};return n}function close(){notification.value?.close();notification.value=null}try{onUnmounted(()=>close())}catch{}return{isSupported,notification,permissionGranted,show,close,onClick,onShow,onError,onClose}}

package/dist/useWebSocket.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";import{toValue}from"./_shared";export function useWebSocket(url,options={}){const{onConnected,onDisconnected,onError,onMessage,immediate=!0,autoReconnect=!1,heartbeat=!1,protocols}=options,data=ref(null),status=ref("CLOSED"),wsRef=ref(null);let retryCount=0,retryTimer=null,heartbeatTimer=null,explicitlyClosed=!1;const heartbeatInterval=typeof heartbeat==="object"?heartbeat.interval??30000:30000,heartbeatMessage=typeof heartbeat==="object"?heartbeat.message??"ping":"ping",maxRetries=typeof autoReconnect==="object"?autoReconnect.retries??3:autoReconnect?1/0:0,retryDelay=typeof autoReconnect==="object"?autoReconnect.delay??1000:1000;function startHeartbeat(ws){stopHeartbeat();if(!heartbeat)return;heartbeatTimer=setInterval(()=>{if(ws.readyState===WebSocket.OPEN)ws.send(heartbeatMessage)},heartbeatInterval)}function stopHeartbeat(){if(heartbeatTimer!==null){clearInterval(heartbeatTimer);heartbeatTimer=null}}function open(){if(typeof WebSocket>"u")return;close();explicitlyClosed=!1;retryCount=0;const resolvedUrl=toValue(url);status.value="CONNECTING";const ws=protocols?new WebSocket(resolvedUrl,protocols):new WebSocket(resolvedUrl);wsRef.value=ws;ws.onopen=()=>{status.value="OPEN";retryCount=0;startHeartbeat(ws);onConnected?.(ws)};ws.onclose=(event)=>{status.value="CLOSED";wsRef.value=null;stopHeartbeat();onDisconnected?.(ws,event);if(!explicitlyClosed&&autoReconnect&&retryCount<maxRetries){retryCount++;retryTimer=setTimeout(()=>{open()},retryDelay)}};ws.onerror=(event)=>{onError?.(ws,event)};ws.onmessage=(event)=>{data.value=typeof event.data==="string"?event.data:String(event.data);onMessage?.(ws,event)}}function close(code,reason){explicitlyClosed=!0;stopHeartbeat();if(retryTimer!==null){clearTimeout(retryTimer);retryTimer=null}const ws=wsRef.value;if(ws){if(ws.readyState===WebSocket.OPEN||ws.readyState===WebSocket.CONNECTING){status.value="CLOSING";ws.close(code,reason)}wsRef.value=null}}function send(sendData){const ws=wsRef.value;if(ws&&ws.readyState===WebSocket.OPEN)ws.send(sendData)}if(immediate)open();try{onUnmounted(()=>{close()})}catch{}return{data,status,ws:wsRef,open,close,send}}
+import{onUnmounted,ref}from"@stacksjs/stx";import{toValue}from"./_shared";export function useWebSocket(url,options={}){const{onConnected,onDisconnected,onError,onMessage,immediate=true,autoReconnect=false,heartbeat=false,protocols}=options;const data=ref(null);const status=ref("CLOSED");const wsRef=ref(null);let retryCount=0;let retryTimer=null;let heartbeatTimer=null;let explicitlyClosed=false;const heartbeatInterval=typeof heartbeat==="object"?heartbeat.interval??30000:30000;const heartbeatMessage=typeof heartbeat==="object"?heartbeat.message??"ping":"ping";const maxRetries=typeof autoReconnect==="object"?autoReconnect.retries??3:autoReconnect?1/0:0;const retryDelay=typeof autoReconnect==="object"?autoReconnect.delay??1000:1000;function startHeartbeat(ws){stopHeartbeat();if(!heartbeat)return;heartbeatTimer=setInterval(()=>{if(ws.readyState===WebSocket.OPEN){ws.send(heartbeatMessage)}},heartbeatInterval)}function stopHeartbeat(){if(heartbeatTimer!==null){clearInterval(heartbeatTimer);heartbeatTimer=null}}function open(){if(typeof WebSocket==="undefined")return;close();explicitlyClosed=false;retryCount=0;const resolvedUrl=toValue(url);status.value="CONNECTING";const ws=protocols?new WebSocket(resolvedUrl,protocols):new WebSocket(resolvedUrl);wsRef.value=ws;ws.onopen=()=>{status.value="OPEN";retryCount=0;startHeartbeat(ws);onConnected?.(ws)};ws.onclose=(event)=>{status.value="CLOSED";wsRef.value=null;stopHeartbeat();onDisconnected?.(ws,event);if(!explicitlyClosed&&autoReconnect&&retryCount<maxRetries){retryCount++;retryTimer=setTimeout(()=>{open()},retryDelay)}};ws.onerror=(event)=>{onError?.(ws,event)};ws.onmessage=(event)=>{data.value=typeof event.data==="string"?event.data:String(event.data);onMessage?.(ws,event)}}function close(code,reason){explicitlyClosed=true;stopHeartbeat();if(retryTimer!==null){clearTimeout(retryTimer);retryTimer=null}const ws=wsRef.value;if(ws){if(ws.readyState===WebSocket.OPEN||ws.readyState===WebSocket.CONNECTING){status.value="CLOSING";ws.close(code,reason)}wsRef.value=null}}function send(sendData){const ws=wsRef.value;if(ws&&ws.readyState===WebSocket.OPEN){ws.send(sendData)}}if(immediate){open()}try{onUnmounted(()=>{close()})}catch{}return{data,status,ws:wsRef,open,close,send}}

package/dist/useWebWorker.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";export function useWebWorker(url,workerOptions){const data=ref(null),worker=ref(void 0);if(typeof Worker<"u"){const w=new Worker(url,workerOptions);worker.value=w;w.onmessage=(e)=>{data.value=e.data};try{onUnmounted(()=>w.terminate())}catch{}}function post(message){worker.value?.postMessage(message)}function terminate(){worker.value?.terminate();worker.value=void 0}return{data,post,terminate,worker}}export function useWebWorkerFn(fn){let worker;function createWorker(){const blob=new Blob([`self.onmessage = function(e) { self.postMessage((${fn.toString()})(...e.data)); }`],{type:"text/javascript"}),url=URL.createObjectURL(blob);return new Worker(url)}function workerFn(...args){return new Promise((resolve,reject)=>{if(typeof Worker>"u"){try{resolve(fn(...args))}catch(e){reject(e)}return}worker=createWorker();worker.onmessage=(e)=>{resolve(e.data);worker?.terminate()};worker.onerror=(e)=>{reject(e);worker?.terminate()};worker.postMessage(args)})}function terminate(){worker?.terminate();worker=void 0}return{workerFn,terminate}}
+import{onUnmounted,ref}from"@stacksjs/stx";export function useWebWorker(url,workerOptions){const data=ref(null);const worker=ref(undefined);if(typeof Worker!=="undefined"){const w=new Worker(url,workerOptions);worker.value=w;w.onmessage=(e)=>{data.value=e.data};try{onUnmounted(()=>w.terminate())}catch{}}function post(message){worker.value?.postMessage(message)}function terminate(){worker.value?.terminate();worker.value=undefined}return{data,post,terminate,worker}}export function useWebWorkerFn(fn){let worker;function createWorker(){const blob=new Blob([`self.onmessage = function(e) { self.postMessage((${fn.toString()})(...e.data)); }`],{type:"text/javascript"});const url=URL.createObjectURL(blob);return new Worker(url)}function workerFn(...args){return new Promise((resolve,reject)=>{if(typeof Worker==="undefined"){try{resolve(fn(...args))}catch(e){reject(e)}return}worker=createWorker();worker.onmessage=(e)=>{resolve(e.data);worker?.terminate()};worker.onerror=(e)=>{reject(e);worker?.terminate()};worker.postMessage(args)})}function terminate(){worker?.terminate();worker=undefined}return{workerFn,terminate}}

package/dist/useWindowFocus.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";export function useWindowFocus(){const focused=ref(typeof document<"u"?document.hasFocus():!1);if(typeof window>"u")return focused;const onFocus=()=>{focused.value=!0},onBlur=()=>{focused.value=!1};window.addEventListener("focus",onFocus,{passive:!0});window.addEventListener("blur",onBlur,{passive:!0});try{onUnmounted(()=>{window.removeEventListener("focus",onFocus);window.removeEventListener("blur",onBlur)})}catch{}return focused}
+import{onUnmounted,ref}from"@stacksjs/stx";export function useWindowFocus(){const focused=ref(typeof document!=="undefined"?document.hasFocus():false);if(typeof window==="undefined")return focused;const onFocus=()=>{focused.value=true};const onBlur=()=>{focused.value=false};window.addEventListener("focus",onFocus,{passive:true});window.addEventListener("blur",onBlur,{passive:true});try{onUnmounted(()=>{window.removeEventListener("focus",onFocus);window.removeEventListener("blur",onBlur)})}catch{}return focused}

package/dist/useWindowScroll.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";export function useWindowScroll(){const x=ref(typeof window<"u"?window.scrollX:0),y=ref(typeof window<"u"?window.scrollY:0);if(typeof window>"u")return{x,y};const handler=()=>{x.value=window.scrollX;y.value=window.scrollY};window.addEventListener("scroll",handler,{passive:!0});try{onUnmounted(()=>{window.removeEventListener("scroll",handler)})}catch{}return{x,y}}
+import{onUnmounted,ref}from"@stacksjs/stx";export function useWindowScroll(){const x=ref(typeof window!=="undefined"?window.scrollX:0);const y=ref(typeof window!=="undefined"?window.scrollY:0);if(typeof window==="undefined")return{x,y};const handler=()=>{x.value=window.scrollX;y.value=window.scrollY};window.addEventListener("scroll",handler,{passive:true});try{onUnmounted(()=>{window.removeEventListener("scroll",handler)})}catch{}return{x,y}}

package/dist/useWindowSize.js

@@ -1 +1 @@
-import{onUnmounted,ref}from"@stacksjs/stx";import{defaultWindow}from"./_shared";export function useWindowSize(options){const{initialWidth=0,initialHeight=0,listenOrientation=!0}=options??{},win=defaultWindow(),width=ref(win?win.innerWidth:initialWidth),height=ref(win?win.innerHeight:initialHeight);function update(){if(win){width.value=win.innerWidth;height.value=win.innerHeight}}if(win){win.addEventListener("resize",update);if(listenOrientation)win.addEventListener("orientationchange",update);try{onUnmounted(()=>{win.removeEventListener("resize",update);if(listenOrientation)win.removeEventListener("orientationchange",update)})}catch{}}return{width,height}}
+import{onUnmounted,ref}from"@stacksjs/stx";import{defaultWindow}from"./_shared";export function useWindowSize(options){const{initialWidth=0,initialHeight=0,listenOrientation=true}=options??{};const win=defaultWindow();const width=ref(win?win.innerWidth:initialWidth);const height=ref(win?win.innerHeight:initialHeight);function update(){if(win){width.value=win.innerWidth;height.value=win.innerHeight}}if(win){win.addEventListener("resize",update);if(listenOrientation){win.addEventListener("orientationchange",update)}try{onUnmounted(()=>{win.removeEventListener("resize",update);if(listenOrientation){win.removeEventListener("orientationchange",update)}})}catch{}}return{width,height}}

package/dist/watchArray.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchArray(source,callback){let oldList=[...source.value];return watch(source,(newValue)=>{const newList=[...newValue],added=newList.filter((item)=>!oldList.includes(item)),removed=oldList.filter((item)=>!newList.includes(item));callback(newList,oldList,added,removed);oldList=newList})}
+import{watch}from"@stacksjs/stx";export function watchArray(source,callback){let oldList=[...source.value];const unwatch=watch(source,(newValue)=>{const newList=[...newValue];const added=newList.filter((item)=>!oldList.includes(item));const removed=oldList.filter((item)=>!newList.includes(item));callback(newList,oldList,added,removed);oldList=newList});return unwatch}

package/dist/watchAtMost.js

@@ -1 +1 @@
-import{ref,watch}from"@stacksjs/stx";export function watchAtMost(source,callback,count){const remaining=ref(count),unwatch=watch(source,(newValue)=>{if(remaining.value>0){remaining.value--;callback(newValue);if(remaining.value<=0)unwatch()}});return{stop:unwatch,remaining}}
+import{ref,watch}from"@stacksjs/stx";export function watchAtMost(source,callback,count){const remaining=ref(count);const unwatch=watch(source,(newValue)=>{if(remaining.value>0){remaining.value--;callback(newValue);if(remaining.value<=0)unwatch()}});return{stop:unwatch,remaining}}

package/dist/watchDebounced.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchDebounced(source,callback,options){const delay=options?.debounce??200;let timeoutId=null;const unwatch=watch(source,(newValue)=>{if(timeoutId!==null)clearTimeout(timeoutId);timeoutId=setTimeout(()=>{timeoutId=null;callback(newValue)},delay)});return()=>{if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}unwatch()}}
+import{watch}from"@stacksjs/stx";export function watchDebounced(source,callback,options){const delay=options?.debounce??200;let timeoutId=null;const unwatch=watch(source,(newValue)=>{if(timeoutId!==null){clearTimeout(timeoutId)}timeoutId=setTimeout(()=>{timeoutId=null;callback(newValue)},delay)});return()=>{if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}unwatch()}}

package/dist/watchDeep.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchDeep(source,callback,options){let prev=JSON.stringify(source.value);if(options?.immediate)callback(source.value);return watch(source,(newValue)=>{const next=JSON.stringify(newValue);if(next!==prev){prev=next;callback(newValue)}})}
+import{watch}from"@stacksjs/stx";export function watchDeep(source,callback,options){let prev=JSON.stringify(source.value);if(options?.immediate)callback(source.value);const unwatch=watch(source,(newValue)=>{const next=JSON.stringify(newValue);if(next!==prev){prev=next;callback(newValue)}});return unwatch}

package/dist/watchIgnorable.js

@@ -1 +1 @@
-import{ref,watch}from"@stacksjs/stx";export function watchIgnorable(source,callback){const isIgnoring=ref(!1);let lastValue;const unwatch=watch(source,(newValue)=>{if(!isIgnoring.value)callback(newValue,lastValue);lastValue=newValue});function ignoreUpdates(updater){isIgnoring.value=!0;updater();Promise.resolve().then(()=>{isIgnoring.value=!1})}return{stop:unwatch,ignoreUpdates,isIgnoring}}export const ignorableWatch=watchIgnorable;
+import{ref,watch}from"@stacksjs/stx";export function watchIgnorable(source,callback){const isIgnoring=ref(false);let lastValue;const unwatch=watch(source,(newValue)=>{if(!isIgnoring.value)callback(newValue,lastValue);lastValue=newValue});function ignoreUpdates(updater){isIgnoring.value=true;updater();Promise.resolve().then(()=>{isIgnoring.value=false})}return{stop:unwatch,ignoreUpdates,isIgnoring}}export const ignorableWatch=watchIgnorable;

package/dist/watchOnce.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchOnce(source,callback){let stopped=!1;const unwatch=watch(source,(newValue)=>{if(stopped)return;stopped=!0;unwatch();callback(newValue)});return()=>{if(!stopped){stopped=!0;unwatch()}}}
+import{watch}from"@stacksjs/stx";export function watchOnce(source,callback){let stopped=false;const unwatch=watch(source,(newValue)=>{if(stopped)return;stopped=true;unwatch();callback(newValue)});return()=>{if(!stopped){stopped=true;unwatch()}}}

package/dist/watchPausable.js

@@ -1 +1 @@
-import{ref,watch}from"@stacksjs/stx";export function watchPausable(source,callback){const isActive=ref(!0);let lastValue;const unwatch=watch(source,(newValue)=>{if(isActive.value)callback(newValue,lastValue);lastValue=newValue});function pause(){isActive.value=!1}function resume(){isActive.value=!0}return{stop:unwatch,pause,resume,isActive}}export const pausableWatch=watchPausable;
+import{ref,watch}from"@stacksjs/stx";export function watchPausable(source,callback){const isActive=ref(true);let lastValue;const unwatch=watch(source,(newValue)=>{if(isActive.value){callback(newValue,lastValue)}lastValue=newValue});function pause(){isActive.value=false}function resume(){isActive.value=true}return{stop:unwatch,pause,resume,isActive}}export const pausableWatch=watchPausable;

package/dist/watchThrottled.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchThrottled(source,callback,options){const interval=options?.throttle??200;let lastExec=0,timeoutId=null,latestValue,hasPending=!1;const unwatch=watch(source,(newValue)=>{const now=Date.now(),elapsed=now-lastExec;if(elapsed>=interval){lastExec=now;if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}hasPending=!1;callback(newValue)}else{latestValue=newValue;hasPending=!0;if(timeoutId===null)timeoutId=setTimeout(()=>{lastExec=Date.now();timeoutId=null;if(hasPending){hasPending=!1;callback(latestValue)}},interval-elapsed)}});return()=>{if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}hasPending=!1;unwatch()}}
+import{watch}from"@stacksjs/stx";export function watchThrottled(source,callback,options){const interval=options?.throttle??200;let lastExec=0;let timeoutId=null;let latestValue;let hasPending=false;const unwatch=watch(source,(newValue)=>{const now=Date.now();const elapsed=now-lastExec;if(elapsed>=interval){lastExec=now;if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}hasPending=false;callback(newValue)}else{latestValue=newValue;hasPending=true;if(timeoutId===null){timeoutId=setTimeout(()=>{lastExec=Date.now();timeoutId=null;if(hasPending){hasPending=false;callback(latestValue)}},interval-elapsed)}}});return()=>{if(timeoutId!==null){clearTimeout(timeoutId);timeoutId=null}hasPending=false;unwatch()}}

package/dist/watchWithFilter.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function watchWithFilter(source,callback,eventFilter){return watch(source,(newValue)=>{eventFilter(()=>callback(newValue))})}
+import{watch}from"@stacksjs/stx";export function watchWithFilter(source,callback,eventFilter){const unwatch=watch(source,(newValue)=>{eventFilter(()=>callback(newValue))});return unwatch}

package/dist/whenever.js

@@ -1 +1 @@
-import{watch}from"@stacksjs/stx";export function whenever(source,callback){return watch(source,(newValue)=>{if(newValue)callback(newValue)})}
+import{watch}from"@stacksjs/stx";export function whenever(source,callback){const unwatch=watch(source,(newValue)=>{if(newValue){callback(newValue)}});return unwatch}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/composables",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.515",
+  "version": "0.75.518",
   "description": "Stacks composables powered by stx reactivity.",
   "author": "Chris Breuer",
   "contributors": [
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@stacksjs/stx": "0.2.807",
-    "@stacksjs/datetime": "0.75.515"
+    "@stacksjs/datetime": "0.75.518"
   },
   "devDependencies": {
     "better-dx": "^0.2.24"