chore(repo): initial commit

Author: shellscape

.commitlintrc

@@ -0,0 +1,5 @@
+{
+  "extends": [
+    "@commitlint/config-conventional"
+  ]
+}

.editorconfig

@@ -0,0 +1,20 @@
+# editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+insert_final_newline = true
+trim_trailing_whitespace = false
+
+[*.yml]
+max_line_length = 500
+
+[README.md]
+max_line_length = 170

.eslintignore

@@ -0,0 +1 @@
+**/dist

.eslintrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+  extends: ['shellscape/typescript', 'plugin:import/typescript'],
+  parserOptions: {
+    project: ['./shared/tsconfig.eslint.json', './packages/*/tsconfig.json'],
+    tsconfigRootDir: __dirname
+  },
+  overrides: [
+    {
+      files: ['**/fixtures/**', '**/scripts/**', '**/test/**'],
+      rules: {
+        'import/extensions': 'off',
+        'import/no-extraneous-dependencies': 'off',
+        'import/no-unresolved': 'off',
+        'no-console': 'off'
+      }
+    }
+  ]
+};

.github/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+## Contributing
+
+We 💛 contributions! The rules for contributing to this org are few:
+
+1. Don't be a jerk
+1. Search issues before opening a new one
+1. Lint and run tests locally before submitting a PR
+1. Adhere to the code style the org has chosen
+
+
+## Before Committing
+
+1. Use at least Node.js v18 or higher. [NVM](https://github.com/creationix/nvm) can be handy for switching between Node versions.
+1. Lint your changes via `pnpm lint`. Fix any errors and warnings before committing.
+1. Test your changes via `pnpm -r test`. Only Pull Requests with passing tests will be accepted.
+
+### Commits
+
+Commits in this repository are expected to follow the [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/). Since commits are used to generate CHANGELOGs for the packages in this repository and control version-release flows, each commit that affects a particular package must have a scope matching that pacakge's name. e.g. `fix(batman): broken riddle` will match the `@dot/batman` a package located at `packages/batman` in the repository.
+
+To affect multiple packages in one commit, use a comma to delimit package names in the commit scope. e.g. `fix(batman,robin): batcave permissions.`
+
+### Pull Requests
+
+Pull Requests should ideally be limited to affect one package, but there may be situations where more than one package needs changes. PR merges should use _Squash Merge_.
+
+### Adding Dependencies
+
+Much like `yarn`, `pnpm add {dependency-name}` will add a dependency to a package.
+
+However, because this is a monorepo, dependencies aren't frequently added to the repo root. Instead, move to the target package directory and run `pnpm add` there. e.g.
+
+```console
+cd packages/batman
+pnpm add del-cli --save-dev
+```
+
+If the rare need arises to add or update a dependency in all packages in the repository, a recursive add may be performed. e.g.
+
+```console
+$ pnpm add typescript --recursive
+```
+
+To add a package to the repo root, use the `-D -W` flags, which instruct `pnpm` to save to `devDependencies` and target the "workspace root." Root packages should always be installed to `devDependencies`.
+
+## Package Scripts
+
+All packages in this monorepo share the same set of scripts, and similar functionality between packages can be expected.
+
+Scripts can be run from the respective `packages/*` directories using `pnpm {script name}`, or from the monorepo root directory using `pnpm {script-name} --filter {package-name}` to target specific packages.

.github/ISSUE_TEMPLATE/BUG.md

@@ -0,0 +1,13 @@
+---
+name: 🐞 Bug Report
+about: Something went awry and you'd like to tell us about it.
+labels: ['t¹ 🐞 bug']
+---
+
+- Package Name: `<name>`
+
+### Expected Behavior
+
+### Actual Behavior
+
+### Additional Information

.github/ISSUE_TEMPLATE/FEATURE.md

@@ -0,0 +1,11 @@
+---
+name: ✨ Feature Request
+about: Suggest an idea for a package in this repo
+labels: ['t³ ✨ feature']
+---
+
+- Package Name: `<name>`
+
+### Feature Use Case
+
+### Feature Proposal

.github/ISSUE_TEMPLATE/MODIFICATION.md

@@ -0,0 +1,13 @@
+---
+name: 🔧 Modification Request
+about: Would you like something work differently? Have an alternative approach? This is the template for you.
+labels: ['t⁴ 💡 idea']
+---
+
+- Package Name: `<name>`
+
+### Expected Behavior / Situation
+
+### Actual Behavior / Situation
+
+### Modification Proposal

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+This PR contains a:
+
+- [ ] bugfix
+- [ ] feature
+- [ ] refactor
+- [ ] documentation
+- [ ] other
+
+Are tests included?
+
+- [ ] yes
+- [ ] no
+
+Breaking Changes?
+
+- [ ] yes
+- [ ] no
+
+<!-- If yes, then include "BREAKING CHANGES:" in the first commit message body, followed by a description of what is breaking. -->
+
+### Description
+
+<!--
+  Please be thorough and clearly explain the problem being solved.
+  * If this PR adds a feature, look for previous discussion on the feature by searching the issues first.
+  * Is this PR related to an issue?
+  * List any relevant issue numbers
+-->

.github/labels.json

@@ -0,0 +1,19 @@
+[
+  { "name": "s¹ 🔥🔥 critical", "color": "#E53935" },
+  { "name": "s² 🔥 important", "color": "#FB8C00" },
+  { "name": "s³ 💧 nice to have", "color": "#FDD835" },
+  { "name": "s⁴ 💧💧 low priority", "color": "#039BE5" },
+
+  { "name": "t¹ 🐞 bug", "color": "#F44336" },
+  { "name": "t² 📚 documentation", "color": "#FDD835" },
+  { "name": "t³ ✨ feature", "color": "#8bc34A" },
+  { "name": "t⁴ 💡 idea", "color": "#1976D2" },
+  { "name": "t⁵ 🔜 todo", "color": "#311B92" },
+
+  { "name": "x¹ ⋅ could not reproduce", "color": "#CFD8DC" },
+  { "name": "x² ⋅ duplicate", "color": "#CFD8DC" },
+  { "name": "x³ ⋅ hold", "color": "#CFD8DC" },
+  { "name": "x⁴ ⋅ in progress", "color": "#1B5E20" },
+  { "name": "x⁵ ⋅ need more info", "color": "#6A1B9A" },
+  { "name": "x⁶ ⋅ wontfix", "color": "#CFD8DC" }
+]

.github/workflows/pr-title.yml

@@ -0,0 +1,25 @@
+name: Pull Request Title Format
+
+on:
+  pull_request:
+    branches:
+      - '*'
+    types:
+      - opened
+      - reopened
+      - edited
+      - synchronize
+
+jobs:
+  prTitle:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Check PR Title
+        uses: clowdhaus/actions/[email protected]
+        with:
+          on-fail-message: "Your PR title doesn't match the required format. The title should be in the conventional commit (https://www.conventionalcommits.org/en/v1.0.0-beta.4/) format. e.g.\n\n```\nchore: add pr title workflow\n```. Note that scopes should not contain spaces."
+          title-regex: '^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\([\w|,|\-|\|]+\))?(!)?\:\s.*'
+          github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/validate.yml

@@ -0,0 +1,74 @@
+name: Validate Monorepo
+
+on:
+  workflow_dispatch:
+  pull_request:
+    types:
+      - edited
+      - opened
+      - synchronize
+  push:
+    branches:
+      - '*'
+      - '!master'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    name: Validate
+
+    steps:
+      - name: Checkout Commit
+        uses: actions/checkout@v1
+
+      - name: Checkout Master
+        run: git branch -f master origin/master
+
+      - name: Setup Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - name: Enable Corepack
+        id: pnpm-setup
+        run: |
+          corepack enable
+          corepack prepare pnpm@latest --activate
+          pnpm config set script-shell "/usr/bin/bash"
+          echo "::set-output name=pnpm_cache_dir::$(pnpm store path)"
+
+      - name: pnpm Cache
+        uses: actions/cache@v3
+        with:
+          path: ${{ steps.pnpm-setup.outputs.pnpm_cache_dir }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: ESLint Cache
+        uses: actions/cache@v3
+        with:
+          path: ./.eslintcache
+          key: ${{ runner.os }}-eslintcache-${{ hashFiles('./eslintcache') }}
+          restore-keys: |
+            ${{ runner.os }}-eslintcache-
+
+      - name: Sanity Check
+        run: |
+          echo git `git version`;
+          echo branch `git branch --show-current`;
+          echo node `node -v`;
+          echo pnpm `pnpm -v`
+          echo python `python --version`
+
+      - name: pnpm install
+        run: pnpm install --frozen-lockfile
+
+      - name: Build Packages
+        run: pnpm -r build
+
+      - name: Lint Monorepo
+        run: pnpm lint
+
+      - name: Run Tests
+        run: pnpm --filter "...[origin/master]" test

.gitignore

@@ -0,0 +1,6 @@
+coverage*
+dist
+node_modules
+.DS_Store
+.eslintcache
+.pnpm-debug.log

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+pnpm dlx lint-staged

.npmrc

@@ -0,0 +1,7 @@
+# pnpm options
+always-auth = true
+enable-pre-post-scripts = true
+link-workspace-packages = false
+shamefully-hoist = true
+shared-workspace-lockfile = true
+strict-peer-dependencies = false

.nvmrc

@@ -0,0 +1 @@
+18

.prettierignore

@@ -0,0 +1,5 @@
+.github/PULL_REQUEST_TEMPLATE.md
+**/dist/
+**/fixtures/
+pnpm-lock.yaml
+cdk.out

.prettierrc.js

@@ -0,0 +1,3 @@
+// Note: This file is necessary so that prettier writes which happen in hooks and scripts match the
+// same config that we're using from the eslint-config package.
+module.exports = require('eslint-config-shellscape/prettier');