stacks 0.50.0 → 0.52.0

package/core/tinker/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@stacksjs/tinker",
+  "type": "module",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
+  "description": "The Stacks way to tinker.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/tinker#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/tinker"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "tinker",
+    "repl",
+    "typescript",
+    "tsx",
+    "zero-config",
+    "stacks"
+  ],
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "bin": {
+    "tinker": "tinker.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "tsx": "^3.12.7"
+  },
+  "devDependencies": {
+    "@stacksjs/development": "workspace:*"
+  }
+}

package/core/tinker/tinker.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('tsx/cli')

package/core/types/README.md

@@ -38,7 +38,7 @@ pnpm test
 
 Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
 
-## 💪🏼 Contributing
+## 🚜 Contributing
 
 Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
 

package/core/types/build.config.ts

@@ -0,0 +1,13 @@
+import { defineBuildConfig } from 'unbuild'
+
+export default defineBuildConfig({
+  entries: [
+    {
+      builder: 'mkdist',
+      input: './src/',
+      outDir: './dist/',
+    },
+  ],
+
+  declaration: true,
+})

package/core/types/node_modules/.bin/markdown-it

@@ -6,9 +6,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules/markdown-it/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules/markdown-it/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules:/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"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules/markdown-it/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules/markdown-it/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/markdown-it@13.0.1/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/markdown-it@13.0.1/node_modules/markdown-it/bin/markdown-it.js" "$@"

package/core/types/node_modules/.bin/vite

@@ -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/vite@4.3.7_@types+node@18.16.10/node_modules/vite/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules/vite/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules/vite/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules/vite/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vite@4.3.7_@types+node@18.16.10/node_modules/vite/bin/vite.js" "$@"
+fi

package/core/types/node_modules/.bin/vite-ssg

@@ -6,12 +6,12 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules:/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"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vite-ssg@0.22.1_wg5sslydmzl6un74innclax7im/node_modules/vite-ssg/bin/vite-ssg.js" "$@"
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/bin/vite-ssg.js" "$@"
 else
-  exec node  "$basedir/../../../../../node_modules/.pnpm/vite-ssg@0.22.1_wg5sslydmzl6un74innclax7im/node_modules/vite-ssg/bin/vite-ssg.js" "$@"
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vite-ssg@0.22.2_@vueuse+head@1.1.26_vite@4.3.7_vue-router@4.2.0_vue@3.3.2/node_modules/vite-ssg/bin/vite-ssg.js" "$@"
 fi

package/core/types/node_modules/.bin/vitepress

@@ -6,12 +6,12 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules:/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"
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/bin/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.40_j73j5xdbzpkigstapj6vkce2xy/node_modules/vitepress/bin/vitepress.js" "$@"
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/bin/vitepress.js" "$@"
 else
-  exec node  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.40_j73j5xdbzpkigstapj6vkce2xy/node_modules/vitepress/bin/vitepress.js" "$@"
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.75_@algolia+client-search@4.17.0_@types+node@18.16.10/node_modules/vitepress/bin/vitepress.js" "$@"
 fi

package/core/types/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.50.0",
-  "packageManager": "pnpm@7.25.1",
+  "version": "0.52.0",
+  "packageManager": "pnpm@8.5.1",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -22,6 +22,12 @@
     "framework",
     "typescript"
   ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -32,41 +38,44 @@
     "dist",
     "README.md"
   ],
-  "engines": {
-    "node": ">=v18.13.0",
-    "pnpm": ">=7.25.1"
-  },
   "scripts": {
-    "build": "mkdist -d",
-    "dev": "mkdist -d",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
     "prepublishOnly": "pnpm run build",
     "typecheck": "tsc --noEmit"
   },
-  "devDependencies": {
-    "@mdit-vue/plugin-component": "^0.11.2",
-    "@mdit-vue/plugin-frontmatter": "^0.11.1",
-    "@mdit-vue/types": "^0.11.0",
-    "@prisma/client": "^4.9.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.14.0",
     "@rollup/pluginutils": "^5.0.2",
+    "@stacksjs/development": "workspace:*",
     "@types/bcryptjs": "^2.4.2",
     "@types/crypto-js": "^4.1.1",
-    "@types/eslint": "^8.4.10",
+    "@types/eslint": "^8.37.0",
     "@types/fs-extra": "^11.0.1",
     "@types/markdown-it-link-attributes": "^3.0.1",
     "@types/minimatch": "^5.1.2",
-    "@types/node": "^18.11.18",
+    "@types/node": "^18.16.10",
     "@types/nprogress": "^0.2.0",
     "@types/pluralize": "^0.0.29",
-    "@types/prompts": "^2.4.2",
     "cac": "^6.7.14",
+    "execa": "^7.1.1",
     "markdown-it": "^13.0.1",
-    "mkdist": "^1.1.0",
-    "typescript": "^4.9.4",
-    "unplugin-auto-import": "^0.12.1",
-    "unplugin-vue-components": "^0.22.12",
-    "vite-plugin-inspect": "^0.7.14",
-    "vite-plugin-vue-layouts": "^0.7.0",
-    "vite-ssg": "^0.22.1",
-    "vitepress": "1.0.0-alpha.40"
+    "meilisearch": "^0.32.3",
+    "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.7",
+    "vite-plugin-inspect": "^0.7.26",
+    "vite-plugin-pwa": "^0.14.7",
+    "vite-plugin-vue-layouts": "^0.8.0",
+    "vite-ssg": "^0.22.2",
+    "vitepress": "1.0.0-alpha.75",
+    "vue": "^3.3.2",
+    "zod": "^3.21.4"
   }
 }

package/core/types/src/app.ts

@@ -1,7 +1,7 @@
 /**
  * **Application Options**
  *
- * This configuration defines all of your application options. Because Stacks is full-typed,
+ * This configuration defines all of your application options. Because Stacks is fully-typed,
  * you may hover any of the options below and the definitions will be provided. In case
  * you have any questions, feel free to reach out via Discord or GitHub Discussions.
  */
@@ -32,12 +32,11 @@ export interface AppOptions {
    * **Application URL**
    *
    * This URL is used by the console to properly generate URLs when using
-   * the Artisan command line tool. You should set this to the root of
-   * your application so that it is used when running Artisan tasks.
+   * 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
+   * @example "https://hello-world.test"
    */
   url?: string
 
@@ -107,17 +106,6 @@ export interface AppOptions {
    */
   fallbackLocale: 'en'
 
-  /**
-   * **Integrated Development Environment**
-   *
-   * Currently, only VS Code is fully supported. While you may use Stacks with
-   * any editor, some of its tooling is VS Code specific. Hence, for the
-   * best experience, VS Code is currently the recommended editor.
-   *
-   * @default string "vscode"
-   */
-  editor: string
-
   /**
    * **Cipher**
    *

package/core/types/src/auto-imports.ts

@@ -1,3 +1 @@
-import type { Options } from 'unplugin-auto-import/types'
-
-export type AutoImportsOptions = Options
+export type { Options as AutoImportsOptions } from 'unplugin-auto-import/types'

package/core/types/src/build.ts

@@ -1,2 +1,2 @@
 export type { UserConfig as ViteConfig } from 'vite'
-export { type ViteSSGContext } from 'vite-ssg'
+export type { ViteSSGContext } from 'vite-ssg'

package/core/types/src/cache.ts

@@ -0,0 +1,78 @@
+export interface CacheOptions {
+  /**
+   * **Cache Driver**
+   *
+   * This value determines the cache driver that will be used by your application to store
+   * cached data. By default, Stacks uses the "redis" driver, which stores cached data in
+   * in a self-configufed Redis instance. You may use any of the other drivers provided
+   * by Stacks or write your own custom driver.
+   *
+   * @default "redis"
+   * @example "redis"
+   * @example "memcached"
+   * @example "dynamodb"
+   *
+   * @see https://stacks.js.org/docs/cache
+   */
+  driver: string
+
+  /**
+   * **Cache Prefix**
+   *
+   * This value determines the prefix that will be used when storing items in the cache. This
+   * prefix may be useful when multiple applications are sharing the same cache driver so that
+   * they may avoid collisions when attempting to retrieve items from the cache.
+   *
+   * @default string "stacks"
+   * @example "stacks"
+   *
+   * @see https://stacks.js.org/docs/cache
+   */
+  prefix: string
+
+  /**
+   * **Cache TTL**
+   *
+   * This value determines the default time to live for items stored in the cache. This value
+   * may be overridden when storing items in the cache. If no value is specified, the cache
+   * driver will default to a reasonable time to live for the given item.
+   *
+   * @default number 3600
+   * @example 3600
+   * @example 3600 * 24
+   * @example -1 (never expires)
+   */
+  ttl: number
+
+  drivers: {
+    redis?: {
+      connection: string
+
+      /**
+       * **Redis Host**
+       *
+       * This value determines the host that will be used to connect to the Redis server.
+       *
+       * @default string "localhost"
+       * @example "localhost"
+       */
+      host: string
+
+      /**
+       * **Redis Port**
+       *
+       * This value determines the port that will be used to connect to the Redis server.
+       *
+       * @default number 6379
+       * @example 6379
+       */
+      port: number
+    }
+
+    memcached?: {
+    }
+
+    dynamodb?: {
+    }
+  }
+}

package/core/types/src/cdn.ts

@@ -0,0 +1,15 @@
+export interface CdnOptions {
+  /**
+   * **CDN Driver**
+   *
+   * This value determines the default CDN driver that will be used when interacting with the
+   * CDN service. This value may be overridden when interacting with the CDN service.
+   *
+   * @default "cloudfront"
+   * @example "cloudfront"
+   * @example "fastly" wip
+   *
+   * @see https://stacks.js.org/docs/cdn
+   */
+  driver: string
+}

package/core/types/src/cli.ts

@@ -3,12 +3,11 @@
  */
 
 import type { Ora } from 'ora'
+import type { ExecaReturnValue } from 'execa'
+import type { Err, Ok } from './errors'
 
-export interface StacksOptions {
-  componentsSrcPath?: string
-  dtsPath?: string
-  extensions?: string[]
-}
+export type CommandReturnValue = ExecaReturnValue<string>
+export type CommandResult = Ok<ExecaReturnValue<string>, Error | void> | Err<ExecaReturnValue<string>, Error | string | void>
 
 export interface OutroOptions {
   startTime?: number
@@ -25,20 +24,31 @@ export interface IntroOptions {
 
 type SpinnerOptions = Ora
 
+export type CliOptionsKeys = keyof CliOptions
+
+/**
+ * The CLI Options used in `./config/cli.ts`.
+ */
+export interface UserCliOptions {
+  name?: string
+  command?: string
+  description?: string
+}
+
 /**
  * The options to pass to the CLI.
  */
 export interface CliOptions {
   /**
-   * **CLI Debug Level**
+   * **Verbose Output**
    *
-   * When your application is in debug mode, a different level
-   * of information, like stack traces, will be shown. When
-   * disabled, it defaults to the "normal experience."
+   * When your application is in "verbose"-mode, a different level of,
+   * information like useful outputs for debugging reasons, will be
+   * shown. When disabled, it defaults to the "normal experience."
    *
    * @default false
    */
-  debug?: boolean
+  verbose?: boolean
 
   /**
    * **Current Work Directory**
@@ -84,13 +94,26 @@ export interface CliOptions {
    * @default false
    */
   shell?: boolean
+
+  /**
+   * **Encoding**
+   *
+   * Encoding type
+   *
+   * @default 'utf-8'
+   */
+  encoding?: string
 }
 
 export type { Ora as SpinnerOptions } from 'ora'
 
-export type ActionsOption = 'types'
-export type ActionsOptions = {
-  [key in ActionsOption]?: boolean;
+export type ActionOption = 'types'
+
+/**
+ * The options to pass to the Action.
+ */
+export type ActionOptions = {
+  [key in ActionOption]?: boolean;
 } & CliOptions
 
 export type BuildOption = 'components' | 'vueComponents' | 'webComponents' | 'elements' | 'functions' | 'docs' | 'pages' | 'stacks' | 'all'
@@ -108,8 +131,8 @@ export type CreateBooleanOption = 'ui' | 'components' | 'web-components' | 'vue'
 export type CreateOptions = {
   [key in CreateBooleanOption]: boolean
 } & {
-  [key in CreateStringOption]: string
-} & CliOptions
+    [key in CreateStringOption]: string
+  } & CliOptions
 
 export type DevOption = 'components' | 'docs' | 'pages' | 'functions' | 'desktop' | 'all'
 export type DevOptions = {
@@ -126,21 +149,22 @@ export type LintOptions = {
   [key in LintOption]: boolean;
 } & CliOptions
 
-export type MakeStringOption = 'name' | 'chat' | 'sms'
+export type MakeStringOption = 'name' | 'chat' | 'sms' | 'env'
 export type MakeBooleanOption = 'component' | 'page' | 'function' | 'language' | 'database' | 'migration' | 'factory' | 'notification' | 'stack'
 export type MakeOptions = {
   [key in MakeBooleanOption]: boolean
 } & {
-  [key in MakeStringOption]: string
-} & CliOptions
+    [key in MakeStringOption]: string
+  } & CliOptions
 
-export type UpdateString = 'version'
-export type UpdateBoolean = 'framework' | 'dependencies' | 'packageManager' | 'node' | 'all' | 'force'
-export type UpdateOptions = {
-  [key in UpdateString]: string;
+export type UpgradeBoolean = 'framework' | 'dependencies' | 'packageManager' | 'node' | 'all' | 'force'
+export type UpgradeString = 'version'
+
+export type UpgradeOptions = {
+  [key in UpgradeBoolean]: boolean;
 } & {
-  [key in UpdateBoolean]: boolean;
-} & CliOptions
+    [key in UpgradeString]: string;
+  } & CliOptions
 
 export type ExamplesString = 'version'
 export type ExamplesBoolean = 'components' | 'vue' | 'webComponents' | 'elements' | 'all' | 'force'
@@ -148,20 +172,22 @@ export type ExamplesOption = ExamplesString & ExamplesBoolean | void
 export type ExamplesOptions = {
   [key in ExamplesString]: string;
 } & {
-  [key in ExamplesBoolean]: boolean;
-} & CliOptions
+    [key in ExamplesBoolean]: boolean;
+  } & CliOptions
 export type TestOptions = CliOptions & {
   showReport?: boolean
 }
 
-export interface CleanOptions extends CliOptions {}
-export interface CommitOptions extends CliOptions {}
-export interface KeyOptions extends CliOptions {}
-export interface FreshOptions extends CliOptions {}
-export interface ReleaseOptions extends CliOptions {}
-export interface PreinstallOptions extends CliOptions {}
-export interface PrepublishOptions extends CliOptions {}
-export interface TypesOptions extends CliOptions {}
+export interface CleanOptions extends CliOptions { }
+export interface CommitOptions extends CliOptions { }
+export interface KeyOptions extends CliOptions { }
+export interface FreshOptions extends CliOptions { }
+export interface InspireOptions extends CliOptions { }
+export interface ReleaseOptions extends CliOptions { }
+export interface PreinstallOptions extends CliOptions { }
+export interface PrepublishOptions extends CliOptions { }
+export interface TinkerOptions extends CliOptions { }
+export interface TypesOptions extends CliOptions { }
 
 export type LibEntryType = 'vue-components' | 'web-components' | 'functions' | 'all'
 
@@ -175,20 +201,15 @@ export const enum NpmScript {
   BuildFunctions = 'build:functions',
   BuildDocs = 'build:docs',
   BuildStacks = 'build:stacks',
-  Clean = 'rimraf ./pnpm-lock.yaml ./node_modules/ ./.stacks/**/node_modules',
+  Clean = 'rimraf ./pnpm-lock.yaml ./node_modules/ ./.stacks/**/node_modules ./.stacks/**/dist',
   Dev = 'dev',
   DevComponents = 'vite --config ./core/build/src/vue-components.ts',
-  DevDocs = 'dev:docs',
+  DevDocs = 'npx vitepress dev ./docs/src',
   DevDesktop = 'dev:desktop',
   DevPages = 'dev:pages',
   DevFunctions = 'dev:functions',
   Fresh = 'fresh',
-  Update = 'update',
-  UpdateDependencies = 'pnpm update',
-  UpdateFramework = 'update:framework',
-  UpdatePackageManager = 'update:package-manager',
-  UpdateNode = 'pnpm env use',
-  Lint = 'eslint .',
+  Lint = 'eslint . ; npx publint',
   LintFix = 'eslint . --fix',
   MakeStack = 'make:stack',
   Test = 'vitest --config vitest.config.ts',
@@ -196,7 +217,7 @@ export const enum NpmScript {
   TestFeature = 'playwright test --config playwright.config.ts',
   TestUi = 'vitest --config vitest.config.ts --ui',
   TestCoverage = 'vitest --config vitest.config.ts --coverage',
-  TestTypes = 'vue-tsc --noEmit',
+  TestTypes = 'vue-npx tsc --noEmit',
   Generate = 'generate',
   GenerateTypes = 'generate:types',
   GenerateEntries = 'generate:entries',
@@ -216,36 +237,49 @@ export const enum NpmScript {
   Preinstall = 'preinstall',
   Prepublish = 'prepublish',
   Wip = 'wip',
+  UpgradeNode = './.stacks/scripts/setup.sh +nodejs.org',
+  UpgradePackageManager = './.stacks/scripts/setup.sh +pnpm.io',
 }
 
 export const enum Action {
   Bump = 'bump', // wip - changelog action
-  Release = 'release',
-  Prepublish = 'prepublish',
-  BuildStacks = 'build-stacks',
+  BuildStacks = 'build/stacks',
   BuildComponentLibs = 'build-component-libs',
   BuildVueComponentLib = 'build-vue-component-lib',
   BuildWebComponentLib = 'build-web-component-lib',
   BuildCli = 'build-cli',
-  BuildCore = 'build-core', // ✅
+  BuildCore = 'build/core', // wip
   BuildDocs = 'build-docs',
   BuildFunctionLib = 'build-function-lib',
   Changelog = 'changelog', // wip
-  Fresh = 'fresh', // ✅
-  GeneratePackageJsons = 'generate-package-jsons', // ✅
-  Lint = 'lint', // ✅
-  LintFix = 'lint-fix', // ✅
-  Test = 'test', // ✅
-  TestUi = 'test-ui', // ✅
-  TestUnit = 'test-unit', // ✅
-  TestFeature = 'test-feature', // wip
-  TestCoverage = 'test-coverage', // ✅
-  ShowFeatureTestReport = 'show-feature-test-report', // wip
-  Typecheck = 'typecheck', // wip
+  Clean = 'clean', // wip
+  DevComponents = 'dev/components', // wip
+  DevDocs = 'dev/docs', // wip
+  Deploy = 'deploy', // wip
+  Fresh = 'fresh', // wip
+  GeneratePackageJsons = 'generate-package-jsons', // wip
+  GenerateSettings = 'generate-settings',
+  GenerateOnboarding = 'generate-onboarding',
+  Inspire = 'inspire', // wip
   KeyGenerate = 'key-generate', // wip
   MakeNotification = 'make-notification', // wip
-  DevComponents = 'dev-components', // 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
+  Tinker = 'tinker',
+  Typecheck = 'typecheck', // wip
+  Upgrade = 'upgrade/index', // wip
+  UpgradeNode = 'upgrade/node', // wip
+  UpgradePackageManager = 'upgrade/package-manager', // wip
 }
 
 export type { CAC as CLI } from 'cac'
-export type { ExecaReturnValue as CommandResult } from 'execa'