import type { CartridgeMapping } from '../code/cartridges.js';
export interface SourceMapper {
    /** Convert a local filesystem path to an SDAPI script_path. */
    toServerPath(localPath: string): string | undefined;
    /** Convert an SDAPI script_path to a local filesystem path. */
    toLocalPath(scriptPath: string): string | undefined;
}
/**
 * Creates a SourceMapper from discovered cartridge mappings.
 *
 * @param cartridges - Array of cartridge mappings from `findCartridges()`
 */
export declare function createSourceMapper(cartridges: CartridgeMapping[]): SourceMapper;