export declare class TargetDirectoryPreflightError extends Error {
    /**
     * Structured errno `code` of the preflight failure cause(s), with `undefined`
     * where a cause carried no code. Retained purely so a reporting policy (see
     * sentry-before-send) can tell a pure local-environment failure from a mixed
     * or product one; it NEVER changes the rendered message. Defaults to the
     * single `cause` when `attemptCauses` is omitted.
     */
    readonly causeCodes: readonly (string | undefined)[];
    constructor(targetDir: string, cause: unknown, attemptCauses?: readonly unknown[]);
}
/** Injectable filesystem seam for directory writability tests. */
export interface TargetDirectoryPreflightDeps {
    pathExists?: (candidate: string) => Promise<boolean>;
    stat?: (candidate: string) => Promise<unknown>;
    mkdtemp?: (prefix: string) => Promise<string>;
    remove?: (target: string) => Promise<void>;
}
/**
 * Normalizes a Windows directory value that reached create-hq with literal
 * shell quoting still attached. Shells on POSIX preserve quote characters only
 * when they are part of the filename, so non-Windows values remain untouched.
 * On Windows, only one non-empty matching outer quote pair is removed; quotes
 * inside a path are never touched.
 */
export declare function normalizeDirArgument(raw: string, platform?: NodeJS.Platform): string;
/**
 * Fails early with a directory-specific explanation when Windows will reject
 * a resolved path. fs-extra otherwise reports this later as a fetch failure.
 */
export declare function validateTargetDirectory(targetDir: string, platform?: NodeJS.Platform): void;
/**
 * Verifies that the closest existing parent of targetDir accepts a new
 * directory, without creating targetDir itself. Known filesystem access
 * failures get a user-actionable directory error before any download begins;
 * unfamiliar probe failures stay non-blocking to avoid false positives on
 * virtualized and network-backed folders.
 */
export declare function preflightTargetDirectory(targetDir: string, deps?: TargetDirectoryPreflightDeps): Promise<void>;
//# sourceMappingURL=dir-arg.d.ts.map