stacks 0.1.0 → 0.37.3

package/core/security/src/index.ts

@@ -0,0 +1,3 @@
+export * from './key'
+export * from './crypt'
+export * from './hash'

package/core/security/src/key.ts

@@ -0,0 +1,11 @@
+import { getRandomValues } from 'node:crypto'
+import utf8 from 'crypto-js/enc-utf8'
+import base64 from 'crypto-js/enc-base64'
+
+export async function generateAppKey() {
+  const random = getRandomValues(new Uint8Array(32))
+  const encodedWord = utf8.parse(random.toString())
+  const key = base64.stringify(encodedWord)
+
+  return `base64:${key}`
+}

package/core/strings/README.md

@@ -0,0 +1,59 @@
+# Stacks Strings
+
+This package contains the Stacks Strings source.
+
+## ☘️ Features
+
+wip
+
+- ⚡️
+
+wip
+
+## 🤖 Usage
+
+wip
+
+```bash
+pnpm i -D @stacksjs/strings
+```
+
+Now, you can use it in your project:
+
+```js
+import * as strings from '@stacksjs/strings'
+
+// wip
+```
+
+Learn more in the docs.
+
+## 🧪 Testing
+
+```bash
+pnpm test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacksjs/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please see [CONTRIBUTING](../../.github/CONTRIBUTING.md) 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 Open Web 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/strings/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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/mkdist@0.3.13_typescript@4.8.4/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@0.3.13_typescript@4.8.4/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

package/core/strings/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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.8.4/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.8.4/node_modules/typescript/bin/tsc" "$@"
+fi

package/core/strings/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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.8.4/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.8.4/node_modules/typescript/bin/tsserver" "$@"
+fi

package/core/strings/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@stacksjs/strings",
+  "type": "module",
+  "version": "0.37.3",
+  "packageManager": "pnpm@7.13.6",
+  "description": "The Stacks string utilities.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/strings#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/strings"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "strings",
+    "camel case",
+    "capital case",
+    "constant case",
+    "dot case",
+    "header case",
+    "no case",
+    "param case",
+    "kebab case",
+    "pascal case",
+    "path case",
+    "sentence case",
+    "snake case",
+    "utilities",
+    "functions",
+    "stacks"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=v18.10.0",
+    "pnpm": ">=7.13.6"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "change-case": "^4.1.2"
+  },
+  "devDependencies": {
+    "mkdist": "^0.3.13",
+    "typescript": "^4.8.4"
+  }
+}

package/core/strings/src/index.ts

@@ -0,0 +1,14 @@
+export {
+  camelCase,
+  capitalCase,
+  constantCase,
+  dotCase,
+  headerCase,
+  noCase,
+  paramCase,
+  paramCase as kebabCase,
+  pascalCase,
+  pathCase,
+  sentenceCase,
+  snakeCase,
+} from 'change-case'

package/core/types/README.md

@@ -0,0 +1,59 @@
+# Stacks Types
+
+This package contains the Stacks TypeScript types.
+
+## ☘️ Features
+
+wip
+
+- ⚡️
+
+wip
+
+## 🤖 Usage
+
+wip
+
+```bash
+pnpm i -D @stacksjs/types
+```
+
+Now, you can use it in your project:
+
+```js
+// import * as types from '@stacksjs/types'
+
+// wip
+```
+
+Learn more in the docs.
+
+## 🧪 Testing
+
+```bash
+pnpm test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacksjs/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please see [CONTRIBUTING](../../.github/CONTRIBUTING.md) 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 Open Web 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/types/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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/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/types/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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/mkdist@0.3.13/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@0.3.13/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vite@3.1.8/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vite@3.1.8/node_modules/vite/bin/vite.js" "$@"
+fi

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

@@ -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="/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/Users/chrisbreuer/Code/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.21/node_modules/vitepress/bin/vitepress.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/vitepress@1.0.0-alpha.21/node_modules/vitepress/bin/vitepress.js" "$@"
+fi

package/core/types/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@stacksjs/types",
+  "type": "module",
+  "version": "0.37.3",
+  "packageManager": "pnpm@7.13.6",
+  "description": "The Stacks framework types.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/types#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/types"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "types",
+    "stacks",
+    "framework",
+    "typescript"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=v18.10.0",
+    "pnpm": ">=7.13.6"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@mdit-vue/plugin-component": "^0.11.1",
+    "@mdit-vue/plugin-frontmatter": "^0.11.1",
+    "@mdit-vue/types": "^0.11.0",
+    "@rollup/pluginutils": "^5.0.2",
+    "markdown-it": "^13.0.1",
+    "unplugin-auto-import": "^0.11.2",
+    "unplugin-vue-components": "^0.22.8",
+    "vite": "^3.1.8",
+    "vite-plugin-inspect": "^0.7.5",
+    "vite-plugin-vue-layouts": "^0.7.0",
+    "vitepress": "1.0.0-alpha.22"
+  },
+  "devDependencies": {
+    "mkdist": "^0.3.13"
+  }
+}

package/core/types/src/app.ts

@@ -0,0 +1,131 @@
+/**
+ * ### Application Options
+ *
+ * This configuration defines all of your application options. Because Stacks is full-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.
+ */
+export interface AppOptions {
+  /**
+   * ### Application Name
+   *
+   * This value is the name of your application. This value is used when the
+   * framework needs to place the application's name in a log or any
+   * other location as required by the application or its packages.
+   *
+   * @default string "Stacks"
+   */
+  name: string
+
+  /**
+   * ### Application Environment
+   *
+   * This value determines the "environment" your application is currently
+   * running in. This may determine how you prefer to configure various
+   * services the application utilizes. Set this in your ".env" file
+   *
+   * @default "local"
+   */
+  env?: 'development' | 'production' | 'local'
+
+  /**
+   * ### 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.
+   *
+   * @default string "https://localhost"
+   * @example
+   * https://hello-world.test
+   */
+  url?: string
+
+  /**
+   * ### Application Debug Mode
+   *
+   * When your application is in debug mode, detailed error messages with
+   * stack traces will be shown on every error that occurs within your
+   * application. If disabled, a simple generic error page is shown.
+   *
+   * @default false
+   */
+  debug: boolean
+
+  /**
+   * ### Application Port
+   *
+   * This port is used when Stacks creates a server you. You should set
+   * a port that's not already in use by your machine. Stacks defaults
+   * to a memorable port that likely is free on your end: 3333.
+   *
+   * @default number 3333
+   */
+  port: number
+
+  /**
+   * ### Encryption Key
+   *
+   * This key is used by the Stacks encrypter service and should be set to
+   * a random, 32 character string, otherwise these encrypted strings will
+   * not be safe. Please do this before deploying an application!
+   */
+  key?: string
+
+  /**
+   * ### Application Timezone
+   *
+   * Here you may specify the default timezone for your application, which
+   * will be used by Stacks and date-time functions. We have gone ahead
+   * and set this to a sensible default for you out of the box.
+   *
+   * @default string "UTC"
+   */
+  timezone?: string
+
+  /**
+   * ### Application Locale Configuration
+   *
+   * The application locale determines the default locale that will be used
+   * by the translation service provider. You are free to set this value
+   * to any of the locales which will be supported by the application.
+   *
+   * @default string "en"
+   * @example
+   * de // ./lang/de.yml needs to be present for this
+   */
+  locale?: string
+
+  /**
+   * ### Application Fallback Locale
+   *
+   * The fallback locale determines the locale to use when the current one
+   * is not available. You may change the value to correspond to any of
+   * the language folders that are provided through your application.
+   *
+   * @default string "en"
+   */
+  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
+   *
+   * Description WIP.
+   *
+   * @default string "aes-256-cbc"
+   */
+  cipher: string
+
+  // inspect: <InspectOptions>{},
+}

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

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

package/core/types/src/build.ts

@@ -0,0 +1,3 @@
+import type { UserConfig } from 'vite'
+
+export type ViteConfig = UserConfig

package/core/types/src/cli.ts

@@ -0,0 +1,49 @@
+/**
+ * The parsed command-line arguments
+ */
+export interface StacksOptions {
+  componentsSrcPath?: string
+  dtsPath?: string
+  extensions?: string[]
+}
+
+/**
+ * The available npm scripts within the Stacks toolkit.
+ */
+export const enum NpmScript {
+  Build = 'build',
+  BuildComponents = 'build:components',
+  BuildWebComponents = 'build:web-components',
+  BuildFunctions = 'build:functions',
+  BuildDocs = 'build:docs',
+  BuildStacks = 'build:stacks',
+  Dev = 'dev',
+  DevComponents = 'dev:components',
+  DevDocs = 'dev:docs',
+  Fresh = 'fresh',
+  Update = 'update',
+  UpdateDependencies = 'update:dependencies',
+  UpdateFramework = 'update:framework',
+  UpdatePackageManager = 'update:package-manager',
+  Lint = 'lint',
+  LintFix = 'lint:fix',
+  MakeStack = 'make:stack',
+  Test = 'test',
+  TestTypes = 'test:types',
+  TestCoverage = 'test:coverage',
+  Generate = 'generate',
+  GenerateEntries = 'generate:entries',
+  GenerateVueCompat = 'generate:vue-compatibility',
+  GenerateWebTypes = 'generate:web-types',
+  GenerateVsCodeCustomData = 'generate:vscode-custom-data',
+  GenerateIdeHelpers = 'generate:ide-helpers',
+  GenerateComponentMeta = 'generate:component-meta',
+  Release = 'release',
+  Commit = 'commit',
+  Example = 'example',
+  ExampleVue = 'example:vue',
+  ExampleWebComponents = 'example:web-components',
+  KeyGenerate = 'key:generate',
+  TypesFix = 'types:fix',
+  TypesGenerate = 'types:generate',
+}

package/core/types/src/components.ts

@@ -0,0 +1,66 @@
+import type { Options } from 'unplugin-vue-components'
+
+export interface TagOption {
+  /**
+   * ### Tag Name
+   *
+   * This is the name of the component to be included in your library build.
+   * When defining a tag, ensure that the name corresponds to a file within
+   * root component directory.
+   *
+   * @example
+   * {
+   *   tags: [{
+   *     name: 'HelloWorld' // results in `<HelloWorld />`
+   *   }]
+   * }
+   *
+   * @example
+   * {
+   *   tags: [{
+   *     name: ['HelloWorld', 'AppHelloWorld'] // results in `<AppHelloWorld />`
+   *   }]
+   * }
+   * @see https://stacksjs.dev/docs/components
+   */
+  name: string | string[]
+
+  /**
+   * ### Tag Description
+   *
+   * This is the description of your component. This value is
+   * used when to provide additional information to IDEs.
+   *
+   * @example
+   * {
+   *   name: 'HelloWorld' // results in `<HelloWorld />`
+   * }
+   * @see https://stacksjs.dev/docs/components
+   */
+  description?: string
+
+  /**
+   * ### Tag Attributes
+   *
+   * These are your component's attributes. While it's an optional field, you should aim
+   * to define all of your component attributes here, to provide as much context
+   * to your IDEs as possible, when actually using the library as an end-user.
+   *
+   * @example
+   * {
+   *   attributes: {
+   *     name: 'greeting',
+   *     description: 'The way to greet the user.',
+   *   }
+   * }
+   * @see https://stacksjs.dev/docs/components
+   */
+  attributes?: {
+    name: string
+    description: string
+  }[]
+}
+
+export type TagsOptions = TagOption[]
+
+export type ComponentOptions = Options

package/core/types/src/deploy.ts

@@ -0,0 +1,11 @@
+export interface DeployOptions {
+  /**
+   * ### Deployment Host
+   *
+   * The host to deploy to.
+   *
+   * @default string 'netlify'
+   * @see https://stacksjs.dev/docs/components
+   */
+  host: 'netlify' | 'vercel'
+}

package/core/types/src/docs.ts

@@ -0,0 +1,3 @@
+import type { UserConfig } from 'vitepress'
+
+export type DocsConfig = UserConfig