@deot/docs-client 1.0.6 → 1.0.7

package/dist/index.cjs

@@ -350,7 +350,7 @@ var default_footer_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			if (!value || typeof value !== "object" || Array.isArray(value)) return value;
 			return findLanguageValue(value, lang.value) ?? findLanguageValue(value, getDefaultLanguage(config));
 		}
-		const groups = (0, vue.computed)(() => options.value ? resolveLocalized(options.value.groups) || [] : createDefaultGroups());
+		const groups = (0, vue.computed)(() => options.value ? resolveLocalized(options.value.nav) || [] : createDefaultGroups());
 		const poweredBy = (0, vue.computed)(() => {
 			const value = options.value ? resolveLocalized(options.value.poweredBy) : "default";
 			if (value === "default") return t("client.common.poweredBy");
@@ -1461,6 +1461,45 @@ var toLogicalResourceSource = (config, lang, url) => {
 	return `./${resolved.pathname.slice(root.pathname.length)}${resolved.search}${resolved.hash}`;
 };
 //#endregion
+//#region packages/client/src/utils/content.ts
+var isRendererDocument = (value) => Boolean(value && typeof value === "object" && "schemaVersion" in value);
+var isPageJsonSource = (value) => typeof value === "string" && /\.page\.json(?:$|[?#])/i.test(value);
+var isContentLocaleMap = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value) && !("schemaVersion" in value));
+var isHomeLikeContent = (content) => {
+	if (isRendererDocument(content) || isPageJsonSource(content)) return true;
+	if (!isContentLocaleMap(content)) return false;
+	return Object.values(content).some((item) => isRendererDocument(item) || isPageJsonSource(item));
+};
+var isHomeLikeRoute = (routeConfig) => {
+	if (!routeConfig || typeof routeConfig === "string" || typeof routeConfig === "function") return false;
+	return isHomeLikeContent(routeConfig.content);
+};
+var resolveLocalizedContent = (content, lang, fallbackLang) => {
+	if (content === void 0) return void 0;
+	if (!isContentLocaleMap(content)) return content;
+	return findLanguageValue(content, lang) ?? findLanguageValue(content, fallbackLang);
+};
+var resolveHomeContent = (config, lang) => {
+	const root = config.routes["/"];
+	if (!root || typeof root !== "object") return void 0;
+	return resolveLocalizedContent(root.content, lang, "en-US");
+};
+var resolveRouteContent = (content, lang, config, pathname = "") => resolveLocalizedContent(content, lang, pathname === "/" ? "en-US" : getDefaultLanguage(config));
+var writeHomeContent = (config, lang, value) => {
+	const current = config.routes["/"];
+	const route = current && typeof current === "object" ? current : {};
+	config.routes["/"] = route;
+	const content = route.content;
+	if (isContentLocaleMap(content) || content === void 0) {
+		route.content = {
+			...isContentLocaleMap(content) ? content : {},
+			[lang]: value
+		};
+		return;
+	}
+	route.content = value;
+};
+//#endregion
 //#region packages/client/src/components/renderer/markdown-props.ts
 var INDICATOR_POSITIONS = /* @__PURE__ */ new Set(["left", "right"]);
 var isPlainObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -2244,7 +2283,8 @@ var ResourcePlanner = class {
 	async resolveRouteContentIdentity(config, lang, pathname, routeMatch) {
 		if (!routeMatch) return null;
 		const route = this.createRouteShape(lang, pathname, routeMatch.params);
-		const slot = typeof routeMatch.config.content === "undefined" ? "default" : routeMatch.config.content;
+		const resolved = typeof routeMatch.config.content === "undefined" ? "default" : resolveRouteContent(routeMatch.config.content, lang, config, pathname);
+		const slot = resolved === void 0 ? null : resolved;
 		if (slot === null) return null;
 		if (slot !== "default") {
 			if (typeof slot !== "string") return null;
@@ -2286,14 +2326,6 @@ var ResourcePlanner = class {
 				params: {}
 			});
 		}
-		this.collectBuiltInHomePages(config, collector);
-	}
-	collectBuiltInHomePages(config, collector) {
-		if (Object.prototype.hasOwnProperty.call(config.routes, "/")) return;
-		for (const lang of this.getLanguages(config)) {
-			const home = config.home?.locales?.[lang] || config.home?.locales?.["en-US"];
-			if (typeof home === "string") collector.add(lang, home, "page");
-		}
 	}
 	needsSidebarDiscovery(config) {
 		return Object.entries(config.routes).some(([path, route]) => (path.includes(":") || path.includes("*")) && route && (typeof route === "function" || typeof route === "object" && (typeof route.content === "undefined" || route.content === "default") && typeof route.value !== "string"));
@@ -2408,17 +2440,6 @@ var ResourcePlanner = class {
 		await this.collectConfiguredResources(config, configured);
 		const sidebarKeys = new Set([...configured.identities.values()].filter((identity) => identity.type === "sidebar").map(resourceIdentityKey));
 		for (const lang of this.getLanguages(config)) {
-			if (!Object.prototype.hasOwnProperty.call(config.routes, "/")) {
-				const home = config.home?.locales?.[lang] || config.home?.locales?.["en-US"];
-				if (typeof home === "string") {
-					const identity = createResourceIdentity(config, lang, "page", home);
-					const key = resourceIdentityKey(identity);
-					if (!resources.has(key)) resources.set(key, {
-						identity,
-						path: `/${lang}`
-					});
-				}
-			}
 			await add(lang, "/");
 			for (const [pathname, routeConfig] of Object.entries(config.routes)) {
 				if (!routeConfig || pathname === "*") continue;
@@ -3519,29 +3540,27 @@ var SearchManager = class {
 			this.parsed.set(key, document);
 			documents.push(document);
 		}
-		if (!Object.prototype.hasOwnProperty.call(config.routes, "/")) {
-			const home = config.home?.locales?.[lang] || config.home?.locales?.["en-US"];
-			if (home && typeof home !== "string") {
-				const key = `${namespace}|${lang}|inline-home`;
-				try {
-					const parsed = await parseRendererSearch(config, JSON.stringify(home), lang);
-					documents.push({
-						key,
-						hash: "inline-home",
-						namespace,
-						lang,
-						path: `/${lang}`,
-						source: "home",
-						title: parsed.title || t("client.search.untitled"),
-						text: parsed.text,
-						sections: parsed.sections.map((section) => ({
-							title: section.title,
-							anchor: section.anchor,
-							text: section.text
-						}))
-					});
-				} catch {}
-			}
+		const home = resolveHomeContent(config, lang);
+		if (isRendererDocument(home)) {
+			const key = `${namespace}|${lang}|inline-home`;
+			try {
+				const parsed = await parseRendererSearch(config, JSON.stringify(home), lang);
+				documents.push({
+					key,
+					hash: "inline-home",
+					namespace,
+					lang,
+					path: `/${lang}`,
+					source: "home",
+					title: parsed.title || t("client.search.untitled"),
+					text: parsed.text,
+					sections: parsed.sections.map((section) => ({
+						title: section.title,
+						anchor: section.anchor,
+						text: section.text
+					}))
+				});
+			} catch {}
 		}
 		this.documents.set(`${namespace}|${lang}`, documents);
 		return documents.length;
@@ -3641,27 +3660,27 @@ var _hoisted_9$3 = {
 	key: 1,
 	class: "docs-search__state docs-search__state--error"
 };
-var _hoisted_10$2 = { class: "docs-search__group-title" };
-var _hoisted_11$2 = [
+var _hoisted_10$3 = { class: "docs-search__group-title" };
+var _hoisted_11$3 = [
 	"data-search-index",
 	"onMouseenter",
 	"onClick"
 ];
-var _hoisted_12$2 = {
+var _hoisted_12$3 = {
 	class: "docs-search__result-icon",
 	"aria-hidden": "true"
 };
-var _hoisted_13$1 = { class: "docs-search__result-content" };
-var _hoisted_14 = { class: "docs-search__result-title" };
-var _hoisted_15 = {
+var _hoisted_13$2 = { class: "docs-search__result-content" };
+var _hoisted_14$1 = { class: "docs-search__result-title" };
+var _hoisted_15$1 = {
 	key: 0,
 	class: "docs-search__result-parent"
 };
-var _hoisted_16 = {
+var _hoisted_16$1 = {
 	key: 1,
 	class: "docs-search__result-excerpt"
 };
-var _hoisted_17 = {
+var _hoisted_17$1 = {
 	key: 0,
 	class: "docs-search__enter",
 	"aria-hidden": "true"
@@ -3927,7 +3946,7 @@ var search_default = /* @__PURE__ */ (0, vue.defineComponent)({
 					"wrapper-style": "overflow-x: hidden;"
 				}, {
 					default: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("div", _hoisted_7$3, [loading.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_8$3, (0, vue.toDisplayString)((0, vue.unref)(t)("client.search.searching")), 1)) : error.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_9$3, (0, vue.toDisplayString)(error.value), 1)) : keyword.value.trim() ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, [
-						(0, vue.createElementVNode)("div", _hoisted_10$2, (0, vue.toDisplayString)((0, vue.unref)(t)("client.search.documentation")), 1),
+						(0, vue.createElementVNode)("div", _hoisted_10$3, (0, vue.toDisplayString)((0, vue.unref)(t)("client.search.documentation")), 1),
 						((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(results.value, (item, index) => {
 							return (0, vue.openBlock)(), (0, vue.createElementBlock)("button", {
 								key: `${item.id}:${item.kind}`,
@@ -3940,16 +3959,16 @@ var search_default = /* @__PURE__ */ (0, vue.defineComponent)({
 								onMouseenter: ($event) => handleMouseenter(index),
 								onClick: ($event) => handleSelect(item)
 							}, [
-								(0, vue.createElementVNode)("span", _hoisted_12$2, (0, vue.toDisplayString)(item.kind === "section" ? "#" : "▤"), 1),
-								(0, vue.createElementVNode)("span", _hoisted_13$1, [(0, vue.createElementVNode)("span", _hoisted_14, [(0, vue.createVNode)(highlight_text_default, {
+								(0, vue.createElementVNode)("span", _hoisted_12$3, (0, vue.toDisplayString)(item.kind === "section" ? "#" : "▤"), 1),
+								(0, vue.createElementVNode)("span", _hoisted_13$2, [(0, vue.createElementVNode)("span", _hoisted_14$1, [(0, vue.createVNode)(highlight_text_default, {
 									text: item.sectionTitle || item.title,
 									keyword: keyword.value
-								}, null, 8, ["text", "keyword"])]), item.kind === "section" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_15, (0, vue.toDisplayString)(item.title), 1)) : item.excerpt ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_16, [(0, vue.createVNode)(highlight_text_default, {
+								}, null, 8, ["text", "keyword"])]), item.kind === "section" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_15$1, (0, vue.toDisplayString)(item.title), 1)) : item.excerpt ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_16$1, [(0, vue.createVNode)(highlight_text_default, {
 									text: item.excerpt,
 									keyword: keyword.value
 								}, null, 8, ["text", "keyword"])])) : (0, vue.createCommentVNode)("v-if", true)]),
-								index === selectedIndex.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_17, "↵")) : (0, vue.createCommentVNode)("v-if", true)
-							], 42, _hoisted_11$2);
+								index === selectedIndex.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_17$1, "↵")) : (0, vue.createCommentVNode)("v-if", true)
+							], 42, _hoisted_11$3);
 						}), 128)),
 						!results.value.length ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_18, (0, vue.toDisplayString)(preparedCount.value ? (0, vue.unref)(t)("client.search.noResults") : (0, vue.unref)(t)("client.search.noCachedDocuments")), 1)) : (0, vue.createCommentVNode)("v-if", true)
 					], 64)) : ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 3 }, [
@@ -4090,6 +4109,10 @@ var CLIENT_ICON_DEFINITIONS = {
 			"a.5.5 0 0 1-.62-.62l.84-2.873a2 2 0 0 1 .506-.852z"
 		].join("")
 	},
+	more: {
+		filled: false,
+		path: ["M4 4h6v6H4zm10 0h6v6h-6z", "M4 14h6v6H4zm10 0h6v6h-6z"].join("")
+	},
 	menu: {
 		filled: false,
 		path: "M4 7h16M4 12h16M4 17h16"
@@ -4105,6 +4128,26 @@ var CLIENT_ICON_DEFINITIONS = {
 	home: {
 		filled: false,
 		path: "M3 11 12 3l9 8M5 10v10h14V10M9 20v-6h6v6"
+	},
+	github: {
+		filled: true,
+		path: [
+			"M12.001 2c-5.525 0-10 4.475-10 10a9.99 9.99 0 0 0 6.837 9.488",
+			"c.5.087.688-.213.688-.476c0-.237-.013-1.024-.013-1.862c-2.512.463-3.162-.612",
+			"-3.362-1.175c-.113-.288-.6-1.175-1.025-1.413c-.35-.187-.85-.65-.013-.662",
+			"c.788-.013 1.35.725 1.538 1.025c.9 1.512 2.337 1.087 2.912.825",
+			"c.088-.65.35-1.087.638-1.337c-2.225-.25-4.55-1.113-4.55-4.938",
+			"c0-1.088.387-1.987 1.025-2.687c-.1-.25-.45-1.275.1-2.65c0 0 .837-.263",
+			" 2.75 1.024a9.3 9.3 0 0 1 2.5-.337c.85 0 1.7.112 2.5.337c1.913-1.3",
+			" 2.75-1.024 2.75-1.024c.55 1.375.2 2.4.1 2.65c.637.7 1.025 1.587",
+			" 1.025 2.687c0 3.838-2.337 4.688-4.562 4.938c.362.312.675.912.675 1.85",
+			"c0 1.337-.013 2.412-.013 2.75c0 .262.188.574.688.474A10.02 10.02 0 0 0 22 12",
+			"c0-5.525-4.475-10-10-10"
+		].join("")
+	},
+	repository: {
+		filled: false,
+		path: ["M4 5a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2Z", "M10 9.5 8 12l2 2.5M14 9.5 16 12l-2 2.5"].join("")
 	}
 };
 //#endregion
@@ -4119,22 +4162,34 @@ var _hoisted_2$14 = ["d"];
 //#region packages/client/src/components/icon/icon.vue
 var icon_default = /* @__PURE__ */ (0, vue.defineComponent)({
 	__name: "icon",
-	props: { name: {} },
+	props: {
+		name: {},
+		size: {}
+	},
 	setup(__props) {
 		const props = __props;
 		const definition = (0, vue.computed)(() => CLIENT_ICON_DEFINITIONS[props.name]);
+		const sizeStyle = (0, vue.computed)(() => {
+			if (props.size == null) return;
+			const value = typeof props.size === "number" ? `${props.size}px` : props.size;
+			return {
+				width: value,
+				height: value
+			};
+		});
 		return (_ctx, _cache) => {
 			return (0, vue.openBlock)(), (0, vue.createElementBlock)("svg", {
 				class: "docs-client-icon",
 				"data-icon": __props.name,
 				viewBox: "0 0 24 24",
+				style: (0, vue.normalizeStyle)(sizeStyle.value),
 				fill: definition.value.filled ? "currentColor" : "none",
 				stroke: definition.value.filled ? "none" : "currentColor",
 				"stroke-width": "1.8",
 				"stroke-linecap": "round",
 				"stroke-linejoin": "round",
 				"aria-hidden": "true"
-			}, [(0, vue.createElementVNode)("path", { d: definition.value.path }, null, 8, _hoisted_2$14)], 8, _hoisted_1$17);
+			}, [(0, vue.createElementVNode)("path", { d: definition.value.path }, null, 8, _hoisted_2$14)], 12, _hoisted_1$17);
 		};
 	}
 });
@@ -4544,17 +4599,36 @@ var _hoisted_2$13 = ["href"];
 var _hoisted_3$11 = ["src"];
 var _hoisted_4$6 = ["src"];
 var _hoisted_5$5 = { class: "docs-header__search" };
-var _hoisted_6$3 = { class: "docs-header__actions" };
-var _hoisted_7$2 = {
+var _hoisted_6$3 = ["aria-label"];
+var _hoisted_7$2 = ["aria-expanded"];
+var _hoisted_8$2 = ["href"];
+var _hoisted_9$2 = { key: 2 };
+var _hoisted_10$2 = ["href"];
+var _hoisted_11$2 = {
+	key: 3,
+	class: "docs-header__nav-item"
+};
+var _hoisted_12$2 = { class: "docs-header__actions" };
+var _hoisted_13$1 = {
 	key: 0,
 	class: "docs-header__locales"
 };
-var _hoisted_8$2 = [
+var _hoisted_14 = [
+	"title",
+	"aria-label",
+	"aria-expanded"
+];
+var _hoisted_15 = [
+	"href",
+	"title",
+	"aria-label"
+];
+var _hoisted_16 = { class: "docs-header__tools" };
+var _hoisted_17 = [
 	"title",
 	"aria-label",
 	"aria-expanded"
 ];
-var _hoisted_9$2 = ["title", "aria-label"];
 //#endregion
 //#region packages/client/src/components/layout/default-header.vue
 var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
@@ -4565,6 +4639,7 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		const config = getDocsConfig();
 		const { t } = (0, _deot_docs_locale.useLocale)();
 		const localeMenuVisible = (0, vue.ref)(false);
+		const toolsMenuVisible = (0, vue.ref)(false);
 		const lang = (0, vue.computed)(() => String(route.params.lang));
 		/**
 		* 按当前语言和站点默认语言选择 Header 配置。
@@ -4576,6 +4651,26 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			return findLanguageValue(value, lang.value) ?? findLanguageValue(value, getDefaultLanguage(config));
 		}
 		const brandOptions = config.layout?.header?.brand;
+		const navItems = (0, vue.computed)(() => resolveLocalized(config.layout?.header?.nav) || []);
+		const navMenuVisible = (0, vue.ref)({});
+		/**
+		* 判断导航地址是否对应当前路由（含前缀匹配）。
+		* @param value 配置中的跳转地址。
+		* @returns 是否为当前导航项。
+		*/
+		function isNavPathActive(value) {
+			if (!value || isExternalLink(value)) return false;
+			const target = localizePath(config, lang.value, value);
+			return route.path === target || route.path.startsWith(`${target}/`);
+		}
+		/**
+		* 顶层项或其子项命中当前路由时视为激活。
+		* @param item 一条 Header 导航。
+		* @returns 是否显示激活下划线。
+		*/
+		function isNavItemActive(item) {
+			return isNavPathActive(item.value) || Boolean(item.children?.some((child) => isNavPathActive(child.value)));
+		}
 		const brandLogo = (0, vue.computed)(() => resolveLocalized(brandOptions?.logo) || "");
 		const brandLabel = (0, vue.computed)(() => resolveLocalized(brandOptions?.label) || config.namespace || t("client.header.brand"));
 		const brandValue = (0, vue.computed)(() => resolveLocalized(brandOptions?.value) || `/${lang.value}`);
@@ -4587,6 +4682,52 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			label: item.label,
 			value
 		})));
+		/**
+		* 校验站点仓库地址，仅允许在新窗口打开的 http(s) 链接。
+		* @param value `$docs.repository` 原始值。
+		* @returns 可打开的地址；非法值返回空字符串。
+		*/
+		function resolveRepositoryHref(value) {
+			const href = value?.trim();
+			if (!href) return "";
+			try {
+				const url = new URL(href);
+				return ["http:", "https:"].includes(url.protocol) ? href : "";
+			} catch {
+				return "";
+			}
+		}
+		const repositoryHref = (0, vue.computed)(() => resolveRepositoryHref(config.repository));
+		const repositoryIcon = (0, vue.computed)(() => {
+			try {
+				const host = new URL(repositoryHref.value).hostname.toLowerCase();
+				return host === "github.com" || host.endsWith(".github.com") ? "github" : "repository";
+			} catch {
+				return "repository";
+			}
+		});
+		const toolsOptions = (0, vue.computed)(() => {
+			return [
+				{
+					value: "editor",
+					icon: "editor",
+					label: t("client.header.editor"),
+					selected: Boolean(route.meta.docsEditor)
+				},
+				{
+					value: "playgroundResource",
+					icon: "playgroundResource",
+					label: t("client.header.playgroundResource"),
+					selected: Boolean(route.meta.docsPlaygroundResource)
+				},
+				{
+					value: "database",
+					icon: "database",
+					label: t("client.header.database"),
+					selected: Boolean(route.meta.docsDatabase)
+				}
+			];
+		});
 		const localePath = (locale) => {
 			const segments = route.path.split("/").filter(Boolean);
 			segments[0] = locale;
@@ -4601,18 +4742,12 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			const target = String(locale);
 			if (target !== lang.value) router.push(localePath(target));
 		};
-		const isInlineRendererDocument = (value) => Boolean(value && typeof value === "object" && "schemaVersion" in value);
+		const isInlineRendererDocument = (value) => isRendererDocument(value);
 		const handleEditor = async () => {
 			const routeConfig = route.meta.docsRoute;
-			let source = routeConfig?.content;
+			let source = route.meta.docsHome ? resolveHomeContent(config, lang.value) : resolveRouteContent(routeConfig?.content, lang.value, config);
 			let type = route.meta.docsHome ? "home" : "";
-			if (route.meta.docsHome) {
-				const configured = config.home?.locales?.[lang.value] || config.home?.locales?.["en-US"];
-				if (typeof configured === "string") {
-					source = configured;
-					type = "page";
-				}
-			}
+			if (route.meta.docsHome && typeof source === "string") type = "page";
 			if (!route.meta.docsHome && isInlineRendererDocument(source)) {
 				stashInlineRendererDocument(route.fullPath, source);
 				await router.push({
@@ -4639,6 +4774,18 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 				}
 			});
 		};
+		const handleTools = (action) => {
+			toolsMenuVisible.value = false;
+			if (action === "editor") {
+				handleEditor();
+				return;
+			}
+			if (action === "playgroundResource") {
+				router.push(playgroundResourcePath.value);
+				return;
+			}
+			if (action === "database") router.push(databasePath.value);
+		};
 		return (_ctx, _cache) => {
 			return (0, vue.openBlock)(), (0, vue.createElementBlock)("header", _hoisted_1$15, [
 				brandExternal.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
@@ -4666,9 +4813,74 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 					_: 1
 				}, 8, ["to"])),
 				(0, vue.createElementVNode)("div", _hoisted_5$5, [(0, vue.createVNode)((0, vue.unref)(trigger_default))]),
-				(0, vue.createElementVNode)("div", _hoisted_6$3, [
+				navItems.value.length ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("nav", {
+					key: 2,
+					class: "docs-header__nav",
+					"aria-label": (0, vue.unref)(t)("client.header.nav")
+				}, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(navItems.value, (item, index) => {
+					return (0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: `${item.label}:${item.value || ""}:${index}` }, [item.children?.length ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_deot_vc.Dropdown), {
+						key: 0,
+						"model-value": Boolean(navMenuVisible.value[index]),
+						class: "docs-header__nav-dropdown",
+						"portal-class": "docs-header__nav-portal",
+						trigger: "hover",
+						placement: "bottom",
+						"onUpdate:modelValue": (visible) => navMenuVisible.value[index] = Boolean(visible)
+					}, {
+						content: (0, vue.withCtx)(() => [(0, vue.createVNode)((0, vue.unref)(_deot_vc.DropdownMenu), {
+							class: "docs-header__nav-options",
+							role: "menu",
+							"aria-label": item.label
+						}, {
+							default: (0, vue.withCtx)(() => [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(item.children, (child) => {
+								return (0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_deot_vc.DropdownItem), {
+									key: `${child.label}:${child.value || ""}`,
+									class: "docs-header__nav-option",
+									value: child.value || child.label,
+									role: "menuitem"
+								}, {
+									default: (0, vue.withCtx)(() => [child.value && (0, vue.unref)(isExternalLink)(child.value) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
+										key: 0,
+										href: child.value,
+										target: "_blank",
+										rel: "noopener noreferrer"
+									}, (0, vue.toDisplayString)(child.label), 9, _hoisted_8$2)) : child.value ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(vue_router.RouterLink), {
+										key: 1,
+										to: (0, vue.unref)(localizePath)((0, vue.unref)(config), lang.value, child.value)
+									}, {
+										default: (0, vue.withCtx)(() => [(0, vue.createTextVNode)((0, vue.toDisplayString)(child.label), 1)]),
+										_: 2
+									}, 1032, ["to"])) : ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_9$2, (0, vue.toDisplayString)(child.label), 1))]),
+									_: 2
+								}, 1032, ["value"]);
+							}), 128))]),
+							_: 2
+						}, 1032, ["aria-label"])]),
+						default: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("button", {
+							type: "button",
+							class: (0, vue.normalizeClass)(["docs-header__nav-item docs-header__nav-trigger", { "is-active": isNavItemActive(item) }]),
+							"aria-expanded": Boolean(navMenuVisible.value[index]),
+							"aria-haspopup": "menu"
+						}, (0, vue.toDisplayString)(item.label), 11, _hoisted_7$2)]),
+						_: 2
+					}, 1032, ["model-value", "onUpdate:modelValue"])) : item.value && (0, vue.unref)(isExternalLink)(item.value) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
+						key: 1,
+						class: "docs-header__nav-item",
+						href: item.value,
+						target: "_blank",
+						rel: "noopener noreferrer"
+					}, (0, vue.toDisplayString)(item.label), 9, _hoisted_10$2)) : item.value ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(vue_router.RouterLink), {
+						key: 2,
+						class: (0, vue.normalizeClass)(["docs-header__nav-item", { "is-active": isNavItemActive(item) }]),
+						to: (0, vue.unref)(localizePath)((0, vue.unref)(config), lang.value, item.value)
+					}, {
+						default: (0, vue.withCtx)(() => [(0, vue.createTextVNode)((0, vue.toDisplayString)(item.label), 1)]),
+						_: 2
+					}, 1032, ["class", "to"])) : ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_11$2, (0, vue.toDisplayString)(item.label), 1))], 64);
+				}), 128))], 8, _hoisted_6$3)) : (0, vue.createCommentVNode)("v-if", true),
+				(0, vue.createElementVNode)("div", _hoisted_12$2, [
 					(0, vue.createVNode)((0, vue.unref)(theme_toggler_default), { class: "docs-header__theme" }),
-					localeOptions.value.length > 1 ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("nav", _hoisted_7$2, [(0, vue.createVNode)((0, vue.unref)(_deot_vc.Dropdown), {
+					localeOptions.value.length > 1 ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("nav", _hoisted_13$1, [(0, vue.createVNode)((0, vue.unref)(_deot_vc.Dropdown), {
 						modelValue: localeMenuVisible.value,
 						"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => localeMenuVisible.value = $event),
 						class: "docs-header__locale-dropdown",
@@ -4708,42 +4920,68 @@ var default_header_default = /* @__PURE__ */ (0, vue.defineComponent)({
 							"aria-label": (0, vue.unref)(t)("client.header.language"),
 							"aria-expanded": localeMenuVisible.value,
 							"aria-haspopup": "menu"
-						}, [(0, vue.createVNode)((0, vue.unref)(icon_default), { name: "language" })], 8, _hoisted_8$2)]),
+						}, [(0, vue.createVNode)((0, vue.unref)(icon_default), {
+							name: "language",
+							size: 22
+						})], 8, _hoisted_14)]),
 						_: 1
 					}, 8, ["modelValue"])])) : (0, vue.createCommentVNode)("v-if", true),
-					(0, vue.createElementVNode)("button", {
-						type: "button",
-						class: "docs-header__action docs-header__editor",
-						title: (0, vue.unref)(t)("client.header.editor"),
-						"aria-label": (0, vue.unref)(t)("client.header.editor"),
-						onClick: handleEditor
-					}, [(0, vue.createVNode)((0, vue.unref)(icon_default), { name: "editor" })], 8, _hoisted_9$2),
-					(0, vue.createVNode)((0, vue.unref)(vue_router.RouterLink), {
-						class: "docs-header__action docs-header__playground-resource",
-						to: playgroundResourcePath.value,
-						title: (0, vue.unref)(t)("client.header.playgroundResource"),
-						"aria-label": (0, vue.unref)(t)("client.header.playgroundResource")
-					}, {
-						default: (0, vue.withCtx)(() => [(0, vue.createVNode)((0, vue.unref)(icon_default), { name: "playgroundResource" })]),
-						_: 1
-					}, 8, [
-						"to",
-						"title",
-						"aria-label"
-					]),
-					(0, vue.createVNode)((0, vue.unref)(vue_router.RouterLink), {
-						class: "docs-header__action docs-header__database",
-						to: databasePath.value,
-						title: (0, vue.unref)(t)("client.header.database"),
-						"aria-label": (0, vue.unref)(t)("client.header.database")
+					repositoryHref.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
+						key: 1,
+						class: "docs-header__action docs-header__repository",
+						href: repositoryHref.value,
+						target: "_blank",
+						rel: "noopener noreferrer",
+						title: (0, vue.unref)(t)("client.header.repository"),
+						"aria-label": (0, vue.unref)(t)("client.header.repository")
+					}, [(0, vue.createVNode)((0, vue.unref)(icon_default), {
+						name: repositoryIcon.value,
+						size: 24
+					}, null, 8, ["name"])], 8, _hoisted_15)) : (0, vue.createCommentVNode)("v-if", true),
+					(0, vue.createElementVNode)("nav", _hoisted_16, [(0, vue.createVNode)((0, vue.unref)(_deot_vc.Dropdown), {
+						modelValue: toolsMenuVisible.value,
+						"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => toolsMenuVisible.value = $event),
+						class: "docs-header__tools-dropdown",
+						"portal-class": "docs-header__tools-portal",
+						trigger: "hover",
+						placement: "bottom-right"
 					}, {
-						default: (0, vue.withCtx)(() => [(0, vue.createVNode)((0, vue.unref)(icon_default), { name: "database" })]),
+						content: (0, vue.withCtx)(() => [(0, vue.createVNode)((0, vue.unref)(_deot_vc.DropdownMenu), {
+							class: "docs-header__tools-options",
+							role: "menu",
+							"aria-label": (0, vue.unref)(t)("client.header.tools")
+						}, {
+							default: (0, vue.withCtx)(() => [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(toolsOptions.value, (item) => {
+								return (0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_deot_vc.DropdownItem), {
+									key: item.value,
+									class: "docs-header__tools-option",
+									value: item.value,
+									selected: item.selected,
+									role: "menuitem",
+									onClick: handleTools
+								}, {
+									default: (0, vue.withCtx)(() => [(0, vue.createVNode)((0, vue.unref)(icon_default), {
+										name: item.icon,
+										size: 16
+									}, null, 8, ["name"]), (0, vue.createTextVNode)(" " + (0, vue.toDisplayString)(item.label), 1)]),
+									_: 2
+								}, 1032, ["value", "selected"]);
+							}), 128))]),
+							_: 1
+						}, 8, ["aria-label"])]),
+						default: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("button", {
+							type: "button",
+							class: "docs-header__action docs-header__tools-trigger",
+							title: (0, vue.unref)(t)("client.header.tools"),
+							"aria-label": (0, vue.unref)(t)("client.header.tools"),
+							"aria-expanded": toolsMenuVisible.value,
+							"aria-haspopup": "menu"
+						}, [(0, vue.createVNode)((0, vue.unref)(icon_default), {
+							name: "more",
+							size: 22
+						})], 8, _hoisted_17)]),
 						_: 1
-					}, 8, [
-						"to",
-						"title",
-						"aria-label"
-					])
+					}, 8, ["modelValue"])])
 				])
 			]);
 		};
@@ -5024,6 +5262,10 @@ var resource_slot_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			const config = routeConfig.value;
 			let slot = config?.[props.name];
 			if (typeof slot === "undefined") slot = props.name === "content" ? "default" : null;
+			if (props.name === "content") {
+				slot = resolveRouteContent(slot, lang.value, docs, route.meta.docsHome ? "/" : "");
+				if (typeof slot === "undefined") slot = null;
+			}
 			if (slot === "default" && props.name === "sidebar") slot = "./sidebar.json";
 			const isBuiltin = slot === "default" && props.name !== "content";
 			const stableSlotKey = [
@@ -5355,13 +5597,13 @@ var createSortableDemo = (lang) => sortableDocument(copy(lang, "流式画布", "
 /**
 * 落地页模块链：Hero → Features → Steps → FAQ → CTA。
 * @param lang 当前文档语言。
-* @returns 可交给 Combo 或 `$docs.home` 的 V2 文档。
+* @returns 可交给 Combo 或 `routes['/'].content` 的 V2 文档。
 */
 var createLandingDemo = (lang) => sortableDocument(copy(lang, "落地页组合", "Landing composition"), [
 	sortableNode("hero", {
 		eyebrow: copy(lang, "产品首页", "Product home"),
 		title: copy(lang, "用可复用模块拼出完整落地页", "Compose a complete landing page from reusable modules"),
-		description: copy(lang, "Hero、特性、步骤、问答和行动条已经串好。把 landing 工厂赋给 `$docs.home` 或路由 `content`，再按品牌改文案。", "Hero, features, steps, FAQ and CTA are already wired. Assign the landing factory to `$docs.home` or route `content`."),
+		description: copy(lang, "Hero、特性、步骤、问答和行动条已经串好。把 landing 工厂赋给 `routes['/'].content` 或其它路由 `content`，再按品牌改文案。", "Hero, features, steps, FAQ and CTA are already wired. Assign the landing factory to `routes['/'].content` or another route `content`."),
 		align: "left",
 		accent: "#873bf4",
 		accentSecondary: "#2d8cf0",
@@ -5485,7 +5727,7 @@ var createLandingDemo = (lang) => sortableDocument(copy(lang, "落地页组合",
 		items: [
 			{
 				question: copy(lang, "能直接当首页用吗？", "Can I use this as the home page?"),
-				answer: copy(lang, "可以。把 `createRendererEditorDemoDocument('landing', lang)` 赋给 `$docs.home.locales`，或把保存后的 `.page.json` 配到 `home.locales`。", "Yes. Assign `createRendererEditorDemoDocument('landing', lang)` to `$docs.home.locales`, or point `home.locales` at the saved `.page.json`.")
+				answer: copy(lang, "可以。把 `createRendererEditorDemoDocument('landing', lang)` 赋给 `routes['/'].content`，或把保存后的 `.page.json` 配到对应语言。", "Yes. Assign `createRendererEditorDemoDocument('landing', lang)` to `routes['/'].content`, or point the matching language at the saved `.page.json`.")
 			},
 			{
 				question: copy(lang, "切换到自由布局会丢块吗？", "Will switching to a free canvas drop blocks?"),
@@ -5703,7 +5945,7 @@ var createDocsDemo = (lang) => {
 		"```",
 		"",
 		":::tip",
-		"开发模式从 Header 进入编辑器后，保存会把内联文档写成 `.page.json`，并回写 `home.locales`。",
+		"开发模式从 Header 进入编辑器后，保存会把内联文档写成 `.page.json`，并回写 `routes['/'].content`。",
 		":::",
 		"",
 		":::warning",
@@ -5736,7 +5978,7 @@ var createDocsDemo = (lang) => {
 		"```",
 		"",
 		":::tip",
-		"In development, saving from the header editor writes an inline document to `.page.json` and updates `home.locales`.",
+		"In development, saving from the header editor writes an inline document to `.page.json` and updates `routes['/'].content`.",
 		":::",
 		"",
 		":::warning",
@@ -5916,7 +6158,7 @@ var createComboDemo = (lang) => sortableDocument(copy(lang, "混合组合", "Mix
 	sortableNode("cta", {
 		eyebrow: copy(lang, "收束", "Close"),
 		title: copy(lang, "同一套模块表供给首页和内容页", "One module table for home and content pages"),
-		description: copy(lang, "把这份文档交给 `$docs.home` 或路由 `content`。需要纯落地页时打开 landing，需要纯文档块时打开 docs。", "Hand this document to `$docs.home` or a route `content`. Open landing for a pure marketing page, or docs for document blocks only."),
+		description: copy(lang, "把这份文档交给 `routes['/'].content` 或其它路由 `content`。需要纯落地页时打开 landing，需要纯文档块时打开 docs。", "Hand this document to `routes['/'].content` or another route `content`. Open landing for a pure marketing page, or docs for document blocks only."),
 		align: "center",
 		accent: "#873bf4",
 		accentSecondary: "#2d8cf0",
@@ -6157,7 +6399,7 @@ var createSelectionDemo = (lang) => {
 //#region packages/client/src/pages/renderer-editor-demos/catalog.ts
 /**
 * development 下 `/renderer-editor-demos?name=` 演示清单。
-* 工厂返回值可直接赋给 `$docs.home` 或路由 `content`。
+* 工厂返回值可直接赋给 `routes['/'].content` 或其它路由 `content`。
 */
 var RENDERER_EDITOR_DEMOS = [
 	"sortable",
@@ -7705,7 +7947,7 @@ var renderer_editor_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		let generation = 0;
 		const lang = (0, vue.computed)(() => String(route.params.lang || Object.keys(docs.locales)[0] || "en-US"));
 		const source = (0, vue.computed)(() => String(route.query.source || ""));
-		const configuredHome = () => docs.home?.locales?.[lang.value] || docs.home?.locales?.["en-US"];
+		const configuredHome = () => resolveHomeContent(docs, lang.value);
 		const hashValue = (value) => {
 			const text = JSON.stringify(value);
 			let hash = 2166136261;
@@ -7870,10 +8112,7 @@ var renderer_editor_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			if (getDocsRuntime().mode !== "development") return;
 			try {
 				const result = await saveDocument(value);
-				if (String(route.query.type || "") === "home") {
-					docs.home ||= { locales: {} };
-					docs.home.locales[lang.value] = result.source;
-				}
+				if (String(route.query.type || "") === "home") writeHomeContent(docs, lang.value, result.source);
 				handleSaved(result.source);
 				_deot_vc.Message.success(t("renderer.common.saved"));
 			} catch (reason) {
@@ -7970,8 +8209,8 @@ var home_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			loading.value = true;
 			document.value = void 0;
 			try {
-				const configured = config.home?.locales?.[lang.value] || config.home?.locales?.["en-US"];
-				if (!configured) return;
+				const configured = resolveHomeContent(config, lang.value);
+				if (!configured || configured === "default") return;
 				if (typeof configured !== "string") {
 					document.value = parseDocument(configured);
 					return;
@@ -8616,7 +8855,6 @@ var createRouteRecord = (config, path, routeConfig, options = {}) => {
 var createDocsRouter = (config, options = {}) => {
 	const defaultLanguage = getDefaultLanguage(config);
 	let currentLanguage = options.initialLanguage && hasConfiguredLanguage(config, options.initialLanguage) ? options.initialLanguage : defaultLanguage;
-	const hasConfiguredRoot = Object.prototype.hasOwnProperty.call(config.routes, "/");
 	const hasConfiguredEditorRoute = Object.keys(config.routes).some((path) => (path.startsWith("/") ? path : `/${path}`) === "/renderer-editor");
 	const hasConfiguredDemosRoute = Object.keys(config.routes).some((path) => (path.startsWith("/") ? path : `/${path}`) === "/renderer-editor-demos");
 	const isDevelopment = config.runtime?.mode === "development";
@@ -8688,26 +8926,35 @@ var createDocsRouter = (config, options = {}) => {
 		path: "/",
 		redirect: () => `/${currentLanguage}`
 	});
-	if (hasConfiguredRoot) routes.push(createRouteRecord(config, "/:lang", config.routes["/"], {
+	const rootConfig = config.routes["/"];
+	if (rootConfig !== void 0 && !isHomeLikeRoute(rootConfig)) routes.push(createRouteRecord(config, "/:lang", rootConfig, {
 		localized: true,
 		languageRoot: true
 	}));
-	else routes.push({
-		path: "/:lang",
-		component: home_default,
-		meta: {
-			docsHome: true,
-			docsLocalized: true,
-			docsLanguageRoot: true,
-			docsRoute: {
-				content: null,
-				sidebar: null,
-				header: "default",
-				footer: "default",
-				extra: null
+	else {
+		const routeObject = typeof rootConfig === "object" && rootConfig ? rootConfig : {};
+		routes.push({
+			path: "/:lang",
+			components: {
+				default: home_default,
+				extra: resource_slot_default
+			},
+			props: { extra: { name: "extra" } },
+			meta: {
+				docsHome: true,
+				docsLocalized: true,
+				docsLanguageRoot: true,
+				docsRoute: {
+					content: null,
+					sidebar: null,
+					header: "default",
+					footer: "default",
+					extra: null,
+					...routeObject
+				}
 			}
-		}
-	});
+		});
+	}
 	Object.entries(config.routes).forEach(([path, routeConfig]) => {
 		if (path === "/" || path === "*") return;
 		const normalized = path.startsWith("/") ? path : `/${path}`;
@@ -8750,6 +8997,23 @@ var createDocsRouter = (config, options = {}) => {
 var PlaygroundResource = Resource.playground;
 //#endregion
 //#region packages/client/src/index.ts
+var consumeStoredRedirect = async (router, config) => {
+	const REDIRECT_KEY = "@deot/docs:redirect";
+	let redirect;
+	try {
+		redirect = sessionStorage.getItem(REDIRECT_KEY);
+		sessionStorage.removeItem(REDIRECT_KEY);
+	} catch {
+		return;
+	}
+	if (!redirect || !redirect.startsWith("/") || redirect.startsWith("//")) return;
+	const base = new URL(getDocsDeploymentBase(config)).pathname;
+	if (redirect === `${location.pathname}${location.search}${location.hash}`) return;
+	if (base !== "/" && !redirect.startsWith(base)) return;
+	try {
+		await router.push(`/${redirect.slice(base.length)}`);
+	} catch {}
+};
 var bootstrap = async (config) => {
 	config ||= window.$docs || {
 		locales: {},
@@ -8778,6 +9042,8 @@ var bootstrap = async (config) => {
 	(async () => {
 		try {
 			await router.isReady();
+			if (disconnected) return;
+			await consumeStoredRedirect(router, config);
 			if (!disconnected) stopPrefetch = Resource.prefetch.start(config);
 		} catch {}
 	})();