import type { Terminal } from "./terminal.js";
/**
 * Where the CLI leaves what it makes, unless someone says otherwise.
 *
 * A dot-directory, and ignored by git from the first write, because none of it
 * is source. The SVGs, the document they were drawn from and the manifest are
 * a preview of the comment, rebuilt from the diff whenever anyone wants it
 * again. A working tree that fills with them leaves the user deciding what to
 * commit, and the answer is always none of it.
 */
export declare const WORKSPACE_DIR = ".pr-lens";
/**
 * Adds the workspace to the repository's .gitignore, and says so. Answers with
 * the file it wrote, or nothing when there was nothing to do. Call it once the
 * workspace directory exists, so git can see that it is one.
 *
 * Nothing is written when git already ignores the previews, or when the
 * repository un-ignores this workspace on purpose: a user who chose to track
 * these files has chosen.
 *
 * The entry is normally unanchored, so it holds wherever in the tree the CLI is
 * run. It is narrowed to this one workspace when the repository un-ignores a
 * different one, since an unanchored line lands last and would overrule that
 * choice on its way past.
 */
export declare const ignoreWorkspace: (workspace: string) => Promise<string | undefined>;
/**
 * Prepares the workspace on the way to writing in it: the README that says
 * what the directory is, and the .gitignore entry that keeps anyone from
 * having to ask.
 *
 * Both are skipped when --out named somewhere else. That directory is the
 * user's, and so is the question of what to do with it.
 */
export declare const prepareWorkspace: (out: string, terminal: Terminal) => Promise<void>;
/** What `render` writes beside the manifest, in every drawing's directory. */
export declare const DRAWN_NAME = "drawn.graph.json";
/** The top-level `drawn.graph.json` from 0.7.0 counts only until a newer render exists. */
export declare function drawings(): Promise<string[]>;
//# sourceMappingURL=workspace.d.ts.map