From 96aa31bcc421f2d5a899edf3275f2cb5bb37e79f Mon Sep 17 00:00:00 2001
From: Rich Harris <rich.harris@vercel.com>
Date: Wed, 9 Apr 2025 16:30:04 -0400
Subject: [PATCH] summarize docs

---
 apps/svelte.dev/src/lib/server/content.ts              | 10 +++++++++-
 .../src/routes/docs/[...path]/+layout.server.ts        |  4 ++--
 packages/site-kit/src/lib/docs/DocsContents.svelte     |  4 ++--
 packages/site-kit/src/lib/types.d.ts                   |  9 +++++++++
 4 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/apps/svelte.dev/src/lib/server/content.ts b/apps/svelte.dev/src/lib/server/content.ts
index 01c84c2ad6..88dd3e177b 100644
--- a/apps/svelte.dev/src/lib/server/content.ts
+++ b/apps/svelte.dev/src/lib/server/content.ts
@@ -1,5 +1,5 @@
 import { read } from '$app/server';
-import type { Document } from '@sveltejs/site-kit';
+import type { Document, DocumentSummary } from '@sveltejs/site-kit';
 import { create_index } from '@sveltejs/site-kit/server/content';
 
 const documents = import.meta.glob<string>('../../../content/**/*.md', {
@@ -123,6 +123,14 @@ function create_docs() {
 	return docs;
 }
 
+export function create_summary(document: Document): DocumentSummary {
+	return {
+		slug: document.slug,
+		metadata: document.metadata,
+		children: document.children.map(create_summary)
+	};
+}
+
 export const docs = create_docs();
 
 export const examples = index.examples.children;
diff --git a/apps/svelte.dev/src/routes/docs/[...path]/+layout.server.ts b/apps/svelte.dev/src/routes/docs/[...path]/+layout.server.ts
index 5ff346304f..41019d898e 100644
--- a/apps/svelte.dev/src/routes/docs/[...path]/+layout.server.ts
+++ b/apps/svelte.dev/src/routes/docs/[...path]/+layout.server.ts
@@ -1,4 +1,4 @@
-import { docs } from '$lib/server/content';
+import { create_summary, docs } from '$lib/server/content';
 import { redirect } from '@sveltejs/kit';
 import { error } from '@sveltejs/kit';
 
@@ -20,6 +20,6 @@ export async function load({ params }) {
 	}
 
 	return {
-		sections: document.children
+		sections: document.children.map(create_summary)
 	};
 }
diff --git a/packages/site-kit/src/lib/docs/DocsContents.svelte b/packages/site-kit/src/lib/docs/DocsContents.svelte
index 86bd2dc2e2..84240e6caf 100644
--- a/packages/site-kit/src/lib/docs/DocsContents.svelte
+++ b/packages/site-kit/src/lib/docs/DocsContents.svelte
@@ -1,10 +1,10 @@
 <script lang="ts">
 	import { afterNavigate } from '$app/navigation';
 	import { page } from '$app/stores';
-	import type { Document } from '../types';
+	import type { Document, DocumentSummary } from '../types';
 
 	interface Props {
-		contents: Document[];
+		contents: DocumentSummary[];
 		show_ts_toggle?: boolean;
 	}
 
diff --git a/packages/site-kit/src/lib/types.d.ts b/packages/site-kit/src/lib/types.d.ts
index b980161cc1..81f22adf1b 100644
--- a/packages/site-kit/src/lib/types.d.ts
+++ b/packages/site-kit/src/lib/types.d.ts
@@ -32,6 +32,15 @@ export interface Document {
 	prev: null | { slug: string; title: string };
 }
 
+export interface DocumentSummary {
+	slug: string;
+	metadata: {
+		title: string;
+		[key: string]: any;
+	};
+	children: DocumentSummary[];
+}
+
 export interface Section {
 	slug: string;
 	title: string;