import type { MetadataStyle, MetadataStyleId } from './metadata-style.types.js';
/**
 * The style used for files this provider creates.
 *
 * `list` because it is the only one of the three that is clean in the raw file
 * and still renders as separate lines.
 *
 * @public
 */
export declare const DEFAULT_METADATA_STYLE_ID: MetadataStyleId;
/**
 * Every style, by id.
 *
 * @public
 */
export declare const METADATA_STYLES: Readonly<Record<MetadataStyleId, MetadataStyle>>;
/**
 * All valid ids, for validating a flag or a config value.
 *
 * @public
 */
export declare const METADATA_STYLE_IDS: readonly MetadataStyleId[];
/**
 * @public
 */
export declare function isMetadataStyleId(value: unknown): value is MetadataStyleId;
/**
 * @public
 */
export declare function getMetadataStyle(id: MetadataStyleId): MetadataStyle;
/**
 * The style a file is already written in, or `undefined` when it has no
 * metadata block to judge by.
 *
 * @public
 */
export declare function detectMetadataStyle(content: string): MetadataStyle | undefined;
/**
 * The style to write a given file in: the one it already uses, falling back to
 * `fallback` for a file that has no block yet.
 *
 * This is the rule that keeps files from going mixed. An edit follows the
 * file; only creation follows the configuration.
 *
 * @public
 */
export declare function resolveMetadataStyle(content: string, fallback?: MetadataStyleId): MetadataStyle;
/**
 * Reads a field by any of the given labels, whatever style the file uses.
 *
 * Takes several labels because the same field is `Assignee` in an English file
 * and `Responsável` in a Portuguese one, and both have to read.
 *
 * @public
 */
export declare function readMetadataField(content: string, ...labels: readonly string[]): string | undefined;
/**
 * Upserts a field, preserving the style the file is already written in.
 *
 * @public
 */
export declare function writeMetadataField(content: string, label: string, value: string | undefined, fallback?: MetadataStyleId): string;
/**
 * Rewrites the metadata block in `target`, leaving the rest of the file alone.
 *
 * @public
 */
export declare function convertMetadataStyle(content: string, target: MetadataStyleId): string;
//# sourceMappingURL=metadata-style.d.ts.map