openmanual 0.8.2 → 0.10.0

package/dist/components/mermaid.js

@@ -1,7 +1,9 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { LocateFixed, RotateCcw, X, ZoomIn, ZoomOut } from "lucide-react";
+import Panzoom from "@panzoom/panzoom";
 import { useTheme } from "next-themes";
-import { use, useEffect, useId, useState } from "react";
+import { use, useCallback, useEffect, useId, useRef, useState } from "react";
 //#region src/components/mermaid.tsx
 function Mermaid({ chart }) {
 	const [mounted, setMounted] = useState(false);
@@ -22,6 +24,20 @@ function cachePromise(key, setPromise) {
 function MermaidContent({ chart }) {
 	const id = useId();
 	const { resolvedTheme } = useTheme();
+	const [dialogState, setDialogState] = useState("closed");
+	const contentRef = useRef(null);
+	const overlayRef = useRef(null);
+	const prefersReducedMotion = useRef(false);
+	const pzRef = useRef(null);
+	useEffect(() => {
+		const mql = window.matchMedia("(prefers-reduced-motion: reduce)");
+		prefersReducedMotion.current = mql.matches;
+		const handler = (e) => {
+			prefersReducedMotion.current = e.matches;
+		};
+		mql.addEventListener("change", handler);
+		return () => mql.removeEventListener("change", handler);
+	}, []);
 	const mermaid = use(cachePromise("mermaid", () => import("mermaid").then((m) => m.default)));
 	mermaid.initialize({
 		startOnLoad: false,
@@ -33,12 +49,183 @@ function MermaidContent({ chart }) {
 	const { svg, bindFunctions } = use(cachePromise(`${chart}-${resolvedTheme}`, () => {
 		return mermaid.render(id, chart.replaceAll("\\n", "\n"));
 	}));
-	return /* @__PURE__ */ jsx("div", {
-		ref: (container) => {
-			if (container) bindFunctions?.(container);
+	const handleOpen = useCallback(() => {
+		if (dialogState === "opening" || dialogState === "open") return;
+		setDialogState("opening");
+	}, [dialogState]);
+	const handleClose = useCallback(() => {
+		if (dialogState === "closed" || dialogState === "closing") return;
+		setDialogState("closing");
+	}, [dialogState]);
+	useEffect(() => {
+		if (dialogState === "opening") requestAnimationFrame(() => {
+			requestAnimationFrame(() => {
+				setDialogState("open");
+			});
+		});
+	}, [dialogState]);
+	useEffect(() => {
+		if (dialogState !== "closing") return;
+		const fallbackTimer = setTimeout(() => {
+			setDialogState("closed");
+		}, 250);
+		return () => clearTimeout(fallbackTimer);
+	}, [dialogState]);
+	const handleOverlayTransitionEnd = useCallback((e) => {
+		if (e.target !== overlayRef.current) return;
+		if (dialogState === "closing") setDialogState("closed");
+	}, [dialogState]);
+	const handleReset = useCallback(() => {
+		pzRef.current?.reset();
+	}, []);
+	const handleZoomIn = useCallback(() => {
+		pzRef.current?.zoomIn();
+	}, []);
+	const handleZoomOut = useCallback(() => {
+		pzRef.current?.zoomOut();
+	}, []);
+	const handleCenter = useCallback(() => {
+		pzRef.current?.reset();
+		pzRef.current?.pan(0, 0);
+	}, []);
+	useEffect(() => {
+		if (dialogState === "closed" || !contentRef.current) return;
+		const pz = Panzoom(contentRef.current, {
+			maxScale: 5,
+			minScale: .1,
+			contain: "outside"
+		});
+		pzRef.current = pz;
+		contentRef.current.parentElement?.addEventListener("wheel", pz.zoomWithWheel);
+		return () => {
+			pz.destroy();
+			contentRef.current?.parentElement?.removeEventListener("wheel", pz.zoomWithWheel);
+		};
+	}, [dialogState]);
+	useEffect(() => {
+		if (dialogState === "closed") return;
+		const handleEscape = (e) => {
+			if (e.key === "Escape") handleClose();
+		};
+		document.addEventListener("keydown", handleEscape);
+		document.body.style.overflow = "hidden";
+		return () => {
+			document.removeEventListener("keydown", handleEscape);
+			document.body.style.overflow = "";
+		};
+	}, [dialogState, handleClose]);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("button", {
+		type: "button",
+		className: "block w-full cursor-zoom-in",
+		onClick: handleOpen,
+		children: /* @__PURE__ */ jsx("div", {
+			className: "w-full cursor-zoom-in pointer-events-none",
+			ref: (container) => {
+				if (container) bindFunctions?.(container);
+			},
+			dangerouslySetInnerHTML: { __html: svg }
+		})
+	}), /* @__PURE__ */ jsx("div", {
+		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" : ""}`,
+		style: {
+			backgroundColor: "var(--color-fd-background)",
+			opacity: dialogState === "closed" || dialogState === "closing" ? 0 : 1,
+			transitionDuration: prefersReducedMotion.current ? "0.01ms" : void 0
 		},
-		dangerouslySetInnerHTML: { __html: svg }
-	});
+		onClick: handleClose,
+		onTransitionEnd: handleOverlayTransitionEnd,
+		onKeyDown: (e) => {
+			if (e.key === "Escape") handleClose();
+		},
+		children: /* @__PURE__ */ jsxs("div", {
+			role: "document",
+			className: "relative overflow-hidden w-full h-full",
+			style: {
+				width: "100%",
+				height: "100%",
+				transform: dialogState === "closed" || dialogState === "closing" ? "scale(0.9)" : dialogState === "opening" ? "scale(0.9)" : "scale(1)",
+				opacity: dialogState === "closed" || dialogState === "closing" ? 0 : 1,
+				transition: dialogState === "closed" ? "none" : `transform ${prefersReducedMotion.current ? "0.01ms" : "200ms"} ease-out, opacity ${prefersReducedMotion.current ? "0.01ms" : "200ms"} ease-out`
+			},
+			onClick: (e) => e.stopPropagation(),
+			onKeyDown: (e) => e.stopPropagation(),
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "absolute top-4 left-1/2 z-10 flex -translate-x-1/2 items-center gap-1 rounded-lg px-2 py-1.5 backdrop-blur-md",
+				style: { backgroundColor: "var(--color-fd-foreground)" },
+				children: [
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: handleZoomIn,
+						className: "mermaid-toolbar-btn inline-flex items-center justify-center rounded-md p-1.5 transition-colors cursor-pointer",
+						style: {
+							color: "var(--color-fd-background)",
+							"--hover-bg": "var(--color-fd-background)",
+							"--hover-color": "var(--color-fd-foreground)"
+						},
+						title: "放大",
+						children: /* @__PURE__ */ jsx(ZoomIn, { size: 16 })
+					}),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: handleZoomOut,
+						className: "mermaid-toolbar-btn inline-flex items-center justify-center rounded-md p-1.5 transition-colors cursor-pointer",
+						style: {
+							color: "var(--color-fd-background)",
+							"--hover-bg": "var(--color-fd-background)",
+							"--hover-color": "var(--color-fd-foreground)"
+						},
+						title: "缩小",
+						children: /* @__PURE__ */ jsx(ZoomOut, { size: 16 })
+					}),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: handleReset,
+						className: "mermaid-toolbar-btn inline-flex items-center justify-center rounded-md p-1.5 transition-colors cursor-pointer",
+						style: {
+							color: "var(--color-fd-background)",
+							"--hover-bg": "var(--color-fd-background)",
+							"--hover-color": "var(--color-fd-foreground)"
+						},
+						title: "重置缩放",
+						children: /* @__PURE__ */ jsx(RotateCcw, { size: 16 })
+					}),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: handleCenter,
+						className: "mermaid-toolbar-btn inline-flex items-center justify-center rounded-md p-1.5 transition-colors cursor-pointer",
+						style: {
+							color: "var(--color-fd-background)",
+							"--hover-bg": "var(--color-fd-background)",
+							"--hover-color": "var(--color-fd-foreground)"
+						},
+						title: "定位到中心",
+						children: /* @__PURE__ */ jsx(LocateFixed, { size: 16 })
+					}),
+					/* @__PURE__ */ jsx("div", { className: "mx-1 h-4 w-px bg-white/20" }),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						onClick: handleClose,
+						className: "mermaid-toolbar-btn inline-flex items-center justify-center rounded-md p-1.5 transition-colors cursor-pointer",
+						style: {
+							color: "var(--color-fd-background)",
+							"--hover-bg": "var(--color-fd-background)",
+							"--hover-color": "var(--color-fd-foreground)"
+						},
+						title: "关闭",
+						children: /* @__PURE__ */ jsx(X, { size: 16 })
+					})
+				]
+			}), /* @__PURE__ */ jsx("div", {
+				ref: contentRef,
+				role: "img",
+				className: "flex w-full h-full items-center justify-center origin-top-left",
+				dangerouslySetInnerHTML: { __html: svg }
+			})]
+		})
+	})] });
 }
 //#endregion
 export { Mermaid };

package/dist/components/provider.js

@@ -4,7 +4,13 @@ import { RootProvider } from "fumadocs-ui/provider/next";
 //#region src/components/provider.tsx
 function Provider({ searchEnabled = true, children }) {
 	return /* @__PURE__ */ jsx(RootProvider, {
-		search: { enabled: searchEnabled },
+		search: {
+			enabled: searchEnabled,
+			options: {
+				type: "static",
+				api: "/api/search"
+			}
+		},
 		children
 	});
 }

package/dist/components/safe-search-dialog.d.ts

@@ -0,0 +1,30 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/safe-search-dialog.d.ts
+interface SafeSearchDialogProps {
+  defaultTag?: string;
+  tags?: {
+    value: string;
+    name: string;
+  }[];
+  api?: string;
+  delayMs?: number;
+  type?: 'fetch' | 'static';
+  allowClear?: boolean;
+  links?: [string, string][];
+  footer?: React.ReactNode;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}
+declare function SafeSearchDialog({
+  defaultTag,
+  tags,
+  api,
+  delayMs,
+  type,
+  allowClear,
+  links,
+  footer
+}: SafeSearchDialogProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SafeSearchDialog as default };

package/dist/components/safe-search-dialog.js

@@ -0,0 +1,77 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { useDocsSearch } from "fumadocs-core/search/client";
+import { useOnChange } from "fumadocs-core/utils/use-on-change";
+import { SearchDialog, SearchDialogClose, SearchDialogContent, SearchDialogFooter, SearchDialogHeader, SearchDialogIcon, SearchDialogInput, SearchDialogList, SearchDialogOverlay, TagsList, TagsListItem, useSearch } from "fumadocs-ui/components/dialog/search";
+import { useI18n } from "fumadocs-ui/contexts/i18n";
+//#region src/components/safe-search-dialog.tsx
+/**
+* SafeSearchDialog - 安全搜索对话框
+*
+* 基于 fumadocs-ui DefaultSearchDialog 复刻，核心修复：
+* 在传递 items 给 SearchDialogList 前增加 Array.isArray 校验，
+* 防止 query.data 为非数组值时触发 `items?.map is not a function` 报错。
+*
+* 对应源码: fumadocs-ui/dist/components/dialog/search-default.js
+* 修复位置: 原 search-default.js 第 48 行
+*   原: items={query.data !== "empty" ? query.data : defaultItems}
+*   新: items={Array.isArray(query.data) ? query.data : defaultItems}
+*/
+function SafeSearchDialog({ defaultTag, tags = [], api, delayMs, type = "fetch", allowClear = false, links = [], footer }) {
+	const { locale } = useI18n();
+	const [tag, setTag] = useState(defaultTag);
+	const { open, onOpenChange } = useSearch();
+	const { search, setSearch, query } = useDocsSearch(type === "fetch" ? {
+		type: "fetch",
+		...api != null && { api },
+		...locale != null && { locale },
+		...tag != null && { tag },
+		...delayMs != null && { delayMs }
+	} : {
+		type: "static",
+		...api != null && { from: api },
+		...locale != null && { locale },
+		...tag != null && { tag },
+		...delayMs != null && { delayMs }
+	});
+	const defaultItems = useMemo(() => {
+		if (links.length === 0) return null;
+		return links.map(([name, link]) => ({
+			type: "page",
+			id: name,
+			content: name,
+			url: link
+		}));
+	}, [links]);
+	useOnChange(defaultTag, (v) => {
+		setTag(v);
+	});
+	const safeItems = Array.isArray(query.data) ? query.data : defaultItems;
+	return /* @__PURE__ */ jsxs(SearchDialog, {
+		open,
+		onOpenChange,
+		search,
+		onSearchChange: setSearch,
+		isLoading: query.isLoading,
+		children: [
+			/* @__PURE__ */ jsx(SearchDialogOverlay, {}),
+			/* @__PURE__ */ jsxs(SearchDialogContent, { children: [/* @__PURE__ */ jsxs(SearchDialogHeader, { children: [
+				/* @__PURE__ */ jsx(SearchDialogIcon, {}),
+				/* @__PURE__ */ jsx(SearchDialogInput, {}),
+				/* @__PURE__ */ jsx(SearchDialogClose, {})
+			] }), /* @__PURE__ */ jsx(SearchDialogList, { items: safeItems })] }),
+			/* @__PURE__ */ jsxs(SearchDialogFooter, { children: [tags.length > 0 && /* @__PURE__ */ jsx(TagsList, {
+				...tag != null && { tag },
+				onTagChange: setTag,
+				allowClear,
+				children: tags.map((tagItem) => /* @__PURE__ */ jsx(TagsListItem, {
+					value: tagItem.value,
+					children: tagItem.name
+				}, tagItem.value))
+			}), footer] })
+		]
+	});
+}
+//#endregion
+export { SafeSearchDialog as default };

package/dist/index.d.ts

@@ -12,6 +12,7 @@ declare const OpenManualConfigSchema: z.ZodObject<{
     strict: "strict";
     all: "all";
   }>>;
+  favicon: z.ZodOptional<z.ZodString>;
   navbar: z.ZodOptional<z.ZodObject<{
     logo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
       light: z.ZodString;

package/dist/index.js

@@ -7,6 +7,7 @@ const LogoSchema = z.union([z.string(), z.object({
 	light: z.string(),
 	dark: z.string()
 })]);
+const FaviconSchema = z.string();
 const NavbarSchema = z.object({
 	logo: LogoSchema.optional(),
 	github: z.url().optional(),
@@ -42,6 +43,7 @@ const OpenManualConfigSchema = z.object({
 	siteUrl: z.url().optional(),
 	locale: z.string().optional(),
 	contentPolicy: z.enum(["strict", "all"]).optional(),
+	favicon: FaviconSchema.optional(),
 	navbar: NavbarSchema.optional(),
 	footer: FooterSchema.optional(),
 	sidebar: z.array(SidebarGroupSchema).optional(),

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 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 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  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});\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>;\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 buildTitleMap(config: OpenManualConfig): Record<string, string> {\n  const map: Record<string, string> = {};\n  if (config.sidebar) {\n    for (const group of config.sidebar) {\n      for (const page of group.pages) {\n        map[page.slug] = page.title;\n      }\n    }\n  }\n  return map;\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  };\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\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 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});\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>;\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 buildTitleMap(config: OpenManualConfig): Record<string, string> {\n  const map: Record<string, string> = {};\n  if (config.sidebar) {\n    for (const group of config.sidebar) {\n      for (const page of group.pages) {\n        map[page.slug] = page.title;\n      }\n    }\n  }\n  return map;\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  };\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;AAEF,MAAa,oBAAoB,EAAE,OAAO;CACxC,MAAM,EAAE,QAAQ;CAChB,OAAO,EAAE,QAAQ;CACjB,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC5B,CAAC;AAEF,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,EACnC,SAAS,EAAE,SAAS,CAAC,UAAU,EAChC,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,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,SAAS,EAAE,MAAM,mBAAmB,CAAC,UAAU;CAC/C,OAAO,YAAY,UAAU;CAC7B,QAAQ,aAAa,UAAU;CAC/B,KAAK,UAAU,UAAU;CACzB,aAAa,kBAAkB,UAAU;CAC1C,CAAC;;;;ACjEF,MAAM,iBAA4C;CAChD,YAAY;CACZ,WAAW;CACX,QAAQ;CACR,QAAQ,EAAE;CACV,QAAQ,EAAE;CACV,OAAO;EACL,YAAY;EACZ,UAAU;EACX;CACD,QAAQ,EACN,SAAS,MACV;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;EACD,QAAQ;GACN,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EACD,KAAK;GACH,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EACD,aAAa;GACX,GAAG,eAAe;GAClB,GAAG,OAAO;GACX;EACF"}

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

@@ -3,12 +3,14 @@ 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;
   }[];
 }
 declare function slugToUrl(slug: string): string;
-declare function restructureTree(tree: PageTree.Root, sidebarConfig: readonly SidebarConfigEntry[]): PageTree.Root;
+declare function restructureTree(tree: PageTree.Root, sidebarConfig: readonly SidebarConfigEntry[], iconMap?: Record<string, React.ReactNode>): PageTree.Root;
 //#endregion
 export { SidebarConfigEntry, restructureTree, slugToUrl };

package/dist/utils/restructure-tree.js

@@ -2,7 +2,7 @@
 function slugToUrl(slug) {
 	return slug === "index" ? "/" : `/${slug}`;
 }
-function restructureTree(tree, sidebarConfig) {
+function restructureTree(tree, sidebarConfig, iconMap) {
 	const consumed = /* @__PURE__ */ new Set();
 	const newChildren = [];
 	const children = tree.children ?? [];
@@ -13,13 +13,17 @@ function restructureTree(tree, sidebarConfig) {
 			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(node);
+				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
 		});
@@ -29,10 +33,26 @@ function restructureTree(tree, sidebarConfig) {
 			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({
-					...children[idx],
+					...originalFolder,
 					name: group.group,
-					defaultOpen: !group.collapsed
+					icon: group.icon && iconMap ? iconMap[group.icon] : void 0,
+					defaultOpen: !group.collapsed,
+					children: childrenWithIcons
 				});
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmanual",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "author": "shenjingnan <sjn.code@gmail.com>",
   "description": "AI 友好的开源文档系统框架",
   "type": "module",
@@ -51,6 +51,7 @@
     "url": "https://github.com/shenjingnan/openmanual.git"
   },
   "dependencies": {
+    "@panzoom/panzoom": "^4.6.2",
     "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "fast-glob": "^3.3.3",
@@ -64,8 +65,10 @@
     "zod": "^4.0.0"
   },
   "peerDependencies": {
+    "lucide-react": ">=0.400.0",
     "mermaid": ">=11.0.0",
-    "next-themes": ">=0.4.0"
+    "next-themes": ">=0.4.0",
+    "tailwind-merge": ">=2.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
@@ -86,7 +89,7 @@
   },
   "scripts": {
     "build": "tsdown",
-    "dev": "concurrently -n tsdown,dev -c blue,green \"tsdown --watch\" \"sleep 2 && OPENMANUAL_ROOT=$(pwd) node dist/bin.js dev --watch --cwd docs\"",
+    "dev": "tsdown --watch",
     "dev:cli": "tsx watch src/cli/bin.ts",
     "test": "vitest run",
     "test:watch": "vitest",