export declare const FRONTMATTER_CONTRACT_VERSION = 1;
export type FrontmatterFieldSource = "auto" | "author" | "default" | "structural";
export interface FrontmatterContractField {
    readonly name: string;
    readonly order: number;
    readonly source: FrontmatterFieldSource;
    readonly mandatory: boolean;
    readonly mandatoryToken: boolean;
    readonly defaultValue: string | null;
    readonly description: string;
}
export declare const FRONTMATTER_CONTRACT: readonly FrontmatterContractField[];
export declare const FRONTMATTER_FIELDS: readonly string[];
export type FrontmatterField = (typeof FRONTMATTER_CONTRACT)[number]["name"];
export declare const MANDATORY_FRONTMATTER_TOKENS: readonly string[];
export type MandatoryFrontmatterToken = "purpose" | "topic" | "mesh-visibility" | "weight";
export declare const DEFAULT_MESH_VISIBILITY: string;
export declare const DEFAULT_WEIGHT: string;
export interface FrontmatterInput {
    title: string;
    created: string;
    modified: string;
    tags?: readonly string[];
    purpose: string;
    topic: string;
    "mesh-visibility"?: string;
    weight?: number | string;
    meta?: Record<string, string>;
    lytScaffold?: boolean;
}
export declare function buildFrontmatter(fields: FrontmatterInput): string;
export interface FrontmatterValidationError {
    field: FrontmatterField | "lyt-scaffold";
    message: string;
}
export declare function validateFrontmatterBlock(raw: string): FrontmatterValidationError[];
export declare const FRONTMATTER_BASELINE_VERSION = 1;
export declare function readFrontmatterVersion(raw: string): number;
export interface FrontmatterDates {
    created: string | null;
    modified: string | null;
}
export declare function readFrontmatterDates(raw: string): FrontmatterDates;
export declare function stampModifiedFrontmatter(raw: string, iso: string): string;
export declare function gitCommitterDateToIso(epochSeconds: number | string): string | null;
//# sourceMappingURL=contract.d.ts.map