@wildo-ai/saas-website 1.1.4 → 1.1.6

package/dist/esm/schemas/label-keys/website-consent-label-keys.schemas.d.ts

@@ -0,0 +1,61 @@
+import { ConsentPurpose } from '@wildo-ai/saas-models/public-runtime';
+import { type WebsiteLabelKey } from './website-label-key.schemas';
+/**
+ * The label keys the framework's visitor consent surface reads (#534).
+ *
+ * FRAMEWORK-OWNED, like the skip link's key: the consent banner is rendered by `WebsitePageLayout`, not by
+ * the site's chrome, so the site does not list these in `chromeLabelKeys`.
+ * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a locale
+ * pack missing one fails the build rather than showing a visitor a raw key.
+ *
+ * They are required of every site, including one that runs no consent-based provider today: the words are
+ * cheap, and a site that adds analytics tomorrow must not ship it with an unlabelled — or absent — way to
+ * refuse.
+ *
+ * Purpose names are keyed by the `ConsentPurpose` VALUE and derived from the vocabulary, so a purpose added
+ * to it is a missing label in every site's pack at the next build, not a purpose the banner cannot name.
+ */
+export declare enum WebsiteConsentLabelSlot {
+    /** Heading of the consent panel. */
+    TITLE = "title",
+    /** What the panel is for: optional purposes are off until agreed, each chosen separately, changeable later. */
+    DESCRIPTION = "description",
+    /** Agree to every purpose listed. */
+    ACCEPT_ALL = "accept-all",
+    /** Agree to none of them — recorded as a choice, so the panel does not return. */
+    DECLINE_ALL = "decline-all",
+    /** Save exactly the purposes ticked. */
+    SAVE = "save",
+    /** Re-open the panel to change a choice already made. */
+    MANAGE = "manage",
+    /**
+     * Name of the row covering what runs whatever the visitor chooses.
+     *
+     * NOT a `ConsentPurpose`, and it must never become one: that vocabulary is what a visitor DECIDES,
+     * and this is the thing they are not being asked about. It is shown because a panel listing only
+     * the optional purposes cannot answer the question a visitor opened it to answer — what is
+     * happening on this site — which is why every specialized consent platform states it.
+     */
+    ESSENTIAL_TITLE = "essential-title",
+    /** What the always-active row covers, and why its control is checked and cannot be changed. */
+    ESSENTIAL_DESCRIPTION = "essential-description"
+}
+/** The fully-composed key for one panel slot. */
+export declare function websiteConsentLabelKey(slot: WebsiteConsentLabelSlot): WebsiteLabelKey;
+/** The fully-composed key naming one consent purpose. */
+export declare function websiteConsentPurposeLabelKey(purpose: ConsentPurpose): WebsiteLabelKey;
+/**
+ * The key EXPLAINING one consent purpose — what agreeing to it means for this visitor.
+ *
+ * The name above answers *what is it called*; this answers *what will happen to me*, and a choice
+ * made without the second is not an informed one. "Analytics" beside a tick box is a category, not
+ * something a visitor can weigh.
+ *
+ * Derived from the vocabulary exactly as the name is, so a purpose added to `ConsentPurpose` is a
+ * missing label in every site's pack at the next build rather than a row that renders a name with no
+ * explanation beneath it.
+ */
+export declare function websiteConsentPurposeDescriptionLabelKey(purpose: ConsentPurpose): WebsiteLabelKey;
+/** Every framework-owned consent key — what a locale pack must carry. Total over both vocabularies. */
+export declare const WEBSITE_CONSENT_LABEL_KEYS: readonly WebsiteLabelKey[];
+//# sourceMappingURL=website-consent-label-keys.schemas.d.ts.map

package/dist/esm/schemas/label-keys/website-consent-label-keys.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-consent-label-keys.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/label-keys/website-consent-label-keys.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,sCAAsC,CAAC;AAExF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,oBAAY,uBAAuB;IACjC,oCAAoC;IACpC,KAAK,UAAU;IACf,+GAA+G;IAC/G,WAAW,gBAAgB;IAC3B,qCAAqC;IACrC,UAAU,eAAe;IACzB,kFAAkF;IAClF,WAAW,gBAAgB;IAC3B,wCAAwC;IACxC,IAAI,SAAS;IACb,yDAAyD;IACzD,MAAM,WAAW;IACjB;;;;;;;OAOG;IACH,eAAe,oBAAoB;IACnC,+FAA+F;IAC/F,qBAAqB,0BAA0B;CAChD;AAID,iDAAiD;AACjD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,eAAe,CAErF;AAED,yDAAyD;AACzD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAEtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wCAAwC,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAEjG;AAED,uGAAuG;AACvG,eAAO,MAAM,0BAA0B,EAAE,SAAS,eAAe,EAI/D,CAAC"}

package/dist/esm/schemas/label-keys/website-consent-label-keys.schemas.js

@@ -0,0 +1,73 @@
+import { CONSENT_PURPOSES } from '@wildo-ai/saas-models/public-runtime';
+import { WebsiteLabelKeySchema } from './website-label-key.schemas.js';
+/**
+ * The label keys the framework's visitor consent surface reads (#534).
+ *
+ * FRAMEWORK-OWNED, like the skip link's key: the consent banner is rendered by `WebsitePageLayout`, not by
+ * the site's chrome, so the site does not list these in `chromeLabelKeys`.
+ * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a locale
+ * pack missing one fails the build rather than showing a visitor a raw key.
+ *
+ * They are required of every site, including one that runs no consent-based provider today: the words are
+ * cheap, and a site that adds analytics tomorrow must not ship it with an unlabelled — or absent — way to
+ * refuse.
+ *
+ * Purpose names are keyed by the `ConsentPurpose` VALUE and derived from the vocabulary, so a purpose added
+ * to it is a missing label in every site's pack at the next build, not a purpose the banner cannot name.
+ */
+export var WebsiteConsentLabelSlot;
+(function (WebsiteConsentLabelSlot) {
+    /** Heading of the consent panel. */
+    WebsiteConsentLabelSlot["TITLE"] = "title";
+    /** What the panel is for: optional purposes are off until agreed, each chosen separately, changeable later. */
+    WebsiteConsentLabelSlot["DESCRIPTION"] = "description";
+    /** Agree to every purpose listed. */
+    WebsiteConsentLabelSlot["ACCEPT_ALL"] = "accept-all";
+    /** Agree to none of them — recorded as a choice, so the panel does not return. */
+    WebsiteConsentLabelSlot["DECLINE_ALL"] = "decline-all";
+    /** Save exactly the purposes ticked. */
+    WebsiteConsentLabelSlot["SAVE"] = "save";
+    /** Re-open the panel to change a choice already made. */
+    WebsiteConsentLabelSlot["MANAGE"] = "manage";
+    /**
+     * Name of the row covering what runs whatever the visitor chooses.
+     *
+     * NOT a `ConsentPurpose`, and it must never become one: that vocabulary is what a visitor DECIDES,
+     * and this is the thing they are not being asked about. It is shown because a panel listing only
+     * the optional purposes cannot answer the question a visitor opened it to answer — what is
+     * happening on this site — which is why every specialized consent platform states it.
+     */
+    WebsiteConsentLabelSlot["ESSENTIAL_TITLE"] = "essential-title";
+    /** What the always-active row covers, and why its control is checked and cannot be changed. */
+    WebsiteConsentLabelSlot["ESSENTIAL_DESCRIPTION"] = "essential-description";
+})(WebsiteConsentLabelSlot || (WebsiteConsentLabelSlot = {}));
+const CONSENT_LABEL_KEY_PREFIX = 'website.chrome.consent';
+/** The fully-composed key for one panel slot. */
+export function websiteConsentLabelKey(slot) {
+    return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.${slot}`);
+}
+/** The fully-composed key naming one consent purpose. */
+export function websiteConsentPurposeLabelKey(purpose) {
+    return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.purpose-${purpose}`);
+}
+/**
+ * The key EXPLAINING one consent purpose — what agreeing to it means for this visitor.
+ *
+ * The name above answers *what is it called*; this answers *what will happen to me*, and a choice
+ * made without the second is not an informed one. "Analytics" beside a tick box is a category, not
+ * something a visitor can weigh.
+ *
+ * Derived from the vocabulary exactly as the name is, so a purpose added to `ConsentPurpose` is a
+ * missing label in every site's pack at the next build rather than a row that renders a name with no
+ * explanation beneath it.
+ */
+export function websiteConsentPurposeDescriptionLabelKey(purpose) {
+    return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.purpose-${purpose}-description`);
+}
+/** Every framework-owned consent key — what a locale pack must carry. Total over both vocabularies. */
+export const WEBSITE_CONSENT_LABEL_KEYS = Object.freeze([
+    ...Object.values(WebsiteConsentLabelSlot).map(websiteConsentLabelKey),
+    ...CONSENT_PURPOSES.map(websiteConsentPurposeLabelKey),
+    ...CONSENT_PURPOSES.map(websiteConsentPurposeDescriptionLabelKey),
+]);
+//# sourceMappingURL=website-consent-label-keys.schemas.js.map

package/dist/esm/schemas/label-keys/website-consent-label-keys.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-consent-label-keys.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/label-keys/website-consent-label-keys.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EAAE,qBAAqB,EAAwB,MAAM,6BAA6B,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,uBAwBX;AAxBD,WAAY,uBAAuB;IACjC,oCAAoC;IACpC,0CAAe,CAAA;IACf,+GAA+G;IAC/G,sDAA2B,CAAA;IAC3B,qCAAqC;IACrC,oDAAyB,CAAA;IACzB,kFAAkF;IAClF,sDAA2B,CAAA;IAC3B,wCAAwC;IACxC,wCAAa,CAAA;IACb,yDAAyD;IACzD,4CAAiB,CAAA;IACjB;;;;;;;OAOG;IACH,8DAAmC,CAAA;IACnC,+FAA+F;IAC/F,0EAA+C,CAAA;AACjD,CAAC,EAxBW,uBAAuB,KAAvB,uBAAuB,QAwBlC;AAED,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAE1D,iDAAiD;AACjD,MAAM,UAAU,sBAAsB,CAAC,IAA6B;IAClE,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,wBAAwB,IAAI,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,6BAA6B,CAAC,OAAuB;IACnE,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,wBAAwB,YAAY,OAAO,EAAE,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wCAAwC,CAAC,OAAuB;IAC9E,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,wBAAwB,YAAY,OAAO,cAAc,CAAC,CAAC;AACnG,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,MAAM,0BAA0B,GAA+B,MAAM,CAAC,MAAM,CAAC;IAClF,GAAG,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACrE,GAAG,gBAAgB,CAAC,GAAG,CAAC,6BAA6B,CAAC;IACtD,GAAG,gBAAgB,CAAC,GAAG,CAAC,wCAAwC,CAAC;CAClE,CAAC,CAAC","sourcesContent":["import { ConsentPurpose, CONSENT_PURPOSES } from '@wildo-ai/saas-models/public-runtime';\n\nimport { WebsiteLabelKeySchema, type WebsiteLabelKey } from './website-label-key.schemas';\n\n/**\n * The label keys the framework's visitor consent surface reads (#534).\n *\n * FRAMEWORK-OWNED, like the skip link's key: the consent banner is rendered by `WebsitePageLayout`, not by\n * the site's chrome, so the site does not list these in `chromeLabelKeys`.\n * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a locale\n * pack missing one fails the build rather than showing a visitor a raw key.\n *\n * They are required of every site, including one that runs no consent-based provider today: the words are\n * cheap, and a site that adds analytics tomorrow must not ship it with an unlabelled — or absent — way to\n * refuse.\n *\n * Purpose names are keyed by the `ConsentPurpose` VALUE and derived from the vocabulary, so a purpose added\n * to it is a missing label in every site's pack at the next build, not a purpose the banner cannot name.\n */\nexport enum WebsiteConsentLabelSlot {\n  /** Heading of the consent panel. */\n  TITLE = 'title',\n  /** What the panel is for: optional purposes are off until agreed, each chosen separately, changeable later. */\n  DESCRIPTION = 'description',\n  /** Agree to every purpose listed. */\n  ACCEPT_ALL = 'accept-all',\n  /** Agree to none of them — recorded as a choice, so the panel does not return. */\n  DECLINE_ALL = 'decline-all',\n  /** Save exactly the purposes ticked. */\n  SAVE = 'save',\n  /** Re-open the panel to change a choice already made. */\n  MANAGE = 'manage',\n  /**\n   * Name of the row covering what runs whatever the visitor chooses.\n   *\n   * NOT a `ConsentPurpose`, and it must never become one: that vocabulary is what a visitor DECIDES,\n   * and this is the thing they are not being asked about. It is shown because a panel listing only\n   * the optional purposes cannot answer the question a visitor opened it to answer — what is\n   * happening on this site — which is why every specialized consent platform states it.\n   */\n  ESSENTIAL_TITLE = 'essential-title',\n  /** What the always-active row covers, and why its control is checked and cannot be changed. */\n  ESSENTIAL_DESCRIPTION = 'essential-description',\n}\n\nconst CONSENT_LABEL_KEY_PREFIX = 'website.chrome.consent';\n\n/** The fully-composed key for one panel slot. */\nexport function websiteConsentLabelKey(slot: WebsiteConsentLabelSlot): WebsiteLabelKey {\n  return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.${slot}`);\n}\n\n/** The fully-composed key naming one consent purpose. */\nexport function websiteConsentPurposeLabelKey(purpose: ConsentPurpose): WebsiteLabelKey {\n  return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.purpose-${purpose}`);\n}\n\n/**\n * The key EXPLAINING one consent purpose — what agreeing to it means for this visitor.\n *\n * The name above answers *what is it called*; this answers *what will happen to me*, and a choice\n * made without the second is not an informed one. \"Analytics\" beside a tick box is a category, not\n * something a visitor can weigh.\n *\n * Derived from the vocabulary exactly as the name is, so a purpose added to `ConsentPurpose` is a\n * missing label in every site's pack at the next build rather than a row that renders a name with no\n * explanation beneath it.\n */\nexport function websiteConsentPurposeDescriptionLabelKey(purpose: ConsentPurpose): WebsiteLabelKey {\n  return WebsiteLabelKeySchema.parse(`${CONSENT_LABEL_KEY_PREFIX}.purpose-${purpose}-description`);\n}\n\n/** Every framework-owned consent key — what a locale pack must carry. Total over both vocabularies. */\nexport const WEBSITE_CONSENT_LABEL_KEYS: readonly WebsiteLabelKey[] = Object.freeze([\n  ...Object.values(WebsiteConsentLabelSlot).map(websiteConsentLabelKey),\n  ...CONSENT_PURPOSES.map(websiteConsentPurposeLabelKey),\n  ...CONSENT_PURPOSES.map(websiteConsentPurposeDescriptionLabelKey),\n]);\n"]}

package/dist/esm/schemas/label-keys/website-label-key.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-label-key.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/label-keys/website-label-key.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,QAAA,MAAM,sBAAsB,2DAWC,CAAC;AAE9B,eAAO,MAAM,qBAAqB,EAAE,OAAO,sBAA+C,CAAC;AAE3F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACrE,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAElB;;AACD,oEAAoE"}
+{"version":3,"file":"website-label-key.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/label-keys/website-label-key.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,QAAA,MAAM,sBAAsB,2DAWC,CAAC;AAE9B,eAAO,MAAM,qBAAqB,EAAE,OAAO,sBAA+C,CAAC;AAE3F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACrE,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAElB;;AACD,oEAAoE"}

package/dist/esm/schemas/label-keys/website-provider-component-label-keys.schemas.d.ts

@@ -0,0 +1,32 @@
+import { type WebsiteLabelKey } from './website-label-key.schemas';
+/**
+ * The label keys the framework's provider-component slot reads (#1703).
+ *
+ * FRAMEWORK-OWNED, like the consent panel's keys: `WebsiteProviderComponent` renders these states,
+ * not the site's chrome, so the site does not list them in `chromeLabelKeys`.
+ * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a
+ * locale pack missing one fails the build rather than showing a visitor a raw key.
+ *
+ * Required of every site, including one that places no provider component today, for the reason the
+ * consent keys are: the words are cheap, and a site that adds an address lookup tomorrow must not
+ * ship it with an unlabelled refusal. The consent-required state also names each missing purpose and
+ * offers the panel, and it reuses the consent keys for both (`purpose-<purpose>`, `manage`) rather
+ * than a second wording of the same thing.
+ */
+export declare enum WebsiteProviderComponentLabelSlot {
+    /**
+     * Shown where a provider component would be when the visitor has not agreed to a purpose it rests
+     * on. Says the feature is off until they agree; the purposes and the way to agree follow it.
+     */
+    CONSENT_REQUIRED = "consent-required",
+    /**
+     * Shown when the component could not be loaded (a network failure, a blocked script). Says the
+     * feature is unavailable right now, without blaming the visitor.
+     */
+    UNAVAILABLE = "unavailable"
+}
+/** The fully-composed key for one slot state. */
+export declare function websiteProviderComponentLabelKey(slot: WebsiteProviderComponentLabelSlot): WebsiteLabelKey;
+/** Every framework-owned provider-component key — what a locale pack must carry. Total over the vocabulary. */
+export declare const WEBSITE_PROVIDER_COMPONENT_LABEL_KEYS: readonly WebsiteLabelKey[];
+//# sourceMappingURL=website-provider-component-label-keys.schemas.d.ts.map

package/dist/esm/schemas/label-keys/website-provider-component-label-keys.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-provider-component-label-keys.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/label-keys/website-provider-component-label-keys.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,oBAAY,iCAAiC;IAC3C;;;OAGG;IACH,gBAAgB,qBAAqB;IACrC;;;OAGG;IACH,WAAW,gBAAgB;CAC5B;AAID,iDAAiD;AACjD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,iCAAiC,GAAG,eAAe,CAEzG;AAED,+GAA+G;AAC/G,eAAO,MAAM,qCAAqC,EAAE,SAAS,eAAe,EAE3E,CAAC"}

package/dist/esm/schemas/label-keys/website-provider-component-label-keys.schemas.js

@@ -0,0 +1,36 @@
+import { WebsiteLabelKeySchema } from './website-label-key.schemas.js';
+/**
+ * The label keys the framework's provider-component slot reads (#1703).
+ *
+ * FRAMEWORK-OWNED, like the consent panel's keys: `WebsiteProviderComponent` renders these states,
+ * not the site's chrome, so the site does not list them in `chromeLabelKeys`.
+ * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a
+ * locale pack missing one fails the build rather than showing a visitor a raw key.
+ *
+ * Required of every site, including one that places no provider component today, for the reason the
+ * consent keys are: the words are cheap, and a site that adds an address lookup tomorrow must not
+ * ship it with an unlabelled refusal. The consent-required state also names each missing purpose and
+ * offers the panel, and it reuses the consent keys for both (`purpose-<purpose>`, `manage`) rather
+ * than a second wording of the same thing.
+ */
+export var WebsiteProviderComponentLabelSlot;
+(function (WebsiteProviderComponentLabelSlot) {
+    /**
+     * Shown where a provider component would be when the visitor has not agreed to a purpose it rests
+     * on. Says the feature is off until they agree; the purposes and the way to agree follow it.
+     */
+    WebsiteProviderComponentLabelSlot["CONSENT_REQUIRED"] = "consent-required";
+    /**
+     * Shown when the component could not be loaded (a network failure, a blocked script). Says the
+     * feature is unavailable right now, without blaming the visitor.
+     */
+    WebsiteProviderComponentLabelSlot["UNAVAILABLE"] = "unavailable";
+})(WebsiteProviderComponentLabelSlot || (WebsiteProviderComponentLabelSlot = {}));
+const PROVIDER_COMPONENT_LABEL_KEY_PREFIX = 'website.chrome.provider-component';
+/** The fully-composed key for one slot state. */
+export function websiteProviderComponentLabelKey(slot) {
+    return WebsiteLabelKeySchema.parse(`${PROVIDER_COMPONENT_LABEL_KEY_PREFIX}.${slot}`);
+}
+/** Every framework-owned provider-component key — what a locale pack must carry. Total over the vocabulary. */
+export const WEBSITE_PROVIDER_COMPONENT_LABEL_KEYS = Object.freeze(Object.values(WebsiteProviderComponentLabelSlot).map(websiteProviderComponentLabelKey));
+//# sourceMappingURL=website-provider-component-label-keys.schemas.js.map

package/dist/esm/schemas/label-keys/website-provider-component-label-keys.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-provider-component-label-keys.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/label-keys/website-provider-component-label-keys.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,6BAA6B,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,iCAWX;AAXD,WAAY,iCAAiC;IAC3C;;;OAGG;IACH,0EAAqC,CAAA;IACrC;;;OAGG;IACH,gEAA2B,CAAA;AAC7B,CAAC,EAXW,iCAAiC,KAAjC,iCAAiC,QAW5C;AAED,MAAM,mCAAmC,GAAG,mCAAmC,CAAC;AAEhF,iDAAiD;AACjD,MAAM,UAAU,gCAAgC,CAAC,IAAuC;IACtF,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,mCAAmC,IAAI,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,MAAM,qCAAqC,GAA+B,MAAM,CAAC,MAAM,CAC5F,MAAM,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC,GAAG,CAAC,gCAAgC,CAAC,CACvF,CAAC","sourcesContent":["import { WebsiteLabelKeySchema, type WebsiteLabelKey } from './website-label-key.schemas';\n\n/**\n * The label keys the framework's provider-component slot reads (#1703).\n *\n * FRAMEWORK-OWNED, like the consent panel's keys: `WebsiteProviderComponent` renders these states,\n * not the site's chrome, so the site does not list them in `chromeLabelKeys`.\n * `composeEffectiveChromeLabelKeys` unions them into the label-pack validator's expected set, so a\n * locale pack missing one fails the build rather than showing a visitor a raw key.\n *\n * Required of every site, including one that places no provider component today, for the reason the\n * consent keys are: the words are cheap, and a site that adds an address lookup tomorrow must not\n * ship it with an unlabelled refusal. The consent-required state also names each missing purpose and\n * offers the panel, and it reuses the consent keys for both (`purpose-<purpose>`, `manage`) rather\n * than a second wording of the same thing.\n */\nexport enum WebsiteProviderComponentLabelSlot {\n  /**\n   * Shown where a provider component would be when the visitor has not agreed to a purpose it rests\n   * on. Says the feature is off until they agree; the purposes and the way to agree follow it.\n   */\n  CONSENT_REQUIRED = 'consent-required',\n  /**\n   * Shown when the component could not be loaded (a network failure, a blocked script). Says the\n   * feature is unavailable right now, without blaming the visitor.\n   */\n  UNAVAILABLE = 'unavailable',\n}\n\nconst PROVIDER_COMPONENT_LABEL_KEY_PREFIX = 'website.chrome.provider-component';\n\n/** The fully-composed key for one slot state. */\nexport function websiteProviderComponentLabelKey(slot: WebsiteProviderComponentLabelSlot): WebsiteLabelKey {\n  return WebsiteLabelKeySchema.parse(`${PROVIDER_COMPONENT_LABEL_KEY_PREFIX}.${slot}`);\n}\n\n/** Every framework-owned provider-component key — what a locale pack must carry. Total over the vocabulary. */\nexport const WEBSITE_PROVIDER_COMPONENT_LABEL_KEYS: readonly WebsiteLabelKey[] = Object.freeze(\n  Object.values(WebsiteProviderComponentLabelSlot).map(websiteProviderComponentLabelKey),\n);\n"]}

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

@@ -1 +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"}
+{"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-root-config.shared.schemas.d.ts

@@ -85,9 +85,10 @@ export type WebsiteSitemapConfig = z.infer<typeof _WebsiteSitemapConfigSchema>;
  *     `'noindex'` is the deliberate exception (staging environments,
  *     beta surfaces, sites still under construction). The opt-OUT
  *     shape mirrors `WebsiteSitemapConfig.enabled` for consistency.
- *   - `'noindex'` emits a `User-agent: *\nDisallow: /` block — the
- *     standard "tell every well-behaved crawler to stay away"
- *     primitive.
+ *   - `'noindex'` is expressed by a `<meta name="robots" content="noindex">`
+ *     on every page, NOT by `Disallow: /` in `robots.txt` (#494): a crawler
+ *     barred from fetching a page never reads its noindex, so the URL can
+ *     still be indexed bare. `robots.txt` stays allow-everything for it.
  *
  * **Why `disallow[]` is a path-prefix list (not a regex)**:
  *   - The `robots.txt` spec only supports literal path prefixes
@@ -412,8 +413,8 @@ export declare const WebsiteRootConfigSchema: typeof _WebsiteRootConfigSchema;
  * and `navigation.footerComponent` as `unknown` (their schema field
  * type), losing the `ComponentType<unknown>` narrowing carried by the
  * hand-written `WebsitePageManifest` and `WebsiteNavigationConfig`
- * interfaces. Factories such as `defineWebsiteRootConfig` and the
- * layout primitives consume `WebsiteRootConfig` and must see those
+ * interfaces. The layout primitives and the Astro helpers consume
+ * `WebsiteRootConfig` and must see those
  * fields pre-narrowed; otherwise every consumer would need a local
  * `as ComponentType` cast at the JSX call site, defeating the type-safe
  * component contract.

package/dist/esm/schemas/manifests/website-root-config.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-root-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/manifests/website-root-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,QAAA,MAAM,2BAA2B;;;;;;;;;;;;iBAU/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,6DAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;iBAsC5B,CAAC;AAEL,eAAO,MAAM,yBAAyB,EAAE,OAAO,0BACnB,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC7E,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;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,8DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BzB,CAAC;AAEL,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAE9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACvE,0DAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,8BAA8B;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,OAAO,8BACnB,CAAC;AAEjC,MAAM,WAAW,uBACf,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC;IACtD,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACzC;AACD,iEAAiE;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2F1B,CAAC;AAEL,eAAO,MAAM,uBAAuB,EAAE,OAAO,wBAAmD,CAAC;AAEjG;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EACxC,eAAe,GAAG,YAAY,CAC/B,GAAG;IACF,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAAC;;AACF,6DAA6D"}
+{"version":3,"file":"website-root-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/manifests/website-root-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,QAAA,MAAM,2BAA2B;;;;;;;;;;;;iBAU/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,6DAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;iBAsC5B,CAAC;AAEL,eAAO,MAAM,yBAAyB,EAAE,OAAO,0BACnB,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC7E,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;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,8DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BzB,CAAC;AAEL,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAAiD,CAAC;AAE9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACvE,0DAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,8BAA8B;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,OAAO,8BACnB,CAAC;AAEjC,MAAM,WAAW,uBACf,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC;IACtD,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACzC;AACD,iEAAiE;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2F1B,CAAC;AAEL,eAAO,MAAM,uBAAuB,EAAE,OAAO,wBAAmD,CAAC;AAEjG;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EACxC,eAAe,GAAG,YAAY,CAC/B,GAAG;IACF,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAAC;;AACF,6DAA6D"}

package/dist/esm/schemas/manifests/website-root-config.shared.schemas.js

@@ -83,9 +83,10 @@ export const WebsiteSitemapConfigSchema = _WebsiteSitemapConfigSchema;
  *     `'noindex'` is the deliberate exception (staging environments,
  *     beta surfaces, sites still under construction). The opt-OUT
  *     shape mirrors `WebsiteSitemapConfig.enabled` for consistency.
- *   - `'noindex'` emits a `User-agent: *\nDisallow: /` block — the
- *     standard "tell every well-behaved crawler to stay away"
- *     primitive.
+ *   - `'noindex'` is expressed by a `<meta name="robots" content="noindex">`
+ *     on every page, NOT by `Disallow: /` in `robots.txt` (#494): a crawler
+ *     barred from fetching a page never reads its noindex, so the URL can
+ *     still be indexed bare. `robots.txt` stays allow-everything for it.
  *
  * **Why `disallow[]` is a path-prefix list (not a regex)**:
  *   - The `robots.txt` spec only supports literal path prefixes
@@ -383,10 +384,10 @@ const _WebsiteRootConfigSchema = z
      *     the chrome) or above it (creating a structural surface
      *     the framework needs anyway).
      *
-     * The key MUST also be present in `chromeLabelKeys` (the
-     * label-pack validator silences "orphaned" warnings off
-     * `chromeLabelKeys`) — the framework adds it automatically via
-     * the `superRefine` pass below so consumers cannot forget.
+     * It is validated as a chrome key without being listed in
+     * `chromeLabelKeys`: the label-pack loader adds it to the effective
+     * chrome key set (`composeEffectiveChromeLabelKeys` in
+     * `astro/label-pack-loader.ts`), so consumers cannot forget it.
      */
     skipToMainContentLabelKey: WebsiteLabelKeySchema,
 })

package/dist/esm/schemas/manifests/website-root-config.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"website-root-config.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/manifests/website-root-config.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,yBAAyB,GAE1B,MAAM,wCAAwC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC3E,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;SAC1E,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;SAC1E,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GACrC,2BAA2B,CAAC;AAG9B,6DAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,0BAA0B,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrD,QAAQ,EAAE,CAAC;SACR,KAAK,CACJ,CAAC;SACE,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;QACtC,KAAK,EAAE,4DAA4D;KACpE,CAAC,CACL;SACA,QAAQ,EAAE;IACb;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1D,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAClF,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,iBAAiB,CAAC;YACzB,OAAO,EACL,sJAAsJ;SACzJ,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,yBAAyB,GACpC,0BAA0B,CAAC;AAG7B,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GACrC,2BAA2B,CAAC;AAG9B,8DAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,sDAAsD,EAAE,CAAC;IAC5E,iBAAiB,EAAE,CAAC;SACjB,GAAG,CAAC,EAAE,KAAK,EAAE,kEAAkE,EAAE,CAAC;SAClF,QAAQ,EAAE;IACb;;;;OAIG;IACH,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAC/C;;;;OAIG;IACH,MAAM,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IAC7C;;;;OAIG;IACH,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,sBAAsB,GAAmC,uBAAuB,CAAC;AAG9F,0DAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GACxC,8BAA8B,CAAC;AAOjC,iEAAiE;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAM,wBAAwB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE;QACvD,KAAK,EAAE,2DAA2D;KACnE,CAAC;IACF,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,8BAA8B;IAC1C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D;;;;;;;;OAQG;IACH,GAAG,EAAE,uBAAuB;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,yBAAyB,EAAE,qBAAqB;CACjD,CAAC;KACD,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAwB,CAAC;QACjD,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC;gBACrC,OAAO,EAAE,uBAAuB,MAAM,sCAAsC;aAC7E,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErB,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAA8B,CAAC;QACzD,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC;gBAC3C,OAAO,EAAE,wBAAwB,QAAQ,sCAAsC;aAChF,CAAC,CAAC;QACL,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,GAAwB,CAAC;QACxC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,iBAAiB,EAAE,KAAK,CAAC;gBAChC,OAAO,EAAE,+BAA+B,MAAM,wCAAwC;aACvF,CAAC,CAAC;QACL,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,uBAAuB,GAAoC,wBAAwB,CAAC;AA4BjG,6DAA6D","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\n\nimport { WebsiteDesignTokensSchema } from '../design-tokens/website-design-tokens.shared.schemas';\nimport { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas';\nimport {\n  WebsitePageManifestSchema,\n  type WebsitePageManifest,\n} from './website-page-manifest.shared.schemas';\n\n/**\n * @wildo_source:part:start saas.website.seo.sitemap-config facet:layer:shared facet:family:website\n *\n * `WebsiteSitemapConfig` — site-wide sitemap policy block.\n *\n * Materialized at build time by `@astrojs/sitemap` (the official\n * Astro plugin) when the consumer wires it into `astro.config.ts`\n * (see `website-seo-aeo-geo` SKILL). The framework owns the\n * **schema** (so config + enforcement live in lock-step with the\n * page registry) but the framework does NOT own the runtime\n * generator — `@astrojs/sitemap` already covers per-page\n * `lastmod` / `changefreq` / `priority` + i18n `xhtml:link\n * hreflang` annotations natively, and re-implementing that surface\n * inside the engine would duplicate well-trodden Astro tooling for\n * zero added value.\n *\n * # Field rationale\n *\n * **Why `enabled` defaults to `true`**:\n *   - Marketing sites that want to ship public pages overwhelmingly\n *     also want them in `sitemap.xml` (search engines treat its\n *     absence as a discoverability signal). The opt-OUT shape avoids\n *     a silent regression where a consumer ships pages that crawlers\n *     never index because they forgot to flip a flag.\n *   - The escape hatch (`enabled: false`) covers staging deployments\n *     and the rare per-app decision to suppress sitemap emission\n *     entirely (e.g. a private beta surface routed under a\n *     `noindex` policy).\n *\n * **Why `changefreq` / `priority` are OPTIONAL** (no defaults):\n *   - Both fields are non-binding hints — Google explicitly\n *     ignores `priority` and treats `changefreq` as a soft signal.\n *     Forcing the consumer to pick a value would either invite\n *     superstitious authoring (`priority: 1.0` on every page) or\n *     bury the field's actual ergonomic shape (per-page overrides\n *     via `WebsitePageManifest.seo` — deferred until a real\n *     consumer requests it).\n *   - Unset values are simply omitted from the emitted `<url>`\n *     entries; `@astrojs/sitemap` handles that automatically.\n *\n * **Validation**:\n *   - `priority` is `z.number().min(0).max(1)` — outside the spec\n *     range would silently break crawler ingestion.\n *   - `changefreq` is the union of the seven values the sitemap\n *     spec defines; arbitrary strings would be silently dropped by\n *     compliant crawlers.\n */\nconst _WebsiteSitemapConfigSchema = z.object({\n  enabled: z.boolean().default(true),\n  changefreq: z\n    .enum(['always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never'])\n    .optional(),\n  priority: z\n    .number()\n    .min(0, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })\n    .max(1, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })\n    .optional(),\n});\n\nexport const WebsiteSitemapConfigSchema: typeof _WebsiteSitemapConfigSchema =\n  _WebsiteSitemapConfigSchema;\n\nexport type WebsiteSitemapConfig = z.infer<typeof _WebsiteSitemapConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.sitemap-config */\n\n/**\n * @wildo_source:part:start saas.website.seo.robots-config facet:layer:shared facet:family:website\n *\n * `WebsiteRobotsConfig` — site-wide `robots.txt` policy block.\n *\n * Materialized at request time by `renderRobotsTxt(siteContext)`\n * from `@wildo-ai/saas-website/astro` (consumer wires a thin\n * `src/pages/robots.txt.ts` Astro endpoint that returns the helper's\n * output). Scoped to the SITE-WIDE policy surface — per-page\n * `noindex` is a separate concern that lands on\n * `WebsitePageManifest.seo` once a real consumer requests it (today\n * the site-wide `disallow[]` covers staging-environment exclusion of\n * specific path prefixes, the dominant real-world use case).\n *\n * # Field rationale\n *\n * **Why `policy` defaults to `'index'`**:\n *   - The default for a public marketing site is \"let crawlers in\";\n *     `'noindex'` is the deliberate exception (staging environments,\n *     beta surfaces, sites still under construction). The opt-OUT\n *     shape mirrors `WebsiteSitemapConfig.enabled` for consistency.\n *   - `'noindex'` emits a `User-agent: *\\nDisallow: /` block — the\n *     standard \"tell every well-behaved crawler to stay away\"\n *     primitive.\n *\n * **Why `disallow[]` is a path-prefix list (not a regex)**:\n *   - The `robots.txt` spec only supports literal path prefixes\n *     with `*` / `$` wildcards; Disallow is NOT a regex surface.\n *     Typing it as `string[]` (validated to start with `/`) keeps\n *     the contract honest and lets consumers paste from their CDN\n *     allowlists without translation.\n *\n * **Why `allowedCrawlers` and `disallowedCrawlers` are mutually\n * exclusive**:\n *   - The two fields are two halves of the SAME AI-crawler policy\n *     decision. `allowedCrawlers` is the deny-by-default shape\n *     (only the named bots may crawl); `disallowedCrawlers` is the\n *     allow-by-default shape (every bot except the named ones may\n *     crawl). Mixing both would emit a contradictory `robots.txt`\n *     (a bot in both lists would receive conflicting directives).\n *     A `superRefine` enforces the mutual-exclusion invariant at\n *     parse time so the build fails fast.\n *\n * **Validation**:\n *   - `disallow[]` entries must start with `/` (sitemap path-prefix\n *     spec) — anything else would silently match nothing.\n *   - `allowedCrawlers` / `disallowedCrawlers` entries must be\n *     non-empty strings (a blank User-agent token would emit\n *     `User-agent: ` which compliant crawlers ignore — silent\n *     misconfig).\n *   - `superRefine` rejects the combined-list anti-pattern.\n */\nconst _WebsiteRobotsConfigSchema = z\n  .object({\n    policy: z.enum(['index', 'noindex']).default('index'),\n    disallow: z\n      .array(\n        z\n          .string()\n          .min(1)\n          .refine((path) => path.startsWith('/'), {\n            error: 'WebsiteRobotsConfig.disallow[] entries must start with \"/\"',\n          }),\n      )\n      .optional(),\n    /**\n     * Deny-by-default AI-crawler allowlist. When set, the emitted\n     * `robots.txt` lists each named bot under its own\n     * `User-agent: <bot>\\nAllow: /` block, then closes with a\n     * catch-all `User-agent: *\\nDisallow: /`. Mutually exclusive\n     * with `disallowedCrawlers` (see `superRefine` below).\n     */\n    allowedCrawlers: z.array(z.string().min(1)).optional(),\n    /**\n     * Allow-by-default AI-crawler denylist. When set, the emitted\n     * `robots.txt` lists each named bot under its own\n     * `User-agent: <bot>\\nDisallow: /` block. Mutually exclusive\n     * with `allowedCrawlers` (see `superRefine` below).\n     */\n    disallowedCrawlers: z.array(z.string().min(1)).optional(),\n  })\n  .superRefine((value, ctx) => {\n    if (value.allowedCrawlers !== undefined && value.disallowedCrawlers !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['allowedCrawlers'],\n        message:\n          'WebsiteRobotsConfig.allowedCrawlers and disallowedCrawlers are mutually exclusive — pick one policy direction (deny-by-default vs allow-by-default).',\n      });\n    }\n  });\n\nexport const WebsiteRobotsConfigSchema: typeof _WebsiteRobotsConfigSchema =\n  _WebsiteRobotsConfigSchema;\n\nexport type WebsiteRobotsConfig = z.infer<typeof _WebsiteRobotsConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.robots-config */\n\n/**\n * @wildo_source:part:start saas.website.seo.llms-txt-config facet:layer:shared facet:family:website\n *\n * `WebsiteLlmsTxtConfig` — site-wide `llms.txt` publication policy.\n *\n * The framework owns only the SERVING surface; the CONTENT remains\n * hand-authored in `src/content/llms.txt`. This block therefore needs\n * exactly one knob:\n *\n * - `enabled?: boolean`\n *   - `true`  → publish when the file exists\n *   - `false` → suppress publication even if the file exists\n *   - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the\n *     file exists, returns `null` when absent)\n *\n * Keeping the \"auto-detect when undefined\" convention in the HELPER\n * (not as a schema default) is deliberate: schema defaults are static,\n * while file presence is runtime/build-time state.\n */\nconst _WebsiteLlmsTxtConfigSchema = z.object({\n  enabled: z.boolean().optional(),\n});\n\nexport const WebsiteLlmsTxtConfigSchema: typeof _WebsiteLlmsTxtConfigSchema =\n  _WebsiteLlmsTxtConfigSchema;\n\nexport type WebsiteLlmsTxtConfig = z.infer<typeof _WebsiteLlmsTxtConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.llms-txt-config */\n\n/**\n * @wildo_source:part:start saas.website.root-config.seo facet:layer:shared facet:family:website\n *\n * `WebsiteSeoConfig` — site-wide SEO/social-graph configuration\n * AUTHORED ON THE ROOT CONFIG.\n *\n * # Scope\n *\n * The public marketing-site origin belongs only in the per-service\n * `wildo.website.config.ts` declaration. Keep it out of this site-level SEO\n * block so the origin and localized routing have one source of truth.\n *\n * What stays on this block: site-level branding + hero-image\n * fallbacks that are co-authored with chrome labels and page\n * manifests respectively, NOT with the URL/i18n routing surface.\n *\n * # Field rationale\n *\n * **Why `siteName` is REQUIRED**:\n *   - `og:site_name` is the brand label social platforms render\n *     above the page title in shared previews. Without it, every\n *     LinkedIn / Facebook / Slack preview shows the bare title with\n *     no brand context.\n *   - It is also the recommended `application-name` meta tag value\n *     and a useful default for JSON-LD `Organization.name` schema\n *     when the application ships structured data.\n *\n * **Why `defaultOgImageUrl` is OPTIONAL**:\n *   - Each page's `WebsitePageManifest.metaLabelKeys.ogImageUrl`\n *     takes precedence; the site-level default is a fallback for\n *     pages that did not commit to a hero image.\n *   - Marketing surfaces shipping no OG images at all (acceptable\n *     for a placeholder build) should not be forced to author one.\n *\n * **Why `sitemap?` and `robots?` are OPTIONAL** (with sensible\n * defaults inside each sub-schema):\n *   - The marketing-site default ships a public surface — every\n *     page indexable, no AI-crawler restrictions, no per-path\n *     disallow. Forcing every consumer to author both blocks just\n *     to land in that default state would pollute the call site.\n *   - Omitting either block at the call site is equivalent to\n *     authoring `{}` — `WebsiteSitemapConfig.enabled` defaults to\n *     `true`, `WebsiteRobotsConfig.policy` defaults to `'index'`.\n *     The per-block field rationale lives on each sub-schema.\n *   - `llmsTxt?` is similarly optional, but with a different default\n *     mechanic: omitting the block means \"auto-detect from file\n *     presence\" rather than \"use a static schema default\". The helper\n *     `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`\n *     exists and returns `null` otherwise.\n *\n * **Validation**:\n *   - `siteName` is `z.string().min(1)` — empty strings would emit\n *     `<meta property=\"og:site_name\" content=\"\" />` which social\n *     platforms render as a blank line.\n *   - `defaultOgImageUrl` (when present) is `z.url()`.\n *   - `sitemap` / `robots` validation lives on the sub-schemas.\n */\nconst _WebsiteSeoConfigSchema = z\n  .object({\n    siteName: z\n      .string()\n      .min(1, { error: 'WebsiteSeoConfig.siteName must be a non-empty string' }),\n    defaultOgImageUrl: z\n      .url({ error: 'WebsiteSeoConfig.defaultOgImageUrl must be a fully-qualified URL' })\n      .optional(),\n    /**\n     * Sitemap policy block. Optional — omitting it is equivalent to\n     * `{ enabled: true }` (the marketing-site default). See\n     * `WebsiteSitemapConfigSchema` for field-by-field rationale.\n     */\n    sitemap: _WebsiteSitemapConfigSchema.optional(),\n    /**\n     * Robots.txt policy block. Optional — omitting it is equivalent\n     * to `{ policy: 'index' }` (the marketing-site default). See\n     * `WebsiteRobotsConfigSchema` for field-by-field rationale.\n     */\n    robots: _WebsiteRobotsConfigSchema.optional(),\n    /**\n     * `llms.txt` publication policy. Optional — omitting it means\n     * \"auto-detect from file presence\". See\n     * `WebsiteLlmsTxtConfigSchema` for the serving contract.\n     */\n    llmsTxt: _WebsiteLlmsTxtConfigSchema.optional(),\n  });\n\nexport const WebsiteSeoConfigSchema: typeof _WebsiteSeoConfigSchema = _WebsiteSeoConfigSchema;\n\nexport type WebsiteSeoConfig = z.infer<typeof _WebsiteSeoConfigSchema>;\n/** @wildo_source:part:end saas.website.root-config.seo */\n\n/**\n * @wildo_source:part:start saas.website.root-config.navigation facet:layer:shared facet:family:website\n *\n * `WebsiteNavigationConfig` — site-wide header/footer slot bindings.\n *\n * The framework intentionally ships no concrete header or footer. The\n * application authors both as React components, registers them once here, and\n * the page layout renders the site-wide chrome around every page.\n *\n * Both fields are typed as `unknown` at the schema layer with the\n * `WebsiteNavigationConfig` interface narrowing them to\n * `ComponentType<unknown>` — same rationale as\n * `WebsiteSectionDefinition.Component` and `WebsitePageManifest.pageComponent`.\n */\nconst _WebsiteNavigationConfigSchema = z.object({\n  headerComponent: z.unknown(),\n  footerComponent: z.unknown(),\n});\n\nexport const WebsiteNavigationConfigSchema: typeof _WebsiteNavigationConfigSchema =\n  _WebsiteNavigationConfigSchema;\n\nexport interface WebsiteNavigationConfig\n  extends z.infer<typeof _WebsiteNavigationConfigSchema> {\n  headerComponent: ComponentType<unknown>;\n  footerComponent: ComponentType<unknown>;\n}\n/** @wildo_source:part:end saas.website.root-config.navigation */\n\n/**\n * @wildo_source:part:start saas.website.root-config.schema facet:layer:shared facet:family:website\n *\n * `WebsiteRootConfig` — the site-level configuration consumed by:\n *   - the Astro adapter to drive i18n routing, page mounting,\n *     and design-token CSS emission,\n *   - the website audit command to validate label-pack\n *     coverage and SEO structured-data conformance,\n *   - the runtime `<WebsitePageLayout>` to render navigation\n *     and apply design tokens.\n *\n * **Authoring convention**: each marketing-site service exports a single\n * `WEBSITE_ROOT_CONFIG: WebsiteRootConfig` from `src/website-root.config.ts`.\n * The Astro adapter and the audit command\n * both consume this canonical entry point; there is exactly one site\n * config per marketing site (no per-page or per-section overrides at\n * this level — overrides flow through the L0/L1/L1.5 component\n * registration hierarchy described in D6).\n *\n * # Scope\n *\n * This block carries site-level chrome and registry data only. Per-locale\n * routing (`locales` / `defaultLocale`) and the public origin belong in the\n * per-service `wildo.website.config.ts` declaration, avoiding duplicated\n * configuration that could diverge during site generation.\n *\n * **Field-by-field rationale**:\n *\n * - `pageManifests` — the registry of every page on the site. Indexed\n *   downstream by `manifest.ref`. Refs MUST be unique (refinement\n *   below).\n * - `designTokens` — see `WebsiteDesignTokensSchema`.\n * - `navigation` — see `WebsiteNavigationConfigSchema`.\n * - `chromeLabelKeys` — OPTIONAL. The set of fully-composed label keys\n *   the site-wide chrome (header / footer / any global slot the\n *   consumer renders outside a section context) reads via\n *   `useWebsiteLabelByKey(...)`. Declared here, NOT in section\n *   `expectedLabelKeys`, because chrome is rendered outside the\n *   page+section context — `useWebsiteLabel(slot)` is structurally\n *   unavailable to it. Threading these through the label-pack\n *   validator (a) silences the always-on \"orphaned chrome key\" build\n *   warnings and (b) lets the build fail fast when a chrome key is\n *   missing from a locale pack, the same way section keys do.\n *   Defaults to an empty array; sites with no chrome label reads\n *   may omit the field entirely.\n * - `seo` — site-level branding + hero-image fallback (see\n *   `WebsiteSeoConfigSchema`). The marketing-site origin USED to live\n *   here as `seo.siteOrigin`; it now lives only on\n *   `WildoMarketingWebsiteConfig.publicOrigin`.\n * - `skipToMainContentLabelKey` — see field JSDoc below.\n *\n * **Refinements**:\n *   - `pageManifests[].ref` uniqueness — the registry is keyed by ref;\n *     duplicates would silently overwrite each other in the lookup\n *     table the bridge uses for cross-page links.\n *   - `pageManifests[].routePath` uniqueness — two pages cannot mount\n *     at the same path (Astro would error at build time, but we\n *     surface it earlier here with a clearer diagnostic).\n *   - `chromeLabelKeys` uniqueness — duplicates indicate copy-paste\n *     bugs at the consumer's call site; surface them here.\n */\nconst _WebsiteRootConfigSchema = z\n  .object({\n    pageManifests: z.array(WebsitePageManifestSchema).min(1, {\n      error: 'WebsiteRootConfig must declare at least one page manifest',\n    }),\n    designTokens: WebsiteDesignTokensSchema,\n    navigation: _WebsiteNavigationConfigSchema,\n    chromeLabelKeys: z.array(WebsiteLabelKeySchema).default([]),\n    /**\n     * Site-level branding + hero-image fallback used by the Astro\n     * head renderer to compose `<meta property=\"og:site_name\">` and\n     * the per-page OG image fallback. The marketing-site origin\n     * (`siteOrigin`) USED to live here; it was moved to\n     * `WildoMarketingWebsiteConfig.publicOrigin` in the seam-collapse\n     * (single source of truth for \"what's the origin this site is\n     * reachable at\").\n     */\n    seo: _WebsiteSeoConfigSchema,\n    /**\n     * Label key the framework reads to render the \"Skip to main\n     * content\" link as the first focusable element on every page\n     * Required because:\n     *   - Skip-to-main is a baseline keyboard-accessibility\n     *     affordance — WCAG 2.1 §2.4.1 \"Bypass Blocks\" (Level A)\n     *     mandates it. A marketing-site framework that omits it\n     *     fails AA for the entire surface; making the contract\n     *     opt-in invites that regression on every new consumer.\n     *   - The text is announced verbatim by assistive tech, so it\n     *     MUST be localized — a hardcoded English fallback would\n     *     speak \"Skip to main content\" to French users. Forcing the\n     *     key through the label-pack validation surface means the\n     *     dev server fails fast when the consumer forgets to add\n     *     the entry to a locale pack.\n     *   - The framework (NOT the consumer's chrome) owns rendering\n     *     the skip link because the chrome is itself the obstacle\n     *     the link bypasses — a chrome-side implementation would\n     *     either be inside the chrome (impossible to focus before\n     *     the chrome) or above it (creating a structural surface\n     *     the framework needs anyway).\n     *\n     * The key MUST also be present in `chromeLabelKeys` (the\n     * label-pack validator silences \"orphaned\" warnings off\n     * `chromeLabelKeys`) — the framework adds it automatically via\n     * the `superRefine` pass below so consumers cannot forget.\n     */\n    skipToMainContentLabelKey: WebsiteLabelKeySchema,\n  })\n  .superRefine((config, ctx) => {\n    const seenRefs = new Set<string>();\n    const seenRoutePaths = new Set<string>();\n    for (const [index, manifest] of config.pageManifests.entries()) {\n      const refKey = manifest.ref as unknown as string;\n      if (seenRefs.has(refKey)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['pageManifests', index, 'ref'],\n          message: `Duplicate page ref \"${refKey}\" in WebsiteRootConfig.pageManifests`,\n        });\n      }\n      seenRefs.add(refKey);\n\n      const routeKey = manifest.routePath as unknown as string;\n      if (seenRoutePaths.has(routeKey)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['pageManifests', index, 'routePath'],\n          message: `Duplicate routePath \"${routeKey}\" in WebsiteRootConfig.pageManifests`,\n        });\n      }\n      seenRoutePaths.add(routeKey);\n    }\n\n    /**\n     * `chromeLabelKeys` uniqueness — a duplicate is harmless at\n     * runtime (the validator de-dupes via a Set) but always indicates\n     * a copy-paste bug at the consumer's call site. Surfacing it here\n     * keeps the chrome contract tidy and matches the discipline applied\n     * to `pageManifests[].ref` and `locales`.\n     */\n    const seenChromeKeys = new Set<string>();\n    for (const [index, key] of config.chromeLabelKeys.entries()) {\n      const keyStr = key as unknown as string;\n      if (seenChromeKeys.has(keyStr)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['chromeLabelKeys', index],\n          message: `Duplicate chrome label key \"${keyStr}\" in WebsiteRootConfig.chromeLabelKeys`,\n        });\n      }\n      seenChromeKeys.add(keyStr);\n    }\n  });\n\nexport const WebsiteRootConfigSchema: typeof _WebsiteRootConfigSchema = _WebsiteRootConfigSchema;\n\n/**\n * Runtime shape of `WebsiteRootConfig`.\n *\n * Hand-written (NOT a bare `z.infer<typeof _WebsiteRootConfigSchema>`)\n * because `z.infer` walks the schema tree and would type\n * `pageManifests[number].pageComponent`, `navigation.headerComponent`\n * and `navigation.footerComponent` as `unknown` (their schema field\n * type), losing the `ComponentType<unknown>` narrowing carried by the\n * hand-written `WebsitePageManifest` and `WebsiteNavigationConfig`\n * interfaces. Factories such as `defineWebsiteRootConfig` and the\n * layout primitives consume `WebsiteRootConfig` and must see those\n * fields pre-narrowed; otherwise every consumer would need a local\n * `as ComponentType` cast at the JSX call site, defeating the type-safe\n * component contract.\n *\n * The `Omit` + intersection pattern keeps the rest of the inferred\n * shape (`designTokens`, `seo`, `chromeLabelKeys`,\n * `skipToMainContentLabelKey`) sourced directly from the schema.\n */\nexport type WebsiteRootConfig = Omit<\n  z.infer<typeof _WebsiteRootConfigSchema>,\n  'pageManifests' | 'navigation'\n> & {\n  pageManifests: WebsitePageManifest[];\n  navigation: WebsiteNavigationConfig;\n};\n/** @wildo_source:part:end saas.website.root-config.schema */\n"]}
+{"version":3,"file":"website-root-config.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/manifests/website-root-config.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\n\nimport { WebsiteDesignTokensSchema } from '../design-tokens/website-design-tokens.shared.schemas';\nimport { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas';\nimport {\n  WebsitePageManifestSchema,\n  type WebsitePageManifest,\n} from './website-page-manifest.shared.schemas';\n\n/**\n * @wildo_source:part:start saas.website.seo.sitemap-config facet:layer:shared facet:family:website\n *\n * `WebsiteSitemapConfig` — site-wide sitemap policy block.\n *\n * Materialized at build time by `@astrojs/sitemap` (the official\n * Astro plugin) when the consumer wires it into `astro.config.ts`\n * (see `website-seo-aeo-geo` SKILL). The framework owns the\n * **schema** (so config + enforcement live in lock-step with the\n * page registry) but the framework does NOT own the runtime\n * generator — `@astrojs/sitemap` already covers per-page\n * `lastmod` / `changefreq` / `priority` + i18n `xhtml:link\n * hreflang` annotations natively, and re-implementing that surface\n * inside the engine would duplicate well-trodden Astro tooling for\n * zero added value.\n *\n * # Field rationale\n *\n * **Why `enabled` defaults to `true`**:\n *   - Marketing sites that want to ship public pages overwhelmingly\n *     also want them in `sitemap.xml` (search engines treat its\n *     absence as a discoverability signal). The opt-OUT shape avoids\n *     a silent regression where a consumer ships pages that crawlers\n *     never index because they forgot to flip a flag.\n *   - The escape hatch (`enabled: false`) covers staging deployments\n *     and the rare per-app decision to suppress sitemap emission\n *     entirely (e.g. a private beta surface routed under a\n *     `noindex` policy).\n *\n * **Why `changefreq` / `priority` are OPTIONAL** (no defaults):\n *   - Both fields are non-binding hints — Google explicitly\n *     ignores `priority` and treats `changefreq` as a soft signal.\n *     Forcing the consumer to pick a value would either invite\n *     superstitious authoring (`priority: 1.0` on every page) or\n *     bury the field's actual ergonomic shape (per-page overrides\n *     via `WebsitePageManifest.seo` — deferred until a real\n *     consumer requests it).\n *   - Unset values are simply omitted from the emitted `<url>`\n *     entries; `@astrojs/sitemap` handles that automatically.\n *\n * **Validation**:\n *   - `priority` is `z.number().min(0).max(1)` — outside the spec\n *     range would silently break crawler ingestion.\n *   - `changefreq` is the union of the seven values the sitemap\n *     spec defines; arbitrary strings would be silently dropped by\n *     compliant crawlers.\n */\nconst _WebsiteSitemapConfigSchema = z.object({\n  enabled: z.boolean().default(true),\n  changefreq: z\n    .enum(['always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never'])\n    .optional(),\n  priority: z\n    .number()\n    .min(0, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })\n    .max(1, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })\n    .optional(),\n});\n\nexport const WebsiteSitemapConfigSchema: typeof _WebsiteSitemapConfigSchema =\n  _WebsiteSitemapConfigSchema;\n\nexport type WebsiteSitemapConfig = z.infer<typeof _WebsiteSitemapConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.sitemap-config */\n\n/**\n * @wildo_source:part:start saas.website.seo.robots-config facet:layer:shared facet:family:website\n *\n * `WebsiteRobotsConfig` — site-wide `robots.txt` policy block.\n *\n * Materialized at request time by `renderRobotsTxt(siteContext)`\n * from `@wildo-ai/saas-website/astro` (consumer wires a thin\n * `src/pages/robots.txt.ts` Astro endpoint that returns the helper's\n * output). Scoped to the SITE-WIDE policy surface — per-page\n * `noindex` is a separate concern that lands on\n * `WebsitePageManifest.seo` once a real consumer requests it (today\n * the site-wide `disallow[]` covers staging-environment exclusion of\n * specific path prefixes, the dominant real-world use case).\n *\n * # Field rationale\n *\n * **Why `policy` defaults to `'index'`**:\n *   - The default for a public marketing site is \"let crawlers in\";\n *     `'noindex'` is the deliberate exception (staging environments,\n *     beta surfaces, sites still under construction). The opt-OUT\n *     shape mirrors `WebsiteSitemapConfig.enabled` for consistency.\n *   - `'noindex'` is expressed by a `<meta name=\"robots\" content=\"noindex\">`\n *     on every page, NOT by `Disallow: /` in `robots.txt` (#494): a crawler\n *     barred from fetching a page never reads its noindex, so the URL can\n *     still be indexed bare. `robots.txt` stays allow-everything for it.\n *\n * **Why `disallow[]` is a path-prefix list (not a regex)**:\n *   - The `robots.txt` spec only supports literal path prefixes\n *     with `*` / `$` wildcards; Disallow is NOT a regex surface.\n *     Typing it as `string[]` (validated to start with `/`) keeps\n *     the contract honest and lets consumers paste from their CDN\n *     allowlists without translation.\n *\n * **Why `allowedCrawlers` and `disallowedCrawlers` are mutually\n * exclusive**:\n *   - The two fields are two halves of the SAME AI-crawler policy\n *     decision. `allowedCrawlers` is the deny-by-default shape\n *     (only the named bots may crawl); `disallowedCrawlers` is the\n *     allow-by-default shape (every bot except the named ones may\n *     crawl). Mixing both would emit a contradictory `robots.txt`\n *     (a bot in both lists would receive conflicting directives).\n *     A `superRefine` enforces the mutual-exclusion invariant at\n *     parse time so the build fails fast.\n *\n * **Validation**:\n *   - `disallow[]` entries must start with `/` (sitemap path-prefix\n *     spec) — anything else would silently match nothing.\n *   - `allowedCrawlers` / `disallowedCrawlers` entries must be\n *     non-empty strings (a blank User-agent token would emit\n *     `User-agent: ` which compliant crawlers ignore — silent\n *     misconfig).\n *   - `superRefine` rejects the combined-list anti-pattern.\n */\nconst _WebsiteRobotsConfigSchema = z\n  .object({\n    policy: z.enum(['index', 'noindex']).default('index'),\n    disallow: z\n      .array(\n        z\n          .string()\n          .min(1)\n          .refine((path) => path.startsWith('/'), {\n            error: 'WebsiteRobotsConfig.disallow[] entries must start with \"/\"',\n          }),\n      )\n      .optional(),\n    /**\n     * Deny-by-default AI-crawler allowlist. When set, the emitted\n     * `robots.txt` lists each named bot under its own\n     * `User-agent: <bot>\\nAllow: /` block, then closes with a\n     * catch-all `User-agent: *\\nDisallow: /`. Mutually exclusive\n     * with `disallowedCrawlers` (see `superRefine` below).\n     */\n    allowedCrawlers: z.array(z.string().min(1)).optional(),\n    /**\n     * Allow-by-default AI-crawler denylist. When set, the emitted\n     * `robots.txt` lists each named bot under its own\n     * `User-agent: <bot>\\nDisallow: /` block. Mutually exclusive\n     * with `allowedCrawlers` (see `superRefine` below).\n     */\n    disallowedCrawlers: z.array(z.string().min(1)).optional(),\n  })\n  .superRefine((value, ctx) => {\n    if (value.allowedCrawlers !== undefined && value.disallowedCrawlers !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['allowedCrawlers'],\n        message:\n          'WebsiteRobotsConfig.allowedCrawlers and disallowedCrawlers are mutually exclusive — pick one policy direction (deny-by-default vs allow-by-default).',\n      });\n    }\n  });\n\nexport const WebsiteRobotsConfigSchema: typeof _WebsiteRobotsConfigSchema =\n  _WebsiteRobotsConfigSchema;\n\nexport type WebsiteRobotsConfig = z.infer<typeof _WebsiteRobotsConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.robots-config */\n\n/**\n * @wildo_source:part:start saas.website.seo.llms-txt-config facet:layer:shared facet:family:website\n *\n * `WebsiteLlmsTxtConfig` — site-wide `llms.txt` publication policy.\n *\n * The framework owns only the SERVING surface; the CONTENT remains\n * hand-authored in `src/content/llms.txt`. This block therefore needs\n * exactly one knob:\n *\n * - `enabled?: boolean`\n *   - `true`  → publish when the file exists\n *   - `false` → suppress publication even if the file exists\n *   - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the\n *     file exists, returns `null` when absent)\n *\n * Keeping the \"auto-detect when undefined\" convention in the HELPER\n * (not as a schema default) is deliberate: schema defaults are static,\n * while file presence is runtime/build-time state.\n */\nconst _WebsiteLlmsTxtConfigSchema = z.object({\n  enabled: z.boolean().optional(),\n});\n\nexport const WebsiteLlmsTxtConfigSchema: typeof _WebsiteLlmsTxtConfigSchema =\n  _WebsiteLlmsTxtConfigSchema;\n\nexport type WebsiteLlmsTxtConfig = z.infer<typeof _WebsiteLlmsTxtConfigSchema>;\n/** @wildo_source:part:end saas.website.seo.llms-txt-config */\n\n/**\n * @wildo_source:part:start saas.website.root-config.seo facet:layer:shared facet:family:website\n *\n * `WebsiteSeoConfig` — site-wide SEO/social-graph configuration\n * AUTHORED ON THE ROOT CONFIG.\n *\n * # Scope\n *\n * The public marketing-site origin belongs only in the per-service\n * `wildo.website.config.ts` declaration. Keep it out of this site-level SEO\n * block so the origin and localized routing have one source of truth.\n *\n * What stays on this block: site-level branding + hero-image\n * fallbacks that are co-authored with chrome labels and page\n * manifests respectively, NOT with the URL/i18n routing surface.\n *\n * # Field rationale\n *\n * **Why `siteName` is REQUIRED**:\n *   - `og:site_name` is the brand label social platforms render\n *     above the page title in shared previews. Without it, every\n *     LinkedIn / Facebook / Slack preview shows the bare title with\n *     no brand context.\n *   - It is also the recommended `application-name` meta tag value\n *     and a useful default for JSON-LD `Organization.name` schema\n *     when the application ships structured data.\n *\n * **Why `defaultOgImageUrl` is OPTIONAL**:\n *   - Each page's `WebsitePageManifest.metaLabelKeys.ogImageUrl`\n *     takes precedence; the site-level default is a fallback for\n *     pages that did not commit to a hero image.\n *   - Marketing surfaces shipping no OG images at all (acceptable\n *     for a placeholder build) should not be forced to author one.\n *\n * **Why `sitemap?` and `robots?` are OPTIONAL** (with sensible\n * defaults inside each sub-schema):\n *   - The marketing-site default ships a public surface — every\n *     page indexable, no AI-crawler restrictions, no per-path\n *     disallow. Forcing every consumer to author both blocks just\n *     to land in that default state would pollute the call site.\n *   - Omitting either block at the call site is equivalent to\n *     authoring `{}` — `WebsiteSitemapConfig.enabled` defaults to\n *     `true`, `WebsiteRobotsConfig.policy` defaults to `'index'`.\n *     The per-block field rationale lives on each sub-schema.\n *   - `llmsTxt?` is similarly optional, but with a different default\n *     mechanic: omitting the block means \"auto-detect from file\n *     presence\" rather than \"use a static schema default\". The helper\n *     `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`\n *     exists and returns `null` otherwise.\n *\n * **Validation**:\n *   - `siteName` is `z.string().min(1)` — empty strings would emit\n *     `<meta property=\"og:site_name\" content=\"\" />` which social\n *     platforms render as a blank line.\n *   - `defaultOgImageUrl` (when present) is `z.url()`.\n *   - `sitemap` / `robots` validation lives on the sub-schemas.\n */\nconst _WebsiteSeoConfigSchema = z\n  .object({\n    siteName: z\n      .string()\n      .min(1, { error: 'WebsiteSeoConfig.siteName must be a non-empty string' }),\n    defaultOgImageUrl: z\n      .url({ error: 'WebsiteSeoConfig.defaultOgImageUrl must be a fully-qualified URL' })\n      .optional(),\n    /**\n     * Sitemap policy block. Optional — omitting it is equivalent to\n     * `{ enabled: true }` (the marketing-site default). See\n     * `WebsiteSitemapConfigSchema` for field-by-field rationale.\n     */\n    sitemap: _WebsiteSitemapConfigSchema.optional(),\n    /**\n     * Robots.txt policy block. Optional — omitting it is equivalent\n     * to `{ policy: 'index' }` (the marketing-site default). See\n     * `WebsiteRobotsConfigSchema` for field-by-field rationale.\n     */\n    robots: _WebsiteRobotsConfigSchema.optional(),\n    /**\n     * `llms.txt` publication policy. Optional — omitting it means\n     * \"auto-detect from file presence\". See\n     * `WebsiteLlmsTxtConfigSchema` for the serving contract.\n     */\n    llmsTxt: _WebsiteLlmsTxtConfigSchema.optional(),\n  });\n\nexport const WebsiteSeoConfigSchema: typeof _WebsiteSeoConfigSchema = _WebsiteSeoConfigSchema;\n\nexport type WebsiteSeoConfig = z.infer<typeof _WebsiteSeoConfigSchema>;\n/** @wildo_source:part:end saas.website.root-config.seo */\n\n/**\n * @wildo_source:part:start saas.website.root-config.navigation facet:layer:shared facet:family:website\n *\n * `WebsiteNavigationConfig` — site-wide header/footer slot bindings.\n *\n * The framework intentionally ships no concrete header or footer. The\n * application authors both as React components, registers them once here, and\n * the page layout renders the site-wide chrome around every page.\n *\n * Both fields are typed as `unknown` at the schema layer with the\n * `WebsiteNavigationConfig` interface narrowing them to\n * `ComponentType<unknown>` — same rationale as\n * `WebsiteSectionDefinition.Component` and `WebsitePageManifest.pageComponent`.\n */\nconst _WebsiteNavigationConfigSchema = z.object({\n  headerComponent: z.unknown(),\n  footerComponent: z.unknown(),\n});\n\nexport const WebsiteNavigationConfigSchema: typeof _WebsiteNavigationConfigSchema =\n  _WebsiteNavigationConfigSchema;\n\nexport interface WebsiteNavigationConfig\n  extends z.infer<typeof _WebsiteNavigationConfigSchema> {\n  headerComponent: ComponentType<unknown>;\n  footerComponent: ComponentType<unknown>;\n}\n/** @wildo_source:part:end saas.website.root-config.navigation */\n\n/**\n * @wildo_source:part:start saas.website.root-config.schema facet:layer:shared facet:family:website\n *\n * `WebsiteRootConfig` — the site-level configuration consumed by:\n *   - the Astro adapter to drive i18n routing, page mounting,\n *     and design-token CSS emission,\n *   - the website audit command to validate label-pack\n *     coverage and SEO structured-data conformance,\n *   - the runtime `<WebsitePageLayout>` to render navigation\n *     and apply design tokens.\n *\n * **Authoring convention**: each marketing-site service exports a single\n * `WEBSITE_ROOT_CONFIG: WebsiteRootConfig` from `src/website-root.config.ts`.\n * The Astro adapter and the audit command\n * both consume this canonical entry point; there is exactly one site\n * config per marketing site (no per-page or per-section overrides at\n * this level — overrides flow through the L0/L1/L1.5 component\n * registration hierarchy described in D6).\n *\n * # Scope\n *\n * This block carries site-level chrome and registry data only. Per-locale\n * routing (`locales` / `defaultLocale`) and the public origin belong in the\n * per-service `wildo.website.config.ts` declaration, avoiding duplicated\n * configuration that could diverge during site generation.\n *\n * **Field-by-field rationale**:\n *\n * - `pageManifests` — the registry of every page on the site. Indexed\n *   downstream by `manifest.ref`. Refs MUST be unique (refinement\n *   below).\n * - `designTokens` — see `WebsiteDesignTokensSchema`.\n * - `navigation` — see `WebsiteNavigationConfigSchema`.\n * - `chromeLabelKeys` — OPTIONAL. The set of fully-composed label keys\n *   the site-wide chrome (header / footer / any global slot the\n *   consumer renders outside a section context) reads via\n *   `useWebsiteLabelByKey(...)`. Declared here, NOT in section\n *   `expectedLabelKeys`, because chrome is rendered outside the\n *   page+section context — `useWebsiteLabel(slot)` is structurally\n *   unavailable to it. Threading these through the label-pack\n *   validator (a) silences the always-on \"orphaned chrome key\" build\n *   warnings and (b) lets the build fail fast when a chrome key is\n *   missing from a locale pack, the same way section keys do.\n *   Defaults to an empty array; sites with no chrome label reads\n *   may omit the field entirely.\n * - `seo` — site-level branding + hero-image fallback (see\n *   `WebsiteSeoConfigSchema`). The marketing-site origin USED to live\n *   here as `seo.siteOrigin`; it now lives only on\n *   `WildoMarketingWebsiteConfig.publicOrigin`.\n * - `skipToMainContentLabelKey` — see field JSDoc below.\n *\n * **Refinements**:\n *   - `pageManifests[].ref` uniqueness — the registry is keyed by ref;\n *     duplicates would silently overwrite each other in the lookup\n *     table the bridge uses for cross-page links.\n *   - `pageManifests[].routePath` uniqueness — two pages cannot mount\n *     at the same path (Astro would error at build time, but we\n *     surface it earlier here with a clearer diagnostic).\n *   - `chromeLabelKeys` uniqueness — duplicates indicate copy-paste\n *     bugs at the consumer's call site; surface them here.\n */\nconst _WebsiteRootConfigSchema = z\n  .object({\n    pageManifests: z.array(WebsitePageManifestSchema).min(1, {\n      error: 'WebsiteRootConfig must declare at least one page manifest',\n    }),\n    designTokens: WebsiteDesignTokensSchema,\n    navigation: _WebsiteNavigationConfigSchema,\n    chromeLabelKeys: z.array(WebsiteLabelKeySchema).default([]),\n    /**\n     * Site-level branding + hero-image fallback used by the Astro\n     * head renderer to compose `<meta property=\"og:site_name\">` and\n     * the per-page OG image fallback. The marketing-site origin\n     * (`siteOrigin`) USED to live here; it was moved to\n     * `WildoMarketingWebsiteConfig.publicOrigin` in the seam-collapse\n     * (single source of truth for \"what's the origin this site is\n     * reachable at\").\n     */\n    seo: _WebsiteSeoConfigSchema,\n    /**\n     * Label key the framework reads to render the \"Skip to main\n     * content\" link as the first focusable element on every page\n     * Required because:\n     *   - Skip-to-main is a baseline keyboard-accessibility\n     *     affordance — WCAG 2.1 §2.4.1 \"Bypass Blocks\" (Level A)\n     *     mandates it. A marketing-site framework that omits it\n     *     fails AA for the entire surface; making the contract\n     *     opt-in invites that regression on every new consumer.\n     *   - The text is announced verbatim by assistive tech, so it\n     *     MUST be localized — a hardcoded English fallback would\n     *     speak \"Skip to main content\" to French users. Forcing the\n     *     key through the label-pack validation surface means the\n     *     dev server fails fast when the consumer forgets to add\n     *     the entry to a locale pack.\n     *   - The framework (NOT the consumer's chrome) owns rendering\n     *     the skip link because the chrome is itself the obstacle\n     *     the link bypasses — a chrome-side implementation would\n     *     either be inside the chrome (impossible to focus before\n     *     the chrome) or above it (creating a structural surface\n     *     the framework needs anyway).\n     *\n     * It is validated as a chrome key without being listed in\n     * `chromeLabelKeys`: the label-pack loader adds it to the effective\n     * chrome key set (`composeEffectiveChromeLabelKeys` in\n     * `astro/label-pack-loader.ts`), so consumers cannot forget it.\n     */\n    skipToMainContentLabelKey: WebsiteLabelKeySchema,\n  })\n  .superRefine((config, ctx) => {\n    const seenRefs = new Set<string>();\n    const seenRoutePaths = new Set<string>();\n    for (const [index, manifest] of config.pageManifests.entries()) {\n      const refKey = manifest.ref as unknown as string;\n      if (seenRefs.has(refKey)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['pageManifests', index, 'ref'],\n          message: `Duplicate page ref \"${refKey}\" in WebsiteRootConfig.pageManifests`,\n        });\n      }\n      seenRefs.add(refKey);\n\n      const routeKey = manifest.routePath as unknown as string;\n      if (seenRoutePaths.has(routeKey)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['pageManifests', index, 'routePath'],\n          message: `Duplicate routePath \"${routeKey}\" in WebsiteRootConfig.pageManifests`,\n        });\n      }\n      seenRoutePaths.add(routeKey);\n    }\n\n    /**\n     * `chromeLabelKeys` uniqueness — a duplicate is harmless at\n     * runtime (the validator de-dupes via a Set) but always indicates\n     * a copy-paste bug at the consumer's call site. Surfacing it here\n     * keeps the chrome contract tidy and matches the discipline applied\n     * to `pageManifests[].ref` and `locales`.\n     */\n    const seenChromeKeys = new Set<string>();\n    for (const [index, key] of config.chromeLabelKeys.entries()) {\n      const keyStr = key as unknown as string;\n      if (seenChromeKeys.has(keyStr)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['chromeLabelKeys', index],\n          message: `Duplicate chrome label key \"${keyStr}\" in WebsiteRootConfig.chromeLabelKeys`,\n        });\n      }\n      seenChromeKeys.add(keyStr);\n    }\n  });\n\nexport const WebsiteRootConfigSchema: typeof _WebsiteRootConfigSchema = _WebsiteRootConfigSchema;\n\n/**\n * Runtime shape of `WebsiteRootConfig`.\n *\n * Hand-written (NOT a bare `z.infer<typeof _WebsiteRootConfigSchema>`)\n * because `z.infer` walks the schema tree and would type\n * `pageManifests[number].pageComponent`, `navigation.headerComponent`\n * and `navigation.footerComponent` as `unknown` (their schema field\n * type), losing the `ComponentType<unknown>` narrowing carried by the\n * hand-written `WebsitePageManifest` and `WebsiteNavigationConfig`\n * interfaces. The layout primitives and the Astro helpers consume\n * `WebsiteRootConfig` and must see those\n * fields pre-narrowed; otherwise every consumer would need a local\n * `as ComponentType` cast at the JSX call site, defeating the type-safe\n * component contract.\n *\n * The `Omit` + intersection pattern keeps the rest of the inferred\n * shape (`designTokens`, `seo`, `chromeLabelKeys`,\n * `skipToMainContentLabelKey`) sourced directly from the schema.\n */\nexport type WebsiteRootConfig = Omit<\n  z.infer<typeof _WebsiteRootConfigSchema>,\n  'pageManifests' | 'navigation'\n> & {\n  pageManifests: WebsitePageManifest[];\n  navigation: WebsiteNavigationConfig;\n};\n/** @wildo_source:part:end saas.website.root-config.schema */\n"]}

package/dist/esm/schemas/refs/page-ref.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-ref.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/refs/page-ref.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,QAAA,MAAM,qBAAqB,0DAQC,CAAC;AAE7B,eAAO,MAAM,oBAAoB,EAAE,OAAO,qBAA6C,CAAC;AAExF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;;AACnE,oDAAoD"}
+{"version":3,"file":"page-ref.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/refs/page-ref.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,QAAA,MAAM,qBAAqB,0DAQC,CAAC;AAE7B,eAAO,MAAM,oBAAoB,EAAE,OAAO,qBAA6C,CAAC;AAExF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;;AACnE,oDAAoD"}

package/dist/esm/schemas/refs/section-ref.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-ref.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/refs/section-ref.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,wBAAwB,6DAQC,CAAC;AAEhC,eAAO,MAAM,uBAAuB,EAAE,OAAO,wBAAmD,CAAC;AAEjG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;;AACzE,uDAAuD"}
+{"version":3,"file":"section-ref.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/refs/section-ref.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,wBAAwB,6DAQC,CAAC;AAEhC,eAAO,MAAM,uBAAuB,EAAE,OAAO,wBAAmD,CAAC;AAEjG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;;AACzE,uDAAuD"}

package/dist/esm/schemas/sections/website-section-category.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-section-category.shared.d.ts","sourceRoot":"","sources":["../../../../src/schemas/sections/website-section-category.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,uBAAuB,4BAA4B;IACnD,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB;;;;;;;;OAQG;IACH,GAAG,QAAQ;CACZ;AAED,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,sBAAsB,CAClD,CAAC;AACjC,iEAAiE"}
+{"version":3,"file":"website-section-category.shared.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/sections/website-section-category.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,uBAAuB,4BAA4B;IACnD,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB;;;;;;;;OAQG;IACH,GAAG,QAAQ;CACZ;AAED,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,sBAAsB,CAClD,CAAC;AACjC,iEAAiE"}

package/dist/esm/schemas/sections/website-section-category.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"website-section-category.shared.js","sourceRoot":"","sources":["../../../../src/schemas/sections/website-section-category.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAN,IAAY,sBAoBX;AApBD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,qCAAW,CAAA;IACX,6EAAmD,CAAA;IACnD,2DAAiC,CAAA;IACjC,6CAAmB,CAAA;IACnB,6CAAmB,CAAA;IACnB,uDAA6B,CAAA;IAC7B,qCAAW,CAAA;IACX,mDAAyB,CAAA;IACzB;;;;;;;;OAQG;IACH,qCAAW,CAAA;AACb,CAAC,EApBW,sBAAsB,KAAtB,sBAAsB,QAoBjC;AAED,MAAM,CAAC,MAAM,4BAA4B,GACvC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AACjC,iEAAiE","sourcesContent":["import { z } from 'zod';\n\n/**\n * @wildo_source:part:start saas.website.sections.category-enum facet:layer:shared facet:family:website\n *\n * `WebsiteSectionCategory` — closed vocabulary tagging the **structural\n * intent** of a section.\n *\n * The category is NOT a layout-shape constraint and NOT a CSS class; the\n * framework ships zero concrete sections and never inspects\n * the category at render time. The category exists for two orthogonal\n * non-render concerns:\n *\n * 1. **Authoring guidance**: each value has matching application-builder\n *    guidance. When introducing a new category, provide its public authoring\n *    method before asking an application to use it.\n * 2. **Analytics labelling**: the runtime emits\n *    `data-section-category=\"…\"` on the `<WebsiteSection>` wrapper so\n *    analytics tooling can group section impressions\n *    without parsing className conventions.\n *\n * **It does NOT gate structured data.** Nothing dispatches JSON-LD by category: the structured-data\n * renderer receives only `sectionRef` and `getStructuredData`, the reconciliation contract carries\n * no category at all, and no build-time warning compares the two. A section may return any\n * vocabulary from `getStructuredData()` whatever its category says, so choose the category for what\n * it does do (guidance and analytics grouping) and validate your JSON-LD yourself.\n *\n * **Closed vocabulary on purpose**: a free-string `category` would\n * defeat the skill mapping and would make the analytics attribute unaggregatable.\n * Consumers who need a wholly-novel section shape use the `RAW` advanced path\n * (`website-factory-advanced` skill) which bypasses the category\n * vocabulary entirely.\n *\n * **Adding a value**: requires (a) a new entry here and (b) a matching\n * `website_section_<value>` skill stub. Removing a value\n * is a labelled rename — every consumer's\n * `defineWebsiteSection({ category: … })` declaration breaks at compile\n * time, which is the desired loud failure.\n */\nexport enum WebsiteSectionCategory {\n  HERO = 'hero',\n  CTA = 'cta',\n  FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary',\n  FEATURE_DETAIL = 'feature-detail',\n  PRICING = 'pricing',\n  CONTACT = 'contact',\n  SOCIAL_PROOF = 'social-proof',\n  FAQ = 'faq',\n  FOOTER_CTA = 'footer-cta',\n  /**\n   * Escape hatch for sections that don't fit any standard category\n   * (third-party widgets, custom one-off marketing pieces). Authors should\n   * prefer a concrete category whenever possible, so the section receives the\n   * matching authoring guidance and groups with its peers in analytics.\n   *\n   * It makes no difference to structured data: no category validates\n   * `getStructuredData()`, so `RAW` opts out of nothing there.\n   */\n  RAW = 'raw',\n}\n\nexport const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCategory> =\n  z.enum(WebsiteSectionCategory);\n/** @wildo_source:part:end saas.website.sections.category-enum */\n"]}
+{"version":3,"file":"website-section-category.shared.js","sourceRoot":"","sources":["../../../../../src/schemas/sections/website-section-category.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAN,IAAY,sBAoBX;AApBD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,qCAAW,CAAA;IACX,6EAAmD,CAAA;IACnD,2DAAiC,CAAA;IACjC,6CAAmB,CAAA;IACnB,6CAAmB,CAAA;IACnB,uDAA6B,CAAA;IAC7B,qCAAW,CAAA;IACX,mDAAyB,CAAA;IACzB;;;;;;;;OAQG;IACH,qCAAW,CAAA;AACb,CAAC,EApBW,sBAAsB,KAAtB,sBAAsB,QAoBjC;AAED,MAAM,CAAC,MAAM,4BAA4B,GACvC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AACjC,iEAAiE","sourcesContent":["import { z } from 'zod';\n\n/**\n * @wildo_source:part:start saas.website.sections.category-enum facet:layer:shared facet:family:website\n *\n * `WebsiteSectionCategory` — closed vocabulary tagging the **structural\n * intent** of a section.\n *\n * The category is NOT a layout-shape constraint and NOT a CSS class; the\n * framework ships zero concrete sections and never inspects\n * the category at render time. The category exists for two orthogonal\n * non-render concerns:\n *\n * 1. **Authoring guidance**: each value has matching application-builder\n *    guidance. When introducing a new category, provide its public authoring\n *    method before asking an application to use it.\n * 2. **Analytics labelling**: the runtime emits\n *    `data-section-category=\"…\"` on the `<WebsiteSection>` wrapper so\n *    analytics tooling can group section impressions\n *    without parsing className conventions.\n *\n * **It does NOT gate structured data.** Nothing dispatches JSON-LD by category: the structured-data\n * renderer receives only `sectionRef` and `getStructuredData`, the reconciliation contract carries\n * no category at all, and no build-time warning compares the two. A section may return any\n * vocabulary from `getStructuredData()` whatever its category says, so choose the category for what\n * it does do (guidance and analytics grouping) and validate your JSON-LD yourself.\n *\n * **Closed vocabulary on purpose**: a free-string `category` would\n * defeat the skill mapping and would make the analytics attribute unaggregatable.\n * Consumers who need a wholly-novel section shape use the `RAW` advanced path\n * (`website-factory-advanced` skill) which bypasses the category\n * vocabulary entirely.\n *\n * **Adding a value**: requires (a) a new entry here and (b) a matching\n * `website_section_<value>` skill stub. Removing a value\n * is a labelled rename — every consumer's\n * `defineWebsiteSection({ category: … })` declaration breaks at compile\n * time, which is the desired loud failure.\n */\nexport enum WebsiteSectionCategory {\n  HERO = 'hero',\n  CTA = 'cta',\n  FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary',\n  FEATURE_DETAIL = 'feature-detail',\n  PRICING = 'pricing',\n  CONTACT = 'contact',\n  SOCIAL_PROOF = 'social-proof',\n  FAQ = 'faq',\n  FOOTER_CTA = 'footer-cta',\n  /**\n   * Escape hatch for sections that don't fit any standard category\n   * (third-party widgets, custom one-off marketing pieces). Authors should\n   * prefer a concrete category whenever possible, so the section receives the\n   * matching authoring guidance and groups with its peers in analytics.\n   *\n   * It makes no difference to structured data: no category validates\n   * `getStructuredData()`, so `RAW` opts out of nothing there.\n   */\n  RAW = 'raw',\n}\n\nexport const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCategory> =\n  z.enum(WebsiteSectionCategory);\n/** @wildo_source:part:end saas.website.sections.category-enum */\n"]}

package/dist/esm/schemas/sections/website-section-definition.shared.schemas.d.ts

@@ -9,7 +9,8 @@ import type { WebsiteStructuredDataReturn } from '../structured-data/website-str
  * `core/define-website-section.tsx` module in Phase 2 because it carries
  * React types in its inputs). The shape is declared in `schemas/`
  * because it is the **observable contract** the page-manifest
- * registration, label-pack validator, and SEO dispatcher depend on.
+ * registration, the label-pack validator, `renderPageStructuredData` and the
+ * structured-data audit depend on.
  *
  * **Shape rationale** (each field carries semantic weight — see
  * `design-philosophy.mdc`):
@@ -19,7 +20,8 @@ import type { WebsiteStructuredDataReturn } from '../structured-data/website-str
  *   (a section can be reused with the same `sectionRef` across pages
  *   when its label-key root is intentionally shared).
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
- *   for SEO-dispatch, skill-mapping, and analytics labelling.
+ *   for skill-mapping and analytics labelling. It does NOT select the
+ *   section's structured data.
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
  *   commits to consuming. The plan originally proposed leaf-relative
  *   keys (`'headline'`) resolved at runtime against the
@@ -32,9 +34,13 @@ import type { WebsiteStructuredDataReturn } from '../structured-data/website-str
  *        graph — `wildo website audit` can list a page's required keys
  *        without booting React.
  *     3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
- *        survive in Phase 2 — the hook composes the leaf with the
- *        page+section context and validates the result against
- *        `expectedLabelKeys`.
+ *        survive — the hook composes the leaf with the page+section
+ *        context and looks the result up in the active pack. It does
+ *        NOT check the key against `expectedLabelKeys`: a leaf the
+ *        section never declared renders its key (with a console warning)
+ *        and is caught by nothing until a reviewer reads the page. The
+ *        build and `wildo website audit` check the pack against the
+ *        DECLARED keys, so declare every slot the component reads.
  * - `Component` — the React component that renders the section. Typed
  *   as `ComponentType<unknown>` here because schema-layer cannot lock
  *   the component's prop shape (props vary per section). The factory
@@ -44,8 +50,9 @@ import type { WebsiteStructuredDataReturn } from '../structured-data/website-str
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
  *   builder library invokes at static-build time to materialize JSON-LD
  *   for the section. The return type is intentionally `unknown` here;
- *   the SEO library narrows by `category` (e.g. `PRICING` →
- *   `Product | AggregateOffer`).
+ *   nothing narrows it by `category` — the section returns whatever
+ *   vocabulary it emits, and `wildo website audit` reconciles that
+ *   against the application's Schema.org catalog.
  *
  * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
  * cannot meaningfully validate "is a React component" beyond

package/dist/esm/schemas/sections/website-section-definition.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-section-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/sections/website-section-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2DAA2D,CAAC;AAG7G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,QAAA,MAAM,+BAA+B;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,OAAO,+BACnB,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,wBAAyB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC;IAC/F,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,EAAE,MAAM,2BAA2B,CAAC;CACvD;;AACD,qEAAqE"}
+{"version":3,"file":"website-section-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/sections/website-section-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2DAA2D,CAAC;AAG7G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,QAAA,MAAM,+BAA+B;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,OAAO,+BACnB,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,wBAAyB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC;IAC/F,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,EAAE,MAAM,2BAA2B,CAAC;CACvD;;AACD,qEAAqE"}