@stacksjs/utils 0.57.3 → 0.58.19

package/package.json

@@ -1,17 +1,16 @@
 {
   "name": "@stacksjs/utils",
   "type": "module",
-  "version": "0.57.3",
-  "packageManager": "pnpm@8.6.6",
+  "version": "0.58.19",
   "description": "The Stacks helper functions.",
   "author": "Chris Breuer",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
-  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/helpers#readme",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/src/helpers#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
-    "directory": "./.stacks/core/helpers"
+    "directory": "./storage/framework/core/src/helpers"
   },
   "bugs": {
     "url": "https://github.com/stacksjs/stacks/issues"
@@ -22,80 +21,90 @@
     "arrays",
     "alias",
     "helpers",
+    "magic-regexp",
     "utilities",
     "functions",
     "stacks"
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs"
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "bun": "./*"
     }
   },
-  "module": "dist/index.mjs",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "contributors": [
-    "Chris Breuer <chris@ow3.org>"
+    "Chris Breuer <chris@stacksjs.org>"
   ],
   "files": [
-    "dist",
-    "README.md"
+    "README.md",
+    "dist"
   ],
+  "scripts": {
+    "build": "bun --bun build.ts",
+    "typecheck": "bun --bun tsc --noEmit",
+    "prepublishOnly": "bun --bun run build",
+    "size": "tsx scripts/export-size.ts"
+  },
   "peerDependencies": {
-    "@dinero.js/currencies": "2.0.0-alpha.14",
-    "@vueuse/core": "^10.2.1",
-    "@vueuse/head": "^1.1.26",
-    "@vueuse/math": "^10.2.1",
-    "@vueuse/shared": "^10.2.1",
-    "defu": "^6.1.2",
-    "dinero.js": "2.0.0-alpha.14",
-    "fast-glob": "^3.3.0",
-    "kolorist": "1.8.0",
-    "p-limit": "^4.0.0",
-    "rimraf": "^5.0.1",
-    "semver": "^7.5.3",
-    "yaml": "^2.3.1",
-    "@stacksjs/arrays": "0.57.3",
-    "@stacksjs/cli": "0.57.3",
-    "@stacksjs/config": "0.57.3",
-    "@stacksjs/development": "0.57.3",
-    "@stacksjs/lint": "0.57.3",
-    "@stacksjs/path": "0.57.3",
-    "@stacksjs/storage": "0.57.3",
-    "@stacksjs/strings": "0.57.3",
-    "@stacksjs/types": "0.57.3"
+    "@stacksjs/actions": "workspace:*",
+    "@stacksjs/arrays": "workspace:*",
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/development": "workspace:*",
+    "@stacksjs/lint": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/strings": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@types/js-yaml": "^4.0.9",
+    "@vueuse/core": "^10.7.1",
+    "@vueuse/head": "^2.0.0",
+    "@vueuse/math": "^10.7.1",
+    "@vueuse/shared": "^10.7.1",
+    "export-size": "^0.7.0",
+    "js-yaml": "^4.1.0",
+    "rimraf": "^5.0.5",
+    "yaml": "^2.3.4"
   },
   "dependencies": {
     "@dinero.js/currencies": "2.0.0-alpha.14",
-    "@vueuse/core": "^10.2.1",
-    "@vueuse/head": "^1.1.26",
-    "@vueuse/math": "^10.2.1",
-    "@vueuse/shared": "^10.2.1",
-    "defu": "^6.1.2",
+    "@stacksjs/actions": "workspace:*",
+    "@stacksjs/arrays": "workspace:*",
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/lint": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/strings": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@vueuse/core": "^10.7.1",
+    "@vueuse/head": "^2.0.0",
+    "@vueuse/math": "^10.7.1",
+    "@vueuse/shared": "^10.7.1",
+    "defu": "^6.1.4",
     "detect-indent": "^7.0.1",
-    "detect-newline": "^4.0.0",
+    "detect-newline": "^4.0.1",
     "dinero.js": "2.0.0-alpha.14",
-    "fast-glob": "^3.3.0",
+    "export-size": "^0.7.0",
+    "js-yaml": "^4.1.0",
     "kolorist": "1.8.0",
-    "p-limit": "^4.0.0",
+    "macroable": "^7.0.2",
+    "magic-regexp": "^0.7.0",
+    "p-limit": "^5.0.0",
     "perfect-debounce": "^1.0.0",
-    "rimraf": "^5.0.1",
-    "semver": "^7.5.3",
-    "yaml": "^2.3.1",
-    "@stacksjs/arrays": "0.57.3",
-    "@stacksjs/cli": "0.57.3",
-    "@stacksjs/config": "0.57.3",
-    "@stacksjs/lint": "0.57.3",
-    "@stacksjs/path": "0.57.3",
-    "@stacksjs/storage": "0.57.3",
-    "@stacksjs/types": "0.57.3"
+    "pretty-bytes": "^6.1.1",
+    "rimraf": "^5.0.5",
+    "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@stacksjs/development": "0.57.3"
-  },
-  "scripts": {
-    "build": "unbuild",
-    "dev": "unbuild --stub",
-    "typecheck": "tsc --noEmit"
+    "@stacksjs/development": "workspace:*",
+    "@types/js-yaml": "^4.0.9",
+    "markdown-table": "^3.0.3",
+    "vue-starport": "^0.4.0"
   }
-}
+}

package/LICENSE.md

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright (c) 2022 Open Web Foundation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/base.d.ts

@@ -1,3 +0,0 @@
-export declare function toString(v: any): any;
-export declare function loop(times: number, callback: any): void;
-export declare function getTypeName(v: any): any;

package/dist/base.mjs

@@ -1,12 +0,0 @@
-export function toString(v) {
-  return Object.prototype.toString.call(v);
-}
-export function loop(times, callback) {
-  [...Array(times)].forEach((item, i) => callback(i));
-}
-export function getTypeName(v) {
-  if (v === null)
-    return "null";
-  const type = toString(v).slice(8, -1).toLowerCase();
-  return typeof v === "object" || typeof v === "function" ? type : typeof v;
-}

package/dist/config.d.ts

@@ -1,28 +0,0 @@
-import type { AppOptions, CacheOptions, CdnOptions, CronJobOptions, DatabaseOptions, DebugOptions, DnsOptions, EmailOptions, Events, GitOptions, HashingOptions, JobOptions, LibraryOptions, Model, NotificationOptions, PagesOption, PaymentOptions, QueueOptions, SearchEngineOptions, ServicesOptions, StorageOptions, UiOptions, UserCliOptions } from '@stacksjs/types';
-export { loadStacksConfig as config } from '@stacksjs/config';
-export declare function defineApp(config: Partial<AppOptions>): AppOptions;
-export declare function defineCache(config: Partial<CacheOptions>): CacheOptions;
-export declare function defineCdn(config: Partial<CdnOptions>): CdnOptions;
-export declare function defineCli(config: Partial<UserCliOptions>): UserCliOptions;
-export declare function defineCronJobsConfig(config: Partial<CronJobOptions>[]): CronJobOptions[];
-export declare function defineJobsConfig(config: Partial<JobOptions>[]): JobOptions[];
-export declare function defineDatabase(config: Partial<DatabaseOptions>): DatabaseOptions;
-export declare function defineDebugConfig(config: Partial<DebugOptions>): DebugOptions;
-export declare function defineDns(config: Partial<DnsOptions>): DnsOptions;
-export declare function defineEmailConfig(config: Partial<EmailOptions>): EmailOptions;
-export declare function defineEvents(config: Partial<Events>): Events;
-export declare function defineGit(config: Partial<GitOptions>): GitOptions;
-export declare function defineHashing(config: Partial<HashingOptions>): HashingOptions;
-export declare function defineLibrary(config: Partial<LibraryOptions>): LibraryOptions;
-export declare function defineModel(config: Partial<Model>): Model;
-export declare function defineNotification(config: Partial<NotificationOptions>): NotificationOptions;
-export declare function defineSms(config: Partial<NotificationOptions['sms']>): NotificationOptions;
-export declare function defineEmail(config: Partial<NotificationOptions['email']>): NotificationOptions;
-export declare function defineChat(config: Partial<NotificationOptions['chat']>): NotificationOptions;
-export declare function definePage(config: Partial<PagesOption>): PagesOption;
-export declare function definePayment(config: Partial<PaymentOptions>): PaymentOptions;
-export declare function defineQueue(config: Partial<QueueOptions>): QueueOptions;
-export declare function defineSearchEngine(config: Partial<SearchEngineOptions>): SearchEngineOptions;
-export declare function defineServices(config: Partial<ServicesOptions>): ServicesOptions;
-export declare function defineStorage(config: Partial<StorageOptions>): StorageOptions;
-export declare function defineUi(config: Partial<UiOptions>): UiOptions;

package/dist/config.mjs

@@ -1,79 +0,0 @@
-export { loadStacksConfig as config } from "@stacksjs/config";
-export function defineApp(config) {
-  return config;
-}
-export function defineCache(config) {
-  return config;
-}
-export function defineCdn(config) {
-  return config;
-}
-export function defineCli(config) {
-  return config;
-}
-export function defineCronJobsConfig(config) {
-  return config;
-}
-export function defineJobsConfig(config) {
-  return config;
-}
-export function defineDatabase(config) {
-  return config;
-}
-export function defineDebugConfig(config) {
-  return config;
-}
-export function defineDns(config) {
-  return config;
-}
-export function defineEmailConfig(config) {
-  return config;
-}
-export function defineEvents(config) {
-  return config;
-}
-export function defineGit(config) {
-  return config;
-}
-export function defineHashing(config) {
-  return config;
-}
-export function defineLibrary(config) {
-  return config;
-}
-export function defineModel(config) {
-  return config;
-}
-export function defineNotification(config) {
-  return config;
-}
-export function defineSms(config) {
-  return config;
-}
-export function defineEmail(config) {
-  return config;
-}
-export function defineChat(config) {
-  return config;
-}
-export function definePage(config) {
-  return config;
-}
-export function definePayment(config) {
-  return config;
-}
-export function defineQueue(config) {
-  return config;
-}
-export function defineSearchEngine(config) {
-  return config;
-}
-export function defineServices(config) {
-  return config;
-}
-export function defineStorage(config) {
-  return config;
-}
-export function defineUi(config) {
-  return config;
-}

package/dist/currency.d.ts

@@ -1,3 +0,0 @@
-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/currency.mjs

@@ -1,28 +0,0 @@
-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";

package/dist/debounce.d.ts

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

package/dist/debounce.mjs

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

package/dist/delete.d.ts

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

package/dist/delete.mjs

@@ -1 +0,0 @@
-export { rimraf, rimraf as del } from "rimraf";

package/dist/equal.d.ts

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

package/dist/equal.mjs

@@ -1,23 +0,0 @@
-import { getTypeName } from "./base.mjs";
-export function isDeepEqual(value1, value2) {
-  const type1 = getTypeName(value1);
-  const type2 = getTypeName(value2);
-  if (type1 !== type2)
-    return false;
-  if (type1 === "array") {
-    if (value1.length !== value2.length)
-      return false;
-    return value1.every((item, i) => {
-      return isDeepEqual(item, value2[i]);
-    });
-  }
-  if (type1 === "object") {
-    const keyArr = Object.keys(value1);
-    if (keyArr.length !== Object.keys(value2).length)
-      return false;
-    return keyArr.every((key) => {
-      return isDeepEqual(value1[key], value2[key]);
-    });
-  }
-  return Object.is(value1, value2);
-}

package/dist/function.d.ts

@@ -1,18 +0,0 @@
-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/function.mjs

@@ -1,7 +0,0 @@
-export function batchInvoke(functions) {
-  functions.forEach((fn) => fn && fn());
-}
-export function tap(value, callback) {
-  callback(value);
-  return value;
-}

package/dist/guards.d.ts

@@ -1,28 +0,0 @@
-/**
- * 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/guards.mjs

@@ -1,12 +0,0 @@
-export function notNullish(v) {
-  return v != null;
-}
-export function noNull(v) {
-  return v !== null;
-}
-export function notUndefined(v) {
-  return v !== void 0;
-}
-export function isTruthy(v) {
-  return Boolean(v);
-}

package/dist/helpers.d.ts

@@ -1,46 +0,0 @@
-/// <reference types="node" />
-import type { AddressInfo } from 'node:net';
-import type { CliOptions, CommandResult, Manifest, NpmScript } from '@stacksjs/types';
-export declare function isProjectCreated(): 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<CommandResult>;
-/**
- * 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;

package/dist/helpers.mjs

@@ -1,92 +0,0 @@
-import { frameworkPath, projectPath } from "@stacksjs/path";
-import { parse } from "yaml";
-import { execSync, log, runCommand, spawn } from "@stacksjs/cli";
-import { app, ui } from "@stacksjs/config";
-import * as storage from "@stacksjs/storage";
-import { semver } from "./versions.mjs";
-export async function isProjectCreated() {
-  if (storage.isFile(".env"))
-    return await isAppKeySet();
-  if (storage.isFile(".env.example"))
-    await spawn("cp .env.example .env", { stdio: "inherit", cwd: projectPath() });
-  return await isAppKeySet();
-}
-export async function installIfVersionMismatch() {
-  const dependenciesYaml = storage.fs.readFileSync(projectPath("tea.yaml"), "utf8");
-  const dependencies = parseYaml(dependenciesYaml).dependencies;
-  const requiredNodeVersion = dependencies["nodejs.org"];
-  const requiredPnpmVersion = dependencies["pnpm.io"];
-  const installedNodeVersion = process.version;
-  const installedPnpmVersion = execSync("pnpm -v").trim();
-  if (!semver.satisfies(installedNodeVersion, requiredNodeVersion)) {
-    log.error(`Installed Node.js version (${installedNodeVersion}) does not satisfy required version (${requiredNodeVersion}). One moment...`);
-    await runCommand(`tea +nodejs.org${requiredNodeVersion} >/dev/null 2>&1`);
-  }
-  if (!semver.satisfies(installedPnpmVersion, requiredPnpmVersion)) {
-    log.error(`Installed pnpm version (${installedPnpmVersion}) does not satisfy required version (${requiredPnpmVersion}). One moment...`);
-    await runCommand(`tea +pnpm.io${requiredPnpmVersion} >/dev/null 2>&1`);
-  }
-}
-export async function frameworkVersion() {
-  return (await storage.readPackageJson(frameworkPath("package.json"))).version;
-}
-export async function isAppKeySet() {
-  const env = await storage.readTextFile(".env", projectPath());
-  const lines = env.data.split("\n");
-  const appKey = lines.find((line) => line.startsWith("APP_KEY="));
-  return !!(appKey && appKey.length > 16);
-}
-export function determineResetPreset(preset) {
-  if (ui.reset)
-    preset = ui.reset;
-  if (preset === "tailwind")
-    return ["import '@unocss/reset/tailwind.css'"];
-  if (preset === "normalize")
-    return ["import '@unocss/reset/normalize.css'"];
-  if (preset === "sanitize")
-    return ["import '@unocss/reset/sanitize/sanitize.css'", "import '@unocss/reset/sanitize/assets.css"];
-  if (preset === "eric-meyer")
-    return ["import '@unocss/reset/eric-meyer.css'"];
-  if (preset === "antfu")
-    return ["import '@unocss/reset/antfu.css'"];
-  return [];
-}
-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 storage.readTextFile(projectPath(".env"));
-  await storage.writeTextFile({
-    path: projectPath(".env"),
-    data: file.data.replace(/APP_KEY=/g, `APP_KEY=${value}`)
-    // todo: do not hardcode the APP_KEY here and instead use the key parameter
-  });
-}
-export async function runNpmScript(script, options) {
-  const { data: manifest } = await storage.readJsonFile("package.json", frameworkPath());
-  if (isManifest(manifest) && hasScript(manifest, script))
-    return await runCommand(`pnpm run ${script}`, options);
-  log.error(`The specified npm script "${script}" does not exist in the package.json file`);
-  process.exit();
-}
-export function hasScript(manifest, script) {
-  const scripts = manifest.scripts;
-  if (scripts && typeof scripts === "object")
-    return Boolean(scripts[script]);
-  return false;
-}
-export function parseYaml(content) {
-  return parse(content);
-}
-export function determineDebugLevel(options) {
-  if (options?.verbose === true)
-    return true;
-  return app.debug === true;
-}
-export function isIpv6(address) {
-  return address.family === "IPv6" || address.family === 6;
-}

package/dist/index.d.ts

@@ -1,15 +0,0 @@
-export * from './base';
-export * from './config';
-export * from './currency';
-export * from './debounce';
-export * from './delete';
-export * from './equal';
-export * from './function';
-export * from './guards';
-export * from './helpers';
-export * from './math';
-export * from './p';
-export * from './promise';
-export * from './throttle';
-export * from './vendors';
-export * from './versions';

package/dist/index.mjs

@@ -1,15 +0,0 @@
-export * from "./base.mjs";
-export * from "./config.mjs";
-export * from "./currency.mjs";
-export * from "./debounce.mjs";
-export * from "./delete.mjs";
-export * from "./equal.mjs";
-export * from "./function.mjs";
-export * from "./guards.mjs";
-export * from "./helpers.mjs";
-export * from "./math.mjs";
-export * from "./p.mjs";
-export * from "./promise.mjs";
-export * from "./throttle.mjs";
-export * from "./vendors.mjs";
-export * from "./versions.mjs";

package/dist/math.d.ts

@@ -1,3 +0,0 @@
-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, not, or, useAbs, useAverage, useCeil, useClamp, useFloor, useMath, useMax, useMin, usePrecision, useProjection, useRound, useSum, useTrunc, } from '@vueuse/math';