@ox-content/vite-plugin 1.0.0-alpha.0 → 2.0.0

package/dist/{index.js → index.mjs}

@@ -1,11 +1,11 @@
-import { n as transformMermaidStatic, t as mermaidClientScript } from "./mermaid2.js";
-import { n as resetTabGroupCounter, r as transformTabs, t as generateTabsCSS } from "./tabs2.js";
-import { n as transformYouTube, t as extractVideoId } from "./youtube2.js";
-import { i as transformGitHub, n as fetchRepoData, r as prefetchGitHubRepos, t as collectGitHubRepos } from "./github2.js";
-import { i as transformOgp, n as fetchOgpData, r as prefetchOgpData, t as collectOgpUrls } from "./ogp2.js";
+import { n as transformMermaidStatic, r as importNapiModule, t as mermaidClientScript } from "./mermaid.mjs";
+import { n as resetTabGroupCounter, r as transformTabs, t as generateTabsCSS } from "./tabs2.mjs";
+import { n as transformYouTube, t as extractVideoId } from "./youtube2.mjs";
+import { i as transformGitHub, n as fetchRepoData, r as prefetchGitHubRepos, t as collectGitHubRepos } from "./github2.mjs";
+import { i as transformOgp, n as fetchOgpData, r as prefetchOgpData, t as collectOgpUrls } from "./ogp2.mjs";
 import { createRequire } from "node:module";
-import * as path from "path";
-import path$1 from "path";
+import * as path$1 from "path";
+import path from "path";
 import { unified } from "unified";
 import rehypeParse from "rehype-parse";
 import rehypeStringify from "rehype-stringify";
@@ -17,8 +17,7 @@ import * as fs from "fs/promises";
 import { glob } from "glob";
 import * as crypto from "crypto";
 import { mkdir, writeFile } from "node:fs/promises";
-
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -27,30 +26,22 @@ var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __exportAll = (all, symbols) => {
+var __exportAll = (all, no_symbols) => {
 	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
 var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
 	}
 	return to;
 };
@@ -60,7 +51,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 //#endregion
 //#region src/environment.ts
 /**
@@ -108,7 +98,6 @@ function createMarkdownEnvironment(options) {
 		}
 	};
 }
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/identity.js
 var require_identity = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -159,7 +148,6 @@ var require_identity = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.isScalar = isScalar;
 	exports.isSeq = isSeq;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/visit.js
 var require_visit = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -350,7 +338,6 @@ var require_visit = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.visit = visit;
 	exports.visitAsync = visitAsync;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/doc/directives.js
 var require_directives = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -516,7 +503,6 @@ var require_directives = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Directives.defaultTags = { "!!": "tag:yaml.org,2002:" };
 	exports.Directives = Directives;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/doc/anchors.js
 var require_anchors = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -579,7 +565,6 @@ var require_anchors = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.createNodeAnchors = createNodeAnchors;
 	exports.findNewAnchor = findNewAnchor;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/doc/applyReviver.js
 var require_applyReviver = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -620,7 +605,6 @@ var require_applyReviver = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.applyReviver = applyReviver;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/toJS.js
 var require_toJS = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -658,7 +642,6 @@ var require_toJS = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.toJS = toJS;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/Node.js
 var require_Node = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -693,7 +676,6 @@ var require_Node = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.NodeBase = NodeBase;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/Alias.js
 var require_Alias = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -787,7 +769,6 @@ var require_Alias = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.Alias = Alias;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/Scalar.js
 var require_Scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -815,7 +796,6 @@ var require_Scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.Scalar = Scalar;
 	exports.isScalarValue = isScalarValue;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/doc/createNode.js
 var require_createNode = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -879,7 +859,6 @@ var require_createNode = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.createNode = createNode;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/Collection.js
 var require_Collection = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1001,7 +980,6 @@ var require_Collection = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.collectionFromPath = collectionFromPath;
 	exports.isEmptyPath = isEmptyPath;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyComment.js
 var require_stringifyComment = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1022,7 +1000,6 @@ var require_stringifyComment = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.lineComment = lineComment;
 	exports.stringifyComment = stringifyComment;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/foldFlowLines.js
 var require_foldFlowLines = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1139,7 +1116,6 @@ var require_foldFlowLines = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.FOLD_QUOTED = FOLD_QUOTED;
 	exports.foldFlowLines = foldFlowLines;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyString.js
 var require_stringifyString = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1364,7 +1340,6 @@ var require_stringifyString = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringifyString = stringifyString;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringify.js
 var require_stringify = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1472,7 +1447,6 @@ var require_stringify = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.createStringifyContext = createStringifyContext;
 	exports.stringify = stringify;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyPair.js
 var require_stringifyPair = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1570,7 +1544,6 @@ var require_stringifyPair = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringifyPair = stringifyPair;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/log.js
 var require_log = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1585,7 +1558,6 @@ var require_log = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.debug = debug;
 	exports.warn = warn;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/merge.js
 var require_merge = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1626,7 +1598,6 @@ var require_merge = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.isMergeKey = isMergeKey;
 	exports.merge = merge;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/addPairToJSMap.js
 var require_addPairToJSMap = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1678,7 +1649,6 @@ var require_addPairToJSMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.addPairToJSMap = addPairToJSMap;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/Pair.js
 var require_Pair = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1712,7 +1682,6 @@ var require_Pair = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.Pair = Pair;
 	exports.createPair = createPair;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyCollection.js
 var require_stringifyCollection = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1827,7 +1796,6 @@ var require_stringifyCollection = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringifyCollection = stringifyCollection;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/YAMLMap.js
 var require_YAMLMap = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -1937,13 +1905,12 @@ var require_YAMLMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.YAMLMap = YAMLMap;
 	exports.findPair = findPair;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/common/map.js
 var require_map = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var identity = require_identity();
 	var YAMLMap = require_YAMLMap();
-	const map = {
+	exports.map = {
 		collection: "map",
 		default: true,
 		nodeClass: YAMLMap.YAMLMap,
@@ -1954,9 +1921,7 @@ var require_map = /* @__PURE__ */ __commonJSMin(((exports) => {
 		},
 		createNode: (schema, obj, ctx) => YAMLMap.YAMLMap.from(schema, obj, ctx)
 	};
-	exports.map = map;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/nodes/YAMLSeq.js
 var require_YAMLSeq = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2063,13 +2028,12 @@ var require_YAMLSeq = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.YAMLSeq = YAMLSeq;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/common/seq.js
 var require_seq = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var identity = require_identity();
 	var YAMLSeq = require_YAMLSeq();
-	const seq = {
+	exports.seq = {
 		collection: "seq",
 		default: true,
 		nodeClass: YAMLSeq.YAMLSeq,
@@ -2080,14 +2044,12 @@ var require_seq = /* @__PURE__ */ __commonJSMin(((exports) => {
 		},
 		createNode: (schema, obj, ctx) => YAMLSeq.YAMLSeq.from(schema, obj, ctx)
 	};
-	exports.seq = seq;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/common/string.js
 var require_string = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var stringifyString = require_stringifyString();
-	const string = {
+	exports.string = {
 		identify: (value) => typeof value === "string",
 		default: true,
 		tag: "tag:yaml.org,2002:str",
@@ -2097,9 +2059,7 @@ var require_string = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return stringifyString.stringifyString(item, ctx, onComment, onChompKeep);
 		}
 	};
-	exports.string = string;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/common/null.js
 var require_null = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2115,7 +2075,6 @@ var require_null = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.nullTag = nullTag;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/core/bool.js
 var require_bool$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2135,7 +2094,6 @@ var require_bool$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.boolTag = boolTag;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyNumber.js
 var require_stringifyNumber = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2157,7 +2115,6 @@ var require_stringifyNumber = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringifyNumber = stringifyNumber;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/core/float.js
 var require_float$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2183,7 +2140,7 @@ var require_float$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return isFinite(num) ? num.toExponential() : stringifyNumber.stringifyNumber(node);
 		}
 	};
-	const float = {
+	exports.float = {
 		identify: (value) => typeof value === "number",
 		default: true,
 		tag: "tag:yaml.org,2002:float",
@@ -2196,11 +2153,9 @@ var require_float$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 		},
 		stringify: stringifyNumber.stringifyNumber
 	};
-	exports.float = float;
 	exports.floatExp = floatExp;
 	exports.floatNaN = floatNaN;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/core/int.js
 var require_int$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2242,7 +2197,6 @@ var require_int$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.intHex = intHex;
 	exports.intOct = intOct;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/core/schema.js
 var require_schema$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2253,7 +2207,7 @@ var require_schema$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var bool = require_bool$1();
 	var float = require_float$1();
 	var int = require_int$1();
-	const schema = [
+	exports.schema = [
 		map.map,
 		seq.seq,
 		string.string,
@@ -2266,9 +2220,7 @@ var require_schema$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 		float.floatExp,
 		float.float
 	];
-	exports.schema = schema;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/json/schema.js
 var require_schema$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2321,7 +2273,7 @@ var require_schema$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 			stringify: stringifyJSON
 		}
 	];
-	const schema = [map.map, seq.seq].concat(jsonScalars, {
+	exports.schema = [map.map, seq.seq].concat(jsonScalars, {
 		default: true,
 		tag: "",
 		test: /^/,
@@ -2330,16 +2282,14 @@ var require_schema$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return str;
 		}
 	});
-	exports.schema = schema;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/binary.js
 var require_binary = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var node_buffer = __require("buffer");
 	var Scalar = require_Scalar();
 	var stringifyString = require_stringifyString();
-	const binary = {
+	exports.binary = {
 		identify: (value) => value instanceof Uint8Array,
 		default: false,
 		tag: "tag:yaml.org,2002:binary",
@@ -2380,9 +2330,7 @@ var require_binary = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}, ctx, onComment, onChompKeep);
 		}
 	};
-	exports.binary = binary;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/pairs.js
 var require_pairs = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2443,7 +2391,6 @@ var require_pairs = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.pairs = pairs;
 	exports.resolvePairs = resolvePairs;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/omap.js
 var require_omap = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2507,7 +2454,6 @@ var require_omap = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.YAMLOMap = YAMLOMap;
 	exports.omap = omap;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/bool.js
 var require_bool = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2535,7 +2481,6 @@ var require_bool = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.falseTag = falseTag;
 	exports.trueTag = trueTag;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/float.js
 var require_float = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2561,7 +2506,7 @@ var require_float = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return isFinite(num) ? num.toExponential() : stringifyNumber.stringifyNumber(node);
 		}
 	};
-	const float = {
+	exports.float = {
 		identify: (value) => typeof value === "number",
 		default: true,
 		tag: "tag:yaml.org,2002:float",
@@ -2577,11 +2522,9 @@ var require_float = /* @__PURE__ */ __commonJSMin(((exports) => {
 		},
 		stringify: stringifyNumber.stringifyNumber
 	};
-	exports.float = float;
 	exports.floatExp = floatExp;
 	exports.floatNaN = floatNaN;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/int.js
 var require_int = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2657,7 +2600,6 @@ var require_int = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.intHex = intHex;
 	exports.intOct = intOct;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/set.js
 var require_set = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2726,7 +2668,6 @@ var require_set = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.YAMLSet = YAMLSet;
 	exports.set = set;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/timestamp.js
 var require_timestamp = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2810,7 +2751,6 @@ var require_timestamp = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.intTime = intTime;
 	exports.timestamp = timestamp;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/yaml-1.1/schema.js
 var require_schema = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2827,7 +2767,7 @@ var require_schema = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var pairs = require_pairs();
 	var set = require_set();
 	var timestamp = require_timestamp();
-	const schema = [
+	exports.schema = [
 		map.map,
 		seq.seq,
 		string.string,
@@ -2850,9 +2790,7 @@ var require_schema = /* @__PURE__ */ __commonJSMin(((exports) => {
 		timestamp.floatTime,
 		timestamp.timestamp
 	];
-	exports.schema = schema;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/tags.js
 var require_tags = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2937,7 +2875,6 @@ var require_tags = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.coreKnownTags = coreKnownTags;
 	exports.getTags = getTags;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/schema/Schema.js
 var require_Schema = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -2947,7 +2884,7 @@ var require_Schema = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var string = require_string();
 	var tags = require_tags();
 	const sortMapEntriesByKey = (a, b) => a.key < b.key ? -1 : a.key > b.key ? 1 : 0;
-	var Schema = class Schema {
+	exports.Schema = class Schema {
 		constructor({ compat, customTags, merge, resolveKnownTags, schema, sortMapEntries, toStringDefaults }) {
 			this.compat = Array.isArray(compat) ? tags.getTags(compat, "compat") : compat ? tags.getTags(null, compat) : null;
 			this.name = typeof schema === "string" && schema || "core";
@@ -2965,9 +2902,7 @@ var require_Schema = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return copy;
 		}
 	};
-	exports.Schema = Schema;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/stringify/stringifyDocument.js
 var require_stringifyDocument = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3029,7 +2964,6 @@ var require_stringifyDocument = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringifyDocument = stringifyDocument;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/doc/Document.js
 var require_Document = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3311,7 +3245,6 @@ var require_Document = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.Document = Document;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/errors.js
 var require_errors = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3365,7 +3298,6 @@ var require_errors = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.YAMLWarning = YAMLWarning;
 	exports.prettifyError = prettifyError;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-props.js
 var require_resolve_props = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3473,7 +3405,6 @@ var require_resolve_props = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveProps = resolveProps;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/util-contains-newline.js
 var require_util_contains_newline = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3503,7 +3434,6 @@ var require_util_contains_newline = /* @__PURE__ */ __commonJSMin(((exports) =>
 	}
 	exports.containsNewline = containsNewline;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/util-flow-indent-check.js
 var require_util_flow_indent_check = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3516,7 +3446,6 @@ var require_util_flow_indent_check = /* @__PURE__ */ __commonJSMin(((exports) =>
 	}
 	exports.flowIndentCheck = flowIndentCheck;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/util-map-includes.js
 var require_util_map_includes = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3529,7 +3458,6 @@ var require_util_map_includes = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.mapIncludes = mapIncludes;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-block-map.js
 var require_resolve_block_map = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3614,7 +3542,6 @@ var require_resolve_block_map = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveBlockMap = resolveBlockMap;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-block-seq.js
 var require_resolve_block_seq = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3657,7 +3584,6 @@ var require_resolve_block_seq = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveBlockSeq = resolveBlockSeq;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-end.js
 var require_resolve_end = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3696,7 +3622,6 @@ var require_resolve_end = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveEnd = resolveEnd;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-flow-collection.js
 var require_resolve_flow_collection = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3852,7 +3777,6 @@ var require_resolve_flow_collection = /* @__PURE__ */ __commonJSMin(((exports) =
 	}
 	exports.resolveFlowCollection = resolveFlowCollection;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/compose-collection.js
 var require_compose_collection = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3905,7 +3829,6 @@ var require_compose_collection = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.composeCollection = composeCollection;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-block-scalar.js
 var require_resolve_block_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4081,7 +4004,6 @@ var require_resolve_block_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveBlockScalar = resolveBlockScalar;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/resolve-flow-scalar.js
 var require_resolve_flow_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4288,7 +4210,6 @@ var require_resolve_flow_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.resolveFlowScalar = resolveFlowScalar;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/compose-scalar.js
 var require_compose_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4348,7 +4269,6 @@ var require_compose_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.composeScalar = composeScalar;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/util-empty-scalar-position.js
 var require_util_empty_scalar_position = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4376,7 +4296,6 @@ var require_util_empty_scalar_position = /* @__PURE__ */ __commonJSMin(((exports
 	}
 	exports.emptyScalarPosition = emptyScalarPosition;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/compose-node.js
 var require_compose_node = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4462,7 +4381,6 @@ var require_compose_node = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.composeEmptyNode = composeEmptyNode;
 	exports.composeNode = composeNode;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/compose-doc.js
 var require_compose_doc = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4505,7 +4423,6 @@ var require_compose_doc = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.composeDoc = composeDoc;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/compose/composer.js
 var require_composer = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4704,7 +4621,6 @@ var require_composer = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.Composer = Composer;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/cst-scalar.js
 var require_cst_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -4972,7 +4888,6 @@ var require_cst_scalar = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.resolveAsScalar = resolveAsScalar;
 	exports.setScalarValue = setScalarValue;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/cst-stringify.js
 var require_cst_stringify = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -5024,7 +4939,6 @@ var require_cst_stringify = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.stringify = stringify;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/cst-visit.js
 var require_cst_visit = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -5116,7 +5030,6 @@ var require_cst_visit = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.visit = visit;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/cst.js
 var require_cst = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -5196,7 +5109,6 @@ var require_cst = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.prettyToken = prettyToken;
 	exports.tokenType = tokenType;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/lexer.js
 var require_lexer = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -5716,7 +5628,6 @@ var require_lexer = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.Lexer = Lexer;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/line-counter.js
 var require_line_counter = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -5764,7 +5675,6 @@ var require_line_counter = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.LineCounter = LineCounter;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/parse/parser.js
 var require_parser = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -6621,7 +6531,6 @@ var require_parser = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.Parser = Parser;
 }));
-
 //#endregion
 //#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/public-api.js
 var require_public_api = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -6709,10 +6618,9 @@ var require_public_api = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.parseDocument = parseDocument;
 	exports.stringify = stringify;
 }));
-
 //#endregion
-//#region ../../node_modules/.pnpm/yaml@2.8.2/node_modules/yaml/dist/index.js
-var require_dist = /* @__PURE__ */ __commonJSMin(((exports) => {
+//#region src/highlight.ts
+var import_dist = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports) => {
 	var composer = require_composer();
 	var Document = require_Document();
 	var Schema = require_Schema();
@@ -6723,7 +6631,7 @@ var require_dist = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var Scalar = require_Scalar();
 	var YAMLMap = require_YAMLMap();
 	var YAMLSeq = require_YAMLSeq();
-	var cst = require_cst();
+	require_cst();
 	var lexer = require_lexer();
 	var lineCounter = require_line_counter();
 	var parser = require_parser();
@@ -6757,11 +6665,7 @@ var require_dist = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.stringify = publicApi.stringify;
 	exports.visit = visit.visit;
 	exports.visitAsync = visit.visitAsync;
-}));
-
-//#endregion
-//#region src/highlight.ts
-var import_dist = /* @__PURE__ */ __toESM(require_dist(), 1);
+})))(), 1);
 /**
 * Syntax highlighting with Shiki via rehype.
 */
@@ -6791,46 +6695,110 @@ const BUILTIN_LANGS = [
 	"diff",
 	"toml"
 ];
-let highlighterPromise = null;
+const highlighterCache = /* @__PURE__ */ new Map();
 /**
 * Get or create the Shiki highlighter.
 */
 async function getHighlighter(theme, customLangs = []) {
-	if (!highlighterPromise) highlighterPromise = createHighlighter({
-		themes: [theme],
-		langs: [...BUILTIN_LANGS, ...customLangs]
+	const { themeInput } = normalizeThemeInput(theme);
+	const cacheKey = JSON.stringify({
+		theme: themeInput,
+		langs: customLangs
 	});
+	let highlighterPromise = highlighterCache.get(cacheKey);
+	if (!highlighterPromise) {
+		highlighterPromise = createHighlighter({
+			themes: [themeInput],
+			langs: [...BUILTIN_LANGS, ...customLangs]
+		});
+		highlighterCache.set(cacheKey, highlighterPromise);
+	}
 	return highlighterPromise;
 }
+function normalizeThemeInput(theme) {
+	if (typeof theme === "string") return {
+		themeInput: theme,
+		themeName: theme
+	};
+	const themeName = theme.name || "ox-content-custom-theme";
+	return {
+		themeInput: theme.name ? theme : {
+			...theme,
+			name: themeName
+		},
+		themeName
+	};
+}
 /**
 * Rehype plugin for syntax highlighting with Shiki.
 */
 function rehypeShikiHighlight(options) {
 	const { theme, langs } = options;
 	return async (tree) => {
+		const { themeName } = normalizeThemeInput(theme);
 		const highlighter = await getHighlighter(theme, langs);
+		const highlightBlockCode = (codeElement) => {
+			let lang = "text";
+			const langClass = normalizeClassName(codeElement.properties?.className).find((value) => value.startsWith("language-"));
+			if (langClass) lang = langClass.replace("language-", "");
+			const codeText = getTextContent(codeElement);
+			try {
+				const highlighted = highlighter.codeToHtml(codeText, {
+					lang,
+					theme: themeName
+				});
+				const parsed = unified().use(rehypeParse, { fragment: true }).parse(highlighted);
+				if (parsed.children[0]?.type === "element") {
+					const highlightedPre = parsed.children[0];
+					highlightedPre.properties ??= {};
+					highlightedPre.properties["data-language"] = lang;
+					return highlightedPre;
+				}
+			} catch {}
+			return null;
+		};
+		const highlightInlineCode = (codeElement) => {
+			let lang = "text";
+			const originalCodeClasses = normalizeClassName(codeElement.properties?.className);
+			const langClass = originalCodeClasses.find((value) => value.startsWith("language-"));
+			if (!langClass) return null;
+			lang = langClass.replace("language-", "");
+			const codeText = getTextContent(codeElement);
+			try {
+				const highlighted = highlighter.codeToHtml(codeText, {
+					lang,
+					theme: themeName
+				});
+				const parsed = unified().use(rehypeParse, { fragment: true }).parse(highlighted);
+				if (parsed.children[0]?.type === "element") {
+					const highlightedCode = parsed.children[0].children.find((child) => child.type === "element" && child.tagName === "code");
+					if (highlightedCode) {
+						highlightedCode.properties ??= {};
+						const highlightedClasses = normalizeClassName(highlightedCode.properties.className);
+						highlightedCode.properties.className = [...new Set([
+							...originalCodeClasses,
+							...highlightedClasses,
+							"shiki-inline"
+						])];
+						highlightedCode.properties["data-language"] = lang;
+						return highlightedCode;
+					}
+				}
+			} catch {}
+			return null;
+		};
 		const visit = async (node) => {
 			if ("children" in node) for (let i = 0; i < node.children.length; i++) {
 				const child = node.children[i];
 				if (child.type === "element" && child.tagName === "pre") {
 					const codeElement = child.children.find((c) => c.type === "element" && c.tagName === "code");
 					if (codeElement) {
-						const className = codeElement.properties?.className;
-						let lang = "text";
-						if (Array.isArray(className)) {
-							const langClass = className.find((c) => typeof c === "string" && c.startsWith("language-"));
-							if (langClass && typeof langClass === "string") lang = langClass.replace("language-", "");
-						}
-						const codeText = getTextContent(codeElement);
-						try {
-							const highlighted = highlighter.codeToHtml(codeText, {
-								lang,
-								theme
-							});
-							const parsed = unified().use(rehypeParse, { fragment: true }).parse(highlighted);
-							if (parsed.children[0]) node.children[i] = parsed.children[0];
-						} catch {}
+						const highlightedPre = highlightBlockCode(codeElement);
+						if (highlightedPre) node.children[i] = highlightedPre;
 					}
+				} else if (child.type === "element" && child.tagName === "code") {
+					const highlightedCode = highlightInlineCode(child);
+					if (highlightedCode) node.children[i] = highlightedCode;
 				} else if (child.type === "element") await visit(child);
 			}
 		};
@@ -6848,6 +6816,11 @@ function getTextContent(node) {
 	}
 	return text;
 }
+function normalizeClassName(className) {
+	if (Array.isArray(className)) return className.filter((value) => typeof value === "string");
+	if (typeof className === "string" && className) return className.split(/\s+/).filter(Boolean);
+	return [];
+}
 /**
 * Apply syntax highlighting to HTML using Shiki.
 */
@@ -6858,7 +6831,6 @@ async function highlightCode(html, theme = "github-dark", langs = []) {
 	}).use(rehypeStringify).process(html);
 	return String(result);
 }
-
 //#endregion
 //#region src/plugins/mermaid-protect.ts
 /**
@@ -6911,7 +6883,6 @@ function restoreMermaidSvgs(html, svgs) {
 	for (const [placeholder, content] of svgs) result = result.replace(placeholder, content);
 	return result;
 }
-
 //#endregion
 //#region src/transform.ts
 /**
@@ -6999,7 +6970,7 @@ async function loadNapiBindings() {
 	if (napiLoadAttempted) return napiBindings ?? null;
 	napiLoadAttempted = true;
 	try {
-		const mod = await import("@ox-content/napi");
+		const mod = await importNapiModule();
 		napiBindings = mod;
 		return mod;
 	} catch (error) {
@@ -7021,7 +6992,11 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		tocMaxDepth: options.tocMaxDepth,
 		convertMdLinks: ssgOptions?.convertMdLinks,
 		baseUrl: ssgOptions?.baseUrl,
-		sourcePath: ssgOptions?.sourcePath ?? filePath
+		sourcePath: ssgOptions?.sourcePath ?? filePath,
+		codeAnnotations: options.codeAnnotations.enabled,
+		codeAnnotationMetaKey: options.codeAnnotations.metaKey,
+		codeAnnotationSyntax: options.codeAnnotations.notation,
+		codeAnnotationDefaultLineNumbers: options.codeAnnotations.defaultLineNumbers
 	});
 	if (result.errors.length > 0) console.warn("[ox-content] Transform warnings:", result.errors);
 	let html = result.html;
@@ -7033,7 +7008,11 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 	if (options.mermaid) html = await transformMermaidStatic(html);
 	const { html: protectedHtml, svgs } = protectMermaidSvgs(html);
 	html = protectedHtml;
-	if (options.highlight) html = await highlightCode(html, options.highlightTheme, options.highlightLangs);
+	if (options.highlight) {
+		const originalHtml = html;
+		const highlightedHtml = await highlightCode(html, options.highlightTheme, options.highlightLangs);
+		html = napi.mergeHighlightedCodeBlocks(originalHtml, highlightedHtml);
+	}
 	html = restoreMermaidSvgs(html, svgs);
 	return {
 		code: generateModuleCode(html, frontmatter, toc, filePath, options),
@@ -7129,7 +7108,6 @@ if (import.meta.hot) {
 }
 `;
 }
-
 //#endregion
 //#region src/nav-generator.ts
 /**
@@ -7276,7 +7254,7 @@ function generateNavMetadata(docs, basePath = "/api") {
 * @internal
 */
 function getDocDisplayName(filePath) {
-	const fileName = path$1.basename(filePath, path$1.extname(filePath));
+	const fileName = path.basename(filePath, path.extname(filePath));
 	if (fileName === "index" || fileName === "index-module") return "Overview";
 	return fileName.replace(/[-_]([a-z])/g, (_, char) => " " + char.toUpperCase()).replace(/^[a-z]/, (char) => char.toUpperCase());
 }
@@ -7293,7 +7271,7 @@ function getDocDisplayName(filePath) {
 * @internal
 */
 function getDocFileName(filePath) {
-	const fileName = path$1.basename(filePath, path$1.extname(filePath));
+	const fileName = path.basename(filePath, path.extname(filePath));
 	if (fileName === "index") return "index";
 	return fileName;
 }
@@ -7368,7 +7346,6 @@ export interface NavItem {
 export const ${exportName}: NavItem[] = ${JSON.stringify(navItems, null, 2)} as const;
 `;
 }
-
 //#endregion
 //#region src/docs.ts
 /**
@@ -7422,16 +7399,160 @@ export const ${exportName}: NavItem[] = ${JSON.stringify(navItems, null, 2)} as
 * ```
 */
 const DOCS_MANIFEST_FILE = ".ox-content-docs-manifest.json";
-/**
-* Regex pattern for matching JSDoc comment blocks.
-*
-* Matches block comments that start at the beginning of a line
-* (with optional leading whitespace). This pattern avoids false matches
-* with block comments inside strings like glob patterns.
-*
-* @internal
-*/
-const JSDOC_BLOCK = /^[ \t]*\/\*\*\s*([\s\S]*?)\s*\*\//gm;
+const DOCS_DATA_FILE = "docs.json";
+function escapeHtml$3(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function entryAnchor(name) {
+	return name.toLowerCase();
+}
+function cleanSummaryText(text, maxLength = 120) {
+	if (!text) return "";
+	const collapsed = text.replace(/\s+/g, " ").trim();
+	if (collapsed.length <= maxLength) return collapsed;
+	return `${collapsed.slice(0, maxLength - 1).trimEnd()}…`;
+}
+function renderInlineHtml(text) {
+	let html = "";
+	let lastIndex = 0;
+	const tokenPattern = /`([^`]+)`|\[([^\]]+)\]\(([^)]+)\)|\*\*([^*]+)\*\*|__([^_]+)__|\*([^*]+)\*|_([^_]+)_/g;
+	let match;
+	while ((match = tokenPattern.exec(text)) !== null) {
+		html += escapeHtml$3(text.slice(lastIndex, match.index));
+		if (match[1]) html += `<code>${escapeHtml$3(match[1])}</code>`;
+		else if (match[2] && match[3]) html += `<a href="${escapeHtml$3(match[3])}">${renderInlineHtml(match[2])}</a>`;
+		else if (match[4] || match[5]) {
+			const strongText = match[4] ?? match[5] ?? "";
+			html += `<strong>${renderInlineHtml(strongText)}</strong>`;
+		} else if (match[6] || match[7]) {
+			const emphasisText = match[6] ?? match[7] ?? "";
+			html += `<em>${renderInlineHtml(emphasisText)}</em>`;
+		}
+		lastIndex = match.index + match[0].length;
+	}
+	html += escapeHtml$3(text.slice(lastIndex));
+	return html.replace(/\n/g, "<br>");
+}
+function isFenceStart(line) {
+	return /^```([\w-]+)?\s*$/.exec(line.trim());
+}
+function isHeading(line) {
+	return /^(#{1,6})\s+(.*)$/.exec(line.trim());
+}
+function isOrderedListItem(line) {
+	return /^\d+\.\s+(.*)$/.exec(line.trim());
+}
+function isUnorderedListItem(line) {
+	return /^[-*+]\s+(.*)$/.exec(line.trim());
+}
+function isMarkdownBlockStart(line) {
+	return Boolean(isFenceStart(line) || isHeading(line) || isOrderedListItem(line) || isUnorderedListItem(line));
+}
+function renderMarkdownBlocksHtml(text) {
+	const lines = text.split(/\r?\n/);
+	const blocks = [];
+	let index = 0;
+	while (index < lines.length) {
+		const line = lines[index];
+		const trimmed = line.trim();
+		if (!trimmed) {
+			index++;
+			continue;
+		}
+		const fenceMatch = isFenceStart(line);
+		if (fenceMatch) {
+			const language = fenceMatch[1] || "text";
+			const codeLines = [];
+			index++;
+			while (index < lines.length && !lines[index].trim().startsWith("```")) {
+				codeLines.push(lines[index]);
+				index++;
+			}
+			if (index < lines.length) index++;
+			blocks.push(renderCodeBlockHtml(codeLines.join("\n"), language));
+			continue;
+		}
+		const headingMatch = isHeading(line);
+		if (headingMatch) {
+			const level = Math.min(headingMatch[1].length, 6);
+			blocks.push(`<h${level}>${renderInlineHtml(headingMatch[2].trim())}</h${level}>`);
+			index++;
+			continue;
+		}
+		if (isOrderedListItem(line)) {
+			const items = [];
+			while (index < lines.length) {
+				const currentLine = lines[index];
+				const currentMatch = isOrderedListItem(currentLine);
+				if (!currentMatch) break;
+				const itemLines = [currentMatch[1].trim()];
+				index++;
+				while (index < lines.length) {
+					const continuation = lines[index];
+					const continuationTrimmed = continuation.trim();
+					if (!continuationTrimmed || isMarkdownBlockStart(continuation) || /^ {0,1}\d+\.\s+/.test(continuationTrimmed)) break;
+					itemLines.push(continuationTrimmed);
+					index++;
+				}
+				items.push(`<li>${renderInlineHtml(itemLines.join(" "))}</li>`);
+				if (index < lines.length && !lines[index].trim()) break;
+			}
+			blocks.push(`<ol>\n${items.join("\n")}\n</ol>`);
+			continue;
+		}
+		if (isUnorderedListItem(line)) {
+			const items = [];
+			while (index < lines.length) {
+				const currentLine = lines[index];
+				const currentMatch = isUnorderedListItem(currentLine);
+				if (!currentMatch) break;
+				const itemLines = [currentMatch[1].trim()];
+				index++;
+				while (index < lines.length) {
+					const continuation = lines[index];
+					const continuationTrimmed = continuation.trim();
+					if (!continuationTrimmed || isMarkdownBlockStart(continuation) || /^[-*+]\s+/.test(continuationTrimmed)) break;
+					itemLines.push(continuationTrimmed);
+					index++;
+				}
+				items.push(`<li>${renderInlineHtml(itemLines.join(" "))}</li>`);
+				if (index < lines.length && !lines[index].trim()) break;
+			}
+			blocks.push(`<ul>\n${items.join("\n")}\n</ul>`);
+			continue;
+		}
+		const paragraphLines = [trimmed];
+		index++;
+		while (index < lines.length) {
+			const nextLine = lines[index];
+			const nextTrimmed = nextLine.trim();
+			if (!nextTrimmed || isMarkdownBlockStart(nextLine)) break;
+			paragraphLines.push(nextTrimmed);
+			index++;
+		}
+		blocks.push(`<p>${renderInlineHtml(paragraphLines.join(" "))}</p>`);
+	}
+	return `<div class="ox-api-entry__prose">\n${blocks.join("\n")}\n</div>`;
+}
+function renderCodeBlockHtml(code, language = "typescript") {
+	return `<pre><code class="language-${language}">${escapeHtml$3(code)}</code></pre>`;
+}
+function renderHighlightedInlineCodeHtml(code, className, language = "typescript") {
+	return `<code class="${escapeHtml$3(className)} language-${language}">${escapeHtml$3(code)}</code>`;
+}
+function renderDetailsControlsHtml(targetSelector) {
+	return `<div class="ox-api-controls" data-ox-api-target="${targetSelector}" role="toolbar" aria-label="Reference display controls">
+<button type="button" class="ox-api-controls__button" data-ox-api-toggle="expand">Open all</button>
+<button type="button" class="ox-api-controls__button" data-ox-api-toggle="collapse">Close all</button>
+</div>`;
+}
+function buildDocsData(docs) {
+	return {
+		version: 1,
+		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		modules: docs
+	};
+}
 /**
 * Extracts JSDoc documentation from source files in specified directories.
 *
@@ -7498,11 +7619,13 @@ const JSDOC_BLOCK = /^[ \t]*\/\*\*\s*([\s\S]*?)\s*\*\//gm;
 * ```
 */
 async function extractDocs(srcDirs, options) {
+	const extractFileDocs = (await importNapiModule()).extractFileDocs;
+	if (!extractFileDocs) throw new Error("[ox-content] extractFileDocs is not available from @ox-content/napi.");
 	const results = [];
 	for (const srcDir of srcDirs) {
 		const files = await findFiles(srcDir, options);
 		for (const file of files) {
-			const entries = extractFromContent(await fs$1.promises.readFile(file, "utf-8"), file, options);
+			const entries = extractFileDocs(file, options.private).map(parseNapiDocItem).filter((entry) => Boolean(entry));
 			if (entries.length > 0) results.push({
 				file,
 				entries
@@ -7526,7 +7649,7 @@ async function findFiles(dir, options) {
 			return;
 		}
 		for (const entry of entries) {
-			const fullPath = path.join(currentDir, entry.name);
+			const fullPath = path$1.join(currentDir, entry.name);
 			if (entry.isDirectory()) {
 				if (!isExcluded(fullPath, options.exclude)) await walk(fullPath);
 			} else if (entry.isFile()) {
@@ -7553,127 +7676,21 @@ function isExcluded(file, patterns) {
 		return false;
 	});
 }
-/**
-* Extracts documentation entries from file content.
-*/
-function extractFromContent(content, file, options) {
-	const entries = [];
-	let match;
-	JSDOC_BLOCK.lastIndex = 0;
-	while ((match = JSDOC_BLOCK.exec(content)) !== null) {
-		const jsdocContent = match[1];
-		const jsdocEnd = match.index + match[0].length;
-		const afterJsdoc = content.slice(jsdocEnd).trim();
-		const lineNumber = content.slice(0, match.index).split("\n").length;
-		const entry = parseJsdocBlock(jsdocContent, afterJsdoc, file, lineNumber);
-		if (entry && (options.private || !entry.private)) entries.push(entry);
-	}
-	return entries;
-}
-/**
-* Extracts the complete function signature for display.
-*
-* Captures the full function declaration from `export/async/function name(...): ReturnType`
-* or `export const name = (...): ReturnType => {}`, handling multi-line signatures.
-*
-* @param signature - Multi-line function declaration text
-* @returns Cleaned function signature or undefined if not found
-*
-* @internal
-*/
-function extractFunctionSignature(signature) {
-	const match = signature.match(/(?:export\s+)?(?:async\s+)?(?:function\s+\w+|\w+\s*=\s*(?:async\s*)?\()\([^{]*?\)(?:\s*:\s*[^{;]+)?/s);
-	if (match) {
-		let sig = match[0].trim();
-		sig = sig.split("\n").map((line) => line.trim()).filter((line) => line).join("\n  ");
-		return sig;
-	}
-}
-/**
-* Extracts parameter and return types from a TypeScript function signature.
-*
-* Parses function signatures to extract:
-* - Parameter names and their type annotations
-* - Return type annotation
-*
-* Handles various function declaration styles:
-* - `function name(param: type): ReturnType`
-* - `const name = (param: type): ReturnType => {}`
-* - `export async function name(param: type): Promise<ReturnType>`
-*
-* @param signature - Multi-line function signature text
-* @param params - Array of parameter docs with names already extracted
-* @returns Object with extracted parameter types and return type
-*
-* @internal
-*/
-function extractTypesFromSignature(signature, _params) {
-	const paramTypes = [];
-	const paramListMatch = signature.match(/\(([^)]*)\)(?:\s*:\s*([^{=>]+))?/s);
-	if (paramListMatch && paramListMatch[1]) {
-		const paramListStr = paramListMatch[1];
-		const paramParts = splitParameters(paramListStr);
-		for (const part of paramParts) {
-			const trimmed = part.trim();
-			if (!trimmed) continue;
-			const typeMatch = /:\s*(.+?)(?:\s*=|$)/.exec(trimmed);
-			if (typeMatch) {
-				let typeStr = typeMatch[1].trim();
-				if (typeStr.includes("=")) typeStr = typeStr.split("=")[0].trim();
-				paramTypes.push(typeStr);
-			}
-		}
-	}
-	let returnType;
-	const returnTypeMatch = signature.match(/\)\s*:\s*(.+?)(?={|$)/);
-	if (returnTypeMatch) returnType = returnTypeMatch[1].trim();
-	return {
-		paramTypes,
-		returnType
-	};
-}
-/**
-* Splits function parameters while respecting nested angle brackets (generics).
-*
-* Handles cases like:
-* - `a: string, b: number` → `["a: string", "b: number"]`
-* - `a: Promise<string>, b: Record<string, any>` → `["a: Promise<string>", "b: Record<string, any>"]`
-*
-* @param paramListStr - String containing all parameters
-* @returns Array of individual parameter strings
-*
-* @internal
-*/
-function splitParameters(paramListStr) {
-	const parts = [];
-	let current = "";
-	let depth = 0;
-	for (const char of paramListStr) if (char === "<") {
-		depth++;
-		current += char;
-	} else if (char === ">") {
-		depth--;
-		current += char;
-	} else if (char === "," && depth === 0) {
-		parts.push(current);
-		current = "";
-	} else current += char;
-	if (current) parts.push(current);
-	return parts;
-}
-/**
-* Parses a JSDoc block and the following declaration.
-* Only matches if the declaration is immediately after the JSDoc (with only whitespace/keywords between).
-*/
-function parseJsdocBlock(jsdoc, declaration, file, line) {
+function parseNapiDocItem(item) {
+	const kind = normalizeNapiKind(item.kind);
+	if (!kind) return null;
 	const params = [];
 	const examples = [];
 	const tags = {};
 	let description = "";
 	let returns;
 	let isPrivate = false;
-	const rawLines = jsdoc.split("\n").map((l) => l.replace(/^\s*\*\s?/, ""));
-	const cleanedLines = rawLines.map((l) => l.trim()).filter((l) => l);
+	const rawLines = (item.jsdoc ?? "").split("\n").map((line) => {
+		const trimmedStart = line.trimStart();
+		const withoutStar = trimmedStart.startsWith("*") ? trimmedStart.slice(1) : trimmedStart;
+		return withoutStar.startsWith(" ") ? withoutStar.slice(1) : withoutStar;
+	});
+	const cleanedLines = rawLines.map((line) => line.trim()).filter(Boolean);
 	let currentExample = "";
 	let inExample = false;
 	let rawLineIndex = 0;
@@ -7720,47 +7737,40 @@ function parseJsdocBlock(jsdoc, declaration, file, line) {
 		else description += "\n" + lineText;
 	}
 	if (inExample && currentExample) examples.push(currentExample.trim());
-	const firstFewLines = declaration.split("\n").slice(0, 5).join("\n");
-	let name = "";
-	let kind = "function";
-	const ANCHORED_FUNCTION = /^(?:export\s+)?(?:async\s+)?function\s+(\w+)/;
-	const ANCHORED_CONST_FUNC = /^(?:export\s+)?const\s+(\w+)\s*=\s*(?:async\s*)?\(/;
-	const ANCHORED_CLASS = /^(?:export\s+)?class\s+(\w+)/;
-	const ANCHORED_INTERFACE = /^(?:export\s+)?interface\s+(\w+)/;
-	const ANCHORED_TYPE = /^(?:export\s+)?type\s+(\w+)/;
-	let declMatch;
-	if (declMatch = ANCHORED_FUNCTION.exec(firstFewLines)) {
-		name = declMatch[1];
-		kind = "function";
-	} else if (declMatch = ANCHORED_CONST_FUNC.exec(firstFewLines)) {
-		name = declMatch[1];
-		kind = "function";
-	} else if (declMatch = ANCHORED_CLASS.exec(firstFewLines)) {
-		name = declMatch[1];
-		kind = "class";
-	} else if (declMatch = ANCHORED_INTERFACE.exec(firstFewLines)) {
-		name = declMatch[1];
-		kind = "interface";
-	} else if (declMatch = ANCHORED_TYPE.exec(firstFewLines)) {
-		name = declMatch[1];
-		kind = "type";
-	}
-	if (!name) return null;
-	let signature;
-	if (kind === "function") {
-		const signatureTypes = extractTypesFromSignature(firstFewLines, params);
-		if (signatureTypes.paramTypes.length > 0) {
-			for (let i = 0; i < params.length && i < signatureTypes.paramTypes.length; i++) if (params[i].type === "unknown") params[i].type = signatureTypes.paramTypes[i];
-		}
-		if (signatureTypes.returnType && (!returns || returns.type === "unknown")) if (returns) returns.type = signatureTypes.returnType;
-		else returns = {
-			type: signatureTypes.returnType,
-			description: ""
-		};
-		signature = extractFunctionSignature(firstFewLines);
+	if (params.length === 0 && item.params.length > 0) params.push(...item.params.map((param) => ({
+		name: param.name,
+		type: param.typeAnnotation ?? "unknown",
+		description: param.description ?? "",
+		optional: param.optional || void 0,
+		default: param.defaultValue
+	})));
+	else if (item.params.length > 0) {
+		const paramMap = new Map(item.params.map((param) => [param.name, param]));
+		for (const param of params) {
+			const rustParam = paramMap.get(param.name);
+			if (!rustParam) continue;
+			if (param.type === "unknown" && rustParam.typeAnnotation) param.type = rustParam.typeAnnotation;
+			if (!param.description && rustParam.description) param.description = rustParam.description;
+			if (param.optional === void 0 && rustParam.optional) param.optional = true;
+			if (!param.default && rustParam.defaultValue) param.default = rustParam.defaultValue;
+		}
+	}
+	if (!returns && item.returnType) returns = {
+		type: item.returnType,
+		description: ""
+	};
+	else if (returns && returns.type === "unknown" && item.returnType) returns.type = item.returnType;
+	if (!description) description = item.doc ?? "";
+	for (const tag of item.tags) {
+		if (tag.tag === "param" || tag.tag === "returns" || tag.tag === "return" || tag.tag === "example") continue;
+		if (tag.tag === "private") {
+			isPrivate = true;
+			continue;
+		}
+		if (!tags[tag.tag]) tags[tag.tag] = tag.value;
 	}
 	return {
-		name,
+		name: item.name,
 		kind,
 		description,
 		params: params.length > 0 ? params : void 0,
@@ -7768,121 +7778,214 @@ function parseJsdocBlock(jsdoc, declaration, file, line) {
 		examples: examples.length > 0 ? examples : void 0,
 		tags: Object.keys(tags).length > 0 ? tags : void 0,
 		private: isPrivate,
-		file,
-		line,
-		signature
+		file: item.sourcePath,
+		line: item.line,
+		endLine: item.endLine,
+		signature: item.signature
 	};
 }
+function normalizeNapiKind(kind) {
+	switch (kind) {
+		case "function":
+		case "class":
+		case "interface":
+		case "type":
+		case "variable":
+		case "module": return kind;
+		case "enum": return "type";
+		default: return null;
+	}
+}
 /**
 * Generates Markdown documentation from extracted docs.
 */
 function generateMarkdown(docs, options) {
 	const result = {};
-	const symbolMap = buildSymbolMap(docs);
+	const sortedDocs = sortExtractedDocs(docs);
+	const symbolMap = buildSymbolMap(sortedDocs);
 	if (options.groupBy === "file") {
 		const docToFile = /* @__PURE__ */ new Map();
-		for (const doc of docs) {
-			let fileName = path.basename(doc.file, path.extname(doc.file));
+		for (const doc of sortedDocs) {
+			let fileName = path$1.basename(doc.file, path$1.extname(doc.file));
 			if (fileName === "index") fileName = "index-module";
 			docToFile.set(doc, fileName);
 			const markdown = generateFileMarkdown(doc, options, fileName, symbolMap);
 			result[`${fileName}.md`] = markdown;
 		}
-		result["index.md"] = generateIndex(docs, docToFile);
+		result["index.md"] = generateIndex(sortedDocs, docToFile);
 	} else {
 		const byKind = /* @__PURE__ */ new Map();
-		for (const doc of docs) for (const entry of doc.entries) {
+		for (const doc of sortedDocs) for (const entry of doc.entries) {
 			const existing = byKind.get(entry.kind) || [];
 			existing.push(entry);
 			byKind.set(entry.kind, existing);
 		}
-		for (const [kind, entries] of byKind) result[`${kind}s.md`] = generateCategoryMarkdown(kind, entries, options, symbolMap);
+		for (const entries of byKind.values()) entries.sort(compareEntriesByName);
+		for (const [kind, entries] of [...byKind.entries()].sort(([a], [b]) => compareStrings(a, b))) result[`${kind}s.md`] = generateCategoryMarkdown(kind, entries, options, symbolMap);
 		result["index.md"] = generateCategoryIndex(byKind);
 	}
 	return result;
 }
+function compareStrings(a, b) {
+	return a.localeCompare(b, "en", {
+		numeric: true,
+		sensitivity: "base"
+	});
+}
+function compareEntriesByName(a, b) {
+	return compareStrings(a.name, b.name);
+}
+function sortExtractedDocs(docs) {
+	return [...docs].map((doc) => ({
+		...doc,
+		entries: [...doc.entries].sort(compareEntriesByName)
+	})).sort((a, b) => compareStrings(path$1.basename(a.file), path$1.basename(b.file)));
+}
 function generateFileMarkdown(doc, options, currentFileName, symbolMap) {
-	let md = `# ${path.basename(doc.file)}\n\n`;
+	let md = `# ${path$1.basename(doc.file)}\n\n`;
 	if (options.githubUrl) {
 		const sourceLink = generateSourceLink(doc.file, options.githubUrl);
 		if (sourceLink) md += sourceLink + "\n\n";
 	}
+	md += `> ${doc.entries.length} documented symbol${doc.entries.length === 1 ? "" : "s"}. `;
+	md += "Read the signatures first, then expand each item for parameters, return types, and examples.\n\n";
+	md += "## Reference\n\n";
+	if (doc.entries.length > 1) md += renderDetailsControlsHtml(".ox-api-entry") + "\n\n";
 	for (const entry of doc.entries) md += generateEntryMarkdown(entry, options, currentFileName, symbolMap);
 	return md;
 }
+function normalizeSignature(signature) {
+	if (!signature) return;
+	return signature.replace(/\s+/g, " ").replace(/^export\s+/, "").replace(/^declare\s+/, "").replace(/^abstract\s+/, "").replace(/^async\s+function\s+/, "").replace(/^function\s+/, "").replace(/^class\s+/, "").replace(/^interface\s+/, "").replace(/^type\s+/, "").trim();
+}
+function formatKindLabel(kind) {
+	switch (kind) {
+		case "function": return "fn";
+		case "interface": return "interface";
+		case "class": return "class";
+		case "type": return "type";
+		case "const": return "const";
+		default: return kind;
+	}
+}
+function renderOverviewLine(entry, href) {
+	const signature = normalizeSignature(entry.signature);
+	const summary = cleanSummaryText(entry.description, 88);
+	const parts = [`- [\`${entry.name}\`](${href})`, `\`${entry.kind}\``];
+	if (signature) parts.push(`\`${signature}\``);
+	if (summary) parts.push(`- ${summary}`);
+	return `${parts.join(" ")}\n`;
+}
+function renderOverviewHtmlItem(entry, href) {
+	const signature = normalizeSignature(entry.signature);
+	const summary = cleanSummaryText(entry.description, 88);
+	const heading = signature ? `<a href="${escapeHtml$3(href)}" class="ox-api-module__link">${renderHighlightedInlineCodeHtml(signature, "ox-api-module__signature ox-api-module__signature--highlighted")}</a>` : `<a href="${escapeHtml$3(href)}" class="ox-api-module__link"><code class="ox-api-module__name">${escapeHtml$3(entry.name)}</code></a>`;
+	return `<li><span class="ox-api-module__kind">${escapeHtml$3(formatKindLabel(entry.kind))}</span><div class="ox-api-module__item">${heading}${summary ? `<span class="ox-api-module__summary">${renderInlineHtml(summary)}</span>` : ""}</div></li>`;
+}
+function renderParamsListHtml(params) {
+	return `<div class="ox-api-entry__section ox-api-entry__section--params">
+<h4>Parameters</h4>
+<ul class="ox-api-entry__params">
+${params.map((param) => {
+		const flags = [param.optional ? "optional" : "", param.default ? `default: ${param.default}` : ""].filter(Boolean);
+		const description = [param.description, flags.join(" · ")].filter(Boolean).join(" — ");
+		return `<li class="ox-api-entry__param">
+  <div class="ox-api-entry__param-heading">
+    <code class="ox-api-entry__param-name">${escapeHtml$3(param.name)}</code>
+    <code class="ox-api-entry__param-type">${escapeHtml$3(param.type)}</code>
+  </div>
+  ${description ? `<p class="ox-api-entry__param-description">${renderInlineHtml(description)}</p>` : ""}
+</li>`;
+	}).join("\n")}
+</ul>
+</div>`;
+}
+function renderTagListHtml(tags) {
+	return `<div class="ox-api-entry__section ox-api-entry__section--tags">
+<h4>Tags</h4>
+<ul class="ox-api-entry__tags">${Object.entries(tags).map(([tag, value]) => `<li><span class="ox-api-entry__tag-name">@${escapeHtml$3(tag)}</span><span class="ox-api-entry__tag-value">${renderInlineHtml(value)}</span></li>`).join("")}</ul>
+</div>`;
+}
 function generateEntryMarkdown(entry, options, currentFileName, symbolMap) {
-	let md = `## ${entry.name}\n\n`;
-	md += `\`${entry.kind}\`\n\n`;
-	if (entry.description) {
-		const processedDescription = currentFileName && symbolMap ? convertSymbolLinks(entry.description, currentFileName, symbolMap) : entry.description;
-		md += `${processedDescription}\n\n`;
-	}
-	if (options?.githubUrl) {
-		const sourceLink = generateSourceLink(entry.file, options.githubUrl, entry.line);
-		if (sourceLink) md += sourceLink + "\n\n";
-	}
-	if (entry.signature && entry.kind === "function") {
-		md += "```typescript\n";
-		md += entry.signature + "\n";
-		md += "```\n\n";
-	}
-	if (entry.params && entry.params.length > 0) {
-		md += "### Parameters\n\n";
-		md += "| Name | Type | Description |\n";
-		md += "|------|------|-------------|\n";
-		for (const param of entry.params) md += `| \`${param.name}\` | \`${param.type}\` | ${param.description} |\n`;
-		md += "\n";
-	}
-	if (entry.returns) {
-		md += "### Returns\n\n";
-		md += `\`${entry.returns.type}\` - ${entry.returns.description}\n\n`;
-	}
+	const processedDescription = entry.description && currentFileName && symbolMap ? convertSymbolLinks(entry.description, currentFileName, symbolMap) : entry.description;
+	const summarySignature = normalizeSignature(entry.signature);
+	const sourceHref = options?.githubUrl ? generateSourceHref(entry.file, options.githubUrl, entry.line, entry.endLine) : void 0;
+	let body = "";
+	if (processedDescription) body += renderMarkdownBlocksHtml(processedDescription) + "\n";
+	if (sourceHref) body += `<p class="ox-api-entry__source"><a href="${escapeHtml$3(sourceHref)}">View source</a></p>\n`;
+	if (entry.params && entry.params.length > 0) body += renderParamsListHtml(entry.params) + "\n";
+	if (entry.returns) body += `<div class="ox-api-entry__section ox-api-entry__section--returns">
+<h4>Returns</h4>
+<div class="ox-api-entry__return">
+  <code class="ox-api-entry__return-type">${escapeHtml$3(entry.returns.type)}</code>
+  ${entry.returns.description ? `<p class="ox-api-entry__return-description">${renderInlineHtml(entry.returns.description)}</p>` : ""}
+</div>
+</div>\n`;
 	if (entry.examples && entry.examples.length > 0) {
-		md += "### Examples\n\n";
-		for (const example of entry.examples) {
-			md += "```ts\n";
-			md += example.replace(/^```\w*\n?/, "").replace(/\n?```$/, "");
-			md += "\n```\n\n";
-		}
-	}
-	md += "---\n\n";
-	return md;
+		const examplesHtml = entry.examples.map((example) => example.replace(/^```\w*\n?/, "").replace(/\n?```$/, "")).map((example) => renderCodeBlockHtml(example, "ts")).join("\n");
+		body += `<div class="ox-api-entry__section ox-api-entry__section--examples">\n<h4>Examples</h4>\n${examplesHtml}\n</div>\n`;
+	}
+	if (entry.tags && Object.keys(entry.tags).length > 0) body += renderTagListHtml(entry.tags) + "\n";
+	const summaryDescription = cleanSummaryText(processedDescription, summarySignature ? 80 : 120);
+	const summaryHeading = summarySignature ? renderHighlightedInlineCodeHtml(summarySignature, "ox-api-entry__signature ox-api-entry__signature--highlighted") : `<code class="ox-api-entry__name">${escapeHtml$3(entry.name)}</code>`;
+	const summaryParts = [`<span class="ox-api-entry__kind">${escapeHtml$3(formatKindLabel(entry.kind))}</span>`, `<span class="ox-api-entry__summary-main">${summaryHeading}${summaryDescription ? `<span class="ox-api-entry__description">${renderInlineHtml(summaryDescription)}</span>` : ""}</span>`];
+	return `<details id="${entryAnchor(entry.name)}" class="ox-api-entry">
+  <summary>${summaryParts.join("")}</summary>
+  <div class="ox-api-entry__body">
+${body.trim()}
+  </div>
+</details>
+
+`;
 }
 function generateIndex(docs, docToFile) {
 	let md = "# API Documentation\n\n";
 	md += "Generated by [Ox Content](https://github.com/ubugeeei/ox-content)\n\n";
+	md += "> Use search scopes like `@api transform` to limit results to the generated API reference.\n\n";
 	md += "## Modules\n\n";
+	if (docs.length > 1) md += renderDetailsControlsHtml(".ox-api-module") + "\n\n";
 	for (const doc of docs) {
-		const displayName = path.basename(doc.file, path.extname(doc.file));
+		const displayName = path$1.basename(doc.file, path$1.extname(doc.file));
 		let fileName = displayName;
 		if (docToFile && docToFile.has(doc)) fileName = docToFile.get(doc);
 		else if (fileName === "index") fileName = "index-module";
-		md += `### [${displayName}](./${fileName}.md)\n\n`;
-		for (const entry of doc.entries) {
-			const desc = entry.description?.slice(0, 80) || "";
-			const ellipsis = entry.description && entry.description.length > 80 ? "..." : "";
-			md += `- \`${entry.kind}\` **${entry.name}** - ${desc}${ellipsis}\n`;
-		}
-		md += "\n";
+		const countLabel = `${doc.entries.length} symbol${doc.entries.length === 1 ? "" : "s"}`;
+		md += `<details class="ox-api-module">
+  <summary>
+    <span class="ox-api-module__title"><a href="./${fileName}.md">${escapeHtml$3(displayName)}</a></span>
+    <span class="ox-api-module__count">${countLabel}</span>
+  </summary>
+  <div class="ox-api-module__body">
+    <ul class="ox-api-module__list">
+`;
+		for (const entry of doc.entries) md += `      ${renderOverviewHtmlItem(entry, `./${fileName}.md#${entryAnchor(entry.name)}`)}\n`;
+		md += `    </ul>
+  </div>
+</details>
+
+`;
 	}
 	return md;
 }
 function generateCategoryMarkdown(kind, entries, options, symbolMap) {
 	const categoryFileName = `${kind}s`;
 	let md = `# ${kind.charAt(0).toUpperCase() + kind.slice(1)}s\n\n`;
+	md += `> ${entries.length} documented ${kind}${entries.length === 1 ? "" : "s"} collected across modules.\n\n`;
+	md += "## Overview\n\n";
+	for (const entry of entries) md += renderOverviewLine(entry, `#${entryAnchor(entry.name)}`);
+	md += "\n## Reference\n\n";
+	if (entries.length > 1) md += renderDetailsControlsHtml(".ox-api-entry") + "\n\n";
 	for (const entry of entries) md += generateEntryMarkdown(entry, options, categoryFileName, symbolMap);
 	return md;
 }
 function generateCategoryIndex(byKind) {
 	let md = "# API Documentation\n\n";
 	md += "Generated by [Ox Content](https://github.com/ubugeeei/ox-content)\n\n";
-	for (const [kind, entries] of byKind) {
+	for (const [kind, entries] of [...byKind.entries()].sort(([a], [b]) => compareStrings(a, b))) {
 		const kindTitle = kind.charAt(0).toUpperCase() + kind.slice(1) + "s";
 		md += `## [${kindTitle}](./${kind}s.md)\n\n`;
-		for (const entry of entries) {
-			const desc = entry.description?.slice(0, 60) || "";
-			md += `- **${entry.name}** - ${desc}...\n`;
-		}
+		md += `> ${entries.length} item${entries.length === 1 ? "" : "s"}.\n\n`;
+		for (const entry of entries) md += renderOverviewLine(entry, `./${kind}s.md#${entryAnchor(entry.name)}`);
 		md += "\n";
 	}
 	return md;
@@ -7923,7 +8026,7 @@ function convertSymbolLinks(text, currentFileName, symbolMap) {
 function buildSymbolMap(docs) {
 	const map = /* @__PURE__ */ new Map();
 	for (const doc of docs) {
-		let fileName = path.basename(doc.file, path.extname(doc.file));
+		let fileName = path$1.basename(doc.file, path$1.extname(doc.file));
 		if (fileName === "index") fileName = "index-module";
 		for (const entry of doc.entries) map.set(entry.name, {
 			name: entry.name,
@@ -7940,7 +8043,8 @@ async function writeDocs(docs, outDir, extractedDocs, options) {
 	await fs$1.promises.mkdir(outDir, { recursive: true });
 	const generatedFiles = new Set(Object.keys(docs));
 	if (extractedDocs && options?.generateNav && options.groupBy === "file") generatedFiles.add("nav.ts");
-	const manifestPath = path.join(outDir, DOCS_MANIFEST_FILE);
+	if (extractedDocs) generatedFiles.add(DOCS_DATA_FILE);
+	const manifestPath = path$1.join(outDir, DOCS_MANIFEST_FILE);
 	let previousFiles = [];
 	try {
 		previousFiles = JSON.parse(await fs$1.promises.readFile(manifestPath, "utf-8"));
@@ -7949,32 +8053,37 @@ async function writeDocs(docs, outDir, extractedDocs, options) {
 	}
 	for (const staleFile of previousFiles) {
 		if (generatedFiles.has(staleFile)) continue;
-		await fs$1.promises.rm(path.join(outDir, staleFile), { force: true });
+		await fs$1.promises.rm(path$1.join(outDir, staleFile), { force: true });
 	}
 	for (const [fileName, content] of Object.entries(docs)) {
-		const filePath = path.join(outDir, fileName);
+		const filePath = path$1.join(outDir, fileName);
 		await fs$1.promises.writeFile(filePath, content, "utf-8");
 	}
 	if (extractedDocs && options?.generateNav && options.groupBy === "file") {
 		const navCode = generateNavCode(generateNavMetadata(extractedDocs, "/api"), "apiNav");
-		const navFilePath = path.join(outDir, "nav.ts");
+		const navFilePath = path$1.join(outDir, "nav.ts");
 		await fs$1.promises.writeFile(navFilePath, navCode, "utf-8");
 	}
+	if (extractedDocs) await fs$1.promises.writeFile(path$1.join(outDir, DOCS_DATA_FILE), JSON.stringify(buildDocsData(extractedDocs), null, 2), "utf-8");
 	await fs$1.promises.writeFile(manifestPath, JSON.stringify([...generatedFiles].sort(), null, 2), "utf-8");
 }
 /**
 * Resolves docs options with defaults.
 */
 /**
-* Generates a GitHub source link for a file and optional line number.
+* Generates a GitHub source link for a file and optional line range.
 *
 * @param filePath - Full path to the source file
 * @param githubUrl - Base GitHub repository URL
-* @param lineNumber - Optional line number to link to
-* @returns Markdown link to source code
+* @param lineNumber - Optional start line number to link to
+* @param endLineNumber - Optional end line number to link to
+* @returns Absolute GitHub URL to source code
 */
-function generateSourceLink(filePath, githubUrl, lineNumber) {
-	return `**[Source](${`${githubUrl}/blob/main/${filePath.replace(/^.*?\/(npm|packages|crates|src)\//, "$1/")}${lineNumber ? `#L${lineNumber}` : ""}`})**`;
+function generateSourceHref(filePath, githubUrl, lineNumber, endLineNumber) {
+	return `${githubUrl}/blob/main/${filePath.replace(/^.*?\/(npm|packages|crates|src)\//, "$1/")}${lineNumber ? endLineNumber && endLineNumber > lineNumber ? `#L${lineNumber}-L${endLineNumber}` : `#L${lineNumber}` : ""}`;
+}
+function generateSourceLink(filePath, githubUrl, lineNumber, endLineNumber) {
+	return `**[Source](${generateSourceHref(filePath, githubUrl, lineNumber, endLineNumber)})**`;
 }
 function resolveDocsOptions(options) {
 	if (options === false) return false;
@@ -7997,7 +8106,6 @@ function resolveDocsOptions(options) {
 		generateNav: opts.generateNav ?? true
 	};
 }
-
 //#endregion
 //#region src/og-image/renderer.ts
 /**
@@ -8042,10 +8150,10 @@ async function renderHtmlToPng(page, html, width, height, publicDir) {
 				await route.continue();
 				return;
 			}
-			const filePath = path.join(publicDir, url.pathname);
+			const filePath = path$1.join(publicDir, url.pathname);
 			try {
 				const body = await fs.readFile(filePath);
-				const ext = path.extname(filePath).toLowerCase();
+				const ext = path$1.extname(filePath).toLowerCase();
 				await route.fulfill({
 					body,
 					contentType: {
@@ -8080,7 +8188,6 @@ async function renderHtmlToPng(page, html, width, height, publicDir) {
 	});
 	return Buffer.from(screenshot);
 }
-
 //#endregion
 //#region src/og-image/browser.ts
 /**
@@ -8126,7 +8233,6 @@ async function openBrowser() {
 		return null;
 	}
 }
-
 //#endregion
 //#region src/og-image/template.ts
 /**
@@ -8135,28 +8241,78 @@ async function openBrowser() {
 function escapeHtml$2(str) {
 	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
+function normalizeBrandValue(str) {
+	return str.replace(/\s+/g, "").toLowerCase();
+}
+function renderWordmarkSvg() {
+	return `<svg width="430" height="102" viewBox="0 0 270 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="ogWordmarkGradient" x1="286" y1="10" x2="320" y2="54" gradientUnits="userSpaceOnUse">
+      <stop offset="0%" stop-color="#355cff"/>
+      <stop offset="100%" stop-color="#74c7ff"/>
+    </linearGradient>
+  </defs>
+  <text
+    x="2"
+    y="43"
+    fill="#eff6ff"
+    font-family="IBM Plex Sans, IBM Plex Mono, Avenir Next, Segoe UI, sans-serif"
+    font-size="34"
+    font-weight="700"
+    letter-spacing="-1.4"
+  >
+    OXCONTENT
+  </text>
+  <text
+    x="213"
+    y="43.5"
+    fill="#eff6ff"
+    font-family="IBM Plex Sans, IBM Plex Mono, Avenir Next, Segoe UI, sans-serif"
+    font-size="40"
+    font-weight="400"
+  >
+    (
+  </text>
+  <g transform="translate(216 9) scale(0.089) rotate(-7 256 256)">
+    <path
+      d="M161 96H286C298 96 309 101 318 110L352 144C361 153 366 164 366 176V386C366 399 355 410 342 410H161C148 410 138 399 138 386V120C138 107 148 96 161 96Z"
+      fill="url(#ogWordmarkGradient)"
+    />
+  </g>
+  <text
+    x="252"
+    y="43.5"
+    fill="#eff6ff"
+    font-family="IBM Plex Sans, IBM Plex Mono, Avenir Next, Segoe UI, sans-serif"
+    font-size="40"
+    font-weight="400"
+  >
+    )
+  </text>
+</svg>`;
+}
 /**
 * Returns the built-in default template function.
 */
 function getDefaultTemplate() {
 	return function defaultTemplate(props) {
-		const { title, description, siteName, tags } = props;
-		const tagsHtml = tags?.length ? `<div style="display:flex;gap:8px;flex-wrap:wrap;margin-top:auto;">
-          ${tags.map((tag) => `<span style="background:rgba(255,255,255,0.15);color:#e2e8f0;padding:4px 12px;border-radius:16px;font-size:14px;">${escapeHtml$2(tag)}</span>`).join("")}
-        </div>` : "";
-		return `<div style="width:100%;height:100%;display:flex;flex-direction:column;justify-content:center;padding:60px 80px;background:linear-gradient(135deg,#1a1a2e 0%,#16213e 50%,#0f3460 100%);font-family:system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
-  <div style="display:flex;flex-direction:column;gap:16px;flex:1;justify-content:center;">
-    <h1 style="font-size:56px;font-weight:700;color:#ffffff;line-height:1.2;margin:0;overflow:hidden;display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;">${escapeHtml$2(title)}</h1>
-    ${description ? `<p style="font-size:24px;color:#94a3b8;line-height:1.5;margin:0;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;">${escapeHtml$2(description)}</p>` : ""}
-  </div>
-  <div style="display:flex;align-items:flex-end;justify-content:space-between;margin-top:auto;">
-    ${siteName ? `<span style="font-size:20px;color:#64748b;font-weight:500;">${escapeHtml$2(siteName)}</span>` : ""}
-    ${tagsHtml}
+		const { title, description, siteName } = props;
+		const rawBrand = siteName?.trim() ? siteName : "Ox Content";
+		const isBrandCard = normalizeBrandValue(title) === normalizeBrandValue(rawBrand);
+		const heroTitle = isBrandCard ? "cargo doc for JavaScript" : title;
+		const heroDescription = isBrandCard ? "Rust-powered docs and high-performance Markdown tooling." : description && description.trim().length > 0 ? description : "Rust-powered docs and Markdown tooling.";
+		const descriptionHtml = heroDescription.trim().length > 0 ? `<p style="max-width:760px;font-size:28px;color:#93a4c3;line-height:1.45;margin:0;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;">${escapeHtml$2(heroDescription)}</p>` : "";
+		return `<div style="width:100%;height:100%;position:relative;overflow:hidden;box-sizing:border-box;padding:56px 64px 52px;background:#0b1220;font-family:'IBM Plex Sans','Avenir Next','Segoe UI',system-ui,sans-serif;color:#eff6ff;border:1px solid #223252;border-top:4px solid #4f6fae;">
+  <div style="position:relative;z-index:1;display:flex;flex-direction:column;height:100%;">
+    <div style="display:flex;align-items:flex-start;">${renderWordmarkSvg()}</div>
+    <div style="display:flex;flex-direction:column;justify-content:center;gap:24px;max-width:860px;flex:1;padding:22px 0 0;">
+      <h1 style="font-size:78px;font-weight:700;color:#eff6ff;line-height:1.02;letter-spacing:-0.055em;margin:0;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;">${escapeHtml$2(heroTitle)}</h1>
+      ${descriptionHtml}
+    </div>
   </div>
 </div>`;
 	};
 }
-
 //#endregion
 //#region src/og-image/cache.ts
 /**
@@ -8182,7 +8338,7 @@ function computeCacheKey(templateSource, props, width, height) {
 * Returns the cached file path if found, null otherwise.
 */
 async function getCached(cacheDir, key) {
-	const filePath = path.join(cacheDir, `${key}.png`);
+	const filePath = path$1.join(cacheDir, `${key}.png`);
 	try {
 		return await fs.readFile(filePath);
 	} catch {
@@ -8194,12 +8350,11 @@ async function getCached(cacheDir, key) {
 */
 async function writeCache(cacheDir, key, png) {
 	await fs.mkdir(cacheDir, { recursive: true });
-	const filePath = path.join(cacheDir, `${key}.png`);
+	const filePath = path$1.join(cacheDir, `${key}.png`);
 	await fs.writeFile(filePath, png);
 }
-
 //#endregion
-//#region \0@oxc-project+runtime@0.110.0/helpers/usingCtx.js
+//#region \0@oxc-project+runtime@0.115.0/helpers/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -8254,7 +8409,6 @@ function _usingCtx() {
 		}
 	};
 }
-
 //#endregion
 //#region src/og-image/index.ts
 /**
@@ -8287,14 +8441,14 @@ function resolveOgImageOptions(options) {
 */
 async function resolveTemplate(options, root) {
 	if (!options.template) return getDefaultTemplate();
-	const templatePath = path.resolve(root, options.template);
+	const templatePath = path$1.resolve(root, options.template);
 	const fs = await import("fs/promises");
 	try {
 		await fs.access(templatePath);
 	} catch {
 		throw new Error(`[ox-content:og-image] Template file not found: ${templatePath}`);
 	}
-	switch (path.extname(templatePath).toLowerCase()) {
+	switch (path$1.extname(templatePath).toLowerCase()) {
 		case ".vue": return resolveVueTemplate(templatePath, options, root);
 		case ".svelte": return resolveSvelteTemplate(templatePath, root);
 		case ".tsx":
@@ -8308,9 +8462,9 @@ async function resolveTemplate(options, root) {
 async function resolveTsTemplate(templatePath, options, root) {
 	const fs = await import("fs/promises");
 	const { rolldown } = await import("rolldown");
-	const cacheDir = path.join(root, ".cache", "og-images");
+	const cacheDir = path$1.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
-	const outfile = path.join(cacheDir, "_template.mjs");
+	const outfile = path$1.join(cacheDir, "_template.mjs");
 	const bundle = await rolldown({
 		input: templatePath,
 		platform: "node"
@@ -8333,9 +8487,9 @@ async function resolveTsTemplate(templatePath, options, root) {
 async function resolveVueTemplate(templatePath, options, root) {
 	const fs = await import("fs/promises");
 	const { rolldown } = await import("rolldown");
-	const cacheDir = path.join(root, ".cache", "og-images");
+	const cacheDir = path$1.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
-	const outfile = path.join(cacheDir, "_template_vue.mjs");
+	const outfile = path$1.join(cacheDir, "_template_vue.mjs");
 	const bundle = await rolldown({
 		input: templatePath,
 		platform: "node",
@@ -8431,9 +8585,9 @@ async function getVizejsPlugin() {
 async function resolveSvelteTemplate(templatePath, root) {
 	const fs = await import("fs/promises");
 	const { rolldown } = await import("rolldown");
-	const cacheDir = path.join(root, ".cache", "og-images");
+	const cacheDir = path$1.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
-	const outfile = path.join(cacheDir, "_template_svelte.mjs");
+	const outfile = path$1.join(cacheDir, "_template_svelte.mjs");
 	const bundle = await rolldown({
 		input: templatePath,
 		platform: "node",
@@ -8489,9 +8643,9 @@ function createSvelteCompilerPlugin() {
 async function resolveReactTemplate(templatePath, root) {
 	const fs = await import("fs/promises");
 	const { rolldown } = await import("rolldown");
-	const cacheDir = path.join(root, ".cache", "og-images");
+	const cacheDir = path$1.join(root, ".cache", "og-images");
 	await fs.mkdir(cacheDir, { recursive: true });
-	const outfile = path.join(cacheDir, "_template_react.mjs");
+	const outfile = path$1.join(cacheDir, "_template_react.mjs");
 	const bundle = await rolldown({
 		input: templatePath,
 		platform: "node",
@@ -8541,7 +8695,7 @@ async function resolveReactTemplate(templatePath, root) {
 async function computeTemplateSource(options, root) {
 	if (!options.template) return "__default__";
 	const fs = await import("fs/promises");
-	const templatePath = path.resolve(root, options.template);
+	const templatePath = path$1.resolve(root, options.template);
 	const content = await fs.readFile(templatePath, "utf-8");
 	return crypto.createHash("sha256").update(content).digest("hex");
 }
@@ -8559,7 +8713,7 @@ async function generateOgImages(pages, options, root) {
 		if (pages.length === 0) return [];
 		const templateFn = await resolveTemplate(options, root);
 		const templateSource = await computeTemplateSource(options, root);
-		const cacheDir = path.join(root, ".cache", "og-images");
+		const cacheDir = path$1.join(root, ".cache", "og-images");
 		if (options.cache) {
 			const allCached = await tryServeAllFromCache(pages, templateSource, options, cacheDir);
 			if (allCached) return allCached;
@@ -8571,7 +8725,7 @@ async function generateOgImages(pages, options, root) {
 			error: "Chromium not available"
 		}));
 		const results = [];
-		const publicDir = path.join(root, "public");
+		const publicDir = path$1.join(root, "public");
 		const concurrency = Math.max(1, options.concurrency);
 		for (let i = 0; i < pages.length; i += concurrency) {
 			const batch = pages.slice(i, i + concurrency);
@@ -8595,7 +8749,7 @@ async function tryServeAllFromCache(pages, templateSource, options, cacheDir) {
 	for (const entry of pages) {
 		const cached = await getCached(cacheDir, computeCacheKey(templateSource, entry.props, options.width, options.height));
 		if (!cached) return null;
-		await fs.mkdir(path.dirname(entry.outputPath), { recursive: true });
+		await fs.mkdir(path$1.dirname(entry.outputPath), { recursive: true });
 		await fs.writeFile(entry.outputPath, cached);
 		results.push({
 			outputPath: entry.outputPath,
@@ -8613,7 +8767,7 @@ async function renderSinglePage(entry, templateFn, templateSource, options, cach
 		if (options.cache) {
 			const cached = await getCached(cacheDir, computeCacheKey(templateSource, entry.props, options.width, options.height));
 			if (cached) {
-				await fs.mkdir(path.dirname(entry.outputPath), { recursive: true });
+				await fs.mkdir(path$1.dirname(entry.outputPath), { recursive: true });
 				await fs.writeFile(entry.outputPath, cached);
 				return {
 					outputPath: entry.outputPath,
@@ -8623,7 +8777,7 @@ async function renderSinglePage(entry, templateFn, templateSource, options, cach
 		}
 		const html = await templateFn(entry.props);
 		const png = await session.renderPage(html, options.width, options.height, publicDir);
-		await fs.mkdir(path.dirname(entry.outputPath), { recursive: true });
+		await fs.mkdir(path$1.dirname(entry.outputPath), { recursive: true });
 		await fs.writeFile(entry.outputPath, png);
 		if (options.cache) await writeCache(cacheDir, computeCacheKey(templateSource, entry.props, options.width, options.height), png);
 		return {
@@ -8638,7 +8792,6 @@ async function renderSinglePage(entry, templateFn, templateSource, options, cach
 		};
 	}
 }
-
 //#endregion
 //#region src/plugins/index.ts
 /**
@@ -8648,28 +8801,27 @@ async function transformAllPlugins(html, options = {}) {
 	const { tabs = true, youtube = true, github = true, ogp = true, mermaid = true, githubToken } = options;
 	let result = html;
 	if (tabs) {
-		const { transformTabs } = await import("./tabs.js");
+		const { transformTabs } = await import("./tabs.mjs");
 		result = await transformTabs(result);
 	}
 	if (youtube) {
-		const { transformYouTube } = await import("./youtube.js");
+		const { transformYouTube } = await import("./youtube.mjs");
 		result = await transformYouTube(result);
 	}
 	if (github) {
-		const { transformGitHub } = await import("./github.js");
+		const { transformGitHub } = await import("./github.mjs");
 		result = await transformGitHub(result, void 0, { token: githubToken });
 	}
 	if (ogp) {
-		const { transformOgp } = await import("./ogp.js");
+		const { transformOgp } = await import("./ogp.mjs");
 		result = await transformOgp(result);
 	}
 	if (mermaid) {
-		const { transformMermaidStatic } = await import("./mermaid.js");
+		const { transformMermaidStatic } = await import("./mermaid2.mjs");
 		result = await transformMermaidStatic(result);
 	}
 	return result;
 }
-
 //#endregion
 //#region src/island/parse.ts
 /**
@@ -8861,7 +9013,6 @@ initIslands((el, props) => {
 });
 `;
 }
-
 //#endregion
 //#region src/theme.ts
 /**
@@ -8871,31 +9022,32 @@ initIslands((el, props) => {
 const defaultTheme = {
 	name: "default",
 	colors: {
-		primary: "#e04d0a",
-		primaryHover: "#f5602a",
+		primary: "#4f6fae",
+		primaryHover: "#425f96",
 		background: "#ffffff",
-		backgroundAlt: "#f8f9fa",
-		text: "#1a1a1a",
-		textMuted: "#666666",
-		border: "#e5e7eb",
-		codeBackground: "#1e293b",
-		codeText: "#e2e8f0"
+		backgroundAlt: "#f5f7fb",
+		text: "#131a30",
+		textMuted: "#4f607b",
+		border: "#d2dbea",
+		codeBackground: "#101a31",
+		codeText: "#edf3ff"
 	},
 	darkColors: {
-		primary: "#f5714a",
-		primaryHover: "#ff8a66",
-		background: "#141414",
-		backgroundAlt: "#141414",
-		text: "#e5e5e5",
-		textMuted: "#a3a3a3",
-		border: "#2a2a2a",
-		codeBackground: "#1a1a1a",
-		codeText: "#e5e5e5"
+		primary: "#86a4da",
+		primaryHover: "#a3bbe8",
+		background: "#060816",
+		backgroundAlt: "#0d1528",
+		text: "#ebf2ff",
+		textMuted: "#8ea0bf",
+		border: "#223252",
+		codeBackground: "#0a1020",
+		codeText: "#e7f0ff"
 	},
 	fonts: {
-		sans: "system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif",
-		mono: "ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace"
+		sans: "\"IBM Plex Sans\", \"Avenir Next\", \"Segoe UI Variable\", \"Segoe UI\", sans-serif",
+		mono: "\"IBM Plex Mono\", \"SFMono-Regular\", Consolas, monospace"
 	},
+	entryPage: { mode: "default" },
 	layout: {
 		sidebarWidth: "260px",
 		headerHeight: "60px",
@@ -8903,6 +9055,9 @@ const defaultTheme = {
 	},
 	header: {
 		logo: void 0,
+		logoLight: void 0,
+		logoDark: void 0,
+		showSiteNameText: true,
 		logoWidth: 28,
 		logoHeight: 28
 	},
@@ -8980,6 +9135,7 @@ function resolveTheme(config) {
 		colors: merged.colors ?? defaultTheme.colors,
 		darkColors: merged.darkColors ?? defaultTheme.darkColors,
 		fonts: merged.fonts ?? defaultTheme.fonts,
+		entryPage: merged.entryPage ?? defaultTheme.entryPage,
 		layout: merged.layout ?? defaultTheme.layout,
 		header: merged.header ?? defaultTheme.header,
 		footer: merged.footer ?? defaultTheme.footer,
@@ -9020,13 +9176,17 @@ function themeToNapi(theme) {
 			sans: theme.fonts.sans,
 			mono: theme.fonts.mono
 		} : void 0,
+		entryPage: theme.entryPage.mode ? { mode: theme.entryPage.mode } : void 0,
 		layout: theme.layout.sidebarWidth ? {
 			sidebarWidth: theme.layout.sidebarWidth,
 			headerHeight: theme.layout.headerHeight,
 			maxContentWidth: theme.layout.maxContentWidth
 		} : void 0,
-		header: theme.header.logo ? {
+		header: theme.header.logo || theme.header.logoLight || theme.header.logoDark ? {
 			logo: theme.header.logo,
+			logoLight: theme.header.logoLight,
+			logoDark: theme.header.logoDark,
+			showSiteNameText: theme.header.showSiteNameText,
 			logoWidth: theme.header.logoWidth,
 			logoHeight: theme.header.logoHeight
 		} : void 0,
@@ -9044,7 +9204,6 @@ function themeToNapi(theme) {
 		js: theme.js || void 0
 	};
 }
-
 //#endregion
 //#region src/ssg.ts
 /**
@@ -9076,40 +9235,65 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       --sidebar-width: 260px;
       --header-height: 60px;
       --max-content-width: 960px;
-      --font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      --font-mono: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
+      --font-sans: 'IBM Plex Sans', 'Avenir Next', 'Segoe UI Variable', 'Segoe UI', sans-serif;
+      --font-mono: 'IBM Plex Mono', 'SFMono-Regular', Consolas, monospace;
       --color-bg: #ffffff;
-      --color-bg-alt: #f8f9fa;
-      --color-text: #1a1a1a;
-      --color-text-muted: #666666;
-      --color-border: #e5e7eb;
-      --color-primary: #b7410e;
-      --color-primary-hover: #ce5937;
-      --color-code-bg: #1e293b;
-      --color-code-text: #e2e8f0;
+      --color-bg-alt: #f5f7fb;
+      --color-text: #131a30;
+      --color-text-muted: #4f607b;
+      --color-border: #d2dbea;
+      --color-primary: #4f6fae;
+      --color-primary-hover: #425f96;
+      --color-code-bg: #101a31;
+      --color-code-bg-top: #18264a;
+      --color-code-text: #edf3ff;
+      --color-code-line-highlight: rgba(56, 189, 248, 0.16);
+      --color-code-line-warning: rgba(245, 158, 11, 0.18);
+      --color-code-line-warning-border: #f59e0b;
+      --color-code-line-error: rgba(239, 68, 68, 0.18);
+      --color-code-line-error-border: #ef4444;
+      --color-code-frame-border: rgba(147, 166, 200, 0.46);
+      --surface-noise-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.2' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.062'/%3E%3C/svg%3E");
+      --surface-noise-size: 164px 164px;
     }
     [data-theme="dark"] {
-      --color-bg: #141414;
-      --color-bg-alt: #141414;
-      --color-text: #e5e5e5;
-      --color-text-muted: #a3a3a3;
-      --color-border: #2a2a2a;
-      --color-primary: #c9714a;
-      --color-primary-hover: #d4845f;
-      --color-code-bg: #1a1a1a;
-      --color-code-text: #e5e5e5;
+      --color-bg: #060816;
+      --color-bg-alt: #0d1528;
+      --color-text: #ebf2ff;
+      --color-text-muted: #8ea0bf;
+      --color-border: #223252;
+      --color-primary: #86a4da;
+      --color-primary-hover: #a3bbe8;
+      --color-code-bg: #0a1020;
+      --color-code-bg-top: #0a1020;
+      --color-code-text: #e7f0ff;
+      --color-code-line-highlight: rgba(14, 165, 233, 0.2);
+      --color-code-line-warning: rgba(245, 158, 11, 0.2);
+      --color-code-line-warning-border: #f59e0b;
+      --color-code-line-error: rgba(239, 68, 68, 0.22);
+      --color-code-line-error-border: #f87171;
+      --color-code-frame-border: rgba(34, 50, 82, 0.92);
+      --surface-noise-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.25' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.098'/%3E%3C/svg%3E");
     }
     @media (prefers-color-scheme: dark) {
       :root:not([data-theme="light"]) {
-        --color-bg: #141414;
-        --color-bg-alt: #141414;
-        --color-text: #e5e5e5;
-        --color-text-muted: #a3a3a3;
-        --color-border: #2a2a2a;
-        --color-primary: #c9714a;
-        --color-primary-hover: #d4845f;
-        --color-code-bg: #1a1a1a;
-        --color-code-text: #e5e5e5;
+        --color-bg: #060816;
+        --color-bg-alt: #0d1528;
+        --color-text: #ebf2ff;
+        --color-text-muted: #8ea0bf;
+        --color-border: #223252;
+        --color-primary: #86a4da;
+        --color-primary-hover: #a3bbe8;
+        --color-code-bg: #0a1020;
+        --color-code-bg-top: #0a1020;
+        --color-code-text: #e7f0ff;
+        --color-code-line-highlight: rgba(14, 165, 233, 0.2);
+        --color-code-line-warning: rgba(245, 158, 11, 0.2);
+        --color-code-line-warning-border: #f59e0b;
+        --color-code-line-error: rgba(239, 68, 68, 0.22);
+        --color-code-line-error-border: #f87171;
+        --color-code-frame-border: rgba(34, 50, 82, 0.92);
+        --surface-noise-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 180 180'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='1.25' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='180' height='180' filter='url(%23noise)' opacity='0.098'/%3E%3C/svg%3E");
       }
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -9119,6 +9303,10 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       line-height: 1.7;
       color: var(--color-text);
       background: var(--color-bg);
+      background-image: var(--surface-noise-image);
+      background-size: var(--surface-noise-size);
+      background-repeat: repeat;
+      background-blend-mode: soft-light;
     }
     a { color: var(--color-primary); text-decoration: none; }
     a:hover { color: var(--color-primary-hover); text-decoration: underline; }
@@ -9137,6 +9325,18 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       padding: 0 1.5rem;
       z-index: 100;
     }
+    .header,
+    .sidebar,
+    .search-modal,
+    .mobile-footer,
+    .content .ox-api-entry,
+    .content .ox-api-module,
+    .content blockquote.ox-callout {
+      background-image: var(--surface-noise-image);
+      background-size: var(--surface-noise-size);
+      background-repeat: repeat;
+      background-blend-mode: soft-light;
+    }
     .header-title {
       font-size: 1.25rem;
       font-weight: 600;
@@ -9161,7 +9361,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       padding: 0.5rem 0.75rem;
       background: var(--color-bg-alt);
       border: 1px solid var(--color-border);
-      border-radius: 6px;
+      border-radius: 4px;
       color: var(--color-text-muted);
       cursor: pointer;
       font-size: 0.875rem;
@@ -9187,7 +9387,6 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       inset: 0;
       z-index: 200;
       background: rgba(0,0,0,0.6);
-      backdrop-filter: blur(4px);
       justify-content: center;
       padding-top: 10vh;
     }
@@ -9198,9 +9397,8 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       margin: 0 1rem;
       background: var(--color-bg);
       border: 1px solid var(--color-border);
-      border-radius: 12px;
+      border-radius: 4px;
       overflow: hidden;
-      box-shadow: 0 25px 50px -12px rgba(0,0,0,0.4);
       max-height: 70vh;
       display: flex;
       flex-direction: column;
@@ -9240,7 +9438,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
     .search-result {
       display: block;
       padding: 0.75rem 1rem;
-      border-radius: 8px;
+      border-radius: 4px;
       color: var(--color-text);
       text-decoration: none;
     }
@@ -9271,7 +9469,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       border: none;
       cursor: pointer;
       padding: 0.5rem;
-      border-radius: 6px;
+      border-radius: 4px;
       color: var(--color-text-muted);
       transition: background 0.15s, color 0.15s;
     }
@@ -9300,38 +9498,50 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       left: 0;
       bottom: 0;
       width: var(--sidebar-width);
-      background: var(--color-bg-alt);
-      border-right: 1px solid var(--color-border);
+      background: color-mix(in srgb, var(--color-bg-alt) 16%, var(--color-bg));
+      border-right: 1px solid color-mix(in srgb, var(--color-border) 48%, transparent);
       overflow-y: auto;
-      padding: 1.5rem 1rem;
+      padding: 1rem 0.875rem 1.5rem;
+    }
+    .sidebar--entry { display: none; }
+    .sidebar nav {
+      display: flex;
+      flex-direction: column;
+      gap: 1rem;
     }
-    .nav-section { margin-bottom: 1.5rem; }
+    .nav-section { margin-bottom: 0; }
     .nav-title {
-      font-size: 0.75rem;
+      font-size: 0.6875rem;
       font-weight: 600;
       text-transform: uppercase;
-      letter-spacing: 0.05em;
+      letter-spacing: 0.08em;
       color: var(--color-text-muted);
-      margin-bottom: 0.5rem;
-      padding: 0 0.75rem;
+      margin-bottom: 0.4rem;
+      padding: 0 0.625rem;
+    }
+    .nav-list {
+      list-style: none;
+      display: flex;
+      flex-direction: column;
+      gap: 0.125rem;
     }
-    .nav-list { list-style: none; }
-    .nav-item { margin: 0.125rem 0; }
+    .nav-item { margin: 0; }
     .nav-link {
       display: block;
-      padding: 0.5rem 0.75rem;
-      border-radius: 6px;
-      color: var(--color-text);
+      padding: 0.45rem 0.625rem;
+      border-radius: 0;
+      color: color-mix(in srgb, var(--color-text) 92%, var(--color-text-muted));
       font-size: 0.875rem;
-      transition: background 0.15s;
     }
     .nav-link:hover {
-      background: var(--color-border);
+      background: color-mix(in srgb, var(--color-bg-alt) 58%, transparent);
+      color: var(--color-text);
       text-decoration: none;
     }
     .nav-link.active {
-      background: var(--color-primary);
-      color: white;
+      background: color-mix(in srgb, var(--color-bg-alt) 72%, transparent);
+      color: var(--color-text);
+      font-weight: 600;
     }
 
     /* Main content */
@@ -9386,8 +9596,31 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       padding: 0.5rem 1rem;
       margin: 1rem 0;
       background: var(--color-bg-alt);
-      border-radius: 0 6px 6px 0;
+      border-radius: 0 4px 4px 0;
+    }
+    .content blockquote.ox-callout {
+      --callout-accent: var(--color-primary);
+      border-left-width: 3px;
+      border-left-color: var(--callout-accent);
+      padding: 0.9rem 1rem;
+      border-radius: 4px;
+      background: color-mix(in srgb, var(--color-bg-alt) 92%, var(--callout-accent) 8%);
+    }
+    .content blockquote.ox-callout.ox-callout--note,
+    .content blockquote.ox-callout.ox-callout--important { --callout-accent: var(--color-primary); }
+    .content blockquote.ox-callout.ox-callout--tip { --callout-accent: #0891b2; }
+    .content blockquote.ox-callout.ox-callout--warning { --callout-accent: #d97706; }
+    .content blockquote.ox-callout.ox-callout--caution { --callout-accent: #dc2626; }
+    .content .ox-callout-title {
+      margin: 0 0 0.5rem;
+      font-size: 0.75rem;
+      font-weight: 700;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+      color: var(--callout-accent, var(--color-primary));
     }
+    .content blockquote.ox-callout > :last-child { margin-bottom: 0; }
+    .content blockquote.ox-callout > :not(.ox-callout-title):first-of-type { margin-top: 0; }
     .content code {
       font-family: var(--font-mono);
       font-size: 0.875em;
@@ -9397,18 +9630,45 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       word-break: break-all;
     }
     .content pre {
-      background: var(--color-code-bg);
+      background: linear-gradient(
+        180deg,
+        var(--color-code-bg-top) 0,
+        var(--color-code-bg) 3.5rem
+      ) !important;
       color: var(--color-code-text);
       padding: 1rem 1.25rem;
-      border-radius: 8px;
+      border-radius: 4px;
+      border: 1px solid var(--color-code-frame-border);
       overflow-x: auto;
       margin: 1.5rem 0;
       line-height: 1.5;
     }
     .content pre code {
       background: transparent;
+      border: 0;
       padding: 0;
+      border-radius: 0;
       font-size: 0.8125rem;
+      word-break: normal;
+    }
+    .content pre.ox-code-block code {
+      display: block;
+    }
+    .content pre.ox-code-block .line {
+      display: block;
+      margin: 0 -1.25rem;
+      padding: 0 1.25rem;
+    }
+    .content pre.ox-code-block .ox-code-line--highlight {
+      background: var(--color-code-line-highlight);
+    }
+    .content pre.ox-code-block .ox-code-line--warning {
+      background: var(--color-code-line-warning);
+      border-left: 3px solid var(--color-code-line-warning-border);
+    }
+    .content pre.ox-code-block .ox-code-line--error {
+      background: var(--color-code-line-error);
+      border-left: 3px solid var(--color-code-line-error-border);
     }
     .content table {
       width: 100%;
@@ -9422,21 +9682,355 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       text-align: left;
     }
     .content th { background: var(--color-bg-alt); font-weight: 600; }
-    .content img { max-width: 100%; height: auto; border-radius: 8px; display: block; }
+    .content img { max-width: 100%; height: auto; border-radius: 4px; display: block; }
     .content img[alt*="Logo"] { max-width: 200px; display: block; margin: 1rem 0; }
     .content img[alt*="Architecture"] { max-width: 600px; }
     .content img[alt*="Benchmark"] { max-width: 680px; }
     .content hr { border: none; border-top: 1px solid var(--color-border); margin: 2rem 0; }
+    .content .ox-api-controls {
+      display: flex;
+      justify-content: flex-end;
+      align-items: center;
+      gap: 0.5rem;
+      margin: 0 0 1rem;
+    }
+    .content .ox-api-controls__button {
+      appearance: none;
+      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);
+      background: color-mix(in srgb, var(--color-bg-alt) 82%, var(--color-bg));
+      padding: 0.4rem 0.7rem;
+      border-radius: 4px;
+      color: color-mix(in srgb, var(--color-text) 82%, var(--color-text-muted));
+      font-family: var(--font-mono);
+      font-size: 0.78rem;
+      font-weight: 600;
+      line-height: 1.4;
+      cursor: pointer;
+    }
+    .content .ox-api-controls__button:hover {
+      color: var(--color-primary);
+      border-color: color-mix(in srgb, var(--color-primary) 38%, var(--color-border));
+      background: color-mix(in srgb, var(--color-bg-alt) 68%, var(--color-primary) 6%);
+    }
+    .content .ox-api-entry,
+    .content .ox-api-module {
+      margin: 0;
+      border: 0;
+      border-top: 1px solid color-mix(in srgb, var(--color-border) 74%, transparent);
+      border-radius: 0;
+      background: transparent;
+      overflow: visible;
+    }
+    .content .ox-api-entry:last-child,
+    .content .ox-api-module:last-child {
+      border-bottom: 1px solid color-mix(in srgb, var(--color-border) 74%, transparent);
+    }
+    .content .ox-api-entry summary,
+    .content .ox-api-module summary {
+      list-style: none;
+      cursor: pointer;
+      padding: 1rem 0;
+      position: relative;
+    }
+    .content .ox-api-entry summary::-webkit-details-marker,
+    .content .ox-api-module summary::-webkit-details-marker { display: none; }
+    .content .ox-api-entry summary {
+      display: grid;
+      grid-template-columns: var(--octc-api-kind-width, 6.5rem) minmax(0, 1fr) auto;
+      align-items: start;
+      gap: 0.95rem;
+    }
+    .content .ox-api-entry summary::after,
+    .content .ox-api-module summary::after {
+      content: "+";
+      align-self: center;
+      color: var(--color-text-muted);
+      font-family: var(--font-mono);
+      font-size: 0.95rem;
+      font-weight: 600;
+      line-height: 1;
+    }
+    .content .ox-api-entry[open] summary::after,
+    .content .ox-api-module[open] summary::after {
+      content: "−";
+      color: var(--color-primary);
+    }
+    .content .ox-api-entry[open] summary,
+    .content .ox-api-module[open] summary {
+      border-bottom: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);
+    }
+    .content .ox-api-entry__kind,
+    .content .ox-api-module__kind {
+      display: block;
+      width: var(--octc-api-kind-width, 6.5rem);
+      padding: 0.3rem 0 0;
+      background: transparent;
+      border: 0;
+      font-family: var(--font-mono);
+      font-size: 0.76rem;
+      font-weight: 600;
+      letter-spacing: 0.01em;
+      text-align: left;
+      white-space: nowrap;
+      color: var(--color-text-muted);
+    }
+    .content .ox-api-module__count {
+      display: inline-flex;
+      align-items: center;
+      padding: 0.2rem 0.48rem;
+      border-radius: 4px;
+      background: color-mix(in srgb, var(--color-bg-alt) 84%, var(--color-primary) 8%);
+      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);
+      color: var(--color-text-muted);
+      font-family: var(--font-mono);
+      font-size: 0.72rem;
+      font-weight: 600;
+      letter-spacing: 0.03em;
+      white-space: nowrap;
+    }
+    .content .ox-api-entry__name {
+      display: block;
+      font-family: var(--font-mono);
+      font-size: 0.95rem;
+      font-weight: 600;
+      line-height: 1.55;
+    }
+    .content .ox-api-entry__signature,
+    .content .ox-api-module__signature {
+      display: block;
+      width: 100%;
+      min-width: 0;
+      font-family: var(--font-mono);
+      font-size: 0.95rem;
+      line-height: 1.55;
+      white-space: nowrap;
+      overflow-x: auto;
+      overflow-y: hidden;
+      -webkit-overflow-scrolling: touch;
+    }
+    .content .ox-api-entry__description {
+      display: block;
+      color: color-mix(in srgb, var(--color-text) 78%, var(--color-text-muted));
+      font-size: 0.9rem;
+      line-height: 1.6;
+      max-width: 72ch;
+    }
+    .content .ox-api-entry__summary-main {
+      min-width: 0;
+      display: flex;
+      flex-direction: column;
+      gap: 0.55rem;
+    }
+    .content .ox-api-entry__name,
+    .content .ox-api-entry__signature,
+    .content .ox-api-module__name,
+    .content .ox-api-module__signature {
+      background: transparent;
+      padding: 0;
+      border-radius: 0;
+      word-break: normal;
+    }
+    .content code.shiki-inline.ox-api-entry__signature--highlighted,
+    .content code.shiki-inline.ox-api-module__signature--highlighted {
+      display: block;
+      width: 100%;
+      max-width: 100%;
+      background: linear-gradient(
+        180deg,
+        var(--color-code-bg-top) 0,
+        var(--color-code-bg) 2.75rem
+      ) !important;
+      border: 1px solid var(--color-code-frame-border) !important;
+      padding: 0.55rem 0.7rem !important;
+      border-radius: 4px !important;
+      white-space: nowrap;
+      overflow-x: auto;
+      overflow-y: hidden;
+      -webkit-overflow-scrolling: touch;
+    }
+    .content code.shiki-inline.ox-api-entry__signature--highlighted .line,
+    .content code.shiki-inline.ox-api-module__signature--highlighted .line {
+      display: block;
+      width: max-content;
+      min-width: 100%;
+    }
+    .content .ox-api-entry__body,
+    .content .ox-api-module__body { padding: 0.7rem 0 1.9rem; }
+    .content .ox-api-entry__body {
+      margin-left: calc(var(--octc-api-kind-width, 6.5rem) + 0.95rem);
+      margin-top: 0.7rem;
+      padding: 1.45rem 1rem 2.1rem 1.1rem;
+      border: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);
+      border-radius: 4px;
+      background: color-mix(in srgb, var(--color-bg-alt) 68%, transparent);
+    }
+    .content .ox-api-entry__body > :first-child { margin-top: 0; }
+    .content .ox-api-entry__body > :last-child { margin-bottom: 0; }
+    .content .ox-api-entry[open] summary {
+      padding-bottom: 0.35rem;
+    }
+    .content .ox-api-entry__section {
+      display: grid;
+      grid-template-columns: 6.5rem minmax(0, 1fr);
+      gap: 0.2rem 1.25rem;
+      align-items: start;
+      margin-top: 1rem;
+      padding-top: 1rem;
+      border-top: 1px solid color-mix(in srgb, var(--color-border) 72%, transparent);
+    }
+    .content .ox-api-entry__section h4 {
+      margin-top: 0;
+      margin-bottom: 0;
+      padding-top: 0.25rem;
+      font-family: var(--font-mono);
+      font-size: 0.78rem;
+      font-weight: 700;
+      letter-spacing: 0.04em;
+      text-transform: uppercase;
+      color: var(--color-text-muted);
+    }
+    .content .ox-api-entry__section > :not(h4) { min-width: 0; }
+    .content .ox-api-entry__source {
+      margin: 0 0 0.15rem;
+      font-family: var(--font-mono);
+      font-size: 0.78rem;
+      color: var(--color-text-muted);
+    }
+    .content .ox-api-entry__source a {
+      color: inherit;
+      text-decoration-color: color-mix(in srgb, var(--color-text-muted) 38%, transparent);
+    }
+    .content .ox-api-entry__tags,
+    .content .ox-api-module__list {
+      list-style: none;
+      padding-left: 0;
+      margin: 0;
+    }
+    .content .ox-api-entry__tags {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 0.6rem;
+    }
+    .content .ox-api-entry__tags li {
+      display: inline-flex;
+      align-items: center;
+      gap: 0.45rem;
+      padding: 0.4rem 0.55rem;
+      border: 1px solid color-mix(in srgb, var(--color-border) 80%, transparent);
+      border-radius: 4px;
+      background: color-mix(in srgb, var(--color-bg-alt) 72%, transparent);
+    }
+    .content .ox-api-module__list li {
+      display: grid;
+      grid-template-columns: var(--octc-api-kind-width, 6.5rem) minmax(0, 1fr);
+      align-items: start;
+      gap: 1rem;
+      padding: 0.85rem 0;
+      border-top: 1px solid color-mix(in srgb, var(--color-border) 70%, transparent);
+    }
+    .content .ox-api-module__list li:first-child { border-top: none; }
+    .content .ox-api-entry__tag-name,
+    .content .ox-api-module__title { font-weight: 700; }
+    .content .ox-api-entry__tag-name {
+      color: var(--color-primary);
+      font-family: var(--font-mono);
+      font-size: 0.74rem;
+    }
+    .content .ox-api-entry__tag-value {
+      color: var(--color-text);
+      font-size: 0.84rem;
+      line-height: 1.45;
+    }
+    .content .ox-api-module summary {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto auto;
+      align-items: center;
+      gap: 0.9rem;
+    }
+    .content .ox-api-module__body { padding-top: 0.15rem; }
+    .content .ox-api-module__item { min-width: 0; }
+    .content .ox-api-module__link {
+      display: block;
+      text-decoration: none;
+    }
+    .content .ox-api-module__link:hover { text-decoration: none; }
+    .content .ox-api-module__name,
+    .content .ox-api-module__signature {
+      display: block;
+      font-family: var(--font-mono);
+      font-size: 0.91rem;
+      line-height: 1.55;
+      color: var(--color-text);
+    }
+    .content .ox-api-module__summary {
+      display: block;
+      margin-top: 0.45rem;
+      color: color-mix(in srgb, var(--color-text) 76%, var(--color-text-muted));
+      font-size: 0.88rem;
+      line-height: 1.55;
+    }
+    .content .ox-api-entry__section--examples pre {
+      margin: 0;
+      border: 1px solid var(--color-code-frame-border);
+      border-radius: 4px;
+    }
+    .content .ox-api-entry__params {
+      list-style: none;
+      padding: 0;
+      margin: 0;
+    }
+    .content .ox-api-entry__param {
+      padding: 0.8rem 0;
+      border-top: 1px solid color-mix(in srgb, var(--color-border) 70%, transparent);
+    }
+    .content .ox-api-entry__param:first-child {
+      padding-top: 0;
+      border-top: 0;
+    }
+    .content .ox-api-entry__param-heading {
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      gap: 0.5rem;
+    }
+    .content .ox-api-entry__param-name,
+    .content .ox-api-entry__return-type {
+      font-family: var(--font-mono);
+      font-size: 0.84rem;
+      font-weight: 600;
+      color: var(--color-text);
+      background: color-mix(in srgb, var(--color-bg-alt) 84%, transparent);
+      border: 1px solid color-mix(in srgb, var(--color-border) 82%, transparent);
+      padding: 0.28rem 0.42rem;
+      border-radius: 4px;
+    }
+    .content .ox-api-entry__param-type {
+      font-family: var(--font-mono);
+      font-size: 0.78rem;
+      color: var(--color-code-text);
+      background: color-mix(in srgb, var(--color-code-bg) 96%, #243556);
+      border: 1px solid color-mix(in srgb, var(--color-code-bg) 82%, var(--color-border));
+      padding: 0.26rem 0.42rem;
+      border-radius: 4px;
+    }
+    .content .ox-api-entry__param-description,
+    .content .ox-api-entry__return-description {
+      margin: 0.55rem 0 0;
+      font-size: 0.88rem;
+      line-height: 1.6;
+      color: color-mix(in srgb, var(--color-text) 78%, var(--color-text-muted));
+    }
+    .content .ox-api-entry__return { margin: 0; }
 
     /* Responsive */
     @media (max-width: 768px) {
       .menu-toggle { display: block; }
       .sidebar {
         transform: translateX(-100%);
-        transition: transform 0.3s ease;
         z-index: 99;
         width: 280px;
       }
+      .sidebar--entry { display: block; }
       .sidebar.open { transform: translateX(0); }
       .main { margin-left: 0; padding: 1rem 0.75rem; }
       .content { padding: 0 0.25rem; }
@@ -9453,16 +10047,48 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
         overflow-x: auto;
         -webkit-overflow-scrolling: touch;
       }
+      .content .ox-api-controls {
+        justify-content: flex-start;
+        gap: 0.75rem;
+      }
+      .content .ox-api-entry__body {
+        margin-left: 0;
+        margin-top: 0.55rem;
+        padding: 1.2rem 0 1.7rem;
+        border-left: 0;
+        border-right: 0;
+        border-bottom: 0;
+        border-radius: 0;
+        background: transparent;
+      }
+      .content .ox-api-entry__section {
+        grid-template-columns: 1fr;
+        gap: 0.5rem;
+      }
+      .content .ox-api-entry__tags li,
+      .content .ox-api-module__list li,
+      .content .ox-api-module summary {
+        grid-template-columns: 1fr;
+      }
+      .content .ox-api-entry__signature { width: 100%; }
+      .content pre.ox-code-block .line {
+        margin: 0 -0.75rem;
+        padding: 0 0.75rem;
+      }
       .content code { font-size: 0.8125em; }
       .content table {
         display: block;
+        width: max-content;
+        min-width: 100%;
+        max-width: calc(100vw - 1.5rem);
         overflow-x: auto;
         -webkit-overflow-scrolling: touch;
         font-size: 0.8125rem;
-        margin: 1rem -0.75rem;
-        width: calc(100% + 1.5rem);
+        margin: 1rem 0;
+        border-collapse: separate;
+        border-spacing: 0;
       }
-      .content th, .content td { padding: 0.5rem 0.75rem; white-space: nowrap; }
+      .content th, .content td { padding: 0.5rem 0.75rem; white-space: nowrap; vertical-align: top; }
       .content img { margin: 1rem 0; }
       .content img[alt*="Logo"] { max-width: 150px; }
       .content img[alt*="Architecture"] { max-width: 100%; }
@@ -9470,12 +10096,13 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       .content blockquote { padding: 0.5rem 0.75rem; margin: 1rem 0; font-size: 0.9375rem; }
       .header { padding: 0 1rem; }
       .header-title { font-size: 1rem; }
-      .header-title img { width: 24px; height: 24px; }
+      .header-title:not(.header-title--logo-only) img { width: 24px; height: 24px; }
+      .header-title--logo-only .header-logo { width: 152px; height: auto; }
       .overlay {
         display: none;
         position: fixed;
         inset: 0;
-        background: rgba(0,0,0,0.5);
+        background: transparent;
         z-index: 98;
       }
       .overlay.open { display: block; }
@@ -9486,7 +10113,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       .main { padding: 0.75rem 0.5rem; }
       .content h1 { font-size: 1.35rem; }
       .content pre { font-size: 0.6875rem; padding: 0.625rem; }
-      .content table { font-size: 0.75rem; }
+      .content table { max-width: calc(100vw - 1rem); font-size: 0.75rem; }
       .content th, .content td { padding: 0.375rem 0.5rem; }
     }
   </style>
@@ -9539,7 +10166,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
   </div>
   <div class="overlay"></div>
   <div class="layout">
-    <aside class="sidebar">
+    <aside class="sidebar{{#entryPage}} sidebar--entry{{/entryPage}}">
       <nav>
 {{navigation}}
       </nav>
@@ -9593,6 +10220,22 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       });
     }
 
+    document.querySelectorAll('.ox-api-controls').forEach((controls) => {
+      const targetSelector = controls.getAttribute('data-ox-api-target');
+      if (!targetSelector) return;
+
+      controls.querySelectorAll('[data-ox-api-toggle]').forEach((button) => {
+        button.addEventListener('click', () => {
+          const shouldOpen = button.getAttribute('data-ox-api-toggle') === 'expand';
+          document.querySelectorAll(targetSelector).forEach((entry) => {
+            if (entry instanceof HTMLDetailsElement) {
+              entry.open = shouldOpen;
+            }
+          });
+        });
+      });
+    });
+
     // Search functionality
     const searchButton = document.querySelector('.search-button');
     const searchOverlay = document.querySelector('.search-modal-overlay');
@@ -9626,6 +10269,39 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       }
     };
 
+    const parseScopedQuery = (query) => {
+      const scopes = [];
+      const terms = [];
+      for (const part of query.trim().split(/\\s+/).filter(Boolean)) {
+        if (part.startsWith('@') && part.length > 1) {
+          scopes.push(part.slice(1).toLowerCase());
+        } else {
+          terms.push(part);
+        }
+      }
+      return { text: terms.join(' ').trim(), scopes: [...new Set(scopes)] };
+    };
+
+    const getScopesForDoc = (doc) => {
+      const source = (doc.id || doc.url || '').replace(/^\\/+/, '').toLowerCase();
+      const segments = source.split('/').filter(Boolean);
+      if (segments.length <= 1) return [];
+
+      const scopes = [];
+      let current = '';
+      for (const segment of segments.slice(0, -1)) {
+        current = current ? current + '/' + segment : segment;
+        scopes.push(current);
+      }
+      return scopes;
+    };
+
+    const matchesScopes = (doc, scopes) => {
+      if (!scopes.length) return true;
+      const docScopes = new Set(getScopesForDoc(doc));
+      return scopes.some((scope) => docScopes.has(scope));
+    };
+
     // Tokenize query
     const tokenize = (text) => {
       const tokens = [];
@@ -9648,27 +10324,31 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
 
     // Perform search
     const performSearch = async (query) => {
-      if (!query.trim()) {
-        searchResults.innerHTML = '';
-        results = [];
-        return;
-      }
       await loadSearchIndex();
       if (!searchIndex) {
         searchResults.innerHTML = '<div class="search-empty">Search index not available</div>';
         return;
       }
 
-      const tokens = tokenize(query);
-      if (!tokens.length) {
+      const parsedQuery = parseScopedQuery(query);
+      if (!parsedQuery.text && parsedQuery.scopes.length === 0) {
         searchResults.innerHTML = '';
         results = [];
         return;
       }
 
+      const tokens = tokenize(parsedQuery.text);
       const k1 = 1.2, b = 0.75;
       const docScores = new Map();
 
+      if (!tokens.length) {
+        searchIndex.documents.forEach((doc, docIdx) => {
+          if (matchesScopes(doc, parsedQuery.scopes)) {
+            docScores.set(docIdx, { score: 0, matches: new Set() });
+          }
+        });
+      }
+
       for (let i = 0; i < tokens.length; i++) {
         const token = tokens[i];
         const isLast = i === tokens.length - 1;
@@ -9687,6 +10367,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
           for (const posting of postings) {
             const doc = searchIndex.documents[posting.doc_idx];
             if (!doc) continue;
+            if (!matchesScopes(doc, parsedQuery.scopes)) continue;
             const boost = posting.field === 'Title' ? 10 : posting.field === 'Heading' ? 5 : 1;
             const tf = posting.tf;
             const docLen = doc.body.length;
@@ -9705,6 +10386,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       results = Array.from(docScores.entries())
         .map(([docIdx, data]) => {
           const doc = searchIndex.documents[docIdx];
+          const scopes = getScopesForDoc(doc);
           let snippet = '';
           if (doc.body) {
             const bodyLower = doc.body.toLowerCase();
@@ -9713,15 +10395,15 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
               const pos = bodyLower.indexOf(match);
               if (pos !== -1 && (firstPos === -1 || pos < firstPos)) firstPos = pos;
             }
-            const start = Math.max(0, firstPos - 50);
+            const start = firstPos === -1 ? 0 : Math.max(0, firstPos - 50);
             const end = Math.min(doc.body.length, start + 150);
             snippet = doc.body.slice(start, end);
             if (start > 0) snippet = '...' + snippet;
             if (end < doc.body.length) snippet += '...';
           }
-          return { ...doc, score: data.score, snippet };
+          return { ...doc, score: data.score, scopes, snippet };
         })
-        .sort((a, b) => b.score - a.score)
+        .sort((a, b) => b.score - a.score || a.title.localeCompare(b.title))
         .slice(0, 10);
 
       selectedIndex = 0;
@@ -9735,7 +10417,7 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       }
       searchResults.innerHTML = results.map((r, i) =>
         '<a href="' + r.url + '" class="search-result' + (i === selectedIndex ? ' selected' : '') + '">' +
-        '<div class="search-result-title">' + r.title + '</div>' +
+        '<div class="search-result-title">' + r.title + (r.scopes?.length ? '<span class="search-result-scope">@' + r.scopes[0] + '</span>' : '') + '</div>' +
         (r.snippet ? '<div class="search-result-snippet">' + r.snippet + '</div>' : '') +
         '</a>'
       ).join('');
@@ -9866,7 +10548,7 @@ function generateBareHtmlPage(content, title) {
 * Generates HTML page with navigation using Rust NAPI bindings.
 */
 async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme) {
-	const mod = await import("@ox-content/napi");
+	const mod = await importNapiModule();
 	const tocForRust = pageData.toc.map((entry) => ({
 		depth: entry.depth,
 		text: entry.text,
@@ -9886,8 +10568,14 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 			name: pageData.entryPage.hero.name,
 			text: pageData.entryPage.hero.text,
 			tagline: pageData.entryPage.hero.tagline,
+			notice: pageData.entryPage.hero.notice ? {
+				title: pageData.entryPage.hero.notice.title,
+				body: pageData.entryPage.hero.notice.body
+			} : void 0,
 			image: pageData.entryPage.hero.image ? {
 				src: pageData.entryPage.hero.image.src,
+				lightSrc: pageData.entryPage.hero.image.lightSrc,
+				darkSrc: pageData.entryPage.hero.image.darkSrc,
 				alt: pageData.entryPage.hero.image.alt,
 				width: pageData.entryPage.hero.image.width,
 				height: pageData.entryPage.hero.image.height
@@ -9969,7 +10657,7 @@ function createSharedAssetChunk(type, label, content, outDir, base) {
 	const hash = createContentHash(content);
 	const fileName = `ox-content-${sanitizeChunkLabel(label)}-${hash}.${type}`;
 	return {
-		outputPath: path.join(outDir, "assets", fileName),
+		outputPath: path$1.join(outDir, "assets", fileName),
 		publicPath: toPublicAssetPath(base, fileName),
 		content
 	};
@@ -10059,7 +10747,7 @@ async function externalizeSharedPageAssets(pages, outDir, base) {
 	});
 	const chunks = [...cssChunks.values(), ...jsChunks.values()];
 	await Promise.all(chunks.map(async (chunk) => {
-		await fs.mkdir(path.dirname(chunk.outputPath), { recursive: true });
+		await fs.mkdir(path$1.dirname(chunk.outputPath), { recursive: true });
 		await fs.writeFile(chunk.outputPath, chunk.content, "utf-8");
 	}));
 	return {
@@ -10071,16 +10759,16 @@ async function externalizeSharedPageAssets(pages, outDir, base) {
 * Converts a markdown file path to its corresponding HTML output path.
 */
 function getOutputPath(inputPath, srcDir, outDir, extension) {
-	const baseName = path.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, extension);
-	if (baseName.endsWith(`index${extension}`)) return path.join(outDir, baseName);
+	const baseName = path$1.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, extension);
+	if (baseName.endsWith(`index${extension}`)) return path$1.join(outDir, baseName);
 	const dirName = baseName.replace(new RegExp(`\\${extension}$`), "");
-	return path.join(outDir, dirName, `index${extension}`);
+	return path$1.join(outDir, dirName, `index${extension}`);
 }
 /**
 * Converts a markdown file path to a relative URL path.
 */
 function getUrlPath$1(inputPath, srcDir) {
-	const baseName = path.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, "");
+	const baseName = path$1.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, "");
 	if (baseName === "index" || baseName.endsWith("/index")) return baseName.replace(/\/?index$/, "") || "/";
 	return baseName;
 }
@@ -10096,12 +10784,12 @@ function getHref(inputPath, srcDir, base, extension) {
 * Gets the OG image output path for a given markdown file.
 */
 function getOgImagePath(inputPath, srcDir, outDir) {
-	const baseName = path.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, "");
+	const baseName = path$1.relative(srcDir, inputPath).replace(/\.(?:md|markdown)$/i, "");
 	if (baseName === "index" || baseName.endsWith("/index")) {
 		const dirPath = baseName.replace(/\/?index$/, "") || "";
-		return path.join(outDir, dirPath, "og-image.png");
+		return path$1.join(outDir, dirPath, "og-image.png");
 	}
-	return path.join(outDir, baseName, "og-image.png");
+	return path$1.join(outDir, baseName, "og-image.png");
 }
 /**
 * Gets the OG image URL for use in meta tags.
@@ -10119,9 +10807,9 @@ function getOgImageUrl(inputPath, srcDir, base, siteUrl) {
 * Gets display title from file path.
 */
 function getDisplayTitle(filePath) {
-	const fileName = path.basename(filePath, path.extname(filePath));
+	const fileName = path$1.basename(filePath, path$1.extname(filePath));
 	if (fileName === "index") {
-		const dirName = path.basename(path.dirname(filePath));
+		const dirName = path$1.basename(path$1.dirname(filePath));
 		if (dirName && dirName !== ".") return formatTitle(dirName);
 		return "Home";
 	}
@@ -10137,7 +10825,7 @@ function formatTitle(name) {
 * Collects all markdown files from the source directory.
 */
 async function collectMarkdownFiles$1(srcDir) {
-	return (await glob(path.join(srcDir, "**/*.{md,markdown}"), {
+	return (await glob(path$1.join(srcDir, "**/*.{md,markdown}"), {
 		nodir: true,
 		ignore: [
 			"**/node_modules/**",
@@ -10158,7 +10846,7 @@ function buildNavItems(markdownFiles, srcDir, base, extension) {
 		"api"
 	];
 	for (const file of markdownFiles) {
-		const parts = path.relative(srcDir, file).split(path.sep);
+		const parts = path$1.relative(srcDir, file).split(path$1.sep);
 		let groupKey = "";
 		if (parts.length > 1) groupKey = parts[0];
 		if (!groups.has(groupKey)) groups.set(groupKey, []);
@@ -10207,8 +10895,8 @@ async function buildSsg(options, root) {
 		files: [],
 		errors: []
 	};
-	const srcDir = path.resolve(root, options.srcDir);
-	const outDir = path.resolve(root, options.outDir);
+	const srcDir = path$1.resolve(root, options.srcDir);
+	const outDir = path$1.resolve(root, options.outDir);
 	const base = options.base.endsWith("/") ? options.base : options.base + "/";
 	const generatedFiles = [];
 	const generatedPages = [];
@@ -10223,7 +10911,7 @@ async function buildSsg(options, root) {
 	const navItems = buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension);
 	let siteName = ssgOptions.siteName ?? "Documentation";
 	if (!ssgOptions.siteName) try {
-		const pkgPath = path.join(root, "package.json");
+		const pkgPath = path$1.join(root, "package.json");
 		const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
 		if (pkg.name) siteName = formatTitle(pkg.name);
 	} catch {}
@@ -10337,7 +11025,7 @@ async function buildSsg(options, root) {
 	const optimizedOutput = await externalizeSharedPageAssets(generatedPages, outDir, base);
 	generatedFiles.push(...optimizedOutput.assets);
 	for (const page of optimizedOutput.pages) {
-		await fs.mkdir(path.dirname(page.outputPath), { recursive: true });
+		await fs.mkdir(path$1.dirname(page.outputPath), { recursive: true });
 		await fs.writeFile(page.outputPath, page.html, "utf-8");
 		generatedFiles.push(page.outputPath);
 	}
@@ -10346,7 +11034,6 @@ async function buildSsg(options, root) {
 		errors
 	};
 }
-
 //#endregion
 //#region src/search.ts
 /**
@@ -10357,7 +11044,7 @@ async function buildSsg(options, root) {
 let oxContent$1 = null;
 async function getOxContent() {
 	if (!oxContent$1) try {
-		oxContent$1 = await import("@ox-content/napi");
+		oxContent$1 = await importNapiModule();
 	} catch {
 		console.warn("[ox-content] Native bindings not available, search disabled");
 		return null;
@@ -10393,7 +11080,7 @@ async function collectMarkdownFiles(dir) {
 		try {
 			const entries = await fs.readdir(currentDir, { withFileTypes: true });
 			for (const entry of entries) {
-				const fullPath = path.join(currentDir, entry.name);
+				const fullPath = path$1.join(currentDir, entry.name);
 				if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") await walk(fullPath);
 				else if (entry.isFile() && entry.name.endsWith(".md")) files.push(fullPath);
 			}
@@ -10418,7 +11105,7 @@ async function buildSearchIndex(srcDir, base) {
 	const documents = [];
 	for (const file of files) try {
 		const content = await fs.readFile(file, "utf-8");
-		const relativePath = path.relative(srcDir, file);
+		const relativePath = path$1.relative(srcDir, file);
 		const url = base + relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
 		const id = relativePath.replace(/\.md$/, "").replace(/\\/g, "/");
 		const extractSearchContent = napi.extractSearchContent;
@@ -10447,7 +11134,7 @@ async function buildSearchIndex(srcDir, base) {
 * Writes the search index to a file.
 */
 async function writeSearchIndex(indexJson, outDir) {
-	const indexPath = path.join(outDir, "search-index.json");
+	const indexPath = path$1.join(outDir, "search-index.json");
 	await fs.mkdir(outDir, { recursive: true });
 	await fs.writeFile(indexPath, indexJson, "utf-8");
 }
@@ -10463,6 +11150,51 @@ const searchOptions = ${JSON.stringify(options)};
 let searchIndex = null;
 let indexPromise = null;
 
+function parseScopedQuery(query) {
+  const scopes = [];
+  const terms = [];
+
+  for (const part of query.trim().split(/\\s+/).filter(Boolean)) {
+    if (part.startsWith('@') && part.length > 1) {
+      scopes.push(part.slice(1).toLowerCase());
+    } else {
+      terms.push(part);
+    }
+  }
+
+  return {
+    text: terms.join(' ').trim(),
+    scopes: [...new Set(scopes)],
+  };
+}
+
+function getScopesForDoc(doc) {
+  const source = (doc.id || doc.url || '').replace(/^\\/+/, '').toLowerCase();
+  const segments = source.split('/').filter(Boolean);
+
+  if (segments.length <= 1) {
+    return [];
+  }
+
+  const scopes = [];
+  let current = '';
+  for (const segment of segments.slice(0, -1)) {
+    current = current ? current + '/' + segment : segment;
+    scopes.push(current);
+  }
+
+  return scopes;
+}
+
+function matchesScopes(doc, scopes) {
+  if (!scopes.length) {
+    return true;
+  }
+
+  const docScopes = new Set(getScopesForDoc(doc));
+  return scopes.some(scope => docScopes.has(scope));
+}
+
 // Tokenizer for queries
 function tokenizeQuery(text) {
   const tokens = [];
@@ -10530,22 +11262,32 @@ async function loadIndex() {
 export async function search(query, options = {}) {
   const index = await loadIndex();
 
-  if (!index || !query.trim()) {
+  if (!index) {
     return [];
   }
 
-  const limit = options.limit ?? searchOptions.limit;
-  const prefix = options.prefix ?? searchOptions.prefix;
-  const tokens = tokenizeQuery(query);
+  const parsedQuery = parseScopedQuery(query);
 
-  if (tokens.length === 0) {
+  if (!parsedQuery.text && parsedQuery.scopes.length === 0) {
     return [];
   }
 
+  const limit = options.limit ?? searchOptions.limit;
+  const prefix = options.prefix ?? searchOptions.prefix;
+  const tokens = tokenizeQuery(parsedQuery.text);
+
   const k1 = 1.2;
   const b = 0.75;
   const docScores = new Map();
 
+  if (tokens.length === 0) {
+    index.documents.forEach((doc, docIdx) => {
+      if (matchesScopes(doc, parsedQuery.scopes)) {
+        docScores.set(docIdx, { score: 0, matches: new Set() });
+      }
+    });
+  }
+
   for (let i = 0; i < tokens.length; i++) {
     const token = tokens[i];
     const isLast = i === tokens.length - 1;
@@ -10566,6 +11308,7 @@ export async function search(query, options = {}) {
       for (const posting of postings) {
         const doc = index.documents[posting.doc_idx];
         if (!doc) continue;
+        if (!matchesScopes(doc, parsedQuery.scopes)) continue;
 
         const docLen = doc.body.length;
         const tf = posting.tf;
@@ -10588,6 +11331,7 @@ export async function search(query, options = {}) {
     .map(([docIdx, data]) => {
       const doc = index.documents[docIdx];
       const matches = Array.from(data.matches);
+      const scopes = getScopesForDoc(doc);
 
       // Generate snippet
       let snippet = '';
@@ -10601,7 +11345,7 @@ export async function search(query, options = {}) {
           }
         }
 
-        const start = Math.max(0, firstPos - 50);
+        const start = firstPos === -1 ? 0 : Math.max(0, firstPos - 50);
         const end = Math.min(doc.body.length, start + 150);
         snippet = doc.body.slice(start, end);
         if (start > 0) snippet = '...' + snippet;
@@ -10615,9 +11359,10 @@ export async function search(query, options = {}) {
         score: data.score,
         matches,
         snippet,
+        scopes,
       };
     })
-    .sort((a, b) => b.score - a.score)
+    .sort((a, b) => b.score - a.score || a.title.localeCompare(b.title))
     .slice(0, limit);
 
   return results;
@@ -10627,7 +11372,6 @@ export { searchOptions };
 export default { search, searchOptions, loadIndex };
 `;
 }
-
 //#endregion
 //#region src/dev-server.ts
 /**
@@ -10692,12 +11436,12 @@ async function resolveMarkdownFile(url, srcDir) {
 	let relativePath;
 	if (pathname === "/") relativePath = "index.md";
 	else relativePath = pathname.slice(1) + ".md";
-	const filePath = path.join(srcDir, relativePath);
+	const filePath = path$1.join(srcDir, relativePath);
 	try {
 		await fs.access(filePath);
 		return filePath;
 	} catch {
-		const indexPath = path.join(srcDir, pathname === "/" ? "" : pathname.slice(1), "index.md");
+		const indexPath = path$1.join(srcDir, pathname === "/" ? "" : pathname.slice(1), "index.md");
 		try {
 			await fs.access(indexPath);
 			return indexPath;
@@ -10741,7 +11485,7 @@ function invalidatePageCache(cache, filePath) {
 async function resolveSiteName(options, root) {
 	if (options.ssg.siteName) return options.ssg.siteName;
 	try {
-		const pkgPath = path.join(root, "package.json");
+		const pkgPath = path$1.join(root, "package.json");
 		const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
 		if (pkg.name) return formatTitle(pkg.name);
 	} catch {}
@@ -10751,7 +11495,7 @@ async function resolveSiteName(options, root) {
 * Render a single markdown page to full HTML.
 */
 async function renderPage$1(filePath, options, navGroups, siteName, base, root) {
-	const srcDir = path.resolve(root, options.srcDir);
+	const srcDir = path$1.resolve(root, options.srcDir);
 	resetTabGroupCounter();
 	resetIslandCounter();
 	const result = await transformMarkdown(await fs.readFile(filePath, "utf-8"), filePath, options, {
@@ -10796,7 +11540,7 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 * Create the dev server middleware for SSG page serving.
 */
 function createDevServerMiddleware(options, root, cache) {
-	const srcDir = path.resolve(root, options.srcDir);
+	const srcDir = path$1.resolve(root, options.srcDir);
 	const base = options.base.endsWith("/") ? options.base : options.base + "/";
 	return async (req, res, next) => {
 		const url = req.url;
@@ -10828,7 +11572,6 @@ function createDevServerMiddleware(options, root, cache) {
 		}
 	};
 }
-
 //#endregion
 //#region src/og-viewer.ts
 /**
@@ -10862,7 +11605,7 @@ function extractTitle(content, frontmatter) {
 	return match ? match[1].trim() : "";
 }
 function getUrlPath(filePath, srcDir) {
-	let rel = path.relative(srcDir, filePath).replace(/\\/g, "/");
+	let rel = path$1.relative(srcDir, filePath).replace(/\\/g, "/");
 	rel = rel.replace(/\.md$/, "");
 	if (rel === "index") return "/";
 	if (rel.endsWith("/index")) rel = rel.slice(0, -6);
@@ -10902,7 +11645,7 @@ function validatePage(page, options) {
 	return warnings;
 }
 async function collectPages(options, root) {
-	const srcDir = path.resolve(root, options.srcDir);
+	const srcDir = path$1.resolve(root, options.srcDir);
 	const files = await glob("**/*.md", {
 		cwd: srcDir,
 		absolute: true
@@ -10920,7 +11663,7 @@ async function collectPages(options, root) {
 		const urlPath = getUrlPath(file, srcDir);
 		const ogImageUrl = computeOgImageUrl(urlPath, options.base, options.ssg.siteUrl, generateOgImage, options.ssg.ogImage);
 		const page = {
-			path: path.relative(srcDir, file),
+			path: path$1.relative(srcDir, file),
 			urlPath,
 			title,
 			description,
@@ -10947,43 +11690,41 @@ function renderViewerHtml(pages, options) {
   <style>
     :root {
       --bg: #ffffff;
-      --bg-card: #f8f9fa;
+      --bg-card: #f5f7fb;
       --bg-preview: #ffffff;
-      --text: #1a1a2e;
-      --text-muted: #6b7280;
-      --border: #e5e7eb;
-      --accent: #e8590c;
-      --accent-light: #fff4e6;
+      --text: #131a30;
+      --text-muted: #4f607b;
+      --border: #d2dbea;
+      --accent: #4f6fae;
+      --accent-light: #eef2fa;
       --error: #dc2626;
       --error-bg: #fef2f2;
       --warning: #d97706;
       --warning-bg: #fffbeb;
       --success: #16a34a;
-      --tag-bg: #f0f0f0;
-      --shadow: 0 1px 3px rgba(0,0,0,0.08);
-      --radius: 8px;
+      --tag-bg: #ecf3ff;
+      --radius: 16px;
     }
     @media (prefers-color-scheme: dark) {
       :root {
-        --bg: #0f172a;
-        --bg-card: #1e293b;
-        --bg-preview: #334155;
-        --text: #e2e8f0;
-        --text-muted: #94a3b8;
-        --border: #334155;
-        --accent: #fb923c;
-        --accent-light: #431407;
+        --bg: #060816;
+        --bg-card: #0d1528;
+        --bg-preview: #10172d;
+        --text: #ebf2ff;
+        --text-muted: #8ea0bf;
+        --border: #223252;
+        --accent: #86a4da;
+        --accent-light: #151730;
         --error: #f87171;
         --error-bg: #450a0a;
         --warning: #fbbf24;
         --warning-bg: #451a03;
         --success: #4ade80;
-        --tag-bg: #334155;
-        --shadow: 0 1px 3px rgba(0,0,0,0.3);
+        --tag-bg: #131b33;
       }
     }
     * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif; background: var(--bg); color: var(--text); }
+    body { font-family: 'IBM Plex Sans', 'Avenir Next', 'Segoe UI', system-ui, sans-serif; background: radial-gradient(circle at top left, rgba(79,111,174,0.10), transparent 24%), radial-gradient(circle at 85% 14%, rgba(145,237,233,0.08), transparent 22%), var(--bg); color: var(--text); }
     .header { padding: 16px 24px; border-bottom: 1px solid var(--border); display: flex; align-items: center; gap: 12px; }
     .header svg { width: 28px; height: 28px; color: var(--accent); }
     .header h1 { font-size: 18px; font-weight: 600; }
@@ -11004,7 +11745,7 @@ function renderViewerHtml(pages, options) {
     .search-input { padding: 6px 12px; border: 1px solid var(--border); border-radius: 6px; background: var(--bg); color: var(--text); font-size: 13px; flex: 1; min-width: 200px; }
     .search-input::placeholder { color: var(--text-muted); }
     .container { padding: 24px; display: flex; flex-direction: column; gap: 20px; max-width: 1200px; margin: 0 auto; }
-    .card { border: 1px solid var(--border); border-radius: var(--radius); background: var(--bg-card); box-shadow: var(--shadow); overflow: hidden; }
+    .card { border: 1px solid var(--border); border-radius: var(--radius); background: var(--bg-card); overflow: hidden; }
     .card-header { padding: 16px; border-bottom: 1px solid var(--border); }
     .card-path { font-size: 12px; color: var(--text-muted); font-family: monospace; margin-bottom: 4px; }
     .card-title { font-size: 16px; font-weight: 600; }
@@ -11175,7 +11916,6 @@ function createOgViewerPlugin(options) {
 		}
 	};
 }
-
 //#endregion
 //#region src/i18n.ts
 /**
@@ -11236,13 +11976,13 @@ function createI18nPlugin(resolvedOptions) {
 		},
 		async buildStart() {
 			if (!i18nOptions || !i18nOptions.check) return;
-			const dictDir = path.resolve(root, i18nOptions.dir);
+			const dictDir = path$1.resolve(root, i18nOptions.dir);
 			if (!fs$1.existsSync(dictDir)) {
 				console.warn(`[ox-content:i18n] Dictionary directory not found: ${dictDir}`);
 				return;
 			}
 			try {
-				const { loadDictionaries, checkI18n, extractTranslationKeys } = await import("@ox-content/napi");
+				const { loadDictionaries, checkI18n, extractTranslationKeys } = await importNapiModule();
 				const loadResult = loadDictionaries(dictDir);
 				if (loadResult.errors.length > 0) {
 					for (const error of loadResult.errors) console.warn(`[ox-content:i18n] ${error}`);
@@ -11258,7 +11998,7 @@ function createI18nPlugin(resolvedOptions) {
 		},
 		configureServer(server) {
 			if (!i18nOptions) return;
-			const dictDir = path.resolve(root, i18nOptions.dir);
+			const dictDir = path$1.resolve(root, i18nOptions.dir);
 			if (fs$1.existsSync(dictDir)) {
 				server.watcher.add(dictDir);
 				server.watcher.on("change", (filePath) => {
@@ -11285,7 +12025,7 @@ function createI18nPlugin(resolvedOptions) {
 * Generates the virtual module for i18n configuration.
 */
 function generateI18nModule(options, root) {
-	const dictDir = path.resolve(root, options.dir);
+	const dictDir = path$1.resolve(root, options.dir);
 	const localesJson = JSON.stringify(options.locales);
 	const defaultLocale = JSON.stringify(options.defaultLocale);
 	let dictionariesCode = "{}";
@@ -11368,15 +12108,15 @@ function flattenObject(obj, prefix, result) {
 function loadDictionariesFallback(options, dictDir) {
 	const dictData = {};
 	for (const locale of options.locales) {
-		const localeDir = path.join(dictDir, locale.code);
+		const localeDir = path$1.join(dictDir, locale.code);
 		if (!fs$1.existsSync(localeDir)) continue;
 		const files = fs$1.readdirSync(localeDir);
 		const localeDict = {};
 		for (const file of files) {
 			if (!file.endsWith(".json")) continue;
-			const filePath = path.join(localeDir, file);
+			const filePath = path$1.join(localeDir, file);
 			const content = fs$1.readFileSync(filePath, "utf-8");
-			const namespace = path.basename(file, ".json");
+			const namespace = path$1.basename(file, ".json");
 			try {
 				flattenObject(JSON.parse(content), namespace, localeDict);
 			} catch {}
@@ -11389,13 +12129,13 @@ function loadDictionariesFallback(options, dictDir) {
 * Collects translation keys from source files using NAPI extractTranslationKeys.
 */
 function collectKeysFromSource(root, extractTranslationKeys, options) {
-	const srcDir = path.resolve(root, "src");
+	const srcDir = path$1.resolve(root, "src");
 	const keys = /* @__PURE__ */ new Set();
 	if (fs$1.existsSync(srcDir)) walkDir(srcDir, /\.(ts|tsx|js|jsx)$/, (filePath) => {
 		const usages = extractTranslationKeys(fs$1.readFileSync(filePath, "utf-8"), filePath, options.functionNames);
 		for (const usage of usages) keys.add(usage.key);
 	});
-	const contentDir = path.resolve(root, "content");
+	const contentDir = path$1.resolve(root, "content");
 	if (fs$1.existsSync(contentDir)) {
 		const tPattern = /\{\{t\(['"]([^'"]+)['"]\)\}\}/g;
 		walkDir(contentDir, /\.(md|mdx)$/, (filePath) => {
@@ -11413,14 +12153,13 @@ function collectKeysFromSource(root, extractTranslationKeys, options) {
 function walkDir(dir, pattern, callback) {
 	const entries = fs$1.readdirSync(dir, { withFileTypes: true });
 	for (const entry of entries) {
-		const fullPath = path.join(dir, entry.name);
+		const fullPath = path$1.join(dir, entry.name);
 		if (entry.isDirectory()) {
 			if (entry.name === "node_modules" || entry.name === ".git") continue;
 			walkDir(fullPath, pattern, callback);
 		} else if (pattern.test(entry.name)) callback(fullPath);
 	}
 }
-
 //#endregion
 //#region src/jsx-runtime.ts
 /**
@@ -11610,7 +12349,6 @@ function when(condition, content) {
 function each(items, render) {
 	return { __html: items.map((item, i) => render(item, i).__html).join("") };
 }
-
 //#endregion
 //#region src/page-context.ts
 var page_context_exports = /* @__PURE__ */ __exportAll({
@@ -11801,7 +12539,6 @@ var currentContext;
 var init_page_context = __esmMin((() => {
 	currentContext = null;
 }));
-
 //#endregion
 //#region src/theme-renderer.ts
 /**
@@ -11903,13 +12640,16 @@ function DefaultTheme({ children }) {
   ${page.description ? `<meta name="description" content="${escapeHtml(page.description)}">` : ""}
   <style>
     :root {
-      --octc-color-primary: #e04d0a;
-      --octc-color-text: #1a1a1a;
+      --octc-color-primary: #4f6fae;
+      --octc-color-text: #131a30;
       --octc-color-bg: #ffffff;
+      --octc-color-bg-alt: #f5f7fb;
+      --octc-color-text-muted: #4f607b;
+      --octc-color-border: #d2dbea;
     }
     body {
-      font-family: system-ui, sans-serif;
-      line-height: 1.6;
+      font-family: "IBM Plex Sans", "Avenir Next", "Segoe UI Variable", "Segoe UI", sans-serif;
+      line-height: 1.7;
       color: var(--octc-color-text);
       background: var(--octc-color-bg);
       max-width: 800px;
@@ -11959,7 +12699,6 @@ function createTheme(config) {
 		return Layout({ children });
 	};
 }
-
 //#endregion
 //#region src/index.ts
 /**
@@ -11994,8 +12733,8 @@ function oxContent(options = {}) {
 	async function regenerateDocs(root) {
 		const docsOptions = resolvedOptions.docs;
 		if (!docsOptions || !docsOptions.enabled) return 0;
-		const srcDirs = docsOptions.src.map((src) => path.resolve(root, src));
-		const outDir = path.resolve(root, docsOptions.out);
+		const srcDirs = docsOptions.src.map((src) => path$1.resolve(root, src));
+		const outDir = path$1.resolve(root, docsOptions.out);
 		const extracted = await extractDocs(srcDirs, docsOptions);
 		const generated = generateMarkdown(extracted, docsOptions);
 		await writeDocs(generated, outDir, extracted, docsOptions);
@@ -12064,7 +12803,7 @@ function oxContent(options = {}) {
 			const docsOptions = resolvedOptions.docs;
 			if (!docsOptions || !docsOptions.enabled) return;
 			const root = config?.root || process.cwd();
-			const srcDirs = docsOptions.src.map((src) => path.resolve(root, src));
+			const srcDirs = docsOptions.src.map((src) => path$1.resolve(root, src));
 			for (const srcDir of srcDirs) devServer.watcher.add(srcDir);
 			devServer.watcher.on("all", async (event, file) => {
 				if (event !== "add" && event !== "change" && event !== "unlink") return;
@@ -12080,7 +12819,7 @@ function oxContent(options = {}) {
 		configureServer(devServer) {
 			if (!resolvedOptions.ssg.enabled) return;
 			const root = config?.root || process.cwd();
-			const srcDir = path.resolve(root, resolvedOptions.srcDir);
+			const srcDir = path$1.resolve(root, resolvedOptions.srcDir);
 			devServer.middlewares.use(createDevServerMiddleware(resolvedOptions, root, ssgDevCache));
 			devServer.watcher.on("add", (file) => {
 				if (file.startsWith(srcDir) && file.endsWith(".md")) {
@@ -12147,7 +12886,7 @@ function oxContent(options = {}) {
 			async buildStart() {
 				if (!resolvedOptions.search.enabled) return;
 				const root = config?.root || process.cwd();
-				const srcDir = path.resolve(root, resolvedOptions.srcDir);
+				const srcDir = path$1.resolve(root, resolvedOptions.srcDir);
 				try {
 					searchIndexJson = await buildSearchIndex(srcDir, resolvedOptions.base);
 					console.log("[ox-content] Search index built");
@@ -12158,10 +12897,10 @@ function oxContent(options = {}) {
 			async closeBundle() {
 				if (!resolvedOptions.search.enabled || !searchIndexJson) return;
 				const root = config?.root || process.cwd();
-				const outDir = path.resolve(root, resolvedOptions.outDir);
+				const outDir = path$1.resolve(root, resolvedOptions.outDir);
 				try {
 					await writeSearchIndex(searchIndexJson, outDir);
-					console.log("[ox-content] Search index written to", path.join(outDir, "search-index.json"));
+					console.log("[ox-content] Search index written to", path$1.join(outDir, "search-index.json"));
 				} catch (err) {
 					console.warn("[ox-content] Failed to write search index:", err);
 				}
@@ -12189,6 +12928,7 @@ function resolveOptions(options) {
 		highlight: options.highlight ?? false,
 		highlightTheme: options.highlightTheme ?? "github-dark",
 		highlightLangs: options.highlightLangs ?? [],
+		codeAnnotations: resolveCodeAnnotationsOptions(options.codeAnnotations),
 		mermaid: options.mermaid ?? false,
 		frontmatter: options.frontmatter ?? true,
 		toc: options.toc ?? true,
@@ -12202,6 +12942,26 @@ function resolveOptions(options) {
 		i18n: resolveI18nOptions(options.i18n)
 	};
 }
+function resolveCodeAnnotationsOptions(options) {
+	if (!options) return {
+		enabled: false,
+		notation: "attribute",
+		metaKey: "annotate",
+		defaultLineNumbers: false
+	};
+	if (options === true) return {
+		enabled: true,
+		notation: "attribute",
+		metaKey: "annotate",
+		defaultLineNumbers: false
+	};
+	return {
+		enabled: true,
+		notation: options.notation ?? "attribute",
+		metaKey: options.metaKey ?? "annotate",
+		defaultLineNumbers: options.defaultLineNumbers ?? false
+	};
+}
 /**
 * Generates virtual module content.
 */
@@ -12219,7 +12979,7 @@ function generateVirtualModule(path, options) {
     `;
 	return "export default {};";
 }
-
 //#endregion
 export { DEFAULT_HTML_TEMPLATE, DefaultTheme, Fragment, buildSearchIndex, buildSsg, clearRenderContext, collectGitHubRepos, collectOgpUrls, createI18nPlugin, createMarkdownEnvironment, createTheme, defaultTheme, defineTheme, each, extractDocs, extractIslandInfo, extractVideoId, fetchOgpData, fetchRepoData, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, hasIslands, inferType, jsx, jsxs, mergeThemes, mermaidClientScript, oxContent, prefetchGitHubRepos, prefetchOgpData, raw, renderAllPages, renderPage, renderToString, resolveDocsOptions, resolveI18nOptions, resolveOgImageOptions, resolveSearchOptions, resolveSsgOptions, resolveTheme, setRenderContext, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeSearchIndex };
-//# sourceMappingURL=index.js.map
+
+//# sourceMappingURL=index.mjs.map