/**
 * Result of splitting a markdown file into YAML frontmatter and body.
 */
export interface FrontmatterSplit {
    /** Raw YAML frontmatter contents (without the --- delimiters). */
    frontmatter: string;
    /** Body content (trimmed). */
    body: string;
    /** True if the file had a recognised --- ... --- block. */
    hasFrontmatter: boolean;
}
/**
 * Split a markdown file into its frontmatter block and body.
 *
 * Recognises the standard `---\n...\n---\n` pattern at the start of the file.
 * When no frontmatter is found, the whole file is returned as `body` and
 * `hasFrontmatter` is false.
 */
export declare function splitFrontmatter(fileContent: string): FrontmatterSplit;
/**
 * Parse a YAML frontmatter string into a plain object using the `yaml`
 * library. Supports nested objects, arrays, multi-line strings, etc.
 *
 * Returns `null` on parse failure or when the YAML doesn't resolve to an
 * object (e.g. a scalar). Callers should treat `null` as "invalid metadata".
 */
export declare function parseYamlObject(frontmatter: string): Record<string, unknown> | null;
//# sourceMappingURL=frontmatter.d.ts.map