/**
 * Pure, fs-free blog SEO builders: Next.js-compatible page metadata and schema.org JSON-LD for
 * the blog index and individual posts. No `next` or `react` import - the returned metadata is a
 * structural {@link PageMetadata} that stays assignable to Next's `Metadata`, and JSON-LD is
 * returned as a plain object for the consumer to serialise into a
 * `<script type="application/ld+json">`.
 *
 * The generic SEO primitives (`absoluteUrl`, `ogLocaleFor`, `hreflangMap`, the i18n `buildSitemap`)
 * live in `../shared/seo.js` and are shared with the docs module; URLs are built exclusively via
 * its `sitePath`/`pageUrl`/`metadataUrl` over `localePath`, the same helper the React components
 * use, so the canonical/hreflang metadata can never drift from the rendered links. On a
 * domain-per-locale site (`site.localeOrigins`) every URL sits on its own locale's origin. For a single-language blog the output is
 * unchanged: `defaultLocale` falls back to the post's own `lang`, so every URL is the unprefixed
 * `<basePath>/<slug>`.
 */
import { type JsonLd } from "../shared/seo.js";
import type { PageMetadata, PostMeta, SiteConfig } from "./types.js";
export type { JsonLd };
/**
 * The blog index description for one language, falling back to a generic brand string. Exported so
 * the RSS builder's channel description is the same string as the index metadata's.
 *
 * @param site - the site configuration.
 * @param lang - the language being built. Defaults to `site.defaultLocale`.
 * @returns the description used for the index metadata, CollectionPage, and RSS channel.
 */
export declare function overviewDescription(site: SiteConfig, lang?: string): string;
/**
 * The blog index's configured name for one language, or `undefined` when the site declares none -
 * each caller keeps the fallback it had before `indexName` existed (the RSS channel falls back to
 * the bare `brandName`, the CollectionPage and OpenGraph titles to `<brandName> Blog`).
 *
 * @param site - the site configuration.
 * @param lang - the language being built. Defaults to `site.defaultLocale`.
 * @returns the configured index name for that language, or `undefined`.
 */
export declare function overviewName(site: SiteConfig, lang?: string): string | undefined;
/**
 * Builds Next.js page metadata for a single post from its front-matter.
 *
 * Sets `metadataBase` to the post locale's host (`assetBase`: never a mounted locale's `/en`) so
 * relative canonical/OG image paths resolve where they are served, a root-relative canonical (absolute on a
 * domain-per-locale site), hreflang `alternates.languages` for the post's translations, and
 * OpenGraph `article` (with `og:locale`) + Twitter `summary_large_image` tags.
 *
 * @param meta - the post's normalised front-matter.
 * @param site - the site configuration.
 * @param translations - the language codes this slug is available in. Defaults to just the
 *   post's own language (no hreflang alternates emitted).
 * @param slugs - each translation's own URL slug, by language, when a post's slug differs per
 *   language (front-matter `slug:`). Optional; a language missing from it uses `meta.slug`.
 * @returns the page metadata, assignable to Next's `Metadata`.
 */
export declare function buildPostMetadata(meta: PostMeta, site: SiteConfig, translations?: string[], slugs?: Readonly<Record<string, string>>): PageMetadata;
/**
 * Builds Next.js page metadata for the blog index page of one language.
 *
 * @param site - the site configuration.
 * @param lang - the language whose index this is. Defaults to `site.defaultLocale`.
 * @param langs - every configured locale code, used to build the hreflang alternates. Defaults
 *   to none (no hreflang emitted, single-language behaviour).
 * @returns the page metadata, assignable to Next's `Metadata`.
 */
export declare function buildOverviewMetadata(site: SiteConfig, lang?: string, langs?: string[]): PageMetadata;
/**
 * Builds schema.org JSON-LD for a single post: a `BlogPosting` (with `inLanguage`) plus a
 * `BreadcrumbList`. All URLs are fully absolute (built from `site.siteUrl`, or each locale's
 * `localeOrigins` entry), because `metadataBase` does not apply to JSON-LD.
 *
 * When the slug is translated, the `BlogPosting` also links its siblings: the original-language
 * version (the default locale, or the first translation when the default is absent) carries a
 * `workTranslation` array of the other versions, and every translation carries a
 * `translationOfWork` reference back to that original. Each reference is a `{ @type, @id, url,
 * inLanguage }` node so a single language's URL and language are self-describing.
 *
 * @param meta - the post's normalised front-matter.
 * @param site - the site configuration.
 * @param translations - the language codes this slug is available in, default-locale first.
 *   Defaults to just the post's own language (no translation cross-links emitted).
 * @param slugs - each translation's own URL slug, by language, when a post's slug differs per
 *   language (front-matter `slug:`). Optional; a language missing from it uses `meta.slug`.
 * @returns the JSON-LD `@graph` document.
 */
export declare function postJsonLd(meta: PostMeta, site: SiteConfig, translations?: string[], slugs?: Readonly<Record<string, string>>): JsonLd;
/**
 * Builds schema.org JSON-LD for the blog index of one language: a `CollectionPage`, a
 * `BreadcrumbList`, and (when posts exist) an `ItemList` of the posts. All URLs are fully
 * absolute.
 *
 * @param posts - the language's posts' front-matter, in display order.
 * @param site - the site configuration.
 * @param lang - the language whose index this is. Defaults to `site.defaultLocale`.
 * @returns the JSON-LD `@graph` document.
 */
export declare function overviewJsonLd(posts: PostMeta[], site: SiteConfig, lang?: string): JsonLd;