feat: Upgrade to Astro v5

Author: VisualEhrmanntraut

astro.config.mjs

@@ -1,3 +1,4 @@
+// @ts-check
 import { defineConfig } from "astro/config";
 import embeds from "astro-embed/integration";
 import starlight from "@astrojs/starlight";
@@ -108,9 +109,7 @@ export default defineConfig({
           "https://github.com/ChefKissInc/ChefKissInc.github.io/edit/master/",
       },
     }),
-    tailwind({
-      applyBaseStyles: false,
-    }),
+    tailwind({ applyBaseStyles: false }),
     icon(),
   ],
 });

package.json

@@ -10,23 +10,26 @@
     "preview": "astro preview",
     "astro": "astro"
   },
-  "dependencies": {
+  "devDependencies": {
     "@astrojs/check": "^0.9.4",
-    "@astrojs/starlight": "^0.29.3",
-    "@astrojs/starlight-tailwind": "^2.0.3",
-    "@astrojs/tailwind": "^5.1.3",
+    "@astrojs/starlight": "^0.32.2",
+    "@astrojs/starlight-tailwind": "^3.0.0",
+    "@astrojs/tailwind": "^5.1.5",
     "@iconify-json/ph": "^1.2.2",
-    "astro": "^4.16.18",
+    "astro": "^5.5.2",
     "astro-embed": "^0.9.0",
-    "astro-icon": "^1.1.4",
-    "astro-og-canvas": "^0.5.5",
-    "astro-vtbot": "^1.10.7",
+    "astro-icon": "^1.1.5",
+    "astro-og-canvas": "^0.7.0",
+    "astro-vtbot": "^2.1.1",
     "canvaskit-wasm": "^0.39.1",
     "sharp": "^0.33.5",
-    "starlight-blog": "^0.15.0",
-    "starlight-image-zoom": "^0.9.0",
-    "starlight-links-validator": "^0.13.4",
+    "starlight-blog": "^0.18.0",
+    "starlight-image-zoom": "^0.11.1",
+    "starlight-links-validator": "^0.14.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.7.2"
+    "typescript": "^5.8.2"
+  },
+  "pnpm": {
+    "neverBuiltDependencies": []
   }
 }

pnpm-lock.yaml

@@ -1,13 +1,12 @@
 ---
-import type { Props } from "@astrojs/starlight/props";
 import StarlightHead from "@astrojs/starlight/components/Head.astro";
 import VtbotStarlight from "astro-vtbot/components/starlight/Base.astro";
 import PageOffset from "astro-vtbot/components/PageOffset.astro";
 import PageOrder from "astro-vtbot/components/starlight/PageOrder.astro";
 import ProgressBar from "astro-vtbot/components/ProgressBar.astro";
 import AutoNameSelected from "astro-vtbot/components/AutoNameSelected.astro";
 
-let imagePath = `${Astro.props.slug || "index"}.png`;
+let imagePath = `${Astro.locals.starlightRoute.entry.id || "index"}.png`;
 if (Astro.props.isFallback) {
 	imagePath = 'en' + imagePath.slice(imagePath.indexOf('/'));
 }

public/favicon.svg

@@ -1,6 +1,5 @@
 ---
 import StarlightBlogMarkdownContent from "starlight-blog/overrides/MarkdownContent.astro";
-import type { Props } from "@astrojs/starlight/props";
 
 import ImageZoom from "starlight-image-zoom/components/ImageZoom.astro";
 ---

src/components/starlight/Head.astro

@@ -2,7 +2,6 @@
 ---
 import config from "virtual:starlight/user-config";
 import { Icon } from "astro-icon/components";
-import type { Props } from "@astrojs/starlight/props";
 
 type Platform = keyof NonNullable<typeof config.social>;
 type SocialConfig = NonNullable<NonNullable<typeof config.social>[Platform]>;

src/components/starlight/MarkdownContent.astro

@@ -1,10 +1,15 @@
 import { defineCollection } from "astro:content";
+import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders";
 import { docsSchema, i18nSchema } from "@astrojs/starlight/schema";
 import { blogSchema } from "starlight-blog/schema";
 
 export const collections = {
   docs: defineCollection({
+    loader: docsLoader(),
     schema: docsSchema({ extend: (context) => blogSchema(context) }),
   }),
-  i18n: defineCollection({ type: "data", schema: i18nSchema() }),
+  i18n: defineCollection({
+    loader: i18nLoader(),
+    schema: i18nSchema(),
+  }),
 };

src/components/starlight/SocialIcons.astro

@@ -1,2 +1,4 @@
 /// <reference path="../.astro/types.d.ts" />
+/// <reference path="../.astro/icon.d.ts" />
 /// <reference types="astro/client" />
+/// <reference types="astro-icon/types" />