@stacksjs/browser 0.65.0

package/src/utils/sleep.ts

@@ -0,0 +1,125 @@
+export type NonNegativeInteger<T extends number> = number extends T
+  ? never
+  : `${T}` extends `-${string}` | `${string}.${string}`
+    ? never
+    : T
+
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export function sleep(ms: number): Promise<void> {
+  if (ms < 0 || !Number.isInteger(ms)) {
+    throw new Error('sleep() requires a non-negative integer')
+  }
+
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export function wait(ms: number): Promise<void> {
+  if (ms < 0 || !Number.isInteger(ms)) {
+    throw new Error('wait() requires a non-negative integer')
+  }
+
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to pause execution.
+ * @returns A promise that resolves after the specified delay.
+ */
+export function delay(ms: number): Promise<void> {
+  if (ms < 0 || !Number.isInteger(ms)) {
+    throw new Error('delay() requires a non-negative integer')
+  }
+
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+export type WaitOptions = number | {
+  interval?: number
+  timeout?: number
+}
+
+/**
+ * Pauses execution until a specified condition is met.
+ * @param condition The condition to wait for.
+ * @param interval The interval at which to check the condition, in milliseconds. Defaults to 1000.
+ * @returns A promise that resolves when the condition is met.
+ */
+export function waitUntil(condition: () => boolean, options: WaitOptions = {}): Promise<void> {
+  return new Promise((resolve) => {
+    const { interval, timeout } = normalizeOptions(options)
+
+    // Immediately resolve if the condition is initially true
+    if (condition()) {
+      resolve()
+      return
+    }
+
+    const check = () => {
+      if (condition()) {
+        resolve()
+      }
+      else {
+        setTimeout(check, interval)
+      }
+    }
+
+    if (timeout) {
+      setTimeout(resolve, timeout)
+    }
+
+    check()
+  })
+}
+
+function normalizeOptions(options: WaitOptions): { interval: number, timeout: number } {
+  if (typeof options === 'number') {
+    return { interval: 100, timeout: options }
+  }
+  return {
+    interval: options.interval ?? 100,
+    timeout: options.timeout ?? 0,
+  }
+}
+
+/**
+ * Pauses execution while a specified condition is met.
+ * @param condition The condition to wait while.
+ * @param interval The interval at which to check the condition, in milliseconds. Defaults to 1000.
+ * @returns A promise that resolves when the condition is no longer met.
+ */
+export function waitWhile(condition: () => boolean, options: WaitOptions = {}): Promise<void> {
+  return new Promise((resolve) => {
+    const { interval = 100, timeout = 0 } = options
+
+    // Immediately resolve if the condition is initially false
+    if (!condition()) {
+      resolve()
+      return
+    }
+
+    const check = () => {
+      if (!condition()) {
+        resolve()
+      }
+      else {
+        setTimeout(check, interval)
+      }
+    }
+
+    if (timeout) {
+      setTimeout(resolve, timeout)
+    }
+
+    check()
+  })
+}

package/src/utils/throttle.ts

@@ -0,0 +1,47 @@
+/**
+ * Throttle a function.
+ *
+ * @param {Function} fn - The function to throttle.
+ * @param {number} [wait] - The time to wait between function calls.
+ * @returns {Function} - A new function that throttles the calls to the original function.
+ *
+ * @example
+ * ```ts
+ * // logs window dimensions at most every 250ms
+ * window.addEventListener(
+ *   "resize",
+ *   throttle(function (evt) {
+ *     console.log(window.innerWidth)
+ *     console.log(window.innerHeight)
+ *   }, 250)
+ * )
+ * ```
+ */
+// eslint-disable-next-line ts/no-unsafe-function-type
+export function throttle(fn: Function, wait = 300) {
+  let inThrottle: boolean
+  let lastFn: ReturnType<typeof setTimeout>
+  let lastTime: number
+
+  return function (this: unknown, ...args: any[]): void {
+    if (!inThrottle) {
+      fn.apply(this, args)
+
+      lastTime = Date.now()
+      inThrottle = true
+    }
+    else {
+      clearTimeout(lastFn)
+
+      lastFn = setTimeout(
+        () => {
+          if (Date.now() - lastTime >= wait) {
+            fn.apply(this, args) // Use 'this' directly
+            lastTime = Date.now()
+          }
+        },
+        Math.max(wait - (Date.now() - lastTime), 0),
+      )
+    }
+  }
+}

package/src/utils/vendors.ts

@@ -0,0 +1,258 @@
+export {
+  asyncComputed,
+  autoResetRef,
+  breakpointsAntDesign,
+  breakpointsBootstrapV5,
+  breakpointsMasterCss,
+  breakpointsQuasar,
+  breakpointsSematic,
+  breakpointsTailwind,
+  breakpointsVuetify,
+  cloneFnJSON,
+  computedAsync,
+  computedEager,
+  computedInject,
+  computedWithControl,
+  controlledComputed,
+  controlledRef,
+  createEventHook,
+  createFetch,
+  createGlobalState,
+  createInjectionState,
+  createReactiveFn,
+  createReusableTemplate,
+  createSharedComposable,
+  createTemplatePromise,
+  createUnrefFn,
+  customStorageEventName,
+  debouncedRef,
+  debouncedWatch,
+  defaultDocument,
+  defaultLocation,
+  defaultNavigator,
+  defaultWindow,
+  eagerComputed,
+  executeTransition,
+  extendRef,
+  formatTimeAgo,
+  getSSRHandler,
+  ignorableWatch,
+  injectLocal,
+  isDefined,
+  makeDestructurable,
+  mapGamepadToXbox360Controller,
+  onClickOutside,
+  onKeyDown,
+  onKeyPressed,
+  onKeyStroke,
+  onKeyUp,
+  onLongPress,
+  onStartTyping,
+  pausableWatch,
+  provideLocal,
+  reactify,
+  reactifyObject,
+  reactiveComputed,
+  reactiveOmit,
+  reactivePick,
+  refAutoReset,
+  refDebounced,
+  refDefault,
+  refThrottled,
+  refWithControl,
+  resolveRef,
+  resolveUnref,
+  setSSRHandler,
+  syncRef,
+  syncRefs,
+  templateRef,
+  throttledRef,
+  throttledWatch,
+  toReactive,
+  tryOnBeforeMount,
+  tryOnBeforeUnmount,
+  tryOnMounted,
+  tryOnScopeDispose,
+  tryOnUnmounted,
+  unrefElement,
+  until,
+  useActiveElement,
+  useAnimate,
+  useArrayDifference,
+  useArrayEvery,
+  useArrayFilter,
+  useArrayFind,
+  useArrayFindIndex,
+  useArrayIncludes,
+  useArrayMap,
+  useArrayReduce,
+  useArraySome,
+  useArrayUnique,
+  useAsyncQueue,
+  useAsyncState,
+  useBase64,
+  useBattery,
+  useBluetooth,
+  useBreakpoints,
+  useBroadcastChannel,
+  useBrowserLocation,
+  useCached,
+  useClipboard,
+  useClipboardItems,
+  useCloned,
+  useColorMode,
+  useConfirmDialog,
+  useCounter,
+  useCssVar,
+  useCurrentElement,
+  useCycleList,
+  useDark,
+  useDateFormat,
+  useDebounce,
+  useDebouncedRefHistory,
+  useDebounceFn,
+  useDeviceMotion,
+  useDeviceOrientation,
+  useDevicePixelRatio,
+  useDevicesList,
+  useDisplayMedia,
+  useDocumentVisibility,
+  useDraggable,
+  useDropZone,
+  useElementBounding,
+  useElementByPoint,
+  useElementHover,
+  useElementSize,
+  useElementVisibility,
+  useEventBus,
+  useEventListener,
+  useEventSource,
+  useEyeDropper,
+  useFavicon,
+  useFetch,
+  useFileDialog,
+  useFileSystemAccess,
+  useFocus,
+  useFocusWithin,
+  useFps,
+  useFullscreen,
+  useGamepad,
+  useGeolocation,
+  useIdle,
+  useImage,
+  useInfiniteScroll,
+  useIntersectionObserver,
+  useInterval,
+  useIntervalFn,
+  useKeyModifier,
+  useLastChanged,
+  useLocalStorage,
+  useMagicKeys,
+  useManualRefHistory,
+  useMediaControls,
+  useMediaQuery,
+  useMemoize,
+  useMemory,
+  useMounted,
+  useMouse,
+  useMouseInElement,
+  useMousePressed,
+  useMutationObserver,
+  useNavigatorLanguage,
+  useNetwork,
+  useNow,
+  useObjectUrl,
+  useOffsetPagination,
+  useOnline,
+  usePageLeave,
+  useParallax,
+  useParentElement,
+  usePerformanceObserver,
+  usePermission,
+  usePointer,
+  usePointerLock,
+  usePointerSwipe,
+  usePreferredColorScheme,
+  usePreferredContrast,
+  usePreferredDark,
+  usePreferredLanguages,
+  usePreferredReducedMotion,
+  usePrevious,
+  useRafFn,
+  useRefHistory,
+  useResizeObserver,
+  useScreenOrientation,
+  useScreenSafeArea,
+  useScriptTag,
+  useScroll,
+  useScrollLock,
+  useSessionStorage,
+  useShare,
+  useSorted,
+  useSpeechRecognition,
+  useSpeechSynthesis,
+  useStepper,
+  useStorage,
+  useStorageAsync,
+  useStyleTag,
+  useSupported,
+  useSwipe,
+  useTemplateRefsList,
+  useTextareaAutosize,
+  useTextDirection,
+  useTextSelection,
+  useThrottle,
+  useThrottledRefHistory,
+  useThrottleFn,
+  useTimeAgo,
+  useTimeout,
+  useTimeoutFn,
+  useTimeoutPoll,
+  useTimestamp,
+  useTitle,
+  useToggle,
+  useToNumber,
+  useToString,
+  useTransition,
+  useUrlSearchParams,
+  useUserMedia,
+  useVibrate,
+  useVirtualList,
+  useVModel,
+  useVModels,
+  useWakeLock,
+  useWebNotification,
+  useWebSocket,
+  useWebWorker,
+  useWebWorkerFn,
+  useWindowFocus,
+  useWindowScroll,
+  useWindowSize,
+  watchArray,
+  watchAtMost,
+  watchDebounced,
+  watchDeep,
+  watchIgnorable,
+  watchImmediate,
+  watchOnce,
+  watchPausable,
+  watchThrottled,
+  watchTriggerable,
+  watchWithFilter,
+  whenever,
+} from '@vueuse/core'
+
+export type {
+  // Head,
+  HeadObject,
+  HeadObjectPlain,
+} from '@vueuse/head'
+
+export {
+  createHead,
+  Head,
+  HeadVuePlugin,
+  renderHeadToString,
+} from '@vueuse/head'
+
+export { default as readableSize } from 'pretty-bytes'