openmanual 0.3.2 → 0.5.0

package/dist/bin.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
+import "./chunk-EFTGR6G5.js";
 
 // src/cli/bin.ts
 import { readFileSync } from "fs";
-import { basename, dirname, join as join5 } from "path";
+import { basename, dirname, join as join6 } from "path";
 import { fileURLToPath } from "url";
 import { Command as Command5 } from "commander";
 
@@ -19,8 +20,9 @@ import { join } from "path";
 
 // src/core/config/schema.ts
 import { z } from "zod";
+var LogoSchema = z.union([z.string(), z.object({ light: z.string(), dark: z.string() })]);
 var NavbarSchema = z.object({
-  logo: z.string().optional(),
+  logo: LogoSchema.optional(),
   github: z.url().optional(),
   links: z.array(
     z.object({
@@ -60,6 +62,7 @@ var OpenManualConfigSchema = z.object({
   outputDir: z.string().optional(),
   siteUrl: z.url().optional(),
   locale: z.string().optional(),
+  contentPolicy: z.enum(["strict", "all"]).optional(),
   navbar: NavbarSchema.optional(),
   footer: FooterSchema.optional(),
   sidebar: z.array(SidebarGroupSchema).optional(),
@@ -109,6 +112,7 @@ ${errors}`);
 function mergeDefaults(config) {
   return {
     ...config,
+    contentPolicy: config.contentPolicy ?? "strict",
     contentDir: config.contentDir ?? DEFAULT_CONFIG.contentDir ?? "content",
     outputDir: config.outputDir ?? DEFAULT_CONFIG.outputDir ?? "dist",
     locale: config.locale ?? DEFAULT_CONFIG.locale ?? "zh",
@@ -145,8 +149,38 @@ import { join as join2 } from "path";
 function generateGlobalCss(ctx) {
   const { config } = ctx;
   const primaryHue = config.theme?.primaryHue ?? 213;
+  const darkMode = config.theme?.darkMode ?? true;
+  const darkBlock = darkMode ? `
+.dark {
+  --primary-hue: ${primaryHue};
+
+  /* \u6E29\u6696\u7684\u6DF1\u8272\u76AE\u9769\u80CC\u666F */
+  --color-fd-background: hsl(30, 18%, 10%);
+  --color-fd-foreground: hsl(35, 15%, 90%);
+  --color-fd-muted: hsl(30, 14%, 14%);
+  --color-fd-muted-foreground: hsla(30, 10%, 65%, 0.8);
+  --color-fd-popover: hsl(30, 16%, 13%);
+  --color-fd-popover-foreground: hsl(35, 12%, 87%);
+  --color-fd-card: hsl(30, 15%, 12%);
+  --color-fd-card-foreground: hsl(35, 15%, 93%);
+  --color-fd-border: hsla(30, 12%, 35%, 25%);
+  --color-fd-primary: hsl(35, 20%, 92%);
+  --color-fd-primary-foreground: hsl(30, 25%, 10%);
+  --color-fd-secondary: hsl(30, 12%, 16%);
+  --color-fd-secondary-foreground: hsl(35, 10%, 88%);
+  --color-fd-accent: hsla(30, 15%, 30%, 35%);
+  --color-fd-accent-foreground: hsl(35, 12%, 88%);
+  --color-fd-ring: hsl(30, 30%, 50%);
+  --color-fd-overlay: hsla(25, 20%, 5%, 0.5);
+}
+
+.dark body {
+  background: linear-gradient(hsla(30, 30%, 15%, 0.4), transparent 20rem, transparent);
+}
+` : "";
   return `@import 'tailwindcss';
 @import 'fumadocs-ui/style.css';
+@custom-variant dark (&:is(.dark, .dark *));
 
 :root {
   --primary-hue: ${primaryHue};
@@ -158,7 +192,7 @@ function generateGlobalCss(ctx) {
   --color-fd-card: hsl(40, 18%, 94%);              /* \u5361\u7247\u80CC\u666F */
   --color-fd-popover: hsl(40, 20%, 97.5%);         /* \u5F39\u7A97\u80CC\u666F */
 }
-`;
+${darkBlock}`;
 }
 
 // src/core/generator/layout.ts
@@ -167,10 +201,16 @@ function isImagePath(value) {
   if (value.startsWith("/")) return true;
   return IMAGE_EXTENSIONS.some((ext) => value.toLowerCase().endsWith(ext));
 }
+function resolveLogoPaths(logo) {
+  if (typeof logo === "string") {
+    return { light: logo, dark: logo };
+  }
+  return { light: logo.light, dark: logo.dark };
+}
 function generateLayout(ctx) {
   const { config } = ctx;
   const logo = config.navbar?.logo ?? config.name;
-  if (isImagePath(logo)) {
+  if (typeof logo === "string" && isImagePath(logo)) {
     return `import type { ReactNode } from 'react';
 import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
 
@@ -185,6 +225,42 @@ export function baseOptions(): BaseLayoutProps {
     },
   };
 }
+`;
+  }
+  if (typeof logo === "object") {
+    const { light, dark } = logo;
+    if (light === dark) {
+      return `import type { ReactNode } from 'react';
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: (
+        <>
+          <img src="${light}" alt="${config.name}" style={{ height: 28 }} />
+        </>
+      ) as ReactNode,
+    },
+  };
+}
+`;
+    }
+    return `import type { ReactNode } from 'react';
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: (
+        <>
+          <img src="${light}" alt="${config.name}" style={{ height: 28 }} className="dark:hidden" />
+          <img src="${dark}" alt="${config.name}" style={{ height: 28 }} className="hidden dark:block" />
+        </>
+      ) as ReactNode,
+    },
+  };
+}
 `;
   }
   return `import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
@@ -260,16 +336,57 @@ function generatePackageJson(_ctx) {
 }
 
 // src/core/generator/page.ts
+function buildAllowedSlugs(config) {
+  const slugs = /* @__PURE__ */ new Set();
+  if (config.sidebar) {
+    for (const group of config.sidebar) {
+      for (const page of group.pages) {
+        slugs.add(page.slug);
+      }
+    }
+  }
+  return slugs;
+}
 function generatePage(_ctx) {
+  const isStrict = _ctx.config.contentPolicy !== "all";
+  const allowedSlugsSnippet = isStrict ? `
+const allowedSlugs = new Set(${JSON.stringify([...buildAllowedSlugs(_ctx.config)])});
+
+function isAllowed(slug: string[] | undefined): boolean {
+  if (allowedSlugs.size === 0) return true;
+  const key = slug ? slug.join('/') : 'index';
+  return allowedSlugs.has(key);
+}
+` : "";
+  const filterInPage = isStrict ? `
+  if (!isAllowed(slug)) {
+    notFound();
+  }
+` : "";
+  const filterInStaticParams = isStrict ? `
+export function generateStaticParams() {
+  let params = source.generateParams();
+  params = params.filter((p: { slug: string[] }) => isAllowed(p.slug));
+  if (!params.some((p: { slug: string[] }) => p.slug.length === 0)) {
+    params.unshift({ ...params[0], slug: [] });
+  }
+  return params;
+}` : `
+export function generateStaticParams() {
+  const params = source.generateParams();
+  if (!params.some((p: { slug: string[] }) => p.slug.length === 0)) {
+    params.unshift({ ...params[0], slug: [] });
+  }
+  return params;
+}`;
   return `import { source } from '@/lib/source';
 import { notFound } from 'next/navigation';
 import { DocsPage, DocsBody, DocsTitle, DocsDescription } from 'fumadocs-ui/page';
-import defaultMdxComponents from 'fumadocs-ui/mdx';
-
+import defaultMdxComponents from 'fumadocs-ui/mdx';${allowedSlugsSnippet}
 export default async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
   const { slug } = await params;
   const page = source.getPage(slug);
-
+${filterInPage}
   if (!page) {
     notFound();
   }
@@ -288,10 +405,7 @@ export default async function Page({ params }: { params: Promise<{ slug?: string
     </DocsPage>
   );
 }
-
-export function generateStaticParams() {
-  return source.generateParams();
-}
+${filterInStaticParams}
 `;
 }
 
@@ -331,14 +445,94 @@ export function Provider({ children }: { children: ReactNode }) {
 }
 
 // src/core/generator/source-config.ts
+function buildTitleMap(config) {
+  const map = {};
+  if (config.sidebar) {
+    for (const group of config.sidebar) {
+      for (const page of group.pages) {
+        map[page.slug] = page.title;
+      }
+    }
+  }
+  return map;
+}
+function buildAllowedSlugs2(config) {
+  const slugs = /* @__PURE__ */ new Set();
+  if (config.sidebar) {
+    for (const group of config.sidebar) {
+      for (const page of group.pages) {
+        slugs.add(page.slug);
+      }
+    }
+  }
+  return slugs;
+}
 function generateSourceConfig(_ctx) {
+  const titleMap = buildTitleMap(_ctx.config);
+  const titleMapEntries = Object.entries(titleMap).map(([slug, title]) => `  '${slug}': '${title.replace(/'/g, "\\'")}'`).join(",\n");
+  const titleMapStr = titleMapEntries ? `{
+${titleMapEntries}
+}` : "{}";
+  const isStrict = _ctx.config.contentPolicy !== "all";
+  const allowedSlugsSnippet = isStrict ? `
+
+const allowedSlugs = new Set(${JSON.stringify([...buildAllowedSlugs2(_ctx.config)])});
+
+function slugFromPath(path: string): string {
+  const normalized = path.replace(/\\\\/g, '/');
+  const idx = normalized.indexOf('content/');
+  const relative = idx >= 0 ? normalized.slice(idx + 'content/'.length) : normalized;
+  return relative.replace(/\\.(md|mdx)$/i, '');
+}
+` : "";
+  const filterSnippet = isStrict ? `
+      .refine((_data) => {
+        const slug = slugFromPath(ctx.path);
+        if (allowedSlugs.size > 0 && !allowedSlugs.has(slug)) {
+          return false;
+        }
+        return true;
+      })` : "";
   return `import { defineDocs, defineConfig } from 'fumadocs-mdx/config';
+import { z } from 'zod';
+
+const titleMap: Record<string, string> = ${titleMapStr};${allowedSlugsSnippet}
+function titleFromPath(path: string): string {
+  const normalized = path.replace(/\\\\/g, '/');
+  const idx = normalized.indexOf('content/');
+  const relative = idx >= 0 ? normalized.slice(idx + 'content/'.length) : normalized;
+  const slug = relative.replace(/\\.(md|mdx)$/i, '');
+  return titleMap[slug] || slug.split('/').pop() || slug;
+}
 
 export const docs = defineDocs({
   dir: 'content',
+  docs: {
+    schema: (ctx) =>
+      z.object({
+        title: z.string().optional(),
+        description: z.string().optional(),
+        icon: z.string().optional(),
+        full: z.boolean().optional(),
+      }).transform((data) => ({
+        ...data,
+        title: data.title ?? titleFromPath(ctx.path),
+      }))${filterSnippet},
+  },
 });
 
-export default defineConfig();
+export default defineConfig({
+  mdxOptions: {
+    rehypeCodeOptions: {
+      themes: {
+        light: 'github-light',
+        dark: 'github-dark',
+      },
+      defaultColor: false,
+      fallbackLanguage: 'text',
+    },
+  },
+});
 `;
 }
 
@@ -438,17 +632,16 @@ async function generateAll(ctx) {
     await mkdir(dir, { recursive: true });
     await writeFile(fullPath, file.content, "utf-8");
   }
-  const logo = ctx.config.navbar?.logo ?? "";
-  if (logo && isImagePath(logo)) {
-    const userLogoPath = join2(ctx.projectDir, "public", logo.replace(/^\//, ""));
-    try {
-      await access(userLogoPath);
-    } catch {
-      const publicDir = join2(ctx.appDir, "public");
-      await mkdir(publicDir, { recursive: true });
-      const logoPath = join2(publicDir, logo.replace(/^\//, ""));
-      await mkdir(join2(logoPath, ".."), { recursive: true });
-      await writeFile(logoPath, generateOpenManualLogoSvg(ctx.config.name), "utf-8");
+  const logo = ctx.config.navbar?.logo;
+  if (logo && typeof logo === "string" && isImagePath(logo)) {
+    await ensureLogoFile(ctx, logo, "light");
+  } else if (logo && typeof logo === "object") {
+    const { light, dark } = resolveLogoPaths(logo);
+    if (isImagePath(light)) {
+      await ensureLogoFile(ctx, light, "light");
+    }
+    if (isImagePath(dark) && dark !== light) {
+      await ensureLogoFile(ctx, dark, "dark");
     }
   }
 }
@@ -503,14 +696,27 @@ export default function DocsLayoutWrapper({ children }: { children: ReactNode })
 }
 `;
 }
-function generateOpenManualLogoSvg(name) {
+function generateOpenManualLogoSvg(name, variant = "light") {
+  const textColor = variant === "dark" ? "#E8E0D4" : "#000000";
   return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 190 32" width="190" height="32">
   <text x="0" y="25" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif" font-size="32" font-weight="700">
-    <tspan fill="#2B7A4B" font-size="34">${name.charAt(0)}</tspan><tspan fill="#000000">${name.slice(1)}</tspan>
+    <tspan fill="#2B7A4B" font-size="34">${name.charAt(0)}</tspan><tspan fill="${textColor}">${name.slice(1)}</tspan>
   </text>
 </svg>
 `;
 }
+async function ensureLogoFile(ctx, logoPath, variant) {
+  const userLogoPath = join2(ctx.projectDir, "public", logoPath.replace(/^\//, ""));
+  try {
+    await access(userLogoPath);
+  } catch {
+    const publicDir = join2(ctx.appDir, "public");
+    await mkdir(publicDir, { recursive: true });
+    const fullPath = join2(publicDir, logoPath.replace(/^\//, ""));
+    await mkdir(join2(fullPath, ".."), { recursive: true });
+    await writeFile(fullPath, generateOpenManualLogoSvg(ctx.config.name, variant), "utf-8");
+  }
+}
 
 // src/utils/install-deps.ts
 import { spawn } from "child_process";
@@ -684,6 +890,57 @@ var buildCommand = new Command("build").description("\u6784\u5EFA\u9759\u6001\u7
 import { spawn as spawn3 } from "child_process";
 import { extname, resolve as resolve4 } from "path";
 import { Command as Command2 } from "commander";
+
+// src/utils/check-code-langs.ts
+import { readdir, readFile as readFile2 } from "fs/promises";
+import { join as join4, relative, sep } from "path";
+async function checkCodeLangs(contentDir) {
+  const { bundledLanguages } = await import("./dist-IK4UEFEW.js");
+  const supportedLangs = new Set(Object.keys(bundledLanguages));
+  supportedLangs.add("text");
+  supportedLangs.add("txt");
+  supportedLangs.add("plaintext");
+  supportedLangs.add("plain");
+  supportedLangs.add("ansi");
+  const files = await collectMdFiles(contentDir);
+  const results = [];
+  for (const file of files) {
+    const content = await readFile2(file, "utf-8");
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      if (!line) continue;
+      const match = line.match(/^```(\S+)/);
+      if (match) {
+        const lang = match[1];
+        if (!lang) continue;
+        if (!supportedLangs.has(lang)) {
+          results.push({
+            file: relative(contentDir, file).split(sep).join("/"),
+            line: i + 1,
+            lang
+          });
+        }
+      }
+    }
+  }
+  return results;
+}
+async function collectMdFiles(dir) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const fullPath = join4(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await collectMdFiles(fullPath));
+    } else if (entry.isFile() && /\.(md|mdx)$/i.test(entry.name)) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+
+// src/cli/commands/dev.ts
 var devCommand = new Command2("dev").description("\u542F\u52A8\u5F00\u53D1\u670D\u52A1\u5668").option("-p, --port <port>", "\u7AEF\u53E3\u53F7", "3000").option("--watch", "\u76D1\u542C\u6846\u67B6\u6E90\u7801\u53D8\u66F4\u5E76\u81EA\u52A8\u91CD\u65B0\u751F\u6210", false).option("--cwd <path>", "\u9879\u76EE\u76EE\u5F55\uFF08watch \u6A21\u5F0F\u4E0B\u4F7F\u7528\uFF09").action(async (options) => {
   const cwd = options.cwd ? resolve4(options.cwd) : process.cwd();
   try {
@@ -700,6 +957,17 @@ var devCommand = new Command2("dev").description("\u542F\u52A8\u5F00\u53D1\u670D
       contentDir: config.contentDir ?? "content"
     };
     await generateAll(ctx);
+    try {
+      const unknownLangs = await checkCodeLangs(contentDir);
+      if (unknownLangs.length > 0) {
+        logger.warn("\u4EE5\u4E0B\u6587\u4EF6\u4F7F\u7528\u4E86\u4E0D\u8BA4\u8BC6\u7684\u4EE3\u7801\u5757\u8BED\u8A00:");
+        for (const item of unknownLangs) {
+          logger.warn(`  ${item.file}:${item.line} - "${item.lang}"`);
+        }
+        logger.warn('\u5EFA\u8BAE\u5C06\u8FD9\u4E9B\u8BED\u8A00\u6539\u4E3A\u53D7\u652F\u6301\u7684\u7C7B\u578B\uFF0C\u6216\u4F7F\u7528 "text" \u4F5C\u4E3A\u9ED8\u8BA4\u503C');
+      }
+    } catch {
+    }
     await createSymlink(contentDir, resolve4(appDir, "content"));
     const publicDir = resolve4(cwd, "public");
     try {
@@ -844,7 +1112,7 @@ var previewCommand = new Command3("preview").description("\u9884\u89C8\u6784\u5E
 
 // src/cli/commands/regenerate.ts
 import { rm as rm2 } from "fs/promises";
-import { join as join4, resolve as resolve6 } from "path";
+import { join as join5, resolve as resolve6 } from "path";
 import { Command as Command4 } from "commander";
 var regenerateCommand = new Command4("_regenerate").description("\u5185\u90E8\u547D\u4EE4\uFF1A\u91CD\u65B0\u751F\u6210\u6587\u4EF6").helpOption(false).option("--cwd <path>", "\u9879\u76EE\u76EE\u5F55").action(async (options) => {
   const cwd = options.cwd ?? process.cwd();
@@ -870,7 +1138,7 @@ var regenerateCommand = new Command4("_regenerate").description("\u5185\u90E8\u5
       "postcss.config.mjs"
     ];
     for (const entry of entriesToClean) {
-      await rm2(join4(appDir, entry), { recursive: true, force: true });
+      await rm2(join5(appDir, entry), { recursive: true, force: true });
     }
     await generateAll(ctx);
     await createSymlink(contentDir, resolve6(appDir, "content"));
@@ -892,17 +1160,17 @@ var regenerateCommand = new Command4("_regenerate").description("\u5185\u90E8\u5
 // src/cli/bin.ts
 function getVersion() {
   if (true) {
-    return "0.3.2";
+    return "0.5.0";
   }
   try {
     const __dirname = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join5(__dirname, "..", "package.json");
+    const pkgPath = join6(__dirname, "..", "package.json");
     const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
     return pkg.version;
   } catch {
     try {
       const __dirname = dirname(fileURLToPath(import.meta.url));
-      const pkgPath = join5(__dirname, "..", "..", "package.json");
+      const pkgPath = join6(__dirname, "..", "..", "package.json");
       const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
       return pkg.version;
     } catch {