docs(deps)(deps): bump astro and @astrojs/starlight in /docs (sbpp#1346)

* docs(deps)(deps): bump astro and @astrojs/starlight in /docs

Bumps [astro](https://github.com/withastro/astro/tree/HEAD/packages/astro) and [@astrojs/starlight](https://github.com/withastro/starlight/tree/HEAD/packages/starlight). These dependencies needed to be updated together.

Updates `astro` from 5.18.1 to 6.3.1
- [Release notes](https://github.com/withastro/astro/releases)
- [Changelog](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md)
- [Commits](https://github.com/withastro/astro/commits/astro@6.3.1/packages/astro)

Updates `@astrojs/starlight` from 0.30.6 to 0.39.2
- [Release notes](https://github.com/withastro/starlight/releases)
- [Changelog](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md)
- [Commits](https://github.com/withastro/starlight/commits/@astrojs/starlight@0.39.2/packages/starlight)

---
updated-dependencies:
- dependency-name: astro
  dependency-version: 6.3.1
  dependency-type: direct:production
- dependency-name: "@astrojs/starlight"
  dependency-version: 0.39.2
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* ci(docs): bump runner Node from 20 to 22 for Astro 6 floor

Astro 6 raised its Node floor to `>=22.12` (`engines.node` in the
astro@6.x manifest, EBADENGINE warning at install time + a hard
"Node.js v20 is not supported by Astro!" abort at `astro build`).
Bumping the docs-build / docs-screenshots-build / docs-screenshots-capture
runners to Node 22 unblocks the paired astro@^5 → ^6 + @astrojs/starlight@^0.30
→ ^0.39 dependency bump in this PR.

The web panel's runtime stack is unaffected (PHP 8.5; the only
client-side TS check runs over `web/scripts/` and stays on Node 20
via `ts-check.yml`).

* docs(starlight): migrate social config from record to array shape

Starlight 0.33 (in the 0.30 → 0.39 bump landing here) changed the
`social` integration option from a `Record<KnownPlatform, url>` map
to a `[{icon, label, href}]` array. The old shape now fails the
config schema with "Starlight v0.33.0 changed the `social` configuration
syntax. Please specify an array of link items instead of an object."

Migrating both the GitHub and Discord entries preserves the topbar
icon row exactly. The pre-fix comment block at the call site already
anticipated this exact migration; the surrounding rationale was
moved into the new comment.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: rumblefrog <contact@zhenyangli.me>

Author: dependabot[bot]

.github/workflows/docs-build.yml

@@ -35,7 +35,11 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          # Astro 6 requires Node >=22.12; 20 trips an EBADENGINE on `npm
+          # ci` and a hard "Node.js v20 is not supported by Astro!" on
+          # `astro build`. Bumped together with the docs astro+starlight
+          # group bump (#1346).
+          node-version: '22'
           cache: 'npm'
           cache-dependency-path: docs/package-lock.json
 

.github/workflows/docs-screenshots-build.yml

@@ -43,7 +43,10 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          # Astro 6 requires Node >=22.12; mirrors the bump in
+          # docs-build.yml that landed with the docs astro+starlight
+          # group bump (#1346).
+          node-version: '22'
           cache: 'npm'
           cache-dependency-path: docs/package-lock.json
 

.github/workflows/docs-screenshots-capture.yml

@@ -143,7 +143,10 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          # Astro 6 requires Node >=22.12; mirrors the bump in
+          # docs-build.yml that landed with the docs astro+starlight
+          # group bump (#1346).
+          node-version: '22'
           cache: 'npm'
           cache-dependency-path: trusted/docs/package-lock.json
 

docs/astro.config.mjs

@@ -58,16 +58,23 @@ export default defineConfig({
           attrs: { name: 'theme-color', content: '#ea580c' },
         },
       ],
-      // Starlight 0.30 takes `social` as a record keyed by platform
-      // name (the schema is `Record<KnownPlatform, url>` in
-      // node_modules/@astrojs/starlight/schemas/social.ts). Newer
-      // Starlight (>= 0.32-ish) expanded this to the
-      // `[{icon, label, href}]` array shape; bump this when the
-      // dependency floor moves.
-      social: {
-        github: 'https://github.com/sbpp/sourcebans-pp',
-        discord: 'https://discord.gg/tzqYqmAtF5',
-      },
+      // Starlight 0.33 changed `social` from a `Record<KnownPlatform, url>`
+      // map to a `[{icon, label, href}]` array (see the changelog at
+      // https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md#0330).
+      // Migrated alongside the @astrojs/starlight ^0.30 → ^0.39 bump
+      // in this PR.
+      social: [
+        {
+          icon: 'github',
+          label: 'GitHub',
+          href: 'https://github.com/sbpp/sourcebans-pp',
+        },
+        {
+          icon: 'discord',
+          label: 'Discord',
+          href: 'https://discord.gg/tzqYqmAtF5',
+        },
+      ],
       editLink: {
         // Source of truth lives in sourcebans-pp; the deploy shell is
         // sbpp.github.io. Edit links point back here.