@mycodemap/mycodemap 0.1.0

package/dist/plugins/plugin-loader.js

@@ -0,0 +1,200 @@
+// ============================================
+// CodeMap 插件加载器
+// 负责动态加载插件
+// ============================================
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { PluginRegistry } from './plugin-registry.js';
+// 获取当前文件目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// 默认插件目录
+const DEFAULT_PLUGIN_DIR = path.join(__dirname, 'built-in');
+// 简单内存缓存实现
+class SimpleCache {
+    cache = new Map();
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return undefined;
+        if (item.ttl && Date.now() > item.ttl) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return item.value;
+    }
+    set(key, value, ttl) {
+        this.cache.set(key, {
+            value,
+            ttl: ttl ? Date.now() + ttl : undefined,
+        });
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+// 控制台日志实现
+class ConsoleLogger {
+    debugEnabled;
+    constructor(debug = false) {
+        this.debugEnabled = debug;
+    }
+    debug(message, ...args) {
+        if (this.debugEnabled) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        console.log(`[INFO] ${message}`, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(`[WARN] ${message}`, ...args);
+    }
+    error(message, ...args) {
+        console.error(`[ERROR] ${message}`, ...args);
+    }
+}
+// 插件加载器
+export class PluginLoader {
+    registry;
+    logger;
+    cache;
+    config;
+    constructor(config, logger, debug = false) {
+        this.config = config;
+        this.logger = logger || new ConsoleLogger(debug);
+        this.cache = new SimpleCache();
+        this.registry = new PluginRegistry();
+    }
+    // 获取插件上下文
+    createContext() {
+        return {
+            config: this.config,
+            logger: this.logger,
+            cache: this.cache,
+        };
+    }
+    // 获取注册表
+    getRegistry() {
+        return this.registry;
+    }
+    // 加载内置插件
+    async loadBuiltInPlugins() {
+        this.logger.info('Loading built-in plugins...');
+        // 动态导入内置插件
+        const builtInPlugins = [
+            { name: 'complexity-analyzer', plugin: (await import('./built-in/complexity-analyzer.js')).default },
+            { name: 'call-graph', plugin: (await import('./built-in/call-graph.js')).default },
+        ];
+        for (const { name, plugin } of builtInPlugins) {
+            try {
+                if (plugin && plugin.metadata) {
+                    await this.registry.register(plugin);
+                }
+            }
+            catch (error) {
+                // 忽略加载失败的内置插件
+                this.logger.debug(`Built-in plugin load skipped: ${error}`);
+            }
+        }
+    }
+    // 从目录加载插件
+    async loadFromDirectory(pluginDir) {
+        this.logger.info(`Loading plugins from directory: ${pluginDir}`);
+        try {
+            const entries = await fs.readdir(pluginDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.endsWith('.js')) {
+                    continue;
+                }
+                const pluginPath = path.join(pluginDir, entry.name);
+                await this.loadPluginFile(pluginPath);
+            }
+        }
+        catch (error) {
+            this.logger.warn(`Failed to load plugins from directory: ${error}`);
+        }
+    }
+    // 从文件加载单个插件
+    async loadPluginFile(pluginPath) {
+        try {
+            this.logger.debug(`Loading plugin from: ${pluginPath}`);
+            const module = await import(pluginPath);
+            const plugin = module.default || module.plugin;
+            if (!plugin) {
+                this.logger.warn(`No plugin export found in: ${pluginPath}`);
+                return;
+            }
+            const pluginInstance = typeof plugin === 'function' ? await plugin() : plugin;
+            await this.registry.register(pluginInstance);
+        }
+        catch (error) {
+            this.logger.error(`Failed to load plugin from ${pluginPath}: ${error}`);
+        }
+    }
+    // 加载指定名称的插件
+    async loadPluginByName(pluginName, pluginDir) {
+        const pluginPath = path.join(pluginDir, `${pluginName}.js`);
+        try {
+            await this.loadPluginFile(pluginPath);
+        }
+        catch (error) {
+            // 尝试作为 Node.js 模块加载
+            try {
+                const module = await import(pluginName);
+                const plugin = module.default || module.plugin;
+                if (plugin) {
+                    const pluginInstance = typeof plugin === 'function' ? await plugin() : plugin;
+                    await this.registry.register(pluginInstance);
+                }
+            }
+            catch {
+                this.logger.warn(`Plugin "${pluginName}" not found`);
+            }
+        }
+    }
+    // 加载所有插件
+    async load(options = {}) {
+        const { builtInPlugins = true, pluginDir = DEFAULT_PLUGIN_DIR, plugins = [] } = options;
+        // 设置插件上下文
+        const context = this.createContext();
+        this.registry.setContext(context);
+        // 加载内置插件
+        if (builtInPlugins) {
+            await this.loadBuiltInPlugins();
+        }
+        // 从目录加载
+        if (pluginDir) {
+            await this.loadFromDirectory(pluginDir);
+        }
+        // 加载指定插件
+        for (const pluginName of plugins) {
+            await this.loadPluginByName(pluginName, pluginDir);
+        }
+        // 初始化所有插件
+        await this.registry.initializeAll();
+        this.logger.info(`Loaded ${this.registry.size()} plugin(s)`);
+    }
+    // 重新加载插件
+    async reload(name) {
+        await this.registry.unregister(name);
+        // TODO: 实现真正的热重载
+        this.logger.info(`Plugin "${name}" reloaded`);
+    }
+    // 销毁
+    async dispose() {
+        await this.registry.disposeAll();
+        this.logger.info('Plugin loader disposed');
+    }
+}
+// 便捷函数：创建并加载插件
+export async function createPluginLoader(config, options = {}) {
+    const loader = new PluginLoader(config, undefined, options.debug);
+    await loader.load(options);
+    return loader;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/plugins/plugin-loader.js.map

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

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

@@ -0,0 +1,20 @@
+import type { CodeMapPlugin, PluginInstance, PluginContext, PluginStatus, AnalysisResult, GeneratedOutput } from './types.js';
+import type { ModuleInfo, CodeMap } from '../types/index.js';
+export declare class PluginRegistry {
+    private plugins;
+    private context;
+    setContext(context: PluginContext): void;
+    register(plugin: CodeMapPlugin): Promise<void>;
+    initializeAll(): Promise<void>;
+    runAnalyze(modules: ModuleInfo[]): Promise<Map<string, AnalysisResult>>;
+    runGenerate(codeMap: CodeMap): Promise<Map<string, GeneratedOutput>>;
+    get(name: string): PluginInstance | undefined;
+    getAllNames(): string[];
+    getInitialized(): string[];
+    getStatus(name: string): PluginStatus | undefined;
+    has(name: string): boolean;
+    unregister(name: string): Promise<void>;
+    disposeAll(): Promise<void>;
+    size(): number;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9H,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,OAAO,CAA8B;IAG7C,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKlC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAuBvE,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IA0B1E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAK7C,WAAW,IAAI,MAAM,EAAE;IAKvB,cAAc,IAAI,MAAM,EAAE;IAW1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKjD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,IAAI,IAAI,MAAM;CAGf"}

package/dist/plugins/plugin-registry.js

@@ -0,0 +1,143 @@
+// ============================================
+// CodeMap 插件注册表
+// 管理已加载的插件
+// ============================================
+export class PluginRegistry {
+    plugins = new Map();
+    context = null;
+    // 设置插件上下文
+    setContext(context) {
+        this.context = context;
+    }
+    // 注册插件
+    async register(plugin) {
+        const name = plugin.metadata.name;
+        if (this.plugins.has(name)) {
+            this.context?.logger.warn(`Plugin "${name}" is already registered, skipping...`);
+            return;
+        }
+        const instance = {
+            plugin,
+            status: 'loaded',
+            loadTime: Date.now(),
+        };
+        this.plugins.set(name, instance);
+        this.context?.logger.info(`Plugin "${name}" v${plugin.metadata.version} registered`);
+    }
+    // 初始化所有插件
+    async initializeAll() {
+        if (!this.context) {
+            throw new Error('Plugin context not set');
+        }
+        for (const [name, instance] of this.plugins) {
+            try {
+                this.context.logger.info(`Initializing plugin "${name}"...`);
+                await instance.plugin.initialize(this.context);
+                instance.status = 'initialized';
+                this.context.logger.info(`Plugin "${name}" initialized successfully`);
+            }
+            catch (error) {
+                instance.status = 'error';
+                instance.error = error instanceof Error ? error : new Error(String(error));
+                this.context.logger.error(`Failed to initialize plugin "${name}": ${instance.error.message}`);
+                throw error;
+            }
+        }
+    }
+    // 运行所有插件的分析钩子
+    async runAnalyze(modules) {
+        const results = new Map();
+        for (const [name, instance] of this.plugins) {
+            if (instance.status !== 'initialized' || !instance.plugin.analyze) {
+                continue;
+            }
+            try {
+                this.context?.logger.info(`Running analyze hook for plugin "${name}"...`);
+                const result = await instance.plugin.analyze(modules);
+                results.set(name, result);
+                instance.status = 'running';
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.context?.logger.error(`Plugin "${name}" analyze hook failed: ${err.message}`);
+            }
+        }
+        return results;
+    }
+    // 运行所有插件的生成钩子
+    async runGenerate(codeMap) {
+        const results = new Map();
+        for (const [name, instance] of this.plugins) {
+            if (instance.status !== 'running' && instance.status !== 'initialized') {
+                continue;
+            }
+            if (!instance.plugin.generate) {
+                continue;
+            }
+            try {
+                this.context?.logger.info(`Running generate hook for plugin "${name}"...`);
+                const result = await instance.plugin.generate(codeMap);
+                results.set(name, result);
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.context?.logger.error(`Plugin "${name}" generate hook failed: ${err.message}`);
+            }
+        }
+        return results;
+    }
+    // 获取插件实例
+    get(name) {
+        return this.plugins.get(name);
+    }
+    // 获取所有插件名称
+    getAllNames() {
+        return Array.from(this.plugins.keys());
+    }
+    // 获取已初始化插件
+    getInitialized() {
+        const initialized = [];
+        for (const [name, instance] of this.plugins) {
+            if (instance.status === 'initialized' || instance.status === 'running') {
+                initialized.push(name);
+            }
+        }
+        return initialized;
+    }
+    // 获取插件状态
+    getStatus(name) {
+        return this.plugins.get(name)?.status;
+    }
+    // 检查插件是否已加载
+    has(name) {
+        return this.plugins.has(name);
+    }
+    // 移除插件
+    async unregister(name) {
+        const instance = this.plugins.get(name);
+        if (!instance) {
+            return;
+        }
+        try {
+            await instance.plugin.dispose();
+        }
+        catch (error) {
+            this.context?.logger.warn(`Error disposing plugin "${name}": ${error}`);
+        }
+        this.plugins.delete(name);
+        this.context?.logger.info(`Plugin "${name}" unregistered`);
+    }
+    // 销毁所有插件
+    async disposeAll() {
+        const names = Array.from(this.plugins.keys());
+        for (const name of names) {
+            await this.unregister(name);
+        }
+        this.context?.logger.info('All plugins disposed');
+    }
+    // 获取插件数量
+    size() {
+        return this.plugins.size;
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

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

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,72 @@
+import type { CodemapConfig, ModuleInfo, CodeMap } from '../types/index.js';
+export interface PluginLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export interface PluginCache {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttl?: number): void;
+    delete(key: string): void;
+    clear(): void;
+}
+export interface PluginContext {
+    config: CodemapConfig;
+    logger: PluginLogger;
+    cache: PluginCache;
+}
+export interface AnalysisResult {
+    moduleData?: Record<string, ModuleInfo>;
+    additionalEdges?: Array<{
+        from: string;
+        to: string;
+        type: string;
+        weight?: number;
+    }>;
+    metrics?: Record<string, unknown>;
+    warnings?: string[];
+}
+export interface GeneratedOutput {
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    append?: Array<{
+        path: string;
+        content: string;
+    }>;
+    data?: Record<string, unknown>;
+}
+export interface PluginHooks {
+    analyze?: (modules: ModuleInfo[]) => Promise<AnalysisResult>;
+    generate?: (codeMap: CodeMap) => Promise<GeneratedOutput>;
+}
+export interface PluginMetadata {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    keywords?: string[];
+}
+export interface CodeMapPlugin {
+    metadata: PluginMetadata;
+    initialize(context: PluginContext): Promise<void>;
+    analyze?(modules: ModuleInfo[]): Promise<AnalysisResult>;
+    generate?(codeMap: CodeMap): Promise<GeneratedOutput>;
+    dispose(): Promise<void>;
+}
+export interface PluginLoadOptions {
+    pluginDir?: string;
+    builtInPlugins?: boolean;
+    plugins?: string[];
+    debug?: boolean;
+}
+export type PluginStatus = 'loaded' | 'initialized' | 'running' | 'disposed' | 'error';
+export interface PluginInstance {
+    plugin: CodeMapPlugin;
+    status: PluginStatus;
+    loadTime: number;
+    error?: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

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

package/dist/plugins/types.js

@@ -0,0 +1,5 @@
+// ============================================
+// CodeMap 插件类型定义
+// ============================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C"}