import type { Command } from "commander";
import type { EmitContext, HarneryProgramContext } from "../commander.js";
export { FILES_ORIGIN_HOST } from "../lib/local-file-url.js";
export type LocalFileUrlMode = "auto" | "raw" | "viewer";
export interface LocalFileUrlOptions {
    coordRoot: string;
    port: number;
    mode?: LocalFileUrlMode;
}
export interface LocalFileUrl {
    url: string;
    relPath: string;
    mode: Exclude<LocalFileUrlMode, "auto">;
}
export type DashboardRootErrorCode = "dashboard_unreachable" | "dashboard_identity_unavailable" | "dashboard_root_mismatch";
export declare class DashboardRootError extends Error {
    readonly code: DashboardRootErrorCode;
    readonly hint: string;
    constructor(code: DashboardRootErrorCode, message: string, hint: string);
}
export type DashboardRootFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
/**
 * Prove that the dashboard on the selected port serves the same canonical
 * coordination root used to mint the file URL.
 */
export declare function verifyDashboardRoot(coordRoot: string, port: number, fetchImpl?: DashboardRootFetch): Promise<void>;
/**
 * Mint the local browser URL for a file under the dashboard's coord root.
 * HTML defaults to the isolated files origin so scripts and relative assets
 * work. Other files default to the dashboard viewer.
 */
export declare function mintLocalFileUrl(input: string, options: LocalFileUrlOptions): LocalFileUrl;
export declare function registerFilesCommand(program: Command, emit: EmitContext, context?: HarneryProgramContext): void;
//# sourceMappingURL=files.d.ts.map