@wildo-ai/saas-website 1.1.1

package/dist/esm/astro/structured-data.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-data.renderer.js","sourceRoot":"","sources":["../../../../src/astro/structured-data.renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  WebsiteStructuredDataPayload,\n  WebsiteStructuredDataReturn,\n} from '../schemas/structured-data/website-structured-data.shared.schemas';\nimport type { WebsiteSectionDefinition } from '../schemas/sections/website-section-definition.shared.schemas';\n\n/**\n * @wildo_source:part:start saas.website.astro.structured-data-renderer facet:layer:astro facet:family:website\n *\n * `renderPageStructuredData()` — collects every section's\n * `getStructuredData()` return + any explicit page-level payloads,\n * normalizes them, dedupes by `@id`, and emits one\n * `<script type=\"application/ld+json\">` block per surviving payload.\n *\n * **Why one `<script>` per payload (NOT a single `@graph` array)**:\n *\n * - Google's structured-data testing tool, Bing webmaster tools, and\n *   the Schema.org reference parser all accept multiple sibling\n *   `<script type=\"application/ld+json\">` blocks. Emitting them as\n *   separate blocks lets each payload be diff-friendly in the\n *   page source AND lets per-payload removal happen on a future\n *   AEO opt-out without churning the whole graph.\n * - `@graph` is technically valid but harder to author — every\n *   payload would need to share `@context` with the wrapper, and\n *   per-section authors would have to coordinate to merge their\n *   payloads into one shared graph. The \"one script per payload\"\n *   pattern keeps section authoring fully local.\n *\n * **Why dedupe by `@id` (last-wins)**: a page may have a section\n * emit a `Product` payload AND another section emit a `Review`\n * referencing the same `Product` via `@id`. Without dedupe, the\n * `Product` would emit twice (once standalone, once referenced).\n * Last-wins because the section's own emission is closer to the\n * truth than a reference; the dedupe is best-effort and harmless\n * if `@id` is absent (the payload always emits).\n *\n * **`@context` injection**: when a payload omits `@context`, the\n * renderer injects `'https://schema.org'`. Consumers wanting a\n * custom vocabulary supply `@context` themselves and the renderer\n * passes it through unchanged.\n *\n * **HTML-safe serialization**: JSON-LD payloads are serialized via\n * `JSON.stringify` with the closing `</` escaped to `<\\/` (and the\n * `<!` opener escaped to `<\\!`) to prevent the payload from\n * accidentally closing the surrounding `<script>` tag if the\n * payload contains the string `</script>` (e.g. a blog post about\n * structured data). This is the canonical safe-serialization\n * pattern (see https://html.spec.whatwg.org/#restrictions-for-contents-of-script-elements).\n */\n\nconst SCHEMA_ORG_DEFAULT_CONTEXT = 'https://schema.org' as const;\n\nexport interface RenderPageStructuredDataOptions {\n  /**\n   * Section definitions whose `getStructuredData()` (when present)\n   * contributes payloads to the page. Sections without\n   * `getStructuredData` are skipped silently.\n   */\n  sections?: readonly Pick<WebsiteSectionDefinition, 'sectionRef' | 'getStructuredData'>[];\n  /**\n   * Optional page-level payloads contributed by the page-shell\n   * itself (typical: `BreadcrumbList`, `Organization`, `WebSite`).\n   * Composed AFTER section payloads in the emission order so a\n   * section's `@id`-keyed payload wins over a page-level one with\n   * the same `@id` (last-wins; see preamble).\n   */\n  pagePayloads?: readonly WebsiteStructuredDataPayload[];\n}\n\nexport function renderPageStructuredData(opts: RenderPageStructuredDataOptions): string {\n  const collected: WebsiteStructuredDataPayload[] = [];\n\n  if (opts.sections) {\n    for (const section of opts.sections) {\n      if (!section.getStructuredData) continue;\n      const value: WebsiteStructuredDataReturn = section.getStructuredData();\n      collectInto(collected, value);\n    }\n  }\n\n  if (opts.pagePayloads) {\n    for (const payload of opts.pagePayloads) {\n      collected.push(payload);\n    }\n  }\n\n  if (collected.length === 0) return '';\n\n  /**\n   * Dedupe by `@id` (last-wins). Payloads without `@id` always\n   * survive. We walk LAST-to-FIRST so the LAST occurrence of an\n   * `@id` is the kept one (later writes overwrite earlier ones\n   * naturally with this loop direction + reverse at the end).\n   */\n  const seen = new Set<string>();\n  const deduped: WebsiteStructuredDataPayload[] = [];\n  for (let i = collected.length - 1; i >= 0; i -= 1) {\n    const payload = collected[i];\n    if (payload === undefined) continue;\n    const id = payload['@id'];\n    if (typeof id === 'string') {\n      if (seen.has(id)) continue;\n      seen.add(id);\n    }\n    deduped.push(payload);\n  }\n  deduped.reverse();\n\n  const lines: string[] = [];\n  for (const payload of deduped) {\n    const withContext: Record<string, unknown> =\n      payload['@context'] === undefined\n        ? { '@context': SCHEMA_ORG_DEFAULT_CONTEXT, ...payload }\n        : { ...payload };\n    const json = serializeForScriptTag(withContext);\n    lines.push(`<script type=\"application/ld+json\">${json}</script>`);\n  }\n  return lines.join('\\n');\n}\n\n/**\n * Normalize a `getStructuredData()` return value into a flat array\n * the renderer iterates. Handles the four legal shapes\n * (`null` / `undefined` / single payload / readonly array).\n *\n * Mutates the `into` array in place — the function is private to\n * this module and the in-place mutation avoids one allocation per\n * section (sections compose linearly, the cost adds up on long\n * pages).\n */\nfunction collectInto(\n  into: WebsiteStructuredDataPayload[],\n  value: WebsiteStructuredDataReturn,\n): void {\n  if (value === null || value === undefined) return;\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      if (item !== null && item !== undefined) into.push(item);\n    }\n    return;\n  }\n  /**\n   * Single-payload shape — narrow the readonly-array branch above\n   * by elimination. `Array.isArray` returns `false` for readonly\n   * arrays in some TS configs but TRUE at runtime; this branch\n   * runs only for non-array `WebsiteStructuredDataPayload`.\n   */\n  into.push(value as WebsiteStructuredDataPayload);\n}\n\n/**\n * Serialize a payload for emission inside a `<script>` tag.\n *\n * `JSON.stringify` alone is NOT safe inside `<script>` tags:\n *\n *   - A payload field containing the literal string `</script>`\n *     (rare but possible on a blog post about HTML / structured\n *     data) would close the script tag prematurely and inject the\n *     remainder as page HTML.\n *   - A payload field containing `<!--` similarly opens an HTML\n *     comment that breaks the surrounding parsing context.\n *\n * Both are mitigated by escaping `<` to `\\u003c` inside the JSON\n * payload — the JSON parser treats `\\u003c` as identical to `<`,\n * so the consumed payload is unchanged, but the HTML parser sees\n * no `<` characters and never gets confused.\n */\nfunction serializeForScriptTag(payload: Record<string, unknown>): string {\n  return JSON.stringify(payload).replace(/</g, '\\\\u003c');\n}\n/** @wildo_source:part:end saas.website.astro.structured-data-renderer */\n"]}

package/dist/esm/astro/website-page-head.renderer.d.ts

@@ -0,0 +1,93 @@
+import type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
+import type { WebsiteDesignTokens } from '../schemas/design-tokens/website-design-tokens.shared.schemas';
+import type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';
+import type { LabelPack } from '../schemas/validators/label-pack.validator';
+import type { WebsiteSiteContext } from './website-site-context';
+/**
+ * @wildo_source:part:start saas.website.astro.head-renderer facet:layer:astro facet:family:website
+ *
+ * Head-block renderers — pure string builders the consumer's per-page
+ * `.astro` file injects via `<Fragment set:html={...}/>` /
+ * `<style set:html={...}></style>`. Two functions:
+ *
+ *   - `renderWebsitePageHeadHtml(opts)` — emits the complete SEO
+ *     `<head>` block: `<title>`, meta description, full Open Graph
+ *     card (`og:title` / `og:description` / `og:type` / `og:url` /
+ *     `og:site_name` / `og:locale` / `og:locale:alternate` / optional
+ *     `og:image`), Twitter card mirrors, `<link rel="canonical">`,
+ *     and one `<link rel="alternate" hreflang>` per declared locale
+ *     (plus an `x-default` for Google's i18n discoverability). Every
+ *     URL is ABSOLUTE (composed from `websiteConfig.publicOrigin` +
+ *     the page's `routePath`) — relative hreflang/canonical
+ *     annotations are not honored consistently across crawlers
+ *     (Phase 6 audit findings H-B / H-C / M-A).
+ *   - `renderWebsiteDesignTokensCss(tokens)` — flattens the design-token
+ *     bundle into `--website-*` custom properties scoped to `:root`.
+ *     Server-static — zero island JS.
+ *
+ * **Why pure string builders** (rather than React components or Astro
+ * components):
+ *
+ *   1. **Avoids the `.astro` distribution problem.** A `.astro` shell
+ *      cannot be re-exported from a TS subpath barrel and `tsc` does
+ *      not copy `.astro` files to `dist/`. Pure TS sidesteps both.
+ *   2. **Avoids the React-island boundary.** Rendering head content
+ *      via React would require either (a) a server-only React subtree
+ *      (extra moving part) or (b) hydrating the `<head>` on the client
+ *      (waste of bundle size for static-build content).
+ *   3. **Vitest-friendly.** Pure functions returning strings are
+ *      trivially asserted against without an Astro test harness.
+ *
+ * **HTML escaping**: every consumer-supplied string (title,
+ * description, OG image URL, hreflang values) is escaped with
+ * `escapeHtmlAttribute` / `escapeHtmlText` before interpolation into
+ * the emitted markup. Marketing copy frequently contains characters
+ * (quotes, ampersands, the rare `<`) that would break the surrounding
+ * tag if interpolated raw — escaping is non-negotiable for a public
+ * surface.
+ *
+ * **Failure modes** — `renderWebsitePageHeadHtml` throws when:
+ *   - `manifest.metaLabelKeys.titleKey` is absent from the pack
+ *   - `manifest.metaLabelKeys.descriptionKey` is absent from the pack
+ * Both throw with the locale + key + actionable next step (`Run
+ * \`wildo website audit\` or add the entry to <pack-path>.json`).
+ */
+export interface RenderWebsitePageHeadHtmlOptions {
+    manifest: WebsitePageManifest;
+    /**
+     * Composed `WebsiteSiteContext` — the renderer reads
+     * `websiteConfig.{defaultLocale, locales, publicOrigin}` for the
+     * URL/locale surface and `rootConfig.seo.{siteName, defaultOgImageUrl}`
+     * for the SEO branding fallback.
+     */
+    siteContext: WebsiteSiteContext;
+    locale: AvailableLanguage;
+    labelPack: LabelPack;
+}
+export declare function renderWebsitePageHeadHtml(opts: RenderWebsitePageHeadHtmlOptions): string;
+/**
+ * Flatten `WebsiteDesignTokens` to a `:root { … }` block of CSS custom
+ * properties. Naming convention: `--website-<group>-<token>` for nested
+ * groups (`colors.primary` → `--website-colors-primary`); top-level
+ * string-valued tokens (none today, future-proofed) emit as
+ * `--website-<token>`.
+ *
+ * **Why scoped to `:root`** rather than `<WebsitePageLayout>`'s root
+ * div: marketing pages frequently embed third-party widgets (live-chat,
+ * analytics overlays) that paint outside the React tree. Scoping
+ * tokens to `:root` makes them visible to those widgets too. The
+ * design-token surface is small enough that the cost of a broader
+ * scope (token-name collisions with consumer-authored `:root` rules)
+ * is bounded by the `--website-` prefix.
+ */
+export declare function renderWebsiteDesignTokensCss(tokens: WebsiteDesignTokens): string;
+/**
+ * @wildo_source:part:end saas.website.astro.head-renderer
+ *
+ * HTML escape helpers moved to `./internal/html-escape.ts` (Phase 7)
+ * so the new `blog-post-head.renderer.ts` sibling can share the same
+ * escape contract instead of redefining it. See that module's preamble
+ * for the framework-mindset rationale (one escape contract per engine,
+ * not one per renderer).
+ */
+//# sourceMappingURL=website-page-head.renderer.d.ts.map

package/dist/esm/astro/website-page-head.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-head.renderer.d.ts","sourceRoot":"","sources":["../../../../src/astro/website-page-head.renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAG9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAC;AACzG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAG5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gCAAgC,GAAG,MAAM,CAmKxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAehF;AAED;;;;;;;;GAQG"}

package/dist/esm/astro/website-page-head.renderer.js

@@ -0,0 +1,184 @@
+import { buildLocalizedRoutePath } from '../core/routing/internal-routing.utils.js';
+import { escapeHtmlAttribute, escapeHtmlText } from './internal/html-escape.js';
+export function renderWebsitePageHeadHtml(opts) {
+    const { manifest, siteContext, locale, labelPack } = opts;
+    const { rootConfig, websiteConfig } = siteContext;
+    const titleKey = manifest.metaLabelKeys.titleKey;
+    const descriptionKey = manifest.metaLabelKeys.descriptionKey;
+    const title = labelPack[titleKey];
+    const description = labelPack[descriptionKey];
+    if (title === undefined) {
+        throw new Error(`[renderWebsitePageHeadHtml] Label pack for locale "${locale}" is missing ` +
+            `the page title key "${titleKey}" (page ref="${manifest.ref}"). ` +
+            `Run \`wildo website audit\` or add the entry to your <locale>.json pack.`);
+    }
+    if (description === undefined) {
+        throw new Error(`[renderWebsitePageHeadHtml] Label pack for locale "${locale}" is missing ` +
+            `the page description key "${descriptionKey}" (page ref="${manifest.ref}"). ` +
+            `Run \`wildo website audit\` or add the entry to your <locale>.json pack.`);
+    }
+    /**
+     * OG image precedence: per-page `manifest.metaLabelKeys.ogImageUrl`
+     * wins; falls back to the site-level `seo.defaultOgImageUrl` so
+     * marketing pages without a hero image still produce a richer
+     * social-card (Phase 6 audit fix M-A). When neither is present,
+     * the Twitter card kind degrades to the smaller `summary` and the
+     * `og:image` / `twitter:image` lines are omitted entirely.
+     */
+    const ogImageUrl = manifest.metaLabelKeys.ogImageUrl ?? rootConfig.seo.defaultOgImageUrl;
+    const titleAttr = escapeHtmlAttribute(title);
+    const descriptionAttr = escapeHtmlAttribute(description);
+    const titleText = escapeHtmlText(title);
+    /**
+     * Absolute URL builder. `prefixDefaultLocale: false` means the
+     * default locale lives at the locale-neutral path; every other
+     * locale sits under `/<locale>/<routePath>`. `x-default` always
+     * resolves to the default-locale path.
+     *
+     * Every URL emitted here is FULLY-QUALIFIED (composed against
+     * `websiteConfig.publicOrigin`) — Google's hreflang spec requires
+     * absolute URLs, and `<link rel="canonical">` relies on absolute
+     * URLs to survive cross-host fetches (preview deployments, CDN
+     * edges). See `WildoMarketingWebsiteConfigSchema.publicOrigin`
+     * JSDoc for the full rationale (incl. trailing-slash rejection).
+     */
+    const routePath = manifest.routePath;
+    const siteOrigin = websiteConfig.publicOrigin;
+    const defaultLocale = websiteConfig.defaultLocale;
+    const currentLocaleStr = String(locale);
+    /**
+     * Compose the absolute URL for `(locale, routePath)` by delegating
+     * the locale-prefix decision to the shared `buildLocalizedRoutePath`
+     * helper — same routing rule that powers `WebsiteInternalLink`. This
+     * guarantees that hreflang/canonical URLs and the chrome's internal
+     * links can never disagree about how a locale is prefixed.
+     */
+    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))}" />`);
+    /**
+     * `og:image` + `twitter:image` are emitted only when an image URL
+     * is available (page-level override OR site-level fallback).
+     * Twitter card type also flips between `summary` (no image) and
+     * `summary_large_image` (image present).
+     */
+    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';
+    /**
+     * `og:locale:alternate` — one per non-current declared locale. Open
+     * Graph spec: the `og:locale` field carries the page's primary
+     * locale; alternates declare the other locales the page is
+     * available in. Emitted in declaration order.
+     *
+     * Locale format: we emit the bare language code (`en`, `fr`) per
+     * the AvailableLanguage atom shape. Open Graph technically
+     * recommends `language_TERRITORY` (e.g. `en_US`), but Facebook /
+     * LinkedIn / Slack accept the bare language code in practice. The
+     * future fix when the platform grows territory-tagged locales is to
+     * map at this site (no consumer change required).
+     */
+    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)}" />`);
+    }
+    const siteNameAttr = escapeHtmlAttribute(rootConfig.seo.siteName);
+    const canonicalAttr = escapeHtmlAttribute(canonicalUrl);
+    const ogLocaleAttr = escapeHtmlAttribute(currentLocaleStr);
+    /**
+     * AI-training opt-out (D-AG3) — `<meta name="robots" content="noai, noimageai">`
+     * is emitted ONLY when the page manifest opts in via
+     * `seo.noaiOptOut: true`. Default is OPT-IN to AI training (the
+     * marketing-site default). This emission pairs with the sibling
+     * `_headers` entry produced by `renderWebsitePageNoaiHeaders()`
+     * for crawlers that don't honor in-document meta.
+     *
+     * Format: `noai` (block AI training on text) and `noimageai`
+     * (block AI training on images) are the two robots directives the
+     * major AI crawlers (GPTBot, ClaudeBot, Google-Extended, etc.)
+     * recognise. Emitting them as a single comma-separated `content`
+     * value is the canonical robots-meta shape.
+     */
+    const noaiMetaLines = [];
+    if (manifest.seo?.noaiOptOut === true) {
+        noaiMetaLines.push(`<meta name="robots" content="noai, noimageai" />`);
+    }
+    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="website" />`,
+        `<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}" />`,
+        ...noaiMetaLines,
+        ...hreflangLines,
+    ].join('\n');
+}
+/**
+ * Flatten `WebsiteDesignTokens` to a `:root { … }` block of CSS custom
+ * properties. Naming convention: `--website-<group>-<token>` for nested
+ * groups (`colors.primary` → `--website-colors-primary`); top-level
+ * string-valued tokens (none today, future-proofed) emit as
+ * `--website-<token>`.
+ *
+ * **Why scoped to `:root`** rather than `<WebsitePageLayout>`'s root
+ * div: marketing pages frequently embed third-party widgets (live-chat,
+ * analytics overlays) that paint outside the React tree. Scoping
+ * tokens to `:root` makes them visible to those widgets too. The
+ * design-token surface is small enough that the cost of a broader
+ * scope (token-name collisions with consumer-authored `:root` rules)
+ * is bounded by the `--website-` prefix.
+ */
+export function renderWebsiteDesignTokensCss(tokens) {
+    const lines = [':root {'];
+    for (const [groupName, groupValue] of Object.entries(tokens)) {
+        if (groupValue !== null && typeof groupValue === 'object' && !Array.isArray(groupValue)) {
+            for (const [tokenName, tokenValue] of Object.entries(groupValue)) {
+                if (typeof tokenValue === 'string') {
+                    lines.push(`  --website-${groupName}-${tokenName}: ${tokenValue};`);
+                }
+            }
+        }
+        else if (typeof groupValue === 'string') {
+            lines.push(`  --website-${groupName}: ${groupValue};`);
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * @wildo_source:part:end saas.website.astro.head-renderer
+ *
+ * HTML escape helpers moved to `./internal/html-escape.ts` (Phase 7)
+ * so the new `blog-post-head.renderer.ts` sibling can share the same
+ * escape contract instead of redefining it. See that module's preamble
+ * for the framework-mindset rationale (one escape contract per engine,
+ * not one per renderer).
+ */
+//# sourceMappingURL=website-page-head.renderer.js.map

package/dist/esm/astro/website-page-head.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-head.renderer.js","sourceRoot":"","sources":["../../../../src/astro/website-page-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 { WebsiteDesignTokens } from '../schemas/design-tokens/website-design-tokens.shared.schemas';\nimport type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';\nimport type { LabelPack } from '../schemas/validators/label-pack.validator';\n\nimport { escapeHtmlAttribute, escapeHtmlText } from './internal/html-escape';\nimport type { WebsiteSiteContext } from './website-site-context';\n\n/**\n * @wildo_source:part:start saas.website.astro.head-renderer facet:layer:astro facet:family:website\n *\n * Head-block renderers — pure string builders the consumer's per-page\n * `.astro` file injects via `<Fragment set:html={...}/>` /\n * `<style set:html={...}></style>`. Two functions:\n *\n *   - `renderWebsitePageHeadHtml(opts)` — emits the complete SEO\n *     `<head>` block: `<title>`, meta description, full Open Graph\n *     card (`og:title` / `og:description` / `og:type` / `og:url` /\n *     `og:site_name` / `og:locale` / `og:locale:alternate` / optional\n *     `og:image`), Twitter card mirrors, `<link rel=\"canonical\">`,\n *     and one `<link rel=\"alternate\" hreflang>` per declared locale\n *     (plus an `x-default` for Google's i18n discoverability). Every\n *     URL is ABSOLUTE (composed from `websiteConfig.publicOrigin` +\n *     the page's `routePath`) — relative hreflang/canonical\n *     annotations are not honored consistently across crawlers\n *     (Phase 6 audit findings H-B / H-C / M-A).\n *   - `renderWebsiteDesignTokensCss(tokens)` — flattens the design-token\n *     bundle into `--website-*` custom properties scoped to `:root`.\n *     Server-static — zero island JS.\n *\n * **Why pure string builders** (rather than React components or Astro\n * components):\n *\n *   1. **Avoids the `.astro` distribution problem.** A `.astro` shell\n *      cannot be re-exported from a TS subpath barrel and `tsc` does\n *      not copy `.astro` files to `dist/`. Pure TS sidesteps both.\n *   2. **Avoids the React-island boundary.** Rendering head content\n *      via React would require either (a) a server-only React subtree\n *      (extra moving part) or (b) hydrating the `<head>` on the client\n *      (waste of bundle size for static-build content).\n *   3. **Vitest-friendly.** Pure functions returning strings are\n *      trivially asserted against without an Astro test harness.\n *\n * **HTML escaping**: every consumer-supplied string (title,\n * description, OG image URL, hreflang values) is escaped with\n * `escapeHtmlAttribute` / `escapeHtmlText` before interpolation into\n * the emitted markup. Marketing copy frequently contains characters\n * (quotes, ampersands, the rare `<`) that would break the surrounding\n * tag if interpolated raw — escaping is non-negotiable for a public\n * surface.\n *\n * **Failure modes** — `renderWebsitePageHeadHtml` throws when:\n *   - `manifest.metaLabelKeys.titleKey` is absent from the pack\n *   - `manifest.metaLabelKeys.descriptionKey` is absent from the pack\n * Both throw with the locale + key + actionable next step (`Run\n * \\`wildo website audit\\` or add the entry to <pack-path>.json`).\n */\n\nexport interface RenderWebsitePageHeadHtmlOptions {\n  manifest: WebsitePageManifest;\n  /**\n   * Composed `WebsiteSiteContext` — the renderer reads\n   * `websiteConfig.{defaultLocale, locales, publicOrigin}` for the\n   * URL/locale surface and `rootConfig.seo.{siteName, defaultOgImageUrl}`\n   * for the SEO branding fallback.\n   */\n  siteContext: WebsiteSiteContext;\n  locale: AvailableLanguage;\n  labelPack: LabelPack;\n}\n\nexport function renderWebsitePageHeadHtml(opts: RenderWebsitePageHeadHtmlOptions): string {\n  const { manifest, siteContext, locale, labelPack } = opts;\n  const { rootConfig, websiteConfig } = siteContext;\n\n  const titleKey = manifest.metaLabelKeys.titleKey as unknown as string;\n  const descriptionKey = manifest.metaLabelKeys.descriptionKey as unknown as string;\n  const title = labelPack[titleKey];\n  const description = labelPack[descriptionKey];\n\n  if (title === undefined) {\n    throw new Error(\n      `[renderWebsitePageHeadHtml] Label pack for locale \"${locale}\" is missing ` +\n        `the page title key \"${titleKey}\" (page ref=\"${manifest.ref as unknown as string}\"). ` +\n        `Run \\`wildo website audit\\` or add the entry to your <locale>.json pack.`,\n    );\n  }\n  if (description === undefined) {\n    throw new Error(\n      `[renderWebsitePageHeadHtml] Label pack for locale \"${locale}\" is missing ` +\n        `the page description key \"${descriptionKey}\" (page ref=\"${manifest.ref as unknown as string}\"). ` +\n        `Run \\`wildo website audit\\` or add the entry to your <locale>.json pack.`,\n    );\n  }\n\n  /**\n   * OG image precedence: per-page `manifest.metaLabelKeys.ogImageUrl`\n   * wins; falls back to the site-level `seo.defaultOgImageUrl` so\n   * marketing pages without a hero image still produce a richer\n   * social-card (Phase 6 audit fix M-A). When neither is present,\n   * the Twitter card kind degrades to the smaller `summary` and the\n   * `og:image` / `twitter:image` lines are omitted entirely.\n   */\n  const ogImageUrl = manifest.metaLabelKeys.ogImageUrl ?? rootConfig.seo.defaultOgImageUrl;\n  const titleAttr = escapeHtmlAttribute(title);\n  const descriptionAttr = escapeHtmlAttribute(description);\n  const titleText = escapeHtmlText(title);\n\n  /**\n   * Absolute URL builder. `prefixDefaultLocale: false` means the\n   * default locale lives at the locale-neutral path; every other\n   * locale sits under `/<locale>/<routePath>`. `x-default` always\n   * resolves to the default-locale path.\n   *\n   * Every URL emitted here is FULLY-QUALIFIED (composed against\n   * `websiteConfig.publicOrigin`) — Google's hreflang spec requires\n   * absolute URLs, and `<link rel=\"canonical\">` relies on absolute\n   * URLs to survive cross-host fetches (preview deployments, CDN\n   * edges). See `WildoMarketingWebsiteConfigSchema.publicOrigin`\n   * JSDoc for the full rationale (incl. trailing-slash rejection).\n   */\n  const routePath = manifest.routePath as unknown as string;\n  const siteOrigin = websiteConfig.publicOrigin;\n  const defaultLocale = websiteConfig.defaultLocale;\n  const currentLocaleStr = String(locale);\n\n  /**\n   * Compose the absolute URL for `(locale, routePath)` by delegating\n   * the locale-prefix decision to the shared `buildLocalizedRoutePath`\n   * helper — same routing rule that powers `WebsiteInternalLink`. This\n   * guarantees that hreflang/canonical URLs and the chrome's internal\n   * links can never disagree about how a locale is prefixed.\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  /**\n   * `og:image` + `twitter:image` are emitted only when an image URL\n   * is available (page-level override OR site-level fallback).\n   * Twitter card type also flips between `summary` (no image) and\n   * `summary_large_image` (image present).\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  /**\n   * `og:locale:alternate` — one per non-current declared locale. Open\n   * Graph spec: the `og:locale` field carries the page's primary\n   * locale; alternates declare the other locales the page is\n   * available in. Emitted in declaration order.\n   *\n   * Locale format: we emit the bare language code (`en`, `fr`) per\n   * the AvailableLanguage atom shape. Open Graph technically\n   * recommends `language_TERRITORY` (e.g. `en_US`), but Facebook /\n   * LinkedIn / Slack accept the bare language code in practice. The\n   * future fix when the platform grows territory-tagged locales is to\n   * map at this site (no consumer change required).\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  const siteNameAttr = escapeHtmlAttribute(rootConfig.seo.siteName);\n  const canonicalAttr = escapeHtmlAttribute(canonicalUrl);\n  const ogLocaleAttr = escapeHtmlAttribute(currentLocaleStr);\n\n  /**\n   * AI-training opt-out (D-AG3) — `<meta name=\"robots\" content=\"noai, noimageai\">`\n   * is emitted ONLY when the page manifest opts in via\n   * `seo.noaiOptOut: true`. Default is OPT-IN to AI training (the\n   * marketing-site default). This emission pairs with the sibling\n   * `_headers` entry produced by `renderWebsitePageNoaiHeaders()`\n   * for crawlers that don't honor in-document meta.\n   *\n   * Format: `noai` (block AI training on text) and `noimageai`\n   * (block AI training on images) are the two robots directives the\n   * major AI crawlers (GPTBot, ClaudeBot, Google-Extended, etc.)\n   * recognise. Emitting them as a single comma-separated `content`\n   * value is the canonical robots-meta shape.\n   */\n  const noaiMetaLines: string[] = [];\n  if (manifest.seo?.noaiOptOut === true) {\n    noaiMetaLines.push(`<meta name=\"robots\" content=\"noai, noimageai\" />`);\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=\"website\" />`,\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    ...noaiMetaLines,\n    ...hreflangLines,\n  ].join('\\n');\n}\n\n/**\n * Flatten `WebsiteDesignTokens` to a `:root { … }` block of CSS custom\n * properties. Naming convention: `--website-<group>-<token>` for nested\n * groups (`colors.primary` → `--website-colors-primary`); top-level\n * string-valued tokens (none today, future-proofed) emit as\n * `--website-<token>`.\n *\n * **Why scoped to `:root`** rather than `<WebsitePageLayout>`'s root\n * div: marketing pages frequently embed third-party widgets (live-chat,\n * analytics overlays) that paint outside the React tree. Scoping\n * tokens to `:root` makes them visible to those widgets too. The\n * design-token surface is small enough that the cost of a broader\n * scope (token-name collisions with consumer-authored `:root` rules)\n * is bounded by the `--website-` prefix.\n */\nexport function renderWebsiteDesignTokensCss(tokens: WebsiteDesignTokens): string {\n  const lines: string[] = [':root {'];\n  for (const [groupName, groupValue] of Object.entries(tokens) as [string, unknown][]) {\n    if (groupValue !== null && typeof groupValue === 'object' && !Array.isArray(groupValue)) {\n      for (const [tokenName, tokenValue] of Object.entries(groupValue) as [string, unknown][]) {\n        if (typeof tokenValue === 'string') {\n          lines.push(`  --website-${groupName}-${tokenName}: ${tokenValue};`);\n        }\n      }\n    } else if (typeof groupValue === 'string') {\n      lines.push(`  --website-${groupName}: ${groupValue};`);\n    }\n  }\n  lines.push('}');\n  return lines.join('\\n');\n}\n\n/**\n * @wildo_source:part:end saas.website.astro.head-renderer\n *\n * HTML escape helpers moved to `./internal/html-escape.ts` (Phase 7)\n * so the new `blog-post-head.renderer.ts` sibling can share the same\n * escape contract instead of redefining it. See that module's preamble\n * for the framework-mindset rationale (one escape contract per engine,\n * not one per renderer).\n */\n"]}

package/dist/esm/astro/website-page-runtime.helper.d.ts

@@ -0,0 +1,112 @@
+import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
+import type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';
+import type { LabelPack } from '../schemas/validators/label-pack.validator';
+import type { WebsiteSiteContext } from './website-site-context';
+/**
+ * @wildo_source:part:start saas.website.astro.runtime-helper facet:layer:astro facet:family:website
+ *
+ * `loadWebsitePageRuntime(opts)` — the per-request entry point a
+ * consumer's `src/pages/<page>.astro` calls inside its frontmatter to
+ * resolve the active locale and load the matching label pack. Returns
+ * the two primitive values (`locale`, `labelPack`) that travel as
+ * Astro-island props to `WebsitePageBridgeIsland` (see
+ * `bridge-runtime.tsx`).
+ *
+ * **Why a single helper** (instead of two — locale resolution + pack
+ * load — invoked separately in every page's frontmatter): the locale
+ * fallback rule (`Astro.currentLocale ?? websiteConfig.defaultLocale`)
+ * MUST stay aligned with the `prefixDefaultLocale: false` convention
+ * encoded by `buildAstroI18nConfig`. Centralizing the rule here means
+ * a future change (e.g. honoring an `Accept-Language` header before
+ * the static default-locale fallback) lands in one place rather than
+ * being duplicated across every consumer page's frontmatter.
+ *
+ * **Why this lives in a `.ts` helper, NOT in a `.astro` shell**: a shipped
+ * `WebsitePageBridge.astro` cannot cross-host the page/header/footer
+ * `ComponentType` references through the React-island serialization
+ * boundary (Astro serializes island props via `devalue`-style JSON;
+ * function refs do not survive). Keeping the per-request work in a
+ * pure TS helper means the consumer authors their own thin per-page
+ * `.astro` file that statically imports each page's bridge island —
+ * the component reference is then a JSX tag in the consumer's
+ * `.astro` template, which Astro's compiler resolves at build time
+ * (no prop serialization).
+ *
+ * **Failure modes** (all surfaced as thrown errors with actionable
+ * messages):
+ *   - `astroLocale` is provided but is not a member of
+ *     `siteContext.websiteConfig.locales`: throws — Astro's i18n
+ *     routing should never present a locale outside the declared set;
+ *     if it does, `astro.config.mjs` is out of sync with
+ *     `WildoMarketingWebsiteConfig`.
+ *   - Label pack file missing / malformed: surfaced by
+ *     `loadLabelPack` (filesystem error message + locale + path).
+ *
+ * @param opts.manifest        The page manifest the consumer is
+ *                             rendering. Read by `pickLabelsForPage`
+ *                             to filter the loaded label pack down to
+ *                             the keys this page actually consumes
+ *                             (the page's own `website.<ref>.*` slice
+ *                             plus the shared `website.chrome.*`
+ *                             slice). Without this filter every page
+ *                             would serialize the whole site's pack
+ *                             into its `<astro-island props=…>`
+ *                             attribute — see
+ *                             `pick-labels-for-page.ts` for the full
+ *                             rationale.
+ * @param opts.siteContext     The composed `WebsiteSiteContext`. Read
+ *                             for `websiteConfig.{defaultLocale,
+ *                             locales}` (locale resolution) and
+ *                             `rootConfig.skipToMainContentLabelKey`
+ *                             (chrome key carried into the per-page
+ *                             pack slice).
+ * @param opts.labelPacksDir   Directory holding `<locale>.json` packs.
+ *                             Resolved relative to the cwd Astro runs
+ *                             in (typically the project root).
+ * @param opts.astroLocale     Whatever `Astro.currentLocale` returned
+ *                             at the consumer's call site.
+ *                             `string | undefined` — Astro returns
+ *                             `undefined` for the un-prefixed
+ *                             default-locale path.
+ */
+export interface LoadWebsitePageRuntimeOptions {
+    /** The page manifest the consumer is rendering (carried for forward-compat). */
+    manifest: WebsitePageManifest;
+    /** The site's composed `WebsiteSiteContext` — single source of truth. */
+    siteContext: WebsiteSiteContext;
+    /** Directory holding `<locale>.json` label-pack files. */
+    labelPacksDir: string;
+    /** The value of `Astro.currentLocale` at the call site. */
+    astroLocale: string | undefined;
+}
+/**
+ * Result of `loadWebsitePageRuntime` — the two primitive values that
+ * travel as Astro-island props to the page's bridge island.
+ *
+ * Both values are JSON-serializable so they cleanly cross Astro's
+ * client-island hydration boundary. Function refs (page component,
+ * header / footer component) are NOT carried here on purpose; they
+ * are closed over by the per-page `createWebsitePageBridgeIsland(...)`
+ * call so they never need to cross a serialization boundary. See the
+ * file-level JSDoc above and `bridge-runtime.tsx` for the redesign
+ * rationale.
+ */
+export interface WebsitePageRuntime {
+    /** The resolved locale (Astro's value with default-locale fallback). */
+    locale: AvailableLanguage;
+    /**
+     * The site's default locale (mirrors `websiteConfig.defaultLocale`).
+     * Returned alongside `locale` so the consumer can pass both to the
+     * bridge island in one symmetric block (`{ locale, defaultLocale }`)
+     * — the island then publishes both into `WebsiteRuntimeContext`,
+     * which `WebsiteInternalLink` reads to compute locale-prefixed paths.
+     * Re-exporting it here avoids forcing every
+     * consumer page to import the website config separately.
+     */
+    defaultLocale: AvailableLanguage;
+    /** The loaded + shape-validated label pack for the active locale. */
+    labelPack: LabelPack;
+}
+export declare function loadWebsitePageRuntime(opts: LoadWebsitePageRuntimeOptions): WebsitePageRuntime;
+/** @wildo_source:part:end saas.website.astro.runtime-helper */
+//# sourceMappingURL=website-page-runtime.helper.d.ts.map

package/dist/esm/astro/website-page-runtime.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-runtime.helper.d.ts","sourceRoot":"","sources":["../../../../src/astro/website-page-runtime.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAGzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAI5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,gFAAgF;IAChF,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,yEAAyE;IACzE,WAAW,EAAE,kBAAkB,CAAC;IAChC,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;;;OAQG;IACH,aAAa,EAAE,iBAAiB,CAAC;IACjC,qEAAqE;IACrE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,6BAA6B,GAClC,kBAAkB,CAqCpB;AA+BD,+DAA+D"}

package/dist/esm/astro/website-page-runtime.helper.js

@@ -0,0 +1,60 @@
+import { loadLabelPack } from './label-pack-loader.js';
+import { pickLabelsForPage } from './pick-labels-for-page.js';
+export function loadWebsitePageRuntime(opts) {
+    const { manifest, siteContext, labelPacksDir, astroLocale } = opts;
+    const { rootConfig, websiteConfig } = siteContext;
+    /**
+     * Locale resolution — the `prefixDefaultLocale: false` convention
+     * means Astro serves the default locale at the un-prefixed path
+     * (`/`, `/pricing`, …) and reports `undefined` from
+     * `Astro.currentLocale` for those requests. Coalesce here to the
+     * website config's default rather than letting `undefined` leak
+     * into the label-pack lookup.
+     */
+    const resolvedLocale = astroLocale === undefined
+        ? websiteConfig.defaultLocale
+        : assertKnownLocale(astroLocale, websiteConfig);
+    const fullPack = loadLabelPack(labelPacksDir, resolvedLocale);
+    /**
+     * Filter to the keys this page can ever read at runtime — page-own
+     * slice + shared chrome slice. The full pack is loaded once (one
+     * fs read per request), then sliced; the slimmed result is what
+     * crosses the SSR → client serialization boundary inside
+     * `<astro-island props=…>`. Sites with O(100) keys per page on
+     * O(10) pages save material payload on every HTML response — the
+     * untrimmed default would have served every page the entire site's
+     * pack on every locale.
+     */
+    const labelPack = pickLabelsForPage(fullPack, manifest, [
+        rootConfig.skipToMainContentLabelKey,
+    ]);
+    return {
+        locale: resolvedLocale,
+        defaultLocale: websiteConfig.defaultLocale,
+        labelPack,
+    };
+}
+/**
+ * Defensive: Astro's i18n routing should only ever present a locale
+ * declared on `WildoMarketingWebsiteConfig.locales`. If it does not,
+ * the consumer's `astro.config.mjs` is out of sync with the website
+ * config — surface that loudly here rather than letting an unknown
+ * locale trigger a `[label-pack-loader] Could not read pack` error
+ * that would imply a content-authoring fault (missing JSON file)
+ * rather than a configuration fault (Astro routing mismatch).
+ */
+function assertKnownLocale(astroLocale, websiteConfig) {
+    for (const entry of websiteConfig.locales) {
+        if (entry.locale === astroLocale) {
+            return entry.locale;
+        }
+    }
+    const declared = websiteConfig.locales.map((entry) => entry.locale);
+    throw new Error(`[loadWebsitePageRuntime] Astro presented locale "${astroLocale}" but ` +
+        `WildoMarketingWebsiteConfig.locales declares only [${declared.join(', ')}]. ` +
+        `Either add "${astroLocale}" to wildo.website.config.ts's locales or update ` +
+        `astro.config.mjs to consume buildAstroI18nConfig(WEBSITE_SITE_CONTEXT) so ` +
+        `both sides stay in sync.`);
+}
+/** @wildo_source:part:end saas.website.astro.runtime-helper */
+//# sourceMappingURL=website-page-runtime.helper.js.map

package/dist/esm/astro/website-page-runtime.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-runtime.helper.js","sourceRoot":"","sources":["../../../../src/astro/website-page-runtime.helper.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA8G3D,MAAM,UAAU,sBAAsB,CACpC,IAAmC;IAEnC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACnE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,WAAW,CAAC;IAElD;;;;;;;OAOG;IACH,MAAM,cAAc,GAClB,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,aAAa,CAAC,aAAa;QAC7B,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC9D;;;;;;;;;OASG;IACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE;QACtD,UAAU,CAAC,yBAAyB;KACrC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,aAAa,EAAE,aAAa,CAAC,aAAa;QAC1C,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CACxB,WAAmB,EACnB,aAA0C;IAE1C,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAK,KAAK,CAAC,MAA4B,KAAK,WAAW,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAA2B,CAC7C,CAAC;IACF,MAAM,IAAI,KAAK,CACb,oDAAoD,WAAW,QAAQ;QACrE,sDAAsD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QAC9E,eAAe,WAAW,mDAAmD;QAC7E,4EAA4E;QAC5E,0BAA0B,CAC7B,CAAC;AACJ,CAAC;AACD,+DAA+D","sourcesContent":["import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport type { WildoMarketingWebsiteConfig } from '../config/wildo-website-config.schemas';\nimport type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';\nimport type { LabelPack } from '../schemas/validators/label-pack.validator';\n\nimport { loadLabelPack } from './label-pack-loader';\nimport { pickLabelsForPage } from './pick-labels-for-page';\nimport type { WebsiteSiteContext } from './website-site-context';\n\n/**\n * @wildo_source:part:start saas.website.astro.runtime-helper facet:layer:astro facet:family:website\n *\n * `loadWebsitePageRuntime(opts)` — the per-request entry point a\n * consumer's `src/pages/<page>.astro` calls inside its frontmatter to\n * resolve the active locale and load the matching label pack. Returns\n * the two primitive values (`locale`, `labelPack`) that travel as\n * Astro-island props to `WebsitePageBridgeIsland` (see\n * `bridge-runtime.tsx`).\n *\n * **Why a single helper** (instead of two — locale resolution + pack\n * load — invoked separately in every page's frontmatter): the locale\n * fallback rule (`Astro.currentLocale ?? websiteConfig.defaultLocale`)\n * MUST stay aligned with the `prefixDefaultLocale: false` convention\n * encoded by `buildAstroI18nConfig`. Centralizing the rule here means\n * a future change (e.g. honoring an `Accept-Language` header before\n * the static default-locale fallback) lands in one place rather than\n * being duplicated across every consumer page's frontmatter.\n *\n * **Why this lives in a `.ts` helper, NOT in a `.astro` shell**: a shipped\n * `WebsitePageBridge.astro` cannot cross-host the page/header/footer\n * `ComponentType` references through the React-island serialization\n * boundary (Astro serializes island props via `devalue`-style JSON;\n * function refs do not survive). Keeping the per-request work in a\n * pure TS helper means the consumer authors their own thin per-page\n * `.astro` file that statically imports each page's bridge island —\n * the component reference is then a JSX tag in the consumer's\n * `.astro` template, which Astro's compiler resolves at build time\n * (no prop serialization).\n *\n * **Failure modes** (all surfaced as thrown errors with actionable\n * messages):\n *   - `astroLocale` is provided but is not a member of\n *     `siteContext.websiteConfig.locales`: throws — Astro's i18n\n *     routing should never present a locale outside the declared set;\n *     if it does, `astro.config.mjs` is out of sync with\n *     `WildoMarketingWebsiteConfig`.\n *   - Label pack file missing / malformed: surfaced by\n *     `loadLabelPack` (filesystem error message + locale + path).\n *\n * @param opts.manifest        The page manifest the consumer is\n *                             rendering. Read by `pickLabelsForPage`\n *                             to filter the loaded label pack down to\n *                             the keys this page actually consumes\n *                             (the page's own `website.<ref>.*` slice\n *                             plus the shared `website.chrome.*`\n *                             slice). Without this filter every page\n *                             would serialize the whole site's pack\n *                             into its `<astro-island props=…>`\n *                             attribute — see\n *                             `pick-labels-for-page.ts` for the full\n *                             rationale.\n * @param opts.siteContext     The composed `WebsiteSiteContext`. Read\n *                             for `websiteConfig.{defaultLocale,\n *                             locales}` (locale resolution) and\n *                             `rootConfig.skipToMainContentLabelKey`\n *                             (chrome key carried into the per-page\n *                             pack slice).\n * @param opts.labelPacksDir   Directory holding `<locale>.json` packs.\n *                             Resolved relative to the cwd Astro runs\n *                             in (typically the project root).\n * @param opts.astroLocale     Whatever `Astro.currentLocale` returned\n *                             at the consumer's call site.\n *                             `string | undefined` — Astro returns\n *                             `undefined` for the un-prefixed\n *                             default-locale path.\n */\nexport interface LoadWebsitePageRuntimeOptions {\n  /** The page manifest the consumer is rendering (carried for forward-compat). */\n  manifest: WebsitePageManifest;\n  /** The site's composed `WebsiteSiteContext` — single source of truth. */\n  siteContext: WebsiteSiteContext;\n  /** Directory holding `<locale>.json` label-pack files. */\n  labelPacksDir: string;\n  /** The value of `Astro.currentLocale` at the call site. */\n  astroLocale: string | undefined;\n}\n\n/**\n * Result of `loadWebsitePageRuntime` — the two primitive values that\n * travel as Astro-island props to the page's bridge island.\n *\n * Both values are JSON-serializable so they cleanly cross Astro's\n * client-island hydration boundary. Function refs (page component,\n * header / footer component) are NOT carried here on purpose; they\n * are closed over by the per-page `createWebsitePageBridgeIsland(...)`\n * call so they never need to cross a serialization boundary. See the\n * file-level JSDoc above and `bridge-runtime.tsx` for the redesign\n * rationale.\n */\nexport interface WebsitePageRuntime {\n  /** The resolved locale (Astro's value with default-locale fallback). */\n  locale: AvailableLanguage;\n  /**\n   * The site's default locale (mirrors `websiteConfig.defaultLocale`).\n   * Returned alongside `locale` so the consumer can pass both to the\n   * bridge island in one symmetric block (`{ locale, defaultLocale }`)\n   * — the island then publishes both into `WebsiteRuntimeContext`,\n   * which `WebsiteInternalLink` reads to compute locale-prefixed paths.\n   * Re-exporting it here avoids forcing every\n   * consumer page to import the website config separately.\n   */\n  defaultLocale: AvailableLanguage;\n  /** The loaded + shape-validated label pack for the active locale. */\n  labelPack: LabelPack;\n}\n\nexport function loadWebsitePageRuntime(\n  opts: LoadWebsitePageRuntimeOptions,\n): WebsitePageRuntime {\n  const { manifest, siteContext, labelPacksDir, astroLocale } = opts;\n  const { rootConfig, websiteConfig } = siteContext;\n\n  /**\n   * Locale resolution — the `prefixDefaultLocale: false` convention\n   * means Astro serves the default locale at the un-prefixed path\n   * (`/`, `/pricing`, …) and reports `undefined` from\n   * `Astro.currentLocale` for those requests. Coalesce here to the\n   * website config's default rather than letting `undefined` leak\n   * into the label-pack lookup.\n   */\n  const resolvedLocale: AvailableLanguage =\n    astroLocale === undefined\n      ? websiteConfig.defaultLocale\n      : assertKnownLocale(astroLocale, websiteConfig);\n\n  const fullPack = loadLabelPack(labelPacksDir, resolvedLocale);\n  /**\n   * Filter to the keys this page can ever read at runtime — page-own\n   * slice + shared chrome slice. The full pack is loaded once (one\n   * fs read per request), then sliced; the slimmed result is what\n   * crosses the SSR → client serialization boundary inside\n   * `<astro-island props=…>`. Sites with O(100) keys per page on\n   * O(10) pages save material payload on every HTML response — the\n   * untrimmed default would have served every page the entire site's\n   * pack on every locale.\n   */\n  const labelPack = pickLabelsForPage(fullPack, manifest, [\n    rootConfig.skipToMainContentLabelKey,\n  ]);\n\n  return {\n    locale: resolvedLocale,\n    defaultLocale: websiteConfig.defaultLocale,\n    labelPack,\n  };\n}\n\n/**\n * Defensive: Astro's i18n routing should only ever present a locale\n * declared on `WildoMarketingWebsiteConfig.locales`. If it does not,\n * the consumer's `astro.config.mjs` is out of sync with the website\n * config — surface that loudly here rather than letting an unknown\n * locale trigger a `[label-pack-loader] Could not read pack` error\n * that would imply a content-authoring fault (missing JSON file)\n * rather than a configuration fault (Astro routing mismatch).\n */\nfunction assertKnownLocale(\n  astroLocale: string,\n  websiteConfig: WildoMarketingWebsiteConfig,\n): AvailableLanguage {\n  for (const entry of websiteConfig.locales) {\n    if ((entry.locale as unknown as string) === astroLocale) {\n      return entry.locale;\n    }\n  }\n  const declared = websiteConfig.locales.map(\n    (entry) => entry.locale as unknown as string,\n  );\n  throw new Error(\n    `[loadWebsitePageRuntime] Astro presented locale \"${astroLocale}\" but ` +\n      `WildoMarketingWebsiteConfig.locales declares only [${declared.join(', ')}]. ` +\n      `Either add \"${astroLocale}\" to wildo.website.config.ts's locales or update ` +\n      `astro.config.mjs to consume buildAstroI18nConfig(WEBSITE_SITE_CONTEXT) so ` +\n      `both sides stay in sync.`,\n  );\n}\n/** @wildo_source:part:end saas.website.astro.runtime-helper */\n"]}