/**
 * Frontmatter schema for canonical site markdown pages under
 * `docs/site/pages/<locale>/*.md`.
 *
 * Site pages use the same YAML frontmatter parser as `/docs` but carry
 * route-oriented fields (path, locale, shell, component) instead of
 * category/subcategory fields.
 *
 * Determinism: resolution is a pure function of (relPath, source, meta.json).
 */
export type SitePageShell = "detail" | "bare";
export type SitePageLocale = "en" | "es";
export interface SitePageFrontmatter {
    /** Public route path, e.g. `/faq`, `/install`. */
    path: string;
    /** Locale code. */
    locale: SitePageLocale;
    /** Display title for the page. */
    page_title: string;
    /** Shell mode: "detail" wraps in DetailPage chrome, "bare" is full-bleed. */
    shell: SitePageShell;
    /** If this is a translation, the canonical path it translates. */
    translation_of: string | null;
    /** Translation status. */
    translation_status: string;
    /** Optional component name for hybrid pages (React wrapper that receives markdown). */
    component: string | null;
    /** Optional nav group for sidebar placement. */
    nav_group: string | null;
    /** Optional nav sort order. */
    nav_order: number | null;
    /** SEO description override. */
    description: string | null;
    /** Page visibility. */
    visibility: "public" | "internal";
}
export interface RawSitePageFrontmatter {
    path?: unknown;
    locale?: unknown;
    page_title?: unknown;
    shell?: unknown;
    translation_of?: unknown;
    translation_status?: unknown;
    component?: unknown;
    nav_group?: unknown;
    nav_order?: unknown;
    description?: unknown;
    visibility?: unknown;
}
/**
 * Resolve site page frontmatter from a markdown source and optional meta.json.
 *
 * @param relPath  Path relative to site pages root, e.g. `en/faq.md`.
 * @param source   Raw markdown source (frontmatter + body).
 * @param metaJson Optional parsed meta.json object (from sibling file).
 */
export declare function resolveSitePageFrontmatter(relPath: string, source: string, metaJson?: Record<string, unknown>): SitePageFrontmatter;
//# sourceMappingURL=site_page_frontmatter.d.ts.map