openmanual 0.8.2 → 0.10.0

package/dist/bin.js

@@ -13,6 +13,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(),
@@ -48,6 +49,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(),
@@ -140,12 +142,21 @@ function mergeDefaults(config) {
 	};
 }
 
+//#endregion
+//#region src/core/generator/callout-component.ts
+function generateCalloutComponent() {
+	return `'use client';
+export { Callout, CalloutTitle, CalloutDescription } from 'openmanual/components/callout';
+`;
+}
+
 //#endregion
 //#region src/core/generator/global-css.ts
 function generateGlobalCss(ctx) {
 	const { config } = ctx;
 	const primaryHue = config.theme?.primaryHue ?? 213;
 	return `@import 'tailwindcss';
+@source './node_modules/openmanual/dist/components/**/*.js';
 @import 'fumadocs-ui/style.css';
 @custom-variant dark (&:is(.dark, .dark *));
 
@@ -158,6 +169,29 @@ function generateGlobalCss(ctx) {
   --color-fd-muted: hsl(40, 15%, 95%);             /* 柔和的暖灰背景 */
   --color-fd-card: hsl(40, 18%, 94%);              /* 卡片背景 */
   --color-fd-popover: hsl(40, 20%, 97.5%);         /* 弹窗背景 */
+
+  /* Callout 类型色 */
+  --callout-info-bg: hsl(210, 35%, 94%);
+  --callout-info-border: hsl(212, 40%, 80%);
+  --callout-info-text: hsl(213, 45%, 35%);
+  --callout-warning-bg: hsl(38, 60%, 93%);
+  --callout-warning-border: hsl(36, 55%, 78%);
+  --callout-warning-text: hsl(28, 55%, 35%);
+  --callout-danger-bg: hsl(0, 50%, 94%);
+  --callout-danger-border: hsl(0, 45%, 82%);
+  --callout-danger-text: hsl(0, 50%, 38%);
+  --callout-check-bg: hsl(150, 35%, 93%);
+  --callout-check-border: hsl(152, 35%, 78%);
+  --callout-check-text: hsl(155, 40%, 32%);
+  --callout-tip-bg: hsl(150, 35%, 93%);
+  --callout-tip-border: hsl(152, 35%, 78%);
+  --callout-tip-text: hsl(155, 40%, 32%);
+  --callout-note-bg: hsl(215, 20%, 94%);
+  --callout-note-border: hsl(215, 22%, 82%);
+  --callout-note-text: hsl(215, 25%, 40%);
+  --callout-key-bg: hsl(30, 55%, 93%);
+  --callout-key-border: hsl(28, 50%, 78%);
+  --callout-key-text: hsl(25, 50%, 35%);
 }
 ${config.theme?.darkMode ?? true ? `
 .dark {
@@ -181,6 +215,29 @@ ${config.theme?.darkMode ?? true ? `
   --color-fd-accent-foreground: hsl(35, 12%, 88%);
   --color-fd-ring: hsl(30, 30%, 50%);
   --color-fd-overlay: hsla(25, 20%, 5%, 0.5);
+
+  /* Callout 类型色 */
+  --callout-info-bg: hsl(213, 25%, 16%);
+  --callout-info-border: hsl(213, 30%, 30%);
+  --callout-info-text: hsl(213, 40%, 72%);
+  --callout-warning-bg: hsl(32, 35%, 17%);
+  --callout-warning-border: hsl(30, 35%, 30%);
+  --callout-warning-text: hsl(35, 45%, 72%);
+  --callout-danger-bg: hsl(5, 25%, 17%);
+  --callout-danger-border: hsl(5, 30%, 30%);
+  --callout-danger-text: hsl(5, 40%, 72%);
+  --callout-check-bg: hsl(155, 22%, 16%);
+  --callout-check-border: hsl(155, 25%, 28%);
+  --callout-check-text: hsl(155, 35%, 68%);
+  --callout-tip-bg: hsl(155, 22%, 16%);
+  --callout-tip-border: hsl(155, 25%, 28%);
+  --callout-tip-text: hsl(155, 35%, 68%);
+  --callout-note-bg: hsl(215, 15%, 16%);
+  --callout-note-border: hsl(215, 18%, 28%);
+  --callout-note-text: hsl(215, 25%, 68%);
+  --callout-key-bg: hsl(30, 28%, 17%);
+  --callout-key-border: hsl(28, 25%, 30%);
+  --callout-key-text: hsl(25, 35%, 68%);
 }
 
 .dark body {
@@ -196,6 +253,21 @@ figure.shiki {
 figure.shiki > div {
   max-height: none;
 }
+
+/* Mermaid 全屏操作栏按钮 hover */
+.mermaid-toolbar-btn:hover {
+  background-color: var(--hover-bg) !important;
+  color: var(--hover-color) !important;
+}
+
+.mermaid-toolbar-btn:hover svg {
+  color: inherit;
+}
+
+/* Callout：去除 shadow */
+[style*="--callout-color"] {
+  box-shadow: none;
+}
 `;
 }
 
@@ -292,7 +364,7 @@ export default withMDX(config);
 //#endregion
 //#region src/core/generator/package-json.ts
 function getOpenManualVersion() {
-	return "0.8.2";
+	return "0.10.0";
 }
 function generatePackageJson(ctx) {
 	const openmanualVersion = getOpenManualVersion();
@@ -313,6 +385,7 @@ function generatePackageJson(ctx) {
 			"fumadocs-core": "^16.7.7",
 			"fumadocs-mdx": "^14.2.11",
 			"fumadocs-ui": "^16.7.7",
+			"lucide-react": "^1.7.0",
 			mermaid: "^11.4.0",
 			next: "^16.2.1",
 			"next-themes": "^0.4.6",
@@ -353,7 +426,8 @@ import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
 import { Files, File, Folder } from 'fumadocs-ui/components/files';
 import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 import { TypeTable } from 'fumadocs-ui/components/type-table';
-import { Mermaid } from '@/components/mermaid';${pageActionsEnabled ? "\nimport { PageActions } from '@/components/page-actions';" : ""}
+import { Mermaid } from '@/components/mermaid';
+import { Callout, CalloutTitle, CalloutDescription } from '@/components/callout';${pageActionsEnabled ? "\nimport { PageActions } from '@/components/page-actions';" : ""}
 ${allowedSlugsSnippet}
 export default async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
   const { slug } = await params;
@@ -384,7 +458,7 @@ ${pageActionsEnabled ? `      <div className="flex items-start justify-between g
         <DocsDescription>{page.data.description}</DocsDescription>
       )}`}
       <DocsBody data-content-area>
-        <MDX components={{ ...defaultMdxComponents, Steps, Step, Tabs, Tab, Files, File, Folder, Accordion, Accordions, TypeTable, Mermaid }} />
+        <MDX components={{ ...defaultMdxComponents, Steps, Step, Tabs, Tab, Files, File, Folder, Accordion, Accordions, TypeTable, Mermaid, Callout, CalloutTitle, CalloutDescription }} />
       </DocsBody>
     </DocsPage>
   );
@@ -438,7 +512,13 @@ import { Provider } from 'openmanual/components/provider';
 import type { ReactNode } from 'react';
 
 export function AppProvider({ children }: { children: ReactNode }) {
-  return <Provider searchEnabled={${ctx.config.search?.enabled !== false}}>{children}</Provider>;
+  return (
+    <Provider
+      searchEnabled={${ctx.config.search?.enabled !== false}}
+    >
+      {children}
+    </Provider>
+  );
 }
 `;
 }
@@ -472,6 +552,17 @@ export async function GET(
 `;
 }
 
+//#endregion
+//#region src/core/generator/search-route.ts
+function generateSearchRoute() {
+	return `import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+
+export const revalidate = false;
+export const { staticGET: GET } = createFromSource(source);
+`;
+}
+
 //#endregion
 //#region src/core/generator/source-config.ts
 function generateSourceConfig(_ctx) {
@@ -613,6 +704,10 @@ async function generateAll(ctx) {
 			path: "lib/layout.tsx",
 			content: generateLayout(ctx)
 		},
+		{
+			path: "components/callout.tsx",
+			content: generateCalloutComponent()
+		},
 		{
 			path: "components/mermaid.tsx",
 			content: generateMermaidComponent()
@@ -624,10 +719,16 @@ async function generateAll(ctx) {
 		...ctx.dev ? [{
 			path: "app/api/raw/[...path]/route.ts",
 			content: generateRawContentRoute()
-		}] : [],
+		}, {
+			path: "app/api/search/route.ts",
+			content: generateSearchRoute()
+		}] : [{
+			path: "app/api/search/route.ts",
+			content: generateSearchRoute()
+		}],
 		{
 			path: "app/layout.tsx",
-			content: generateRootLayout()
+			content: generateRootLayout(ctx)
 		},
 		{
 			path: "app/provider.tsx",
@@ -656,11 +757,21 @@ async function generateAll(ctx) {
 	}
 	await generateMetaFiles(ctx);
 }
-function generateRootLayout() {
+function generateRootLayout(ctx) {
+	const { config } = ctx;
+	const favicon = config.favicon;
 	return `import { AppLayout } from 'openmanual/components/app-layout';
 import { AppProvider } from './provider';
 import type { ReactNode } from 'react';
-import '../global.css';
+${favicon ? `import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+  icons: {
+    icon: '${favicon}',
+  },
+};
+
+` : ""}import '../global.css';
 
 export default function RootLayout({ children }: { children: ReactNode }) {
   return (
@@ -686,20 +797,34 @@ function generateDocsLayout(ctx) {
 	const footerLine = footerText ? `\n  footer: { children: '${footerText.replace(/'/g, "\\'")}' },` : "";
 	const sidebar = config.sidebar;
 	const hasSidebar = sidebar && sidebar.length > 0;
+	const iconNames = /* @__PURE__ */ new Set();
+	if (hasSidebar) for (const g of sidebar ?? []) {
+		if (g.icon) iconNames.add(g.icon);
+		for (const p of g.pages) if (p.icon) iconNames.add(p.icon);
+	}
+	const hasIcons = iconNames.size > 0;
+	const iconNameList = [...iconNames];
 	const sidebarConfigSnippet = hasSidebar ? `\nconst sidebarConfig = ${JSON.stringify((sidebar ?? []).map((g) => ({
 		group: g.group,
+		icon: g.icon,
 		collapsed: g.collapsed,
-		pages: g.pages.map((p) => ({ slug: p.slug }))
+		pages: g.pages.map((p) => ({
+			slug: p.slug,
+			icon: p.icon
+		}))
 	})), null, 2)} as const;
+` : "";
+	const lucideImportLine = hasIcons ? `\nimport { ${iconNameList.join(", ")} } from 'lucide-react';` : "";
+	const iconMapSnippet = hasIcons ? `\nconst iconMap = {${iconNameList.map((name) => `\n  ${name}: <${name} />,`).join("")}\n} as const;
 ` : "";
 	return `import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { baseOptions } from '@/lib/layout';
 import { source } from '@/lib/source';
-import type { ReactNode } from 'react';${hasSidebar ? "\nimport { restructureTree } from 'openmanual/utils/restructure-tree';" : ""}
-${sidebarConfigSnippet}
+import type { ReactNode } from 'react';${hasSidebar ? "\nimport { restructureTree } from 'openmanual/utils/restructure-tree';" : ""}${lucideImportLine}
+${sidebarConfigSnippet}${iconMapSnippet}
 const docsOptions = {
   ...baseOptions(),
-  ${hasSidebar ? "tree: restructureTree(source.getPageTree(), sidebarConfig)," : "tree: source.getPageTree(),"}${githubLine}${linksLine}${footerLine}
+  ${hasSidebar ? hasIcons ? "tree: restructureTree(source.getPageTree(), sidebarConfig, iconMap)," : "tree: restructureTree(source.getPageTree(), sidebarConfig)," : "tree: source.getPageTree(),"}${githubLine}${linksLine}${footerLine}
 };
 
 export default function DocsLayoutWrapper({ children }: { children: ReactNode }) {
@@ -986,14 +1111,27 @@ const devCommand = new Command("dev").description("启动开发服务器").optio
 		const tempDir = await ensureTempDir(cwd);
 		const appDir = getAppDir(cwd);
 		const contentDir = resolve(cwd, config.contentDir ?? "content");
-		await generateAll({
+		const __dirname = dirname(fileURLToPath(import.meta.url));
+		const openmanualRoot = process.env.OPENMANUAL_ROOT || resolve(__dirname, "..");
+		const ctx = {
 			config,
 			projectDir: cwd,
 			appDir,
 			contentDir: config.contentDir ?? "content",
 			dev: true,
-			...process.env.OPENMANUAL_ROOT ? { openmanualRoot: process.env.OPENMANUAL_ROOT } : {}
-		});
+			openmanualRoot
+		};
+		if (process.env.OPENMANUAL_ROOT) await spawnInitialGenerate(openmanualRoot, cwd);
+		else {
+			await generateAll(ctx);
+			await createSymlink(contentDir, resolve(appDir, "content"));
+			const publicDir = resolve(cwd, "public");
+			try {
+				const { stat } = await import("node:fs/promises");
+				await stat(publicDir);
+				await createSymlink(publicDir, resolve(appDir, "public"));
+			} catch {}
+		}
 		try {
 			const unknownLangs = await checkCodeLangs(contentDir);
 			if (unknownLangs.length > 0) {
@@ -1002,13 +1140,6 @@ const devCommand = new Command("dev").description("启动开发服务器").optio
 				logger.warn("建议将这些语言改为受支持的类型，或使用 \"text\" 作为默认值");
 			}
 		} catch {}
-		await createSymlink(contentDir, resolve(appDir, "content"));
-		const publicDir = resolve(cwd, "public");
-		try {
-			const { stat } = await import("node:fs/promises");
-			await stat(publicDir);
-			await createSymlink(publicDir, resolve(appDir, "public"));
-		} catch {}
 		logger.step("安装依赖...");
 		await installDeps(appDir);
 		logger.success("开发服务器启动中...");
@@ -1080,6 +1211,24 @@ const devCommand = new Command("dev").description("启动开发服务器").optio
 		process.exit(1);
 	}
 });
+function spawnInitialGenerate(openmanualRoot, cwd) {
+	const child = spawn("node", [
+		resolve(openmanualRoot, "dist/bin.js"),
+		"_regenerate",
+		"--cwd",
+		cwd
+	], {
+		stdio: "inherit",
+		env: { ...process.env }
+	});
+	return new Promise((promiseResolve, promiseReject) => {
+		child.on("exit", (code) => {
+			if (code === 0) promiseResolve();
+			else promiseReject(/* @__PURE__ */ new Error(`初始生成失败 (exit code: ${code})`));
+		});
+		child.on("error", promiseReject);
+	});
+}
 function spawnRegenerate(openmanualRoot, cwd, nextChild) {
 	if (nextChild.exitCode !== null) {
 		logger.warn("Next.js 进程已退出，跳过重新生成");
@@ -1192,7 +1341,7 @@ const regenerateCommand = new Command("_regenerate").description("内部命令
 //#endregion
 //#region src/cli/bin.ts
 function getVersion() {
-	return "0.8.2";
+	return "0.10.0";
 }
 const program = new Command();
 const commandName = basename(process.argv[1] ?? "openmanual");