@yalehwang/archguard 0.1.0

package/dist/cli/config-loader.js

@@ -0,0 +1,259 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { z } from 'zod';
+const MermaidConfigSchema = z.object({
+    renderer: z.enum(['isomorphic', 'cli']).default('isomorphic'),
+    theme: z.enum(['default', 'forest', 'dark', 'neutral']).default('default'),
+    transparentBackground: z.boolean().default(false),
+});
+const DiagramMetadataSchema = z.object({
+    title: z.string().optional(),
+    subtitle: z.string().optional(),
+    purpose: z.string().optional(),
+    primaryActors: z.array(z.string()).optional(),
+    input: z
+        .object({
+        type: z.string(),
+        description: z.string().optional(),
+        example: z.string().optional(),
+    })
+        .optional(),
+    output: z
+        .object({
+        description: z.string(),
+        formats: z.array(z.string()).optional(),
+        example: z.string().optional(),
+    })
+        .optional(),
+});
+const DesignPatternInfoSchema = z.object({
+    name: z.string(),
+    category: z.enum(['creational', 'structural', 'behavioral', 'concurrency']),
+    participants: z.array(z.string()),
+    description: z.string(),
+    codeExample: z.string().optional(),
+});
+const DesignInfoSchema = z.object({
+    architectureStyle: z.enum(['layered', 'event-driven', 'microkernel', 'serverless']).optional(),
+    patterns: z.array(DesignPatternInfoSchema).optional(),
+    principles: z.array(z.string()).optional(),
+    decisions: z
+        .array(z.object({
+        topic: z.string(),
+        decision: z.string(),
+        rationale: z.string(),
+        alternatives: z.array(z.string()).optional(),
+    }))
+        .optional(),
+});
+const ProcessStageSchema = z.object({
+    order: z.number(),
+    name: z.string(),
+    description: z.string(),
+    namespace: z.string().optional(),
+    patterns: z.array(z.string()).optional(),
+});
+const ProcessInfoSchema = z.object({
+    stages: z.number().optional(),
+    stageList: z.array(ProcessStageSchema).optional(),
+    dataFlow: z.string().optional(),
+    keyDependencies: z.array(z.string()).optional(),
+});
+const AnnotationConfigSchema = z.object({
+    enableComments: z.boolean().optional(),
+    highlightPatterns: z.boolean().optional(),
+    showExternalDeps: z.boolean().optional(),
+    includeUsageExample: z.boolean().optional(),
+    enableVisibleTitle: z.boolean().optional(),
+    visibleTitleSections: z
+        .array(z.enum([
+        'title',
+        'subtitle',
+        'purpose',
+        'input',
+        'output',
+        'patterns',
+        'principles',
+        'process',
+    ]))
+        .optional(),
+    titlePosition: z.enum(['top', 'bottom']).optional(),
+});
+const ClassAnnotationSchema = z.object({
+    className: z.string(),
+    note: z.string().optional(),
+    stereotypes: z.array(z.string()).optional(),
+    responsibility: z.string().optional(),
+});
+const ClassHighlightConfigSchema = z.object({
+    highlightClasses: z.array(z.string()).optional(),
+    annotateClasses: z.array(ClassAnnotationSchema).optional(),
+    visibility: z
+        .object({
+        show: z.array(z.string()).optional(),
+        hide: z.array(z.string()).optional(),
+    })
+        .optional(),
+});
+const configSchema = z.object({
+    outputDir: z.string().default('./.archguard'),
+    format: z.enum(['mermaid', 'json']).default('mermaid'),
+    mermaid: MermaidConfigSchema.default({}),
+    exclude: z.array(z.string()).default(['**/*.test.ts', '**/*.spec.ts', '**/node_modules/**']),
+    cli: z
+        .object({
+        command: z.string().default('claude'),
+        args: z.array(z.string()).default([]),
+        timeout: z.number().default(60000),
+    })
+        .default({
+        command: 'claude',
+        args: [],
+        timeout: 60000,
+    }),
+    cache: z
+        .object({
+        enabled: z.boolean().default(true),
+        ttl: z.number().default(86400),
+    })
+        .default({
+        enabled: true,
+        ttl: 86400,
+    }),
+    concurrency: z.number().default(os.cpus().length),
+    verbose: z.boolean().default(false),
+    metadata: z
+        .object({
+        title: z.string().optional(),
+        description: z.string().optional(),
+        system: z.string().optional(),
+        author: z.string().optional(),
+        projectUrl: z.string().optional(),
+        keywords: z.array(z.string()).optional(),
+    })
+        .optional(),
+    diagrams: z
+        .array(z.object({
+        name: z.string(),
+        sources: z.array(z.string()),
+        level: z.enum(['package', 'class', 'method']),
+        description: z.string().optional(),
+        format: z.enum(['mermaid', 'json']).optional(),
+        exclude: z.array(z.string()).optional(),
+        metadata: DiagramMetadataSchema.optional(),
+        design: DesignInfoSchema.optional(),
+        process: ProcessInfoSchema.optional(),
+        annotations: AnnotationConfigSchema.optional(),
+        classes: ClassHighlightConfigSchema.optional(),
+    }))
+        .default([]),
+});
+export class ConfigLoader {
+    configDir;
+    constructor(configDir = process.cwd()) {
+        this.configDir = configDir;
+    }
+    async load(cliOptions = {}, configPath) {
+        const fileConfig = await this.loadFromFile(configPath);
+        const normalized = this.normalizeConfig(fileConfig);
+        const merged = this.deepMerge(normalized, cliOptions);
+        try {
+            return configSchema.parse(merged);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const issues = error.issues
+                    .map((issue) => {
+                    const path = issue.path.join('.');
+                    return `  - ${path}: ${issue.message}`;
+                })
+                    .join('\n');
+                throw new Error(`Configuration validation failed:\n${issues}`);
+            }
+            throw error;
+        }
+    }
+    normalizeConfig(config) {
+        return { ...config };
+    }
+    deepMerge(target, source) {
+        const output = { ...target };
+        if (this.isObject(target) && this.isObject(source)) {
+            Object.keys(source).forEach((key) => {
+                const sourceValue = source[key];
+                if (sourceValue && this.isObject(sourceValue)) {
+                    if (!(key in target)) {
+                        output[key] = sourceValue;
+                    }
+                    else {
+                        const targetValue = target[key];
+                        if (targetValue && this.isObject(targetValue)) {
+                            output[key] = this.deepMerge(targetValue, sourceValue);
+                        }
+                    }
+                }
+                else if (sourceValue !== undefined) {
+                    output[key] = sourceValue;
+                }
+            });
+        }
+        return output;
+    }
+    isObject(item) {
+        return item !== null && typeof item === 'object' && !Array.isArray(item);
+    }
+    async loadFromFile(configPath) {
+        if (configPath) {
+            const resolvedPath = path.resolve(configPath);
+            if (await fs.pathExists(resolvedPath)) {
+                if (resolvedPath.endsWith('.json')) {
+                    return await fs.readJson(resolvedPath);
+                }
+                else if (resolvedPath.endsWith('.js')) {
+                    const module = await import(`file://${resolvedPath}`);
+                    return module.default ?? module;
+                }
+            }
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        const jsonPath = path.join(this.configDir, 'archguard.config.json');
+        if (await fs.pathExists(jsonPath)) {
+            return await fs.readJson(jsonPath);
+        }
+        const jsPath = path.join(this.configDir, 'archguard.config.js');
+        if (await fs.pathExists(jsPath)) {
+            const module = await import(`file://${jsPath}`);
+            return module.default ?? module;
+        }
+        return {};
+    }
+    async init(options = {}) {
+        const format = options.format ?? 'json';
+        const configPath = path.join(this.configDir, `archguard.config.${format}`);
+        if (await fs.pathExists(configPath)) {
+            throw new Error('Configuration file already exists');
+        }
+        const defaultConfig = configSchema.parse({});
+        if (format === 'json') {
+            await fs.writeJson(configPath, defaultConfig, { spaces: 2 });
+        }
+        else {
+            const jsContent = `export default ${JSON.stringify(defaultConfig, null, 2)};
+`;
+            await fs.writeFile(configPath, jsContent);
+        }
+    }
+    async getConfigPath() {
+        const jsonPath = path.join(this.configDir, 'archguard.config.json');
+        if (await fs.pathExists(jsonPath)) {
+            return jsonPath;
+        }
+        const jsPath = path.join(this.configDir, 'archguard.config.js');
+        if (await fs.pathExists(jsPath)) {
+            return jsPath;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/cli/config-loader.js.map

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

package/dist/cli/error-handler.d.ts

@@ -0,0 +1,15 @@
+export interface ErrorFormatOptions {
+    color?: boolean;
+    verbose?: boolean;
+}
+export declare class ErrorHandler {
+    format(error: unknown, options?: ErrorFormatOptions): string;
+    private formatParseError;
+    private formatAPIError;
+    private formatValidationError;
+    private formatFileError;
+    private formatGenericError;
+    private formatStringError;
+    private formatUnknownError;
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/cli/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/cli/error-handler.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAYD,qBAAa,YAAY;IAIvB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM;IA0ChE,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/cli/error-handler.js

@@ -0,0 +1,127 @@
+import chalk from 'chalk';
+import { ParseError, APIError, ValidationError, FileError } from './errors.js';
+export class ErrorHandler {
+    format(error, options = {}) {
+        const { color = true, verbose = false } = options;
+        if (error === null || error === undefined) {
+            return this.formatUnknownError(color);
+        }
+        if (typeof error === 'string') {
+            return this.formatStringError(error, color);
+        }
+        if (error instanceof ParseError) {
+            return this.formatParseError(error, color);
+        }
+        if (error instanceof APIError) {
+            return this.formatAPIError(error, color);
+        }
+        if (error instanceof ValidationError) {
+            return this.formatValidationError(error, color);
+        }
+        if (error instanceof FileError) {
+            return this.formatFileError(error, color);
+        }
+        if (error instanceof Error) {
+            return this.formatGenericError(error, color, verbose);
+        }
+        return this.formatUnknownError(color);
+    }
+    formatParseError(error, useColor) {
+        const title = useColor ? chalk.red.bold('Parse Error') : 'Parse Error';
+        let location = error.filePath;
+        if (error.line !== undefined) {
+            location += `:${error.line}`;
+        }
+        if (error.column !== undefined) {
+            location += `:${error.column}`;
+        }
+        const locationStr = useColor ? chalk.cyan(location) : location;
+        const tipLabel = useColor ? chalk.yellow('Tip:') : 'Tip:';
+        return `
+${title}
+  ${locationStr}
+  ${error.message}
+
+${tipLabel} Check the syntax at the specified line.
+`;
+    }
+    formatAPIError(error, useColor) {
+        const title = useColor ? chalk.red.bold('API Error') : 'API Error';
+        const statusCode = useColor ? chalk.yellow(`[${error.statusCode}]`) : `[${error.statusCode}]`;
+        let suggestion = '';
+        if (error.statusCode === 429) {
+            suggestion = 'Please try again later or check your rate limits.';
+        }
+        else if (error.statusCode === 401 || error.statusCode === 403) {
+            suggestion = 'Ensure Claude Code CLI is properly installed and authenticated.';
+        }
+        else if (error.statusCode >= 500) {
+            suggestion = 'Claude API service may be temporarily unavailable. Please retry.';
+        }
+        const suggestionLabel = useColor ? chalk.yellow('Suggestion:') : 'Suggestion:';
+        return `
+${title} ${statusCode}
+  ${error.message}
+
+${suggestion ? `${suggestionLabel} ${suggestion}\n` : ''}`;
+    }
+    formatValidationError(error, useColor) {
+        const title = useColor ? chalk.red.bold('Validation Error') : 'Validation Error';
+        let message = `
+${title}
+  ${error.message}
+`;
+        if (error.suggestions.length > 0) {
+            const optionsLabel = useColor ? chalk.yellow('Available options:') : 'Available options:';
+            const options = error.suggestions.join(', ');
+            message += `\n${optionsLabel} ${options}\n`;
+        }
+        return message;
+    }
+    formatFileError(error, useColor) {
+        const title = useColor ? chalk.red.bold('File Error') : 'File Error';
+        const operation = error.operation.charAt(0).toUpperCase() + error.operation.slice(1);
+        const filePath = useColor ? chalk.cyan(error.filePath) : error.filePath;
+        return `
+${title}
+  Operation: ${operation}
+  File: ${filePath}
+  ${error.message}
+`;
+    }
+    formatGenericError(error, useColor, verbose) {
+        const title = useColor ? chalk.red.bold('Error') : 'Error';
+        let suggestion = '';
+        if (error.message.includes('ENOENT')) {
+            suggestion = 'File not found. Check if the path is correct.';
+        }
+        else if (error.message.includes('EACCES')) {
+            suggestion = 'Permission denied. Check file permissions.';
+        }
+        else if (error.message.includes('EADDRINUSE')) {
+            suggestion = 'Port already in use.';
+        }
+        const tipLabel = useColor ? chalk.yellow('Tip:') : 'Tip:';
+        const stack = verbose && error.stack ? `\n${error.stack}` : '';
+        return `
+${title}
+  ${error.message}
+
+${suggestion ? `${tipLabel} ${suggestion}\n` : ''}${stack}`;
+    }
+    formatStringError(error, useColor) {
+        const title = useColor ? chalk.red.bold('Error') : 'Error';
+        return `
+${title}
+  ${error}
+`;
+    }
+    formatUnknownError(useColor) {
+        const title = useColor ? chalk.red.bold('Error') : 'Error';
+        return `
+${title}
+  Unknown error occurred
+`;
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/cli/error-handler.js.map

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

package/dist/cli/errors.d.ts

@@ -0,0 +1,15 @@
+export { ParseError } from '../parser/errors.js';
+export declare class APIError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export declare class ValidationError extends Error {
+    readonly suggestions: string[];
+    constructor(message: string, suggestions?: string[]);
+}
+export declare class FileError extends Error {
+    readonly filePath: string;
+    readonly operation: 'read' | 'write' | 'delete' | 'create';
+    constructor(message: string, filePath: string, operation: 'read' | 'write' | 'delete' | 'create');
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKhD,qBAAa,QAAS,SAAQ,KAAK;aAGf,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAMrC;AAKD,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,WAAW,EAAE,MAAM,EAAE;gBADrC,OAAO,EAAE,MAAM,EACC,WAAW,GAAE,MAAM,EAAO;CAM7C;AAKD,qBAAa,SAAU,SAAQ,KAAK;aAGhB,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ;gBAFjE,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ;CAMpE"}

package/dist/cli/errors.js

@@ -0,0 +1,31 @@
+export { ParseError } from '../parser/errors.js';
+export class APIError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'APIError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+export class ValidationError extends Error {
+    suggestions;
+    constructor(message, suggestions = []) {
+        super(message);
+        this.suggestions = suggestions;
+        this.name = 'ValidationError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+export class FileError extends Error {
+    filePath;
+    operation;
+    constructor(message, filePath, operation) {
+        super(message);
+        this.filePath = filePath;
+        this.operation = operation;
+        this.name = 'FileError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKhD,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IAFlB,YACE,OAAe,EACC,UAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAKD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,cAAwB,EAAE;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,gBAAW,GAAX,WAAW,CAAe;QAG1C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAKD,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,QAAgB,EAChB,SAAiD;QAEjE,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAwC;QAGjE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare function createCLI(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,SAAS,IAAI,OAAO,CAcnC"}

package/dist/cli/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createAnalyzeCommand } from './commands/analyze.js';
+import { createCacheCommand } from './commands/cache.js';
+import { createInitCommand } from './commands/init.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+export function createCLI() {
+    const program = new Command();
+    program
+        .name('archguard')
+        .version(packageJson.version)
+        .description('ArchGuard - TypeScript Architecture Analyzer and Documentation Generator');
+    program.addCommand(createAnalyzeCommand());
+    program.addCommand(createCacheCommand());
+    program.addCommand(createInitCommand());
+    return program;
+}
+import * as fs from 'fs';
+import * as url from 'url';
+const isMain = process.argv[1] && import.meta.url === url.pathToFileURL(fs.realpathSync(process.argv[1])).href;
+if (isMain) {
+    const program = createCLI();
+    program.parse(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAKlD,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;SAC5B,WAAW,CAAC,0EAA0E,CAAC,CAAC;IAG3F,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAK3B,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClG,IAAI,MAAM,EAAE,CAAC;IACX,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/cli/processors/diagram-processor.d.ts

@@ -0,0 +1,61 @@
+import type { ParseCache } from '../../parser/parse-cache.js';
+import type { DiagramConfig, GlobalConfig } from '../../types/config.js';
+import type { ArchJSON } from '../../types/index.js';
+import type { ProgressReporter } from '../progress.js';
+import type { PluginRegistry } from '../../core/plugin-registry.js';
+export interface DiagramProcessorOptions {
+    diagrams: DiagramConfig[];
+    globalConfig: GlobalConfig;
+    progress: ProgressReporter;
+    parseCache?: ParseCache;
+    registry?: PluginRegistry;
+}
+export interface DiagramResult {
+    name: string;
+    success: boolean;
+    paths?: {
+        mmd?: string;
+        svg?: string;
+        png?: string;
+        json?: string;
+    };
+    stats?: {
+        entities: number;
+        relations: number;
+        parseTime: number;
+    };
+    error?: string;
+}
+export declare function deriveSubModuleArchJSON(parent: ArchJSON, subPath: string, workspaceRoot?: string): ArchJSON;
+export declare class DiagramProcessor {
+    private diagrams;
+    private globalConfig;
+    private progress;
+    private fileDiscovery;
+    private aggregator;
+    private metricsCalculator;
+    private parallelProgress?;
+    private parseCache?;
+    private registry?;
+    private archJsonDiskCache;
+    constructor(options: DiagramProcessorOptions);
+    processAll(): Promise<DiagramResult[]>;
+    private groupDiagramsBySource;
+    private hashSources;
+    private cacheArchJson;
+    private registerDeferred;
+    private findParentCoverage;
+    private archJsonCache;
+    private archJsonPathIndex;
+    private archJsonDeferred;
+    private processSourceGroup;
+    private processDiagramWithArchJSON;
+    private parseGoProject;
+    private parseCppProject;
+    private parseTsProject;
+    private generateOutput;
+    private generateAtlasOutput;
+    private generateTsModuleGraphOutput;
+    private generateCppPackageOutput;
+}
+//# sourceMappingURL=diagram-processor.d.ts.map

package/dist/cli/processors/diagram-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-processor.d.ts","sourceRoot":"","sources":["../../../src/cli/processors/diagram-processor.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAA6B,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAYhE,MAAM,WAAW,uBAAuB;IAEtC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAE1B,YAAY,EAAE,YAAY,CAAC;IAE3B,QAAQ,EAAE,gBAAgB,CAAC;IAM3B,UAAU,CAAC,EAAE,UAAU,CAAC;IAMxB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAKD,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,QAAQ,CAsGV;AAmBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAC,CAA2B;IACpD,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,OAAO,EAAE,uBAAuB;IA4BtC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAyE5C,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,aAAa,CAA+B;IAGpD,OAAO,CAAC,iBAAiB,CAA6B;IAOtD,OAAO,CAAC,gBAAgB,CAAwE;YASlF,kBAAkB;YAmMlB,0BAA0B;YA8G1B,cAAc;YAsBd,eAAe;YA2Bf,cAAc;YAwBd,cAAc;YA4Dd,mBAAmB;YAwGnB,2BAA2B;YA+D3B,wBAAwB;CAiDvC"}