@deot/docs-client 1.1.0 → 1.1.2

package/dist/index.cjs

@@ -3,11 +3,11 @@ let vue = require("vue");
 let _deot_docs_locale = require("@deot/docs-locale");
 let _deot_vc = require("@deot/vc");
 let vue_router = require("vue-router");
+let _deot_docs_markdown = require("@deot/docs-markdown");
 let _deot_helper_cache = require("@deot/helper-cache");
 let _deot_docs_theme = require("@deot/docs-theme");
 let _deot_helper_fp = require("@deot/helper-fp");
 let _deot_http = require("@deot/http");
-let _deot_docs_markdown = require("@deot/docs-markdown");
 let _deot_docs_renderer = require("@deot/docs-renderer");
 let es_module_lexer = require("es-module-lexer");
 let _deot_docs_playground = require("@deot/docs-playground");
@@ -5389,7 +5389,8 @@ var default_sidebar_default = /* @__PURE__ */ (0, vue.defineComponent)({
 	__name: "default-sidebar",
 	props: {
 		items: {},
-		nested: { type: Boolean }
+		nested: { type: Boolean },
+		depth: { default: 0 }
 	},
 	setup(__props) {
 		const route = (0, vue_router.useRoute)();
@@ -5403,7 +5404,10 @@ var default_sidebar_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		};
 		return (_ctx, _cache) => {
 			const _component_DefaultSidebar = (0, vue.resolveComponent)("DefaultSidebar", true);
-			return (0, vue.openBlock)(), (0, vue.createElementBlock)("ul", { class: (0, vue.normalizeClass)(["docs-sidebar", { "docs-sidebar--nested": __props.nested }]) }, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(__props.items, (item) => {
+			return (0, vue.openBlock)(), (0, vue.createElementBlock)("ul", {
+				class: (0, vue.normalizeClass)(["docs-sidebar", { "docs-sidebar--nested": __props.nested }]),
+				style: (0, vue.normalizeStyle)(__props.nested ? { "--docs-sidebar-depth": __props.depth } : void 0)
+			}, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(__props.items, (item) => {
 				return (0, vue.openBlock)(), (0, vue.createElementBlock)("li", {
 					key: `${item.label}:${item.value || ""}`,
 					class: "docs-sidebar__item"
@@ -5436,9 +5440,10 @@ var default_sidebar_default = /* @__PURE__ */ (0, vue.defineComponent)({
 				])), item.children?.length ? ((0, vue.openBlock)(), (0, vue.createBlock)(_component_DefaultSidebar, {
 					key: 3,
 					items: item.children,
-					nested: ""
-				}, null, 8, ["items"])) : (0, vue.createCommentVNode)("v-if", true)]);
-			}), 128))], 2);
+					nested: "",
+					depth: __props.depth + 1
+				}, null, 8, ["items", "depth"])) : (0, vue.createCommentVNode)("v-if", true)]);
+			}), 128))], 6);
 		};
 	}
 });
@@ -5609,7 +5614,13 @@ var page_footer_default = /* @__PURE__ */ (0, vue.defineComponent)({
 //#region packages/client/src/utils/outline.ts
 var markdownArticleKey = Symbol("docs-markdown-article");
 var HEADING_SELECTOR = "h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]";
-var SKIP_CLOSEST = "pre, .docs-markdown-code-preview, [data-playground][data-code], [data-playground][data-files]";
+var SKIP_CLOSEST = [
+	"pre",
+	".docs-markdown-code-preview",
+	"[data-playground][data-code]",
+	"[data-playground][data-files]",
+	".docs-markdown-tabs__panel[hidden]"
+].join(", ");
 /**
 * 去掉 markdown-it-anchor 的井号后，读取标题的可见文案。
 * @param element 当前标题节点。
@@ -5985,6 +5996,23 @@ var page_outline_default = /* @__PURE__ */ (0, vue.defineComponent)({
 	}
 });
 //#endregion
+//#region packages/client/src/utils/query.ts
+/**
+* 复制 query 并去掉指定键，用于比较「内容导航」相关的 query 是否变化。
+* @param query 当前路由 query。
+* @param keys 需要忽略的键，例如 `tab`。
+* @returns 去掉指定键后的普通对象，便于 JSON.stringify。
+*/
+var omitRouteQuery = (query, keys) => {
+	const ignored = new Set(keys);
+	const next = {};
+	Object.keys(query).forEach((key) => {
+		if (ignored.has(key)) return;
+		next[key] = query[key];
+	});
+	return next;
+};
+//#endregion
 //#region packages/client/src/components/layout/resource-slot.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$13 = [
 	"data-slot",
@@ -6344,7 +6372,7 @@ var resource_slot_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		};
 		(0, vue.watch)([
 			() => route.path,
-			() => JSON.stringify(route.query),
+			() => JSON.stringify(omitRouteQuery(route.query, ["tab"])),
 			() => props.name
 		], load, { immediate: true });
 		(0, vue.watch)(() => route.hash, (hash) => {
@@ -7560,6 +7588,7 @@ var app_default = /* @__PURE__ */ (0, vue.defineComponent)({
 	__name: "app",
 	setup(__props) {
 		const route = (0, vue_router.useRoute)();
+		const router = (0, vue_router.useRouter)();
 		const { t } = (0, _deot_docs_locale.useLocale)();
 		const mainScroller = (0, vue.ref)();
 		const mobileSidebarOpen = (0, vue.ref)(false);
@@ -7574,7 +7603,24 @@ var app_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		const handleSidebarNavigation = (event) => {
 			if (event.target?.closest("a")) closeMobileSidebar();
 		};
-		(0, vue.watch)([() => route.path, () => JSON.stringify(route.query)], async () => {
+		(0, vue.provide)(_deot_docs_markdown.markdownTabQueryKey, {
+			get: () => {
+				const value = route.query.tab;
+				return typeof value === "string" ? value : Array.isArray(value) ? String(value[0] || "") : "";
+			},
+			set: (tab) => {
+				const query = { ...route.query };
+				if (tab) query.tab = tab;
+				else delete query.tab;
+				router.replace({
+					path: route.path,
+					query,
+					hash: route.hash
+				});
+			},
+			subscribe: (listener) => (0, vue.watch)(() => route.query.tab, () => listener())
+		});
+		(0, vue.watch)([() => route.path, () => JSON.stringify(omitRouteQuery(route.query, ["tab"]))], async () => {
 			closeMobileSidebar();
 			await (0, vue.nextTick)();
 			mainScroller.value?.setScrollTop(0);
@@ -7702,8 +7748,13 @@ var connectResourceEvents = () => {
 			return;
 		}
 		const configuredLanguages = Object.keys(config.locales);
-		(event.lang ? [event.lang] : configuredLanguages.length ? configuredLanguages : [getDefaultLanguage(config)]).forEach((lang) => {
-			const identity = createResourceIdentity(config, lang, event.resourceType, event.source);
+		/**
+		* 共享目录（docs/markdown.md）若被服务端误拆成 `{ lang: 'docs', source: './markdown.md' }`，
+		* 仍还原成 Client 订阅使用的 logical source。
+		*/
+		const sharedSource = event.lang && !configuredLanguages.includes(event.lang) ? `${event.lang}/${event.source.replace(/^\.\//, "")}` : event.source;
+		(event.lang && configuredLanguages.includes(event.lang) ? [event.lang] : configuredLanguages.length ? configuredLanguages : [getDefaultLanguage(config)]).forEach((lang) => {
+			const identity = createResourceIdentity(config, lang, event.resourceType, sharedSource);
 			if (!Gateway.isSubscribed(identity) && !Gateway.isPrefetched(identity)) return;
 			revalidateSilently(identity);
 		});