@wildo-ai/saas-website 1.1.1

package/dist/esm/astro/blog-post-head.renderer.js

@@ -0,0 +1,139 @@
+import { buildLocalizedRoutePath } from '../core/routing/internal-routing.utils.js';
+import { escapeHtmlAttribute, escapeHtmlText } from './internal/html-escape.js';
+import { renderPageStructuredData } from './structured-data.renderer.js';
+export function buildBlogPostStructuredDataPayload(opts) {
+    const { frontmatter, canonicalUrl, siteOrigin, siteName, locale } = opts;
+    return {
+        '@type': 'BlogPosting',
+        '@id': `${canonicalUrl}#blog-post`,
+        headline: frontmatter.title,
+        description: frontmatter.summary,
+        datePublished: frontmatter.publishedAt,
+        author: {
+            '@type': 'Person',
+            name: String(frontmatter.authorRef),
+        },
+        publisher: {
+            '@type': 'Organization',
+            name: siteName,
+            url: siteOrigin,
+        },
+        mainEntityOfPage: canonicalUrl,
+        url: canonicalUrl,
+        inLanguage: String(locale),
+        ...(frontmatter.coverImageUrl ? { image: frontmatter.coverImageUrl } : {}),
+        ...(frontmatter.tags.length > 0 ? { keywords: frontmatter.tags.join(', ') } : {}),
+    };
+}
+export function renderBlogPostHeadHtml(opts) {
+    const { siteContext, locale, routePath, frontmatter, noaiOptOut } = opts;
+    const { rootConfig, websiteConfig } = siteContext;
+    const title = frontmatter.title;
+    const description = frontmatter.summary;
+    const ogImageUrl = frontmatter.coverImageUrl;
+    const titleAttr = escapeHtmlAttribute(title);
+    const descriptionAttr = escapeHtmlAttribute(description);
+    const titleText = escapeHtmlText(title);
+    const siteOrigin = websiteConfig.publicOrigin;
+    const defaultLocale = websiteConfig.defaultLocale;
+    const currentLocaleStr = String(locale);
+    /**
+     * Same locale-prefix composition rule as `renderWebsitePageHeadHtml`
+     * — delegated to the shared `buildLocalizedRoutePath` helper so a
+     * future change to the prefix policy lands in ONE place and propagates
+     * consistently to internal links + page heads + blog-post heads.
+     */
+    function buildAbsoluteUrl(forLocale) {
+        const path = buildLocalizedRoutePath({
+            locale: forLocale,
+            defaultLocale,
+            routePath,
+        });
+        return `${siteOrigin}${path}`;
+    }
+    const canonicalUrl = buildAbsoluteUrl(locale);
+    const hreflangLines = [];
+    for (const entry of websiteConfig.locales) {
+        const localeStr = String(entry.locale);
+        hreflangLines.push(`<link rel="alternate" hreflang="${escapeHtmlAttribute(localeStr)}" href="${escapeHtmlAttribute(buildAbsoluteUrl(entry.locale))}" />`);
+    }
+    hreflangLines.push(`<link rel="alternate" hreflang="x-default" href="${escapeHtmlAttribute(buildAbsoluteUrl(defaultLocale))}" />`);
+    const ogImageLines = [];
+    if (ogImageUrl !== undefined) {
+        const ogImageAttr = escapeHtmlAttribute(ogImageUrl);
+        ogImageLines.push(`<meta property="og:image" content="${ogImageAttr}" />`, `<meta name="twitter:image" content="${ogImageAttr}" />`);
+    }
+    const twitterCardKind = ogImageUrl !== undefined ? 'summary_large_image' : 'summary';
+    const ogLocaleAlternateLines = [];
+    for (const entry of websiteConfig.locales) {
+        const localeStr = String(entry.locale);
+        if (localeStr === currentLocaleStr)
+            continue;
+        ogLocaleAlternateLines.push(`<meta property="og:locale:alternate" content="${escapeHtmlAttribute(localeStr)}" />`);
+    }
+    /**
+     * `og:article:*` block — the per-post metadata that distinguishes
+     * the blog-post head from the page head. The Open Graph "article"
+     * vertical defines:
+     *   - `article:published_time` (ISO-8601 — already validated by
+     *     the frontmatter schema's `z.iso.datetime`).
+     *   - `article:author` (free text or URL — we emit the author
+     *     ref as a free-text string; a future author-registry
+     *     resolution would emit the author's profile URL instead).
+     *   - `article:tag` (one tag per emission; the OG spec uses
+     *     repeated `<meta property="article:tag">` lines, NOT a
+     *     comma-joined list).
+     *
+     * `article:section` (the OG "section" field, e.g. "Engineering" /
+     * "Product") is intentionally NOT emitted — Wonder Todos has no
+     * blog-section taxonomy yet, and emitting an empty section would
+     * be worse than omission.
+     */
+    const articleMetaLines = [
+        `<meta property="article:published_time" content="${escapeHtmlAttribute(frontmatter.publishedAt)}" />`,
+        `<meta property="article:author" content="${escapeHtmlAttribute(frontmatter.authorRef)}" />`,
+    ];
+    for (const tag of frontmatter.tags) {
+        articleMetaLines.push(`<meta property="article:tag" content="${escapeHtmlAttribute(tag)}" />`);
+    }
+    const siteNameAttr = escapeHtmlAttribute(rootConfig.seo.siteName);
+    const canonicalAttr = escapeHtmlAttribute(canonicalUrl);
+    const ogLocaleAttr = escapeHtmlAttribute(currentLocaleStr);
+    const noaiMetaLines = [];
+    if (noaiOptOut === true) {
+        noaiMetaLines.push(`<meta name="robots" content="noai, noimageai" />`);
+    }
+    const structuredDataHtml = renderPageStructuredData({
+        pagePayloads: [
+            buildBlogPostStructuredDataPayload({
+                frontmatter,
+                canonicalUrl,
+                siteOrigin,
+                siteName: rootConfig.seo.siteName,
+                locale,
+            }),
+        ],
+    });
+    return [
+        `<title>${titleText}</title>`,
+        `<meta name="description" content="${descriptionAttr}" />`,
+        `<link rel="canonical" href="${canonicalAttr}" />`,
+        `<meta property="og:title" content="${titleAttr}" />`,
+        `<meta property="og:description" content="${descriptionAttr}" />`,
+        `<meta property="og:type" content="article" />`,
+        `<meta property="og:url" content="${canonicalAttr}" />`,
+        `<meta property="og:site_name" content="${siteNameAttr}" />`,
+        `<meta property="og:locale" content="${ogLocaleAttr}" />`,
+        ...ogLocaleAlternateLines,
+        ...ogImageLines,
+        `<meta name="twitter:card" content="${twitterCardKind}" />`,
+        `<meta name="twitter:title" content="${titleAttr}" />`,
+        `<meta name="twitter:description" content="${descriptionAttr}" />`,
+        ...articleMetaLines,
+        ...noaiMetaLines,
+        structuredDataHtml,
+        ...hreflangLines,
+    ].join('\n');
+}
+/** @wildo_source:part:end saas.website.blog.head-renderer */
+//# sourceMappingURL=blog-post-head.renderer.js.map

package/dist/esm/astro/blog-post-head.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post-head.renderer.js","sourceRoot":"","sources":["../../../../src/astro/blog-post-head.renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport { buildLocalizedRoutePath } from '../core/routing/internal-routing.utils';\nimport type { BlogPostFrontmatter } from '../schemas/blog/blog-post-frontmatter.shared.schemas';\nimport type { WebsiteStructuredDataPayload } from '../schemas/structured-data/website-structured-data.shared.schemas';\n\nimport { escapeHtmlAttribute, escapeHtmlText } from './internal/html-escape';\nimport { renderPageStructuredData } from './structured-data.renderer';\nimport type { WebsiteSiteContext } from './website-site-context';\n\n/**\n * @wildo_source:part:start saas.website.blog.head-renderer facet:layer:astro facet:family:website\n *\n * `renderBlogPostHeadHtml(opts)` — sibling of `renderWebsitePageHeadHtml`\n * that emits the SEO `<head>` block for an individual blog post,\n * sourcing per-render copy from a validated `BlogPostFrontmatter`\n * instead of the page manifest's `metaLabelKeys`.\n *\n * # Why a separate renderer (not an overload of the page-head renderer)\n *\n * The framework-mindset rule \"every type / bucket / field must carry\n * its semantic weight\" pushes against overloading\n * `renderWebsitePageHeadHtml` with a \"blog-post mode\" flag:\n *\n *   - The two renderers have STRUCTURALLY different inputs.\n *     `renderWebsitePageHeadHtml` reads `manifest.metaLabelKeys.{titleKey,\n *     descriptionKey, ogImageUrl}` + the matching `labelPack` lookup;\n *     this renderer reads `frontmatter.{title, summary, coverImageUrl,\n *     publishedAt, authorRef, tags}` directly — no label-pack\n *     dependency at all (blog body copy is per-post, not\n *     per-locale-pack, by design).\n *   - The two renderers emit DIFFERENT meta surfaces.\n *     `og:type=website` vs. `og:type=article`; the article variant\n *     additionally emits `article:published_time`,\n *     `article:author`, and `article:tag` (one per `frontmatter.tags`\n *     entry). Folding both into one helper would require an\n *     `articleMeta?: { ... }` discriminated branch that carries no\n *     value when called from a non-blog page — exactly the kind of\n *     \"convenience union\" the framework rules forbid.\n *   - The blog-post route itself uses a parameterized `routePath`\n *     (`/blog/[slug]`) that needs the SLUG substituted at render time\n *     to produce the absolute canonical/hreflang URLs. Page-level\n *     routes are always literal — keeping the substitution in this\n *     renderer (rather than at the manifest layer) means the page\n *     manifest stays free of per-render concerns.\n *\n * Both renderers share the exact same hreflang/canonical/OG locale\n * composition logic — duplicating ~30 lines of stable URL composition\n * is the lesser evil compared to threading a generic options bag\n * through both. If a third renderer ever lands (a \"campaign-page\" or\n * \"tag-page\" head emitter, say), the right move is to extract a\n * shared `composeHreflangAndCanonical(...)` helper at that point;\n * doing it now would be premature against the YAGNI line.\n *\n * # The `routePath` argument\n *\n * The blog-post page manifest's `routePath` is `/blog/[slug]` (Astro\n * route-parameter syntax). At render time the consumer's `[slug].astro`\n * has already resolved the slug, so we accept the FULLY-SUBSTITUTED\n * locale-neutral path (e.g. `/blog/why-context-beats-content`) here.\n * `buildLocalizedRoutePath` then handles the locale-prefix decision,\n * mirroring how `WebsiteInternalLink` and `renderWebsitePageHeadHtml`\n * handle their own routes — the locale-prefix rule never lives in two\n * places.\n *\n * # Failure modes\n *\n * Throws nothing — all required frontmatter fields are guaranteed by\n * `parseBlogPostFrontmatter` upstream (same Zod 4 schema). The\n * optional `coverImageUrl` is the only branch: when absent, the\n * Twitter card kind degrades to `summary` (text-only) and `og:image`\n * is omitted entirely.\n */\n\nexport interface RenderBlogPostHeadHtmlOptions {\n  /**\n   * Composed `WebsiteSiteContext` — the renderer reads\n   * `websiteConfig.{defaultLocale, locales, publicOrigin}` for the\n   * URL/locale surface and `rootConfig.seo.{siteName}` for the\n   * brand fallback. `seo.defaultOgImageUrl` is intentionally NOT\n   * consulted: blog posts that ship without a `coverImageUrl` get a\n   * smaller-card degradation rather than a generic site-wide image\n   * (the default OG image is meaningful for marketing pages but\n   * misleading for blog posts).\n   */\n  siteContext: WebsiteSiteContext;\n  /**\n   * The locale Astro resolved (with default-locale fallback) for the\n   * current request. Drives the `<html lang>` value upstream + the\n   * `og:locale` line and the canonical URL's locale-prefix decision.\n   */\n  locale: AvailableLanguage;\n  /**\n   * The fully-substituted locale-neutral route path for the post —\n   * typically `/blog/<slug>` with `<slug>` already resolved by the\n   * consumer's `[slug].astro` `getStaticPaths()`. Passing the\n   * substituted path (rather than the parameterized one) keeps the\n   * renderer agnostic of the consumer's route-parameter naming.\n   */\n  routePath: string;\n  /**\n   * Validated frontmatter — the result of `parseBlogPostFrontmatter`.\n   * Carrying the parsed (branded) shape here means an unvalidated\n   * `entry.data` cannot reach this renderer accidentally (the\n   * branded-type signature would reject a raw `unknown`).\n   */\n  frontmatter: BlogPostFrontmatter;\n  /**\n   * AI-training opt-out (D-AG3) — when `true`, the renderer emits\n   * `<meta name=\"robots\" content=\"noai, noimageai\">`. The sibling\n   * `_headers` entry is produced by `renderBlogPostNoaiHeaders()`\n   * (one knob, two channels — see the page-head renderer's\n   * companion).\n   *\n   * **Why a renderer-level option, not a frontmatter field**: the\n   * blog-post frontmatter schema (`BlogPostFrontmatterSchema`)\n   * doesn't yet expose a per-post AI-opt-out knob — when it does,\n   * the consumer's `[slug].astro` will read it from the parsed\n   * frontmatter and pass it through here. Keeping the option at\n   * the renderer surface NOW means a third-party blog-post catalog\n   * (campaigns, customer stories) can opt out without authoring a\n   * new frontmatter schema first.\n   */\n  noaiOptOut?: boolean;\n}\n\nexport interface BuildBlogPostStructuredDataPayloadOptions {\n  frontmatter: BlogPostFrontmatter;\n  canonicalUrl: string;\n  siteOrigin: string;\n  siteName: string;\n  locale: AvailableLanguage;\n}\n\nexport function buildBlogPostStructuredDataPayload(\n  opts: BuildBlogPostStructuredDataPayloadOptions,\n): WebsiteStructuredDataPayload {\n  const { frontmatter, canonicalUrl, siteOrigin, siteName, locale } = opts;\n  return {\n    '@type': 'BlogPosting',\n    '@id': `${canonicalUrl}#blog-post`,\n    headline: frontmatter.title,\n    description: frontmatter.summary,\n    datePublished: frontmatter.publishedAt,\n    author: {\n      '@type': 'Person',\n      name: String(frontmatter.authorRef),\n    },\n    publisher: {\n      '@type': 'Organization',\n      name: siteName,\n      url: siteOrigin,\n    },\n    mainEntityOfPage: canonicalUrl,\n    url: canonicalUrl,\n    inLanguage: String(locale),\n    ...(frontmatter.coverImageUrl ? { image: frontmatter.coverImageUrl } : {}),\n    ...(frontmatter.tags.length > 0 ? { keywords: frontmatter.tags.join(', ') } : {}),\n  };\n}\n\nexport function renderBlogPostHeadHtml(opts: RenderBlogPostHeadHtmlOptions): string {\n  const { siteContext, locale, routePath, frontmatter, noaiOptOut } = opts;\n  const { rootConfig, websiteConfig } = siteContext;\n\n  const title = frontmatter.title;\n  const description = frontmatter.summary;\n  const ogImageUrl = frontmatter.coverImageUrl;\n  const titleAttr = escapeHtmlAttribute(title);\n  const descriptionAttr = escapeHtmlAttribute(description);\n  const titleText = escapeHtmlText(title);\n\n  const siteOrigin = websiteConfig.publicOrigin;\n  const defaultLocale = websiteConfig.defaultLocale;\n  const currentLocaleStr = String(locale);\n\n  /**\n   * Same locale-prefix composition rule as `renderWebsitePageHeadHtml`\n   * — delegated to the shared `buildLocalizedRoutePath` helper so a\n   * future change to the prefix policy lands in ONE place and propagates\n   * consistently to internal links + page heads + blog-post heads.\n   */\n  function buildAbsoluteUrl(forLocale: AvailableLanguage): string {\n    const path = buildLocalizedRoutePath({\n      locale: forLocale,\n      defaultLocale,\n      routePath,\n    });\n    return `${siteOrigin}${path}`;\n  }\n\n  const canonicalUrl = buildAbsoluteUrl(locale);\n\n  const hreflangLines: string[] = [];\n  for (const entry of websiteConfig.locales) {\n    const localeStr = String(entry.locale);\n    hreflangLines.push(\n      `<link rel=\"alternate\" hreflang=\"${escapeHtmlAttribute(localeStr)}\" href=\"${escapeHtmlAttribute(buildAbsoluteUrl(entry.locale))}\" />`,\n    );\n  }\n  hreflangLines.push(\n    `<link rel=\"alternate\" hreflang=\"x-default\" href=\"${escapeHtmlAttribute(buildAbsoluteUrl(defaultLocale))}\" />`,\n  );\n\n  const ogImageLines: string[] = [];\n  if (ogImageUrl !== undefined) {\n    const ogImageAttr = escapeHtmlAttribute(ogImageUrl);\n    ogImageLines.push(\n      `<meta property=\"og:image\" content=\"${ogImageAttr}\" />`,\n      `<meta name=\"twitter:image\" content=\"${ogImageAttr}\" />`,\n    );\n  }\n  const twitterCardKind = ogImageUrl !== undefined ? 'summary_large_image' : 'summary';\n\n  const ogLocaleAlternateLines: string[] = [];\n  for (const entry of websiteConfig.locales) {\n    const localeStr = String(entry.locale);\n    if (localeStr === currentLocaleStr) continue;\n    ogLocaleAlternateLines.push(\n      `<meta property=\"og:locale:alternate\" content=\"${escapeHtmlAttribute(localeStr)}\" />`,\n    );\n  }\n\n  /**\n   * `og:article:*` block — the per-post metadata that distinguishes\n   * the blog-post head from the page head. The Open Graph \"article\"\n   * vertical defines:\n   *   - `article:published_time` (ISO-8601 — already validated by\n   *     the frontmatter schema's `z.iso.datetime`).\n   *   - `article:author` (free text or URL — we emit the author\n   *     ref as a free-text string; a future author-registry\n   *     resolution would emit the author's profile URL instead).\n   *   - `article:tag` (one tag per emission; the OG spec uses\n   *     repeated `<meta property=\"article:tag\">` lines, NOT a\n   *     comma-joined list).\n   *\n   * `article:section` (the OG \"section\" field, e.g. \"Engineering\" /\n   * \"Product\") is intentionally NOT emitted — Wonder Todos has no\n   * blog-section taxonomy yet, and emitting an empty section would\n   * be worse than omission.\n   */\n  const articleMetaLines: string[] = [\n    `<meta property=\"article:published_time\" content=\"${escapeHtmlAttribute(frontmatter.publishedAt)}\" />`,\n    `<meta property=\"article:author\" content=\"${escapeHtmlAttribute(frontmatter.authorRef as unknown as string)}\" />`,\n  ];\n  for (const tag of frontmatter.tags) {\n    articleMetaLines.push(\n      `<meta property=\"article:tag\" content=\"${escapeHtmlAttribute(tag as unknown as string)}\" />`,\n    );\n  }\n\n  const siteNameAttr = escapeHtmlAttribute(rootConfig.seo.siteName);\n  const canonicalAttr = escapeHtmlAttribute(canonicalUrl);\n  const ogLocaleAttr = escapeHtmlAttribute(currentLocaleStr);\n  const noaiMetaLines: string[] = [];\n  if (noaiOptOut === true) {\n    noaiMetaLines.push(`<meta name=\"robots\" content=\"noai, noimageai\" />`);\n  }\n\n  const structuredDataHtml = renderPageStructuredData({\n    pagePayloads: [\n      buildBlogPostStructuredDataPayload({\n        frontmatter,\n        canonicalUrl,\n        siteOrigin,\n        siteName: rootConfig.seo.siteName,\n        locale,\n      }),\n    ],\n  });\n\n  return [\n    `<title>${titleText}</title>`,\n    `<meta name=\"description\" content=\"${descriptionAttr}\" />`,\n    `<link rel=\"canonical\" href=\"${canonicalAttr}\" />`,\n    `<meta property=\"og:title\" content=\"${titleAttr}\" />`,\n    `<meta property=\"og:description\" content=\"${descriptionAttr}\" />`,\n    `<meta property=\"og:type\" content=\"article\" />`,\n    `<meta property=\"og:url\" content=\"${canonicalAttr}\" />`,\n    `<meta property=\"og:site_name\" content=\"${siteNameAttr}\" />`,\n    `<meta property=\"og:locale\" content=\"${ogLocaleAttr}\" />`,\n    ...ogLocaleAlternateLines,\n    ...ogImageLines,\n    `<meta name=\"twitter:card\" content=\"${twitterCardKind}\" />`,\n    `<meta name=\"twitter:title\" content=\"${titleAttr}\" />`,\n    `<meta name=\"twitter:description\" content=\"${descriptionAttr}\" />`,\n    ...articleMetaLines,\n    ...noaiMetaLines,\n    structuredDataHtml,\n    ...hreflangLines,\n  ].join('\\n');\n}\n/** @wildo_source:part:end saas.website.blog.head-renderer */\n"]}

package/dist/esm/astro/bridge-runtime.d.ts

@@ -0,0 +1,224 @@
+import type { ComponentType, FunctionComponent } from 'react';
+import type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';
+import type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
+import type { WebsiteDesignTokens } from '../schemas/design-tokens/website-design-tokens.shared.schemas';
+import type { WebsiteLabelKey } from '../schemas/label-keys/website-label-key.schemas';
+import type { WebsiteNavigationConfig } from '../schemas/manifests/website-root-config.shared.schemas';
+import type { WebsitePageRef } from '../schemas/refs/page-ref.schemas';
+import type { LabelPack } from '../schemas/validators/label-pack.validator';
+/**
+ * @wildo_source:part:start saas.website.astro.bridge facet:layer:astro facet:family:website
+ *
+ * `createWebsitePageBridgeIsland(deps)` — factory that returns the
+ * React island a consumer's per-page `.astro` file mounts with a
+ * `client:idle` (or `client:load`) directive.
+ *
+ * **The hard architectural constraint this design solves**: Astro
+ * serializes React-island props via `devalue`-style JSON to transfer
+ * them across the SSR → client-hydration boundary. Function values —
+ * including `ComponentType` references — are NOT serializable. Any
+ * design that tried to pass `pageComponent`, `headerComponent`, or
+ * `footerComponent` AS island props would render correctly server-side
+ * (the function ref is in-process during SSR) and then mismatch on
+ * first hydration (the client receives `undefined`/broken placeholders
+ * for the function-typed fields). The Vitest suite would not catch
+ * this because Vitest renders React in a single process — there is no
+ * serialization boundary in unit tests.
+ *
+ * **The factory pattern fixes the constraint by closing over** the
+ * `pageComponent`, `pageRef`, and `navigation` (header / footer
+ * component refs) at MODULE LOAD TIME on the consumer side. The
+ * returned island accepts only PRIMITIVE-VALUED props (`locale`,
+ * `labelPack`, `designTokens`) — all JSON-serializable, all safe to
+ * cross the hydration boundary. The component refs never appear in
+ * the prop signature; they live in the lexical closure that the
+ * client-side bundle includes naturally as part of the island's
+ * compiled module.
+ *
+ * **Authoring pattern (per-page bridge module)**:
+ *
+ * ```tsx
+ * // consumer's src/pages-impl/landing.bridge.tsx
+ * import { createWebsitePageBridgeIsland } from '@wildo-ai/saas-website/astro-island';
+ * import { LandingPage, LANDING_PAGE_MANIFEST } from './landing.page';
+ * import { WEBSITE_ROOT_CONFIG } from '../website-root.config';
+ *
+ * export const LandingBridgeIsland = createWebsitePageBridgeIsland({
+ *   PageComponent: LandingPage,
+ *   pageRef: LANDING_PAGE_MANIFEST.ref,
+ *   navigation: WEBSITE_ROOT_CONFIG.navigation,
+ * });
+ * ```
+ *
+ * ```astro
+ * ---
+ * // consumer's src/pages/index.astro
+ * import {
+ *   loadWebsitePageRuntime,
+ *   renderWebsitePageHeadHtml,
+ *   renderWebsiteDesignTokensCss,
+ * } from '@wildo-ai/saas-website/astro';
+ * import { LandingBridgeIsland } from '../pages-impl/landing.bridge';
+ * import { LANDING_PAGE_MANIFEST } from '../pages-impl/landing.page';
+ * import { WEBSITE_ROOT_CONFIG } from '../website-root.config';
+ *
+ * const runtime = loadWebsitePageRuntime({
+ *   manifest: LANDING_PAGE_MANIFEST,
+ *   rootConfig: WEBSITE_ROOT_CONFIG,
+ *   labelPacksDir: './src/i18n',
+ *   astroLocale: Astro.currentLocale,
+ * });
+ * const headHtml = renderWebsitePageHeadHtml({
+ *   manifest: LANDING_PAGE_MANIFEST,
+ *   rootConfig: WEBSITE_ROOT_CONFIG,
+ *   locale: runtime.locale,
+ *   labelPack: runtime.labelPack,
+ * });
+ * const designTokensCss = renderWebsiteDesignTokensCss(
+ *   WEBSITE_ROOT_CONFIG.designTokens,
+ * );
+ * ---
+ * <!doctype html>
+ * <html lang={runtime.locale}>
+ *   <head>
+ *     <Fragment set:html={headHtml} />
+ *     <style set:html={designTokensCss}></style>
+ *   </head>
+ *   <body>
+ *     <LandingBridgeIsland
+ *       client:idle
+ *       locale={runtime.locale}
+ *       labelPack={runtime.labelPack}
+ *       designTokens={WEBSITE_ROOT_CONFIG.designTokens}
+ *     />
+ *   </body>
+ * </html>
+ * ```
+ *
+ * **Why a per-page bridge file** (rather than constructing the island
+ * inline in the consumer's `.astro` frontmatter):
+ *
+ * Astro's `client:*` directive requires the JSX tag to reference a
+ * statically-resolvable module export at compile time — that is how
+ * Astro knows which module to bundle for client-side hydration. A
+ * factory call inside `.astro` frontmatter (`const Island =
+ * createWebsitePageBridgeIsland({...}); <Island client:idle/>`) does
+ * NOT round-trip through Astro's module-graph analyzer: Astro would
+ * see a runtime-constructed component reference and fail to bundle
+ * the closure for the client. The per-page bridge file gives Astro a
+ * static export to bind the directive to. The cost is one ~6-line
+ * file per page; the win is the only architecture that is safe
+ * against the H-2 hydration-mismatch failure mode AND uses Astro's
+ * native bundling pipeline.
+ *
+ * **Why `ComponentType` refs in `Deps` and not in `Props`**: this is
+ * the entire point of the redesign. `Deps` is consumed at module load
+ * time on the consumer side — the closure traps the function refs
+ * inside the returned component. `Props` is consumed at island-mount
+ * time and crosses Astro's serialization boundary. Keeping the two
+ * concerns lexically separate makes the boundary visible in the type
+ * signature.
+ *
+ * **Boundary** (D12 client-bundle discipline): this module ships into
+ * the React-island bundle. It MUST stay clear of `node:*` imports,
+ * fs / path helpers, and the SSR-tier specifiers
+ * (`axios`, `jsonwebtoken`, …). The bundle-isolation test catches
+ * regressions both globally (closure-wide allow-list) AND with the
+ * targeted Phase-5 negative test that asserts `node:fs` / `node:path`
+ * reach this island closure ONLY through `astro.ts`, never through
+ * `index.ts` or `companion-exports.ts`.
+ */
+/**
+ * Module-load-time dependencies — closed over inside the returned
+ * island. NEVER cross the hydration boundary as serialized props.
+ */
+export interface CreateWebsitePageBridgeIslandDeps {
+    /**
+     * The page's React component. Typically the same value that was
+     * passed to `defineWebsitePageManifest({ pageComponent })` — the
+     * authoring convention re-imports it here to keep the closure
+     * explicit and the per-page bridge file self-contained.
+     *
+     * Typed as `ComponentType<any>` to mirror
+     * `WebsitePageManifest.pageComponent` and dodge React's `ComponentType`
+     * contravariance: a narrower `ComponentType<TProps>` returned by
+     * `defineWebsitePageManifest<TProps>` would not be assignable to a
+     * `ComponentType<unknown>` slot, blocking every per-page bridge
+     * call site. The component is invoked with no props at the
+     * `<PageComponent />` JSX call site below, so widening here is
+     * runtime-safe.
+     */
+    PageComponent: ComponentType<any>;
+    /**
+     * The active page's ref. Carried as a primitive (string-branded)
+     * value so the inner `WebsitePageLayout` can register the
+     * `WebsitePageContext` without re-resolving it from the manifest.
+     */
+    pageRef: WebsitePageRef;
+    /**
+     * Site-wide navigation slot bindings (header / footer components).
+     * Closed over here rather than passed as island props because both
+     * fields are `ComponentType` refs that cannot survive Astro's
+     * serialization boundary.
+     */
+    navigation: WebsiteNavigationConfig;
+}
+/**
+ * Hydration-boundary props — what the consumer's `.astro` page passes
+ * to `<LandingBridgeIsland client:idle ...{primitiveProps}/>`. Every
+ * field is JSON-serializable.
+ */
+export interface WebsitePageBridgeIslandProps {
+    /** The locale Astro resolved (with default-locale fallback). */
+    locale: AvailableLanguage;
+    /**
+     * The site's default locale. Carried as an island prop (not closed
+     * over in `Deps`) because it is JSON-primitive and consumers
+     * already pass `runtime.locale` from the per-locale Astro page
+     * frontmatter — passing the matching `runtime.defaultLocale` from
+     * the same `loadWebsitePageRuntime(...)` return value keeps the
+     * authoring story symmetric. Required for `WebsiteInternalLink`
+     * (Phase 6 fix H-β) which needs both locales to compute the
+     * correct prefix.
+     */
+    defaultLocale: AvailableLanguage;
+    /** Already-loaded + already-shape-validated label pack. */
+    labelPack: LabelPack;
+    /** Design-token bundle from `WebsiteRootConfig.designTokens`. */
+    designTokens: WebsiteDesignTokens;
+    /**
+     * Fully-composed label key the framework reads to render the
+     * "Skip to main content" affordance (Phase 6 third audit fix M-α).
+     * Mirrors `WebsiteRootConfig.skipToMainContentLabelKey`. Carried as
+     * a JSON-serializable string prop (NOT closed over in `Deps`)
+     * because it is a primitive value the consumer already has on the
+     * root config in the `.astro` frontmatter — passing it as an island
+     * prop keeps the per-page bridge module dependency-free of the
+     * site root config (the bridge stays page-local; only the per-page
+     * `.astro` page knows about `WEBSITE_ROOT_CONFIG`).
+     */
+    skipToMainContentLabelKey: WebsiteLabelKey;
+    /** Optional website-facing public providers materialized at build time. */
+    frontendProviders?: FrontendProvidersBlock;
+    /**
+     * Optional backend API origin (no trailing slash) forwarded into
+     * `WebsiteRuntimeContext.apiOrigin` for anonymous-capture sections
+     * (lead / draft-note forms) to construct their
+     * `WebsiteAnonymousSessionClient`. A JSON-serializable string, so it
+     * crosses the hydration boundary as an island prop; the `.astro` page
+     * resolves the per-environment value from
+     * `WildoMarketingWebsiteConfig.apiOrigin`. Omitted on pages with no
+     * capture section.
+     */
+    apiOrigin?: string;
+}
+/**
+ * Returns a FUNCTION component, not the wider `ComponentType` union. The island IS a function
+ * component — Astro hydrates nothing else here — and the union is not callable, so the wider
+ * declaration cost callers the ability to invoke the island directly. Mirrors
+ * `createWebsiteBlogPostBridgeIsland`, whose suite depends on that call. `FunctionComponent` is
+ * assignable to `ComponentType`, so no consumer narrows.
+ */
+export declare function createWebsitePageBridgeIsland(deps: CreateWebsitePageBridgeIslandDeps): FunctionComponent<WebsitePageBridgeIslandProps>;
+/** @wildo_source:part:end saas.website.astro.bridge */
+//# sourceMappingURL=bridge-runtime.d.ts.map

package/dist/esm/astro/bridge-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-runtime.d.ts","sourceRoot":"","sources":["../../../../src/astro/bridge-runtime.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAC;AAEzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAQ9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAC;AACzG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyHG;AAEH;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;;;;;;;;;;;OAcG;IACH,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC;;;;OAIG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;;;;OAKG;IACH,UAAU,EAAE,uBAAuB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,gEAAgE;IAChE,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;;;;OASG;IACH,aAAa,EAAE,iBAAiB,CAAC;IACjC,2DAA2D;IAC3D,SAAS,EAAE,SAAS,CAAC;IACrB,iEAAiE;IACjE,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;;;;;;OAUG;IACH,yBAAyB,EAAE,eAAe,CAAC;IAC3C,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,iCAAiC,GACtC,iBAAiB,CAAC,4BAA4B,CAAC,CAiCjD;AACD,uDAAuD"}

package/dist/esm/astro/bridge-runtime.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { WebsiteRuntimeContextProvider, } from '../core/contexts/WebsiteRuntimeContext.js';
+import { createFrontendWebsiteProviderRegistry } from '../core/external-providers/frontend-provider-registry.website.js';
+import { WebsitePageLayout } from '../core/layouts/WebsitePageLayout.js';
+/**
+ * Returns a FUNCTION component, not the wider `ComponentType` union. The island IS a function
+ * component — Astro hydrates nothing else here — and the union is not callable, so the wider
+ * declaration cost callers the ability to invoke the island directly. Mirrors
+ * `createWebsiteBlogPostBridgeIsland`, whose suite depends on that call. `FunctionComponent` is
+ * assignable to `ComponentType`, so no consumer narrows.
+ */
+export function createWebsitePageBridgeIsland(deps) {
+    const { PageComponent, pageRef, navigation } = deps;
+    function WebsitePageBridgeIsland({ locale, defaultLocale, labelPack, designTokens, skipToMainContentLabelKey, frontendProviders, apiOrigin, }) {
+        const runtimeValue = {
+            locale,
+            defaultLocale,
+            labelPack,
+            designTokens,
+            navigation,
+            skipToMainContentLabelKey,
+            frontendProviderRegistry: createFrontendWebsiteProviderRegistry(frontendProviders),
+            apiOrigin,
+        };
+        return (_jsx(WebsiteRuntimeContextProvider, { value: runtimeValue, children: _jsx(WebsitePageLayout, { pageRef: pageRef, children: _jsx(PageComponent, {}) }) }));
+    }
+    WebsitePageBridgeIsland.displayName = 'WebsitePageBridgeIsland';
+    return WebsitePageBridgeIsland;
+}
+//# sourceMappingURL=bridge-runtime.js.map

package/dist/esm/astro/bridge-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-runtime.js","sourceRoot":"","sources":["../../../../src/astro/bridge-runtime.tsx"],"names":[],"mappings":";AAKA,OAAO,EACL,6BAA6B,GAE9B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,qCAAqC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAwNtE;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAuC;IAEvC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEpD,SAAS,uBAAuB,CAAC,EAC/B,MAAM,EACN,aAAa,EACb,SAAS,EACT,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,EACjB,SAAS,GACoB;QAC7B,MAAM,YAAY,GAA+B;YAC/C,MAAM;YACN,aAAa;YACb,SAAS;YACT,YAAY;YACZ,UAAU;YACV,yBAAyB;YACzB,wBAAwB,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;YAClF,SAAS;SACV,CAAC;QACF,OAAO,CACL,KAAC,6BAA6B,IAAC,KAAK,EAAE,YAAY,YAChD,KAAC,iBAAiB,IAAC,OAAO,EAAE,OAAO,YACjC,KAAC,aAAa,KAAG,GACC,GACU,CACjC,CAAC;IACJ,CAAC;IACD,uBAAuB,CAAC,WAAW,GAAG,yBAAyB,CAAC;IAEhE,OAAO,uBAAuB,CAAC;AACjC,CAAC","sourcesContent":["import type { ComponentType, FunctionComponent, ReactNode } from 'react';\n\nimport type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';\nimport type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport {\n  WebsiteRuntimeContextProvider,\n  type WebsiteRuntimeContextValue,\n} from '../core/contexts/WebsiteRuntimeContext';\nimport { createFrontendWebsiteProviderRegistry } from '../core/external-providers/frontend-provider-registry.website';\nimport { WebsitePageLayout } from '../core/layouts/WebsitePageLayout';\nimport type { WebsiteDesignTokens } from '../schemas/design-tokens/website-design-tokens.shared.schemas';\nimport type { WebsiteLabelKey } from '../schemas/label-keys/website-label-key.schemas';\nimport type { WebsiteNavigationConfig } from '../schemas/manifests/website-root-config.shared.schemas';\nimport type { WebsitePageRef } from '../schemas/refs/page-ref.schemas';\nimport type { LabelPack } from '../schemas/validators/label-pack.validator';\n\n/**\n * @wildo_source:part:start saas.website.astro.bridge facet:layer:astro facet:family:website\n *\n * `createWebsitePageBridgeIsland(deps)` — factory that returns the\n * React island a consumer's per-page `.astro` file mounts with a\n * `client:idle` (or `client:load`) directive.\n *\n * **The hard architectural constraint this design solves**: Astro\n * serializes React-island props via `devalue`-style JSON to transfer\n * them across the SSR → client-hydration boundary. Function values —\n * including `ComponentType` references — are NOT serializable. Any\n * design that tried to pass `pageComponent`, `headerComponent`, or\n * `footerComponent` AS island props would render correctly server-side\n * (the function ref is in-process during SSR) and then mismatch on\n * first hydration (the client receives `undefined`/broken placeholders\n * for the function-typed fields). The Vitest suite would not catch\n * this because Vitest renders React in a single process — there is no\n * serialization boundary in unit tests.\n *\n * **The factory pattern fixes the constraint by closing over** the\n * `pageComponent`, `pageRef`, and `navigation` (header / footer\n * component refs) at MODULE LOAD TIME on the consumer side. The\n * returned island accepts only PRIMITIVE-VALUED props (`locale`,\n * `labelPack`, `designTokens`) — all JSON-serializable, all safe to\n * cross the hydration boundary. The component refs never appear in\n * the prop signature; they live in the lexical closure that the\n * client-side bundle includes naturally as part of the island's\n * compiled module.\n *\n * **Authoring pattern (per-page bridge module)**:\n *\n * ```tsx\n * // consumer's src/pages-impl/landing.bridge.tsx\n * import { createWebsitePageBridgeIsland } from '@wildo-ai/saas-website/astro-island';\n * import { LandingPage, LANDING_PAGE_MANIFEST } from './landing.page';\n * import { WEBSITE_ROOT_CONFIG } from '../website-root.config';\n *\n * export const LandingBridgeIsland = createWebsitePageBridgeIsland({\n *   PageComponent: LandingPage,\n *   pageRef: LANDING_PAGE_MANIFEST.ref,\n *   navigation: WEBSITE_ROOT_CONFIG.navigation,\n * });\n * ```\n *\n * ```astro\n * ---\n * // consumer's src/pages/index.astro\n * import {\n *   loadWebsitePageRuntime,\n *   renderWebsitePageHeadHtml,\n *   renderWebsiteDesignTokensCss,\n * } from '@wildo-ai/saas-website/astro';\n * import { LandingBridgeIsland } from '../pages-impl/landing.bridge';\n * import { LANDING_PAGE_MANIFEST } from '../pages-impl/landing.page';\n * import { WEBSITE_ROOT_CONFIG } from '../website-root.config';\n *\n * const runtime = loadWebsitePageRuntime({\n *   manifest: LANDING_PAGE_MANIFEST,\n *   rootConfig: WEBSITE_ROOT_CONFIG,\n *   labelPacksDir: './src/i18n',\n *   astroLocale: Astro.currentLocale,\n * });\n * const headHtml = renderWebsitePageHeadHtml({\n *   manifest: LANDING_PAGE_MANIFEST,\n *   rootConfig: WEBSITE_ROOT_CONFIG,\n *   locale: runtime.locale,\n *   labelPack: runtime.labelPack,\n * });\n * const designTokensCss = renderWebsiteDesignTokensCss(\n *   WEBSITE_ROOT_CONFIG.designTokens,\n * );\n * ---\n * <!doctype html>\n * <html lang={runtime.locale}>\n *   <head>\n *     <Fragment set:html={headHtml} />\n *     <style set:html={designTokensCss}></style>\n *   </head>\n *   <body>\n *     <LandingBridgeIsland\n *       client:idle\n *       locale={runtime.locale}\n *       labelPack={runtime.labelPack}\n *       designTokens={WEBSITE_ROOT_CONFIG.designTokens}\n *     />\n *   </body>\n * </html>\n * ```\n *\n * **Why a per-page bridge file** (rather than constructing the island\n * inline in the consumer's `.astro` frontmatter):\n *\n * Astro's `client:*` directive requires the JSX tag to reference a\n * statically-resolvable module export at compile time — that is how\n * Astro knows which module to bundle for client-side hydration. A\n * factory call inside `.astro` frontmatter (`const Island =\n * createWebsitePageBridgeIsland({...}); <Island client:idle/>`) does\n * NOT round-trip through Astro's module-graph analyzer: Astro would\n * see a runtime-constructed component reference and fail to bundle\n * the closure for the client. The per-page bridge file gives Astro a\n * static export to bind the directive to. The cost is one ~6-line\n * file per page; the win is the only architecture that is safe\n * against the H-2 hydration-mismatch failure mode AND uses Astro's\n * native bundling pipeline.\n *\n * **Why `ComponentType` refs in `Deps` and not in `Props`**: this is\n * the entire point of the redesign. `Deps` is consumed at module load\n * time on the consumer side — the closure traps the function refs\n * inside the returned component. `Props` is consumed at island-mount\n * time and crosses Astro's serialization boundary. Keeping the two\n * concerns lexically separate makes the boundary visible in the type\n * signature.\n *\n * **Boundary** (D12 client-bundle discipline): this module ships into\n * the React-island bundle. It MUST stay clear of `node:*` imports,\n * fs / path helpers, and the SSR-tier specifiers\n * (`axios`, `jsonwebtoken`, …). The bundle-isolation test catches\n * regressions both globally (closure-wide allow-list) AND with the\n * targeted Phase-5 negative test that asserts `node:fs` / `node:path`\n * reach this island closure ONLY through `astro.ts`, never through\n * `index.ts` or `companion-exports.ts`.\n */\n\n/**\n * Module-load-time dependencies — closed over inside the returned\n * island. NEVER cross the hydration boundary as serialized props.\n */\nexport interface CreateWebsitePageBridgeIslandDeps {\n  /**\n   * The page's React component. Typically the same value that was\n   * passed to `defineWebsitePageManifest({ pageComponent })` — the\n   * authoring convention re-imports it here to keep the closure\n   * explicit and the per-page bridge file self-contained.\n   *\n   * Typed as `ComponentType<any>` to mirror\n   * `WebsitePageManifest.pageComponent` and dodge React's `ComponentType`\n   * contravariance: a narrower `ComponentType<TProps>` returned by\n   * `defineWebsitePageManifest<TProps>` would not be assignable to a\n   * `ComponentType<unknown>` slot, blocking every per-page bridge\n   * call site. The component is invoked with no props at the\n   * `<PageComponent />` JSX call site below, so widening here is\n   * runtime-safe.\n   */\n  PageComponent: ComponentType<any>;\n  /**\n   * The active page's ref. Carried as a primitive (string-branded)\n   * value so the inner `WebsitePageLayout` can register the\n   * `WebsitePageContext` without re-resolving it from the manifest.\n   */\n  pageRef: WebsitePageRef;\n  /**\n   * Site-wide navigation slot bindings (header / footer components).\n   * Closed over here rather than passed as island props because both\n   * fields are `ComponentType` refs that cannot survive Astro's\n   * serialization boundary.\n   */\n  navigation: WebsiteNavigationConfig;\n}\n\n/**\n * Hydration-boundary props — what the consumer's `.astro` page passes\n * to `<LandingBridgeIsland client:idle ...{primitiveProps}/>`. Every\n * field is JSON-serializable.\n */\nexport interface WebsitePageBridgeIslandProps {\n  /** The locale Astro resolved (with default-locale fallback). */\n  locale: AvailableLanguage;\n  /**\n   * The site's default locale. Carried as an island prop (not closed\n   * over in `Deps`) because it is JSON-primitive and consumers\n   * already pass `runtime.locale` from the per-locale Astro page\n   * frontmatter — passing the matching `runtime.defaultLocale` from\n   * the same `loadWebsitePageRuntime(...)` return value keeps the\n   * authoring story symmetric. Required for `WebsiteInternalLink`\n   * (Phase 6 fix H-β) which needs both locales to compute the\n   * correct prefix.\n   */\n  defaultLocale: AvailableLanguage;\n  /** Already-loaded + already-shape-validated label pack. */\n  labelPack: LabelPack;\n  /** Design-token bundle from `WebsiteRootConfig.designTokens`. */\n  designTokens: WebsiteDesignTokens;\n  /**\n   * Fully-composed label key the framework reads to render the\n   * \"Skip to main content\" affordance (Phase 6 third audit fix M-α).\n   * Mirrors `WebsiteRootConfig.skipToMainContentLabelKey`. Carried as\n   * a JSON-serializable string prop (NOT closed over in `Deps`)\n   * because it is a primitive value the consumer already has on the\n   * root config in the `.astro` frontmatter — passing it as an island\n   * prop keeps the per-page bridge module dependency-free of the\n   * site root config (the bridge stays page-local; only the per-page\n   * `.astro` page knows about `WEBSITE_ROOT_CONFIG`).\n   */\n  skipToMainContentLabelKey: WebsiteLabelKey;\n  /** Optional website-facing public providers materialized at build time. */\n  frontendProviders?: FrontendProvidersBlock;\n  /**\n   * Optional backend API origin (no trailing slash) forwarded into\n   * `WebsiteRuntimeContext.apiOrigin` for anonymous-capture sections\n   * (lead / draft-note forms) to construct their\n   * `WebsiteAnonymousSessionClient`. A JSON-serializable string, so it\n   * crosses the hydration boundary as an island prop; the `.astro` page\n   * resolves the per-environment value from\n   * `WildoMarketingWebsiteConfig.apiOrigin`. Omitted on pages with no\n   * capture section.\n   */\n  apiOrigin?: string;\n}\n\n/**\n * Returns a FUNCTION component, not the wider `ComponentType` union. The island IS a function\n * component — Astro hydrates nothing else here — and the union is not callable, so the wider\n * declaration cost callers the ability to invoke the island directly. Mirrors\n * `createWebsiteBlogPostBridgeIsland`, whose suite depends on that call. `FunctionComponent` is\n * assignable to `ComponentType`, so no consumer narrows.\n */\nexport function createWebsitePageBridgeIsland(\n  deps: CreateWebsitePageBridgeIslandDeps,\n): FunctionComponent<WebsitePageBridgeIslandProps> {\n  const { PageComponent, pageRef, navigation } = deps;\n\n  function WebsitePageBridgeIsland({\n    locale,\n    defaultLocale,\n    labelPack,\n    designTokens,\n    skipToMainContentLabelKey,\n    frontendProviders,\n    apiOrigin,\n  }: WebsitePageBridgeIslandProps): ReactNode {\n    const runtimeValue: WebsiteRuntimeContextValue = {\n      locale,\n      defaultLocale,\n      labelPack,\n      designTokens,\n      navigation,\n      skipToMainContentLabelKey,\n      frontendProviderRegistry: createFrontendWebsiteProviderRegistry(frontendProviders),\n      apiOrigin,\n    };\n    return (\n      <WebsiteRuntimeContextProvider value={runtimeValue}>\n        <WebsitePageLayout pageRef={pageRef}>\n          <PageComponent />\n        </WebsitePageLayout>\n      </WebsiteRuntimeContextProvider>\n    );\n  }\n  WebsitePageBridgeIsland.displayName = 'WebsitePageBridgeIsland';\n\n  return WebsitePageBridgeIsland;\n}\n/** @wildo_source:part:end saas.website.astro.bridge */\n"]}

package/dist/esm/astro/collect-expected-label-keys.d.ts

@@ -0,0 +1,65 @@
+import type { WebsiteSectionDefinition } from '../schemas/sections/website-section-definition.shared.schemas';
+import type { ExpectedLabelKeysBySectionRef } from '../schemas/validators/label-pack.validator';
+/**
+ * @wildo_source:part:start saas.website.astro.label-key-collector facet:layer:astro facet:family:website
+ *
+ * `collectExpectedLabelKeysFromSections(sections)` — pure, no-I/O
+ * collector that materializes the
+ * `ExpectedLabelKeysBySectionRef` map the label-pack validator
+ * (`validateLabelPackAgainstManifest`) consumes.
+ *
+ * **Why an explicit-list collector and not a JSX walker**
+ * (Phase 5 plan originally proposed walking each manifest's
+ * `pageComponent` to discover its `defineWebsiteSection` calls —
+ * we deliberately rejected that approach):
+ *
+ *   - **No runtime React introspection.** A JSX walker would either
+ *     (a) require booting React + a virtual DOM at build time just to
+ *     render every page once and observe its section composition, or
+ *     (b) require static AST analysis of the `pageComponent` source
+ *     file to discover `<HeroSection/>`-style imports. Both add a
+ *     non-trivial dependency surface (jsdom or a TS AST walker) and
+ *     both fail silently on dynamic composition (a section rendered
+ *     conditionally by a feature flag is invisible to the static
+ *     walker but visible to the renderer, and vice versa).
+ *   - **The consumer already has the list.** Each page-impl module
+ *     already imports its sections (that's how JSX renders them);
+ *     `WebsiteRootConfig` already lists every page manifest; the
+ *     consumer's `website-root.config.ts` is therefore one line away
+ *     from also exporting a flat `[HeroSection, PricingSection, …]`
+ *     array. Asking for that array trades a frame of build-time magic
+ *     for a single hand-authored line and turns "did the build see
+ *     this section?" into a TypeScript-checked import — a far better
+ *     trade than a JSX walker.
+ *   - **Section reuse across pages is naturally handled.** Two pages
+ *     reusing the same `HeroSection` definition (with the same
+ *     `sectionRef`) collide silently in a JSX walker (which would
+ *     register the section twice with identical expected keys).
+ *     Here, the array deduplicates per `sectionRef` (a same-ref
+ *     duplicate with NON-matching `expectedLabelKeys` is a hard
+ *     authoring bug — see refinement below).
+ *
+ * **Refinement — duplicate `sectionRef` with non-matching keys**:
+ * if the same `sectionRef` appears twice with different
+ * `expectedLabelKeys`, the collector throws. This catches the
+ * "two distinct sections accidentally using the same ref" bug
+ * (typically a copy-paste during section authoring) at build time
+ * with an actionable message rather than letting the second
+ * `Map.set` silently overwrite the first.
+ *
+ * **Pure / no I/O**: the collector is invoked at build start by
+ * the Astro adapter and at audit time by `wildo website audit`;
+ * it does not read files and does not boot React.
+ *
+ * @param sections Every `WebsiteSectionDefinition` registered on the
+ *                 site. Order does not matter — the result is an
+ *                 unordered map keyed by `sectionRef`.
+ * @returns A `Map<WebsiteSectionRef, readonly WebsiteLabelKey[]>`
+ *          ready to feed into `validateLabelPackAgainstManifest`.
+ * @throws  When two distinct sections share a `sectionRef` but
+ *          declare different `expectedLabelKeys` arrays (length or
+ *          membership) — the collector's hard-error path.
+ */
+export declare function collectExpectedLabelKeysFromSections(sections: readonly WebsiteSectionDefinition[]): ExpectedLabelKeysBySectionRef;
+/** @wildo_source:part:end saas.website.astro.label-key-collector */
+//# sourceMappingURL=collect-expected-label-keys.d.ts.map

package/dist/esm/astro/collect-expected-label-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-expected-label-keys.d.ts","sourceRoot":"","sources":["../../../../src/astro/collect-expected-label-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+DAA+D,CAAC;AAG9G,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4CAA4C,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,6BAA6B,CAsB/B;AAuBD,oEAAoE"}

package/dist/esm/astro/collect-expected-label-keys.js

@@ -0,0 +1,101 @@
+/**
+ * @wildo_source:part:start saas.website.astro.label-key-collector facet:layer:astro facet:family:website
+ *
+ * `collectExpectedLabelKeysFromSections(sections)` — pure, no-I/O
+ * collector that materializes the
+ * `ExpectedLabelKeysBySectionRef` map the label-pack validator
+ * (`validateLabelPackAgainstManifest`) consumes.
+ *
+ * **Why an explicit-list collector and not a JSX walker**
+ * (Phase 5 plan originally proposed walking each manifest's
+ * `pageComponent` to discover its `defineWebsiteSection` calls —
+ * we deliberately rejected that approach):
+ *
+ *   - **No runtime React introspection.** A JSX walker would either
+ *     (a) require booting React + a virtual DOM at build time just to
+ *     render every page once and observe its section composition, or
+ *     (b) require static AST analysis of the `pageComponent` source
+ *     file to discover `<HeroSection/>`-style imports. Both add a
+ *     non-trivial dependency surface (jsdom or a TS AST walker) and
+ *     both fail silently on dynamic composition (a section rendered
+ *     conditionally by a feature flag is invisible to the static
+ *     walker but visible to the renderer, and vice versa).
+ *   - **The consumer already has the list.** Each page-impl module
+ *     already imports its sections (that's how JSX renders them);
+ *     `WebsiteRootConfig` already lists every page manifest; the
+ *     consumer's `website-root.config.ts` is therefore one line away
+ *     from also exporting a flat `[HeroSection, PricingSection, …]`
+ *     array. Asking for that array trades a frame of build-time magic
+ *     for a single hand-authored line and turns "did the build see
+ *     this section?" into a TypeScript-checked import — a far better
+ *     trade than a JSX walker.
+ *   - **Section reuse across pages is naturally handled.** Two pages
+ *     reusing the same `HeroSection` definition (with the same
+ *     `sectionRef`) collide silently in a JSX walker (which would
+ *     register the section twice with identical expected keys).
+ *     Here, the array deduplicates per `sectionRef` (a same-ref
+ *     duplicate with NON-matching `expectedLabelKeys` is a hard
+ *     authoring bug — see refinement below).
+ *
+ * **Refinement — duplicate `sectionRef` with non-matching keys**:
+ * if the same `sectionRef` appears twice with different
+ * `expectedLabelKeys`, the collector throws. This catches the
+ * "two distinct sections accidentally using the same ref" bug
+ * (typically a copy-paste during section authoring) at build time
+ * with an actionable message rather than letting the second
+ * `Map.set` silently overwrite the first.
+ *
+ * **Pure / no I/O**: the collector is invoked at build start by
+ * the Astro adapter and at audit time by `wildo website audit`;
+ * it does not read files and does not boot React.
+ *
+ * @param sections Every `WebsiteSectionDefinition` registered on the
+ *                 site. Order does not matter — the result is an
+ *                 unordered map keyed by `sectionRef`.
+ * @returns A `Map<WebsiteSectionRef, readonly WebsiteLabelKey[]>`
+ *          ready to feed into `validateLabelPackAgainstManifest`.
+ * @throws  When two distinct sections share a `sectionRef` but
+ *          declare different `expectedLabelKeys` arrays (length or
+ *          membership) — the collector's hard-error path.
+ */
+export function collectExpectedLabelKeysFromSections(sections) {
+    const map = new Map();
+    for (const section of sections) {
+        const existing = map.get(section.sectionRef);
+        if (existing === undefined) {
+            map.set(section.sectionRef, section.expectedLabelKeys);
+            continue;
+        }
+        if (!areLabelKeyArraysEqual(existing, section.expectedLabelKeys)) {
+            throw new Error(`[collectExpectedLabelKeysFromSections] Duplicate sectionRef ` +
+                `"${section.sectionRef}" registered with ` +
+                `non-matching expectedLabelKeys. ` +
+                `First registration: [${existing.join(', ')}]. ` +
+                `Second registration: [${section.expectedLabelKeys.join(', ')}]. ` +
+                `Either rename one section's sectionRef or align both expectedLabelKeys arrays.`);
+        }
+    }
+    return map;
+}
+/**
+ * Order-insensitive equality for two `readonly WebsiteLabelKey[]`.
+ * Used by the collector to validate that a duplicate-ref registration
+ * is intentional (same keys) vs. a copy-paste bug (different keys).
+ *
+ * Quadratic in the array length, but `expectedLabelKeys` is bounded by
+ * the number of slots a single section consumes (typically <20), so
+ * the cost is negligible compared to surface readability of the
+ * comparison.
+ */
+function areLabelKeyArraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const aSet = new Set(a);
+    for (const key of b) {
+        if (!aSet.has(key))
+            return false;
+    }
+    return true;
+}
+/** @wildo_source:part:end saas.website.astro.label-key-collector */
+//# sourceMappingURL=collect-expected-label-keys.js.map