import type { FrontmatterResult } from '../types/frontmatter.js';
/**
 * Parse YAML frontmatter from markdown content.
 * Supports simple key: value pairs, arrays `[a, b]`, null, integers, and quoted strings.
 * Returns the original content as body if no frontmatter is found.
 */
export declare function parseFrontmatter(content: string): FrontmatterResult;
/**
 * Strip YAML frontmatter from markdown content, returning only the body.
 * If no frontmatter is present, returns the original content unchanged.
 */
export declare function stripFrontmatter(content: string): string;
/**
 * Update a single field in YAML frontmatter of markdown content.
 * If the field exists, replaces its value. If not, appends before the closing ---.
 * Returns the updated content, or the original content if no frontmatter is found.
 *
 * SPEC-698: only top-level keys are matched. Indented (nested) keys with the same
 * name are NOT touched — e.g. `estimation:\n  model: sonnet` is preserved when
 * updating top-level `model`.
 *
 * SPEC-698 (security): `key` and `value` are rendered verbatim into the file. Newlines
 * or carriage returns in either would let a caller inject extra YAML keys or break
 * the frontmatter delimiters. Both are rejected.
 */
export declare function updateFrontmatterField(content: string, key: string, value: string): string;
//# sourceMappingURL=frontmatter-parser.d.ts.map