import type { ArchivesOnDisk } from '../core/version.js';
/**
 * Written into every archive `archive-version` creates. Not a convenience for
 * the command: this file is what makes a directory an archived version rather
 * than an ordinary section of the current docs, and the build reads it. The two
 * are otherwise indistinguishable, since a page is assigned to a version by its
 * first directory segment. See
 * `docs/adr/0003-the-archive-marker-defines-an-archive.md`.
 *
 * @experimental Outside the 1.0 stability promise. Name and role may change in
 * a minor until authors have used versioning for real.
 */
export declare const ARCHIVE_MARKER = ".docsmith-archive";
/** The text written into a new archive's marker file. */
export declare function markerContents(id: string): string;
/**
 * The directories directly under `contentDir`, and which of them are archives.
 * An absent docs root reads as empty rather than throwing: the collectors
 * already report that case, and the command has its own message for it.
 */
export declare function discoverArchives(contentDir: string): ArchivesOnDisk;