zengen 0.1.0

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigationGenerator = exports.TemplateEngine = exports.MarkdownConverter = exports.ZenBuilder = void 0;
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "ZenBuilder", { enumerable: true, get: function () { return builder_1.ZenBuilder; } });
+var markdown_1 = require("./markdown");
+Object.defineProperty(exports, "MarkdownConverter", { enumerable: true, get: function () { return markdown_1.MarkdownConverter; } });
+var template_1 = require("./template");
+Object.defineProperty(exports, "TemplateEngine", { enumerable: true, get: function () { return template_1.TemplateEngine; } });
+var navigation_1 = require("./navigation");
+Object.defineProperty(exports, "NavigationGenerator", { enumerable: true, get: function () { return navigation_1.NavigationGenerator; } });
+/**
+ * ZEN 文档构建工具
+ *
+ * 一个极简主义的 Markdown 文档站点生成器
+ *
+ * @example
+ * ```typescript
+ * import { ZenBuilder } from 'zengen';
+ *
+ * const builder = new ZenBuilder();
+ * await builder.build({
+ *   srcDir: './docs',
+ *   outDir: './dist'
+ * });
+ * ```
+ */
+const builder_2 = require("./builder");
+const markdown_2 = require("./markdown");
+const template_2 = require("./template");
+const navigation_2 = require("./navigation");
+exports.default = {
+    Builder: builder_2.ZenBuilder,
+    MarkdownConverter: markdown_2.MarkdownConverter,
+    TemplateEngine: template_2.TemplateEngine,
+    NavigationGenerator: navigation_2.NavigationGenerator
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AACnB,uCAA+C;AAAtC,6GAAA,iBAAiB,OAAA;AAC1B,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,2CAAmD;AAA1C,iHAAA,mBAAmB,OAAA;AAU5B;;;;;;;;;;;;;;;GAeG;AACH,uCAAuC;AACvC,yCAA+C;AAC/C,yCAA4C;AAC5C,6CAAmD;AAEnD,kBAAe;IACb,OAAO,EAAE,oBAAU;IACnB,iBAAiB,EAAE,4BAAiB;IACpC,cAAc,EAAE,yBAAc;IAC9B,mBAAmB,EAAE,gCAAmB;CACzC,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,34 @@
+import { FileInfo, MarkdownProcessor } from './types';
+export declare class MarkdownConverter {
+    private processors;
+    constructor(processors?: MarkdownProcessor[]);
+    /**
+     * 添加处理器
+     */
+    addProcessor(processor: MarkdownProcessor): void;
+    /**
+     * 解析 YAML frontmatter
+     */
+    private parseFrontmatter;
+    /**
+     * 从内容中提取标题
+     */
+    private extractTitle;
+    /**
+     * 转换 Markdown 文件
+     */
+    convert(fileInfo: FileInfo): Promise<FileInfo>;
+    /**
+     * 批量转换文件
+     */
+    convertFiles(files: FileInfo[]): Promise<FileInfo[]>;
+    /**
+     * 从文件路径读取并转换
+     */
+    convertFromPath(filePath: string, baseDir?: string): Promise<FileInfo>;
+    /**
+     * 从目录读取所有 Markdown 文件并转换
+     */
+    convertDirectory(dirPath: string): Promise<FileInfo[]>;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA0BtD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAA2B;gBAEjC,UAAU,GAAE,iBAAiB,EAAO;IAIhD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiCpD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiB1D;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBhF;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CA+B7D"}

package/dist/markdown.js

@@ -0,0 +1,209 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownConverter = void 0;
+const marked_1 = require("marked");
+const highlight_js_1 = __importDefault(require("highlight.js"));
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("yaml"));
+// 配置 marked 使用 highlight.js 进行代码高亮
+marked_1.marked.setOptions({
+    highlight: function (code, lang) {
+        if (lang && highlight_js_1.default.getLanguage(lang)) {
+            try {
+                return highlight_js_1.default.highlight(code, { language: lang }).value;
+            }
+            catch (err) {
+                console.warn(`Failed to highlight code with language ${lang}:`, err);
+            }
+        }
+        return highlight_js_1.default.highlightAuto(code).value;
+    },
+    pedantic: false,
+    gfm: true,
+    breaks: false,
+    sanitize: false,
+    smartLists: true,
+    smartypants: false,
+    xhtml: false
+});
+class MarkdownConverter {
+    constructor(processors = []) {
+        this.processors = [];
+        this.processors = processors;
+    }
+    /**
+     * 添加处理器
+     */
+    addProcessor(processor) {
+        this.processors.push(processor);
+    }
+    /**
+     * 解析 YAML frontmatter
+     */
+    parseFrontmatter(content) {
+        const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
+        const match = content.match(frontmatterRegex);
+        if (!match) {
+            return { metadata: {}, content };
+        }
+        try {
+            const metadata = yaml.parse(match[1]) || {};
+            const remainingContent = content.slice(match[0].length);
+            return { metadata, content: remainingContent };
+        }
+        catch (error) {
+            console.warn('Failed to parse frontmatter:', error);
+            return { metadata: {}, content };
+        }
+    }
+    /**
+     * 从内容中提取标题
+     */
+    extractTitle(content) {
+        // 查找第一个一级标题
+        const h1Match = content.match(/^#\s+(.+)$/m);
+        if (h1Match) {
+            return h1Match[1].trim();
+        }
+        // 如果没有一级标题，查找第一个二级标题
+        const h2Match = content.match(/^##\s+(.+)$/m);
+        if (h2Match) {
+            return h2Match[1].trim();
+        }
+        return 'Untitled';
+    }
+    /**
+     * 转换 Markdown 文件
+     */
+    async convert(fileInfo) {
+        let { content, metadata } = this.parseFrontmatter(fileInfo.content);
+        // 应用前置处理器
+        for (const processor of this.processors) {
+            if (processor.beforeParse) {
+                content = await processor.beforeParse(content, fileInfo);
+            }
+        }
+        // 转换 Markdown 为 HTML
+        let html = marked_1.marked.parse(content);
+        // 应用后置处理器
+        for (const processor of this.processors) {
+            if (processor.afterParse) {
+                html = await processor.afterParse(html, fileInfo);
+            }
+        }
+        // 提取标题（如果 metadata 中没有）
+        if (!metadata.title) {
+            metadata.title = this.extractTitle(content);
+        }
+        return {
+            ...fileInfo,
+            content,
+            html,
+            metadata
+        };
+    }
+    /**
+     * 批量转换文件
+     */
+    async convertFiles(files) {
+        const results = [];
+        for (const file of files) {
+            try {
+                const result = await this.convert(file);
+                results.push(result);
+            }
+            catch (error) {
+                console.error(`Failed to convert file ${file.path}:`, error);
+                // 即使转换失败，也保留原始文件信息
+                results.push(file);
+            }
+        }
+        return results;
+    }
+    /**
+     * 从文件路径读取并转换
+     */
+    async convertFromPath(filePath, baseDir = '') {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const relativePath = baseDir ? path.relative(baseDir, filePath) : filePath;
+        const ext = path.extname(filePath);
+        const name = path.basename(filePath, ext);
+        const fileInfo = {
+            path: filePath,
+            relativePath,
+            name,
+            ext,
+            content
+        };
+        return this.convert(fileInfo);
+    }
+    /**
+     * 从目录读取所有 Markdown 文件并转换
+     */
+    async convertDirectory(dirPath) {
+        const files = [];
+        async function scanDirectory(currentPath) {
+            const entries = await fs.readdir(currentPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentPath, entry.name);
+                if (entry.isDirectory()) {
+                    await scanDirectory(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    const content = await fs.readFile(fullPath, 'utf-8');
+                    const relativePath = path.relative(dirPath, fullPath);
+                    const ext = path.extname(entry.name);
+                    const name = path.basename(entry.name, ext);
+                    files.push({
+                        path: fullPath,
+                        relativePath,
+                        name,
+                        ext,
+                        content
+                    });
+                }
+            }
+        }
+        await scanDirectory(dirPath);
+        return this.convertFiles(files);
+    }
+}
+exports.MarkdownConverter = MarkdownConverter;
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"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"}

package/dist/navigation.d.ts

@@ -0,0 +1,36 @@
+import { NavigationItem, FileInfo } from './types';
+export declare class NavigationGenerator {
+    /**
+     * 从文件信息生成导航结构
+     */
+    generate(files: FileInfo[]): NavigationItem[];
+    /**
+     * 将文件添加到导航树中
+     */
+    private addFileToNavigation;
+    /**
+     * 格式化标题（将连字符/下划线转换为空格并首字母大写）
+     */
+    private formatTitle;
+    /**
+     * 生成扁平化导航（所有页面在同一层级）
+     */
+    generateFlat(files: FileInfo[]): NavigationItem[];
+    /**
+     * 生成面包屑导航
+     */
+    generateBreadcrumbs(filePath: string, navigation: NavigationItem[]): NavigationItem[];
+    /**
+     * 在导航树中查找项目
+     */
+    private findNavigationItem;
+    /**
+     * 生成站点地图 XML
+     */
+    generateSitemap(files: FileInfo[], baseUrl?: string): string;
+    /**
+     * 生成 JSON 格式的导航数据（用于前端动态加载）
+     */
+    generateJsonNavigation(files: FileInfo[]): string;
+}
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnD,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAgB7C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoD3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAYjD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IA4BrF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,MAA8B,GAAG,MAAM;IAmBnF;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM;CAIlD"}

package/dist/navigation.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigationGenerator = void 0;
+class NavigationGenerator {
+    /**
+     * 从文件信息生成导航结构
+     */
+    generate(files) {
+        // 按路径排序
+        const sortedFiles = [...files].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+        // 构建树形结构
+        const root = [];
+        for (const file of sortedFiles) {
+            this.addFileToNavigation(root, file);
+        }
+        return root;
+    }
+    /**
+     * 将文件添加到导航树中
+     */
+    addFileToNavigation(navigation, file) {
+        const parts = file.relativePath.split('/');
+        let currentLevel = navigation;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const isLastPart = i === parts.length - 1;
+            const isMarkdownFile = part.endsWith('.md');
+            // 如果是 Markdown 文件，移除扩展名
+            const displayName = isMarkdownFile ? part.replace(/\.md$/, '') : part;
+            // 生成标题（使用文件名或 metadata 中的标题）
+            const title = file.metadata?.title || this.formatTitle(displayName);
+            // 生成路径
+            const itemPath = isMarkdownFile
+                ? `/${file.relativePath.replace(/\.md$/, '.html')}`
+                : `/${parts.slice(0, i + 1).join('/')}`;
+            if (isLastPart) {
+                // 添加文件节点
+                currentLevel.push({
+                    title,
+                    path: itemPath
+                });
+            }
+            else {
+                // 查找或创建目录节点
+                let dirItem = currentLevel.find(item => item.title === displayName && !item.path.endsWith('.html'));
+                if (!dirItem) {
+                    dirItem = {
+                        title: this.formatTitle(displayName),
+                        path: itemPath,
+                        children: []
+                    };
+                    currentLevel.push(dirItem);
+                }
+                // 确保 children 存在
+                if (!dirItem.children) {
+                    dirItem.children = [];
+                }
+                // 进入下一层
+                currentLevel = dirItem.children;
+            }
+        }
+    }
+    /**
+     * 格式化标题（将连字符/下划线转换为空格并首字母大写）
+     */
+    formatTitle(name) {
+        // 移除扩展名
+        const baseName = name.replace(/\.[^/.]+$/, '');
+        // 将连字符、下划线、点替换为空格
+        const withSpaces = baseName.replace(/[-_.]/g, ' ');
+        // 首字母大写每个单词
+        return withSpaces
+            .split(' ')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ');
+    }
+    /**
+     * 生成扁平化导航（所有页面在同一层级）
+     */
+    generateFlat(files) {
+        return files.map(file => {
+            const title = file.metadata?.title || this.formatTitle(file.name);
+            const itemPath = `/${file.relativePath.replace(/\.md$/, '.html')}`;
+            return {
+                title,
+                path: itemPath
+            };
+        }).sort((a, b) => a.title.localeCompare(b.title));
+    }
+    /**
+     * 生成面包屑导航
+     */
+    generateBreadcrumbs(filePath, navigation) {
+        const parts = filePath.split('/').filter(part => part);
+        const breadcrumbs = [];
+        let currentNav = navigation;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const isLast = i === parts.length - 1;
+            const searchPath = `/${parts.slice(0, i + 1).join('/')}`;
+            // 在当前层级查找匹配的导航项
+            const foundItem = this.findNavigationItem(currentNav, searchPath);
+            if (foundItem) {
+                breadcrumbs.push({
+                    title: foundItem.title,
+                    path: foundItem.path
+                });
+                if (foundItem.children && !isLast) {
+                    currentNav = foundItem.children;
+                }
+            }
+        }
+        return breadcrumbs;
+    }
+    /**
+     * 在导航树中查找项目
+     */
+    findNavigationItem(navigation, searchPath) {
+        for (const item of navigation) {
+            if (item.path === searchPath) {
+                return item;
+            }
+            if (item.children) {
+                const found = this.findNavigationItem(item.children, searchPath);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * 生成站点地图 XML
+     */
+    generateSitemap(files, baseUrl = 'https://example.com') {
+        const urls = files.map(file => {
+            const path = `/${file.relativePath.replace(/\.md$/, '.html')}`;
+            const lastmod = file.metadata?.last_modified || file.metadata?.date || new Date().toISOString().split('T')[0];
+            return `  <url>
+    <loc>${baseUrl}${path}</loc>
+    <lastmod>${lastmod}</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>`;
+        }).join('\n');
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`;
+    }
+    /**
+     * 生成 JSON 格式的导航数据（用于前端动态加载）
+     */
+    generateJsonNavigation(files) {
+        const navigation = this.generate(files);
+        return JSON.stringify(navigation, null, 2);
+    }
+}
+exports.NavigationGenerator = NavigationGenerator;
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"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"}

package/dist/template.d.ts

@@ -0,0 +1,29 @@
+import { TemplateData, NavigationItem, FileInfo } from './types';
+export declare class TemplateEngine {
+    private defaultTemplate;
+    /**
+     * 生成导航 HTML
+     */
+    private generateNavigationHtml;
+    /**
+     * 简单的模板变量替换
+     */
+    private renderTemplate;
+    /**
+     * 渲染模板
+     */
+    render(data: TemplateData, templatePath?: string): Promise<string>;
+    /**
+     * 从文件信息生成模板数据
+     */
+    generateTemplateData(fileInfo: FileInfo, navigation: NavigationItem[]): TemplateData;
+    /**
+     * 生成输出文件路径
+     */
+    getOutputPath(fileInfo: FileInfo, outDir: string): string;
+    /**
+     * 保存渲染结果到文件
+     */
+    saveToFile(html: string, outputPath: string): Promise<void>;
+}
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIjE,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CA6QhB;IAEP;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcxE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,YAAY;IAUpF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAMzD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQlE"}