@egentica/codemap 0.1.5

package/dist/core/LineRangeWriter.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Line range write operations.
+ *
+ * Handles smart replacement of line ranges in files:
+ * - Content shorter than range → file shrinks
+ * - Content longer than range → file expands
+ * - Content same as range → exact replacement
+ *
+ * @example
+ * ```typescript
+ * const writer = new LineRangeWriter(fsProvider);
+ *
+ * // Replace lines 50-52 (3 lines) with 5 lines of new content
+ * await writer.replaceLines('TaskCard.vue', { start: 50, end: 52 },
+ *   'line1\nline2\nline3\nline4\nline5'
+ * );
+ * // Result: Lines 50-52 deleted, 5 new lines inserted, file grows by 2 lines
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineRangeWriter = void 0;
+class LineRangeWriter {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Replace a line range in a file with new content.
+     *
+     * Line numbers are 1-indexed and inclusive.
+     *
+     * @param filePath - Path to file
+     * @param lineRange - Lines to replace (1-indexed, inclusive)
+     * @param newContent - New content (may be multiple lines)
+     * @returns Result with line count changes
+     */
+    async replaceLines(filePath, lineRange, newContent) {
+        try {
+            // Validate file exists
+            const exists = await this.storage.exists(filePath);
+            if (!exists) {
+                return {
+                    ok: false,
+                    linesRemoved: 0,
+                    linesAdded: 0,
+                    netChange: 0,
+                    error: `File not found: ${filePath}`
+                };
+            }
+            // Read current content
+            const currentContent = await this.storage.read(filePath);
+            const lines = currentContent.split('\n');
+            // Convert 1-indexed to 0-indexed
+            const startIdx = lineRange.start - 1;
+            const endIdx = lineRange.end - 1;
+            // Validate range
+            if (startIdx < 0 || endIdx >= lines.length) {
+                return {
+                    ok: false,
+                    linesRemoved: 0,
+                    linesAdded: 0,
+                    netChange: 0,
+                    error: `Invalid line range ${lineRange.start}-${lineRange.end} for file with ${lines.length} lines`
+                };
+            }
+            if (startIdx > endIdx) {
+                return {
+                    ok: false,
+                    linesRemoved: 0,
+                    linesAdded: 0,
+                    netChange: 0,
+                    error: `Line range start (${lineRange.start}) cannot be greater than end (${lineRange.end})`
+                };
+            }
+            // Split new content into lines
+            const newLines = newContent.split('\n');
+            // Perform replacement
+            const before = lines.slice(0, startIdx);
+            const after = lines.slice(endIdx + 1);
+            const result = [...before, ...newLines, ...after];
+            // Write back
+            await this.storage.write(filePath, result.join('\n'));
+            const linesRemoved = endIdx - startIdx + 1;
+            const linesAdded = newLines.length;
+            const netChange = linesAdded - linesRemoved;
+            return {
+                ok: true,
+                linesRemoved,
+                linesAdded,
+                netChange
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                linesRemoved: 0,
+                linesAdded: 0,
+                netChange: 0,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Replace line ranges in multiple files.
+     *
+     * @param operations - Array of line range write operations
+     * @returns Array of results (one per operation)
+     */
+    async replaceMany(operations) {
+        const results = [];
+        for (const op of operations) {
+            const result = await this.replaceLines(op.filePath, op.lineRange, op.content);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Insert content at a specific line (without replacing).
+     *
+     * @param filePath - Path to file
+     * @param lineNumber - Line number to insert at (1-indexed)
+     * @param content - Content to insert
+     * @returns Result with line count changes
+     */
+    async insertAt(filePath, lineNumber, content) {
+        try {
+            const exists = await this.storage.exists(filePath);
+            if (!exists) {
+                return {
+                    ok: false,
+                    linesRemoved: 0,
+                    linesAdded: 0,
+                    netChange: 0,
+                    error: `File not found: ${filePath}`
+                };
+            }
+            const currentContent = await this.storage.read(filePath);
+            const lines = currentContent.split('\n');
+            // Convert 1-indexed to 0-indexed
+            const insertIdx = lineNumber - 1;
+            if (insertIdx < 0 || insertIdx > lines.length) {
+                return {
+                    ok: false,
+                    linesRemoved: 0,
+                    linesAdded: 0,
+                    netChange: 0,
+                    error: `Invalid line number ${lineNumber} for file with ${lines.length} lines`
+                };
+            }
+            // Split new content
+            const newLines = content.split('\n');
+            // Insert at position
+            const result = [
+                ...lines.slice(0, insertIdx),
+                ...newLines,
+                ...lines.slice(insertIdx)
+            ];
+            await this.storage.write(filePath, result.join('\n'));
+            return {
+                ok: true,
+                linesRemoved: 0,
+                linesAdded: newLines.length,
+                netChange: newLines.length
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                linesRemoved: 0,
+                linesAdded: 0,
+                netChange: 0,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+}
+exports.LineRangeWriter = LineRangeWriter;
+//# sourceMappingURL=LineRangeWriter.js.map

package/dist/core/LineRangeWriter.js.map

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

package/dist/core/ParserRegistry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ParserRegistry - Bundled parser registration and extension mapping.
+ *
+ * Directly imports and registers bundled parsers (TypeScript and Vue).
+ * Maps file extensions to parsers for quick lookup.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ParserRegistry();
+ * await registry.autoloadParsers(codemap);
+ *
+ * // Parsers auto-hook via event bus:
+ * // codemap.on('scan:file', (payload) => {
+ * //   if (parser.canParse(file)) {
+ * //     file.symbols = parser.parse(file);
+ * //   }
+ * // });
+ * ```
+ */
+import type { Plugin } from '../types/contracts/Plugin.js';
+import type { CodeMapHost } from '../types/contracts/Plugin.js';
+export declare class ParserRegistry {
+    private parsers;
+    private extensionMap;
+    /**
+     * Auto-register bundled parsers (TypeScript and Vue).
+     *
+     * @param codemap - CodeMap instance for event registration
+     * @param config - Configuration object (unused, kept for compatibility)
+     */
+    autoloadParsers(codemap: CodeMapHost, config?: any): Promise<void>;
+    /**
+     * Register a parser and map its extensions.
+     *
+     * The parser is registered with CodeMap (which calls parser.register(codemap)),
+     * allowing it to hook into the event bus. Extensions are mapped for quick lookup.
+     *
+     * @param parser - Language parser plugin
+     * @param codemap - CodeMap instance for event registration
+     */
+    register(parser: any, codemap: any): Promise<void>;
+    /**
+     * Get parser for file extension.
+     *
+     * @param ext - File extension (e.g., '.ts', '.php')
+     * @returns Parser plugin or undefined
+     */
+    getParserForExtension(ext: string): Plugin | undefined;
+    /**
+     * Get all supported file extensions.
+     *
+     * @returns Array of extensions (e.g., ['.ts', '.js', '.php'])
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * Get all loaded parsers with their extensions.
+     *
+     * @returns Array of parser metadata
+     */
+    getLoadedParsers(): Array<{
+        name: string;
+        version: string;
+        extensions: string[];
+    }>;
+    /**
+     * Get total number of loaded parsers.
+     */
+    get count(): number;
+}
+//# sourceMappingURL=ParserRegistry.d.ts.map

package/dist/core/ParserRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParserRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ParserRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,YAAY,CAAkC;IAEtD;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E;;;;;;;;OAQG;IACG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD;;;;;OAKG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD;;;;OAIG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;;;OAIG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAQlF;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/core/ParserRegistry.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * ParserRegistry - Bundled parser registration and extension mapping.
+ *
+ * Directly imports and registers bundled parsers (TypeScript and Vue).
+ * Maps file extensions to parsers for quick lookup.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ParserRegistry();
+ * await registry.autoloadParsers(codemap);
+ *
+ * // Parsers auto-hook via event bus:
+ * // codemap.on('scan:file', (payload) => {
+ * //   if (parser.canParse(file)) {
+ * //     file.symbols = parser.parse(file);
+ * //   }
+ * // });
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParserRegistry = void 0;
+const index_js_1 = __importDefault(require("../plugins/parser-typescript/index.js"));
+const index_js_2 = __importDefault(require("../plugins/parser-vue/index.js"));
+class ParserRegistry {
+    parsers = new Map(); // name → parser
+    extensionMap = new Map(); // .ts → TypeScriptParser
+    /**
+     * Auto-register bundled parsers (TypeScript and Vue).
+     *
+     * @param codemap - CodeMap instance for event registration
+     * @param config - Configuration object (unused, kept for compatibility)
+     */
+    async autoloadParsers(codemap, config = {}) {
+        // Register bundled parsers
+        const typescriptParser = new index_js_1.default();
+        const vueParser = new index_js_2.default();
+        // @ts-ignore
+        const oldConfig = config.typescript ?? {};
+        this.register(typescriptParser, codemap);
+        this.register(vueParser, codemap);
+    }
+    /**
+     * Register a parser and map its extensions.
+     *
+     * The parser is registered with CodeMap (which calls parser.register(codemap)),
+     * allowing it to hook into the event bus. Extensions are mapped for quick lookup.
+     *
+     * @param parser - Language parser plugin
+     * @param codemap - CodeMap instance for event registration
+     */
+    async register(parser, codemap) {
+        this.parsers.set(parser.name, parser);
+        // Register with CodeMap's PluginRegistry (CRITICAL for getParserForFile to work)
+        if (codemap.registerPlugin && typeof codemap.registerPlugin === 'function') {
+            await codemap.registerPlugin(parser);
+        }
+        else {
+            // Fallback: call parser.register() directly (old behavior)
+            parser.register(codemap);
+        }
+        // Map extensions for quick lookup
+        if (parser.fileExtensions) {
+            for (const ext of parser.fileExtensions) {
+                this.extensionMap.set(ext, parser);
+            }
+        }
+    }
+    /**
+     * Get parser for file extension.
+     *
+     * @param ext - File extension (e.g., '.ts', '.php')
+     * @returns Parser plugin or undefined
+     */
+    getParserForExtension(ext) {
+        return this.extensionMap.get(ext);
+    }
+    /**
+     * Get all supported file extensions.
+     *
+     * @returns Array of extensions (e.g., ['.ts', '.js', '.php'])
+     */
+    getSupportedExtensions() {
+        return Array.from(this.extensionMap.keys()).sort();
+    }
+    /**
+     * Get all loaded parsers with their extensions.
+     *
+     * @returns Array of parser metadata
+     */
+    getLoadedParsers() {
+        return Array.from(this.parsers.values()).map(p => ({
+            name: p.name,
+            version: p.version,
+            extensions: p.fileExtensions || []
+        }));
+    }
+    /**
+     * Get total number of loaded parsers.
+     */
+    get count() {
+        return this.parsers.size;
+    }
+}
+exports.ParserRegistry = ParserRegistry;
+//# sourceMappingURL=ParserRegistry.js.map

package/dist/core/ParserRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParserRegistry.js","sourceRoot":"","sources":["../../src/core/ParserRegistry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;AAIH,qFAAqE;AACrE,8EAAuD;AAEvD,MAAa,cAAc;IACjB,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,gBAAgB;IAC1D,YAAY,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,yBAAyB;IAEhF;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAoB,EAAE,SAAc,EAAE;QAC1D,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,IAAI,kBAAgB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,kBAAS,EAAE,CAAC;QAClC,aAAa;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAW,EAAE,OAAY;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtC,iFAAiF;QACjF,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC3E,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,2DAA2D;YAC3D,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,kCAAkC;QAClC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,GAAW;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,EAAG,CAAS,CAAC,IAAI;YACrB,OAAO,EAAG,CAAS,CAAC,OAAO;YAC3B,UAAU,EAAG,CAAS,CAAC,cAAc,IAAI,EAAE;SAC5C,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAtFD,wCAsFC"}

package/dist/core/PluginRegistry.d.ts

@@ -0,0 +1,120 @@
+/**
+ * PluginRegistry - Central plugin management for CodeMap.
+ *
+ * Discovers, registers, and manages plugin lifecycle.
+ * Plugins register hooks via the CodeMapHost interface.
+ *
+ * Architecture:
+ * - Plugins register via registry.register(plugin)
+ * - Each plugin receives CodeMapHost interface to hook into events
+ * - Registry tracks all registered plugins for lifecycle management
+ * - Supports plugin unregistration for cleanup
+ *
+ * @example
+ * ```typescript
+ * const registry = new PluginRegistry(codemap);
+ *
+ * // Register a language parser
+ * registry.register(new TypeScriptParser());
+ *
+ * // Register TimeWarp plugin
+ * registry.register(new TimeWarpPlugin());
+ *
+ * // Cleanup on shutdown
+ * await registry.unregisterAll();
+ * ```
+ */
+import type { Plugin } from '../types/contracts/Plugin';
+import type { CodeMapHost } from '../types/contracts/Plugin';
+export declare class PluginRegistry {
+    private plugins;
+    private codemap;
+    constructor(codemap: CodeMapHost);
+    /**
+     * Auto-discover and register all available plugin packages.
+     *
+     * Loads plugins in two phases:
+     * 1. First-party plugins: Auto-discover @egentica/codemap-plugin-* packages
+     * 2. Third-party plugins: Load from config.plugins array
+     *
+     * Silently skips packages that are not installed.
+     *
+     * @param config - Configuration object (may contain plugins array)
+     */
+    autoloadPlugins(config?: any): Promise<void>;
+    /**
+     * Register a plugin with CodeMap.
+     *
+     * Calls plugin.register(codemap) to let the plugin hook into events.
+     * If plugin has initialize() method, calls it for async setup.
+     * Plugin name must be unique.
+     *
+     * @param plugin - Plugin to register
+     * @throws Error if plugin with same name already registered
+     */
+    register(plugin: Plugin): Promise<void>;
+    /**
+     * Unregister a plugin by name.
+     *
+     * Calls plugin.unregister() if defined.
+     * Removes plugin from registry.
+     *
+     * Note: Does NOT automatically remove event handlers.
+     * Plugins are responsible for cleanup in their unregister() method.
+     *
+     * @param name - Plugin name to unregister
+     * @returns True if plugin was found and unregistered
+     */
+    unregister(name: string): Promise<boolean>;
+    /**
+     * Unregister all plugins.
+     *
+     * Calls unregister() on each plugin sequentially.
+     * Useful for shutdown/cleanup.
+     */
+    unregisterAll(): Promise<void>;
+    /**
+     * Check if a plugin is registered.
+     *
+     * @param name - Plugin name to check
+     * @returns True if plugin is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Get a registered plugin by name.
+     *
+     * @param name - Plugin name
+     * @returns Plugin instance or undefined
+     */
+    get(name: string): Plugin | undefined;
+    /**
+     * Get all registered plugin names.
+     *
+     * @returns Array of plugin names
+     */
+    getRegisteredPlugins(): string[];
+    /**
+     * Get plugin count.
+     *
+     * @returns Number of registered plugins
+     */
+    get count(): number;
+    /**
+     * Get plugin metadata (name, version, registration time).
+     *
+     * @returns Array of plugin metadata
+     */
+    getPluginInfo(): Array<{
+        name: string;
+        version: string;
+        registeredAt: number;
+    }>;
+    /**
+     * Get a language parser that can handle the given file.
+     *
+     * @param filePath - File path to find parser for
+     * @returns LanguageParser instance or undefined
+     */
+    getParserForFile(filePath: string): any | undefined;
+}
+//# sourceMappingURL=PluginRegistry.d.ts.map

package/dist/core/PluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"","sources":["../../src/core/PluginRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAW7D,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,WAAW;IAKhC;;;;;;;;;;OAUG;IACG,eAAe,CAAC,MAAM,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBtD;;;;;;;;;OASG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAchD;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrC;;;;OAIG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,aAAa,IAAI,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAQF;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;CAcpD"}