@pubinfo/devtools 2.1.11 → 2.1.12

package/dist/client/assets/{server-router-DB9k7gY9.js → server-router-BkLhbRZZ.js}

@@ -1,17 +1,23 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["./javascript-QnJdw8u5.js","./javascript-_FvKZjd1.js","./typescript-C5tShSk5.js","./typescript-BEfC8S_c.js","./vue-DZSPIjN6.js","./css-DbgpCiOq.js","./html-Tu6OX5Eq.js","./json-CzPoZe0r.js","./json-WgRhEAOB.js","./html-74krLQbR.js","./css-D-vtiAqw.js"])))=>i.map(i=>d[i]);
-import { $ as toRef, A as provide, B as withCtx, C as inject, D as onBeforeUnmount, E as nextTick, F as resolveDynamicComponent, G as isRef, L as useSlots, M as renderSlot, N as resolveComponent, O as onMounted, P as resolveDirective, R as watch, S as h, T as mergeProps, V as withDirectives, Y as ref, Z as shallowRef, b as defineComponent, d as KeepAlive, f as computed, g as createElementBlock, h as createCommentVNode, i as vModelCheckbox, it as toDisplayString, j as renderList, k as openBlock, l as withKeys, m as createBlock, nt as normalizeClass, p as createBaseVNode, q as reactive, r as Transition, rt as normalizeStyle, s as vModelSelect, t as __vitePreload, tt as unref, u as Fragment, v as createTextVNode, x as getCurrentInstance, y as createVNode, z as watchEffect } from "./index-BysXje24.js";
-import { a as Icon_default, i as SectionBlock_default, n as TextInput_default, r as Button_default, t as Navbar_default } from "./Navbar-CvJ_8xbf.js";
-import { c as onClickOutside, d as useLocalStorage, f as useVModel, m as createSharedComposable, o as Badge_default, s as createReusableTemplate, t as apiListFetch, u as useElementSize } from "./fetch-ZAeX5On9.js";
-import { t as _plugin_vue_export_helper_default } from "./_plugin-vue_export-helper-D8E0syuh.js";
-import { t as PanelGrids_default } from "./PanelGrids-DM2bwqw6.js";
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["./javascript-yBXmlTMV.js","./javascript-D9OtNJpI.js","./typescript-jte7_wp4.js","./typescript-C6a_X60d.js","./vue-BvqQiUzU.js","./css-3PrNsnPt.js","./html-B5Ny8iin.js","./json-DFv6u-UA.js","./json-CDHOIUIc.js","./html-g0uz4re7.js","./css-mRoPUXX2.js"])))=>i.map(i=>d[i]);
+import { A as renderList, B as withDirectives, C as nextTick, Ct as normalizeStyle, E as openBlock, G as isRef, I as useSlots, L as watch, M as resolveComponent, N as resolveDirective, O as provide, P as resolveDynamicComponent, Q as shallowRef, R as watchEffect, S as mergeProps, T as onMounted, Y as ref, _ as getCurrentInstance, b as inject, c as createBaseVNode, d as createElementBlock, et as toRef, g as defineComponent, h as createVNode, i as KeepAlive, j as renderSlot, l as createBlock, m as createTextVNode, nt as unref, q as reactive, r as Fragment, s as computed, u as createCommentVNode, w as onBeforeUnmount, wt as toDisplayString, xt as normalizeClass, y as h, z as withCtx } from "./runtime-core.esm-bundler-CsZVtwV7.js";
+import { i as vModelCheckbox, l as withKeys, r as Transition, s as vModelSelect, t as __vitePreload } from "./index-CWvhvxM4.js";
+import { a as Icon_default, i as SectionBlock_default, n as TextInput_default, r as Button_default, t as Navbar_default } from "./Navbar-DYyO71VR.js";
+import { c as onClickOutside, d as useLocalStorage, f as useVModel, m as createSharedComposable, o as Badge_default, s as createReusableTemplate, t as apiListFetch, u as useElementSize } from "./fetch-Bz1BNH1Z.js";
+import { t as _plugin_vue_export_helper_default } from "./_plugin-vue_export-helper-Ctigiz3_.js";
+import { t as PanelGrids_default } from "./PanelGrids-rTFcKhN6.js";
+//#region src/client/@ui/Card.vue
 var _sfc_main = {};
 var _hoisted_1$10 = { class: "n-card n-card-base" };
 function _sfc_render(_ctx, _cache) {
 	return openBlock(), createElementBlock("div", _hoisted_1$10, [renderSlot(_ctx.$slots, "default")]);
 }
 var Card_default = /* @__PURE__ */ _plugin_vue_export_helper_default(_sfc_main, [["render", _sfc_render]]);
+//#endregion
+//#region src/client/@ui/Drawer.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$9 = ["border"];
 var _hoisted_2$9 = { class: "relative h-full w-full of-auto" };
+//#endregion
+//#region src/client/@ui/Drawer.vue
 var Drawer_default = /* @__PURE__ */ defineComponent({
 	__name: "Drawer",
 	props: {
@@ -78,6 +84,8 @@ var Drawer_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region ../../node_modules/.pnpm/splitpanes@4.0.4_vue@3.5.28_typescript@5.9.3_/node_modules/splitpanes/dist/splitpanes.es.js
 var Pe = {
 	__name: "splitpanes",
 	props: {
@@ -375,7 +383,11 @@ var Pe = {
 		}, [renderSlot(r.$slots, "default")], 4));
 	}
 };
+//#endregion
+//#region src/client/@ui/SplitPane.vue?vue&type=script&setup=true&lang.ts
 var DEFAULT = 30;
+//#endregion
+//#region src/client/@ui/SplitPane.vue
 var SplitPane_default = /* @__PURE__ */ defineComponent({
 	__name: "SplitPane",
 	props: {
@@ -422,25 +434,40 @@ var SplitPane_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/composables/useShikiHighlighter.ts
 var highlighterPromise = null;
+/**
+* 获取 Shiki 高亮器实例（单例模式）
+* 支持的语言：javascript, typescript, vue, json, html, css
+* 支持的主题：vitesse-dark, vitesse-light
+*
+* 所有 shiki 相关模块均采用动态导入，避免主 bundle 体积过大
+*/
 function getShikiHighlighter() {
 	if (!highlighterPromise) highlighterPromise = (async () => {
-		const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([__vitePreload(() => import("./core-D6JqxgYq.js"), [], import.meta.url), __vitePreload(() => import("./engine-oniguruma-n-bafM3H.js"), [], import.meta.url)]);
+		const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([__vitePreload(() => import("./core-CrqZ8qrs.js"), [], import.meta.url), __vitePreload(() => import("./engine-oniguruma-C1mOz3PQ.js"), [], import.meta.url)]);
 		return createHighlighterCore({
-			themes: [__vitePreload(() => import("./vitesse-dark-Bz6RXfkV.js"), [], import.meta.url), __vitePreload(() => import("./vitesse-light-NvDlvJl2.js"), [], import.meta.url)],
+			themes: [__vitePreload(() => import("./vitesse-dark-Dd6LUkEf.js"), [], import.meta.url), __vitePreload(() => import("./vitesse-light-LEkeIfQx.js"), [], import.meta.url)],
 			langs: [
-				__vitePreload(() => import("./javascript-QnJdw8u5.js"), __vite__mapDeps([0,1]), import.meta.url),
-				__vitePreload(() => import("./typescript-C5tShSk5.js"), __vite__mapDeps([2,3]), import.meta.url),
-				__vitePreload(() => import("./vue-DZSPIjN6.js"), __vite__mapDeps([4,5,6,1,7,3]), import.meta.url),
-				__vitePreload(() => import("./json-WgRhEAOB.js"), __vite__mapDeps([8,7]), import.meta.url),
-				__vitePreload(() => import("./html-74krLQbR.js"), __vite__mapDeps([9,6,5,1]), import.meta.url),
-				__vitePreload(() => import("./css-D-vtiAqw.js"), __vite__mapDeps([10,5]), import.meta.url)
+				__vitePreload(() => import("./javascript-yBXmlTMV.js"), __vite__mapDeps([0,1]), import.meta.url),
+				__vitePreload(() => import("./typescript-jte7_wp4.js"), __vite__mapDeps([2,3]), import.meta.url),
+				__vitePreload(() => import("./vue-BvqQiUzU.js"), __vite__mapDeps([4,5,6,1,7,3]), import.meta.url),
+				__vitePreload(() => import("./json-CDHOIUIc.js"), __vite__mapDeps([8,7]), import.meta.url),
+				__vitePreload(() => import("./html-g0uz4re7.js"), __vite__mapDeps([9,6,5,1]), import.meta.url),
+				__vitePreload(() => import("./css-mRoPUXX2.js"), __vite__mapDeps([10,5]), import.meta.url)
 			],
-			engine: createOnigurumaEngine(__vitePreload(() => import("./wasm-D0Echd05.js"), [], import.meta.url))
+			engine: createOnigurumaEngine(__vitePreload(() => import("./wasm-bCjRd0-o.js"), [], import.meta.url))
 		});
 	})();
 	return highlighterPromise;
 }
+/**
+* 使用 Shiki 高亮代码
+* @param code 要高亮的代码
+* @param options 高亮选项
+* @returns 高亮后的 HTML 字符串
+*/
 async function highlightCode(code, options) {
 	const { lang, lightTheme = "vitesse-light", darkTheme = "vitesse-dark", fallbackLang = "typescript" } = options;
 	try {
@@ -458,8 +485,12 @@ async function highlightCode(code, options) {
 		return `<pre><code>${code}</code></pre>`;
 	}
 }
+//#endregion
+//#region src/client/@ui/CodeBlock.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$8 = ["innerHTML"];
 var _hoisted_2$8 = ["textContent"];
+//#endregion
+//#region src/client/@ui/CodeBlock.vue
 var CodeBlock_default = /* @__PURE__ */ defineComponent({
 	name: "CodeBlock",
 	__name: "CodeBlock",
@@ -541,9 +572,21 @@ var CodeBlock_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
-const devtoolsStorageKey = { response: "__pubinfo_devtools_raw_response__" };
+//#endregion
+//#region src/constants.ts
+/**
+* Devtools 在宿主应用/面板中的本地存储键名集合。
+*
+* - response：用于缓存最近一次请求的原始响应（含状态码/头部/数据），
+*   以便切换页面或刷新后仍能展示上一次请求结果。
+*/
+var devtoolsStorageKey = { response: "__pubinfo_devtools_raw_response__" };
+//#endregion
+//#region src/client/@ui/Loading.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$7 = { class: "n-loading n-panel-grids-center" };
 var _hoisted_2$7 = { class: "flex flex-col animate-pulse items-center text-lg" };
+//#endregion
+//#region src/client/@ui/Loading.vue
 var Loading_default = /* @__PURE__ */ defineComponent({
 	name: "Loading",
 	__name: "Loading",
@@ -553,7 +596,9 @@ var Loading_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
-const ServerRouteTabIcons = {
+//#endregion
+//#region src/client/composables/constants.ts
+var ServerRouteTabIcons = {
 	snippet: "i-ph-file-code",
 	headers: "i-ph-file-html",
 	cookies: "i-ph-cookie",
@@ -561,6 +606,8 @@ const ServerRouteTabIcons = {
 	query: "i-ph-question",
 	body: "i-ph-file-text"
 };
+//#endregion
+//#region src/client/composables/useInputDefaults.ts
 function createDefaultState() {
 	return {
 		query: [],
@@ -573,7 +620,7 @@ function toRecord(list) {
 	const formatted = Object.fromEntries(list.filter(({ active, key, value }) => active && key && value !== void 0).map(({ key, value }) => [key, value]));
 	return Object.keys(formatted).length ? formatted : void 0;
 }
-const useInputDefaults = createSharedComposable(() => {
+var useInputDefaults = createSharedComposable(() => {
 	const inputDefaults = useLocalStorage("pubinfo-devtools:input-defaults", createDefaultState(), { deep: true });
 	function getDefaults(tab) {
 		return inputDefaults.value[tab];
@@ -600,6 +647,9 @@ const useInputDefaults = createSharedComposable(() => {
 		resetToEmpty
 	};
 });
+//#endregion
+//#region src/client/composables/useServerRouteParams.ts
+/** 创建参数输入的默认状态 */
 function createDefaultParamInputs() {
 	return {
 		query: [{
@@ -622,6 +672,9 @@ function createDefaultParamInputs() {
 		}]
 	};
 }
+/**
+* 从简化的 schema.type 推断输入控件类型。
+*/
 function getInputTypeFromSchema(schemaType) {
 	switch (schemaType) {
 		case "integer":
@@ -630,10 +683,14 @@ function getInputTypeFromSchema(schemaType) {
 		default: return "string";
 	}
 }
+/** 将表单项数组转为简单的 key-value 记录，仅保留已激活的项 */
 function parseInputs(inputs = []) {
 	const formatted = Object.fromEntries(inputs.filter(({ active, key, value }) => active && key && value !== void 0).map(({ key, value }) => [key, value]));
 	return Object.entries(formatted).length ? formatted : void 0;
 }
+/**
+* 负责管理单个路由的参数输入状态（包含默认值合并、tab 切换、最终 URL 计算等）。
+*/
 function useServerRouteParams(route, options = {}) {
 	const paramInputs = ref(createDefaultParamInputs());
 	const activeTab = ref();
@@ -665,6 +722,11 @@ function useServerRouteParams(route, options = {}) {
 	function ensureActiveTab() {
 		if (!activeTab.value) activeTab.value = route.value.paramLocation === "body" ? "body" : "query";
 	}
+	/**
+	* 基于路由的 `paramSchema` 初始构建/合并参数输入列表。
+	* - 优先将 schema 中的字段置顶并标记 fromSchema
+	* - 其后追加用户自定义的输入项（不覆盖）
+	*/
 	function initializeParamsFromSchema() {
 		ensureActiveTab();
 		const properties = route.value.paramSchema?.properties;
@@ -700,9 +762,11 @@ function useServerRouteParams(route, options = {}) {
 			type: "string"
 		}];
 	}
+	/** 重置所有参数输入为默认状态 */
 	function resetParamInputs() {
 		paramInputs.value = createDefaultParamInputs();
 	}
+	/** 当路由变化时，按路由特性同步参数输入与激活的 tab */
 	function syncParamsForRoute() {
 		resetParamInputs();
 		activeTab.value = route.value.paramLocation === "body" ? "body" : "query";
@@ -723,6 +787,13 @@ function useServerRouteParams(route, options = {}) {
 		resetParamInputs
 	};
 }
+//#endregion
+//#region src/client/composables/useServerRouteRequest.ts
+/**
+* 将 HTTP 方法映射为宿主请求实例的方法名。
+*
+* 约定：宿主请求实例提供 `Get/Post/Put/Patch/Delete/Head` 等方法。
+*/
 var methodNameMap = {
 	GET: "Get",
 	POST: "Post",
@@ -818,6 +889,9 @@ async function sendRequestThroughHost(payload) {
 		}
 	});
 }
+/**
+* 尝试通过 JSON 序列化/反序列化将对象转为普通对象，避免 Proxy/循环引用等。
+*/
 function toPlainObject(payload) {
 	if (payload === void 0 || payload === null) return payload;
 	try {
@@ -826,9 +900,22 @@ function toPlainObject(payload) {
 		return payload;
 	}
 }
+/** 判断 payload 是否像 HTTP 响应对象（含 status 或 headers 字段） */
 function isHttpLike(payload) {
 	return payload && typeof payload === "object" && ("status" in payload || "headers" in payload);
 }
+/**
+* 用于在 Devtools 中对单个路由发起请求与展示响应的组合式函数。
+*
+* 功能：
+* - 通过与宿主页面的消息通道委托应用执行请求，并按路由/参数构造请求。
+* - 统一异常处理与响应快照持久化，便于刷新后查看历史结果。
+* - 提供响应的语言/内容推断（json/html/css/media/pdf/text）。
+*
+* 持久化：
+* - 默认使用 `devtoolsStorageKey.response` 存储最近一次响应，
+*   可通过 `storageKey=false` 禁用。
+*/
 function useServerRouteRequest({ route, routeMethod, parsedQuery, parsedBody, parsedHeader, cookie, storageKey = devtoolsStorageKey.response }) {
 	const fetching = ref(false);
 	const hasSentRequest = ref(false);
@@ -1043,6 +1130,13 @@ function useServerRouteRequest({ route, routeMethod, parsedQuery, parsedBody, pa
 		storedResponse
 	};
 }
+//#endregion
+//#region src/client/composables/useServerRouteSnippets.ts
+/**
+* 根据当前选中的路由和参数生成多种语言/框架的调用示例。
+*
+* 目前仅输出 TypeScript 片段，后续可按需扩展（curl、fetch、axios 等）。
+*/
 function useServerRouteSnippets({ route, routeMethod, parsedQuery, parsedBody, parsedHeader }) {
 	return computed(() => {
 		const snippets = [];
@@ -1084,6 +1178,8 @@ const { data } = await ${routeInfo.name}(${argsStr});`,
 		return snippets;
 	});
 }
+//#endregion
+//#region src/client/utils/method.ts
 var requestMethodClass = {
 	get: "n-green",
 	post: "n-blue",
@@ -1096,10 +1192,14 @@ var requestMethodClass = {
 function getRequestMethodClass(method) {
 	return requestMethodClass[method.toLowerCase()] || requestMethodClass.default;
 }
+//#endregion
+//#region src/client/components/CodeSnippets.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$6 = { class: "flex flex-col" };
 var _hoisted_2$6 = { class: "flex-1 overflow-auto relative" };
 var _hoisted_3$4 = { class: "absolute top-0 right-0 z-10" };
 var _hoisted_4$2 = ["innerHTML"];
+//#endregion
+//#region src/client/components/CodeSnippets.vue
 var CodeSnippets_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__PURE__ */ defineComponent({
 	__name: "CodeSnippets",
 	props: { codeSnippets: {} },
@@ -1158,9 +1258,13 @@ var CodeSnippets_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 		};
 	}
 }), [["__scopeId", "data-v-1703382f"]]);
+//#endregion
+//#region src/client/@ui/Checkbox.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$5 = ["checked", "disabled"];
 var _hoisted_2$5 = ["disabled"];
 var _hoisted_3$3 = { class: "n-checkbox-box n-transition n-checked:n-checkbox-box-checked peer-active:n-active-base peer-focus-visible:n-focus-base" };
+//#endregion
+//#region src/client/@ui/Checkbox.vue
 var Checkbox_default = /* @__PURE__ */ defineComponent({
 	__name: "Checkbox",
 	props: {
@@ -1194,6 +1298,8 @@ var Checkbox_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/@ui/Select.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$4 = ["disabled"];
 var _hoisted_2$4 = {
 	key: 0,
@@ -1201,6 +1307,8 @@ var _hoisted_2$4 = {
 	disabled: "",
 	hidden: ""
 };
+//#endregion
+//#region src/client/@ui/Select.vue
 var Select_default = /* @__PURE__ */ defineComponent({
 	__name: "Select",
 	props: {
@@ -1228,6 +1336,8 @@ var Select_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/components/ServerRouteInput.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$3 = { class: "flex flex-col gap-4 p-4" };
 var _hoisted_2$3 = {
 	key: 1,
@@ -1244,6 +1354,8 @@ var _hoisted_5$1 = {
 	flex: "",
 	"gap-4": ""
 };
+//#endregion
+//#region src/client/components/ServerRouteInput.vue
 var ServerRouteInput_default = /* @__PURE__ */ defineComponent({
 	__name: "ServerRouteInput",
 	props: {
@@ -1457,6 +1569,8 @@ var ServerRouteInput_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/components/ServerRouteDetail.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$2 = { class: "size-full flex flex-col" };
 var _hoisted_2$2 = { class: "n-bg-base flex-none p4 flex flex-col gap-2" };
 var _hoisted_3$1 = { class: "flex gap-2 items-center" };
@@ -1483,6 +1597,8 @@ var _hoisted_14 = {
 	key: 6,
 	class: "px-4 pb-4 text-sm op50"
 };
+//#endregion
+//#region src/client/components/ServerRouteDetail.vue
 var ServerRouteDetail_default = /* @__PURE__ */ defineComponent({
 	__name: "ServerRouteDetail",
 	props: { route: {} },
@@ -1729,8 +1845,12 @@ var ServerRouteDetail_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/components/ServerRouteListItem.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$1 = { class: "min-w-0" };
 var _hoisted_2$1 = { class: "truncate" };
+//#endregion
+//#region src/client/components/ServerRouteListItem.vue
 var ServerRouteListItem_default = /* @__PURE__ */ defineComponent({
 	__name: "ServerRouteListItem",
 	props: {
@@ -1740,6 +1860,14 @@ var ServerRouteListItem_default = /* @__PURE__ */ defineComponent({
 	},
 	emits: ["select"],
 	setup(__props, { emit: __emit }) {
+		/**
+		* 左侧路由树的单个条目（既可代表文件夹，也可代表具体接口）。
+		*
+		* 行为：
+		* - collection（文件夹）点击后切换展开/收起。
+		* - route（接口）点击后触发 select 事件，通知父组件更新详情面板。
+		* - 根据 props.selected 判定是否高亮当前项。
+		*/
 		const props = __props;
 		const emit = __emit;
 		const open = ref(true);
@@ -1794,6 +1922,11 @@ var ServerRouteListItem_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
+//#region src/client/utils/api-transform.ts
+/**
+* 按源文件（controller）聚合 API，适合从“控制器”视角浏览。
+*/
 function groupRoutesByFile(apiResult) {
 	const routes = [];
 	const fileMap = /* @__PURE__ */ new Map();
@@ -1833,6 +1966,9 @@ function groupRoutesByFile(apiResult) {
 	});
 	return routes;
 }
+/**
+* 扁平化为路由清单，适合配合搜索/过滤使用。
+*/
 function flattenApiToRoutes(apiResult) {
 	const routes = [];
 	apiResult.modules.forEach((module) => {
@@ -1857,6 +1993,7 @@ function flattenApiToRoutes(apiResult) {
 	});
 	return routes;
 }
+/** 计算简单统计信息（模块数/API 数/类型数/按方法分布） */
 function calculateApiStats(apiResult) {
 	const stats = {
 		totalModules: apiResult.modules.length,
@@ -1874,6 +2011,7 @@ function calculateApiStats(apiResult) {
 	});
 	return stats;
 }
+/** 根据关键词过滤路由（支持嵌套集合） */
 function filterRoutes(routes, searchText) {
 	if (!searchText) return routes;
 	const search = searchText.toLowerCase();
@@ -1889,6 +2027,9 @@ function filterRoutes(routes, searchText) {
 		return route.route.toLowerCase().includes(search) || route.method?.toLowerCase().includes(search) || route.description?.toLowerCase().includes(search) || route.name?.toLowerCase().includes(search) ? route : null;
 	}).filter((route) => route !== null);
 }
+/**
+* 按 HTTP 方法优先级排序；集合优先于具体路由，并在同层按字典序。
+*/
 function sortRoutesByMethod(routes) {
 	const methodOrder = [
 		"GET",
@@ -1909,16 +2050,32 @@ function sortRoutesByMethod(routes) {
 		return a.route.localeCompare(b.route);
 	});
 }
+//#endregion
+//#region src/client/pages/server-router.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { class: "flex gap-1 text-sm" };
 var _hoisted_2 = {
 	key: 0,
 	class: "op50"
 };
 var _hoisted_3 = { class: "op50" };
+//#endregion
+//#region src/client/pages/server-router.vue
 var server_router_default = /* @__PURE__ */ defineComponent({
 	name: "ServerRouterPage",
 	__name: "server-router",
 	setup(__props) {
+		/**
+		* Server Router 页面
+		*
+		* 展示并调试通过 devtools 扫描得到的后端 API：
+		* - 左侧：路由树/列表（可按文件分组或扁平化展示，支持搜索与统计）。
+		* - 右侧：选中路由的详情与调试面板（参数输入、发送请求、查看响应）。
+		* - 顶部：切换视图、打开“默认值”抽屉，对常用参数进行预置。
+		*
+		* 依赖：
+		* - `apiListFetch` 负责向 `__pubinfo_devtools_api/api-list` 拉取 API 元数据。
+		* - 一系列 utils/composables 用于转换、分组、排序与统计。
+		*/
 		const search = ref("");
 		const isGrouped = ref(true);
 		const inputDefaultsDrawer = ref(false);
@@ -1930,6 +2087,7 @@ var server_router_default = /* @__PURE__ */ defineComponent({
 			"body",
 			"headers"
 		];
+		/** 首字母大写，用于标签标题显示 */
 		function toTitle(s) {
 			return s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
 		}
@@ -2046,4 +2204,5 @@ var server_router_default = /* @__PURE__ */ defineComponent({
 		};
 	}
 });
+//#endregion
 export { server_router_default as default };