@yalehwang/archguard 0.1.0

package/dist/core/plugin-registry.d.ts

@@ -0,0 +1,19 @@
+import type { ILanguagePlugin } from './interfaces/index.js';
+export interface RegisterOptions {
+    overwrite?: boolean;
+}
+export declare class PluginRegistry {
+    private plugins;
+    private extensionMap;
+    register(plugin: ILanguagePlugin, options?: RegisterOptions): void;
+    getByName(name: string, version?: string): ILanguagePlugin | null;
+    getByExtension(extension: string): ILanguagePlugin | null;
+    private static readonly DETECTION_RULES;
+    detectPluginForDirectory(directoryPath: string): Promise<ILanguagePlugin | null>;
+    listVersions(name: string): string[];
+    listAll(): ILanguagePlugin[];
+    has(name: string, version?: string): boolean;
+    loadFromPath(pluginPath: string): Promise<ILanguagePlugin>;
+    private compareVersions;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/core/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/core/plugin-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,MAAM,WAAW,eAAe;IAK9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD,qBAAa,cAAc;IAIzB,OAAO,CAAC,OAAO,CAAwD;IAMvE,OAAO,CAAC,YAAY,CAA6C;IASjE,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAkDtE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA2BjE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAczD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAWrC;IAYI,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA6BtF,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBpC,OAAO,IAAI,eAAe,EAAE;IAmB5B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAmBtC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6BhE,OAAO,CAAC,eAAe;CAcxB"}

package/dist/core/plugin-registry.js

@@ -0,0 +1,137 @@
+import path from 'path';
+import { pathToFileURL } from 'node:url';
+import fs from 'fs-extra';
+export class PluginRegistry {
+    plugins = new Map();
+    extensionMap = new Map();
+    register(plugin, options = {}) {
+        const { name, version, fileExtensions } = plugin.metadata;
+        const { overwrite = false } = options;
+        if (!this.plugins.has(name)) {
+            this.plugins.set(name, new Map());
+        }
+        const versionMap = this.plugins.get(name);
+        if (versionMap.has(version) && !overwrite) {
+            throw new Error(`Plugin '${name}@${version}' is already registered. Use overwrite option to replace.`);
+        }
+        versionMap.set(version, plugin);
+        for (const ext of fileExtensions) {
+            if (!this.extensionMap.has(ext)) {
+                this.extensionMap.set(ext, []);
+            }
+            const plugins = this.extensionMap.get(ext);
+            if (overwrite) {
+                const index = plugins.findIndex((p) => p.metadata.name === name && p.metadata.version === version);
+                if (index !== -1) {
+                    plugins.splice(index, 1);
+                }
+            }
+            plugins.push(plugin);
+            plugins.sort((a, b) => this.compareVersions(b.metadata.version, a.metadata.version));
+        }
+    }
+    getByName(name, version) {
+        const versionMap = this.plugins.get(name);
+        if (!versionMap) {
+            return null;
+        }
+        if (version) {
+            return versionMap.get(version) ?? null;
+        }
+        const versions = Array.from(versionMap.keys());
+        if (versions.length === 0) {
+            return null;
+        }
+        versions.sort((a, b) => this.compareVersions(b, a));
+        const latestVersion = versions[0];
+        return versionMap.get(latestVersion) ?? null;
+    }
+    getByExtension(extension) {
+        const plugins = this.extensionMap.get(extension);
+        if (!plugins || plugins.length === 0) {
+            return null;
+        }
+        return plugins[0];
+    }
+    static DETECTION_RULES = [
+        { file: 'go.mod', plugin: 'golang' },
+        { file: 'package.json', plugin: 'typescript' },
+        { file: 'tsconfig.json', plugin: 'typescript' },
+        { file: 'pom.xml', plugin: 'java' },
+        { file: 'build.gradle', plugin: 'java' },
+        { file: 'pyproject.toml', plugin: 'python' },
+        { file: 'requirements.txt', plugin: 'python' },
+        { file: 'setup.py', plugin: 'python' },
+        { file: 'CMakeLists.txt', plugin: 'cpp' },
+        { file: 'Makefile', plugin: 'cpp' },
+    ];
+    async detectPluginForDirectory(directoryPath) {
+        for (const rule of PluginRegistry.DETECTION_RULES) {
+            const markerPath = path.join(directoryPath, rule.file);
+            try {
+                if (await fs.pathExists(markerPath)) {
+                    const plugin = this.getByName(rule.plugin);
+                    if (plugin) {
+                        return plugin;
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    listVersions(name) {
+        const versionMap = this.plugins.get(name);
+        if (!versionMap) {
+            return [];
+        }
+        const versions = Array.from(versionMap.keys());
+        versions.sort((a, b) => this.compareVersions(a, b));
+        return versions;
+    }
+    listAll() {
+        const allPlugins = [];
+        for (const versionMap of this.plugins.values()) {
+            for (const plugin of versionMap.values()) {
+                allPlugins.push(plugin);
+            }
+        }
+        return allPlugins;
+    }
+    has(name, version) {
+        const versionMap = this.plugins.get(name);
+        if (!versionMap) {
+            return false;
+        }
+        if (version) {
+            return versionMap.has(version);
+        }
+        return versionMap.size > 0;
+    }
+    async loadFromPath(pluginPath) {
+        const pluginUrl = pathToFileURL(pluginPath).href;
+        const module = await import(pluginUrl);
+        const PluginClass = module.default || module.Plugin;
+        if (!PluginClass) {
+            throw new Error(`Plugin at '${pluginPath}' must export a default class or named 'Plugin' export`);
+        }
+        const plugin = new PluginClass();
+        return plugin;
+    }
+    compareVersions(a, b) {
+        const partsA = a.split('.').map((n) => parseInt(n, 10));
+        const partsB = b.split('.').map((n) => parseInt(n, 10));
+        for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+            const numA = partsA[i] || 0;
+            const numB = partsB[i] || 0;
+            if (numA < numB)
+                return -1;
+            if (numA > numB)
+                return 1;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/core/plugin-registry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types/index.js';
+export * from './parser/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './types/index.js';
+export * from './parser/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/mermaid/auto-repair.d.ts

@@ -0,0 +1,23 @@
+import { MermaidParseValidator } from './validator-parse.js';
+import type { ValidationError } from './types.js';
+export declare class MermaidAutoRepair {
+    private parseValidator;
+    constructor(parseValidator: MermaidParseValidator);
+    repair(mermaidCode: string, errors: ValidationError[]): Promise<string>;
+    private addDiagramDeclaration;
+    private fixGenericTypes;
+    private flattenNestedNamespaces;
+    private extractNamespaceRelations;
+    private isRelationLine;
+    private fixTrailingCommas;
+    private normalizeWhitespace;
+    private attemptAdvancedRepairs;
+    private fixLineError;
+    private removeUnknownTokens;
+    private fixUnexpectedToken;
+    repairBestEffort(mermaidCode: string): Promise<{
+        repaired: string;
+        successful: boolean;
+    }>;
+}
+//# sourceMappingURL=auto-repair.d.ts.map

package/dist/mermaid/auto-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-repair.d.ts","sourceRoot":"","sources":["../../src/mermaid/auto-repair.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,qBAAqB;IAKnD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmC7E,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,uBAAuB;IAkC/B,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,mBAAmB;YAqBb,sBAAsB;IAuBpC,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,kBAAkB;IAcpB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;CAmBhG"}

package/dist/mermaid/auto-repair.js

@@ -0,0 +1,197 @@
+export class MermaidAutoRepair {
+    parseValidator;
+    constructor(parseValidator) {
+        this.parseValidator = parseValidator;
+    }
+    async repair(mermaidCode, errors) {
+        let repaired = mermaidCode;
+        repaired = this.addDiagramDeclaration(repaired);
+        repaired = this.fixGenericTypes(repaired);
+        repaired = this.flattenNestedNamespaces(repaired);
+        repaired = this.extractNamespaceRelations(repaired);
+        repaired = this.fixTrailingCommas(repaired);
+        repaired = this.normalizeWhitespace(repaired);
+        const result = await this.parseValidator.validate(repaired);
+        if (result.valid) {
+            return repaired;
+        }
+        repaired = await this.attemptAdvancedRepairs(repaired, result.errors);
+        const finalResult = await this.parseValidator.validate(repaired);
+        if (finalResult.valid) {
+            return repaired;
+        }
+        throw new Error(`Cannot repair Mermaid code. Errors: ${finalResult.errors.map((e) => e.message).join(', ')}`);
+    }
+    addDiagramDeclaration(code) {
+        const trimmed = code.trim();
+        const hasDeclaration = /^\s*(classDiagram|flowchart|stateDiagram|erDiagram|gitGraph)/m.test(trimmed);
+        if (!hasDeclaration && trimmed.length > 0) {
+            return `classDiagram\n${trimmed}`;
+        }
+        return code;
+    }
+    fixGenericTypes(code) {
+        let repaired = code;
+        const genericPattern = /(\w+)<([^>]+)>/g;
+        repaired = repaired.replace(genericPattern, (match, className, generics) => {
+            const cleanGenerics = generics.replace(/\s*,\s*/g, ',').replace(/\s+/g, '');
+            return `${className}~${cleanGenerics}~`;
+        });
+        return repaired;
+    }
+    flattenNestedNamespaces(code) {
+        const lines = code.split('\n');
+        const result = [];
+        let namespaceDepth = 0;
+        let currentNamespace = '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('namespace ')) {
+                if (namespaceDepth === 0) {
+                    result.push(line);
+                    currentNamespace = trimmed;
+                }
+                namespaceDepth++;
+            }
+            else if (trimmed === '}') {
+                namespaceDepth--;
+                if (namespaceDepth === 0) {
+                    result.push(line);
+                    currentNamespace = '';
+                }
+            }
+            else if (namespaceDepth <= 1) {
+                result.push(line);
+            }
+        }
+        return result.join('\n');
+    }
+    extractNamespaceRelations(code) {
+        const lines = code.split('\n');
+        const relations = [];
+        const result = [];
+        let inNamespace = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('namespace ')) {
+                inNamespace = true;
+                result.push(line);
+            }
+            else if (trimmed === '}') {
+                inNamespace = false;
+                result.push(line);
+            }
+            else if (inNamespace && this.isRelationLine(trimmed)) {
+                relations.push(line);
+            }
+            else {
+                result.push(line);
+            }
+        }
+        if (relations.length > 0) {
+            result.push('');
+            result.push('// Relations extracted from namespaces');
+            result.push(...relations);
+        }
+        return result.join('\n');
+    }
+    isRelationLine(line) {
+        const relationPatterns = [
+            /\w+\s*-->/,
+            /\w+\s*<--/,
+            /\w+\s*--/,
+            /\w+\s*\.\./,
+            /\w+\s*<\|/,
+            /\w+\s*\|>/,
+        ];
+        return relationPatterns.some((pattern) => pattern.test(line));
+    }
+    fixTrailingCommas(code) {
+        let repaired = code;
+        repaired = repaired.replace(/,(\s*$)/gm, '$1');
+        repaired = repaired.replace(/,(\s*\n)/gm, '\n');
+        repaired = repaired.replace(/,(\s*})/g, '$1');
+        return repaired;
+    }
+    normalizeWhitespace(code) {
+        let repaired = code;
+        repaired = repaired.replace(/\n{3,}/g, '\n\n');
+        repaired = repaired
+            .split('\n')
+            .map((line) => line.trimEnd())
+            .join('\n');
+        repaired = repaired.replace(/\n+$/, '\n');
+        return repaired;
+    }
+    async attemptAdvancedRepairs(code, errors) {
+        let repaired = code;
+        for (const error of errors) {
+            if (error.code === 'SYNTAX_ERROR' && error.line) {
+                repaired = this.fixLineError(repaired, error);
+            }
+            if (error.message.toLowerCase().includes('unknown')) {
+                repaired = this.removeUnknownTokens(repaired);
+            }
+            if (error.message.toLowerCase().includes('unexpected')) {
+                repaired = this.fixUnexpectedToken(repaired);
+            }
+        }
+        return repaired;
+    }
+    fixLineError(code, error) {
+        const lines = code.split('\n');
+        if (error.line && error.line >= 1 && error.line <= lines.length) {
+            const lineIndex = error.line - 1;
+            const line = lines[lineIndex];
+            let fixed = line;
+            if (fixed.includes('{') && !fixed.includes('}')) {
+                fixed = fixed + ' {';
+            }
+            if (!fixed.includes('{') && fixed.includes('class')) {
+                fixed = fixed + ' {';
+            }
+            fixed = fixed.replace(/[|{}[\]]/g, '');
+            lines[lineIndex] = fixed;
+        }
+        return lines.join('\n');
+    }
+    removeUnknownTokens(code) {
+        const repaired = code;
+        const lines = repaired.split('\n');
+        const filtered = lines.filter((line) => {
+            const trimmed = line.trim();
+            if (trimmed.length === 0 || trimmed.startsWith('%%'))
+                return true;
+            if (/^\s*(classDiagram|class|namespace|%%)/.test(trimmed))
+                return true;
+            if (/^\s*\w+\s*(-->\|<--\|--|<\|\.\.|\.\.|-->)/.test(trimmed))
+                return true;
+            if (/^\s*[\+\-#]\s*\w+/.test(trimmed))
+                return true;
+            return !/[|{}\[\]\\]/.test(trimmed);
+        });
+        return filtered.join('\n');
+    }
+    fixUnexpectedToken(code) {
+        let repaired = code;
+        repaired = repaired.replace(/\|/g, '_');
+        repaired = repaired.replace(/\[/g, '(');
+        repaired = repaired.replace(/\]/g, ')');
+        return repaired;
+    }
+    async repairBestEffort(mermaidCode) {
+        let repaired = mermaidCode;
+        repaired = this.addDiagramDeclaration(repaired);
+        repaired = this.fixGenericTypes(repaired);
+        repaired = this.flattenNestedNamespaces(repaired);
+        repaired = this.extractNamespaceRelations(repaired);
+        repaired = this.fixTrailingCommas(repaired);
+        repaired = this.normalizeWhitespace(repaired);
+        const result = await this.parseValidator.validate(repaired);
+        return {
+            repaired,
+            successful: result.valid,
+        };
+    }
+}
+//# sourceMappingURL=auto-repair.js.map

package/dist/mermaid/auto-repair.js.map

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

package/dist/mermaid/comment-generator.d.ts

@@ -0,0 +1,10 @@
+import type { DiagramConfig } from '../types/config.js';
+export declare class CommentGenerator {
+    generateHeader(config: DiagramConfig): string;
+    generatePatternComments(config: DiagramConfig): string;
+    generateProcessComments(config: DiagramConfig): string;
+    generateUsageComments(config: DiagramConfig): string;
+    generateAll(config: DiagramConfig): string;
+    generateVisibleTitle(config: DiagramConfig): string;
+}
+//# sourceMappingURL=comment-generator.d.ts.map

package/dist/mermaid/comment-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-generator.d.ts","sourceRoot":"","sources":["../../src/mermaid/comment-generator.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,qBAAa,gBAAgB;IAO3B,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA4D7C,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA+CtD,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAgDtD,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA0CpD,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IA2B1C,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;CAmGpD"}

package/dist/mermaid/comment-generator.js

@@ -0,0 +1,213 @@
+export class CommentGenerator {
+    generateHeader(config) {
+        const meta = config.metadata;
+        if (!meta)
+            return '';
+        let output = '\n%% ============================================================\n';
+        output += `%% ${meta.title || config.name}\n`;
+        if (meta.subtitle) {
+            output += `%% ${meta.subtitle}\n`;
+        }
+        output += '%% ============================================================\n';
+        if (meta.purpose) {
+            output += `\n%% Purpose: ${meta.purpose}\n`;
+        }
+        if (meta.primaryActors && meta.primaryActors.length > 0) {
+            output += `\n%% Primary Actors: ${meta.primaryActors.join(', ')}\n`;
+        }
+        if (meta.input || meta.output) {
+            output += '\n%% ============================================================\n';
+            if (meta.input) {
+                output += `\n%% Input:\n`;
+                output += `%%   Type: ${meta.input.type}\n`;
+                if (meta.input.description) {
+                    output += `%%   Description: ${meta.input.description}\n`;
+                }
+                if (meta.input.example) {
+                    output += `%%   Example: ${meta.input.example}\n`;
+                }
+            }
+            if (meta.output) {
+                output += `\n%% Output:\n`;
+                output += `%%   Description: ${meta.output.description}\n`;
+                if (meta.output.formats) {
+                    output += `%%   Formats: ${meta.output.formats.join(', ')}\n`;
+                }
+                if (meta.output.example) {
+                    output += `%%   Example: ${meta.output.example}\n`;
+                }
+            }
+            output += '\n%% ============================================================\n';
+        }
+        return output;
+    }
+    generatePatternComments(config) {
+        const design = config.design;
+        if (!design?.patterns || design.patterns.length === 0) {
+            return '';
+        }
+        let output = '\n%% ============================================================\n';
+        output += `%% Design Patterns (${design.patterns.length})\n`;
+        output += '%% ============================================================\n';
+        if (design.architectureStyle) {
+            output += `\n%% Architecture Style: ${design.architectureStyle}\n`;
+        }
+        output += '\n';
+        for (const pattern of design.patterns) {
+            output += `%% ${pattern.name} (${pattern.category})\n`;
+            output += `%%   Participants: ${pattern.participants.join(', ')}\n`;
+            output += `%%   Description: ${pattern.description}\n`;
+            if (pattern.codeExample) {
+                output += `%%   Example:\n%%     ${pattern.codeExample}\n`;
+            }
+            output += '\n';
+        }
+        if (design.principles && design.principles.length > 0) {
+            output += '%% Key Principles:\n';
+            for (const principle of design.principles) {
+                output += `%%   - ${principle}\n`;
+            }
+        }
+        output += '%% ============================================================\n';
+        return output;
+    }
+    generateProcessComments(config) {
+        const process = config.process;
+        if (!process)
+            return '';
+        let output = '\n%% ============================================================\n';
+        output += '%% Processing Flow\n';
+        output += '%% ============================================================\n';
+        if (process.dataFlow) {
+            output += `\n%% Data Flow: ${process.dataFlow}\n`;
+        }
+        if (process.stageList && process.stageList.length > 0) {
+            output += '\n';
+            for (const stage of process.stageList) {
+                output += `\n%% Stage ${stage.order}: ${stage.name}\n`;
+                output += `%% ${stage.description}\n`;
+                if (stage.namespace) {
+                    output += `%% Namespace: ${stage.namespace}\n`;
+                }
+                if (stage.patterns && stage.patterns.length > 0) {
+                    output += `%% Patterns: ${stage.patterns.join(', ')}\n`;
+                }
+            }
+        }
+        if (process.keyDependencies && process.keyDependencies.length > 0) {
+            output += '\n%% Key Dependencies:\n';
+            for (const dep of process.keyDependencies) {
+                output += `%%   - ${dep}\n`;
+            }
+        }
+        output += '\n%% ============================================================\n';
+        return output;
+    }
+    generateUsageComments(config) {
+        const meta = config.metadata;
+        const process = config.process;
+        if (!meta?.purpose && !process?.dataFlow) {
+            return '';
+        }
+        let output = '\n%% ============================================================\n';
+        output += '%% Usage Scenario\n';
+        output += '%% ============================================================\n';
+        if (meta?.purpose) {
+            output += `\n%% Purpose: ${meta.purpose}\n`;
+        }
+        if (meta?.input?.example) {
+            output += `\n%% User Action:\n%%   ${meta.input.example}\n`;
+        }
+        if (process?.dataFlow) {
+            output += `\n%% Processing:\n%%   ${process.dataFlow}\n`;
+        }
+        if (meta?.output?.example) {
+            output += `\n%% Result:\n%%   ${meta.output.example}\n`;
+        }
+        output += '\n%% ============================================================\n';
+        return output;
+    }
+    generateAll(config) {
+        const parts = [];
+        parts.push(this.generateHeader(config));
+        parts.push(this.generateProcessComments(config));
+        parts.push(this.generatePatternComments(config));
+        parts.push(this.generateUsageComments(config));
+        return parts.filter((p) => p.length > 0).join('\n');
+    }
+    generateVisibleTitle(config) {
+        if (!config.annotations?.enableVisibleTitle) {
+            return '';
+        }
+        const meta = config.metadata;
+        if (!meta) {
+            return '';
+        }
+        const sections = config.annotations.visibleTitleSections || [
+            'title',
+            'subtitle',
+            'purpose',
+            'input',
+            'output',
+            'patterns',
+            'principles',
+            'process',
+        ];
+        const lines = [];
+        if (sections.includes('title')) {
+            if (meta.title) {
+                lines.push(`**${meta.title}**`);
+            }
+            else {
+                lines.push(`**${config.name}**`);
+            }
+        }
+        if (sections.includes('subtitle') && meta.subtitle) {
+            lines.push(meta.subtitle);
+        }
+        if (sections.includes('purpose') && meta.purpose) {
+            lines.push(`用途: ${meta.purpose}`);
+        }
+        if (sections.includes('input') && meta.input) {
+            if (meta.input.type) {
+                lines.push(`输入: ${meta.input.type}`);
+                if (meta.input.example) {
+                    lines.push(`  示例: ${meta.input.example}`);
+                }
+            }
+        }
+        if (sections.includes('output') && meta.output) {
+            if (meta.output.description) {
+                lines.push(`输出: ${meta.output.description}`);
+            }
+            if (meta.output.formats) {
+                lines.push(`  格式: ${meta.output.formats.join(', ')}`);
+            }
+        }
+        if (sections.includes('patterns')) {
+            const design = config.design;
+            if (design?.patterns && design.patterns.length > 0) {
+                const patternNames = design.patterns.map((p) => p.name).join(', ');
+                lines.push(`设计模式: ${patternNames}`);
+            }
+        }
+        if (sections.includes('principles')) {
+            const design = config.design;
+            if (design?.principles && design.principles.length > 0) {
+                lines.push(`原则: ${design.principles.join(', ')}`);
+            }
+        }
+        if (sections.includes('process')) {
+            const process = config.process;
+            if (process?.dataFlow) {
+                lines.push(`流程: ${process.dataFlow}`);
+            }
+        }
+        if (lines.length === 0) {
+            return '';
+        }
+        const content = lines.join('\n');
+        return `\nnote for Diagram "${content}"\n`;
+    }
+}
+//# sourceMappingURL=comment-generator.js.map