import type { Finding } from '../types.js';
/**
 * todo-comments takes an OPTIONAL files list because the detector
 * walks the workspace itself when omitted — that's how it picks up
 * Python / Go / shell sources the TS parser ignores. The shared
 * `FileWalkingDetectorInput` requires `files`, so this detector keeps
 * its own shape rather than extending.
 */
export interface TodoCommentsDetectorInput {
    workspaceRoot: string;
    /**
     * Optional pre-parsed file list. When omitted, the detector walks the
     * workspace itself — useful for picking up Python / Go / shell files
     * the TS parser does not visit.
     */
    files?: ReadonlyArray<string>;
    /**
     * Recognised markers (case-insensitive). Default covers the common
     * ones used across JS / TS / Go / Rust / Python style guides.
     */
    markers?: ReadonlyArray<string>;
    /**
     * Max findings to emit. Default 60 — these are LOW signal and would
     * otherwise drown the dashboard on legacy repos.
     */
    maxFindings?: number;
}
export declare function detectTodoComments(input: TodoCommentsDetectorInput): Finding[];
//# sourceMappingURL=todo-comments.d.ts.map