/**
 * Minimal YAML front-matter parser. Splits a `---`-delimited header from the
 * markdown body and validates the YAML payload against
 * {@link DocFrontmatterSchema}.
 *
 * Implemented in-house (rather than via `gray-matter`) to avoid an extra
 * runtime dependency: `js-yaml` is already in the install bundle.
 */
import { type DocFrontmatter } from "./types.js";
export interface ParsedFrontmatter {
    frontmatter: DocFrontmatter;
    body: string;
}
export declare class FrontmatterError extends Error {
    readonly sourcePath: string;
    readonly cause?: unknown | undefined;
    constructor(message: string, sourcePath: string, cause?: unknown | undefined);
}
/**
 * Parse and validate front-matter from a raw markdown source.
 *
 * @param raw The full file contents.
 * @param sourcePath Used purely for error messages.
 */
export declare function parseFrontmatter(raw: string, sourcePath: string): ParsedFrontmatter;
//# sourceMappingURL=frontmatter.d.ts.map