Add JSON-LD structured data to docs pages (#726)

* feat: add JSON-LD structured data for docs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: remove duplicate site tour flag

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* feat: extend structured data for FAQ and Aspire Conf

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* perf: simplify structured data page routing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: escape structured data JSON safely

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: IEvangelist

src/frontend/package.json

@@ -29,13 +29,14 @@
     "astro": "pnpm git-env && astro",
     "test": "pnpm test:unit && pnpm test:e2e",
     "test:all": "pnpm lint && pnpm test",
-    "test:unit": "pnpm test:unit:contracts && pnpm test:unit:components && pnpm test:unit:docs && pnpm test:unit:api-markdown && pnpm test:unit:ts-api && pnpm test:unit:twoslash-types",
+    "test:unit": "pnpm test:unit:contracts && pnpm test:unit:components && pnpm test:unit:docs && pnpm test:unit:api-markdown && pnpm test:unit:ts-api && pnpm test:unit:twoslash-types && pnpm test:unit:structured-data",
     "test:unit:api-markdown": "vitest run --config vitest.config.ts tests/unit/api-markdown.vitest.test.ts",
     "test:unit:ts-api": "vitest run --config vitest.config.ts tests/unit/ts-api-routes.vitest.test.ts tests/unit/ts-api-search.vitest.test.ts",
     "test:unit:twoslash-types": "vitest run --config vitest.config.ts tests/unit/twoslash-types-generator.vitest.test.ts",
     "test:unit:contracts": "vitest run --config vitest.config.ts tests/unit/analytics-script-contracts.vitest.test.ts",
     "test:unit:components": "vitest run --config vitest.config.ts tests/unit/custom-components.vitest.test.ts tests/unit/site-tour.vitest.test.ts",
     "test:unit:docs": "vitest run --config vitest.config.ts tests/unit/filetree-format.vitest.test.ts",
+    "test:unit:structured-data": "vitest run --config vitest.config.ts tests/unit/structured-data.vitest.test.ts",
     "test:e2e:api-markdown": "playwright test --config playwright.api-markdown.config.mjs",
     "test:e2e": "playwright test",
     "test:e2e:install": "playwright install chromium",

src/frontend/src/components/starlight/Head.astro

@@ -3,6 +3,7 @@ import { Tooltips } from 'astro-tooltips';
 import DefaultHead from '@astrojs/starlight/components/Head.astro';
 import AccessibleCodeButtons from '../AccessibleCodeButtons.astro';
 import SiteTour from '../SiteTour.astro';
+import { getStructuredData } from '@utils/structured-data';
 
 const repoUrl = (
   import.meta.env.PUBLIC_REPO_URL ||
@@ -15,6 +16,7 @@ const route = Astro.locals?.starlightRoute;
 const entryId = route?.entry?.id;
 const path = route?.entry?.filePath;
 const isSiteTourEnabled = import.meta.env.PUBLIC_ENABLE_SITE_TOUR === 'true';
+const structuredData = route ? getStructuredData(route, Astro.url, Astro.site) : undefined;
 
 function computeRepoPath() {
   if (path) {
@@ -35,6 +37,7 @@ function computeSourceUrl() {
 <meta name="git-source-url" content={computeSourceUrl()} />
 
 <DefaultHead {...Astro.props} />
+{structuredData && <script type="application/ld+json" is:inline set:html={structuredData} />}
 
 <!-- Restore persisted sidebar state before paint and keep legacy AppHost pages readable -->
 <script is:inline>
@@ -62,11 +65,17 @@ function computeSourceUrl() {
       document.documentElement.setAttribute('data-apphost-lang', appHostLang);
 
       var path = window.location.pathname.replace(/\/$/, '');
-      if (localStorage.getItem('api-sidebar-collapsed') === '1' && path.indexOf('/reference/api') !== -1) {
+      if (
+        localStorage.getItem('api-sidebar-collapsed') === '1' &&
+        path.indexOf('/reference/api') !== -1
+      ) {
         document.documentElement.setAttribute('data-sidebar-collapsed', '');
       }
 
-      if (localStorage.getItem('topic-sidebar-collapsed') === '1' && path.indexOf('/reference/api') === -1) {
+      if (
+        localStorage.getItem('topic-sidebar-collapsed') === '1' &&
+        path.indexOf('/reference/api') === -1
+      ) {
         document.documentElement.setAttribute('data-topic-sidebar-collapsed', '');
       }
     } catch (e) {}
@@ -132,7 +141,7 @@ function computeSourceUrl() {
     }
   }}
 />
-  
+
 <script is:inline>
   (function () {
     document.addEventListener('keydown', function (event) {