import { type GrayMatterFile } from 'gray-matter';
export type ParsedMarkdown<T extends Record<string, unknown>> = GrayMatterFile<string> & {
    readonly data: Readonly<T>;
};
export type EnsureBaselineOptions<T extends Record<string, unknown>> = {
    readonly filePath?: string;
    readonly content?: string;
    readonly uuidFactory?: () => string;
    readonly createdAtFactory?: (args: {
        readonly frontmatter: Readonly<T>;
        readonly filePath?: string;
    }) => string | undefined;
    readonly fallbackCreatedAt?: string;
    readonly now?: () => string;
    readonly titleFactory?: (args: {
        readonly frontmatter: Readonly<T>;
        readonly filePath?: string;
        readonly content?: string;
    }) => string | undefined;
    readonly fallbackTitle?: string;
};
export type BaselineFrontmatter = {
    readonly uuid: string;
    readonly created_at: string;
    readonly title: string;
};
export type MergeGenerated = {
    readonly filename?: string;
    readonly description?: string;
    readonly tags?: readonly string[];
    readonly title?: string;
};
export type MergeOptions = {
    readonly filePath?: string;
    readonly descriptionFallback?: string;
    readonly deriveFilename?: (args: {
        readonly filePath?: string;
    }) => string;
};
export declare const parseFrontmatter: <T extends Record<string, unknown> = Record<string, unknown>>(raw: string) => ParsedMarkdown<T>;
export declare const stringifyFrontmatter: <T extends Record<string, unknown>>(content: string, frontmatter: Readonly<T>) => string;
export declare const normalizeStringList: (values: readonly unknown[] | undefined) => string[];
export declare const deriveFilenameFromPath: (filePath: string) => string;
export declare const ensureBaselineFrontmatter: <T extends Record<string, unknown>>(frontmatter: Readonly<T>, options?: EnsureBaselineOptions<T>) => Readonly<T & BaselineFrontmatter>;
export declare const mergeFrontmatterWithGenerated: <T extends Record<string, unknown>, G extends MergeGenerated>(base: Readonly<T>, generated: Readonly<G>, options?: MergeOptions) => Readonly<T & {
    filename: string;
    title: string;
    description: string;
    tags: string[];
}>;
//# sourceMappingURL=frontmatter.d.ts.map