stacks 0.40.0 → 0.44.9

package/buddy/package.json

@@ -0,0 +1,183 @@
+{
+  "name": "@stacksjs/buddy",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "description": "Meet Buddy. The Stacks runtime.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/buddy"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "vite",
+    "component",
+    "composables",
+    "functions",
+    "headless",
+    "api",
+    "ssg",
+    "pwa",
+    "modern",
+    "library",
+    "vue",
+    "web components",
+    "typescript",
+    "javascript",
+    "starter kit"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "bin": {
+    "stacks": "bin/stacks.mjs",
+    "stx": "bin/stacks.mjs",
+    "buddy": "bin/stacks.mjs",
+    "bud": "bin/stacks.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.18.2"
+  },
+  "scripts": {
+    "buddy": "esno ./src/cli.ts",
+    "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",
+    "update:dependencies": "pnpm buddy update:dependencies",
+    "update:framework": "pnpm buddy update:framework",
+    "update:package-manager": "pnpm buddy update:package-manager",
+    "update:node": "pnpm buddy update:node",
+    "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 '../core/**' --filter '!../buddy/' dev",
+    "dev:desktop": "wip",
+    "dev:docs": "vitepress dev ../apps/docs",
+    "dev:pages": "nitro dev",
+    "dev:functions": "pnpm buddy dev:functions",
+    "development": "pnpm run dev",
+    "build": "pnpm buddy build",
+    "build:bin": "pkg .",
+    "build:components": "pnpm buddy build:components",
+    "build:vue-components": "npx vite build -c ./core/build/src/vue-components.ts",
+    "build:web-components": "npx vite build -c ./core/build/src/web-components.ts",
+    "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:cli": "npx unbuild",
+    "build:runtime": "pnpm run build:cli",
+    "build:desktop": "wip",
+    "build:stacks": "npx mkdist -d && pnpm build:cli && pnpm build:core",
+    "build:all": "wip",
+    "prod": "pnpm run build",
+    "prod:components": "pnpm run build:components",
+    "prod:vue": "pnpm run prod:vue",
+    "prod:web-components": "pnpm run build:web-components",
+    "prod:functions": "pnpm run build:functions",
+    "prod:docs": "pnpm run build:docs",
+    "prod:pages": "pnpm run build:pages",
+    "prod:stacks": "pnpm run build:stacks",
+    "prod:all": "pnpm run build:all",
+    "deploy": "pnpm buddy deploy",
+    "deploy:functions": "pnpm buddy deploy:functions",
+    "deploy:pages": "pnpm buddy deploy:functions",
+    "deploy:docs": "pnpm buddy deploy:docs",
+    "deploy:all": "pnpm buddy deploy:all",
+    "example": "wip",
+    "example:vue": "pnpm run build:components && cd examples/vue && ln -sf ../../components/vue/dist dist && npx vite serve -c ../../core/build/example-vue.ts",
+    "example:web-components": "pnpm run build:web-components && cd examples/web && ln -sf ../../components/web/dist dist && npx vite serve -c ../../core/build/example-wc.ts",
+    "lint": "eslint ..",
+    "lint:fix": "eslint .. --fix",
+    "serve": "pnpm buddy serve",
+    "serve:pages": "pnpm run dev:pages",
+    "serve:functions": "pnpm run dev:functions",
+    "make": "pnpm buddy make",
+    "make:component": "pnpm buddy make:component",
+    "make:function": "pnpm buddy make:function",
+    "make:database": "pnpm buddy make:migration",
+    "make:migration": "pnpm buddy make:migration",
+    "make:factory": "pnpm buddy make:factory",
+    "make:lang": "pnpm buddy make:lang",
+    "make:stack": "pnpm buddy make:stack",
+    "key": "pnpm buddy key",
+    "key:generate": "pnpm buddy key:generate",
+    "commit": "git cz",
+    "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",
+    "generate:vue-compat": "esno ./core/actions/src/generate-vue-compat.ts",
+    "generate:vscode-custom-data": "esno ./core/actions/src/generate-vscode-custom-data.ts",
+    "generate:web-types": "vue-docgen-web-types -c ./core/build/web-types.config.cjs",
+    "generate:component-meta": "esno ./core/actions/src/component-meta.ts",
+    "generate:ide-helpers": "esno ./core/actions/src/generate-ide-helpers.ts",
+    "generate:all": "pnpm buddy generate:all",
+    "types:generate": "vue-tsc --declaration --emitDeclarationOnly && esno ./core/actions/src/copy-types.ts",
+    "types:fix": "esno actions/src/fix-types.ts",
+    "add": "pnpm buddy add",
+    "test": "vitest --config vitest.config.ts",
+    "test:ui": "pnpm buddy test:ui",
+    "test:coverage": "pnpm buddy test:coverage",
+    "test:types": "pnpm buddy test:types"
+  },
+  "peerDependencies": {
+    "@stacksjs/actions": "workspace:*",
+    "@stacksjs/alias": "workspace:*",
+    "@stacksjs/arrays": "workspace:*",
+    "@stacksjs/build": "workspace:*",
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/cloud": "workspace:*",
+    "@stacksjs/collections": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/docs": "workspace:*",
+    "@stacksjs/domains": "workspace:*",
+    "@stacksjs/error-handling": "workspace:*",
+    "@stacksjs/git": "workspace:*",
+    "@stacksjs/lint": "workspace:*",
+    "@stacksjs/logging": "workspace:*",
+    "@stacksjs/modules": "workspace:*",
+    "@stacksjs/objects": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/router": "workspace:*",
+    "@stacksjs/security": "workspace:*",
+    "@stacksjs/server": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/strings": "workspace:*",
+    "@stacksjs/testing": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@stacksjs/ui": "workspace:*",
+    "@stacksjs/utils": "workspace:*"
+  },
+  "devDependencies": {
+    "only-allow": "^1.1.1",
+    "pnpm": ">=7.18.2",
+    "typescript": "^4.9.4",
+    "unbuild": "^1.0.2"
+  },
+  "config": {
+    "commitizen": {
+      "path": "node_modules/cz-git"
+    }
+  },
+  "web-types": "./web-types.json"
+}

package/buddy/src/cli.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { command, log } from '@stacksjs/cli'
+import { isProjectCreated } from '@stacksjs/utils'
+import { version } from '../package.json' assert { type: 'json' }
+import { build, clean, commit, create, dev, example, fresh, generate, key, lint, make, preinstall, prepublish, release, setup, test, update } from './commands'
+
+const cli = command('stacks')
+
+// setup global error handlers
+process.on('uncaughtException', errorHandler)
+process.on('unhandledRejection', errorHandler)
+
+async function main() {
+  // before running any commands, check if the project is already initialized
+  await setup(cli)
+  await key(cli)
+
+  if (!await isProjectCreated()) {
+    await create(cli)
+  }
+  else {
+    await preinstall(cli)
+    await prepublish(cli)
+    await update(cli)
+    await generate(cli)
+    await dev(cli)
+    await build(cli)
+    await clean(cli)
+    await commit(cli)
+    await fresh(cli)
+    await lint(cli)
+    await release(cli)
+    await make(cli)
+    await example(cli)
+    await test(cli)
+  }
+
+  cli.help()
+  cli.version(version)
+
+  cli.parse()
+}
+
+main()
+
+function errorHandler(error: Error): void {
+  log.error(error)
+  process.exit()
+}

package/buddy/src/commands/add.ts

@@ -0,0 +1,63 @@
+import type { AddOptions, BuildOptions, CLI } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { prompts } from '@stacksjs/cli'
+import { invoke } from '@stacksjs/actions/add'
+
+const descriptions = {
+  add: 'Add a stack to your project (coming soon)',
+  table: 'Add the Table Stack to your project',
+  calendar: 'Add the Calendar Stack to your project',
+  all: 'Add all stacks',
+  debug: 'Enable debug mode',
+}
+
+async function add(stacks: CLI) {
+  stacks
+    .command('add', descriptions.add)
+    .option('-t, --table', descriptions.table, { default: false })
+    .option('-c, --calendar', descriptions.calendar, { default: false })
+    .option('-a, --all', descriptions.all, { default: false })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      if (hasNoOptions(options)) {
+        const answers = await prompts.multiselect({
+          type: 'multiselect',
+          name: 'add',
+          message: 'Which stack/s are you trying to add?',
+          choices: [
+            { title: 'Calendar', value: 'calendar' },
+            { title: 'Table', value: 'table' },
+          ],
+        })
+
+        // creates an object out of array and sets answers to true
+        options = answers.reduce((a: any, v: any) => ({ ...a, [v]: true }), {})
+      }
+
+      await invoke(options)
+
+      process.exit(ExitCode.Success)
+    })
+
+  stacks
+    .command('add:table', descriptions.table)
+    .option('-t, --table', descriptions.table, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('add:calendar', descriptions.calendar)
+    .option('-t, --calendar', descriptions.calendar, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+}
+
+function hasNoOptions(options: AddOptions) {
+  return !options.all && !options.table && !options.calendar
+}
+
+export { add }

package/buddy/src/commands/build.ts

@@ -0,0 +1,111 @@
+import type { BuildOptions, CLI } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { prompts } from '@stacksjs/cli'
+import { invoke } from '@stacksjs/actions/build'
+
+const descriptions = {
+  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: CLI) {
+  stacks
+    .command('build', 'Automagically build any of your libraries/packages for production use. Select any of the following packages')
+    .option('-c, --components', descriptions.components)
+    .option('-v, --vue-components', descriptions.vueComponents) // these are automatically built with your -c option as well
+    .option('-w, --web-components', descriptions.webComponents) // these are automatically built with your -c option as well
+    .option('-e, --elements', descriptions.elements)
+    .option('-f, --functions', descriptions.functions)
+    .option('-p, --pages', descriptions.pages)
+    .option('-d, --docs', descriptions.docs)
+    .option('-s, --stacks', descriptions.stacks, { default: false })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      if (hasNoOptions(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' },
+          ],
+        })
+
+        // creates an object out of array and sets answers to true
+        options = answers.reduce((a: any, v: any) => ({ ...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.components, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('build:functions', 'Automagically build function library for npm/CDN distribution')
+    .option('-f, --functions', descriptions.functions, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('build:vue-components', 'Automagically build Vue component library for npm/CDN distribution')
+    .option('-v, --vue-components', descriptions.vueComponents, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .alias('build:vue')
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('build:web-components', 'Automagically build Web Component library for npm/CDN distribution')
+    .option('-w, --web-components', descriptions.webComponents, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .alias('build:elements')
+    .alias('build:wc')
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('build:docs', 'Automagically build your documentation site.')
+    .option('-d, --docs', descriptions.docs, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+
+  stacks
+    .command('build:stacks', 'Build the core Stacks framework.')
+    .option('-s, --stacks', descriptions.stacks, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: BuildOptions) => {
+      await invoke(options)
+    })
+}
+
+function hasNoOptions(options: BuildOptions) {
+  return !options.components && !options.vueComponents && !options.webComponents && !options.elements && !options.functions && !options.pages && !options.docs && !options.stacks
+}
+
+export { build }

package/buddy/src/commands/clean.ts

@@ -0,0 +1,18 @@
+import type { CLI, CleanOptions } from '@stacksjs/types'
+import { invoke } from '@stacksjs/actions/clean'
+
+const descriptions = {
+  clean: 'Removes all node_modules & lock files',
+  debug: 'Enable debug mode',
+}
+
+async function clean(stacks: CLI) {
+  stacks
+    .command('clean', descriptions.clean)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: CleanOptions) => {
+      await invoke(options)
+    })
+}
+
+export { clean }

package/buddy/src/commands/commit.ts

@@ -0,0 +1,18 @@
+import type { CLI, FreshOptions } from '@stacksjs/types'
+import { invoke } from '@stacksjs/actions/commit'
+
+const descriptions = {
+  commit: 'Commit your stashed changes',
+  debug: 'Enable debug mode',
+}
+
+async function commit(stacks: CLI) {
+  stacks
+    .command('commit', descriptions.commit)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: FreshOptions) => {
+      await invoke(options)
+    })
+}
+
+export { commit }

package/buddy/src/commands/create.ts

@@ -0,0 +1,129 @@
+import type { CLI, CreateOptions } from '@stacksjs/types'
+import { bold, cyan, green, intro, link, log, runCommand } from '@stacksjs/cli'
+import { useOnline } from '@stacksjs/utils'
+import { isFolder } from '@stacksjs/storage'
+import { resolve } from '@stacksjs/path'
+import { ExitCode } from '@stacksjs/types'
+import { generate as generateAppKey } from '@stacksjs/actions/key'
+
+const descriptions = {
+  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: CLI) {
+  stacks
+    .command('new <name>', descriptions.command)
+    .option('-u, --ui', descriptions.ui, { default: true }) // if no, disregard remainder of questions wrt UI
+    .option('-c, --components', descriptions.components, { default: true }) // if no, -v and -w would be false
+    .option('-w, --web-components', descriptions.webComponents, { default: true })
+    .option('-v, --vue', descriptions.vue, { default: true })
+    .option('-p, --pages', descriptions.pages, { default: true }) // pages need an HTTP server
+    .option('-f, --functions', descriptions.functions, { default: true }) // if no, API would be false
+    .option('-a, --api', descriptions.api, { default: true }) // APIs need an HTTP server & assumes functions is true
+    .option('-d, --database', descriptions.database, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    // .option('--auth', 'Scaffold an authentication?', { default: true })
+    .action(async (options: CreateOptions) => {
+      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)
+
+      // a custom outro
+      console.log()
+
+      if (startTime) {
+        const time = performance.now() - startTime
+        log.success(green(`Done in ${time}ms`))
+      }
+
+      log.info(bold('Welcome to the Stacks Framework! ⚛️'))
+      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: string) {
+  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: string, path: string, options: CreateOptions) {
+  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: string, options: CreateOptions) {
+  log.info('Ensuring your environment is ready...')
+  // todo: this should check for whether the proper Node version is installed because fnm is not a requirement
+  await runCommand('fnm use', { ...options, cwd: path })
+  log.success('Environment is ready')
+}
+
+async function install(path: string, options: CreateOptions) {
+  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 generateAppKey(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 🚀')
+}
+
+export { create }

package/buddy/src/commands/dev.ts

@@ -0,0 +1,96 @@
+import { ExitCode } from '@stacksjs/types'
+import type { CLI, DevOption, DevOptions } from '@stacksjs/types'
+import { prompts } from '@stacksjs/cli'
+import { components, desktop, docs, functions, pages, invoke as startDevelopmentServer } from '@stacksjs/actions/dev'
+
+const descriptions = {
+  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: CLI) {
+  stacks
+    .command('dev', 'Start the development server for any of the following')
+    .option('-c, --components', descriptions.components)
+    .option('-f, --functions', descriptions.functions)
+    .option('-d, --docs', descriptions.docs)
+    .option('-p, --pages', descriptions.pages)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      if (hasNoOptions(options)) {
+        const answer: DevOption | void = 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 startDevelopmentServer(options)
+      process.exit(ExitCode.Success)
+    })
+
+  stacks
+    .command('dev:components', descriptions.components)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      await startDevelopmentServer(options)
+    })
+
+  stacks
+    .command('dev:docs', descriptions.docs)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      await docs(options)
+    })
+
+  stacks
+    .command('dev:desktop', descriptions.desktop)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      await desktop(options)
+    })
+
+  stacks
+    .command('dev:functions', descriptions.functions)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      await functions(options)
+    })
+
+  stacks
+    .command('dev:pages', descriptions.pages)
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: DevOptions) => {
+      await pages(options)
+    })
+}
+
+function hasNoOptions(options: DevOptions) {
+  return !options.components && !options.all && !options.docs && !options.functions && !options.pages
+}
+
+export { dev }