Initial commit

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.eslintignore

@@ -0,0 +1,4 @@
+coverage/
+dist/
+node_modules/
+private/

.eslintrc

@@ -0,0 +1,83 @@
+{
+  "root": true,
+  "extends": ["@webdeveric/eslint-config-ts", "plugin:import/recommended", "plugin:import/typescript", "prettier"],
+  "env": {
+    "browser": false,
+    "es6": true,
+    "node": true
+  },
+  "parserOptions": {
+    "project": ["./tsconfig.json"],
+    "ecmaFeatures": {
+      "jsx": false
+    }
+  },
+  "settings": {
+    "import/extensions": [".ts", ".mts", ".cts", ".js", ".mjs", ".cjs", ".json"],
+    "import/resolver": {
+      "typescript": {
+        "project": "./tsconfig.json"
+      },
+      "node": {
+        "extensions": [".ts", ".mts", ".cts", ".js", ".mjs", ".cjs"]
+      }
+    },
+    "import/parsers": {
+      "@typescript-eslint/parser": [".ts", ".mts", ".cts"]
+    }
+  },
+  "rules": {
+    "import/first": "error",
+    "import/no-absolute-path": "error",
+    "import/no-cycle": "error",
+    "import/no-deprecated": "error",
+    "import/no-extraneous-dependencies": [
+      "error",
+      {
+        "devDependencies": ["./build.mjs", "./vitest.config.mts", "**/*.test.ts"]
+      }
+    ],
+    "import/no-relative-packages": "error",
+    "import/no-self-import": "error",
+    "import/no-unresolved": "error",
+    "import/no-useless-path-segments": [
+      "error",
+      {
+        "noUselessIndex": false
+      }
+    ],
+    "import/order": [
+      "error",
+      {
+        "alphabetize": {
+          "order": "asc",
+          "caseInsensitive": true
+        },
+        "groups": ["builtin", "external", "internal", "parent", ["sibling", "index"], "type"],
+        "newlines-between": "always",
+        "pathGroups": [
+          {
+            "pattern": "@{src,commands}/**",
+            "group": "internal",
+            "position": "after"
+          }
+        ]
+      }
+    ],
+    "sort-imports": "off"
+  },
+  "overrides": [
+    {
+      "files": ["./*.mjs", "./*.mts"],
+      "parserOptions": {
+        "project": ["./tsconfig.project-files.json"]
+      }
+    },
+    {
+      "files": ["**/*.test.ts"],
+      "rules": {
+        "@typescript-eslint/no-explicit-any": ["off"]
+      }
+    }
+  ]
+}

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @webdeveric

.github/workflows/node.js.yml

@@ -0,0 +1,34 @@
+name: Node.js CI
+
+on: [push]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    name: Continuous Integration
+    strategy:
+      fail-fast: true
+      matrix:
+        os: [ubuntu-22.04, windows-2022]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v2
+      - name: Use Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'pnpm'
+      - name: Installing dependencies
+        run: pnpm install
+      - name: Linting
+        run: pnpm lint
+      - name: Type checking
+        run: pnpm typecheck
+      - name: Testing
+        run: pnpm coverage
+      - name: Building
+        run: pnpm build

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+npm-debug.log
+coverage/
+dist/
+node_modules/
+private/

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no cspell -- --no-summary --no-progress --language-id commit-msg $1

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no lint-staged

.npmrc

@@ -0,0 +1,3 @@
+auto-install-peers=true
+enable-pre-post-scripts=true
+# strict-peer-dependencies=false

.nvmrc

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

.prettierignore

@@ -0,0 +1,6 @@
+.vscode/
+coverage/
+dist/
+private/
+package-lock.json
+LICENSE

.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "streetsidesoftware.code-spell-checker",
+    "editorconfig.editorconfig",
+    "dbaeumer.vscode-eslint",
+    "eamodio.gitlens"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,34 @@
+{
+  "eslint.alwaysShowStatus": true,
+  "eslint.format.enable": true,
+  "eslint.validate": [
+    "javascript",
+    "typescript"
+  ],
+  "eslint.lintTask.enable": true,
+  "eslint.packageManager": "npm",
+  "editor.bracketPairColorization.enabled": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "javascript.format.semicolons": "insert",
+  "javascript.updateImportsOnFileMove.enabled": "always",
+  "typescript.format.semicolons": "insert",
+  "typescript.updateImportsOnFileMove.enabled": "always",
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "javascript.suggest.completeJSDocs": true,
+  "javascript.suggest.jsdoc.generateReturns": true,
+  "typescript.suggest.completeJSDocs": false,
+  "typescript.suggest.jsdoc.generateReturns": false
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Eric King
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

build.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env -S node --experimental-json-modules --no-warnings
+
+import { comment } from '@webdeveric/utils/comment';
+import { build } from 'esbuild';
+import { clean } from 'esbuild-plugin-clean';
+import { environmentPlugin } from 'esbuild-plugin-environment';
+import { nodeExternals } from 'esbuild-plugin-node-externals';
+
+import pkg from './package.json' assert { type: 'json' };
+
+try {
+  const results = await build({
+    entryPoints: ['./src/cli.ts'],
+    outdir: './dist',
+    platform: 'node',
+    bundle: true,
+    format: 'esm',
+    outExtension: {
+      '.js': '.mjs',
+    },
+    target: `node${process.versions.node}`,
+    minify: process.env.NODE_ENV === 'production',
+    banner: {
+      js: comment(
+        `
+          @file ${pkg.name}
+          @version ${pkg.version}
+          @license ${pkg.license}
+          @copyright ${pkg.author.name} ${new Date().getFullYear()}
+          @see {@link ${pkg.homepage}}
+        `,
+        {
+          type: 'legal',
+        },
+      ),
+    },
+    plugins: [
+      clean({
+        patterns: ['./dist/*'],
+      }),
+      nodeExternals(),
+      environmentPlugin(['npm_package_engines_node']),
+    ],
+  });
+
+  const errors = [...results.warnings, ...results.errors];
+
+  if (errors.length) {
+    throw new AggregateError(errors, 'Build error and warnings');
+  }
+} catch (error) {
+  console.error(error);
+
+  process.exitCode ||= 1;
+}

cspell.json

@@ -0,0 +1,22 @@
+{
+  "version": "0.2",
+  "words": [
+    "CODEOWNERS",
+    "corepack",
+    "nvmrc",
+    "outdir",
+    "Positionals",
+    "predemo",
+    "typecheck",
+    "unstub",
+    "vitest",
+    "webdeveric"
+  ],
+  "ignorePaths": ["node_modules/**", ".vscode/*.json", "./private", "pnpm-lock.yaml", ".github/CODEOWNERS"],
+  "languageSettings": [
+    {
+      "languageId": "commit-msg",
+      "ignoreRegExpList": ["/^#.*/gm"]
+    }
+  ]
+}

lint-staged.config.mjs

@@ -0,0 +1,27 @@
+import { relative } from 'node:path';
+import { cwd } from 'node:process';
+
+/**
+ * @type {(filenames: string[]) => string[]>}
+ */
+const relativeFilenames = filenames => {
+  const root = cwd();
+
+  return filenames.map(file => relative(root, file));
+};
+
+/**
+ * @type {Record<string, string | (filenames: string[]) => string | string[] | Promise<string | string[]>}
+ */
+export default {
+  '*.{js,cjs,mjs,ts,cts,mts}': ['eslint --fix', 'prettier --write'],
+  '*.{json,md}': 'prettier --write',
+  '*': filenames => {
+    const files = relativeFilenames(filenames);
+
+    return [
+      `cspell lint --no-progress --no-summary --no-must-find-files ${files.join(' ')}`,
+      `sh -c 'echo "${files.join('\n')}" | cspell --show-context stdin'`, // Spell check file names.
+    ];
+  },
+};