stacks 0.52.10 → 0.56.3

package/core/strings/src/macro.ts

@@ -0,0 +1,139 @@
+import { Macroable } from 'macroable'
+import * as c from './case'
+import * as p from './pluralize'
+import * as u from './utils'
+
+export class Str extends Macroable {
+  slash(str: string) {
+    return u.slash(str)
+  }
+
+  ensurePrefix(prefix: string, str: string) {
+    return u.ensurePrefix(prefix, str)
+  }
+
+  ensureSuffix(suffix: string, str: string) {
+    return u.ensureSuffix(suffix, str)
+  }
+
+  template(str: string, ...args: any[]): string {
+    return u.template(str, ...args)
+  }
+
+  /**
+   * Truncate a string
+   */
+  truncate(str: string, length: number, end = '...') {
+    return u.truncate(str, length, end)
+  }
+
+  random(length = 16) {
+    return u.randomStr(length)
+  }
+
+  capitalize(str: string) {
+    return c.capitalize(str)
+  }
+
+  slug(str: string) {
+    return u.slug(str)
+  }
+
+  detectIndent(str: string) {
+    return u.detectIndent(str)
+  }
+
+  detectNewline(str: string) {
+    return u.detectNewline(str)
+  }
+
+  camelCase(str: string) {
+    return c.camelCase(str)
+  }
+
+  capitalCase(str: string) {
+    return c.capitalCase(str)
+  }
+
+  constantCase(str: string) {
+    return c.constantCase(str)
+  }
+
+  dotCase(str: string) {
+    return c.dotCase(str)
+  }
+
+  headerCase(str: string) {
+    return c.headerCase(str)
+  }
+
+  noCase(str: string) {
+    return c.noCase(str)
+  }
+
+  paramCase(str: string) {
+    return c.paramCase(str)
+  }
+
+  pascalCase(str: string) {
+    return c.pascalCase(str)
+  }
+
+  pathCase(str: string) {
+    return c.pathCase(str)
+  }
+
+  sentenceCase(str: string) {
+    return c.sentenceCase(str)
+  }
+
+  snakeCase(str: string) {
+    return c.snakeCase(str)
+  }
+
+  titleCase(str: string) {
+    return c.titleCase(str)
+  }
+
+  kebabCase(str: string) {
+    return c.kebabCase(str)
+  }
+
+  plural(str: string) {
+    // plural, singular, isPlural, isSingular, addPluralRule, addSingularRule, addIrregularRule, addUncountableRule
+    return p.plural(str)
+  }
+
+  singular(str: string) {
+    return p.singular(str)
+  }
+
+  isPlural(str: string) {
+    return p.isPlural(str)
+  }
+
+  isSingular(str: string) {
+    return p.isSingular(str)
+  }
+
+  addPluralRule(rule: string | RegExp, repl: string) {
+    return p.addPluralRule(rule, repl)
+  }
+
+  addSingularRule(rule: string | RegExp, repl: string) {
+    return p.addSingularRule(rule, repl)
+  }
+
+  addIrregularRule(single: string, plural: string) {
+    return p.addIrregularRule(single, plural)
+  }
+
+  addUncountableRule(word: string | RegExp) {
+    return p.addUncountableRule(word)
+  }
+
+  static macros = {}
+  static getters = {}
+}
+
+export const str = new Str()

package/core/strings/src/utils.ts

@@ -78,6 +78,13 @@ export function template(str: string, ...args: any[]): string {
   })
 }
 
+export function truncate(str: string, length: number, end = '...') {
+  if (str.length <= length)
+    return str
+
+  return str.slice(0, length - end.length) + end
+}
+
 /**
  * Generate a random string
  * @category String
@@ -91,18 +98,6 @@ export function randomStr(size = 16, dict = urlAlphabet) {
   return id
 }
 
-/**
- * First letter uppercase, other lowercase
- * @category string
- * @example
- * ```
- * capitalize('hello world') => 'Hello world'
- * ```
- */
-export function capitalize(str: string): string {
-  return str[0].toUpperCase() + str.slice(1).toLowerCase()
-}
-
 /**
  * Slugify a string
  * @category string
@@ -120,3 +115,6 @@ export function slug(str: string, options?: SlugOptions): string {
     strict: true,
   })
 }
+
+export { default as detectIndent } from 'detect-indent'
+export { detectNewline } from 'detect-newline'

package/core/testing/build.config.ts

@@ -1,6 +1,8 @@
-import { defineBuildConfig } from 'unbuild'
+import { alias, defineBuildConfig } from '@stacksjs/development'
 
 export default defineBuildConfig({
+  alias,
+
   entries: [
     {
       builder: 'mkdist',

package/core/testing/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/testing",
   "type": "module",
-  "version": "0.52.10",
-  "packageManager": "pnpm@8.5.1",
+  "version": "0.56.3",
+  "packageManager": "pnpm@8.6.5",
   "description": "The Stacks way of testing.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -46,17 +46,17 @@
   "scripts": {
     "build": "unbuild",
     "dev": "unbuild --stub",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "unbuild",
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@playwright/test": "^1.33.0",
-    "@vitest/coverage-istanbul": "^0.31.1",
-    "@vitest/ui": "^0.31.1",
-    "vitest": "^0.31.1"
+    "@playwright/test": "^1.35.1",
+    "@vitest/coverage-istanbul": "^0.32.2",
+    "@vitest/ui": "^0.32.2",
+    "vitest": "^0.32.2"
   },
   "devDependencies": {
-    "typescript": "^5.0.4",
+    "typescript": "^5.1.3",
     "unbuild": "^1.2.1"
   }
 }

package/core/tinker/build.config.ts

@@ -0,0 +1,12 @@
+import { alias, defineBuildConfig } from '@stacksjs/development'
+
+export default defineBuildConfig({
+  alias,
+
+  entries: [
+    './src/index',
+  ],
+
+  clean: true,
+  declaration: true,
+})

package/core/tinker/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/tinker",
   "type": "module",
-  "version": "0.52.10",
-  "packageManager": "pnpm@8.5.1",
+  "version": "0.56.3",
+  "packageManager": "pnpm@8.6.5",
   "description": "The Stacks way to tinker.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -36,10 +36,22 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "prepublishOnly": "unbuild",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@vue/repl": "^2.3.0",
+    "tsx": "^3.12.7"
+  },
   "dependencies": {
+    "@vue/repl": "^2.3.0",
     "tsx": "^3.12.7"
   },
   "devDependencies": {
-    "@stacksjs/development": "workspace:*"
+    "typescript": "^5.1.3",
+    "unbuild": "^1.2.1"
   }
 }

package/core/tinker/src/index.ts

@@ -0,0 +1 @@
+export * from '@vue/repl'

package/core/types/build.config.ts

@@ -1,13 +1,22 @@
-import { defineBuildConfig } from 'unbuild'
+import type { BuildConfig } from '@stacksjs/development'
+import { alias, defineBuildConfig } from '@stacksjs/development'
+
+type Entries = BuildConfig['entries']
+const devEntries: Entries = [{
+  input: './src/index',
+  outDir: './dist/',
+}]
+const buildEntries = devEntries
+const command = process.env.npm_lifecycle_script
+const entries: Entries = command?.includes('--stub') ? devEntries : buildEntries
 
 export default defineBuildConfig({
-  entries: [
-    {
-      builder: 'mkdist',
-      input: './src/',
-      outDir: './dist/',
-      format: 'esm',
-    },
+  alias,
+
+  entries,
+
+  externals: [
+    '@stacksjs/utils',
   ],
 
   clean: true,

package/core/types/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.52.10",
-  "packageManager": "pnpm@8.5.1",
+  "version": "0.56.3",
+  "packageManager": "pnpm@8.6.5",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -26,9 +26,9 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs"
-    }
+    },
+    "./*": "./*"
   },
-  "main": "dist/index.mjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "contributors": [
@@ -41,41 +41,47 @@
   "scripts": {
     "build": "unbuild",
     "dev": "unbuild --stub",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "unbuild",
     "typecheck": "tsc --noEmit"
   },
+  "peerDependencies": {
+    "neverthrow": "^6.0.0"
+  },
   "dependencies": {
     "@mdit-vue/plugin-component": "^0.12.0",
     "@mdit-vue/plugin-frontmatter": "^0.12.0",
     "@mdit-vue/types": "^0.12.0",
-    "@novu/stateless": "^0.15.0",
+    "@novu/stateless": "^0.16.1",
     "@rollup/pluginutils": "^5.0.2",
-    "@stacksjs/development": "workspace:*",
     "@types/bcryptjs": "^2.4.2",
     "@types/crypto-js": "^4.1.1",
-    "@types/eslint": "^8.37.0",
+    "@types/eslint": "^8.40.2",
     "@types/fs-extra": "^11.0.1",
     "@types/markdown-it-link-attributes": "^3.0.1",
     "@types/minimatch": "^5.1.2",
-    "@types/node": "^18.16.13",
+    "@types/node": "^18.16.18",
     "@types/nprogress": "^0.2.0",
     "@types/pluralize": "^0.0.29",
+    "@vinejs/vine": "^1.4.1",
     "cac": "^6.7.14",
     "execa": "^7.1.1",
     "markdown-it": "^13.0.1",
-    "meilisearch": "^0.32.3",
+    "meilisearch": "^0.33.0",
     "neverthrow": "^6.0.0",
     "ora": "^6.3.1",
-    "unocss": "^0.51.13",
-    "unplugin-auto-import": "^0.16.0",
-    "unplugin-vue-components": "^0.24.1",
-    "vite": "^4.3.8",
-    "vite-plugin-inspect": "^0.7.26",
-    "vite-plugin-pwa": "^0.15.0",
+    "unocss": "^0.53.4",
+    "unplugin-auto-import": "^0.16.4",
+    "unplugin-vue-components": "^0.25.1",
+    "vite": "^4.3.9",
+    "vite-plugin-inspect": "^0.7.29",
+    "vite-plugin-pwa": "^0.16.4",
     "vite-plugin-vue-layouts": "^0.8.0",
     "vite-ssg": "^0.22.2",
-    "vitepress": "1.0.0-alpha.76",
-    "vue": "^3.3.4",
-    "zod": "^3.21.4"
+    "vitepress": "1.0.0-beta.3",
+    "vue": "^3.3.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.1.3",
+    "unbuild": "^1.2.1"
   }
 }

package/core/types/src/app.ts

@@ -26,7 +26,7 @@ export interface AppOptions {
    *
    * @default "local"
    */
-  env?: 'local' | 'development' | 'production'
+  env: 'local' | 'development' | 'staging' | 'production'
 
   /**
    * **Application URL**
@@ -35,10 +35,10 @@ export interface AppOptions {
    * the Buddy command line tool. You should set this to the root of
    * your application so that it is used when running Buddy tasks.
    *
-   * @default string "https://localhost"
-   * @example "https://hello-world.test"
+   * @default string "https://stacks.test"
+   * @example "https://my-project.test"
    */
-  url?: string
+  url: string
 
   /**
    * **Application Debug Mode**

package/core/types/src/cli.ts

@@ -214,7 +214,7 @@ export type LibEntryType = 'vue-components' | 'web-components' | 'functions' | '
  */
 export const enum NpmScript {
   Build = 'build',
-  BuildComponents = 'build:components',
+  BuildComponents = 'vite build --config ./core/build/src/vue-components.ts',
   BuildWebComponents = 'build:web-components',
   BuildFunctions = 'build:functions',
   BuildDocs = 'build:docs',
@@ -227,8 +227,9 @@ export const enum NpmScript {
   DevPages = 'dev:pages',
   DevFunctions = 'dev:functions',
   Fresh = 'fresh',
-  Lint = 'eslint . ; npx publint',
+  Lint = 'eslint .',
   LintFix = 'eslint . --fix',
+  LintPackageJson = 'npx publint',
   MakeStack = 'make:stack',
   Test = 'vitest --config vitest.config.ts',
   TestUnit = 'vitest --config vitest.config.ts',
@@ -256,48 +257,47 @@ export const enum NpmScript {
   Prepublish = 'prepublish',
   Wip = 'wip',
   UpgradeNode = './.stacks/scripts/setup.sh +nodejs.org',
-  UpgradePackageManager = './.stacks/scripts/setup.sh +pnpm.io',
+  UpgradeDependencies = 'pnpm up',
 }
 
 export const enum Action {
-  Bump = 'bump', // wip - changelog action
+  Bump = 'bump',
   BuildStacks = 'build/stacks',
-  BuildComponentLibs = 'build-component-libs',
+  BuildComponentLibs = 'build/component-libs',
   BuildVueComponentLib = 'build-vue-component-lib',
   BuildWebComponentLib = 'build-web-component-lib',
   BuildCli = 'build-cli',
-  BuildCore = 'build/core', // wip
+  BuildCore = 'build/core',
   BuildDocs = 'build-docs',
   BuildFunctionLib = 'build-function-lib',
-  Changelog = 'changelog', // wip
-  Clean = 'clean', // wip
-  DevComponents = 'dev/components', // wip
-  DevDocs = 'dev/docs', // wip
-  Deploy = 'deploy', // wip
-  Fresh = 'fresh', // wip
-  GeneratePackageJsons = 'generate/package-jsons', // ✅
-  GenerateSettings = 'generate-settings', // wip
-  GenerateOnboarding = 'generate-onboarding', // wip
-  Inspire = 'inspire', // wip
-  KeyGenerate = 'key-generate', // wip
-  MakeNotification = 'make-notification', // wip
-  Migrate = 'migrate', // wip
-  Seed = 'seed', // wip
-  Lint = 'lint/index', // wip
-  LintFix = 'lint/fix', // wip
-  Prepublish = 'prepublish', // wip
-  Release = 'release', // wip
-  ShowFeatureTestReport = 'show-feature-test-report', // wip
-  Test = 'test', // wip
-  TestUi = 'test-ui', // wip
-  TestUnit = 'test-unit', // wip
-  TestFeature = 'test-feature', // wip
-  TestCoverage = 'test-coverage', // wip
+  Changelog = 'changelog',
+  Clean = 'clean',
+  DevComponents = 'dev/components', // ✅
+  Dev = 'dev/index',
+  DevDocs = 'dev/docs',
+  Deploy = 'deploy',
+  Fresh = 'fresh',
+  GenerateLibraryEntries = 'generate/lib-entries', // ✅
+  Inspire = 'inspire',
+  KeyGenerate = 'key-generate',
+  MakeNotification = 'make-notification',
+  Migrate = 'migrate',
+  Seed = 'seed',
+  Lint = 'lint/index',
+  LintFix = 'lint/fix',
+  Prepublish = 'prepublish',
+  Release = 'release', // ✅
+  ShowFeatureTestReport = 'show-feature-test-report',
+  Test = 'test',
+  TestUi = 'test-ui',
+  TestUnit = 'test-unit',
+  TestFeature = 'test-feature',
+  TestCoverage = 'test-coverage',
   Tinker = 'tinker',
-  Typecheck = 'typecheck', // wip
-  Upgrade = 'upgrade/index', // wip
-  UpgradeNode = 'upgrade/node', // wip
-  UpgradePackageManager = 'upgrade/package-manager', // wip
+  Typecheck = 'typecheck',
+  Upgrade = 'upgrade/index',
+  UpgradeNode = 'upgrade/node',
+  UpgradePackageManager = 'upgrade/package-manager',
 }
 
 export type { CAC as CLI } from 'cac'

package/core/types/src/cron-jobs.ts

@@ -1,17 +1,38 @@
 /**
  * Cron Job Options.
  */
-export interface CronJobOptions {
+export interface JobOptions {
   /**
-   * The name of the cron job.
+   * The name of the job.
    */
   name?: string
-  function: string
-  schedule: string
+  action?: string | Function
+  run?: string | Function
+  schedule?: string
   description?: string
   enabled?: boolean
   timezone?: string
+  active?: boolean
+  tries?: number
+  backoff?: number | number[]
 }
+export type Job = JobOptions
+export type Jobs = Job[]
 
+export interface CronJobOptions extends Omit<JobOptions, 'schedule'> {
+  schedule: string
+}
 export type CronJob = CronJobOptions
 export type CronJobs = CronJob[]
+
+export enum Every {
+  Minute = '* * * * *',
+  Hour = '0 * * * *',
+  HalfHour = '0,30 * * * *',
+  Day = '0 0 * * *',
+  Month = '0 0 1 * *',
+  Week = '0 0 * * 0',
+  Year = '0 0 1 1 *',
+  FifthMinute = '*/5 * * * *',
+  TenthMinute = '*/10 * * * *',
+}

package/core/types/src/database.ts

@@ -3,22 +3,31 @@ import type { Model } from './model'
 export type DatabaseClient = any
 
 export interface DatabaseOptions {
-  driver: string
+  default: string
 
-  drivers: {
+  connections: {
     mysql: {
       url?: string
       host?: string
       port?: number
       client?: DatabaseClient
-      name: string
+      name?: string
       username?: string
       password?: string
+      prefix?: string
+    }
+
+    sqlite: {
+      url?: string
+      database?: string
+      prefix?: string
     }
 
     planetscale: {}
     postgres: {}
   }
+
+  migrations: string
 }
 
 export interface FactoryOptions {

package/core/types/src/errors.ts

@@ -1,6 +1,24 @@
-export {
+import {
   Err,
   Ok,
   Result,
   ResultAsync,
 } from 'neverthrow'
+
+export declare class ValidationError extends Error {
+  messages: any
+  status: number
+  code: string
+  constructor(messages: any, options?: ErrorOptions)
+  get [Symbol.toStringTag](): string
+  toString(): string
+}
+
+export type StacksError = Error | ValidationError
+
+export {
+  Err,
+  Ok,
+  Result,
+  ResultAsync,
+}

package/core/types/src/events.ts

@@ -7,16 +7,24 @@
  *
  * @example To fire an event, you may use any of the following approaches:
  * ```ts
- * useEvent('user:registered', { name: 'Chris'})
- * dispatch('user:registered', { name: 'Chris'})
+ * dispatch('user:registered', { name: 'Chris', email: 'chris@stacksjs.dev' })
+ *
+ * // alternatively, you may use the following:
+ * useEvent('user:registered', { name: 'Chris', email: 'chris@stacksjs.dev' })
+ * events.emit('user:registered', { name: 'Chris', email: 'chris@stacksjs.dev' })
+ * useEvents.emit('user:registered', { name: 'Chris', email: 'chris@stacksjs.dev' })
  * ````
 
  * @example To capture an event, you may use any of the following approaches:
  * ```ts
- * useListen('user:registered', (user) => console.log(user))
- * listen('user:registered', (user) => console.log(user))
+ * listen('user:registered', (user) => sendWelcomeEmail(user))
+ *
+ * // alternatively, you may use the following:
+ * useListen('user:registered', (user) => sendWelcomeEmail(user))
+ * events.on('user:registered', (user) => sendWelcomeEmail(user))
+ * useEvents.on('user:registered', (user) => sendWelcomeEmail(user))
  * ```
  */
 export interface Events {
-  [key: string]: any
+  [key: string]: (...args: any[]) => Function
 }

package/core/types/src/fs.ts

@@ -20,6 +20,11 @@ export interface JsonFile {
  * Describes a package.json file.
  */
 export interface PackageJson {
+  engines: {
+    node: string
+    pnpm: string
+  }
+  version: string
   packageManager: string
   // wip
 }

package/core/types/src/git.ts

@@ -33,7 +33,7 @@ export interface GitOptions {
    * git: [
    *   scopes: [
    *     '', 'ci', 'deps', 'dx', 'release', 'readme', 'test', 'actions', 'build', 'cli',
-   *     'config', 'examples', 'functions', 'modules', 'pages', 'router', 'scripts',
+   *     'config', 'examples', 'functions', 'modules', 'views', 'router', 'scripts',
    *     'ui', 'utils', 'arrays', 'collections', 'fs', 'objects', 'strings',
    *   ]
    * ]