Merge branch 'main' into hd/sponsor-page

* main: (325 commits)
  i18n(ko-KR): update `plugins.mdx` (#4146)
  [ci] release (#4137)
  Fix localisation of Expressive Code UI (#4138)
  chore: migrate Changesets to v3 (#4139)
  Add WhatsApp icon (#4142)
  docs: add starlight-custom-navigation to plugins showcase (#4141)
  [ci] format
  i18n(de): update plugins.mdx (#4140)
  i18n(ko-KR): update `plugins` (#4136)
  Use a page-specific counter for `<Tabs>`  IDs (#4133)
  Add starlight-pydocs and starlight-quiz (#4130)
  Remove Vitest native config loader warnings (#4129)
  i18n(ko-KR): update `authoring-content`, `i18n`, `plugins` (#4125)
  i18n(fr): update `authoring-content.mdx`, `i18n.mdx` & `plugins.md` (#4128)
  i18n(de): update links to Astro docs (#4126)
  Update `size-limit` config (#4122)
  Replace 3 outdated links to Astro Docs (#4120)
  [ci] release (#4115)
  Update dependencies (#4113)
  Add Astro LilyPond to Starlight showcase (#4116)
  ...

Author: HiDeoo

.changeset/config.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
+  "$schema": "https://unpkg.com/@changesets/config@4.0.0/schema.json",
   "changelog": [
     "@changesets/changelog-github",
     { "repo": "withastro/starlight" }
@@ -9,7 +9,6 @@
   "access": "public",
   "baseBranch": "origin/main",
   "updateInternalDependencies": "patch",
-  "ignore": ["starlight-docs", "@example/*", "starlight-file-icons-generator", "@e2e/*"],
   "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
     "onlyUpdatePeerDependentsWhenOutOfRange": true
   }

.devcontainer/Dockerfile

@@ -1,5 +1,5 @@
 # Based on https://github.com/withastro/astro/blob/main/.devcontainer/Dockerfile
-FROM mcr.microsoft.com/devcontainers/javascript-node:0-18
+FROM mcr.microsoft.com/devcontainers/javascript-node:0-22
 
 # We uninstall pnpm here, since we enable the corepack version in the postCreateCommand
 # This ensures we respect the "packageManager" version in package.json

.github/ISSUE_TEMPLATE/---01-bug-report.yml

@@ -9,7 +9,7 @@ body:
         Thank you for taking the time to file a bug report! Please fill out this form as completely as possible.
 
         ✅ I am using the **latest versions of Starlight and Astro**.
-        ✅ I am using a version of Node that supports ESM (`v14.18.0+`, or `v16.12.0+`).
+        ✅ I am using a compatible version of Node.js (`v22.12.0+`).
   - type: input
     id: starlight-version
     attributes:

.github/labeler.yml

@@ -23,6 +23,7 @@ i18n:
           - docs/src/content/docs/hi/**/*
           - docs/src/content/docs/da/**/*
           - docs/src/content/docs/uk/**/*
+          - docs/src/content/docs/fa/**/*
 
 '🌟 core':
   - changed-files:

.github/renovate.json5

@@ -10,6 +10,7 @@
 	],
 	rangeStrategy: 'bump',
 	ignorePaths: ['**/node_modules/**'],
+	minimumReleaseAge: '3 days',
 	packageRules: [
 		{
 			groupName: 'github-actions',
@@ -28,10 +29,22 @@
 			enabled: false,
 		},
 		{
-			description: 'Disable Node.js version updates with actions/setup-node',
+			description: 'Group Node.js workflow updates',
+			matchManagers: ['github-actions'],
 			matchDepNames: ['node'],
 			matchDepTypes: ['uses-with'],
-			enabled: false,
+			groupName: 'node.js',
+			// Allows Node.js PRs roughly every two weeks only.
+			schedule: ['* * 1,15 * *'],
+		},
+		{
+			description: 'Keep CI workflow on the latest patch of the minimum Node.js major supported by Astro',
+			matchManagers: ['github-actions'],
+			matchDepNames: ['node'],
+			matchDepTypes: ['uses-with'],
+			groupName: 'node.js',
+			matchFileNames: ['.github/workflows/ci.yml'],
+			allowedVersions: '/^22\\./',
 		},
 	],
 }

.github/workflows/ci.yml

@@ -13,7 +13,6 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  NODE_VERSION: 18
   ASTRO_TELEMETRY_DISABLED: true
 
 jobs:
@@ -23,21 +22,24 @@ jobs:
       pull-requests: read
     outputs:
       docs: ${{ steps.filter.outputs.docs }}
+      docs_fa: ${{ steps.filter.outputs.docs_fa }}
       docs_ja: ${{ steps.filter.outputs.docs_ja }}
       docs_en: ${{ steps.filter.outputs.docs_en }}
       docs_not_content: ${{ steps.filter.outputs.docs_not_content }}
       packages: ${{ steps.filter.outputs.packages }}
       ci: ${{ steps.filter.outputs.ci }}
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: dorny/paths-filter@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: dorny/paths-filter@7b450fff21473bca461d4b92ce414b9d0420d706 # v4.0.2
         id: filter
         # When updating filters here, make sure to also add or remove them from the
         # outputs block above.
         with:
           filters: |
             docs:
               - 'docs/**'
+            docs_fa:
+              - 'docs/src/content/docs/fa/**'
             docs_ja:
               - 'docs/src/content/docs/ja/**'
             docs_en:
@@ -51,6 +53,9 @@ jobs:
               - '!docs/src/content/docs/**'
             packages:
               - 'packages/**'
+              - 'package.json'
+              - 'pnpm-lock.yaml'
+              - 'pnpm-workspace.yaml'
             ci:
               - '.github/workflows/ci.yml'
 
@@ -60,18 +65,15 @@ jobs:
     if: ${{ needs.changes.outputs.packages == 'true' || needs.changes.outputs.ci == 'true' }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
       - run: pnpm i
       - name: Test packages
         run: pnpm -r test:coverage
-      - name: Test legacy collections support
-        working-directory: packages/starlight
-        run: pnpm test:legacy
 
   e2e-test:
     name: 'Run E2E tests (${{ matrix.os }})'
@@ -83,41 +85,25 @@ jobs:
         os: [ubuntu-latest, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      # Uninstall man-db to prevent man page updates taking a long time after package installations
-      # on Ubuntu 24.04.
-      # https://github.com/actions/runner/issues/4030
-      # https://github.com/actions/runner-images/issues/10977
-      - name: Uninstall man-db
-        if: matrix.os == 'ubuntu-latest'
-        run: |
-          sudo apt-get update
-          sudo apt-get remove man-db
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
-      - run: pnpm i
-      - name: Test packages (Linux)
-        if: matrix.os == 'ubuntu-latest'
-        run: pnpm -r test:e2e:chrome
-      # Firefox is used for Windows E2E tests as Chrome on Windows requires the installation of the
-      # Server Media Foundation windows feature, which can take up to 3 minutes to install on CI.
-      # https://github.com/microsoft/playwright/blob/e7bff526433b6dcb02801763ab5b1c6407902d47/packages/playwright-core/src/server/registry/dependencies.ts#L79-L89
-      - name: Test packages (Windows)
-        if: matrix.os == 'windows-latest'
-        run: pnpm -r test:e2e:firefox
+      - run: pnpm i --filter @astrojs/starlight --filter "@e2e/*"
+      - name: Test packages
+        run: pnpm -r test:e2e:ci
 
   type-check:
     name: Run type checks
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
       - run: pnpm i
       - name: Generate docs types
@@ -130,11 +116,11 @@ jobs:
     name: Lint code
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
       - run: pnpm i
       - name: Generate types
@@ -146,46 +132,45 @@ jobs:
   a11y:
     name: Check for accessibility issues
     needs: changes
-    if: ${{ needs.changes.outputs.docs_not_content == 'true' || needs.changes.outputs.docs_ja == 'true' || needs.changes.outputs.docs_en == 'true' || needs.changes.outputs.ci == 'true' || needs.changes.outputs.packages == 'true' }}
+    if: >
+      needs.changes.outputs.docs_not_content == 'true' ||
+      needs.changes.outputs.docs_fa == 'true' ||
+      needs.changes.outputs.docs_ja == 'true' ||
+      needs.changes.outputs.docs_en == 'true' ||
+      needs.changes.outputs.ci == 'true' || 
+      needs.changes.outputs.packages == 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-
-      # Uninstall man-db to prevent man page updates taking a long time after package installations
-      # on Ubuntu 24.04.
-      # https://github.com/actions/runner/issues/4030
-      # https://github.com/actions/runner-images/issues/10977
-      - name: Uninstall man-db
-        run: |
-          sudo apt-get update
-          sudo apt-get remove man-db
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+        uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
 
       - name: Setup Node
-        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
 
       - name: Install Dependencies
         run: pnpm i
 
       - name: Run accessibility audit
         working-directory: ./docs
-        run: pnpm t
+        run: pnpm test:ci
 
   windows-smoke:
     name: Docs site builds on Windows
+    needs: changes
+    if: ${{ needs.changes.outputs.packages == 'true' || needs.changes.outputs.ci == 'true' || needs.changes.outputs.docs_not_content == 'true' }}
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
       - run: pnpm i
       - name: Build docs site
@@ -199,15 +184,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+        uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
 
       - name: Setup Node
-        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: 22.23.1
           cache: 'pnpm'
 
       - name: Install Dependencies

.github/workflows/congratsbot.yml

@@ -7,7 +7,7 @@ on:
 jobs:
   congrats:
     if: ${{ github.repository_owner == 'withastro' && github.event.head_commit.message != '[ci] format' }}
-    uses: withastro/automation/.github/workflows/congratsbot.yml@main
+    uses: withastro/automation/.github/workflows/congratsbot.yml@8a5969576beae8ae7bdce64167a95237878f4901 # v1.0.1
     with:
       EMOJIS: '🎉,🎊,🧑‍🚀,🥳,🙌,🚀,🤩,☄️,💫,<:starlight:1107431075543797802>,<:houston_pride:1130504824673284107>'
       COAUTHOR_TEMPLATES: >

.github/workflows/file-icons.yml

@@ -16,15 +16,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+        uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
 
       - name: Setup Node
-        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: 18.20.8
+          node-version: 24.18.0
           cache: 'pnpm'
 
       - name: Install Dependencies
@@ -35,7 +35,7 @@ jobs:
         working-directory: packages/file-icons-generator
 
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
         with:
           branch: ci/file-icons
           token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}

.github/workflows/format.yml

@@ -5,28 +5,14 @@ on:
     branches:
       - main
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   format:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check out code using Git
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          ref: ${{ github.head_ref }}
-          # Needs access to push to main
-          token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
-      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
-      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
-        with:
-          node-version: 18.20.8
-          cache: 'pnpm'
-      - run: pnpm i
-      - name: Format with Prettier
-        run: pnpm format
-      - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@04702edda442b2e678b25b537cec683a1493fcb9 # v7.1.0
-        with:
-          commit_message: '[ci] format'
-          branch: ${{ github.head_ref }}
-          commit_user_name: fredkbot
-          commit_user_email: fred+astrobot@astro.build
+    if: github.repository_owner == 'withastro'
+    uses: withastro/automation/.github/workflows/format.yml@8a5969576beae8ae7bdce64167a95237878f4901 # v1.0.1
+    with:
+      command: "format"
+    secrets: inherit

.github/workflows/lunaria.yml

@@ -20,19 +20,19 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           # Necessary for Lunaria to work properly
           # Makes the action clone the entire git history
           fetch-depth: 0
 
       - name: Setup PNPM
-        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+        uses: pnpm/action-setup@0ebf47130e4866e96fce0953f49152a61190b271 # v6.0.9
 
       - name: Setup Node
-        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: 20.19.4
+          node-version: 24.18.0
           cache: pnpm
 
       - name: Install dependencies