build(hybrid)!: esm-cjs hybrid migration

- drop `.js` extensions
- drop support for `esm2015` and `esm5` build outputs
- remove `browser`, `es2015`, and `umd` package entrypoints
- update bundle filenames and locations

Author: unicornware

commitlint.config.js renamed to .commitlintrc.ts

@@ -1,22 +1,20 @@
-require('ts-node').register(require('./tsconfig.json'))
-require('tsconfig-paths/register')
-
-const workspaces = require('./tools/helpers/workspaces').default
+import type { UserConfig } from '@commitlint/types'
+import workspaces from './tools/helpers/workspaces'
 
 /**
  * @file Commitlint Configuration
  * @see https://commitlint.js.org/#/guides-local-setup
  * @see https://commitlint.js.org/#/reference-configuration
  */
 
-module.exports = {
+const config: UserConfig = {
   /**
    * Enable default ignore rules.
    */
   defaultIgnores: true,
 
   /**
-   * IDs of commitlint configurations.
+   * IDs of commitlint configurations to extend.
    */
   extends: ['@commitlint/config-conventional'],
 
@@ -48,12 +46,17 @@ module.exports = {
       2,
       'always',
       [
+        'cjs',
         'deploy',
         'deps',
         'deps-dev',
+        'deps-opt',
         'deps-peer',
+        'esm',
         'github',
+        'hybrid',
         'release',
+        'scripts',
         'tests',
         'tools',
         'typescript',
@@ -90,3 +93,5 @@ module.exports = {
     ]
   }
 }
+
+export default config

.env

@@ -1,13 +1,36 @@
 # Environment Variables - Project Defaults
-# 
+#
 # References:
-# 
-# - https://github.com/entropitor/dotenv-cli
+#
+# - https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dotenv
 
 DEBUG='*,-babel*,-yarn,-eslint:*,-eslintrc:*,-lint-staged:*,-typescript-eslint*'
 DEBUG_COLORS=true
-NPM_TOKEN=$NPM_TOKEN_FLDV
+GITHUB_WORKSPACE=$PWD
 NODE_ENV=development
+# Fixes `YN0000: Strings should avoid referencing the node_modules directory`
+# warning during the `yarn check:install` lifecycle
+NODE_MODULES=node_modules
+NPM_TOKEN=$NPM_TOKEN_FLDV
 PAT_GPR=$PAT_GPR_FLDV
-PAT_GPR_REPO_ADMIN=$PAT_REPO_FLDV_ADMIN
-TS_NODE_PROJECT="$PWD/tsconfig.json"
+PROJECT_CWD=$GITHUB_WORKSPACE
+
+# NODE_OPTIONS - Use ESM
+# See: https://github.com/TypeStrong/ts-node/issues/1007
+if [ -f "./node_modules/ts-node/esm.mjs" ]; then
+  # Silence warnings
+  NODE_NO_WARNINGS=1
+
+  # Import JSON modules
+  JSON_MODULES=''
+  [ !$GITHUB_ACTIONS ] && JSON_MODULES='--experimental-json-modules'
+
+  # Don't require imported modules to include extensions
+  SPECIFIER_RESOLUTION='--es-module-specifier-resolution node'
+
+  # Use custom ESM loader
+  LOADER="--loader $PROJECT_CWD/tools/loaders/esm.mjs"
+
+  # Specify Node options
+  NODE_OPTIONS="$JSON_MODULES $SPECIFIER_RESOLUTION $LOADER"
+fi

.env.production

@@ -1,8 +1,3 @@
 # Environment Variables - Project - `production`
-# 
-# References:
-# 
-# - https://github.com/entropitor/dotenv-cli
 
 NODE_ENV=production
-TS_NODE_PROJECT="$PWD/tsconfig.prod.json"

.env.test

@@ -1,8 +1,3 @@
 # Environment Variables - Project - `test`
-# 
-# References:
-# 
-# - https://github.com/entropitor/dotenv-cli
 
 NODE_ENV=test
-TS_NODE_PROJECT="$PWD/tsconfig.test.json"

.eslintignore

@@ -1,12 +1,15 @@
 # ESLint Ignore
 # https://eslint.org/docs/user-guide/configuring#ignoring-files-and-directories
 
-.yarn/
-coverage/
-node_modules/
+**/coverage/*
+**/node_modules/*
+
+.yarn/*
 packages/*/build/
-packages/*/cjs/
-packages/*/dist/
-packages/*/esm5/
-packages/*/esm2015/
-packages/*/types/
+packages/*/cjs/*
+packages/*/esm/*
+packages/*/types/*
+
+**/CHANGELOG.md
+
+!packages/src/types/*

.eslintrc.base.js renamed to .eslintrc.base.cjs

@@ -1,5 +1,3 @@
-const prettierConfig = require('./.prettierrc')
-
 /**
  * @file ESLint Configuration - Base
  * @see https://eslint.org/docs/user-guide/configuring
@@ -26,7 +24,7 @@ module.exports = {
       impliedStrict: true,
       jsx: true
     },
-    extraFileExtensions: ['cjs'],
+    extraFileExtensions: ['.cjs', '.mjs'],
     project: ['./packages/**/tsconfig.json', './tsconfig.json'],
     sourceType: 'module',
     tsconfigRootDir: __dirname,
@@ -87,7 +85,7 @@ module.exports = {
     ],
     'no-ex-assign': 0,
     'prefer-arrow-callback': 2,
-    'prettier/prettier': [2, prettierConfig],
+    'prettier/prettier': [2, require('./.prettierrc.cjs')],
     'sort-keys': [
       1,
       'asc',
@@ -116,16 +114,21 @@ module.exports = {
         skipWordIfMatch: [],
         skipWords: [
           'argv',
+          'basedir',
           'bundlers',
           'cjs',
           'commitlint',
+          'commonjs',
           'cmd',
           'dotenv',
           'enum',
           'esm',
-          'esm5',
+          'extensionless',
           'formatter',
+          'loadenv',
+          'mjs',
           'perf',
+          'pkgfile',
           'pnv',
           'postinstall',
           'prepack',
@@ -134,14 +137,17 @@ module.exports = {
           'stderr',
           'stdout',
           'tgz',
+          'tsc',
           'tsconfig',
           'ttsc',
           'typeof',
           'umd',
           'usr',
+          'wasm',
           'wip',
           'workspace',
-          'workspaces'
+          'workspaces',
+          'yargs'
         ],
         strings: true
       }
@@ -220,31 +226,34 @@ module.exports = {
   },
   overrides: [
     {
-      files: ['**/*.cjs', '**/*.js', '**/*.md/*.js'],
-      parser: `${__dirname}/node_modules/@babel/eslint-parser/lib/index.cjs`,
-      parserOptions: {
-        requireConfigFile: false
-      },
+      files: ['**/*.cjs'],
       rules: {
-        '@typescript-eslint/explicit-module-boundary-types': 0,
-        '@typescript-eslint/no-var-requires': 0
+        'unicorn/prefer-module': 0
       }
     },
     {
-      files: ['**/*.cjs', '*.js'],
+      files: ['**/*.cjs', '**/*.md/*.js'],
       rules: {
-        'unicorn/prefer-module': 0
+        '@typescript-eslint/no-var-requires': 0
+      }
+    },
+    {
+      files: ['**/*.cjs', '**/*.mjs'],
+      parser: `${__dirname}/node_modules/@babel/eslint-parser/lib/index.cjs`,
+      parserOptions: {
+        requireConfigFile: false
       }
     },
     {
       files: ['**/*.md'],
+      extends: ['plugin:markdownlint/recommended'],
+      parser: require.resolve('eslint-plugin-markdownlint/parser'),
       processor: 'markdown/markdown'
     },
     {
       files: ['**/*.md/*.ts'],
       parser: require.resolve('@typescript-eslint/parser')
     },
-
     {
       files: ['**/*.spec.ts'],
       env: {
@@ -273,7 +282,7 @@ module.exports = {
       }
     },
     {
-      files: ['**/__mocks__/**', '**/__tests__/**', '**/tools/**', '*.js'],
+      files: ['**/__mocks__/**', '**/__tests__/**', '**/tools/**'],
       rules: {
         'tree-shaking/no-side-effects-in-initialization': 0
       }
@@ -285,6 +294,12 @@ module.exports = {
         '@typescript-eslint/triple-slash-reference': 0,
         'unicorn/filename-case': 0
       }
+    },
+    {
+      files: ['tools/loaders/env.cjs'],
+      rules: {
+        'unicorn/no-array-reduce': 0
+      }
     }
   ],
   settings: {

.eslintrc.js renamed to .eslintrc.cjs

@@ -5,5 +5,5 @@
 
 module.exports = {
   root: true,
-  extends: ['./.eslintrc.base']
+  extends: ['./.eslintrc.base.cjs']
 }