@reactive-vscode/vueuse 0.3.1 → 0.3.3

package/dist/index.js

@@ -1,14 +1,14 @@
-import { shallowRef, watch, customRef, getCurrentScope, onScopeDispose, effectScope, isRef, unref, toValue as toValue$1, computed, reactive, toRefs as toRefs$1, readonly, toRef as toRef$1, ref, nextTick, isReactive, watchEffect, isReadonly, markRaw } from "@reactive-vscode/reactivity";
-function computedWithControl(source, fn) {
+import { toValue as toValue$1, customRef, watch, effectScope, unref, computed, ref, shallowReadonly, isRef, readonly, toRefs as toRefs$1, toRef as toRef$1, reactive, getCurrentScope, onScopeDispose, shallowRef, nextTick, isReactive, watchEffect, isReadonly, markRaw } from "@reactive-vscode/reactivity";
+function computedWithControl(source, fn, options = {}) {
   let v = void 0;
   let track;
   let trigger;
-  const dirty = shallowRef(true);
+  let dirty = true;
   const update = () => {
-    dirty.value = true;
+    dirty = true;
     trigger();
   };
-  watch(source, update, { flush: "sync" });
+  watch(source, update, { flush: "sync", ...options });
   const get2 = typeof fn === "function" ? fn : fn.get;
   const set2 = typeof fn === "function" ? void 0 : fn.set;
   const result = customRef((_track, _trigger) => {
@@ -16,9 +16,9 @@ function computedWithControl(source, fn) {
     trigger = _trigger;
     return {
       get() {
-        if (dirty.value) {
+        if (dirty) {
           v = get2(v);
-          dirty.value = false;
+          dirty = false;
         }
         track();
         return v;
@@ -28,8 +28,7 @@ function computedWithControl(source, fn) {
       }
     };
   });
-  if (Object.isExtensible(result))
-    result.trigger = update;
+  result.trigger = update;
   return result;
 }
 function tryOnScopeDispose(fn) {
@@ -39,6 +38,7 @@ function tryOnScopeDispose(fn) {
   }
   return false;
 }
+// @__NO_SIDE_EFFECTS__
 function createEventHook() {
   const fns = /* @__PURE__ */ new Set();
   const off = (fn) => {
@@ -65,6 +65,7 @@ function createEventHook() {
     clear
   };
 }
+// @__NO_SIDE_EFFECTS__
 function createGlobalState(stateFactory) {
   let initialized = false;
   let state;
@@ -77,6 +78,7 @@ function createGlobalState(stateFactory) {
     return state;
   };
 }
+// @__NO_SIDE_EFFECTS__
 function createRef(value, deep) {
   if (deep === true) {
     return ref(value);
@@ -84,6 +86,7 @@ function createRef(value, deep) {
     return shallowRef(value);
   }
 }
+// @__NO_SIDE_EFFECTS__
 function createSharedComposable(composable) {
   let subscribers = 0;
   let state;
@@ -134,6 +137,7 @@ function get(obj, key) {
 function isDefined(v) {
   return unref(v) != null;
 }
+// @__NO_SIDE_EFFECTS__
 function makeDestructurable(obj, arr) {
   if (typeof Symbol !== "undefined") {
     const clone = { ...obj };
@@ -154,12 +158,14 @@ function makeDestructurable(obj, arr) {
     return Object.assign([...arr], obj);
   }
 }
+// @__NO_SIDE_EFFECTS__
 function reactify(fn, options) {
   const unrefFn = (options == null ? void 0 : options.computedGetter) === false ? unref : toValue$1;
   return function(...args) {
     return computed(() => fn.apply(this, args.map((i) => unrefFn(i))));
   };
 }
+// @__NO_SIDE_EFFECTS__
 function reactifyObject(obj, optionsOrKeys = {}) {
   let keys = [];
   let options;
@@ -177,7 +183,7 @@ function reactifyObject(obj, optionsOrKeys = {}) {
       const value = obj[key];
       return [
         key,
-        typeof value === "function" ? reactify(value.bind(obj), options) : value
+        typeof value === "function" ? /* @__PURE__ */ reactify(value.bind(obj), options) : value
       ];
     })
   );
@@ -243,6 +249,43 @@ const rand = (min, max) => {
   return Math.floor(Math.random() * (max - min + 1)) + min;
 };
 const hasOwn = (val, key) => Object.prototype.hasOwnProperty.call(val, key);
+function toRef(...args) {
+  if (args.length !== 1)
+    return toRef$1(...args);
+  const r = args[0];
+  return typeof r === "function" ? readonly(customRef(() => ({ get: r, set: noop }))) : ref(r);
+}
+const resolveRef = toRef;
+function reactivePick(obj, ...keys) {
+  const flatKeys = keys.flat();
+  const predicate = flatKeys[0];
+  return reactiveComputed(() => typeof predicate === "function" ? Object.fromEntries(Object.entries(toRefs$1(obj)).filter(([k, v]) => predicate(toValue$1(v), k))) : Object.fromEntries(flatKeys.map((k) => [k, toRef(obj, k)])));
+}
+function refAutoReset(defaultValue, afterMs = 1e4) {
+  return customRef((track, trigger) => {
+    let value = toValue$1(defaultValue);
+    let timer;
+    const resetAfter = () => setTimeout(() => {
+      value = toValue$1(defaultValue);
+      trigger();
+    }, toValue$1(afterMs));
+    tryOnScopeDispose(() => {
+      clearTimeout(timer);
+    });
+    return {
+      get() {
+        track();
+        return value;
+      },
+      set(newValue) {
+        value = newValue;
+        trigger();
+        clearTimeout(timer);
+        timer = resetAfter();
+      }
+    };
+  });
+}
 function createFilterWrapper(filter, fn) {
   function wrapper(...args) {
     return new Promise((resolve, reject) => {
@@ -272,7 +315,7 @@ function debounceFilter(ms, options = {}) {
     if (duration <= 0 || maxDuration !== void 0 && maxDuration <= 0) {
       if (maxTimer) {
         _clearTimeout(maxTimer);
-        maxTimer = null;
+        maxTimer = void 0;
       }
       return Promise.resolve(invoke2());
     }
@@ -283,14 +326,14 @@ function debounceFilter(ms, options = {}) {
         maxTimer = setTimeout(() => {
           if (timer)
             _clearTimeout(timer);
-          maxTimer = null;
+          maxTimer = void 0;
           resolve(lastInvoker());
         }, maxDuration);
       }
       timer = setTimeout(() => {
         if (maxTimer)
           _clearTimeout(maxTimer);
-        maxTimer = null;
+        maxTimer = void 0;
         resolve(invoke2());
       }, duration);
     });
@@ -368,19 +411,6 @@ function pausableFilter(extendFilter = bypassFilter, options = {}) {
   };
   return { isActive: readonly(isActive), pause, resume, eventFilter };
 }
-function cacheStringFunction(fn) {
-  const cache = /* @__PURE__ */ Object.create(null);
-  return (str) => {
-    const hit = cache[str];
-    return hit || (cache[str] = fn(str));
-  };
-}
-const hyphenateRE = /\B([A-Z])/g;
-const hyphenate = cacheStringFunction((str) => str.replace(hyphenateRE, "-$1").toLowerCase());
-const camelizeRE = /-(\w)/g;
-const camelize = cacheStringFunction((str) => {
-  return str.replace(camelizeRE, (_, c) => c ? c.toUpperCase() : "");
-});
 function promiseTimeout(ms, throwOnTimeout = false, reason = "Timeout") {
   return new Promise((resolve, reject) => {
     if (throwOnTimeout)
@@ -441,49 +471,26 @@ function objectOmit(obj, keys, omitUndefined = false) {
 function objectEntries(obj) {
   return Object.entries(obj);
 }
-function getLifeCycleTarget(target) {
-  return target || null;
-}
 function toArray(value) {
   return Array.isArray(value) ? value : [value];
 }
-function toRef(...args) {
-  if (args.length !== 1)
-    return toRef$1(...args);
-  const r = args[0];
-  return typeof r === "function" ? readonly(customRef(() => ({ get: r, set: noop }))) : ref(r);
-}
-const resolveRef = toRef;
-function reactivePick(obj, ...keys) {
-  const flatKeys = keys.flat();
-  const predicate = flatKeys[0];
-  return reactiveComputed(() => typeof predicate === "function" ? Object.fromEntries(Object.entries(toRefs$1(obj)).filter(([k, v]) => predicate(toValue$1(v), k))) : Object.fromEntries(flatKeys.map((k) => [k, toRef(obj, k)])));
+function cacheStringFunction(fn) {
+  const cache = /* @__PURE__ */ Object.create(null);
+  return (str) => {
+    const hit = cache[str];
+    return hit || (cache[str] = fn(str));
+  };
 }
-function refAutoReset(defaultValue, afterMs = 1e4) {
-  return customRef((track, trigger) => {
-    let value = toValue$1(defaultValue);
-    let timer;
-    const resetAfter = () => setTimeout(() => {
-      value = toValue$1(defaultValue);
-      trigger();
-    }, toValue$1(afterMs));
-    tryOnScopeDispose(() => {
-      clearTimeout(timer);
-    });
-    return {
-      get() {
-        track();
-        return value;
-      },
-      set(newValue) {
-        value = newValue;
-        trigger();
-        clearTimeout(timer);
-        timer = resetAfter();
-      }
-    };
-  });
+const hyphenateRE = /\B([A-Z])/g;
+const hyphenate = cacheStringFunction((str) => str.replace(hyphenateRE, "-$1").toLowerCase());
+const camelizeRE = /-(\w)/g;
+const camelize = cacheStringFunction((str) => {
+  return str.replace(camelizeRE, (_, c) => c ? c.toUpperCase() : "");
+});
+function getLifeCycleTarget(target) {
+  return target || null;
 }
+// @__NO_SIDE_EFFECTS__
 function useDebounceFn(fn, ms = 200, options = {}) {
   return createFilterWrapper(
     debounceFilter(ms, options),
@@ -491,13 +498,14 @@ function useDebounceFn(fn, ms = 200, options = {}) {
   );
 }
 function refDebounced(value, ms = 200, options = {}) {
-  const debounced = ref(value.value);
-  const updater = useDebounceFn(() => {
+  const debounced = ref(toValue$1(value));
+  const updater = /* @__PURE__ */ useDebounceFn(() => {
     debounced.value = value.value;
   }, ms, options);
   watch(value, () => updater());
-  return debounced;
+  return shallowReadonly(debounced);
 }
+// @__NO_SIDE_EFFECTS__
 function refDefault(source, defaultValue) {
   return computed({
     get() {
@@ -509,6 +517,7 @@ function refDefault(source, defaultValue) {
     }
   });
 }
+// @__NO_SIDE_EFFECTS__
 function useThrottleFn(fn, ms = 200, trailing = false, leading = true, rejectOnCancel = false) {
   return createFilterWrapper(
     throttleFilter(ms, trailing, leading, rejectOnCancel),
@@ -518,13 +527,14 @@ function useThrottleFn(fn, ms = 200, trailing = false, leading = true, rejectOnC
 function refThrottled(value, delay = 200, trailing = true, leading = true) {
   if (delay <= 0)
     return value;
-  const throttled = ref(value.value);
-  const updater = useThrottleFn(() => {
+  const throttled = ref(toValue$1(value));
+  const updater = /* @__PURE__ */ useThrottleFn(() => {
     throttled.value = value.value;
   }, delay, trailing, leading);
   watch(value, () => updater());
   return throttled;
 }
+// @__NO_SIDE_EFFECTS__
 function refWithControl(initial, options = {}) {
   let source = initial;
   let track;
@@ -701,7 +711,10 @@ function toRefs(objectRef, options = {}) {
 const toValue = toValue$1;
 const resolveUnref = toValue$1;
 function tryOnMounted(fn, sync = true, target) {
-  if (sync)
+  const instance = getLifeCycleTarget(target);
+  if (instance)
+    ;
+  else if (sync)
     fn();
   else
     nextTick(fn);
@@ -833,6 +846,7 @@ function until(r) {
 function defaultComparator(value, othVal) {
   return value === othVal;
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayDifference(...args) {
   var _a, _b;
   const list = args[0];
@@ -853,17 +867,21 @@ function useArrayDifference(...args) {
     return diff1;
   }
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayEvery(list, fn) {
   return computed(() => toValue$1(list).every((element, index, array) => fn(toValue$1(element), index, array)));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayFilter(list, fn) {
   return computed(() => toValue$1(list).map((i) => toValue$1(i)).filter(fn));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayFind(list, fn) {
   return computed(() => toValue$1(
     toValue$1(list).find((element, index, array) => fn(toValue$1(element), index, array))
   ));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayFindIndex(list, fn) {
   return computed(() => toValue$1(list).findIndex((element, index, array) => fn(toValue$1(element), index, array)));
 }
@@ -875,6 +893,7 @@ function findLast(arr, cb) {
   }
   return void 0;
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayFindLast(list, fn) {
   return computed(() => toValue$1(
     !Array.prototype.findLast ? findLast(toValue$1(list), (element, index, array) => fn(toValue$1(element), index, array)) : toValue$1(list).findLast((element, index, array) => fn(toValue$1(element), index, array))
@@ -883,6 +902,7 @@ function useArrayFindLast(list, fn) {
 function isArrayIncludesOptions(obj) {
   return isObject(obj) && containsProp(obj, "formIndex", "comparator");
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayIncludes(...args) {
   var _a;
   const list = args[0];
@@ -905,12 +925,15 @@ function useArrayIncludes(...args) {
     toValue$1(array)
   )));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayJoin(list, separator) {
   return computed(() => toValue$1(list).map((i) => toValue$1(i)).join(toValue$1(separator)));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayMap(list, fn) {
   return computed(() => toValue$1(list).map((i) => toValue$1(i)).map(fn));
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayReduce(list, reducer, ...args) {
   const reduceCallback = (sum, value, index) => reducer(toValue$1(sum), toValue$1(value), index);
   return computed(() => {
@@ -918,6 +941,7 @@ function useArrayReduce(list, reducer, ...args) {
     return args.length ? resolved.reduce(reduceCallback, typeof args[0] === "function" ? toValue$1(args[0]()) : toValue$1(args[0])) : resolved.reduce(reduceCallback);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function useArraySome(list, fn) {
   return computed(() => toValue$1(list).some((element, index, array) => fn(toValue$1(element), index, array)));
 }
@@ -931,6 +955,7 @@ function uniqueElementsBy(array, fn) {
     return acc;
   }, []);
 }
+// @__NO_SIDE_EFFECTS__
 function useArrayUnique(list, compareFn) {
   return computed(() => {
     const resolvedList = toValue$1(list).map((element) => toValue$1(element));
@@ -952,7 +977,7 @@ function useCounter(initialValue = 0, options = {}) {
     _initialValue = val;
     return set2(val);
   };
-  return { count, inc, dec, get: get2, set: set2, reset };
+  return { count: shallowReadonly(count), inc, dec, get: get2, set: set2, reset };
 }
 const REGEX_PARSE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[T\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/i;
 const REGEX_FORMAT = /[YMDHhms]o|\[([^\]]+)\]|Y{1,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a{1,2}|A{1,2}|m{1,2}|s{1,2}|Z{1,2}|z{1,4}|SSS/g;
@@ -1042,6 +1067,7 @@ function normalizeDate(date) {
   }
   return new Date(date);
 }
+// @__NO_SIDE_EFFECTS__
 function useDateFormat(date, formatStr = "HH:mm:ss", options = {}) {
   return computed(() => formatDate(normalizeDate(toValue$1(date)), toValue$1(formatStr), options));
 }
@@ -1084,7 +1110,7 @@ function useIntervalFn(cb, interval = 1e3, options = {}) {
   }
   tryOnScopeDispose(pause);
   return {
-    isActive,
+    isActive: shallowReadonly(isActive),
     pause,
     resume
   };
@@ -1110,12 +1136,12 @@ function useInterval(interval = 1e3, options = {}) {
   );
   if (exposeControls) {
     return {
-      counter,
+      counter: shallowReadonly(counter),
       reset,
       ...controls
     };
   } else {
-    return counter;
+    return shallowReadonly(counter);
   }
 }
 function useLastChanged(source, options = {}) {
@@ -1126,7 +1152,7 @@ function useLastChanged(source, options = {}) {
     () => ms.value = timestamp(),
     options
   );
-  return ms;
+  return shallowReadonly(ms);
 }
 function useTimeoutFn(cb, interval, options = {}) {
   const {
@@ -1134,11 +1160,11 @@ function useTimeoutFn(cb, interval, options = {}) {
     immediateCallback = false
   } = options;
   const isPending = shallowRef(false);
-  let timer = null;
+  let timer;
   function clear() {
     if (timer) {
       clearTimeout(timer);
-      timer = null;
+      timer = void 0;
     }
   }
   function stop() {
@@ -1152,7 +1178,7 @@ function useTimeoutFn(cb, interval, options = {}) {
     isPending.value = true;
     timer = setTimeout(() => {
       isPending.value = false;
-      timer = null;
+      timer = void 0;
       cb(...args);
     }, toValue$1(interval));
   }
@@ -1163,7 +1189,7 @@ function useTimeoutFn(cb, interval, options = {}) {
   }
   tryOnScopeDispose(stop);
   return {
-    isPending: readonly(isPending),
+    isPending: shallowReadonly(isPending),
     start,
     stop
   };
@@ -1188,6 +1214,7 @@ function useTimeout(interval = 1e3, options = {}) {
     return ready;
   }
 }
+// @__NO_SIDE_EFFECTS__
 function useToNumber(value, options = {}) {
   const {
     method = "parseFloat",
@@ -1205,9 +1232,11 @@ function useToNumber(value, options = {}) {
     return resolved;
   });
 }
+// @__NO_SIDE_EFFECTS__
 function useToString(value) {
   return computed(() => `${toValue$1(value)}`);
 }
+// @__NO_SIDE_EFFECTS__
 function useToggle(initialValue = false, options = {}) {
   const {
     truthyValue = true,
@@ -1308,50 +1337,50 @@ function watchIgnorable(source, cb, options = {}) {
   let ignorePrevAsyncUpdates;
   let stop;
   if (watchOptions.flush === "sync") {
-    const ignore = shallowRef(false);
+    let ignore = false;
     ignorePrevAsyncUpdates = () => {
     };
     ignoreUpdates = (updater) => {
-      ignore.value = true;
+      ignore = true;
       updater();
-      ignore.value = false;
+      ignore = false;
     };
     stop = watch(
       source,
       (...args) => {
-        if (!ignore.value)
+        if (!ignore)
           filteredCb(...args);
       },
       watchOptions
     );
   } else {
     const disposables = [];
-    const ignoreCounter = shallowRef(0);
-    const syncCounter = shallowRef(0);
+    let ignoreCounter = 0;
+    let syncCounter = 0;
     ignorePrevAsyncUpdates = () => {
-      ignoreCounter.value = syncCounter.value;
+      ignoreCounter = syncCounter;
     };
     disposables.push(
       watch(
         source,
         () => {
-          syncCounter.value++;
+          syncCounter++;
         },
         { ...watchOptions, flush: "sync" }
       )
     );
     ignoreUpdates = (updater) => {
-      const syncCounterPrev = syncCounter.value;
+      const syncCounterPrev = syncCounter;
       updater();
-      ignoreCounter.value += syncCounter.value - syncCounterPrev;
+      ignoreCounter += syncCounter - syncCounterPrev;
     };
     disposables.push(
       watch(
         source,
         (...args) => {
-          const ignore = ignoreCounter.value > 0 && ignoreCounter.value === syncCounter.value;
-          ignoreCounter.value = 0;
-          syncCounter.value = 0;
+          const ignore = ignoreCounter > 0 && ignoreCounter === syncCounter;
+          ignoreCounter = 0;
+          syncCounter = 0;
           if (ignore)
             return;
           filteredCb(...args);
@@ -1376,11 +1405,14 @@ function watchImmediate(source, cb, options) {
   );
 }
 function watchOnce(source, cb, options) {
-  const stop = watch(source, (...args) => {
-    nextTick(() => stop());
-    return cb(...args);
-  }, options);
-  return stop;
+  return watch(
+    source,
+    cb,
+    {
+      ...options,
+      once: true
+    }
+  );
 }
 function watchThrottled(source, cb, options = {}) {
   const {
@@ -1456,6 +1488,7 @@ function whenever(source, cb, options) {
   return stop;
 }
 function computedAsync(evaluationCallback, initialState, optionsOrRef) {
+  var _a;
   let options;
   if (isRef(optionsOrRef)) {
     options = {
@@ -1466,9 +1499,10 @@ function computedAsync(evaluationCallback, initialState, optionsOrRef) {
   }
   const {
     lazy = false,
+    flush = "pre",
     evaluating = void 0,
     shallow = true,
-    onError = noop
+    onError = (_a = globalThis.reportError) != null ? _a : noop
   } = options;
   const started = shallowRef(!lazy);
   const current = shallow ? shallowRef(initialState) : ref(initialState);
@@ -1502,7 +1536,7 @@ function computedAsync(evaluationCallback, initialState, optionsOrRef) {
         evaluating.value = false;
       hasFinished = true;
     }
-  });
+  }, { flush });
   if (lazy) {
     return computed(() => {
       started.value = true;
@@ -1512,6 +1546,7 @@ function computedAsync(evaluationCallback, initialState, optionsOrRef) {
     return current;
   }
 }
+// @__NO_SIDE_EFFECTS__
 function createUnrefFn(fn) {
   return function(...args) {
     return fn.apply(this, args.map((i) => toValue$1(i)));
@@ -1570,12 +1605,14 @@ function useEventListener(...args) {
   tryOnScopeDispose(cleanup);
   return stop;
 }
+// @__NO_SIDE_EFFECTS__
 function useMounted() {
   const isMounted = shallowRef(false);
   return isMounted;
 }
+// @__NO_SIDE_EFFECTS__
 function useSupported(callback) {
-  const isMounted = useMounted();
+  const isMounted = /* @__PURE__ */ useMounted();
   return computed(() => {
     isMounted.value;
     return Boolean(callback());
@@ -1709,10 +1746,11 @@ function whenAborted(signal) {
   });
 }
 function useAsyncState(promise, initialState, options) {
+  var _a;
   const {
     immediate = true,
     delay = 0,
-    onError = noop,
+    onError = (_a = globalThis.reportError) != null ? _a : noop,
     onSuccess = noop,
     resetOnExecute = true,
     shallow = true,
@@ -1724,7 +1762,7 @@ function useAsyncState(promise, initialState, options) {
   const error = shallowRef(void 0);
   async function execute(delay2 = 0, ...args) {
     if (resetOnExecute)
-      state.value = initialState;
+      state.value = toValue$1(initialState);
     error.value = void 0;
     isReady.value = false;
     isLoading.value = true;
@@ -1754,7 +1792,8 @@ function useAsyncState(promise, initialState, options) {
     isReady,
     isLoading,
     error,
-    execute
+    execute,
+    executeImmediate: (...args) => execute(0, ...args)
   };
   function waitUntilIsLoaded() {
     return new Promise((resolve, reject) => {
@@ -1870,7 +1909,7 @@ function useBroadcastChannel(options) {
     name,
     window: window2 = defaultWindow
   } = options;
-  const isSupported = useSupported(() => window2 && "BroadcastChannel" in window2);
+  const isSupported = /* @__PURE__ */ useSupported(() => window2 && "BroadcastChannel" in window2);
   const isClosed = shallowRef(false);
   const channel = ref();
   const data = ref();
@@ -1917,7 +1956,7 @@ function useBroadcastChannel(options) {
 }
 function useCached(refValue, comparator = (a, b) => a === b, options) {
   const { deepRefs = true, ...watchOptions } = options || {};
-  const cachedValue = createRef(refValue.value, deepRefs);
+  const cachedValue = /* @__PURE__ */ createRef(refValue.value, deepRefs);
   watch(() => refValue.value, (value) => {
     if (!comparator(value, cachedValue.value))
       cachedValue.value = value;
@@ -2093,7 +2132,8 @@ function useRefHistory(source, options = {}) {
   const {
     deep = false,
     flush = "pre",
-    eventFilter
+    eventFilter,
+    shouldCommit = () => true
   } = options;
   const {
     eventFilter: composedFilter,
@@ -2101,6 +2141,7 @@ function useRefHistory(source, options = {}) {
     resume: resumeTracking,
     isActive: isTracking
   } = pausableFilter(eventFilter);
+  let lastRawValue = source.value;
   const {
     ignoreUpdates,
     ignorePrevAsyncUpdates,
@@ -2114,12 +2155,16 @@ function useRefHistory(source, options = {}) {
     ignorePrevAsyncUpdates();
     ignoreUpdates(() => {
       source2.value = value;
+      lastRawValue = value;
     });
   }
   const manualHistory = useManualRefHistory(source, { ...options, clone: options.clone || deep, setSource });
   const { clear, commit: manualCommit } = manualHistory;
   function commit() {
     ignorePrevAsyncUpdates();
+    if (!shouldCommit(lastRawValue, source.value))
+      return;
+    lastRawValue = source.value;
     manualCommit();
   }
   function resume(commitNow) {
@@ -2158,6 +2203,7 @@ function useDebouncedRefHistory(source, options = {}) {
   };
 }
 const events = /* @__PURE__ */ new Map();
+// @__NO_SIDE_EFFECTS__
 function useEventBus(key) {
   const scope = getCurrentScope();
   function on(listener) {
@@ -2279,7 +2325,7 @@ function createFetch(config = {}) {
   return useFactoryFetch;
 }
 function useFetch(url, ...args) {
-  var _a;
+  var _a, _b;
   const supportsAbort = typeof AbortController === "function";
   let fetchOptions = {};
   let options = {
@@ -2304,13 +2350,13 @@ function useFetch(url, ...args) {
       options = { ...options, ...args[1] };
   }
   const {
-    fetch = (_a = defaultWindow) == null ? void 0 : _a.fetch,
+    fetch = (_b = (_a = defaultWindow) == null ? void 0 : _a.fetch) != null ? _b : globalThis == null ? void 0 : globalThis.fetch,
     initialData,
     timeout
   } = options;
-  const responseEvent = createEventHook();
-  const errorEvent = createEventHook();
-  const finallyEvent = createEventHook();
+  const responseEvent = /* @__PURE__ */ createEventHook();
+  const errorEvent = /* @__PURE__ */ createEventHook();
+  const finallyEvent = /* @__PURE__ */ createEventHook();
   const isFinished = shallowRef(false);
   const isFetching = shallowRef(false);
   const aborted = shallowRef(false);
@@ -2321,9 +2367,9 @@ function useFetch(url, ...args) {
   const canAbort = computed(() => supportsAbort && isFetching.value);
   let controller;
   let timer;
-  const abort = () => {
+  const abort = (reason) => {
     if (supportsAbort) {
-      controller == null ? void 0 : controller.abort();
+      controller == null ? void 0 : controller.abort(reason);
       controller = new AbortController();
       controller.signal.onabort = () => aborted.value = true;
       fetchOptions = {
@@ -2340,7 +2386,7 @@ function useFetch(url, ...args) {
     timer = useTimeoutFn(abort, timeout, { immediate: false });
   let executeCounter = 0;
   const execute = async (throwOnFailed = false) => {
-    var _a2, _b;
+    var _a2, _b2;
     abort();
     loading(true);
     error.value = null;
@@ -2389,7 +2435,7 @@ function useFetch(url, ...args) {
         ...context.options,
         headers: {
           ...headersToObject(defaultFetchOptions.headers),
-          ...headersToObject((_b = context.options) == null ? void 0 : _b.headers)
+          ...headersToObject((_b2 = context.options) == null ? void 0 : _b2.headers)
         }
       }
     ).then(async (fetchResponse) => {
@@ -2574,7 +2620,8 @@ function useIdle(timeout = oneMinute, options = {}) {
           onEvent();
       }, listenerOptions);
     }
-    reset();
+    if (!initialState)
+      reset();
   }
   return {
     idle,
@@ -2582,14 +2629,16 @@ function useIdle(timeout = oneMinute, options = {}) {
     reset
   };
 }
+// @__NO_SIDE_EFFECTS__
 function useNow(options = {}) {
   const {
     controls: exposeControls = false,
-    interval = "requestAnimationFrame"
+    interval = "requestAnimationFrame",
+    immediate = true
   } = options;
   const now2 = ref(/* @__PURE__ */ new Date());
   const update = () => now2.value = /* @__PURE__ */ new Date();
-  const controls = interval === "requestAnimationFrame" ? useRafFn(update, { immediate: true }) : useIntervalFn(update, interval, { immediate: true });
+  const controls = interval === "requestAnimationFrame" ? useRafFn(update, { immediate }) : useIntervalFn(update, interval, { immediate });
   if (exposeControls) {
     return {
       now: now2,
@@ -2618,6 +2667,7 @@ function useObjectUrl(object) {
   tryOnScopeDispose(release);
   return readonly(url);
 }
+// @__NO_SIDE_EFFECTS__
 function useClamp(value, min, max) {
   if (typeof value === "function" || isReadonly(value))
     return computed(() => clamp(toValue$1(value), toValue$1(min), toValue$1(max)));
@@ -2640,12 +2690,12 @@ function useOffsetPagination(options) {
     onPageSizeChange = noop,
     onPageCountChange = noop
   } = options;
-  const currentPageSize = useClamp(pageSize, 1, Number.POSITIVE_INFINITY);
+  const currentPageSize = /* @__PURE__ */ useClamp(pageSize, 1, Number.POSITIVE_INFINITY);
   const pageCount = computed(() => Math.max(
     1,
     Math.ceil(toValue$1(total) / toValue$1(currentPageSize))
   ));
-  const currentPage = useClamp(page, 1, pageCount);
+  const currentPage = /* @__PURE__ */ useClamp(page, 1, pageCount);
   const isFirstPage = computed(() => currentPage.value === 1);
   const isLastPage = computed(() => currentPage.value === pageCount.value);
   if (isRef(page)) {
@@ -2728,6 +2778,7 @@ function useSorted(...args) {
   });
   return source;
 }
+// @__NO_SIDE_EFFECTS__
 function useStepper(steps, initialStep) {
   const stepsRef = ref(steps);
   const stepNames = computed(() => Array.isArray(stepsRef.value) ? stepsRef.value : Object.keys(stepsRef.value));
@@ -2835,12 +2886,13 @@ const DEFAULT_MESSAGES = {
 function DEFAULT_FORMATTER(date) {
   return date.toISOString().slice(0, 10);
 }
+// @__NO_SIDE_EFFECTS__
 function useTimeAgo(time, options = {}) {
   const {
     controls: exposeControls = false,
     updateInterval = 3e4
   } = options;
-  const { now: now2, ...controls } = useNow({ interval: updateInterval, controls: true });
+  const { now: now2, ...controls } = /* @__PURE__ */ useNow({ interval: updateInterval, controls: true });
   const timeAgo = computed(() => formatTimeAgo(new Date(toValue$1(time)), options, toValue$1(now2)));
   if (exposeControls) {
     return {
@@ -2961,7 +3013,8 @@ function useUrlSearchParams(mode = "history", options = {}) {
     removeFalsyValues = false,
     write: enableWrite = true,
     writeMode = "replace",
-    window: window2 = defaultWindow
+    window: window2 = defaultWindow,
+    stringify = (params) => params.toString()
   } = options;
   if (!window2)
     return reactive(initialValue);
@@ -2978,7 +3031,7 @@ function useUrlSearchParams(mode = "history", options = {}) {
     }
   }
   function constructQuery(params) {
-    const stringified = params.toString();
+    const stringified = stringify(params);
     if (mode === "history")
       return `${stringified ? `?${stringified}` : ""}${window2.location.hash || ""}`;
     if (mode === "hash-params")
@@ -3020,7 +3073,7 @@ function useUrlSearchParams(mode = "history", options = {}) {
     },
     { deep: true }
   );
-  function write(params, shouldUpdate) {
+  function write(params, shouldUpdate, shouldWriteHistory = true) {
     pause();
     if (shouldUpdate)
       updateState(params);
@@ -3031,18 +3084,20 @@ function useUrlSearchParams(mode = "history", options = {}) {
         window2.location.pathname + constructQuery(params)
       );
     } else {
-      window2.history.pushState(
-        window2.history.state,
-        window2.document.title,
-        window2.location.pathname + constructQuery(params)
-      );
+      if (shouldWriteHistory) {
+        window2.history.pushState(
+          window2.history.state,
+          window2.document.title,
+          window2.location.pathname + constructQuery(params)
+        );
+      }
     }
-    resume();
+    nextTick(() => resume());
   }
   function onChanged() {
     if (!enableWrite)
       return;
-    write(read(), true);
+    write(read(), true, false);
   }
   const listenerOptions = { passive: true };
   useEventListener(window2, "popstate", onChanged, listenerOptions);