@wildo-ai/saas-website 1.1.1

package/dist/esm/schemas/manifests/website-page-manifest.shared.schemas.d.ts

@@ -0,0 +1,209 @@
+import type { ComponentType } from 'react';
+import { z } from 'zod';
+/**
+ * @wildo_source:part:start saas.website.page-manifest.meta-label-keys facet:layer:shared facet:family:website
+ *
+ * `WebsitePageMetaLabelKeys` — the i18n keys the Astro adapter (Phase 5)
+ * resolves at static-build time to populate `<title>` / `<meta>` /
+ * Open Graph tags for the page.
+ *
+ * - `titleKey` — REQUIRED. Renders into `<title>` AND `og:title`. The
+ *   manifest commits to declaring this key in every locale's label
+ *   pack; the validator surfaces missing entries at build start.
+ * - `descriptionKey` — REQUIRED. Renders into `<meta name="description">`,
+ *   `og:description`, and `twitter:description`. Same per-locale
+ *   commitment.
+ * - `ogImageUrl` — OPTIONAL. Static URL (typically a per-locale CDN
+ *   path) for `og:image` / `twitter:image`. Not a label key because
+ *   marketing teams overwhelmingly ship one localized asset URL per
+ *   page rather than authoring image URLs in label packs. When
+ *   per-locale images are needed, the consumer supplies a function
+ *   in their site-root config that resolves locale → URL (Phase 5).
+ *
+ * **Why these three only**: the JSON-LD / canonical / `hreflang` /
+ * robots tags are NOT label-key-driven — they are derived
+ * mechanically from the manifest (`routePath`), the root config
+ * (`locales`, `defaultLocale`), and the section-level
+ * `getStructuredData()` hooks. Mixing them into the meta-label-keys
+ * shape would conflate human-authored copy with structural metadata.
+ */
+declare const _WebsitePageMetaLabelKeysSchema: z.ZodObject<{
+    titleKey: z.core.$ZodBranded<z.ZodString, "WebsiteLabelKey", "out">;
+    descriptionKey: z.core.$ZodBranded<z.ZodString, "WebsiteLabelKey", "out">;
+    ogImageUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+export declare const WebsitePageMetaLabelKeysSchema: typeof _WebsitePageMetaLabelKeysSchema;
+export type WebsitePageMetaLabelKeys = z.infer<typeof _WebsitePageMetaLabelKeysSchema>;
+/** @wildo_source:part:end saas.website.page-manifest.meta-label-keys */
+/**
+ * @wildo_source:part:start saas.website.page-manifest.route-path facet:layer:shared facet:family:website
+ *
+ * `WebsitePageRoutePath` — the URL path the page mounts at (locale
+ * prefix stripped).
+ *
+ * **Format**:
+ *   - MUST start with `/`
+ *   - MAY be the root (`'/'`) for the landing page
+ *   - segments are lowercase kebab-case
+ *   - parameter segments use Astro's `[param]` convention
+ *     (e.g. `'/blog/[slug]'`, `'/case-studies/[slug]'`)
+ *
+ * The Astro adapter (Phase 5) prepends the locale prefix
+ * (`/en`, `/fr`, …) when generating routes. The manifest stores the
+ * locale-neutral path because the same `pageComponent` renders for
+ * every locale.
+ *
+ * **Brand**: prevents accidental cross-talk with absolute URLs
+ * (`https://…`), with locale-prefixed paths (`/en/pricing`), and with
+ * arbitrary string props in the manifest factory.
+ */
+declare const _WebsitePageRoutePathSchema: z.core.$ZodBranded<z.ZodString, "WebsitePageRoutePath", "out">;
+export declare const WebsitePageRoutePathSchema: typeof _WebsitePageRoutePathSchema;
+export type WebsitePageRoutePath = z.infer<typeof _WebsitePageRoutePathSchema>;
+/** @wildo_source:part:end saas.website.page-manifest.route-path */
+/**
+ * @wildo_source:part:start saas.website.page-manifest.schema facet:layer:shared facet:family:website
+ *
+ * `WebsitePageManifest` — the registration-time descriptor for one
+ * marketing-site page.
+ *
+ * **Authoring path**: each page-impl module exports both a
+ * `<PageName>Page` React component AND a `<PAGE_NAME>_PAGE_MANIFEST`
+ * literal. The manifest is collected into `WebsiteRootConfig.pageManifests[]`;
+ * the Astro page file (`src/pages/<page>.astro`) imports the manifest
+ * and hands it to `<WebsitePageBridge manifest={…}>` (Phase 5).
+ *
+ * **Field-by-field rationale** (semantic-weight discipline):
+ *
+ * - `ref` — the page's structural identity. Used for label-key
+ *   derivation (`website.<ref>.<sectionRef>.<slot>`), for
+ *   cross-page navigation lookup, and as the manifest registry key.
+ * - `routePath` — the locale-neutral URL path. Decoupled from `ref`
+ *   because the same page (e.g. `ref: 'pricing'`) may mount at a
+ *   localized path (`/tarifs` in French) — the locale-aware path
+ *   resolution is a Phase 5 concern; this field is the canonical
+ *   English-language path.
+ * - `pageComponent` — the React component the bridge renders inside
+ *   `<WebsitePageContext value={{ pageRef: ref }}>`. Type relaxed to
+ *   `unknown` at the schema layer for the same reasons as
+ *   `WebsiteSectionDefinition.Component`; the manifest factory
+ *   (`defineWebsitePageManifest`, Phase 2) preserves precise typing
+ *   at the consumer call site.
+ * - `sectionRefs` — the contractual list of section refs the page
+ *   declares. Used by the label-pack validator to cross-reference
+ *   `expectedLabelKeys` collected from each section against the
+ *   page's commitment. **Order matters** for the validator's
+ *   diagnostic output (sections are reported in declaration order)
+ *   but does NOT control render order — render order is whatever the
+ *   `pageComponent` JSX lays out.
+ * - `metaLabelKeys` — see `WebsitePageMetaLabelKeysSchema`.
+ * - `hydration` — opt-in flag. `'lazy'` (default) corresponds to
+ *   `client:idle` in the Astro adapter (deferred hydration); `'eager'`
+ *   corresponds to `client:load` (immediate hydration). The page
+ *   author flips this to `'eager'` only when the page hosts
+ *   above-the-fold interactive sections (e.g. a contact form).
+ *
+ *   **Important — informational, NOT auto-wired**: Astro's
+ *   `client:*` directives MUST resolve to a literal token at compile
+ *   time (the Astro compiler reads the directive from the JSX source
+ *   to decide which hydration helper to bundle); a runtime-computed
+ *   value will not work. The framework therefore CANNOT translate
+ *   this field into the directive on the consumer's behalf — the
+ *   manifest field is the single source of truth a consumer's
+ *   per-page `.astro` template should USE to pick the matching
+ *   `client:idle` / `client:load` directive by hand. Keeping the two
+ *   in lock-step is a discipline obligation; the audit CLI (Phase 7)
+ *   will surface a drift warning when a page's hydration field does
+ *   not match the directive in its `.astro` file.
+ *
+ * **Refinements**:
+ *   - `sectionRefs` MUST contain unique values. Duplicates indicate
+ *     either a copy-paste bug (two sections pointing at the same
+ *     label-key root) or an intent to share a label-key root that
+ *     the framework rejects to keep the per-page validation
+ *     unambiguous (consumers who need a shared label-key root
+ *     across two distinct sections should pull the shared content
+ *     to the page level via `WebsiteRootConfig`-level globals,
+ *     Phase 2.5).
+ */
+export declare enum WebsitePageHydrationStrategy {
+    /** `client:idle` in the Astro adapter (deferred hydration). */
+    LAZY = "lazy",
+    /** `client:load` in the Astro adapter (immediate hydration). */
+    EAGER = "eager"
+}
+export declare const WebsitePageHydrationStrategySchema: z.ZodEnum<typeof WebsitePageHydrationStrategy>;
+/**
+ * @wildo_source:part:start saas.website.page-manifest.seo facet:layer:shared facet:family:website
+ *
+ * `WebsitePageSeoConfig` — per-page SEO/AEO/GEO knobs.
+ *
+ * The marketing-site default is to be FULLY discoverable by every
+ * crawler (search engines AND AI training crawlers). This block holds
+ * the per-page opt-out levers that flip a page out of that default.
+ *
+ * **Field rationale**:
+ *
+ * - `noaiOptOut?` — when `true`, the page emits
+ *   `<meta name="robots" content="noai, noimageai">` AND a sibling
+ *   `_headers` file entry signalling `X-Robots-Tag: noai, noimageai`
+ *   for crawlers that don't honor in-document meta. ONE knob drives
+ *   BOTH channels (`headers-renderer.ts` reads the same flag) — the
+ *   framework owns the dual emission so consumers can't accidentally
+ *   set one and forget the other.
+ *
+ *   **Why default-IN to AI training (D-AG3)**: the marketing-site
+ *   default is `false` (consent to AI training). Marketing pages
+ *   benefit from AI-engine citation; opting out is a per-page
+ *   editorial decision (typically pricing pages — to avoid stale
+ *   price training; or legal/internal pages — to avoid free-text
+ *   reproduction of contractual language). Per-blog-post opt-out
+ *   would mirror this knob on a sibling blog-post manifest schema
+ *   if that need materializes.
+ */
+declare const _WebsitePageSeoConfigSchema: z.ZodObject<{
+    noaiOptOut: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const WebsitePageSeoConfigSchema: typeof _WebsitePageSeoConfigSchema;
+export type WebsitePageSeoConfig = z.infer<typeof _WebsitePageSeoConfigSchema>;
+/** @wildo_source:part:end saas.website.page-manifest.seo */
+declare const _WebsitePageManifestSchema: z.ZodObject<{
+    ref: z.core.$ZodBranded<z.ZodString, "WebsitePageRef", "out">;
+    routePath: z.core.$ZodBranded<z.ZodString, "WebsitePageRoutePath", "out">;
+    pageComponent: z.ZodUnknown;
+    sectionRefs: z.ZodArray<z.core.$ZodBranded<z.ZodString, "WebsiteSectionRef", "out">>;
+    metaLabelKeys: z.ZodObject<{
+        titleKey: z.core.$ZodBranded<z.ZodString, "WebsiteLabelKey", "out">;
+        descriptionKey: z.core.$ZodBranded<z.ZodString, "WebsiteLabelKey", "out">;
+        ogImageUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>;
+    hydration: z.ZodOptional<z.ZodEnum<typeof WebsitePageHydrationStrategy>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        noaiOptOut: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const WebsitePageManifestSchema: typeof _WebsitePageManifestSchema;
+/**
+ * Runtime shape of `WebsitePageManifest`.
+ *
+ * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`** —
+ * same variance reasoning as `WebsiteSectionDefinition.Component`:
+ * `ComponentType<TProps>` is CONTRAVARIANT in `TProps`, so a
+ * narrower `TypedWebsitePageManifest<TProps>` (returned by
+ * `defineWebsitePageManifest<TProps>`) was not assignable to a
+ * `WebsitePageManifest` typed with `ComponentType<unknown>`. That
+ * blocked every consumer call-site that passed a typed manifest to
+ * helpers / registries / validators expecting the bare type
+ * (root config's `pageManifests[]`, the Astro adapter's
+ * `loadWebsitePageRuntime`, and the head-renderer). Using `any`
+ * matches the React-canonical pattern for heterogeneous component
+ * containers and reflects the runtime contract: the framework only
+ * RENDERS these components — it never constructs ad-hoc props for
+ * them; the consumer's JSX call site supplies the precise props.
+ */
+export interface WebsitePageManifest extends z.infer<typeof _WebsitePageManifestSchema> {
+    pageComponent: ComponentType<any>;
+}
+export {};
+/** @wildo_source:part:end saas.website.page-manifest.schema */
+//# sourceMappingURL=website-page-manifest.shared.schemas.d.ts.map

package/dist/esm/schemas/manifests/website-page-manifest.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-manifest.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/manifests/website-page-manifest.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,+BAA+B;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,OAAO,+BACnB,CAAC;AAElC,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACvF,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,2BAA2B,gEAWC,CAAC;AAEnC,eAAO,MAAM,0BAA0B,EAAE,OAAO,2BACnB,CAAC;AAE9B,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC/E,mEAAmE;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,oBAAY,4BAA4B;IACtC,+DAA+D;IAC/D,IAAI,SAAS;IACb,gEAAgE;IAChE,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,kCAAkC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,4BAA4B,CACxD,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,QAAA,MAAM,2BAA2B;;iBAE/B,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,OAAO,2BACnB,CAAC;AAE9B,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC/E,4DAA4D;AAE5D,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;iBAuC5B,CAAC;AAEL,eAAO,MAAM,yBAAyB,EAAE,OAAO,0BACnB,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAoB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC;IACrF,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACnC;;AACD,+DAA+D"}

package/dist/esm/schemas/manifests/website-page-manifest.shared.schemas.js

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+import { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas.js';
+import { WebsitePageRefSchema } from '../refs/page-ref.schemas.js';
+import { WebsiteSectionRefSchema } from '../refs/section-ref.schemas.js';
+/**
+ * @wildo_source:part:start saas.website.page-manifest.meta-label-keys facet:layer:shared facet:family:website
+ *
+ * `WebsitePageMetaLabelKeys` — the i18n keys the Astro adapter (Phase 5)
+ * resolves at static-build time to populate `<title>` / `<meta>` /
+ * Open Graph tags for the page.
+ *
+ * - `titleKey` — REQUIRED. Renders into `<title>` AND `og:title`. The
+ *   manifest commits to declaring this key in every locale's label
+ *   pack; the validator surfaces missing entries at build start.
+ * - `descriptionKey` — REQUIRED. Renders into `<meta name="description">`,
+ *   `og:description`, and `twitter:description`. Same per-locale
+ *   commitment.
+ * - `ogImageUrl` — OPTIONAL. Static URL (typically a per-locale CDN
+ *   path) for `og:image` / `twitter:image`. Not a label key because
+ *   marketing teams overwhelmingly ship one localized asset URL per
+ *   page rather than authoring image URLs in label packs. When
+ *   per-locale images are needed, the consumer supplies a function
+ *   in their site-root config that resolves locale → URL (Phase 5).
+ *
+ * **Why these three only**: the JSON-LD / canonical / `hreflang` /
+ * robots tags are NOT label-key-driven — they are derived
+ * mechanically from the manifest (`routePath`), the root config
+ * (`locales`, `defaultLocale`), and the section-level
+ * `getStructuredData()` hooks. Mixing them into the meta-label-keys
+ * shape would conflate human-authored copy with structural metadata.
+ */
+const _WebsitePageMetaLabelKeysSchema = z.object({
+    titleKey: WebsiteLabelKeySchema,
+    descriptionKey: WebsiteLabelKeySchema,
+    ogImageUrl: z.url({ error: 'ogImageUrl must be a valid URL' }).optional(),
+});
+export const WebsitePageMetaLabelKeysSchema = _WebsitePageMetaLabelKeysSchema;
+/** @wildo_source:part:end saas.website.page-manifest.meta-label-keys */
+/**
+ * @wildo_source:part:start saas.website.page-manifest.route-path facet:layer:shared facet:family:website
+ *
+ * `WebsitePageRoutePath` — the URL path the page mounts at (locale
+ * prefix stripped).
+ *
+ * **Format**:
+ *   - MUST start with `/`
+ *   - MAY be the root (`'/'`) for the landing page
+ *   - segments are lowercase kebab-case
+ *   - parameter segments use Astro's `[param]` convention
+ *     (e.g. `'/blog/[slug]'`, `'/case-studies/[slug]'`)
+ *
+ * The Astro adapter (Phase 5) prepends the locale prefix
+ * (`/en`, `/fr`, …) when generating routes. The manifest stores the
+ * locale-neutral path because the same `pageComponent` renders for
+ * every locale.
+ *
+ * **Brand**: prevents accidental cross-talk with absolute URLs
+ * (`https://…`), with locale-prefixed paths (`/en/pricing`), and with
+ * arbitrary string props in the manifest factory.
+ */
+const _WebsitePageRoutePathSchema = z
+    .string()
+    .min(1, { error: 'routePath must not be empty' })
+    .max(256, { error: 'routePath must be at most 256 characters' })
+    .regex(/^\/(?:[a-z0-9][a-z0-9-]*(?:\/[a-z0-9-]+|\/\[[a-z][a-zA-Z0-9]*\])*)?\/?$/, {
+    error: 'routePath must start with `/`, use lowercase kebab-case segments, and may include Astro `[param]` segments (e.g. "/", "/pricing", "/blog/[slug]")',
+})
+    .brand();
+export const WebsitePageRoutePathSchema = _WebsitePageRoutePathSchema;
+/** @wildo_source:part:end saas.website.page-manifest.route-path */
+/**
+ * @wildo_source:part:start saas.website.page-manifest.schema facet:layer:shared facet:family:website
+ *
+ * `WebsitePageManifest` — the registration-time descriptor for one
+ * marketing-site page.
+ *
+ * **Authoring path**: each page-impl module exports both a
+ * `<PageName>Page` React component AND a `<PAGE_NAME>_PAGE_MANIFEST`
+ * literal. The manifest is collected into `WebsiteRootConfig.pageManifests[]`;
+ * the Astro page file (`src/pages/<page>.astro`) imports the manifest
+ * and hands it to `<WebsitePageBridge manifest={…}>` (Phase 5).
+ *
+ * **Field-by-field rationale** (semantic-weight discipline):
+ *
+ * - `ref` — the page's structural identity. Used for label-key
+ *   derivation (`website.<ref>.<sectionRef>.<slot>`), for
+ *   cross-page navigation lookup, and as the manifest registry key.
+ * - `routePath` — the locale-neutral URL path. Decoupled from `ref`
+ *   because the same page (e.g. `ref: 'pricing'`) may mount at a
+ *   localized path (`/tarifs` in French) — the locale-aware path
+ *   resolution is a Phase 5 concern; this field is the canonical
+ *   English-language path.
+ * - `pageComponent` — the React component the bridge renders inside
+ *   `<WebsitePageContext value={{ pageRef: ref }}>`. Type relaxed to
+ *   `unknown` at the schema layer for the same reasons as
+ *   `WebsiteSectionDefinition.Component`; the manifest factory
+ *   (`defineWebsitePageManifest`, Phase 2) preserves precise typing
+ *   at the consumer call site.
+ * - `sectionRefs` — the contractual list of section refs the page
+ *   declares. Used by the label-pack validator to cross-reference
+ *   `expectedLabelKeys` collected from each section against the
+ *   page's commitment. **Order matters** for the validator's
+ *   diagnostic output (sections are reported in declaration order)
+ *   but does NOT control render order — render order is whatever the
+ *   `pageComponent` JSX lays out.
+ * - `metaLabelKeys` — see `WebsitePageMetaLabelKeysSchema`.
+ * - `hydration` — opt-in flag. `'lazy'` (default) corresponds to
+ *   `client:idle` in the Astro adapter (deferred hydration); `'eager'`
+ *   corresponds to `client:load` (immediate hydration). The page
+ *   author flips this to `'eager'` only when the page hosts
+ *   above-the-fold interactive sections (e.g. a contact form).
+ *
+ *   **Important — informational, NOT auto-wired**: Astro's
+ *   `client:*` directives MUST resolve to a literal token at compile
+ *   time (the Astro compiler reads the directive from the JSX source
+ *   to decide which hydration helper to bundle); a runtime-computed
+ *   value will not work. The framework therefore CANNOT translate
+ *   this field into the directive on the consumer's behalf — the
+ *   manifest field is the single source of truth a consumer's
+ *   per-page `.astro` template should USE to pick the matching
+ *   `client:idle` / `client:load` directive by hand. Keeping the two
+ *   in lock-step is a discipline obligation; the audit CLI (Phase 7)
+ *   will surface a drift warning when a page's hydration field does
+ *   not match the directive in its `.astro` file.
+ *
+ * **Refinements**:
+ *   - `sectionRefs` MUST contain unique values. Duplicates indicate
+ *     either a copy-paste bug (two sections pointing at the same
+ *     label-key root) or an intent to share a label-key root that
+ *     the framework rejects to keep the per-page validation
+ *     unambiguous (consumers who need a shared label-key root
+ *     across two distinct sections should pull the shared content
+ *     to the page level via `WebsiteRootConfig`-level globals,
+ *     Phase 2.5).
+ */
+export var WebsitePageHydrationStrategy;
+(function (WebsitePageHydrationStrategy) {
+    /** `client:idle` in the Astro adapter (deferred hydration). */
+    WebsitePageHydrationStrategy["LAZY"] = "lazy";
+    /** `client:load` in the Astro adapter (immediate hydration). */
+    WebsitePageHydrationStrategy["EAGER"] = "eager";
+})(WebsitePageHydrationStrategy || (WebsitePageHydrationStrategy = {}));
+export const WebsitePageHydrationStrategySchema = z.enum(WebsitePageHydrationStrategy);
+/**
+ * @wildo_source:part:start saas.website.page-manifest.seo facet:layer:shared facet:family:website
+ *
+ * `WebsitePageSeoConfig` — per-page SEO/AEO/GEO knobs.
+ *
+ * The marketing-site default is to be FULLY discoverable by every
+ * crawler (search engines AND AI training crawlers). This block holds
+ * the per-page opt-out levers that flip a page out of that default.
+ *
+ * **Field rationale**:
+ *
+ * - `noaiOptOut?` — when `true`, the page emits
+ *   `<meta name="robots" content="noai, noimageai">` AND a sibling
+ *   `_headers` file entry signalling `X-Robots-Tag: noai, noimageai`
+ *   for crawlers that don't honor in-document meta. ONE knob drives
+ *   BOTH channels (`headers-renderer.ts` reads the same flag) — the
+ *   framework owns the dual emission so consumers can't accidentally
+ *   set one and forget the other.
+ *
+ *   **Why default-IN to AI training (D-AG3)**: the marketing-site
+ *   default is `false` (consent to AI training). Marketing pages
+ *   benefit from AI-engine citation; opting out is a per-page
+ *   editorial decision (typically pricing pages — to avoid stale
+ *   price training; or legal/internal pages — to avoid free-text
+ *   reproduction of contractual language). Per-blog-post opt-out
+ *   would mirror this knob on a sibling blog-post manifest schema
+ *   if that need materializes.
+ */
+const _WebsitePageSeoConfigSchema = z.object({
+    noaiOptOut: z.boolean().optional(),
+});
+export const WebsitePageSeoConfigSchema = _WebsitePageSeoConfigSchema;
+/** @wildo_source:part:end saas.website.page-manifest.seo */
+const _WebsitePageManifestSchema = z
+    .object({
+    ref: WebsitePageRefSchema,
+    routePath: _WebsitePageRoutePathSchema,
+    pageComponent: z.unknown(),
+    sectionRefs: z.array(WebsiteSectionRefSchema).min(1, {
+        error: 'A page manifest must declare at least one sectionRef',
+    }),
+    metaLabelKeys: _WebsitePageMetaLabelKeysSchema,
+    hydration: WebsitePageHydrationStrategySchema.optional(),
+    seo: _WebsitePageSeoConfigSchema.optional(),
+})
+    .superRefine((manifest, ctx) => {
+    const seen = new Set();
+    for (const [index, sectionRef] of manifest.sectionRefs.entries()) {
+        const key = sectionRef;
+        if (seen.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['sectionRefs', index],
+                message: `Duplicate sectionRef "${key}" in page manifest "${manifest.ref}"`,
+            });
+        }
+        seen.add(key);
+    }
+    const expectedPagePrefix = `website.${manifest.ref}.`;
+    for (const [field, key] of [
+        ['titleKey', manifest.metaLabelKeys.titleKey],
+        ['descriptionKey', manifest.metaLabelKeys.descriptionKey],
+    ]) {
+        if (!key.startsWith(expectedPagePrefix)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['metaLabelKeys', field],
+                message: `metaLabelKeys.${field} ("${key}") must be rooted under the page ref "${manifest.ref}" (expected prefix "${expectedPagePrefix}")`,
+            });
+        }
+    }
+});
+export const WebsitePageManifestSchema = _WebsitePageManifestSchema;
+/** @wildo_source:part:end saas.website.page-manifest.schema */
+//# sourceMappingURL=website-page-manifest.shared.schemas.js.map

package/dist/esm/schemas/manifests/website-page-manifest.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-page-manifest.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/manifests/website-page-manifest.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\n\nimport { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas';\nimport { WebsitePageRefSchema } from '../refs/page-ref.schemas';\nimport { WebsiteSectionRefSchema } from '../refs/section-ref.schemas';\n\n/**\n * @wildo_source:part:start saas.website.page-manifest.meta-label-keys facet:layer:shared facet:family:website\n *\n * `WebsitePageMetaLabelKeys` — the i18n keys the Astro adapter (Phase 5)\n * resolves at static-build time to populate `<title>` / `<meta>` /\n * Open Graph tags for the page.\n *\n * - `titleKey` — REQUIRED. Renders into `<title>` AND `og:title`. The\n *   manifest commits to declaring this key in every locale's label\n *   pack; the validator surfaces missing entries at build start.\n * - `descriptionKey` — REQUIRED. Renders into `<meta name=\"description\">`,\n *   `og:description`, and `twitter:description`. Same per-locale\n *   commitment.\n * - `ogImageUrl` — OPTIONAL. Static URL (typically a per-locale CDN\n *   path) for `og:image` / `twitter:image`. Not a label key because\n *   marketing teams overwhelmingly ship one localized asset URL per\n *   page rather than authoring image URLs in label packs. When\n *   per-locale images are needed, the consumer supplies a function\n *   in their site-root config that resolves locale → URL (Phase 5).\n *\n * **Why these three only**: the JSON-LD / canonical / `hreflang` /\n * robots tags are NOT label-key-driven — they are derived\n * mechanically from the manifest (`routePath`), the root config\n * (`locales`, `defaultLocale`), and the section-level\n * `getStructuredData()` hooks. Mixing them into the meta-label-keys\n * shape would conflate human-authored copy with structural metadata.\n */\nconst _WebsitePageMetaLabelKeysSchema = z.object({\n  titleKey: WebsiteLabelKeySchema,\n  descriptionKey: WebsiteLabelKeySchema,\n  ogImageUrl: z.url({ error: 'ogImageUrl must be a valid URL' }).optional(),\n});\n\nexport const WebsitePageMetaLabelKeysSchema: typeof _WebsitePageMetaLabelKeysSchema =\n  _WebsitePageMetaLabelKeysSchema;\n\nexport type WebsitePageMetaLabelKeys = z.infer<typeof _WebsitePageMetaLabelKeysSchema>;\n/** @wildo_source:part:end saas.website.page-manifest.meta-label-keys */\n\n/**\n * @wildo_source:part:start saas.website.page-manifest.route-path facet:layer:shared facet:family:website\n *\n * `WebsitePageRoutePath` — the URL path the page mounts at (locale\n * prefix stripped).\n *\n * **Format**:\n *   - MUST start with `/`\n *   - MAY be the root (`'/'`) for the landing page\n *   - segments are lowercase kebab-case\n *   - parameter segments use Astro's `[param]` convention\n *     (e.g. `'/blog/[slug]'`, `'/case-studies/[slug]'`)\n *\n * The Astro adapter (Phase 5) prepends the locale prefix\n * (`/en`, `/fr`, …) when generating routes. The manifest stores the\n * locale-neutral path because the same `pageComponent` renders for\n * every locale.\n *\n * **Brand**: prevents accidental cross-talk with absolute URLs\n * (`https://…`), with locale-prefixed paths (`/en/pricing`), and with\n * arbitrary string props in the manifest factory.\n */\nconst _WebsitePageRoutePathSchema = z\n  .string()\n  .min(1, { error: 'routePath must not be empty' })\n  .max(256, { error: 'routePath must be at most 256 characters' })\n  .regex(\n    /^\\/(?:[a-z0-9][a-z0-9-]*(?:\\/[a-z0-9-]+|\\/\\[[a-z][a-zA-Z0-9]*\\])*)?\\/?$/,\n    {\n      error:\n        'routePath must start with `/`, use lowercase kebab-case segments, and may include Astro `[param]` segments (e.g. \"/\", \"/pricing\", \"/blog/[slug]\")',\n    },\n  )\n  .brand<'WebsitePageRoutePath'>();\n\nexport const WebsitePageRoutePathSchema: typeof _WebsitePageRoutePathSchema =\n  _WebsitePageRoutePathSchema;\n\nexport type WebsitePageRoutePath = z.infer<typeof _WebsitePageRoutePathSchema>;\n/** @wildo_source:part:end saas.website.page-manifest.route-path */\n\n/**\n * @wildo_source:part:start saas.website.page-manifest.schema facet:layer:shared facet:family:website\n *\n * `WebsitePageManifest` — the registration-time descriptor for one\n * marketing-site page.\n *\n * **Authoring path**: each page-impl module exports both a\n * `<PageName>Page` React component AND a `<PAGE_NAME>_PAGE_MANIFEST`\n * literal. The manifest is collected into `WebsiteRootConfig.pageManifests[]`;\n * the Astro page file (`src/pages/<page>.astro`) imports the manifest\n * and hands it to `<WebsitePageBridge manifest={…}>` (Phase 5).\n *\n * **Field-by-field rationale** (semantic-weight discipline):\n *\n * - `ref` — the page's structural identity. Used for label-key\n *   derivation (`website.<ref>.<sectionRef>.<slot>`), for\n *   cross-page navigation lookup, and as the manifest registry key.\n * - `routePath` — the locale-neutral URL path. Decoupled from `ref`\n *   because the same page (e.g. `ref: 'pricing'`) may mount at a\n *   localized path (`/tarifs` in French) — the locale-aware path\n *   resolution is a Phase 5 concern; this field is the canonical\n *   English-language path.\n * - `pageComponent` — the React component the bridge renders inside\n *   `<WebsitePageContext value={{ pageRef: ref }}>`. Type relaxed to\n *   `unknown` at the schema layer for the same reasons as\n *   `WebsiteSectionDefinition.Component`; the manifest factory\n *   (`defineWebsitePageManifest`, Phase 2) preserves precise typing\n *   at the consumer call site.\n * - `sectionRefs` — the contractual list of section refs the page\n *   declares. Used by the label-pack validator to cross-reference\n *   `expectedLabelKeys` collected from each section against the\n *   page's commitment. **Order matters** for the validator's\n *   diagnostic output (sections are reported in declaration order)\n *   but does NOT control render order — render order is whatever the\n *   `pageComponent` JSX lays out.\n * - `metaLabelKeys` — see `WebsitePageMetaLabelKeysSchema`.\n * - `hydration` — opt-in flag. `'lazy'` (default) corresponds to\n *   `client:idle` in the Astro adapter (deferred hydration); `'eager'`\n *   corresponds to `client:load` (immediate hydration). The page\n *   author flips this to `'eager'` only when the page hosts\n *   above-the-fold interactive sections (e.g. a contact form).\n *\n *   **Important — informational, NOT auto-wired**: Astro's\n *   `client:*` directives MUST resolve to a literal token at compile\n *   time (the Astro compiler reads the directive from the JSX source\n *   to decide which hydration helper to bundle); a runtime-computed\n *   value will not work. The framework therefore CANNOT translate\n *   this field into the directive on the consumer's behalf — the\n *   manifest field is the single source of truth a consumer's\n *   per-page `.astro` template should USE to pick the matching\n *   `client:idle` / `client:load` directive by hand. Keeping the two\n *   in lock-step is a discipline obligation; the audit CLI (Phase 7)\n *   will surface a drift warning when a page's hydration field does\n *   not match the directive in its `.astro` file.\n *\n * **Refinements**:\n *   - `sectionRefs` MUST contain unique values. Duplicates indicate\n *     either a copy-paste bug (two sections pointing at the same\n *     label-key root) or an intent to share a label-key root that\n *     the framework rejects to keep the per-page validation\n *     unambiguous (consumers who need a shared label-key root\n *     across two distinct sections should pull the shared content\n *     to the page level via `WebsiteRootConfig`-level globals,\n *     Phase 2.5).\n */\nexport enum WebsitePageHydrationStrategy {\n  /** `client:idle` in the Astro adapter (deferred hydration). */\n  LAZY = 'lazy',\n  /** `client:load` in the Astro adapter (immediate hydration). */\n  EAGER = 'eager',\n}\n\nexport const WebsitePageHydrationStrategySchema: z.ZodEnum<typeof WebsitePageHydrationStrategy> =\n  z.enum(WebsitePageHydrationStrategy);\n\n/**\n * @wildo_source:part:start saas.website.page-manifest.seo facet:layer:shared facet:family:website\n *\n * `WebsitePageSeoConfig` — per-page SEO/AEO/GEO knobs.\n *\n * The marketing-site default is to be FULLY discoverable by every\n * crawler (search engines AND AI training crawlers). This block holds\n * the per-page opt-out levers that flip a page out of that default.\n *\n * **Field rationale**:\n *\n * - `noaiOptOut?` — when `true`, the page emits\n *   `<meta name=\"robots\" content=\"noai, noimageai\">` AND a sibling\n *   `_headers` file entry signalling `X-Robots-Tag: noai, noimageai`\n *   for crawlers that don't honor in-document meta. ONE knob drives\n *   BOTH channels (`headers-renderer.ts` reads the same flag) — the\n *   framework owns the dual emission so consumers can't accidentally\n *   set one and forget the other.\n *\n *   **Why default-IN to AI training (D-AG3)**: the marketing-site\n *   default is `false` (consent to AI training). Marketing pages\n *   benefit from AI-engine citation; opting out is a per-page\n *   editorial decision (typically pricing pages — to avoid stale\n *   price training; or legal/internal pages — to avoid free-text\n *   reproduction of contractual language). Per-blog-post opt-out\n *   would mirror this knob on a sibling blog-post manifest schema\n *   if that need materializes.\n */\nconst _WebsitePageSeoConfigSchema = z.object({\n  noaiOptOut: z.boolean().optional(),\n});\n\nexport const WebsitePageSeoConfigSchema: typeof _WebsitePageSeoConfigSchema =\n  _WebsitePageSeoConfigSchema;\n\nexport type WebsitePageSeoConfig = z.infer<typeof _WebsitePageSeoConfigSchema>;\n/** @wildo_source:part:end saas.website.page-manifest.seo */\n\nconst _WebsitePageManifestSchema = z\n  .object({\n    ref: WebsitePageRefSchema,\n    routePath: _WebsitePageRoutePathSchema,\n    pageComponent: z.unknown(),\n    sectionRefs: z.array(WebsiteSectionRefSchema).min(1, {\n      error: 'A page manifest must declare at least one sectionRef',\n    }),\n    metaLabelKeys: _WebsitePageMetaLabelKeysSchema,\n    hydration: WebsitePageHydrationStrategySchema.optional(),\n    seo: _WebsitePageSeoConfigSchema.optional(),\n  })\n  .superRefine((manifest, ctx) => {\n    const seen = new Set<string>();\n    for (const [index, sectionRef] of manifest.sectionRefs.entries()) {\n      const key = sectionRef as unknown as string;\n      if (seen.has(key)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['sectionRefs', index],\n          message: `Duplicate sectionRef \"${key}\" in page manifest \"${manifest.ref as unknown as string}\"`,\n        });\n      }\n      seen.add(key);\n    }\n\n    const expectedPagePrefix = `website.${manifest.ref as unknown as string}.`;\n    for (const [field, key] of [\n      ['titleKey', manifest.metaLabelKeys.titleKey] as const,\n      ['descriptionKey', manifest.metaLabelKeys.descriptionKey] as const,\n    ]) {\n      if (!(key as unknown as string).startsWith(expectedPagePrefix)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['metaLabelKeys', field],\n          message: `metaLabelKeys.${field} (\"${key as unknown as string}\") must be rooted under the page ref \"${manifest.ref as unknown as string}\" (expected prefix \"${expectedPagePrefix}\")`,\n        });\n      }\n    }\n  });\n\nexport const WebsitePageManifestSchema: typeof _WebsitePageManifestSchema =\n  _WebsitePageManifestSchema;\n\n/**\n * Runtime shape of `WebsitePageManifest`.\n *\n * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`** —\n * same variance reasoning as `WebsiteSectionDefinition.Component`:\n * `ComponentType<TProps>` is CONTRAVARIANT in `TProps`, so a\n * narrower `TypedWebsitePageManifest<TProps>` (returned by\n * `defineWebsitePageManifest<TProps>`) was not assignable to a\n * `WebsitePageManifest` typed with `ComponentType<unknown>`. That\n * blocked every consumer call-site that passed a typed manifest to\n * helpers / registries / validators expecting the bare type\n * (root config's `pageManifests[]`, the Astro adapter's\n * `loadWebsitePageRuntime`, and the head-renderer). Using `any`\n * matches the React-canonical pattern for heterogeneous component\n * containers and reflects the runtime contract: the framework only\n * RENDERS these components — it never constructs ad-hoc props for\n * them; the consumer's JSX call site supplies the precise props.\n */\nexport interface WebsitePageManifest extends z.infer<typeof _WebsitePageManifestSchema> {\n  pageComponent: ComponentType<any>;\n}\n/** @wildo_source:part:end saas.website.page-manifest.schema */\n"]}