refactor: regenerate assets

.codecov.yml

@@ -1,2 +1,22 @@
+codecov:
+  branch: main
 coverage:
   range: '75...100'
+  status:
+    project:
+      default:
+        informational: true
+    patch:
+      default:
+        informational: true
+# * Well-known flag syntax: package.<branch>_<package-id>
+# * <package>-id will be the WorkspacePackageId or "root" for RootPackages
+flag_management:
+  # * These rules will apply to all non-specially-configured flags
+  default_rules:
+    carryforward: true
+    statuses:
+      - type: project
+        target: auto
+      - type: patch
+        target: auto

.env.default

@@ -85,4 +85,3 @@ GPG_PASSPHRASE=
 # The GPG key used to sign all git commits and releases. Not referenced during
 # non-CI/CD (i.e. local, manual) deployments.
 GPG_PRIVATE_KEY=
-

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,7 @@
-<!-- Add a brief description of your PR here -->
-<!-- If this PR closes any issues, please enumerate them; i.e. "Closes #4" -->
+<!-- Add a brief description of your PR here |-->
+
+<!-- If this PR closes any issues, please enumerate them; i.e. "Closes #4" |-->
+
 <!-- If this PR involves or references any other issues, list them as well -->
 
 ---

.github/SUPPORT.md

@@ -57,5 +57,4 @@ you for contribution 🎉, your efforts are greatly appreciated! 🙌🏿
   https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments
 [link-issue-resolution]:
   https://isitmaintained.com/project/Xunnamius/next-test-api-route-handler
-[open-issues]:
-  https://github.com/Xunnamius/next-test-api-route-handler/issues?q=
+[open-issues]: https://github.com/Xunnamius/next-test-api-route-handler/issues?q=

.github/workflows/README.md

@@ -1,6 +1,3 @@
-Note: the `build-test`, `deploy`, `cleanup`, and `post-release-check` workflows
-are part of the [Projector][1] pipeline. Details on pipeline design and
-operation can be found [here][2].
+Details on pipeline design and operation can be found [here][1].
 
-[1]: https://github.com/Xunnamius/projector
-[2]: https://github.com/Xunnamius/projector-pipeline
+[1]: https://github.com/Xunnamius/symbiote/wiki

.gitignore

@@ -1,34 +1,110 @@
-# Ignore temporary files by giving them a special name
+# ! Note that any pattern with a / in the beginning OR MIDDLE (but not end) will
+# ! be considered relative to this file ONLY. Matching subdirs will NOT match!
+# ! Otherwise, patterns will match entities in any directory or subdirectory.
+# ! Prepend ** (or **/) if advanced subdir matching of complex paths is desired.
+# ! See https://git-scm.com/docs/gitignore#_pattern_format
+
+# Ignore temporary files in any subdir by giving them a special name
 *.ignore
 *.ignore.*
 ignore.*
+tmp
 
-# Ignore sensitive files
+# Ignore sensitive files in any subdir
 .env
 .npmrc
 *.local
 
-# Ignore transpiled source (used for advanced debugging)
+# Ignore transpiled source in any subdir (used for advanced debugging)
 .transpiled
 
-# Ignore any external scripts
-external-scripts/bin
+# Ignore packaged files that probably shouldn't be committed
+*.tgz
 
-# Ignore build artifacts
+# Ignore relevant build artifacts in any subdir (with exceptions)
 *.tsbuildinfo
+# ? Preceding asterisks "**/" are needed to match any build subdir in monorepos
+# ? and proceeding asterisks "/**" allow subsequent negations to be interpreted
+# ? properly. See: https://git-scm.com/docs/gitignore#_pattern_format
+**/build/**
+# ? This and other negations must end in "/**" to be interpreted properly.
+!**/src/**/build/**
+# ? This and other negations must end in "/**" to be interpreted properly.
+!**/docs/**/build/**
 dist
-build
+coverage
+lib-cov
+.nyc_output
+.grunt
+bower_components
+.lock-wscript
+build/Release
 .vercel
 .next
 next-env.d.ts
-coverage
 
-# Ignore local configuration
-.vscode
-!.vscode/launch.example.json
+# Ignore cloned GitHub wiki (do not regard it as a so-called "submodule")
+# ? Note that this complex path is relative to this file
+/.wiki
 
-# Ignore node_modules
+# Ignore local vscode configuration
+# ? Note that this complex path is relative to this file
+/.vscode/**
+# ? Note that this complex path is relative to this file
+!/.vscode/*.example.json
+
+# Ignore relevant NPM and JSPM artifacts in any subdir
+.npm
 node_modules
+jspm_packages
+
+# Ignore logs in any subdir
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
 
-# Ignore random nothingness
-.DS_Store
+# Ignore random nothingness in any subdir
+.eslintcache
+.node_repl_history
+.yarn-integrity
+*.DS_Store
+.AppleDouble
+.LSOverride
+*~
+.fuse_hidden*
+.directory
+.Trash-*
+.nfs*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+pids
+*.pid
+*.seed
+*.pid.lock
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+Desktop.ini
+$RECYCLE.BIN
+*.cab
+*.msi
+*.msm
+*.msp
+*.lnk
+_book
+CertificateAuthorityCertificate.pem
+
+# Custom
+external-scripts/bin

.husky/commit-msg

@@ -1,11 +1,16 @@
+#!/bin/sh
+
+# TODO: replace these uglies with JS (mjs) scripts
+
 beginswith() { case $2 in "$1"*) true;; *) false;; esac; }
 
 if beginswith 'rebase' "$GIT_REFLOG_ACTION"; then
   echo 'husky-hook::commit-msg: skipped commit-msg hook due to rebase'
   exit 0
 fi
 
-npx commitlint -e
-if [ -z $GAC_VERIFY_SIMPLE ]; then npm run test; fi
-echo
-node spellcheck-commit.js
+NODE_NO_WARNINGS=1 commitlint -e
+if [ -z "$GAC_VERIFY_SIMPLE" ]; then npm run test; fi
+# TODO: bring back spellchecker:
+#echo
+#NODE_NO_WARNINGS=1 node spellcheck-commit.cjs

.husky/pre-commit

@@ -1,9 +1,13 @@
+#!/bin/sh
+
+# TODO: replace these uglies with JS (mjs) scripts
+
 beginswith() { case $2 in "$1"*) true;; *) false;; esac; }
 
 if beginswith 'rebase' "$GIT_REFLOG_ACTION"; then
   echo 'husky-hook::commit-msg: skipped pre-commit hook due to rebase'
   exit 0
 fi
 
-if [ -z $GAC_VERIFY_SIMPLE ]; then npm run lint:all; fi
-NODE_ENV=format npx lint-staged --concurrent false
+if [ -z "$GAC_VERIFY_SIMPLE" ]; then npm run lint:package; fi
+NODE_NO_WARNINGS=1 lint-staged --concurrent false

.husky/pre-push

@@ -0,0 +1,50 @@
+#!/bin/sh
+
+# TODO: replace these uglies with JS (mjs) scripts
+
+beginswith() { case $2 in "$1"*) true;; *) false;; esac; }
+prepend() { while read -r line; do echo "${1}${line}"; done; }
+
+if beginswith 'rebase' "$GIT_REFLOG_ACTION"; then
+  echo 'husky-hook::pre-push: pushing commits in the middle of a rebase/merge/cherry-pick is not allowed!'
+  exit 1
+fi
+
+echo 'husky-hook::pre-push: checking for commits that should not be pushed...'
+
+log=$(git log HEAD --oneline --not --remotes)
+set +e
+incompleteCommitsGrep=$(echo "$log" | grep -q -i -e 'mergeme' -e '\[WIP\]' -e '\[NOPUSH\]'; echo $?)
+set -e
+
+interestingMdFiles=$(git ls-tree -r --full-tree --name-only HEAD | grep '\.md$' | grep -vE '(^|/)(src|test|docs)/' | grep -v '/CHANGELOG.md$')
+set +e
+incompleteMdFilesGrep=$(echo "$interestingMdFiles" | xargs -P 0 sh -c 'if grep -q -i -F -e "-✄-" "$@"; then exit 255; else true; fi' 'x' 1>/dev/null 2>&1; echo $?)
+set -e
+
+# ? Make sure no commits to be pushed contain "mergeme" etc in their headers and
+# ? no relevant markdown files contain "-✄-" in their contents
+if [ "$incompleteCommitsGrep" = 0 ] || [ "$incompleteMdFilesGrep" != 0 ]; then
+  echo 'husky-hook::pre-push: BAD COMMIT(S) DETECTED!'
+  echo 'husky-hook::pre-push: merge, delete, reword, or otherwise rectify the following commits before trying again:'
+
+  if [ "$incompleteCommitsGrep" = 0 ]; then
+    echo
+    echo 'husky-hook::pre-push: incomplete commits (e.g. WIP, mergeme, NOPUSH):'
+    echo
+    echo "$log" | grep -i -e 'mergeme' -e '\[WIP\]' -e '\[NOPUSH\]' | prepend '  ⋗ '
+  fi
+
+  if [ "$incompleteMdFilesGrep" != 0 ]; then
+    echo
+    echo 'husky-hook::pre-push: markdown files at HEAD with unmerged replacer regions:'
+    echo
+    echo "$interestingMdFiles" | xargs -P 0 grep -i -l -H -F -e '-✄-' | prepend '  ⋗ '
+  fi
+
+  echo
+  exit 2;
+else
+  echo 'husky-hook::pre-push: ✅'
+  exit 0;
+fi

.ncurc.cjs

@@ -0,0 +1,25 @@
+// @ts-check
+'use strict';
+
+const { createDebugLogger } = require('rejoinder');
+
+const debug = createDebugLogger({ namespace: 'symbiote:config:ncurc' });
+
+// * https://www.npmjs.com/package/npm-check-updates#configuration-files
+module.exports = {
+  install: 'never',
+  reject: [
+    // ? Reject any super-pinned dependencies (e.g. find-up~5 and execa~7)
+    '*~*',
+    // !
+    // TODO: delete these
+    // ? Pin the CJS version of strip-ansi
+    'strip-ansi',
+    // ? Pin the non-broken version of glob
+    'glob',
+    // ? Pin the CJS version of execa
+    'execa'
+  ]
+};
+
+debug('exported config: %O', module.exports);

.prettierignore

@@ -1,13 +1,59 @@
-# Paths below are ignored by prettier as well as remark and doctoc when called
-# with npm run format)
-build
-external-scripts/bin
-node_modules
+# * Paths below are ignored by prettier, remark, doctoc when called
+# * with `symbiote format` and `symbiote lint`. To have eslint ignore
+# * certain files, add them to an "ignores" block in eslint.config.js. To have
+# * tsc ignore certain files, exclude them from the appropriate tsc.*.json file.
+# * See symbiote's help text for more details.
+
+# ! Note that any pattern with a / in the beginning OR MIDDLE (but not end) will
+# ! be considered relative to this file ONLY. Matching subdirs will NOT match!
+# ! Otherwise, patterns will match entities in any directory or subdirectory.
+# ! Prepend ** (or **/) if advanced subdir matching of complex paths is desired.
+# ! See https://git-scm.com/docs/gitignore#_pattern_format
+
+# Ignore temporary files in any subdir by giving them a special name
+*.ignore
+*.ignore.*
+ignore.*
+
+# Ignore sensitive files in any subdir
+.env
+.npmrc
+*.local
+
+# Ignore transpiled source in any subdir (used for advanced debugging)
+.transpiled
+
+# Ignore relevant build artifacts in any subdir (with exceptions)
+*.tsbuildinfo
+# ? Preceding AND proceeding asterisks (**) are needed to match any build subdir
+# ? in monorepos and allow subsequent negations to be interpreted properly.
+**/build/**
+# ? This negation must end in "/**" to be interpreted properly.
+!**/src/**/build/**
+docs
 dist
 coverage
-package-lock.json
-fixtures
-docs
+.vercel
+.next
+next-env.d.ts
 CHANGELOG.md
-bundle-stats.ignore.json
+LICENSE
+LICENSE.md
+
+# Ignore relevant NPM artifacts in any subdir
+node_modules
+package-lock.json
+
+# Ignore test fixtures in any subdir (which may depend on remaining as they are)
+**/test/**/fixtures/**
+__*__
+
+# Ignore things that prettier isn't good at in any subdir
+*.hbs
+
+# Ignore random nothingness in any subdir
+.DS_Store
+
+# Custom
+external-scripts/bin
 test/integration/assets/output-1.js