import type { ScannedFile, GraphNode } from '../orient.types.js';
/**
 * @purpose Build a consumer dependency graph from scanned files.
 * @invariant Consumer names are extracted from @consumers: headers.
 * @invariant Consumer name matching a file name resolves to that file; otherwise it is a text node.
 * @param files All scanned project files.
 * @returns Map of consumer name to GraphNode.
 */
export declare function buildGraph(files: ScannedFile[]): Map<string, GraphNode>;
/**
 * @purpose Build a recursive dependency tree from the flat graph.
 * @invariant Detects and marks circular dependencies with `[circular]`.
 * @param graph Flat graph map from buildGraph.
 * @param rootConsumer Root consumer name to start from.
 * @param maxDepth Maximum recursion depth.
 * @returns Indented tree lines.
 */
export declare function buildRecursiveTree(graph: Map<string, GraphNode>, rootConsumer: string, maxDepth: number): string[];