memgrid 0.5.0

package/dist/scanner/python.js

@@ -0,0 +1,177 @@
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Python project scanner.
+ * Extracts functions, classes, methods, decorators via regex-based parsing.
+ */
+export class PythonScanner {
+    name = 'python';
+    projectRoot;
+    constructor(_store, projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    detect(projectRoot) {
+        return (fs.existsSync(path.join(projectRoot, 'pyproject.toml')) ||
+            fs.existsSync(path.join(projectRoot, 'setup.py')) ||
+            fs.existsSync(path.join(projectRoot, 'requirements.txt')) ||
+            fs.existsSync(path.join(projectRoot, 'Pipfile')) ||
+            this.findSourceDirs(projectRoot).length > 0);
+    }
+    async scan(_options) {
+        const units = [];
+        const srcDirs = this.findSourceDirs(this.projectRoot);
+        for (const dir of srcDirs) {
+            await this.scanDir(dir, '', units);
+        }
+        // Also scan root-level .py files (excluding setup.py, __init__.py scaffold)
+        const rootDirs = ['src', 'lib', 'tests', 'app'];
+        for (const d of rootDirs) {
+            const abs = path.join(this.projectRoot, d);
+            if (fs.existsSync(abs) && !srcDirs.includes(abs)) {
+                await this.scanDir(abs, '', units);
+            }
+        }
+        return units;
+    }
+    async scanDir(dir, relPrefix, units) {
+        if (!fs.existsSync(dir))
+            return;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const abs = path.join(dir, entry.name);
+            const rel = relPrefix ? path.join(relPrefix, entry.name) : entry.name;
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith('.') || entry.name === '__pycache__' || entry.name === 'node_modules')
+                    continue;
+                if (entry.name === 'tests' || entry.name === 'test')
+                    continue;
+                await this.scanDir(abs, rel, units);
+            }
+            else if (entry.name.endsWith('.py') && !entry.name.startsWith('test_') && !entry.name.endsWith('_test.py')) {
+                try {
+                    const code = fs.readFileSync(abs, 'utf-8');
+                    this.parsePythonFile(code, rel, units);
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+        }
+    }
+    parsePythonFile(code, file, units) {
+        const lines = code.split('\n');
+        // Class pattern: class ClassName(...):
+        const classPattern = /^class\s+(\w+)\s*(?:\(([^)]*)\))?\s*:/;
+        // Function/method pattern: def func_name(params):
+        const funcPattern = /^\s{0,8}def\s+(\w+)\s*\(([^)]*)\)\s*(?:->\s*(\S+))?\s*:/;
+        let currentClass = '';
+        let decorators = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const stripped = line.trim();
+            // Track decorators
+            if (stripped.startsWith('@')) {
+                decorators.push(stripped);
+                continue;
+            }
+            // Class
+            const classMatch = stripped.match(classPattern);
+            if (classMatch) {
+                currentClass = classMatch[1];
+                const doc = this.extractDoc(lines, i + 1);
+                units.push({
+                    id: `method_py_${this.sanitizeId(currentClass)}`,
+                    type: 'method',
+                    summary: `${currentClass}${doc ? ` — ${doc}` : ''}`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [currentClass],
+                    content: {
+                        description: `Python class ${currentClass}${decorators.length ? ` [${decorators.join(', ')}]` : ''}`,
+                    },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.7,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+                decorators = [];
+                continue;
+            }
+            // Function/method
+            const funcMatch = stripped.match(funcPattern);
+            if (funcMatch) {
+                const funcName = funcMatch[1];
+                if (funcName.startsWith('_') && funcName !== '__init__') {
+                    decorators = [];
+                    continue;
+                } // skip private
+                const params = funcMatch[2];
+                const returnType = funcMatch[3] || '';
+                const doc = this.extractDoc(lines, i + 1);
+                const fullName = currentClass ? `${currentClass}.${funcName}` : funcName;
+                const unit = {
+                    id: `method_py_${this.sanitizeId(fullName)}`,
+                    type: 'method',
+                    summary: doc ? `${fullName}() — ${doc}` : `${fullName}()`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [fullName, funcName],
+                    content: {
+                        description: doc || `${fullName}()`,
+                        inputs: params || 'none',
+                        outputs: returnType || 'unknown',
+                    },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: currentClass ? 0.75 : 0.7,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                };
+                // Add decorator info
+                if (decorators.length > 0) {
+                    unit.content.style_notes = `Decorators: ${decorators.join(', ')}`;
+                }
+                units.push(unit);
+                decorators = [];
+            }
+        }
+    }
+    extractDoc(lines, startLine) {
+        // Look for """ or ''' docstring on next non-empty line
+        for (let i = startLine; i < Math.min(startLine + 3, lines.length); i++) {
+            const line = lines[i].trim();
+            const match = line.match(/^["']{3}([^"']*)["']{3}$/);
+            if (match)
+                return match[1].trim();
+            if (line.startsWith('"""') || line.startsWith("'''")) {
+                const inner = line.replace(/^["']{3}|["']{3}$/g, '').trim();
+                return inner || '...';
+            }
+        }
+        return '';
+    }
+    findSourceDirs(projectRoot) {
+        const dirs = [];
+        for (const name of ['src', 'app', 'lib', 'modules']) {
+            const abs = path.join(projectRoot, name);
+            if (fs.existsSync(abs) && fs.statSync(abs).isDirectory()) {
+                dirs.push(abs);
+            }
+        }
+        return dirs;
+    }
+    sanitizeId(text) {
+        return text
+            .replace(/\./g, '_')
+            .replace(/__/g, '_dunder_')
+            .replace(/[^a-zA-Z0-9_\-]/g, '_')
+            .replace(/_+/g, '_')
+            .toLowerCase()
+            .replace(/^_|_$/g, '');
+    }
+}
+//# sourceMappingURL=python.js.map

package/dist/scanner/python.js.map

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

package/dist/scanner/rules.d.ts

@@ -0,0 +1,15 @@
+import type { MemoryUnit, ScanOptions } from '../shared/types.js';
+import type { Scanner } from './scanner.js';
+/**
+ * Shared scanner for .claude/rules/*.md files.
+ * Extracted from TypeScriptScanner — applies to any language project.
+ */
+export declare class RulesScanner implements Scanner {
+    readonly name = "rules";
+    private projectRoot;
+    constructor(projectRoot: string);
+    detect(projectRoot: string): boolean;
+    scan(_options: ScanOptions): Promise<MemoryUnit[]>;
+    scanFiles(_files: string[], _options: ScanOptions): Promise<MemoryUnit[]>;
+}
+//# sourceMappingURL=rules.d.ts.map

package/dist/scanner/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/scanner/rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAI/B,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAK9B,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqElD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAIhF"}

package/dist/scanner/rules.js

@@ -0,0 +1,86 @@
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Shared scanner for .claude/rules/*.md files.
+ * Extracted from TypeScriptScanner — applies to any language project.
+ */
+export class RulesScanner {
+    name = 'rules';
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    detect(projectRoot) {
+        const dir = path.join(projectRoot, '.claude', 'rules');
+        return fs.existsSync(dir) && fs.readdirSync(dir).some((f) => f.endsWith('.md'));
+    }
+    async scan(_options) {
+        const units = [];
+        const rulesDir = path.join(this.projectRoot, '.claude', 'rules');
+        if (!fs.existsSync(rulesDir))
+            return units;
+        for (const file of fs.readdirSync(rulesDir)) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(rulesDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const relativePath = path.relative(this.projectRoot, filePath);
+            // Extract sections from markdown
+            const sections = content.split(/^## /m).filter(Boolean);
+            for (const section of sections) {
+                const title = section.split('\n')[0].trim();
+                const body = section.split('\n').slice(1).join('\n').trim();
+                if (!title || body.length < 50)
+                    continue;
+                const safeTitle = title.replace(/[^a-zA-Z0-9_\-]/g, '_').replace(/_+/g, '_').slice(0, 50).toLowerCase();
+                if (!safeTitle || safeTitle === '_')
+                    continue;
+                const safeFile = file.replace('.md', '').replace(/[^a-zA-Z0-9_\-]/g, '_').replace(/_+/g, '_').slice(0, 30).toLowerCase();
+                units.push({
+                    id: `rule_${safeFile}_${safeTitle}`,
+                    type: 'pattern',
+                    summary: `${file.replace('.md', '')}: ${title}`,
+                    source: { file: relativePath },
+                    signatures: [title, file.replace('.md', '').replace(/-/g, ' ')],
+                    content: { description: body.slice(0, 500) },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.9,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+            }
+            // Also create a rule_trigger unit
+            const safeFile = file.replace('.md', '').replace(/[^a-zA-Z0-9_\-]/g, '_').replace(/_+/g, '_').slice(0, 30).toLowerCase();
+            units.push({
+                id: `trigger_rule_${safeFile}`,
+                type: 'rule_trigger',
+                summary: `When working on ${file.replace('.md', '').replace(/-/g, ' ')} → load ${file}`,
+                source: { file: relativePath },
+                signatures: [file.replace('.md', '').replace(/-/g, ' ')],
+                content: {
+                    description: `Load ${relativePath} when working on relevant code`,
+                    trigger: `Working on ${file.replace('.md', '').replace(/-/g, ' ')} related code`,
+                    action: `Load ${relativePath}`,
+                },
+                associations: [],
+                meta: {
+                    created: new Date().toISOString(),
+                    updated: new Date().toISOString(),
+                    confidence: 0.8,
+                    usage_count: 0,
+                    status: 'active',
+                },
+            });
+        }
+        return units;
+    }
+    async scanFiles(_files, _options) {
+        // Rules are small — just re-scan all
+        return this.scan(_options);
+    }
+}
+//# sourceMappingURL=rules.js.map

package/dist/scanner/rules.js.map

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

package/dist/scanner/rust.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryUnit, ScanOptions } from '../shared/types.js';
+import type { Scanner } from './scanner.js';
+/**
+ * Rust project scanner.
+ * Regex-based: extracts fn, struct, impl, trait, enum declarations.
+ */
+export declare class RustScanner implements Scanner {
+    readonly name = "rust";
+    private projectRoot;
+    constructor(_store: any, projectRoot: string);
+    detect(projectRoot: string): boolean;
+    scan(_options: ScanOptions): Promise<MemoryUnit[]>;
+    private scanDir;
+    private parseRustFile;
+    private findSourceDirs;
+    private sanitizeId;
+}
+//# sourceMappingURL=rust.d.ts.map

package/dist/scanner/rust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.d.ts","sourceRoot":"","sources":["../../src/scanner/rust.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM;IAI5C,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI9B,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAW1C,OAAO;IAmBrB,OAAO,CAAC,aAAa;IA2HrB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,UAAU;CAUnB"}

package/dist/scanner/rust.js

@@ -0,0 +1,178 @@
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Rust project scanner.
+ * Regex-based: extracts fn, struct, impl, trait, enum declarations.
+ */
+export class RustScanner {
+    name = 'rust';
+    projectRoot;
+    constructor(_store, projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    detect(projectRoot) {
+        return fs.existsSync(path.join(projectRoot, 'Cargo.toml'));
+    }
+    async scan(_options) {
+        const units = [];
+        const srcDirs = this.findSourceDirs(this.projectRoot);
+        for (const dir of srcDirs) {
+            await this.scanDir(dir, '', units);
+        }
+        return units;
+    }
+    async scanDir(dir, relPrefix, units) {
+        if (!fs.existsSync(dir))
+            return;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const abs = path.join(dir, entry.name);
+            const rel = relPrefix ? path.join(relPrefix, entry.name) : entry.name;
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith('.') || entry.name === 'target' || entry.name === 'node_modules')
+                    continue;
+                await this.scanDir(abs, rel, units);
+            }
+            else if (entry.name.endsWith('.rs')) {
+                try {
+                    const code = fs.readFileSync(abs, 'utf-8');
+                    this.parseRustFile(code, rel, units);
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+    parseRustFile(code, file, units) {
+        const lines = code.split('\n');
+        let currentImpl = '';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // fn name(params) -> ReturnType {
+            let match = line.match(/^(?:pub(?:\s*\(\s*crate\s*\))?\s+)?(?:async\s+)?fn\s+(\w+)\s*(?:<[^>]*>)?\s*\(([^)]*)\)\s*(?:->\s*([^{]+?))?\s*\{/);
+            if (match) {
+                const fnName = match[1];
+                if (fnName === 'main' || fnName.startsWith('test_'))
+                    continue;
+                const params = match[2];
+                const retType = match[3]?.trim() || '';
+                const fullName = currentImpl ? `${currentImpl}::${fnName}` : fnName;
+                units.push({
+                    id: `method_rs_${this.sanitizeId(fullName)}`,
+                    type: 'method',
+                    summary: retType ? `${fullName}() → ${retType}` : `${fullName}()`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [fullName, fnName],
+                    content: {
+                        description: `Rust function ${fullName}()`,
+                        inputs: params || 'none',
+                        outputs: retType || '()',
+                    },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.7,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+                continue;
+            }
+            // pub struct Name {
+            match = line.match(/^(?:pub\s+)?struct\s+(\w+)\s*(?:<[^>]*>)?\s*\{/);
+            if (match) {
+                const structName = match[1];
+                units.push({
+                    id: `method_rs_struct_${this.sanitizeId(structName)}`,
+                    type: 'method',
+                    summary: `${structName} (struct)`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [structName],
+                    content: { description: `Rust struct ${structName}` },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.65,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+                continue;
+            }
+            // pub enum Name {
+            match = line.match(/^(?:pub\s+)?enum\s+(\w+)\s*\{/);
+            if (match) {
+                units.push({
+                    id: `method_rs_enum_${this.sanitizeId(match[1])}`,
+                    type: 'pattern',
+                    summary: `${match[1]} (enum)`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [match[1]],
+                    content: { description: `Rust enum ${match[1]}` },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.65,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+                continue;
+            }
+            // pub trait Name {
+            match = line.match(/^(?:pub\s+)?trait\s+(\w+)\s*\{/);
+            if (match) {
+                units.push({
+                    id: `method_rs_trait_${this.sanitizeId(match[1])}`,
+                    type: 'pattern',
+                    summary: `${match[1]} (trait)`,
+                    source: { file, lines: `${i + 1}` },
+                    signatures: [match[1]],
+                    content: { description: `Rust trait ${match[1]}` },
+                    associations: [],
+                    meta: {
+                        created: new Date().toISOString(),
+                        updated: new Date().toISOString(),
+                        confidence: 0.7,
+                        usage_count: 0,
+                        status: 'active',
+                    },
+                });
+                continue;
+            }
+            // impl Type { or impl Trait for Type {
+            match = line.match(/^impl(?:\s+(\w+)\s+for)?\s+(\w+)\s*\{/);
+            if (match) {
+                currentImpl = match[2];
+                continue;
+            }
+            // Close impl block
+            if (line === '}' && currentImpl) {
+                currentImpl = '';
+                continue;
+            }
+        }
+    }
+    findSourceDirs(projectRoot) {
+        const dirs = [];
+        for (const name of ['src', 'crates']) {
+            const abs = path.join(projectRoot, name);
+            if (fs.existsSync(abs) && fs.statSync(abs).isDirectory()) {
+                dirs.push(abs);
+            }
+        }
+        return dirs;
+    }
+    sanitizeId(text) {
+        return text
+            .replace(/::/g, '_')
+            .replace(/\./g, '_')
+            .replace(/<[^>]*>/g, '')
+            .replace(/[^a-zA-Z0-9_\-]/g, '_')
+            .replace(/_+/g, '_')
+            .toLowerCase()
+            .replace(/^_|_$/g, '');
+    }
+}
+//# sourceMappingURL=rust.js.map

package/dist/scanner/rust.js.map

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

package/dist/scanner/scanner.d.ts

@@ -0,0 +1,33 @@
+import type { MemoryUnit, ScanOptions } from '../shared/types.js';
+/**
+ * Scanner interface — scan a project directory and produce memory units.
+ *
+ * MemGrid is language-agnostic. Each language/framework gets its own
+ * Scanner implementation. Scanners are composed via CompositeScanner.
+ *
+ * Implementations:
+ * - TypeScriptScanner — ts-morph AST extraction
+ * - (future) PythonScanner, GoScanner, MarkdownScanner, ComponentScanner...
+ */
+export interface Scanner {
+    /** Human-readable name for CLI output */
+    readonly name: string;
+    /**
+     * Scan the configured project and return memory units.
+     * Called once during init, or per-changed-file during sync.
+     */
+    scan(options: ScanOptions): Promise<MemoryUnit[]>;
+    /**
+     * Scan only specific files (used by incremental sync).
+     * Default implementation: returns empty array (scanner doesn't support partial).
+     * Override for scanners that can parse individual files.
+     */
+    scanFiles?(files: string[], options: ScanOptions): Promise<MemoryUnit[]>;
+    /**
+     * Detect whether this scanner applies to the given project.
+     * e.g. TypeScriptScanner checks for tsconfig.json or .ts files.
+     * Used by auto-detection in CLI.
+     */
+    detect(projectRoot: string): boolean;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAElD;;;;OAIG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEzE;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC"}

package/dist/scanner/scanner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.js.map

package/dist/scanner/scanner.js.map

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

package/dist/scanner/typescript.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryUnit, ScanOptions } from '../shared/types.js';
+import type { FileStore } from '../store/file-store.js';
+import type { Scanner } from './scanner.js';
+export declare class TypeScriptScanner implements Scanner {
+    readonly name = "typescript";
+    private store;
+    private projectRoot;
+    constructor(store: FileStore, projectRoot: string);
+    detect(projectRoot: string): boolean;
+    scan(options: ScanOptions): Promise<MemoryUnit[]>;
+    private scanTypeScript;
+    private scanRules;
+    private scanExamples;
+    private scanConfig;
+    private sanitizeId;
+    private buildAssociations;
+    private updateGrid;
+    private extractJsDoc;
+    private extractDependencies;
+    /**
+     * Extract function/method names called in a code snippet.
+     * Matches patterns like: foo(), await foo(), this.foo(), obj.foo()
+     */
+    private extractCalledNames;
+    private isCommonKeyword;
+    private findSourceDirs;
+}
+//# sourceMappingURL=typescript.d.ts.map

package/dist/scanner/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/scanner/typescript.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA2B,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM;IAKjD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAO9B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAkCzC,cAAc;YA8Hd,SAAS;YA2ET,YAAY;YA8CZ,UAAU;IAgExB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAkGzB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,mBAAmB;IAc3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;CAkBvB"}