import type { AgencyConfig } from "../config/config.js";
/** The package.json Node consults for `file`: the nearest one in `file`'s
 *  directory or any directory above it. Null when there is none. */
export declare function nearestPackageJson(file: string): string | null;
/** Agency compiles to ES modules. Node refuses to run an ES module `.js` file
 *  when its nearest package.json says `"type": "commonjs"`, with an error that
 *  does not mention Agency. Returns a note explaining the fix in that case,
 *  and null otherwise.
 *
 *  A package.json with no `"type"` field is fine: Node 22.7+ detects the
 *  module syntax and prints its own warning naming the fix. */
export declare function moduleTypeWarning(outputFile: string): string | null;
/** `moduleTypeWarning` for `agency compile <inputs>`: checks where each
 *  `.agency` file's output lands, expanding directories the way `compile`
 *  does. Returns the first warning, so a project gets one note. */
export declare function compileOutputsWarning(config: AgencyConfig, inputs: string[]): string | null;