openmanual 0.4.0 → 0.6.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";
 
@@ -61,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(),
@@ -110,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",
@@ -333,16 +336,63 @@ 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 { Steps, Step } from 'fumadocs-ui/components/steps';
+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';
+${allowedSlugsSnippet}
 export default async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
   const { slug } = await params;
   const page = source.getPage(slug);
-
+${filterInPage}
   if (!page) {
     notFound();
   }
@@ -356,19 +406,12 @@ export default async function Page({ params }: { params: Promise<{ slug?: string
         <DocsDescription>{page.data.description}</DocsDescription>
       )}
       <DocsBody>
-        <MDX components={{ ...defaultMdxComponents }} />
+        <MDX components={{ ...defaultMdxComponents, Steps, Step, Tabs, Tab, Files, File, Folder, Accordion, Accordions, TypeTable }} />
       </DocsBody>
     </DocsPage>
   );
 }
-
-export function generateStaticParams() {
-  const params = source.generateParams();
-  if (!params.some((p: { slug: string[] }) => p.slug.length === 0)) {
-    params.unshift({ ...params[0], slug: [] });
-  }
-  return params;
-}
+${filterInStaticParams}
 `;
 }
 
@@ -408,14 +451,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',
+    },
+  },
+});
 `;
 }
 
@@ -527,6 +650,7 @@ async function generateAll(ctx) {
       await ensureLogoFile(ctx, dark, "dark");
     }
   }
+  await generateMetaFiles(ctx);
 }
 function generateRootLayout() {
   return `import { Provider } from './provider';
@@ -560,14 +684,91 @@ function generateDocsLayout(ctx) {
     links: ${JSON.stringify(linksArray)},` : "";
   const footerLine = footerText ? `
   footer: { children: '${footerText.replace(/'/g, "\\'")}' },` : "";
+  const sidebar = config.sidebar;
+  const sidebarSnippet = sidebar && sidebar.length > 0 ? `
+const sidebarConfig = ${JSON.stringify(
+    sidebar.map((g) => ({
+      group: g.group,
+      collapsed: g.collapsed,
+      pages: g.pages.map((p) => ({ slug: p.slug }))
+    })),
+    null,
+    2
+  )} as const;
+
+function slugToUrl(slug: string): string {
+  return slug === 'index' ? '/' : \`/\${slug}\`;
+}
+
+function restructureTree(tree: PageTree.Root): PageTree.Root {
+  const consumed = new Set<number>();
+  const newChildren: PageTree.Node[] = [];
+
+  for (const group of sidebarConfig) {
+    const isRootGroup = group.pages.every((p) => !p.slug.includes('/'));
+
+    if (isRootGroup) {
+      const folderChildren: PageTree.Node[] = [];
+      for (const page of group.pages) {
+        const url = slugToUrl(page.slug);
+        const idx = (tree.children ?? []).findIndex(
+          (c, i) => !consumed.has(i) && c.type === 'page' && c.url === url
+        );
+        if (idx >= 0) {
+          folderChildren.push(tree.children![idx]);
+          consumed.add(idx);
+        }
+      }
+      if (folderChildren.length > 0) {
+        newChildren.push({
+          type: 'folder',
+          name: group.group,
+          defaultOpen: group.collapsed !== true,
+          children: folderChildren,
+        });
+      }
+    } else {
+      const dirPrefix = group.pages.find((p) => p.slug.includes('/'))?.slug.split('/')[0];
+      if (dirPrefix) {
+        const idx = (tree.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);
+          newChildren.push({
+            ...(tree.children![idx] as PageTree.Folder),
+            name: group.group,
+            defaultOpen: group.collapsed !== true,
+          });
+        }
+      }
+    }
+  }
+
+  for (let i = 0; i < (tree.children ?? []).length; i++) {
+    if (!consumed.has(i)) {
+      newChildren.push(tree.children![i]);
+    }
+  }
+
+  return { ...tree, children: newChildren };
+}
+` : "";
+  const treeLine = sidebarSnippet ? "tree: restructureTree(source.getPageTree())," : "tree: source.getPageTree(),";
+  const pageTreeImport = sidebarSnippet ? "\nimport type * as PageTree from 'fumadocs-core/page-tree';" : "";
   return `import { DocsLayout } from 'fumadocs-ui/layouts/docs';
 import { baseOptions } from '@/lib/layout';
 import { source } from '@/lib/source';
-import type { ReactNode } from 'react';
-
+import type { ReactNode } from 'react';${pageTreeImport}
+${sidebarSnippet}
 const docsOptions = {
   ...baseOptions(),
-  tree: source.getPageTree(),${githubLine}${linksLine}${footerLine}
+  ${treeLine}${githubLine}${linksLine}${footerLine}
 };
 
 export default function DocsLayoutWrapper({ children }: { children: ReactNode }) {
@@ -600,6 +801,25 @@ async function ensureLogoFile(ctx, logoPath, variant) {
     await writeFile(fullPath, generateOpenManualLogoSvg(ctx.config.name, variant), "utf-8");
   }
 }
+async function generateMetaFiles(ctx) {
+  const sidebar = ctx.config.sidebar;
+  if (!sidebar || sidebar.length === 0) return;
+  const contentAbsDir = join2(ctx.projectDir, ctx.contentDir);
+  for (const group of sidebar) {
+    const dirPrefix = group.pages.map((p) => p.slug).find((slug) => slug.includes("/"))?.split("/")[0];
+    if (!dirPrefix) continue;
+    const dirPath = join2(contentAbsDir, dirPrefix);
+    const metaPath = join2(dirPath, "meta.json");
+    try {
+      await access(metaPath);
+      continue;
+    } catch {
+    }
+    await mkdir(dirPath, { recursive: true });
+    await writeFile(metaPath, `${JSON.stringify({ title: group.group }, null, 2)}
+`, "utf-8");
+  }
+}
 
 // src/utils/install-deps.ts
 import { spawn } from "child_process";
@@ -773,6 +993,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 {
@@ -789,6 +1060,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 {
@@ -933,7 +1215,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();
@@ -959,7 +1241,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"));
@@ -981,17 +1263,17 @@ var regenerateCommand = new Command4("_regenerate").description("\u5185\u90E8\u5
 // src/cli/bin.ts
 function getVersion() {
   if (true) {
-    return "0.4.0";
+    return "0.6.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 {