stacks 0.40.0 → 0.44.9

package/core/utils/node_modules/.bin/tsc

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+fi

package/core/utils/node_modules/.bin/tsserver

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+fi

package/core/utils/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@stacksjs/utils",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/helpers"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "objects",
+    "strings",
+    "arrays",
+    "alias",
+    "helpers",
+    "utilities",
+    "functions",
+    "stacks"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.18.2"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@stacksjs/arrays": "workspace:*",
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/lint": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@vueuse/core": "^9.6.0",
+    "@vueuse/head": "^1.0.22",
+    "@vueuse/math": "^9.6.0",
+    "@vueuse/shared": "^9.6.0",
+    "defu": "^6.1.1",
+    "detect-indent": "^7.0.1",
+    "detect-newline": "^4.0.0",
+    "dinero.js": "2.0.0-alpha.12",
+    "esno": "^0.16.3",
+    "fast-glob": "^3.2.12",
+    "kolorist": "1.6.0",
+    "p-limit": "^4.0.0",
+    "rimraf": "^3.0.2",
+    "throttle-debounce": "^5.0.0"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4"
+  }
+}

package/core/utils/src/base.ts

@@ -0,0 +1,10 @@
+// export const assert = (condition: boolean, message: string): asserts condition => {
+//   if (!condition)
+//     throw new Error(message)
+// }
+export const toString = (v: any) => Object.prototype.toString.call(v)
+// export const noop = () => {}
+
+export const loop = (times: number, callback: any) => {
+  [...Array(times)].forEach((item, i) => callback(i))
+}

package/core/utils/src/function.ts

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

package/core/utils/src/guards.ts

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

package/core/utils/src/helpers.ts

@@ -0,0 +1,134 @@
+import { log, runCommand, spawn } from '@stacksjs/cli'
+import { type CliOptions, type Manifest, type NpmScript } from '@stacksjs/types'
+import { frameworkPath, projectPath } from '@stacksjs/path'
+import storage from '@stacksjs/storage'
+import { ui } from '@stacksjs/config'
+
+export async function isProjectCreated() {
+  if (storage.isFile('.env'))
+    return await isAppKeySet()
+
+  // copy the .env.example to become the .env file
+  if (storage.isFile('.env.example'))
+    await spawn('cp .env.example .env', { stdio: 'inherit', cwd: projectPath() })
+
+  return await isAppKeySet()
+}
+
+export async function readVersion() {
+  const packageJson = await storage.fs.readJson(frameworkPath('package.json'))
+  return packageJson.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='))
+
+  if (appKey && appKey.length > 16)
+    return true
+
+  return false
+}
+
+/**
+ * Determines the utilized reset preset.
+ *
+ * @url https://www.npmjs.com/package/@unocss/reset
+ * @param preset
+ */
+export function determineResetPreset(preset?: string) {
+  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 env(key?: string, fallback?: any) {
+  // console.log('isClient', isClient)
+  // if (key && import.meta?.env)
+  //   return import.meta.env[key]
+
+  return fallback
+}
+
+export function config(key?: string, fallback?: string) {
+  // eslint-disable-next-line no-console
+  console.log('key', key, 'fallback', fallback)
+  // return key ? configArr[key as string] : fallback
+}
+
+/**
+ * Determines whether the specified value is a package manifest.
+ */
+export function isManifest(obj: any): obj is Manifest {
+  return obj
+    && typeof obj === 'object'
+    && isOptionalString(obj.name)
+    && isOptionalString(obj.version)
+    && isOptionalString(obj.description)
+}
+
+/**
+ * Determines whether the specified value is a string, null, or undefined.
+ */
+export function isOptionalString(value: any): value is string | undefined {
+  const type = typeof value
+  return value === null
+    || type === 'undefined'
+    || type === 'string'
+}
+
+export async function setEnvValue(key: string, value: string) {
+  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
+  })
+}
+
+/**
+ * Runs the specified NPM script in the package.json file.
+ */
+export async function runNpmScript(script: NpmScript, options?: CliOptions) {
+  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()
+}
+
+/**
+ * Determines whether the specified NPM script exists in the given manifest.
+ */
+export function hasScript(manifest: Manifest, script: NpmScript): boolean {
+  const scripts = manifest.scripts as Record<NpmScript, string> | undefined
+
+  if (scripts && typeof scripts === 'object')
+    return Boolean(scripts[script])
+
+  return false
+}
+
+export * from '@dinero.js/currencies'
+export * from 'dinero.js'
+export * as detectIndent from 'detect-indent'
+export { detectNewline } from 'detect-newline'

package/core/utils/src/index.ts

@@ -0,0 +1,13 @@
+export * from './base'
+export * from './helpers'
+export * from './promise'
+export * from './function'
+export * from './guards'
+export * from './is'
+export * from './p'
+export * from './vendor'
+
+export * from '@vueuse/core'
+export * from '@vueuse/math'
+// export * from '@vueuse/head'
+export * from '@vueuse/shared'

package/core/utils/src/is.ts

@@ -0,0 +1,12 @@
+// import { toString } from './base'
+
+// export const isDef = <T = any>(val?: T): val is T => typeof val !== 'undefined'
+// export const isBoolean = (val: any): val is boolean => typeof val === 'boolean'
+// export const isFunction = <T extends Function> (val: any): val is T => typeof val === 'function'
+// export const isNumber = (val: any): val is number => typeof val === 'number'
+// export const isString = (val: unknown): val is string => typeof val === 'string'
+// export const isObject = (val: any): val is object => toString(val) === '[object Object]'
+
+// export const isWindow = (val: any): boolean => typeof window !== 'undefined' && toString(val) === '[object Window]'
+export const isBrowser = typeof window !== 'undefined'
+export const isServer = typeof document === 'undefined' // https://remix.run/docs/en/v1/pages/gotchas#typeof-window-checks

package/core/utils/src/p.ts

@@ -0,0 +1,118 @@
+import pLimit from 'p-limit'
+
+/**
+ * Internal marker for filtered items
+ */
+const VOID = Symbol('p-void')
+
+interface POptions {
+  /**
+   * How many promises are resolved at the same time.
+   */
+  concurrency?: number | undefined
+}
+
+class PInstance<T = any> extends Promise<Awaited<T>[]> {
+  private promises = new Set<T | Promise<T>>()
+
+  get promise(): Promise<Awaited<T>[]> {
+    let batch
+    const items = [...Array.from(this.items), ...Array.from(this.promises)]
+
+    if (this.options?.concurrency) {
+      const limit = pLimit(this.options.concurrency)
+      batch = Promise.all(items.map(p => limit(() => p)))
+    }
+    else {
+      batch = Promise.all(items)
+    }
+
+    return batch.then(l => l.filter((i: any) => i !== VOID))
+  }
+
+  constructor(public items: Iterable<T> = [], public options?: POptions) {
+    super(() => {})
+  }
+
+  add(...args: (T | Promise<T>)[]) {
+    args.forEach((i) => {
+      this.promises.add(i)
+    })
+  }
+
+  map<U>(fn: (value: Awaited<T>, index: number) => U): PInstance<Promise<U>> {
+    return new PInstance(
+      Array.from(this.items)
+        .map(async (i, idx) => {
+          const v = await i
+          if ((v as any) === VOID)
+            return VOID as unknown as U
+          return fn(v, idx)
+        }),
+      this.options,
+    )
+  }
+
+  filter(fn: (value: Awaited<T>, index: number) => boolean | Promise<boolean>): PInstance<Promise<T>> {
+    return new PInstance(
+      Array.from(this.items)
+        .map(async (i, idx) => {
+          const v = await i
+          const r = await fn(v, idx)
+          if (!r)
+            return VOID as unknown as T
+          return v
+        }),
+      this.options,
+    )
+  }
+
+  forEach(fn: (value: Awaited<T>, index: number) => void): Promise<void> {
+    return this.map(fn).then()
+  }
+
+  reduce<U>(fn: (previousValue: U, currentValue: Awaited<T>, currentIndex: number, array: Awaited<T>[]) => U, initialValue: U): Promise<U> {
+    return this.promise.then(array => array.reduce(fn, initialValue))
+  }
+
+  clear() {
+    this.promises.clear()
+  }
+
+  then(fn?: () => PromiseLike<any>) {
+    const p = this.promise
+    if (fn)
+      return p.then(fn)
+    else
+      return p
+  }
+
+  catch(fn?: (err: unknown) => PromiseLike<any>) {
+    return this.promise.catch(fn)
+  }
+
+  finally(fn?: () => void) {
+    return this.promise.finally(fn)
+  }
+}
+
+/**
+ * Utility for managing multiple promises.
+ *
+ * @see https://github.com/antfu/utils/tree/main/docs/p.md
+ * @category Promise
+ * @example
+ * ```
+ * import { p } from '@antfu/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 function p<T = any>(items?: Iterable<T>, options?: POptions): PInstance<T> {
+  return new PInstance(items, options)
+}

package/core/utils/src/promise.ts

@@ -0,0 +1,91 @@
+import { remove } from '@stacksjs/arrays'
+import type { Fn } from '@stacksjs/types'
+
+/**
+ * Promised `setTimeout`
+ *
+ * @category Promise
+ */
+export function sleep(ms: number, callback?: Fn<any>) {
+  return new Promise<void>(resolve =>
+    setTimeout(async () => {
+      await callback?.()
+      resolve()
+    }, ms),
+  )
+}
+
+/**
+ * Create a promise lock
+ *
+ * @category Promise
+ * @example
+ * ```
+ * const lock = createPromiseLock()
+ *
+ * lock.run(async () => {
+ *   await doSomething()
+ * })
+ *
+ * // in anther context:
+ * await lock.wait() // it will wait all tasking finished
+ * ```
+ */
+export function createPromiseLock() {
+  const locks: Promise<any>[] = []
+
+  return {
+    async run<T = void>(fn: () => Promise<T>): Promise<T> {
+      const p = fn()
+      locks.push(p)
+      try {
+        return await p
+      }
+      finally {
+        remove(locks, p)
+      }
+    },
+    async wait(): Promise<void> {
+      await Promise.allSettled(locks)
+    },
+    isWaiting() {
+      return Boolean(locks.length)
+    },
+    clear() {
+      locks.length = 0
+    },
+  }
+}
+
+/**
+ * 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
+}
+
+/**
+ * Return a Promise with `resolve` and `reject` methods
+ *
+ * @category Promise
+ * @example
+ * ```
+ * const promise = createControlledPromise()
+ *
+ * await promise
+ *
+ * // in anther context:
+ * promise.resolve(data)
+ * ```
+ */
+export function createControlledPromise<T>(): ControlledPromise<T> {
+  let resolve: any, reject: any
+  const promise = new Promise<T>((_resolve, _reject) => {
+    resolve = _resolve
+    reject = _reject
+  }) as ControlledPromise<T>
+  promise.resolve = resolve
+  promise.reject = reject
+  return promise
+}

package/core/utils/src/vendor.ts

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

package/core/utils/tests/example.test.ts

@@ -0,0 +1,7 @@
+import { assert, describe, test } from 'vitest'
+
+describe('example test', () => {
+  test('assert', () => {
+    assert.equal(1, 1)
+  })
+})

package/core/x-ray/README.md

@@ -0,0 +1,55 @@
+# Stacks X-Ray
+
+Visualize & debug your application logs.
+
+## ☘️ Features
+
+- Works in browser & server
+- Visualizes logs
+- Debugs logs
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/x-ray
+```
+
+Now, you can use it in your project:
+
+```ts
+import xRay from '@stacksjs/x-ray'
+
+// wip
+```
+
+Learn more in the docs.
+
+## 🧪 Testing
+
+```bash
+pnpm test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
+
+## 🏝 Community
+
+For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+
+[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)
+
+For casual chit-chat with others using this package:
+
+[Join the Stacks Discord Server](https://discord.ow3.org)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.
+
+Made with ❤️

package/core/x-ray/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>X Ray App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./src/desktop/main.ts"></script>
+  </body>
+</html>

package/core/x-ray/node_modules/.bin/mkdist

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

package/core/x-ray/node_modules/.bin/tsc

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+fi