@side-quest/kit 0.1.0 → 0.2.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAA"}

package/dist/lib/ast/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AST Module
+ *
+ * Tree-sitter powered AST search for code analysis.
+ * Provides pattern-based search across TypeScript, JavaScript, and Python files.
+ */
+export { detectLanguage, getParser, getSupportedGlob, initParser, isSupported, LANGUAGES, SUPPORTED_LANGUAGES, type SupportedLanguage, } from './languages.js';
+export { ASTPattern } from './pattern.js';
+export { ASTSearcher } from './searcher.js';
+export { AST_SEARCH_TIMEOUT, type ASTMatch, type ASTMatchContext, type ASTSearchOptions, type ASTSearchResult, type PatternCriteria, SearchMode, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/ast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/ast/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,KAAK,iBAAiB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACN,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,UAAU,GACV,MAAM,YAAY,CAAA"}

package/dist/lib/ast/index.js

@@ -0,0 +1,15 @@
+/**
+ * AST Module
+ *
+ * Tree-sitter powered AST search for code analysis.
+ * Provides pattern-based search across TypeScript, JavaScript, and Python files.
+ */
+// Language utilities
+export { detectLanguage, getParser, getSupportedGlob, initParser, isSupported, LANGUAGES, SUPPORTED_LANGUAGES, } from './languages.js';
+// Pattern matching
+export { ASTPattern } from './pattern.js';
+// Search engine
+export { ASTSearcher } from './searcher.js';
+// Types
+export { AST_SEARCH_TIMEOUT, SearchMode, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/ast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/ast/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAqB;AACrB,OAAO,EACN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,GAEnB,MAAM,gBAAgB,CAAA;AACvB,mBAAmB;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,QAAQ;AACR,OAAO,EACN,kBAAkB,EAMlB,UAAU,GACV,MAAM,YAAY,CAAA"}

package/dist/lib/ast/languages.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Language Registry
+ *
+ * Maps file extensions to tree-sitter languages and provides
+ * lazy-loaded parser instances using WASM grammars.
+ */
+import { type Node, Parser } from 'web-tree-sitter';
+/**
+ * File extension to tree-sitter language mapping.
+ * Ported from Kit's LANGUAGES dict in tree_sitter_symbol_extractor.py
+ */
+export declare const LANGUAGES: Record<string, string>;
+/**
+ * Languages we support for AST search.
+ */
+export declare const SUPPORTED_LANGUAGES: readonly ["typescript", "tsx", "javascript", "python"];
+export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+/**
+ * Initialize the tree-sitter parser.
+ * Must be called before any parsing operations.
+ */
+export declare function initParser(): Promise<void>;
+/**
+ * Get a parser configured for a specific language.
+ *
+ * Each language gets its own dedicated parser instance to avoid race conditions
+ * when concurrent requests for different languages would otherwise swap the
+ * language on a shared parser mid-parse.
+ *
+ * @param language - The language name (e.g., "typescript")
+ * @returns Configured parser instance for this language
+ */
+export declare function getParser(language: SupportedLanguage): Promise<Parser>;
+/**
+ * Detect language from file path by extension.
+ *
+ * @param filePath - Path to the file
+ * @returns Language name or null if unsupported
+ */
+export declare function detectLanguage(filePath: string): SupportedLanguage | null;
+/**
+ * Check if a file is supported for AST parsing.
+ *
+ * @param filePath - Path to the file
+ * @returns True if the file can be parsed
+ */
+export declare function isSupported(filePath: string): boolean;
+/**
+ * Get all supported file extensions as a glob pattern.
+ *
+ * @returns Glob pattern matching all supported files
+ */
+export declare function getSupportedGlob(): string;
+export type { Node as SyntaxNode };
+//# sourceMappingURL=languages.d.ts.map

package/dist/lib/ast/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/lib/ast/languages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAM7D;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAU5C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,wDAKtB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAQpE;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBhD;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5E;AAkCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAYzE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAID,YAAY,EAAE,IAAI,IAAI,UAAU,EAAE,CAAA"}

package/dist/lib/ast/languages.js

@@ -0,0 +1,146 @@
+/**
+ * Language Registry
+ *
+ * Maps file extensions to tree-sitter languages and provides
+ * lazy-loaded parser instances using WASM grammars.
+ */
+import { createRequire } from 'node:module';
+import { ResourcePool } from '@side-quest/core/concurrency';
+import { Language, Parser } from 'web-tree-sitter';
+import { getAstLogger } from '../logger.js';
+// Create require for resolving WASM paths
+const require = createRequire(import.meta.url);
+/**
+ * File extension to tree-sitter language mapping.
+ * Ported from Kit's LANGUAGES dict in tree_sitter_symbol_extractor.py
+ */
+export const LANGUAGES = {
+    '.ts': 'typescript',
+    '.tsx': 'tsx',
+    '.mts': 'typescript',
+    '.cts': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    '.py': 'python',
+};
+/**
+ * Languages we support for AST search.
+ */
+export const SUPPORTED_LANGUAGES = [
+    'typescript',
+    'tsx',
+    'javascript',
+    'python',
+];
+// Resource pools for cached instances
+const languagePool = new ResourcePool();
+const parserPool = new ResourcePool();
+let initialized = false;
+/**
+ * Initialize the tree-sitter parser.
+ * Must be called before any parsing operations.
+ */
+export async function initParser() {
+    if (initialized)
+        return;
+    const logger = getAstLogger();
+    logger.debug('Initializing tree-sitter parser');
+    try {
+        await Parser.init();
+        initialized = true;
+        logger.debug('Tree-sitter parser initialized successfully');
+    }
+    catch (error) {
+        logger.error('Failed to initialize tree-sitter parser', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
+/**
+ * Get a parser configured for a specific language.
+ *
+ * Each language gets its own dedicated parser instance to avoid race conditions
+ * when concurrent requests for different languages would otherwise swap the
+ * language on a shared parser mid-parse.
+ *
+ * @param language - The language name (e.g., "typescript")
+ * @returns Configured parser instance for this language
+ */
+export async function getParser(language) {
+    await initParser();
+    const logger = getAstLogger();
+    return parserPool.getOrCreate(language, async (lang) => {
+        logger.debug('Creating new parser for language', { language: lang });
+        const parser = new Parser();
+        const grammar = await loadLanguage(lang);
+        parser.setLanguage(grammar);
+        return parser;
+    });
+}
+/**
+ * Load a language grammar from WASM.
+ *
+ * @param language - The language name
+ * @returns Loaded language instance
+ */
+async function loadLanguage(language) {
+    const logger = getAstLogger();
+    return languagePool.getOrCreate(language, async (lang) => {
+        logger.debug('Loading language grammar from WASM', { language: lang });
+        try {
+            const wasmPath = require.resolve(`tree-sitter-wasms/out/tree-sitter-${lang}.wasm`);
+            const grammar = await Language.load(wasmPath);
+            logger.debug('Language grammar loaded successfully', {
+                language: lang,
+                wasmPath,
+            });
+            return grammar;
+        }
+        catch (error) {
+            logger.error('Failed to load language grammar', {
+                language: lang,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    });
+}
+/**
+ * Detect language from file path by extension.
+ *
+ * @param filePath - Path to the file
+ * @returns Language name or null if unsupported
+ */
+export function detectLanguage(filePath) {
+    const lastDot = filePath.lastIndexOf('.');
+    if (lastDot === -1)
+        return null;
+    const ext = filePath.substring(lastDot).toLowerCase();
+    const language = LANGUAGES[ext];
+    if (language && SUPPORTED_LANGUAGES.includes(language)) {
+        return language;
+    }
+    return null;
+}
+/**
+ * Check if a file is supported for AST parsing.
+ *
+ * @param filePath - Path to the file
+ * @returns True if the file can be parsed
+ */
+export function isSupported(filePath) {
+    return detectLanguage(filePath) !== null;
+}
+/**
+ * Get all supported file extensions as a glob pattern.
+ *
+ * @returns Glob pattern matching all supported files
+ */
+export function getSupportedGlob() {
+    const extensions = Object.keys(LANGUAGES).map((ext) => ext.slice(1));
+    return `**/*.{${extensions.join(',')}}`;
+}
+//# sourceMappingURL=languages.js.map

package/dist/lib/ast/languages.js.map

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

package/dist/lib/ast/pattern.d.ts

@@ -0,0 +1,84 @@
+/**
+ * AST Pattern
+ *
+ * Compiles and matches AST search patterns against tree-sitter nodes.
+ * Ported from Kit's ASTPattern class in ast_search.py.
+ */
+import type { SyntaxNode } from './languages.js';
+import { SearchMode } from './types.js';
+/**
+ * ASTPattern compiles search patterns and matches them against AST nodes.
+ *
+ * Supports two modes:
+ * - `simple`: Natural language patterns like "async function", "class"
+ * - `pattern`: JSON object criteria like {"type": "function_declaration"}
+ */
+export declare class ASTPattern {
+    readonly pattern: string;
+    readonly mode: SearchMode;
+    private isAsync;
+    private isDef;
+    private isClass;
+    private isTry;
+    private isImport;
+    private isExport;
+    private criteria;
+    /**
+     * Create a new AST pattern.
+     *
+     * @param pattern - The search pattern string
+     * @param mode - The search mode (simple or pattern)
+     */
+    constructor(pattern: string, mode?: SearchMode);
+    /**
+     * Compile the pattern based on mode.
+     */
+    private compile;
+    /**
+     * Compile simple mode pattern from natural language.
+     * Parses keywords like "async", "function", "class", etc.
+     */
+    private compileSimple;
+    /**
+     * Compile pattern mode from JSON criteria.
+     */
+    private compilePattern;
+    /**
+     * Check if a node matches this pattern.
+     *
+     * @param node - The tree-sitter syntax node
+     * @param source - The source code string
+     * @returns True if the node matches
+     */
+    matches(node: SyntaxNode, source: string): boolean;
+    /**
+     * Match a node against simple mode pattern.
+     */
+    private matchesSimple;
+    /**
+     * Match a node against pattern mode criteria.
+     */
+    private matchesPattern;
+    /**
+     * Check if a node type is a function node.
+     */
+    private isFunctionNode;
+    /**
+     * Check if a node type is a class node.
+     */
+    private isClassNode;
+    /**
+     * Check if a node has an async modifier.
+     * Works for both direct 'async' child and keyword in text.
+     */
+    private hasAsyncModifier;
+    /**
+     * Get the name of a named node (function, class, etc.)
+     */
+    private getNodeName;
+    /**
+     * Get the text content of a node.
+     */
+    private getNodeText;
+}
+//# sourceMappingURL=pattern.d.ts.map

package/dist/lib/ast/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../src/lib/ast/pattern.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAwB,UAAU,EAAE,MAAM,YAAY,CAAA;AAkC7D;;;;;;GAMG;AACH,qBAAa,UAAU;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IAGzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAQ;IAGxB,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAA8B;IAMjE;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;;OAGG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IASlD;;OAEG;IACH,OAAO,CAAC,aAAa;IAmCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGnB"}

package/dist/lib/ast/pattern.js

@@ -0,0 +1,268 @@
+/**
+ * AST Pattern
+ *
+ * Compiles and matches AST search patterns against tree-sitter nodes.
+ * Ported from Kit's ASTPattern class in ast_search.py.
+ */
+import { getAstLogger } from '../logger.js';
+import { SearchMode } from './types.js';
+/**
+ * Node types that represent function definitions across languages.
+ */
+const FUNCTION_NODE_TYPES = [
+    // TypeScript/JavaScript
+    'function_declaration',
+    'function_expression',
+    'arrow_function',
+    'method_definition',
+    'generator_function_declaration',
+    // Python
+    'function_definition',
+];
+/**
+ * Node types that represent class definitions across languages.
+ */
+const CLASS_NODE_TYPES = [
+    // TypeScript/JavaScript
+    'class_declaration',
+    'class_expression',
+    // Python
+    'class_definition',
+];
+/**
+ * Node types that represent try/catch statements.
+ */
+const TRY_NODE_TYPES = [
+    'try_statement', // TypeScript/JavaScript and Python
+];
+/**
+ * ASTPattern compiles search patterns and matches them against AST nodes.
+ *
+ * Supports two modes:
+ * - `simple`: Natural language patterns like "async function", "class"
+ * - `pattern`: JSON object criteria like {"type": "function_declaration"}
+ */
+export class ASTPattern {
+    pattern;
+    mode;
+    // Simple mode flags (parsed from natural language)
+    isAsync = false;
+    isDef = false;
+    isClass = false;
+    isTry = false;
+    isImport = false;
+    isExport = false;
+    // Pattern mode criteria (parsed from JSON)
+    criteria = {};
+    /**
+     * Create a new AST pattern.
+     *
+     * @param pattern - The search pattern string
+     * @param mode - The search mode (simple or pattern)
+     */
+    constructor(pattern, mode = SearchMode.SIMPLE) {
+        this.pattern = pattern;
+        this.mode = mode;
+        this.compile();
+    }
+    /**
+     * Compile the pattern based on mode.
+     */
+    compile() {
+        if (this.mode === SearchMode.SIMPLE) {
+            this.compileSimple();
+        }
+        else if (this.mode === SearchMode.PATTERN) {
+            this.compilePattern();
+        }
+    }
+    /**
+     * Compile simple mode pattern from natural language.
+     * Parses keywords like "async", "function", "class", etc.
+     */
+    compileSimple() {
+        const lower = this.pattern.toLowerCase();
+        // Check for keywords
+        this.isAsync = lower.includes('async');
+        this.isDef =
+            lower.includes('function') ||
+                lower.includes('def') ||
+                lower.includes('method');
+        this.isClass = lower.includes('class');
+        this.isTry = lower.includes('try') || lower.includes('catch');
+        this.isImport = lower.includes('import');
+        this.isExport = lower.includes('export');
+        // If no specific keywords matched, treat as text search
+        if (!this.isAsync &&
+            !this.isDef &&
+            !this.isClass &&
+            !this.isTry &&
+            !this.isImport &&
+            !this.isExport) {
+            // Fall back to text matching mode
+            this.criteria = { textMatch: this.pattern };
+        }
+    }
+    /**
+     * Compile pattern mode from JSON criteria.
+     */
+    compilePattern() {
+        try {
+            this.criteria = JSON.parse(this.pattern);
+        }
+        catch (error) {
+            // If JSON parsing fails, treat as text match
+            // Log at debug level since this is often intentional (user typed plain text)
+            const logger = getAstLogger();
+            logger.debug('Pattern JSON parse failed, using text match fallback', {
+                pattern: this.pattern,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            this.criteria = { textMatch: this.pattern };
+        }
+    }
+    /**
+     * Check if a node matches this pattern.
+     *
+     * @param node - The tree-sitter syntax node
+     * @param source - The source code string
+     * @returns True if the node matches
+     */
+    matches(node, source) {
+        if (this.mode === SearchMode.SIMPLE) {
+            return this.matchesSimple(node, source);
+        }
+        else if (this.mode === SearchMode.PATTERN) {
+            return this.matchesPattern(node, source);
+        }
+        return false;
+    }
+    /**
+     * Match a node against simple mode pattern.
+     */
+    matchesSimple(node, source) {
+        const nodeType = node.type;
+        // If we're looking for specific constructs
+        if (this.isDef ||
+            this.isClass ||
+            this.isTry ||
+            this.isImport ||
+            this.isExport) {
+            // Check construct type
+            if (this.isDef && !this.isFunctionNode(nodeType))
+                return false;
+            if (this.isClass && !this.isClassNode(nodeType))
+                return false;
+            if (this.isTry && !TRY_NODE_TYPES.includes(nodeType))
+                return false;
+            if (this.isImport && !nodeType.includes('import'))
+                return false;
+            if (this.isExport && !nodeType.includes('export'))
+                return false;
+            // Check async modifier (only for functions)
+            if (this.isAsync && this.isDef) {
+                if (!this.hasAsyncModifier(node))
+                    return false;
+            }
+            return true;
+        }
+        // Text match fallback
+        if (this.criteria.textMatch) {
+            const text = this.getNodeText(node, source);
+            return text.includes(this.criteria.textMatch);
+        }
+        return false;
+    }
+    /**
+     * Match a node against pattern mode criteria.
+     */
+    matchesPattern(node, source) {
+        // Match node type
+        if (this.criteria.type && node.type !== this.criteria.type) {
+            return false;
+        }
+        // Match async modifier
+        if (this.criteria.async !== undefined) {
+            if (this.hasAsyncModifier(node) !== this.criteria.async) {
+                return false;
+            }
+        }
+        // Match symbol name
+        if (this.criteria.name) {
+            const name = this.getNodeName(node, source);
+            if (name !== this.criteria.name) {
+                return false;
+            }
+        }
+        // Match text content
+        if (this.criteria.textMatch) {
+            const text = this.getNodeText(node, source);
+            if (!text.includes(this.criteria.textMatch)) {
+                return false;
+            }
+        }
+        // If no criteria specified, don't match anything
+        if (!this.criteria.type &&
+            !this.criteria.async &&
+            !this.criteria.name &&
+            !this.criteria.textMatch) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if a node type is a function node.
+     */
+    isFunctionNode(type) {
+        return FUNCTION_NODE_TYPES.includes(type);
+    }
+    /**
+     * Check if a node type is a class node.
+     */
+    isClassNode(type) {
+        return CLASS_NODE_TYPES.includes(type);
+    }
+    /**
+     * Check if a node has an async modifier.
+     * Works for both direct 'async' child and keyword in text.
+     */
+    hasAsyncModifier(node) {
+        // Check for 'async' child node (TypeScript/JavaScript)
+        for (const child of node.children) {
+            if (child && child.type === 'async')
+                return true;
+        }
+        // Check for async keyword in first few characters
+        // This handles cases where async is part of the node text
+        const firstPart = node.text?.slice(0, 10) ?? '';
+        return firstPart.includes('async');
+    }
+    /**
+     * Get the name of a named node (function, class, etc.)
+     */
+    getNodeName(node, source) {
+        // Look for identifier or name child
+        for (const child of node.children) {
+            if (!child)
+                continue;
+            if (child.type === 'identifier' ||
+                child.type === 'type_identifier' ||
+                child.type === 'property_identifier') {
+                return source.substring(child.startIndex, child.endIndex);
+            }
+        }
+        // Check named children
+        const nameChild = node.childForFieldName('name');
+        if (nameChild) {
+            return source.substring(nameChild.startIndex, nameChild.endIndex);
+        }
+        return undefined;
+    }
+    /**
+     * Get the text content of a node.
+     */
+    getNodeText(node, source) {
+        return source.substring(node.startIndex, node.endIndex);
+    }
+}
+//# sourceMappingURL=pattern.js.map

package/dist/lib/ast/pattern.js.map

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