stacks 0.40.0 → 0.44.9

package/buddy/src/commands/update.ts

@@ -0,0 +1,108 @@
+import type { CLI, UpdateOptions } from '@stacksjs/types'
+import { ExitCode } from '@stacksjs/types'
+import { prompts } from '@stacksjs/cli'
+import { invoke as updateStacks } from '@stacksjs/actions/update'
+
+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: CLI) {
+  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: UpdateOptions) => {
+      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' },
+          ],
+        })
+
+        // creates an object out of array and sets answers to true
+        options = answers.reduce((a: any, v: any) => ({ ...a, [v]: true }), {})
+      }
+
+      await updateStacks(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: UpdateOptions) => {
+      await updateStacks(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: UpdateOptions) => {
+      await updateStacks(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: UpdateOptions) => {
+      options.version = 'latest'
+
+      if (stacks.args[0])
+        options.version = stacks.args[0]
+
+      await updateStacks(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: UpdateOptions) => {
+      await updateStacks(options)
+    })
+
+  stacks
+    .command('update:all', descriptions.all)
+    .option('-a, --all', descriptions.all, { default: true })
+    .option('--debug', descriptions.debug, { default: false })
+    .action(async (options: UpdateOptions) => {
+      await updateStacks(options)
+    })
+}
+
+function hasNoOptions(options: UpdateOptions) {
+  return !options.framework && !options.dependencies && !options.packageManager && !options.node && !options.all
+}
+
+export { update }

package/buddy/src/index.ts

@@ -0,0 +1,17 @@
+export * from './commands'
+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/desktop'
+export * from '@stacksjs/storage'
+export * from '@stacksjs/router'
+export * from '@stacksjs/server'
+export * from '@stacksjs/strings'
+export * from '@stacksjs/types'
+export * from '@stacksjs/objects'
+export * from '@stacksjs/path'
+export * from '@stacksjs/ui'

package/components/vue/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href=".github/art/logo.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Stacks Playground</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./main.ts"></script>
+  </body>
+</html>

package/components/vue/main.ts

@@ -0,0 +1,18 @@
+import { createApp } from 'vue'
+// import Previewer from 'virtual:vue-component-preview'
+import Demo from '../../components/Demo.vue'
+
+// prepare the messages object from the yaml language files
+// const messages = Object.fromEntries(
+//   Object.entries(
+//     import.meta.glob<{ default: any }>('../../../lang/*.y(a)?ml', { eager: true }))
+//     .map(([key, value]) => {
+//       const yaml = key.endsWith('.yaml')
+//       return [key.slice(14, yaml ? -5 : -4), value.default]
+//     }),
+// )
+
+const app = createApp(Demo)
+
+// app.use(Previewer)
+app.mount('#app')

package/components/vue/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "hello-world-vue",
+  "type": "module",
+  "version": "",
+  "packageManager": "pnpm@7.18.2",
+  "description": "Your Vue component library description",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/components#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "components"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": ["component", "library", "vue", "vite", "typescript", "javascript"],
+  "contributors": ["Chris Breuer <chris@ow3.org>"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build -c ../build/vue-components.ts",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "stacks": "workspace:*"
+  }
+}

package/components/web/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "hello-world-elements",
+  "type": "module",
+  "version": "",
+  "packageManager": "pnpm@7.18.2",
+  "description": "Your framework agnostic web component library description.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/components#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "components"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": ["custom-elements", "web-components", "library", "framework-agnostic", "typescript", "javascript"],
+  "contributors": ["Chris Breuer <chris@ow3.org>"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build -c ../build/web-components.ts",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "stacks": "workspace:*"
+  }
+}

package/components.d.ts

@@ -0,0 +1,22 @@
+// generated by unplugin-vue-components
+// We suggest you to commit this file into source control
+// Read more: https://github.com/vuejs/core/pull/3399
+import '@vue/runtime-core'
+
+export {}
+
+declare module '@vue/runtime-core' {
+  export interface GlobalComponents {
+    404: typeof import('./../pages/layouts/404.vue')['default']
+    Counter: typeof import('./../components/Buttons/Counter.vue')['default']
+    Default: typeof import('./../pages/layouts/default.vue')['default']
+    Demo: typeof import('./../components/Demo.vue')['default']
+    HelloWorld: typeof import('./../components/HelloWorld.vue')['default']
+    Home: typeof import('./../pages/layouts/home.vue')['default']
+    Logo: typeof import('./../components/Logo.vue')['default']
+    README: typeof import('./../components/README.md')['default']
+    RouterLink: typeof import('vue-router')['RouterLink']
+    RouterView: typeof import('vue-router')['RouterView']
+    ToggleDark: typeof import('./../components/Buttons/ToggleDark.vue')['default']
+  }
+}

package/core/actions/README.md

@@ -0,0 +1,58 @@
+# Stacks Actions
+
+This package contains the Stacks Actions.
+
+## ☘️ Features
+
+- Generate Component Meta information
+- Generate IDE Helper files
+- Generate Stacks Library Entry Points
+- Generate Package Manifests
+- Generate VS Code Custom Data file
+- Generate Vue 2 Compatibility (maybe deprecate)
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/actions
+```
+
+Now, you can use it in your project:
+
+```ts
+import actions from '@stacksjs/actions'
+
+// wip
+```
+
+Learn more in the docs.
+
+## 🧪 Testing
+
+```bash
+pnpm test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
+
+## 🏝 Community
+
+For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+
+[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)
+
+For casual chit-chat with others using this package:
+
+[Join the Stacks Discord Server](https://discord.ow3.org)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.
+
+Made with ❤️

package/core/actions/node_modules/.bin/esno

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

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

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

package/core/actions/node_modules/.bin/mkdist

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

package/core/actions/node_modules/.bin/tsc

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

package/core/actions/node_modules/.bin/tsserver

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

package/core/actions/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@stacksjs/actions",
+  "type": "module",
+  "version": "0.44.9",
+  "packageManager": "pnpm@7.18.2",
+  "description": "The Stacks actions.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/actions#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/actions"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "actions",
+    "stacks",
+    "framework",
+    "typescript",
+    "javascript",
+    "vite",
+    "nitro",
+    "vue",
+    "components",
+    "library"
+  ],
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.18.2"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@stacksjs/cli": "workspace:*",
+    "@stacksjs/config": "workspace:*",
+    "@stacksjs/logging": "workspace:*",
+    "@stacksjs/path": "workspace:*",
+    "@stacksjs/storage": "workspace:*",
+    "@stacksjs/types": "workspace:*",
+    "@stacksjs/utils": "workspace:*",
+    "markdown-it": "^13.0.1",
+    "vue-component-meta": "^1.0.13"
+  },
+  "dependencies": {
+    "@stacksjs/strings": "workspace:*",
+    "esno": "^0.16.3"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4"
+  }
+}

package/core/actions/src/add.ts

@@ -0,0 +1,32 @@
+import { installPackage } from '@stacksjs/cli'
+import type { AddOptions } from '@stacksjs/types'
+
+export async function invoke(options: AddOptions) {
+  if (options?.table)
+    await addTable()
+
+  if (options?.calendar)
+    await addCalendar()
+}
+
+/**
+ * An alias of the invoke method.
+ * @param options
+ * @returns
+ */
+export async function add(options: AddOptions) {
+  return invoke(options)
+}
+
+export async function addTable() {
+  await installPackage('@stacksjs/table')
+}
+
+export async function addCalendar() {
+  await installPackage('@stacksjs/calendar')
+}
+
+export async function installPackages(names: string[]) {
+  for (const name of names)
+    await installPackage(name)
+}

package/core/actions/src/build.ts

@@ -0,0 +1,93 @@
+import { log } from '@stacksjs/logging'
+import { hasComponents, hasFunctions } from '@stacksjs/storage'
+import { runNpmScript } from '@stacksjs/utils'
+import { type BuildOptions, NpmScript } from '@stacksjs/types'
+import { types as generateTypes } from './generate'
+
+export async function invoke(options: BuildOptions) {
+  if (options.components)
+    await componentLibraries(options)
+
+  else if (options.vueComponents)
+    await vueComponentLibrary(options)
+
+  else if (options.webComponents || options.elements)
+    await webComponentLibrary(options)
+
+  else if (options.functions)
+    await functionsLibrary(options)
+
+  else if (options.docs)
+    await docs(options)
+
+  else if (options.stacks)
+    await stacks(options)
+
+  await generateTypes()
+}
+
+/**
+ * An alias of the invoke method.
+ * @param options
+ * @returns
+ */
+export async function build(options: BuildOptions) {
+  return invoke(options)
+}
+
+export async function componentLibraries(options: BuildOptions) {
+  await runNpmScript(NpmScript.GenerateEntries, options)
+  await vueComponentLibrary(options)
+  await webComponentLibrary(options)
+}
+
+export async function vueComponentLibrary(options: BuildOptions) {
+  if (hasComponents()) {
+    log.info('Building your component library...')
+    await runNpmScript(NpmScript.BuildComponents, options)
+    log.success('Your component library was built successfully')
+  }
+  else {
+    // todo: throw custom error here
+    log.warn('No components found.')
+    log.info('Before you can build components,')
+    log.info('you need to have created some in the ./components folder.')
+  }
+}
+
+export async function webComponentLibrary(options: BuildOptions) {
+  log.info('Building your component library for production use & npm/CDN distribution...')
+
+  if (hasComponents()) {
+    await runNpmScript(NpmScript.BuildWebComponents, options)
+    log.success('Your Web Component library was built successfully')
+  }
+  else {
+    // todo: throw custom error here
+    log.info('No components found.')
+  }
+}
+
+export async function docs(options: BuildOptions) {
+  log.info('Building the documentation site...')
+  await runNpmScript(NpmScript.BuildDocs, options)
+  log.success('Docs built successfully')
+}
+
+export async function stacks(options: BuildOptions) {
+  log.info('Building the Stacks Framework...')
+  await runNpmScript(NpmScript.BuildStacks, options)
+  log.success('Stacks built successfully')
+}
+
+export async function functionsLibrary(options: BuildOptions) {
+  if (hasFunctions()) {
+    log.info('Building your functions library for production usages...')
+    log.info('Production usages include: manual npm distribution and/or CDN distribution')
+    await runNpmScript(NpmScript.BuildFunctions, options)
+    log.success('Functions library built successfully')
+  }
+  else {
+    log.info('No functions found')
+  }
+}

package/core/actions/src/clean.ts

@@ -0,0 +1,25 @@
+import { log, runCommand } from '@stacksjs/cli'
+import { type CleanOptions, ExitCode, NpmScript } from '@stacksjs/types'
+
+export async function invoke(options?: CleanOptions) {
+  log.info('Running clean command...')
+
+  const result = await runCommand(NpmScript.Clean, options)
+
+  if (result.isOk()) {
+    log.success('Cleaned up')
+    process.exit(ExitCode.Success)
+  }
+
+  log.error(result.error)
+  process.exit(ExitCode.FatalError)
+}
+
+/**
+ * An alias of the invoke method.
+ * @param options
+ * @returns
+ */
+export async function clean(options: CleanOptions) {
+  return invoke(options)
+}

package/core/actions/src/commit.ts

@@ -0,0 +1,19 @@
+import { log } from '@stacksjs/logging'
+import { runNpmScript } from '@stacksjs/utils'
+import type { CleanOptions } from '@stacksjs/types'
+import { NpmScript } from '@stacksjs/types'
+
+export async function invoke(options: CleanOptions) {
+  log.info('Committing...')
+  await runNpmScript(NpmScript.Commit, options)
+  log.success('Committed')
+}
+
+/**
+ * An alias of the invoke method.
+ * @param options
+ * @returns
+ */
+export async function commit(options: CleanOptions) {
+  return invoke(options)
+}