import type { AstNode, SourceMap } from '../parser/types';
/**
 * Source map utilities for debugger frontends.
 * Resolves AST node positions from the source map — shared by VS Code DAP adapter,
 * playground debugger, and any future debug frontend.
 */
/** Resolve a node's source file path from the source map. */
export declare function getNodeFile(node: AstNode, sourceMap: SourceMap): string | null;
/** Resolve a node's 0-based start line from the source map. */
export declare function getNodeLine(node: AstNode, sourceMap: SourceMap): number | null;
/** Resolve a node's 0-based end line from the source map. */
export declare function getNodeEndLine(node: AstNode, sourceMap: SourceMap): number | null;
/**
 * Find the first evaluatable node ID on a given line in a given file.
 * Skips structuralLeaf nodes (Sym, Builtin, etc.) since the evaluator's
 * onNodeEval hook never visits them — setting a breakpoint on one would never fire.
 * DAP lines are 1-based, source map positions are 0-based.
 * Returns null if no node found on that line.
 */
export declare function findNodeIdForLine(line: number, filePath: string, sourceMap: SourceMap): number | null;