@stacksjs/utils 0.70.87 → 0.70.90

package/dist/bytes.js

@@ -0,0 +1,55 @@
+const DECIMAL_UNITS = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"], BINARY_UNITS = ["B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
+export function formatBytes(bytes, options = {}) {
+  const {
+    precision = 1,
+    binary = !1,
+    space = !0,
+    locale = "en-US",
+    minimumFractionDigits = 0,
+    maximumFractionDigits = precision
+  } = options;
+  if (!Number.isFinite(bytes))
+    throw TypeError(`Expected a finite number, got ${typeof bytes}: ${bytes}`);
+  const isNegative = bytes < 0, prefix = isNegative ? "-" : "";
+  if (isNegative)
+    bytes = -bytes;
+  if (bytes < 1) {
+    const numberString = bytes.toLocaleString(locale, {
+      minimumFractionDigits,
+      maximumFractionDigits
+    });
+    return `${prefix}${numberString}${space ? " " : ""}B`;
+  }
+  const base = binary ? 1024 : 1000, units = binary ? BINARY_UNITS : DECIMAL_UNITS, exponent = Math.min(Math.floor(Math.log(bytes) / Math.log(base)), units.length - 1), numberString = (bytes / base ** exponent).toLocaleString(locale, {
+    minimumFractionDigits,
+    maximumFractionDigits
+  }), unit = units[exponent];
+  return `${prefix}${numberString}${space ? " " : ""}${unit}`;
+}
+export function parseBytes(input) {
+  const match = input.match(/^(-?[\d.]+)\s*([A-Za-z]+)?$/);
+  if (!match)
+    throw Error(`Invalid byte string: ${input}`);
+  const [, numberStr, unit = "B"] = match;
+  if (numberStr === void 0)
+    throw Error(`Invalid byte string: ${input}`);
+  const number = Number.parseFloat(numberStr);
+  if (!Number.isFinite(number))
+    throw Error(`Invalid number in byte string: ${numberStr}`);
+  const normalizedUnit = unit.toUpperCase(), isBinary = normalizedUnit.endsWith("IB"), base = isBinary ? 1024 : 1000;
+  let exponent = 0;
+  const units = isBinary ? BINARY_UNITS : DECIMAL_UNITS;
+  for (let i = 0;i < units.length; i++)
+    if (units[i]?.toUpperCase() === normalizedUnit) {
+      exponent = i;
+      break;
+    }
+  return number * base ** exponent;
+}
+export function compareBytes(a, b) {
+  const bytesA = typeof a === "string" ? parseBytes(a) : a, bytesB = typeof b === "string" ? parseBytes(b) : b;
+  return bytesA - bytesB;
+}
+export const prettyBytes = formatBytes, readableSize = formatBytes;
+
+export { formatBytes as default };

package/dist/clean.js

@@ -0,0 +1,13 @@
+import { path as p } from "@stacksjs/path";
+export async function cleanProject() {
+  await Bun.$`rm -rf ${p.projectPath("bun.lock")}`;
+  await Bun.$`rm -rf ${p.projectPath("yarn.lock")}`;
+  await Bun.$`rm -rf ${p.projectPath("node_modules/")}`;
+  await Bun.$`rm -rf ${p.frameworkPath("dist")}`;
+  await Bun.$`rm -rf ${p.frameworkPath("node_modules")}`;
+  await Bun.$`rm -rf ${p.frameworkPath("**/dist")}`;
+  await Bun.$`rm -rf ${p.frameworkPath("**/node_modules")}`;
+  await Bun.$`rm -rf ${p.frameworkCloudPath("cdk.out/")}`;
+  await Bun.$`rm -rf ${p.frameworkCloudPath("cdk.context.json")}`;
+  await Bun.$`rm -rf ${p.cloudPath("dist.zip")}`;
+}

package/dist/colors.js

@@ -0,0 +1,100 @@
+const isColorSupported = !process.env.NO_COLOR && (process.env.FORCE_COLOR || process.stdout?.isTTY), colors = {
+  reset: isColorSupported ? "\x1B[0m" : "",
+  black: isColorSupported ? "\x1B[30m" : "",
+  red: isColorSupported ? "\x1B[31m" : "",
+  green: isColorSupported ? "\x1B[32m" : "",
+  yellow: isColorSupported ? "\x1B[33m" : "",
+  blue: isColorSupported ? "\x1B[34m" : "",
+  magenta: isColorSupported ? "\x1B[35m" : "",
+  cyan: isColorSupported ? "\x1B[36m" : "",
+  white: isColorSupported ? "\x1B[37m" : "",
+  gray: isColorSupported ? "\x1B[90m" : "",
+  grey: isColorSupported ? "\x1B[90m" : "",
+  lightRed: isColorSupported ? "\x1B[91m" : "",
+  lightGreen: isColorSupported ? "\x1B[92m" : "",
+  lightYellow: isColorSupported ? "\x1B[93m" : "",
+  lightBlue: isColorSupported ? "\x1B[94m" : "",
+  lightMagenta: isColorSupported ? "\x1B[95m" : "",
+  lightCyan: isColorSupported ? "\x1B[96m" : "",
+  lightGray: isColorSupported ? "\x1B[37m" : "",
+  lightGrey: isColorSupported ? "\x1B[37m" : "",
+  bgBlack: isColorSupported ? "\x1B[40m" : "",
+  bgRed: isColorSupported ? "\x1B[41m" : "",
+  bgGreen: isColorSupported ? "\x1B[42m" : "",
+  bgYellow: isColorSupported ? "\x1B[43m" : "",
+  bgBlue: isColorSupported ? "\x1B[44m" : "",
+  bgMagenta: isColorSupported ? "\x1B[45m" : "",
+  bgCyan: isColorSupported ? "\x1B[46m" : "",
+  bgWhite: isColorSupported ? "\x1B[47m" : "",
+  bgLightRed: isColorSupported ? "\x1B[101m" : "",
+  bgLightGreen: isColorSupported ? "\x1B[102m" : "",
+  bgLightYellow: isColorSupported ? "\x1B[103m" : "",
+  bgLightBlue: isColorSupported ? "\x1B[104m" : "",
+  bgLightMagenta: isColorSupported ? "\x1B[105m" : "",
+  bgLightCyan: isColorSupported ? "\x1B[106m" : "",
+  bold: isColorSupported ? "\x1B[1m" : "",
+  dim: isColorSupported ? "\x1B[2m" : "",
+  italic: isColorSupported ? "\x1B[3m" : "",
+  underline: isColorSupported ? "\x1B[4m" : "",
+  inverse: isColorSupported ? "\x1B[7m" : "",
+  hidden: isColorSupported ? "\x1B[8m" : "",
+  strikethrough: isColorSupported ? "\x1B[9m" : ""
+};
+function createColorFn(code, endCode = colors.reset) {
+  return (text) => {
+    if (!isColorSupported)
+      return String(text);
+    return `${code}${text}${endCode}`;
+  };
+}
+export const black = createColorFn(colors.black), red = createColorFn(colors.red), green = createColorFn(colors.green), yellow = createColorFn(colors.yellow), blue = createColorFn(colors.blue), magenta = createColorFn(colors.magenta), cyan = createColorFn(colors.cyan), white = createColorFn(colors.white), gray = createColorFn(colors.gray), grey = gray, lightRed = createColorFn(colors.lightRed), lightGreen = createColorFn(colors.lightGreen), lightYellow = createColorFn(colors.lightYellow), lightBlue = createColorFn(colors.lightBlue), lightMagenta = createColorFn(colors.lightMagenta), lightCyan = createColorFn(colors.lightCyan), lightGray = createColorFn(colors.lightGray), lightGrey = lightGray, bgBlack = createColorFn(colors.bgBlack), bgRed = createColorFn(colors.bgRed), bgGreen = createColorFn(colors.bgGreen), bgYellow = createColorFn(colors.bgYellow), bgBlue = createColorFn(colors.bgBlue), bgMagenta = createColorFn(colors.bgMagenta), bgCyan = createColorFn(colors.bgCyan), bgWhite = createColorFn(colors.bgWhite), bgLightRed = createColorFn(colors.bgLightRed), bgLightGreen = createColorFn(colors.bgLightGreen), bgLightYellow = createColorFn(colors.bgLightYellow), bgLightBlue = createColorFn(colors.bgLightBlue), bgLightMagenta = createColorFn(colors.bgLightMagenta), bgLightCyan = createColorFn(colors.bgLightCyan), bold = createColorFn(colors.bold), dim = createColorFn(colors.dim), italic = createColorFn(colors.italic), underline = createColorFn(colors.underline), inverse = createColorFn(colors.inverse), hidden = createColorFn(colors.hidden), strikethrough = createColorFn(colors.strikethrough), reset = createColorFn(colors.reset, "");
+export function stripColors(text) {
+  return text.replace(/\x1B\[\d+m/g, "");
+}
+export function supportsColor() {
+  return !!isColorSupported;
+}
+export default {
+  black,
+  red,
+  green,
+  yellow,
+  blue,
+  magenta,
+  cyan,
+  white,
+  gray,
+  grey,
+  lightRed,
+  lightGreen,
+  lightYellow,
+  lightBlue,
+  lightMagenta,
+  lightCyan,
+  lightGray,
+  lightGrey,
+  bgBlack,
+  bgRed,
+  bgGreen,
+  bgYellow,
+  bgBlue,
+  bgMagenta,
+  bgCyan,
+  bgWhite,
+  bgLightRed,
+  bgLightGreen,
+  bgLightYellow,
+  bgLightBlue,
+  bgLightMagenta,
+  bgLightCyan,
+  bold,
+  dim,
+  italic,
+  underline,
+  inverse,
+  hidden,
+  strikethrough,
+  reset,
+  stripColors,
+  supportsColor
+};

package/dist/config.js

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

package/dist/debounce.js

@@ -0,0 +1,77 @@
+export function debounce(fn, wait = 0, options = {}) {
+  const { leading = !1, trailing = !0 } = options;
+  let timeout = null, lastArgs = null, lastThis = null, result;
+  const invokeFunc = () => {
+    if (lastArgs) {
+      result = fn.apply(lastThis, lastArgs);
+      lastArgs = null;
+      lastThis = null;
+    }
+    return result;
+  }, cancel = () => {
+    if (timeout) {
+      clearTimeout(timeout);
+      timeout = null;
+    }
+    lastArgs = null;
+    lastThis = null;
+  }, flush = () => {
+    if (timeout) {
+      clearTimeout(timeout);
+      timeout = null;
+      return invokeFunc();
+    }
+    return result;
+  }, debounced = function(...args) {
+    lastArgs = args;
+    lastThis = this;
+    const shouldCallNow = leading && !timeout;
+    if (timeout)
+      clearTimeout(timeout);
+    timeout = setTimeout(() => {
+      timeout = null;
+      if (trailing && lastArgs)
+        invokeFunc();
+    }, wait);
+    if (shouldCallNow)
+      return invokeFunc();
+    return result;
+  };
+  debounced.cancel = cancel;
+  debounced.flush = flush;
+  return debounced;
+}
+export function throttle(fn, wait = 0) {
+  let timeout = null, lastRun = 0, lastArgs = null, lastThis = null;
+  const invokeFunc = () => {
+    if (lastArgs) {
+      fn.apply(lastThis, lastArgs);
+      lastArgs = null;
+      lastThis = null;
+      lastRun = Date.now();
+    }
+  }, cancel = () => {
+    if (timeout) {
+      clearTimeout(timeout);
+      timeout = null;
+    }
+    lastArgs = null;
+    lastThis = null;
+  }, throttled = function(...args) {
+    lastArgs = args;
+    lastThis = this;
+    const timeSinceLastRun = Date.now() - lastRun;
+    if (timeSinceLastRun >= wait)
+      invokeFunc();
+    else if (!timeout)
+      timeout = setTimeout(() => {
+        timeout = null;
+        invokeFunc();
+      }, wait - timeSinceLastRun);
+  };
+  throttled.cancel = cancel;
+  return throttled;
+}
+export function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/detect.js

@@ -0,0 +1,65 @@
+export function detectIndent(text) {
+  const lines = text.split(`
+`), indents = [];
+  for (const line of lines) {
+    if (!line.trim())
+      continue;
+    const match = line.match(/^(\s+)/);
+    if (match && match[1] !== void 0)
+      indents.push(match[1]);
+  }
+  if (indents.length === 0)
+    return { amount: 0, type: null, indent: "" };
+  const indentCounts = new Map;
+  for (const indent of indents)
+    indentCounts.set(indent, (indentCounts.get(indent) || 0) + 1);
+  let mostCommon = "", maxCount = 0;
+  for (const [indent, count] of indentCounts)
+    if (count > maxCount) {
+      maxCount = count;
+      mostCommon = indent;
+    }
+  if (mostCommon.includes("\t"))
+    return {
+      amount: mostCommon.length,
+      type: "tab",
+      indent: mostCommon
+    };
+  return {
+    amount: mostCommon.length,
+    type: "space",
+    indent: mostCommon
+  };
+}
+export function detectNewline(text) {
+  if (!text)
+    return null;
+  if (text.includes(`\r
+`))
+    return `\r
+`;
+  if (text.includes(`
+`))
+    return `
+`;
+  if (text.includes("\r"))
+    return "\r";
+  return null;
+}
+export function detectNewlineGraceful(text, fallback = `
+`) {
+  return detectNewline(text) || fallback;
+}
+export function normalizeNewlines(text, newline = `
+`) {
+  return text.replace(/\r\n|\r|\n/g, newline);
+}
+export function countNewlines(text) {
+  const crlf = (text.match(/\r\n/g) || []).length, cr = (text.match(/\r(?!\n)/g) || []).length, lf = (text.match(/(?<!\r)\n/g) || []).length;
+  return {
+    crlf,
+    lf,
+    cr,
+    total: crlf + lf + cr
+  };
+}

package/dist/equal.js

@@ -0,0 +1,27 @@
+import { getTypeName } from "@stacksjs/types";
+export function isDeepEqual(value1, value2, seen = new WeakMap) {
+  if (value1 === value2)
+    return !0;
+  if (typeof value1 === "number" && typeof value2 === "number" && Number.isNaN(value1) && Number.isNaN(value2))
+    return !0;
+  const type1 = getTypeName(value1), type2 = getTypeName(value2);
+  if (type1 !== type2)
+    return !1;
+  if (value1 && typeof value1 === "object") {
+    if (seen.get(value1) === value2)
+      return !0;
+    seen.set(value1, value2);
+  }
+  if (type1 === "array") {
+    if (value1.length !== value2.length)
+      return !1;
+    return value1.every((item, i) => isDeepEqual(item, value2[i], seen));
+  }
+  if (type1 === "object") {
+    const keyArr = Object.keys(value1);
+    if (keyArr.length !== Object.keys(value2).length)
+      return !1;
+    return keyArr.every((key) => isDeepEqual(value1[key], value2[key], seen));
+  }
+  return Object.is(value1, value2);
+}

package/dist/errors.js

@@ -0,0 +1,44 @@
+export function getErrorMessage(e) {
+  if (e instanceof Error)
+    return e.message;
+  if (typeof e === "string")
+    return e;
+  if (typeof e === "number" || typeof e === "boolean")
+    return String(e);
+  if (e && typeof e === "object" && "message" in e && typeof e.message === "string")
+    return e.message;
+  if (e == null)
+    return "Unknown error";
+  try {
+    return String(e);
+  } catch {
+    return "Unknown error";
+  }
+}
+export function getErrorStack(e) {
+  if (e instanceof Error)
+    return e.stack;
+  if (e && typeof e === "object" && "stack" in e && typeof e.stack === "string")
+    return e.stack;
+  return;
+}
+export function getErrorCode(e) {
+  if (e && typeof e === "object" && "code" in e && typeof e.code === "string")
+    return e.code;
+  return;
+}
+export function getErrorStatusCode(e) {
+  if (!e || typeof e !== "object")
+    return;
+  const obj = e;
+  if (typeof obj.statusCode === "number" && Number.isFinite(obj.statusCode))
+    return obj.statusCode;
+  if (typeof obj.status === "number" && Number.isFinite(obj.status))
+    return obj.status;
+  return;
+}
+export function toError(e) {
+  if (e instanceof Error)
+    return e;
+  return Error(getErrorMessage(e), { cause: e });
+}

package/dist/export-size.js

@@ -0,0 +1 @@
+export { getExportsSize } from "./size";

package/dist/find.js

@@ -0,0 +1,68 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { italic } from "@stacksjs/cli";
+import { log } from "@stacksjs/logging";
+const targetFileName = "buddy", alwaysExcludePatterns = [
+  "node_modules",
+  "dist",
+  "vendor",
+  "storage/framework",
+  /.*out.*/,
+  /.*\/\..*/
+], homeOnlyExcludePatterns = [
+  `${os.homedir()}/Documents`,
+  `${os.homedir()}/Pictures`,
+  `${os.homedir()}/Library`,
+  `${os.homedir()}/.Trash`
+];
+export async function findStacksProjects(dir, options) {
+  const dirWasExplicit = !!dir;
+  dir = dir || os.homedir();
+  const excludePatterns = dirWasExplicit ? alwaysExcludePatterns : [...alwaysExcludePatterns, ...homeOnlyExcludePatterns];
+  if (!options?.quiet) {
+    log.info(`Searching for Stacks projects in: ${italic(dir)}`);
+    log.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("");
+    log.debug(`Excluding directories: ${excludePatterns.join(", ")}`);
+  }
+  const foundProjects = await searchDirectory(dir, excludePatterns);
+  if (!foundProjects)
+    throw Error("No Stacks projects found");
+  return foundProjects;
+}
+async function searchDirectory(directory, excludePatterns) {
+  const foundProjects = [];
+  if (excludePatterns.some((pattern) => typeof pattern === "string" ? directory.includes(pattern) : pattern.test(directory)))
+    return foundProjects;
+  let items;
+  try {
+    items = await fs.readdir(directory, { withFileTypes: !0 });
+  } catch (error) {
+    console.error(`Error reading directory ${directory}:`, error);
+    return foundProjects;
+  }
+  let buddyFileFound = !1, storageDirFound = !1;
+  for (const item of items) {
+    if (item.isFile() && item.name === targetFileName)
+      buddyFileFound = !0;
+    if (item.isDirectory()) {
+      const fullPath = path.join(directory, item.name);
+      if (item.name === "storage") {
+        const storagePath = path.join(fullPath, "framework/core/buddy");
+        try {
+          await fs.access(storagePath);
+          storageDirFound = !0;
+        } catch {}
+      }
+      const subDirProjects = await searchDirectory(fullPath, excludePatterns);
+      foundProjects.push(...subDirProjects);
+    }
+  }
+  if (buddyFileFound && storageDirFound)
+    foundProjects.push(directory);
+  return foundProjects;
+}

package/dist/git.js

@@ -0,0 +1,11 @@
+import { execSync } from "node:child_process";
+import { handleError } from "@stacksjs/error-handling";
+export function isGitClean() {
+  try {
+    execSync("git diff-index --quiet HEAD --");
+    return !0;
+  } catch (error) {
+    handleError(error);
+    return !1;
+  }
+}

package/dist/glob.d.ts

@@ -0,0 +1 @@
+export { glob } from '@stacksjs/storage';

package/dist/glob.js

@@ -0,0 +1 @@
+export { glob } from "@stacksjs/storage";

package/dist/hash.js

@@ -0,0 +1,36 @@
+import { config } from "@stacksjs/config";
+import { log } from "@stacksjs/logging";
+import { path } from "@stacksjs/path";
+import { hashPaths } from "@stacksjs/storage";
+export function originRequestFunctionHash() {
+  try {
+    return hashPaths(path.cloudPath("src/edge"));
+  } catch (error) {
+    log.error("Are we in a Docker container? Failed to hash paths. Error below:");
+    log.error(error);
+    return;
+  }
+}
+export function websiteSourceHash() {
+  const docsSrc = [
+    path.projectPath("docs"),
+    path.frameworkPath("docs/dist")
+  ], websiteSrc = [
+    path.projectPath("resources/views"),
+    path.projectPath("resources/assets"),
+    path.projectPath("resources/lang"),
+    path.projectPath("resources/functions"),
+    path.projectPath("resources/components"),
+    path.projectPath("resources/modules"),
+    path.projectPath("resources/stores"),
+    path.frameworkPath("views/web")
+  ];
+  return config.app.docMode === !0 ? hashPaths(docsSrc) : hashPaths(websiteSrc);
+}
+export function docsSourceHash() {
+  const docsSrc = [
+    path.projectPath("docs"),
+    path.frameworkPath("docs/dist")
+  ];
+  return hashPaths(docsSrc);
+}

package/dist/helpers.js

@@ -0,0 +1,101 @@
+import { runAction } from "@stacksjs/actions";
+import { log, runCommand } from "@stacksjs/cli";
+import { app, ui } from "@stacksjs/config";
+import { Action } from "@stacksjs/enums";
+import { err, handleError, ok } from "@stacksjs/error-handling";
+import { frameworkPath, projectPath } from "@stacksjs/path";
+import { fs, readJsonFile, readPackageJson, readTextFile, writeTextFile } from "@stacksjs/storage";
+export async function packageManager() {
+  const { packageManager } = await readPackageJson(frameworkPath("package.json"));
+  return packageManager;
+}
+export async function initProject() {
+  if (app.env !== "production")
+    log.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));
+  log.info("Application key generated.");
+  return ok(result.value);
+}
+export async function ensureProjectIsInitialized() {
+  if (fs.existsSync(projectPath(".env")))
+    return await isAppKeySet();
+  if (fs.existsSync(projectPath(".env.example")))
+    fs.copyFileSync(projectPath(".env.example"), projectPath(".env"));
+  else
+    console.error("no .env.example file found");
+  return await isAppKeySet();
+}
+export async function installIfVersionMismatch() {}
+export async function frameworkVersion() {
+  return (await readPackageJson(frameworkPath("package.json"))).version;
+}
+export async function isAppKeySet() {
+  const appKey = (await readTextFile(".env", projectPath())).data.split(`
+`).find((line) => line.startsWith("APP_KEY="));
+  return !!(appKey && appKey.length > 16);
+}
+export function determineResetPreset(preset) {
+  if (preset === void 0 && ui.reset)
+    preset = ui.reset;
+  if (preset === null)
+    return [];
+  const resetImport = {
+    tailwind: 'import { tailwindPreflight as reset } from "@cwcss/crosswind"',
+    preflight: 'import { tailwindPreflight as reset } from "@cwcss/crosswind"',
+    forms: 'import { tailwindFormsPreflight as reset } from "@cwcss/crosswind"'
+  }[preset ?? "tailwind"];
+  return resetImport ? [resetImport] : [];
+}
+export function isManifest(obj) {
+  return obj && typeof obj === "object" && isOptionalString(obj.name) && isOptionalString(obj.version) && isOptionalString(obj.description);
+}
+export function isOptionalString(value) {
+  const type = typeof value;
+  return value === null || type === "undefined" || type === "string";
+}
+export async function setEnvValue(key, value) {
+  const file = await readTextFile(projectPath(".env")), escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), keyPattern = new RegExp(`^${escapedKey}=.*$`, "m"), nextValue = `${key}=${value}`, data = keyPattern.test(file.data) ? file.data.replace(keyPattern, nextValue) : `${file.data}${file.data.endsWith(`
+`) ? "" : `
+`}${nextValue}
+`;
+  await writeTextFile({
+    path: projectPath(".env"),
+    data
+  });
+}
+export async function runNpmScript(script, options) {
+  const { data: manifest } = await readJsonFile("package.json", frameworkPath());
+  if (isManifest(manifest) && hasScript(manifest, script))
+    return await runCommand(`bun run ${script}`, options);
+  return err(handleError(`The ${script} script does not exist in the package.json file.`));
+}
+export function hasScript(manifest, script) {
+  const scripts = manifest.scripts;
+  if (scripts && typeof scripts === "object")
+    return Boolean(scripts[script]);
+  return !1;
+}
+export function parseYaml(content) {
+  return Bun.YAML.parse(content);
+}
+export function determineDebugLevel(options) {
+  if (options?.verbose === !0)
+    return !0;
+  return app.debug === !0;
+}
+export function isIpv6(address) {
+  return address.family === "IPv6" || address.family === 6;
+}
+export function dumpYaml(content) {
+  const yaml = Bun.YAML;
+  if (typeof yaml.stringify === "function")
+    return yaml.stringify(content);
+  return JSON.stringify(content, null, 2);
+}
+export function loadYaml(content) {
+  return Bun.YAML.parse(content);
+}

package/dist/index.js

@@ -1,16 +1,23 @@
-// @bun
-import{path as L}from"@stacksjs/path";async function S$(){await Bun.$`rm -rf ${L.projectPath("bun.lock")}`,await Bun.$`rm -rf ${L.projectPath("yarn.lock")}`,await Bun.$`rm -rf ${L.projectPath("node_modules/")}`,await Bun.$`rm -rf ${L.frameworkPath("dist")}`,await Bun.$`rm -rf ${L.frameworkPath("node_modules")}`,await Bun.$`rm -rf ${L.frameworkPath("**/dist")}`,await Bun.$`rm -rf ${L.frameworkPath("**/node_modules")}`,await Bun.$`rm -rf ${L.frameworkCloudPath("cdk.out/")}`,await Bun.$`rm -rf ${L.frameworkCloudPath("cdk.context.json")}`,await Bun.$`rm -rf ${L.cloudPath("dist.zip")}`}import{defineApp as p$,defineCache as g$,defineCdn as b$,defineChat as m$,defineCli as d$,defineDatabase as u$,defineDependencies as c$,defineDns as n$,defineEmail as i$,defineEmailConfig as s$,defineGit as r$,defineHashing as a$,defineLibrary as o$,defineNotification as l$,definePayment as t$,defineQueue as e$,defineSearchEngine as $T,defineServices as TT,defineSms as fT,defineFilesystems as HT,defineUi as QT}from"@stacksjs/config";import{getTypeName as S}from"@stacksjs/types";function v($,T,f=new WeakMap){if($===T)return!0;if(typeof $==="number"&&typeof T==="number"&&Number.isNaN($)&&Number.isNaN(T))return!0;let H=S($),Q=S(T);if(H!==Q)return!1;if($&&typeof $==="object"){if(f.get($)===T)return!0;f.set($,T)}if(H==="array"){if($.length!==T.length)return!1;return $.every((X,_)=>v(X,T[_],f))}if(H==="object"){let X=Object.keys($);if(X.length!==Object.keys(T).length)return!1;return X.every((_)=>v($[_],T[_],f))}return Object.is($,T)}function $$($){if($ instanceof Error)return $.message;if(typeof $==="string")return $;if(typeof $==="number"||typeof $==="boolean")return String($);if($&&typeof $==="object"&&"message"in $&&typeof $.message==="string")return $.message;if($==null)return"Unknown error";try{return String($)}catch{return"Unknown error"}}function qT($){if($ instanceof Error)return $.stack;if($&&typeof $==="object"&&"stack"in $&&typeof $.stack==="string")return $.stack;return}function VT($){if($&&typeof $==="object"&&"code"in $&&typeof $.code==="string")return $.code;return}function _T($){if(!$||typeof $!=="object")return;let T=$;if(typeof T.statusCode==="number"&&Number.isFinite(T.statusCode))return T.statusCode;if(typeof T.status==="number"&&Number.isFinite(T.status))return T.status;return}function PT($){if($ instanceof Error)return $;return Error($$($),{cause:$})}import{stat as T$}from"fs/promises";var C=["B","KB","MB","GB","TB","PB","EB","ZB","YB"],p=["B","KiB","MiB","GiB","TiB","PiB","EiB","ZiB","YiB"];function I($,T={}){let{precision:f=1,binary:H=!1,space:Q=!0,locale:X="en-US",minimumFractionDigits:_=0,maximumFractionDigits:P=f}=T;if(!Number.isFinite($))throw TypeError(`Expected a finite number, got ${typeof $}: ${$}`);let B=$<0,J=B?"-":"";if(B)$=-$;if($<1){let e=$.toLocaleString(X,{minimumFractionDigits:_,maximumFractionDigits:P});return`${J}${e}${Q?" ":""}B`}let G=H?1024:1000,Y=H?p:C,U=Math.min(Math.floor(Math.log($)/Math.log(G)),Y.length-1),O=($/G**U).toLocaleString(X,{minimumFractionDigits:_,maximumFractionDigits:P}),W=Y[U];return`${J}${O}${Q?" ":""}${W}`}function y($){let T=$.match(/^(-?[\d.]+)\s*([A-Za-z]+)?$/);if(!T)throw Error(`Invalid byte string: ${$}`);let[,f,H="B"]=T;if(f===void 0)throw Error(`Invalid byte string: ${$}`);let Q=Number.parseFloat(f);if(!Number.isFinite(Q))throw Error(`Invalid number in byte string: ${f}`);let X=H.toUpperCase(),_=X.endsWith("IB"),P=_?1024:1000,B=0,J=_?p:C;for(let G=0;G<J.length;G++)if(J[G]?.toUpperCase()===X){B=G;break}return Q*P**B}function GT($,T){let f=typeof $==="string"?y($):$,H=typeof T==="string"?y(T):T;return f-H}var JT=I,UT=I;async function f$($){try{return(await T$($)).size}catch{return 0}}async function H$($){let T=[],f=0;try{let H=await Q$($);for(let Q of H){let X=await f$(Q.path);f+=X,T.push({name:Q.name,size:X,readable:I(X)})}}catch(H){}return{totalSize:f,totalReadable:I(f),exports:T.sort((H,Q)=>Q.size-H.size)}}async function Q$($){let T=[];try{let f=await Bun.$.throws(!1)`find ${$} -type f \\( -name "*.js" -o -name "*.mjs" -o -name "*.cjs" \\)`.text();for(let H of f.split(`
-`).filter(Boolean)){let Q=H.replace($,"").replace(/^\//,"");T.push({name:Q,path:H})}}catch{}return T}function X$($){return Math.floor($*0.3)}function Z$($){return Math.floor($*0.25)}function OT($){if($.exports.length===0)return"No exports found";let T=["Export Sizes:",""],f=Math.max(...$.exports.map((H)=>H.name.length));for(let H of $.exports){let Q=H.name.padEnd(f," ");T.push(`  ${Q}  ${H.readable}`)}return T.push(""),T.push(`Total: ${$.totalReadable}`),T.push(`Estimated gzipped: ${I(X$($.totalSize))}`),T.push(`Estimated brotli: ${I(Z$($.totalSize))}`),T.join(`
-`)}import g from"fs/promises";import D from"os";import b from"path";import{italic as R}from"@stacksjs/cli";import{log as z}from"@stacksjs/logging";var q$="buddy",m=["node_modules","dist","vendor","storage/framework",/.*out.*/,/.*\/\..*/],V$=[`${D.homedir()}/Documents`,`${D.homedir()}/Pictures`,`${D.homedir()}/Library`,`${D.homedir()}/.Trash`];async function zT($,T){let f=!!$;$=$||D.homedir();let H=f?m:[...m,...V$];if(!T?.quiet)z.info(`Searching for Stacks projects in: ${R($)}`),z.info("This may take a few moments..."),console.log(""),console.log(R("  Please note, while Stacks is searching for projects on your machine,")),console.log(R("  you may be asked for permissions to scan certain directories.")),console.log(""),z.debug(`Excluding directories: ${H.join(", ")}`);let Q=await d($,H);if(!Q)throw Error("No Stacks projects found");return Q}async function d($,T){let f=[];if(T.some((P)=>typeof P==="string"?$.includes(P):P.test($)))return f;let Q;try{Q=await g.readdir($,{withFileTypes:!0})}catch(P){return console.error(`Error reading directory ${$}:`,P),f}let X=!1,_=!1;for(let P of Q){if(P.isFile()&&P.name===q$)X=!0;if(P.isDirectory()){let B=b.join($,P.name);if(P.name==="storage"){let G=b.join(B,"framework/core/buddy");try{await g.access(G),_=!0}catch{}}let J=await d(B,T);f.push(...J)}}if(X&&_)f.push($);return f}import{execSync as _$}from"child_process";import{handleError as P$}from"@stacksjs/error-handling";function hT(){try{return _$("git diff-index --quiet HEAD --"),!0}catch($){return P$($),!1}}import{config as B$}from"@stacksjs/config";import{log as u}from"@stacksjs/logging";import{path as M}from"@stacksjs/path";import{hashPaths as E}from"@stacksjs/storage";function CT(){try{return E(M.cloudPath("src/edge"))}catch($){u.error("Are we in a Docker container? Failed to hash paths. Error below:"),u.error($);return}}function pT(){let $=[M.projectPath("docs"),M.frameworkPath("docs/dist")],T=[M.projectPath("resources/views"),M.projectPath("resources/assets"),M.projectPath("resources/lang"),M.projectPath("resources/functions"),M.projectPath("resources/components"),M.projectPath("resources/modules"),M.projectPath("resources/stores"),M.frameworkPath("views/web")];return B$.app.docMode===!0?E($):E(T)}function gT(){let $=[M.projectPath("docs"),M.frameworkPath("docs/dist")];return E($)}import{runAction as G$}from"@stacksjs/actions";import{log as c,runCommand as J$}from"@stacksjs/cli";import{app as s,ui as n}from"@stacksjs/config";import{Action as U$}from"@stacksjs/enums";import{err as r,handleError as x,ok as Y$}from"@stacksjs/error-handling";import{frameworkPath as h,projectPath as k}from"@stacksjs/path";import{fs as A,readJsonFile as K$,readPackageJson as a,readTextFile as o,writeTextFile as M$}from"@stacksjs/storage";async function rT(){let{packageManager:$}=await a(h("package.json"));return $}async function aT(){if(s.env!=="production")c.info("Project not yet initialized, generating application key...");else x("Please run `buddy key:generate` to generate an application key");let $=await G$(U$.KeyGenerate,{cwd:k()});if($.isErr)return r(x($.error));return c.info("Application key generated."),Y$($.value)}async function oT(){if(A.existsSync(k(".env")))return await i();if(A.existsSync(k(".env.example")))A.copyFileSync(k(".env.example"),k(".env"));else console.error("no .env.example file found");return await i()}async function lT(){}async function tT(){return(await a(h("package.json"))).version}async function i(){let f=(await o(".env",k())).data.split(`
-`).find((H)=>H.startsWith("APP_KEY="));return!!(f&&f.length>16)}function eT($){if($===void 0&&n.reset)$=n.reset;if($===null)return[];let H={tailwind:'import { tailwindPreflight as reset } from "@cwcss/crosswind"',preflight:'import { tailwindPreflight as reset } from "@cwcss/crosswind"',forms:'import { tailwindFormsPreflight as reset } from "@cwcss/crosswind"'}[$??"tailwind"];return H?[H]:[]}function O$($){return $&&typeof $==="object"&&w($.name)&&w($.version)&&w($.description)}function w($){let T=typeof $;return $===null||T==="undefined"||T==="string"}async function $f($,T){let f=await o(k(".env")),H=$.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),Q=new RegExp(`^${H}=.*$`,"m"),X=`${$}=${T}`,_=Q.test(f.data)?f.data.replace(Q,X):`${f.data}${f.data.endsWith(`
-`)?"":`
-`}${X}
-`;await M$({path:k(".env"),data:_})}async function Tf($,T){let{data:f}=await K$("package.json",h());if(O$(f)&&L$(f,$))return await J$(`bun run ${$}`,T);return r(x(`The ${$} script does not exist in the package.json file.`))}function L$($,T){let f=$.scripts;if(f&&typeof f==="object")return Boolean(f[T]);return!1}function ff($){return Bun.YAML.parse($)}function Hf($){if($?.verbose===!0)return!0;return s.debug===!0}function Qf($){return $.family==="IPv6"||$.family===6}function Xf($){let T=Bun.YAML;if(typeof T.stringify==="function")return T.stringify($);return JSON.stringify($,null,2)}function Zf($){return Bun.YAML.parse($)}class k${static macros=new Map;static macro($,T,f=!1){if(this.macros.has($)&&!f)throw Error(`Macro "${$}" is already registered`);this.macros.set($,T),Object.defineProperty(this.prototype,$,{value:T,writable:!0,configurable:!0,enumerable:!1})}static mixin($,T=!0){let f=Object.getOwnPropertyNames($);for(let H of f){if(H==="constructor")continue;if(this.macros.has(H)&&!T)continue;let Q=Object.getOwnPropertyDescriptor($,H);if(Q&&typeof Q.value==="function")this.macro(H,Q.value,T)}}static hasMacro($){return this.macros.has($)}static flushMacros(){for(let $ of this.macros.keys())delete this.prototype[$];this.macros.clear()}static getMacros(){return Array.from(this.macros.keys())}callMacro($,...T){let f=this.constructor.macros.get($);if(!f)throw Error(`Macro "${$}" is not registered`);return f.apply(this,T)}}function Vf($=class{}){return class extends ${static macros=new Map;static macro(T,f,H=!1){if(this.macros.has(T)&&!H)throw Error(`Macro "${T}" is already registered`);this.macros.set(T,f),Object.defineProperty(this.prototype,T,{value:f,writable:!0,configurable:!0,enumerable:!1})}static mixin(T,f=!0){let H=Object.getOwnPropertyNames(T);for(let Q of H){if(Q==="constructor")continue;if(this.macros.has(Q)&&!f)continue;let X=Object.getOwnPropertyDescriptor(T,Q);if(X&&typeof X.value==="function")this.macro(Q,X.value,f)}}static hasMacro(T){return this.macros.has(T)}static flushMacros(){for(let T of this.macros.keys())delete this.prototype[T];this.macros.clear()}static getMacros(){return Array.from(this.macros.keys())}}}function _f($){let T=new Map;return $.macro=function(f,H,Q=!1){if(T.has(f)&&!Q)throw Error(`Macro "${f}" is already registered`);T.set(f,H),Object.defineProperty($.prototype,f,{value:H,writable:!0,configurable:!0,enumerable:!1})},$.mixin=function(f,H=!0){let Q=Object.getOwnPropertyNames(f);for(let X of Q){if(X==="constructor")continue;if(T.has(X)&&!H)continue;let _=Object.getOwnPropertyDescriptor(f,X);if(_&&typeof _.value==="function")$.macro(X,_.value,H)}},$.hasMacro=function(f){return T.has(f)},$.flushMacros=function(){for(let f of T.keys())delete $.prototype[f];T.clear()},$.getMacros=function(){return Array.from(T.keys())},$}function Jf($,T){if(typeof $!=="string"||$.length===0)return T;try{return JSON.parse($)}catch{return T}}function Uf($){if(typeof $!=="string")return{ok:!1,reason:"not-string"};if($.length===0)return{ok:!1,reason:"empty"};try{return{ok:!0,value:JSON.parse($)}}catch(T){return{ok:!1,reason:"malformed",error:T}}}function Yf($,T){let f=new WeakSet;return JSON.stringify($,(H,Q)=>{if(typeof Q==="bigint")return Q.toString();if(Q&&typeof Q==="object"){if(f.has(Q))return"[Circular]";f.add(Q)}return Q},T)}var W$="0.70.87";var Lf=Bun.semver;function kf($,T){return Bun.semver.order($,T)===1}function If($,T){return Bun.semver.order($,T)===-1}function Wf($,T){return Bun.semver.order($,T)===0}function Df($,T){return Bun.semver.order($,T)>=0}function Ef($,T){return Bun.semver.order($,T)<=0}function N(...$){let T={};for(let f of $){if(!f||typeof f!=="object")continue;for(let H in f){let Q=f[H],X=T[H];if(Q===void 0)continue;if(Array.isArray(Q))T[H]=Array.isArray(X)?[...X,...Q]:[...Q];else if(Q&&typeof Q==="object"&&!E$(Q))T[H]=N(X||{},Q);else T[H]=Q}}return T}function Rf($){return(...T)=>{return N($,...T)}}function D$($,...T){return N({},...T,$)}function E$($){if($ instanceof Date)return!0;if($ instanceof RegExp)return!0;if($ instanceof Error)return!0;if($ instanceof Promise)return!0;if($ instanceof Map)return!0;if($ instanceof Set)return!0;if($ instanceof WeakMap)return!0;if($ instanceof WeakSet)return!0;if(ArrayBuffer.isView($))return!0;return!1}var zf=D$,Af=N;function xf($){let T=$.split(`
-`),f=[];for(let P of T){if(!P.trim())continue;let B=P.match(/^(\s+)/);if(B&&B[1]!==void 0)f.push(B[1])}if(f.length===0)return{amount:0,type:null,indent:""};let H=new Map;for(let P of f)H.set(P,(H.get(P)||0)+1);let Q="",X=0;for(let[P,B]of H)if(B>X)X=B,Q=P;if(Q.includes("\t"))return{amount:Q.length,type:"tab",indent:Q};return{amount:Q.length,type:"space",indent:Q}}function N$($){if(!$)return null;if($.includes(`\r
-`))return`\r
-`;if($.includes(`
-`))return`
-`;if($.includes("\r"))return"\r";return null}function hf($,T=`
-`){return N$($)||T}function Ff($,T=`
-`){return $.replace(/\r\n|\r|\n/g,T)}function jf($){let T=($.match(/\r\n/g)||[]).length,f=($.match(/\r(?!\n)/g)||[]).length,H=($.match(/(?<!\r)\n/g)||[]).length;return{crlf:T,lf:H,cr:f,total:T+H+f}}function vf($,T=0,f={}){let{leading:H=!1,trailing:Q=!0}=f,X=null,_=null,P=null,B,J=()=>{if(_)B=$.apply(P,_),_=null,P=null;return B},G=()=>{if(X)clearTimeout(X),X=null;_=null,P=null},Y=()=>{if(X)return clearTimeout(X),X=null,J();return B},U=function(...K){_=K,P=this;let O=H&&!X;if(X)clearTimeout(X);if(X=setTimeout(()=>{if(X=null,Q&&_)J()},T),O)return J();return B};return U.cancel=G,U.flush=Y,U}function yf($,T=0){let f=null,H=0,Q=null,X=null,_=()=>{if(Q)$.apply(X,Q),Q=null,X=null,H=Date.now()},P=()=>{if(f)clearTimeout(f),f=null;Q=null,X=null},B=function(...J){Q=J,X=this;let Y=Date.now()-H;if(Y>=T)_();else if(!f)f=setTimeout(()=>{f=null,_()},T-Y)};return B.cancel=P,B}function Cf($){return new Promise((T)=>setTimeout(T,$))}var Z=!process.env.NO_COLOR&&(process.env.FORCE_COLOR||process.stdout?.isTTY),q={reset:Z?"\x1B[0m":"",black:Z?"\x1B[30m":"",red:Z?"\x1B[31m":"",green:Z?"\x1B[32m":"",yellow:Z?"\x1B[33m":"",blue:Z?"\x1B[34m":"",magenta:Z?"\x1B[35m":"",cyan:Z?"\x1B[36m":"",white:Z?"\x1B[37m":"",gray:Z?"\x1B[90m":"",grey:Z?"\x1B[90m":"",lightRed:Z?"\x1B[91m":"",lightGreen:Z?"\x1B[92m":"",lightYellow:Z?"\x1B[93m":"",lightBlue:Z?"\x1B[94m":"",lightMagenta:Z?"\x1B[95m":"",lightCyan:Z?"\x1B[96m":"",lightGray:Z?"\x1B[37m":"",lightGrey:Z?"\x1B[37m":"",bgBlack:Z?"\x1B[40m":"",bgRed:Z?"\x1B[41m":"",bgGreen:Z?"\x1B[42m":"",bgYellow:Z?"\x1B[43m":"",bgBlue:Z?"\x1B[44m":"",bgMagenta:Z?"\x1B[45m":"",bgCyan:Z?"\x1B[46m":"",bgWhite:Z?"\x1B[47m":"",bgLightRed:Z?"\x1B[101m":"",bgLightGreen:Z?"\x1B[102m":"",bgLightYellow:Z?"\x1B[103m":"",bgLightBlue:Z?"\x1B[104m":"",bgLightMagenta:Z?"\x1B[105m":"",bgLightCyan:Z?"\x1B[106m":"",bold:Z?"\x1B[1m":"",dim:Z?"\x1B[2m":"",italic:Z?"\x1B[3m":"",underline:Z?"\x1B[4m":"",inverse:Z?"\x1B[7m":"",hidden:Z?"\x1B[8m":"",strikethrough:Z?"\x1B[9m":""};function V($,T=q.reset){return(f)=>{if(!Z)return String(f);return`${$}${f}${T}`}}var gf=V(q.black),bf=V(q.red),mf=V(q.green),df=V(q.yellow),uf=V(q.blue),cf=V(q.magenta),nf=V(q.cyan),sf=V(q.white),R$=V(q.gray),rf=R$,af=V(q.lightRed),of=V(q.lightGreen),lf=V(q.lightYellow),tf=V(q.lightBlue),ef=V(q.lightMagenta),$0=V(q.lightCyan),z$=V(q.lightGray),T0=z$,f0=V(q.bgBlack),H0=V(q.bgRed),Q0=V(q.bgGreen),X0=V(q.bgYellow),Z0=V(q.bgBlue),q0=V(q.bgMagenta),V0=V(q.bgCyan),_0=V(q.bgWhite),P0=V(q.bgLightRed),B0=V(q.bgLightGreen),G0=V(q.bgLightYellow),J0=V(q.bgLightBlue),U0=V(q.bgLightMagenta),Y0=V(q.bgLightCyan),K0=V(q.bold),M0=V(q.dim),O0=V(q.italic),L0=V(q.underline),k0=V(q.inverse),I0=V(q.hidden),W0=V(q.strikethrough),D0=V(q.reset,"");function E0($){return $.replace(/\x1B\[\d+m/g,"")}function N0(){return!!Z}function A$($,T={}){let{align:f=[],padding:H=!0,delimiter:Q="|",delimiterStart:X=!0,delimiterEnd:_=!0,alignDelimiter:P="-"}=T;if(!$||$.length===0)return"";let B=$.map((U)=>U.map((K)=>{if(K===null||K===void 0)return"";return String(K)})),J=Math.max(...B.map((U)=>U.length)),G=Array.from({length:J}).fill(0);for(let U of B)for(let K=0;K<U.length;K++){let O=U[K]?.length??0;if(O>(G[K]??0))G[K]=O}let Y=[];if(B.length>0){let U=B[0]??[];Y.push(F(U,G,H,Q,X,_));let K=G.map((O,W)=>{let j=x$(f[W]);return w$(O,j,P)});Y.push(F(K,G,H,Q,X,_));for(let O=1;O<B.length;O++){let W=B[O]??[];Y.push(F(W,G,H,Q,X,_))}}return Y.join(`
-`)}function F($,T,f,H,Q,X){let _=$.map((J,G)=>{let Y=T[G]??0;return J.padEnd(Y," ")}),P=f?" ":"",B=_.map((J)=>`${P}${J}${P}`).join(H);if(Q)B=H+B;if(X)B=B+H;return B}function w$($,T,f){let H=T==="center"?3:T?2:1;if($<H)$=H;let Q=f.repeat($);if(T==="left")Q=`:${Q.slice(1)}`;else if(T==="right")Q=Q.slice(0,-1)+":";else if(T==="center")Q=`:${Q.slice(2)}:`;return Q}function x$($){if(!$)return null;switch($){case"l":case"left":return"left";case"c":case"center":return"center";case"r":case"right":return"right";default:return null}}function z0($,T={}){if(!$||$.length===0)return"";let f=Array.from(new Set($.flatMap((Q)=>Object.keys(Q)))),H=[f,...$.map((Q)=>f.map((X)=>Q[X]))];return A$(H,T)}function h$(){return typeof window<"u"&&"ResizeObserver"in window}function l(){if(h$())return window.ResizeObserver;return class{callback;observedElements=new Set;rafId=null;constructor(T){this.callback=T}observe(T){if(!this.observedElements.has(T))this.observedElements.add(T),this.scheduleCheck()}unobserve(T){if(this.observedElements.delete(T),this.observedElements.size===0&&this.rafId!==null)(typeof cancelAnimationFrame<"u"?cancelAnimationFrame:clearTimeout)(this.rafId),this.rafId=null}disconnect(){if(this.observedElements.clear(),this.rafId!==null)(typeof cancelAnimationFrame<"u"?cancelAnimationFrame:clearTimeout)(this.rafId),this.rafId=null}scheduleCheck(){if(this.rafId!==null)return;let T=typeof requestAnimationFrame<"u"?requestAnimationFrame:setTimeout;this.rafId=T(()=>{if(this.check(),this.rafId=null,this.observedElements.size>0)this.scheduleCheck()})}check(){let T=[];for(let f of this.observedElements){let H=f.getBoundingClientRect(),Q={target:f,contentRect:H,borderBoxSize:[{inlineSize:H.width,blockSize:H.height}],contentBoxSize:[{inlineSize:H.width,blockSize:H.height}],devicePixelContentBoxSize:[{inlineSize:H.width,blockSize:H.height}]};T.push(Q)}if(T.length>0)this.callback(T,this)}}}function F$($,T){let H=new(l())($),Q=Array.isArray(T)?T:[T];for(let X of Q)H.observe(X);return()=>{H.disconnect()}}function w0($,T){return F$((f)=>{let H=f.find((Q)=>Q.target===$);if(H)T(H)},$)}var x0=l();class t{passable;pipes=[];method="handle";static send($){let T=new t;return T.passable=$,T}through($){return this.pipes=$,this}pipe(...$){return this.pipes.push(...$),this}via($){return this.method=$,this}then($){return this.pipes.reduceRight((f,H)=>{return(Q)=>{if(typeof H==="function")return H(Q,f);let X=H[this.method];if(typeof X==="function")return X.call(H,Q,f);return f(Q)}},$)(this.passable)}thenReturn(){return this.then(($)=>$)}}export{df as yellow,sf as white,pT as websiteSourceHash,W$ as version,l0 as useOnline,L0 as underline,PT as toError,yf as throttle,N0 as supportsColor,E0 as stripColors,W0 as strikethrough,$f as setEnvValue,Lf as semver,Yf as safeJsonStringify,Uf as safeJsonParseResult,Jf as safeJsonParse,Tf as runNpmScript,o0 as retry,D0 as reset,bf as red,UT as readableSize,JT as prettyBytes,ff as parseYaml,y as parseBytes,rT as packageManager,CT as originRequestFunctionHash,w0 as observeElementSize,a0 as notNullish,Ff as normalizeNewlines,D$ as mergeDefaults,N as merge,z0 as markdownTableFromObjects,A$ as markdownTable,cf as magenta,_f as macroable,Zf as loadYaml,lf as lightYellow,af as lightRed,ef as lightMagenta,T0 as lightGrey,of as lightGreen,z$ as lightGray,$0 as lightCyan,tf as lightBlue,O0 as italic,Ef as isVersionLessThanOrEqual,If as isVersionLessThan,Df as isVersionGreaterThanOrEqual,kf as isVersionGreaterThan,Wf as isVersionEqual,h$ as isResizeObserverSupported,w as isOptionalString,O$ as isManifest,Qf as isIpv6,hT as isGitClean,v as isDeepEqual,i as isAppKeySet,k0 as inverse,lT as installIfVersionMismatch,aT as initProject,I0 as hidden,L$ as hasScript,rf as grey,mf as green,R$ as gray,l as getResizeObserver,f$ as getFileSize,H$ as getExportsSize,_T as getErrorStatusCode,qT as getErrorStack,$$ as getErrorMessage,VT as getErrorCode,tT as frameworkVersion,OT as formatExportSizes,I as formatBytes,zT as findStacksProjects,X$ as estimateGzipSize,Z$ as estimateBrotliSize,oT as ensureProjectIsInitialized,Xf as dumpYaml,gT as docsSourceHash,M0 as dim,eT as determineResetPreset,Hf as determineDebugLevel,hf as detectNewlineGraceful,N$ as detectNewline,xf as detectIndent,Cf as delay,Af as defuArrayFn,zf as defu,QT as defineUi,fT as defineSms,TT as defineServices,$T as defineSearchEngine,e$ as defineQueue,t$ as definePayment,l$ as defineNotification,o$ as defineLibrary,a$ as defineHashing,r$ as defineGit,HT as defineFilesystems,s$ as defineEmailConfig,i$ as defineEmail,n$ as defineDns,c$ as defineDependencies,u$ as defineDatabase,d$ as defineCli,m$ as defineChat,b$ as defineCdn,g$ as defineCache,p$ as defineApp,vf as debounce,nf as cyan,F$ as createResizeObserver,Rf as createMerger,Vf as createMacroable,jf as countNewlines,GT as compareBytes,S$ as cleanProject,r0 as clamp,i0 as browserUtils,K0 as bold,uf as blue,gf as black,X0 as bgYellow,_0 as bgWhite,H0 as bgRed,q0 as bgMagenta,G0 as bgLightYellow,P0 as bgLightRed,U0 as bgLightMagenta,B0 as bgLightGreen,Y0 as bgLightCyan,J0 as bgLightBlue,Q0 as bgGreen,V0 as bgCyan,Z0 as bgBlue,f0 as bgBlack,x0 as ResizeObserver,t as Pipeline,k$ as Macroable};
+export * from "./clean";
+export * from "./config";
+export * from "./equal";
+export * from "./errors";
+export * from "./export-size";
+export * from "./find";
+export * from "./git";
+export * from "./hash";
+export * from "./helpers";
+export * from "./macroable";
+export * from "./safe-json";
+export * from "./versions";
+export * as browserUtils from "@stacksjs/browser";
+export { clamp, notNullish, retry, useOnline } from "@stacksjs/browser";
+export * from "./merge";
+export * from "./detect";
+export * from "./debounce";
+export * from "./bytes";
+export * from "./colors";
+export * from "./markdown";
+export * from "./size";
+export * from "./observer";
+export * from "./pipeline";

package/dist/macroable.js

@@ -0,0 +1,121 @@
+export class Macroable {
+  static macros = new Map;
+  static macro(name, fn, replace = !1) {
+    if (this.macros.has(name) && !replace)
+      throw Error(`Macro "${name}" is already registered`);
+    this.macros.set(name, fn);
+    Object.defineProperty(this.prototype, name, {
+      value: fn,
+      writable: !0,
+      configurable: !0,
+      enumerable: !1
+    });
+  }
+  static mixin(obj, replace = !0) {
+    const methods = Object.getOwnPropertyNames(obj);
+    for (const method of methods) {
+      if (method === "constructor")
+        continue;
+      if (this.macros.has(method) && !replace)
+        continue;
+      const descriptor = Object.getOwnPropertyDescriptor(obj, method);
+      if (descriptor && typeof descriptor.value === "function")
+        this.macro(method, descriptor.value, replace);
+    }
+  }
+  static hasMacro(name) {
+    return this.macros.has(name);
+  }
+  static flushMacros() {
+    for (const name of this.macros.keys())
+      delete this.prototype[name];
+    this.macros.clear();
+  }
+  static getMacros() {
+    return Array.from(this.macros.keys());
+  }
+  callMacro(name, ...args) {
+    const macro = this.constructor.macros.get(name);
+    if (!macro)
+      throw Error(`Macro "${name}" is not registered`);
+    return macro.apply(this, args);
+  }
+}
+export function createMacroable(BaseClass = class {
+}) {
+  return class extends BaseClass {
+    static macros = new Map;
+    static macro(name, fn, replace = !1) {
+      if (this.macros.has(name) && !replace)
+        throw Error(`Macro "${name}" is already registered`);
+      this.macros.set(name, fn);
+      Object.defineProperty(this.prototype, name, {
+        value: fn,
+        writable: !0,
+        configurable: !0,
+        enumerable: !1
+      });
+    }
+    static mixin(obj, replace = !0) {
+      const methods = Object.getOwnPropertyNames(obj);
+      for (const method of methods) {
+        if (method === "constructor")
+          continue;
+        if (this.macros.has(method) && !replace)
+          continue;
+        const descriptor = Object.getOwnPropertyDescriptor(obj, method);
+        if (descriptor && typeof descriptor.value === "function")
+          this.macro(method, descriptor.value, replace);
+      }
+    }
+    static hasMacro(name) {
+      return this.macros.has(name);
+    }
+    static flushMacros() {
+      for (const name of this.macros.keys())
+        delete this.prototype[name];
+      this.macros.clear();
+    }
+    static getMacros() {
+      return Array.from(this.macros.keys());
+    }
+  };
+}
+export function macroable(target) {
+  const macros = new Map;
+  target.macro = function(name, fn, replace = !1) {
+    if (macros.has(name) && !replace)
+      throw Error(`Macro "${name}" is already registered`);
+    macros.set(name, fn);
+    Object.defineProperty(target.prototype, name, {
+      value: fn,
+      writable: !0,
+      configurable: !0,
+      enumerable: !1
+    });
+  };
+  target.mixin = function(obj, replace = !0) {
+    const methods = Object.getOwnPropertyNames(obj);
+    for (const method of methods) {
+      if (method === "constructor")
+        continue;
+      if (macros.has(method) && !replace)
+        continue;
+      const descriptor = Object.getOwnPropertyDescriptor(obj, method);
+      if (descriptor && typeof descriptor.value === "function")
+        target.macro(method, descriptor.value, replace);
+    }
+  };
+  target.hasMacro = function(name) {
+    return macros.has(name);
+  };
+  target.flushMacros = function() {
+    for (const name of macros.keys())
+      delete target.prototype[name];
+    macros.clear();
+  };
+  target.getMacros = function() {
+    return Array.from(macros.keys());
+  };
+  return target;
+}

package/dist/markdown.js

@@ -0,0 +1,92 @@
+export function markdownTable(table, options = {}) {
+  const {
+    align = [],
+    padding = !0,
+    delimiter = "|",
+    delimiterStart = !0,
+    delimiterEnd = !0,
+    alignDelimiter = "-"
+  } = options;
+  if (!table || table.length === 0)
+    return "";
+  const normalized = table.map((row) => row.map((cell) => {
+    if (cell === null || cell === void 0)
+      return "";
+    return String(cell);
+  })), columnCount = Math.max(...normalized.map((row) => row.length)), columnWidths = Array.from({ length: columnCount }).fill(0);
+  for (const row of normalized)
+    for (let i = 0;i < row.length; i++) {
+      const cellLength = row[i]?.length ?? 0;
+      if (cellLength > (columnWidths[i] ?? 0))
+        columnWidths[i] = cellLength;
+    }
+  const rows = [];
+  if (normalized.length > 0) {
+    const header = normalized[0] ?? [];
+    rows.push(buildRow(header, columnWidths, padding, delimiter, delimiterStart, delimiterEnd));
+    const separatorCells = columnWidths.map((width, index) => {
+      const alignment = normalizeAlignment(align[index]);
+      return buildSeparator(width, alignment, alignDelimiter);
+    });
+    rows.push(buildRow(separatorCells, columnWidths, padding, delimiter, delimiterStart, delimiterEnd));
+    for (let i = 1;i < normalized.length; i++) {
+      const dataRow = normalized[i] ?? [];
+      rows.push(buildRow(dataRow, columnWidths, padding, delimiter, delimiterStart, delimiterEnd));
+    }
+  }
+  return rows.join(`
+`);
+}
+function buildRow(cells, columnWidths, padding, delimiter, delimiterStart, delimiterEnd) {
+  const paddedCells = cells.map((cell, index) => {
+    const width = columnWidths[index] ?? 0;
+    return cell.padEnd(width, " ");
+  }), space = padding ? " " : "";
+  let row = paddedCells.map((cell) => `${space}${cell}${space}`).join(delimiter);
+  if (delimiterStart)
+    row = delimiter + row;
+  if (delimiterEnd)
+    row = row + delimiter;
+  return row;
+}
+function buildSeparator(width, alignment, char) {
+  const minWidth = alignment === "center" ? 3 : alignment ? 2 : 1;
+  if (width < minWidth)
+    width = minWidth;
+  let separator = char.repeat(width);
+  if (alignment === "left")
+    separator = `:${separator.slice(1)}`;
+  else if (alignment === "right")
+    separator = separator.slice(0, -1) + ":";
+  else if (alignment === "center")
+    separator = `:${separator.slice(2)}:`;
+  return separator;
+}
+function normalizeAlignment(align) {
+  if (!align)
+    return null;
+  switch (align) {
+    case "l":
+    case "left":
+      return "left";
+    case "c":
+    case "center":
+      return "center";
+    case "r":
+    case "right":
+      return "right";
+    default:
+      return null;
+  }
+}
+export function markdownTableFromObjects(objects, options = {}) {
+  if (!objects || objects.length === 0)
+    return "";
+  const keys = Array.from(new Set(objects.flatMap((obj) => Object.keys(obj)))), table = [
+    keys,
+    ...objects.map((obj) => keys.map((key) => obj[key]))
+  ];
+  return markdownTable(table, options);
+}
+
+export { markdownTable as default };

package/dist/merge.js

@@ -0,0 +1,51 @@
+export function merge(...objects) {
+  const result = {};
+  for (const obj of objects) {
+    if (!obj || typeof obj !== "object")
+      continue;
+    for (const key in obj) {
+      const value = obj[key], existing = result[key];
+      if (value === void 0)
+        continue;
+      if (Array.isArray(value))
+        result[key] = Array.isArray(existing) ? [...existing, ...value] : [...value];
+      else if (value && typeof value === "object" && !isSpecialObject(value))
+        result[key] = merge(existing || {}, value);
+      else
+        result[key] = value;
+    }
+  }
+  return result;
+}
+export function createMerger(defaults) {
+  return (...objects) => {
+    return merge(defaults, ...objects);
+  };
+}
+export function mergeDefaults(obj, ...defaults) {
+  return merge({}, ...defaults, obj);
+}
+function isSpecialObject(obj) {
+  if (obj instanceof Date)
+    return !0;
+  if (obj instanceof RegExp)
+    return !0;
+  if (obj instanceof Error)
+    return !0;
+  if (obj instanceof Promise)
+    return !0;
+  if (obj instanceof Map)
+    return !0;
+  if (obj instanceof Set)
+    return !0;
+  if (obj instanceof WeakMap)
+    return !0;
+  if (obj instanceof WeakSet)
+    return !0;
+  if (ArrayBuffer.isView(obj))
+    return !0;
+  return !1;
+}
+export const defu = mergeDefaults, defuArrayFn = merge;
+
+export { merge as default };

package/dist/observer.js

@@ -0,0 +1,78 @@
+export function isResizeObserverSupported() {
+  return typeof window < "u" && "ResizeObserver" in window;
+}
+export function getResizeObserver() {
+  if (isResizeObserverSupported())
+    return window.ResizeObserver;
+  return class ResizeObserverPolyfill {
+    callback;
+    observedElements = new Set;
+    rafId = null;
+    constructor(callback) {
+      this.callback = callback;
+    }
+    observe(target) {
+      if (!this.observedElements.has(target)) {
+        this.observedElements.add(target);
+        this.scheduleCheck();
+      }
+    }
+    unobserve(target) {
+      this.observedElements.delete(target);
+      if (this.observedElements.size === 0 && this.rafId !== null) {
+        (typeof cancelAnimationFrame < "u" ? cancelAnimationFrame : clearTimeout)(this.rafId);
+        this.rafId = null;
+      }
+    }
+    disconnect() {
+      this.observedElements.clear();
+      if (this.rafId !== null) {
+        (typeof cancelAnimationFrame < "u" ? cancelAnimationFrame : clearTimeout)(this.rafId);
+        this.rafId = null;
+      }
+    }
+    scheduleCheck() {
+      if (this.rafId !== null)
+        return;
+      const raf = typeof requestAnimationFrame < "u" ? requestAnimationFrame : setTimeout;
+      this.rafId = raf(() => {
+        this.check();
+        this.rafId = null;
+        if (this.observedElements.size > 0)
+          this.scheduleCheck();
+      });
+    }
+    check() {
+      const entries = [];
+      for (const element of this.observedElements) {
+        const rect = element.getBoundingClientRect(), entry = {
+          target: element,
+          contentRect: rect,
+          borderBoxSize: [{ inlineSize: rect.width, blockSize: rect.height }],
+          contentBoxSize: [{ inlineSize: rect.width, blockSize: rect.height }],
+          devicePixelContentBoxSize: [{ inlineSize: rect.width, blockSize: rect.height }]
+        };
+        entries.push(entry);
+      }
+      if (entries.length > 0)
+        this.callback(entries, this);
+    }
+  };
+}
+export function createResizeObserver(callback, target) {
+  const observer = new (getResizeObserver())(callback), targets = Array.isArray(target) ? target : [target];
+  for (const element of targets)
+    observer.observe(element);
+  return () => {
+    observer.disconnect();
+  };
+}
+export function observeElementSize(element, callback) {
+  return createResizeObserver((entries) => {
+    const entry = entries.find((e) => e.target === element);
+    if (entry)
+      callback(entry);
+  }, element);
+}
+export const ResizeObserver = getResizeObserver();
+export default ResizeObserver;

package/dist/pipeline.js

@@ -0,0 +1,37 @@
+export class Pipeline {
+  passable;
+  pipes = [];
+  method = "handle";
+  static send(passable) {
+    const pipeline = new Pipeline;
+    pipeline.passable = passable;
+    return pipeline;
+  }
+  through(pipes) {
+    this.pipes = pipes;
+    return this;
+  }
+  pipe(...pipes) {
+    this.pipes.push(...pipes);
+    return this;
+  }
+  via(method) {
+    this.method = method;
+    return this;
+  }
+  then(destination) {
+    return this.pipes.reduceRight((next, pipe) => {
+      return (passable) => {
+        if (typeof pipe === "function")
+          return pipe(passable, next);
+        const handler = pipe[this.method];
+        if (typeof handler === "function")
+          return handler.call(pipe, passable, next);
+        return next(passable);
+      };
+    }, destination)(this.passable);
+  }
+  thenReturn() {
+    return this.then((passable) => passable);
+  }
+}

package/dist/safe-json.js

@@ -0,0 +1,33 @@
+export function safeJsonParse(text, defaultValue) {
+  if (typeof text !== "string" || text.length === 0)
+    return defaultValue;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return defaultValue;
+  }
+}
+export function safeJsonParseResult(text) {
+  if (typeof text !== "string")
+    return { ok: !1, reason: "not-string" };
+  if (text.length === 0)
+    return { ok: !1, reason: "empty" };
+  try {
+    return { ok: !0, value: JSON.parse(text) };
+  } catch (err) {
+    return { ok: !1, reason: "malformed", error: err };
+  }
+}
+export function safeJsonStringify(value, space) {
+  const seen = new WeakSet;
+  return JSON.stringify(value, (_key, v) => {
+    if (typeof v === "bigint")
+      return v.toString();
+    if (v && typeof v === "object") {
+      if (seen.has(v))
+        return "[Circular]";
+      seen.add(v);
+    }
+    return v;
+  }, space);
+}

package/dist/size.js

@@ -0,0 +1,66 @@
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { formatBytes } from "./bytes";
+export async function getFileSize(filePath) {
+  try {
+    return (await stat(filePath)).size;
+  } catch {
+    return 0;
+  }
+}
+export async function getExportsSize(distPath) {
+  const exports = [];
+  let totalSize = 0;
+  try {
+    const files = await getAllJsFiles(distPath);
+    for (const file of files) {
+      const size = await getFileSize(file.path);
+      totalSize += size;
+      exports.push({
+        name: file.name,
+        size,
+        readable: formatBytes(size)
+      });
+    }
+  } catch (error) {}
+  return {
+    totalSize,
+    totalReadable: formatBytes(totalSize),
+    exports: exports.sort((a, b) => b.size - a.size)
+  };
+}
+async function getAllJsFiles(dir) {
+  const files = [];
+  try {
+    const entries = await Bun.$.throws(!1)`find ${dir} -type f \\( -name "*.js" -o -name "*.mjs" -o -name "*.cjs" \\)`.text();
+    for (const entry of entries.split(`
+`).filter(Boolean)) {
+      const name = entry.replace(dir, "").replace(/^\//, "");
+      files.push({ name, path: entry });
+    }
+  } catch {}
+  return files;
+}
+export function estimateGzipSize(size) {
+  return Math.floor(size * 0.3);
+}
+export function estimateBrotliSize(size) {
+  return Math.floor(size * 0.25);
+}
+export function formatExportSizes(result) {
+  if (result.exports.length === 0)
+    return "No exports found";
+  const lines = ["Export Sizes:", ""], maxNameLength = Math.max(...result.exports.map((e) => e.name.length));
+  for (const exp of result.exports) {
+    const name = exp.name.padEnd(maxNameLength, " ");
+    lines.push(`  ${name}  ${exp.readable}`);
+  }
+  lines.push("");
+  lines.push(`Total: ${result.totalReadable}`);
+  lines.push(`Estimated gzipped: ${formatBytes(estimateGzipSize(result.totalSize))}`);
+  lines.push(`Estimated brotli: ${formatBytes(estimateBrotliSize(result.totalSize))}`);
+  return lines.join(`
+`);
+}
+
+export { getExportsSize as default };

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const components: string[];
+export declare const functions: string[];

package/dist/utils.js

@@ -0,0 +1,6 @@
+var __dirname = "";
+import { resolve } from "@stacksjs/path";
+import { fs } from "@stacksjs/storage";
+import { kebabCase } from "@stacksjs/strings";
+const ignore = ["readme-md"];
+export const components = fs.readdirSync(resolve(__dirname, "./resources/components")).map((item) => kebabCase(item.replace(/\.(stx|vue)/g, ""))).filter((item) => !ignore.includes(item)), functions = fs.readdirSync(resolve(__dirname, "./resources/functions")).map((item) => kebabCase(item.replace(/.ts/g, ""))).filter((item) => !ignore.includes(item));

package/dist/versions.js

@@ -0,0 +1,19 @@
+import { version } from "../package.json";
+export const semver = Bun.semver;
+export function isVersionGreaterThan(version, compareVersion) {
+  return Bun.semver.order(version, compareVersion) === 1;
+}
+export function isVersionLessThan(version, compareVersion) {
+  return Bun.semver.order(version, compareVersion) === -1;
+}
+export function isVersionEqual(version, compareVersion) {
+  return Bun.semver.order(version, compareVersion) === 0;
+}
+export function isVersionGreaterThanOrEqual(version, compareVersion) {
+  return Bun.semver.order(version, compareVersion) >= 0;
+}
+export function isVersionLessThanOrEqual(version, compareVersion) {
+  return Bun.semver.order(version, compareVersion) <= 0;
+}
+
+export { version };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/utils",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.90",
   "description": "The Stacks helper functions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,20 +58,20 @@
     "size": "bun scripts/export-size.ts"
   },
   "dependencies": {
-    "@stacksjs/browser": "0.70.87"
+    "@stacksjs/browser": "0.70.90"
   },
   "devDependencies": {
-    "@stacksjs/actions": "0.70.87",
-    "@stacksjs/arrays": "0.70.87",
-    "@stacksjs/cli": "0.70.87",
-    "@stacksjs/config": "0.70.87",
+    "@stacksjs/actions": "0.70.90",
+    "@stacksjs/arrays": "0.70.90",
+    "@stacksjs/cli": "0.70.90",
+    "@stacksjs/config": "0.70.90",
     "better-dx": "^0.2.16",
     "filesize": "^11.0.22",
     "markdown-table": "^3.0.4",
-    "@stacksjs/lint": "0.70.87",
-    "@stacksjs/path": "0.70.87",
-    "@stacksjs/storage": "0.70.87",
-    "@stacksjs/strings": "0.70.87",
-    "@stacksjs/types": "0.70.87"
+    "@stacksjs/lint": "0.70.90",
+    "@stacksjs/path": "0.70.90",
+    "@stacksjs/storage": "0.70.90",
+    "@stacksjs/strings": "0.70.90",
+    "@stacksjs/types": "0.70.90"
   }
 }