/**
 * Pure, fs-free docs SEO builders: Next.js-compatible page metadata and schema.org JSON-LD for
 * the docs index and individual documentation pages. No `next` or `react` import - the returned
 * metadata is a structural {@link PageMetadata} assignable to Next's `Metadata`, and JSON-LD is a
 * plain object for the consumer to serialise into a `<script type="application/ld+json">`.
 *
 * A documentation page is modelled as a `TechArticle` (rather than a blog's `BlogPosting`). The
 * generic SEO primitives (`absoluteUrl`, `ogLocaleFor`, `hreflangMap`) and the i18n sitemap builder
 * live in `../shared/seo.js` and are shared with the blog; URLs are built exclusively via
 * {@link localePath} so the canonical/hreflang metadata can never drift from the rendered links.
 */
import { type JsonLd } from "../shared/seo.js";
import type { DocMeta, NavItem, PageMetadata, SiteConfig } from "./types.js";
export type { JsonLd };
/**
 * Builds Next.js page metadata for a single documentation page from its front-matter.
 *
 * Sets `metadataBase` from `site.siteUrl`, a root-relative canonical, hreflang
 * `alternates.languages` for the page's translations, and OpenGraph `article` (with `og:locale`)
 * + Twitter `summary_large_image` tags.
 *
 * A `hidden` page additionally carries `robots: { index: false }` (noindex), so a draft or
 * deep-linked page is kept out of search-engine indexes even though it stays routable (and is
 * likewise dropped from the sitemap - see {@link import("./docs.js").Docs.sitemapEntries}).
 *
 * @param meta - the page's normalised front-matter.
 * @param site - the site configuration.
 * @param translations - the language codes this slug is available in. Defaults to just the page's
 *   own language (no hreflang alternates emitted).
 * @returns the page metadata, assignable to Next's `Metadata`.
 */
export declare function buildDocMetadata(meta: DocMeta, site: SiteConfig, translations?: string[]): PageMetadata;
/**
 * Builds Next.js page metadata for the docs 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 buildIndexMetadata(site: SiteConfig, lang?: string, langs?: string[]): PageMetadata;
/**
 * Builds schema.org JSON-LD for a single documentation page: a `TechArticle` (with `inLanguage`)
 * plus a `BreadcrumbList` (`Home > Docs > [group] > page`). All URLs are fully absolute (built
 * from `site.siteUrl`), because `metadataBase` does not apply to JSON-LD.
 *
 * When the slug is translated, the `TechArticle` also links its siblings: the original-language
 * version carries a `workTranslation` array of the other versions, and every translation carries a
 * `translationOfWork` reference back to the original (each a self-describing `{ @type, @id, url,
 * inLanguage }` node), mirroring the blog's cross-links.
 *
 * @param meta - the page'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 page's own language (no translation cross-links emitted).
 * @returns the JSON-LD `@graph` document.
 */
export declare function docJsonLd(meta: DocMeta, site: SiteConfig, translations?: string[]): JsonLd;
/**
 * Builds schema.org JSON-LD for the docs index of one language: a `CollectionPage`, a
 * `BreadcrumbList` (`Home > Docs`), and (when pages exist) an `ItemList` of the pages in sidebar
 * order. All URLs are fully absolute.
 *
 * @param items - the language's pages as flattened nav items, in sidebar order (typically
 *   `flattenNav(Docs.getNavTree(lang))`).
 * @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 indexJsonLd(items: NavItem[], site: SiteConfig, lang?: string): JsonLd;