chore: refactor project architecture

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

.codecov.yml

@@ -4,17 +4,18 @@
 ---
 codecov:
   notify:
-    after_n_builds: 3
+    after_n_builds: 2
     wait_for_ci: true
   require_ci_to_pass: true
 
 comment:
-  after_n_builds: 3
+  after_n_builds: 2
   behavior: default
-  layout: header,diff,files,components,footer
+  layout: header,diff,flags,files,components,tree,footer
   require_base: false
   require_changes: false
   require_head: true
+  show_carryforward_flags: true
   show_critical_paths: true
 
 component_management:
@@ -26,11 +27,11 @@ component_management:
     - component_id: internal
       name: internal
       paths:
-        - src/internal/*.ts
+        - src/internal/*.mts
     - component_id: lib
       name: lib
       paths:
-        - src/lib/*.ts
+        - src/lib/*.mts
 
 coverage:
   precision: 2
@@ -79,6 +80,10 @@ coverage:
         threshold: 0%
 
 flags:
+  node23:
+    carryforward: false
+    paths:
+      - src/
   node22:
     carryforward: false
     paths:
@@ -88,14 +93,15 @@ github_checks:
   annotations: true
 
 ignore:
+  - '**/*.d.mts'
   - '**/__mocks__/**'
   - '**/__tests__/**'
-  - '**/index.ts'
-  - '!src/index.ts'
-  - src/interfaces/
-  - src/internal/*.browser.ts
-  - src/types/
+  - '**/index.mts'
+  - '**/interfaces/**'
+  - '**/types/**'
+  - '!src/index.mts'
+  - src/internal/*.browser.mts
 
 profiling:
   critical_files_paths:
-    - src/lib/*.ts
+    - src/lib/*.mts

.cspell.json

@@ -13,7 +13,6 @@
   "failFast": false,
   "flagWords": [],
   "ignorePaths": [
-    "!scratch.*",
     "**/*.patch",
     "**/*.snap",
     "**/*.wasm",

.dictionary.txt

@@ -1,7 +1,6 @@
 abar
 attw
 barx
-cbar
 cefc
 codecov
 commitlintrc
@@ -20,11 +19,10 @@ ggshield
 gpgsign
 hmarr
 iife
-infile
 jchen
 kaisugi
+ksort
 lcov
-lintstagedrc
 mkbuild
 mlly
 nocheck

.dprint.jsonc

@@ -15,17 +15,17 @@
   "exec": {
     "commands": [
       {
-        "command": "node ./dprint/prettier.mjs {{file_path}}",
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/prettier.mts {{file_path}}",
         "exts": ["css", "html", "json5", "scss", "yaml", "yml"],
         "stdin": true
       },
       {
-        "command": "node ./dprint/remark.mjs {{file_path}}",
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/remark.mts {{file_path}}",
         "exts": ["md", "mdx"],
         "stdin": true
       },
       {
-        "command": "node ./dprint/shfmt.mjs {{file_path}}",
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/shfmt.mts {{file_path}}",
         "exts": ["sh", "zsh"],
         "fileNames": [
           ".editorconfig",

.env.zsh

@@ -6,6 +6,7 @@
 # - https://homebrew-file.readthedocs.io/en/latest/usage.html
 
 [ -f $PWD/.env.repo ] && source $PWD/.env.repo
+[ -f $PWD/.env.vars ] && source $PWD/.env.vars
 HOMEBREW_BREWFILE=./Brewfile
 NODE_NO_WARNINGS=1
 NODE_OPTIONS='--experimental-strip-types --experimental-transform-types'

.github/infrastructure.yml

@@ -33,10 +33,9 @@ branches:
           - context: lint
           - context: spelling
           - context: test (22)
-          - context: typescript (5.0.4)
-          - context: typescript (5.4.5)
-          - context: typescript (5.5.4)
-          - context: typescript (5.6.2)
+          - context: test (23)
+          - context: typescript (5.6.3)
+          - context: typescript (5.7.1-rc)
         strict: true
       restrictions: null
 environments:

.github/workflows/ci.yml

@@ -58,8 +58,10 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       cache-key: ${{ steps.cache-key.outputs.result }}
-      version: ${{ steps.version.outputs.result }}
+      test-files: ${{ steps.test-files.outputs.files_exists }}
+      typecheck-files: ${{ steps.typecheck-files.outputs.files_exists }}
       version-typescript: ${{ steps.version-typescript.outputs.result }}
+      version: ${{ steps.version.outputs.result }}
     steps:
       - id: debug
         name: Print environment variables and event payload
@@ -97,6 +99,16 @@ jobs:
       - id: version-typescript
         name: Get TypeScript version
         run: echo "result=$(jq .devDependencies.typescript package.json -r)" >>$GITHUB_OUTPUT
+      - id: test-files
+        name: Check for test files
+        uses: andstor/file-existence-action@v3.0.0
+        with:
+          files: '**/__tests__/*.spec.+(mts|tsx)'
+      - id: typecheck-files
+        name: Check for typecheck files
+        uses: andstor/file-existence-action@v3.0.0
+        with:
+          files: '**/__tests__/*.spec-d.mts'
   commitlint:
     needs: preflight
     runs-on: ubuntu-latest
@@ -245,50 +257,47 @@ jobs:
       matrix:
         typescript-version:
           - ${{ needs.preflight.outputs.version-typescript }}
-          - 5.5.4
-          - 5.4.5
-          - 5.0.4
+          - 5.6.3
+    env:
+      TYPESCRIPT_VERSION: ${{ matrix.typescript-version }}
+      VITEST_REPORT: ./.vitest-reports/typecheck.blob.json
+    if: ${{ fromJson(needs.preflight.outputs.typecheck-files) }}
     steps:
       - id: checkout
         name: Checkout ${{ env.REF_NAME }}
         uses: actions/checkout@v4.2.2
         with:
           persist-credentials: false
           ref: ${{ env.REF }}
-      - id: test-files-check
-        name: Check for typecheck files
-        uses: andstor/file-existence-action@v3.0.0
-        with:
-          files: '**/__tests__/*.spec-d.ts'
       - id: node
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Setup Node.js
         uses: actions/setup-node@v4.1.0
         with:
           cache: yarn
           cache-dependency-path: yarn.lock
           node-version-file: .nvmrc
       - id: cache
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Restore dependencies cache
         uses: actions/cache@v4.1.2
         with:
           key: ${{ needs.preflight.outputs.cache-key }}
           path: ${{ env.CACHE_PATH }}
       - id: typescript
-        if: steps.test-files-check.outputs.files_exists == 'true'
-        name: Install typescript@${{ matrix.typescript-version }}
-        run: yarn add -D typescript@${{ matrix.typescript-version }}
+        name: Install typescript@${{ env.TYPESCRIPT_VERSION }}
+        run: yarn add -D typescript@${{ env.TYPESCRIPT_VERSION }}
       - id: print-typescript-version
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Print TypeScript version
         run: jq .devDependencies.typescript package.json -r
       - id: typecheck
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Run typecheck
-        env:
-          NODE_OPTIONS: --experimental-strip-types --experimental-transform-types
         run: yarn typecheck
+      - id: report
+        name: Upload report
+        uses: actions/upload-artifact@v4.4.3
+        with:
+          name: |
+            ${{ format('typecheck-{0}-{1}-{2}.blob.json', env.TYPESCRIPT_VERSION, github.event.repository.name, env.SHA) }}
+          path: ${{ env.VITEST_REPORT }}
   test:
     needs:
       - commitlint
@@ -299,25 +308,22 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
+          - 23
           - 22
     env:
       COVERAGE_SUMMARY: ./coverage/coverage-summary.json
+      NODE_VERSION: ${{ matrix.node-version }}
       PCT: .total.branches.pct + .total.functions.pct + .total.lines.pct + .total.statements.pct
       VITEST_REPORT: ./.vitest-reports/test.blob.json
+    if: ${{ fromJson(needs.preflight.outputs.test-files) }}
     steps:
       - id: checkout
         name: Checkout ${{ env.REF_NAME }}
         uses: actions/checkout@v4.2.2
         with:
           persist-credentials: false
           ref: ${{ env.REF }}
-      - id: test-files-check
-        name: Check for test files
-        uses: andstor/file-existence-action@v3.0.0
-        with:
-          files: '**/__tests__/*.spec.+(ts|tsx)'
       - id: node
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Setup Node.js v${{ matrix.node-version }}
         uses: actions/setup-node@v4.1.0
         with:
@@ -326,37 +332,31 @@ jobs:
           check-latest: true
           node-version: ${{ matrix.node-version }}
       - id: cache
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Restore dependencies cache
         uses: actions/cache@v4.1.2
         with:
           key: ${{ needs.preflight.outputs.cache-key }}
           path: ${{ env.CACHE_PATH }}
       - id: test
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Run tests
-        env:
-          NODE_OPTIONS: --experimental-strip-types --experimental-transform-types
         run: |
           yarn test:cov --coverage.thresholds.100=false \
           && echo "coverage=$(jq '${{ env.PCT }}' ${{ env.COVERAGE_SUMMARY }} -r)" >>$GITHUB_OUTPUT
       - id: report
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Upload report
         uses: actions/upload-artifact@v4.4.3
         with:
-          name: ${{ format('vitest-report-{0}-{1}.json', github.event.repository.name, env.SHA) }}
+          name: |
+            ${{ format('test-{0}-{1}-{2}.blob.json', env.NODE_VERSION, github.event.repository.name, env.SHA) }}
           path: ${{ env.VITEST_REPORT }}
       - id: coverage-summary
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Upload coverage summary
         uses: actions/upload-artifact@v4.4.3
         with:
           name: |
-            ${{ format('coverage-summary-{0}-{1}.json', github.event.repository.name, env.SHA) }}
+            ${{ format('coverage-summary-{0}-{1}-{2}.json', env.NODE_VERSION, github.event.repository.name, env.SHA) }}
           path: ${{ env.COVERAGE_SUMMARY }}
       - id: codecov
-        if: steps.test-files-check.outputs.files_exists == 'true'
         name: Upload coverage report to Codecov
         uses: codecov/codecov-action@v4.6.0
         env:
@@ -377,12 +377,8 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           verbose: true
       - id: coverage-failure
-        if: |
-          steps.test-files-check.outputs.files_exists == 'true'
-          && ${{ toJson(steps.test.outputs.coverage) }} != 400
+        if: ${{ toJson(steps.test.outputs.coverage) != 400 }}
         name: Coverage threshold failure (${{ steps.test.outputs.coverage }})
-        env:
-          NODE_OPTIONS: --experimental-strip-types --experimental-transform-types
         run: yarn test:cov:reports
   build:
     needs:
@@ -443,6 +439,8 @@ jobs:
       - test
       - typescript
     runs-on: ubuntu-latest
+    env:
+      NODE_NO_WARNINGS: 1
     steps:
       - id: checkout
         name: Checkout ${{ env.REF_NAME }}

.github/workflows/typescript-canary.yml

@@ -73,8 +73,6 @@ jobs:
         run: yarn build
       - id: typecheck
         name: Run typecheck
-        env:
-          NODE_OPTIONS: --experimental-strip-types --experimental-transform-types
         run: yarn typecheck
       - id: typecheck-build
         name: Run typecheck-build