@wildo-ai/saas-website 1.1.1 → 1.1.3

package/dist/esm/config/wildo-website-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wildo-website-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/wildo-website-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+GG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAEvF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;kBASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iCAAiC;IAE1C;;;;;;;;;;OAUG;;IASH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;;;;OAsBG;;IAWH;;;;;OAKG;;;;;;;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;;;;kBAqDH,CAAC;AACL,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AACjG,wDAAwD"}
+{"version":3,"file":"wildo-website-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/config/wildo-website-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsHG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAEvF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;kBASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iCAAiC;IAE1C;;;;;;;;;;OAUG;;IASH;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;;;;;;;;OAsBG;;IAWH;;;;;OAKG;;;;;;;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;;;;kBAqDH,CAAC;AACL,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AACjG,wDAAwD"}

package/dist/esm/config/wildo-website-config.schemas.js

@@ -16,11 +16,18 @@
  *     `<link rel="canonical">`, `og:url`, hreflang `href` URLs and
  *     the structured-data `mainEntityOfPage`. The previous
  *     `WebsiteRootConfig.seo.siteOrigin` was deleted.
- *   - `appOrigin` — has NO runtime consumer today. The
- *     marketing → app handoff link surface that will read it does
- *     not exist yet. Authored eagerly so the link-surface PR is a
- *     single framework-owned move; until then the field is exercised
- *     only by the schema parser.
+ *   - `appOrigin` — the marketing → app handoff target, read at runtime
+ *     since #493. A `wildo.website.config.ts` is Node-loaded and so
+ *     invisible to a client island, which is why this value reaches the
+ *     browser the way `apiOrigin` does: the `.astro` page forwards it to
+ *     its bridge island, which puts it on `WebsiteRuntimeContext.appOrigin`
+ *     for the CTA to read.
+ *
+ *     It previously had NO runtime consumer, and a site resolved the app
+ *     origin a SECOND time from a public build-time environment variable —
+ *     one host authored twice with no mechanical link, and a silent
+ *     fallback to localhost when the variable was unset. That is how a
+ *     marketing site comes to point at the wrong environment.
  *   - `csp?` — read by the website-local `sync-nginx-csp` build step,
  *     which merges the app-static posture with `infra.csp?.<serviceKey>`,
  *     emits the generated artifact consumed by Astro pages, and rewrites

package/dist/esm/config/wildo-website-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"wildo-website-config.schemas.js","sourceRoot":"","sources":["../../../../src/config/wildo-website-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @wildo_source:part:start engine.saas-website.config facet:layer:engine facet:family:marketing-website\n *\n * Per-service marketing-website configuration block, authored in\n * the website service folder as `wildo.website.config.ts`.\n *\n * # What this file's loaded value is used for TODAY\n *\n * This schema is the single source of truth for the marketing-site routing\n * and origin surface. Every consumer reads here:\n *\n *   - `defaultLocale` + `locales` — read by `buildAstroI18nConfig(...)`,\n *     `assertLabelPacksValid(...)`, `loadWebsitePageRuntime(...)` and\n *     `renderWebsitePageHeadHtml(...)` via the shared `WebsiteSiteContext`.\n *   - `publicOrigin` — read by the head renderer to compose absolute\n *     `<link rel=\"canonical\">`, `og:url`, hreflang `href` URLs and\n *     the structured-data `mainEntityOfPage`. The previous\n *     `WebsiteRootConfig.seo.siteOrigin` was deleted.\n *   - `appOrigin` — has NO runtime consumer today. The\n *     marketing → app handoff link surface that will read it does\n *     not exist yet. Authored eagerly so the link-surface PR is a\n *     single framework-owned move; until then the field is exercised\n *     only by the schema parser.\n *   - `csp?` — read by the website-local `sync-nginx-csp` build step,\n *     which merges the app-static posture with `infra.csp?.<serviceKey>`,\n *     emits the generated artifact consumed by Astro pages, and rewrites\n *     the checked-in nginx marker file used by the website Docker image.\n *\n * Future companion subprocesses that introspect the marketing\n * surface (locale-coverage audits, label-pack validation against\n * authored locales, SEO-link sanity checks) will also read here —\n * none exist today.\n *\n * # Why this is per-service website configuration\n *\n * Co-locating the schema with the engine package that owns its semantics\n * keeps three concerns separate from application-root service declarations:\n *\n *   1. **Right reuse axis.** Marketing-site content (locales, SEO origins,\n *      future label-pack overrides, marketing-only CTAs) is conceptually\n *      different from saas-app-level service declarations (`path`,\n *      `serviceName`, `frontendType`, `sessionStorage`). The marketing\n *      config travels with the website service folder, NOT with the\n *      SaaS app root. Two unrelated lifecycles, two different review\n *      audiences.\n *   2. **Engine boundary.** `platform-config-lib` no longer needs to\n *      depend on `@wildo-ai/presets-components-models` (the home of\n *      `AvailableLanguage`) just to type the marketing-site locale\n *      enum. Adding a new website primitive (a new SEO field, a new\n *      locale-pack id) belongs with the website package and its public\n *      configuration contract.\n *   3. **Disambiguator hazard.** The previous root-level\n *      `marketingWebsite?` block silently assumed \"one STATIC_WEBSITE\n *      service per SaaS app\" — but nothing in the schema enforced it.\n *      Two STATIC_WEBSITE services would have silently shared one\n *      config block with no obvious \"which one wins?\" answer. The\n *      application configuration rejects more than one STATIC_WEBSITE (and\n *      TECH_DOC) service, so the per-service config-file lookup is\n *      deterministic by construction.\n *\n * # Schema decisions encoded here\n *\n * - `z.strictObject` so authoring an unknown key surfaces as a parse\n *   error at `defineWebsiteConfig` time instead of being silently\n *   dropped (same posture as `WildoSaasConfigSchema` and\n *   `WildoTechnicalDocConfigSchema`).\n *\n * - **No `enabled` field.** The gate is \"is there a `wildo.website.config.ts`\n *   in a `frontendType: STATIC_WEBSITE` service folder?\" — file\n *   presence under a STATIC_WEBSITE service IS the enable signal.\n *   The Astro build / dev companion / future audit CLI requires the\n *   file when it walks a STATIC_WEBSITE service folder, so a\n *   half-authored config simply cannot exist (the loader fails\n *   closed). Removing the boolean closes a foot-gun: an authored\n *   `enabled: false` block was previously a silent way to keep the\n *   config \"warm\" without shipping anything, and consumers had to\n *   remember to read the flag in addition to the file presence — a\n *   future read-the-config / forget-the-flag bug waiting to happen.\n *   A separate `services.<key>.enabled` pattern (orthogonal to\n *   marketing-website) is the right place for any \"temporarily\n *   disable this service\" story (deferred — see DASHBOARD).\n *\n * - URL fields are `z.url()` (Zod 4 native validator) so we get\n *   protocol + host parsing for free, matching the rest of the\n *   codebase.\n *\n * - `csp?` is typed against `WildoCspConfigSchema` from\n *   `@wildo-ai/platform-config-lib`, mirroring the docs service's\n *   `wildo.tech-doc.config.ts` contract. The parsed value is consumed by\n *   the shared `resolveCspPolicy()` / `emitCspArtifacts()` generator flow.\n *\n * - `defaultLocale ∈ locales` cross-check via `.superRefine` —\n *   keeping `defaultLocale` as a top-level field is product-explicit\n *   (\"which locale URL is the canonical one\") and decouples it from\n *   list ordering. Locale-path uniqueness AND locale-value\n *   uniqueness are also enforced — duplicate paths would silently\n *   overwrite each other in the Astro build and corrupt the sitemap;\n *   duplicate locales would produce duplicate hreflang entries.\n *\n * - Locale primitive is `AvailableLanguage`. The schema imports it\n *   from `@wildo-ai/presets-components-models/public-runtime` (the\n *   side-effect-free public-runtime seam), but **consumers authoring\n *   `wildo.website.config.ts` must import it from\n *   `@wildo-ai/saas-models/public-runtime`**. Both paths produce identical\n *   values; saas-models simply re-exports the presets atom. Picking\n *   one path consistently across consumer files prevents drift in\n *   docs / examples / search results. Values authored in\n *   `wildo.website.config.ts` are the lowercase BCP-47 strings\n *   (`'en'`, `'fr'`), NOT the UPPERCASE TS enum member names\n *   (`EN`, `FR`). `z.enum(AvailableLanguage)` parses against the\n *   enum VALUES, which is what we want.\n */\n\nimport { WildoCspConfigSchema } from '@wildo-ai/platform-config-lib';\nimport { z } from 'zod';\nimport { AvailableLanguage } from '@wildo-ai/presets-components-models/public-runtime';\n\n/**\n * Per-locale configuration. Each authored locale gets one entry.\n *\n * `path` is the locale URL prefix segment (e.g. `'en'`, `'fr'`) — the\n * Astro builder maps `/en/...` and `/fr/...` paths via this value. We\n * do NOT auto-derive `path` from the locale string because some\n * deployments may want a flat root for the default locale (`/...`\n * instead of `/en/...`); keeping it explicit per locale leaves that\n * door open without a config-shape change.\n */\nexport const WebsiteLocaleConfigSchema = z.strictObject({\n  locale: z.enum(AvailableLanguage),\n  path: z\n    .string()\n    .min(1)\n    .regex(\n      /^[a-z0-9-]+$/,\n      'locale path must be lowercase alphanumeric with hyphens (becomes a URL segment)',\n    ),\n});\nexport type WebsiteLocaleConfig = z.infer<typeof WebsiteLocaleConfigSchema>;\n\n/**\n * Per-service marketing-website configuration block.\n *\n * Authored as `export default defineWebsiteConfig({...})` in\n * `<website-service-root>/wildo.website.config.ts`. The Astro\n * build loads this file once at bootstrap via jiti and composes\n * a `WebsiteSiteContext`; helpers consume that composed context rather than\n * this raw value.\n *\n * @example\n * ```ts\n * import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n * import { defineWebsiteConfig } from '@wildo-ai/saas-website';\n *\n * export default defineWebsiteConfig({\n *   publicOrigin: 'https://example.com',\n *   appOrigin: 'https://app.example.com',\n *   defaultLocale: AvailableLanguage.EN,\n *   locales: [\n *     { locale: AvailableLanguage.EN, path: 'en' },\n *     { locale: AvailableLanguage.FR, path: 'fr' },\n *   ],\n *   csp: { enabled: true, reportOnly: true },\n * });\n * ```\n */\nexport const WildoMarketingWebsiteConfigSchema = z\n  .strictObject({\n    /**\n     * Public origin of the marketing site (apex / www) — canonical\n     * input the Astro head renderer emits as absolute URLs\n     * (`<link rel=\"canonical\">`, `og:url`, hreflang `href`,\n     * sitemap base, structured-data `mainEntityOfPage`).\n     *\n     * MUST NOT end with `/` — the head renderer composes\n     * `${publicOrigin}${routePath}` and a trailing slash would emit\n     * `https://example.com//`. Surface the constraint loudly here\n     * rather than silently corrupting URLs at build time.\n     */\n    publicOrigin: z\n      .url()\n      .refine((value) => !value.endsWith('/'), {\n        error:\n          'WildoMarketingWebsiteConfig.publicOrigin must NOT end with \"/\" (the head ' +\n          'renderer concatenates publicOrigin + routePath; trailing slash would emit \"//\")',\n      }),\n\n    /**\n     * Origin of the SaaS application the marketing site links into\n     * (signup / login / pricing → checkout).\n     *\n     * **Today**: NO runtime consumer. The cross-origin handoff\n     * surface that will read it does not exist yet. Authored\n     * eagerly so the link-surface PR is a single framework-owned move\n     * — until then the field is exercised only by the schema\n     * parser.\n     *\n     * Distinct from the general `WildoSaasConfig.services.<name>`\n     * URL surface because the marketing site is a separate Astro\n     * project that does not load the full SaaS app graph at build\n     * time.\n     */\n    appOrigin: z.url(),\n\n    /**\n     * Backend API origin the marketing site POSTs to for anonymous\n     * captures (lead / draft-note forms) — e.g.\n     * `https://api.example.com`. Threaded through\n     * `WebsiteRuntimeContext.apiOrigin` into the React island that\n     * constructs the `WebsiteAnonymousSessionClient`.\n     *\n     * OPTIONAL because a pure brochure site with no capture forms never\n     * talks to an API — only sites that host an anonymous-capture\n     * section need it. When such a section renders without a resolved\n     * `apiOrigin`, the section surfaces a loud misconfiguration rather\n     * than silently POSTing nowhere.\n     *\n     * MUST NOT end with `/` — the anon client composes\n     * `${apiOrigin}${MAIN_API_BASE_PATH}${path}` and a trailing slash\n     * would emit a doubled `//` in the request URL. (The client also\n     * defensively strips trailing slashes, but the refine surfaces the\n     * mistake at authoring time.)\n     *\n     * Distinct from `appOrigin` (the human-facing app the marketing CTAs\n     * link into) and `publicOrigin` (the marketing site's own canonical\n     * origin): this is the machine-to-machine API host.\n     */\n    apiOrigin: z\n      .url()\n      .refine((value) => !value.endsWith('/'), {\n        error:\n          'WildoMarketingWebsiteConfig.apiOrigin must NOT end with \"/\" (the anonymous ' +\n          'client concatenates apiOrigin + MAIN_API_BASE_PATH + path; a trailing slash ' +\n          'would emit \"//\")',\n      })\n      .optional(),\n\n    /**\n     * Optional Content-Security-Policy override for the marketing site.\n     * Consumed by the website-local `sync-nginx-csp` step, which emits\n     * the generated artifact for Astro page injection and rewrites the\n     * website nginx marker file from the same resolved output.\n     */\n    csp: WildoCspConfigSchema.optional(),\n\n    /**\n     * Default locale the marketing site serves for unmatched URLs\n     * and as the canonical hreflang signal. Must appear in\n     * `locales` below (cross-check enforced by the schema-level\n     * `.superRefine`).\n     *\n     * Read by `buildAstroI18nConfig(...)` (drives Astro's own\n     * `i18n.defaultLocale`) and by the head renderer (drives\n     * `<html lang=\"...\">`, `og:locale`, hreflang `x-default`).\n     */\n    defaultLocale: z.enum(AvailableLanguage),\n\n    /**\n     * Ordered list of locales the marketing site builds. Order is\n     * preserved (used by the language switcher rendering and by\n     * the sitemap emitter — when the sitemap surface lands).\n     *\n     * Read by `buildAstroI18nConfig(...)` (Astro `i18n.locales`),\n     * by `assertLabelPacksValid(...)` (one label pack per locale),\n     * by `loadWebsitePageRuntime(...)` (per-page locale resolution),\n     * and by the head renderer (hreflang alternates).\n     */\n    locales: z.array(WebsiteLocaleConfigSchema).min(1),\n  })\n  .superRefine((config, ctx) => {\n    const declaredLocales = new Set(config.locales.map((entry) => entry.locale));\n    if (!declaredLocales.has(config.defaultLocale)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['defaultLocale'],\n        message:\n          `defaultLocale '${config.defaultLocale}' is not declared in 'locales' ` +\n          `(declared: [${[...declaredLocales].join(', ')}]). The default locale ` +\n          `must be one of the locales the site actually builds.`,\n      });\n    }\n\n    // Locale-path uniqueness: two entries collapsing to the same URL\n    // segment would silently overwrite each other in the Astro build\n    // and corrupt the sitemap. Fail closed at parse time.\n    const pathOwners = new Map<string, AvailableLanguage>();\n    for (const entry of config.locales) {\n      const previous = pathOwners.get(entry.path);\n      if (previous !== undefined) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['locales'],\n          message:\n            `Locale path '${entry.path}' is declared by both '${previous}' and ` +\n            `'${entry.locale}'. Each locale must have a unique URL path segment.`,\n        });\n        continue;\n      }\n      pathOwners.set(entry.path, entry.locale);\n    }\n\n    // Locale-value uniqueness: same locale appearing twice would\n    // produce duplicate hreflang entries and ambiguous default-locale\n    // resolution.\n    const localeOwners = new Map<AvailableLanguage, string>();\n    for (const entry of config.locales) {\n      const previousPath = localeOwners.get(entry.locale);\n      if (previousPath !== undefined) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['locales'],\n          message:\n            `Locale '${entry.locale}' is declared twice (paths '${previousPath}' ` +\n            `and '${entry.path}'). Each locale must appear at most once.`,\n        });\n        continue;\n      }\n      localeOwners.set(entry.locale, entry.path);\n    }\n  });\nexport type WildoMarketingWebsiteConfig = z.infer<typeof WildoMarketingWebsiteConfigSchema>;\nexport type WildoMarketingWebsiteConfigInput = z.input<typeof WildoMarketingWebsiteConfigSchema>;\n/** @wildo_source:part:end engine.saas-website.config */\n"]}
+{"version":3,"file":"wildo-website-config.schemas.js","sourceRoot":"","sources":["../../../../src/config/wildo-website-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @wildo_source:part:start engine.saas-website.config facet:layer:engine facet:family:marketing-website\n *\n * Per-service marketing-website configuration block, authored in\n * the website service folder as `wildo.website.config.ts`.\n *\n * # What this file's loaded value is used for TODAY\n *\n * This schema is the single source of truth for the marketing-site routing\n * and origin surface. Every consumer reads here:\n *\n *   - `defaultLocale` + `locales` — read by `buildAstroI18nConfig(...)`,\n *     `assertLabelPacksValid(...)`, `loadWebsitePageRuntime(...)` and\n *     `renderWebsitePageHeadHtml(...)` via the shared `WebsiteSiteContext`.\n *   - `publicOrigin` — read by the head renderer to compose absolute\n *     `<link rel=\"canonical\">`, `og:url`, hreflang `href` URLs and\n *     the structured-data `mainEntityOfPage`. The previous\n *     `WebsiteRootConfig.seo.siteOrigin` was deleted.\n *   - `appOrigin` — the marketing → app handoff target, read at runtime\n *     since #493. A `wildo.website.config.ts` is Node-loaded and so\n *     invisible to a client island, which is why this value reaches the\n *     browser the way `apiOrigin` does: the `.astro` page forwards it to\n *     its bridge island, which puts it on `WebsiteRuntimeContext.appOrigin`\n *     for the CTA to read.\n *\n *     It previously had NO runtime consumer, and a site resolved the app\n *     origin a SECOND time from a public build-time environment variable —\n *     one host authored twice with no mechanical link, and a silent\n *     fallback to localhost when the variable was unset. That is how a\n *     marketing site comes to point at the wrong environment.\n *   - `csp?` — read by the website-local `sync-nginx-csp` build step,\n *     which merges the app-static posture with `infra.csp?.<serviceKey>`,\n *     emits the generated artifact consumed by Astro pages, and rewrites\n *     the checked-in nginx marker file used by the website Docker image.\n *\n * Future companion subprocesses that introspect the marketing\n * surface (locale-coverage audits, label-pack validation against\n * authored locales, SEO-link sanity checks) will also read here —\n * none exist today.\n *\n * # Why this is per-service website configuration\n *\n * Co-locating the schema with the engine package that owns its semantics\n * keeps three concerns separate from application-root service declarations:\n *\n *   1. **Right reuse axis.** Marketing-site content (locales, SEO origins,\n *      future label-pack overrides, marketing-only CTAs) is conceptually\n *      different from saas-app-level service declarations (`path`,\n *      `serviceName`, `frontendType`, `sessionStorage`). The marketing\n *      config travels with the website service folder, NOT with the\n *      SaaS app root. Two unrelated lifecycles, two different review\n *      audiences.\n *   2. **Engine boundary.** `platform-config-lib` no longer needs to\n *      depend on `@wildo-ai/presets-components-models` (the home of\n *      `AvailableLanguage`) just to type the marketing-site locale\n *      enum. Adding a new website primitive (a new SEO field, a new\n *      locale-pack id) belongs with the website package and its public\n *      configuration contract.\n *   3. **Disambiguator hazard.** The previous root-level\n *      `marketingWebsite?` block silently assumed \"one STATIC_WEBSITE\n *      service per SaaS app\" — but nothing in the schema enforced it.\n *      Two STATIC_WEBSITE services would have silently shared one\n *      config block with no obvious \"which one wins?\" answer. The\n *      application configuration rejects more than one STATIC_WEBSITE (and\n *      TECH_DOC) service, so the per-service config-file lookup is\n *      deterministic by construction.\n *\n * # Schema decisions encoded here\n *\n * - `z.strictObject` so authoring an unknown key surfaces as a parse\n *   error at `defineWebsiteConfig` time instead of being silently\n *   dropped (same posture as `WildoSaasConfigSchema` and\n *   `WildoTechnicalDocConfigSchema`).\n *\n * - **No `enabled` field.** The gate is \"is there a `wildo.website.config.ts`\n *   in a `frontendType: STATIC_WEBSITE` service folder?\" — file\n *   presence under a STATIC_WEBSITE service IS the enable signal.\n *   The Astro build / dev companion / future audit CLI requires the\n *   file when it walks a STATIC_WEBSITE service folder, so a\n *   half-authored config simply cannot exist (the loader fails\n *   closed). Removing the boolean closes a foot-gun: an authored\n *   `enabled: false` block was previously a silent way to keep the\n *   config \"warm\" without shipping anything, and consumers had to\n *   remember to read the flag in addition to the file presence — a\n *   future read-the-config / forget-the-flag bug waiting to happen.\n *   A separate `services.<key>.enabled` pattern (orthogonal to\n *   marketing-website) is the right place for any \"temporarily\n *   disable this service\" story (deferred — see DASHBOARD).\n *\n * - URL fields are `z.url()` (Zod 4 native validator) so we get\n *   protocol + host parsing for free, matching the rest of the\n *   codebase.\n *\n * - `csp?` is typed against `WildoCspConfigSchema` from\n *   `@wildo-ai/platform-config-lib`, mirroring the docs service's\n *   `wildo.tech-doc.config.ts` contract. The parsed value is consumed by\n *   the shared `resolveCspPolicy()` / `emitCspArtifacts()` generator flow.\n *\n * - `defaultLocale ∈ locales` cross-check via `.superRefine` —\n *   keeping `defaultLocale` as a top-level field is product-explicit\n *   (\"which locale URL is the canonical one\") and decouples it from\n *   list ordering. Locale-path uniqueness AND locale-value\n *   uniqueness are also enforced — duplicate paths would silently\n *   overwrite each other in the Astro build and corrupt the sitemap;\n *   duplicate locales would produce duplicate hreflang entries.\n *\n * - Locale primitive is `AvailableLanguage`. The schema imports it\n *   from `@wildo-ai/presets-components-models/public-runtime` (the\n *   side-effect-free public-runtime seam), but **consumers authoring\n *   `wildo.website.config.ts` must import it from\n *   `@wildo-ai/saas-models/public-runtime`**. Both paths produce identical\n *   values; saas-models simply re-exports the presets atom. Picking\n *   one path consistently across consumer files prevents drift in\n *   docs / examples / search results. Values authored in\n *   `wildo.website.config.ts` are the lowercase BCP-47 strings\n *   (`'en'`, `'fr'`), NOT the UPPERCASE TS enum member names\n *   (`EN`, `FR`). `z.enum(AvailableLanguage)` parses against the\n *   enum VALUES, which is what we want.\n */\n\nimport { WildoCspConfigSchema } from '@wildo-ai/platform-config-lib';\nimport { z } from 'zod';\nimport { AvailableLanguage } from '@wildo-ai/presets-components-models/public-runtime';\n\n/**\n * Per-locale configuration. Each authored locale gets one entry.\n *\n * `path` is the locale URL prefix segment (e.g. `'en'`, `'fr'`) — the\n * Astro builder maps `/en/...` and `/fr/...` paths via this value. We\n * do NOT auto-derive `path` from the locale string because some\n * deployments may want a flat root for the default locale (`/...`\n * instead of `/en/...`); keeping it explicit per locale leaves that\n * door open without a config-shape change.\n */\nexport const WebsiteLocaleConfigSchema = z.strictObject({\n  locale: z.enum(AvailableLanguage),\n  path: z\n    .string()\n    .min(1)\n    .regex(\n      /^[a-z0-9-]+$/,\n      'locale path must be lowercase alphanumeric with hyphens (becomes a URL segment)',\n    ),\n});\nexport type WebsiteLocaleConfig = z.infer<typeof WebsiteLocaleConfigSchema>;\n\n/**\n * Per-service marketing-website configuration block.\n *\n * Authored as `export default defineWebsiteConfig({...})` in\n * `<website-service-root>/wildo.website.config.ts`. The Astro\n * build loads this file once at bootstrap via jiti and composes\n * a `WebsiteSiteContext`; helpers consume that composed context rather than\n * this raw value.\n *\n * @example\n * ```ts\n * import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n * import { defineWebsiteConfig } from '@wildo-ai/saas-website';\n *\n * export default defineWebsiteConfig({\n *   publicOrigin: 'https://example.com',\n *   appOrigin: 'https://app.example.com',\n *   defaultLocale: AvailableLanguage.EN,\n *   locales: [\n *     { locale: AvailableLanguage.EN, path: 'en' },\n *     { locale: AvailableLanguage.FR, path: 'fr' },\n *   ],\n *   csp: { enabled: true, reportOnly: true },\n * });\n * ```\n */\nexport const WildoMarketingWebsiteConfigSchema = z\n  .strictObject({\n    /**\n     * Public origin of the marketing site (apex / www) — canonical\n     * input the Astro head renderer emits as absolute URLs\n     * (`<link rel=\"canonical\">`, `og:url`, hreflang `href`,\n     * sitemap base, structured-data `mainEntityOfPage`).\n     *\n     * MUST NOT end with `/` — the head renderer composes\n     * `${publicOrigin}${routePath}` and a trailing slash would emit\n     * `https://example.com//`. Surface the constraint loudly here\n     * rather than silently corrupting URLs at build time.\n     */\n    publicOrigin: z\n      .url()\n      .refine((value) => !value.endsWith('/'), {\n        error:\n          'WildoMarketingWebsiteConfig.publicOrigin must NOT end with \"/\" (the head ' +\n          'renderer concatenates publicOrigin + routePath; trailing slash would emit \"//\")',\n      }),\n\n    /**\n     * Origin of the SaaS application the marketing site links into\n     * (signup / login / pricing → checkout).\n     *\n     * **Today**: NO runtime consumer. The cross-origin handoff\n     * surface that will read it does not exist yet. Authored\n     * eagerly so the link-surface PR is a single framework-owned move\n     * — until then the field is exercised only by the schema\n     * parser.\n     *\n     * Distinct from the general `WildoSaasConfig.services.<name>`\n     * URL surface because the marketing site is a separate Astro\n     * project that does not load the full SaaS app graph at build\n     * time.\n     */\n    appOrigin: z.url(),\n\n    /**\n     * Backend API origin the marketing site POSTs to for anonymous\n     * captures (lead / draft-note forms) — e.g.\n     * `https://api.example.com`. Threaded through\n     * `WebsiteRuntimeContext.apiOrigin` into the React island that\n     * constructs the `WebsiteAnonymousSessionClient`.\n     *\n     * OPTIONAL because a pure brochure site with no capture forms never\n     * talks to an API — only sites that host an anonymous-capture\n     * section need it. When such a section renders without a resolved\n     * `apiOrigin`, the section surfaces a loud misconfiguration rather\n     * than silently POSTing nowhere.\n     *\n     * MUST NOT end with `/` — the anon client composes\n     * `${apiOrigin}${MAIN_API_BASE_PATH}${path}` and a trailing slash\n     * would emit a doubled `//` in the request URL. (The client also\n     * defensively strips trailing slashes, but the refine surfaces the\n     * mistake at authoring time.)\n     *\n     * Distinct from `appOrigin` (the human-facing app the marketing CTAs\n     * link into) and `publicOrigin` (the marketing site's own canonical\n     * origin): this is the machine-to-machine API host.\n     */\n    apiOrigin: z\n      .url()\n      .refine((value) => !value.endsWith('/'), {\n        error:\n          'WildoMarketingWebsiteConfig.apiOrigin must NOT end with \"/\" (the anonymous ' +\n          'client concatenates apiOrigin + MAIN_API_BASE_PATH + path; a trailing slash ' +\n          'would emit \"//\")',\n      })\n      .optional(),\n\n    /**\n     * Optional Content-Security-Policy override for the marketing site.\n     * Consumed by the website-local `sync-nginx-csp` step, which emits\n     * the generated artifact for Astro page injection and rewrites the\n     * website nginx marker file from the same resolved output.\n     */\n    csp: WildoCspConfigSchema.optional(),\n\n    /**\n     * Default locale the marketing site serves for unmatched URLs\n     * and as the canonical hreflang signal. Must appear in\n     * `locales` below (cross-check enforced by the schema-level\n     * `.superRefine`).\n     *\n     * Read by `buildAstroI18nConfig(...)` (drives Astro's own\n     * `i18n.defaultLocale`) and by the head renderer (drives\n     * `<html lang=\"...\">`, `og:locale`, hreflang `x-default`).\n     */\n    defaultLocale: z.enum(AvailableLanguage),\n\n    /**\n     * Ordered list of locales the marketing site builds. Order is\n     * preserved (used by the language switcher rendering and by\n     * the sitemap emitter — when the sitemap surface lands).\n     *\n     * Read by `buildAstroI18nConfig(...)` (Astro `i18n.locales`),\n     * by `assertLabelPacksValid(...)` (one label pack per locale),\n     * by `loadWebsitePageRuntime(...)` (per-page locale resolution),\n     * and by the head renderer (hreflang alternates).\n     */\n    locales: z.array(WebsiteLocaleConfigSchema).min(1),\n  })\n  .superRefine((config, ctx) => {\n    const declaredLocales = new Set(config.locales.map((entry) => entry.locale));\n    if (!declaredLocales.has(config.defaultLocale)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['defaultLocale'],\n        message:\n          `defaultLocale '${config.defaultLocale}' is not declared in 'locales' ` +\n          `(declared: [${[...declaredLocales].join(', ')}]). The default locale ` +\n          `must be one of the locales the site actually builds.`,\n      });\n    }\n\n    // Locale-path uniqueness: two entries collapsing to the same URL\n    // segment would silently overwrite each other in the Astro build\n    // and corrupt the sitemap. Fail closed at parse time.\n    const pathOwners = new Map<string, AvailableLanguage>();\n    for (const entry of config.locales) {\n      const previous = pathOwners.get(entry.path);\n      if (previous !== undefined) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['locales'],\n          message:\n            `Locale path '${entry.path}' is declared by both '${previous}' and ` +\n            `'${entry.locale}'. Each locale must have a unique URL path segment.`,\n        });\n        continue;\n      }\n      pathOwners.set(entry.path, entry.locale);\n    }\n\n    // Locale-value uniqueness: same locale appearing twice would\n    // produce duplicate hreflang entries and ambiguous default-locale\n    // resolution.\n    const localeOwners = new Map<AvailableLanguage, string>();\n    for (const entry of config.locales) {\n      const previousPath = localeOwners.get(entry.locale);\n      if (previousPath !== undefined) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['locales'],\n          message:\n            `Locale '${entry.locale}' is declared twice (paths '${previousPath}' ` +\n            `and '${entry.path}'). Each locale must appear at most once.`,\n        });\n        continue;\n      }\n      localeOwners.set(entry.locale, entry.path);\n    }\n  });\nexport type WildoMarketingWebsiteConfig = z.infer<typeof WildoMarketingWebsiteConfigSchema>;\nexport type WildoMarketingWebsiteConfigInput = z.input<typeof WildoMarketingWebsiteConfigSchema>;\n/** @wildo_source:part:end engine.saas-website.config */\n"]}

package/dist/esm/core/anonymous-session/inbound-contact-form.schema.d.ts

@@ -10,11 +10,11 @@
  * server-set fields: `_id`, `anonymousUserId`, `userId`, `emailUserMatch`, timestamps).
  *
  * Mirrors the non-excluded, non-backend-only CREATE inputs of `InboundContact`
- * (`email` required; `firstName` / `lastName` / `phone` optional), plus TWO distinct
- * privacy signal: an OPTIONAL marketing opt-in (mapped to the
- * `privacy.dataProcessingConsent` tier). A governed notice, contract or consent
- * interaction must use the separate exact-release receipt contract; this DTO cannot
- * manufacture legal evidence from a checkbox and client timestamp.
+ * (`email` required; `firstName` / `lastName` / `phone` optional), plus ONE privacy
+ * signal: an OPTIONAL marketing opt-in (mapped to the `privacy.dataProcessingConsent`
+ * tier). There is no second, required agreement field: a governed notice, contract or
+ * consent interaction must use the separate exact-release receipt contract, because this
+ * DTO cannot manufacture legal evidence from a checkbox and a client timestamp.
  * `relatedUserId` is intentionally absent — it is `.excludeFromCreate()` on the
  * resource (sales/admin-only, never client-authored).
  */

package/dist/esm/core/anonymous-session/inbound-contact-form.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-contact-form.schema.d.ts","sourceRoot":"","sources":["../../../../../src/core/anonymous-session/inbound-contact-form.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAYnC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYvG"}
+{"version":3,"file":"inbound-contact-form.schema.d.ts","sourceRoot":"","sources":["../../../../../src/core/anonymous-session/inbound-contact-form.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAanC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYvG"}

package/dist/esm/core/anonymous-session/inbound-contact-form.schema.js

@@ -10,11 +10,11 @@
  * server-set fields: `_id`, `anonymousUserId`, `userId`, `emailUserMatch`, timestamps).
  *
  * Mirrors the non-excluded, non-backend-only CREATE inputs of `InboundContact`
- * (`email` required; `firstName` / `lastName` / `phone` optional), plus TWO distinct
- * privacy signal: an OPTIONAL marketing opt-in (mapped to the
- * `privacy.dataProcessingConsent` tier). A governed notice, contract or consent
- * interaction must use the separate exact-release receipt contract; this DTO cannot
- * manufacture legal evidence from a checkbox and client timestamp.
+ * (`email` required; `firstName` / `lastName` / `phone` optional), plus ONE privacy
+ * signal: an OPTIONAL marketing opt-in (mapped to the `privacy.dataProcessingConsent`
+ * tier). There is no second, required agreement field: a governed notice, contract or
+ * consent interaction must use the separate exact-release receipt contract, because this
+ * DTO cannot manufacture legal evidence from a checkbox and a client timestamp.
  * `relatedUserId` is intentionally absent — it is `.excludeFromCreate()` on the
  * resource (sales/admin-only, never client-authored).
  */
@@ -33,7 +33,8 @@ export const InboundContactFormSchema = z.object({
     phone: z.string().trim().max(64).optional(),
     /**
      * OPTIONAL marketing opt-in — maps into the resource's `privacy.dataProcessingConsent`
-     * tier ('marketing' vs the BASIC default). Independent of the required agreement above.
+     * tier ('marketing' vs the BASIC default). It is the only privacy field on this form,
+     * and it gates nothing: an unchecked box still submits, at the BASIC tier.
      */
     marketingConsent: z.boolean().default(false),
 });

package/dist/esm/core/anonymous-session/inbound-contact-form.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-contact-form.schema.js","sourceRoot":"","sources":["../../../../../src/core/anonymous-session/inbound-contact-form.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,mFAAmF;IACnF,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C;;;OAGG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAgC;IAC5E,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE;YACP,2EAA2E;YAC3E,4BAA4B;YAC5B,qBAAqB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;SACvE;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Inbound-contact form input schema (website-local, bundle-safe).\n *\n * Deliberately a SEPARATE plain-Zod schema, NOT `InboundContactSchema` from\n * `@wildo-ai/saas-models`: that schema is decorator-bound (`.isPrimaryKey()`,\n * `.excludeFromCreate()`, `.isBackendOnly()`, …), so importing it would boot the\n * decorator framework into the browser bundle — forbidden by bundle discipline. The\n * website only needs to validate the handful of client-authored CREATE fields; the\n * backend is the authority on the full contract (it re-validates + injects the\n * server-set fields: `_id`, `anonymousUserId`, `userId`, `emailUserMatch`, timestamps).\n *\n * Mirrors the non-excluded, non-backend-only CREATE inputs of `InboundContact`\n * (`email` required; `firstName` / `lastName` / `phone` optional), plus TWO distinct\n * privacy signal: an OPTIONAL marketing opt-in (mapped to the\n * `privacy.dataProcessingConsent` tier). A governed notice, contract or consent\n * interaction must use the separate exact-release receipt contract; this DTO cannot\n * manufacture legal evidence from a checkbox and client timestamp.\n * `relatedUserId` is intentionally absent — it is `.excludeFromCreate()` on the\n * resource (sales/admin-only, never client-authored).\n */\n\nimport { z } from \"zod\";\n\n/**\n * The wire payload POSTed to `/api/v1/inbound-contacts`. `privacy` matches the\n * resource's `InboundContactPrivacySchema` shape (a nested consent object) so the\n * backend accepts it verbatim.\n */\nexport const InboundContactFormSchema = z.object({\n  // Zod 4: top-level `z.email()` (not the deprecated `z.string().email()`), matching\n  // the resource schema. An empty string fails it, so it also covers \"required\".\n  email: z.email(\"Enter a valid email address\"),\n  firstName: z.string().trim().max(200).optional(),\n  lastName: z.string().trim().max(200).optional(),\n  phone: z.string().trim().max(64).optional(),\n  /**\n   * OPTIONAL marketing opt-in — maps into the resource's `privacy.dataProcessingConsent`\n   * tier ('marketing' vs the BASIC default). Independent of the required agreement above.\n   */\n  marketingConsent: z.boolean().default(false),\n});\n\nexport type InboundContactFormValues = z.infer<typeof InboundContactFormSchema>;\n\n/**\n * Build the exact JSON body the backend CREATE expects from validated form values.\n * Keeps the `privacy` nesting + the consent enum mapping in ONE place so the form\n * component stays declarative.\n */\nexport function buildInboundContactCreateBody(values: InboundContactFormValues): Record<string, unknown> {\n  return {\n    email: values.email.trim().toLowerCase(),\n    ...(values.firstName ? { firstName: values.firstName } : {}),\n    ...(values.lastName ? { lastName: values.lastName } : {}),\n    ...(values.phone ? { phone: values.phone } : {}),\n    privacy: {\n      // OPTIONAL marketing tier: 'marketing' when the visitor opted in, else the\n      // resource's BASIC default.\n      dataProcessingConsent: values.marketingConsent ? \"marketing\" : \"basic\",\n    },\n  };\n}\n"]}
+{"version":3,"file":"inbound-contact-form.schema.js","sourceRoot":"","sources":["../../../../../src/core/anonymous-session/inbound-contact-form.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,mFAAmF;IACnF,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAgC;IAC5E,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE;YACP,2EAA2E;YAC3E,4BAA4B;YAC5B,qBAAqB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;SACvE;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Inbound-contact form input schema (website-local, bundle-safe).\n *\n * Deliberately a SEPARATE plain-Zod schema, NOT `InboundContactSchema` from\n * `@wildo-ai/saas-models`: that schema is decorator-bound (`.isPrimaryKey()`,\n * `.excludeFromCreate()`, `.isBackendOnly()`, …), so importing it would boot the\n * decorator framework into the browser bundle — forbidden by bundle discipline. The\n * website only needs to validate the handful of client-authored CREATE fields; the\n * backend is the authority on the full contract (it re-validates + injects the\n * server-set fields: `_id`, `anonymousUserId`, `userId`, `emailUserMatch`, timestamps).\n *\n * Mirrors the non-excluded, non-backend-only CREATE inputs of `InboundContact`\n * (`email` required; `firstName` / `lastName` / `phone` optional), plus ONE privacy\n * signal: an OPTIONAL marketing opt-in (mapped to the `privacy.dataProcessingConsent`\n * tier). There is no second, required agreement field: a governed notice, contract or\n * consent interaction must use the separate exact-release receipt contract, because this\n * DTO cannot manufacture legal evidence from a checkbox and a client timestamp.\n * `relatedUserId` is intentionally absent — it is `.excludeFromCreate()` on the\n * resource (sales/admin-only, never client-authored).\n */\n\nimport { z } from \"zod\";\n\n/**\n * The wire payload POSTed to `/api/v1/inbound-contacts`. `privacy` matches the\n * resource's `InboundContactPrivacySchema` shape (a nested consent object) so the\n * backend accepts it verbatim.\n */\nexport const InboundContactFormSchema = z.object({\n  // Zod 4: top-level `z.email()` (not the deprecated `z.string().email()`), matching\n  // the resource schema. An empty string fails it, so it also covers \"required\".\n  email: z.email(\"Enter a valid email address\"),\n  firstName: z.string().trim().max(200).optional(),\n  lastName: z.string().trim().max(200).optional(),\n  phone: z.string().trim().max(64).optional(),\n  /**\n   * OPTIONAL marketing opt-in — maps into the resource's `privacy.dataProcessingConsent`\n   * tier ('marketing' vs the BASIC default). It is the only privacy field on this form,\n   * and it gates nothing: an unchecked box still submits, at the BASIC tier.\n   */\n  marketingConsent: z.boolean().default(false),\n});\n\nexport type InboundContactFormValues = z.infer<typeof InboundContactFormSchema>;\n\n/**\n * Build the exact JSON body the backend CREATE expects from validated form values.\n * Keeps the `privacy` nesting + the consent enum mapping in ONE place so the form\n * component stays declarative.\n */\nexport function buildInboundContactCreateBody(values: InboundContactFormValues): Record<string, unknown> {\n  return {\n    email: values.email.trim().toLowerCase(),\n    ...(values.firstName ? { firstName: values.firstName } : {}),\n    ...(values.lastName ? { lastName: values.lastName } : {}),\n    ...(values.phone ? { phone: values.phone } : {}),\n    privacy: {\n      // OPTIONAL marketing tier: 'marketing' when the visitor opted in, else the\n      // resource's BASIC default.\n      dataProcessingConsent: values.marketingConsent ? \"marketing\" : \"basic\",\n    },\n  };\n}\n"]}

package/dist/esm/core/contexts/WebsitePageContext.d.ts

@@ -15,9 +15,10 @@ import type { WebsitePageRef } from '../../schemas/refs/page-ref.schemas';
  * MDX-driven blog index aggregating post excerpts, etc.) without
  * lying about which page each subtree belongs to.
  *
- * **Why a separate file from the hook**: same Fast-Refresh rationale
- * as `WebsiteRuntimeContext` — split provider/context/hook to keep
- * HMR boundaries small.
+ * **Why the hook lives in a separate file**: same Fast-Refresh
+ * rationale as `WebsiteRuntimeContext` — the context and its provider
+ * component stay together here (`useContext` matches on object
+ * identity), and only the hook is split out, into `useWebsitePage.ts`.
  */
 export interface WebsitePageContextValue {
     /**

package/dist/esm/core/contexts/WebsitePageContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebsitePageContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsitePageContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CACxB,CAAC;AAEtD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,QAAQ,GACT,EAAE,+BAA+B,GAAG,SAAS,CAM7C;yBATe,0BAA0B;;;AAW1C,uDAAuD"}
+{"version":3,"file":"WebsitePageContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsitePageContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CACxB,CAAC;AAEtD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,QAAQ,GACT,EAAE,+BAA+B,GAAG,SAAS,CAM7C;yBATe,0BAA0B;;;AAW1C,uDAAuD"}

package/dist/esm/core/contexts/WebsitePageContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebsitePageContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsitePageContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAgC7D,MAAM,CAAC,MAAM,kBAAkB,GAC7B,aAAa,CAAiC,IAAI,CAAC,CAAC;AAOtD,MAAM,UAAU,0BAA0B,CAAC,EACzC,KAAK,EACL,QAAQ,GACwB;IAChC,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACtC,QAAQ,GACmB,CAC/B,CAAC;AACJ,CAAC;AACD,0BAA0B,CAAC,WAAW,GAAG,4BAA4B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { WebsitePageRef } from '../../schemas/refs/page-ref.schemas';\n\n/**\n * @wildo_source:part:start saas.website.page.context facet:layer:core facet:family:website\n *\n * `WebsitePageContext` — identity of the page currently rendering.\n * Provided by `<WebsitePageLayout pageRef=\"…\">` exactly once per\n * page render and consumed by `useWebsiteLabel(leaf)` to compose the\n * full label key (`website.{pageRef}.{sectionRef}.{leaf}`).\n *\n * **Why an isolated context (not merged into runtime)**: the runtime\n * context is set at the host-adapter boundary and is constant per\n * build; the page context is set per page route. Splitting them\n * lets a single host adapter render multiple pages (preview tooling,\n * MDX-driven blog index aggregating post excerpts, etc.) without\n * lying about which page each subtree belongs to.\n *\n * **Why a separate file from the hook**: same Fast-Refresh rationale\n * as `WebsiteRuntimeContext` — split provider/context/hook to keep\n * HMR boundaries small.\n */\nexport interface WebsitePageContextValue {\n  /**\n   * The validated `WebsitePageRef` of the page currently rendering.\n   * MUST match a `WebsitePageManifest.pageRef` registered in the\n   * site's `WebsiteRootConfig`.\n   */\n  pageRef: WebsitePageRef;\n}\n\nexport const WebsitePageContext: React.Context<WebsitePageContextValue | null> =\n  createContext<WebsitePageContextValue | null>(null);\n\nexport interface WebsitePageContextProviderProps {\n  value: WebsitePageContextValue;\n  children: ReactNode;\n}\n\nexport function WebsitePageContextProvider({\n  value,\n  children,\n}: WebsitePageContextProviderProps): ReactNode {\n  return (\n    <WebsitePageContext.Provider value={value}>\n      {children}\n    </WebsitePageContext.Provider>\n  );\n}\nWebsitePageContextProvider.displayName = 'WebsitePageContextProvider';\n/** @wildo_source:part:end saas.website.page.context */\n"]}
+{"version":3,"file":"WebsitePageContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsitePageContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAiC7D,MAAM,CAAC,MAAM,kBAAkB,GAC7B,aAAa,CAAiC,IAAI,CAAC,CAAC;AAOtD,MAAM,UAAU,0BAA0B,CAAC,EACzC,KAAK,EACL,QAAQ,GACwB;IAChC,OAAO,CACL,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACtC,QAAQ,GACmB,CAC/B,CAAC;AACJ,CAAC;AACD,0BAA0B,CAAC,WAAW,GAAG,4BAA4B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { WebsitePageRef } from '../../schemas/refs/page-ref.schemas';\n\n/**\n * @wildo_source:part:start saas.website.page.context facet:layer:core facet:family:website\n *\n * `WebsitePageContext` — identity of the page currently rendering.\n * Provided by `<WebsitePageLayout pageRef=\"…\">` exactly once per\n * page render and consumed by `useWebsiteLabel(leaf)` to compose the\n * full label key (`website.{pageRef}.{sectionRef}.{leaf}`).\n *\n * **Why an isolated context (not merged into runtime)**: the runtime\n * context is set at the host-adapter boundary and is constant per\n * build; the page context is set per page route. Splitting them\n * lets a single host adapter render multiple pages (preview tooling,\n * MDX-driven blog index aggregating post excerpts, etc.) without\n * lying about which page each subtree belongs to.\n *\n * **Why the hook lives in a separate file**: same Fast-Refresh\n * rationale as `WebsiteRuntimeContext` — the context and its provider\n * component stay together here (`useContext` matches on object\n * identity), and only the hook is split out, into `useWebsitePage.ts`.\n */\nexport interface WebsitePageContextValue {\n  /**\n   * The validated `WebsitePageRef` of the page currently rendering.\n   * MUST match a `WebsitePageManifest.pageRef` registered in the\n   * site's `WebsiteRootConfig`.\n   */\n  pageRef: WebsitePageRef;\n}\n\nexport const WebsitePageContext: React.Context<WebsitePageContextValue | null> =\n  createContext<WebsitePageContextValue | null>(null);\n\nexport interface WebsitePageContextProviderProps {\n  value: WebsitePageContextValue;\n  children: ReactNode;\n}\n\nexport function WebsitePageContextProvider({\n  value,\n  children,\n}: WebsitePageContextProviderProps): ReactNode {\n  return (\n    <WebsitePageContext.Provider value={value}>\n      {children}\n    </WebsitePageContext.Provider>\n  );\n}\nWebsitePageContextProvider.displayName = 'WebsitePageContextProvider';\n/** @wildo_source:part:end saas.website.page.context */\n"]}

package/dist/esm/core/contexts/WebsiteRuntimeContext.d.ts

@@ -48,13 +48,22 @@ import type { LabelPack } from '../../schemas/validators/label-pack.validator';
  *   contract the SaaS app now uses, instead of inventing a website-only
  *   metadata seam.
  *
- * **Why a separate file from the hook + provider**: split for React
- * Fast Refresh — when a `.tsx` exports both a React component and a
- * React Context object, edits to either one invalidate the entire
- * module's HMR boundary. Keeping the bare context here, the hook in
- * `useWebsiteRuntime.ts`, and the provider component in
- * `WebsiteRuntimeContextProvider.tsx` makes section authors edit
- * components without retriggering the runtime context's identity.
+ * **Why the hook lives in a separate file**: React Fast Refresh only
+ * preserves state for a module whose every export is a component, so
+ * a module mixing components with plain functions loses its HMR
+ * boundary. This file holds the two things that must be identical
+ * objects at runtime — the context and the provider component that
+ * writes it — while `useWebsiteRuntime` sits alone in
+ * `useWebsiteRuntime.ts`. A section author editing a component that
+ * merely READS the runtime therefore never remounts the provider.
+ *
+ * Until 2026-09-09 this paragraph described a different arrangement:
+ * that only the bare context was kept here and the provider lived in
+ * a file of its own. No such file has ever existed — the provider is
+ * exported below — and splitting it out would be the wrong shape
+ * anyway, since `useContext` matches on object identity.
+ * prose-referent-waiver: the retired file name is quoted only to retire it.
+ * The claim named `WebsiteRuntimeContextProvider.tsx`.
  */
 export interface WebsiteRuntimeContextValue {
     /**
@@ -74,6 +83,26 @@ export interface WebsiteRuntimeContextValue {
      * paths.
      */
     defaultLocale: AvailableLanguage;
+    /**
+     * Origin of the application this marketing site sends visitors INTO — the
+     * marketing → product handoff target, authored once as
+     * `WildoMarketingWebsiteConfig.appOrigin` (#493).
+     *
+     * Carried here for exactly the reason `defaultLocale` above is: a
+     * `wildo.website.config.ts` is Node-loaded and therefore invisible to a
+     * client island, so before this a site resolved the app origin a SECOND
+     * time from a public build-time environment variable it could read in the
+     * browser — one host authored twice, in two files, with no mechanical link
+     * between the copies. That is how a marketing site comes to point at the
+     * wrong environment: a defect nobody notices until a customer follows the
+     * link.
+     *
+     * Threading it through the runtime keeps the handoff a framework-internal
+     * concern, the same way threading `defaultLocale` kept locale-prefixing one:
+     * section authors never hand-assemble the product URL, and there is one
+     * place to change it.
+     */
+    appOrigin?: string;
     /**
      * Flat `Record<string, string>` label pack for the active locale.
      * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`

package/dist/esm/core/contexts/WebsiteRuntimeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebsiteRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteRuntimeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0DAA0D,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AAC1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;;;;OASG;IACH,aAAa,EAAE,iBAAiB,CAAC;IACjC;;;;;OAKG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;;OAMG;IACH,UAAU,EAAE,uBAAuB,CAAC;IACpC;;;;;;;;;;;;;;;OAeG;IACH,yBAAyB,EAAE,eAAe,CAAC;IAC3C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,+BAA+B,CAAC;IAC3D;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAC3B,CAAC;AAEzD,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,SAAS,CAMhD;yBATe,6BAA6B;;;AAW7C,0DAA0D"}
+{"version":3,"file":"WebsiteRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteRuntimeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0DAA0D,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AAC1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;;;;OASG;IACH,aAAa,EAAE,iBAAiB,CAAC;IACjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;;OAMG;IACH,UAAU,EAAE,uBAAuB,CAAC;IACpC;;;;;;;;;;;;;;;OAeG;IACH,yBAAyB,EAAE,eAAe,CAAC;IAC3C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,+BAA+B,CAAC;IAC3D;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAC3B,CAAC;AAEzD,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,SAAS,CAMhD;yBATe,6BAA6B;;;AAW7C,0DAA0D"}

package/dist/esm/core/contexts/WebsiteRuntimeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebsiteRuntimeContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteRuntimeContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AA6I7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOzD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AACD,6BAA6B,CAAC,WAAW,GAAG,+BAA+B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport type { WebsiteDesignTokens } from '../../schemas/design-tokens/website-design-tokens.shared.schemas';\nimport type { FrontendWebsiteProviderRegistry } from '../external-providers/frontend-provider-registry.website';\nimport type { WebsiteLabelKey } from '../../schemas/label-keys/website-label-key.schemas';\nimport type { WebsiteNavigationConfig } from '../../schemas/manifests/website-root-config.shared.schemas';\nimport type { LabelPack } from '../../schemas/validators/label-pack.validator';\n\n/**\n * @wildo_source:part:start saas.website.runtime.context facet:layer:core facet:family:website\n *\n * `WebsiteRuntimeContext` — site-wide runtime state for the marketing\n * surface. Created **once per page render** by the host adapter\n * (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the\n * resolved label pack from disk and calls\n * `<WebsiteRuntimeContextProvider value={…}>` around the page tree).\n *\n * **Why \"runtime\" and not \"config\"**: the values here are the\n * locale-resolved subset of `WebsiteRootConfig` — only the active\n * locale's label pack travels with the React tree (the other locales\n * live in their own per-locale static builds). A `*Config` name would\n * suggest the full multi-locale surface is in scope.\n *\n * **Three pieces of state**:\n *\n * - `locale` — the currently-rendering locale. Sections that need\n *   locale-aware formatting (number/date in marketing copy is rare\n *   but legitimate) read it via `useWebsiteRuntime()`.\n * - `labelPack` — the locale-resolved flat key→string map, validated\n *   against the manifest by `validateLabelPackAgainstManifest` at\n *   build start. Consumed by `useWebsiteLabel` and\n *   `useWebsiteLabelByKey`.\n * - `designTokens` — the `WebsiteDesignTokens` from\n *   `WebsiteRootConfig.designTokens`. Consumed by\n *   `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that\n *   materializes them as `--website-*` custom properties on the\n *   `<WebsitePageLayout>` root.\n * - `navigation` — the `WebsiteNavigationConfig` from\n *   `WebsiteRootConfig.navigation`. Carried in the runtime context\n *   (rather than as a separate `WebsiteNavigationContext`) because\n *   `<WebsitePageLayout>` already reads runtime state and\n *   header/footer slots are inseparable from \"the site is rendering\n *   right now\". A second context for two component refs would split\n *   the host-adapter's wiring surface without buying isolation.\n * - `frontendProviderRegistry` — optional website-facing public provider\n *   registry hydrated from the materialized provider artifact for the\n *   concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /\n *   browser-monitoring integrations on the same frontend-provider\n *   contract the SaaS app now uses, instead of inventing a website-only\n *   metadata seam.\n *\n * **Why a separate file from the hook + provider**: split for React\n * Fast Refresh — when a `.tsx` exports both a React component and a\n * React Context object, edits to either one invalidate the entire\n * module's HMR boundary. Keeping the bare context here, the hook in\n * `useWebsiteRuntime.ts`, and the provider component in\n * `WebsiteRuntimeContextProvider.tsx` makes section authors edit\n * components without retriggering the runtime context's identity.\n */\nexport interface WebsiteRuntimeContextValue {\n  /**\n   * The currently-rendering locale. Marketing-site routing emits one\n   * static build per locale (D8), so this value is constant per build\n   * — never re-renders mid-session.\n   */\n  locale: AvailableLanguage;\n  /**\n   * The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).\n   * Carried in the runtime context so client-tier components — namely\n   * `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct\n   * locale-prefixed pathname (`/pricing` on the EN site,\n   * `/fr/pricing` on the FR site) without re-importing the root\n   * config. Plumbing it through the runtime keeps the routing rule\n   * a framework-internal concern: section authors NEVER hand-prefix\n   * paths.\n   */\n  defaultLocale: AvailableLanguage;\n  /**\n   * Flat `Record<string, string>` label pack for the active locale.\n   * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`\n   * strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`\n   * which composes the full key against the page+section context.\n   */\n  labelPack: LabelPack;\n  /**\n   * Design-token bundle for the active site. Same object referenced\n   * by `WebsiteRootConfig.designTokens`; passed by reference (not\n   * cloned) so token-aware components can rely on referential\n   * stability across renders.\n   */\n  designTokens: WebsiteDesignTokens;\n  /**\n   * Site-wide navigation slot bindings (header / footer components).\n   * Same object referenced by `WebsiteRootConfig.navigation`. Read\n   * by `<WebsitePageLayout>` to render the chrome around each page's\n   * `<main>` content; per-page `header` / `footer` props on\n   * `<WebsitePageLayout>` override these defaults.\n   */\n  navigation: WebsiteNavigationConfig;\n  /**\n   * Fully-composed label key the framework reads to render the\n   * \"Skip to main content\" affordance as the FIRST focusable element\n   * on every page (Phase 6 third audit fix M-α). Mirrors\n   * `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the\n   * runtime context (NOT re-derived from the root config inside\n   * `WebsitePageLayout`) for two reasons:\n   *   - The layout is a client-tier React component; it cannot import\n   *     the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging\n   *     server-only code (manifest registry, page components) into\n   *     the client bundle.\n   *   - Threading the key through the runtime keeps the layout's\n   *     contract symmetric with how every other localized text on the\n   *     page is sourced (label pack + key), so the skip link is\n   *     translated automatically without any per-locale branching.\n   */\n  skipToMainContentLabelKey: WebsiteLabelKey;\n  /**\n   * Website-facing public providers for the active static website\n   * service. Optional so older tests and provider-free sites can omit\n   * it, but when present it is the canonical frontend-safe provider\n   * catalog for analytics / captcha / browser-monitoring slices.\n   */\n  frontendProviderRegistry?: FrontendWebsiteProviderRegistry;\n  /**\n   * Backend API origin (WITHOUT a trailing slash) that anonymous-capture\n   * sections POST to when constructing a `WebsiteAnonymousSessionClient`\n   * (lead / draft-note forms). Sourced from\n   * `WildoMarketingWebsiteConfig.apiOrigin` and passed as a\n   * JSON-serializable island prop (the `.astro` page resolves the\n   * per-environment value and forwards it).\n   *\n   * Optional because only pages that host an anonymous-capture section\n   * need it — brochure pages omit it. A capture section that reads\n   * `undefined` here surfaces a loud misconfiguration rather than\n   * silently failing to submit.\n   */\n  apiOrigin?: string;\n}\n\n/**\n * Bare React context. Default `null` — `useWebsiteRuntime()` throws\n * with a clear error message when invoked outside of\n * `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred\n * over a silent default value so a missing provider is detected at\n * the first hook call rather than at render time when a missing\n * label silently renders as the key string.\n */\nexport const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =\n  createContext<WebsiteRuntimeContextValue | null>(null);\n\nexport interface WebsiteRuntimeContextProviderProps {\n  value: WebsiteRuntimeContextValue;\n  children: ReactNode;\n}\n\n/**\n * Provider component. Authored as a thin wrapper so consumers do NOT\n * have to import `WebsiteRuntimeContext.Provider` directly — the\n * provider component carries the documented authoring API and is the\n * Fast-Refresh-stable surface section authors compose against.\n */\nexport function WebsiteRuntimeContextProvider({\n  value,\n  children,\n}: WebsiteRuntimeContextProviderProps): ReactNode {\n  return (\n    <WebsiteRuntimeContext.Provider value={value}>\n      {children}\n    </WebsiteRuntimeContext.Provider>\n  );\n}\nWebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';\n/** @wildo_source:part:end saas.website.runtime.context */\n"]}
+{"version":3,"file":"WebsiteRuntimeContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteRuntimeContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AA0K7D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOzD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AACD,6BAA6B,CAAC,WAAW,GAAG,+BAA+B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';\n\nimport type { WebsiteDesignTokens } from '../../schemas/design-tokens/website-design-tokens.shared.schemas';\nimport type { FrontendWebsiteProviderRegistry } from '../external-providers/frontend-provider-registry.website';\nimport type { WebsiteLabelKey } from '../../schemas/label-keys/website-label-key.schemas';\nimport type { WebsiteNavigationConfig } from '../../schemas/manifests/website-root-config.shared.schemas';\nimport type { LabelPack } from '../../schemas/validators/label-pack.validator';\n\n/**\n * @wildo_source:part:start saas.website.runtime.context facet:layer:core facet:family:website\n *\n * `WebsiteRuntimeContext` — site-wide runtime state for the marketing\n * surface. Created **once per page render** by the host adapter\n * (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the\n * resolved label pack from disk and calls\n * `<WebsiteRuntimeContextProvider value={…}>` around the page tree).\n *\n * **Why \"runtime\" and not \"config\"**: the values here are the\n * locale-resolved subset of `WebsiteRootConfig` — only the active\n * locale's label pack travels with the React tree (the other locales\n * live in their own per-locale static builds). A `*Config` name would\n * suggest the full multi-locale surface is in scope.\n *\n * **Three pieces of state**:\n *\n * - `locale` — the currently-rendering locale. Sections that need\n *   locale-aware formatting (number/date in marketing copy is rare\n *   but legitimate) read it via `useWebsiteRuntime()`.\n * - `labelPack` — the locale-resolved flat key→string map, validated\n *   against the manifest by `validateLabelPackAgainstManifest` at\n *   build start. Consumed by `useWebsiteLabel` and\n *   `useWebsiteLabelByKey`.\n * - `designTokens` — the `WebsiteDesignTokens` from\n *   `WebsiteRootConfig.designTokens`. Consumed by\n *   `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that\n *   materializes them as `--website-*` custom properties on the\n *   `<WebsitePageLayout>` root.\n * - `navigation` — the `WebsiteNavigationConfig` from\n *   `WebsiteRootConfig.navigation`. Carried in the runtime context\n *   (rather than as a separate `WebsiteNavigationContext`) because\n *   `<WebsitePageLayout>` already reads runtime state and\n *   header/footer slots are inseparable from \"the site is rendering\n *   right now\". A second context for two component refs would split\n *   the host-adapter's wiring surface without buying isolation.\n * - `frontendProviderRegistry` — optional website-facing public provider\n *   registry hydrated from the materialized provider artifact for the\n *   concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /\n *   browser-monitoring integrations on the same frontend-provider\n *   contract the SaaS app now uses, instead of inventing a website-only\n *   metadata seam.\n *\n * **Why the hook lives in a separate file**: React Fast Refresh only\n * preserves state for a module whose every export is a component, so\n * a module mixing components with plain functions loses its HMR\n * boundary. This file holds the two things that must be identical\n * objects at runtime — the context and the provider component that\n * writes it — while `useWebsiteRuntime` sits alone in\n * `useWebsiteRuntime.ts`. A section author editing a component that\n * merely READS the runtime therefore never remounts the provider.\n *\n * Until 2026-09-09 this paragraph described a different arrangement:\n * that only the bare context was kept here and the provider lived in\n * a file of its own. No such file has ever existed — the provider is\n * exported below — and splitting it out would be the wrong shape\n * anyway, since `useContext` matches on object identity.\n * prose-referent-waiver: the retired file name is quoted only to retire it.\n * The claim named `WebsiteRuntimeContextProvider.tsx`.\n */\nexport interface WebsiteRuntimeContextValue {\n  /**\n   * The currently-rendering locale. Marketing-site routing emits one\n   * static build per locale (D8), so this value is constant per build\n   * — never re-renders mid-session.\n   */\n  locale: AvailableLanguage;\n  /**\n   * The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).\n   * Carried in the runtime context so client-tier components — namely\n   * `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct\n   * locale-prefixed pathname (`/pricing` on the EN site,\n   * `/fr/pricing` on the FR site) without re-importing the root\n   * config. Plumbing it through the runtime keeps the routing rule\n   * a framework-internal concern: section authors NEVER hand-prefix\n   * paths.\n   */\n  defaultLocale: AvailableLanguage;\n  /**\n   * Origin of the application this marketing site sends visitors INTO — the\n   * marketing → product handoff target, authored once as\n   * `WildoMarketingWebsiteConfig.appOrigin` (#493).\n   *\n   * Carried here for exactly the reason `defaultLocale` above is: a\n   * `wildo.website.config.ts` is Node-loaded and therefore invisible to a\n   * client island, so before this a site resolved the app origin a SECOND\n   * time from a public build-time environment variable it could read in the\n   * browser — one host authored twice, in two files, with no mechanical link\n   * between the copies. That is how a marketing site comes to point at the\n   * wrong environment: a defect nobody notices until a customer follows the\n   * link.\n   *\n   * Threading it through the runtime keeps the handoff a framework-internal\n   * concern, the same way threading `defaultLocale` kept locale-prefixing one:\n   * section authors never hand-assemble the product URL, and there is one\n   * place to change it.\n   */\n  appOrigin?: string;\n  /**\n   * Flat `Record<string, string>` label pack for the active locale.\n   * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`\n   * strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`\n   * which composes the full key against the page+section context.\n   */\n  labelPack: LabelPack;\n  /**\n   * Design-token bundle for the active site. Same object referenced\n   * by `WebsiteRootConfig.designTokens`; passed by reference (not\n   * cloned) so token-aware components can rely on referential\n   * stability across renders.\n   */\n  designTokens: WebsiteDesignTokens;\n  /**\n   * Site-wide navigation slot bindings (header / footer components).\n   * Same object referenced by `WebsiteRootConfig.navigation`. Read\n   * by `<WebsitePageLayout>` to render the chrome around each page's\n   * `<main>` content; per-page `header` / `footer` props on\n   * `<WebsitePageLayout>` override these defaults.\n   */\n  navigation: WebsiteNavigationConfig;\n  /**\n   * Fully-composed label key the framework reads to render the\n   * \"Skip to main content\" affordance as the FIRST focusable element\n   * on every page (Phase 6 third audit fix M-α). Mirrors\n   * `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the\n   * runtime context (NOT re-derived from the root config inside\n   * `WebsitePageLayout`) for two reasons:\n   *   - The layout is a client-tier React component; it cannot import\n   *     the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging\n   *     server-only code (manifest registry, page components) into\n   *     the client bundle.\n   *   - Threading the key through the runtime keeps the layout's\n   *     contract symmetric with how every other localized text on the\n   *     page is sourced (label pack + key), so the skip link is\n   *     translated automatically without any per-locale branching.\n   */\n  skipToMainContentLabelKey: WebsiteLabelKey;\n  /**\n   * Website-facing public providers for the active static website\n   * service. Optional so older tests and provider-free sites can omit\n   * it, but when present it is the canonical frontend-safe provider\n   * catalog for analytics / captcha / browser-monitoring slices.\n   */\n  frontendProviderRegistry?: FrontendWebsiteProviderRegistry;\n  /**\n   * Backend API origin (WITHOUT a trailing slash) that anonymous-capture\n   * sections POST to when constructing a `WebsiteAnonymousSessionClient`\n   * (lead / draft-note forms). Sourced from\n   * `WildoMarketingWebsiteConfig.apiOrigin` and passed as a\n   * JSON-serializable island prop (the `.astro` page resolves the\n   * per-environment value and forwards it).\n   *\n   * Optional because only pages that host an anonymous-capture section\n   * need it — brochure pages omit it. A capture section that reads\n   * `undefined` here surfaces a loud misconfiguration rather than\n   * silently failing to submit.\n   */\n  apiOrigin?: string;\n}\n\n/**\n * Bare React context. Default `null` — `useWebsiteRuntime()` throws\n * with a clear error message when invoked outside of\n * `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred\n * over a silent default value so a missing provider is detected at\n * the first hook call rather than at render time when a missing\n * label silently renders as the key string.\n */\nexport const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =\n  createContext<WebsiteRuntimeContextValue | null>(null);\n\nexport interface WebsiteRuntimeContextProviderProps {\n  value: WebsiteRuntimeContextValue;\n  children: ReactNode;\n}\n\n/**\n * Provider component. Authored as a thin wrapper so consumers do NOT\n * have to import `WebsiteRuntimeContext.Provider` directly — the\n * provider component carries the documented authoring API and is the\n * Fast-Refresh-stable surface section authors compose against.\n */\nexport function WebsiteRuntimeContextProvider({\n  value,\n  children,\n}: WebsiteRuntimeContextProviderProps): ReactNode {\n  return (\n    <WebsiteRuntimeContext.Provider value={value}>\n      {children}\n    </WebsiteRuntimeContext.Provider>\n  );\n}\nWebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';\n/** @wildo_source:part:end saas.website.runtime.context */\n"]}

package/dist/esm/core/contexts/WebsiteSectionContext.d.ts

@@ -17,8 +17,9 @@ import type { WebsiteSectionRef } from '../../schemas/refs/section-ref.schemas';
  * both saves consumers from having to thread the manifest just to
  * map a ref back to its category.
  *
- * **Why a separate file from the hook**: same Fast-Refresh rationale
- * as the runtime + page contexts.
+ * **Why the hook lives in a separate file**: same Fast-Refresh
+ * rationale as the runtime + page contexts — context and provider
+ * together here, the hook alone in `useWebsiteSection.ts`.
  */
 export interface WebsiteSectionContextValue {
     /**

package/dist/esm/core/contexts/WebsiteSectionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebsiteSectionContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteSectionContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,iBAAiB,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAC3B,CAAC;AAEzD,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,SAAS,CAMhD;yBATe,6BAA6B;;;AAW7C,0DAA0D"}
+{"version":3,"file":"WebsiteSectionContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteSectionContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,iBAAiB,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAC3B,CAAC;AAEzD,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GACT,EAAE,kCAAkC,GAAG,SAAS,CAMhD;yBATe,6BAA6B;;;AAW7C,0DAA0D"}

package/dist/esm/core/contexts/WebsiteSectionContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebsiteSectionContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteSectionContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAuC7D,MAAM,CAAC,MAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOzD,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AACD,6BAA6B,CAAC,WAAW,GAAG,+BAA+B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { WebsiteSectionCategory } from '../../schemas/sections/website-section-category.shared';\nimport type { WebsiteSectionRef } from '../../schemas/refs/section-ref.schemas';\n\n/**\n * @wildo_source:part:start saas.website.section.context facet:layer:core facet:family:website\n *\n * `WebsiteSectionContext` — identity + metadata of the section\n * currently rendering. Provided by `<WebsiteSection>` and consumed\n * by `useWebsiteLabel(leaf)` to compose the full label key, by\n * analytics overlays that need the category, and by SEO emitters\n * that decorate sections with `data-*` attributes.\n *\n * **Why expose `category` here (not just `sectionRef`)**: the\n * category is the section's semantic role (`hero`, `cta`, `social`,\n * etc.) and is needed by overlay tooling and analytics consumers\n * that don't know the per-site `sectionRef` vocabulary. Bundling\n * both saves consumers from having to thread the manifest just to\n * map a ref back to its category.\n *\n * **Why a separate file from the hook**: same Fast-Refresh rationale\n * as the runtime + page contexts.\n */\nexport interface WebsiteSectionContextValue {\n  /**\n   * The validated `WebsiteSectionRef` of the section currently\n   * rendering. Composed by `useWebsiteLabel(leaf)` into the full key.\n   */\n  sectionRef: WebsiteSectionRef;\n  /**\n   * The semantic category of the section (`hero` / `cta` / etc.).\n   * Sourced from the matching `WebsiteSectionDefinition.category`\n   * by the host adapter and surfaced here so analytics + SEO\n   * tooling does not need to re-resolve it.\n   */\n  category: WebsiteSectionCategory;\n}\n\nexport const WebsiteSectionContext: React.Context<WebsiteSectionContextValue | null> =\n  createContext<WebsiteSectionContextValue | null>(null);\n\nexport interface WebsiteSectionContextProviderProps {\n  value: WebsiteSectionContextValue;\n  children: ReactNode;\n}\n\nexport function WebsiteSectionContextProvider({\n  value,\n  children,\n}: WebsiteSectionContextProviderProps): ReactNode {\n  return (\n    <WebsiteSectionContext.Provider value={value}>\n      {children}\n    </WebsiteSectionContext.Provider>\n  );\n}\nWebsiteSectionContextProvider.displayName = 'WebsiteSectionContextProvider';\n/** @wildo_source:part:end saas.website.section.context */\n"]}
+{"version":3,"file":"WebsiteSectionContext.js","sourceRoot":"","sources":["../../../../../src/core/contexts/WebsiteSectionContext.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAwC7D,MAAM,CAAC,MAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAOzD,MAAM,UAAU,6BAA6B,CAAC,EAC5C,KAAK,EACL,QAAQ,GAC2B;IACnC,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AACD,6BAA6B,CAAC,WAAW,GAAG,+BAA+B,CAAC","sourcesContent":["import React, { createContext, type ReactNode } from 'react';\n\nimport type { WebsiteSectionCategory } from '../../schemas/sections/website-section-category.shared';\nimport type { WebsiteSectionRef } from '../../schemas/refs/section-ref.schemas';\n\n/**\n * @wildo_source:part:start saas.website.section.context facet:layer:core facet:family:website\n *\n * `WebsiteSectionContext` — identity + metadata of the section\n * currently rendering. Provided by `<WebsiteSection>` and consumed\n * by `useWebsiteLabel(leaf)` to compose the full label key, by\n * analytics overlays that need the category, and by SEO emitters\n * that decorate sections with `data-*` attributes.\n *\n * **Why expose `category` here (not just `sectionRef`)**: the\n * category is the section's semantic role (`hero`, `cta`, `social`,\n * etc.) and is needed by overlay tooling and analytics consumers\n * that don't know the per-site `sectionRef` vocabulary. Bundling\n * both saves consumers from having to thread the manifest just to\n * map a ref back to its category.\n *\n * **Why the hook lives in a separate file**: same Fast-Refresh\n * rationale as the runtime + page contexts — context and provider\n * together here, the hook alone in `useWebsiteSection.ts`.\n */\nexport interface WebsiteSectionContextValue {\n  /**\n   * The validated `WebsiteSectionRef` of the section currently\n   * rendering. Composed by `useWebsiteLabel(leaf)` into the full key.\n   */\n  sectionRef: WebsiteSectionRef;\n  /**\n   * The semantic category of the section (`hero` / `cta` / etc.).\n   * Sourced from the matching `WebsiteSectionDefinition.category`\n   * by the host adapter and surfaced here so analytics + SEO\n   * tooling does not need to re-resolve it.\n   */\n  category: WebsiteSectionCategory;\n}\n\nexport const WebsiteSectionContext: React.Context<WebsiteSectionContextValue | null> =\n  createContext<WebsiteSectionContextValue | null>(null);\n\nexport interface WebsiteSectionContextProviderProps {\n  value: WebsiteSectionContextValue;\n  children: ReactNode;\n}\n\nexport function WebsiteSectionContextProvider({\n  value,\n  children,\n}: WebsiteSectionContextProviderProps): ReactNode {\n  return (\n    <WebsiteSectionContext.Provider value={value}>\n      {children}\n    </WebsiteSectionContext.Provider>\n  );\n}\nWebsiteSectionContextProvider.displayName = 'WebsiteSectionContextProvider';\n/** @wildo_source:part:end saas.website.section.context */\n"]}

package/dist/esm/core/external-providers/frontend-provider-registry.website.d.ts

@@ -1,17 +1,41 @@
-import type { FrontendProviderEntry, FrontendProvidersBlock, ProviderCapability } from '@wildo-ai/saas-models/public-runtime';
-export type FrontendWebsiteProviderRef = string & {
-    readonly __brand: 'FrontendWebsiteProviderRef';
-};
-export type FrontendWebsiteProviderModule = FrontendProviderEntry;
-export interface FrontendWebsiteProviderRegistry {
-    readonly modules: ReadonlyMap<FrontendWebsiteProviderRef, FrontendWebsiteProviderModule>;
-    getProviderByRef(ref: FrontendWebsiteProviderRef): FrontendWebsiteProviderModule | undefined;
-    getProvidersByProviderCapability(providerCapability: ProviderCapability): ReadonlyArray<FrontendWebsiteProviderModule>;
-    findProviderByProviderCapability(providerCapability: ProviderCapability): FrontendWebsiteProviderModule | undefined;
+/**
+ * The website's provider registry — now composed from BOTH channels.
+ *
+ * It used to build itself by casting each served `FrontendProviderEntry` to a
+ * module type that was an alias of that entry, which made the cast true and
+ * useless: the registry could never hold anything a JSON payload could not
+ * carry, so a provider's SDK loader had nowhere to arrive.
+ *
+ *   - **DATA** — the materialized frontend-services block for THIS website
+ *     service. Authoritative for which providers are on, in this environment.
+ *   - **CODE** — `generatedFrontendProviderModules` from the website's own
+ *     `src/generated/frontend-providers.generated.ts`, written by
+ *     `wildo config sync` and handed in by the Astro bridge.
+ *
+ * The types are now the engine's own website-facet types rather than local
+ * aliases, so a provider module authored against
+ * `@wildo-ai/external-connectors-public/website` is the same type this registry
+ * holds. Re-exported under the same names so every consumer's import is
+ * unchanged.
+ */
+import { type GeneratedWebsiteProviderModules } from '@wildo-ai/external-connectors-public/website';
+import type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';
+import type { FrontendProviderHydrationDiagnostic } from '@wildo-ai/external-connectors-public/website';
+export type { FrontendWebsiteProviderModule, FrontendWebsiteProviderRef, FrontendWebsiteProviderRegistry, GeneratedWebsiteProviderModules, } from '@wildo-ai/external-connectors-public/website';
+import type { FrontendWebsiteProviderRegistry } from '@wildo-ai/external-connectors-public/website';
+export interface CreateFrontendWebsiteProviderRegistryInput {
+    /** The DATA channel: the materialized block for this website service. */
+    readonly entries?: FrontendProvidersBlock;
+    /**
+     * The CODE channel. Absent is the ordinary case for a website that declares
+     * no package-shipped provider — `wildo config sync` writes no generated file,
+     * so there is nothing to import and nothing to pass.
+     */
+    readonly modules?: GeneratedWebsiteProviderModules;
+    readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;
 }
 /**
- * Website-side public-provider registry hydrated from the materialized
- * frontend-provider bootstrap block.
+ * Website-side public-provider registry, hydrated from both channels.
  */
-export declare function createFrontendWebsiteProviderRegistry(frontendProviders?: FrontendProvidersBlock): FrontendWebsiteProviderRegistry;
+export declare function createFrontendWebsiteProviderRegistry(input?: CreateFrontendWebsiteProviderRegistryInput): FrontendWebsiteProviderRegistry;
 //# sourceMappingURL=frontend-provider-registry.website.d.ts.map

package/dist/esm/core/external-providers/frontend-provider-registry.website.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.website.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.website.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG;IAChD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAC3B,0BAA0B,EAC1B,6BAA6B,CAC9B,CAAC;IAEF,gBAAgB,CACd,GAAG,EAAE,0BAA0B,GAC9B,6BAA6B,GAAG,SAAS,CAAC;IAE7C,gCAAgC,CAC9B,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,6BAA6B,CAAC,CAAC;IAEhD,gCAAgC,CAC9B,kBAAkB,EAAE,kBAAkB,GACrC,6BAA6B,GAAG,SAAS,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,iBAAiB,CAAC,EAAE,sBAAsB,GACzC,+BAA+B,CAwBjC"}
+{"version":3,"file":"frontend-provider-registry.website.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.website.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,8CAA8C,CAAC;AAExG,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,8CAA8C,CAAC;AAEtD,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,8CAA8C,CAAC;AAEpG,MAAM,WAAW,0CAA0C;IACzD,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,+BAA+B,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACnF;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,CAAC,EAAE,0CAA0C,GACjD,+BAA+B,CAMjC"}

package/dist/esm/core/external-providers/frontend-provider-registry.website.js

@@ -1,23 +1,32 @@
 /**
- * Website-side public-provider registry hydrated from the materialized
- * frontend-provider bootstrap block.
+ * The website's provider registry — now composed from BOTH channels.
+ *
+ * It used to build itself by casting each served `FrontendProviderEntry` to a
+ * module type that was an alias of that entry, which made the cast true and
+ * useless: the registry could never hold anything a JSON payload could not
+ * carry, so a provider's SDK loader had nowhere to arrive.
+ *
+ *   - **DATA** — the materialized frontend-services block for THIS website
+ *     service. Authoritative for which providers are on, in this environment.
+ *   - **CODE** — `generatedFrontendProviderModules` from the website's own
+ *     `src/generated/frontend-providers.generated.ts`, written by
+ *     `wildo config sync` and handed in by the Astro bridge.
+ *
+ * The types are now the engine's own website-facet types rather than local
+ * aliases, so a provider module authored against
+ * `@wildo-ai/external-connectors-public/website` is the same type this registry
+ * holds. Re-exported under the same names so every consumer's import is
+ * unchanged.
  */
-export function createFrontendWebsiteProviderRegistry(frontendProviders) {
-    const modules = new Map(Object.entries(frontendProviders?.providers ?? {}).map(([ref, provider]) => [
-        ref,
-        provider,
-    ]));
-    return {
-        modules,
-        getProviderByRef(ref) {
-            return modules.get(ref);
-        },
-        getProvidersByProviderCapability(providerCapability) {
-            return [...modules.values()].filter((provider) => provider.providerCapabilities.includes(providerCapability));
-        },
-        findProviderByProviderCapability(providerCapability) {
-            return [...modules.values()].find((provider) => provider.providerCapabilities.includes(providerCapability));
-        },
-    };
+import { composeHydratedFrontendWebsiteProviders, } from '@wildo-ai/external-connectors-public/website';
+/**
+ * Website-side public-provider registry, hydrated from both channels.
+ */
+export function createFrontendWebsiteProviderRegistry(input) {
+    return composeHydratedFrontendWebsiteProviders({
+        entries: input?.entries,
+        modules: input?.modules,
+        onDiagnostic: input?.onDiagnostic,
+    });
 }
 //# sourceMappingURL=frontend-provider-registry.website.js.map

package/dist/esm/core/external-providers/frontend-provider-registry.website.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.website.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.website.ts"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CACnD,iBAA0C;IAE1C,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC1E,GAAiC;QACjC,QAAyC;KAC1C,CAAC,CACH,CAAC;IAEF,OAAO;QACL,OAAO;QACP,gBAAgB,CAAC,GAA+B;YAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,gCAAgC,CAAC,kBAAsC;YACrE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC/C,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAC3D,CAAC;QACJ,CAAC;QACD,gCAAgC,CAAC,kBAAsC;YACrE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC7C,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAC3D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  FrontendProviderEntry,\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models/public-runtime';\n\nexport type FrontendWebsiteProviderRef = string & {\n  readonly __brand: 'FrontendWebsiteProviderRef';\n};\n\nexport type FrontendWebsiteProviderModule = FrontendProviderEntry;\n\nexport interface FrontendWebsiteProviderRegistry {\n  readonly modules: ReadonlyMap<\n    FrontendWebsiteProviderRef,\n    FrontendWebsiteProviderModule\n  >;\n\n  getProviderByRef(\n    ref: FrontendWebsiteProviderRef,\n  ): FrontendWebsiteProviderModule | undefined;\n\n  getProvidersByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendWebsiteProviderModule>;\n\n  findProviderByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendWebsiteProviderModule | undefined;\n}\n\n/**\n * Website-side public-provider registry hydrated from the materialized\n * frontend-provider bootstrap block.\n */\nexport function createFrontendWebsiteProviderRegistry(\n  frontendProviders?: FrontendProvidersBlock,\n): FrontendWebsiteProviderRegistry {\n  const modules = new Map<FrontendWebsiteProviderRef, FrontendWebsiteProviderModule>(\n    Object.entries(frontendProviders?.providers ?? {}).map(([ref, provider]) => [\n      ref as FrontendWebsiteProviderRef,\n      provider as FrontendWebsiteProviderModule,\n    ]),\n  );\n\n  return {\n    modules,\n    getProviderByRef(ref: FrontendWebsiteProviderRef) {\n      return modules.get(ref);\n    },\n    getProvidersByProviderCapability(providerCapability: ProviderCapability) {\n      return [...modules.values()].filter((provider) =>\n        provider.providerCapabilities.includes(providerCapability),\n      );\n    },\n    findProviderByProviderCapability(providerCapability: ProviderCapability) {\n      return [...modules.values()].find((provider) =>\n        provider.providerCapabilities.includes(providerCapability),\n      );\n    },\n  };\n}\n"]}
+{"version":3,"file":"frontend-provider-registry.website.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.website.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,uCAAuC,GAExC,MAAM,8CAA8C,CAAC;AAyBtD;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAkD;IAElD,OAAO,uCAAuC,CAAC;QAC7C,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,OAAO,EAAE,KAAK,EAAE,OAAO;QACvB,YAAY,EAAE,KAAK,EAAE,YAAY;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * The website's provider registry — now composed from BOTH channels.\n *\n * It used to build itself by casting each served `FrontendProviderEntry` to a\n * module type that was an alias of that entry, which made the cast true and\n * useless: the registry could never hold anything a JSON payload could not\n * carry, so a provider's SDK loader had nowhere to arrive.\n *\n *   - **DATA** — the materialized frontend-services block for THIS website\n *     service. Authoritative for which providers are on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the website's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and handed in by the Astro bridge.\n *\n * The types are now the engine's own website-facet types rather than local\n * aliases, so a provider module authored against\n * `@wildo-ai/external-connectors-public/website` is the same type this registry\n * holds. Re-exported under the same names so every consumer's import is\n * unchanged.\n */\n\nimport {\n  composeHydratedFrontendWebsiteProviders,\n  type GeneratedWebsiteProviderModules,\n} from '@wildo-ai/external-connectors-public/website';\nimport type { FrontendProvidersBlock } from '@wildo-ai/saas-models/public-runtime';\nimport type { FrontendProviderHydrationDiagnostic } from '@wildo-ai/external-connectors-public/website';\n\nexport type {\n  FrontendWebsiteProviderModule,\n  FrontendWebsiteProviderRef,\n  FrontendWebsiteProviderRegistry,\n  GeneratedWebsiteProviderModules,\n} from '@wildo-ai/external-connectors-public/website';\n\nimport type { FrontendWebsiteProviderRegistry } from '@wildo-ai/external-connectors-public/website';\n\nexport interface CreateFrontendWebsiteProviderRegistryInput {\n  /** The DATA channel: the materialized block for this website service. */\n  readonly entries?: FrontendProvidersBlock;\n  /**\n   * The CODE channel. Absent is the ordinary case for a website that declares\n   * no package-shipped provider — `wildo config sync` writes no generated file,\n   * so there is nothing to import and nothing to pass.\n   */\n  readonly modules?: GeneratedWebsiteProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\n/**\n * Website-side public-provider registry, hydrated from both channels.\n */\nexport function createFrontendWebsiteProviderRegistry(\n  input?: CreateFrontendWebsiteProviderRegistryInput,\n): FrontendWebsiteProviderRegistry {\n  return composeHydratedFrontendWebsiteProviders({\n    entries: input?.entries,\n    modules: input?.modules,\n    onDiagnostic: input?.onDiagnostic,\n  });\n}\n"]}