@stacksjs/utils 0.58.72 → 0.59.1

package/dist/base.d.ts

@@ -0,0 +1,2 @@
+export { toString } from '@stacksjs/strings';
+export declare function loop(times: number, callback: any): Promise<void>;

package/dist/clean.d.ts

@@ -0,0 +1 @@
+export declare function cleanProject(): Promise<void>;

package/dist/config.d.ts

@@ -0,0 +1 @@
+export { defineApp, defineCache, defineCli, defineCdn, defineCronJob, defineJob, defineDependencies, defineDatabase, defineDns, defineEmailConfig, defineGit, defineHashing, defineLibrary, defineNotification, defineSms, defineEmail, defineChat, definePayment, defineQueue, defineSearchEngine, defineServices, defineStorage, defineUi, } from '@stacksjs/config';

package/dist/currency.d.ts

@@ -0,0 +1,3 @@
+export { add, allocate, compare, convert, equal, greaterThan, greaterThanOrEqual, hasSubUnits, isZero, lessThan, lessThanOrEqual, maximum, minimum, multiply, normalizeScale, dinero, dinero as money, subtract, toSnapshot, toUnits, toDecimal, trimScale, haveSameCurrency, haveSameAmount, dinero as currency, } from 'dinero.js';
+export { USD } from '@dinero.js/currencies';
+export type { Dinero, Currency } from 'dinero.js';

package/dist/debounce.d.ts

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

package/dist/equal.d.ts

@@ -0,0 +1 @@
+export declare function isDeepEqual(value1: any, value2: any): boolean;

package/dist/export-size.d.ts

@@ -0,0 +1 @@
+export { getExportsSize } from 'export-size';

package/dist/find.d.ts

@@ -0,0 +1,5 @@
+interface FindStacksProjectsOptions {
+    quiet?: boolean;
+}
+export declare function findStacksProjects(dir?: string, options?: FindStacksProjectsOptions): Promise<string[]>;
+export {};

package/dist/function.d.ts

@@ -0,0 +1,18 @@
+import type { Fn, Nullable } from '@stacksjs/types';
+/**
+ * Call every function in an array
+ */
+export declare function batchInvoke(functions: Nullable<Fn>[]): void;
+/**
+ * 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 declare function tap<T>(value: T, callback: (value: T) => void): T;

package/dist/git.d.ts

@@ -0,0 +1 @@
+export declare function isGitClean(): boolean;

package/dist/guards.d.ts

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

package/dist/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function originRequestFunctionHash(): string | undefined;
+export declare const websiteSourceHash: string;

package/dist/helpers.d.ts

@@ -0,0 +1,52 @@
+/// <reference types="bun-types" />
+/// <reference types="node" />
+import type { AddressInfo } from 'node:net';
+import type { Result } from '@stacksjs/error-handling';
+import type { CliOptions, Manifest, SyncSubprocess } from '@stacksjs/types';
+import type { NpmScript } from '@stacksjs/enums';
+export declare function packageManager(): Promise<string>;
+export declare function initProject(): Promise<Result<SyncSubprocess, Error>>;
+export declare function ensureProjectIsInitialized(): Promise<boolean>;
+export declare function installIfVersionMismatch(): Promise<void>;
+export declare function frameworkVersion(): Promise<string>;
+export declare function isAppKeySet(): Promise<boolean>;
+/**
+ * Determines the utilized reset preset.
+ *
+ * @url https://www.npmjs.com/package/@unocss/reset
+ * @param preset
+ */
+export declare function determineResetPreset(preset?: string): string[];
+/**
+ * Determines whether the specified value is a package manifest.
+ */
+export declare function isManifest(obj: any): obj is Manifest;
+/**
+ * Determines whether the specified value is a string, null, or undefined.
+ */
+export declare function isOptionalString(value: any): value is string | undefined;
+export declare function setEnvValue(key: string, value: string): Promise<void>;
+/**
+ * Runs the specified NPM script in the package.json file.
+ */
+export declare function runNpmScript(script: NpmScript, options?: CliOptions): Promise<Result<SyncSubprocess, Error>>;
+/**
+ * Determines whether the specified NPM script exists in the given manifest.
+ */
+export declare function hasScript(manifest: Manifest, script: NpmScript): boolean;
+export declare function parseYaml(content: any): any;
+/**
+ * Determines the level of debugging.
+ *
+ * The debug level is determined by the following:
+ * 1. The --verbose flag
+ * 2. The debug property in the app configuration
+ *
+ * Currently, we don't support a custom debug level,
+ * though, we would like to in the future.
+ *
+ * @param options
+ */
+export declare function determineDebugLevel(options?: CliOptions): boolean;
+export declare function isIpv6(address: AddressInfo): boolean;
+export { dump as dumpYaml, load as loadYaml } from 'js-yaml';

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export * from './base';
+export * from './clean';
+export * from './config';
+export * from './currency';
+export * from './debounce';
+export * from './equal';
+export * from './export-size';
+export * from './find';
+export * from './function';
+export * from './git';
+export * from './guards';
+export * from './hash';
+export * from './helpers';
+export * from './macroable';
+export * from './math';
+export * from './p';
+export * from './promise';
+export * from './regex';
+export * from './retry';
+export * from './sleep';
+export * from './throttle';
+export * from './vendors';
+export * from './versions';

package/dist/index.js

@@ -6,24 +6,18 @@ async function loop(times, callback) {
 }
 // src/clean.ts
 import {path as p} from "@stacksjs/path";
-
-// src/delete.ts
-import {rimraf} from "rimraf";
-
-// src/clean.ts
+var {$ } = globalThis.Bun;
 async function cleanProject() {
-  return await rimraf([
-    p.projectPath("bun.lockb"),
-    p.projectPath("yarn.lock"),
-    p.projectPath("node_modules/"),
-    p.frameworkPath("dist"),
-    p.frameworkPath("node_modules"),
-    p.frameworkPath("**/dist"),
-    p.frameworkPath("**/node_modules"),
-    p.frameworkCloudPath("cdk.out/"),
-    p.frameworkCloudPath("cdk.context.json"),
-    p.frameworkCloudPath("dist.zip")
-  ]);
+  await $`rm -rf ${p.projectPath("bun.lockb")}`;
+  await $`rm -rf ${p.projectPath("yarn.lock")}`;
+  await $`rm -rf ${p.projectPath("node_modules/")}`;
+  await $`rm -rf ${p.frameworkPath("dist")}`;
+  await $`rm -rf ${p.frameworkPath("node_modules")}`;
+  await $`rm -rf ${p.frameworkPath("**/dist")}`;
+  await $`rm -rf ${p.frameworkPath("**/node_modules")}`;
+  await $`rm -rf ${p.frameworkCloudPath("cdk.out/")}`;
+  await $`rm -rf ${p.frameworkCloudPath("cdk.context.json")}`;
+  await $`rm -rf ${p.frameworkCloudPath("dist.zip")}`;
 }
 // src/config.ts
 import {
@@ -108,6 +102,74 @@ function isDeepEqual(value1, value2) {
 }
 // src/export-size.ts
 import {getExportsSize} from "export-size";
+// src/find.ts
+import os from "os";
+import fs from "fs/promises";
+import path2 from "path";
+import {italic} from "@stacksjs/cli";
+import {log as log2} from "@stacksjs/logging";
+async function findStacksProjects(dir, options) {
+  dir = dir || os.homedir();
+  if (!options?.quiet) {
+    log2.info(`Searching for Stacks projects in: ${italic(dir)}`);
+    log2.info(`This may take a few moments...`);
+    console.log("");
+    console.log(italic("  Please note, while Stacks is searching for projects on your machine,"));
+    console.log(italic("  you may be asked for permissions to scan certain directories."));
+    console.log("");
+    log2.debug(`Excluding directories: ${excludePatterns.join(", ")}`);
+  }
+  const foundProjects = await searchDirectory(dir);
+  if (!foundProjects)
+    throw new Error("No Stacks projects found");
+  return foundProjects;
+}
+async function searchDirectory(directory) {
+  const foundProjects = [];
+  const isExcluded = excludePatterns.some((pattern) => typeof pattern === "string" ? directory.includes(pattern) : pattern.test(directory));
+  if (isExcluded)
+    return;
+  let items;
+  try {
+    items = await fs.readdir(directory, { withFileTypes: true });
+  } catch (error) {
+    console.error(`Error reading directory ${directory}:`, error);
+    return;
+  }
+  let buddyFileFound = false;
+  let storageDirFound = false;
+  for (const item of items) {
+    if (item.isFile() && item.name === targetFileName) {
+      buddyFileFound = true;
+    } else if (item.isDirectory()) {
+      const fullPath = path2.join(directory, item.name);
+      if (item.name === "storage") {
+        try {
+          const storagePath = path2.join(fullPath, "framework/core/buddy");
+          await fs.access(storagePath);
+          storageDirFound = true;
+        } catch (error) {
+        }
+      }
+      await searchDirectory(fullPath);
+    }
+  }
+  if (buddyFileFound && storageDirFound)
+    foundProjects.push(directory);
+  return foundProjects;
+}
+var targetFileName = "buddy";
+var excludePatterns = [
+  "node_modules",
+  "dist",
+  "vendor",
+  `${os.homedir()}/Documents`,
+  `${os.homedir()}/Pictures`,
+  `${os.homedir()}/Library`,
+  `${os.homedir()}/.Trash`,
+  /.*out.*|.*\.out.*|out-.*/,
+  /.*\/\..*/
+];
 // src/function.ts
 function batchInvoke(functions) {
   functions.forEach((fn) => fn && fn());
@@ -161,7 +223,7 @@ var websiteSrc = [
 ];
 var websiteSourceHash = config2.app.docMode === true ? hashPaths(docsSrc) : hashPaths(websiteSrc);
 // src/helpers.ts
-import {log as log2, runCommand} from "@stacksjs/cli";
+import {log as log3, runCommand} from "@stacksjs/cli";
 import {err, handleError, ok} from "@stacksjs/error-handling";
 import {frameworkPath, projectPath} from "@stacksjs/path";
 import * as storage2 from "@stacksjs/storage";
@@ -174,13 +236,13 @@ async function packageManager() {
 }
 async function initProject() {
   if (app.env !== "production")
-    log2.info("Project not yet initialized, generating application key...");
+    log3.info("Project not yet initialized, generating application key...");
   else
     handleError("Please run `buddy key:generate` to generate an application key");
   const result = await runAction(Action.KeyGenerate, { cwd: projectPath() });
   if (result.isErr())
     return err(handleError(result.error));
-  log2.info("Application key generated.");
+  log3.info("Application key generated.");
   return ok(result.value);
 }
 async function ensureProjectIsInitialized() {
@@ -408,89 +470,8 @@ function createControlledPromise() {
   promise.reject = reject;
   return promise;
 }
-// /home/runner/work/stacks/stacks/node_modules/magic-regexp/dist/shared/magic-regexp.b7c910ac.mjs
-var NO_WRAP_RE = /^(\(.*\)|\\?.)$/;
-var wrap = (s) => {
-  const v = s.toString();
-  return NO_WRAP_RE.test(v) ? v : `(?:${v})`;
-};
-var GROUPED_AS_REPLACE_RE = /^(?:\(\?:(.+)\)|(\(?.+\)?))$/;
-var GROUPED_REPLACE_RE = /^(?:\(\?:(.+)\)([?+*]|{[\d,]+})?|(.+))$/;
-var createInput = (s) => {
-  const groupedAsFn = (key) => createInput(`(?<${key}>${`${s}`.replace(GROUPED_AS_REPLACE_RE, "$1$2")})`);
-  return {
-    toString: () => s.toString(),
-    and: Object.assign((...inputs) => createInput(`${s}${exactly(...inputs)}`), {
-      referenceTo: (groupName) => createInput(`${s}\\k<${groupName}>`)
-    }),
-    or: (...inputs) => createInput(`(?:${s}|${exactly(...inputs)})`),
-    after: (...input) => createInput(`(?<=${exactly(...input)})${s}`),
-    before: (...input) => createInput(`${s}(?=${exactly(...input)})`),
-    notAfter: (...input) => createInput(`(?<!${exactly(...input)})${s}`),
-    notBefore: (...input) => createInput(`${s}(?!${exactly(...input)})`),
-    times: Object.assign((number) => createInput(`${wrap(s)}{${number}}`), {
-      any: () => createInput(`${wrap(s)}*`),
-      atLeast: (min) => createInput(`${wrap(s)}{${min},}`),
-      atMost: (max) => createInput(`${wrap(s)}{0,${max}}`),
-      between: (min, max) => createInput(`${wrap(s)}{${min},${max}}`)
-    }),
-    optionally: () => createInput(`${wrap(s)}?`),
-    as: groupedAsFn,
-    groupedAs: groupedAsFn,
-    grouped: () => createInput(`${s}`.replace(GROUPED_REPLACE_RE, "($1$3)$2")),
-    at: {
-      lineStart: () => createInput(`^${s}`),
-      lineEnd: () => createInput(`${s}\$`)
-    }
-  };
-};
-var ESCAPE_REPLACE_RE = /[.*+?^${}()|[\]\\/]/g;
-var charIn = (chars) => createInput(`[${chars.replace(/[-\\^\]]/g, "\\$&")}]`);
-var charNotIn = (chars) => createInput(`[^${chars.replace(/[-\\^\]]/g, "\\$&")}]`);
-var anyOf = (...inputs) => createInput(`(?:${inputs.map((a) => exactly(a)).join("|")})`);
-var char = createInput(".");
-var word = createInput("\\b\\w+\\b");
-var wordChar = createInput("\\w");
-var wordBoundary = createInput("\\b");
-var digit = createInput("\\d");
-var whitespace = createInput("\\s");
-var letter = Object.assign(createInput("[a-zA-Z]"), {
-  lowercase: createInput("[a-z]"),
-  uppercase: createInput("[A-Z]")
-});
-var tab = createInput("\\t");
-var linefeed = createInput("\\n");
-var carriageReturn = createInput("\\r");
-var not = {
-  word: createInput("\\W+"),
-  wordChar: createInput("\\W"),
-  wordBoundary: createInput("\\B"),
-  digit: createInput("\\D"),
-  whitespace: createInput("\\S"),
-  letter: Object.assign(createInput("[^a-zA-Z]"), {
-    lowercase: createInput("[^a-z]"),
-    uppercase: createInput("[^A-Z]")
-  }),
-  tab: createInput("[^\\t]"),
-  linefeed: createInput("[^\\n]"),
-  carriageReturn: createInput("[^\\r]")
-};
-var maybe = (...inputs) => createInput(`${wrap(exactly(...inputs))}?`);
-var exactly = (...inputs) => createInput(inputs.map((input) => typeof input === "string" ? input.replace(ESCAPE_REPLACE_RE, "\\$&") : input).join(""));
-var oneOrMore = (...inputs) => createInput(`${wrap(exactly(...inputs))}+`);
-var withIndices = "d";
-var caseInsensitive = "i";
-var global = "g";
-var multiline = "m";
-var dotAll = "s";
-var unicode = "u";
-var sticky = "y";
-
-// /home/runner/work/stacks/stacks/node_modules/magic-regexp/dist/index.mjs
-var createRegExp = (...inputs) => {
-  const flags = inputs.length > 1 && (Array.isArray(inputs[inputs.length - 1]) || inputs[inputs.length - 1] instanceof Set) ? inputs.pop() : undefined;
-  return new RegExp(exactly(...inputs).toString(), [...flags || ""].join(""));
-};
+// src/regex.ts
+import {createRegExp, caseInsensitive, anyOf, carriageReturn, char, charIn, charNotIn, digit, dotAll, exactly, global, letter, linefeed, maybe, multiline, not, oneOrMore, sticky, tab, unicode, whitespace, withIndices, word, wordBoundary, wordChar} from "magic-regexp";
 // src/retry.ts
 function retry(fn, options) {
   const { retries = 3, initialDelay = 1000, backoffFactor = 2, jitter = true } = options;
@@ -823,7 +804,7 @@ createHead,
 renderHeadToString
 } from "@vueuse/head";
 
-// /home/runner/work/stacks/stacks/node_modules/pretty-bytes/index.js
+// ../../../../node_modules/pretty-bytes/index.js
 var BYTE_UNITS = [
   "B",
   "kB",
@@ -918,7 +899,7 @@ function prettyBytes(number, options) {
   return prefix + numberString + separator + unit;
 }
 // package.json
-var version = "0.58.72";
+var version = "0.59.1";
 export {
   wordChar,
   wordBoundary,
@@ -1135,7 +1116,6 @@ export {
   setSSRHandler,
   setEnvValue,
   runNpmScript,
-  rimraf,
   retry,
   resolveUnref,
   resolveRef,
@@ -1212,6 +1192,7 @@ export {
   getExportsSize,
   frameworkVersion,
   formatTimeAgo,
+  findStacksProjects,
   extendRef,
   executeTransition,
   exactly,

package/dist/macroable.d.ts

@@ -0,0 +1 @@
+export { Macroable } from 'macroable';

package/dist/math.d.ts

@@ -0,0 +1,3 @@
+export declare const clamp: (n: number, min: number, max: number) => number;
+export declare function rand(min: number, max: number): number;
+export { and, createGenericProjection, createProjection, logicNot, logicOr, or, useAbs, useAverage, useCeil, useClamp, useFloor, useMath, useMax, useMin, usePrecision, useProjection, useRound, useSum, useTrunc, } from '@vueuse/math';

package/dist/p.d.ts

@@ -0,0 +1,41 @@
+interface POptions {
+    /**
+     * How many promises are resolved at the same time.
+     */
+    concurrency?: number | undefined;
+}
+declare class PInstance<T = any> extends Promise<Awaited<T>[]> {
+    items: Iterable<T>;
+    options?: POptions | undefined;
+    private promises;
+    get promise(): Promise<Awaited<T>[]>;
+    constructor(items?: Iterable<T>, options?: POptions | undefined);
+    add(...args: (T | Promise<T>)[]): void;
+    map<U>(fn: (value: Awaited<T>, index: number) => U): PInstance<Promise<U>>;
+    filter(fn: (value: Awaited<T>, index: number) => boolean | Promise<boolean>): PInstance<Promise<T>>;
+    forEach(fn: (value: Awaited<T>, index: number) => void): Promise<void>;
+    reduce<U>(fn: (previousValue: U, currentValue: Awaited<T>, currentIndex: number, array: Awaited<T>[]) => U, initialValue: U): Promise<U>;
+    clear(): void;
+    then(fn?: () => PromiseLike<any>): Promise<any>;
+    catch(fn?: (err: unknown) => PromiseLike<any>): Promise<any>;
+    finally(fn?: () => void): Promise<Awaited<T>[]>;
+}
+/**
+ * Utility for managing multiple promises.
+ *
+ * @see https://github.com/antfu/utils/tree/main/docs/p.md
+ * @category Promise
+ * @example
+ * ```
+ * import { p } from '@stacksjs/utils'
+ *
+ * const items = [1, 2, 3, 4, 5]
+ *
+ * await p(items)
+ *   .map(async i => await multiply(i, 3))
+ *   .filter(async i => await isEven(i))
+ * // [6, 12]
+ * ```
+ */
+export declare function p<T = any>(items?: Iterable<T>, options?: POptions): PInstance<T>;
+export {};

package/dist/promise.d.ts

@@ -0,0 +1,61 @@
+export interface SingletonPromiseReturn<T> {
+    (): Promise<T>;
+    /**
+     * Reset current staled promise.
+     * Await it to have proper shutdown.
+     */
+    reset: () => Promise<void>;
+}
+/**
+ * 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 declare function createSingletonPromise<T>(fn: () => Promise<T>): SingletonPromiseReturn<T>;
+/**
+ * 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 declare function createPromiseLock(): {
+    run<T = void>(fn: () => Promise<T>): Promise<T>;
+    wait(): Promise<void>;
+    isWaiting(): boolean;
+    clear(): void;
+};
+/**
+ * Return a Promise with `resolve` and `reject` methods
+ *
+ * @category Promise
+ * @example
+ * ```
+ * const promise = createControlledPromise()
+ *
+ * await promise
+ *
+ * // in anther context:
+ * promise.resolve(data)
+ * ```
+ */
+export declare function createControlledPromise<T>(): ControlledPromise<T>;
+/**
+ * Create a promise that will be resolved after `ms` milliseconds.
+ */

package/dist/regex.d.ts

@@ -0,0 +1,2 @@
+export type { Flag, MagicRegExp, MagicRegExpMatchArray, Input, MapToStringCapturedBy, StringCapturedBy } from 'magic-regexp';
+export { createRegExp, caseInsensitive, anyOf, carriageReturn, char, charIn, charNotIn, digit, dotAll, exactly, global, letter, linefeed, maybe, multiline, not, oneOrMore, sticky, tab, unicode, whitespace, withIndices, word, wordBoundary, wordChar } from 'magic-regexp';

package/dist/retry.d.ts

@@ -0,0 +1,2 @@
+export declare function retry(fn: Function, options: any): Promise<any>;
+export declare function calculateDelay(attemptCount: number, initialDelay: number, backoffFactor: number, jitter?: boolean): number;

package/dist/sleep.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 declare function sleep(ms: number): Promise<void>;
+/**
+ * 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 declare function wait(ms: number): Promise<void>;
+/**
+ * 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 declare function delay(ms: number): Promise<void>;
+/**
+ * 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 declare function waitUntil(condition: () => boolean, interval?: number): Promise<void>;
+/**
+ * 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 declare function waitWhile(condition: () => boolean, interval?: number): Promise<void>;

package/dist/throttle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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)
+ * )
+ * ```
+ */
+export declare function throttle(fn: Function, wait?: number): (this: unknown, ...args: any[]) => void;

package/dist/vendors.d.ts

@@ -0,0 +1,4 @@
+export { asyncComputed, breakpointsAntDesign, breakpointsBootstrapV5, breakpointsMasterCss, breakpointsQuasar, breakpointsSematic, breakpointsTailwind, breakpointsVuetify, cloneFnJSON, computedAsync, computedInject, createFetch, createReusableTemplate, createTemplatePromise, createUnrefFn, customStorageEventName, defaultDocument, defaultLocation, defaultNavigator, defaultWindow, executeTransition, formatTimeAgo, getSSRHandler, mapGamepadToXbox360Controller, onClickOutside, onKeyDown, onKeyPressed, onKeyStroke, onKeyUp, onLongPress, onStartTyping, setSSRHandler, templateRef, unrefElement, useActiveElement, useAnimate, useAsyncQueue, useAsyncState, useBase64, useBattery, useBluetooth, useBreakpoints, useBroadcastChannel, useBrowserLocation, useCached, useClipboard, useCloned, useColorMode, useConfirmDialog, useCssVar, useCurrentElement, useCycleList, useDark, useDebouncedRefHistory, 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, useKeyModifier, useLocalStorage, useMagicKeys, useManualRefHistory, useMediaControls, useMediaQuery, useMemoize, useMemory, useMounted, useMouse, useMouseInElement, useMousePressed, useMutationObserver, useNavigatorLanguage, useNetwork, 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, useTextDirection, useTextSelection, useTextareaAutosize, useThrottledRefHistory, useTimeAgo, useTimeoutPoll, useTimestamp, useTitle, useTransition, useToggle, useUrlSearchParams, useUserMedia, useVModel, useVModels, useVibrate, useVirtualList, useWakeLock, useWebNotification, useWebSocket, useWebWorker, useWebWorkerFn, useWindowFocus, useWindowScroll, useWindowSize, useDateFormat, useNow, watchArray, watchAtMost, watchDebounced, watchDeep, watchIgnorable, watchImmediate, watchOnce, watchPausable, watchThrottled, watchTriggerable, watchWithFilter, whenever, syncRef, syncRefs, throttledRef, throttledWatch, toReactive, tryOnBeforeMount, tryOnBeforeUnmount, tryOnMounted, tryOnScopeDispose, tryOnUnmounted, until, isDefined, ignorableWatch, extendRef, eagerComputed, debouncedRef, debouncedWatch, createReactiveFn, createSharedComposable, createInjectionState, createGlobalState, createEventHook, controlledRef, controlledComputed, computedEager, computedWithControl, autoResetRef, injectLocal, makeDestructurable, pausableWatch, provideLocal, reactify, reactifyObject, reactiveComputed, reactiveOmit, reactivePick, refAutoReset, refDebounced, refDefault, refThrottled, refWithControl, resolveRef, resolveUnref, useArrayDifference, useArrayEvery, useArrayFilter, useArrayFind, useArrayFindIndex, useArrayIncludes, useArrayMap, useArrayReduce, useArraySome, useArrayUnique, useClipboardItems, useCounter, useDebounce, useDebounceFn, useInterval, useIntervalFn, useLastChanged, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useToNumber, useToString, } from '@vueuse/core';
+export type { HeadObject, HeadObjectPlain, } from '@vueuse/head';
+export { Head, HeadVuePlugin, createHead, renderHeadToString, } from '@vueuse/head';
+export { default as readableSize } from 'pretty-bytes';

package/dist/versions.d.ts

@@ -0,0 +1,2 @@
+import { version } from '../package.json';
+export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/utils",
   "type": "module",
-  "version": "0.58.72",
+  "version": "0.59.1",
   "description": "The Stacks helper functions.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -63,14 +63,14 @@
     "@stacksjs/strings": "latest",
     "@stacksjs/types": "latest",
     "@types/js-yaml": "^4.0.9",
-    "@vueuse/core": "^10.7.2",
+    "@vueuse/core": "^10.9.0",
     "@vueuse/head": "^2.0.0",
-    "@vueuse/math": "^10.7.2",
-    "@vueuse/shared": "^10.7.2",
+    "@vueuse/math": "^10.9.0",
+    "@vueuse/shared": "^10.9.0",
+    "bun-plugin-env": "^0.4.1",
+    "bun-plugin-yml": "^0.3.0",
     "export-size": "^0.7.0",
-    "js-yaml": "^4.1.0",
-    "rimraf": "^5.0.5",
-    "yaml": "^2.3.4"
+    "yaml": "^2.4.0"
   },
   "dependencies": {
     "@dinero.js/currencies": "2.0.0-alpha.14",
@@ -83,10 +83,12 @@
     "@stacksjs/storage": "latest",
     "@stacksjs/strings": "latest",
     "@stacksjs/types": "latest",
-    "@vueuse/core": "^10.7.2",
+    "@vueuse/core": "^10.9.0",
     "@vueuse/head": "^2.0.0",
-    "@vueuse/math": "^10.7.2",
-    "@vueuse/shared": "^10.7.2",
+    "@vueuse/math": "^10.9.0",
+    "@vueuse/shared": "^10.9.0",
+    "bun-plugin-env": "^0.4.1",
+    "bun-plugin-yml": "^0.3.0",
     "defu": "^6.1.4",
     "detect-indent": "^7.0.1",
     "detect-newline": "^4.0.1",
@@ -99,8 +101,7 @@
     "p-limit": "^5.0.0",
     "perfect-debounce": "^1.0.0",
     "pretty-bytes": "^6.1.1",
-    "rimraf": "^5.0.5",
-    "yaml": "^2.3.4"
+    "yaml": "^2.4.0"
   },
   "devDependencies": {
     "@stacksjs/development": "latest",

package/src/clean.ts

@@ -1,17 +1,15 @@
 import { path as p } from '@stacksjs/path'
-import { rimraf } from './delete'
+import { $ } from 'bun'
 
 export async function cleanProject() {
-  return await rimraf([
-    p.projectPath('bun.lockb'),
-    p.projectPath('yarn.lock'),
-    p.projectPath('node_modules/'),
-    p.frameworkPath('dist'),
-    p.frameworkPath('node_modules'),
-    p.frameworkPath('**/dist'),
-    p.frameworkPath('**/node_modules'),
-    p.frameworkCloudPath('cdk.out/'),
-    p.frameworkCloudPath('cdk.context.json'),
-    p.frameworkCloudPath('dist.zip'),
-  ])
+  await $`rm -rf ${p.projectPath('bun.lockb')}`
+  await $`rm -rf ${p.projectPath('yarn.lock')}` // just in case
+  await $`rm -rf ${p.projectPath('node_modules/')}`
+  await $`rm -rf ${p.frameworkPath('dist')}`
+  await $`rm -rf ${p.frameworkPath('node_modules')}`
+  await $`rm -rf ${p.frameworkPath('**/dist')}`
+  await $`rm -rf ${p.frameworkPath('**/node_modules')}`
+  await $`rm -rf ${p.frameworkCloudPath('cdk.out/')}`
+  await $`rm -rf ${p.frameworkCloudPath('cdk.context.json')}`
+  await $`rm -rf ${p.frameworkCloudPath('dist.zip')}`
 }

package/src/find.ts

@@ -0,0 +1,97 @@
+import os from 'node:os'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import type { Dirent } from 'node:fs'
+import { italic } from '@stacksjs/cli'
+import { log } from '@stacksjs/logging'
+
+const targetFileName = 'buddy' // The exact name of the target file
+
+// Assuming excludePatterns is defined somewhere in your script
+const excludePatterns = [
+  'node_modules',
+  'dist',
+  'vendor',
+  `${os.homedir()}/Documents`,
+  `${os.homedir()}/Pictures`,
+  `${os.homedir()}/Library`,
+  `${os.homedir()}/.Trash`,
+  /.*out.*|.*\.out.*|out-.*/, // exclude any folder with 'out' in the name
+  /.*\/\..*/, // exclude any folder that starts with a dot
+]
+
+interface FindStacksProjectsOptions {
+  quiet?: boolean
+}
+
+export async function findStacksProjects(dir?: string, options?: FindStacksProjectsOptions): Promise<string[]> {
+  dir = dir || os.homedir()
+
+  if (!options?.quiet) {
+    log.info(`Searching for Stacks projects in: ${italic(dir)}`)
+    log.info(`This may take a few moments...`)
+    // eslint-disable-next-line no-console
+    console.log('')
+    // eslint-disable-next-line no-console
+    console.log(italic('  Please note, while Stacks is searching for projects on your machine,'))
+    // eslint-disable-next-line no-console
+    console.log(italic('  you may be asked for permissions to scan certain directories.'))
+    // eslint-disable-next-line no-console
+    console.log('')
+    log.debug(`Excluding directories: ${excludePatterns.join(', ')}`)
+  }
+
+  const foundProjects = await searchDirectory(dir)
+
+  if (!foundProjects)
+    throw new Error('No Stacks projects found')
+
+  return foundProjects
+}
+
+async function searchDirectory(directory: string) {
+  const foundProjects: string[] = []
+
+  const isExcluded = excludePatterns.some(pattern => typeof pattern === 'string' ? directory.includes(pattern) : pattern.test(directory))
+  if (isExcluded)
+    return
+
+  let items: Dirent[]
+  try {
+    items = await fs.readdir(directory, { withFileTypes: true })
+  }
+  catch (error) {
+    console.error(`Error reading directory ${directory}:`, error)
+    return
+  }
+
+  let buddyFileFound = false
+  let storageDirFound = false
+
+  for (const item of items) {
+    if (item.isFile() && item.name === targetFileName) {
+      buddyFileFound = true
+    }
+    else if (item.isDirectory()) {
+      // Recursively search in directories
+      const fullPath = path.join(directory, item.name)
+      if (item.name === 'storage') {
+        // Check if the 'storage/framework/core/buddy/' structure exists within this directory
+        try {
+          const storagePath = path.join(fullPath, 'framework/core/buddy')
+          await fs.access(storagePath)
+          storageDirFound = true
+        }
+        catch (error) {
+          // The specific directory structure does not exist
+        }
+      }
+      await searchDirectory(fullPath)
+    }
+  }
+
+  if (buddyFileFound && storageDirFound)
+    foundProjects.push(directory) // Both conditions are met
+
+  return foundProjects
+}

package/src/index.ts

@@ -3,9 +3,9 @@ export * from './clean'
 export * from './config'
 export * from './currency'
 export * from './debounce'
-export * from './delete'
 export * from './equal'
 export * from './export-size'
+export * from './find'
 export * from './function'
 export * from './git'
 export * from './guards'

package/src/delete.ts

@@ -1 +0,0 @@
-export { rimraf } from 'rimraf'