@wildo-ai/saas-website 1.1.1

package/dist/esm/astro/label-pack-loader.js

@@ -0,0 +1,298 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { validateLabelPackAgainstManifest, } from '../schemas/validators/label-pack.validator.js';
+/**
+ * @wildo_source:part:start saas.website.astro.label-loader facet:layer:astro facet:family:website
+ *
+ * `label-pack-loader.ts` — synchronous, fs-backed loader for
+ * marketing-site label packs. Consumed by:
+ *   - the Astro adapter (`WebsitePageBridge.astro` reads the active
+ *     locale's pack at request time during SSR / pre-render),
+ *   - the `wildo website audit` CLI (Phase 7) to validate every
+ *     locale pack against every manifest at CI time,
+ *   - any build-time hook that wants to fail fast on a missing or
+ *     malformed pack.
+ *
+ * **Convention** (matches the slice plan + the validator's contract):
+ *
+ *   - One file per locale: `<packsDir>/<locale>.json`
+ *   - JSON object: flat key-value map, `Record<string, string>`
+ *   - Keys are fully-composed `WebsiteLabelKey`s (`website.<page>.<section>.<slot>`)
+ *   - Values are the localized strings
+ *
+ * **Why synchronous I/O**:
+ *   - The Astro frontmatter executes at build / SSR time in a Node
+ *     process (no event loop pressure to relieve), and the bridge
+ *     wants the pack resolved before it emits any HTML — async would
+ *     force the consumer to `await` inside an Astro frontmatter,
+ *     which is supported but adds a needless yield-point on a single
+ *     small JSON file.
+ *   - The validator is pure and synchronous; making the loader async
+ *     would add a coloring boundary for no benefit.
+ *
+ * **Failure modes — all surfaced as thrown errors with actionable
+ * messages**:
+ *   - File missing — wrapped in a `[label-pack-loader] Could not read
+ *     pack at <path>` error so a typo in the dir / locale is obvious.
+ *   - JSON parse failure — error includes the file path and the
+ *     parser's own message.
+ *   - Top-level shape is not an object, or a value is not a string —
+ *     error names the offending key + observed type.
+ *
+ * **Why three exports** (loader, multi-loader, validator-runner):
+ *   - `loadLabelPack(packsDir, locale)` is the atomic primitive
+ *     (one file → one validated `LabelPack`). Used by the bridge at
+ *     request time.
+ *   - `loadAllLabelPacks(packsDir, siteContext)` is the build-time
+ *     batch — every locale pack at once. Used by the CLI auditor
+ *     and by the build-start hook.
+ *   - `validateAllLabelPacks(packsDir, siteContext, expectedKeysBySectionRef)`
+ *     is the highest-level entry point: load every pack, run the
+ *     validator on each, and either return the diagnostic results
+ *     or throw on the first hard error. The returned shape carries
+ *     per-locale diagnostics so the caller can format a CLI report.
+ *
+ * **`siteContext` parameter** — the consumer's composed
+ * `WebsiteSiteContext` (see `website-site-context.ts`). The loader
+ * reads `siteContext.websiteConfig.locales` for "which locales does
+ * the site ship?" and `siteContext.rootConfig.{pageManifests,
+ * chromeLabelKeys, skipToMainContentLabelKey}` for the manifest
+ * registry / chrome-key set the validator runs against.
+ */
+/**
+ * Load and validate a single locale's label pack. Synchronous —
+ * suitable for Astro frontmatter execution.
+ *
+ * @param packsDir Absolute or cwd-relative path to the directory
+ *                 containing per-locale `<locale>.json` files.
+ * @param locale   The locale to load. Must be a member of
+ *                 `WildoMarketingWebsiteConfig.locales`.
+ * @returns A flat `LabelPack` (`Record<string, string>`) ready to
+ *          feed into `WebsiteRuntimeContextValue.labelPack`.
+ * @throws  When the file is missing, malformed JSON, not an object,
+ *          or contains a non-string value.
+ */
+export function loadLabelPack(packsDir, locale) {
+    const filePath = resolve(packsDir, `${locale}.json`);
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf-8');
+    }
+    catch (cause) {
+        throw new Error(`[label-pack-loader] Could not read label pack at ${filePath} ` +
+            `(locale="${locale}"). ` +
+            `Make sure the directory exists and contains a "${locale}.json" file. ` +
+            `Underlying error: ${cause.message}`, { cause });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error(`[label-pack-loader] Failed to parse JSON in ${filePath} ` +
+            `(locale="${locale}"). Underlying parser error: ${cause.message}`, { cause });
+    }
+    return assertLabelPackShape(parsed, filePath, locale);
+}
+/**
+ * Batch loader — every locale declared on the site at once. The map
+ * iteration order matches the declaration order of
+ * `siteContext.websiteConfig.locales` so CLI reports come out in a
+ * deterministic, authored sequence.
+ */
+export function loadAllLabelPacks(packsDir, siteContext) {
+    const packs = new Map();
+    for (const entry of siteContext.websiteConfig.locales) {
+        packs.set(entry.locale, loadLabelPack(packsDir, entry.locale));
+    }
+    return packs;
+}
+/**
+ * Highest-level entry point: load every locale's pack and run the
+ * label-pack validator against the manifest registry.
+ *
+ * **Return shape decision** — this function does NOT throw on
+ * `missing` keys; it returns the per-locale results so the caller
+ * (the build-start hook OR the CLI auditor OR a debugging
+ * subprocess) can decide how to surface the failure (process exit
+ * code, formatted CLI output, JSON report, …). A thin `throwIfAny…`
+ * helper sits next to it for the common "fail the build on first
+ * missing key" path.
+ */
+export function loadAndValidateAllLabelPacks(packsDir, siteContext, expectedKeysBySectionRef) {
+    const { rootConfig } = siteContext;
+    const packs = loadAllLabelPacks(packsDir, siteContext);
+    const manifests = rootConfig.pageManifests;
+    const effectiveChromeKeys = composeEffectiveChromeLabelKeys(rootConfig);
+    const validations = [];
+    for (const [locale, pack] of packs) {
+        validations.push({
+            locale,
+            result: validateLabelPackAgainstManifest(manifests, expectedKeysBySectionRef, pack, effectiveChromeKeys),
+        });
+    }
+    return validations;
+}
+/**
+ * Compose the chrome-label-key set the validator should treat as
+ * "expected" — `WebsiteRootConfig.chromeLabelKeys` (consumer-authored)
+ * UNION the framework-required `skipToMainContentLabelKey`.
+ *
+ * Centralized here because:
+ *   - Both `loadAndValidateAllLabelPacks` (used at build time) and
+ *     `buildKeyOriginMap` (used to annotate missing-key errors) need
+ *     the same composed list, and forking the union into two places
+ *     would be a drift hazard.
+ *   - The framework owns the skip-link key (it is rendered by
+ *     `WebsitePageLayout`, not the consumer's chrome), so the
+ *     consumer should NOT have to remember to also list it in
+ *     `chromeLabelKeys`. Auto-injection here keeps the contract
+ *     minimal at the consumer's call site (just declare the key in
+ *     `WebsiteRootConfig.skipToMainContentLabelKey` once + ship the
+ *     translation in every locale pack) while still surfacing the key
+ *     through the validator's "missing"/"orphaned" diagnostics.
+ *   - De-duplication is via `Set` semantics so a consumer who
+ *     defensively lists the key in both places (no-op but harmless)
+ *     does not produce a duplicate-key warning downstream.
+ */
+function composeEffectiveChromeLabelKeys(rootConfig) {
+    const set = new Set(rootConfig.chromeLabelKeys);
+    set.add(rootConfig.skipToMainContentLabelKey);
+    return Array.from(set);
+}
+/**
+ * Convenience wrapper for the build-start hook: validates every
+ * declared locale's pack and throws a SINGLE aggregated error if any
+ * locale has a hard failure (`missing` keys or `unmappedSectionRefs`).
+ * Orphaned keys are logged via `console.warn` (soft warning per the
+ * validator's contract) but do NOT throw.
+ *
+ * **Why aggregate (not first-fail)**: a multi-locale marketing site
+ * with `en` and `fr` packs both missing keys would, under a
+ * first-fail policy, force the author to fix `en`, re-run the build,
+ * THEN see `fr`'s problem. Aggregating means one build run surfaces
+ * every locale's hard errors together — material UX win for the
+ * authoring loop. The aggregated message keeps each locale's failure
+ * in its own block so the diagnostic stays scannable.
+ *
+ * **Why throw vs. return**: the build-start hook lives in
+ * `astro.config.mjs` (or a `vite-plugin`-style integration) and
+ * benefits from the shortest possible code path — a thrown error
+ * naturally aborts `astro build` with a non-zero exit code and
+ * surfaces the message in the build log. The richer
+ * `loadAndValidateAllLabelPacks` is what `wildo website audit` calls
+ * when it wants programmatic access to the per-locale results.
+ *
+ * **Key-origin annotation**: every `missing` key is tagged with the
+ * page (and, if section-scoped, the section) that declared it, so the
+ * author can grep + open the right `defineWebsiteSection` /
+ * `defineWebsitePageManifest` call site without leaving the build log.
+ */
+export function assertLabelPacksValid(packsDir, siteContext, expectedKeysBySectionRef) {
+    const { rootConfig } = siteContext;
+    const validations = loadAndValidateAllLabelPacks(packsDir, siteContext, expectedKeysBySectionRef);
+    /**
+     * Build a key → origin map ONCE per assert call (cost is bounded by
+     * the total number of declared keys across the whole site, which is
+     * typically small for a marketing surface). Enriches the missing-key
+     * error with the page/section that committed to each key — the
+     * author can grep the ref to find the site authoring call site.
+     */
+    const keyOrigins = buildKeyOriginMap(rootConfig.pageManifests, expectedKeysBySectionRef, composeEffectiveChromeLabelKeys(rootConfig));
+    const localeErrorBlocks = [];
+    for (const { locale, result } of validations) {
+        const blocks = [];
+        if (result.unmappedSectionRefs.length > 0) {
+            blocks.push(`  unmappedSectionRefs (build-pipeline bug — sections referenced by a ` +
+                `manifest but missing from the expected-keys collector): ` +
+                `[${result.unmappedSectionRefs.join(', ')}]. ` +
+                `Add every referenced section to the array passed to ` +
+                `collectExpectedLabelKeysFromSections().`);
+        }
+        if (result.missing.length > 0) {
+            const annotated = result.missing.map((key) => `    "${key}"  ← ${keyOrigins.get(key) ?? 'unknown origin'}`);
+            blocks.push(`  missing ${result.missing.length} required key(s) in ${packsDir}/${locale}.json:\n` +
+                annotated.join('\n'));
+        }
+        if (blocks.length > 0) {
+            localeErrorBlocks.push(`Locale "${locale}":\n${blocks.join('\n')}`);
+        }
+        if (result.orphaned.length > 0) {
+            console.warn(`[label-pack-loader] Locale "${locale}": ${result.orphaned.length} ` +
+                `orphaned key(s) in ${locale}.json (declared in pack but not consumed ` +
+                `by any section or page manifest):\n  ${result.orphaned.join('\n  ')}`);
+        }
+    }
+    if (localeErrorBlocks.length > 0) {
+        throw new Error(`[label-pack-loader] Label pack validation failed for ` +
+            `${localeErrorBlocks.length} locale(s):\n\n${localeErrorBlocks.join('\n\n')}`);
+    }
+}
+/**
+ * Build a `keyString -> "page <pageRef> meta titleKey" | "section <sectionRef> in page <pageRef>"`
+ * lookup so the assert message can name the call site that committed
+ * to each missing key. Pure and small (cost is O(totalKeys) per build
+ * — bounded by the marketing surface).
+ */
+function buildKeyOriginMap(manifests, expectedKeysBySectionRef, chromeLabelKeys) {
+    const origins = new Map();
+    for (const manifest of manifests) {
+        const pageRefStr = manifest.ref;
+        const titleKey = manifest.metaLabelKeys.titleKey;
+        const descriptionKey = manifest.metaLabelKeys.descriptionKey;
+        if (!origins.has(titleKey)) {
+            origins.set(titleKey, `page "${pageRefStr}" metaLabelKeys.titleKey`);
+        }
+        if (!origins.has(descriptionKey)) {
+            origins.set(descriptionKey, `page "${pageRefStr}" metaLabelKeys.descriptionKey`);
+        }
+        for (const sectionRef of manifest.sectionRefs) {
+            const sectionRefStr = sectionRef;
+            const sectionKeys = expectedKeysBySectionRef.get(sectionRef);
+            if (sectionKeys === undefined)
+                continue;
+            for (const sectionKey of sectionKeys) {
+                const keyStr = sectionKey;
+                if (!origins.has(keyStr)) {
+                    origins.set(keyStr, `section "${sectionRefStr}" in page "${pageRefStr}"`);
+                }
+            }
+        }
+    }
+    for (const chromeKey of chromeLabelKeys) {
+        const keyStr = chromeKey;
+        if (!origins.has(keyStr)) {
+            origins.set(keyStr, `WebsiteRootConfig.chromeLabelKeys`);
+        }
+    }
+    return origins;
+}
+/**
+ * Defensive shape guard. Surface the offending key + observed type
+ * so the consumer can find the malformed entry quickly. Pure
+ * validation — no transformation; the returned value is the same
+ * object reference passed in (cast to `LabelPack`) so the caller
+ * does not pay an unnecessary copy.
+ */
+function assertLabelPackShape(parsed, filePath, locale) {
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`[label-pack-loader] ${filePath} (locale="${locale}") must contain a ` +
+            `JSON object at the top level (got ${describeJson(parsed)}).`);
+    }
+    for (const [key, value] of Object.entries(parsed)) {
+        if (typeof value !== 'string') {
+            throw new Error(`[label-pack-loader] ${filePath} (locale="${locale}"): key "${key}" ` +
+                `must map to a string (got ${describeJson(value)}).`);
+        }
+    }
+    return parsed;
+}
+function describeJson(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+/** @wildo_source:part:end saas.website.astro.label-loader */
+//# sourceMappingURL=label-pack-loader.js.map

package/dist/esm/astro/label-pack-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-pack-loader.js","sourceRoot":"","sources":["../../../../src/astro/label-pack-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\n\nimport type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport type { WebsiteLabelKey } from '../schemas/label-keys/website-label-key.schemas';\nimport type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';\nimport type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';\nimport {\n  validateLabelPackAgainstManifest,\n  type ExpectedLabelKeysBySectionRef,\n  type LabelPack,\n  type LabelPackValidationResult,\n} from '../schemas/validators/label-pack.validator';\n\nimport type { WebsiteSiteContext } from './website-site-context';\n\n/**\n * @wildo_source:part:start saas.website.astro.label-loader facet:layer:astro facet:family:website\n *\n * `label-pack-loader.ts` — synchronous, fs-backed loader for\n * marketing-site label packs. Consumed by:\n *   - the Astro adapter (`WebsitePageBridge.astro` reads the active\n *     locale's pack at request time during SSR / pre-render),\n *   - the `wildo website audit` CLI (Phase 7) to validate every\n *     locale pack against every manifest at CI time,\n *   - any build-time hook that wants to fail fast on a missing or\n *     malformed pack.\n *\n * **Convention** (matches the slice plan + the validator's contract):\n *\n *   - One file per locale: `<packsDir>/<locale>.json`\n *   - JSON object: flat key-value map, `Record<string, string>`\n *   - Keys are fully-composed `WebsiteLabelKey`s (`website.<page>.<section>.<slot>`)\n *   - Values are the localized strings\n *\n * **Why synchronous I/O**:\n *   - The Astro frontmatter executes at build / SSR time in a Node\n *     process (no event loop pressure to relieve), and the bridge\n *     wants the pack resolved before it emits any HTML — async would\n *     force the consumer to `await` inside an Astro frontmatter,\n *     which is supported but adds a needless yield-point on a single\n *     small JSON file.\n *   - The validator is pure and synchronous; making the loader async\n *     would add a coloring boundary for no benefit.\n *\n * **Failure modes — all surfaced as thrown errors with actionable\n * messages**:\n *   - File missing — wrapped in a `[label-pack-loader] Could not read\n *     pack at <path>` error so a typo in the dir / locale is obvious.\n *   - JSON parse failure — error includes the file path and the\n *     parser's own message.\n *   - Top-level shape is not an object, or a value is not a string —\n *     error names the offending key + observed type.\n *\n * **Why three exports** (loader, multi-loader, validator-runner):\n *   - `loadLabelPack(packsDir, locale)` is the atomic primitive\n *     (one file → one validated `LabelPack`). Used by the bridge at\n *     request time.\n *   - `loadAllLabelPacks(packsDir, siteContext)` is the build-time\n *     batch — every locale pack at once. Used by the CLI auditor\n *     and by the build-start hook.\n *   - `validateAllLabelPacks(packsDir, siteContext, expectedKeysBySectionRef)`\n *     is the highest-level entry point: load every pack, run the\n *     validator on each, and either return the diagnostic results\n *     or throw on the first hard error. The returned shape carries\n *     per-locale diagnostics so the caller can format a CLI report.\n *\n * **`siteContext` parameter** — the consumer's composed\n * `WebsiteSiteContext` (see `website-site-context.ts`). The loader\n * reads `siteContext.websiteConfig.locales` for \"which locales does\n * the site ship?\" and `siteContext.rootConfig.{pageManifests,\n * chromeLabelKeys, skipToMainContentLabelKey}` for the manifest\n * registry / chrome-key set the validator runs against.\n */\n\n/**\n * Load and validate a single locale's label pack. Synchronous —\n * suitable for Astro frontmatter execution.\n *\n * @param packsDir Absolute or cwd-relative path to the directory\n *                 containing per-locale `<locale>.json` files.\n * @param locale   The locale to load. Must be a member of\n *                 `WildoMarketingWebsiteConfig.locales`.\n * @returns A flat `LabelPack` (`Record<string, string>`) ready to\n *          feed into `WebsiteRuntimeContextValue.labelPack`.\n * @throws  When the file is missing, malformed JSON, not an object,\n *          or contains a non-string value.\n */\nexport function loadLabelPack(packsDir: string, locale: AvailableLanguage): LabelPack {\n  const filePath = resolve(packsDir, `${locale}.json`);\n\n  let raw: string;\n  try {\n    raw = readFileSync(filePath, 'utf-8');\n  } catch (cause) {\n    throw new Error(\n      `[label-pack-loader] Could not read label pack at ${filePath} ` +\n        `(locale=\"${locale}\"). ` +\n        `Make sure the directory exists and contains a \"${locale}.json\" file. ` +\n        `Underlying error: ${(cause as Error).message}`,\n      { cause },\n    );\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (cause) {\n    throw new Error(\n      `[label-pack-loader] Failed to parse JSON in ${filePath} ` +\n        `(locale=\"${locale}\"). Underlying parser error: ${(cause as Error).message}`,\n      { cause },\n    );\n  }\n\n  return assertLabelPackShape(parsed, filePath, locale);\n}\n\n/**\n * Batch loader — every locale declared on the site at once. The map\n * iteration order matches the declaration order of\n * `siteContext.websiteConfig.locales` so CLI reports come out in a\n * deterministic, authored sequence.\n */\nexport function loadAllLabelPacks(\n  packsDir: string,\n  siteContext: WebsiteSiteContext,\n): Map<AvailableLanguage, LabelPack> {\n  const packs = new Map<AvailableLanguage, LabelPack>();\n  for (const entry of siteContext.websiteConfig.locales) {\n    packs.set(entry.locale, loadLabelPack(packsDir, entry.locale));\n  }\n  return packs;\n}\n\n/**\n * Per-locale validation result — the validator's flat output extended\n * with the locale tag so a multi-locale report can flatten + group.\n */\nexport interface LocaleLabelPackValidation {\n  locale: AvailableLanguage;\n  result: LabelPackValidationResult;\n}\n\n/**\n * Highest-level entry point: load every locale's pack and run the\n * label-pack validator against the manifest registry.\n *\n * **Return shape decision** — this function does NOT throw on\n * `missing` keys; it returns the per-locale results so the caller\n * (the build-start hook OR the CLI auditor OR a debugging\n * subprocess) can decide how to surface the failure (process exit\n * code, formatted CLI output, JSON report, …). A thin `throwIfAny…`\n * helper sits next to it for the common \"fail the build on first\n * missing key\" path.\n */\nexport function loadAndValidateAllLabelPacks(\n  packsDir: string,\n  siteContext: WebsiteSiteContext,\n  expectedKeysBySectionRef: ExpectedLabelKeysBySectionRef,\n): readonly LocaleLabelPackValidation[] {\n  const { rootConfig } = siteContext;\n  const packs = loadAllLabelPacks(packsDir, siteContext);\n  const manifests: readonly WebsitePageManifest[] = rootConfig.pageManifests;\n  const effectiveChromeKeys = composeEffectiveChromeLabelKeys(rootConfig);\n\n  const validations: LocaleLabelPackValidation[] = [];\n  for (const [locale, pack] of packs) {\n    validations.push({\n      locale,\n      result: validateLabelPackAgainstManifest(\n        manifests,\n        expectedKeysBySectionRef,\n        pack,\n        effectiveChromeKeys,\n      ),\n    });\n  }\n  return validations;\n}\n\n/**\n * Compose the chrome-label-key set the validator should treat as\n * \"expected\" — `WebsiteRootConfig.chromeLabelKeys` (consumer-authored)\n * UNION the framework-required `skipToMainContentLabelKey`.\n *\n * Centralized here because:\n *   - Both `loadAndValidateAllLabelPacks` (used at build time) and\n *     `buildKeyOriginMap` (used to annotate missing-key errors) need\n *     the same composed list, and forking the union into two places\n *     would be a drift hazard.\n *   - The framework owns the skip-link key (it is rendered by\n *     `WebsitePageLayout`, not the consumer's chrome), so the\n *     consumer should NOT have to remember to also list it in\n *     `chromeLabelKeys`. Auto-injection here keeps the contract\n *     minimal at the consumer's call site (just declare the key in\n *     `WebsiteRootConfig.skipToMainContentLabelKey` once + ship the\n *     translation in every locale pack) while still surfacing the key\n *     through the validator's \"missing\"/\"orphaned\" diagnostics.\n *   - De-duplication is via `Set` semantics so a consumer who\n *     defensively lists the key in both places (no-op but harmless)\n *     does not produce a duplicate-key warning downstream.\n */\nfunction composeEffectiveChromeLabelKeys(\n  rootConfig: WebsiteRootConfig,\n): readonly WebsiteLabelKey[] {\n  const set = new Set<WebsiteLabelKey>(rootConfig.chromeLabelKeys);\n  set.add(rootConfig.skipToMainContentLabelKey);\n  return Array.from(set);\n}\n\n/**\n * Convenience wrapper for the build-start hook: validates every\n * declared locale's pack and throws a SINGLE aggregated error if any\n * locale has a hard failure (`missing` keys or `unmappedSectionRefs`).\n * Orphaned keys are logged via `console.warn` (soft warning per the\n * validator's contract) but do NOT throw.\n *\n * **Why aggregate (not first-fail)**: a multi-locale marketing site\n * with `en` and `fr` packs both missing keys would, under a\n * first-fail policy, force the author to fix `en`, re-run the build,\n * THEN see `fr`'s problem. Aggregating means one build run surfaces\n * every locale's hard errors together — material UX win for the\n * authoring loop. The aggregated message keeps each locale's failure\n * in its own block so the diagnostic stays scannable.\n *\n * **Why throw vs. return**: the build-start hook lives in\n * `astro.config.mjs` (or a `vite-plugin`-style integration) and\n * benefits from the shortest possible code path — a thrown error\n * naturally aborts `astro build` with a non-zero exit code and\n * surfaces the message in the build log. The richer\n * `loadAndValidateAllLabelPacks` is what `wildo website audit` calls\n * when it wants programmatic access to the per-locale results.\n *\n * **Key-origin annotation**: every `missing` key is tagged with the\n * page (and, if section-scoped, the section) that declared it, so the\n * author can grep + open the right `defineWebsiteSection` /\n * `defineWebsitePageManifest` call site without leaving the build log.\n */\nexport function assertLabelPacksValid(\n  packsDir: string,\n  siteContext: WebsiteSiteContext,\n  expectedKeysBySectionRef: ExpectedLabelKeysBySectionRef,\n): void {\n  const { rootConfig } = siteContext;\n  const validations = loadAndValidateAllLabelPacks(\n    packsDir,\n    siteContext,\n    expectedKeysBySectionRef,\n  );\n\n  /**\n   * Build a key → origin map ONCE per assert call (cost is bounded by\n   * the total number of declared keys across the whole site, which is\n   * typically small for a marketing surface). Enriches the missing-key\n   * error with the page/section that committed to each key — the\n   * author can grep the ref to find the site authoring call site.\n   */\n  const keyOrigins = buildKeyOriginMap(\n    rootConfig.pageManifests,\n    expectedKeysBySectionRef,\n    composeEffectiveChromeLabelKeys(rootConfig),\n  );\n\n  const localeErrorBlocks: string[] = [];\n\n  for (const { locale, result } of validations) {\n    const blocks: string[] = [];\n    if (result.unmappedSectionRefs.length > 0) {\n      blocks.push(\n        `  unmappedSectionRefs (build-pipeline bug — sections referenced by a ` +\n          `manifest but missing from the expected-keys collector): ` +\n          `[${(result.unmappedSectionRefs as unknown as readonly string[]).join(', ')}]. ` +\n          `Add every referenced section to the array passed to ` +\n          `collectExpectedLabelKeysFromSections().`,\n      );\n    }\n    if (result.missing.length > 0) {\n      const annotated = (result.missing as unknown as readonly string[]).map(\n        (key) => `    \"${key}\"  ← ${keyOrigins.get(key) ?? 'unknown origin'}`,\n      );\n      blocks.push(\n        `  missing ${result.missing.length} required key(s) in ${packsDir}/${locale}.json:\\n` +\n          annotated.join('\\n'),\n      );\n    }\n    if (blocks.length > 0) {\n      localeErrorBlocks.push(`Locale \"${locale}\":\\n${blocks.join('\\n')}`);\n    }\n    if (result.orphaned.length > 0) {\n      console.warn(\n        `[label-pack-loader] Locale \"${locale}\": ${result.orphaned.length} ` +\n          `orphaned key(s) in ${locale}.json (declared in pack but not consumed ` +\n          `by any section or page manifest):\\n  ${result.orphaned.join('\\n  ')}`,\n      );\n    }\n  }\n\n  if (localeErrorBlocks.length > 0) {\n    throw new Error(\n      `[label-pack-loader] Label pack validation failed for ` +\n        `${localeErrorBlocks.length} locale(s):\\n\\n${localeErrorBlocks.join('\\n\\n')}`,\n    );\n  }\n}\n\n/**\n * Build a `keyString -> \"page <pageRef> meta titleKey\" | \"section <sectionRef> in page <pageRef>\"`\n * lookup so the assert message can name the call site that committed\n * to each missing key. Pure and small (cost is O(totalKeys) per build\n * — bounded by the marketing surface).\n */\nfunction buildKeyOriginMap(\n  manifests: readonly WebsitePageManifest[],\n  expectedKeysBySectionRef: ExpectedLabelKeysBySectionRef,\n  chromeLabelKeys: readonly WebsiteLabelKey[],\n): Map<string, string> {\n  const origins = new Map<string, string>();\n  for (const manifest of manifests) {\n    const pageRefStr = manifest.ref as unknown as string;\n    const titleKey = manifest.metaLabelKeys.titleKey as unknown as string;\n    const descriptionKey = manifest.metaLabelKeys.descriptionKey as unknown as string;\n    if (!origins.has(titleKey)) {\n      origins.set(titleKey, `page \"${pageRefStr}\" metaLabelKeys.titleKey`);\n    }\n    if (!origins.has(descriptionKey)) {\n      origins.set(descriptionKey, `page \"${pageRefStr}\" metaLabelKeys.descriptionKey`);\n    }\n    for (const sectionRef of manifest.sectionRefs) {\n      const sectionRefStr = sectionRef as unknown as string;\n      const sectionKeys = expectedKeysBySectionRef.get(sectionRef);\n      if (sectionKeys === undefined) continue;\n      for (const sectionKey of sectionKeys) {\n        const keyStr = sectionKey as unknown as string;\n        if (!origins.has(keyStr)) {\n          origins.set(keyStr, `section \"${sectionRefStr}\" in page \"${pageRefStr}\"`);\n        }\n      }\n    }\n  }\n  for (const chromeKey of chromeLabelKeys) {\n    const keyStr = chromeKey as unknown as string;\n    if (!origins.has(keyStr)) {\n      origins.set(keyStr, `WebsiteRootConfig.chromeLabelKeys`);\n    }\n  }\n  return origins;\n}\n\n/**\n * Defensive shape guard. Surface the offending key + observed type\n * so the consumer can find the malformed entry quickly. Pure\n * validation — no transformation; the returned value is the same\n * object reference passed in (cast to `LabelPack`) so the caller\n * does not pay an unnecessary copy.\n */\nfunction assertLabelPackShape(\n  parsed: unknown,\n  filePath: string,\n  locale: AvailableLanguage,\n): LabelPack {\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new Error(\n      `[label-pack-loader] ${filePath} (locale=\"${locale}\") must contain a ` +\n        `JSON object at the top level (got ${describeJson(parsed)}).`,\n    );\n  }\n  for (const [key, value] of Object.entries(parsed)) {\n    if (typeof value !== 'string') {\n      throw new Error(\n        `[label-pack-loader] ${filePath} (locale=\"${locale}\"): key \"${key}\" ` +\n          `must map to a string (got ${describeJson(value)}).`,\n      );\n    }\n  }\n  return parsed as LabelPack;\n}\n\nfunction describeJson(value: unknown): string {\n  if (value === null) return 'null';\n  if (Array.isArray(value)) return 'array';\n  return typeof value;\n}\n/** @wildo_source:part:end saas.website.astro.label-loader */\n"]}

package/dist/esm/astro/llms-txt-server.d.ts

@@ -0,0 +1,28 @@
+import type { WebsiteSiteContext } from './website-site-context';
+export interface ReadLlmsTxtBodyOptions {
+    /**
+     * Directory containing the hand-authored `llms.txt` file. Defaults
+     * to the conventional `./src/content` path from the website package
+     * root.
+     */
+    contentDir?: string;
+    /**
+     * File name under `contentDir`. Exposed for tests; consumers should
+     * stick to the canonical `llms.txt`.
+     */
+    fileName?: string;
+}
+/**
+ * @wildo_source:part:start saas.website.astro.llms-txt-server facet:layer:astro facet:family:website
+ *
+ * Read the hand-authored `llms.txt` body for the marketing site.
+ *
+ * Publication policy:
+ * - `seo.llmsTxt?.enabled === false` → return `null`
+ * - `seo.llmsTxt?.enabled === true`  → read the file if present, else `null`
+ * - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
+ *   publish when the file exists, otherwise return `null`
+ */
+export declare function readLlmsTxtBody(siteContext: WebsiteSiteContext, options?: ReadLlmsTxtBodyOptions): string | null;
+/** @wildo_source:part:end saas.website.astro.llms-txt-server */
+//# sourceMappingURL=llms-txt-server.d.ts.map

package/dist/esm/astro/llms-txt-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt-server.d.ts","sourceRoot":"","sources":["../../../../src/astro/llms-txt-server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,IAAI,CAqBf;AACD,gEAAgE"}

package/dist/esm/astro/llms-txt-server.js

@@ -0,0 +1,33 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * @wildo_source:part:start saas.website.astro.llms-txt-server facet:layer:astro facet:family:website
+ *
+ * Read the hand-authored `llms.txt` body for the marketing site.
+ *
+ * Publication policy:
+ * - `seo.llmsTxt?.enabled === false` → return `null`
+ * - `seo.llmsTxt?.enabled === true`  → read the file if present, else `null`
+ * - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
+ *   publish when the file exists, otherwise return `null`
+ */
+export function readLlmsTxtBody(siteContext, options = {}) {
+    const contentDir = options.contentDir ?? './src/content';
+    const fileName = options.fileName ?? 'llms.txt';
+    const filePath = resolve(contentDir, fileName);
+    if (siteContext.rootConfig.seo.llmsTxt?.enabled === false) {
+        return null;
+    }
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        return readFileSync(filePath, 'utf-8');
+    }
+    catch (cause) {
+        throw new Error(`[llms-txt-server] Could not read llms.txt at ${filePath}. ` +
+            `Underlying error: ${cause.message}`, { cause });
+    }
+}
+/** @wildo_source:part:end saas.website.astro.llms-txt-server */
+//# sourceMappingURL=llms-txt-server.js.map

package/dist/esm/astro/llms-txt-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt-server.js","sourceRoot":"","sources":["../../../../src/astro/llms-txt-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,WAA+B,EAC/B,UAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE/C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,gDAAgD,QAAQ,IAAI;YAC1D,qBAAsB,KAAe,CAAC,OAAO,EAAE,EACjD,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AACD,gEAAgE","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { resolve } from 'node:path';\n\nimport type { WebsiteSiteContext } from './website-site-context';\n\nexport interface ReadLlmsTxtBodyOptions {\n  /**\n   * Directory containing the hand-authored `llms.txt` file. Defaults\n   * to the conventional `./src/content` path from the website package\n   * root.\n   */\n  contentDir?: string;\n  /**\n   * File name under `contentDir`. Exposed for tests; consumers should\n   * stick to the canonical `llms.txt`.\n   */\n  fileName?: string;\n}\n\n/**\n * @wildo_source:part:start saas.website.astro.llms-txt-server facet:layer:astro facet:family:website\n *\n * Read the hand-authored `llms.txt` body for the marketing site.\n *\n * Publication policy:\n * - `seo.llmsTxt?.enabled === false` → return `null`\n * - `seo.llmsTxt?.enabled === true`  → read the file if present, else `null`\n * - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:\n *   publish when the file exists, otherwise return `null`\n */\nexport function readLlmsTxtBody(\n  siteContext: WebsiteSiteContext,\n  options: ReadLlmsTxtBodyOptions = {},\n): string | null {\n  const contentDir = options.contentDir ?? './src/content';\n  const fileName = options.fileName ?? 'llms.txt';\n  const filePath = resolve(contentDir, fileName);\n\n  if (siteContext.rootConfig.seo.llmsTxt?.enabled === false) {\n    return null;\n  }\n  if (!existsSync(filePath)) {\n    return null;\n  }\n\n  try {\n    return readFileSync(filePath, 'utf-8');\n  } catch (cause) {\n    throw new Error(\n      `[llms-txt-server] Could not read llms.txt at ${filePath}. ` +\n        `Underlying error: ${(cause as Error).message}`,\n      { cause },\n    );\n  }\n}\n/** @wildo_source:part:end saas.website.astro.llms-txt-server */\n"]}

package/dist/esm/astro/pick-labels-for-page.d.ts

@@ -0,0 +1,63 @@
+import type { WebsiteLabelKey } from '../schemas/label-keys/website-label-key.schemas';
+import type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';
+import type { LabelPack } from '../schemas/validators/label-pack.validator';
+/**
+ * @wildo_source:part:start saas.website.astro.pick-labels-for-page facet:layer:astro facet:family:website
+ *
+ * `pickLabelsForPage(pack, manifest)` — return the subset of a loaded
+ * label pack that the given page actually consumes at render time.
+ *
+ * **Why this exists**: the per-page bridge island carries its
+ * `labelPack` prop across the SSR → client hydration boundary as
+ * serialized JSON inside the `<astro-island props=...>` attribute.
+ * Shipping the entire site's pack on every page (every locale × every
+ * page = every visitor pays the full pack) inflates the static HTML
+ * payload by ~70% on a typical marketing surface where each page reads
+ * only its own slice plus the shared chrome slice.
+ *
+ * **Filter rule** (matches the runtime contract enforced by
+ * `useWebsiteLabel` / `useWebsiteLabelByKey`):
+ *   - Keep keys starting with `website.<manifest.ref>.` — every key a
+ *     `useWebsiteLabel(slot)` call inside any of this page's sections
+ *     can ever resolve to (the hook composes
+ *     `website.<pageRef>.<sectionRef>.<slot>`).
+ *   - Keep keys starting with `website.chrome.` — the synthetic
+ *     namespace site-wide chrome (header / footer) reads via
+ *     `useWebsiteLabelByKey(absoluteKey)`. The chrome contract is
+ *     declared on `WebsiteRootConfig.chromeLabelKeys` and validated
+ *     by the label-pack validator.
+ *
+ * **What gets dropped**: every `website.<otherPage>.…` key. A page
+ * cannot legitimately read another page's labels through the hook
+ * surface — the hook would either throw (`useWebsiteLabel`) or
+ * surface a missing-key diagnostic (`useWebsiteLabelByKey`) — so
+ * dropping those keys is observably safe.
+ *
+ * **Why prefix-based** (vs. walking `expectedKeysBySectionRef` for an
+ * exact key list): prefix matching is O(N) over `Object.entries(pack)`
+ * with no extra inputs threaded through `loadWebsitePageRuntime`. An
+ * exact-list filter would need to know the section-key map at request
+ * time, forcing every consumer's `.astro` page to import the
+ * collected map — extra config-surface for a tighter filter that
+ * saves an additional handful of bytes (the section keys for the
+ * page would already match the prefix).
+ *
+ * **Pure**: no I/O, no observable side-effects. Returns a fresh
+ * object — the input `pack` reference is not mutated.
+ *
+ * @param pack The full loaded label pack for the active locale.
+ * @param manifest The page manifest being rendered (drives the
+ *                 `website.<manifest.ref>.*` page-own prefix).
+ * @param explicitKeys OPTIONAL allow-list of additional fully-composed
+ *                     label keys to keep regardless of prefix. Used by
+ *                     the framework to guarantee that
+ *                     `WebsiteRootConfig.skipToMainContentLabelKey`
+ *                     reaches the bridge even if a consumer chose to
+ *                     namespace it outside `website.chrome.*` (the
+ *                     framework MUST be able to render the skip link
+ *                     on every page in every locale — Phase 6 audit
+ *                     fix M-α).
+ */
+export declare function pickLabelsForPage(pack: LabelPack, manifest: WebsitePageManifest, explicitKeys?: readonly WebsiteLabelKey[]): LabelPack;
+/** @wildo_source:part:end saas.website.astro.pick-labels-for-page */
+//# sourceMappingURL=pick-labels-for-page.d.ts.map

package/dist/esm/astro/pick-labels-for-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-labels-for-page.d.ts","sourceRoot":"","sources":["../../../../src/astro/pick-labels-for-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,mBAAmB,EAC7B,YAAY,GAAE,SAAS,eAAe,EAAO,GAC5C,SAAS,CAkBX;AACD,qEAAqE"}

package/dist/esm/astro/pick-labels-for-page.js

@@ -0,0 +1,73 @@
+/**
+ * @wildo_source:part:start saas.website.astro.pick-labels-for-page facet:layer:astro facet:family:website
+ *
+ * `pickLabelsForPage(pack, manifest)` — return the subset of a loaded
+ * label pack that the given page actually consumes at render time.
+ *
+ * **Why this exists**: the per-page bridge island carries its
+ * `labelPack` prop across the SSR → client hydration boundary as
+ * serialized JSON inside the `<astro-island props=...>` attribute.
+ * Shipping the entire site's pack on every page (every locale × every
+ * page = every visitor pays the full pack) inflates the static HTML
+ * payload by ~70% on a typical marketing surface where each page reads
+ * only its own slice plus the shared chrome slice.
+ *
+ * **Filter rule** (matches the runtime contract enforced by
+ * `useWebsiteLabel` / `useWebsiteLabelByKey`):
+ *   - Keep keys starting with `website.<manifest.ref>.` — every key a
+ *     `useWebsiteLabel(slot)` call inside any of this page's sections
+ *     can ever resolve to (the hook composes
+ *     `website.<pageRef>.<sectionRef>.<slot>`).
+ *   - Keep keys starting with `website.chrome.` — the synthetic
+ *     namespace site-wide chrome (header / footer) reads via
+ *     `useWebsiteLabelByKey(absoluteKey)`. The chrome contract is
+ *     declared on `WebsiteRootConfig.chromeLabelKeys` and validated
+ *     by the label-pack validator.
+ *
+ * **What gets dropped**: every `website.<otherPage>.…` key. A page
+ * cannot legitimately read another page's labels through the hook
+ * surface — the hook would either throw (`useWebsiteLabel`) or
+ * surface a missing-key diagnostic (`useWebsiteLabelByKey`) — so
+ * dropping those keys is observably safe.
+ *
+ * **Why prefix-based** (vs. walking `expectedKeysBySectionRef` for an
+ * exact key list): prefix matching is O(N) over `Object.entries(pack)`
+ * with no extra inputs threaded through `loadWebsitePageRuntime`. An
+ * exact-list filter would need to know the section-key map at request
+ * time, forcing every consumer's `.astro` page to import the
+ * collected map — extra config-surface for a tighter filter that
+ * saves an additional handful of bytes (the section keys for the
+ * page would already match the prefix).
+ *
+ * **Pure**: no I/O, no observable side-effects. Returns a fresh
+ * object — the input `pack` reference is not mutated.
+ *
+ * @param pack The full loaded label pack for the active locale.
+ * @param manifest The page manifest being rendered (drives the
+ *                 `website.<manifest.ref>.*` page-own prefix).
+ * @param explicitKeys OPTIONAL allow-list of additional fully-composed
+ *                     label keys to keep regardless of prefix. Used by
+ *                     the framework to guarantee that
+ *                     `WebsiteRootConfig.skipToMainContentLabelKey`
+ *                     reaches the bridge even if a consumer chose to
+ *                     namespace it outside `website.chrome.*` (the
+ *                     framework MUST be able to render the skip link
+ *                     on every page in every locale — Phase 6 audit
+ *                     fix M-α).
+ */
+export function pickLabelsForPage(pack, manifest, explicitKeys = []) {
+    const pagePrefix = `website.${manifest.ref}.`;
+    const chromePrefix = 'website.chrome.';
+    const explicitKeySet = new Set(explicitKeys.map((key) => key));
+    const filtered = {};
+    for (const [key, value] of Object.entries(pack)) {
+        if (key.startsWith(pagePrefix) ||
+            key.startsWith(chromePrefix) ||
+            explicitKeySet.has(key)) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/** @wildo_source:part:end saas.website.astro.pick-labels-for-page */
+//# sourceMappingURL=pick-labels-for-page.js.map

package/dist/esm/astro/pick-labels-for-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-labels-for-page.js","sourceRoot":"","sources":["../../../../src/astro/pick-labels-for-page.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAe,EACf,QAA6B,EAC7B,eAA2C,EAAE;IAE7C,MAAM,UAAU,GAAG,WAAW,QAAQ,CAAC,GAAwB,GAAG,CAAC;IACnE,MAAM,YAAY,GAAG,iBAAiB,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAwB,CAAC,CACpD,CAAC;IAEF,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IACE,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;YAC1B,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;YAC5B,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EACvB,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AACD,qEAAqE","sourcesContent":["import type { WebsiteLabelKey } from '../schemas/label-keys/website-label-key.schemas';\nimport type { WebsitePageManifest } from '../schemas/manifests/website-page-manifest.shared.schemas';\nimport type { LabelPack } from '../schemas/validators/label-pack.validator';\n\n/**\n * @wildo_source:part:start saas.website.astro.pick-labels-for-page facet:layer:astro facet:family:website\n *\n * `pickLabelsForPage(pack, manifest)` — return the subset of a loaded\n * label pack that the given page actually consumes at render time.\n *\n * **Why this exists**: the per-page bridge island carries its\n * `labelPack` prop across the SSR → client hydration boundary as\n * serialized JSON inside the `<astro-island props=...>` attribute.\n * Shipping the entire site's pack on every page (every locale × every\n * page = every visitor pays the full pack) inflates the static HTML\n * payload by ~70% on a typical marketing surface where each page reads\n * only its own slice plus the shared chrome slice.\n *\n * **Filter rule** (matches the runtime contract enforced by\n * `useWebsiteLabel` / `useWebsiteLabelByKey`):\n *   - Keep keys starting with `website.<manifest.ref>.` — every key a\n *     `useWebsiteLabel(slot)` call inside any of this page's sections\n *     can ever resolve to (the hook composes\n *     `website.<pageRef>.<sectionRef>.<slot>`).\n *   - Keep keys starting with `website.chrome.` — the synthetic\n *     namespace site-wide chrome (header / footer) reads via\n *     `useWebsiteLabelByKey(absoluteKey)`. The chrome contract is\n *     declared on `WebsiteRootConfig.chromeLabelKeys` and validated\n *     by the label-pack validator.\n *\n * **What gets dropped**: every `website.<otherPage>.…` key. A page\n * cannot legitimately read another page's labels through the hook\n * surface — the hook would either throw (`useWebsiteLabel`) or\n * surface a missing-key diagnostic (`useWebsiteLabelByKey`) — so\n * dropping those keys is observably safe.\n *\n * **Why prefix-based** (vs. walking `expectedKeysBySectionRef` for an\n * exact key list): prefix matching is O(N) over `Object.entries(pack)`\n * with no extra inputs threaded through `loadWebsitePageRuntime`. An\n * exact-list filter would need to know the section-key map at request\n * time, forcing every consumer's `.astro` page to import the\n * collected map — extra config-surface for a tighter filter that\n * saves an additional handful of bytes (the section keys for the\n * page would already match the prefix).\n *\n * **Pure**: no I/O, no observable side-effects. Returns a fresh\n * object — the input `pack` reference is not mutated.\n *\n * @param pack The full loaded label pack for the active locale.\n * @param manifest The page manifest being rendered (drives the\n *                 `website.<manifest.ref>.*` page-own prefix).\n * @param explicitKeys OPTIONAL allow-list of additional fully-composed\n *                     label keys to keep regardless of prefix. Used by\n *                     the framework to guarantee that\n *                     `WebsiteRootConfig.skipToMainContentLabelKey`\n *                     reaches the bridge even if a consumer chose to\n *                     namespace it outside `website.chrome.*` (the\n *                     framework MUST be able to render the skip link\n *                     on every page in every locale — Phase 6 audit\n *                     fix M-α).\n */\nexport function pickLabelsForPage(\n  pack: LabelPack,\n  manifest: WebsitePageManifest,\n  explicitKeys: readonly WebsiteLabelKey[] = [],\n): LabelPack {\n  const pagePrefix = `website.${manifest.ref as unknown as string}.`;\n  const chromePrefix = 'website.chrome.';\n  const explicitKeySet = new Set<string>(\n    explicitKeys.map((key) => key as unknown as string),\n  );\n\n  const filtered: LabelPack = {};\n  for (const [key, value] of Object.entries(pack)) {\n    if (\n      key.startsWith(pagePrefix) ||\n      key.startsWith(chromePrefix) ||\n      explicitKeySet.has(key)\n    ) {\n      filtered[key] = value;\n    }\n  }\n  return filtered;\n}\n/** @wildo_source:part:end saas.website.astro.pick-labels-for-page */\n"]}