@egentica/codemap 0.1.5

package/dist/types/label.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Label types for CodeMap labeling system.
+ *
+ * Labels provide visual organization with emoji-tagged metadata that can be
+ * assigned to files, directories, and symbols.
+ */
+/**
+ * Label definition with display properties.
+ */
+export interface Label {
+    /** Unique slug ID (e.g., "lbl_security_audit_001") */
+    id: string;
+    /** Single emoji character (e.g., "🔐") */
+    emoji: string;
+    /** Display name (spaces allowed, e.g., "Security Audit") */
+    name: string;
+    /** Full description */
+    description: string;
+    /** Optional background hex color (e.g., "#FF5733") */
+    bgColor?: string;
+    /** Optional foreground hex color (e.g., "#FFFFFF") */
+    fgColor?: string;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+}
+/**
+ * Type of target that can have labels assigned.
+ */
+export type LabelTargetType = 'file' | 'directory' | 'symbol';
+/**
+ * Label assignment linking a label to a target.
+ */
+export interface LabelAssignment {
+    /** Reference to label ID */
+    labelId: string;
+    /** Path for file/dir, or "path$symbol" for symbol */
+    target: string;
+    /** Type of target */
+    targetType: LabelTargetType;
+    /** Future: if directory, apply to children */
+    recursive?: boolean;
+    /** Assignment timestamp */
+    assignedAt: number;
+}
+/**
+ * Storage format for labels database.
+ */
+export interface LabelsData {
+    /** Version for future migrations */
+    version: number;
+    /** All label definitions, keyed by label ID */
+    labels: Record<string, Label>;
+    /** All assignments (flat array for wildcard operations) */
+    assignments: LabelAssignment[];
+}
+/**
+ * Result from label creation.
+ */
+export interface CreateLabelResult {
+    ok: boolean;
+    label?: Label;
+    error?: string;
+}
+/**
+ * Result from label editing.
+ */
+export interface EditLabelResult {
+    ok: boolean;
+    label?: Label;
+    error?: string;
+}
+/**
+ * Result from label assignment.
+ */
+export interface AssignLabelResult {
+    ok: boolean;
+    assigned: number;
+    targets: string[];
+    error?: string;
+}
+/**
+ * Result from label unassignment.
+ */
+export interface UnassignLabelResult {
+    ok: boolean;
+    unassigned: number;
+    error?: string;
+}
+/**
+ * Result from label migration.
+ */
+export interface MigrateLabelResult {
+    ok: boolean;
+    migrated: number;
+    error?: string;
+}
+/**
+ * Result from label deletion.
+ */
+export interface DeleteLabelResult {
+    ok: boolean;
+    unassigned?: number;
+    error?: string;
+}
+/**
+ * Paginated label list result.
+ */
+export interface LabelListResult {
+    labels: Array<Label & {
+        assignmentCount: number;
+    }>;
+    pagination: {
+        page: number;
+        pageSize: number;
+        totalLabels: number;
+        totalPages: number;
+    };
+}
+/**
+ * Label detail result with assignments.
+ */
+export interface LabelDetailResult {
+    label: Label;
+    assignments: LabelAssignment[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        totalAssignments: number;
+        totalPages: number;
+    };
+}
+/**
+ * Label search result.
+ */
+export interface LabelSearchResult {
+    results: Array<{
+        target: string;
+        targetType: LabelTargetType;
+        labels: Label[];
+    }>;
+    pagination: {
+        page: number;
+        pageSize: number;
+        totalResults: number;
+        totalPages: number;
+    };
+}
+//# sourceMappingURL=label.d.ts.map

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

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

package/dist/types/label.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Label types for CodeMap labeling system.
+ *
+ * Labels provide visual organization with emoji-tagged metadata that can be
+ * assigned to files, directories, and symbols.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=label.js.map

package/dist/types/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../../src/types/label.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/types/query.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Query system types for file and symbol discovery.
+ *
+ * QueryEngine provides search capabilities:
+ * - Text search (keyword matching in paths/content)
+ * - Symbol search (find symbols by name/kind)
+ * - Relevance ranking
+ */
+import type { FileEntry, SymbolEntry } from './core';
+import type { ResponseEnvelope } from './response';
+/**
+ * Search mode.
+ */
+export type SearchMode = 'text' | 'symbol' | 'hybrid';
+/**
+ * Search request.
+ */
+export interface SearchRequest {
+    /** Search query */
+    query: string;
+    /** Search mode */
+    mode?: SearchMode;
+    /** Maximum files to return (default: 5, ignored if includeFull: true) */
+    maxResults?: number;
+    /** Maximum symbols to show per file (default: 5, ignored if includeFull: true) */
+    maxSymbolsPerFile?: number;
+    /** Symbol display format: "full" for full objects, "compact" for comma-separated names (default: "full") */
+    symbolFormat?: 'full' | 'compact';
+    /** Include full results without pagination (default: false) */
+    includeFull?: boolean;
+    /** Treat query as regex pattern (default: false) */
+    useRegex?: boolean;
+    /** File extension filter */
+    extensions?: string[];
+    /** Path prefix filter */
+    pathPrefix?: string;
+    /** Symbol kind filter */
+    symbolKinds?: string[];
+}
+/**
+ * Search result (single file).
+ */
+export interface SearchResult {
+    /** File entry */
+    file: FileEntry;
+    /** Relevance score (0-1) */
+    relevance: number;
+    /** Match reasons */
+    reasons: string[];
+    /** Matched symbols (if any) */
+    matchedSymbols?: SymbolEntry[];
+    /**
+     * Plugin-extensible metadata for this search result.
+     * Namespace convention: metadata.{pluginName}.*
+     *
+     * Examples:
+     * - metadata.timewarp = { lastModified: '2026-03-30T12:00:00Z' }
+     * - metadata.analytics = { searchRank: 1, clickCount: 5 }
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Search response data (payload within ResponseEnvelope).
+ */
+export interface SearchResponseData {
+    /** Results (sorted by relevance) */
+    results: SearchResult[];
+    /** Total matches before limit */
+    totalMatches: number;
+    /** Contextual hints (if any) */
+    hints?: string[];
+}
+/**
+ * Search response (universal envelope).
+ *
+ * Envelope structure:
+ * - success: true
+ * - data: { results, totalMatches, hints }
+ * - meta: { durationMs, operation: 'search', query, mode }
+ */
+export type SearchResponse = ResponseEnvelope<SearchResponseData>;
+/**
+ * Keyword match in path or content.
+ */
+export interface KeywordMatch {
+    /** Keyword that matched */
+    keyword: string;
+    /** Location: 'path' | 'content' | 'symbol' */
+    location: 'path' | 'content' | 'symbol';
+    /** Match score (0-1) */
+    score: number;
+}
+/**
+ * Symbol match.
+ */
+export interface SymbolMatch {
+    /** Matched symbol */
+    symbol: SymbolEntry;
+    /** Match score (0-1) */
+    score: number;
+    /** Match type: 'exact' | 'partial' | 'fuzzy' */
+    matchType: 'exact' | 'partial' | 'fuzzy';
+}
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/types/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,QAAQ,GACR,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IAErB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAExC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,MAAM,EAAE,WAAW,CAAC;IAEpB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IAEd,gDAAgD;IAChD,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C"}

package/dist/types/query.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Query system types for file and symbol discovery.
+ *
+ * QueryEngine provides search capabilities:
+ * - Text search (keyword matching in paths/content)
+ * - Symbol search (find symbols by name/kind)
+ * - Relevance ranking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query.js.map

package/dist/types/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/types/query.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/types/response.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Universal response envelope for all CodeMap operations.
+ *
+ * Provides consistent response structure across:
+ * - Search operations
+ * - Read operations
+ * - File operations
+ * - Tool responses
+ *
+ * Benefits:
+ * - Plugins can intercept all responses uniformly
+ * - Consistent error handling
+ * - Metadata extensibility for plugins
+ * - Type-safe response handling
+ *
+ * @example
+ * ```typescript
+ * // Search response
+ * const response: ResponseEnvelope<SearchData> = {
+ *   success: true,
+ *   data: { results: [...], totalMatches: 10 },
+ *   meta: { durationMs: 42 }
+ * };
+ *
+ * // Plugin enrichment
+ * codemap.on('search:result:after', (envelope) => {
+ *   envelope.meta.timewarp = { lastSnapshot: '2026-03-30' };
+ * });
+ * ```
+ */
+/**
+ * Universal response envelope.
+ *
+ * All CodeMap operations return this structure.
+ */
+export interface ResponseEnvelope<T = unknown> {
+    /**
+     * Operation success status.
+     * true = operation succeeded
+     * false = operation failed (check error field)
+     */
+    success: boolean;
+    /**
+     * Response data (operation-specific payload).
+     * Type varies by operation:
+     * - Search: { results, totalMatches }
+     * - Read: { content, path }
+     * - File ops: { updated, path }
+     */
+    data?: T;
+    /**
+     * Response metadata (extensible by plugins).
+     *
+     * Core fields:
+     * - durationMs: Operation duration
+     * - timestamp: Unix timestamp
+     * - operation: Operation name (search, read, etc.)
+     *
+     * Plugin fields (namespace convention):
+     * - timewarp: TimeWarp plugin metadata
+     * - analytics: Analytics plugin metadata
+     * - domain: Domain plugin metadata
+     */
+    meta?: ResponseMeta;
+    /**
+     * Error details (only present when success: false).
+     */
+    error?: ResponseError;
+}
+/**
+ * Response metadata (core + plugin-extensible).
+ */
+export interface ResponseMeta {
+    /**
+     * Operation duration in milliseconds.
+     */
+    durationMs?: number;
+    /**
+     * Operation timestamp (Unix ms).
+     */
+    timestamp?: number;
+    /**
+     * Operation name (search, read, write, etc.).
+     */
+    operation?: string;
+    /**
+     * Plugin-specific metadata.
+     * Namespace convention: meta[pluginName] = {...}
+     *
+     * Examples:
+     * - meta.timewarp = { snapshotCount: 5, lastSnapshot: '...' }
+     * - meta.analytics = { viewCount: 42, lastAccessed: '...' }
+     * - meta.domain = { relevance: 0.9, domainName: 'auth' }
+     */
+    [pluginName: string]: unknown;
+}
+/**
+ * Error details for failed operations.
+ */
+export interface ResponseError {
+    /**
+     * Error code (machine-readable).
+     * Examples: FILE_NOT_FOUND, SYNTAX_ERROR, VALIDATION_FAILED
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional: Additional error context.
+     */
+    details?: Record<string, unknown>;
+}
+/**
+ * Extract data type from response envelope.
+ *
+ * @example
+ * ```typescript
+ * type SearchData = ResponseData<SearchResponse>;
+ * // SearchData = { results: SearchResult[], totalMatches: number }
+ * ```
+ */
+export type ResponseData<T> = T extends ResponseEnvelope<infer D> ? D : never;
+/**
+ * Create success response envelope.
+ */
+export declare function createSuccessResponse<T>(data: T, meta?: Partial<ResponseMeta>): ResponseEnvelope<T>;
+/**
+ * Create error response envelope.
+ */
+export declare function createErrorResponse(code: string, message: string, details?: Record<string, unknown>): ResponseEnvelope<never>;
+//# sourceMappingURL=response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/types/response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC;IAET;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;OAQG;IACH,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE9E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B,gBAAgB,CAAC,CAAC,CAAC,CASrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,CAAC,KAAK,CAAC,CAQzB"}

package/dist/types/response.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Universal response envelope for all CodeMap operations.
+ *
+ * Provides consistent response structure across:
+ * - Search operations
+ * - Read operations
+ * - File operations
+ * - Tool responses
+ *
+ * Benefits:
+ * - Plugins can intercept all responses uniformly
+ * - Consistent error handling
+ * - Metadata extensibility for plugins
+ * - Type-safe response handling
+ *
+ * @example
+ * ```typescript
+ * // Search response
+ * const response: ResponseEnvelope<SearchData> = {
+ *   success: true,
+ *   data: { results: [...], totalMatches: 10 },
+ *   meta: { durationMs: 42 }
+ * };
+ *
+ * // Plugin enrichment
+ * codemap.on('search:result:after', (envelope) => {
+ *   envelope.meta.timewarp = { lastSnapshot: '2026-03-30' };
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+/**
+ * Create success response envelope.
+ */
+function createSuccessResponse(data, meta) {
+    return {
+        success: true,
+        data,
+        meta: {
+            timestamp: Date.now(),
+            ...meta
+        }
+    };
+}
+/**
+ * Create error response envelope.
+ */
+function createErrorResponse(code, message, details) {
+    return {
+        success: false,
+        error: { code, message, details },
+        meta: {
+            timestamp: Date.now()
+        }
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/types/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/types/response.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAiHH,sDAYC;AAKD,kDAYC;AAhCD;;GAEG;AACH,SAAgB,qBAAqB,CACnC,IAAO,EACP,IAA4B;IAE5B,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,IAAI;SACR;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,IAAY,EACZ,OAAe,EACf,OAAiC;IAEjC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACjC,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/types/target.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Target parsing and resolution types.
+ *
+ * Supports:
+ * - Wildcards: "src/components/*.vue" or "src.components.*"
+ * - Line ranges: "file.ts:1-50" or "file.ts:10" (1-indexed)
+ * - Multiple targets: ["file1.ts", "file2.ts"]
+ */
+/**
+ * Parsed target with optional line range.
+ */
+export interface ParsedTarget {
+    /** Base path without line range suffix (may contain wildcards) */
+    basePath: string;
+    /** True if basePath contains * or ? wildcards */
+    isWildcard: boolean;
+    /** Optional line range (1-indexed, inclusive) */
+    lineRange?: {
+        /** Start line (1-indexed) */
+        start: number;
+        /** End line (1-indexed) */
+        end: number;
+    };
+    /** Original unparsed target string */
+    original: string;
+}
+/**
+ * Result of resolving a target (potentially with wildcards) to concrete file paths.
+ */
+export interface ResolvedTarget {
+    /** Original target string */
+    original: string;
+    /** Parsed target structure */
+    parsed: ParsedTarget;
+    /** Concrete file paths resolved from wildcards (empty if no matches) */
+    files: string[];
+    /** True if target resolved to at least one file */
+    found: boolean;
+}
+/**
+ * Line range write operation parameters.
+ */
+export interface LineRangeWrite {
+    /** File path */
+    filePath: string;
+    /** Line range to replace (1-indexed, inclusive) */
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    /** New content to insert */
+    content: string;
+}
+/**
+ * Result of a line range write operation.
+ */
+export interface LineRangeWriteResult {
+    ok: boolean;
+    /** Number of lines removed */
+    linesRemoved: number;
+    /** Number of lines added */
+    linesAdded: number;
+    /** Net change in line count (negative = file shrunk, positive = file grew) */
+    netChange: number;
+    /** Error message if operation failed */
+    error?: string;
+}
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/types/target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IAEpB,iDAAiD;IACjD,SAAS,CAAC,EAAE;QACV,6BAA6B;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,2BAA2B;QAC3B,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IAErB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IAEZ,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/target.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Target parsing and resolution types.
+ *
+ * Supports:
+ * - Wildcards: "src/components/*.vue" or "src.components.*"
+ * - Line ranges: "file.ts:1-50" or "file.ts:10" (1-indexed)
+ * - Multiple targets: ["file1.ts", "file2.ts"]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=target.js.map

package/dist/types/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/types/target.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/utils/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Version utility - loads version from package.json
+ */
+/**
+ * Get the package version from package.json
+ * Caches the result for performance
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAenC"}

package/dist/utils/version.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Version utility - loads version from package.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+let cachedVersion = null;
+/**
+ * Get the package version from package.json
+ * Caches the result for performance
+ */
+function getVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        // Navigate from dist/utils/version.js -> package.json
+        const packagePath = (0, path_1.join)(__dirname, '..', '..', 'package.json');
+        const packageJson = JSON.parse((0, fs_1.readFileSync)(packagePath, 'utf-8'));
+        cachedVersion = packageJson.version || '0.0.0';
+        return cachedVersion;
+    }
+    catch (error) {
+        console.error('[CodeMap] Failed to load version from package.json:', error);
+        return '0.0.0'; // Fallback version
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,gCAeC;AAxBD,2BAAkC;AAClC,+BAA4B;AAE5B,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;GAGG;AACH,SAAgB,UAAU;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,sDAAsD;QACtD,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,aAAa,GAAG,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;QAC/C,OAAO,aAAuB,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC"}