@ox-content/vite-plugin 0.17.0 → 1.1.0

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

@@ -1,23 +1,23 @@
-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";
 import { createHighlighter } from "shiki";
 import { dirname, join } from "node:path";
 import * as fs$1 from "fs";
+import { createHash } from "node:crypto";
 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;
@@ -26,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;
 };
@@ -59,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
 /**
@@ -107,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) => {
@@ -158,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) => {
@@ -349,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) => {
@@ -515,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) => {
@@ -578,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) => {
@@ -619,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) => {
@@ -657,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) => {
@@ -692,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) => {
@@ -786,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) => {
@@ -814,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) => {
@@ -878,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) => {
@@ -1000,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) => {
@@ -1021,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) => {
@@ -1138,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) => {
@@ -1363,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) => {
@@ -1471,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) => {
@@ -1569,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) => {
@@ -1584,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) => {
@@ -1625,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) => {
@@ -1677,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) => {
@@ -1711,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) => {
@@ -1826,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) => {
@@ -1936,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,
@@ -1953,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) => {
@@ -2062,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,
@@ -2079,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",
@@ -2096,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) => {
@@ -2114,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) => {
@@ -2134,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) => {
@@ -2156,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) => {
@@ -2182,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",
@@ -2195,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) => {
@@ -2241,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) => {
@@ -2252,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,
@@ -2265,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) => {
@@ -2320,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: /^/,
@@ -2329,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",
@@ -2379,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) => {
@@ -2442,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) => {
@@ -2506,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) => {
@@ -2534,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) => {
@@ -2560,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",
@@ -2576,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) => {
@@ -2656,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) => {
@@ -2725,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) => {
@@ -2809,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) => {
@@ -2826,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,
@@ -2849,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) => {
@@ -2936,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) => {
@@ -2946,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";
@@ -2964,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) => {
@@ -3028,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) => {
@@ -3310,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) => {
@@ -3364,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) => {
@@ -3472,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) => {
@@ -3502,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) => {
@@ -3515,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) => {
@@ -3528,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) => {
@@ -3613,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) => {
@@ -3656,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) => {
@@ -3695,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) => {
@@ -3851,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) => {
@@ -3904,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) => {
@@ -4080,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) => {
@@ -4287,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) => {
@@ -4347,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) => {
@@ -4375,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) => {
@@ -4461,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) => {
@@ -4504,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) => {
@@ -4703,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) => {
@@ -4971,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) => {
@@ -5023,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) => {
@@ -5115,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) => {
@@ -5195,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) => {
@@ -5715,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) => {
@@ -5763,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) => {
@@ -6620,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) => {
@@ -6708,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();
@@ -6722,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();
@@ -6756,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.
 */
@@ -6790,15 +6695,23 @@ 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 cacheKey = JSON.stringify({
+		theme,
+		langs: customLangs
 	});
+	let highlighterPromise = highlighterCache.get(cacheKey);
+	if (!highlighterPromise) {
+		highlighterPromise = createHighlighter({
+			themes: [theme],
+			langs: [...BUILTIN_LANGS, ...customLangs]
+		});
+		highlighterCache.set(cacheKey, highlighterPromise);
+	}
 	return highlighterPromise;
 }
 /**
@@ -6814,12 +6727,9 @@ function rehypeShikiHighlight(options) {
 				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 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, {
@@ -6827,7 +6737,12 @@ function rehypeShikiHighlight(options) {
 								theme
 							});
 							const parsed = unified().use(rehypeParse, { fragment: true }).parse(highlighted);
-							if (parsed.children[0]) node.children[i] = parsed.children[0];
+							if (parsed.children[0]?.type === "element") {
+								const highlightedPre = parsed.children[0];
+								highlightedPre.properties ??= {};
+								highlightedPre.properties["data-language"] = lang;
+								node.children[i] = highlightedPre;
+							}
 						} catch {}
 					}
 				} else if (child.type === "element") await visit(child);
@@ -6847,6 +6762,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.
 */
@@ -6857,7 +6777,6 @@ async function highlightCode(html, theme = "github-dark", langs = []) {
 	}).use(rehypeStringify).process(html);
 	return String(result);
 }
-
 //#endregion
 //#region src/plugins/mermaid-protect.ts
 /**
@@ -6910,7 +6829,6 @@ function restoreMermaidSvgs(html, svgs) {
 	for (const [placeholder, content] of svgs) result = result.replace(placeholder, content);
 	return result;
 }
-
 //#endregion
 //#region src/transform.ts
 /**
@@ -6998,7 +6916,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) {
@@ -7020,7 +6938,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;
@@ -7032,7 +6954,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),
@@ -7128,7 +7054,6 @@ if (import.meta.hot) {
 }
 `;
 }
-
 //#endregion
 //#region src/nav-generator.ts
 /**
@@ -7275,7 +7200,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());
 }
@@ -7292,7 +7217,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;
 }
@@ -7367,7 +7292,6 @@ export interface NavItem {
 export const ${exportName}: NavItem[] = ${JSON.stringify(navItems, null, 2)} as const;
 `;
 }
-
 //#endregion
 //#region src/docs.ts
 /**
@@ -7421,6 +7345,46 @@ export const ${exportName}: NavItem[] = ${JSON.stringify(navItems, null, 2)} as
 * ```
 */
 const DOCS_MANIFEST_FILE = ".ox-content-docs-manifest.json";
+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])}">${escapeHtml$3(match[2])}</a>`;
+		lastIndex = match.index + match[0].length;
+	}
+	html += escapeHtml$3(text.slice(lastIndex));
+	return html.replace(/\n/g, "<br>");
+}
+function renderParagraphsHtml(text) {
+	return text.split(/\n\s*\n/).map((paragraph) => paragraph.trim()).filter(Boolean).map((paragraph) => `<p>${renderInlineHtml(paragraph)}</p>`).join("\n");
+}
+function renderCodeBlockHtml(code, language = "typescript") {
+	return `<pre><code class="language-${language}">${escapeHtml$3(code)}</code></pre>`;
+}
+function buildDocsData(docs) {
+	return {
+		version: 1,
+		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		modules: docs
+	};
+}
 /**
 * Regex pattern for matching JSDoc comment blocks.
 *
@@ -7525,7 +7489,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()) {
@@ -7781,7 +7745,7 @@ function generateMarkdown(docs, options) {
 	if (options.groupBy === "file") {
 		const docToFile = /* @__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";
 			docToFile.set(doc, fileName);
 			const markdown = generateFileMarkdown(doc, options, fileName, symbolMap);
@@ -7801,74 +7765,132 @@ function generateMarkdown(docs, options) {
 	return result;
 }
 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 += "Skim the one-line surface first, then expand the accordions for details.\n\n";
+	md += "## Overview\n\n";
+	for (const entry of doc.entries) md += renderOverviewLine(entry, `#${entryAnchor(entry.name)}`);
+	md += "\n## Reference\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(/^async\s+function\s+/, "").replace(/^function\s+/, "").replace(/^class\s+/, "").trim();
+}
+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 fragments = [`<a href="${escapeHtml$3(href)}"><code>${escapeHtml$3(entry.name)}</code></a>`, `<span class="ox-api-module__kind">${escapeHtml$3(entry.kind)}</span>`];
+	if (signature) fragments.push(`<code>${escapeHtml$3(signature)}</code>`);
+	if (summary) fragments.push(`<span>${renderInlineHtml(summary)}</span>`);
+	return `<li>${fragments.join("")}</li>`;
+}
+function renderParamsTableHtml(params) {
+	return `<div class="ox-api-entry__section">
+<h4>Parameters</h4>
+<table>
+  <thead>
+    <tr><th>Name</th><th>Type</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+${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 `<tr>
+  <td><code>${escapeHtml$3(param.name)}</code></td>
+  <td><code>${escapeHtml$3(param.type)}</code></td>
+  <td>${renderInlineHtml(description)}</td>
+</tr>`;
+	}).join("\n")}
+  </tbody>
+</table>
+</div>`;
+}
+function renderTagListHtml(tags) {
+	return `<div class="ox-api-entry__section">
+<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>${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) : void 0;
+	let body = "";
+	if (processedDescription) body += renderParagraphsHtml(processedDescription) + "\n";
+	if (sourceHref) body += `<p class="ox-api-entry__source"><a href="${escapeHtml$3(sourceHref)}">View source</a></p>\n`;
+	if (entry.signature) body += `<div class="ox-api-entry__section">\n<h4>Signature</h4>\n${renderCodeBlockHtml(entry.signature)}\n</div>\n`;
+	if (entry.params && entry.params.length > 0) body += renderParamsTableHtml(entry.params) + "\n";
+	if (entry.returns) body += `<div class="ox-api-entry__section">
+<h4>Returns</h4>
+<p><code>${escapeHtml$3(entry.returns.type)}</code>${entry.returns.description ? ` — ${renderInlineHtml(entry.returns.description)}` : ""}</p>
+</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">\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 summaryParts = [`<span class="ox-api-entry__kind">${escapeHtml$3(entry.kind)}</span>`, `<code class="ox-api-entry__name">${escapeHtml$3(entry.name)}</code>`];
+	if (summarySignature) summaryParts.push(`<code class="ox-api-entry__signature">${escapeHtml$3(summarySignature)}</code>`);
+	if (summaryDescription) summaryParts.push(`<span class="ox-api-entry__description">${renderInlineHtml(summaryDescription)}</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";
 	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";
 	for (const entry of entries) md += generateEntryMarkdown(entry, options, categoryFileName, symbolMap);
 	return md;
 }
@@ -7878,10 +7900,8 @@ function generateCategoryIndex(byKind) {
 	for (const [kind, entries] of byKind) {
 		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;
@@ -7922,7 +7942,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,
@@ -7939,7 +7959,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"));
@@ -7948,17 +7969,18 @@ 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");
 }
 /**
@@ -7970,10 +7992,13 @@ async function writeDocs(docs, outDir, extractedDocs, options) {
 * @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
+* @returns Absolute GitHub URL to source code
 */
+function generateSourceHref(filePath, githubUrl, lineNumber) {
+	return `${githubUrl}/blob/main/${filePath.replace(/^.*?\/(npm|packages|crates|src)\//, "$1/")}${lineNumber ? `#L${lineNumber}` : ""}`;
+}
 function generateSourceLink(filePath, githubUrl, lineNumber) {
-	return `**[Source](${`${githubUrl}/blob/main/${filePath.replace(/^.*?\/(npm|packages|crates|src)\//, "$1/")}${lineNumber ? `#L${lineNumber}` : ""}`})**`;
+	return `**[Source](${generateSourceHref(filePath, githubUrl, lineNumber)})**`;
 }
 function resolveDocsOptions(options) {
 	if (options === false) return false;
@@ -7996,7 +8021,6 @@ function resolveDocsOptions(options) {
 		generateNav: opts.generateNav ?? true
 	};
 }
-
 //#endregion
 //#region src/og-image/renderer.ts
 /**
@@ -8041,10 +8065,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: {
@@ -8079,7 +8103,6 @@ async function renderHtmlToPng(page, html, width, height, publicDir) {
 	});
 	return Buffer.from(screenshot);
 }
-
 //#endregion
 //#region src/og-image/browser.ts
 /**
@@ -8125,7 +8148,6 @@ async function openBrowser() {
 		return null;
 	}
 }
-
 //#endregion
 //#region src/og-image/template.ts
 /**
@@ -8155,7 +8177,6 @@ function getDefaultTemplate() {
 </div>`;
 	};
 }
-
 //#endregion
 //#region src/og-image/cache.ts
 /**
@@ -8181,7 +8202,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 {
@@ -8193,12 +8214,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();
@@ -8253,7 +8273,6 @@ function _usingCtx() {
 		}
 	};
 }
-
 //#endregion
 //#region src/og-image/index.ts
 /**
@@ -8286,14 +8305,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":
@@ -8307,9 +8326,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"
@@ -8332,9 +8351,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",
@@ -8430,9 +8449,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",
@@ -8488,9 +8507,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",
@@ -8540,7 +8559,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");
 }
@@ -8558,7 +8577,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;
@@ -8570,7 +8589,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);
@@ -8594,7 +8613,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,
@@ -8612,7 +8631,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,
@@ -8622,7 +8641,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 {
@@ -8637,7 +8656,6 @@ async function renderSinglePage(entry, templateFn, templateSource, options, cach
 		};
 	}
 }
-
 //#endregion
 //#region src/plugins/index.ts
 /**
@@ -8647,28 +8665,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
 /**
@@ -8860,7 +8877,6 @@ initIslands((el, props) => {
 });
 `;
 }
-
 //#endregion
 //#region src/theme.ts
 /**
@@ -9043,7 +9059,6 @@ function themeToNapi(theme) {
 		js: theme.js || void 0
 	};
 }
-
 //#endregion
 //#region src/ssg.ts
 /**
@@ -9086,6 +9101,11 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       --color-primary-hover: #ce5937;
       --color-code-bg: #1e293b;
       --color-code-text: #e2e8f0;
+      --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;
     }
     [data-theme="dark"] {
       --color-bg: #141414;
@@ -9097,6 +9117,11 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       --color-primary-hover: #d4845f;
       --color-code-bg: #1a1a1a;
       --color-code-text: #e5e5e5;
+      --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;
     }
     @media (prefers-color-scheme: dark) {
       :root:not([data-theme="light"]) {
@@ -9109,6 +9134,11 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
         --color-primary-hover: #d4845f;
         --color-code-bg: #1a1a1a;
         --color-code-text: #e5e5e5;
+        --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;
       }
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -9409,6 +9439,25 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
       padding: 0;
       font-size: 0.8125rem;
     }
+    .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);
+      box-shadow: inset 3px 0 0 var(--color-code-line-warning-border);
+    }
+    .content pre.ox-code-block .ox-code-line--error {
+      background: var(--color-code-line-error);
+      box-shadow: inset 3px 0 0 var(--color-code-line-error-border);
+    }
     .content table {
       width: 100%;
       border-collapse: collapse;
@@ -9452,6 +9501,10 @@ const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
         overflow-x: auto;
         -webkit-overflow-scrolling: touch;
       }
+      .content pre.ox-code-block .line {
+        margin: 0 -0.75rem;
+        padding: 0 0.75rem;
+      }
       .content code { font-size: 0.8125em; }
       .content table {
         display: block;
@@ -9625,6 +9678,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 = [];
@@ -9647,27 +9733,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;
@@ -9686,6 +9776,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;
@@ -9704,6 +9795,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();
@@ -9712,15 +9804,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;
@@ -9734,7 +9826,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('');
@@ -9865,7 +9957,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,
@@ -9919,20 +10011,167 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		theme: themeForRust
 	});
 }
+const SSG_STYLE_BLOCK_RE = /[ \t]*<!-- ox-content:styles:start -->\s*<style>([\s\S]*?)<\/style>\s*<!-- ox-content:styles:end -->/;
+const SSG_SCRIPT_BLOCK_RE = /[ \t]*<!-- ox-content:scripts:start -->\s*<script>([\s\S]*?)<\/script>\s*<!-- ox-content:scripts:end -->/;
+const FIRST_INLINE_STYLE_RE = /[ \t]*<style>([\s\S]*?)<\/style>/;
+const LAST_INLINE_BODY_SCRIPT_RE = /[ \t]*<script>([\s\S]*?)<\/script>\s*<\/body>/;
+const CSS_SECTION_RE = /\/\* ox-content:css:([a-z0-9-]+):start \*\/\s*([\s\S]*?)\s*\/\* ox-content:css:\1:end \*\//g;
+const SEARCH_CHUNK_RE = /\/\/ ox-content:search:start\s*([\s\S]*?)\s*\/\/ ox-content:search:end/;
+const SEARCH_CHUNK_PLACEHOLDER = "__OX_CONTENT_SEARCH_CHUNK__";
+const CORE_CSS_SECTION_NAMES = new Set(["base", "footer"]);
+const THEME_INLINE_CSS_MAX_BYTES = 2048;
+function createContentHash(content) {
+	return createHash("sha256").update(content).digest("hex").slice(0, 10);
+}
+function sanitizeChunkLabel(label) {
+	return label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "asset";
+}
+function toPublicAssetPath(base, fileName) {
+	return `${base.endsWith("/") ? base : `${base}/`}assets/${fileName}`;
+}
+function hasRelativeCssUrls(css) {
+	let cursor = 0;
+	while (cursor < css.length) {
+		const urlIndex = css.indexOf("url(", cursor);
+		if (urlIndex === -1) return false;
+		let valueStart = urlIndex + 4;
+		while (valueStart < css.length && /\s/.test(css[valueStart])) valueStart++;
+		const quote = css[valueStart] === "\"" || css[valueStart] === "'" ? css[valueStart] : "";
+		if (quote) valueStart++;
+		let valueEnd = valueStart;
+		while (valueEnd < css.length) {
+			const char = css[valueEnd];
+			if (quote) {
+				if (char === "\\") {
+					valueEnd += 2;
+					continue;
+				}
+				if (char === quote) break;
+			} else if (char === ")") break;
+			valueEnd++;
+		}
+		const value = css.slice(valueStart, valueEnd).trim();
+		if (value && !value.startsWith("data:") && !value.startsWith("http:") && !value.startsWith("https:") && !value.startsWith("//") && !value.startsWith("/") && !value.startsWith("#") && !value.startsWith("blob:") && !value.startsWith("var(")) return true;
+		cursor = valueEnd + 1;
+	}
+	return false;
+}
+function createSharedAssetChunk(type, label, content, outDir, base) {
+	const hash = createContentHash(content);
+	const fileName = `ox-content-${sanitizeChunkLabel(label)}-${hash}.${type}`;
+	return {
+		outputPath: path$1.join(outDir, "assets", fileName),
+		publicPath: toPublicAssetPath(base, fileName),
+		content
+	};
+}
+function extractCssSections(cssContent) {
+	return Array.from(cssContent.matchAll(CSS_SECTION_RE)).map(([, name, content]) => ({
+		name,
+		content: content.trim()
+	})).filter((section) => section.content.length > 0);
+}
+function getOrCreateSharedChunk(chunks, type, label, content, outDir, base) {
+	let chunk = chunks.get(content);
+	if (!chunk) {
+		chunk = createSharedAssetChunk(type, label, content, outDir, base);
+		chunks.set(content, chunk);
+	}
+	return chunk;
+}
+function buildStyleReplacement(cssContent, cssChunks, outDir, base) {
+	const sections = extractCssSections(cssContent);
+	const effectiveSections = sections.length > 0 ? sections : [{
+		name: "css",
+		content: cssContent.trim()
+	}];
+	const coreContent = effectiveSections.filter((section) => CORE_CSS_SECTION_NAMES.has(section.name)).map((section) => section.content).join("\n").trim();
+	const fragments = [];
+	if (coreContent) {
+		const coreChunk = getOrCreateSharedChunk(cssChunks, "css", "core", coreContent, outDir, base);
+		fragments.push(`  <link rel="stylesheet" href="${coreChunk.publicPath}">`);
+	}
+	for (const section of effectiveSections) {
+		if (CORE_CSS_SECTION_NAMES.has(section.name)) continue;
+		if (section.name === "theme" && (hasRelativeCssUrls(section.content) || section.content.length <= THEME_INLINE_CSS_MAX_BYTES) || hasRelativeCssUrls(section.content)) {
+			fragments.push(`  <style>${section.content}</style>`);
+			continue;
+		}
+		const chunk = getOrCreateSharedChunk(cssChunks, "css", section.name, section.content, outDir, base);
+		fragments.push(`  <link rel="stylesheet" href="${chunk.publicPath}">`);
+	}
+	return fragments.join("\n");
+}
+function buildScriptReplacement(jsContent, jsChunks, outDir, base) {
+	const searchMatch = jsContent.match(SEARCH_CHUNK_RE);
+	if (searchMatch && jsContent.includes(SEARCH_CHUNK_PLACEHOLDER)) {
+		const searchContent = searchMatch[1].trim();
+		if (searchContent) {
+			const searchChunk = getOrCreateSharedChunk(jsChunks, "js", "search", searchContent, outDir, base);
+			const coreContent = jsContent.replace(SEARCH_CHUNK_RE, "").replaceAll(SEARCH_CHUNK_PLACEHOLDER, searchChunk.publicPath).trim();
+			if (coreContent) return `  <script defer src="${getOrCreateSharedChunk(jsChunks, "js", "core", coreContent, outDir, base).publicPath}"><\/script>`;
+		}
+	}
+	const fallbackContent = jsContent.trim();
+	if (!fallbackContent) return "";
+	return `  <script defer src="${getOrCreateSharedChunk(jsChunks, "js", "js", fallbackContent, outDir, base).publicPath}"><\/script>`;
+}
+async function externalizeSharedPageAssets(pages, outDir, base) {
+	const cssChunks = /* @__PURE__ */ new Map();
+	const jsChunks = /* @__PURE__ */ new Map();
+	const optimizedPages = pages.map((page) => {
+		let html = page.html;
+		const styleMatch = html.match(SSG_STYLE_BLOCK_RE);
+		if (styleMatch) {
+			const replacement = buildStyleReplacement(styleMatch[1], cssChunks, outDir, base);
+			html = html.replace(SSG_STYLE_BLOCK_RE, replacement);
+		} else {
+			const inlineStyleMatch = html.match(FIRST_INLINE_STYLE_RE);
+			if (inlineStyleMatch) {
+				const replacement = buildStyleReplacement(inlineStyleMatch[1], cssChunks, outDir, base);
+				html = html.replace(FIRST_INLINE_STYLE_RE, replacement);
+			}
+		}
+		const scriptMatch = html.match(SSG_SCRIPT_BLOCK_RE);
+		if (scriptMatch) {
+			const replacement = buildScriptReplacement(scriptMatch[1], jsChunks, outDir, base);
+			html = html.replace(SSG_SCRIPT_BLOCK_RE, replacement);
+		} else {
+			const inlineScriptMatch = html.match(LAST_INLINE_BODY_SCRIPT_RE);
+			if (inlineScriptMatch) {
+				const replacement = buildScriptReplacement(inlineScriptMatch[1], jsChunks, outDir, base);
+				html = html.replace(LAST_INLINE_BODY_SCRIPT_RE, replacement ? `${replacement}\n</body>` : "</body>");
+			}
+		}
+		return {
+			...page,
+			html
+		};
+	});
+	const chunks = [...cssChunks.values(), ...jsChunks.values()];
+	await Promise.all(chunks.map(async (chunk) => {
+		await fs.mkdir(path$1.dirname(chunk.outputPath), { recursive: true });
+		await fs.writeFile(chunk.outputPath, chunk.content, "utf-8");
+	}));
+	return {
+		pages: optimizedPages,
+		assets: chunks.map((chunk) => chunk.outputPath)
+	};
+}
 /**
 * 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;
 }
@@ -9948,12 +10187,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.
@@ -9971,9 +10210,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";
 	}
@@ -9989,7 +10228,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/**",
@@ -10010,7 +10249,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, []);
@@ -10059,10 +10298,11 @@ 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 = [];
 	const errors = [];
 	if (ssgOptions.clean) try {
 		await fs.rm(outDir, {
@@ -10074,7 +10314,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 {}
@@ -10176,19 +10416,27 @@ async function buildSsg(options, root) {
 			entryPage
 		}, navItems, siteName, base, pageOgImage, ssgOptions.theme);
 		const outputPath = getOutputPath(inputPath, srcDir, outDir, ssgOptions.extension);
-		await fs.mkdir(path.dirname(outputPath), { recursive: true });
-		await fs.writeFile(outputPath, html, "utf-8");
-		generatedFiles.push(outputPath);
+		generatedPages.push({
+			inputPath,
+			outputPath,
+			html
+		});
 	} catch (err) {
 		const errorMessage = err instanceof Error ? err.message : String(err);
 		errors.push(`Failed to generate HTML for ${pageResult.inputPath}: ${errorMessage}`);
 	}
+	const optimizedOutput = await externalizeSharedPageAssets(generatedPages, outDir, base);
+	generatedFiles.push(...optimizedOutput.assets);
+	for (const page of optimizedOutput.pages) {
+		await fs.mkdir(path$1.dirname(page.outputPath), { recursive: true });
+		await fs.writeFile(page.outputPath, page.html, "utf-8");
+		generatedFiles.push(page.outputPath);
+	}
 	return {
 		files: generatedFiles,
 		errors
 	};
 }
-
 //#endregion
 //#region src/search.ts
 /**
@@ -10199,7 +10447,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;
@@ -10235,7 +10483,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);
 			}
@@ -10260,7 +10508,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;
@@ -10289,7 +10537,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");
 }
@@ -10305,6 +10553,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 = [];
@@ -10372,22 +10665,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;
@@ -10408,6 +10711,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;
@@ -10430,6 +10734,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 = '';
@@ -10443,7 +10748,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;
@@ -10457,9 +10762,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;
@@ -10469,7 +10775,6 @@ export { searchOptions };
 export default { search, searchOptions, loadIndex };
 `;
 }
-
 //#endregion
 //#region src/dev-server.ts
 /**
@@ -10534,12 +10839,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;
@@ -10583,7 +10888,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 {}
@@ -10593,7 +10898,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, {
@@ -10638,7 +10943,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;
@@ -10670,7 +10975,6 @@ function createDevServerMiddleware(options, root, cache) {
 		}
 	};
 }
-
 //#endregion
 //#region src/og-viewer.ts
 /**
@@ -10704,7 +11008,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);
@@ -10744,7 +11048,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
@@ -10762,7 +11066,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,
@@ -11017,7 +11321,6 @@ function createOgViewerPlugin(options) {
 		}
 	};
 }
-
 //#endregion
 //#region src/i18n.ts
 /**
@@ -11078,13 +11381,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}`);
@@ -11100,7 +11403,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) => {
@@ -11127,7 +11430,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 = "{}";
@@ -11210,15 +11513,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 {}
@@ -11231,13 +11534,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) => {
@@ -11255,14 +11558,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
 /**
@@ -11452,7 +11754,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({
@@ -11643,7 +11944,6 @@ var currentContext;
 var init_page_context = __esmMin((() => {
 	currentContext = null;
 }));
-
 //#endregion
 //#region src/theme-renderer.ts
 /**
@@ -11801,7 +12101,6 @@ function createTheme(config) {
 		return Layout({ children });
 	};
 }
-
 //#endregion
 //#region src/index.ts
 /**
@@ -11836,8 +12135,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);
@@ -11906,7 +12205,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;
@@ -11922,7 +12221,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")) {
@@ -11959,7 +12258,7 @@ function oxContent(options = {}) {
 			const root = config?.root || process.cwd();
 			try {
 				const result = await buildSsg(resolvedOptions, root);
-				if (result.files.length > 0) console.log(`[ox-content] Generated ${result.files.length} HTML files`);
+				if (result.files.length > 0) console.log(`[ox-content] Generated ${result.files.length} output files`);
 				if (result.errors.length > 0) for (const error of result.errors) console.warn(`[ox-content] ${error}`);
 			} catch (err) {
 				console.error("[ox-content] SSG build failed:", err);
@@ -11989,7 +12288,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");
@@ -12000,10 +12299,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);
 				}
@@ -12031,6 +12330,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,
@@ -12044,6 +12344,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.
 */
@@ -12061,7 +12381,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