@contentrain/emitter-astro 0.14.5 → 0.15.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ComponentDef, EntrySourceRef, ModelDefinition, ProjectIR, RouteModel, RuntimeBinding, RuntimeBinding as RuntimeBinding$1 } from "@contentrain/types";
+import { ComponentDef, EntrySourceRef, ModelDefinition, ProjectIR, RawRedirect, RawRedirect as RawRedirect$1, RawSeoEntry, RouteModel, RuntimeBinding, RuntimeBinding as RuntimeBinding$1, SeoProvider } from "@contentrain/types";
 
 //#region src/types.d.ts
 /**
@@ -33,6 +33,12 @@ interface EmitPost {
   /** The site's date-format catalog applied to this post's date (index-aligned with `date{n}` marks). */
   dates?: string[];
   author?: string;
+  /**
+   * The author's page — their archive on the site, absolute or site-root-
+   * relative. The Article's author gets it as `url`, the address the
+   * archive's ProfilePage names its Person at, so the two are one person.
+   */
+  author_url?: string;
   author_first?: string;
   author_last?: string;
   /**
@@ -61,6 +67,27 @@ interface EmitPost {
   image_meta?: ImageMeta;
   /** Canonical override — for a page that should point somewhere else. Default: this page's own address. */
   canonical?: string;
+  /**
+   * The document title (`<title>`, and the default og/twitter title) when the
+   * source's SEO plugin composed one apart from the entry's — Yoast's
+   * "Post – Site". `title` stays the entry's own name: its marks, the Article
+   * headline, the last breadcrumb. Default: `title`.
+   */
+  seo_title?: string;
+  /** Open Graph text and image the source set for this page, over the derived ones. */
+  open_graph?: SocialOverride;
+  /** Twitter card values the source set for this page. Unset values follow Open Graph. */
+  twitter?: TwitterOverride;
+  /**
+   * The page's JSON-LD as the source's SEO plugin rendered it — a `@graph`
+   * object, an array of nodes, or one node. Printed instead of the graph the
+   * emitter would build, so FAQ, HowTo, Product and whatever else the plugin
+   * described survive. The migrated site keeps the source addresses, so the
+   * graph's `@id`s and URLs stay true; media URLs in it are printed as given
+   * and are the producer's to rewrite. A WebSite `SearchAction` is dropped (a
+   * static site has no `?s=` search), as is a copy of the head's WebSite node.
+   */
+  schema?: unknown;
   /** ISO 8601, for Article structured data. `dates` holds display strings, which schema.org cannot read. */
   published_at?: string;
   modified_at?: string;
@@ -85,6 +112,14 @@ interface EmitPost {
    * as a placeholder.
    */
   entry?: EntrySourceRef;
+  /**
+   * The source page was `noindex` (e.g. Yoast `robots.index`). The page gets
+   * `<meta name="robots" content="noindex">` and is left out of the sitemap —
+   * a migration must not make indexable what the site kept out of search.
+   */
+  noindex?: boolean;
+  /** The source page was `nofollow`: `<meta name="robots" content="nofollow">`. */
+  nofollow?: boolean;
 }
 /**
  * One block of a list: a template, optional wrapper, and how many items it takes.
@@ -138,6 +173,44 @@ interface QueryPage {
   canonical?: string;
   /** The trail to this list page, itself excluded — see `EmitPost.breadcrumbs`. */
   breadcrumbs?: Breadcrumb[];
+  /** See `EmitPost.noindex`. */
+  noindex?: boolean;
+  /** See `EmitPost.nofollow`. */
+  nofollow?: boolean;
+  /** See `EmitPost.open_graph`. */
+  open_graph?: SocialOverride;
+  /** See `EmitPost.twitter`. */
+  twitter?: TwitterOverride;
+  /** See `EmitPost.schema`. */
+  schema?: unknown;
+  /**
+   * On an author's archive: who it is about. The page becomes a ProfilePage
+   * whose main entity is this Person, at the page's own address.
+   */
+  profile?: AuthorProfile;
+}
+/** An author as their archive page presents them. */
+interface AuthorProfile {
+  name: string;
+  /** The author's bio. */
+  description?: string;
+  /** Avatar or photo, absolute or site-root-relative. */
+  image?: string;
+  /** Profiles elsewhere (social accounts, a personal site) — schema.org `sameAs`; http(s) only. */
+  same_as?: string[];
+}
+/**
+ * Share-card values a page's source set by hand. Each one left out falls back
+ * to the value derived from the page. `image` is absolute or site-root-relative.
+ */
+interface SocialOverride {
+  title?: string;
+  description?: string;
+  image?: string;
+}
+interface TwitterOverride extends SocialOverride {
+  /** `summary` or `summary_large_image`; anything else is ignored. */
+  card?: string;
 }
 /** One step of a breadcrumb trail. */
 interface Breadcrumb {
@@ -175,6 +248,24 @@ interface EmitCssFile {
   path: string;
   content: string;
 }
+/** A host the emitted site may optimize images from (Astro \`image.remotePatterns\`). */
+interface RemoteImagePattern {
+  protocol?: 'https' | 'http';
+  /** Exact host, or \`*.example.com\` for any subdomain. */
+  hostname: string;
+  /** Path prefix, e.g. \`/media/\`. Optional. */
+  pathname?: string;
+}
+interface ImageOptions {
+  /** Default true. \`false\` emits no image pass at all. */
+  enabled?: boolean;
+  /** Hosts whose images are optimized. The runtime host (Studio's CDN) is always added. */
+  remotePatterns?: RemoteImagePattern[];
+  /** srcset widths in px. Default 480, 768, 1024, 1600; widths above the width the HTML declares are dropped. */
+  widths?: number[];
+  /** \`sizes\` for an image that has none. Default \`(max-width: 768px) 100vw, 768px\`. */
+  sizes?: string;
+}
 interface EmitOptions {
   /** Generated project's package name. Default: "migrated-site". */
   projectName?: string;
@@ -202,6 +293,37 @@ interface EmitOptions {
    * sitemap silently for exactly that producer.
    */
   sitemap?: boolean;
+  /**
+   * Build-time image optimization for content bodies (\`astro:assets\`):
+   * srcset, WebP, width/height and lazy loading for images on allowed hosts —
+   * migrated media on the runtime host is always allowed — and lazy loading
+   * with async decoding for every other image. Default on.
+   */
+  images?: ImageOptions;
+  /**
+   * Build the site's RSS feed at `/feed.xml` — the newest posts, as WordPress
+   * serves them at `/feed/` — and point the theme's head link at it. Default
+   * true. Needs `site.url` (feed links are absolute) and a route that builds
+   * the `posts` collection.
+   */
+  feed?: boolean;
+  /**
+   * Build `/llms.txt` (llmstxt.org): the site's name, tagline and newest pages
+   * of each collection, for language models. Default true. Needs `site.url`.
+   */
+  llms?: boolean;
+  /** The site's tagline (WordPress `blogdescription`): the feed's description and the llms.txt summary. */
+  siteDescription?: string;
+  /**
+   * Whether the source site's addresses end in a slash (WordPress
+   * `RawRouting.trailing_slash`): `/hello/` or `/hello`. Default true. With
+   * false the build writes files (`/hello.html`, which Netlify and Cloudflare
+   * Pages serve at `/hello`, and Vercel with the `cleanUrls` this adds to
+   * `vercel.json`), and canonical, og:url, hreflang, the feed and llms.txt
+   * name every page without the slash — the migrated site keeps the form the
+   * source was indexed under.
+   */
+  trailingSlash?: boolean;
   /**
    * The site's interface-text dictionary (see \`UI_STRINGS_MODEL\`). Comments
    * and forms read it at build time from \`dir\` (default
@@ -215,6 +337,14 @@ interface EmitOptions {
     dir?: string;
     locales?: string[];
   };
+  /**
+   * The host the site deploys to, for `EmitInput.redirects`: its own redirect
+   * file is written so the rules answer with a real HTTP status (a static
+   * Astro build serves them as meta-refresh pages, kept as the fallback).
+   * Unset: Netlify `public/_redirects` and `vercel.json` are both written; a
+   * Cloudflare Pages site must name its host (no forced rules there).
+   */
+  redirectHost?: 'netlify' | 'cloudflare' | 'vercel';
 }
 interface EmitInput {
   ir: ProjectIR;
@@ -227,6 +357,13 @@ interface EmitInput {
    * complete without any runtime offer being accepted.
    */
   runtime?: RuntimeBinding;
+  /**
+   * The live site's redirect rules (`RawIR.redirects`). Plain one-to-one rules
+   * are written to `astro.config` `redirects`; patterns, regular expressions,
+   * other statuses and rules on an address the site builds a page at come
+   * back in `EmitResult.redirects.manual` with the reason, to set up at the host.
+   */
+  redirects?: RawRedirect[];
 }
 /**
  * Pure result: every generated file as path → content. Writing to disk is a
@@ -236,6 +373,16 @@ interface EmitInput {
 interface EmitResult {
   files: Record<string, string>;
   warnings: string[];
+  /** Present when `EmitInput.redirects` was given: what was written and what was not, with why. */
+  redirects?: {
+    written: RawRedirect[];
+    manual: Array<{
+      redirect: RawRedirect;
+      reason: string;
+    }>; /** The host redirect files written, e.g. `public/_redirects (netlify)`. Empty: meta-refresh only. */
+    host_files: string[]; /** Rules (by `from`) left out of a Cloudflare / Vercel file at its rule limit: meta-refresh only there. */
+    host_over_limit: string[];
+  };
 }
 //#endregion
 //#region src/css.d.ts
@@ -245,6 +392,39 @@ interface WrapCssResult {
 }
 declare function wrapLegacyCss(path: string, css: string): WrapCssResult;
 //#endregion
+//#region src/feed.d.ts
+/** Where the feed is built. */
+declare const FEED_PATH = "/feed.xml";
+/** Items in the feed — WordPress's default `posts_per_rss`. */
+declare const FEED_ITEMS = 10;
+/** Links per llms.txt section. A long archive is summarised by its newest pages. */
+declare const LLMS_LINKS = 100;
+/** A collection some route builds one page per entry of, and the pattern it builds them at. */
+interface LinkSource {
+  collection: string;
+  pattern: string;
+}
+/**
+ * The collections the site builds entry pages for in its default language,
+ * each with the first route that does: posts first, pages next, the rest by
+ * name. A route in another language is left out — the feed and llms.txt
+ * describe the site as it is in its default one.
+ */
+declare function linkSources(routes: RouteModel[], siteLocale: string): LinkSource[];
+interface FeedLinkResult {
+  html: string;
+  /** Links now pointing at FEED_PATH. */
+  rewritten: number;
+  /**
+   * The site's other feed links, removed: a category's, a tag's or an
+   * author's is the template page's own (each archive page links its feed
+   * itself), and a comments or Atom feed is not built.
+   */
+  other: number;
+}
+/** Point the head's link to the site's main feed at the one the build writes, and remove the template page's others. */
+declare function rewriteFeedLinks(html: string, siteUrl: string): FeedLinkResult;
+//#endregion
 //#region src/util.d.ts
 /** "f-archive" → "FArchive", "posts" → "Posts" — Astro component file names. */
 declare function pascalCase(id: string): string;
@@ -283,12 +463,27 @@ declare function isRuntimeImplemented(c: ComponentDef, runtime: RuntimeBinding$1
  * no id, no link.
  */
 declare function websiteIdOf(html: string): string | undefined;
+/**
+ * `@id` of the node that publishes the site, as the head's structured data
+ * says: the WebSite's own `publisher` reference (Yoast and Rank Math write
+ * one — an Organization, or the Person a personal site is published by),
+ * else the head's first Organization. The Article names it by `@id`, so the
+ * logo and profile the site declared count for every post.
+ */
+declare function publisherIdOf(html: string): string | undefined;
 interface StripResult {
   html: string;
   /** What was taken out, for the emit warning — never a silent removal. */
   removed: string[];
   /** Site-wide structured-data types kept out of a block that was otherwise page-scoped. */
   kept: string[];
+  /**
+   * The robots directives of the template's `robots` / `googlebot` tags that
+   * are site settings rather than this page's indexing — Yoast's
+   * `max-image-preview:large, max-snippet:-1, max-video-preview:-1`. The Seo
+   * component prints them on every page, after the page's own noindex/nofollow.
+   */
+  robots: string[];
 }
 /** Remove the source head's per-page SEO tags so the emitter's own are the only ones. */
 declare function stripSeoTags(html: string): StripResult;
@@ -308,7 +503,44 @@ declare function bodySeoLeaks(html: string): string[];
  * `Astro.site` rather than from data: it is then, by construction, the address
  * Astro actually generated, and no producer has to recompute a permalink.
  */
-declare const SEO_COMPONENT = "---\n/**\n * Per-page SEO \u2014 emitted by @contentrain/emitter-astro.\n *\n * Title, description, canonical, Open Graph, Twitter card and (on entry pages)\n * Article structured data, derived from the entry. The source theme's copies of\n * these tags are removed from the head chrome at emit time, so each appears once.\n *\n * Canonical and absolute URLs need `site` in astro.config.mjs; without it the\n * canonical link and og:url are omitted rather than pointing at a build host.\n */\nimport { absoluteUrl, imageMetaTags, jsonLd, pageStructuredData, seoDescription, type Breadcrumb, type ImageMeta } from '../lib/fill'\n\ninterface Props {\n  title?: string\n  /** Meta description; falls back to the entry's excerpt, tags stripped. */\n  description?: string\n  /** Overrides the generated address \u2014 for a page that canonicalises elsewhere. */\n  canonical?: string\n  /** Social image: absolute, or site-root-relative. */\n  image?: string\n  /** Size and type of `image`, as the producer measured it. */\n  imageMeta?: ImageMeta\n  /** This page's translations, itself included, plus x-default. */\n  alternates?: Array<{ lang: string; path: string }>\n  /** The trail to this page, itself excluded \u2014 the page is appended with its own address. */\n  breadcrumbs?: Breadcrumb[]\n  /** `CollectionPage` on a list; `WebPage` otherwise. */\n  pageType?: 'WebPage' | 'CollectionPage'\n  /** `@id` of the site's WebSite node kept in the head chrome, when there is one. */\n  websiteId?: string\n  /** `article` on entry pages, `website` on lists and static pages. */\n  type?: 'article' | 'website'\n  /** ISO 8601 \u2014 structured data only; the displayed date stays a mark. */\n  publishedAt?: string\n  modifiedAt?: string\n  author?: string\n  siteName?: string\n  locale?: string\n}\n\nconst {\n  title = '',\n  description,\n  canonical,\n  image,\n  imageMeta,\n  alternates = [],\n  breadcrumbs,\n  pageType,\n  websiteId,\n  type = 'website',\n  publishedAt,\n  modifiedAt,\n  author,\n  siteName,\n  locale,\n} = Astro.props\n\nconst site = Astro.site\nconst url = canonical ? absoluteUrl(canonical, site) : absoluteUrl(Astro.url.pathname, site)\nconst imageUrl = absoluteUrl(image, site)\nconst imageTags = imageUrl ? imageMetaTags(imageMeta) : {}\n// hreflang needs absolute URLs; without `site` there are none to give.\nconst hreflang = alternates.flatMap((a) => {\n  const href = absoluteUrl(a.path, site)\n  return href ? [{ lang: a.lang, href }] : []\n})\nconst localeAlternates = [...new Set(hreflang.map((a) => a.lang))].filter((l) => l !== 'x-default' && l !== locale)\nconst desc = seoDescription(description)\nconst article = type === 'article'\nconst structured = pageStructuredData({\n  url,\n  site,\n  title,\n  description: desc,\n  image: imageUrl,\n  locale,\n  article,\n  pageType,\n  publishedAt,\n  modifiedAt,\n  author,\n  siteName,\n  websiteId,\n  breadcrumbs,\n})\n---\n<title>{title}</title>\n{desc && <meta name=\"description\" content={desc} />}\n{url && <link rel=\"canonical\" href={url} />}\n{hreflang.map((a) => <link rel=\"alternate\" hreflang={a.lang} href={a.href} />)}\n<meta property=\"og:type\" content={type} />\n{title && <meta property=\"og:title\" content={title} />}\n{desc && <meta property=\"og:description\" content={desc} />}\n{url && <meta property=\"og:url\" content={url} />}\n{imageUrl && <meta property=\"og:image\" content={imageUrl} />}\n{imageTags.width && <meta property=\"og:image:width\" content={imageTags.width} />}\n{imageTags.height && <meta property=\"og:image:height\" content={imageTags.height} />}\n{imageTags.type && <meta property=\"og:image:type\" content={imageTags.type} />}\n{siteName && <meta property=\"og:site_name\" content={siteName} />}\n{locale && <meta property=\"og:locale\" content={locale} />}\n{localeAlternates.map((l) => <meta property=\"og:locale:alternate\" content={l} />)}\n{article && publishedAt && <meta property=\"article:published_time\" content={publishedAt} />}\n{article && modifiedAt && <meta property=\"article:modified_time\" content={modifiedAt} />}\n{article && author && <meta property=\"article:author\" content={author} />}\n<meta name=\"twitter:card\" content={imageUrl ? 'summary_large_image' : 'summary'} />\n{title && <meta name=\"twitter:title\" content={title} />}\n{desc && <meta name=\"twitter:description\" content={desc} />}\n{imageUrl && <meta name=\"twitter:image\" content={imageUrl} />}\n{structured && <script is:inline type=\"application/ld+json\" set:html={jsonLd(structured)} />}\n";
+declare const SEO_COMPONENT = "---\n/**\n * Per-page SEO \u2014 emitted by @contentrain/emitter-astro.\n *\n * Title, description, canonical, Open Graph, Twitter card and (on entry pages)\n * Article structured data, derived from the entry. The source theme's copies of\n * these tags are removed from the head chrome at emit time, so each appears once.\n *\n * Canonical and absolute URLs need `site` in astro.config.mjs; without it the\n * canonical link and og:url are omitted rather than pointing at a build host.\n */\nimport { absoluteUrl, imageMetaTags, jsonLd, ogLocale, pagePath, pageStructuredData, seoDescription, sourceStructuredData, type AuthorProfile, type Breadcrumb, type ImageMeta, type SocialOverride, type TwitterOverride } from '../lib/fill'\n\ninterface Props {\n  /** The document title \u2014 an SEO plugin's composed one when the source had it. */\n  title?: string\n  /** The entry's own title, when it differs from `title`: Article headline, last breadcrumb. */\n  headline?: string\n  /** Meta description; falls back to the entry's excerpt, tags stripped. */\n  description?: string\n  /** Overrides the generated address \u2014 for a page that canonicalises elsewhere. */\n  canonical?: string\n  /** Social image: absolute, or site-root-relative. */\n  image?: string\n  /** Size and type of `image`, as the producer measured it. */\n  imageMeta?: ImageMeta\n  /** This page's translations, itself included, plus x-default. */\n  alternates?: Array<{ lang: string; path: string }>\n  /** The trail to this page, itself excluded \u2014 the page is appended with its own address. */\n  breadcrumbs?: Breadcrumb[]\n  /** `CollectionPage` on a list; `WebPage` otherwise. */\n  pageType?: 'WebPage' | 'CollectionPage'\n  /** `@id` of the site's WebSite node kept in the head chrome, when there is one. */\n  websiteId?: string\n  /** `@id` of the node the kept head says publishes the site \u2014 the Article's publisher. */\n  publisherId?: string\n  /** false: the site's addresses end without a slash (`/hello`), as the source's did. */\n  trailingSlash?: boolean\n  /** `@id` of every structured-data node the head chrome keeps \u2014 not repeated from `schema`. */\n  headLdIds?: string[]\n  /** `article` on entry pages, `website` on lists and static pages. */\n  type?: 'article' | 'website'\n  /** ISO 8601 \u2014 structured data only; the displayed date stays a mark. */\n  publishedAt?: string\n  modifiedAt?: string\n  author?: string\n  /** The author's page, for the Article author's `url`. */\n  authorUrl?: string\n  /** On an author's archive: who the page is about \u2014 ProfilePage + Person. */\n  profile?: AuthorProfile\n  /** This page's own feed (an archive's), site-root-relative: `<link rel=\"alternate\" type=\"application/rss+xml\">`. */\n  feed?: { path: string; title?: string }\n  siteName?: string\n  locale?: string\n  /** The page is kept out of search: `<meta name=\"robots\" content=\"noindex\">`. */\n  noindex?: boolean\n  nofollow?: boolean\n  /** Site-wide robots directives from the template head (`max-image-preview:large`, \u2026), printed on every page. */\n  robotsDefault?: string[]\n  /** Share-card values the source set by hand, over the derived ones. */\n  openGraph?: SocialOverride\n  /** Unset values follow Open Graph. */\n  twitter?: TwitterOverride\n  /** The source SEO plugin's JSON-LD for this page \u2014 printed instead of the generated graph. */\n  schema?: unknown\n}\n\nconst {\n  title = '',\n  headline,\n  description,\n  canonical,\n  image,\n  imageMeta,\n  alternates = [],\n  breadcrumbs,\n  pageType,\n  websiteId,\n  publisherId,\n  trailingSlash = true,\n  headLdIds = [],\n  type = 'website',\n  publishedAt,\n  modifiedAt,\n  author,\n  authorUrl,\n  profile,\n  feed,\n  siteName,\n  locale,\n  noindex = false,\n  nofollow = false,\n  robotsDefault = [],\n  openGraph,\n  twitter,\n  schema,\n} = Astro.props\n\nconst site = Astro.site\nconst url = canonical ? absoluteUrl(canonical, site) : absoluteUrl(pagePath(Astro.url.pathname, trailingSlash), site)\nconst imageUrl = absoluteUrl(image, site)\nconst imageTags = imageUrl ? imageMetaTags(imageMeta) : {}\n// hreflang needs absolute URLs; without `site` there are none to give.\nconst hreflang = alternates.flatMap((a) => {\n  const href = absoluteUrl(pagePath(a.path, trailingSlash), site)\n  return href ? [{ lang: a.lang, href }] : []\n})\n// og:locale takes ll_RR; a language without a region has no such form and is left out.\nconst ogLang = ogLocale(locale)\nconst localeAlternates = [...new Set(hreflang.map((a) => ogLocale(a.lang)))].filter((l): l is string => Boolean(l) && l !== ogLang)\nconst desc = seoDescription(description)\nconst robots = [noindex && 'noindex', nofollow && 'nofollow', ...robotsDefault].filter(Boolean).join(', ')\n// Share cards: what the source set by hand, else what the page says.\nconst ogTitle = openGraph?.title || title\nconst ogDesc = seoDescription(openGraph?.description) ?? desc\nconst ogImage = absoluteUrl(openGraph?.image, site) ?? imageUrl\n// The measurements describe `image`; an override is another file.\nconst ogImageTags = ogImage === imageUrl ? imageTags : {}\nconst twTitle = twitter?.title || ogTitle\nconst twDesc = seoDescription(twitter?.description) ?? ogDesc\nconst twImage = absoluteUrl(twitter?.image, site) ?? ogImage\nconst twCard = twitter?.card === 'summary' || twitter?.card === 'summary_large_image' ? twitter.card : twImage ? 'summary_large_image' : 'summary'\nconst article = type === 'article'\nconst structured = sourceStructuredData(schema, headLdIds) ?? pageStructuredData({\n  url,\n  site,\n  title,\n  headline,\n  description: desc,\n  image: imageUrl,\n  imageMeta: imageUrl ? imageMeta : undefined,\n  locale,\n  article,\n  pageType,\n  publishedAt,\n  modifiedAt,\n  author,\n  authorUrl,\n  profile,\n  trailingSlash,\n  siteName,\n  websiteId,\n  publisherId,\n  breadcrumbs,\n})\n---\n<title>{title}</title>\n{robots && <meta name=\"robots\" content={robots} />}\n{desc && <meta name=\"description\" content={desc} />}\n{url && <link rel=\"canonical\" href={url} />}\n{hreflang.map((a) => <link rel=\"alternate\" hreflang={a.lang} href={a.href} />)}\n{feed && <link rel=\"alternate\" type=\"application/rss+xml\" title={feed.title} href={feed.path} />}\n<meta property=\"og:type\" content={type} />\n{ogTitle && <meta property=\"og:title\" content={ogTitle} />}\n{ogDesc && <meta property=\"og:description\" content={ogDesc} />}\n{url && <meta property=\"og:url\" content={url} />}\n{ogImage && <meta property=\"og:image\" content={ogImage} />}\n{ogImageTags.width && <meta property=\"og:image:width\" content={ogImageTags.width} />}\n{ogImageTags.height && <meta property=\"og:image:height\" content={ogImageTags.height} />}\n{ogImageTags.type && <meta property=\"og:image:type\" content={ogImageTags.type} />}\n{siteName && <meta property=\"og:site_name\" content={siteName} />}\n{ogLang && <meta property=\"og:locale\" content={ogLang} />}\n{localeAlternates.map((l) => <meta property=\"og:locale:alternate\" content={l} />)}\n{article && publishedAt && <meta property=\"article:published_time\" content={publishedAt} />}\n{article && modifiedAt && <meta property=\"article:modified_time\" content={modifiedAt} />}\n{article && author && <meta property=\"article:author\" content={author} />}\n<meta name=\"twitter:card\" content={twCard} />\n{twTitle && <meta name=\"twitter:title\" content={twTitle} />}\n{twDesc && <meta name=\"twitter:description\" content={twDesc} />}\n{twImage && <meta name=\"twitter:image\" content={twImage} />}\n{structured && <script is:inline type=\"application/ld+json\" set:html={jsonLd(structured)} />}\n";
+//#endregion
+//#region src/seo-entry.d.ts
+/** The SEO fields of one page, ready to spread into an `EmitPost` or `QueryPage`. */
+interface SeoFields {
+  /** For an `EmitPost`; a `QueryPage`'s `title` is already its document title. */
+  seo_title?: string;
+  description?: string;
+  canonical?: string;
+  /** Kept out of search. */
+  noindex?: boolean;
+  nofollow?: boolean;
+  open_graph?: SocialOverride;
+  twitter?: TwitterOverride;
+  schema?: unknown;
+}
+interface SeoFromRawOptions {
+  /** The plugin the live site's head came from (`RawSeo.serving`). Its block is read first. */
+  serving?: SeoProvider | 'wordpress-core';
+  /**
+   * The page's own absolute address. A canonical equal to it is left out — the
+   * Seo component already points a page at itself — so only a canonical that
+   * sends the page somewhere else becomes an override.
+   */
+  url?: string;
+}
+/**
+ * One page's SEO fields from the blocks each plugin holds for it. The serving
+ * plugin's block wins; without one the first plugin (Yoast, Rank Math, AIOSEO)
+ * that has data does. A block not marked `resolved` holds stored values and
+ * templates, so its template strings — in that plugin's syntax — are dropped
+ * and its literal values kept.
+ *
+ * Robots come from `robots_served` — what the page actually carried after
+ * WordPress and the plugin reconciled their settings — and from the plugin's
+ * own `robots` only when that is missing.
+ */
+declare function seoFromRawEntry(blocks: Partial<Record<SeoProvider, RawSeoEntry>> | undefined, options?: SeoFromRawOptions): SeoFields;
 //#endregion
 //#region src/alternates.d.ts
 interface Alternate {
@@ -338,7 +570,7 @@ interface AlternatesResult {
 declare function withAlternates(routes: RouteModel[], content: EmitContent, siteLocale: string): AlternatesResult;
 //#endregion
 //#region src/embed.d.ts
-declare const EMBED_TS = "// Emitted by @contentrain/emitter-astro \u2014 the runtime-component client.\n//\n// Comments and forms are the two regions of a migrated site that need a live\n// service. This module is the browser side of the provider's PUBLIC API\n// (Studio: /api/forms/v1 and /api/comments/v1) \u2014 the same contract that\n// @contentrain/query/cdn implements, inlined so the generated site depends on\n// nothing but Astro. No credential travels with a request: the endpoints are\n// unauthenticated by design, and a page cannot keep a secret.\n//\n// Rendering helpers are pure (strings in, HTML out, escaped by default) so the\n// mount functions at the bottom are the only code that touches the DOM.\n\nexport interface Runtime {\n  base_url: string\n  project_id: string\n}\n\nexport interface EntryRef {\n  model_id: string\n  entry_id: string\n  locale?: string\n}\n\nexport class EmbedError extends Error {\n  status: number\n  constructor(status: number, message: string) {\n    super(message)\n    this.name = 'EmbedError'\n    this.status = status\n  }\n}\n\n/**\n * Visitor-facing text. The component passes the page's text from the site's\n * ui-strings dictionary (`data-strings`); these are the defaults it falls\n * back to, key for key.\n */\nexport const strings = {\n  loading: 'Loading\u2026',\n  send: 'Send',\n  sending: 'Sending\u2026',\n  commentsTitle: 'Comments',\n  noComments: 'No comments yet.',\n  closed: 'Comments are closed.',\n  postComment: 'Post comment',\n  reply: 'Reply',\n  replyingTo: 'Replying to',\n  cancel: 'Cancel',\n  loadMore: 'Load more comments',\n  moderator: 'Moderator',\n  pending: 'Thank you \u2014 your comment is awaiting moderation.',\n  posted: 'Your comment has been posted.',\n  name: 'Name',\n  email: 'Email',\n  emailNote: '(never shown)',\n  website: 'Website',\n  comment: 'Comment',\n  failed: 'Something went wrong. Please try again.',\n  honeypot: 'Leave this field empty',\n}\n\nexport const esc = (value: unknown): string =>\n  String(value ?? '')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n\n// \u2500\u2500\u2500 Transport \u2500\u2500\u2500\n\n/** `base` without a trailing slash, segments URL-encoded, empty query values dropped. */\nexport function publicUrl(base: string, segments: string[], query?: Record<string, string | number | undefined>): string {\n  const path = segments.map((s) => encodeURIComponent(s)).join('/')\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query ?? {})) {\n    if (value !== undefined && value !== '') params.set(key, String(value))\n  }\n  const qs = params.toString()\n  return base.replace(/\\/+$/, '') + '/' + path + (qs ? '?' + qs : '')\n}\n\nasync function failure(res: Response): Promise<EmbedError> {\n  const text = await res.text().catch(() => '')\n  let message = text || 'Request failed'\n  try {\n    const parsed = JSON.parse(text) as { message?: unknown; statusMessage?: unknown }\n    const m = parsed.message ?? parsed.statusMessage\n    if (typeof m === 'string' && m) message = m\n  } catch {\n    // not JSON \u2014 the raw text is the message\n  }\n  return new EmbedError(res.status, message)\n}\n\nexport async function getJson<T>(url: string): Promise<T> {\n  const res = await fetch(url)\n  if (!res.ok) throw await failure(res)\n  return (await res.json()) as T\n}\n\nexport async function postJson<T>(url: string, body: unknown): Promise<T> {\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  })\n  if (!res.ok) throw await failure(res)\n  return (await res.json()) as T\n}\n\nexport const formsRoot = (rt: Runtime): string => rt.base_url.replace(/\\/+$/, '') + '/api/forms/v1'\nexport const commentsRoot = (rt: Runtime): string => rt.base_url.replace(/\\/+$/, '') + '/api/comments/v1'\n\n/** The hidden input Cloudflare Turnstile adds to the enclosing form. */\nexport const CAPTCHA_FIELD = 'cf-turnstile-response'\n\n// \u2500\u2500\u2500 Forms \u2500\u2500\u2500\n\nexport interface FieldDef {\n  type: string\n  required?: boolean\n  label?: string\n  options?: string[]\n  min?: number\n  max?: number\n  pattern?: string\n  default?: unknown\n}\n\nexport interface FormConfig {\n  modelId: string\n  locale: string\n  /** Exposed fields only, keyed by field id. */\n  fields: Record<string, FieldDef>\n  captcha: 'turnstile' | null\n  captchaSiteKey: string | null\n  successMessage?: string\n  honeypotField: string | null\n}\n\nexport interface FieldError {\n  field: string\n  message: string\n}\n\nexport interface FormSubmitResult {\n  success: boolean\n  message?: string\n  errors?: FieldError[]\n}\n\n/** The documented request body: values under `data`, control fields beside it. */\nexport interface FormPayload {\n  data: Record<string, unknown>\n  captchaToken?: string\n  _hp?: string\n}\n\nexport function fetchFormConfig(rt: Runtime, model: string): Promise<FormConfig> {\n  return getJson<FormConfig>(publicUrl(formsRoot(rt), [rt.project_id, model, 'config']))\n}\n\nexport function submitForm(rt: Runtime, model: string, payload: FormPayload): Promise<FormSubmitResult> {\n  return postJson<FormSubmitResult>(publicUrl(formsRoot(rt), [rt.project_id, model, 'submit']), payload)\n}\n\nfunction coerce(def: FieldDef, value: string): unknown {\n  switch (def.type) {\n    case 'number':\n    case 'integer':\n    case 'decimal':\n    case 'percent':\n    case 'rating':\n      return value === '' ? '' : Number(value)\n    case 'boolean':\n      return value === 'on' || value === 'true'\n    default:\n      return value\n  }\n}\n\n/**\n * Form entries (`new FormData(form)`) \u2192 request body. Only exposed fields\n * reach `data`; the captcha token and the honeypot value travel beside it, so\n * a control field can never collide with a model field. Files are skipped \u2014\n * uploads are not part of the public contract.\n */\nexport function formPayload(\n  entries: Iterable<[string, unknown]>,\n  config: { fields: Record<string, FieldDef>; honeypotField: string | null },\n): FormPayload {\n  const payload: FormPayload = { data: {} }\n  for (const [name, raw] of entries) {\n    if (typeof raw !== 'string') continue\n    if (name === CAPTCHA_FIELD) {\n      if (raw) payload.captchaToken = raw\n      continue\n    }\n    if (config.honeypotField && name === config.honeypotField) {\n      payload._hp = raw\n      continue\n    }\n    const def = config.fields[name]\n    if (!def) continue\n    payload.data[name] = coerce(def, raw)\n  }\n  return payload\n}\n\nexport function labelFor(id: string, def: FieldDef): string {\n  if (def.label) return def.label\n  const words = id.replace(/[_-]+/g, ' ').trim()\n  return words.charAt(0).toUpperCase() + words.slice(1)\n}\n\n/** One input for one exposed field, chosen by field type. */\nexport function fieldControl(id: string, def: FieldDef, prefix = 'cr-field'): string {\n  const common =\n    ' id=\"' + esc(prefix + '-' + id) + '\" name=\"' + esc(id) + '\"' +\n    (def.required ? ' required' : '') +\n    (def.pattern ? ' pattern=\"' + esc(def.pattern) + '\"' : '')\n  const range =\n    (def.min !== undefined ? ' min=\"' + esc(def.min) + '\"' : '') +\n    (def.max !== undefined ? ' max=\"' + esc(def.max) + '\"' : '')\n  const length = def.max !== undefined ? ' maxlength=\"' + esc(def.max) + '\"' : ''\n  switch (def.type) {\n    case 'text':\n    case 'markdown':\n    case 'richtext':\n    case 'code':\n      return '<textarea' + common + length + ' rows=\"5\"></textarea>'\n    case 'select': {\n      const blank = def.required ? '' : '<option value=\"\"></option>'\n      const options = (def.options ?? []).map((o) => '<option value=\"' + esc(o) + '\">' + esc(o) + '</option>').join('')\n      return '<select' + common + '>' + blank + options + '</select>'\n    }\n    case 'boolean':\n      return '<input type=\"checkbox\"' + common + ' />'\n    case 'number':\n    case 'integer':\n    case 'rating':\n      return '<input type=\"number\"' + common + range + (def.type === 'integer' ? ' step=\"1\"' : '') + ' />'\n    case 'decimal':\n    case 'percent':\n      return '<input type=\"number\" step=\"any\"' + common + range + ' />'\n    case 'email':\n      return '<input type=\"email\"' + common + length + ' />'\n    case 'url':\n      return '<input type=\"url\"' + common + length + ' />'\n    case 'phone':\n      return '<input type=\"tel\"' + common + length + ' />'\n    case 'date':\n      return '<input type=\"date\"' + common + ' />'\n    case 'datetime':\n      return '<input type=\"datetime-local\"' + common + ' />'\n    case 'color':\n      return '<input type=\"color\"' + common + ' />'\n    default:\n      return '<input type=\"text\"' + common + length + ' />'\n  }\n}\n\nexport function honeypotHtml(field: string | null): string {\n  if (!field) return ''\n  return (\n    '<p class=\"cr-hp\" aria-hidden=\"true\" style=\"position:absolute;left:-9999px;top:auto;width:1px;height:1px;overflow:hidden\">' +\n    '<label>' + esc(strings.honeypot) + ' <input type=\"text\" name=\"' + esc(field) + '\" tabindex=\"-1\" autocomplete=\"off\" /></label></p>'\n  )\n}\n\nexport function captchaHtml(captcha: 'turnstile' | null, siteKey: string | null): string {\n  if (captcha !== 'turnstile' || !siteKey) return ''\n  return '<div class=\"cf-turnstile\" data-sitekey=\"' + esc(siteKey) + '\"></div>'\n}\n\nexport function errorsHtml(errors: FieldError[]): string {\n  return (\n    '<ul class=\"cr-errors\" role=\"alert\">' +\n    errors.map((e) => '<li data-field=\"' + esc(e.field) + '\">' + esc(e.field) + ': ' + esc(e.message) + '</li>').join('') +\n    '</ul>'\n  )\n}\n\n/** The whole form for a public form config: one control per exposed field, honeypot, captcha, submit. */\nexport function formHtml(config: FormConfig, prefix = 'cr-field'): string {\n  const fields = Object.entries(config.fields)\n    .map(([id, def]) => {\n      const control = fieldControl(id, def, prefix)\n      const label = '<label for=\"' + esc(prefix + '-' + id) + '\">' + esc(labelFor(id, def)) + (def.required ? ' <span aria-hidden=\"true\">*</span>' : '') + '</label>'\n      return '<p class=\"cr-field cr-field--' + esc(def.type) + '\">' + (def.type === 'boolean' ? control + ' ' + label : label + control) + '</p>'\n    })\n    .join('')\n  return (\n    '<form class=\"cr-form\" method=\"post\" data-model=\"' + esc(config.modelId) + '\">' +\n    fields +\n    honeypotHtml(config.honeypotField) +\n    captchaHtml(config.captcha, config.captchaSiteKey) +\n    '<p class=\"cr-actions\"><button type=\"submit\">' + esc(strings.send) + '</button></p>' +\n    '<div class=\"cr-status\" aria-live=\"polite\"></div>' +\n    '</form>'\n  )\n}\n\n// \u2500\u2500\u2500 Comments \u2500\u2500\u2500\n\nexport interface CommentAuthor {\n  name: string\n  url: string | null\n  isModerator: boolean\n}\n\nexport interface PublicComment {\n  id: string\n  parentId: string | null\n  depth: number\n  author: CommentAuthor\n  /** Plain text. */\n  body: string\n  type: 'comment' | 'pingback' | 'trackback'\n  createdAt: string\n  replies: PublicComment[]\n}\n\nexport interface ThreadConfig {\n  closed: boolean\n  requireApproval: boolean\n  requireEmail: boolean\n  maxDepth: number\n  maxBodyLength: number\n  captcha: 'turnstile' | null\n  captchaSiteKey: string | null\n  honeypotField: string | null\n}\n\nexport interface CommentThread {\n  entry: { modelId: string; entryId: string; locale: string }\n  config: ThreadConfig\n  comments: PublicComment[]\n  total: number\n  page: number\n  limit: number\n}\n\nexport interface CommentSubmitBody {\n  author: { name: string; email?: string; url?: string }\n  body: string\n  /** null for a root comment \u2014 sent explicitly, as the provider's own fixture does. */\n  parentId: string | null\n  captchaToken?: string\n  _hp?: string\n}\n\nexport interface CommentSubmitResult {\n  success: boolean\n  status?: 'pending' | 'approved'\n  comment?: PublicComment\n  errors?: FieldError[]\n}\n\nexport interface ThreadQuery {\n  page?: number\n  limit?: number\n  sort?: 'oldest' | 'newest'\n}\n\nexport function fetchThread(rt: Runtime, entry: EntryRef, query?: ThreadQuery): Promise<CommentThread> {\n  const url = publicUrl(commentsRoot(rt), [rt.project_id, entry.model_id, entry.entry_id], {\n    locale: entry.locale,\n    page: query?.page,\n    limit: query?.limit,\n    sort: query?.sort,\n  })\n  return getJson<CommentThread>(url)\n}\n\nexport function submitComment(rt: Runtime, entry: EntryRef, body: CommentSubmitBody): Promise<CommentSubmitResult> {\n  const url = publicUrl(commentsRoot(rt), [rt.project_id, entry.model_id, entry.entry_id], { locale: entry.locale })\n  return postJson<CommentSubmitResult>(url, body)\n}\n\n/** Comment-form entries \u2192 the documented request body (inputs: author_name, author_email, author_url, body, parent_id). */\nexport function commentPayload(entries: Iterable<[string, unknown]>, honeypotField: string | null): CommentSubmitBody {\n  const values: Record<string, string> = {}\n  const payload: CommentSubmitBody = { author: { name: '' }, body: '', parentId: null }\n  for (const [name, raw] of entries) {\n    if (typeof raw !== 'string') continue\n    if (name === CAPTCHA_FIELD) {\n      if (raw) payload.captchaToken = raw\n      continue\n    }\n    if (honeypotField && name === honeypotField) {\n      payload._hp = raw\n      continue\n    }\n    values[name] = raw\n  }\n  payload.author.name = (values.author_name ?? '').trim()\n  if (values.author_email?.trim()) payload.author.email = values.author_email.trim()\n  if (values.author_url?.trim()) payload.author.url = values.author_url.trim()\n  payload.body = (values.body ?? '').trim()\n  payload.parentId = values.parent_id?.trim() || null\n  return payload\n}\n\n/** Plain text \u2192 paragraphs; blank lines separate paragraphs, single newlines break lines. */\nexport function bodyHtml(text: string): string {\n  return text\n    .split(/\\n{2,}/)\n    .map((p) => p.trim())\n    .filter(Boolean)\n    .map((p) => '<p>' + esc(p).replace(/\\n/g, '<br />') + '</p>')\n    .join('')\n}\n\nexport function hasMore(thread: CommentThread): boolean {\n  return thread.page * thread.limit < thread.total\n}\n\n/** One comment with its replies. A reply button appears only while the thread is open and depth allows it. */\nexport function commentHtml(c: PublicComment, config: { closed: boolean; maxDepth: number }): string {\n  const author = c.author.url\n    ? '<a href=\"' + esc(c.author.url) + '\" rel=\"nofollow ugc noopener\" target=\"_blank\">' + esc(c.author.name) + '</a>'\n    : esc(c.author.name)\n  const badge = c.author.isModerator ? ' <span class=\"cr-moderator\">' + esc(strings.moderator) + '</span>' : ''\n  const date = '<time datetime=\"' + esc(c.createdAt) + '\">' + esc(c.createdAt.slice(0, 10)) + '</time>'\n  const canReply = !config.closed && c.depth < config.maxDepth\n  const reply = canReply\n    ? '<button type=\"button\" class=\"cr-reply\" data-parent=\"' + esc(c.id) + '\" data-author=\"' + esc(c.author.name) + '\">' + esc(strings.reply) + '</button>'\n    : ''\n  const replies = c.replies.length\n    ? '<ol class=\"cr-replies\">' + c.replies.map((r) => commentHtml(r, config)).join('') + '</ol>'\n    : ''\n  return (\n    '<li class=\"cr-comment cr-comment--' + esc(c.type) + '\" id=\"cr-comment-' + esc(c.id) + '\" data-depth=\"' + esc(c.depth) + '\">' +\n    '<div class=\"cr-comment-meta\"><span class=\"cr-comment-author\">' + author + '</span>' + badge + ' ' + date + '</div>' +\n    '<div class=\"cr-comment-body\">' + bodyHtml(c.body) + '</div>' +\n    (reply ? '<div class=\"cr-comment-actions\">' + reply + '</div>' : '') +\n    replies +\n    '</li>'\n  )\n}\n\nexport function threadHtml(thread: CommentThread): string {\n  if (!thread.comments.length) return '<p class=\"cr-empty\">' + esc(strings.noComments) + '</p>'\n  return '<ol class=\"cr-comment-list\">' + thread.comments.map((c) => commentHtml(c, thread.config)).join('') + '</ol>'\n}\n\n/** The comment form; a reply carries its parent in a hidden input. */\nexport function commentFormHtml(config: ThreadConfig, prefix = 'cr-c'): string {\n  const emailLabel = esc(strings.email) + (config.requireEmail ? ' <span aria-hidden=\"true\">*</span>' : '') + ' <small>' + esc(strings.emailNote) + '</small>'\n  return (\n    '<form class=\"cr-comment-form\" method=\"post\">' +\n    '<input type=\"hidden\" name=\"parent_id\" value=\"\" />' +\n    '<p class=\"cr-replying\" hidden><span class=\"cr-replying-to\"></span> <button type=\"button\" class=\"cr-cancel-reply\">' + esc(strings.cancel) + '</button></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-body\">' + esc(strings.comment) + ' <span aria-hidden=\"true\">*</span></label>' +\n    '<textarea id=\"' + prefix + '-body\" name=\"body\" required maxlength=\"' + esc(config.maxBodyLength) + '\" rows=\"5\"></textarea></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-name\">' + esc(strings.name) + ' <span aria-hidden=\"true\">*</span></label>' +\n    '<input type=\"text\" id=\"' + prefix + '-name\" name=\"author_name\" required maxlength=\"120\" autocomplete=\"name\" /></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-email\">' + emailLabel + '</label>' +\n    '<input type=\"email\" id=\"' + prefix + '-email\" name=\"author_email\"' + (config.requireEmail ? ' required' : '') + ' maxlength=\"254\" autocomplete=\"email\" /></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-url\">' + esc(strings.website) + '</label>' +\n    '<input type=\"url\" id=\"' + prefix + '-url\" name=\"author_url\" maxlength=\"2048\" autocomplete=\"url\" /></p>' +\n    honeypotHtml(config.honeypotField) +\n    captchaHtml(config.captcha, config.captchaSiteKey) +\n    '<p class=\"cr-actions\"><button type=\"submit\">' + esc(strings.postComment) + '</button></p>' +\n    '<div class=\"cr-status\" aria-live=\"polite\"></div>' +\n    '</form>'\n  )\n}\n\n// \u2500\u2500\u2500 Turnstile (explicit render, so widgets added after load still render) \u2500\u2500\u2500\n\ninterface TurnstileApi {\n  render: (el: Element, options: { sitekey: string }) => string\n  reset: (id?: string) => void\n}\n\nconst TURNSTILE_SRC = 'https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit&onload=__crTurnstileReady'\nconst widgets = new WeakMap<Element, string>()\nconst waiting: Element[] = []\n\nfunction turnstileApi(): TurnstileApi | undefined {\n  return (globalThis as { turnstile?: TurnstileApi }).turnstile\n}\n\nfunction renderWidget(api: TurnstileApi, el: Element): void {\n  if (widgets.has(el)) return\n  widgets.set(el, api.render(el, { sitekey: el.getAttribute('data-sitekey') ?? '' }))\n}\n\n/** Render every `.cf-turnstile` under `root`, loading the Turnstile script once on first use. */\nexport function renderCaptcha(root: ParentNode): void {\n  const els = Array.from(root.querySelectorAll('.cf-turnstile'))\n  if (!els.length) return\n  const api = turnstileApi()\n  if (api) {\n    for (const el of els) renderWidget(api, el)\n    return\n  }\n  waiting.push(...els)\n  if (document.querySelector('script[data-cr-turnstile]')) return\n  ;(globalThis as Record<string, unknown>).__crTurnstileReady = () => {\n    const ready = turnstileApi()\n    if (!ready) return\n    for (const el of waiting.splice(0)) renderWidget(ready, el)\n  }\n  const script = document.createElement('script')\n  script.src = TURNSTILE_SRC\n  script.async = true\n  script.defer = true\n  script.setAttribute('data-cr-turnstile', '1')\n  document.head.appendChild(script)\n}\n\nexport function resetCaptcha(root: ParentNode): void {\n  const api = turnstileApi()\n  if (!api) return\n  for (const el of Array.from(root.querySelectorAll('.cf-turnstile'))) api.reset(widgets.get(el))\n}\n\n// \u2500\u2500\u2500 Mounting (the only DOM code) \u2500\u2500\u2500\n\n/** ui-strings dictionary key \u2192 the `strings` entry it sets. */\nexport const STRING_KEYS: ReadonlyArray<readonly [string, keyof typeof strings]> = [\n  ['common.loading', 'loading'],\n  ['common.failed', 'failed'],\n  ['form.send', 'send'],\n  ['form.sending', 'sending'],\n  ['form.honeypot', 'honeypot'],\n  ['comments.title', 'commentsTitle'],\n  ['comments.empty', 'noComments'],\n  ['comments.closed', 'closed'],\n  ['comments.post', 'postComment'],\n  ['comments.reply', 'reply'],\n  ['comments.replying_to', 'replyingTo'],\n  ['comments.cancel', 'cancel'],\n  ['comments.load_more', 'loadMore'],\n  ['comments.moderator', 'moderator'],\n  ['comments.pending', 'pending'],\n  ['comments.posted', 'posted'],\n  ['comments.field.name', 'name'],\n  ['comments.field.email', 'email'],\n  ['comments.field.email_note', 'emailNote'],\n  ['comments.field.website', 'website'],\n  ['comments.field.comment', 'comment'],\n]\n\n/**\n * Take the page's interface text from the host element. A value that is not a\n * non-empty string leaves the default; text that cannot be parsed changes\n * nothing, because a mount that fails over a label is worse than an English one.\n */\nexport function applyStrings(host: HTMLElement): void {\n  const raw = host.dataset.strings\n  if (!raw) return\n  let text: unknown\n  try {\n    text = JSON.parse(raw)\n  } catch {\n    return\n  }\n  if (!text || typeof text !== 'object') return\n  for (const [key, name] of STRING_KEYS) {\n    const value = (text as Record<string, unknown>)[key]\n    if (typeof value === 'string' && value !== '') strings[name] = value\n  }\n}\n\nexport function runtimeOf(host: HTMLElement): Runtime {\n  return { base_url: host.dataset.baseUrl ?? '', project_id: host.dataset.project ?? '' }\n}\n\nfunction entryOf(host: HTMLElement): EntryRef {\n  return { model_id: host.dataset.model ?? '', entry_id: host.dataset.entry ?? '', locale: host.dataset.locale || undefined }\n}\n\nfunction setStatus(form: HTMLFormElement, html: string): void {\n  const status = form.querySelector('.cr-status')\n  if (status) status.innerHTML = html\n}\n\nfunction busy(form: HTMLFormElement, on: boolean): void {\n  const button = form.querySelector<HTMLButtonElement>('button[type=\"submit\"]')\n  if (!button) return\n  button.disabled = on\n  if (on) {\n    button.dataset.label = button.textContent ?? ''\n    button.textContent = strings.sending\n  } else {\n    button.textContent = button.dataset.label ?? button.textContent\n  }\n}\n\nfunction entriesOf(form: HTMLFormElement): Array<[string, unknown]> {\n  const out: Array<[string, unknown]> = []\n  new FormData(form).forEach((value, key) => out.push([key, value]))\n  return out\n}\n\n/** `<cr-form data-base-url data-project data-model>` \u2192 fetch the config, render, submit. */\nexport async function mountForm(host: HTMLElement): Promise<void> {\n  applyStrings(host)\n  const rt = runtimeOf(host)\n  const model = host.dataset.model ?? ''\n  host.innerHTML = '<p class=\"cr-loading\">' + esc(strings.loading) + '</p>'\n  let config: FormConfig\n  try {\n    config = await fetchFormConfig(rt, model)\n  } catch (error) {\n    host.innerHTML = '<p class=\"cr-error\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>'\n    return\n  }\n  host.innerHTML = formHtml(config)\n  renderCaptcha(host)\n  const form = host.querySelector('form')\n  if (!form) return\n  form.addEventListener('submit', async (event) => {\n    event.preventDefault()\n    busy(form, true)\n    setStatus(form, '')\n    try {\n      const result = await submitForm(rt, model, formPayload(entriesOf(form), config))\n      if (result.success) {\n        host.innerHTML = '<p class=\"cr-success\" role=\"status\">' + esc(result.message ?? config.successMessage ?? '') + '</p>'\n        return\n      }\n      setStatus(form, errorsHtml(result.errors ?? []))\n      resetCaptcha(form)\n    } catch (error) {\n      setStatus(form, '<p class=\"cr-error\" role=\"alert\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>')\n      resetCaptcha(form)\n    } finally {\n      busy(form, false)\n    }\n  })\n}\n\n/** `<cr-comments data-base-url data-project data-model data-entry data-locale>` \u2192 thread + form. */\nexport async function mountComments(host: HTMLElement): Promise<void> {\n  applyStrings(host)\n  const rt = runtimeOf(host)\n  const entry = entryOf(host)\n  host.innerHTML = '<p class=\"cr-loading\">' + esc(strings.loading) + '</p>'\n  let thread: CommentThread\n  try {\n    thread = await fetchThread(rt, entry)\n  } catch (error) {\n    host.innerHTML = '<p class=\"cr-error\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>'\n    return\n  }\n\n  host.innerHTML =\n    '<section class=\"cr-comments-section\">' +\n    '<h2 class=\"cr-comments-title\">' + esc(strings.commentsTitle) + ' <span class=\"cr-count\">(' + esc(thread.total) + ')</span></h2>' +\n    '<div class=\"cr-thread\">' + threadHtml(thread) + '</div>' +\n    (hasMore(thread) ? '<p class=\"cr-more\"><button type=\"button\" class=\"cr-load-more\">' + esc(strings.loadMore) + '</button></p>' : '') +\n    (thread.config.closed ? '<p class=\"cr-closed\">' + esc(strings.closed) + '</p>' : commentFormHtml(thread.config)) +\n    '</section>'\n  renderCaptcha(host)\n\n  const threadEl = host.querySelector('.cr-thread')\n  const form = host.querySelector<HTMLFormElement>('form.cr-comment-form')\n  let page = thread.page\n\n  host.addEventListener('click', async (event) => {\n    const target = event.target as HTMLElement | null\n    if (!target) return\n    const replyButton = target.closest<HTMLElement>('.cr-reply')\n    if (replyButton && form) {\n      const parent = form.querySelector<HTMLInputElement>('input[name=\"parent_id\"]')\n      if (parent) parent.value = replyButton.dataset.parent ?? ''\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      const to = form.querySelector('.cr-replying-to')\n      if (to) to.textContent = strings.replyingTo + ' ' + (replyButton.dataset.author ?? '')\n      if (replying) replying.hidden = false\n      replyButton.closest('.cr-comment')?.appendChild(form)\n      form.querySelector<HTMLTextAreaElement>('textarea[name=\"body\"]')?.focus()\n      return\n    }\n    if (target.closest('.cr-cancel-reply') && form) {\n      const parent = form.querySelector<HTMLInputElement>('input[name=\"parent_id\"]')\n      if (parent) parent.value = ''\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      if (replying) replying.hidden = true\n      host.querySelector('.cr-comments-section')?.appendChild(form)\n      return\n    }\n    const more = target.closest<HTMLButtonElement>('.cr-load-more')\n    if (more && threadEl) {\n      more.disabled = true\n      try {\n        const next = await fetchThread(rt, entry, { page: page + 1 })\n        page = next.page\n        const list = threadEl.querySelector('.cr-comment-list')\n        if (list) list.insertAdjacentHTML('beforeend', next.comments.map((c) => commentHtml(c, next.config)).join(''))\n        if (!hasMore(next)) more.closest('.cr-more')?.remove()\n      } finally {\n        more.disabled = false\n      }\n    }\n  })\n\n  form?.addEventListener('submit', async (event) => {\n    event.preventDefault()\n    busy(form, true)\n    setStatus(form, '')\n    try {\n      const result = await submitComment(rt, entry, commentPayload(entriesOf(form), thread.config.honeypotField))\n      if (!result.success) {\n        setStatus(form, errorsHtml(result.errors ?? []))\n        resetCaptcha(form)\n        return\n      }\n      const parentId = result.comment?.parentId ?? null\n      if (result.status === 'approved' && result.comment && threadEl) {\n        const html = commentHtml(result.comment, thread.config)\n        const parent = parentId ? threadEl.querySelector('#cr-comment-' + parentId) : null\n        if (parent) {\n          let replies = parent.querySelector(':scope > .cr-replies')\n          if (!replies) {\n            parent.insertAdjacentHTML('beforeend', '<ol class=\"cr-replies\"></ol>')\n            replies = parent.querySelector(':scope > .cr-replies')\n          }\n          replies?.insertAdjacentHTML('beforeend', html)\n        } else {\n          const list = threadEl.querySelector('.cr-comment-list')\n          if (list) list.insertAdjacentHTML('beforeend', html)\n          else threadEl.innerHTML = '<ol class=\"cr-comment-list\">' + html + '</ol>'\n        }\n      }\n      form.reset()\n      host.querySelector('.cr-comments-section')?.appendChild(form)\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      if (replying) replying.hidden = true\n      resetCaptcha(form)\n      setStatus(form, '<p class=\"cr-success\" role=\"status\">' + esc(result.status === 'approved' ? strings.posted : strings.pending) + '</p>')\n    } catch (error) {\n      setStatus(form, '<p class=\"cr-error\" role=\"alert\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>')\n      resetCaptcha(form)\n    } finally {\n      busy(form, false)\n    }\n  })\n}\n";
+declare const EMBED_TS = "// Emitted by @contentrain/emitter-astro \u2014 the runtime-component client.\n//\n// Comments and forms are the two regions of a migrated site that need a live\n// service. This module is the browser side of the provider's PUBLIC API\n// (Studio: /api/forms/v1 and /api/comments/v1) \u2014 the same contract that\n// @contentrain/query/cdn implements, inlined so the generated site depends on\n// nothing but Astro. No credential travels with a request: the endpoints are\n// unauthenticated by design, and a page cannot keep a secret.\n//\n// Rendering helpers are pure (strings in, HTML out, escaped by default) so the\n// mount functions at the bottom are the only code that touches the DOM.\n\nexport interface Runtime {\n  base_url: string\n  project_id: string\n}\n\nexport interface EntryRef {\n  model_id: string\n  entry_id: string\n  locale?: string\n}\n\nexport class EmbedError extends Error {\n  status: number\n  /** The API's machine code (`data.code`), when the body carries one \u2014 e.g. `payment_required`. */\n  code?: string\n  constructor(status: number, message: string, code?: string) {\n    super(message)\n    this.name = 'EmbedError'\n    this.status = status\n    if (code) this.code = code\n  }\n}\n\n/**\n * The workspace's subscription is inactive (Studio answers 402\n * `payment_required` on the public forms and comments endpoints). Not the\n * visitor's problem and not transient: no retry helps until the owner updates\n * billing.\n */\nexport function isPaymentRequired(error: unknown): boolean {\n  return error instanceof EmbedError && (error.status === 402 || error.code === 'payment_required')\n}\n\n/**\n * Take a widget off the page without a word to the visitor \u2014 the message is\n * written for the workspace owner, who finds it in the console. The rest of\n * the page is untouched.\n */\nexport function hideUnavailable(host: HTMLElement, what: 'form' | 'comments'): void {\n  host.innerHTML = ''\n  host.hidden = true\n  // A site stylesheet that sets display on the element would override hidden.\n  host.style.display = 'none'\n  console.debug('[contentrain] ' + what + ' hidden: the workspace subscription is inactive (402 payment_required). The workspace owner needs to update billing in Contentrain Studio.')\n}\n\n/**\n * Visitor-facing text. The component passes the page's text from the site's\n * ui-strings dictionary (`data-strings`); these are the defaults it falls\n * back to, key for key.\n */\nexport const strings = {\n  loading: 'Loading\u2026',\n  send: 'Send',\n  sending: 'Sending\u2026',\n  commentsTitle: 'Comments',\n  noComments: 'No comments yet.',\n  closed: 'Comments are closed.',\n  postComment: 'Post comment',\n  reply: 'Reply',\n  replyingTo: 'Replying to',\n  cancel: 'Cancel',\n  loadMore: 'Load more comments',\n  moderator: 'Moderator',\n  pending: 'Thank you \u2014 your comment is awaiting moderation.',\n  posted: 'Your comment has been posted.',\n  name: 'Name',\n  email: 'Email',\n  emailNote: '(never shown)',\n  website: 'Website',\n  comment: 'Comment',\n  failed: 'Something went wrong. Please try again.',\n  honeypot: 'Leave this field empty',\n}\n\nexport const esc = (value: unknown): string =>\n  String(value ?? '')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n\n// \u2500\u2500\u2500 Transport \u2500\u2500\u2500\n\n/** `base` without a trailing slash, segments URL-encoded, empty query values dropped. */\nexport function publicUrl(base: string, segments: string[], query?: Record<string, string | number | undefined>): string {\n  const path = segments.map((s) => encodeURIComponent(s)).join('/')\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query ?? {})) {\n    if (value !== undefined && value !== '') params.set(key, String(value))\n  }\n  const qs = params.toString()\n  return base.replace(/\\/+$/, '') + '/' + path + (qs ? '?' + qs : '')\n}\n\nasync function failure(res: Response): Promise<EmbedError> {\n  const text = await res.text().catch(() => '')\n  let message = text || 'Request failed'\n  let code: string | undefined\n  try {\n    const parsed = JSON.parse(text) as { message?: unknown; statusMessage?: unknown; data?: { code?: unknown } }\n    const m = parsed.message ?? parsed.statusMessage\n    if (typeof m === 'string' && m) message = m\n    if (typeof parsed.data?.code === 'string') code = parsed.data.code\n  } catch {\n    // not JSON \u2014 the raw text is the message\n  }\n  return new EmbedError(res.status, message, code)\n}\n\nexport async function getJson<T>(url: string): Promise<T> {\n  const res = await fetch(url)\n  if (!res.ok) throw await failure(res)\n  return (await res.json()) as T\n}\n\nexport async function postJson<T>(url: string, body: unknown): Promise<T> {\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  })\n  if (!res.ok) throw await failure(res)\n  return (await res.json()) as T\n}\n\nexport const formsRoot = (rt: Runtime): string => rt.base_url.replace(/\\/+$/, '') + '/api/forms/v1'\nexport const commentsRoot = (rt: Runtime): string => rt.base_url.replace(/\\/+$/, '') + '/api/comments/v1'\n\n/** The hidden input Cloudflare Turnstile adds to the enclosing form. */\nexport const CAPTCHA_FIELD = 'cf-turnstile-response'\n\n// \u2500\u2500\u2500 Forms \u2500\u2500\u2500\n\nexport interface FieldDef {\n  type: string\n  required?: boolean\n  label?: string\n  options?: string[]\n  min?: number\n  max?: number\n  pattern?: string\n  default?: unknown\n}\n\nexport interface FormConfig {\n  modelId: string\n  locale: string\n  /** Exposed fields only, keyed by field id. */\n  fields: Record<string, FieldDef>\n  captcha: 'turnstile' | null\n  captchaSiteKey: string | null\n  successMessage?: string\n  honeypotField: string | null\n}\n\nexport interface FieldError {\n  field: string\n  message: string\n}\n\nexport interface FormSubmitResult {\n  success: boolean\n  message?: string\n  errors?: FieldError[]\n}\n\n/** The documented request body: values under `data`, control fields beside it. */\nexport interface FormPayload {\n  data: Record<string, unknown>\n  captchaToken?: string\n  _hp?: string\n}\n\nexport function fetchFormConfig(rt: Runtime, model: string): Promise<FormConfig> {\n  return getJson<FormConfig>(publicUrl(formsRoot(rt), [rt.project_id, model, 'config']))\n}\n\nexport function submitForm(rt: Runtime, model: string, payload: FormPayload): Promise<FormSubmitResult> {\n  return postJson<FormSubmitResult>(publicUrl(formsRoot(rt), [rt.project_id, model, 'submit']), payload)\n}\n\nfunction coerce(def: FieldDef, value: string): unknown {\n  switch (def.type) {\n    case 'number':\n    case 'integer':\n    case 'decimal':\n    case 'percent':\n    case 'rating':\n      return value === '' ? '' : Number(value)\n    case 'boolean':\n      return value === 'on' || value === 'true'\n    default:\n      return value\n  }\n}\n\n/**\n * Form entries (`new FormData(form)`) \u2192 request body. Only exposed fields\n * reach `data`; the captcha token and the honeypot value travel beside it, so\n * a control field can never collide with a model field. Files are skipped \u2014\n * uploads are not part of the public contract.\n */\nexport function formPayload(\n  entries: Iterable<[string, unknown]>,\n  config: { fields: Record<string, FieldDef>; honeypotField: string | null },\n): FormPayload {\n  const payload: FormPayload = { data: {} }\n  for (const [name, raw] of entries) {\n    if (typeof raw !== 'string') continue\n    if (name === CAPTCHA_FIELD) {\n      if (raw) payload.captchaToken = raw\n      continue\n    }\n    if (config.honeypotField && name === config.honeypotField) {\n      payload._hp = raw\n      continue\n    }\n    const def = config.fields[name]\n    if (!def) continue\n    payload.data[name] = coerce(def, raw)\n  }\n  return payload\n}\n\nexport function labelFor(id: string, def: FieldDef): string {\n  if (def.label) return def.label\n  const words = id.replace(/[_-]+/g, ' ').trim()\n  return words.charAt(0).toUpperCase() + words.slice(1)\n}\n\n/** One input for one exposed field, chosen by field type. */\nexport function fieldControl(id: string, def: FieldDef, prefix = 'cr-field'): string {\n  const common =\n    ' id=\"' + esc(prefix + '-' + id) + '\" name=\"' + esc(id) + '\"' +\n    (def.required ? ' required' : '') +\n    (def.pattern ? ' pattern=\"' + esc(def.pattern) + '\"' : '')\n  const range =\n    (def.min !== undefined ? ' min=\"' + esc(def.min) + '\"' : '') +\n    (def.max !== undefined ? ' max=\"' + esc(def.max) + '\"' : '')\n  const length = def.max !== undefined ? ' maxlength=\"' + esc(def.max) + '\"' : ''\n  switch (def.type) {\n    case 'text':\n    case 'markdown':\n    case 'richtext':\n    case 'code':\n      return '<textarea' + common + length + ' rows=\"5\"></textarea>'\n    case 'select': {\n      const blank = def.required ? '' : '<option value=\"\"></option>'\n      const options = (def.options ?? []).map((o) => '<option value=\"' + esc(o) + '\">' + esc(o) + '</option>').join('')\n      return '<select' + common + '>' + blank + options + '</select>'\n    }\n    case 'boolean':\n      return '<input type=\"checkbox\"' + common + ' />'\n    case 'number':\n    case 'integer':\n    case 'rating':\n      return '<input type=\"number\"' + common + range + (def.type === 'integer' ? ' step=\"1\"' : '') + ' />'\n    case 'decimal':\n    case 'percent':\n      return '<input type=\"number\" step=\"any\"' + common + range + ' />'\n    case 'email':\n      return '<input type=\"email\"' + common + length + ' />'\n    case 'url':\n      return '<input type=\"url\"' + common + length + ' />'\n    case 'phone':\n      return '<input type=\"tel\"' + common + length + ' />'\n    case 'date':\n      return '<input type=\"date\"' + common + ' />'\n    case 'datetime':\n      return '<input type=\"datetime-local\"' + common + ' />'\n    case 'color':\n      return '<input type=\"color\"' + common + ' />'\n    default:\n      return '<input type=\"text\"' + common + length + ' />'\n  }\n}\n\nexport function honeypotHtml(field: string | null): string {\n  if (!field) return ''\n  return (\n    '<p class=\"cr-hp\" aria-hidden=\"true\" style=\"position:absolute;left:-9999px;top:auto;width:1px;height:1px;overflow:hidden\">' +\n    '<label>' + esc(strings.honeypot) + ' <input type=\"text\" name=\"' + esc(field) + '\" tabindex=\"-1\" autocomplete=\"off\" /></label></p>'\n  )\n}\n\nexport function captchaHtml(captcha: 'turnstile' | null, siteKey: string | null): string {\n  if (captcha !== 'turnstile' || !siteKey) return ''\n  return '<div class=\"cf-turnstile\" data-sitekey=\"' + esc(siteKey) + '\"></div>'\n}\n\nexport function errorsHtml(errors: FieldError[]): string {\n  return (\n    '<ul class=\"cr-errors\" role=\"alert\">' +\n    errors.map((e) => '<li data-field=\"' + esc(e.field) + '\">' + esc(e.field) + ': ' + esc(e.message) + '</li>').join('') +\n    '</ul>'\n  )\n}\n\n/** The whole form for a public form config: one control per exposed field, honeypot, captcha, submit. */\nexport function formHtml(config: FormConfig, prefix = 'cr-field'): string {\n  const fields = Object.entries(config.fields)\n    .map(([id, def]) => {\n      const control = fieldControl(id, def, prefix)\n      const label = '<label for=\"' + esc(prefix + '-' + id) + '\">' + esc(labelFor(id, def)) + (def.required ? ' <span aria-hidden=\"true\">*</span>' : '') + '</label>'\n      return '<p class=\"cr-field cr-field--' + esc(def.type) + '\">' + (def.type === 'boolean' ? control + ' ' + label : label + control) + '</p>'\n    })\n    .join('')\n  return (\n    '<form class=\"cr-form\" method=\"post\" data-model=\"' + esc(config.modelId) + '\">' +\n    fields +\n    honeypotHtml(config.honeypotField) +\n    captchaHtml(config.captcha, config.captchaSiteKey) +\n    '<p class=\"cr-actions\"><button type=\"submit\">' + esc(strings.send) + '</button></p>' +\n    '<div class=\"cr-status\" aria-live=\"polite\"></div>' +\n    '</form>'\n  )\n}\n\n// \u2500\u2500\u2500 Comments \u2500\u2500\u2500\n\nexport interface CommentAuthor {\n  name: string\n  url: string | null\n  isModerator: boolean\n}\n\nexport interface PublicComment {\n  id: string\n  parentId: string | null\n  depth: number\n  author: CommentAuthor\n  /** Plain text. */\n  body: string\n  type: 'comment' | 'pingback' | 'trackback'\n  createdAt: string\n  replies: PublicComment[]\n}\n\nexport interface ThreadConfig {\n  closed: boolean\n  requireApproval: boolean\n  requireEmail: boolean\n  maxDepth: number\n  maxBodyLength: number\n  captcha: 'turnstile' | null\n  captchaSiteKey: string | null\n  honeypotField: string | null\n}\n\nexport interface CommentThread {\n  entry: { modelId: string; entryId: string; locale: string }\n  config: ThreadConfig\n  comments: PublicComment[]\n  total: number\n  page: number\n  limit: number\n}\n\nexport interface CommentSubmitBody {\n  author: { name: string; email?: string; url?: string }\n  body: string\n  /** null for a root comment \u2014 sent explicitly, as the provider's own fixture does. */\n  parentId: string | null\n  captchaToken?: string\n  _hp?: string\n}\n\nexport interface CommentSubmitResult {\n  success: boolean\n  status?: 'pending' | 'approved'\n  comment?: PublicComment\n  errors?: FieldError[]\n}\n\nexport interface ThreadQuery {\n  page?: number\n  limit?: number\n  sort?: 'oldest' | 'newest'\n}\n\nexport function fetchThread(rt: Runtime, entry: EntryRef, query?: ThreadQuery): Promise<CommentThread> {\n  const url = publicUrl(commentsRoot(rt), [rt.project_id, entry.model_id, entry.entry_id], {\n    locale: entry.locale,\n    page: query?.page,\n    limit: query?.limit,\n    sort: query?.sort,\n  })\n  return getJson<CommentThread>(url)\n}\n\nexport function submitComment(rt: Runtime, entry: EntryRef, body: CommentSubmitBody): Promise<CommentSubmitResult> {\n  const url = publicUrl(commentsRoot(rt), [rt.project_id, entry.model_id, entry.entry_id], { locale: entry.locale })\n  return postJson<CommentSubmitResult>(url, body)\n}\n\n/** Comment-form entries \u2192 the documented request body (inputs: author_name, author_email, author_url, body, parent_id). */\nexport function commentPayload(entries: Iterable<[string, unknown]>, honeypotField: string | null): CommentSubmitBody {\n  const values: Record<string, string> = {}\n  const payload: CommentSubmitBody = { author: { name: '' }, body: '', parentId: null }\n  for (const [name, raw] of entries) {\n    if (typeof raw !== 'string') continue\n    if (name === CAPTCHA_FIELD) {\n      if (raw) payload.captchaToken = raw\n      continue\n    }\n    if (honeypotField && name === honeypotField) {\n      payload._hp = raw\n      continue\n    }\n    values[name] = raw\n  }\n  payload.author.name = (values.author_name ?? '').trim()\n  if (values.author_email?.trim()) payload.author.email = values.author_email.trim()\n  if (values.author_url?.trim()) payload.author.url = values.author_url.trim()\n  payload.body = (values.body ?? '').trim()\n  payload.parentId = values.parent_id?.trim() || null\n  return payload\n}\n\n/** Plain text \u2192 paragraphs; blank lines separate paragraphs, single newlines break lines. */\nexport function bodyHtml(text: string): string {\n  return text\n    .split(/\\n{2,}/)\n    .map((p) => p.trim())\n    .filter(Boolean)\n    .map((p) => '<p>' + esc(p).replace(/\\n/g, '<br />') + '</p>')\n    .join('')\n}\n\nexport function hasMore(thread: CommentThread): boolean {\n  return thread.page * thread.limit < thread.total\n}\n\n/** One comment with its replies. A reply button appears only while the thread is open and depth allows it. */\nexport function commentHtml(c: PublicComment, config: { closed: boolean; maxDepth: number }): string {\n  const author = c.author.url\n    ? '<a href=\"' + esc(c.author.url) + '\" rel=\"nofollow ugc noopener\" target=\"_blank\">' + esc(c.author.name) + '</a>'\n    : esc(c.author.name)\n  const badge = c.author.isModerator ? ' <span class=\"cr-moderator\">' + esc(strings.moderator) + '</span>' : ''\n  const date = '<time datetime=\"' + esc(c.createdAt) + '\">' + esc(c.createdAt.slice(0, 10)) + '</time>'\n  const canReply = !config.closed && c.depth < config.maxDepth\n  const reply = canReply\n    ? '<button type=\"button\" class=\"cr-reply\" data-parent=\"' + esc(c.id) + '\" data-author=\"' + esc(c.author.name) + '\">' + esc(strings.reply) + '</button>'\n    : ''\n  const replies = c.replies.length\n    ? '<ol class=\"cr-replies\">' + c.replies.map((r) => commentHtml(r, config)).join('') + '</ol>'\n    : ''\n  return (\n    '<li class=\"cr-comment cr-comment--' + esc(c.type) + '\" id=\"cr-comment-' + esc(c.id) + '\" data-depth=\"' + esc(c.depth) + '\">' +\n    '<div class=\"cr-comment-meta\"><span class=\"cr-comment-author\">' + author + '</span>' + badge + ' ' + date + '</div>' +\n    '<div class=\"cr-comment-body\">' + bodyHtml(c.body) + '</div>' +\n    (reply ? '<div class=\"cr-comment-actions\">' + reply + '</div>' : '') +\n    replies +\n    '</li>'\n  )\n}\n\nexport function threadHtml(thread: CommentThread): string {\n  if (!thread.comments.length) return '<p class=\"cr-empty\">' + esc(strings.noComments) + '</p>'\n  return '<ol class=\"cr-comment-list\">' + thread.comments.map((c) => commentHtml(c, thread.config)).join('') + '</ol>'\n}\n\n/** The comment form; a reply carries its parent in a hidden input. */\nexport function commentFormHtml(config: ThreadConfig, prefix = 'cr-c'): string {\n  const emailLabel = esc(strings.email) + (config.requireEmail ? ' <span aria-hidden=\"true\">*</span>' : '') + ' <small>' + esc(strings.emailNote) + '</small>'\n  return (\n    '<form class=\"cr-comment-form\" method=\"post\">' +\n    '<input type=\"hidden\" name=\"parent_id\" value=\"\" />' +\n    '<p class=\"cr-replying\" hidden><span class=\"cr-replying-to\"></span> <button type=\"button\" class=\"cr-cancel-reply\">' + esc(strings.cancel) + '</button></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-body\">' + esc(strings.comment) + ' <span aria-hidden=\"true\">*</span></label>' +\n    '<textarea id=\"' + prefix + '-body\" name=\"body\" required maxlength=\"' + esc(config.maxBodyLength) + '\" rows=\"5\"></textarea></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-name\">' + esc(strings.name) + ' <span aria-hidden=\"true\">*</span></label>' +\n    '<input type=\"text\" id=\"' + prefix + '-name\" name=\"author_name\" required maxlength=\"120\" autocomplete=\"name\" /></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-email\">' + emailLabel + '</label>' +\n    '<input type=\"email\" id=\"' + prefix + '-email\" name=\"author_email\"' + (config.requireEmail ? ' required' : '') + ' maxlength=\"254\" autocomplete=\"email\" /></p>' +\n    '<p class=\"cr-field\"><label for=\"' + prefix + '-url\">' + esc(strings.website) + '</label>' +\n    '<input type=\"url\" id=\"' + prefix + '-url\" name=\"author_url\" maxlength=\"2048\" autocomplete=\"url\" /></p>' +\n    honeypotHtml(config.honeypotField) +\n    captchaHtml(config.captcha, config.captchaSiteKey) +\n    '<p class=\"cr-actions\"><button type=\"submit\">' + esc(strings.postComment) + '</button></p>' +\n    '<div class=\"cr-status\" aria-live=\"polite\"></div>' +\n    '</form>'\n  )\n}\n\n// \u2500\u2500\u2500 Turnstile (explicit render, so widgets added after load still render) \u2500\u2500\u2500\n\ninterface TurnstileApi {\n  render: (el: Element, options: { sitekey: string }) => string\n  reset: (id?: string) => void\n}\n\nconst TURNSTILE_SRC = 'https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit&onload=__crTurnstileReady'\nconst widgets = new WeakMap<Element, string>()\nconst waiting: Element[] = []\n\nfunction turnstileApi(): TurnstileApi | undefined {\n  return (globalThis as { turnstile?: TurnstileApi }).turnstile\n}\n\nfunction renderWidget(api: TurnstileApi, el: Element): void {\n  if (widgets.has(el)) return\n  widgets.set(el, api.render(el, { sitekey: el.getAttribute('data-sitekey') ?? '' }))\n}\n\n/** Render every `.cf-turnstile` under `root`, loading the Turnstile script once on first use. */\nexport function renderCaptcha(root: ParentNode): void {\n  const els = Array.from(root.querySelectorAll('.cf-turnstile'))\n  if (!els.length) return\n  const api = turnstileApi()\n  if (api) {\n    for (const el of els) renderWidget(api, el)\n    return\n  }\n  waiting.push(...els)\n  if (document.querySelector('script[data-cr-turnstile]')) return\n  ;(globalThis as Record<string, unknown>).__crTurnstileReady = () => {\n    const ready = turnstileApi()\n    if (!ready) return\n    for (const el of waiting.splice(0)) renderWidget(ready, el)\n  }\n  const script = document.createElement('script')\n  script.src = TURNSTILE_SRC\n  script.async = true\n  script.defer = true\n  script.setAttribute('data-cr-turnstile', '1')\n  document.head.appendChild(script)\n}\n\nexport function resetCaptcha(root: ParentNode): void {\n  const api = turnstileApi()\n  if (!api) return\n  for (const el of Array.from(root.querySelectorAll('.cf-turnstile'))) api.reset(widgets.get(el))\n}\n\n// \u2500\u2500\u2500 Mounting (the only DOM code) \u2500\u2500\u2500\n\n/** ui-strings dictionary key \u2192 the `strings` entry it sets. */\nexport const STRING_KEYS: ReadonlyArray<readonly [string, keyof typeof strings]> = [\n  ['common.loading', 'loading'],\n  ['common.failed', 'failed'],\n  ['form.send', 'send'],\n  ['form.sending', 'sending'],\n  ['form.honeypot', 'honeypot'],\n  ['comments.title', 'commentsTitle'],\n  ['comments.empty', 'noComments'],\n  ['comments.closed', 'closed'],\n  ['comments.post', 'postComment'],\n  ['comments.reply', 'reply'],\n  ['comments.replying_to', 'replyingTo'],\n  ['comments.cancel', 'cancel'],\n  ['comments.load_more', 'loadMore'],\n  ['comments.moderator', 'moderator'],\n  ['comments.pending', 'pending'],\n  ['comments.posted', 'posted'],\n  ['comments.field.name', 'name'],\n  ['comments.field.email', 'email'],\n  ['comments.field.email_note', 'emailNote'],\n  ['comments.field.website', 'website'],\n  ['comments.field.comment', 'comment'],\n]\n\n/**\n * Take the page's interface text from the host element. A value that is not a\n * non-empty string leaves the default; text that cannot be parsed changes\n * nothing, because a mount that fails over a label is worse than an English one.\n */\nexport function applyStrings(host: HTMLElement): void {\n  const raw = host.dataset.strings\n  if (!raw) return\n  let text: unknown\n  try {\n    text = JSON.parse(raw)\n  } catch {\n    return\n  }\n  if (!text || typeof text !== 'object') return\n  for (const [key, name] of STRING_KEYS) {\n    const value = (text as Record<string, unknown>)[key]\n    if (typeof value === 'string' && value !== '') strings[name] = value\n  }\n}\n\nexport function runtimeOf(host: HTMLElement): Runtime {\n  return { base_url: host.dataset.baseUrl ?? '', project_id: host.dataset.project ?? '' }\n}\n\nfunction entryOf(host: HTMLElement): EntryRef {\n  return { model_id: host.dataset.model ?? '', entry_id: host.dataset.entry ?? '', locale: host.dataset.locale || undefined }\n}\n\nfunction setStatus(form: HTMLFormElement, html: string): void {\n  const status = form.querySelector('.cr-status')\n  if (status) status.innerHTML = html\n}\n\nfunction busy(form: HTMLFormElement, on: boolean): void {\n  const button = form.querySelector<HTMLButtonElement>('button[type=\"submit\"]')\n  if (!button) return\n  button.disabled = on\n  if (on) {\n    button.dataset.label = button.textContent ?? ''\n    button.textContent = strings.sending\n  } else {\n    button.textContent = button.dataset.label ?? button.textContent\n  }\n}\n\nfunction entriesOf(form: HTMLFormElement): Array<[string, unknown]> {\n  const out: Array<[string, unknown]> = []\n  new FormData(form).forEach((value, key) => out.push([key, value]))\n  return out\n}\n\n/** `<cr-form data-base-url data-project data-model>` \u2192 fetch the config, render, submit. */\nexport async function mountForm(host: HTMLElement): Promise<void> {\n  applyStrings(host)\n  const rt = runtimeOf(host)\n  const model = host.dataset.model ?? ''\n  host.innerHTML = '<p class=\"cr-loading\">' + esc(strings.loading) + '</p>'\n  let config: FormConfig\n  try {\n    config = await fetchFormConfig(rt, model)\n  } catch (error) {\n    if (isPaymentRequired(error)) return hideUnavailable(host, 'form')\n    host.innerHTML = '<p class=\"cr-error\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>'\n    return\n  }\n  host.innerHTML = formHtml(config)\n  renderCaptcha(host)\n  const form = host.querySelector('form')\n  if (!form) return\n  form.addEventListener('submit', async (event) => {\n    event.preventDefault()\n    busy(form, true)\n    setStatus(form, '')\n    try {\n      const result = await submitForm(rt, model, formPayload(entriesOf(form), config))\n      if (result.success) {\n        host.innerHTML = '<p class=\"cr-success\" role=\"status\">' + esc(result.message ?? config.successMessage ?? '') + '</p>'\n        return\n      }\n      setStatus(form, errorsHtml(result.errors ?? []))\n      resetCaptcha(form)\n    } catch (error) {\n      if (isPaymentRequired(error)) return hideUnavailable(host, 'form')\n      setStatus(form, '<p class=\"cr-error\" role=\"alert\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>')\n      resetCaptcha(form)\n    } finally {\n      busy(form, false)\n    }\n  })\n}\n\n/** `<cr-comments data-base-url data-project data-model data-entry data-locale>` \u2192 thread + form. */\nexport async function mountComments(host: HTMLElement): Promise<void> {\n  applyStrings(host)\n  const rt = runtimeOf(host)\n  const entry = entryOf(host)\n  host.innerHTML = '<p class=\"cr-loading\">' + esc(strings.loading) + '</p>'\n  let thread: CommentThread\n  try {\n    thread = await fetchThread(rt, entry)\n  } catch (error) {\n    if (isPaymentRequired(error)) return hideUnavailable(host, 'comments')\n    host.innerHTML = '<p class=\"cr-error\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>'\n    return\n  }\n\n  host.innerHTML =\n    '<section class=\"cr-comments-section\">' +\n    '<h2 class=\"cr-comments-title\">' + esc(strings.commentsTitle) + ' <span class=\"cr-count\">(' + esc(thread.total) + ')</span></h2>' +\n    '<div class=\"cr-thread\">' + threadHtml(thread) + '</div>' +\n    (hasMore(thread) ? '<p class=\"cr-more\"><button type=\"button\" class=\"cr-load-more\">' + esc(strings.loadMore) + '</button></p>' : '') +\n    (thread.config.closed ? '<p class=\"cr-closed\">' + esc(strings.closed) + '</p>' : commentFormHtml(thread.config)) +\n    '</section>'\n  renderCaptcha(host)\n\n  const threadEl = host.querySelector('.cr-thread')\n  const form = host.querySelector<HTMLFormElement>('form.cr-comment-form')\n  let page = thread.page\n\n  host.addEventListener('click', async (event) => {\n    const target = event.target as HTMLElement | null\n    if (!target) return\n    const replyButton = target.closest<HTMLElement>('.cr-reply')\n    if (replyButton && form) {\n      const parent = form.querySelector<HTMLInputElement>('input[name=\"parent_id\"]')\n      if (parent) parent.value = replyButton.dataset.parent ?? ''\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      const to = form.querySelector('.cr-replying-to')\n      if (to) to.textContent = strings.replyingTo + ' ' + (replyButton.dataset.author ?? '')\n      if (replying) replying.hidden = false\n      replyButton.closest('.cr-comment')?.appendChild(form)\n      form.querySelector<HTMLTextAreaElement>('textarea[name=\"body\"]')?.focus()\n      return\n    }\n    if (target.closest('.cr-cancel-reply') && form) {\n      const parent = form.querySelector<HTMLInputElement>('input[name=\"parent_id\"]')\n      if (parent) parent.value = ''\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      if (replying) replying.hidden = true\n      host.querySelector('.cr-comments-section')?.appendChild(form)\n      return\n    }\n    const more = target.closest<HTMLButtonElement>('.cr-load-more')\n    if (more && threadEl) {\n      more.disabled = true\n      try {\n        const next = await fetchThread(rt, entry, { page: page + 1 })\n        page = next.page\n        const list = threadEl.querySelector('.cr-comment-list')\n        if (list) list.insertAdjacentHTML('beforeend', next.comments.map((c) => commentHtml(c, next.config)).join(''))\n        if (!hasMore(next)) more.closest('.cr-more')?.remove()\n      } catch (error) {\n        if (isPaymentRequired(error)) return hideUnavailable(host, 'comments')\n        // Anything else: the button comes back for another try.\n      } finally {\n        more.disabled = false\n      }\n    }\n  })\n\n  form?.addEventListener('submit', async (event) => {\n    event.preventDefault()\n    busy(form, true)\n    setStatus(form, '')\n    try {\n      const result = await submitComment(rt, entry, commentPayload(entriesOf(form), thread.config.honeypotField))\n      if (!result.success) {\n        setStatus(form, errorsHtml(result.errors ?? []))\n        resetCaptcha(form)\n        return\n      }\n      const parentId = result.comment?.parentId ?? null\n      if (result.status === 'approved' && result.comment && threadEl) {\n        const html = commentHtml(result.comment, thread.config)\n        const parent = parentId ? threadEl.querySelector('#cr-comment-' + parentId) : null\n        if (parent) {\n          let replies = parent.querySelector(':scope > .cr-replies')\n          if (!replies) {\n            parent.insertAdjacentHTML('beforeend', '<ol class=\"cr-replies\"></ol>')\n            replies = parent.querySelector(':scope > .cr-replies')\n          }\n          replies?.insertAdjacentHTML('beforeend', html)\n        } else {\n          const list = threadEl.querySelector('.cr-comment-list')\n          if (list) list.insertAdjacentHTML('beforeend', html)\n          else threadEl.innerHTML = '<ol class=\"cr-comment-list\">' + html + '</ol>'\n        }\n      }\n      form.reset()\n      host.querySelector('.cr-comments-section')?.appendChild(form)\n      const replying = form.querySelector<HTMLElement>('.cr-replying')\n      if (replying) replying.hidden = true\n      resetCaptcha(form)\n      setStatus(form, '<p class=\"cr-success\" role=\"status\">' + esc(result.status === 'approved' ? strings.posted : strings.pending) + '</p>')\n    } catch (error) {\n      if (isPaymentRequired(error)) return hideUnavailable(host, 'comments')\n      setStatus(form, '<p class=\"cr-error\" role=\"alert\">' + esc(error instanceof Error ? error.message : strings.failed) + '</p>')\n      resetCaptcha(form)\n    } finally {\n      busy(form, false)\n    }\n  })\n}\n";
 //#endregion
 //#region src/ui-strings.d.ts
 /** Where the dictionary lives in an emitted project, relative to its root. */
@@ -387,10 +619,81 @@ declare function checkBalance(html: string): BalanceReport;
 /** Human-readable balance complaint, or null when the fragment is sound. */
 declare function balanceWarning(html: string): string | null;
 //#endregion
+//#region src/noindex.d.ts
+/** Site-root paths (directory format, `/a/b/`) of every noindex page, sorted. */
+declare function noindexPaths(routes: RouteModel[], content: EmitContent): string[];
+//#endregion
+//#region src/redirects.d.ts
+/** The statuses written to `astro.config`; any other is a manual rule. */
+declare const REDIRECT_STATUSES: readonly [301, 302, 307, 308];
+type RedirectStatus = typeof REDIRECT_STATUSES[number];
+/** A rule the emitter did not write, with why. */
+interface ManualRedirect {
+  redirect: RawRedirect$1;
+  reason: string;
+}
+interface RedirectPlan {
+  /** `from` → rule, as `astro.config` `redirects` takes it. Sorted by `from`. */
+  config: Record<string, {
+    status: RedirectStatus;
+    destination: string;
+  }>;
+  /** The input rules written, in input order. */
+  written: RawRedirect$1[];
+  /** The rules to set up by hand at the host, in input order. */
+  manual: ManualRedirect[];
+}
+/**
+ * Every address the emitted site builds a page at, as `addressKey`s, with the
+ * route that owns it. Single and collection routes build one page per entry,
+ * query routes one per result set, and a route without parameters one page.
+ */
+declare function builtAddresses(routes: RouteModel[], content: EmitContent): Map<string, string>;
+/**
+ * Split the rules into what `astro.config` serves and what the host has to.
+ * `built` is `builtAddresses` of the emitted routes.
+ */
+declare function planRedirects(redirects: RawRedirect$1[], built: Map<string, string>): RedirectPlan;
+/** The `redirects` line for astro.config.mjs, or null when there is nothing to write. */
+declare function astroRedirectsConfig(config: RedirectPlan['config']): string | null;
+/** Hosts whose own redirect file the emitter can write. */
+type RedirectHost = 'netlify' | 'cloudflare' | 'vercel';
+interface HostRedirectFiles {
+  /** Path → content, for the emitted project. */
+  files: Record<string, string>;
+  /** Which host each written file is for, e.g. `public/_redirects (netlify)`. */
+  written: string[];
+  /** Config keys a host file cannot express, left to the meta-refresh fallback. */
+  skipped: string[];
+  /**
+   * Config keys left out of a Cloudflare or Vercel file because it reached
+   * that host's rule limit — served by the meta-refresh fallback only there.
+   */
+  over_limit: string[];
+}
+/**
+ * Real HTTP redirects for the host the site deploys to. A static Astro build
+ * serves `redirects` as meta-refresh pages; the status code only exists if the
+ * host answers the request itself, from its own redirect file. The
+ * meta-refresh pages stay as the fallback for a host without one.
+ *
+ * - `netlify` — `public/_redirects`, forced (`301!`): the build writes a page
+ *   at every redirected path, and Netlify serves an existing file before an
+ *   unforced rule.
+ * - `cloudflare` — `public/_redirects`, unforced: Cloudflare Pages has no `!`
+ *   and applies its rules before static assets.
+ * - `vercel` — `vercel.json` `redirects`, which Vercel applies before the
+ *   filesystem.
+ *
+ * Without a host both the Netlify file and `vercel.json` are written; a site
+ * on Cloudflare Pages should name its host.
+ */
+declare function hostRedirectFiles(config: RedirectPlan['config'], host?: RedirectHost): HostRedirectFiles;
+//#endregion
 //#region src/index.d.ts
 declare function emitAstroProject(input: EmitInput): EmitResult;
 /** Write an EmitResult to disk. Separate from emit so the core stays pure. */
 declare function writeEmit(result: EmitResult, dir: string): Promise<void>;
 //#endregion
-export { type Alternate, type AlternatesResult, type BalanceReport, type Breadcrumb, EMBED_TS, type EmitContent, type EmitCssFile, type EmitInput, type EmitOptions, type EmitPost, type EmitResult, type EmitTermRef, type EntrySourceRef, type ImageMeta, type MountRef, type QueryPage, RUNTIME_IMPLEMENTED, type RuntimeBinding, SEO_COMPONENT, type StripResult, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, type UiStringKey, balanceWarning, bodySeoLeaks, checkBalance, componentMarkers, emitAstroProject, entryPath, isRuntimeImplemented, pascalCase, patternToPagePath, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
+export { type Alternate, type AlternatesResult, type AuthorProfile, type BalanceReport, type Breadcrumb, EMBED_TS, type EmitContent, type EmitCssFile, type EmitInput, type EmitOptions, type EmitPost, type EmitResult, type EmitTermRef, type EntrySourceRef, FEED_ITEMS, FEED_PATH, type FeedLinkResult, type HostRedirectFiles, type ImageMeta, LLMS_LINKS, type LinkSource, type ManualRedirect, type MountRef, type QueryPage, REDIRECT_STATUSES, RUNTIME_IMPLEMENTED, type RawRedirect, type RedirectHost, type RedirectPlan, type RedirectStatus, type RuntimeBinding, SEO_COMPONENT, type SeoFields, type SeoFromRawOptions, type SocialOverride, type StripResult, type TwitterOverride, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, type UiStringKey, astroRedirectsConfig, balanceWarning, bodySeoLeaks, builtAddresses, checkBalance, componentMarkers, emitAstroProject, entryPath, hostRedirectFiles, isRuntimeImplemented, linkSources, noindexPaths, pascalCase, patternToPagePath, planRedirects, publisherIdOf, rewriteFeedLinks, seoFromRawEntry, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
 //# sourceMappingURL=index.d.mts.map