import type { ReferenceHit } from "./types.js";
export type PathSegments = string[];
/**
 * Scan one block of JS for references to the gap path.
 * gapSegs is the path without the action prefix (e.g. ["message","intent","category","id"]).
 * Detects:
 *   - property-access chains (foo.bar.baz, foo?.bar, foo["bar"], etc.)
 *   - quoted dotted strings ("a.b.c", '$.a.b.c') in code (e.g. _.get / getValue / JSONPath)
 *   - comments (// or /* ... *​/) that mention the path
 * Snake/camel variants of the gap path are matched.
 */
export declare function scanSource(src: string, gapSegs: string[], meta: {
    flowId: string;
    actionId: string;
    kind: "generate" | "validate" | "requirements";
}, maxHits?: number): ReferenceHit[];
/**
 * Scan only the comments of a JS blob for path mentions. Returns full
 * ReferenceHits with kind="comment". Used as a complement to AST-based
 * scanning, which drops comments by default.
 */
export declare function scanCommentsOnly(src: string, gapSegs: string[], meta: {
    flowId: string;
    actionId: string;
}, maxHits?: number): ReferenceHit[];
/**
 * Scan source for occurrences of a single identifier (used for saveData
 * alias lookups: when generate persists `transactionId` to session and another
 * step's code reads it as `transactionId`).
 */
export declare function scanIdentifier(src: string, ident: string, meta: {
    flowId: string;
    actionId: string;
}, maxHits?: number): ReferenceHit[];
/**
 * Scan a saveData record (object of {key: "$.a.b.c"}) for JSONPaths that end at
 * the gap path (or whose tail matches the gap's tail).
 */
export declare function scanSaveData(saveData: Record<string, unknown> | undefined, gapSegs: string[]): Array<{
    key: string;
    jsonpath: string;
}>;
//# sourceMappingURL=reference-scanner.d.ts.map