@zat-design/sisyphus-react 3.11.8 → 3.11.9-beta.2

package/scripts/aggregateDocs.ts

@@ -0,0 +1,94 @@
+/* eslint-disable @typescript-eslint/no-var-requires */
+const fs = require('fs');
+const path = require('path');
+
+// 递归遍历目录，返回所有匹配的文件路径
+function getFiles(dir, ext) {
+  let results = [];
+  const list = fs.readdirSync(dir);
+  list.forEach((file) => {
+    const filePath = path.join(dir, file);
+    const stat = fs.statSync(filePath);
+    if (stat && stat.isDirectory()) {
+      results = results.concat(getFiles(filePath, ext));
+    } else if (filePath.endsWith(ext)) {
+      results.push(filePath);
+    }
+  });
+  return results;
+}
+
+// 去除文件开头的日志相关信息（移除包含 '@' 的行），保留其他说明
+function removeLogInfo(content) {
+  const headerRegex = /^\/\*[\s\S]*?\*\//;
+  const match = content.match(headerRegex);
+  if (match) {
+    const header = match[0];
+    // 过滤掉包含 '@' 的行
+    const cleanedHeader = header
+      .split('\n')
+      .filter((line) => !line.includes('@'))
+      .join('\n')
+      .trim();
+    // 移除 header 后剩余的内容
+    const rest = content.replace(headerRegex, '').trim();
+    return cleanedHeader ? `${cleanedHeader}
+
+${rest}` : rest;
+  }
+  return content;
+}
+
+// 聚合 docs 下所有 Markdown 文件内容
+function aggregateDocsMarkdown() {
+  const docsDir = path.join(process.cwd(), 'docs');
+  const mdFiles = getFiles(docsDir, '.md');
+  let aggregated = '# API 描述\n\n';
+  mdFiles.forEach((filePath) => {
+    const relativePath = path.relative(process.cwd(), filePath);
+    const content = fs.readFileSync(filePath, 'utf-8');
+    aggregated += `## ${relativePath}\n\n`;
+    aggregated += `${content}\n\n`;
+  });
+  return aggregated;
+}
+
+// 按组件维度聚合 src 下各子目录的 demos 文件夹中 demo 文件的代码示例
+function aggregateDemoDescriptions() {
+  const srcDir = path.join(process.cwd(), 'src');
+  let aggregated = '# Demo 示例\n\n';
+
+  // 遍历 src 目录的所有子目录，作为组件
+  const subDirs = fs.readdirSync(srcDir)
+    .map((name) => path.join(srcDir, name))
+    .filter((p) => fs.statSync(p).isDirectory());
+
+  subDirs.forEach((subDir) => {
+    const demosPath = path.join(subDir, 'demos');
+    if (fs.existsSync(demosPath) && fs.statSync(demosPath).isDirectory()) {
+      const componentName = path.basename(subDir);
+      aggregated += `## 组件: ${componentName}\n\n`;
+      const demoFiles = getFiles(demosPath, '.tsx');
+      demoFiles.forEach((demoFile) => {
+        const demoFileName = path.basename(demoFile);
+        const relativePath = path.relative(process.cwd(), demoFile);
+        let content = fs.readFileSync(demoFile, 'utf-8');
+        // 清洗日志相关信息
+        content = removeLogInfo(content);
+        aggregated += `### Demo: ${demoFileName} (${relativePath})\n\n`;
+        aggregated += `\`\`\`tsx\n${content}\n\`\`\`\n\n`;
+      });
+    }
+  });
+  return aggregated;
+}
+
+function main() {
+  const docsContent = aggregateDocsMarkdown();
+  const demoContent = aggregateDemoDescriptions();
+  const finalContent = `# 代码库上下文聚合\n\n${docsContent}\n${demoContent}`;
+  const outputPath = path.join(process.cwd(), 'aggregated_context.md');
+  fs.writeFileSync(outputPath, finalContent, 'utf-8');
+}
+
+main();