@stacksjs/browser 0.65.0 → 0.67.0

package/src/index.ts

@@ -1 +0,0 @@
-export * from './utils/'

package/src/utils/base.ts

@@ -1,12 +0,0 @@
-export { toString } from '@stacksjs/strings'
-
-// export function assert(condition: boolean, message: string): asserts condition {
-//   if (!condition)
-//     throw new Error(message)
-// }
-
-// export function noop() {}
-
-export async function loop(times: number, callback: any): Promise<void> {
-  Array.from({ length: times }).forEach(async (_, i) => await callback(i))
-}

package/src/utils/debounce.ts

@@ -1 +0,0 @@
-export { debounce } from 'perfect-debounce'

package/src/utils/function.ts

@@ -1,32 +0,0 @@
-import type { Fn, Nullable } from '@stacksjs/types'
-
-/**
- * Call every function in an array
- */
-export function batchInvoke(functions: Nullable<Fn>[]): void {
-  functions.forEach(fn => fn?.())
-}
-
-// /**
-//  * Call the function
-//  */
-// export function invoke(fn: Fn) {
-//   return fn()
-// }
-
-/**
- * Pass the value through the callback, and return the value
- *
- * @example
- * ```
- * function createUser(name: string): User {
- *   return tap(new User, user => {
- *     user.name = name
- *   })
- * }
- * ```
- */
-export function tap<T>(value: T, callback: (value: T) => void): T {
-  callback(value)
-  return value
-}

package/src/utils/guards.ts

@@ -1,39 +0,0 @@
-/**
- * Type guard to filter out null-ish values
- *
- * @category Guards
- * @example array.filter(notNullish)
- */
-export function notNullish<T>(v: T | null | undefined): v is NonNullable<T> {
-  return v != null
-}
-
-/**
- * Type guard to filter out null values
- *
- * @category Guards
- * @example array.filter(noNull)
- */
-export function noNull<T>(v: T | null): v is Exclude<T, null> {
-  return v !== null
-}
-
-/**
- * Type guard to filter out null-ish values
- *
- * @category Guards
- * @example array.filter(notUndefined)
- */
-export function notUndefined<T>(v: T): v is Exclude<T, undefined> {
-  return v !== undefined
-}
-
-/**
- * Type guard to filter out falsy values
- *
- * @category Guards
- * @example array.filter(isTruthy)
- */
-export function isTruthy<T>(v: T): v is NonNullable<T> {
-  return Boolean(v)
-}

package/src/utils/index.ts

@@ -1,11 +0,0 @@
-export * from './base'
-export * from './debounce'
-export * from './function'
-export * from './guards'
-export * from './math'
-export * from './promise'
-export * from './regex'
-export * from './retry'
-export * from './sleep'
-export * from './throttle'
-export * from './vendors'

package/src/utils/math.ts

@@ -1,30 +0,0 @@
-export const clamp = (n: number, min: number, max: number): number => Math.min(max, Math.max(min, n))
-
-export function rand(min: number, max: number): number {
-  min = Math.ceil(min)
-  max = Math.floor(max)
-  return Math.floor(Math.random() * (max - min + 1)) + min
-}
-
-// not, -> exported as well in ../regex
-export {
-  and,
-  createGenericProjection,
-  createProjection,
-  logicNot,
-  logicOr,
-  or,
-  useAbs,
-  useAverage,
-  useCeil,
-  useClamp,
-  useFloor,
-  useMath,
-  useMax,
-  useMin,
-  usePrecision,
-  useProjection,
-  useRound,
-  useSum,
-  useTrunc,
-} from '@vueuse/math'

package/src/utils/promise.ts

@@ -1,134 +0,0 @@
-export interface SingletonPromiseReturn<T> {
-  (): Promise<T>
-  /**
-   * Reset current staled promise.
-   * Await it to have proper shutdown.
-   */
-  reset: () => Promise<void>
-}
-
-// export { peek } from 'bun'
-
-/**
- * Promise with `resolve` and `reject` methods of itself
- */
-export interface ControlledPromise<T = void> extends Promise<T> {
-  resolve: (value: T | PromiseLike<T>) => void
-  reject: (reason?: any) => void
-}
-
-/**
- * Create singleton promise function.
- *
- * @category Promise
- */
-export function createSingletonPromise<T>(fn: () => Promise<T>): SingletonPromiseReturn<T> {
-  let _promise: Promise<T> | undefined
-
-  function wrapper() {
-    if (!_promise)
-      _promise = fn()
-    return _promise
-  }
-
-  wrapper.reset = async () => {
-    const _prev = _promise
-    _promise = undefined
-    if (_prev)
-      await _prev
-  }
-
-  return wrapper
-}
-
-/**
- * Create a promise lock.
- *
- * @category Promise
- * @example
- * ```
- * const lock = createPromiseLock()
- *
- * lock.run(async () => {
- *   await doSomething()
- * })
- *
- * // in anther context:
- * await lock.wait() // it will wait all tasking finished
- * ```
- */
-export function createPromiseLock() {
-  let currentPromise = Promise.resolve()
-  const queue: Promise<any>[] = []
-
-  return {
-    async run<T = void>(fn: () => Promise<T>): Promise<T> {
-      const runTask = async (): Promise<T> => {
-        await currentPromise
-        return fn()
-      }
-
-      const taskPromise = runTask()
-      queue.push(taskPromise)
-
-      currentPromise = taskPromise
-        .catch(() => {})
-        .finally(() => {
-          const index = queue.indexOf(taskPromise)
-          if (index > -1)
-            queue.splice(index, 1)
-        }) as Promise<void>
-
-      return taskPromise
-    },
-
-    async wait(): Promise<void> {
-      while (queue.length > 0) {
-        await Promise.all(queue)
-      }
-    },
-
-    isWaiting(): boolean {
-      return queue.length > 0
-    },
-
-    clear(): void {
-      queue.length = 0
-      currentPromise = Promise.resolve()
-    },
-  }
-}
-
-/**
- * Return a Promise with `resolve` and `reject` methods
- *
- * @category Promise
- * @example
- * ```
- * const promise = createControlledPromise()
- *
- * await promise
- *
- * // in anther context:
- * promise.resolve(data)
- * ```
- */
-export function createControlledPromise<T>(): ControlledPromise<T> {
-  let resolve: any
-  let reject: any
-
-  const promise = new Promise<T>((_resolve, _reject) => {
-    resolve = _resolve
-    reject = _reject
-  }) as ControlledPromise<T>
-
-  promise.resolve = resolve
-
-  promise.reject = reject
-  return promise
-}
-
-/**
- * Create a promise that will be resolved after `ms` milliseconds.
- */
-// export { sleep, sleepSync } from 'bun'

package/src/utils/regex.ts

@@ -1,42 +0,0 @@
-export type {
-  Flag,
-  Input,
-  MagicRegExp,
-  MagicRegExpMatchArray,
-  MapToStringCapturedBy,
-  StringCapturedBy,
-} from 'magic-regexp'
-export {
-  anyOf,
-  carriageReturn,
-  caseInsensitive,
-  char,
-  charIn,
-  charNotIn,
-  digit,
-  dotAll,
-  exactly,
-  global,
-  letter,
-  linefeed,
-  maybe,
-  multiline,
-  not,
-  oneOrMore,
-  sticky,
-  tab,
-  unicode,
-  whitespace,
-  withIndices,
-  word,
-  wordBoundary,
-  wordChar,
-} from 'magic-regexp'
-
-// export function caseInsensitive(pattern: string): RegExp {
-//   return new RegExp(pattern, 'i')
-// }
-
-export function createRegExp(pattern: string, options: { flags?: string } = {}): RegExp {
-  return new RegExp(pattern, options.flags)
-}

package/src/utils/retry.ts

@@ -1,43 +0,0 @@
-// eslint-disable-next-line ts/no-unsafe-function-type
-export function retry(fn: Function, options: any): Promise<any> {
-  const { retries = 3, initialDelay = 1000, backoffFactor = 2, jitter = true } = options
-
-  return new Promise((resolve, reject) => {
-    let attemptCount = 0
-
-    const attempt = async () => {
-      try {
-        resolve(await fn())
-      }
-      catch (err) {
-        if (attemptCount >= retries) {
-          reject(err)
-        }
-        else {
-          const delay = calculateDelay(attemptCount, initialDelay, backoffFactor, jitter)
-          setTimeout(() => attempt(), delay)
-          attemptCount++
-        }
-      }
-    }
-
-    attempt()
-  })
-}
-
-export function calculateDelay(
-  attemptCount: number,
-  initialDelay: number,
-  backoffFactor: number,
-  jitter?: boolean,
-): number {
-  let delay = initialDelay * backoffFactor ** attemptCount
-
-  if (jitter) {
-    const random = Math.random() // Generates a number between 0 and 1
-    const jitterValue = delay * 0.3 // Jitter will be up to 30% of the delay
-    delay = delay + jitterValue * (random - 0.5) * 2 // Adjust delay randomly within ±30%
-  }
-
-  return delay
-}

package/src/utils/sleep.ts

@@ -1,125 +0,0 @@
-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

@@ -1,47 +0,0 @@
-/**
- * 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),
-      )
-    }
-  }
-}