openmanual 0.13.0 → 0.14.0

package/dist/components/callout.js

@@ -1,7 +1,7 @@
 "use client";
+import { cn } from "./lib/utils.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Info, KeyRound, Lightbulb, MessageCircleCheck, MessageCircleWarning, OctagonAlert, TriangleAlert } from "lucide-react";
-import { twMerge } from "tailwind-merge";
 //#region src/components/callout.tsx
 const iconClass = "size-5 -me-0.5 text-(--callout-color)";
 function resolveAlias(type) {
@@ -21,7 +21,7 @@ function Callout({ children, title, ...props }) {
 function CalloutContainer({ type: inputType = "info", icon, children, className, style, ...props }) {
 	const type = resolveAlias(inputType);
 	return /* @__PURE__ */ jsxs("div", {
-		className: twMerge("flex gap-2 my-4 rounded-xl border p-3 text-sm text-(--callout-color)", className),
+		className: cn("flex gap-2 my-4 rounded-xl border p-3 text-sm text-(--callout-color)", className),
 		style: {
 			"--callout-color": `var(--callout-${type}-text)`,
 			backgroundColor: `var(--callout-${type}-bg)`,
@@ -45,14 +45,14 @@ function CalloutContainer({ type: inputType = "info", icon, children, className,
 }
 function CalloutTitle({ children, className, ...props }) {
 	return /* @__PURE__ */ jsx("p", {
-		className: twMerge("font-medium my-0!", className),
+		className: cn("font-medium my-0!", className),
 		...props,
 		children
 	});
 }
 function CalloutDescription({ children, className, ...props }) {
 	return /* @__PURE__ */ jsx("div", {
-		className: twMerge("prose-no-margin empty:hidden", className),
+		className: cn("prose-no-margin empty:hidden", className),
 		...props,
 		children
 	});

package/dist/components/lib/utils.js

@@ -0,0 +1,8 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+//#region src/lib/utils.ts
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+//#endregion
+export { cn };

package/dist/components/mermaid.js

@@ -1,4 +1,5 @@
 "use client";
+import { cn } from "./lib/utils.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { LocateFixed, RotateCcw, X, ZoomIn, ZoomOut } from "lucide-react";
 import Panzoom from "@panzoom/panzoom";
@@ -129,7 +130,7 @@ function MermaidContent({ chart }) {
 		ref: overlayRef,
 		role: "dialog",
 		"aria-modal": dialogState !== "closed" ? "true" : void 0,
-		className: `fixed inset-0 z-50 flex items-center justify-center transition-opacity duration-200 ease-out ${dialogState === "closed" ? "pointer-events-none" : ""}`,
+		className: cn("fixed inset-0 z-50 flex items-center justify-center transition-opacity duration-200 ease-out", dialogState === "closed" && "pointer-events-none"),
 		style: {
 			backgroundColor: "var(--color-fd-background)",
 			opacity: dialogState === "closed" || dialogState === "closing" ? 0 : 1,

package/dist/components/nav-links.d.ts

@@ -0,0 +1,36 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { ComponentProps } from "react";
+
+//#region src/components/nav-links.d.ts
+/** 单个导航链接项的配置 */
+interface NavLinkItem {
+  /** 链接地址 */
+  href: string;
+  /** 显示文本 */
+  label?: string;
+  /** lucide-react 图标名称，或图片文件路径（如 /icons/foo.svg） */
+  icon?: string;
+  /** 是否在新窗口打开（默认 true） */
+  external?: boolean;
+}
+interface NavLinksProps extends Omit<ComponentProps<'nav'>, 'children'> {
+  /** 链接列表 */
+  links: NavLinkItem[];
+  /** 容器额外 className */
+  className?: string;
+}
+/**
+ * 导航链接组 — 渲染顶部横条右侧的图标/文本链接
+ *
+ * 支持三种模式：
+ * - icon + label：图标带文字
+ * - 仅 icon：仅图标按钮（带 aria-label 无障碍）
+ * - 仅 label：纯文字链接
+ */
+declare function NavLinks({
+  links,
+  className,
+  ...props
+}: NavLinksProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { NavLinkItem, NavLinks, NavLinksProps };

package/dist/components/nav-links.js

@@ -0,0 +1,82 @@
+"use client";
+import { cn } from "./lib/utils.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { DynamicIcon } from "lucide-react/dynamic.js";
+//#region src/components/nav-links.tsx
+/** 图片路径检测：判断 icon 值是否为图片文件路径 */
+function isImagePath(value) {
+	return /^\//i.test(value) || /^\.\.?\//i.test(value) || /\.(svg|png|jpe?g|gif|webp)$/i.test(value);
+}
+/**
+* 导航链接组 — 渲染顶部横条右侧的图标/文本链接
+*
+* 支持三种模式：
+* - icon + label：图标带文字
+* - 仅 icon：仅图标按钮（带 aria-label 无障碍）
+* - 仅 label：纯文字链接
+*/
+function NavLinks({ links, className = "", ...props }) {
+	if (links.length === 0) return null;
+	return /* @__PURE__ */ jsx("nav", {
+		className: cn("flex items-center gap-4", className),
+		...props,
+		children: links.map((link) => /* @__PURE__ */ jsx(NavLinkItemRender, { ...link }, link.href))
+	});
+}
+function NavLinkItemRender({ href, label, icon, external = true }) {
+	const externalAttrs = external !== false ? {
+		target: "_blank",
+		rel: "noopener noreferrer"
+	} : {};
+	const hasIcon = !!icon;
+	const hasLabel = !!label;
+	const isImage = hasIcon && isImagePath(icon);
+	if (isImage && hasLabel) return /* @__PURE__ */ jsxs("a", {
+		href,
+		...externalAttrs,
+		className: "inline-flex items-center gap-1.5 text-md text-fd-muted-foreground hover:text-fd-foreground transition-colors whitespace-nowrap",
+		children: [/* @__PURE__ */ jsx("img", {
+			src: icon,
+			alt: label,
+			className: "size-5"
+		}), label]
+	});
+	if (isImage) return /* @__PURE__ */ jsx("a", {
+		href,
+		...externalAttrs,
+		className: "inline-flex items-center justify-center text-fd-muted-foreground hover:text-fd-foreground transition-colors",
+		"aria-label": label || icon,
+		children: /* @__PURE__ */ jsx("img", {
+			src: icon,
+			alt: label || icon,
+			className: "size-5"
+		})
+	});
+	if (hasIcon && hasLabel) return /* @__PURE__ */ jsxs("a", {
+		href,
+		...externalAttrs,
+		className: "inline-flex items-center gap-1.5 text-md text-fd-muted-foreground hover:text-fd-foreground transition-colors whitespace-nowrap",
+		children: [/* @__PURE__ */ jsx(DynamicIcon, {
+			name: icon,
+			className: "size-5"
+		}), label]
+	});
+	if (hasIcon) return /* @__PURE__ */ jsx("a", {
+		href,
+		...externalAttrs,
+		className: "inline-flex items-center justify-center text-fd-muted-foreground hover:text-fd-foreground transition-colors",
+		"aria-label": icon,
+		children: /* @__PURE__ */ jsx(DynamicIcon, {
+			name: icon,
+			className: "size-5"
+		})
+	});
+	return /* @__PURE__ */ jsx("a", {
+		href,
+		...externalAttrs,
+		className: "text-md text-fd-muted-foreground hover:text-fd-foreground transition-colors whitespace-nowrap",
+		children: label
+	});
+}
+//#endregion
+export { NavLinks };

package/dist/components/page-actions.js

@@ -1,10 +1,8 @@
 "use client";
+import { cn } from "./lib/utils.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useRef, useState } from "react";
 //#region src/components/page-actions.tsx
-function cn(...classes) {
-	return classes.filter(Boolean).join(" ");
-}
 function getPageText() {
 	const article = document.querySelector("[data-content-area]") ?? document.querySelector("article");
 	return article ? article.innerText : "";

package/dist/components/provider.d.ts

@@ -3,6 +3,7 @@ import { ReactNode } from "react";
 
 //#region src/components/provider.d.ts
 interface ProviderProps {
+  /** 是否启用搜索（存在即启用，与 openmanual.json 的 search 字段语义一致） */
   searchEnabled?: boolean;
   children: ReactNode;
 }

package/dist/components/top-bar-search-trigger.d.ts

@@ -0,0 +1,12 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/top-bar-search-trigger.d.ts
+/**
+ * TopBar 中间位置的搜索触发器（Mintlify 风格）
+ *
+ * 渲染为圆角搜索输入框样式，点击后打开 SearchDialog。
+ * 仅在 search.position === 'header' 时使用。
+ */
+declare function TopBarSearchTrigger(): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { TopBarSearchTrigger };

package/dist/components/top-bar-search-trigger.js

@@ -0,0 +1,43 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Search } from "lucide-react";
+import { useI18n } from "fumadocs-ui/contexts/i18n";
+import { useSearchContext } from "fumadocs-ui/contexts/search";
+//#region src/components/top-bar-search-trigger.tsx
+/** 各语言的搜索占位符文本 */
+const PLACEHOLDERS = {
+	zh: "搜索文档...",
+	en: "Search documents...",
+	ja: "ドキュメントを検索...",
+	ko: "문서 검색..."
+};
+/**
+* TopBar 中间位置的搜索触发器（Mintlify 风格）
+*
+* 渲染为圆角搜索输入框样式，点击后打开 SearchDialog。
+* 仅在 search.position === 'header' 时使用。
+*/
+function TopBarSearchTrigger() {
+	const { setOpenSearch } = useSearchContext();
+	const { locale } = useI18n();
+	const placeholder = PLACEHOLDERS[locale ?? "zh"] ?? PLACEHOLDERS.zh;
+	return /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		onClick: () => setOpenSearch(true),
+		className: "\n        flex items-center gap-2 w-full max-w-md h-9 px-3\n        rounded-lg border border-fd-border bg-fd-muted/50\n        text-sm text-fd-muted-foreground\n        cursor-pointer transition-colors\n        hover:bg-fd-muted hover:border-fd-inputborder\n        focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-primary\n      ",
+		"aria-label": placeholder,
+		children: [
+			/* @__PURE__ */ jsx(Search, { className: "size-4 shrink-0" }),
+			/* @__PURE__ */ jsx("span", {
+				className: "flex-1 text-left truncate",
+				children: placeholder
+			}),
+			/* @__PURE__ */ jsx("kbd", {
+				className: "\n          inline-flex items-center gap-0.5 h-5 px-1.5 rounded\n          border border-fd-border bg-fd-background text-[11px] text-fd-muted-foreground\n          font-mono select-none pointer-events-none\n        ",
+				children: "⌘K"
+			})
+		]
+	});
+}
+//#endregion
+export { TopBarSearchTrigger };

package/dist/components/top-bar.d.ts

@@ -0,0 +1,31 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { ReactNode } from "react";
+
+//#region src/components/top-bar.d.ts
+interface TopBarProps {
+  /** 高度值，如 '64px' */
+  height: string;
+  /** 左侧内容（Logo 等） */
+  left?: ReactNode;
+  /** 中间内容（搜索框等） */
+  center?: ReactNode;
+  /** 右侧内容（链接等） */
+  right?: ReactNode;
+  /** 是否 sticky */
+  sticky?: boolean;
+  /** 背景色 */
+  background?: string;
+  /** 是否显示底边框 */
+  bordered?: boolean;
+}
+declare function TopBar({
+  height,
+  left,
+  center,
+  right,
+  sticky,
+  background,
+  bordered
+}: TopBarProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { TopBar, TopBarProps };

package/dist/components/top-bar.js

@@ -0,0 +1,38 @@
+"use client";
+import { cn } from "./lib/utils.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/top-bar.tsx
+function TopBar({ height, left, center, right, sticky = true, background, bordered = true }) {
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("style", { children: `:root { --fd-banner-height: ${height}; }` }), /* @__PURE__ */ jsx("div", {
+		id: "om-topbar",
+		style: {
+			height,
+			...sticky ? {
+				position: "sticky",
+				top: 0,
+				zIndex: 40
+			} : {},
+			...background ? { background } : {}
+		},
+		className: cn("w-full shrink-0 bg-fd-background text-fd-foreground", bordered && "border-b border-fd-border"),
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "flex items-center justify-between mx-auto max-w-[var(--fd-layout-width,97rem)] px-4 h-full",
+			children: [
+				/* @__PURE__ */ jsx("div", {
+					className: "flex items-center gap-3 min-w-0",
+					children: left
+				}),
+				/* @__PURE__ */ jsx("div", {
+					className: "flex items-center justify-center flex-1 min-w-0 px-4 max-md:hidden",
+					children: center
+				}),
+				/* @__PURE__ */ jsx("div", {
+					className: "flex items-center gap-4 min-w-0",
+					children: right
+				})
+			]
+		})
+	})] });
+}
+//#endregion
+export { TopBar };

package/dist/index.d.ts

@@ -24,6 +24,22 @@ declare const OpenManualConfigSchema: z.ZodObject<{
       href: z.ZodString;
     }, z.core.$strip>>>;
   }, z.core.$strip>>;
+  header: z.ZodOptional<z.ZodObject<{
+    height: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      light: z.ZodString;
+      dark: z.ZodString;
+    }, z.core.$strip>]>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodString>;
+      href: z.ZodString;
+      external: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+    sticky: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    background: z.ZodOptional<z.ZodString>;
+    bordered: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, z.core.$strip>>;
   footer: z.ZodOptional<z.ZodObject<{
     text: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
@@ -42,7 +58,10 @@ declare const OpenManualConfigSchema: z.ZodObject<{
     darkMode: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
   search: z.ZodOptional<z.ZodObject<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
+    position: z.ZodOptional<z.ZodEnum<{
+      sidebar: "sidebar";
+      header: "header";
+    }>>;
   }, z.core.$strip>>;
   mdx: z.ZodOptional<z.ZodObject<{
     latex: z.ZodOptional<z.ZodBoolean>;
@@ -62,6 +81,20 @@ declare const OpenManualConfigSchema: z.ZodObject<{
       dir: "dir";
     }>>;
   }, z.core.$strip>>;
+  openapi: z.ZodOptional<z.ZodObject<{
+    specPath: z.ZodOptional<z.ZodString>;
+    specs: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      group: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>]>>;
+    label: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      tag: "tag";
+      route: "route";
+      none: "none";
+    }>>>;
+    separateTab: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type OpenManualConfig = z.infer<typeof OpenManualConfigSchema>;
 //#endregion

package/dist/index.js

@@ -32,7 +32,7 @@ const ThemeSchema = z.object({
 	primaryHue: z.number().min(0).max(360).optional(),
 	darkMode: z.boolean().optional()
 });
-const SearchSchema = z.object({ enabled: z.boolean().optional() });
+const SearchSchema = z.object({ position: z.enum(["sidebar", "header"]).optional() });
 const MdxSchema = z.object({ latex: z.boolean().optional() });
 const PageActionsSchema = z.object({ enabled: z.boolean().optional() });
 const I18nLocaleSchema = z.object({
@@ -45,6 +45,40 @@ const I18nConfigSchema = z.object({
 	languages: z.array(I18nLocaleSchema).optional(),
 	parser: z.enum(["dot", "dir"]).optional()
 });
+const OpenApiSpecSchema = z.object({
+	path: z.string(),
+	group: z.string().optional()
+});
+const OpenApiSchema = z.object({
+	specPath: z.string().optional(),
+	specs: z.union([z.string(), z.array(OpenApiSpecSchema)]).optional(),
+	label: z.string().optional(),
+	groupBy: z.enum([
+		"tag",
+		"route",
+		"none"
+	]).optional().default("tag"),
+	separateTab: z.boolean().optional().default(false)
+});
+/** 顶部横条链接项 */
+const TopBarLinkSchema = z.object({
+	label: z.string().optional(),
+	icon: z.string().optional(),
+	href: z.string(),
+	external: z.boolean().optional().default(true)
+}).refine((data) => data.label || data.icon, {
+	message: "至少需要提供 label 或 icon 中的一个",
+	path: ["label"]
+});
+/** 顶部横条配置 */
+const TopBarSchema = z.object({
+	height: z.string().optional(),
+	logo: LogoSchema.optional(),
+	links: z.array(TopBarLinkSchema).optional(),
+	sticky: z.boolean().optional().default(true),
+	background: z.string().optional(),
+	bordered: z.boolean().optional().default(true)
+});
 const OpenManualConfigSchema = z.object({
 	name: z.string().min(1),
 	description: z.string().optional(),
@@ -55,13 +89,15 @@ const OpenManualConfigSchema = z.object({
 	contentPolicy: z.enum(["strict", "all"]).optional(),
 	favicon: FaviconSchema.optional(),
 	navbar: NavbarSchema.optional(),
+	header: TopBarSchema.optional(),
 	footer: FooterSchema.optional(),
 	sidebar: z.array(SidebarGroupSchema).optional(),
 	theme: ThemeSchema.optional(),
 	search: SearchSchema.optional(),
 	mdx: MdxSchema.optional(),
 	pageActions: PageActionsSchema.optional(),
-	i18n: I18nConfigSchema.optional()
+	i18n: I18nConfigSchema.optional(),
+	openapi: OpenApiSchema.optional()
 });
 
 //#endregion
@@ -76,7 +112,6 @@ const DEFAULT_CONFIG = {
 		primaryHue: 213,
 		darkMode: true
 	},
-	search: { enabled: true },
 	mdx: {},
 	pageActions: { enabled: true }
 };
@@ -122,10 +157,7 @@ function mergeDefaults(config) {
 			...DEFAULT_CONFIG.theme,
 			...config.theme
 		},
-		search: {
-			...DEFAULT_CONFIG.search,
-			...config.search
-		},
+		search: config.search ? { position: config.search.position ?? "sidebar" } : void 0,
 		mdx: {
 			...DEFAULT_CONFIG.mdx,
 			...config.mdx
@@ -139,6 +171,13 @@ function mergeDefaults(config) {
 			defaultLanguage: config.i18n.defaultLanguage ?? config.locale ?? "zh",
 			languages: config.i18n.languages ?? [],
 			parser: config.i18n.parser ?? "dot"
+		} : void 0,
+		openapi: config.openapi ? {
+			specPath: config.openapi.specPath,
+			specs: config.openapi.specs,
+			label: config.openapi.label ?? "接口文档",
+			groupBy: config.openapi.groupBy ?? "tag",
+			separateTab: config.openapi.separateTab ?? false
 		} : void 0
 	};
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/core/config/schema.ts","../src/core/config/loader.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const LogoSchema = z.union([z.string(), z.object({ light: z.string(), dark: z.string() })]);\n\nexport const FaviconSchema = z.string();\n\nexport const NavbarSchema = z.object({\n  logo: LogoSchema.optional(),\n  github: z.url().optional(),\n  links: z\n    .array(\n      z.object({\n        label: z.string(),\n        href: z.string(),\n      })\n    )\n    .optional(),\n});\n\nexport const FooterSchema = z.object({\n  text: z.string().optional(),\n});\n\nexport const SidebarPageSchema = z.object({\n  slug: z.string(),\n  title: z.string(),\n  icon: z.string().optional(),\n});\n\nexport const SidebarGroupSchema = z.object({\n  group: z.string(),\n  icon: z.string().optional(),\n  collapsed: z.boolean().optional(),\n  pages: z.array(SidebarPageSchema),\n});\n\nexport const ThemeSchema = z.object({\n  primaryHue: z.number().min(0).max(360).optional(),\n  darkMode: z.boolean().optional(),\n});\n\nexport const SearchSchema = z.object({\n  enabled: z.boolean().optional(),\n});\n\nexport const MdxSchema = z.object({\n  latex: z.boolean().optional(),\n});\n\nexport const PageActionsSchema = z.object({\n  enabled: z.boolean().optional(),\n});\n\nexport const I18nLocaleSchema = z.object({\n  code: z.string().min(1),\n  name: z.string().min(1),\n});\n\nexport const I18nConfigSchema = z.object({\n  enabled: z.boolean().optional(),\n  defaultLanguage: z.string().optional(),\n  languages: z.array(I18nLocaleSchema).optional(),\n  parser: z.enum(['dot', 'dir']).optional(),\n});\n\nexport const OpenManualConfigSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().optional(),\n  contentDir: z.string().optional(),\n  outputDir: z.string().optional(),\n  siteUrl: z.url().optional(),\n  locale: z.string().optional(),\n  contentPolicy: z.enum(['strict', 'all']).optional(),\n  favicon: FaviconSchema.optional(),\n  navbar: NavbarSchema.optional(),\n  footer: FooterSchema.optional(),\n  sidebar: z.array(SidebarGroupSchema).optional(),\n  theme: ThemeSchema.optional(),\n  search: SearchSchema.optional(),\n  mdx: MdxSchema.optional(),\n  pageActions: PageActionsSchema.optional(),\n  i18n: I18nConfigSchema.optional(),\n});\n\nexport type OpenManualConfig = z.infer<typeof OpenManualConfigSchema>;\nexport type NavbarConfig = z.infer<typeof NavbarSchema>;\nexport type FooterConfig = z.infer<typeof FooterSchema>;\nexport type SidebarGroup = z.infer<typeof SidebarGroupSchema>;\nexport type SidebarPage = z.infer<typeof SidebarPageSchema>;\nexport type ThemeConfig = z.infer<typeof ThemeSchema>;\nexport type LogoConfig = z.infer<typeof LogoSchema>;\nexport type FaviconConfig = z.infer<typeof FaviconSchema>;\nexport type I18nLocale = z.infer<typeof I18nLocaleSchema>;\nexport type I18nConfig = z.infer<typeof I18nConfigSchema>;\n\nexport function collectConfiguredSlugs(config: OpenManualConfig): Set<string> {\n  const slugs = new Set<string>();\n  if (config.sidebar) {\n    for (const group of config.sidebar) {\n      for (const page of group.pages) {\n        slugs.add(page.slug);\n      }\n    }\n  }\n  return slugs;\n}\n\nexport function isI18nEnabled(config: OpenManualConfig): boolean {\n  return config.i18n?.enabled === true && (config.i18n.languages?.length ?? 0) > 1;\n}\n\nexport function isDirParser(config: OpenManualConfig): boolean {\n  return config.i18n?.parser === 'dir';\n}\n","import { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { type OpenManualConfig, OpenManualConfigSchema } from './schema.js';\n\nconst DEFAULT_CONFIG: Partial<OpenManualConfig> = {\n  contentDir: 'content',\n  outputDir: 'dist',\n  locale: 'zh',\n  navbar: {},\n  footer: {},\n  theme: {\n    primaryHue: 213,\n    darkMode: true,\n  },\n  search: {\n    enabled: true,\n  },\n  mdx: {},\n  pageActions: { enabled: true },\n};\n\nexport async function loadConfig(cwd: string = process.cwd()): Promise<OpenManualConfig> {\n  const configPath = join(cwd, 'openmanual.json');\n\n  let rawJson: string;\n  try {\n    rawJson = await readFile(configPath, 'utf-8');\n  } catch {\n    throw new Error(`openmanual.json not found in ${cwd}. Please create one.`);\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(rawJson);\n  } catch {\n    throw new Error('openmanual.json is not valid JSON.');\n  }\n\n  const result = OpenManualConfigSchema.safeParse(parsed);\n  if (!result.success) {\n    const errors = result.error.issues\n      .map((i) => `  - ${i.path.join('.')}: ${i.message}`)\n      .join('\\n');\n    throw new Error(`openmanual.json validation failed:\\n${errors}`);\n  }\n\n  return mergeDefaults(result.data);\n}\n\nfunction mergeDefaults(config: OpenManualConfig): OpenManualConfig {\n  return {\n    ...config,\n    contentPolicy: config.contentPolicy ?? 'strict',\n    contentDir: config.contentDir ?? DEFAULT_CONFIG.contentDir ?? 'content',\n    outputDir: config.outputDir ?? DEFAULT_CONFIG.outputDir ?? 'dist',\n    locale: config.locale ?? DEFAULT_CONFIG.locale ?? 'zh',\n    navbar: {\n      ...DEFAULT_CONFIG.navbar,\n      ...config.navbar,\n      logo: config.navbar?.logo ?? config.name,\n    },\n    footer: {\n      ...DEFAULT_CONFIG.footer,\n      ...config.footer,\n      text: config.footer?.text ?? `MIT ${new Date().getFullYear()} © ${config.name}.`,\n    },\n    theme: {\n      ...DEFAULT_CONFIG.theme,\n      ...config.theme,\n    },\n    search: {\n      ...DEFAULT_CONFIG.search,\n      ...config.search,\n    },\n    mdx: {\n      ...DEFAULT_CONFIG.mdx,\n      ...config.mdx,\n    },\n    pageActions: {\n      ...DEFAULT_CONFIG.pageActions,\n      ...config.pageActions,\n    },\n    i18n: config.i18n\n      ? {\n          enabled: config.i18n.enabled ?? false,\n          defaultLanguage: config.i18n.defaultLanguage ?? config.locale ?? 'zh',\n          languages: config.i18n.languages ?? [],\n          parser: config.i18n.parser ?? 'dot',\n        }\n      : undefined,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/core/config/schema.ts","../src/core/config/loader.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const LogoSchema = z.union([z.string(), z.object({ light: z.string(), dark: z.string() })]);\n\nexport const FaviconSchema = z.string();\n\nexport const NavbarSchema = z.object({\n  logo: LogoSchema.optional(),\n  github: z.url().optional(),\n  links: z\n    .array(\n      z.object({\n        label: z.string(),\n        href: z.string(),\n      })\n    )\n    .optional(),\n});\n\nexport const FooterSchema = z.object({\n  text: z.string().optional(),\n});\n\n// @deprecated Use meta.json files in content directories instead\nexport const SidebarPageSchema = z.object({\n  slug: z.string(),\n  title: z.string(),\n  icon: z.string().optional(),\n});\n\n// @deprecated Use meta.json files in content directories instead\nexport const SidebarGroupSchema = z.object({\n  group: z.string(),\n  icon: z.string().optional(),\n  collapsed: z.boolean().optional(),\n  pages: z.array(SidebarPageSchema),\n});\n\nexport const ThemeSchema = z.object({\n  primaryHue: z.number().min(0).max(360).optional(),\n  darkMode: z.boolean().optional(),\n});\n\nexport const SearchSchema = z.object({\n  /**\n   * 搜索入口位置\n   * - 'sidebar': 放在侧边栏顶部（Fumadocs 风格）\n   * - 'header': 放在 header 中间（Mintlify 风格）\n   *\n   * 默认值: 'sidebar'\n   * 不配置 search 字段则不启用搜索（与 header 的「配置即启用」语义一致）\n   */\n  position: z.enum(['sidebar', 'header']).optional(),\n});\n\nexport const MdxSchema = z.object({\n  latex: z.boolean().optional(),\n});\n\nexport const PageActionsSchema = z.object({\n  enabled: z.boolean().optional(),\n});\n\nexport const I18nLocaleSchema = z.object({\n  code: z.string().min(1),\n  name: z.string().min(1),\n});\n\nexport const I18nConfigSchema = z.object({\n  enabled: z.boolean().optional(),\n  defaultLanguage: z.string().optional(),\n  languages: z.array(I18nLocaleSchema).optional(),\n  parser: z.enum(['dot', 'dir']).optional(),\n});\n\nexport const OpenApiSpecSchema = z.object({\n  /** OpenAPI 规范文件路径，相对于项目根目录 */\n  path: z.string(),\n  /** 分组标签（用于在侧边栏中显示的分组名） */\n  group: z.string().optional(),\n});\n\nexport const OpenApiSchema = z.object({\n  /**\n   * OpenAPI 规范文件路径（单个文件），相对于项目根目录。支持 .json / .yaml / .yml\n   * @deprecated 推荐使用 specs 字段\n   */\n  specPath: z.string().optional(),\n  /**\n   * OpenAPI 规范文件配置，支持字符串（单文件）或对象数组（多文件）\n   * - string: 单个 spec 文件路径\n   * - array: 多个 spec 文件配置，每个可指定 path 和 group\n   */\n  specs: z.union([z.string(), z.array(OpenApiSpecSchema)]).optional(),\n  /** 侧边栏 Tab 显示名称，默认 \"接口文档\"（仅在 separateTab: true 时生效） */\n  label: z.string().optional(),\n  /**\n   * API 端点在侧边栏中的分组策略\n   * - 'tag': 按 OpenAPI 规范中的 tags 分组（默认）\n   * - 'route': 按路由路径分组\n   * - 'none': 不分组，平铺展示\n   */\n  groupBy: z.enum(['tag', 'route', 'none']).optional().default('tag'),\n  /**\n   * 是否将 API 文档作为独立的侧边栏 Tab 展示\n   * - true: 保持旧行为，API 文档在独立 Tab 中（向后兼容）\n   * - false: 将 API 端点混合到文档导航树中（类似 Mintlify 风格） // cspell:ignore Mintlify\n   */\n  separateTab: z.boolean().optional().default(false),\n});\n\n/** 顶部横条链接项 */\nexport const TopBarLinkSchema = z\n  .object({\n    /** 链接显示文本（与 icon 至少填一个） */\n    label: z.string().optional(),\n    /** lucide-react 图标名称（如 \"Github\", \"Twitter\"，与 label 至少填一个） */\n    icon: z.string().optional(),\n    href: z.string(),\n    external: z.boolean().optional().default(true),\n  })\n  .refine((data) => data.label || data.icon, {\n    message: '至少需要提供 label 或 icon 中的一个',\n    path: ['label'],\n  });\n\n/** 顶部横条配置 */\nexport const TopBarSchema = z.object({\n  /** 高度，默认 '64px' */\n  height: z.string().optional(),\n  /** Logo 配置（独立于 navbar.logo） */\n  logo: LogoSchema.optional(),\n  /** 右侧导航链接 */\n  links: z.array(TopBarLinkSchema).optional(),\n  /** 是否显示粘性（sticky），默认 true */\n  sticky: z.boolean().optional().default(true),\n  /** 背景色（CSS 值） */\n  background: z.string().optional(),\n  /** 底部边框 */\n  bordered: z.boolean().optional().default(true),\n});\n\nexport const OpenManualConfigSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().optional(),\n  contentDir: z.string().optional(),\n  outputDir: z.string().optional(),\n  siteUrl: z.url().optional(),\n  locale: z.string().optional(),\n  contentPolicy: z.enum(['strict', 'all']).optional(),\n  favicon: FaviconSchema.optional(),\n  navbar: NavbarSchema.optional(),\n  header: TopBarSchema.optional(),\n  footer: FooterSchema.optional(),\n  // @deprecated Use meta.json files in content directories instead\n  sidebar: z.array(SidebarGroupSchema).optional(),\n  theme: ThemeSchema.optional(),\n  search: SearchSchema.optional(),\n  mdx: MdxSchema.optional(),\n  pageActions: PageActionsSchema.optional(),\n  i18n: I18nConfigSchema.optional(),\n  openapi: OpenApiSchema.optional(),\n});\n\nexport type OpenManualConfig = z.infer<typeof OpenManualConfigSchema>;\nexport type NavbarConfig = z.infer<typeof NavbarSchema>;\nexport type FooterConfig = z.infer<typeof FooterSchema>;\nexport type SidebarGroup = z.infer<typeof SidebarGroupSchema>;\nexport type SidebarPage = z.infer<typeof SidebarPageSchema>;\nexport type ThemeConfig = z.infer<typeof ThemeSchema>;\nexport type LogoConfig = z.infer<typeof LogoSchema>;\nexport type FaviconConfig = z.infer<typeof FaviconSchema>;\nexport type I18nLocale = z.infer<typeof I18nLocaleSchema>;\nexport type I18nConfig = z.infer<typeof I18nConfigSchema>;\nexport type OpenApiConfig = z.infer<typeof OpenApiSchema>;\nexport type TopBarConfig = z.infer<typeof TopBarSchema>;\nexport type TopBarLink = z.infer<typeof TopBarLinkSchema>;\n\n// @deprecated Use collectSlugsFromMeta from meta-scanner instead\nexport function collectConfiguredSlugs(config: OpenManualConfig): Set<string> {\n  const slugs = new Set<string>();\n  if (config.sidebar) {\n    console.warn(\n      '[openmanual] The \"sidebar\" field in openmanual.json is deprecated. ' +\n        'Please use meta.json files in your content directories instead.'\n    );\n    for (const group of config.sidebar) {\n      for (const page of group.pages) {\n        slugs.add(page.slug);\n      }\n    }\n  }\n  return slugs;\n}\n\nexport function isI18nEnabled(config: OpenManualConfig): boolean {\n  return config.i18n?.enabled === true && (config.i18n.languages?.length ?? 0) > 1;\n}\n\nexport function isDirParser(config: OpenManualConfig): boolean {\n  return config.i18n?.parser === 'dir';\n}\n\nexport function isOpenApiEnabled(config: OpenManualConfig): boolean {\n  if (config.openapi === undefined) return false;\n  // 检查 specs（新格式）或 specPath（旧格式，向后兼容）\n  const hasSpecs = config.openapi.specs !== undefined;\n  const hasSpecPath = typeof config.openapi?.specPath === 'string';\n  return hasSpecs || hasSpecPath;\n}\n\n/**\n * 从 OpenAPI 配置中解析出所有 spec 文件路径\n * 兼容 specs（新）和 specPath（旧）两种格式\n */\nexport function resolveOpenApiSpecPaths(config: OpenManualConfig): string[] {\n  const openApiCfg = config.openapi;\n  if (!openApiCfg) return [];\n\n  // 新格式：specs 数组或字符串\n  if (openApiCfg.specs !== undefined) {\n    if (typeof openApiCfg.specs === 'string') {\n      return [openApiCfg.specs];\n    }\n    return openApiCfg.specs.map((s) => s.path);\n  }\n\n  // 旧格式：specPath 字符串\n  if (typeof openApiCfg.specPath === 'string') {\n    return [openApiCfg.specPath];\n  }\n\n  return [];\n}\n\n/**\n * 判断是否使用独立 Tab 模式（旧行为）\n */\nexport function isSeparateTabMode(config: OpenManualConfig): boolean {\n  return config.openapi?.separateTab === true;\n}\n\n/**\n * 判断是否启用了顶部横条（配置了 header 即启用）\n */\nexport function isHeaderEnabled(config: OpenManualConfig): boolean {\n  return config.header !== undefined;\n}\n","import { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { type OpenManualConfig, OpenManualConfigSchema } from './schema.js';\n\nconst DEFAULT_CONFIG: Partial<OpenManualConfig> = {\n  contentDir: 'content',\n  outputDir: 'dist',\n  locale: 'zh',\n  navbar: {},\n  footer: {},\n  theme: {\n    primaryHue: 213,\n    darkMode: true,\n  },\n  mdx: {},\n  pageActions: { enabled: true },\n};\n\nexport async function loadConfig(cwd: string = process.cwd()): Promise<OpenManualConfig> {\n  const configPath = join(cwd, 'openmanual.json');\n\n  let rawJson: string;\n  try {\n    rawJson = await readFile(configPath, 'utf-8');\n  } catch {\n    throw new Error(`openmanual.json not found in ${cwd}. Please create one.`);\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(rawJson);\n  } catch {\n    throw new Error('openmanual.json is not valid JSON.');\n  }\n\n  const result = OpenManualConfigSchema.safeParse(parsed);\n  if (!result.success) {\n    const errors = result.error.issues\n      .map((i) => `  - ${i.path.join('.')}: ${i.message}`)\n      .join('\\n');\n    throw new Error(`openmanual.json validation failed:\\n${errors}`);\n  }\n\n  return mergeDefaults(result.data);\n}\n\nfunction mergeDefaults(config: OpenManualConfig): OpenManualConfig {\n  return {\n    ...config,\n    contentPolicy: config.contentPolicy ?? 'strict',\n    contentDir: config.contentDir ?? DEFAULT_CONFIG.contentDir ?? 'content',\n    outputDir: config.outputDir ?? DEFAULT_CONFIG.outputDir ?? 'dist',\n    locale: config.locale ?? DEFAULT_CONFIG.locale ?? 'zh',\n    navbar: {\n      ...DEFAULT_CONFIG.navbar,\n      ...config.navbar,\n      logo: config.navbar?.logo ?? config.name,\n    },\n    footer: {\n      ...DEFAULT_CONFIG.footer,\n      ...config.footer,\n      text: config.footer?.text ?? `MIT ${new Date().getFullYear()} © ${config.name}.`,\n    },\n    theme: {\n      ...DEFAULT_CONFIG.theme,\n      ...config.theme,\n    },\n    // 「配置即启用」：用户不配 search 字段则保持 undefined（不启用搜索）\n    search: config.search ? { position: config.search.position ?? 'sidebar' } : undefined,\n    mdx: {\n      ...DEFAULT_CONFIG.mdx,\n      ...config.mdx,\n    },\n    pageActions: {\n      ...DEFAULT_CONFIG.pageActions,\n      ...config.pageActions,\n    },\n    i18n: config.i18n\n      ? {\n          enabled: config.i18n.enabled ?? false,\n          defaultLanguage: config.i18n.defaultLanguage ?? config.locale ?? 'zh',\n          languages: config.i18n.languages ?? [],\n          parser: config.i18n.parser ?? 'dot',\n        }\n      : undefined,\n    openapi: config.openapi\n      ? {\n          specPath: config.openapi.specPath,\n          specs: config.openapi.specs,\n          label: config.openapi.label ?? '接口文档',\n          groupBy: config.openapi.groupBy ?? 'tag',\n          separateTab: config.openapi.separateTab ?? false,\n        }\n      : undefined,\n  };\n}\n"],"mappings":";;;;;AAEA,MAAa,aAAa,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO;CAAE,OAAO,EAAE,QAAQ;CAAE,MAAM,EAAE,QAAQ;CAAE,CAAC,CAAC,CAAC;AAElG,MAAa,gBAAgB,EAAE,QAAQ;AAEvC,MAAa,eAAe,EAAE,OAAO;CACnC,MAAM,WAAW,UAAU;CAC3B,QAAQ,EAAE,KAAK,CAAC,UAAU;CAC1B,OAAO,EACJ,MACC,EAAE,OAAO;EACP,OAAO,EAAE,QAAQ;EACjB,MAAM,EAAE,QAAQ;EACjB,CAAC,CACH,CACA,UAAU;CACd,CAAC;AAEF,MAAa,eAAe,EAAE,OAAO,EACnC,MAAM,EAAE,QAAQ,CAAC,UAAU,EAC5B,CAAC;AAGF,MAAa,oBAAoB,EAAE,OAAO;CACxC,MAAM,EAAE,QAAQ;CAChB,OAAO,EAAE,QAAQ;CACjB,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC5B,CAAC;AAGF,MAAa,qBAAqB,EAAE,OAAO;CACzC,OAAO,EAAE,QAAQ;CACjB,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC3B,WAAW,EAAE,SAAS,CAAC,UAAU;CACjC,OAAO,EAAE,MAAM,kBAAkB;CAClC,CAAC;AAEF,MAAa,cAAc,EAAE,OAAO;CAClC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU;CACjD,UAAU,EAAE,SAAS,CAAC,UAAU;CACjC,CAAC;AAEF,MAAa,eAAe,EAAE,OAAO,EASnC,UAAU,EAAE,KAAK,CAAC,WAAW,SAAS,CAAC,CAAC,UAAU,EACnD,CAAC;AAEF,MAAa,YAAY,EAAE,OAAO,EAChC,OAAO,EAAE,SAAS,CAAC,UAAU,EAC9B,CAAC;AAEF,MAAa,oBAAoB,EAAE,OAAO,EACxC,SAAS,EAAE,SAAS,CAAC,UAAU,EAChC,CAAC;AAEF,MAAa,mBAAmB,EAAE,OAAO;CACvC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,CAAC;AAEF,MAAa,mBAAmB,EAAE,OAAO;CACvC,SAAS,EAAE,SAAS,CAAC,UAAU;CAC/B,iBAAiB,EAAE,QAAQ,CAAC,UAAU;CACtC,WAAW,EAAE,MAAM,iBAAiB,CAAC,UAAU;CAC/C,QAAQ,EAAE,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,UAAU;CAC1C,CAAC;AAEF,MAAa,oBAAoB,EAAE,OAAO;CAExC,MAAM,EAAE,QAAQ;CAEhB,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC7B,CAAC;AAEF,MAAa,gBAAgB,EAAE,OAAO;CAKpC,UAAU,EAAE,QAAQ,CAAC,UAAU;CAM/B,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,kBAAkB,CAAC,CAAC,CAAC,UAAU;CAEnE,OAAO,EAAE,QAAQ,CAAC,UAAU;CAO5B,SAAS,EAAE,KAAK;EAAC;EAAO;EAAS;EAAO,CAAC,CAAC,UAAU,CAAC,QAAQ,MAAM;CAMnE,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACnD,CAAC;;AAGF,MAAa,mBAAmB,EAC7B,OAAO;CAEN,OAAO,EAAE,QAAQ,CAAC,UAAU;CAE5B,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC3B,MAAM,EAAE,QAAQ;CAChB,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC/C,CAAC,CACD,QAAQ,SAAS,KAAK,SAAS,KAAK,MAAM;CACzC,SAAS;CACT,MAAM,CAAC,QAAQ;CAChB,CAAC;;AAGJ,MAAa,eAAe,EAAE,OAAO;CAEnC,QAAQ,EAAE,QAAQ,CAAC,UAAU;CAE7B,MAAM,WAAW,UAAU;CAE3B,OAAO,EAAE,MAAM,iBAAiB,CAAC,UAAU;CAE3C,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAE5C,YAAY,EAAE,QAAQ,CAAC,UAAU;CAEjC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC/C,CAAC;AAEF,MAAa,yBAAyB,EAAE,OAAO;CAC7C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,aAAa,EAAE,QAAQ,CAAC,UAAU;CAClC,YAAY,EAAE,QAAQ,CAAC,UAAU;CACjC,WAAW,EAAE,QAAQ,CAAC,UAAU;CAChC,SAAS,EAAE,KAAK,CAAC,UAAU;CAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU;CAC7B,eAAe,EAAE,KAAK,CAAC,UAAU,MAAM,CAAC,CAAC,UAAU;CACnD,SAAS,cAAc,UAAU;CACjC,QAAQ,aAAa,UAAU;CAC/B,QAAQ,aAAa,UAAU;CAC/B,QAAQ,aAAa,UAAU;CAE/B,SAAS,EAAE,MAAM,mBAAmB,CAAC,UAAU;CAC/C,OAAO,YAAY,UAAU;CAC7B,QAAQ,aAAa,UAAU;CAC/B,KAAK,UAAU,UAAU;CACzB,aAAa,kBAAkB,UAAU;CACzC,MAAM,iBAAiB,UAAU;CACjC,SAAS,cAAc,UAAU;CAClC,CAAC;;;;AC9JF,MAAM,iBAA4C;CAChD,YAAY;CACZ,WAAW;CACX,QAAQ;CACR,QAAQ,EAAE;CACV,QAAQ,EAAE;CACV,OAAO;EACL,YAAY;EACZ,UAAU;EACX;CACD,KAAK,EAAE;CACP,aAAa,EAAE,SAAS,MAAM;CAC/B;AAED,eAAsB,WAAW,MAAc,QAAQ,KAAK,EAA6B;CACvF,MAAM,aAAa,KAAK,KAAK,kBAAkB;CAE/C,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,SAAS,YAAY,QAAQ;SACvC;AACN,QAAM,IAAI,MAAM,gCAAgC,IAAI,sBAAsB;;CAG5E,IAAI;AACJ,KAAI;AACF,WAAS,KAAK,MAAM,QAAQ;SACtB;AACN,QAAM,IAAI,MAAM,qCAAqC;;CAGvD,MAAM,SAAS,uBAAuB,UAAU,OAAO;AACvD,KAAI,CAAC,OAAO,SAAS;EACnB,MAAM,SAAS,OAAO,MAAM,OACzB,KAAK,MAAM,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,UAAU,CACnD,KAAK,KAAK;AACb,QAAM,IAAI,MAAM,uCAAuC,SAAS;;AAGlE,QAAO,cAAc,OAAO,KAAK;;AAGnC,SAAS,cAAc,QAA4C;AACjE,QAAO;EACL,GAAG;EACH,eAAe,OAAO,iBAAiB;EACvC,YAAY,OAAO,cAAc,eAAe,cAAc;EAC9D,WAAW,OAAO,aAAa,eAAe,aAAa;EAC3D,QAAQ,OAAO,UAAU,eAAe,UAAU;EAClD,QAAQ;GACN,GAAG,eAAe;GAClB,GAAG,OAAO;GACV,MAAM,OAAO,QAAQ,QAAQ,OAAO;GACrC;EACD,QAAQ;GACN,GAAG,eAAe;GAClB,GAAG,OAAO;GACV,MAAM,OAAO,QAAQ,QAAQ,wBAAO,IAAI,MAAM,EAAC,aAAa,CAAC,KAAK,OAAO,KAAK;GAC/E;EACD,OAAO;GACL,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EAED,QAAQ,OAAO,SAAS,EAAE,UAAU,OAAO,OAAO,YAAY,WAAW,GAAG;EAC5E,KAAK;GACH,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EACD,aAAa;GACX,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EACD,MAAM,OAAO,OACT;GACE,SAAS,OAAO,KAAK,WAAW;GAChC,iBAAiB,OAAO,KAAK,mBAAmB,OAAO,UAAU;GACjE,WAAW,OAAO,KAAK,aAAa,EAAE;GACtC,QAAQ,OAAO,KAAK,UAAU;GAC/B,GACD;EACJ,SAAS,OAAO,UACZ;GACE,UAAU,OAAO,QAAQ;GACzB,OAAO,OAAO,QAAQ;GACtB,OAAO,OAAO,QAAQ,SAAS;GAC/B,SAAS,OAAO,QAAQ,WAAW;GACnC,aAAa,OAAO,QAAQ,eAAe;GAC5C,GACD;EACL"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmanual",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "author": "shenjingnan <sjn.code@gmail.com>",
   "description": "AI 友好的开源文档系统框架",
   "type": "module",
@@ -53,6 +53,7 @@
   "dependencies": {
     "@panzoom/panzoom": "^4.6.2",
     "chokidar": "^5.0.0",
+    "clsx": "^2.1.1",
     "commander": "^14.0.3",
     "fast-glob": "^3.3.3",
     "fumadocs-core": "^16.7.7",

package/dist/utils/restructure-tree.d.ts

@@ -1,20 +0,0 @@
-import * as PageTree from "fumadocs-core/page-tree";
-
-//#region src/utils/restructure-tree.d.ts
-interface SidebarConfigEntry {
-  group: string;
-  icon?: string;
-  collapsed?: boolean;
-  pages: readonly {
-    slug: string;
-    icon?: string;
-  }[];
-}
-interface RestructureOptions {
-  /** 是否保留树节点原始名称（不覆盖为 sidebar 配置值）。i18n 模式下应设为 true */
-  preserveNames?: boolean;
-}
-declare function slugToUrl(slug: string): string;
-declare function restructureTree(tree: PageTree.Root, sidebarConfig: readonly SidebarConfigEntry[], iconMap?: Record<string, React.ReactNode>, options?: RestructureOptions): PageTree.Root;
-//#endregion
-export { RestructureOptions, SidebarConfigEntry, restructureTree, slugToUrl };

package/dist/utils/restructure-tree.js

@@ -1,70 +0,0 @@
-//#region src/utils/restructure-tree.ts
-function slugToUrl(slug) {
-	return slug === "index" ? "/" : `/${slug}`;
-}
-function restructureTree(tree, sidebarConfig, iconMap, options) {
-	const consumed = /* @__PURE__ */ new Set();
-	const newChildren = [];
-	const children = tree.children ?? [];
-	for (const group of sidebarConfig) if (group.pages.every((p) => !p.slug.includes("/"))) {
-		const folderChildren = [];
-		for (const page of group.pages) {
-			const url = slugToUrl(page.slug);
-			const idx = children.findIndex((c, i) => !consumed.has(i) && c.type === "page" && c.url === url);
-			if (idx >= 0) {
-				const node = children[idx];
-				if (node) folderChildren.push(page.icon && iconMap?.[page.icon] ? {
-					...node,
-					icon: iconMap[page.icon]
-				} : node);
-				consumed.add(idx);
-			}
-		}
-		if (folderChildren.length > 0) newChildren.push({
-			type: "folder",
-			name: group.group,
-			icon: group.icon && iconMap ? iconMap[group.icon] : void 0,
-			defaultOpen: !group.collapsed,
-			children: folderChildren
-		});
-	} else {
-		const dirPrefix = group.pages.find((p) => p.slug.includes("/"))?.slug.split("/")[0];
-		if (dirPrefix) {
-			const idx = children.findIndex((child, i) => !consumed.has(i) && child.type === "folder" && child.children?.some((c) => c.type === "page" && c.url?.startsWith(`/${dirPrefix}/`)));
-			if (idx >= 0) {
-				consumed.add(idx);
-				const originalFolder = children[idx];
-				const childrenWithIcons = (originalFolder.children ?? []).map((child) => {
-					if (child.type === "page") {
-						const matchedPage = group.pages.find((p) => {
-							const url = slugToUrl(p.slug);
-							return child.url === url;
-						});
-						if (matchedPage?.icon && iconMap?.[matchedPage.icon]) return {
-							...child,
-							icon: iconMap[matchedPage.icon]
-						};
-					}
-					return child;
-				});
-				newChildren.push({
-					...originalFolder,
-					...options?.preserveNames ? {} : { name: group.group },
-					icon: group.icon && iconMap ? iconMap[group.icon] : void 0,
-					defaultOpen: !group.collapsed,
-					children: childrenWithIcons
-				});
-			}
-		}
-	}
-	for (let i = 0; i < children.length; i++) if (!consumed.has(i)) {
-		const node = children[i];
-		if (node) newChildren.push(node);
-	}
-	return {
-		...tree,
-		children: newChildren
-	};
-}
-//#endregion
-export { restructureTree, slugToUrl };