import type { ReferenceMatch } from "./types.js";
export interface ScanOptions {
    /** Old fully-qualified skill name (e.g. "sw/ado-mapper" or "ado-mapper"). */
    oldSkillName: string;
    /** Logical filename (relative to skill root) — recorded in each match. */
    file?: string;
}
/**
 * Scan SKILL.md content for cross-skill references and self-name occurrences.
 * Returns matches in document order with line numbers (1-indexed).
 */
export declare function scanReferences(content: string, opts: ScanOptions): ReferenceMatch[];
/**
 * Scan for literal occurrences of the OLD skill name in prose.
 * Suppressed inside fenced code blocks. Returned as a separate array because
 * it's informational at a different level (manual rename candidates, not
 * cross-skill dependencies).
 */
export declare function scanSelfNameOccurrences(content: string, opts: ScanOptions): ReferenceMatch[];