@windagency/valora 2.2.0 → 2.3.0

package/dist/ast/ast-query.service.js

@@ -0,0 +1,203 @@
+/**
+ * AST Query Service
+ *
+ * High-level query operations on the codebase index:
+ * symbol search, file outline, reference finding.
+ */
+import { getASTIndexService } from './ast-index.service.js';
+import { CHARS_PER_TOKEN } from './ast-parser.service.js';
+export const DEFAULT_SEARCH_LIMIT = 20;
+const SCORE_EXACT = 100;
+const SCORE_PREFIX = 80;
+const SCORE_CONTAINS = 60;
+const SCORE_FUZZY = 40;
+const EXPORT_BONUS = 5;
+const INITIAL_TOKEN_ESTIMATE = 10;
+/**
+ * Search for symbols by name with fuzzy matching
+ */
+export function searchSymbols(query, options) {
+    const indexService = getASTIndexService();
+    const index = indexService.getIndex();
+    const results = [];
+    const queryLower = query.toLowerCase();
+    const limit = options?.limit ?? DEFAULT_SEARCH_LIMIT;
+    for (const [name, ids] of Object.entries(index.nameIndex)) {
+        if (!ids || ids.length === 0)
+            continue;
+        const match = scoreSymbolMatch(name.toLowerCase(), queryLower);
+        if (!match)
+            continue;
+        collectMatchingSymbols(ids, index, options, match, results);
+    }
+    results.sort((a, b) => b.score - a.score || a.symbol.name.localeCompare(b.symbol.name));
+    return results.slice(0, limit);
+}
+/**
+ * Score a symbol name match against a query
+ */
+function scoreSymbolMatch(nameLower, queryLower) {
+    if (nameLower === queryLower)
+        return { matchType: 'exact', score: SCORE_EXACT };
+    if (nameLower.startsWith(queryLower))
+        return { matchType: 'prefix', score: SCORE_PREFIX };
+    if (nameLower.includes(queryLower))
+        return { matchType: 'contains', score: SCORE_CONTAINS };
+    if (fuzzyMatch(queryLower, nameLower))
+        return { matchType: 'fuzzy', score: SCORE_FUZZY };
+    return null;
+}
+/**
+ * Collect matching symbols from IDs, applying filters
+ */
+function collectMatchingSymbols(ids, index, options, match, results) {
+    for (const id of ids) {
+        const sym = index.symbols[id];
+        if (!sym)
+            continue;
+        if (isSymbolFilteredOut(sym, index, options))
+            continue;
+        const exportBonus = sym.exported ? EXPORT_BONUS : 0;
+        results.push({
+            matchType: match.matchType,
+            score: match.score + exportBonus,
+            symbol: sym
+        });
+    }
+}
+function isSymbolFilteredOut(sym, index, options) {
+    if (options?.kind && sym.kind !== options.kind)
+        return true;
+    if (options?.language) {
+        const file = index.files[sym.filePath];
+        if (file && file.language !== options.language)
+            return true;
+    }
+    return false;
+}
+/**
+ * Get a structured outline of a file
+ */
+export function getFileOutline(filePath) {
+    const indexService = getASTIndexService();
+    const symbols = indexService.lookupByFile(filePath);
+    if (symbols.length === 0)
+        return [];
+    const topLevel = [];
+    const childrenMap = new Map();
+    for (const sym of symbols) {
+        if (sym.parentId) {
+            if (!childrenMap.has(sym.parentId))
+                childrenMap.set(sym.parentId, []);
+            childrenMap.get(sym.parentId).push(sym);
+        }
+        else {
+            topLevel.push(sym);
+        }
+    }
+    topLevel.sort((a, b) => a.startLine - b.startLine);
+    return topLevel.map((sym) => symbolToOutlineEntry(sym, childrenMap));
+}
+/**
+ * Find all references to a symbol across the index
+ */
+export function findReferences(symbolName, scopePath) {
+    const indexService = getASTIndexService();
+    const index = indexService.getIndex();
+    const results = [];
+    for (const [id, sym] of Object.entries(index.symbols)) {
+        if (sym.references.includes(symbolName)) {
+            if (scopePath && !sym.filePath.startsWith(scopePath))
+                continue;
+            results.push({ filePath: sym.filePath, line: sym.startLine, symbolId: id, symbolName: sym.name });
+        }
+    }
+    for (const [filePath, fileEntry] of Object.entries(index.files)) {
+        if (scopePath && !filePath.startsWith(scopePath))
+            continue;
+        for (const imp of fileEntry.imports) {
+            if (imp.names.includes(symbolName)) {
+                results.push({
+                    filePath,
+                    line: 1,
+                    symbolId: `${filePath}#import#${symbolName}`,
+                    symbolName: `import ${symbolName}`
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Generate a compact codebase map
+ */
+export function generateCodebaseMap(maxTokens) {
+    const indexService = getASTIndexService();
+    const index = indexService.getIndex();
+    const budget = maxTokens ?? 2000;
+    const dirMap = buildDirectoryMap(index);
+    return renderCodebaseMap(dirMap, budget);
+}
+// --- Helpers ---
+function buildDirectoryMap(index) {
+    const dirMap = new Map();
+    for (const [filePath, fileEntry] of Object.entries(index.files)) {
+        const parts = filePath.split('/');
+        const dir = parts.slice(0, -1).join('/') || '.';
+        const name = parts[parts.length - 1] ?? filePath;
+        if (!dirMap.has(dir))
+            dirMap.set(dir, []);
+        const symbols = fileEntry.symbolIds
+            .map((id) => index.symbols[id])
+            .filter((s) => !!s && s.exported);
+        dirMap.get(dir).push({ name, symbols });
+    }
+    return dirMap;
+}
+function fuzzyMatch(query, target) {
+    let qi = 0;
+    for (let ti = 0; ti < target.length && qi < query.length; ti++) {
+        if (target[ti] === query[qi])
+            qi++;
+    }
+    return qi === query.length;
+}
+function renderCodebaseMap(dirMap, budget) {
+    const lines = ['## Codebase Map\n'];
+    let tokenEstimate = INITIAL_TOKEN_ESTIMATE;
+    const sortedDirs = Array.from(dirMap.entries()).sort(([a], [b]) => a.localeCompare(b));
+    for (const [dir, files] of sortedDirs) {
+        const dirLine = `${dir}/`;
+        const dirTokens = Math.ceil(dirLine.length / CHARS_PER_TOKEN);
+        if (tokenEstimate + dirTokens > budget)
+            break;
+        lines.push(dirLine);
+        tokenEstimate += dirTokens;
+        for (const file of files.sort((a, b) => a.name.localeCompare(b.name))) {
+            const symbolNames = file.symbols.map((s) => s.name).join(', ');
+            const fileLine = `  ${file.name} — ${symbolNames || '(no exports)'}`;
+            const fileTokens = Math.ceil(fileLine.length / CHARS_PER_TOKEN);
+            if (tokenEstimate + fileTokens > budget)
+                break;
+            lines.push(fileLine);
+            tokenEstimate += fileTokens;
+        }
+    }
+    return lines.join('\n');
+}
+function symbolToOutlineEntry(sym, childrenMap) {
+    const children = childrenMap.get(sym.id);
+    const childEntries = children
+        ?.sort((a, b) => a.startLine - b.startLine)
+        .map((c) => symbolToOutlineEntry(c, childrenMap));
+    return {
+        children: childEntries && childEntries.length > 0 ? childEntries : undefined,
+        endLine: sym.endLine,
+        exported: sym.exported,
+        kind: sym.kind,
+        name: sym.name,
+        signature: sym.signature,
+        startLine: sym.startLine
+    };
+}
+//# sourceMappingURL=ast-query.service.js.map

package/dist/ast/ast-query.service.js.map

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

package/dist/ast/ast-tools.service.d.ts

@@ -0,0 +1,39 @@
+/**
+ * AST Tools Service
+ *
+ * LLM tool handlers for AST-based code intelligence:
+ * symbol_search, file_outline, find_references, smart_context, request_context
+ */
+import type { getLogger } from '../output/logger.js';
+type Logger = ReturnType<typeof getLogger>;
+/**
+ * AST Tools Service — handles LLM tool calls for AST operations
+ */
+export declare class ASTToolsService {
+    private readonly projectRoot;
+    constructor(projectRoot?: string, _logger?: Logger);
+    /**
+     * Execute the symbol_search tool
+     */
+    executeSymbolSearch(args: Record<string, unknown>): string;
+    /**
+     * Execute the file_outline tool
+     */
+    executeFileOutline(args: Record<string, unknown>): string;
+    /**
+     * Execute the find_references tool
+     */
+    executeFindReferences(args: Record<string, unknown>): string;
+    /**
+     * Execute the smart_context tool
+     */
+    executeSmartContext(args: Record<string, unknown>): string;
+    /**
+     * Execute the request_context tool (progressive disclosure)
+     */
+    executeRequestContext(args: Record<string, unknown>): Promise<string>;
+}
+export declare function getASTToolsService(projectRoot?: string): ASTToolsService;
+export declare function resetASTToolsService(): void;
+export {};
+//# sourceMappingURL=ast-tools.service.d.ts.map

package/dist/ast/ast-tools.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-tools.service.d.ts","sourceRoot":"","sources":["../../src/ast/ast-tools.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE3C;;GAEG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE,MAAM;IAIjE;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAoC1D;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAqBzD;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAwB5D;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAyB1D;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAiD3E;AAuBD,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAGxE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/ast/ast-tools.service.js

@@ -0,0 +1,187 @@
+/**
+ * AST Tools Service
+ *
+ * LLM tool handlers for AST-based code intelligence:
+ * symbol_search, file_outline, find_references, smart_context, request_context
+ */
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { extractSmartContext } from './ast-context.service.js';
+import { getASTIndexService } from './ast-index.service.js';
+import { DEFAULT_SEARCH_LIMIT, findReferences, getFileOutline, searchSymbols } from './ast-query.service.js';
+/**
+ * AST Tools Service — handles LLM tool calls for AST operations
+ */
+export class ASTToolsService {
+    projectRoot;
+    constructor(projectRoot = process.cwd(), _logger) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Execute the symbol_search tool
+     */
+    executeSymbolSearch(args) {
+        const query = args['query'];
+        if (!query)
+            return 'symbol_search requires a query argument';
+        const indexService = getASTIndexService(this.projectRoot);
+        // Ensure index is available
+        if (!indexService.isBuilt()) {
+            if (!indexService.loadIndex()) {
+                return 'Codebase index not yet built. Run `valora index build` or wait for automatic indexing. Falling back to grep.';
+            }
+        }
+        const kind = args['kind'];
+        const language = args['language'];
+        const results = searchSymbols(query, {
+            kind: kind,
+            language,
+            limit: DEFAULT_SEARCH_LIMIT
+        });
+        if (results.length === 0) {
+            return `No symbols found matching "${query}"`;
+        }
+        const formatted = results.map((r) => {
+            const sym = r.symbol;
+            const exportLabel = sym.exported ? 'exported ' : '';
+            const doc = sym.docComment ? ` — ${sym.docComment.split('\n')[0]}` : '';
+            return `${sym.filePath}:${sym.startLine} ${exportLabel}${sym.kind} ${sym.name}${doc} (score: ${r.score})`;
+        });
+        return formatted.join('\n');
+    }
+    /**
+     * Execute the file_outline tool
+     */
+    executeFileOutline(args) {
+        const path = args['path'];
+        if (!path)
+            return 'file_outline requires a path argument';
+        const indexService = getASTIndexService(this.projectRoot);
+        if (!indexService.isBuilt()) {
+            if (!indexService.loadIndex()) {
+                return 'Codebase index not yet built. Falling back to basic file reading.';
+            }
+        }
+        const outline = getFileOutline(path);
+        if (outline.length === 0) {
+            return `No symbols found in ${path}. The file may not be indexed yet.`;
+        }
+        const formatted = outline.map((entry) => formatOutlineEntry(entry, 0));
+        return formatted.join('\n');
+    }
+    /**
+     * Execute the find_references tool
+     */
+    executeFindReferences(args) {
+        const symbol = args['symbol'];
+        if (!symbol)
+            return 'find_references requires a symbol argument';
+        const indexService = getASTIndexService(this.projectRoot);
+        if (!indexService.isBuilt()) {
+            if (!indexService.loadIndex()) {
+                return 'Codebase index not yet built. Falling back to grep.';
+            }
+        }
+        const scopePath = args['path'];
+        const refs = findReferences(symbol, scopePath);
+        if (refs.length === 0) {
+            return `No references found for "${symbol}"`;
+        }
+        const formatted = refs.map((r) => `${r.filePath}:${r.line} — ${r.symbolName}`);
+        return `Found ${refs.length} reference(s) to "${symbol}":\n${formatted.join('\n')}`;
+    }
+    /**
+     * Execute the smart_context tool
+     */
+    executeSmartContext(args) {
+        const task = args['task'];
+        if (!task)
+            return 'smart_context requires a task argument';
+        const indexService = getASTIndexService(this.projectRoot);
+        if (!indexService.isBuilt()) {
+            if (!indexService.loadIndex()) {
+                return 'Codebase index not yet built. Cannot extract smart context.';
+            }
+        }
+        const files = args['files'];
+        const budget = args['budget'];
+        const mode = args['mode'];
+        const result = extractSmartContext({ budget, files, mode, task });
+        const header = `Smart context: ${result.includedFiles.length} files, ~${result.tokenEstimate} tokens\n` +
+            `Focal symbols: ${result.focalSymbols.join(', ') || 'none'}\n---\n`;
+        return header + result.content;
+    }
+    /**
+     * Execute the request_context tool (progressive disclosure)
+     */
+    async executeRequestContext(args) {
+        const target = args['target'];
+        if (!target)
+            return 'request_context requires a target argument';
+        const level = args['level'] ?? 'full';
+        const indexService = getASTIndexService(this.projectRoot);
+        // Try to find the target as a file
+        const fileEntry = indexService.getFile(target);
+        if (fileEntry) {
+            if (level === 'signatures') {
+                const symbols = indexService.lookupByFile(target);
+                const exported = symbols.filter((s) => s.exported);
+                return exported.map((s) => s.signature).join('\n');
+            }
+            // Full file content
+            try {
+                const absPath = join(this.projectRoot, target);
+                const content = await readFile(absPath, 'utf-8');
+                return `--- File: ${target} ---\n${content}\n--- End of File ---`;
+            }
+            catch {
+                return `Could not read file: ${target}`;
+            }
+        }
+        // Try to find the target as a symbol
+        const results = searchSymbols(target, { limit: 1 });
+        if (results.length > 0) {
+            const sym = results[0].symbol;
+            if (level === 'signatures') {
+                return sym.signature;
+            }
+            // Full symbol body
+            try {
+                const absPath = join(this.projectRoot, sym.filePath);
+                const content = await readFile(absPath, 'utf-8');
+                const lines = content.split('\n');
+                const body = lines.slice(sym.startLine - 1, sym.endLine).join('\n');
+                return `// ${sym.filePath}:${sym.startLine}-${sym.endLine}\n${body}`;
+            }
+            catch {
+                return `Could not read symbol body for: ${target}`;
+            }
+        }
+        return `Target not found in index: "${target}". Try using read_file or grep.`;
+    }
+}
+/**
+ * Format an outline entry with indentation
+ */
+function formatOutlineEntry(entry, depth) {
+    const indent = '  '.repeat(depth);
+    const exportLabel = entry.exported ? 'exported ' : '';
+    let line = `${indent}${entry.startLine}-${entry.endLine} ${exportLabel}${entry.kind} ${entry.name}: ${entry.signature}`;
+    if (entry.children) {
+        const childLines = entry.children.map((c) => formatOutlineEntry(c, depth + 1));
+        line += '\n' + childLines.join('\n');
+    }
+    return line;
+}
+/**
+ * Singleton management
+ */
+let astToolsServiceInstance = null;
+export function getASTToolsService(projectRoot) {
+    astToolsServiceInstance ??= new ASTToolsService(projectRoot);
+    return astToolsServiceInstance;
+}
+export function resetASTToolsService() {
+    astToolsServiceInstance = null;
+}
+//# sourceMappingURL=ast-tools.service.js.map

package/dist/ast/ast-tools.service.js.map

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

package/dist/ast/ast.types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * AST Code Intelligence Type Definitions
+ *
+ * Core types for the AST-based codebase index, symbol extraction,
+ * and smart context system.
+ */
+/**
+ * Supported languages for AST parsing
+ */
+export type ASTLanguage = 'go' | 'java' | 'javascript' | 'python' | 'rust' | 'typescript';
+/**
+ * Symbol kinds extracted from AST
+ */
+export type SymbolKind = 'class' | 'constant' | 'enum' | 'function' | 'interface' | 'method' | 'type' | 'variable';
+/**
+ * Context extraction levels for token reduction
+ */
+export type ContextLevel = 0 | 1 | 2 | 3;
+/**
+ * Import information extracted from a file
+ */
+export interface ImportInfo {
+    names: string[];
+    source: string;
+    typeOnly: boolean;
+}
+/**
+ * A symbol extracted from AST parsing
+ */
+export interface IndexedSymbol {
+    /** Unique ID: filePath#name#kind#line */
+    id: string;
+    /** Symbol name */
+    name: string;
+    /** Symbol kind (function, class, etc.) */
+    kind: SymbolKind;
+    /** File path relative to project root */
+    filePath: string;
+    /** Start line (1-based) */
+    startLine: number;
+    /** End line (1-based) */
+    endLine: number;
+    /** Declaration signature (not body) */
+    signature: string;
+    /** Whether the symbol is exported */
+    exported: boolean;
+    /** JSDoc or doc comment content */
+    docComment?: string;
+    /** Parent symbol ID (for methods inside classes) */
+    parentId?: string;
+    /** Symbol names referenced in body */
+    references: string[];
+    /** Estimated token count for the symbol body */
+    tokenEstimate: number;
+}
+/**
+ * A file's index entry
+ */
+export interface IndexedFile {
+    /** File path relative to project root */
+    filePath: string;
+    /** Detected language */
+    language: ASTLanguage;
+    /** SHA-256 content hash for incremental updates */
+    contentHash: string;
+    /** Timestamp of last indexing */
+    indexedAt: number;
+    /** Extracted imports */
+    imports: ImportInfo[];
+    /** IDs of symbols defined in this file */
+    symbolIds: string[];
+}
+/**
+ * The complete codebase index
+ */
+export interface CodebaseIndex {
+    /** Schema version for migration */
+    version: number;
+    /** Absolute path to project root */
+    projectRoot: string;
+    /** ISO 8601 timestamp of last update */
+    updatedAt: string;
+    /** Files indexed, keyed by relative path */
+    files: Record<string, IndexedFile>;
+    /** All symbols, keyed by symbol ID */
+    symbols: Record<string, IndexedSymbol>;
+    /** Symbol name -> symbol IDs (for name-based lookup) */
+    nameIndex: Record<string, string[]>;
+    /** File path -> symbol IDs (for file-based lookup) */
+    fileIndex: Record<string, string[]>;
+}
+/**
+ * Result of a symbol search query
+ */
+export interface SymbolSearchResult {
+    matchType: 'contains' | 'exact' | 'fuzzy' | 'prefix';
+    score: number;
+    symbol: IndexedSymbol;
+}
+/**
+ * File outline entry (structured view of a file)
+ */
+export interface FileOutlineEntry {
+    children?: FileOutlineEntry[];
+    endLine: number;
+    exported: boolean;
+    kind: SymbolKind;
+    name: string;
+    signature: string;
+    startLine: number;
+}
+/**
+ * Smart context request options
+ */
+export interface SmartContextOptions {
+    /** Task description for relevance scoring */
+    task: string;
+    /** Specific files to focus on */
+    files?: string[];
+    /** Token budget (default: model context - system - output reserve) */
+    budget?: number;
+    /** Context mode */
+    mode?: 'broad' | 'focused';
+}
+/**
+ * Smart context result
+ */
+export interface SmartContextResult {
+    /** The assembled context string */
+    content: string;
+    /** Total estimated tokens */
+    tokenEstimate: number;
+    /** Files included and their extraction levels */
+    includedFiles: Array<{
+        filePath: string;
+        level: ContextLevel;
+        tokenEstimate: number;
+    }>;
+    /** Symbols included at full body level */
+    focalSymbols: string[];
+}
+/**
+ * Codebase map entry for compact overview
+ */
+export interface CodebaseMapEntry {
+    /** Directory path */
+    directory: string;
+    /** Files in this directory */
+    files: Array<{
+        description: string;
+        lineCount: number;
+        name: string;
+        symbols: Array<{
+            exported: boolean;
+            kind: SymbolKind;
+            name: string;
+        }>;
+    }>;
+}
+/**
+ * Index manifest for persistence
+ */
+export interface IndexManifest {
+    fileCount: number;
+    projectRoot: string;
+    shards: string[];
+    symbolCount: number;
+    updatedAt: string;
+    version: number;
+}
+/**
+ * Context deduplication tracking
+ */
+export interface ContextDeduplicationState {
+    /** Symbols sent at full level, keyed by symbol ID */
+    sentSymbols: Map<string, {
+        level: ContextLevel;
+        stage: string;
+    }>;
+    /** Files sent, keyed by file path */
+    sentFiles: Map<string, {
+        level: ContextLevel;
+        stage: string;
+    }>;
+}
+/**
+ * Context savings metrics
+ */
+export interface ContextSavingsMetrics {
+    contextSavingsPercent: number;
+    contextTokensAfter: number;
+    contextTokensBefore: number;
+    progressiveDisclosureCalls: number;
+}
+//# sourceMappingURL=ast.types.d.ts.map

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

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

package/dist/ast/ast.types.js

@@ -0,0 +1,8 @@
+/**
+ * AST Code Intelligence Type Definitions
+ *
+ * Core types for the AST-based codebase index, symbol extraction,
+ * and smart context system.
+ */
+export {};
+//# sourceMappingURL=ast.types.js.map

package/dist/ast/ast.types.js.map

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