@stacksjs/buddy 0.43.1 → 0.44.7

package/README.md

@@ -8,61 +8,76 @@
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 <!-- [![Codecov][codecov-src]][codecov-href] -->
 
-_For internal usage only until the beta is released by the end of ~November._
+_Pre-release until public beta released. Coming December._
 
-The goal of the Stacks framework is to _help you_ create & maintain frontends, backends, and clouds without having to worry about the boilerplate. Whether it's SSG pages, npm distributed & framework-agnostic component & function libraries, serverless APIs, Stacks helps you every step along the way, including production deployments and the maintenance of its related infrastructure (server or serverless).
+The goal of the framework is to _help you_ create & maintain frontends, backends, and clouds—without having to worry about the boilerplate. Stacks is a rapid application development framework, meeting all your full stack needs.
 
-Convention over configuration is our mantra—in beginner & expert-friendly ways.
+- Web & Desktop applications
+- Serverless & traditional APIs
+- Cloud infrastructure creation & maintenance
+- Interactive CLIs
+- Framework-agnostic component & function libraries
+- Deployment & Release Manager _(CI & CD)_
+
+Stacks helps you every step along the way—in beginner & expert-friendly ways, allowing you to focus on the _what_ and _why_ of your project.
+
+> “Convention over configuration” is the Stacks mantra. _- Chris_
 
 <!-- ![Atomic UI & FX Design](./apps/docs/images/diagram.png) -->
 
 ## Features
 
-The Stacks framework is a harmony of the following engines:
+The Stacks framework is a harmony of several “engines” to build any web and/or desktop application, in highly scalable & privacy-friendly ways. It consists of the following engines:
 
 ### Stacks UI
 
-_Develop UIs with helpers for atomic design, component libraries, and more._
+_Develop dynamic UIs with helpers for atomic design, and much more._
 
-- 🧩 Components _develop UI components with ease_
-- 📚 Library Mode _auto-builds Vue & Web component libraries_
-- 📊 Pages _SSG & PWA support using components_
-- 🖥️ Desktop _components as desktop elements, powered by Tauri_
+- 🧩 **Components** _a Stacks primitive to develop user interfaces_
+- 🤖 **Functions** _grant your UI superpowers_
+- 🌐 **Web** _"a routing & templating engine that makes sense" using components—SSG & PWA ready_
+- 🖥️ **Desktop** _components as desktop elements_
+- 📚 **Library** _auto-builds component & function libraries_
 - ⚡️ Powered by Vue, Vite, UnoCSS & Tauri
 
 ### Stacks Functions
 
 _Develop serverless (or server) functions with countless helpers to build scalable & fast APIs._
 
+- 🪄 **AI** _deep OpenAI integration_
 - 🤖 **APIs** _scalability & maintainability built-in_
-- 🏎️ **Cache** Redis, DynamoDB, SingleStore, and more
-- ⚙️ **CLIs** _create beautiful CLIs for Linux, Windows, and Mac. Without requirements._
+- 🏎️ **Cache** _Redis, DynamoDB, SingleStore, and more_
+- ⚙️ **CLIs** _create beautiful CLIs for Linux, Windows, and Mac—without requirements_
 - 📀 **Database** _MySQL, Postgres, PlanetScale, Supabase, Prisma, ..._
 - 👾 **Errors** _native type-safe error handling_
 - 📢 **Notifications** _emails, SMSs, direct, and push notifications & webhooks_
-- ⚙️ **Queues** run your heavy workload in the background
+- 💳 **Payments** _unified API for one-off & subscription billing methods for Stripe_
+- ⚙️ **Queues** _run your heavy workload in the background_
 - 🏎️ **Realtime** _"everything you need to build dynamic real-time apps"_
 - 🧭 **Router** _smart routing, file-based or Laravel-like_
 - 🔎 **Search Engine** _smart searching, advanced filtering & sorting, pagination, headless UI_
 - 💾 **Storage** _easily create & make use of local & remote storages/file systems_
-- 🌪️ **Validation** _e2e type-safety (frontend & backend harmony)_
-- 📈 **X-Ray** _All you need to debug, log & analyze, easily_
+- 🌪️ **Validation** _e2e type-safety (frontend knows what the backend knows)_
+- 📈 **X-Ray** _all you need to debug, log & analyze_
 
 ### Stacks Cloud
 
-Create your own Vercel-like cloud. _With a few commands._
+_Create your personal or professional Vercel-like cloud._
 
 - ☁️ **Server** _local development server & production-ready servers_
 - ⛅️ **Serverless** _on-demand, auto-scaling, zero maintenance_
-- 🚏 **CDN** _your own CloudFront CDN_
+- 🚏 **CDN** _zero-config low-latency CDN, including request life-cycle hooks_
+- 🤌🏼 **Brotli & gzip** _optimized request compressions to speed up page load times_
+- 📧 **Email** _secure & simplistic easy-peasy@custom-domains.com mail_
 - 🔐 **Firewall** _native web application firewall support_
 - 🏗️ **Maintenance** _handles your cloud infrastructure via the Stacks & Serverless framework_
+- 🤖 **Infrastructure as Code** _create & maintain your cloud infrastructure with ease_
 
 ### Stacks CI/CD
 
 _Focus on coding, not publishing._
 
-- 🚀 **Deployment Manager** _take the sweat & stress out of production deployments (AWS, Vercel, Netlify, and more)_
+- 🚀 **Deployment Manager** _take the sweat out of production deployments (AWS, Vercel, Netlify, and more)_
 - 📫 **Release Manager** _libraries (component & function) auto-published to npm, git helpers, and more_
 
 ### Stacks DX
@@ -73,10 +88,11 @@ _Enhanced productivity for developers. No more creating boilerplate._
 - 🪄 **Zero-Config** _yet highly configurable—convention over configuration_
 - 👩🏽‍🔧 **Linter & Formatter** _auto-configured & built into your IDE_
 - 💪🏼 **Type Strong** _built-in e2e type-safety_
-- ✨ **Git workflows** _committing with ease_
+- ✨ **Git Workflows** _committing with ease_
 - 🚗 **Auto Imports** _your components & functions, including date, string, array, & object helpers_
+- ⏩ **Code Snippets** _say goodbye to the boilerplate_
 - 🛠️ **Utilities** _Collections, VueUse, and more_
-- 🧪 **Testing** _unit & e2e tests powered by Vitest_
+- 🧪 **Testing** _unit & e2e tests powered by Vitest & Playwright_
 
 No matter whether you are a beginner or an expert, the approachable Stacks design allows you to learn at your own pace, using our thorough documentation covering every aspect of the framework. Stacks is extremely beginner & expert-friendly.
 
@@ -97,7 +113,7 @@ npx stacks new my-project
 ```
 
 > **Note**
-> pnpm 7.16 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
+> pnpm 7.18 or higher required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
 
 ## 🤖 Usage
 

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { CLI } from '@stacksjs/types';
+export * from '@stacksjs/types';
+export * from '@stacksjs/alias';
+export * from '@stacksjs/arrays';
+export * from '@stacksjs/build';
+export * from '@stacksjs/cli';
+export * from '@stacksjs/cloud';
+export * from '@stacksjs/collections';
+export * from '@stacksjs/config';
+export * from '@stacksjs/storage';
+export * from '@stacksjs/router';
+export * from '@stacksjs/server';
+export * from '@stacksjs/strings';
+export * from '@stacksjs/objects';
+export * from '@stacksjs/path';
+export * from '@stacksjs/ui';
+
+declare function build(stacks: CLI): Promise<void>;
+
+declare function clean(stacks: CLI): Promise<void>;
+
+declare function commit(stacks: CLI): Promise<void>;
+
+declare function create(stacks: CLI): Promise<void>;
+
+declare function dev(stacks: CLI): Promise<void>;
+
+declare function example(stacks: CLI): Promise<void>;
+
+declare function fresh(stacks: CLI): Promise<void>;
+
+declare function generate(stacks: CLI): Promise<void>;
+
+declare function lint(stacks: CLI): Promise<void>;
+
+declare function key(stacks: CLI): Promise<void>;
+
+declare function make(stacks: CLI): Promise<void>;
+
+declare function prepublish(stacks: CLI): Promise<void>;
+
+declare function preinstall(stacks: CLI): Promise<void>;
+
+declare function release(stacks: CLI): Promise<void>;
+
+declare function setup(stacks: CLI): Promise<void>;
+
+declare function test(stacks: CLI): Promise<void>;
+
+declare function types(stacks: CLI): Promise<void>;
+
+declare function update(stacks: CLI): Promise<void>;
+
+export { build, clean, commit, create, dev, example, fresh, generate, key, lint, make, preinstall, prepublish, release, setup, test, types, update };

package/dist/index.mjs

@@ -0,0 +1,644 @@
+import { ExitCode, Action } from '@stacksjs/types';
+export * from '@stacksjs/types';
+import { prompts, intro, log, green, bold, link, runCommand, cyan, italic, outro } from '@stacksjs/cli';
+export * from '@stacksjs/cli';
+import { invoke } from '@stacksjs/actions/build';
+import { invoke as invoke$1 } from '@stacksjs/actions/clean';
+import { invoke as invoke$2 } from '@stacksjs/actions/commit';
+import { useOnline } from '@stacksjs/utils';
+import { isFolder } from '@stacksjs/storage';
+export * from '@stacksjs/storage';
+import { resolve } from '@stacksjs/path';
+export * from '@stacksjs/path';
+import { generate as generate$1 } from '@stacksjs/actions/key';
+import { components, functions, pages, docs, invoke as invoke$3, desktop } from '@stacksjs/actions/dev';
+import { componentExample, webComponentExample, invoke as invoke$4 } from '@stacksjs/actions/examples';
+import { invoke as invoke$5 } from '@stacksjs/actions/fresh';
+import { invoke as invoke$6, types as types$2, libEntries, vueCompat, webTypes, vsCodeCustomData, ideHelpers, componentMeta } from '@stacksjs/actions/generate';
+import { invoke as invoke$7, lintFix } from '@stacksjs/actions/lint';
+import { invoke as invoke$8, component, database, migration, factory, page, fx, language, notification, stack } from '@stacksjs/actions/make';
+import { runAction } from '@stacksjs/actions';
+import { invoke as invoke$9 } from '@stacksjs/actions/preinstall';
+import { invoke as invoke$a, testUi, typecheck, testCoverageReport } from '@stacksjs/actions/test';
+import { invoke as invoke$b } from '@stacksjs/actions/update';
+export * from '@stacksjs/alias';
+export * from '@stacksjs/arrays';
+export * from '@stacksjs/build';
+export * from '@stacksjs/cloud';
+export * from '@stacksjs/collections';
+export * from '@stacksjs/config';
+export * from '@stacksjs/router';
+export * from '@stacksjs/server';
+export * from '@stacksjs/strings';
+export * from '@stacksjs/objects';
+export * from '@stacksjs/ui';
+
+const descriptions$g = {
+  components: "Build your component library",
+  vueComponents: "Build your Vue component library",
+  webComponents: "Build your framework agnostic web component library",
+  elements: "An alias to the -w flag",
+  functions: "Build your function library",
+  pages: "Build your SSG pages",
+  docs: "Build your documentation site",
+  stacks: "Build Stacks framework",
+  debug: "Enable debug mode"
+};
+async function build(stacks) {
+  stacks.command("build", "Automagically build any of your libraries/packages for production use. Select any of the following packages").option("-c, --components", descriptions$g.components).option("-v, --vue-components", descriptions$g.vueComponents).option("-w, --web-components", descriptions$g.webComponents).option("-e, --elements", descriptions$g.elements).option("-f, --functions", descriptions$g.functions).option("-p, --pages", descriptions$g.pages).option("-d, --docs", descriptions$g.docs).option("-s, --stacks", descriptions$g.stacks, { default: false }).option("--debug", descriptions$g.debug, { default: false }).action(async (options) => {
+    if (hasNoOptions$4(options)) {
+      const answers = await prompts.multiselect({
+        type: "multiselect",
+        name: "update",
+        message: "What are you trying to build?",
+        choices: [
+          { title: "Components", value: "components" },
+          { title: "Vue Components", value: "vue-components" },
+          { title: "Web Components", value: "web-components" },
+          { title: "Functions", value: "functions" },
+          { title: "Pages", value: "pages" },
+          { title: "Documentation", value: "docs" }
+        ]
+      });
+      options = answers.reduce((a, v) => ({ ...a, [v]: true }), {});
+    }
+    await invoke(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("build:components", "Automagically build component libraries for production use & npm/CDN distribution").option("-c, --components", descriptions$g.components, { default: true }).option("--debug", descriptions$g.debug, { default: false }).action(async (options) => {
+    await invoke(options);
+  });
+  stacks.command("build:functions", "Automagically build function library for npm/CDN distribution").option("-f, --functions", descriptions$g.functions, { default: true }).option("--debug", descriptions$g.debug, { default: false }).action(async (options) => {
+    await invoke(options);
+  });
+  stacks.command("build:vue-components", "Automagically build Vue component library for npm/CDN distribution").option("-v, --vue-components", descriptions$g.vueComponents, { default: true }).option("--debug", descriptions$g.debug, { default: false }).alias("build:vue").action(async (options) => {
+    await invoke(options);
+  });
+  stacks.command("build:web-components", "Automagically build Web Component library for npm/CDN distribution").option("-w, --web-components", descriptions$g.webComponents, { default: true }).option("--debug", descriptions$g.debug, { default: false }).alias("build:elements").alias("build:wc").action(async (options) => {
+    await invoke(options);
+  });
+  stacks.command("build:docs", "Automagically build your documentation site.").option("-d, --docs", descriptions$g.docs, { default: true }).option("--debug", descriptions$g.debug, { default: false }).action(async (options) => {
+    await invoke(options);
+  });
+  stacks.command("build:stacks", "Build the core Stacks framework.").option("-s, --stacks", descriptions$g.stacks, { default: true }).option("--debug", descriptions$g.debug, { default: false }).action(async (options) => {
+    await invoke(options);
+  });
+}
+function hasNoOptions$4(options) {
+  return !options.components && !options.vueComponents && !options.webComponents && !options.elements && !options.functions && !options.pages && !options.docs && !options.stacks;
+}
+
+const descriptions$f = {
+  clean: "Removes all node_modules & lock files",
+  debug: "Enable debug mode"
+};
+async function clean(stacks) {
+  stacks.command("clean", descriptions$f.clean).option("--debug", descriptions$f.debug, { default: false }).action(async (options) => {
+    await invoke$1(options);
+  });
+}
+
+const descriptions$e = {
+  commit: "Commit your stashed changes",
+  debug: "Enable debug mode"
+};
+async function commit(stacks) {
+  stacks.command("commit", descriptions$e.commit).option("--debug", descriptions$e.debug, { default: false }).action(async (options) => {
+    await invoke$2(options);
+  });
+}
+
+const descriptions$d = {
+  command: "Create a new Stacks project",
+  ui: "Are you building a UI?",
+  components: "Are you building UI components?",
+  webComponents: "Automagically built optimized custom elements/web components?",
+  vue: "Automagically built a Vue component library?",
+  pages: "How about pages?",
+  functions: "Are you developing functions/composables?",
+  api: "Are you building an API?",
+  database: "Do you need a database?",
+  debug: "Enable debug mode"
+};
+async function create(stacks) {
+  stacks.command("new <name>", descriptions$d.command).option("-u, --ui", descriptions$d.ui, { default: true }).option("-c, --components", descriptions$d.components, { default: true }).option("-w, --web-components", descriptions$d.webComponents, { default: true }).option("-v, --vue", descriptions$d.vue, { default: true }).option("-p, --pages", descriptions$d.pages, { default: true }).option("-f, --functions", descriptions$d.functions, { default: true }).option("-a, --api", descriptions$d.api, { default: true }).option("-d, --database", descriptions$d.database, { default: true }).option("--debug", descriptions$d.debug, { default: false }).action(async (options) => {
+    const startTime = intro("stacks new");
+    const name = options.name;
+    const path = resolve(process.cwd(), name);
+    await isFolderCheck(path);
+    await onlineCheck();
+    const result = await download(name, path, options);
+    if (result.isErr()) {
+      log.error(result.error);
+      process.exit(ExitCode.FatalError);
+    }
+    await ensureEnv(path, options);
+    await install(path, options);
+    console.log();
+    if (startTime) {
+      const time = performance.now() - startTime;
+      log.success(green(`Done in ${time}ms`));
+    }
+    log.info(bold("Welcome to the Stacks Framework! \u269B\uFE0F"));
+    console.log(`cd ${link(path, `vscode://file/${path}:1`)} && code .`);
+    console.log();
+    log.info("To learn more, visit https://stacksjs.dev");
+    process.exit(ExitCode.Success);
+  });
+}
+async function isFolderCheck(path) {
+  if (await isFolder(path)) {
+    log.error(`Path ${path} already exists`);
+    process.exit(ExitCode.FatalError);
+  }
+}
+async function onlineCheck() {
+  const online = useOnline();
+  if (!online) {
+    log.info("It appears you are disconnected from the internet.");
+    log.info("The Stacks setup requires a brief internet connection for setup.");
+    log.info("For instance, it installs your dependencies from.");
+    process.exit(ExitCode.FatalError);
+  }
+}
+async function download(name, path, options) {
+  log.info("Setting up your stack.");
+  const result = await runCommand(`giget stacks ${name}`, options);
+  log.success(`Successfully scaffolded your project at ${cyan(path)}`);
+  return result;
+}
+async function ensureEnv(path, options) {
+  log.info("Ensuring your environment is ready...");
+  await runCommand("fnm use", { ...options, cwd: path });
+  log.success("Environment is ready");
+}
+async function install(path, options) {
+  log.info("Installing & setting up Stacks");
+  const res1 = await runCommand("pnpm install", { ...options, cwd: path });
+  if (res1.isErr()) {
+    log.error(res1.error);
+    process.exit(ExitCode.FatalError);
+  }
+  const res2 = await runCommand("cp .env.example .env", { ...options, cwd: path });
+  if (res2.isErr()) {
+    log.error(res2.error);
+    process.exit(ExitCode.FatalError);
+  }
+  await generate$1(options);
+  const res3 = await runCommand("git init", { ...options, cwd: path });
+  if (res3.isErr()) {
+    log.error(res3.error);
+    process.exit(ExitCode.FatalError);
+  }
+  log.success("Installed & set-up \u{1F680}");
+}
+
+const descriptions$c = {
+  components: "Start the Components development server",
+  desktop: "Start the Desktop development server",
+  functions: "Start the Functions development server",
+  docs: "Start the Documentation development server",
+  pages: "Start the Pages development server",
+  debug: "Enable debug mode"
+};
+async function dev(stacks) {
+  stacks.command("dev", "Start the development server for any of the following").option("-c, --components", descriptions$c.components).option("-f, --functions", descriptions$c.functions).option("-d, --docs", descriptions$c.docs).option("-p, --pages", descriptions$c.pages).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    if (hasNoOptions$3(options)) {
+      const answer = await prompts.select({
+        type: "select",
+        name: "development",
+        message: "Which development server are you trying to start?",
+        choices: [
+          { title: "Components", value: "components" },
+          { title: "Functions", value: "functions" },
+          { title: "Pages", value: "pages" },
+          { title: "Docs", value: "docs" }
+        ]
+      });
+      if (answer !== null)
+        process.exit(ExitCode.InvalidArgument);
+      if (answer === "components")
+        await components(options);
+      else if (answer === "functions")
+        await functions(options);
+      else if (answer === "pages")
+        await pages(options);
+      else if (answer === "docs")
+        await docs(options);
+      else
+        process.exit(ExitCode.InvalidArgument);
+    }
+    await invoke$3(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("dev:components", descriptions$c.components).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    await invoke$3(options);
+  });
+  stacks.command("dev:docs", descriptions$c.docs).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    await docs(options);
+  });
+  stacks.command("dev:desktop", descriptions$c.desktop).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    await desktop(options);
+  });
+  stacks.command("dev:functions", descriptions$c.functions).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    await functions(options);
+  });
+  stacks.command("dev:pages", descriptions$c.pages).option("--debug", descriptions$c.debug, { default: false }).action(async (options) => {
+    await pages(options);
+  });
+}
+function hasNoOptions$3(options) {
+  return !options.components && !options.all && !options.docs && !options.functions && !options.pages;
+}
+
+const descriptions$b = {
+  example: "Which example do you want to see?",
+  components: "Test your libraries against your built bundle",
+  vue: "Test your Vue component library",
+  webComponents: "Test your web component library",
+  debug: "Enable debug mode"
+};
+async function example(stacks) {
+  stacks.command("example", descriptions$b.example).option("-c, --components", descriptions$b.components).option("-v, --vue", descriptions$b.vue).option("-w, --web-components", descriptions$b.webComponents).option("--debug", descriptions$b.debug, { default: false }).action(async (options) => {
+    const answer = await prompts.select({
+      type: "select",
+      name: "example",
+      message: "Which example are you trying to view?",
+      choices: [
+        { title: "Components", value: "components" },
+        { title: "Web Components", value: "web-components" }
+      ]
+    });
+    if (answer !== null) {
+      log.error(`You did not provide an answer. Please try again, ${italic("or report the issue")}`);
+      process.exit();
+    }
+    if (answer === "components")
+      await componentExample(options);
+    else if (answer === "web-components")
+      await webComponentExample(options);
+    else
+      process.exit(ExitCode.InvalidArgument);
+    await invoke$4(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("example:vue", descriptions$b.vue).option("-v, --vue", descriptions$b.debug, { default: true }).option("--debug", descriptions$b.debug, { default: false }).alias("example:components").action(async (options) => {
+    await invoke$4(options);
+  });
+  stacks.command("example:web-components", "Test your Web Component library.").option("-w, --web-components", descriptions$b.debug, { default: true }).option("--debug", descriptions$b.debug, { default: false }).action(async (options) => {
+    await invoke$4(options);
+  });
+}
+
+const descriptions$a = {
+  fresh: "Reinstalls your npm dependencies",
+  debug: "Enable debug mode"
+};
+async function fresh(stacks) {
+  stacks.command("fresh", descriptions$a.fresh).option("--debug", descriptions$a.debug, { default: false }).action(async (options) => {
+    await invoke$5(options);
+  });
+}
+
+const descriptions$9 = {
+  command: "Automagically build any of your libraries/packages for production use. Select any of the following packages",
+  types: "Generate your TypeScript types",
+  entries: "Generate your function & component library entry points",
+  webTypes: "Generate web-types.json for IDEs",
+  customData: "Generate VS Code custom data (custom-elements.json) for IDEs",
+  ideHelpers: "Generate IDE helpers",
+  vueCompat: "Generate Vue 2 & 3 compatibility",
+  componentMeta: "Generate component meta information",
+  debug: "Enable debug mode"
+};
+async function generate(stacks) {
+  stacks.command("generate", descriptions$9.command).option("-t, --types", descriptions$9.types).option("-e, --entries", descriptions$9.entries).option("-w, --web-types", descriptions$9.webTypes).option("-c, --custom-data", descriptions$9.customData).option("-i, --ide-helpers", descriptions$9.ideHelpers).option("-v, --vue-compatibility", descriptions$9.vueCompat).option("-c, --component-meta", descriptions$9.componentMeta).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    if (hasNoOptions$2(options)) {
+      const answers = await prompts.multiselect({
+        type: "multiselect",
+        name: "generate",
+        message: "What are you trying to generate?",
+        choices: [
+          { title: "1.) TypeScript Types", value: "types" },
+          { title: "2.) Library Entry Points", value: "entries" },
+          { title: "3.) Web Types", value: "web-types" },
+          { title: "4.) VS Code Custom Data", value: "custom-data" },
+          { title: "5.) IDE Helpers", value: "ide-helpers" },
+          { title: "6.) Vue 2 & 3 Compatibility", value: "vue-compatibility" },
+          { title: "7.) Component Meta", value: "component-meta" }
+        ]
+      });
+      options = answers.reduce((a, v) => ({ ...a, [v]: true }), {});
+    }
+    await invoke$6(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("generate:types", descriptions$9.types).option("--debug", descriptions$9.debug, { default: false }).alias("types:generate").action(async (options) => {
+    await types$2(options);
+  });
+  stacks.command("generate:entries", descriptions$9.entries).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await libEntries(options);
+  });
+  stacks.command("generate:vue-compatibility", descriptions$9.vueCompat).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await vueCompat(options);
+  });
+  stacks.command("generate:web-types", descriptions$9.webTypes).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await webTypes(options);
+  });
+  stacks.command("generate:vscode-custom-data", descriptions$9.customData).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await vsCodeCustomData(options);
+  });
+  stacks.command("generate:ide-helpers", descriptions$9.ideHelpers).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await ideHelpers(options);
+  });
+  stacks.command("generate:component-meta", descriptions$9.componentMeta).option("--debug", descriptions$9.debug, { default: false }).action(async (options) => {
+    await componentMeta(options);
+  });
+}
+function hasNoOptions$2(options) {
+  return !options.types && !options.entries && !options.webTypes && !options.customData && !options.ideHelpers && !options.vueCompatibility && !options.componentMeta;
+}
+
+const descriptions$8 = {
+  lint: "Automagically lints your codebase",
+  lintFix: "Automagically fixes lint errors",
+  debug: "Enable debug mode"
+};
+async function lint(stacks) {
+  stacks.command("lint", descriptions$8.lint).option("-f, --fix", descriptions$8.lintFix, { default: false }).option("--debug", descriptions$8.debug, { default: false }).action(async (options) => {
+    await invoke$7(options);
+  });
+  stacks.command("lint:fix", descriptions$8.lintFix).option("--debug", descriptions$8.debug, { default: false }).action(async (options) => {
+    await lintFix(options);
+  });
+}
+
+async function key(stacks) {
+  const descriptions = {
+    command: "Generate & set the application key.",
+    debug: "Enable debug mode"
+  };
+  stacks.command("key:generate", descriptions.command).option("--debug", descriptions.debug, { default: false }).action(async (options) => {
+    await generate$1(options);
+  });
+}
+
+const descriptions$7 = {
+  component: "Create a new component",
+  page: "Create a new page",
+  function: "Create a new function",
+  language: "Create a new language",
+  database: "Create a new database",
+  migration: "Create a new migration",
+  factory: "Create a new factory",
+  notification: "Create a new notification",
+  stack: "Create a new new stack",
+  debug: "Enable debug mode"
+};
+async function make(stacks) {
+  stacks.command("make", "The make command").option("-c, --component", descriptions$7.component, { default: false }).option("-p, --page", descriptions$7.page, { default: false }).option("-f, --function", descriptions$7.function, { default: false }).option("-l, --language", descriptions$7.language, { default: false }).option("-d, --database", descriptions$7.database, { default: false }).option("-m, --migration", descriptions$7.migration, { default: false }).option("-f, --factory", descriptions$7.factory, { default: false }).option("-n, --notification", descriptions$7.notification, { default: false }).option("-s, --stack", descriptions$7.stack, { default: false }).option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0];
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    if (hasNoOptions$1(options)) {
+      const answers = await prompts.multiselect({
+        type: "multiselect",
+        name: "make",
+        message: "What are you trying to make?",
+        choices: [
+          { title: "Component", value: "component" },
+          { title: "Function", value: "function" },
+          { title: "Page", value: "page" },
+          { title: "Language", value: "language" },
+          { title: "Notification", value: "notification" },
+          { title: "Database", value: "database" },
+          { title: "Migration", value: "migration" },
+          { title: "Factory", value: "factory" },
+          { title: "Stack", value: "stack" }
+        ]
+      });
+      options = answers.reduce((a, v) => ({ ...a, [v]: true }), {});
+    }
+    await invoke$8(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("make:component", descriptions$7.component).option("--n, -name", "The name of the component").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await component(options);
+  });
+  stacks.command("make:database", descriptions$7.database).option("--n, -name", "The name of the database").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await database(options);
+  });
+  stacks.command("make:migration", descriptions$7.migration).option("--n, -name", "The name of the migration").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await migration(options);
+  });
+  stacks.command("make:factory", descriptions$7.factory).option("--n, -name", "The name of the factory").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await factory(options);
+  });
+  stacks.command("make:page", descriptions$7.page).option("--n, -name", "The name of the page").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await page(options);
+  });
+  stacks.command("make:function", descriptions$7.function).option("--n, -name", "The name of the function").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    await fx(options);
+  });
+  stacks.command("make:lang", descriptions$7.language).option("--n, -name", "The name of the language").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await language(options);
+  });
+  stacks.command("make:notification", descriptions$7.notification).option("--n, -name", "The name of the notification").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await notification(options);
+  });
+  stacks.command("make:stack", descriptions$7.stack).option("--n, -name", "The name of the stack").option("--debug", descriptions$7.debug, { default: false }).action(async (options) => {
+    const name = stacks.args[0] || options.name;
+    options.name = name;
+    if (!name) {
+      log.error("You need to specify a name. Read more about the documentation here.");
+      process.exit();
+    }
+    await stack(options);
+  });
+}
+function hasNoOptions$1(options) {
+  return !options.component && !options.page && !options.function && !options.language && !options.database && !options.migration && !options.factory && !options.notification && !options.stack;
+}
+
+const descriptions$6 = {
+  command: "Run your prepublish script",
+  debug: "Enable debug mode"
+};
+async function prepublish(stacks) {
+  stacks.command("prepublish", descriptions$6.command).option("--debug", descriptions$6.debug, { default: false }).action(async (options) => {
+    await runAction(Action.Prepublish, options);
+  });
+}
+
+const descriptions$5 = {
+  command: "Run your preinstall script",
+  debug: "Enable debug mode"
+};
+async function preinstall(stacks) {
+  stacks.command("preinstall", descriptions$5.command).option("--debug", descriptions$5.debug, { default: false }).action(async (options) => {
+    await invoke$9(options);
+  });
+}
+
+const descriptions$4 = {
+  release: "Release a new version of your libraries/packages",
+  debug: "Enable debug mode"
+};
+async function release(stacks) {
+  stacks.command("release", descriptions$4.release).option("--debug", descriptions$4.debug, { default: true }).action(async (options) => {
+    const perf = intro("buddy release");
+    const result = await runAction(Action.Release, options);
+    if (result.isErr()) {
+      log.error("Failed to trigger the CI/CD release workflow.", result.error);
+      process.exit();
+    }
+    outro("Triggered CI/CD release workflow", { startTime: perf, useSeconds: true });
+  });
+}
+
+const descriptions$3 = {
+  ensure: "This command checks whether Node is installed. pnpm is checked via `only-allow` preinstall hook",
+  setup: "This command installs Node & pnpm",
+  debug: "Enable debug mode"
+};
+async function setup(stacks) {
+  stacks.command("ensure", descriptions$3.ensure).option("--debug", descriptions$3.debug, { default: false }).action(async (options) => {
+    await runCommand("pnpm install", options);
+  });
+  stacks.command("setup", descriptions$3.setup).option("--debug", descriptions$3.debug, { default: false }).action(async (options) => {
+    await runCommand("pnpm env use", options);
+  });
+}
+
+const descriptions$2 = {
+  command: "Runs your test suite",
+  types: "Typechecks your codebase",
+  coverage: "Generates a test coverage report",
+  debug: "Enable debug mode"
+};
+async function test(stacks) {
+  stacks.command("test", descriptions$2.command).option("--debug", descriptions$2.debug, { default: false }).action(async (options) => {
+    await invoke$a(options);
+  });
+  stacks.command("test:ui", descriptions$2.command).option("--debug", descriptions$2.debug, { default: false }).action(async (options) => {
+    await testUi(options);
+  });
+  stacks.command("test:types", descriptions$2.types).option("--debug", descriptions$2.debug, { default: false }).action(async (options) => {
+    await typecheck(options);
+  });
+  stacks.command("test:coverage", descriptions$2.coverage).option("--debug", descriptions$2.debug, { default: false }).action(async (options) => {
+    await testCoverageReport(options);
+  });
+}
+
+const descriptions$1 = {
+  generate: "Generate the types of & for your library/libraries",
+  fix: "wip",
+  debug: "Enable debug mode"
+};
+async function types(stacks) {
+  stacks.command("types:generate", descriptions$1.generate).option("--debug", descriptions$1.debug, { default: false }).action(async () => {
+    await types$2();
+  });
+  stacks.command("types:fix", descriptions$1.fix).option("--debug", descriptions$1.debug, { default: false }).action(async () => {
+  });
+}
+
+const descriptions = {
+  command: "Update dependencies, framework, package manager, and/or Node",
+  framework: "Update the Stacks framework",
+  dependencies: "Update your dependencies",
+  packageManager: "Update your package manager, i.e. pnpm",
+  node: "Update Node to the version defined in ./node-version",
+  all: "Update Node, package manager, project dependencies, and framework",
+  force: "Overwrite possible local updates with remote framework updates",
+  debug: "Enable debug mode",
+  select: "What are you trying to update?"
+};
+async function update(stacks) {
+  stacks.command("update", descriptions.command).option("-c, --framework", descriptions.framework, { default: false }).option("-d, --dependencies", descriptions.dependencies, { default: false }).option("-p, --package-manager", descriptions.packageManager, { default: false }).option("-n, --node", descriptions.node, { default: false }).option("-a, --all", descriptions.all, { default: false }).option("-f, --force", descriptions.force, { default: false }).option("--debug", descriptions.debug, { default: false }).example("buddy update -a --debug").action(async (options) => {
+    if (hasNoOptions(options)) {
+      const answers = await prompts.multiselect({
+        type: "multiselect",
+        name: "update",
+        message: descriptions.select,
+        choices: [
+          { title: "Dependencies", value: "dependencies" },
+          { title: "Framework", value: "framework" },
+          { title: "Node", value: "node" },
+          { title: "pnpm", value: "package-manager" }
+        ]
+      });
+      options = answers.reduce((a, v) => ({ ...a, [v]: true }), {});
+    }
+    await invoke$b(options);
+  });
+  stacks.command("update:framework", descriptions.framework).option("-f, --framework", descriptions.framework, { default: true }).option("--debug", descriptions.debug, { default: false }).example("buddy update:framework --debug").action(async (options) => {
+    await invoke$b(options);
+  });
+  stacks.command("update:dependencies", descriptions.dependencies).option("-d, --dependencies", descriptions.dependencies, { default: true }).option("--debug", descriptions.debug, { default: false }).alias("update:deps").example("buddy update:dependencies --debug").action(async (options) => {
+    await invoke$b(options);
+  });
+  stacks.command("update:package-manager", descriptions.packageManager).option("-p, --package-manager", descriptions.packageManager, { default: true }).option("--debug", descriptions.debug, { default: false }).alias("update:pm").example("buddy update:package-manager 7.16.1 --debug").example("buddy update:package-manager latest").action(async (options) => {
+    options.version = "latest";
+    if (stacks.args[0])
+      options.version = stacks.args[0];
+    await invoke$b(options);
+    process.exit(ExitCode.Success);
+  });
+  stacks.command("update:node", descriptions.node).option("-n, --node", descriptions.node, { default: true }).option("--debug", descriptions.debug, { default: false }).action(async (options) => {
+    await invoke$b(options);
+  });
+  stacks.command("update:all", descriptions.all).option("-a, --all", descriptions.all, { default: true }).option("--debug", descriptions.debug, { default: false }).action(async (options) => {
+    await invoke$b(options);
+  });
+}
+function hasNoOptions(options) {
+  return !options.framework && !options.dependencies && !options.packageManager && !options.node && !options.all;
+}
+
+export { build, clean, commit, create, dev, example, fresh, generate, key, lint, make, preinstall, prepublish, release, setup, test, types, update };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@stacksjs/buddy",
   "type": "module",
-  "version": "0.43.1",
-  "packageManager": "pnpm@7.17.1",
-  "description": "The Stacks runtime, named Buddy.",
+  "version": "0.44.7",
+  "packageManager": "pnpm@7.18.2",
+  "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
@@ -51,39 +51,41 @@
   ],
   "engines": {
     "node": ">=v18.12.1",
-    "pnpm": ">=7.17.1"
+    "pnpm": ">=7.18.2"
   },
   "peerDependencies": {
-    "@stacksjs/actions": "0.43.1",
-    "@stacksjs/arrays": "0.43.1",
-    "@stacksjs/build": "0.43.1",
-    "@stacksjs/cli": "0.43.1",
-    "@stacksjs/cloud": "0.43.1",
-    "@stacksjs/collections": "0.43.1",
-    "@stacksjs/config": "0.43.1",
-    "@stacksjs/desktop": "0.43.1",
-    "@stacksjs/docs": "0.43.1",
-    "@stacksjs/error-handling": "0.43.1",
-    "@stacksjs/git": "0.43.1",
-    "@stacksjs/lint": "0.43.1",
-    "@stacksjs/modules": "0.43.1",
-    "@stacksjs/objects": "0.43.1",
-    "@stacksjs/path": "0.43.1",
-    "@stacksjs/router": "0.43.1",
-    "@stacksjs/security": "0.43.1",
-    "@stacksjs/server": "0.43.1",
-    "@stacksjs/storage": "0.43.1",
-    "@stacksjs/strings": "0.43.1",
-    "@stacksjs/testing": "0.43.1",
-    "@stacksjs/types": "0.43.1",
-    "@stacksjs/ui": "0.43.1",
-    "@stacksjs/utils": "0.43.1",
-    "@stacksjs/x-ray": "0.43.1"
+    "@stacksjs/actions": "0.44.7",
+    "@stacksjs/alias": "0.44.7",
+    "@stacksjs/arrays": "0.44.7",
+    "@stacksjs/build": "0.44.7",
+    "@stacksjs/cli": "0.44.7",
+    "@stacksjs/cloud": "0.44.7",
+    "@stacksjs/collections": "0.44.7",
+    "@stacksjs/config": "0.44.7",
+    "@stacksjs/docs": "0.44.7",
+    "@stacksjs/domains": "0.44.7",
+    "@stacksjs/error-handling": "0.44.7",
+    "@stacksjs/git": "0.44.7",
+    "@stacksjs/lint": "0.44.7",
+    "@stacksjs/logging": "0.44.7",
+    "@stacksjs/modules": "0.44.7",
+    "@stacksjs/objects": "0.44.7",
+    "@stacksjs/path": "0.44.7",
+    "@stacksjs/router": "0.44.7",
+    "@stacksjs/security": "0.44.7",
+    "@stacksjs/server": "0.44.7",
+    "@stacksjs/storage": "0.44.7",
+    "@stacksjs/strings": "0.44.7",
+    "@stacksjs/testing": "0.44.7",
+    "@stacksjs/types": "0.44.7",
+    "@stacksjs/ui": "0.44.7",
+    "@stacksjs/utils": "0.44.7"
   },
   "devDependencies": {
     "only-allow": "^1.1.1",
-    "pnpm": ">=7.17.1",
-    "typescript": "^4.9.3"
+    "pnpm": ">=7.18.2",
+    "typescript": "^4.9.4",
+    "unbuild": "^1.0.2"
   },
   "config": {
     "commitizen": {
@@ -96,6 +98,7 @@
     "stacks": "pnpm run buddy",
     "stx": "pnpm run buddy",
     "preinstall": "npx only-allow pnpm",
+    "prepublish": "pnpm buddy prepublish",
     "fresh": "pnpm buddy fresh",
     "clean": "pnpm buddy clean",
     "update": "pnpm buddy update",
@@ -106,7 +109,7 @@
     "update:all": "pnpm buddy update:all",
     "dev": "pnpm buddy dev",
     "dev:components": "npx vite serve ./components/vue -c ./core/build/src/vue-components.ts",
-    "dev:core": "pnpm --filter '../**' --filter '!../buddy/' dev",
+    "dev:core": "pnpm --filter '../core/**' --filter '!../buddy/' dev",
     "dev:desktop": "wip",
     "dev:docs": "vitepress dev ../apps/docs",
     "dev:pages": "nitro dev",
@@ -120,7 +123,7 @@
     "build:functions": "npx vite build -c ./core/build/src/functions.ts",
     "build:docs": "npx vitepress build ../apps/docs",
     "build:pages": "npx vite-ssg build ./pages -c ./core/build/src/pages.ts",
-    "build:core": "pnpm --filter './core/**' --filter='!./core/config' build && pnpm --filter './core/config' build",
+    "build:core": "pnpm --filter '../core/**' --filter='!../core/config' build && pnpm --filter '../core/config' build",
     "build:cli": "npx unbuild",
     "build:runtime": "pnpm run build:cli",
     "build:desktop": "wip",
@@ -159,7 +162,7 @@
     "key": "pnpm buddy key",
     "key:generate": "pnpm buddy key:generate",
     "commit": "git cz",
-    "release": "esno ./core/actions/src/generate-package-json.ts && pnpm lint:fix && bumpp ../package.json ./package.json ./core/**/package.json ../package.json --execute 'pnpm run changelog' --all",
+    "release": "pnpm buddy release",
     "changelog": "cd .. && conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
     "generate": "pnpm buddy generate",
     "generate:entries": "pnpm buddy generate:entries",