@umami/shiso 1.10.0 → 1.12.0

package/dist/chunks/docs.js

@@ -9832,7 +9832,8 @@ const styles = {
 	accordionItem: "",
 	accordionTrigger: "text-foreground",
 	accordionContent: "text-muted-foreground [&_p]:mt-0 [&_p:last-child]:mb-0",
-	expandableTrigger: "items-center px-4 py-3 text-sm font-normal text-foreground hover:no-underline",
+	expandableTrigger: "items-center py-3 text-sm font-normal text-foreground hover:no-underline",
+	expandableContent: "pl-6",
 	callout: "my-4 flex items-start gap-3 rounded-lg border px-3 py-2.5 text-sm leading-6",
 	calloutIcon: "flex h-6 w-5 shrink-0 items-center justify-center [&_svg]:block [&_svg]:size-4",
 	calloutBody: "flex min-w-0 flex-1 flex-col gap-[0.35rem] [&>:first-child]:mt-0 [&>:last-child]:mb-0 [&_:where(p,ul,ol)]:my-[0.35rem] [&>:where(p,ul,ol):first-child]:mt-0 [&>:where(p,ul,ol):last-child]:mb-0",
@@ -9844,7 +9845,8 @@ const styles = {
 	tip: "border-green-300 bg-green-50 text-green-900 dark:border-green-400/40 dark:bg-green-400/10 dark:text-green-300",
 	check: "border-emerald-300 bg-emerald-50 text-emerald-900 dark:border-emerald-400/40 dark:bg-emerald-400/10 dark:text-emerald-300",
 	danger: "border-destructive/40 bg-destructive/10 text-destructive",
-	card: "block h-full gap-0 rounded-lg border border-border bg-transparent p-4 text-base ring-0 hover:border-primary",
+	card: "block h-full gap-0 rounded-lg border border-border p-4 text-sm ring-0 hover:border-primary",
+	cardPlain: "bg-card",
 	cardHorizontal: "[&_[data-slot=card-inner]]:items-center [&_[data-slot=card-main]]:flex-row [&_[data-slot=card-main]]:items-center [&_[data-slot=card-main]]:gap-3 [&_[data-slot=card-body]]:m-0 [&_[data-slot=card-header]]:flex-row [&_[data-slot=card-header]]:items-center [&_[data-slot=card-header]]:gap-2",
 	cardTyped: "[&_[data-slot=card-title]]:text-inherit [&_[data-slot=card-body]]:text-inherit [&_[data-slot=card-cta]]:text-inherit [&_[data-slot=card-arrow]]:text-inherit",
 	cardImageLayout: "p-0 [&_[data-slot=card-inner]]:p-6",
@@ -9853,7 +9855,7 @@ const styles = {
 	cardMain: "flex min-w-0 flex-col gap-2",
 	cardHeader: "flex flex-col items-start gap-3",
 	cardIcon: "inline-flex shrink-0 items-center justify-center [&_img]:size-6 [&_svg]:size-6",
-	cardTitle: "text-base font-semibold text-foreground",
+	cardTitle: "text-sm font-semibold text-foreground",
 	cardBody: "text-muted-foreground [&>:first-child]:mt-0 [&>:last-child]:mb-0",
 	cardCta: "flex shrink-0 items-center gap-[0.35rem] text-[0.9rem] font-medium text-muted-foreground",
 	cardArrow: "shrink-0 text-muted-foreground",
@@ -10377,7 +10379,7 @@ function DocsCardContent({ title, icon, color, img, cta, arrow, type, children }
 function Card({ title, href, icon, color, img, cta, horizontal, arrow, type, children }) {
 	const external = typeof href === "string" && /^https?:\/\//i.test(href);
 	const showArrow = arrow ?? external;
-	const className = `${styles.card} ${type ? `${styles.cardTyped} ${styles[type]} ${CARD_TYPE_HOVER[type]}` : ""} ${horizontal ? styles.cardHorizontal : ""} ${img ? styles.cardImageLayout : ""}`;
+	const className = `${styles.card} ${type ? `${styles.cardTyped} ${styles[type]} ${CARD_TYPE_HOVER[type]}` : styles.cardPlain} ${horizontal ? styles.cardHorizontal : ""} ${img ? styles.cardImageLayout : ""}`;
 	const content = /* @__PURE__ */ jsx(Card$1, {
 		className,
 		children: /* @__PURE__ */ jsx(DocsCardContent, {
@@ -11298,13 +11300,13 @@ function CodeGroup({ children }) {
 	const selected = blocks.some((block) => block.id === selectedKey) ? selectedKey : blocks[0]?.id;
 	if (!blocks.length) return null;
 	if (blocks.length === 1) return /* @__PURE__ */ jsx("div", {
-		className: styles.tabs,
+		className: `${styles.tabs} [&_[data-slot=code-block-header]]:hidden`,
 		children: blocks[0].content
 	});
 	return /* @__PURE__ */ jsxs(Tabs$1, {
 		value: selected,
 		onValueChange: setSelectedKey,
-		className: "my-4 gap-0 overflow-hidden rounded-lg bg-muted/50 [&_[data-slot=code-block]]:my-0 [&_[data-slot=code-block]]:rounded-none [&_[data-slot=code-block]]:border-0 [&_[data-slot=code-block]]:bg-transparent",
+		className: "my-4 gap-0 overflow-hidden rounded-lg bg-card [&_[data-slot=code-block]]:my-0 [&_[data-slot=code-block]]:rounded-none [&_[data-slot=code-block]]:border-0 [&_[data-slot=code-block]]:bg-transparent [&_[data-slot=code-block-header]]:hidden",
 		children: [/* @__PURE__ */ jsx(TabsList, {
 			variant: "line",
 			className: "h-9 w-full justify-start gap-5 overflow-x-auto overflow-y-hidden rounded-none px-3 py-0 shadow-[inset_0_-1px_0_var(--border)] [scrollbar-width:none] [&::-webkit-scrollbar]:hidden",
@@ -11541,7 +11543,7 @@ function Expandable({ title, children, defaultOpen = false }) {
 				className: `${styles.expandableTrigger} group/collapsible-trigger flex w-full justify-start gap-2 text-left outline-none focus-visible:ring-3 focus-visible:ring-ring/50`,
 				children: [/* @__PURE__ */ jsx(ChevronRight, { className: "size-4 shrink-0 text-muted-foreground transition-transform group-aria-expanded/collapsible-trigger:rotate-90" }), title]
 			}), /* @__PURE__ */ jsx(CollapsibleContent, { children: /* @__PURE__ */ jsx("div", {
-				className: styles.accordionContent,
+				className: `${styles.accordionContent} ${styles.expandableContent}`,
 				children
 			}) })]
 		})
@@ -11725,53 +11727,43 @@ function PropertiesTable({ children }) {
 	const rows = toElementArray(children);
 	if (!rows.length) return null;
 	return /* @__PURE__ */ jsx("div", {
-		className: "my-4 overflow-x-auto rounded-lg border border-border px-6 py-2",
+		className: "my-4 overflow-x-auto",
 		children: /* @__PURE__ */ jsxs("table", {
-			className: "m-0 min-w-[40rem] table-fixed border-collapse border-0",
+			className: "m-0 min-w-[40rem] table-fixed",
 			children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
 				/* @__PURE__ */ jsx("th", {
-					className: "w-1/5 border-x-0 border-t-0 border-b border-border bg-transparent px-0 py-2 pr-6 text-left text-sm font-semibold text-foreground",
+					className: "w-1/5",
 					children: "Name"
 				}),
 				/* @__PURE__ */ jsx("th", {
-					className: "w-1/4 border-x-0 border-t-0 border-b border-border bg-transparent px-0 py-2 pr-6 text-left text-sm font-semibold text-foreground",
+					className: "w-1/4",
 					children: "Type"
 				}),
-				/* @__PURE__ */ jsx("th", {
-					className: "border-x-0 border-t-0 border-b border-border bg-transparent px-0 py-2 text-left text-sm font-semibold text-foreground",
-					children: "Description"
-				})
-			] }) }), /* @__PURE__ */ jsx("tbody", { children: rows.map((row, index) => {
+				/* @__PURE__ */ jsx("th", { children: "Description" })
+			] }) }), /* @__PURE__ */ jsx("tbody", { children: rows.map((row) => {
 				const { name, type, required, deprecated, children: description } = row.props;
 				const defaultValue = displayValue(row.props.default);
-				const borderClass = index === rows.length - 1 ? "border-b-0" : "border-b";
 				return /* @__PURE__ */ jsxs("tr", { children: [
-					/* @__PURE__ */ jsx("td", {
-						className: `${borderClass} border-x-0 border-t-0 border-border px-0 py-2 pr-6 align-top text-sm text-foreground`,
-						children: /* @__PURE__ */ jsxs("span", {
-							className: "inline-flex flex-wrap items-center gap-2",
-							children: [
-								name,
-								required ? /* @__PURE__ */ jsx(Badge, {
-									size: "xs",
-									tone: "primary",
-									children: "required"
-								}) : null,
-								deprecated ? /* @__PURE__ */ jsx(Badge, {
-									size: "xs",
-									children: "deprecated"
-								}) : null
-							]
-						})
-					}),
-					/* @__PURE__ */ jsx("td", {
-						className: `${borderClass} border-x-0 border-t-0 border-border px-0 py-2 pr-6 align-top text-sm text-foreground`,
-						children: displayValue(type)
-					}),
+					/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsxs("span", {
+						className: "inline-flex flex-wrap items-center gap-2",
+						children: [
+							name,
+							required ? /* @__PURE__ */ jsx(Badge, {
+								size: "xs",
+								tone: "primary",
+								children: "required"
+							}) : null,
+							deprecated ? /* @__PURE__ */ jsx(Badge, {
+								size: "xs",
+								children: "deprecated"
+							}) : null
+						]
+					}) }),
+					/* @__PURE__ */ jsx("td", { children: displayValue(type) }),
 					/* @__PURE__ */ jsxs("td", {
-						className: `${borderClass} border-x-0 border-t-0 border-border px-0 py-2 align-top text-sm leading-6 text-foreground [&_p]:m-0`,
+						className: "[&_p]:m-0",
 						children: [description, defaultValue ? /* @__PURE__ */ jsxs("span", {
-							className: "mt-1 block text-sm text-muted-foreground",
+							className: "mt-1 block text-muted-foreground",
 							children: ["Default: ", defaultValue]
 						}) : null]
 					})

package/dist/entry-client.js

@@ -1,5 +1,5 @@
 import { ar as BrowserRouter } from "./chunks/docs.js";
-import { m as BASE_URL, t as App } from "./chunks/App.js";
+import { h as BASE_URL, t as App } from "./chunks/App.js";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/entry-client.tsx

package/dist/entry-server.js

@@ -1,5 +1,5 @@
 import { hr as ABSOLUTE_URL_REGEX, lr as Router, mr as parsePath, pr as createPath } from "./chunks/docs.js";
-import { a as docsSite, c as getSeo, d as getDocModule, f as getLastModified, h as toAbsoluteUrl, i as docsHomeUrl, l as siteName, m as BASE_URL, n as buildHead, o as getLocaleByPathname, p as getScopeForPage, r as renderHeadToString, s as getRedirects, t as App, u as standalonePages } from "./chunks/App.js";
+import { a as docsSite, c as getSeo, d as standalonePages, f as getDocModule, g as toAbsoluteUrl, h as BASE_URL, i as docsHomeUrl, l as siteConfig, m as getScopeForPage, n as buildHead, o as getLocaleByPathname, p as getLastModified, r as renderHeadToString, s as getRedirects, t as App, u as siteName } from "./chunks/App.js";
 import * as React$1 from "react";
 import { jsx } from "react/jsx-runtime";
 import { renderToString } from "react-dom/server";
@@ -107,6 +107,33 @@ function getMarkdownPages() {
 		filePath: page.filePath
 	}))];
 }
+/** Navigable Markdown pages used to generate llms.txt and llms-full.txt. */
+function getLlmsPages() {
+	const { indexing } = getSeo();
+	const pages = [];
+	for (const page of docsSite.pages) {
+		const doc = getDocModule(page.filePath);
+		if (doc?.frontmatter?.noindex === true || (page.hidden || getScopeForPage(docsSite, page).hidden) && indexing !== "all") continue;
+		pages.push({
+			route: page.url,
+			filePath: page.filePath,
+			title: doc?.frontmatter?.title || page.label,
+			description: doc?.frontmatter?.description
+		});
+	}
+	for (const page of standalonePages) {
+		if (page.filePath.endsWith(".tsx")) continue;
+		const doc = getDocModule(page.filePath);
+		if (doc?.frontmatter?.noindex === true) continue;
+		pages.push({
+			route: page.path,
+			filePath: page.filePath,
+			title: doc?.frontmatter?.title || page.title || page.path,
+			description: doc?.frontmatter?.description
+		});
+	}
+	return pages;
+}
 /**
 * Absolute URLs for the sitemap, honoring `seo.indexing` and per-page
 * noindex. Empty when the shiso.config `siteUrl` is not configured, since a sitemap
@@ -145,6 +172,7 @@ function render(url) {
 		htmlAttrs: getLocaleByPathname(url)
 	};
 }
+const siteDescription = siteConfig.description;
 
 //#endregion
-export { docsHomeUrl, getMarkdownPages, getRedirects, getRoutes, getSitemapEntries, render, siteName };
+export { docsHomeUrl, getLlmsPages, getMarkdownPages, getRedirects, getRoutes, getSitemapEntries, render, siteDescription, siteName };

package/docs.schema.json

@@ -172,6 +172,37 @@
           ],
           "description": "Page eyebrow style: the section name (default) or the full navigation path.",
           "default": "section"
+        },
+        "codeBlocks": {
+          "type": "object",
+          "description": "Fenced code block defaults: line numbers and the Shiki light/dark themes.",
+          "additionalProperties": false,
+          "properties": {
+            "$ref": { "$ref": "#/definitions/configRef" },
+            "lineNumbers": {
+              "allOf": [{ "$ref": "#/definitions/booleanValue" }],
+              "description": "Show line numbers on every block. Override per block with showLineNumbers or hideLineNumbers in the fence meta.",
+              "default": false
+            },
+            "theme": {
+              "type": "object",
+              "description": "Bundled Shiki theme names for each color mode (https://shiki.style/themes).",
+              "additionalProperties": false,
+              "properties": {
+                "$ref": { "$ref": "#/definitions/configRef" },
+                "light": {
+                  "allOf": [{ "$ref": "#/definitions/nonEmptyStringValue" }],
+                  "description": "Theme used in light mode.",
+                  "default": "github-light"
+                },
+                "dark": {
+                  "allOf": [{ "$ref": "#/definitions/nonEmptyStringValue" }],
+                  "description": "Theme used in dark mode.",
+                  "default": "github-dark"
+                }
+              }
+            }
+          }
         }
       }
     },
@@ -567,6 +598,24 @@
         }
       }
     },
+    "api": {
+      "type": "object",
+      "description": "API reference settings: the OpenAPI spec powering openapi frontmatter pages.",
+      "anyOf": [{ "required": ["$ref"] }, { "required": ["spec"] }],
+      "additionalProperties": false,
+      "properties": {
+        "$ref": { "$ref": "#/definitions/configRef" },
+        "spec": {
+          "allOf": [{ "$ref": "#/definitions/nonEmptyStringValue" }],
+          "description": "Path to a local OpenAPI 3.0 or 3.1 spec (JSON or YAML), relative to the project root."
+        },
+        "directory": {
+          "allOf": [{ "$ref": "#/definitions/nonEmptyStringValue" }],
+          "description": "Folder inside the content directory for generated endpoint pages.",
+          "default": "api-reference"
+        }
+      }
+    },
     "errors": {
       "type": "object",
       "description": "Error handling settings.",
@@ -712,6 +761,8 @@
           "description": "Page reference relative to the content directory, without extension (e.g. \"components/tabs\")."
         },
         { "$ref": "#/definitions/pageObject" },
+        { "$ref": "#/definitions/globItem" },
+        { "$ref": "#/definitions/openapiItem" },
         { "$ref": "#/definitions/linkItem" },
         { "$ref": "#/definitions/group" }
       ]
@@ -736,12 +787,51 @@
         },
         "icon": { "allOf": [{ "$ref": "#/definitions/stringValue" }], "description": "Icon name shown beside the label." },
         "tag": { "allOf": [{ "$ref": "#/definitions/stringValue" }], "description": "Short label shown after the page name." },
+        "method": {
+          "anyOf": [
+            { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE"] },
+            { "$ref": "#/definitions/configRefValue" }
+          ],
+          "description": "HTTP method badge shown after the page name on API reference pages."
+        },
         "hidden": {
           "allOf": [{ "$ref": "#/definitions/booleanValue" }],
           "description": "Hide from the sidebar and search. The page is still built and reachable by URL."
         }
       }
     },
+    "globItem": {
+      "type": "object",
+      "required": ["glob"],
+      "additionalProperties": false,
+      "properties": {
+        "glob": {
+          "allOf": [{ "$ref": "#/definitions/nonEmptyStringValue" }],
+          "description": "Glob relative to contentDir. Matching Markdown and MDX files are expanded into page entries."
+        },
+        "exclude": {
+          "anyOf": [
+            {
+              "type": "array",
+              "items": { "$ref": "#/definitions/nonEmptyStringValue" }
+            },
+            { "$ref": "#/definitions/configRefValue" }
+          ],
+          "description": "Optional glob patterns to omit from the matches."
+        }
+      }
+    },
+    "openapiItem": {
+      "type": "object",
+      "required": ["openapi"],
+      "additionalProperties": false,
+      "properties": {
+        "openapi": {
+          "anyOf": [{ "type": "boolean" }, { "$ref": "#/definitions/nonEmptyStringValue" }],
+          "description": "Expand API endpoints into pages: true for every tag (grouped), or a tag name for that tag's operations. Requires the api.spec setting."
+        }
+      }
+    },
     "linkItem": {
       "type": "object",
       "description": "An external link in the navigation tree.",

package/mdx.config.ts

@@ -1,104 +1,19 @@
 import mdx from '@mdx-js/rollup';
 import rehypeAutolinkHeadings from 'rehype-autolink-headings';
-import rehypeHighlight from 'rehype-highlight';
 import rehypeSlug from 'rehype-slug';
 import remarkFrontmatter from 'remark-frontmatter';
 import remarkGfm from 'remark-gfm';
 import remarkMdxFrontmatter from 'remark-mdx-frontmatter';
 import type { Plugin } from 'vite';
-import { type MdNode, toText, walkTree } from './src/lib/mdast.ts';
+import { resolveCodeBlockConfig } from './src/lib/code-blocks.ts';
+import { type MdNode, toText } from './src/lib/mdast.ts';
+import { rehypeShiki } from './src/lib/rehype-shiki.ts';
 import { remarkToc } from './src/lib/remark-toc.ts';
+import type { MdxConfig, ResolvedCodeBlockConfig } from './src/lib/types.ts';
 
-const SYNTHETIC_FRAGMENT = 'data-shiso-synthetic-fragment';
-
-function remarkCodeTitles() {
-  return (tree: MdNode) => {
-    const visit = (node: MdNode) => {
-      if (node.type === 'code' && node.meta?.trim()) {
-        const meta = node.meta.trim();
-        const titleMatch = meta.match(/(?:^|\s)title=(?:"([^"]+)"|'([^']+)'|([^\s]+))/);
-        const title = titleMatch ? titleMatch[1] || titleMatch[2] || titleMatch[3] : meta;
-        const hProperties = (node.data?.hProperties || {}) as Record<string, unknown>;
-        node.data = {
-          ...node.data,
-          hProperties: { ...hProperties, 'data-title': title },
-        };
-      }
-
-      node.children?.forEach(visit);
-    };
-
-    visit(tree);
-  };
-}
-
-function rehypeWrapJsxForHighlighting() {
-  return (tree: MdNode) => {
-    walkTree(tree, node => {
-      if (node.tagName !== 'code') {
-        return;
-      }
-
-      const properties = (node.properties || {}) as Record<string, unknown>;
-      const className = properties.className;
-      const classes = Array.isArray(className) ? className.map(String) : [String(className || '')];
-      const source = toText(node);
-
-      if (!classes.some(value => /\blanguage-(?:jsx|tsx)\b/.test(value))) {
-        return;
-      }
-
-      if (!/^\s*<[A-Z][\w.]*(?:\s|>|\/)/.test(source)) {
-        return;
-      }
-
-      properties[SYNTHETIC_FRAGMENT] = true;
-      node.properties = properties;
-      node.children = [{ type: 'text', value: `<>\n${source}\n</>` }];
-    });
-  };
-}
-
-function boundaryText(node: MdNode, fromEnd = false): MdNode | undefined {
-  if (node.type === 'text' && typeof node.value === 'string') {
-    return node;
-  }
-
-  const children = fromEnd ? [...(node.children || [])].reverse() : node.children || [];
-  for (const child of children) {
-    const match = boundaryText(child, fromEnd);
-    if (match) {
-      return match;
-    }
-  }
-
-  return undefined;
-}
-
-function rehypeRemoveHighlightingFragments() {
-  return (tree: MdNode) => {
-    walkTree(tree, node => {
-      if (node.tagName !== 'code') {
-        return;
-      }
-
-      const properties = (node.properties || {}) as Record<string, unknown>;
-      if (!properties[SYNTHETIC_FRAGMENT]) {
-        return;
-      }
-
-      const first = boundaryText(node);
-      const last = boundaryText(node, true);
-      if (first?.value) {
-        first.value = first.value.replace(/^<>\r?\n/, '');
-      }
-      if (last?.value) {
-        last.value = last.value.replace(/\r?\n<\/>$/, '');
-      }
-
-      delete properties[SYNTHETIC_FRAGMENT];
-    });
-  };
+export interface ShisoMdxOptions extends MdxConfig {
+  /** Resolved docs.json `styling.codeBlocks`; defaults apply when omitted. */
+  codeBlocks?: ResolvedCodeBlockConfig;
 }
 
 function rehypeZoomableImages() {
@@ -142,7 +57,9 @@ function rehypeZoomableImages() {
  * The MDX compilation pipeline, shared by the app build and the test runner so
  * tests exercise the same transforms the site ships with.
  */
-export function shisoMdx(): Plugin {
+export function shisoMdx(options: ShisoMdxOptions = {}): Plugin {
+  const codeBlocks = options.codeBlocks || resolveCodeBlockConfig();
+
   return {
     // Must run before vite:react-babel so MDX is compiled to JSX first.
     enforce: 'pre',
@@ -152,13 +69,12 @@ export function shisoMdx(): Plugin {
         remarkFrontmatter,
         remarkMdxFrontmatter,
         remarkGfm,
-        remarkCodeTitles,
+        ...(options.remarkPlugins || []),
         remarkToc,
       ],
       rehypePlugins: [
-        rehypeWrapJsxForHighlighting,
-        rehypeHighlight,
-        rehypeRemoveHighlightingFragments,
+        ...(options.rehypePlugins || []),
+        [rehypeShiki, codeBlocks],
         rehypeZoomableImages,
         rehypeSlug,
         [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umami/shiso",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "Open-source documentation framework for Markdown and MDX sites.",
   "type": "module",
   "bin": {
@@ -72,6 +72,7 @@
     "@fontsource/jetbrains-mono": "^5.2.5",
     "@mdx-js/react": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
+    "@shikijs/transformers": "^4.4.3",
     "@tailwindcss/vite": "^4.3.3",
     "@vitejs/plugin-react": "^6.0.5",
     "ajv": "^8.20.0",
@@ -80,24 +81,24 @@
     "cmdk": "^1.1.1",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
-    "highlight.js": "^11.11.1",
     "jiti": "^2.4.0",
     "lucide-react": "^1.28.0",
     "react-router": "^8.3.0",
     "rehype-autolink-headings": "^7.1.0",
-    "rehype-highlight": "^7.0.1",
     "rehype-slug": "^6.0.0",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remark-mdx-frontmatter": "^5.2.0",
     "remark-parse": "^11.0.0",
+    "shiki": "^4.4.3",
     "simple-icons": "^16.28.0",
     "tailwind-merge": "^3.6.0",
     "tailwindcss": "^4.3.3",
     "tw-animate-css": "^1.4.0",
     "unified": "^11.0.5",
-    "vite": "^8.2.0"
+    "vite": "^8.2.0",
+    "yaml": "^2.9.0"
   },
   "optionalDependencies": {
     "pagefind": "^1.4.0"

package/scripts/build-runtime.mjs

@@ -10,6 +10,7 @@ const outputRoot = path.join(packageRoot, 'dist');
 const projectModules = new Set([
   '@/generated/last-modified',
   '@/lib/icon-registry.generated',
+  '@/lib/openapi.generated',
   '@/lib/search-index.generated',
   'virtual:shiso-docs-config',
   'virtual:shiso-config',