@lupinum/ginko-docs 0.2.2 → 0.2.5

package/content.ts

@@ -1,5 +1,4 @@
 import {
-  defineAgentAppPage,
   defineAgentMetadataFields,
   defineAgentSection,
   defineCollection,
@@ -10,10 +9,27 @@ import type { ContentCollectionConfig, ContentConfig } from "@lupinum/ginko-cont
 import { z } from "zod";
 import { routeSlugs } from "./shared/route-slugs";
 
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Expected an ISO date (YYYY-MM-DD)");
+const nonEmptyString = z.string().trim().min(1);
+/** Former public URLs of a page, as served: locale prefix and translated slugs included. */
+const redirectFrom = z
+  .array(nonEmptyString.regex(/^\//, "redirectFrom entries must be absolute site paths"))
+  .optional();
+
+/**
+ * Derives the sitemap lastmod from the authored date so it has one source of
+ * truth. Route records require normalized UTC ISO values.
+ */
+const withSitemapLastmod = <T extends object>(data: T, lastmod: string | undefined) =>
+  lastmod ? { ...data, sitemap: { lastmod: `${lastmod}T00:00:00.000Z` } } : data;
+
 export interface GinkoDocsContentOptions {
-  site: { name: string; description: string; url: string };
-  locales?: Array<"en" | "de">;
-  defaultLocale?: "en" | "de";
+  site: {
+    name: string | { en: string; de: string };
+    description: string | { en: string; de: string };
+    url: string;
+  };
+  locales?: readonly ["en"] | readonly ["en", "de"];
   blog?: boolean;
 }
 
@@ -22,7 +38,8 @@ const docsSchema = z.object({
   description: z.string(),
   icon: z.string().optional(),
   badge: z.string().optional(),
-  updated: z.string().optional(),
+  updated: isoDate.optional(),
+  redirectFrom,
   sidebar: z.enum(["section", "group"]).optional(),
   navigation: z
     .object({
@@ -33,15 +50,20 @@ const docsSchema = z.object({
     })
     .optional(),
 });
+const docsSchemaWithLastmod = docsSchema.transform((data) =>
+  withSitemapLastmod(data, data.updated),
+);
 const blogSchema = z.object({
   title: z.string(),
   description: z.string(),
   badge: z.string().optional(),
-  date: z.string(),
-  readingTime: z.string(),
+  date: isoDate,
+  readingTime: nonEmptyString,
   author: reference("authors"),
   image: z.string().optional(),
+  redirectFrom,
 });
+const blogSchemaWithLastmod = blogSchema.transform((data) => withSitemapLastmod(data, data.date));
 const authorsSchema = z.object({
   slug: z.string(),
   name: z.string(),
@@ -51,8 +73,8 @@ const authorsSchema = z.object({
   links: z.array(z.object({ label: z.string(), href: z.string() })).optional(),
 });
 
-type DocsCollection = ContentCollectionConfig<typeof docsSchema>;
-type BlogCollection = ContentCollectionConfig<typeof blogSchema>;
+type DocsCollection = ContentCollectionConfig<typeof docsSchemaWithLastmod>;
+type BlogCollection = ContentCollectionConfig<typeof blogSchemaWithLastmod>;
 type AuthorsCollection = ContentCollectionConfig<typeof authorsSchema>;
 type DocsContentConfig = ContentConfig<{ docs: DocsCollection }>;
 type DocsBlogContentConfig = ContentConfig<{
@@ -69,10 +91,14 @@ export function defineGinkoDocsConfig(
   options: GinkoDocsContentOptions,
 ): DocsContentConfig | DocsBlogContentConfig {
   const locales = options.locales ?? ["en"];
-  const defaultLocale = options.defaultLocale ?? locales[0] ?? "en";
-  const i18n = locales.length > 1;
-  const routeMap = (key: "docs" | "blog") =>
-    Object.fromEntries(locales.map((locale) => [locale, routeSlugs[key][locale]]));
+  const validLocales =
+    locales.length === 1
+      ? locales[0] === "en"
+      : locales.length === 2 && locales[0] === "en" && locales[1] === "de";
+  if (!validLocales) {
+    throw new TypeError('locales must be exactly ["en"] or ["en", "de"]');
+  }
+  const i18n = locales.length === 2;
   const metadata = defineAgentMetadataFields([
     "title",
     "description",
@@ -88,19 +114,19 @@ export function defineGinkoDocsConfig(
     type: "page",
     source: i18n ? "{1.docs,1.dokumentation}/**/*.md" : "docs/**/*.md",
     i18n: i18n ? true : undefined,
-    route: i18n ? routeMap("docs") : routeSlugs.docs[defaultLocale],
+    route: i18n ? routeSlugs.docs : routeSlugs.docs.en,
     agent: { section: "optional", markdown: true },
     strict: true,
-    schema: docsSchema,
+    schema: docsSchemaWithLastmod,
   });
   const blog = defineCollection({
     type: "page",
-    source: "2.blog/**/*.md",
+    source: "2.blog/*.md",
     i18n: i18n ? true : undefined,
-    route: i18n ? routeMap("blog") : routeSlugs.blog[defaultLocale],
+    route: i18n ? routeSlugs.blog : routeSlugs.blog.en,
     agent: { section: "blog", markdown: true },
     strict: true,
-    schema: blogSchema,
+    schema: blogSchemaWithLastmod,
   });
   const authors = defineCollection({
     type: "data",
@@ -119,20 +145,13 @@ export function defineGinkoDocsConfig(
       },
       markdown: { metadata: { enabled: true, defaultFields: metadata } },
       sections: [
-        ...(options.blog ? [defineAgentSection({ id: "blog", title: "Blog", order: 40 })] : []),
-        defineAgentSection({ id: "optional", title: "Documentation", order: 100 }),
-      ],
-      pages: [
-        defineAgentAppPage({
-          id: "home",
-          route: Object.fromEntries(
-            locales.map((locale) => [locale, locale === defaultLocale ? "/" : `/${locale}`]),
-          ),
-          section: "optional",
-          title: options.site.name,
-          description: options.site.description,
-          metadata,
-          render: () => `# ${options.site.name}\n\n> ${options.site.description}`,
+        ...(options.blog
+          ? [defineAgentSection({ id: "blog", title: { en: "Blog", de: "Blog" }, order: 40 })]
+          : []),
+        defineAgentSection({
+          id: "optional",
+          title: { en: "Documentation", de: "Dokumentation" },
+          order: 100,
         }),
       ],
     },

package/i18n/messages/global/blog.ts

@@ -11,4 +11,8 @@ export const blog = {
   toc: { de: "Im Artikel", en: "In this article" },
   readMore: { de: "Weiterlesen", en: "Read more" },
   moreArticles: { de: "Weitere Artikel", en: "More articles" },
+  empty: {
+    de: "Noch keine Artikel veröffentlicht.",
+    en: "No articles have been published yet.",
+  },
 } as const;

package/i18n/messages/global/command.ts

@@ -19,10 +19,14 @@ export const command = {
     recent: { de: "Zuletzt", en: "Recent" },
     pages: { de: "Navigation", en: "Navigation" },
     docs_nav: { de: "Docs-Navigation", en: "Docs Navigation" },
-    blog: { de: "Blog-Ergebnisse", en: "Blog Results" },
-    docs: { de: "Docs-Ergebnisse", en: "Docs Results" },
+    search: { de: "Suchergebnisse", en: "Search results" },
     actions: { de: "Aktionen", en: "Actions" },
   },
+  loading: { de: "Suche läuft …", en: "Searching…" },
+  error: {
+    de: "Die Suche ist gerade nicht verfügbar. Versuche es erneut.",
+    en: "Search is temporarily unavailable. Please try again.",
+  },
   pages: {
     home: {
       title: { de: "Start", en: "Home" },

package/i18n/messages/global/docs.ts

@@ -14,7 +14,10 @@ export const docs = {
   copiedText: { de: "Text kopiert", en: "Copied text" },
   copyFailed: { de: "Kopieren fehlgeschlagen", en: "Copy failed" },
   codeSample: { de: "Codebeispiel", en: "Code sample" },
+  showAllLines: { de: "Alle {count} Zeilen anzeigen", en: "Show all {count} lines" },
+  showMore: { de: "Mehr anzeigen", en: "Show more" },
   zoomImage: { de: "Bild vergrößern", en: "Zoom image" },
+  lastUpdated: { de: "Zuletzt aktualisiert", en: "Last updated" },
   moreActions: { de: "Weitere Seitenaktionen", en: "More page actions" },
   copyLink: { de: "Markdown-Link kopieren", en: "Copy Markdown link" },
   viewMarkdown: { de: "Als Markdown anzeigen", en: "View as Markdown" },
@@ -22,6 +25,7 @@ export const docs = {
   askClaude: { de: "In Claude öffnen", en: "Open in Claude" },
   copyMcpUrl: { de: "MCP-Server-URL kopieren", en: "Copy MCP server URL" },
   contribute: { de: "Zu dieser Seite beitragen", en: "Contribute to this page" },
+  backToTop: { de: "Nach oben", en: "Back to top" },
   editPage: { de: "Diese Seite bearbeiten", en: "Edit this page" },
   reportIssue: { de: "Problem melden", en: "Report an issue" },
   issueTitle: { de: "Dokumentation: {title}", en: "Docs: {title}" },

package/i18n/messages/global/nav.ts

@@ -3,8 +3,12 @@ export const nav = {
   home: { de: "Startseite", en: "Home" },
   main: { de: "Hauptnavigation", en: "Main navigation" },
   mobile: { de: "Mobile Navigation", en: "Mobile navigation" },
-  navigationSection: { de: "Navigation", en: "Navigation" },
-  settingsHelp: { de: "Einstellungen & Hilfe", en: "Settings & Help" },
+  menu: { de: "Menü", en: "Menu" },
+  docsDescription: {
+    de: "Anleitungen, Komponenten, Referenz",
+    en: "Guides, components, reference",
+  },
+  blogDescription: { de: "Releases und Artikel", en: "Releases and writing" },
   language: { de: "Sprache wechseln", en: "Change language" },
   openMenu: { de: "Menü öffnen", en: "Open menu" },
   closeMenu: { de: "Menü schließen", en: "Close menu" },
@@ -13,6 +17,5 @@ export const nav = {
   company: { de: "Unternehmen", en: "Company" },
   documentation: { de: "Dokumentation", en: "Documentation" },
   blog: { de: "Blog", en: "Blog" },
-  github: { de: "GitHub", en: "GitHub" },
   externalLink: { de: "externer Link", en: "external link" },
 } as const;

package/i18n/messages/index.ts

@@ -1,19 +1,19 @@
 import { type LocaleCode, localeCodes } from "../locales";
 import { localizedRoutes } from "../routes";
+import { globalMessages } from "./global";
 import { localizeMessages } from "./localize";
-import { messageSource } from "./source";
 
 export const messages = localeCodes.reduce(
   (localizedMessages, locale) => {
     localizedMessages[locale] = {
-      ...localizeMessages(messageSource, locale),
+      ...localizeMessages(globalMessages, locale),
       routes: localizedRoutes[locale],
     };
     return localizedMessages;
   },
   {} as Record<
     LocaleCode,
-    ReturnType<typeof localizeMessages<typeof messageSource>> & {
+    ReturnType<typeof localizeMessages<typeof globalMessages>> & {
       routes: (typeof localizedRoutes)[LocaleCode];
     }
   >,

package/icon-bundle.ts

@@ -12,12 +12,14 @@ export const layerIconNames = [
   "logos:yarn",
   "lucide:arrow-left",
   "lucide:arrow-right",
+  "lucide:arrow-up",
   "lucide:arrow-up-right",
   "lucide:atom",
   "lucide:badge-check",
   "lucide:blocks",
   "lucide:book-open",
   "lucide:bookmark",
+  "lucide:calendar",
   "lucide:braces",
   "lucide:building-2",
   "lucide:check",
@@ -41,6 +43,8 @@ export const layerIconNames = [
   "lucide:file-json",
   "lucide:file-key",
   "lucide:file-text",
+  "lucide:folder",
+  "lucide:folder-open",
   "lucide:git-branch",
   "lucide:github",
   "lucide:hash",
@@ -49,6 +53,7 @@ export const layerIconNames = [
   "lucide:lightbulb",
   "lucide:link",
   "lucide:linkedin",
+  "lucide:loader-circle",
   "lucide:list",
   "lucide:menu",
   "lucide:message-circle",
@@ -74,68 +79,16 @@ export const layerIconNames = [
   "lucide:zap",
 ] as const;
 
-type IconTransform = {
-  width?: number;
-  height?: number;
-  left?: number;
-  top?: number;
-  rotate?: number;
-  hFlip?: boolean;
-  vFlip?: boolean;
-};
-type IconData = IconTransform & { body: string };
-type IconAlias = IconTransform & { parent: string };
 type IconCollection = {
   prefix: string;
   width?: number;
   height?: number;
-  icons: Record<string, IconData>;
-  aliases?: Record<string, IconAlias>;
+  icons: Record<string, { body: string }>;
+  aliases?: Record<string, { parent: string }>;
 };
 
 const require = createRequire(import.meta.url);
-const sourceCollections = new Map<string, IconCollection>(
-  ["circle-flags", "logos", "lucide"].map((prefix) => [
-    prefix,
-    require(`@iconify-json/${prefix}/icons.json`) as IconCollection,
-  ]),
-);
-
-export const layerIconCollections: IconCollection[] = [...sourceCollections.values()].map(
-  ({ prefix, width, height }) => ({ prefix, width, height, icons: {}, aliases: {} }),
-);
 
-const bundledCollections = new Map(
-  layerIconCollections.map((collection) => [collection.prefix, collection]),
+export const layerIconCollections = ["circle-flags", "logos", "lucide"].map(
+  (prefix) => require(`@iconify-json/${prefix}/icons.json`) as IconCollection,
 );
-
-function includeIcon(prefix: string, name: string, seen = new Set<string>()) {
-  const key = `${prefix}:${name}`;
-  if (seen.has(key)) return;
-  seen.add(key);
-
-  const source = sourceCollections.get(prefix);
-  const target = bundledCollections.get(prefix);
-  if (!source || !target) return;
-
-  const icon = source.icons[name];
-  if (icon) {
-    target.icons[name] = icon;
-    return;
-  }
-
-  const alias = source.aliases?.[name];
-  if (!alias) return;
-  target.aliases![name] = alias;
-  includeIcon(prefix, alias.parent, seen);
-}
-
-export function includeIconNames(names: Iterable<string>) {
-  for (const icon of names) {
-    const separator = icon.indexOf(":");
-    if (separator < 1) continue;
-    includeIcon(icon.slice(0, separator), icon.slice(separator + 1));
-  }
-}
-
-includeIconNames(layerIconNames);

package/index.d.ts

@@ -1,12 +1,18 @@
 import type { GinkoDocsAppConfig } from "./shared/types/app-config";
 
+type GinkoDocsAppConfigInput<T> = T extends readonly unknown[]
+  ? T
+  : T extends object
+    ? { [Key in keyof T]?: GinkoDocsAppConfigInput<T[Key]> }
+    : T;
+
 declare module "nuxt/schema" {
   interface AppConfig {
     ginkoDocs: GinkoDocsAppConfig;
   }
 
   interface AppConfigInput {
-    ginkoDocs?: Partial<GinkoDocsAppConfig>;
+    ginkoDocs?: GinkoDocsAppConfigInput<GinkoDocsAppConfig>;
   }
 }
 

package/modules/feature-routing.ts

@@ -1,10 +1,16 @@
 import { defineNuxtModule } from "@nuxt/kit";
 import type {} from "@lupinum/ginko-content";
+import { localeCodes, localizedPath } from "../i18n/locales";
+import { routeSlugs } from "../shared/route-slugs";
 
 interface PageRoute {
   path: string;
 }
 
+export const blogFeedRoutes = localeCodes.map(
+  (locale) => `${localizedPath(locale, routeSlugs.blog[locale])}/rss.xml`,
+);
+
 export function removeBlogPages(pages: PageRoute[], blogEnabled: boolean) {
   if (blogEnabled) return;
 
@@ -28,5 +34,14 @@ export default defineNuxtModule({
     nuxt.hook("pages:extend", (pages) => {
       removeBlogPages(pages, blogEnabled);
     });
+
+    // content:context runs before Nitro config is finalized, so the feed
+    // routes only prerender when the consuming app enables the blog.
+    nuxt.hook("nitro:config", (nitroConfig) => {
+      if (!blogEnabled) return;
+      nitroConfig.prerender ??= {};
+      nitroConfig.prerender.routes ??= [];
+      nitroConfig.prerender.routes.push(...blogFeedRoutes);
+    });
   },
 });

package/nuxt.config.ts

@@ -6,7 +6,9 @@ import darkPlus from "shiki/dist/themes/dark-plus.mjs";
 import lightPlus from "shiki/dist/themes/light-plus.mjs";
 import { contentComponentPolicy, contentComponentTags } from "./tags";
 import { i18nPages } from "./i18n/routes";
-import { includeIconNames, layerIconCollections, layerIconNames } from "./icon-bundle";
+import { localeCodes, localizedPath } from "./i18n/locales";
+import { routeSlugs } from "./shared/route-slugs";
+import { layerIconCollections, layerIconNames } from "./icon-bundle";
 
 const root = dirname(fileURLToPath(import.meta.url));
 const app = join(root, "app");
@@ -41,7 +43,7 @@ export default defineNuxtConfig({
   },
   mcp: {
     name: "Ginko Docs",
-    version: "0.2.2",
+    version: "0.2.5",
   },
   components: {
     dirs: [
@@ -57,6 +59,7 @@ export default defineNuxtConfig({
           "SiteLocaleSwitcher.vue",
           "SiteLogoMark.vue",
           "SiteSkipLink.vue",
+          "SiteSocialLinks.vue",
         ],
       },
       {
@@ -69,7 +72,6 @@ export default defineNuxtConfig({
       { path: join(app, "components/prose"), pathPrefix: false, global: true },
     ],
   },
-  imports: { autoImport: false },
   colorMode: { classSuffix: "" },
   icon: {
     provider: "none",
@@ -116,6 +118,9 @@ export default defineNuxtConfig({
   },
   content: {
     componentPolicy: contentComponentPolicy,
+    // Broken internal links and missing #anchors fail the build instead of
+    // only landing in the validation report.
+    validation: "error",
     i18n: {
       translatedSlugs: true,
     },
@@ -142,6 +147,9 @@ export default defineNuxtConfig({
   },
   sitemap: {
     excludeAppSources: ["nuxt:prerender"],
+    // The docs roots prerender as redirects to the first docs page; a sitemap
+    // must not list redirecting URLs.
+    exclude: localeCodes.map((locale) => localizedPath(locale, routeSlugs.docs[locale])),
   },
   app: {
     head: {
@@ -152,9 +160,6 @@ export default defineNuxtConfig({
     },
   },
   hooks: {
-    "icon:clientBundleIcons"(icons) {
-      includeIconNames(icons);
-    },
     "components:dirs"(dirs) {
       const defaultComponentsDir = join(app, "components").replaceAll("\\", "/");
       const filtered = dirs.filter((entry) => {
@@ -172,7 +177,15 @@ export default defineNuxtConfig({
       concurrency: 1,
       crawlLinks: true,
       failOnError: true,
-      routes: ["/llms.txt", "/llms-full.txt", "/sitemap.xml", "/robots.txt"],
+      routes: [
+        "/llms.txt",
+        "/llms-full.txt",
+        "/sitemap.xml",
+        "/robots.txt",
+        // Link page over every authored redirectFrom source; crawling it
+        // materializes the redirect stubs.
+        "/api/_ginko-docs/redirects",
+      ],
     },
   },
   vite: {
@@ -181,6 +194,7 @@ export default defineNuxtConfig({
         "@vueuse/core",
         "class-variance-authority",
         "clsx",
+        "motion-v",
         "reka-ui",
         "tailwind-merge",
         "zod",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lupinum/ginko-docs",
-  "version": "0.2.2",
-  "description": "A polished Nuxt documentation layer powered by Ginko Content.",
+  "version": "0.2.5",
+  "description": "A Nuxt documentation layer powered by Ginko Content.",
   "keywords": [
     "content",
     "documentation",
@@ -52,40 +52,43 @@
   },
   "dependencies": {
     "@iconify-json/circle-flags": "^1.2.10",
-    "@iconify-json/logos": "^1.2.11",
-    "@iconify-json/lucide": "^1.2.111",
+    "@iconify-json/logos": "^1.2.12",
+    "@iconify-json/lucide": "^1.2.123",
     "@nuxt/fonts": "^0.14.0",
-    "@nuxt/icon": "^2.2.3",
-    "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.4.6",
-    "@nuxt/scripts": "^0.13.2",
-    "@nuxtjs/color-mode": "^4.0.0",
-    "@nuxtjs/i18n": "^10.4.0",
-    "@nuxtjs/mcp-toolkit": "0.17.2",
-    "@nuxtjs/robots": "^6.1.2",
-    "@nuxtjs/sitemap": "^8.2.2",
-    "@resvg/resvg-js": "^2.6.0",
-    "@shikijs/transformers": "^4.2.0",
-    "@tailwindcss/vite": "^4.3.0",
-    "@vueuse/core": "^14.2.1",
+    "@nuxt/icon": "^2.5.0",
+    "@nuxt/image": "^2.1.0",
+    "@nuxt/kit": "^4.5.2",
+    "@nuxt/scripts": "^1.3.3",
+    "@nuxtjs/color-mode": "^4.0.1",
+    "@nuxtjs/i18n": "^10.6.0",
+    "@nuxtjs/mcp-toolkit": "0.18.1",
+    "@nuxtjs/robots": "^6.1.4",
+    "@nuxtjs/sitemap": "^8.3.4",
+    "@resvg/resvg-js": "^2.6.2",
+    "@shikijs/transformers": "^4.4.3",
+    "@tailwindcss/vite": "^4.3.3",
+    "@vueuse/core": "^14.4.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "h3": "^1.15.4",
+    "motion-v": "^2.3.0",
     "nitropack": "^2.13.4",
-    "nuxt-og-image": "^6.7.2",
-    "reka-ui": "^2.9.2",
-    "satori": "^0.19.2",
-    "shiki": "^4.0.2",
-    "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.2",
+    "nuxt-og-image": "^6.7.7",
+    "reka-ui": "^2.10.3",
+    "satori": "^0.29.0",
+    "shiki": "^4.4.3",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.3",
     "tw-animate-css": "^1.4.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@lupinum/ginko-content": ">=0.3.0-rc.2 <0.4.0",
-    "nuxt": "^4.4.6",
+    "@lupinum/ginko-content": ">=0.3.5 <0.4.0",
+    "nuxt": ">=4.4.7 <5",
     "vue": "^3.5.35",
     "vue-router": "^5.1.0"
   },
+  "engines": {
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
+  },
   "scripts": {}
 }

package/runtime/server/agent-markdown.ts

@@ -8,8 +8,6 @@ import { contentComponentTags } from "../../tags";
 const renderXmlComponent: AgentMarkdownSerializer = (node, ctx) =>
   ctx.xmlComponent(node.tag || "component", ctx.cleanProps(node), ctx.renderChildren(node));
 
-export const contentComponentAgentMarkdownTags = Object.keys(contentComponentTags);
-
 export function registerContentComponentAgentMarkdownSerializers() {
   const serializers: AgentMarkdownSerializerMap = {};
   for (const [tag, component] of Object.entries(contentComponentTags)) {

package/server/api/_ginko-docs/redirects.get.ts

@@ -0,0 +1,28 @@
+import { defineEventHandler, setHeader } from "h3";
+import { loadRedirectMap } from "../../utils/redirects";
+
+const escapeHtml = (value: string) =>
+  value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+
+/**
+ * Prerender seed: returns a link page of every `redirectFrom` source so the
+ * crawler visits each old path and materializes its redirect stub. Conflict
+ * validation throws here, which fails the build via `failOnError`.
+ */
+export default defineEventHandler(async (event) => {
+  const redirects = await loadRedirectMap(event);
+
+  if (import.meta.prerender) {
+    setHeader(event, "content-type", "text/html; charset=utf-8");
+    const links = Array.from(redirects.keys())
+      .map((source) => `<a href="${escapeHtml(source)}"></a>`)
+      .join("");
+    return `<!doctype html><html><head><meta charset="utf-8"></head><body>${links}</body></html>`;
+  }
+
+  return { count: redirects.size, redirects: Object.fromEntries(redirects) };
+});

package/server/middleware/redirects.ts

@@ -0,0 +1,22 @@
+import { defineEventHandler, sendRedirect } from "h3";
+import { loadRedirectMap } from "../utils/redirects";
+import { normalizeRedirectPath } from "../utils/redirects.utils";
+
+/**
+ * Serves authored `redirectFrom` moves as 301s. During prerender this runs
+ * before the catch-all page would SSR a 404 for the crawled old path, so the
+ * static build materializes the same meta-refresh stub the docs root uses.
+ */
+export default defineEventHandler(async (event) => {
+  if (event.method !== "GET" && event.method !== "HEAD") return;
+
+  const path = normalizeRedirectPath(event.path);
+  const lastSegment = path.slice(path.lastIndexOf("/") + 1);
+  if (path.startsWith("/api/") || path.startsWith("/_") || lastSegment.includes(".")) return;
+
+  const redirects = await loadRedirectMap(event);
+  const target = redirects.get(path);
+  if (target) {
+    return sendRedirect(event, target, 301);
+  }
+});

package/server/routes/[locale]/blog/rss.xml.get.ts

@@ -0,0 +1,13 @@
+import { createError, defineEventHandler, getRouterParam } from "h3";
+import { defaultLocale, isLocaleCode } from "../../../../i18n/locales";
+import { serveBlogFeed } from "../../../utils/blog-feed";
+
+// A param route keeps the router free of static locale segments; a static
+// /de/... node would shadow ginko-content's /:locale/llms.txt routes.
+export default defineEventHandler(async (event) => {
+  const locale = getRouterParam(event, "locale");
+  if (!locale || !isLocaleCode(locale) || locale === defaultLocale) {
+    throw createError({ statusCode: 404, statusMessage: "Page not found" });
+  }
+  return serveBlogFeed(event, locale);
+});

package/server/routes/blog/rss.xml.get.ts

@@ -0,0 +1,5 @@
+import { defineEventHandler } from "h3";
+import { defaultLocale } from "../../../i18n/locales";
+import { serveBlogFeed } from "../../utils/blog-feed";
+
+export default defineEventHandler((event) => serveBlogFeed(event, defaultLocale));