scip-query 0.6.9 → 0.7.1

package/dist/db-Rx8Ho_JF.d.ts

@@ -1,838 +0,0 @@
-import Database from 'better-sqlite3';
-
-/**
- * Builds a gitignore-based path filter from .gitignore files found
- * in the project directory tree. This replaces hardcoded path exclusions
- * like "node_modules/", "dist/", "target/", "__pycache__/" — instead,
- * we respect whatever the project already ignores.
- *
- * Falls back to sensible defaults if no .gitignore is found.
- */
-declare function createGitignoreFilter(projectRoot: string): PathFilter;
-interface PathFilter {
-    /** Returns true if this path should be excluded from results */
-    isIgnored: (relativePath: string) => boolean;
-    /** Filter an array of paths, keeping only non-ignored ones */
-    filter: (paths: string[]) => string[];
-}
-
-/**
- * A symbol's location in the SCIP index. The minimum data needed to
- * identify a definition: which document it lives in, which lines it
- * spans, and the global symbol id. Used as a lightweight handle when
- * the caller doesn't need the symbol's textual name or path.
- */
-interface SymbolLocation {
-    documentId: number;
-    startLine: number;
-    endLine: number;
-    symbolId: number;
-}
-/**
- * A SymbolLocation plus the human-readable bits: the SCIP symbol string
- * and the document's relative path. Returned by lookup helpers like
- * `findFirstSymbolMatch` so callers don't have to round-trip through the
- * documents table to get a path or symbol name.
- */
-interface SymbolMatch extends SymbolLocation {
-    symbol: string;
-    relativePath: string;
-}
-/**
- * Reference-site of a symbol — where (file + line) the symbol is used,
- * and the smallest enclosing definition at that line (for credit
- * attribution in reverse-index views).
- */
-interface ReferenceSite {
-    file: string;
-    line: number;
-    enclosingSymbol: string | null;
-}
-/**
- * A full definition record: SymbolMatch plus per-symbol metadata
- * (leaf name, parent type, kind, documentation, enclosing symbol).
- * Used by the catalog APIs (`getDefinitionsForFile`, `getAllDefinitions`,
- * `getScopedDefinitions`) so consumers don't have to re-derive any of
- * these per-record.
- */
-interface IndexedDefinition extends SymbolMatch {
-    leaf: string;
-    parentTypeName: string | null;
-    isFunctionLike: boolean;
-    isTypeLike: boolean;
-    kind: number | null;
-    documentation: string | null;
-    enclosingSymbol: string | null;
-}
-/**
- * Internal scoring shape used by `path-resolver` to rank document path
- * candidates against a user-supplied file pattern. Not part of any
- * public CLI interface.
- */
-interface DocumentPathCandidate {
-    relativePath: string;
-    score: number;
-}
-/**
- * A single import binding parsed out of a source file. Captures both the
- * lexical shape (kind, names, source path) and a usage flag computed from
- * the source's body — `used` is `true` when the imported binding's local
- * name appears anywhere in the file outside the import statement itself.
- *
- * Producers: each per-language parser in `src/language-parsers/*.ts`.
- * Consumers: import-graph queries (`imports`, `drift`, `redundant-reexports`),
- * unused-imports queries, and the import-attribution path inside
- * `identifier-attribution.ts`.
- */
-interface ParsedSourceImport {
-    importedName: string;
-    localName: string | null;
-    sourcePath: string | null;
-    kind: 'named' | 'default' | 'namespace' | 'side-effect';
-    used: boolean;
-    usedMembers: string[];
-    isTypeOnly?: boolean;
-}
-/**
- * A single export-from binding parsed out of a source file. Used by the
- * languages that have an explicit re-export construct (Rust `pub use`,
- * Dart `export`) to surface what a barrel module re-shapes.
- */
-interface ParsedSourceExport {
-    sourcePath: string | null;
-    specifier: string;
-}
-/**
- * A re-export statement in a JavaScript/TypeScript source file — one of:
- *   export { X [as Y] } from './path'
- *   export type { X } from './path'
- *   export * from './path'
- *   export * as Ns from './path'
- *
- * The `sourcePath` is the resolved, project-relative path to the re-exported
- * module (same convention as ParsedSourceImport.sourcePath).
- */
-interface ParsedReExport {
-    kind: 'named' | 'star' | 'star-as';
-    sourcePath: string | null;
-    /** For 'named': the list of re-exported identifiers as they appear in THIS file. */
-    names: string[];
-    /** Start line in the source (0-indexed) — inclusive. */
-    startLine: number;
-    /** End line in the source (0-indexed) — inclusive. */
-    endLine: number;
-}
-/** Parsed components of a SCIP symbol string */
-interface ScipSymbol {
-    /** The indexer scheme (e.g. "scip-typescript", "scip-java", "rust-analyzer") */
-    scheme: string;
-    /** Package manager (e.g. "npm", "maven", "cargo") */
-    manager: string;
-    /** Package name (e.g. "@vega/api", "com.example/mylib") */
-    packageName: string;
-    /** Package version */
-    version: string;
-    /** Descriptor chain — the path to the symbol within the file */
-    descriptors: ScipDescriptor[];
-    /** The raw, unparsed symbol string */
-    raw: string;
-}
-interface ScipDescriptor {
-    name: string;
-    suffix: DescriptorSuffix;
-}
-type DescriptorSuffix = 'namespace' | 'type' | 'term' | 'method' | 'type-param' | 'parameter' | 'meta' | 'macro';
-/** A local symbol (file-scoped, no cross-file identity) */
-interface ScipLocalSymbol {
-    kind: 'local';
-    id: string;
-    raw: string;
-}
-interface StatsResult {
-    documents: number;
-    symbols: number;
-    definitions: number;
-    references: number;
-    indexSizeBytes: number;
-    lastBuilt: Date | null;
-}
-interface FileResult {
-    relativePath: string;
-}
-interface SymbolResult {
-    startLine: number;
-    endLine: number;
-    symbol: string;
-    shortName: string;
-    signature: string | null;
-}
-interface MethodResult {
-    startLine: number;
-    endLine: number;
-    name: string;
-}
-interface RefResult {
-    relativePath: string;
-    line: number;
-}
-interface DepResult {
-    relativePath: string;
-}
-interface TraceResult {
-    definitions: Array<{
-        relativePath: string;
-        startLine: number;
-        endLine: number;
-        signature: string | null;
-        source: string | null;
-    }>;
-    referencedBy: Array<{
-        relativePath: string;
-        line: number;
-        enclosingSymbol: string | null;
-        enclosingShort: string;
-    }>;
-}
-interface SystemResult {
-    files: string[];
-    symbols: SymbolResult[];
-    dependsOn: string[];
-    dependedOnBy: string[];
-}
-interface SurfaceResult {
-    consumer: string;
-    symbol: string;
-    shortName: string;
-}
-interface DeadSymbolResult {
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    symbol: string;
-    shortName: string;
-    sameFileRefs: number;
-    kind: 'dead-code' | 'file-internal';
-}
-interface DeadSummary {
-    symbols: DeadSymbolResult[];
-    totalCount: number;
-    /** Symbols with zero references anywhere — safe to delete */
-    deadCodeCount: number;
-    /** Symbols referenced only within their own file — no cross-file consumers.
-     *  May be private helpers (fine) or forgotten exports (needs review). */
-    fileInternalCount: number;
-    totalLoc: number;
-}
-interface HotspotResult {
-    symbol: string;
-    shortName: string;
-    refCount: number;
-    fileCount: number;
-    definedIn: string;
-}
-interface ImportResult {
-    symbol: string;
-    shortName: string;
-    fromFile: string;
-}
-interface UnusedImportResult {
-    symbol: string;
-    shortName: string;
-    importedIn: string;
-}
-interface OutlineNode {
-    symbol: string;
-    shortName: string;
-    startLine: number;
-    endLine: number;
-    children: OutlineNode[];
-}
-interface MemberResult {
-    symbol: string;
-    shortName: string;
-    startLine: number;
-    endLine: number;
-    kind: string;
-}
-interface FanResult {
-    name: string;
-    count: number;
-}
-interface CouplingResult {
-    file1: string;
-    file2: string;
-    sharedSymbols: number;
-}
-interface CycleResult {
-    /** Files forming a cycle, in order */
-    path: string[];
-    /**
-     * Classification of the cycle:
-     *   - 'real':            architectural cycle worth fixing
-     *   - 'module-hierarchy': barrel-file pattern (mod.rs / index.ts /
-     *                        __init__.py declaring children that re-import
-     *                        parent re-exports). Standard module structure,
-     *                        not actionable.
-     */
-    kind: 'real' | 'module-hierarchy';
-}
-interface BottleneckResult {
-    symbol: string;
-    shortName: string;
-    fanIn: number;
-    fanOut: number;
-    /** fanIn * fanOut — higher = more central coupling hub */
-    score: number;
-    definedIn: string;
-}
-interface IsolatedResult {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-}
-interface ByKindResult {
-    symbol: string;
-    shortName: string;
-    kind: number;
-    kindName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-}
-interface DeepChainResult {
-    /** Files in the chain, from leaf to root */
-    chain: string[];
-    depth: number;
-}
-interface HierarchyNode {
-    symbol: string;
-    shortName: string;
-    depth: number;
-}
-interface CallGraphResult {
-    symbol: string;
-    shortName: string;
-    /** Symbols that call this one (incoming) */
-    callers: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-    }>;
-    /** Symbols called by this one (outgoing) */
-    callees: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-    }>;
-}
-interface DriftResult {
-    file: string;
-    kind: 'unused-import' | 'layer-violation' | 'pattern-deviation';
-    description: string;
-    /** The dependency involved */
-    dep: string;
-    /** For layer violations: the expected layer boundary */
-    detail?: string;
-}
-interface DriftSummary {
-    results: DriftResult[];
-    unusedImports: number;
-    layerViolations: number;
-    patternDeviations: number;
-}
-interface WrapperCandidate {
-    symbol: string;
-    shortName: string;
-    file: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    singleCaller: string;
-    singleCallerShort: string;
-    callerFanIn: number;
-}
-interface PassthroughCandidate {
-    symbol: string;
-    shortName: string;
-    file: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    forwardsTo: string;
-    forwardsToShort: string;
-    forwardsToFile: string;
-}
-interface StaleAbstraction {
-    symbol: string;
-    shortName: string;
-    file: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    /**
-     * Cross-file consumers NOT counting files that only re-export the symbol
-     * through a barrel (`export { X } from '...'`). Barrel files expand the
-     * public surface; they aren't real consumers.
-     */
-    consumers: number;
-    /** Number of files whose only reference is a passthrough re-export. */
-    barrelConsumers: number;
-    /** What the definition is syntactically — detected from source at the definition line. */
-    kind: 'class' | 'interface' | 'type' | 'enum' | 'other';
-    /**
-     * Does the defining file itself reference the type outside its own declaration?
-     * `false` is the strongest stale signal — the type lives in a file that never
-     * uses it (misplaced types file), while another file is its only consumer.
-     */
-    definerUsesType: boolean;
-    /**
-     * Ranked confidence in the "stale" verdict:
-     *   'high'   — consumers === 0, OR consumers === 1 && !definerUsesType && kind !== 'class'.
-     *   'medium' — consumers <= 1 with one of the signals pointing weakly stale.
-     *   'low'    — consumers === 1 but kind === 'class' (likely encapsulation, not over-abstraction).
-     */
-    confidence: 'high' | 'medium' | 'low';
-    /** Short human-readable explanation of why this was flagged. */
-    reason: string;
-}
-interface ComplexityHotspot {
-    symbol: string;
-    shortName: string;
-    file: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    fanIn: number;
-    fanOut: number;
-    calleeCount: number;
-    score: number;
-}
-interface SimilarSymbolResult {
-    symbolA: string;
-    shortNameA: string;
-    fileA: string;
-    symbolB: string;
-    shortNameB: string;
-    fileB: string;
-    /** Similarity score (0-1). Basis says what evidence was compared. */
-    similarity: number;
-    /** Evidence used for similarity: call graph callees or lexical source tokens. */
-    similarityBasis?: 'callees' | 'source-tokens';
-    /** Shared callees or source tokens, depending on similarityBasis. */
-    sharedCallees: string[];
-    /** Callees or source tokens unique to A, depending on similarityBasis. */
-    uniqueToA: string[];
-    /** Callees or source tokens unique to B, depending on similarityBasis. */
-    uniqueToB: string[];
-}
-interface SimilarFileResult {
-    fileA: string;
-    fileB: string;
-    /** Jaccard similarity of dependency sets (0-1) */
-    similarity: number;
-    sharedDeps: string[];
-    uniqueToA: string[];
-    uniqueToB: string[];
-}
-interface SimilarChainResult {
-    chainA: string[];
-    chainB: string[];
-    /** Fraction of nodes shared (0-1) */
-    similarity: number;
-    /** Edit distance between the two chains */
-    editDistance: number;
-    /** Indices where the chains diverge — the consolidation targets */
-    divergencePoints: Array<{
-        index: number;
-        nodeA: string;
-        nodeB: string;
-    }>;
-    /** Shared prefix */
-    commonPrefix: string[];
-    /** Shared suffix */
-    commonSuffix: string[];
-}
-interface ExtractCandidate {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    /** Total callees */
-    totalCallees: number;
-    /** Distinct clusters of callees (natural extraction seams) */
-    clusters: Array<{
-        callees: string[];
-        /** How isolated this cluster is from the rest (0-1, higher = more extractable) */
-        isolation: number;
-    }>;
-}
-interface HealthAction {
-    category: string;
-    description: string;
-    effort: 'low' | 'medium' | 'high';
-    impact: 'low' | 'medium' | 'high';
-    count: number;
-    locRecoverable: number;
-}
-interface HealthReport {
-    score: number;
-    overview: {
-        documents: number;
-        symbols: number;
-        indexSizeBytes: number;
-    };
-    findings: {
-        deadSymbols: number;
-        deadLoc: number;
-        isolatedSymbols: number;
-        isolatedLoc: number;
-        cycles: number;
-        similarPairs: number;
-        extractionCandidates: number;
-        wrappers: number;
-        passthroughs: number;
-        staleTypes: number;
-        driftedFiles: number;
-        complexityHotspotCount: number;
-    };
-    actions: HealthAction[];
-    topComplexity: Array<{
-        symbol: string;
-        score: number;
-    }>;
-    warnings?: string[];
-}
-interface ConvergenceResult {
-    symbolA: {
-        symbol: string;
-        shortName: string;
-        file: string;
-        loc: number;
-    };
-    symbolB: {
-        symbol: string;
-        shortName: string;
-        file: string;
-        loc: number;
-    };
-    similarity: number;
-    sharedCallees: string[];
-    uniqueToA: string[];
-    uniqueToB: string[];
-    consolidationStrategy: string;
-}
-interface CodeResult {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    language: string | null;
-    source: string;
-}
-interface ComplexityResult {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    loc: number;
-    /** Branch count from source-level regex (if, else, for, while, switch, catch, ternary, &&, ||) */
-    branches: number;
-    /** Cyclomatic complexity estimate: branches + 1 */
-    cyclomaticEstimate: number;
-    /** Number of distinct callees within the definition */
-    calleeCount: number;
-    fanIn: number;
-    fanOut: number;
-}
-interface DataflowResult {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    /** Where the symbol is defined (role=1) */
-    definitionSites: Array<{
-        file: string;
-        line: number;
-    }>;
-    /** Where the symbol is referenced (role!=1) */
-    usageSites: Array<{
-        file: string;
-        line: number;
-        enclosingSymbol: string;
-        enclosingShort: string;
-    }>;
-    /** Symbols that appear in the same function that defines this symbol (producers/inputs) */
-    producers: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-    }>;
-    /** Symbols defined by functions that reference this symbol (consumers/outputs) */
-    consumers: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-    }>;
-}
-interface SliceResult {
-    symbol: string;
-    shortName: string;
-    direction: 'backward' | 'forward';
-    /** Backward: symbols referenced in the same function as the target's definition (inputs) */
-    /** Forward: symbols defined by functions that reference the target (outputs) */
-    connectedSymbols: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-        relationship: string;
-    }>;
-}
-interface AffectedResult {
-    symbol: string;
-    shortName: string;
-    file: string;
-    depth: number;
-}
-interface ChangeSurfaceEntry {
-    symbol: string;
-    shortName: string;
-    startLine: number;
-    endLine: number;
-    externalConsumers: number;
-    riskLevel: 'low' | 'medium' | 'high';
-}
-interface ChangeSurfaceResult {
-    file: string;
-    symbols: ChangeSurfaceEntry[];
-    totalExternalConsumers: number;
-}
-interface DiffImpactResult {
-    changedFiles: string[];
-    changedSymbols: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-        fanIn: number;
-    }>;
-    affectedConsumers: Array<{
-        file: string;
-        consumedSymbols: number;
-    }>;
-    summary: {
-        totalChangedFiles: number;
-        totalChangedSymbols: number;
-        totalAffectedFiles: number;
-        note?: string;
-    };
-}
-interface DeadOptions {
-    scope?: string;
-    minLoc?: number;
-    includeTests?: boolean;
-    skipBarrels?: boolean;
-    includeMembers?: boolean;
-    deadCodeOnly?: boolean;
-    scanLimit?: number;
-    semantic?: boolean;
-}
-interface InstallMethod {
-    /** Human-readable label (e.g., "npm", "pip", "go install") */
-    label: string;
-    /** Binary that must exist for this install method to work (e.g., "npm", "pip3", "go") */
-    prerequisite: string;
-    /** Command to execute */
-    binary: string;
-    /** Arguments for the command */
-    args: string[];
-}
-type SupportedLanguage = 'typescript' | 'javascript' | 'java' | 'scala' | 'kotlin' | 'rust' | 'python' | 'ruby' | 'go' | 'cpp' | 'c' | 'csharp' | 'vb' | 'dart' | 'php';
-interface IndexerConfig {
-    language: SupportedLanguage;
-    /** Preferred executable name for the indexer */
-    indexerBinary: string;
-    /** Additional executable names accepted on PATH for the same indexer */
-    binaryAliases?: string[];
-    /** Project-local executable paths to prefer when they exist */
-    projectLocalBinaries?: string[];
-    /** Command to check if the indexer is installed */
-    checkCommand: string;
-    /** Returns the binary + args array for execFileSync (no shell injection) */
-    indexArgs: (opts: {
-        projectRoot: string;
-        outputPath: string;
-        pnpmWorkspaces?: boolean;
-        indexerBinary: string;
-    }) => {
-        binary: string;
-        args: string[];
-    };
-    /** Relative output path written by the indexer when it ignores outputPath */
-    defaultOutputPath?: string;
-    /** Marker files that indicate this language is present */
-    markerFiles: string[];
-    /** Installation methods to try in order of preference */
-    installMethods?: InstallMethod[];
-    /** URL for manual installation if auto-install fails */
-    installUrl?: string;
-    /**
-     * npm package bundled with scip-query as an optionalDependency. When this
-     * package resolves locally (i.e. it installed successfully), the indexer is
-     * considered available even if its binary isn't on PATH — `npx <binary>`
-     * will pick up the local install.
-     */
-    bundledNpmPackage?: string;
-}
-interface ScipQueryConfig {
-    /** Path to the SQLite database (index.db) */
-    dbPath: string;
-    /** Path to the SCIP protobuf index (index.scip) */
-    indexPath: string;
-    /** Project root directory */
-    projectRoot: string;
-    /** Project-specific externally-live roots for dead-code filtering */
-    entryRoots?: EntryRootsConfig;
-    /** Paths to .gitignore files to load for filtering */
-    gitignorePaths?: string[];
-    /** Optional semantic-provider configuration */
-    semantic?: SemanticConfig;
-}
-interface ProjectConfig {
-    /** Override which languages to index (default: auto-detect) */
-    languages?: SupportedLanguage[];
-    /** Watch mode settings */
-    watch?: WatchConfig;
-    /** Per-language indexer overrides */
-    indexer?: Partial<Record<SupportedLanguage, IndexerOverrides>>;
-    /** Override the database storage path (default: ~/.cache/scip-query/<hash>/) */
-    dbPath?: string;
-    /** Project-specific externally-live roots for dead-code filtering */
-    entryRoots?: EntryRootsConfig;
-    /** Optional semantic-provider configuration */
-    semantic?: SemanticConfig;
-}
-interface SemanticConfig {
-    typescript?: TypeScriptSemanticConfig;
-}
-interface TypeScriptSemanticConfig {
-    /** Explicit tsconfig paths, relative to project root unless absolute */
-    tsconfigs?: string[];
-}
-interface EntryRootsConfig {
-    /** Any symbol defined in these path prefixes is externally live */
-    pathPrefixes?: string[];
-    /** Any symbol defined in these exact files is externally live */
-    files?: string[];
-    /** Symbols matching these regular expressions are externally live */
-    symbolPatterns?: string[];
-    /** Qualified var names like my.ns/my-fn that are externally live */
-    qualifiedVars?: string[];
-}
-interface WatchConfig {
-    /** Enable file watching (default: false, must opt in) */
-    enabled?: boolean;
-    /** Ms to wait after the last file change before triggering reindex (default: 30000) */
-    debounceMs?: number;
-    /** Minimum ms between reindex completions (default: 60000) */
-    cooldownMs?: number;
-    /** Extra glob patterns to ignore beyond .gitignore */
-    ignore?: string[];
-}
-interface IndexerOverrides {
-    /** Enable pnpm workspace support (TypeScript) */
-    pnpmWorkspaces?: boolean;
-}
-interface RedundantReexport {
-    barrelFile: string;
-    symbol: string;
-    shortName: string;
-    originalFile: string;
-    /** How many consumers import through the barrel */
-    barrelConsumers: number;
-    /** How many consumers import directly from the source */
-    directConsumers: number;
-}
-interface SimilarSignatureGroup {
-    /** The normalized signature shared by all functions in the group */
-    signature: string;
-    /** Functions that share this signature */
-    functions: Array<{
-        symbol: string;
-        shortName: string;
-        file: string;
-        startLine: number;
-        endLine: number;
-        loc: number;
-    }>;
-}
-type WatcherStatus = {
-    state: 'idle';
-} | {
-    state: 'waiting';
-    changedFiles: number;
-    reindexAt: number;
-} | {
-    state: 'indexing';
-    startedAt: number;
-} | {
-    state: 'cooldown';
-    until: number;
-    dirty: boolean;
-};
-
-/**
- * Thin wrapper around better-sqlite3 with a pre-configured connection
- * and helper methods for the SCIP SQLite schema.
- *
- * The schema is produced by `scip expt-convert` and is identical
- * regardless of source language (TypeScript, Rust, Python, etc.).
- *
- * Tables:
- *   documents             — indexed files (id, language, relative_path)
- *   global_symbols        — all symbols (id, symbol, display_name, kind, documentation)
- *   defn_enclosing_ranges — definition locations (document_id, symbol_id, start/end line/char)
- *   mentions              — references & definitions (chunk_id, symbol_id, role)
- *   chunks                — code segments (document_id, chunk_index, start/end line, occurrences)
- */
-declare class ScipDatabase {
-    readonly db: Database.Database;
-    readonly config: ScipQueryConfig;
-    private pathFilter;
-    constructor(config: ScipQueryConfig, pathFilter?: PathFilter);
-    /** Check if a path should be excluded based on .gitignore rules */
-    isIgnored(relativePath: string): boolean;
-    /**
-     * The local-symbol predicate: only match symbols that are defined
-     * in files NOT excluded by gitignore. This replaces the old hardcoded
-     * `NOT LIKE 'node_modules/%'` check.
-     *
-     * Since SQLite can't evaluate JS gitignore rules inline, we use a
-     * simpler approach: query broadly, then filter in JS. For queries
-     * that need SQL-level filtering, use excludedPathPatterns().
-     */
-    get localSymbolPredicate(): string;
-    /**
-     * SQL WHERE clause fragments to exclude common build/dependency paths.
-     * Complements the JS-level gitignore filtering for performance.
-     */
-    get pathExclusions(): string;
-    /** Reusable SQL fragment: filter out synthetic/internal symbol noise */
-    get symbolNoise(): string;
-    /** Build SQL path exclusions for one or more document table aliases */
-    pathExclusionsFor(...aliases: string[]): string;
-    /** Build SQL symbol exclusions for the given global_symbols alias */
-    symbolNoiseFor(alias: string): string;
-    /** Run a raw SQL query and return all rows */
-    all<T = Record<string, unknown>>(sql: string, ...params: unknown[]): T[];
-    /** Run a raw SQL query and return the first row */
-    get<T = Record<string, unknown>>(sql: string, ...params: unknown[]): T | undefined;
-    close(): void;
-}
-
-export { type ProjectConfig as $, type AffectedResult as A, type BottleneckResult as B, type CallGraphResult as C, type DataflowResult as D, type ExtractCandidate as E, type FanResult as F, type StaleAbstraction as G, type HealthReport as H, type ImportResult as I, type SliceResult as J, type RedundantReexport as K, type SimilarSignatureGroup as L, type MemberResult as M, type SymbolMatch as N, type OutlineNode as O, type PassthroughCandidate as P, type SymbolLocation as Q, type RefResult as R, ScipDatabase as S, type TraceResult as T, type UnusedImportResult as U, type IndexedDefinition as V, type WrapperCandidate as W, type ScipSymbol as X, type ScipLocalSymbol as Y, type SupportedLanguage as Z, type IndexerConfig as _, type ByKindResult as a, type WatcherStatus as a0, type ChangeSurfaceEntry as a1, type DeadSymbolResult as a2, type DescriptorSuffix as a3, type DocumentPathCandidate as a4, type DriftResult as a5, type EntryRootsConfig as a6, type HealthAction as a7, type IndexerOverrides as a8, type InstallMethod as a9, type ParsedReExport as aa, type ParsedSourceExport as ab, type ParsedSourceImport as ac, type ReferenceSite as ad, type ScipDescriptor as ae, type ScipQueryConfig as af, type SemanticConfig as ag, type TypeScriptSemanticConfig as ah, type WatchConfig as ai, createGitignoreFilter as aj, type ChangeSurfaceResult as b, type CodeResult as c, type ComplexityHotspot as d, type ComplexityResult as e, type ConvergenceResult as f, type CouplingResult as g, type CycleResult as h, type DeadOptions as i, type DeadSummary as j, type DeepChainResult as k, type DepResult as l, type DiffImpactResult as m, type DriftSummary as n, type FileResult as o, type HierarchyNode as p, type HotspotResult as q, type IsolatedResult as r, type MethodResult as s, type StatsResult as t, type SymbolResult as u, type SystemResult as v, type SurfaceResult as w, type SimilarSymbolResult as x, type SimilarFileResult as y, type SimilarChainResult as z };