Merge branch 'main' into hd-draft-pages

* main: (63 commits)
  Add translation for copy button (withastro#1788)
  Update astro-expressive-code (withastro#1720)
  Fix type inference for extended i18n schemas (withastro#1786)
  Fix TypeScript schema error when using project references (withastro#1777)
  Update fa.json (withastro#1793)
  i18n(fr): update `resources/community-content.mdx` (withastro#1795)
  [ci] format
  i18n(ko-KR): update `community-content.mdx` (withastro#1794)
  [ci] format
  Adds Starlight in Next.js project video (withastro#1789)
  [ci] format
  i18n(ru): update translations (withastro#1783)
  i18n(id): Update getting-started.mdx (withastro#1778)
  Upgrade Lunaria and add Action (withastro#1768)
  [ci] format
  i18n(es): update `sidebar` (withastro#1767)
  i18n(pt-br): Update `getting-started.mdx` (withastro#1776)
  i18n(es): update `configuration` (withastro#1766)
  [ci] format
  Add TrueCharts to showcases (withastro#1773)
  ...

.changeset/healthy-boxes-smoke.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Adds Russian translations for Expressive Code labels

.changeset/spotty-eggs-sit.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Fixes type inference for i18n strings added by extending the default schema

.changeset/spotty-mice-travel.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Fixes an issue where TypeScript could fail to serialize the frontmatter schema when configured to emit declaration files

.changeset/strong-moose-jam.md

@@ -0,0 +1,7 @@
+---
+'@astrojs/starlight': minor
+---
+
+Updates `astro-expressive-code` dependency to the latest minor release (0.35) and exposes a new `@astrojs/starlight/expressive-code/hast` module for users who need to use Expressive Code’s version of `hast`.
+
+This includes a potentially breaking change if you use custom Expressive Code plugins. See the [Expressive Code release notes](https://expressive-code.com/releases/#0340) for full details.

.changeset/sweet-vans-carry.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Refactors `<ThemeSelect>` custom element logic to improve performance

.changeset/swift-files-wave.md

@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Fixes responding to system color scheme changes when theme is `auto`

.changeset/tiny-walls-carry.md

@@ -0,0 +1,5 @@
+---
+"@astrojs/starlight": patch
+---
+
+Updates the Farsi UI translations

.github/workflows/file-icons.yml

@@ -0,0 +1,45 @@
+name: File icons generator
+
+on:
+  schedule:
+    - cron: '0 0 * * 0'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  icons:
+    name: Generate file icons
+    if: github.repository_owner == 'withastro'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v3
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: 'pnpm'
+
+      - name: Install Dependencies
+        run: pnpm i
+
+      - name: Run file icons generator
+        run: pnpm build
+        working-directory: packages/file-icons-generator
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          branch: ci/file-icons
+          token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
+          commit-message: 'ci: update file icons'
+          title: 'ci: update file icons'
+          body: |
+            This PR is auto-generated by a GitHub action to update the file icons and file tree definitions available in Starlight.

.github/workflows/lunaria.yml

@@ -0,0 +1,46 @@
+name: Lunaria
+
+on:
+  # Trigger the workflow every time a pull request is opened or synchronized at the target `main` branch
+  pull_request_target:
+    types: [opened, synchronize]
+    branches: [main]
+    paths:
+      - 'docs/**'
+
+# Allow this job to clone the repository and comment on the pull request
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  lunaria-overview:
+    name: Generate Lunaria Overview
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        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@v3
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+        shell: bash
+
+      - name: Generate Lunaria Overview
+        uses: yanthomasdev/lunaria-action@f60cb4c257e95ab41fc44356c4a852fe614e3bb4
+        with:
+          token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
+          working-directory: docs

docs/lunaria.config.json

@@ -73,7 +73,8 @@
   "files": [
     {
       "location": "src/content/docs/**/*.{md,mdx}",
-      "pattern": "src/content/docs/@lang/@path"
+      "pattern": "src/content/docs/@lang/@path",
+      "type": "universal"
     }
   ],
   "dashboard": {

docs/package.json

@@ -16,7 +16,7 @@
   "dependencies": {
     "@astro-community/astro-embed-youtube": "^0.4.4",
     "@astrojs/starlight": "workspace:*",
-    "@lunariajs/core": "^0.0.25",
+    "@lunariajs/core": "^0.0.32",
     "@types/culori": "^2.0.0",
     "astro": "^4.3.5",
     "culori": "^3.2.0",

docs/src/components/showcase-sites.astro

@@ -126,4 +126,5 @@ import FluidGrid from './fluid-grid.astro';
 		href="https://docs.fontawesome.com/"
 		thumbnail="docs.fontawesome.com.png"
 	/>
+	<Card title="TrueCharts" href="https://truecharts.org/" thumbnail="truecharts.org.png" />
 </FluidGrid>

docs/src/components/sidebar-preview.astro

@@ -17,7 +17,10 @@ function makeEntries(items: SidebarConfig): SidebarEntry[] {
 			return {
 				type: 'link',
 				label: item.label,
-				href: item.link,
+				// Empty hrefs are used to represent internal links that do not exist in the Starlight
+				// docs. Using a non-existing anchor link like `#_` will not trigger a page reload or any
+				// scrolling.
+				href: item.link.length > 0 ? item.link : '#_',
 				isCurrent: false,
 				badge: item.badge,
 				attrs: item.attrs ?? {},