feat: prototype new custom rust zlib implementation

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

.commitlintrc.json

@@ -5,8 +5,9 @@
 		"type-enum": [
 			2,
 			"always",
-			["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types", "typings"]
+			["chore", "build", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test", "types"]
 		],
-		"scope-case": [0]
+		"scope-case": [0],
+		"subject-exclamation-mark": [0]
 	}
 }

.github/.kodiak.toml

@@ -2,7 +2,7 @@ version = 1
 
 [merge]
 require_automerge_label = false
-blocking_labels = ['blocked', 'in review']
+blocking_labels = ['blocked', 'in review', 'semver:major']
 method = 'squash'
 
 [merge.message]

.github/CODEOWNERS

@@ -1,13 +1,18 @@
 # Learn how to add code owners here:
-# https://help.github.com/en/articles/about-code-owners
+# https://help.github.com/articles/about-code-owners
 
 * @iCrawl
 
+package.json @discordjs/core
+pnpm-lock.yaml @discordjs/core
+
 /apps/guide/ @discordjs/website @discordjs/guide
 /apps/guide/src/content/ @discordjs/guide
 /apps/website/ @discordjs/website
 
 /packages/actions/ @discordjs/actions
+/packages/api-extractor/ @discordjs/api-extractor-utils
+/packages/api-extractor-model/ @discordjs/api-extractor-utils
 /packages/api-extractor-utils/ @discordjs/api-extractor-utils
 /packages/brokers/ @discordjs/brokers
 /packages/builders/ @discordjs/builders

.github/COMMIT_CONVENTION.md

@@ -7,7 +7,7 @@
 Messages must be matched by the following regex:
 
 ```js
-/^(revert: )?(feat|fix|docs|style|refactor|perf|test|workflow|build|ci|chore|types|wip)(\(.+\))?: .{1,72}/;
+/^(revert: )?(feat|fix|docs|style|refactor|perf|test|build|ci|chore|types)(\(.+\))?!?: .{1,72}/;
 ```
 
 #### Examples
@@ -55,6 +55,7 @@ A commit message consists of a **header**, **body** and **footer**. The header h
 ```
 
 The **header** is mandatory and the **scope** of the header is optional.
+If the commit contains **Breaking Changes**, a `!` can be added before the `:` as an indicator.
 
 ### Revert
 

.github/ISSUE_TEMPLATE/01-package_bug_report.yml

@@ -62,7 +62,7 @@ body:
       description: List necessary versions here. This includes your package version, runtime version, operating system etc.
       placeholder: |
         - discord.js 14.12.1 (`npm ls discord.js` or another package)
-        - Node.js 16.11.0 (`node --version`)
+        - Node.js 22.12.0 (`node --version`)
         - TypeScript 5.1.6 (`npm ls typescript` if you use it)
         - macOS Ventura 13.3.1
     validations:
@@ -107,7 +107,7 @@ body:
         - Guilds
         - GuildMembers
         - GuildModeration
-        - GuildEmojisAndStickers
+        - GuildExpressions
         - GuildIntegrations
         - GuildWebhooks
         - GuildInvites

.github/labeler.yml

@@ -1,60 +1,100 @@
 apps:guide:
-  - apps/guide/*
-  - apps/guide/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - apps/guide/*
+          - apps/guide/**/*
 apps:website:
-  - apps/website/*
-  - apps/website/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - apps/website/*
+          - apps/website/**/*
 packages:api-extractor:
-  - packages/api-extractor/*
-  - packages/api-extractor/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/api-extractor/*
+          - packages/api-extractor/**/*
 packages:api-extractor-model:
-  - packages/api-extractor-model/*
-  - packages/api-extractor-model/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/api-extractor-model/*
+          - packages/api-extractor-model/**/*
 packages:brokers:
-  - packages/brokers/*
-  - packages/brokers/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/brokers/*
+          - packages/brokers/**/*
 packages:builders:
-  - packages/builders/*
-  - packages/builders/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/builders/*
+          - packages/builders/**/*
 packages:collection:
-  - packages/collection/*
-  - packages/collection/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/collection/*
+          - packages/collection/**/*
 packages:core:
-  - packages/core/*
-  - packages/core/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/core/*
+          - packages/core/**/*
 packages:create-discord-bot:
-  - packages/create-discord-bot/*
-  - packages/create-discord-bot/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/create-discord-bot/*
+          - packages/create-discord-bot/**/*
 packages:discord.js:
-  - packages/discord.js/*
-  - packages/discord.js/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/discord.js/*
+          - packages/discord.js/**/*
 packages:docgen:
-  - packages/docgen/*
-  - packages/docgen/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/docgen/*
+          - packages/docgen/**/*
 packages:formatters:
-  - packages/formatters/*
-  - packages/formatters/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/formatters/*
+          - packages/formatters/**/*
 packages:next:
-  - packages/next/*
-  - packages/next/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/next/*
+          - packages/next/**/*
 packages:proxy:
-  - packages/proxy/*
-  - packages/proxy/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/proxy/*
+          - packages/proxy/**/*
 packages:proxy-container:
-  - packages/proxy-container/*
-  - packages/proxy-container/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/proxy-container/*
+          - packages/proxy-container/**/*
 packages:rest:
-  - packages/rest/*
-  - packages/rest/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/rest/*
+          - packages/rest/**/*
 packages:ui:
-  - packages/ui/*
-  - packages/ui/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/ui/*
+          - packages/ui/**/*
 packages:util:
-  - packages/util/*
-  - packages/util/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/util/*
+          - packages/util/**/*
 packages:voice:
-  - packages/voice/*
-  - packages/voice/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/voice/*
+          - packages/voice/**/*
 packages:ws:
-  - packages/ws/*
-  - packages/ws/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - packages/ws/*
+          - packages/ws/**/*

.github/labels.yml

@@ -10,6 +10,8 @@
   color: 7ef7ef
 - name: backport
   color: 88aabb
+- name: backport-candidate
+  color: 0075ca
 - name: blocked
   color: fc1423
 - name: bug
@@ -38,8 +40,6 @@
   color: 80c042
 - name: good first issue
   color: 7057ff
-- name: has PR
-  color: 4b1f8e
 - name: help wanted
   color: '008672'
 - name: in progress

.github/workflows/cleanup-cache.yml

@@ -1,4 +1,4 @@
-# https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows#force-deleting-cache-entries
+# https://docs.github.com/actions/using-workflows/caching-dependencies-to-speed-up-workflows#force-deleting-cache-entries
 name: Cleanup caches
 on:
   pull_request:
@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Cleanup caches
         run: |

.github/workflows/deploy-website.yml

@@ -14,12 +14,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install Node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/deprecate-version.yml

@@ -34,12 +34,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install Node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/documentation.yml

@@ -36,14 +36,14 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ inputs.ref || '' }}
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
@@ -53,15 +53,18 @@ jobs:
 
       - name: Checkout main repository
         if: ${{ inputs.ref && inputs.ref != 'main' }}
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           path: 'main'
 
       - name: Build main
         if: ${{ inputs.ref && inputs.ref != 'main' }}
         shell: bash
+        env:
+          COREPACK_ENABLE_STRICT: 0
         run: |
           cd main
+          pnpm self-update 10
           pnpm install --frozen-lockfile --prefer-offline --loglevel error
           pnpm run build
           cd ..
@@ -75,7 +78,7 @@ jobs:
 
       - name: Apply tag to api-extractor config
         if: ${{ env.REF_TYPE == 'tag' && !inputs.ref }}
-        run: sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ steps.extract-tag.outputs.semver }}!' "packages/${{ steps.extract-tag.outputs.package}}/"
+        run: sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ github.ref_name }}!' "packages/${{ steps.extract-tag.outputs.package}}/api-extractor.json"
 
       - name: Build docs
         run: pnpm run docs
@@ -93,7 +96,7 @@ jobs:
           done
 
       - name: Checkout docs repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: 'discordjs/docs'
           token: ${{ secrets.DJS_DOCS }}
@@ -103,7 +106,15 @@ jobs:
         if: ${{ env.REF_TYPE == 'tag' && (!inputs.ref || inputs.ref == 'main') }}
         env:
           DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./packages/actions/src/uploadDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -113,7 +124,15 @@ jobs:
         if: ${{ env.REF_TYPE == 'tag' && inputs.ref && inputs.ref != 'main' }}
         env:
           DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./main/packages/actions/src/uploadDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -123,6 +142,10 @@ jobs:
         if: ${{ env.REF_TYPE == 'tag' && (!inputs.ref || inputs.ref == 'main') }}
         env:
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./packages/actions/src/uploadSplitDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -132,6 +155,10 @@ jobs:
         if: ${{ env.REF_TYPE == 'tag' && inputs.ref && inputs.ref != 'main' }}
         env:
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./main/packages/actions/src/uploadSplitDocumentation
         with:
           package: ${{ steps.extract-tag.outputs.package }}
@@ -155,26 +182,50 @@ jobs:
         if: ${{ env.REF_TYPE == 'branch' && (!inputs.ref || inputs.ref == 'main') }}
         env:
           DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./packages/actions/src/uploadDocumentation
 
       - name: Upload documentation to database
         if: ${{ env.REF_TYPE == 'branch' && inputs.ref && inputs.ref != 'main' }}
         env:
           DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }}
+          CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }}
+          CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
+          CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }}
         uses: ./main/packages/actions/src/uploadDocumentation
 
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'branch' && (!inputs.ref || inputs.ref == 'main') }}
         env:
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./packages/actions/src/uploadSplitDocumentation
 
       - name: Upload split documentation to blob storage
         if: ${{ env.REF_TYPE == 'branch' && inputs.ref && inputs.ref != 'main' }}
         env:
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+          CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }}
+          CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }}
+          CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }}
+          CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }}
         uses: ./main/packages/actions/src/uploadSplitDocumentation
 
       - name: Move docs to correct directory
@@ -211,12 +262,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache

.github/workflows/issue-triage.yml

@@ -6,7 +6,7 @@ jobs:
   issue-triage:
     runs-on: ubuntu-latest
     steps:
-      - uses: github/issue-labeler@v3.2
+      - uses: github/issue-labeler@v3.4
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           configuration-path: .github/issue-labeler.yml

.github/workflows/label-sync.yml

@@ -15,9 +15,9 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Label sync
-        uses: crazy-max/ghaction-github-labeler@v4
+        uses: crazy-max/ghaction-github-labeler@v5
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/lock.yml

@@ -11,7 +11,7 @@ jobs:
     permissions:
       issues: write
     steps:
-      - uses: dessant/lock-threads@v4
+      - uses: dessant/lock-threads@v5
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           issue-inactive-days: 365

.github/workflows/pr-triage.yml

@@ -1,13 +1,35 @@
 name: 'PR Triage'
 on:
   pull_request_target:
+    types:
+      - opened
+      - edited
+      - reopened
+      - synchronize
 jobs:
-  pr-triage:
-    name: PR Triage
+  label:
+    name: Label
+    if: github.event.action != 'edited'
     runs-on: ubuntu-latest
     steps:
-      - name: Automatically label PR
-        uses: actions/labeler@v4
+      - name: Label pull request
+        uses: actions/labeler@v5
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           sync-labels: true
+  validate-title:
+    name: Validate title
+    if: github.event.action != 'synchronize'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate pull request title
+        env:
+          TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          REGEX="^(revert: )?(feat|fix|docs|style|refactor|perf|test|build|ci|chore|types)(\\(.+\\))?!?: .{1,72}$"
+
+          echo "Title: \"$TITLE\""
+
+          if [[ ! "$TITLE" =~ $REGEX ]]; then
+            exit 1
+          fi

.github/workflows/publish-dev-docker.yml

@@ -10,18 +10,18 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to DockerHub
         run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin

.github/workflows/publish-dev.yml

@@ -43,14 +43,14 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
           registry-url: https://registry.npmjs.org/
 
       - name: Check the current development version
@@ -72,7 +72,7 @@ jobs:
       - name: Publish package
         if: steps.release-check.outputs.release == '1'
         run: |
-          pnpm --filter=${{ matrix.package }} run release --preid "dev.$(date +%s)-$(git rev-parse --short HEAD)"
+          pnpm --filter=${{ matrix.package }} run release --preid "dev.$(date +%s)-$(git rev-parse --short HEAD)" --skip-changelog
           pnpm --filter=${{ matrix.package }} publish --provenance --no-git-checks --tag dev || true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

.github/workflows/publish-docker.yml

@@ -7,18 +7,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to DockerHub
         run: echo ${{ secrets.DOCKER_ACCESS_TOKEN }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin

.github/workflows/publish-release.yml

@@ -14,12 +14,12 @@ jobs:
     if: github.repository_owner == 'discordjs'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
           registry-url: https://registry.npmjs.org/
 
       - name: Install dependencies

.github/workflows/tests.yml

@@ -15,14 +15,14 @@ jobs:
       TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install node.js v18
-        uses: actions/setup-node@v3
+      - name: Install Node.js v22
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
       - name: Install dependencies
         uses: ./packages/actions/src/pnpmCache
@@ -62,3 +62,5 @@ jobs:
       - name: Upload Coverage
         if: github.repository_owner == 'discordjs'
         uses: ./packages/actions/src/uploadCoverage
+        with:
+          codecov_token: ${{ secrets.CODECOV_TOKEN }}

.npmrc

@@ -1,6 +0,0 @@
-auto-install-peers=false
-resolution-mode=highest
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-public-hoist-pattern[]=*@rushstack/node-core-library*
-public-hoist-pattern[]=*jju*

.vscode/settings.json

@@ -1,32 +1,54 @@
 {
 	"eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact"],
-	"eslint.experimental.useFlatConfig": true,
-	"eslint.workingDirectories": [
-		{ "directory": "${workspaceFolder}" },
-		{ "pattern": "./apps/*/" },
-		{ "pattern": "./packages/*/" }
-	],
+	"eslint.useESLintClass": true,
+	"eslint.useFlatConfig": true,
 	"editor.defaultFormatter": "esbenp.prettier-vscode",
 	"editor.formatOnSave": true,
 	"editor.codeActionsOnSave": {
 		"source.organizeImports": "never",
-		"source.fixAll.eslint": "explicit",
-		"source.fixAll": "explicit"
+		"source.fixAll.eslint": "always",
+		"source.fixAll": "always"
 	},
 	"editor.trimAutoWhitespace": false,
 	"files.associations": {
-		"api-extractor.json": "jsonc",
-		"api-extractor-docs.json": "jsonc",
 		"tsconfig.json": "jsonc",
-		"tsconfig.eslint.json": "jsonc",
-		"tsconfig.docs.json": "jsonc"
+		"tsconfig.eslint.json": "jsonc"
 	},
 	"files.insertFinalNewline": true,
 	"files.eol": "\n",
+	"search.exclude": {
+		"**/.yarn": true,
+		"**/.next": true,
+		"**/dist": true,
+		"**/coverage": true,
+		"**/test-results": true
+	},
+	"search.followSymlinks": false,
+	"search.useParentIgnoreFiles": true,
+	"files.watcherExclude": {
+		"**/.next/*/**": true,
+		"**/.yarn/*/**": true,
+		"**/coverage/*/**": true,
+		"**/dist/*/**": true,
+		"**/test-results/*/**": true
+	},
+	"unocss.disable": true,
 	"npm.packageManager": "pnpm",
 	"typescript.tsdk": "node_modules/typescript/lib",
 	"typescript.enablePromptUseWorkspaceTsdk": true,
-	"unocss.disable": true,
+	"tailwindCSS.experimental.classRegex": [
+		["cva\\(((?:[^()]|\\([^()]*\\))*)\\)", "[\"'`]?([^\"'`]+)[\"'`]?"],
+		["cx\\(((?:[^()]|\\([^()]*\\))*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"],
+		["class:\\s*?[\"'`]([^\"'`]*).*?,"]
+	],
+	"workbench.editor.customLabels.patterns": {
+		"**/app/**/page.tsx": "${dirname} (${filename}.${extname}) - Page",
+		"**/app/**/layout.tsx": "${dirname} (${filename}.${extname}) - Layout",
+		"**/app/**/template.tsx": "${dirname} (${filename}.${extname}) - Template",
+		"**/app/**/error.tsx": "${dirname} (${filename}.${extname}) - Error",
+		"**/app/**/not-found.tsx": "${dirname} (${filename}.${extname}) - Not Found",
+		"**/components/**/page.tsx": "${dirname} (${filename}.${extname}) - Component"
+	},
 	"deno.enable": false,
 	"deno.enablePaths": ["./packages/create-discord-bot/template/Deno"],
 	"deno.lint": false,

README.md

@@ -9,7 +9,9 @@
 		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/v/discord.js.svg?maxAge=3600" alt="npm version" /></a>
 		<a href="https://www.npmjs.com/package/discord.js"><img src="https://img.shields.io/npm/dt/discord.js.svg?maxAge=3600" alt="npm downloads" /></a>
 		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Tests status" /></a>
-		<a href="https://codecov.io/gh/discordjs/discord.js" ><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2" alt="Code coverage" /></a>
+		<a href="https://github.com/discordjs/discord.js/commits/main"><img src="https://img.shields.io/github/last-commit/discordjs/discord.js.svg?logo=github&logoColor=ffffff" alt="Last commit." /></a>
+		<a href="https://github.com/discordjs/discord.js/graphs/contributors"><img src="https://img.shields.io/github/contributors/discordjs/discord.js.svg?maxAge=3600&logo=github&logoColor=fff&color=00c7be" alt="contributors" /></a>
+		<a href="https://codecov.io/gh/discordjs/discord.js"><img src="https://codecov.io/gh/discordjs/discord.js/branch/main/graph/badge.svg?precision=2" alt="Code coverage" /></a>
 	</p>
 	<p>
 		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>

apps/guide/.env.development

@@ -1 +0,0 @@
-METADATA_BASE_URL=http://localhost:3000

apps/guide/.prettierignore

@@ -1,7 +0,0 @@
-.contentlayer
-.next
-.turbo
-.vscode
-coverage
-src/styles/unocss.css
-next-env.d.ts

apps/guide/README.md

@@ -1,52 +0,0 @@
-<div align="center">
-	<br />
-	<p>
-		<a href="https://discord.js.org"><img src="https://discord.js.org/static/logo.svg" width="546" alt="discord.js" /></a>
-	</p>
-	<br />
-	<p>
-		<a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
-		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Build status" /></a>
-	</p>
-	<p>
-		<a href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-vercel.svg" alt="Vercel" /></a>
-		<a href="https://www.cloudflare.com"><img src="https://raw.githubusercontent.com/discordjs/discord.js/main/.github/powered-by-workers.png" alt="Cloudflare Workers" height="44" /></a>
-	</p>
-</div>
-
-## About
-
-The official guide for discord.js, made to help you get started easily with the library.
-
-## Links
-
-- [Website][website] ([source][website-source])
-- [Documentation][documentation]
-- [Guide][guide] ([source][guide-source])
-  Also see the v13 to v14 [Update Guide][guide-update], which includes updated and removed items from the library.
-- [discord.js Discord server][discord]
-- [Discord API Discord server][discord-api]
-- [GitHub][source]
-- [Related libraries][related-libs]
-
-## Contributing
-
-Before creating an issue, please ensure that it hasn't already been reported/suggested, and double-check the
-[documentation][documentation].  
-See [the contribution guide][contributing] if you'd like to submit a PR.
-
-## Help
-
-If you don't understand something in the documentation, you are experiencing problems, or you just need a gentle nudge in the right direction, please don't hesitate to join our official [discord.js Server][discord].
-
-[website]: https://discord.js.org
-[website-source]: https://github.com/discordjs/discord.js/tree/main/apps/website
-[documentation]: https://discord.js.org/docs
-[guide]: https://discordjs.guide/
-[guide-source]: https://github.com/discordjs/guide
-[guide-update]: https://discordjs.guide/additional-info/changes-in-v14.html
-[discord]: https://discord.gg/djs
-[discord-api]: https://discord.gg/discord-api
-[source]: https://github.com/discordjs/discord.js/tree/main/apps/guide
-[related-libs]: https://discord.com/developers/docs/topics/community-resources#libraries
-[contributing]: https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md

apps/guide/contentlayer.config.ts

@@ -1,94 +0,0 @@
-import { remarkCodeHike } from '@code-hike/mdx';
-import { defineDocumentType, makeSource } from 'contentlayer/source-files';
-import { type Node, toString } from 'hast-util-to-string';
-import { h } from 'hastscript';
-import { escape } from 'html-escaper';
-import rehypeAutolinkHeadings from 'rehype-autolink-headings';
-import rehypeSlug from 'rehype-slug';
-import remarkGfm from 'remark-gfm';
-import codeHikeThemeDarkPlus from './src/styles/code-hike-theme-dark-plus.json';
-
-export const Content = defineDocumentType(() => ({
-	name: 'Content',
-	filePathPattern: `**/*.mdx`,
-	contentType: 'mdx',
-	fields: {
-		title: {
-			type: 'string',
-			required: true,
-		},
-		category: {
-			type: 'string',
-			required: true,
-		},
-	},
-	computedFields: {
-		slug: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => doc._raw.flattenedPath.replace(/\d+-/g, ''),
-		},
-		url: {
-			type: 'string',
-			// eslint-disable-next-line unicorn/prefer-string-replace-all
-			resolve: (doc) => `/guide/${doc._raw.flattenedPath.replace(/\d+-/g, '')}`,
-		},
-	},
-}));
-
-const LinkIcon = h(
-	'svg',
-	{
-		width: '1.25rem',
-		height: '1.25rem',
-		viewBox: '0 0 24 24',
-		fill: 'none',
-		stroke: 'currentColor',
-		strokeWidth: '2',
-		strokeLinecap: 'round',
-		strokeLinejoin: 'round',
-	},
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71',
-	}),
-	h('path', {
-		// eslint-disable-next-line id-length
-		d: 'M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71',
-	}),
-);
-
-const createSROnlyLabel = (text: any) => {
-	return h('span', { class: 'sr-only' }, `Section titled ${escape(text)}`);
-};
-
-export default makeSource({
-	contentDirPath: 'src/content',
-	documentTypes: [Content],
-	mdx: {
-		remarkPlugins: [remarkGfm, [remarkCodeHike, { theme: codeHikeThemeDarkPlus, lineNumbers: true }]],
-		rehypePlugins: [
-			rehypeSlug,
-			[
-				rehypeAutolinkHeadings,
-				{
-					properties: {
-						class:
-							'relative inline-flex place-items-center place-content-center outline-none text-black dark:text-white pr-2 -ml-8 opacity-0 group-hover:opacity-100',
-					},
-					behavior: 'prepend',
-					content: (heading: Node) => [
-						h(
-							`span.anchor-icon`,
-							{
-								ariaHidden: 'true',
-							},
-							LinkIcon,
-						),
-						createSROnlyLabel(toString(heading)),
-					],
-				},
-			],
-		],
-	},
-});

apps/guide/next-env.d.ts

@@ -1,5 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/basic-features/typescript for more information.

apps/guide/next.config.js

@@ -1,25 +0,0 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-/* eslint-disable @typescript-eslint/no-require-imports */
-// import bundleAnalyzer from '@next/bundle-analyzer';
-// import { withContentlayer } from 'next-contentlayer';
-const bundleAnalyzer = require('@next/bundle-analyzer');
-const { withContentlayer } = require('next-contentlayer');
-
-const withBundleAnalyzer = bundleAnalyzer({
-	enabled: process.env.ANALYZE === 'true',
-});
-
-module.exports = withBundleAnalyzer(
-	withContentlayer({
-		reactStrictMode: true,
-		experimental: {
-			typedRoutes: true,
-		},
-		images: {
-			dangerouslyAllowSVG: true,
-			contentDispositionType: 'attachment',
-			contentSecurityPolicy: "default-src 'self'; frame-src 'none'; sandbox;",
-		},
-		poweredByHeader: false,
-	}),
-);

apps/guide/package.json

@@ -1,100 +0,0 @@
-{
-	"$schema": "https://json.schemastore.org/package.json",
-	"name": "@discordjs/guide",
-	"version": "0.1.0",
-	"description": "Imagine a guide... that explores the many possibilities for your discord.js bot",
-	"private": true,
-	"scripts": {
-		"test": "vitest run",
-		"build:check": "tsc --noEmit",
-		"build:local": "pnpm run build:prod",
-		"build:prod": "next build",
-		"build:analyze": "cross-env ANALYZE=true pnpm run build:prod",
-		"preview": "next start",
-		"dev": "next dev",
-		"generate:contentlayer": "contentlayer build",
-		"lint": "pnpm run build:check && prettier --check . && cross-env TIMING=1 eslint --format=pretty src",
-		"format": "pnpm run build:check && prettier --write . && cross-env TIMING=1 eslint --fix --format=pretty src",
-		"fmt": "pnpm run format"
-	},
-	"type": "commonjs",
-	"directories": {
-		"lib": "src"
-	},
-	"contributors": [
-		"Crawl <icrawltogo@gmail.com>"
-	],
-	"license": "Apache-2.0",
-	"keywords": [
-		"discord",
-		"api",
-		"bot",
-		"client",
-		"node",
-		"discordapp",
-		"discordjs"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/discordjs/discord.js.git",
-		"directory": "apps/guide"
-	},
-	"bugs": {
-		"url": "https://github.com/discordjs/discord.js/issues"
-	},
-	"homepage": "https://discord.js.org",
-	"funding": "https://github.com/discordjs/discord.js?sponsor",
-	"dependencies": {
-		"@code-hike/mdx": "^0.9.0",
-		"@discordjs/ui": "workspace:^",
-		"@react-icons/all-files": "^4.1.0",
-		"@vercel/analytics": "^1.2.2",
-		"@vercel/edge-config": "^1.1.0",
-		"@vercel/og": "^0.6.2",
-		"ariakit": "2.0.0-next.44",
-		"cmdk": "^1.0.0",
-		"contentlayer": "^0.3.4",
-		"next": "14.2.1",
-		"next-contentlayer": "^0.3.4",
-		"next-themes": "^0.3.0",
-		"react": "^18.2.0",
-		"react-custom-scrollbars-2": "^4.5.0",
-		"react-dom": "^18.2.0",
-		"rehype-autolink-headings": "^6.1.1",
-		"rehype-slug": "^5.1.0",
-		"remark-gfm": "^3.0.1",
-		"sharp": "^0.33.3"
-	},
-	"devDependencies": {
-		"@next/bundle-analyzer": "14.2.1",
-		"@testing-library/react": "^15.0.2",
-		"@testing-library/user-event": "^14.5.2",
-		"@types/html-escaper": "^3.0.2",
-		"@types/node": "18.18.8",
-		"@types/react": "^18.2.79",
-		"@types/react-dom": "^18.2.25",
-		"@unocss/eslint-plugin": "^0.59.3",
-		"@unocss/postcss": "^0.58.5",
-		"@unocss/reset": "^0.59.3",
-		"@vitejs/plugin-react": "^4.2.1",
-		"@vitest/coverage-v8": "^1.5.0",
-		"cross-env": "^7.0.3",
-		"eslint": "^8.57.0",
-		"eslint-config-neon": "^0.1.62",
-		"eslint-formatter-pretty": "^6.0.1",
-		"happy-dom": "^14.7.1",
-		"hast-util-to-string": "^2.0.0",
-		"hastscript": "^8.0.0",
-		"html-escaper": "^3.0.3",
-		"postcss": "^8.4.38",
-		"prettier": "^3.2.5",
-		"turbo": "^1.13.2",
-		"typescript": "^5.4.5",
-		"unocss": "^0.59.3",
-		"vercel": "^34.0.0",
-		"vitest": "^1.5.0"
-	},
-	"engines": {
-		"node": ">=18"
-	}
-}

apps/guide/postcss.config.cjs

@@ -1,5 +0,0 @@
-module.exports = {
-	plugins: {
-		'@unocss/postcss': {},
-	},
-};

apps/guide/public/browserconfig.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<browserconfig>
-    <msapplication>
-        <tile>
-            <square70x70logo src="/mstile-70x70.png"/>
-            <square150x150logo src="/mstile-150x150.png"/>
-            <square310x310logo src="/mstile-310x310.png"/>
-            <wide310x150logo src="/mstile-310x150.png"/>
-            <TileColor>#090a16</TileColor>
-        </tile>
-    </msapplication>
-</browserconfig>

apps/guide/public/safari-pinned-tab.svg

@@ -1,32 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
- "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
-<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
- width="400.000000pt" height="400.000000pt" viewBox="0 0 400.000000 400.000000"
- preserveAspectRatio="xMidYMid meet">
-<metadata>
-Created by potrace 1.14, written by Peter Selinger 2001-2017
-</metadata>
-<g transform="translate(0.000000,400.000000) scale(0.100000,-0.100000)"
-fill="#000000" stroke="none">
-<path d="M0 2000 l0 -2000 2000 0 2000 0 0 2000 0 2000 -2000 0 -2000 0 0
--2000z m1305 795 c219 -47 373 -197 421 -411 24 -109 16 -315 -16 -399 l-23
--61 -59 -11 c-110 -21 -182 -92 -203 -202 -11 -56 -11 -56 -68 -79 -76 -30
--201 -42 -464 -42 l-223 0 0 610 0 610 283 0 c210 0 300 -4 352 -15z m890
--585 c0 -543 -2 -601 -18 -659 -56 -198 -190 -334 -365 -370 -176 -37 -349 5
--471 115 -48 44 -111 134 -111 161 0 6 19 14 43 18 23 4 73 18 110 32 l68 24
-50 -45 c56 -50 98 -66 175 -66 100 0 207 81 234 178 6 23 10 251 10 625 l0
-588 138 -3 137 -3 0 -595z m930 570 c93 -29 197 -84 252 -134 l44 -41 -61 -75
-c-34 -41 -67 -81 -74 -88 -10 -10 -25 -4 -78 32 -95 63 -154 81 -268 81 -79 0
--103 -4 -142 -23 -62 -31 -90 -71 -96 -137 -8 -94 28 -137 168 -202 157 -73
-172 -80 240 -108 236 -97 341 -215 356 -400 16 -193 -82 -363 -258 -449 -91
--45 -187 -66 -303 -66 -191 0 -390 74 -524 195 l-40 37 80 93 80 94 73 -53
-c168 -121 353 -155 491 -92 72 33 108 82 113 155 9 122 -37 162 -323 286 -258
-111 -350 179 -407 300 -69 148 -37 343 75 463 61 65 195 133 300 152 79 14
-222 4 302 -20z m-1367 -977 c45 -34 65 -69 70 -125 4 -61 -19 -106 -77 -145
--90 -60 -226 3 -238 111 -3 24 -3 56 1 70 8 34 54 86 91 102 40 19 120 12 153
--13z"/>
-<path d="M967 2543 c-4 -3 -7 -159 -7 -346 l0 -339 128 4 c101 3 136 8 172 24
-106 48 162 145 168 292 10 214 -69 334 -238 361 -73 12 -213 15 -223 4z"/>
-</g>
-</svg>

apps/guide/public/site.webmanifest

@@ -1,19 +0,0 @@
-{
-	"name": "discord.js guide",
-	"short_name": "discord.js guide",
-	"icons": [
-		{
-			"src": "/android-chrome-192x192.png",
-			"sizes": "192x192",
-			"type": "image/png"
-		},
-		{
-			"src": "/android-chrome-384x384.png",
-			"sizes": "384x384",
-			"type": "image/png"
-		}
-	],
-	"theme_color": "#1a1b1e",
-	"background_color": "#1a1b1e",
-	"display": "standalone"
-}

apps/guide/src/app/_global-error.tsx

@@ -1,26 +0,0 @@
-'use client';
-
-import { inter } from '~/util/fonts';
-import { Providers } from './providers';
-
-import '~/styles/cmdk.css';
-import '~/styles/main.css';
-
-export default function GlobalError({ error }: { readonly error: Error }) {
-	console.error(error);
-
-	return (
-		<html className={inter.variable} lang="en" suppressHydrationWarning>
-			<body className="bg-light-600 dark:bg-dark-600 dark:text-light-900">
-				<Providers>
-					<main className="mx-auto max-w-2xl min-h-screen">
-						<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-							<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">500</h1>
-							<h2 className="text-[2rem] md:text-[3rem]">Error.</h2>
-						</div>
-					</main>
-				</Providers>
-			</body>
-		</html>
-	);
-}

apps/guide/src/app/error.tsx

@@ -1,12 +0,0 @@
-'use client';
-
-export default function Error({ error }: { readonly error: Error }) {
-	console.error(error);
-
-	return (
-		<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-			<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">500</h1>
-			<h2 className="text-[2rem] md:text-[3rem]">Error.</h2>
-		</div>
-	);
-}

apps/guide/src/app/guide/[...slug]/not-found.tsx

@@ -1 +0,0 @@
-export { default } from '~/app/not-found';

apps/guide/src/app/guide/[...slug]/page.tsx

@@ -1,21 +0,0 @@
-import { notFound } from 'next/navigation';
-import { allContents } from 'contentlayer/generated';
-import { Mdx } from '~/components/Mdx';
-
-export async function generateStaticParams() {
-	return allContents.map((content) => ({ slug: [content.slug] }));
-}
-
-export default function Page({ params }: { readonly params: { slug: string[] } }) {
-	const content = allContents.find((content) => content.slug === params.slug?.join('/'));
-
-	if (!content) {
-		notFound();
-	}
-
-	return (
-		<article className="max-w-none px-5 prose">
-			<Mdx code={content?.body.code ?? ''} />
-		</article>
-	);
-}

apps/guide/src/app/guide/layout.tsx

@@ -1,25 +0,0 @@
-import type { PropsWithChildren } from 'react';
-import Footer from '~/components/Footer';
-import Header from '~/components/Header';
-import { Nav } from '~/components/Nav';
-import { Providers } from './providers';
-
-export default function Layout({ children }: PropsWithChildren) {
-	return (
-		<Providers>
-			<main className="mx-auto max-w-7xl px-4 lg:max-w-full">
-				<Header />
-				<div className="relative top-6 mx-auto max-w-7xl gap-6 lg:max-w-full lg:flex">
-					<div className="lg:sticky lg:top-23 lg:h-[calc(100vh_-_105px)]">
-						<Nav />
-					</div>
-
-					<div className="mx-auto max-w-5xl min-w-xs w-full pb-10">
-						{children}
-						<Footer />
-					</div>
-				</div>
-			</main>
-		</Providers>
-	);
-}

apps/guide/src/app/guide/page.tsx

@@ -1,3 +0,0 @@
-export default function Page() {
-	return null;
-}

apps/guide/src/app/guide/providers.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import type { PropsWithChildren } from 'react';
-import { NavProvider } from '~/contexts/nav';
-
-export function Providers({ children }: PropsWithChildren) {
-	return <NavProvider>{children}</NavProvider>;
-}

apps/guide/src/app/layout.tsx

@@ -1,84 +0,0 @@
-import { Analytics } from '@vercel/analytics/react';
-import type { Metadata, Viewport } from 'next';
-import type { PropsWithChildren } from 'react';
-import { DESCRIPTION } from '~/util/constants';
-import { inter, jetBrainsMono } from '~/util/fonts';
-import { Providers } from './providers';
-
-import '~/styles/cmdk.css';
-import '@code-hike/mdx/styles.css';
-import '~/styles/ch.css';
-import '~/styles/main.css';
-
-export const viewport: Viewport = {
-	themeColor: [
-		{ media: '(prefers-color-scheme: light)', color: '#f1f3f5' },
-		{ media: '(prefers-color-scheme: dark)', color: '#181818' },
-	],
-	colorScheme: 'light dark',
-};
-
-export const metadata: Metadata = {
-	metadataBase: new URL(
-		process.env.METADATA_BASE_URL ? process.env.METADATA_BASE_URL : `http://localhost:${process.env.PORT ?? 3_000}`,
-	),
-	title: 'discord.js',
-	description: DESCRIPTION,
-	icons: {
-		other: [
-			{
-				url: '/favicon-32x32.png',
-				sizes: '32x32',
-				type: 'image/png',
-			},
-			{
-				url: '/favicon-16x16.png',
-				sizes: '16x16',
-				type: 'image/png',
-			},
-		],
-		apple: [
-			'/apple-touch-icon.png',
-			{
-				url: '/safari-pinned-tab.svg',
-				rel: 'mask-icon',
-			},
-		],
-	},
-
-	manifest: '/site.webmanifest',
-
-	appleWebApp: {
-		title: 'discord.js',
-	},
-
-	applicationName: 'discord.js',
-
-	openGraph: {
-		siteName: 'discord.js',
-		type: 'website',
-		title: 'discord.js',
-		description: DESCRIPTION,
-		images: 'https://discordjs.dev/api/open-graph.png',
-	},
-
-	twitter: {
-		card: 'summary_large_image',
-		creator: '@iCrawlToGo',
-	},
-
-	other: {
-		'msapplication-TileColor': '#090a16',
-	},
-};
-
-export default function RootLayout({ children }: PropsWithChildren) {
-	return (
-		<html className={`${inter.variable} ${jetBrainsMono.variable}`} lang="en" suppressHydrationWarning>
-			<body className="bg-light-600 dark:bg-dark-600 dark:text-light-900">
-				<Providers>{children}</Providers>
-				<Analytics />
-			</body>
-		</html>
-	);
-}

apps/guide/src/app/loading.tsx

@@ -1,20 +0,0 @@
-export default function Loading() {
-	return (
-		<div className="mx-4 min-h-screen flex flex-col items-center justify-center gap-4">
-			<svg
-				className="h-9 w-9 animate-spin text-black dark:text-white"
-				fill="none"
-				viewBox="0 0 24 24"
-				xmlns="http://www.w3.org/2000/svg"
-			>
-				<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
-				<path
-					className="opacity-75 dark:opacity-100"
-					d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
-					fill="currentColor"
-				/>
-			</svg>
-			<div className="text-lg font-medium">Loading...</div>
-		</div>
-	);
-}

apps/guide/src/app/not-found.tsx

@@ -1,16 +0,0 @@
-import Link from 'next/link';
-
-export default function NotFound() {
-	return (
-		<div className="mx-auto max-w-lg min-h-screen flex flex-col place-content-center place-items-center gap-8 px-8 py-16 lg:px-6 lg:py-0">
-			<h1 className="text-[9rem] font-black leading-none md:text-[12rem]">404</h1>
-			<h2 className="text-[2rem] md:text-[3rem]">Not found.</h2>
-			<Link
-				className="h-11 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded bg-blurple px-6 text-base text-white font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-white"
-				href="/guide"
-			>
-				Take me back
-			</Link>
-		</div>
-	);
-}

apps/guide/src/app/page.tsx

@@ -1,3 +0,0 @@
-export default function Page() {
-	return null;
-}

apps/guide/src/app/providers.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import { ThemeProvider } from 'next-themes';
-import type { PropsWithChildren } from 'react';
-
-export function Providers({ children }: PropsWithChildren) {
-	return <ThemeProvider attribute="class">{children}</ThemeProvider>;
-}

apps/guide/src/assets/powered-by-vercel.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="212" height="44" fill="none"><rect width="212" height="44" fill="#000" rx="8"/><path fill="#fff" d="M60.438 15.227V26.5h1.406v-4.023h2.836c2.117 0 3.625-1.493 3.625-3.602 0-2.148-1.477-3.648-3.61-3.648h-4.257Zm1.406 1.25h2.484c1.633 0 2.531.851 2.531 2.398 0 1.492-.93 2.352-2.53 2.352h-2.485v-4.75Zm11.5 10.171c2.399 0 3.883-1.656 3.883-4.359 0-2.71-1.484-4.36-3.883-4.36-2.398 0-3.883 1.65-3.883 4.36 0 2.703 1.485 4.36 3.883 4.36Zm0-1.21c-1.594 0-2.492-1.157-2.492-3.149 0-2 .898-3.148 2.492-3.148 1.594 0 2.492 1.148 2.492 3.148 0 1.992-.898 3.148-2.492 3.148Zm15.954-7.36h-1.352l-1.656 6.735h-.125l-1.883-6.735h-1.29l-1.882 6.735h-.125l-1.656-6.735h-1.36l2.36 8.422h1.36l1.874-6.516h.125l1.883 6.516h1.367l2.36-8.422Zm4.523 1.04c1.336 0 2.227.984 2.258 2.476h-4.64c.101-1.492 1.039-2.477 2.382-2.477Zm2.219 5.202c-.352.742-1.086 1.14-2.172 1.14-1.43 0-2.36-1.054-2.43-2.718v-.062h6.055v-.516c0-2.617-1.383-4.234-3.656-4.234-2.313 0-3.797 1.718-3.797 4.367 0 2.664 1.46 4.351 3.797 4.351 1.844 0 3.156-.89 3.547-2.328H96.04Zm3.242 2.18h1.344v-5.219c0-1.187.93-2.047 2.211-2.047.266 0 .75.047.86.078V17.97a5.77 5.77 0 0 0-.672-.04c-1.117 0-2.086.579-2.336 1.4h-.125v-1.25h-1.281V26.5Zm8.899-7.383c1.336 0 2.227.985 2.258 2.477h-4.641c.102-1.492 1.04-2.477 2.383-2.477Zm2.219 5.203c-.352.742-1.086 1.14-2.172 1.14-1.43 0-2.359-1.054-2.43-2.718v-.062h6.055v-.516c0-2.617-1.383-4.234-3.656-4.234-2.313 0-3.797 1.718-3.797 4.367 0 2.664 1.461 4.351 3.797 4.351 1.844 0 3.156-.89 3.547-2.328H110.4Zm6.36 2.328c1.164 0 2.164-.554 2.695-1.492h.125V26.5h1.281V14.734h-1.343v4.672h-.118c-.476-.922-1.468-1.476-2.64-1.476-2.141 0-3.539 1.718-3.539 4.36 0 2.648 1.382 4.358 3.539 4.358Zm.312-7.507c1.524 0 2.477 1.218 2.477 3.148 0 1.945-.946 3.148-2.477 3.148-1.539 0-2.461-1.18-2.461-3.148 0-1.96.93-3.148 2.461-3.148Zm14.462 7.507c2.133 0 3.531-1.726 3.531-4.359 0-2.648-1.391-4.36-3.531-4.36-1.156 0-2.18.571-2.641 1.477h-.125v-4.672h-1.344V26.5h1.282v-1.344h.125c.531.938 1.531 1.492 2.703 1.492Zm-.313-7.507c1.539 0 2.453 1.18 2.453 3.148 0 1.969-.914 3.148-2.453 3.148-1.531 0-2.484-1.203-2.484-3.148s.953-3.148 2.484-3.148Zm6.04 10.406c1.492 0 2.164-.578 2.882-2.531l3.29-8.938h-1.43l-2.305 6.93h-.125l-2.312-6.93h-1.453l3.117 8.43-.157.5c-.351 1.015-.773 1.383-1.546 1.383-.188 0-.399-.008-.563-.04V29.5c.188.031.422.047.602.047Zm17.391-3.047 3.898-11.273h-2.148l-2.813 8.921h-.132l-2.836-8.921h-2.227l3.938 11.273h2.32Zm8.016-7.18c1.164 0 1.93.813 1.969 2.078h-4.024c.086-1.25.899-2.078 2.055-2.078Zm1.984 4.828c-.281.633-.945.985-1.906.985-1.273 0-2.094-.89-2.141-2.313v-.101h5.969v-.625c0-2.696-1.461-4.313-3.898-4.313-2.477 0-4.016 1.727-4.016 4.477s1.516 4.414 4.031 4.414c2.016 0 3.446-.969 3.797-2.524h-1.836Zm3.547 2.352h1.938v-4.938c0-1.195.875-1.976 2.133-1.976.328 0 .843.055.992.11v-1.798c-.18-.054-.524-.085-.805-.085-1.101 0-2.023.625-2.258 1.468h-.132v-1.328h-1.868V26.5Zm13.501-5.672c-.203-1.797-1.532-3.047-3.727-3.047-2.57 0-4.078 1.649-4.078 4.422 0 2.813 1.516 4.469 4.086 4.469 2.164 0 3.508-1.203 3.719-2.992h-1.844c-.203.89-.875 1.367-1.883 1.367-1.32 0-2.117-1.047-2.117-2.844 0-1.773.789-2.797 2.117-2.797 1.063 0 1.703.594 1.883 1.422h1.844Zm5.117-1.508c1.164 0 1.93.813 1.969 2.078h-4.024c.086-1.25.899-2.078 2.055-2.078Zm1.985 4.828c-.282.633-.946.985-1.907.985-1.273 0-2.093-.89-2.14-2.313v-.101h5.968v-.625c0-2.696-1.461-4.313-3.898-4.313-2.477 0-4.016 1.727-4.016 4.477s1.516 4.414 4.032 4.414c2.015 0 3.445-.969 3.796-2.524h-1.835Zm3.625 2.352h1.937V14.648h-1.937V26.5ZM23.325 13l9.325 16H14l9.325-16Z"/><path stroke="#5E5E5E" d="M43.5 0v44"/></svg>

apps/guide/src/components/DiscordAPITypesLink.tsx

@@ -1,91 +0,0 @@
-import { FiExternalLink } from '@react-icons/all-files/fi/FiExternalLink';
-import type { PropsWithChildren } from 'react';
-import {
-	BASE_URL_DISCORD_API_TYPES,
-	DISCORD_API_TYPES_VERSION,
-	DISCORD_API_TYPES_VOICE_VERSION,
-} from '~/util/constants';
-
-interface DiscordAPITypesLinkOptions {
-	/**
-	 * The initial documentation enum, interface, function etc.
-	 *
-	 * @example `'RESTJSONErrorCodes'`
-	 */
-	readonly parent?: string;
-	/**
-	 * The scope of where this link lives.
-	 *
-	 * @remarks API does not have a scope.
-	 */
-	readonly scope?: 'gateway' | 'globals' | 'payloads' | 'rest' | 'rpc' | 'utils' | 'voice';
-	/**
-	 * The symbol belonging to the parent.
-	 *
-	 * @example '`MaximumNumberOfGuildsReached'`
-	 */
-	readonly symbol?: string;
-	/**
-	 * The type of the {@link DiscordAPITypesLinkOptions.parent}.
-	 *
-	 * @example `'enum'`
-	 * @example `'interface'`
-	 */
-	readonly type?: string;
-}
-
-export function DiscordAPITypesLink({
-	parent,
-	scope,
-	symbol,
-	type,
-	children,
-}: PropsWithChildren<DiscordAPITypesLinkOptions>) {
-	let url = BASE_URL_DISCORD_API_TYPES;
-	let text = 'discord-api-types';
-
-	if (type || parent) {
-		url += `/api/discord-api-types`;
-
-		switch (scope) {
-			case 'globals':
-				url += `-${scope}`;
-				break;
-			case 'gateway':
-			case 'payloads':
-			case 'rest':
-				url += `-${scope}/common`;
-				break;
-			case 'rpc':
-			case 'utils':
-				url += `-${scope}/${DISCORD_API_TYPES_VERSION}`;
-				break;
-			case 'voice':
-				url += `-${scope}/${DISCORD_API_TYPES_VOICE_VERSION}`;
-				break;
-			default:
-				url += `-${DISCORD_API_TYPES_VERSION}`;
-		}
-
-		if (type) {
-			url += `/${type}/${parent}`;
-			if (symbol) url += `#${symbol}`;
-		} else {
-			url += `#${parent}`;
-		}
-
-		text = `${parent}${symbol ? `#${symbol}` : ''}${type?.toUpperCase() === 'FUNCTION' ? '()' : ''}`;
-	}
-
-	return (
-		<a
-			className="inline-flex flex-row place-items-center gap-1"
-			href={url}
-			rel="external noopener noreferrer"
-			target="_blank"
-		>
-			{children ?? text}
-			<FiExternalLink size={18} />
-		</a>
-	);
-}

apps/guide/src/components/DocsLink.tsx

@@ -1,86 +0,0 @@
-import { FiExternalLink } from '@react-icons/all-files/fi/FiExternalLink';
-import type { PropsWithChildren } from 'react';
-import { BASE_URL, BASE_URL_LEGACY, PACKAGES, VERSION } from '~/util/constants';
-
-interface DocsLinkOptions {
-	/**
-	 * Whether to apply brackets to the end of the symbol to denote a method.
-	 *
-	 * @remarks Functions automatically infer this.
-	 */
-	readonly brackets?: boolean;
-	/**
-	 * The package.
-	 *
-	 * @defaultValue `'discord.js'`
-	 */
-	readonly package?: (typeof PACKAGES)[number];
-	/**
-	 * The initial documentation class, function, interface etc.
-	 *
-	 * @example `'Client'`
-	 */
-	readonly parent?: string;
-	/**
-	 * Whether to reference a static property.
-	 *
-	 * @remarks
-	 * This should only be used for the https://discord.js.org domain
-	 * as static properties are not identified in the URL.
-	 */
-	readonly static?: boolean;
-	/**
-	 * The symbol belonging to the parent.
-	 *
-	 * @example '`login'`
-	 */
-	readonly symbol?: string;
-	/**
-	 * The type of the {@link DocsLinkOptions.parent}.
-	 *
-	 * @example `'class'`
-	 * @example `'Function'`
-	 */
-	readonly type?: string;
-}
-
-export function DocsLink({
-	package: docs = PACKAGES[0],
-	type,
-	parent,
-	symbol,
-	brackets,
-	static: staticReference,
-	children,
-}: PropsWithChildren<DocsLinkOptions>) {
-	// In the case of no type and no parent, this will default to the entry point of the respective documentation.
-	let url = docs === PACKAGES[0] ? `${BASE_URL_LEGACY}/${VERSION}/general/welcome` : `${BASE_URL}/${docs}/stable`;
-	let text = `${docs === PACKAGES[0] ? '' : '@discordjs/'}${docs}`;
-
-	// If there is a type and parent, we need to do some parsing.
-	if (type && parent) {
-		const bracketText = brackets || type?.toUpperCase() === 'FUNCTION' ? '()' : '';
-
-		// Legacy discord.js documentation parsing.
-		if (docs === PACKAGES[0]) {
-			url = `${BASE_URL_LEGACY}/${VERSION}/${type}/${parent}`;
-			if (symbol) url += `?scrollTo=${symbol}`;
-
-			text = `${parent}${symbol ? (symbol.startsWith('s-') ? '.' : '#') : ''}${
-				// eslint-disable-next-line prefer-named-capture-group
-				symbol ? `${symbol.replace(/(e|s)-/, '')}` : ''
-			}${bracketText}`;
-		} else {
-			url += `/${parent}:${type}`;
-			if (symbol) url += `#${symbol}`;
-			text = `${parent}${symbol ? `${staticReference ? '.' : '#'}${symbol}` : ''}${bracketText}`;
-		}
-	}
-
-	return (
-		<a className="inline-flex flex-row place-items-center gap-1" href={url} rel="noopener noreferrer" target="_blank">
-			{children ?? text}
-			<FiExternalLink size={18} />
-		</a>
-	);
-}

apps/guide/src/components/Footer.tsx

@@ -1,98 +0,0 @@
-import Image from 'next/image';
-import vercelLogo from '~/assets/powered-by-vercel.svg';
-import workersLogo from '~/assets/powered-by-workers.png';
-
-export default function Footer() {
-	return (
-		<footer className="md:pl-12 md:pr-12">
-			<div className="flex flex-col flex-wrap place-content-center gap-6 pt-12 sm:flex-row md:gap-12">
-				<div className="flex flex-wrap place-content-center place-items-center gap-4">
-					<a
-						className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-						href="https://vercel.com/?utm_source=discordjs&utm_campaign=oss"
-						rel="external noopener noreferrer"
-						target="_blank"
-						title="Vercel"
-					>
-						<Image
-							alt="Vercel"
-							blurDataURL="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAABLCAQAAAA1k5H2AAAAi0lEQVR42u3SMQEAAAgDoC251a3gL2SgmfBYBRAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARCAgwWEOSWBnYbKggAAAABJRU5ErkJggg=="
-							height={44}
-							placeholder="blur"
-							src={vercelLogo}
-							width={212}
-						/>
-					</a>
-					<a
-						className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-						href="https://www.cloudflare.com"
-						rel="external noopener noreferrer"
-						target="_blank"
-						title="Cloudflare Workers"
-					>
-						<Image
-							alt="Cloudflare"
-							blurDataURL="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAABLCAQAAAA1k5H2AAAAi0lEQVR42u3SMQEAAAgDoC251a3gL2SgmfBYBRAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARAAARCAgwWEOSWBnYbKggAAAABJRU5ErkJggg=="
-							height={44}
-							placeholder="blur"
-							priority
-							src={workersLogo}
-						/>
-					</a>
-				</div>
-				<div className="flex flex-col place-self-center gap-6 sm:flex-row md:gap-12">
-					<div className="max-w-max flex flex-col gap-2">
-						<div className="text-lg font-semibold">Community</div>
-						<div className="flex flex-col gap-1">
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord.gg/djs"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								Discord
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://github.com/discordjs/discord.js/discussions"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								GitHub discussions
-							</a>
-						</div>
-					</div>
-					<div className="max-w-max flex flex-col gap-2">
-						<div className="text-lg font-semibold">Project</div>
-						<div className="flex flex-col gap-1">
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://github.com/discordjs/discord.js"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								discord.js
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord.js.org/docs"
-								rel="noopener noreferrer"
-								target="_blank"
-							>
-								discord.js documentation
-							</a>
-							<a
-								className="rounded outline-none focus:ring focus:ring-width-2 focus:ring-blurple"
-								href="https://discord-api-types.dev"
-								rel="external noopener noreferrer"
-								target="_blank"
-							>
-								discord-api-types
-							</a>
-						</div>
-					</div>
-				</div>
-			</div>
-		</footer>
-	);
-}

apps/guide/src/components/H1.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H1({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h1 className={`group ${className}`} {...props}>
-			{children}
-		</h1>
-	);
-}

apps/guide/src/components/H2.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H2({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h2 className={`group ${className}`} {...props}>
-			{children}
-		</h2>
-	);
-}

apps/guide/src/components/H3.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H3({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h3 className={`group ${className}`} {...props}>
-			{children}
-		</h3>
-	);
-}

apps/guide/src/components/H4.tsx

@@ -1,9 +0,0 @@
-import type { HTMLAttributes, PropsWithChildren } from 'react';
-
-export function H4({ children, className, ...props }: PropsWithChildren<HTMLAttributes<HTMLHeadingElement>>) {
-	return (
-		<h4 className={`group ${className}`} {...props}>
-			{children}
-		</h4>
-	);
-}

apps/guide/src/components/Header.tsx

@@ -1,92 +0,0 @@
-'use client';
-
-import { VscGithubInverted } from '@react-icons/all-files/vsc/VscGithubInverted';
-import { VscMenu } from '@react-icons/all-files/vsc/VscMenu';
-import { Button } from 'ariakit/button';
-import type { Route } from 'next';
-import dynamic from 'next/dynamic';
-import Link from 'next/link';
-import { usePathname } from 'next/navigation';
-import { Fragment, useMemo } from 'react';
-import { useNav } from '~/contexts/nav';
-
-const ThemeSwitcher = dynamic(async () => import('./ThemeSwitcher'));
-
-export default function Header() {
-	const pathname = usePathname();
-	const { setOpened } = useNav();
-
-	const pathElements = useMemo(
-		() =>
-			pathname
-				.split('/')
-				.slice(1)
-				.map((path, idx, original) => (
-					<Link
-						className="rounded outline-none hover:underline focus:ring focus:ring-width-2 focus:ring-blurple"
-						href={`/${original.slice(0, idx + 1).join('/')}` as Route}
-						key={`${path}-${idx}`}
-					>
-						{path}
-					</Link>
-				)),
-		[pathname],
-	);
-
-	const breadcrumbs = useMemo(
-		() =>
-			pathElements.flatMap((el, idx, array) => {
-				if (idx === 0) {
-					return (
-						<Fragment key={`${el.key}-${idx}`}>
-							<div className="mx-2">/</div>
-							<div>{el}</div>
-							<div className="mx-2">/</div>
-						</Fragment>
-					);
-				}
-
-				if (idx !== array.length - 1) {
-					return (
-						<Fragment key={`${el.key}-${idx}`}>
-							<div>{el}</div>
-							<div className="mx-2">/</div>
-						</Fragment>
-					);
-				}
-
-				return <div key={`${el.key}-${idx}`}>{el}</div>;
-			}),
-		[pathElements],
-	);
-
-	return (
-		<header className="sticky top-4 z-20 border border-light-900 rounded-md bg-white/75 shadow backdrop-blur-md dark:border-dark-100 dark:bg-dark-600/75">
-			<div className="block h-16 px-6">
-				<div className="h-full flex flex-row place-content-between place-items-center gap-8">
-					<Button
-						aria-label="Menu"
-						className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none lg:hidden active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-						onClick={() => setOpened((open) => !open)}
-					>
-						<VscMenu size={24} />
-					</Button>
-					<div className="hidden lg:flex lg:grow lg:flex-row lg:overflow-hidden">{breadcrumbs}</div>
-					<div className="flex flex-row place-items-center gap-4">
-						<Button
-							aria-label="GitHub"
-							as="a"
-							className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded rounded-full bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-							href="https://github.com/discordjs/discord.js"
-							rel="external noopener noreferrer"
-							target="_blank"
-						>
-							<VscGithubInverted size={24} />
-						</Button>
-						<ThemeSwitcher />
-					</div>
-				</div>
-			</div>
-		</header>
-	);
-}

apps/guide/src/components/Mdx.tsx

@@ -1,34 +0,0 @@
-'use client';
-
-import { Alert, Section, DiscordMessages, DiscordMessage, DiscordMessageEmbed } from '@discordjs/ui';
-import { useMDXComponent } from 'next-contentlayer/hooks';
-import { DocsLink } from '~/components/DocsLink';
-import { ResultingCode } from '~/components/ResultingCode';
-import { DiscordAPITypesLink } from './DiscordAPITypesLink';
-import { H1 } from './H1';
-import { H2 } from './H2';
-import { H3 } from './H3';
-import { H4 } from './H4';
-
-export function Mdx({ code }: { readonly code: string }) {
-	const Component = useMDXComponent(code);
-
-	return (
-		<Component
-			components={{
-				Alert,
-				Section,
-				DiscordMessages,
-				DiscordMessage,
-				DiscordMessageEmbed,
-				DiscordAPITypesLink,
-				DocsLink,
-				ResultingCode,
-				h1: H1,
-				h2: H2,
-				h3: H3,
-				h4: H4,
-			}}
-		/>
-	);
-}

apps/guide/src/components/Nav.tsx

@@ -1,32 +0,0 @@
-'use client';
-
-import { Scrollbars } from 'react-custom-scrollbars-2';
-import { useNav } from '~/contexts/nav';
-import { Sidebar } from './Sidebar';
-
-export function Nav() {
-	const { opened } = useNav();
-
-	return (
-		<nav
-			className={`dark:bg-dark-600/75 dark:border-dark-100 border-light-900 top-22 fixed bottom-4 left-4 right-4 z-20 mx-auto max-w-5xl rounded-md border bg-white/75 shadow backdrop-blur-md ${
-				opened ? 'block' : 'hidden'
-			} lg:min-w-xs lg:sticky lg:block lg:h-full lg:w-full lg:max-w-xs`}
-		>
-			<Scrollbars
-				autoHide
-				className="[&>div]:overscroll-none"
-				hideTracksWhenNotNeeded
-				renderThumbVertical={(props) => <div {...props} className="z-30 rounded bg-light-900 dark:bg-dark-100" />}
-				renderTrackVertical={(props) => (
-					<div {...props} className="absolute bottom-0.5 right-0.5 top-0.5 z-30 w-1.5 rounded" />
-				)}
-				universal
-			>
-				<div className="flex flex-col gap-4 p-3">
-					<Sidebar />
-				</div>
-			</Scrollbars>
-		</nav>
-	);
-}

apps/guide/src/components/Outline.tsx

@@ -1,69 +0,0 @@
-import { useMemo, useState } from 'react';
-import { Scrollbars } from 'react-custom-scrollbars-2';
-
-const LINK_HEIGHT = 30;
-const INDICATOR_SIZE = 10;
-const INDICATOR_OFFSET = (LINK_HEIGHT - INDICATOR_SIZE) / 2;
-
-export function Outline({ headings }: { readonly headings: any[] }) {
-	// eslint-disable-next-line react/hook-use-state
-	const [active /* setActive */] = useState(0);
-
-	const headingItems = useMemo(
-		() =>
-			headings.map((heading, idx) => (
-				<a
-					className={`dark:border-dark-100 border-light-800 pl-6.5 focus:ring-width-2 focus:ring-blurple ml-[10px] border-l p-[5px] text-sm outline-none focus:rounded focus:border-0 focus:ring ${
-						idx === active
-							? 'bg-blurple text-white'
-							: 'dark:hover:bg-dark-200 dark:active:bg-dark-100 hover:bg-light-700 active:bg-light-800'
-					}`}
-					href={`#${heading.slug}`}
-					key={heading.slug}
-					style={{ paddingLeft: `${heading.depth * 14}px` }}
-					title={heading.text}
-				>
-					<span className="line-clamp-1">{heading.text}</span>
-				</a>
-			)),
-		[headings, active],
-	);
-
-	// useEffect(() => {
-	// 	const idx = headings.findIndex((heading) => heading.slug === state.hash?.slice(1));
-	// 	if (idx >= 0) {
-	// 		setActive(idx);
-	// 	}
-	// }, [state, headings]);
-
-	return (
-		<Scrollbars
-			autoHide
-			hideTracksWhenNotNeeded
-			renderThumbVertical={(props) => <div {...props} className="z-30 rounded bg-light-900 dark:bg-dark-100" />}
-			renderTrackVertical={(props) => (
-				<div {...props} className="absolute bottom-0.5 right-0.5 top-0.5 z-30 w-1.5 rounded" />
-			)}
-			universal
-		>
-			<div className="flex flex-col break-all p-3 pb-8">
-				<div className="ml-2 mt-4 flex flex-row gap-2">
-					{/* <VscListSelection size={25} /> */}
-					<span className="font-semibold">Contents</span>
-				</div>
-				<div className="ml-2 mt-4 flex flex-col gap-2">
-					<div className="relative flex flex-col">
-						<div
-							className="absolute h-[10px] w-[10px] border-2 border-black rounded-full bg-blurple dark:border-white"
-							style={{
-								left: INDICATOR_SIZE / 2 + 0.5,
-								transform: `translateY(${active * LINK_HEIGHT + INDICATOR_OFFSET}px)`,
-							}}
-						/>
-						{headingItems}
-					</div>
-				</div>
-			</div>
-		</Scrollbars>
-	);
-}

apps/guide/src/components/PageButton.tsx

@@ -1,21 +0,0 @@
-export function PageButton({
-	url,
-	title,
-	direction,
-}: {
-	readonly direction: 'next' | 'prev';
-	readonly title: string;
-	readonly url: string;
-}) {
-	return (
-		<a
-			className="flex flex-row flex-col transform-gpu cursor-pointer select-none appearance-none place-items-center gap-2 rounded bg-light-600 px-4 py-3 leading-none no-underline outline-none active:translate-y-px active:bg-light-800 dark:bg-dark-600 hover:bg-light-700 focus:ring focus:ring-width-2 focus:ring-blurple dark:active:bg-dark-400 dark:hover:bg-dark-500"
-			href={url}
-		>
-			<h3 className="text-md font-semibold">{title}</h3>
-			<p className={`${direction === 'next' ? 'ml-auto' : 'mr-auto'} text-sm text-gray-600 dark:text-gray-400`}>
-				{direction === 'next' ? 'Next Page' : 'Previous Page'}
-			</p>
-		</a>
-	);
-}

apps/guide/src/components/ResultingCode.tsx

@@ -1,3 +0,0 @@
-export function ResultingCode() {
-	return null;
-}

apps/guide/src/components/Section.tsx

@@ -1,8 +0,0 @@
-'use client';
-
-import { Section as DJSSection, type SectionOptions } from '@discordjs/ui';
-import type { PropsWithChildren } from 'react';
-
-export function Section(options: PropsWithChildren<SectionOptions>) {
-	return <DJSSection {...options} />;
-}

apps/guide/src/components/Sidebar.tsx

@@ -1,63 +0,0 @@
-'use client';
-
-import type { Route } from 'next';
-import Link from 'next/link';
-import { usePathname } from 'next/navigation';
-import { allContents } from 'contentlayer/generated';
-import { useNav } from '~/contexts/nav';
-import { Section } from './Section';
-
-const items = allContents.map((content) => ({
-	title: content.title,
-	category: content.category,
-	slug: content.slug,
-	href: content.url,
-}));
-
-function transformItemsByCategory(allContents: typeof items) {
-	return allContents.reduce<Record<string, typeof items>>((accumulator: any, content) => {
-		if (!accumulator[content.category]) {
-			accumulator[content.category] = [];
-		}
-
-		accumulator[content.category].push(content);
-		return accumulator;
-	}, {});
-}
-
-const itemsByCategory = transformItemsByCategory(items);
-
-export function Sidebar() {
-	const pathname = usePathname();
-	const { setOpened } = useNav();
-
-	return (
-		<div className="flex flex-col gap-4">
-			{Object.keys(itemsByCategory).map((category, idx) => (
-				<Section
-					buttonClassName="bg-light-600 hover:bg-light-700 active:bg-light-800 dark:bg-dark-400 dark:hover:bg-dark-300 dark:active:bg-dark-400 focus:ring-width-2 focus:ring-blurple rounded p-3 outline-none focus:ring z-10"
-					key={`${category}-${idx}`}
-					title={category}
-				>
-					{itemsByCategory[category]?.map((member, index) => (
-						<Link
-							className={`dark:border-dark-100 border-light-800 focus:ring-width-2 focus:ring-blurple ml-5 flex flex-col border-l first:mt-1 p-[5px] pl-6 outline-none focus:rounded focus:border-0 focus:ring ${
-								decodeURIComponent(pathname ?? '') === member.href
-									? 'bg-blurple text-white'
-									: 'dark:hover:bg-dark-200 dark:active:bg-dark-100 hover:bg-light-700 active:bg-light-800'
-							}`}
-							href={member.href as Route}
-							key={`${member.title}-${index}`}
-							onClick={() => setOpened(false)}
-							title={member.title}
-						>
-							<div className="flex flex-row place-items-center gap-2 lg:text-sm">
-								<span className="truncate">{member.title}</span>
-							</div>
-						</Link>
-					))}
-				</Section>
-			))}
-		</div>
-	);
-}

apps/guide/src/components/ThemeSwitcher.tsx

@@ -1,20 +0,0 @@
-'use client';
-
-import { VscColorMode } from '@react-icons/all-files/vsc/VscColorMode';
-import { Button } from 'ariakit/button';
-import { useTheme } from 'next-themes';
-
-export default function ThemeSwitcher() {
-	const { resolvedTheme, setTheme } = useTheme();
-	const toggleTheme = () => setTheme(resolvedTheme === 'light' ? 'dark' : 'light');
-
-	return (
-		<Button
-			aria-label="Toggle theme"
-			className="h-6 w-6 flex flex-row transform-gpu cursor-pointer select-none appearance-none place-items-center border-0 rounded rounded-full bg-transparent p-0 text-sm font-semibold leading-none no-underline outline-none active:translate-y-px focus:ring focus:ring-width-2 focus:ring-blurple"
-			onClick={() => toggleTheme()}
-		>
-			<VscColorMode size={24} />
-		</Button>
-	);
-}

apps/guide/src/content/01-home/01-introduction.mdx

@@ -1,32 +0,0 @@
----
-title: Introduction
-category: Home
----
-
-# Introduction
-
-If you're reading this, it probably means you want to learn how to make a bot with discord.js. Awesome! You've come to the right place.
-This guide will teach you things such as:
-
-- How to get a bot [up and running](../getting-started/starting-out) from scratch;
-- In-depth explanations regarding features and concepts of the API (e.g. [intents](../topics/intents), [threads](../topics/threads), [webhooks](../topics/webhooks));
-- And much more.
-
-This guide will also cover subjects like common errors and how to solve them, keeping your code clean, setting up a proper development environment, etc.
-Sounds good? Great! Let's get started.
-
-## Before you begin...
-
-Alright, making a bot is cool and all, but there are some prerequisites to it. To create a bot with discord.js, you should have a fairly decent grasp of JavaScript itself.
-While you _can_ make a bot with very little JavaScript and programming knowledge, trying to do so without understanding the language first will only hinder you. You may get stuck on many uncomplicated issues, struggle with solutions to incredibly easy problems, and all-in-all end up frustrated. Sounds pretty annoying.
-
-If you don't know JavaScript but would like to learn about it, here are a few links to help get you started:
-
-- [Eloquent JavaScript, a free online book](http://eloquentjavascript.net)
-- [JavaScript.info, a modern javascript tutorial](https://javascript.info)
-- [Codecademy's interactive JavaScript course](https://codecademy.com/learn/introduction-to-javascript)
-- [Nodeschool, for both JavaScript and Node.js lessons](https://nodeschool.io)
-- [MDN's JavaScript guide and full documentation](https://developer.mozilla.org/docs/Web/JavaScript)
-- [Google, your best friend](https://google.com)
-
-Take your pick, learn some JavaScript, and once you feel like you're confident enough to make a bot, come back and get started!

apps/guide/src/content/01-home/02-whats-new.mdx

@@ -1,49 +0,0 @@
----
-title: What's new
-category: Home
----
-
-# What's new
-
-<DiscordMessages rounded>
-	<DiscordMessage
-		interaction={{
-			author: {
-				avatar: '/assets/old-guide.png',
-				username: 'discord.js',
-			},
-			command: '/upgrade',
-		}}
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			username: 'Guide Bot',
-			time: 'Today at 21:00',
-		}}
-	>
-		This website is new! We will no longer be updating the old guide website.
-	</DiscordMessage>
-</DiscordMessages>
-
-## Site
-
-We have moved from VuePress to [Next.js](https://nextjs.org/)! The source can be found [here](https://github.com/discordjs/discord.js/tree/main/apps/guide).
-
-## Pages
-
-- Pages have been revamped to account for our new [create-discord-bot](https://github.com/discordjs/discord.js/tree/main/packages/create-discord-bot) command-line interface.
-- Popular topic are now simply "topics" that detail usage of a particular concept of the API.
-- Focus is primarily on discord.js, so irrelevant topics have been removed. It may be better to visit the documentation of the package you are using to learn how to use them.
-
-<DiscordMessages rounded>
-	<DiscordMessage
-		author={{
-			avatar: '/assets/discordjs.png',
-			bot: true,
-			username: 'Guide Bot',
-			time: 'Today at 21:00',
-		}}
-	>
-		Thank you to all of those that contributed to the development of discord.js and the guide!
-	</DiscordMessage>
-</DiscordMessages>