@wildo-ai/saas-website 1.1.5 → 1.1.7

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"}

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

@@ -10,7 +10,8 @@ import { WebsiteSectionCategorySchema } from './website-section-category.shared.
  * `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`):
@@ -20,7 +21,8 @@ import { WebsiteSectionCategorySchema } from './website-section-category.shared.
  *   (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
@@ -33,9 +35,13 @@ import { WebsiteSectionCategorySchema } from './website-section-category.shared.
  *        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
@@ -45,8 +51,9 @@ import { WebsiteSectionCategorySchema } from './website-section-category.shared.
  * - `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.js.map

@@ -1 +1 @@
-{"version":3,"file":"website-section-definition.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/sections/website-section-definition.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,uBAAuB;IACnC,QAAQ,EAAE,4BAA4B;IACtC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GACzC,+BAA+B,CAAC;AA+ClC,qEAAqE","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\n\nimport { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas';\nimport { WebsiteSectionRefSchema } from '../refs/section-ref.schemas';\nimport type { WebsiteStructuredDataReturn } from '../structured-data/website-structured-data.shared.schemas';\nimport { WebsiteSectionCategorySchema } from './website-section-category.shared';\n\n/**\n * @wildo_source:part:start saas.website.sections.definition-schema facet:layer:shared facet:family:website\n *\n * `WebsiteSectionDefinition` — the runtime contract returned by the\n * `defineWebsiteSection({ … })` factory (authored as a separate\n * `core/define-website-section.tsx` module in Phase 2 because it carries\n * React types in its inputs). The shape is declared in `schemas/`\n * because it is the **observable contract** the page-manifest\n * registration, label-pack validator, and SEO dispatcher depend on.\n *\n * **Shape rationale** (each field carries semantic weight — see\n * `design-philosophy.mdc`):\n *\n * - `sectionRef` — the section's identity inside its hosting page.\n *   Uniqueness is enforced **per page** at manifest registration time\n *   (a section can be reused with the same `sectionRef` across pages\n *   when its label-key root is intentionally shared).\n * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section\n *   for SEO-dispatch, skill-mapping, and analytics labelling.\n * - `expectedLabelKeys` — the **fully-composed** label keys the section\n *   commits to consuming. The plan originally proposed leaf-relative\n *   keys (`'headline'`) resolved at runtime against the\n *   page+section context, but storing the fully-composed key on the\n *   definition has three concrete benefits:\n *     1. The label-pack validator (`validateLabelPackAgainstManifest`)\n *        runs as a pure function with no need to walk the JSX tree at\n *        build time to discover the leaf-to-key resolution.\n *     2. The contract is auditable from outside the React render\n *        graph — `wildo website audit` can list a page's required keys\n *        without booting React.\n *     3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)\n *        survive in Phase 2 — the hook composes the leaf with the\n *        page+section context and validates the result against\n *        `expectedLabelKeys`.\n * - `Component` — the React component that renders the section. Typed\n *   as `ComponentType<unknown>` here because schema-layer cannot lock\n *   the component's prop shape (props vary per section). The factory\n *   function (`defineWebsiteSection<TProps>(…)`) preserves the precise\n *   prop type at the consumer call site via generics; this schema only\n *   guards the runtime shape of \"is callable as a React component\".\n * - `getStructuredData?` — optional pure function the SEO/AEO/GEO\n *   builder library invokes at static-build time to materialize JSON-LD\n *   for the section. The return type is intentionally `unknown` here;\n *   the SEO library narrows by `category` (e.g. `PRICING` →\n *   `Product | AggregateOffer`).\n *\n * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate\n * cannot meaningfully validate \"is a React component\" beyond\n * `typeof === 'function'`, and the false-positive cost (any function\n * passes) is too high for the value (none — the consumer either\n * imports a real component or fails at JSX render time with a clearer\n * error). Using `z.unknown()` + a TS-side type cast keeps the runtime\n * cost zero and the type-safety contract entirely on the TS side\n * (where it actually has teeth via the factory's generic).\n */\nconst _WebsiteSectionDefinitionSchema = z.object({\n  sectionRef: WebsiteSectionRefSchema,\n  category: WebsiteSectionCategorySchema,\n  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),\n  Component: z.unknown(),\n  getStructuredData: z.unknown().optional(),\n});\n\nexport const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSchema =\n  _WebsiteSectionDefinitionSchema;\n\n/**\n * Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and\n * `getStructuredData` are typed precisely on the factory return type\n * (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred\n * type is the lowest common denominator used at the persistence /\n * validation boundary only.\n *\n * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:\n * React component props are CONTRAVARIANT in `ComponentType<T>` —\n * a narrower `ComponentType<{ foo: string }>` is NOT assignable to\n * `ComponentType<unknown>` (because a caller could pass an `unknown`\n * the narrower component cannot accept). This made every consumer\n * who built sections via `defineWebsiteSection<TProps>(…)` unable\n * to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to\n * helpers typed against the bare `WebsiteSectionDefinition` —\n * collectors, validators, and registries. Using `any` here is the\n * exact escape hatch the React typings themselves use for\n * heterogeneous component containers (`React.forwardRef`,\n * `React.lazy`'s internal component slot, etc.) and matches the\n * runtime contract: the framework NEVER instantiates these\n * components directly with arbitrary props — the consumer's JSX\n * supplies the right props at the call site.\n */\nexport interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {\n  Component: ComponentType<any>;\n  /**\n   * Optional pure function the SEO/AEO/GEO renderer invokes at\n   * static-build time to materialize JSON-LD for the section.\n   *\n   * **Why typed as `WebsiteStructuredDataReturn` (not `unknown`)** —\n   * a typed return shape gives section authors autocomplete on\n   * `@type` / `@id` / `@context` (the framework-owned fields) while\n   * keeping all other fields free-form (Schema.org has hundreds of\n   * optional fields per entity; locking them in TS would be both\n   * impractical and brittle as Schema.org evolves). The companion\n   * catalog reconciliation surface catches missing-required and\n   * deprecated-field-used at the SEMANTIC layer (warning-only per\n   * D-AG4), so the runtime type stays loose.\n   *\n   * Returns `null`, `undefined`, or `[]` when the section has no\n   * structured-data contribution for the current state — the\n   * renderer short-circuits all three.\n   */\n  getStructuredData?: () => WebsiteStructuredDataReturn;\n}\n/** @wildo_source:part:end saas.website.sections.definition-schema */\n"]}
+{"version":3,"file":"website-section-definition.shared.schemas.js","sourceRoot":"","sources":["../../../../src/schemas/sections/website-section-definition.shared.schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,uBAAuB;IACnC,QAAQ,EAAE,4BAA4B;IACtC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GACzC,+BAA+B,CAAC;AA+ClC,qEAAqE","sourcesContent":["import type { ComponentType } from 'react';\nimport { z } from 'zod';\n\nimport { WebsiteLabelKeySchema } from '../label-keys/website-label-key.schemas';\nimport { WebsiteSectionRefSchema } from '../refs/section-ref.schemas';\nimport type { WebsiteStructuredDataReturn } from '../structured-data/website-structured-data.shared.schemas';\nimport { WebsiteSectionCategorySchema } from './website-section-category.shared';\n\n/**\n * @wildo_source:part:start saas.website.sections.definition-schema facet:layer:shared facet:family:website\n *\n * `WebsiteSectionDefinition` — the runtime contract returned by the\n * `defineWebsiteSection({ … })` factory (authored as a separate\n * `core/define-website-section.tsx` module in Phase 2 because it carries\n * React types in its inputs). The shape is declared in `schemas/`\n * because it is the **observable contract** the page-manifest\n * registration, the label-pack validator, `renderPageStructuredData` and the\n * structured-data audit depend on.\n *\n * **Shape rationale** (each field carries semantic weight — see\n * `design-philosophy.mdc`):\n *\n * - `sectionRef` — the section's identity inside its hosting page.\n *   Uniqueness is enforced **per page** at manifest registration time\n *   (a section can be reused with the same `sectionRef` across pages\n *   when its label-key root is intentionally shared).\n * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section\n *   for skill-mapping and analytics labelling. It does NOT select the\n *   section's structured data.\n * - `expectedLabelKeys` — the **fully-composed** label keys the section\n *   commits to consuming. The plan originally proposed leaf-relative\n *   keys (`'headline'`) resolved at runtime against the\n *   page+section context, but storing the fully-composed key on the\n *   definition has three concrete benefits:\n *     1. The label-pack validator (`validateLabelPackAgainstManifest`)\n *        runs as a pure function with no need to walk the JSX tree at\n *        build time to discover the leaf-to-key resolution.\n *     2. The contract is auditable from outside the React render\n *        graph — `wildo website audit` can list a page's required keys\n *        without booting React.\n *     3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)\n *        survive — the hook composes the leaf with the page+section\n *        context and looks the result up in the active pack. It does\n *        NOT check the key against `expectedLabelKeys`: a leaf the\n *        section never declared renders its key (with a console warning)\n *        and is caught by nothing until a reviewer reads the page. The\n *        build and `wildo website audit` check the pack against the\n *        DECLARED keys, so declare every slot the component reads.\n * - `Component` — the React component that renders the section. Typed\n *   as `ComponentType<unknown>` here because schema-layer cannot lock\n *   the component's prop shape (props vary per section). The factory\n *   function (`defineWebsiteSection<TProps>(…)`) preserves the precise\n *   prop type at the consumer call site via generics; this schema only\n *   guards the runtime shape of \"is callable as a React component\".\n * - `getStructuredData?` — optional pure function the SEO/AEO/GEO\n *   builder library invokes at static-build time to materialize JSON-LD\n *   for the section. The return type is intentionally `unknown` here;\n *   nothing narrows it by `category` — the section returns whatever\n *   vocabulary it emits, and `wildo website audit` reconciles that\n *   against the application's Schema.org catalog.\n *\n * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate\n * cannot meaningfully validate \"is a React component\" beyond\n * `typeof === 'function'`, and the false-positive cost (any function\n * passes) is too high for the value (none — the consumer either\n * imports a real component or fails at JSX render time with a clearer\n * error). Using `z.unknown()` + a TS-side type cast keeps the runtime\n * cost zero and the type-safety contract entirely on the TS side\n * (where it actually has teeth via the factory's generic).\n */\nconst _WebsiteSectionDefinitionSchema = z.object({\n  sectionRef: WebsiteSectionRefSchema,\n  category: WebsiteSectionCategorySchema,\n  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),\n  Component: z.unknown(),\n  getStructuredData: z.unknown().optional(),\n});\n\nexport const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSchema =\n  _WebsiteSectionDefinitionSchema;\n\n/**\n * Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and\n * `getStructuredData` are typed precisely on the factory return type\n * (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred\n * type is the lowest common denominator used at the persistence /\n * validation boundary only.\n *\n * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:\n * React component props are CONTRAVARIANT in `ComponentType<T>` —\n * a narrower `ComponentType<{ foo: string }>` is NOT assignable to\n * `ComponentType<unknown>` (because a caller could pass an `unknown`\n * the narrower component cannot accept). This made every consumer\n * who built sections via `defineWebsiteSection<TProps>(…)` unable\n * to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to\n * helpers typed against the bare `WebsiteSectionDefinition` —\n * collectors, validators, and registries. Using `any` here is the\n * exact escape hatch the React typings themselves use for\n * heterogeneous component containers (`React.forwardRef`,\n * `React.lazy`'s internal component slot, etc.) and matches the\n * runtime contract: the framework NEVER instantiates these\n * components directly with arbitrary props — the consumer's JSX\n * supplies the right props at the call site.\n */\nexport interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {\n  Component: ComponentType<any>;\n  /**\n   * Optional pure function the SEO/AEO/GEO renderer invokes at\n   * static-build time to materialize JSON-LD for the section.\n   *\n   * **Why typed as `WebsiteStructuredDataReturn` (not `unknown`)** —\n   * a typed return shape gives section authors autocomplete on\n   * `@type` / `@id` / `@context` (the framework-owned fields) while\n   * keeping all other fields free-form (Schema.org has hundreds of\n   * optional fields per entity; locking them in TS would be both\n   * impractical and brittle as Schema.org evolves). The companion\n   * catalog reconciliation surface catches missing-required and\n   * deprecated-field-used at the SEMANTIC layer (warning-only per\n   * D-AG4), so the runtime type stays loose.\n   *\n   * Returns `null`, `undefined`, or `[]` when the section has no\n   * structured-data contribution for the current state — the\n   * renderer short-circuits all three.\n   */\n  getStructuredData?: () => WebsiteStructuredDataReturn;\n}\n/** @wildo_source:part:end saas.website.sections.definition-schema */\n"]}

package/dist/esm/schemas/structured-data/pricing-offer-structured-data.shared.d.ts

@@ -0,0 +1,57 @@
+import { type PublicPricingCatalog } from '@wildo-ai/saas-models/public-runtime';
+import type { WebsiteStructuredDataPayload } from './website-structured-data.shared.schemas';
+/**
+ * @wildo_source:part:start saas.website.pricing-offer-structured-data facet:layer:core facet:family:website facet:audience:app-developer
+ *
+ * `buildWebsitePricingOfferStructuredData` — the `AggregateOffer` a pricing page publishes, DERIVED from
+ * the application's public pricing catalogue (#1835) instead of typed by hand beside it.
+ *
+ * ## What it publishes, and what it refuses to
+ *
+ * A search engine shows an offer's `price` as the price of the offer, so an offer is published only
+ * when that is TRUE:
+ *
+ * - the plan is on sale (`availability: AVAILABLE`) — an upcoming plan cannot be bought;
+ * - its price is `LISTED` — a starting price is a floor, and an on-request plan has no price;
+ * - its published price states the whole offer for its unit: a flat or per-unit amount, never an
+ *   indicative amount of a tiered, graduated or package price.
+ *
+ * Each published offer uses the plan's DEFAULT price (the one the catalogue marks) and carries a
+ * `UnitPriceSpecification` saying what the number is FOR: its recurrence as `billingDuration` (ISO 8601
+ * `P1M` / `P1Y`) and, for a per-unit price, a `referenceQuantity` of one of the page's unit (`member`)
+ * — so "$4 per member per month" is never read as "$4".
+ *
+ * One `AggregateOffer` per (currency, amount basis, recurrence): a range is only meaningful over prices
+ * that measure the same thing, so a flat price and a per-member price, or a monthly and a yearly one, are
+ * never folded into one `lowPrice` / `highPrice`. EVERY group's `@id` is `aggregateOfferIdPrefix` suffixed with
+ * what distinguishes it (`-per-unit-1-month-usd`), so an aggregate's identity depends only on what it
+ * aggregates: adding, removing or reordering a plan in ANOTHER group never moves it. Returns `[]` when
+ * nothing may be published — a page with only on-request plans publishes no price at all, which is the
+ * true statement.
+ */
+export interface BuildWebsitePricingOfferStructuredDataInput {
+    readonly catalog: PublicPricingCatalog;
+    /** The `@id` of the entity the offers price — typically the page's `SoftwareApplication`. */
+    readonly itemOfferedId: string;
+    /**
+     * The prefix of every `AggregateOffer` `@id` (`https://…/pricing#plans`); each group appends what it
+     * aggregates, e.g. `#plans-flat-1-month-usd`.
+     */
+    readonly aggregateOfferIdPrefix: string;
+    /** The URL of the page the offers are made on; each offer's URL is this plus `#plan-<key>`. */
+    readonly url: string;
+    /**
+     * The plan's name in the page's locale. Names are text a person reads, so they come from the page's
+     * label pack; a plan the callback does not name is published without one rather than with its key.
+     */
+    readonly planName?: (planKey: string) => string | undefined;
+    /**
+     * What ONE unit of a per-unit price is, in the page's locale (`member`, `seat`) — published as the
+     * offer's `referenceQuantity.unitText`. Required when any published offer is per-unit: omitting it
+     * would state a per-member price as a whole price, so the builder refuses instead.
+     */
+    readonly perUnitName?: string;
+}
+export declare function buildWebsitePricingOfferStructuredData(input: BuildWebsitePricingOfferStructuredDataInput): readonly WebsiteStructuredDataPayload[];
+/** @wildo_source:part:end saas.website.pricing-offer-structured-data */
+//# sourceMappingURL=pricing-offer-structured-data.shared.d.ts.map

package/dist/esm/schemas/structured-data/pricing-offer-structured-data.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-offer-structured-data.shared.d.ts","sourceRoot":"","sources":["../../../../src/schemas/structured-data/pricing-offer-structured-data.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oBAAoB,EAG1B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,2CAA2C,GAAG,SAAS,4BAA4B,EAAE,CAmDlJ;AA0BD,wEAAwE"}

package/dist/esm/schemas/structured-data/pricing-offer-structured-data.shared.js

@@ -0,0 +1,76 @@
+import { ProductAvailability, ProductPriceDisclosure, PublicPricingAmountBasis, PublicPricingRecurrenceUnit, publicPricingAmountDecimal, } from '@wildo-ai/saas-models/public-runtime';
+export function buildWebsitePricingOfferStructuredData(input) {
+    const published = input.catalog.plans.flatMap((plan) => {
+        const price = publishablePrice(plan);
+        return price === undefined ? [] : [{ plan, price }];
+    });
+    if (published.some(({ price }) => price.amountBasis === PublicPricingAmountBasis.PER_UNIT) && !input.perUnitName) {
+        throw new Error('[buildWebsitePricingOfferStructuredData] a published plan is priced per unit, so the page must name the unit '
+            + '(`perUnitName`, e.g. "member"); without it the offer would state a per-unit price as the whole price.');
+    }
+    const groupKeyOf = (price) => `${price.currency}|${price.amountBasis}|${price.recurrence.unit}|${price.recurrence.count}`;
+    const groupKeys = [...new Set(published.map(({ price }) => groupKeyOf(price)))];
+    return groupKeys.map((groupKey) => {
+        const offers = published.filter(({ price }) => groupKeyOf(price) === groupKey);
+        const sample = offers[0].price;
+        const amounts = offers.map(({ price }) => publicPricingAmountDecimal(price));
+        const numeric = amounts.map(Number);
+        return {
+            '@type': 'AggregateOffer',
+            '@id': `${input.aggregateOfferIdPrefix}-${aggregateSuffix(sample)}`,
+            itemOffered: { '@id': input.itemOfferedId },
+            priceCurrency: sample.currency,
+            lowPrice: amounts[numeric.indexOf(Math.min(...numeric))],
+            highPrice: amounts[numeric.indexOf(Math.max(...numeric))],
+            offerCount: offers.length,
+            url: input.url,
+            offers: offers.map(({ plan, price }) => {
+                const name = input.planName?.(plan.key);
+                const amount = publicPricingAmountDecimal(price);
+                return {
+                    '@type': 'Offer',
+                    ...(name === undefined ? {} : { name }),
+                    price: amount,
+                    priceCurrency: price.currency,
+                    availability: 'https://schema.org/InStock',
+                    url: `${input.url}#plan-${plan.key}`,
+                    priceSpecification: {
+                        '@type': 'UnitPriceSpecification',
+                        price: amount,
+                        priceCurrency: price.currency,
+                        ...(price.recurrence.unit === PublicPricingRecurrenceUnit.ONE_TIME ? {} : { billingDuration: isoDurationOf(price) }),
+                        ...(price.amountBasis === PublicPricingAmountBasis.PER_UNIT
+                            ? { referenceQuantity: { '@type': 'QuantitativeValue', value: 1, unitText: input.perUnitName } }
+                            : {}),
+                    },
+                };
+            }),
+        };
+    });
+}
+/** What distinguishes an aggregate's `@id`: its basis, its recurrence and its currency — exactly its group key. */
+function aggregateSuffix(price) {
+    return `${price.amountBasis}-${price.recurrence.count}-${price.recurrence.unit}-${price.currency}`.toLowerCase().replace(/_/gu, '-');
+}
+/** The plan's default price, when publishing it as the offer's price would be true. */
+function publishablePrice(plan) {
+    if (plan.availability !== ProductAvailability.AVAILABLE)
+        return undefined;
+    if (plan.priceDisclosure !== ProductPriceDisclosure.LISTED)
+        return undefined;
+    const price = plan.prices.find((candidate) => candidate.isDefault) ?? plan.prices[0];
+    if (price === undefined || price.amountBasis === PublicPricingAmountBasis.VARIABLE)
+        return undefined;
+    return price;
+}
+/** Total over the recurring units: a member added to the vocabulary is a compile error here until it is mapped. */
+const ISO_DURATION_DESIGNATOR = {
+    [PublicPricingRecurrenceUnit.MONTH]: 'M',
+    [PublicPricingRecurrenceUnit.YEAR]: 'Y',
+};
+function isoDurationOf(price) {
+    const unit = price.recurrence.unit;
+    return `P${price.recurrence.count}${ISO_DURATION_DESIGNATOR[unit]}`;
+}
+/** @wildo_source:part:end saas.website.pricing-offer-structured-data */
+//# sourceMappingURL=pricing-offer-structured-data.shared.js.map

package/dist/esm/schemas/structured-data/pricing-offer-structured-data.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-offer-structured-data.shared.js","sourceRoot":"","sources":["../../../../src/schemas/structured-data/pricing-offer-structured-data.shared.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ProductAvailability,\n  ProductPriceDisclosure,\n  PublicPricingAmountBasis,\n  PublicPricingRecurrenceUnit,\n  publicPricingAmountDecimal,\n  type PublicPricingCatalog,\n  type PublicPricingPlan,\n  type PublicPricingPrice,\n} from '@wildo-ai/saas-models/public-runtime';\n\nimport type { WebsiteStructuredDataPayload } from './website-structured-data.shared.schemas';\n\n/**\n * @wildo_source:part:start saas.website.pricing-offer-structured-data facet:layer:core facet:family:website facet:audience:app-developer\n *\n * `buildWebsitePricingOfferStructuredData` — the `AggregateOffer` a pricing page publishes, DERIVED from\n * the application's public pricing catalogue (#1835) instead of typed by hand beside it.\n *\n * ## What it publishes, and what it refuses to\n *\n * A search engine shows an offer's `price` as the price of the offer, so an offer is published only\n * when that is TRUE:\n *\n * - the plan is on sale (`availability: AVAILABLE`) — an upcoming plan cannot be bought;\n * - its price is `LISTED` — a starting price is a floor, and an on-request plan has no price;\n * - its published price states the whole offer for its unit: a flat or per-unit amount, never an\n *   indicative amount of a tiered, graduated or package price.\n *\n * Each published offer uses the plan's DEFAULT price (the one the catalogue marks) and carries a\n * `UnitPriceSpecification` saying what the number is FOR: its recurrence as `billingDuration` (ISO 8601\n * `P1M` / `P1Y`) and, for a per-unit price, a `referenceQuantity` of one of the page's unit (`member`)\n * — so \"$4 per member per month\" is never read as \"$4\".\n *\n * One `AggregateOffer` per (currency, amount basis, recurrence): a range is only meaningful over prices\n * that measure the same thing, so a flat price and a per-member price, or a monthly and a yearly one, are\n * never folded into one `lowPrice` / `highPrice`. EVERY group's `@id` is `aggregateOfferIdPrefix` suffixed with\n * what distinguishes it (`-per-unit-1-month-usd`), so an aggregate's identity depends only on what it\n * aggregates: adding, removing or reordering a plan in ANOTHER group never moves it. Returns `[]` when\n * nothing may be published — a page with only on-request plans publishes no price at all, which is the\n * true statement.\n */\nexport interface BuildWebsitePricingOfferStructuredDataInput {\n  readonly catalog: PublicPricingCatalog;\n  /** The `@id` of the entity the offers price — typically the page's `SoftwareApplication`. */\n  readonly itemOfferedId: string;\n  /**\n   * The prefix of every `AggregateOffer` `@id` (`https://…/pricing#plans`); each group appends what it\n   * aggregates, e.g. `#plans-flat-1-month-usd`.\n   */\n  readonly aggregateOfferIdPrefix: string;\n  /** The URL of the page the offers are made on; each offer's URL is this plus `#plan-<key>`. */\n  readonly url: string;\n  /**\n   * The plan's name in the page's locale. Names are text a person reads, so they come from the page's\n   * label pack; a plan the callback does not name is published without one rather than with its key.\n   */\n  readonly planName?: (planKey: string) => string | undefined;\n  /**\n   * What ONE unit of a per-unit price is, in the page's locale (`member`, `seat`) — published as the\n   * offer's `referenceQuantity.unitText`. Required when any published offer is per-unit: omitting it\n   * would state a per-member price as a whole price, so the builder refuses instead.\n   */\n  readonly perUnitName?: string;\n}\n\nexport function buildWebsitePricingOfferStructuredData(input: BuildWebsitePricingOfferStructuredDataInput): readonly WebsiteStructuredDataPayload[] {\n  const published = input.catalog.plans.flatMap((plan) => {\n    const price = publishablePrice(plan);\n    return price === undefined ? [] : [{ plan, price }];\n  });\n  if (published.some(({ price }) => price.amountBasis === PublicPricingAmountBasis.PER_UNIT) && !input.perUnitName) {\n    throw new Error(\n      '[buildWebsitePricingOfferStructuredData] a published plan is priced per unit, so the page must name the unit '\n        + '(`perUnitName`, e.g. \"member\"); without it the offer would state a per-unit price as the whole price.',\n    );\n  }\n  const groupKeyOf = (price: PublicPricingPrice): string =>\n    `${price.currency}|${price.amountBasis}|${price.recurrence.unit}|${price.recurrence.count}`;\n  const groupKeys = [...new Set(published.map(({ price }) => groupKeyOf(price)))];\n  return groupKeys.map((groupKey) => {\n    const offers = published.filter(({ price }) => groupKeyOf(price) === groupKey);\n    const sample = offers[0]!.price;\n    const amounts = offers.map(({ price }) => publicPricingAmountDecimal(price));\n    const numeric = amounts.map(Number);\n    return {\n      '@type': 'AggregateOffer',\n      '@id': `${input.aggregateOfferIdPrefix}-${aggregateSuffix(sample)}`,\n      itemOffered: { '@id': input.itemOfferedId },\n      priceCurrency: sample.currency,\n      lowPrice: amounts[numeric.indexOf(Math.min(...numeric))],\n      highPrice: amounts[numeric.indexOf(Math.max(...numeric))],\n      offerCount: offers.length,\n      url: input.url,\n      offers: offers.map(({ plan, price }) => {\n        const name = input.planName?.(plan.key);\n        const amount = publicPricingAmountDecimal(price);\n        return {\n          '@type': 'Offer',\n          ...(name === undefined ? {} : { name }),\n          price: amount,\n          priceCurrency: price.currency,\n          availability: 'https://schema.org/InStock',\n          url: `${input.url}#plan-${plan.key}`,\n          priceSpecification: {\n            '@type': 'UnitPriceSpecification',\n            price: amount,\n            priceCurrency: price.currency,\n            ...(price.recurrence.unit === PublicPricingRecurrenceUnit.ONE_TIME ? {} : { billingDuration: isoDurationOf(price) }),\n            ...(price.amountBasis === PublicPricingAmountBasis.PER_UNIT\n              ? { referenceQuantity: { '@type': 'QuantitativeValue', value: 1, unitText: input.perUnitName } }\n              : {}),\n          },\n        };\n      }),\n    };\n  });\n}\n\n/** What distinguishes an aggregate's `@id`: its basis, its recurrence and its currency — exactly its group key. */\nfunction aggregateSuffix(price: PublicPricingPrice): string {\n  return `${price.amountBasis}-${price.recurrence.count}-${price.recurrence.unit}-${price.currency}`.toLowerCase().replace(/_/gu, '-');\n}\n\n/** The plan's default price, when publishing it as the offer's price would be true. */\nfunction publishablePrice(plan: PublicPricingPlan): PublicPricingPrice | undefined {\n  if (plan.availability !== ProductAvailability.AVAILABLE) return undefined;\n  if (plan.priceDisclosure !== ProductPriceDisclosure.LISTED) return undefined;\n  const price = plan.prices.find((candidate) => candidate.isDefault) ?? plan.prices[0];\n  if (price === undefined || price.amountBasis === PublicPricingAmountBasis.VARIABLE) return undefined;\n  return price;\n}\n\n/** Total over the recurring units: a member added to the vocabulary is a compile error here until it is mapped. */\nconst ISO_DURATION_DESIGNATOR: Record<Exclude<PublicPricingRecurrenceUnit, PublicPricingRecurrenceUnit.ONE_TIME>, string> = {\n  [PublicPricingRecurrenceUnit.MONTH]: 'M',\n  [PublicPricingRecurrenceUnit.YEAR]: 'Y',\n};\n\nfunction isoDurationOf(price: PublicPricingPrice): string {\n  const unit = price.recurrence.unit as Exclude<PublicPricingRecurrenceUnit, PublicPricingRecurrenceUnit.ONE_TIME>;\n  return `P${price.recurrence.count}${ISO_DURATION_DESIGNATOR[unit]}`;\n}\n/** @wildo_source:part:end saas.website.pricing-offer-structured-data */\n"]}

package/dist/esm/schemas/structured-data/structured-data-reconciliation.shared.d.ts

@@ -80,6 +80,27 @@ export interface StructuredDataCrossEntityReferenceDriftFinding {
     message: string;
 }
 export type StructuredDataReconciliationFinding = StructuredDataCatalogOverrideFinding | StructuredDataCatalogMissFinding | StructuredDataSpecViolationFinding | StructuredDataDeprecatedFieldFinding | StructuredDataCrossEntityReferenceDriftFinding;
+/**
+ * An OPTIONAL field a payload leaves out, reported because its catalog entry opted in with
+ * `recommendOptionals: true` — the entry's statement that for this type the optional fields are
+ * where the richer search and answer-engine results come from.
+ *
+ * Deliberately NOT a finding. A finding says the payload is wrong (a missing required field, an
+ * unknown type, a deprecated field) and `--strict` escalates every finding to a failure. A payload
+ * without its optional fields is valid; reporting it through the same channel would fail strict CI for
+ * following the vocabulary. So recommendations travel beside the findings, are shown as information,
+ * and never change an audit's outcome.
+ */
+export interface StructuredDataOptionalFieldRecommendation {
+    pageRef: string;
+    routePath: string;
+    sectionRef: string;
+    entityType: string;
+    entityId?: string;
+    /** The entry's optional fields this payload does not carry, in catalog order. */
+    missingOptionalFields: readonly string[];
+    message: string;
+}
 export interface StructuredDataReconciliationPageResult {
     pageRef: string;
     routePath: string;
@@ -88,6 +109,8 @@ export interface StructuredDataReconciliationPageResult {
 }
 export interface StructuredDataReconciliationResult {
     findings: StructuredDataReconciliationFinding[];
+    /** Optional-field recommendations from entries that opted in — information, never a finding. */
+    recommendations: StructuredDataOptionalFieldRecommendation[];
     pages: StructuredDataReconciliationPageResult[];
 }
 export interface ReconcileStructuredDataOptions {

package/dist/esm/schemas/structured-data/structured-data-reconciliation.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured-data-reconciliation.shared.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/structured-data/structured-data-reconciliation.shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structured-data-reconciliation.shared.d.ts","sourceRoot":"","sources":["../../../../src/schemas/structured-data/structured-data-reconciliation.shared.ts"],"names":[],"mappings":"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"}

package/dist/esm/schemas/structured-data/structured-data-reconciliation.shared.js

@@ -1,5 +1,6 @@
 export function reconcileStructuredDataAgainstCatalog(options) {
     const findings = [];
+    const recommendations = [];
     const pages = [];
     const sectionsByRef = new Map(options.sections.map((section) => [section.sectionRef, section]));
     const pagePayloadsByPageRef = new Map();
@@ -138,7 +139,7 @@ export function reconcileStructuredDataAgainstCatalog(options) {
             }
             const routeFindingStart = findings.length;
             for (const payloadContext of payloadContexts) {
-                validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings);
+                validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings, recommendations);
             }
             pages.push({
                 pageRef: page.ref,
@@ -164,6 +165,7 @@ export function reconcileStructuredDataAgainstCatalog(options) {
     }
     return {
         findings,
+        recommendations,
         pages,
     };
 }
@@ -215,7 +217,7 @@ function collectNormalizedPayloadContexts(input) {
         });
     }
 }
-function validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings) {
+function validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings, recommendations) {
     const { payload, pageRef, routePath, sectionRef } = payloadContext;
     const entityType = payload['@type'];
     const entityId = typeof payload['@id'] === 'string' ? payload['@id'] : undefined;
@@ -249,6 +251,22 @@ function validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEn
             });
         }
     }
+    if (catalogEntry.recommendOptionals === true) {
+        const missingOptionalFields = (catalogEntry.optionalFields ?? []).filter((field) => !hasPresentFieldValue(payload, field));
+        if (missingOptionalFields.length > 0) {
+            recommendations.push({
+                pageRef,
+                routePath,
+                sectionRef,
+                entityType,
+                entityId,
+                missingOptionalFields,
+                message: `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" on page "${pageRef}" ` +
+                    `could carry ${missingOptionalFields.map((field) => `"${field}"`).join(', ')} — optional, and the catalog ` +
+                    'recommends them for richer search and answer-engine results.',
+            });
+        }
+    }
     for (const deprecatedField of catalogEntry.deprecatedFields ?? []) {
         if (!hasPresentFieldValue(payload, deprecatedField.field)) {
             continue;

package/dist/esm/schemas/structured-data/structured-data-reconciliation.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"structured-data-reconciliation.shared.js","sourceRoot":"","sources":["../../../../../src/schemas/structured-data/structured-data-reconciliation.shared.ts"],"names":[],"mappings":"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","sourcesContent":["export interface StructuredDataDeprecatedField {\n  field: string;\n  replacedBy: string | null;\n  deprecatedSince: string;\n}\n\nexport interface StructuredDataCatalogEntry {\n  '@type': string;\n  requiredFields: readonly string[];\n  optionalFields?: readonly string[];\n  deprecatedFields?: readonly StructuredDataDeprecatedField[];\n  recommendOptionals?: boolean;\n}\n\nexport interface StructuredDataPayload {\n  '@type': string;\n  '@id'?: string;\n  [key: string]: unknown;\n}\n\nexport interface StructuredDataSectionDefinitionLike {\n  sectionRef: string;\n  getStructuredData?: () => unknown;\n}\n\nexport interface StructuredDataPageManifestLike {\n  ref: string;\n  routePath: string;\n  sectionRefs: readonly string[];\n}\n\nexport interface StructuredDataPagePayloadLike {\n  pageRef: string;\n  routePath?: string;\n  sourceRef?: string;\n  payloads: unknown;\n}\n\nexport type StructuredDataSpecViolationCode =\n  | 'invalid-payload-shape'\n  | 'missing-entity-type'\n  | 'missing-required-field'\n  | 'missing-section-definition'\n  | 'orphan-page-payload';\n\nexport interface StructuredDataCatalogOverrideFinding {\n  kind: 'catalog-override';\n  entityType: string;\n  count: number;\n  message: string;\n}\n\nexport interface StructuredDataCatalogMissFinding {\n  kind: 'catalog-miss';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  message: string;\n}\n\nexport interface StructuredDataSpecViolationFinding {\n  kind: 'spec-violation';\n  code: StructuredDataSpecViolationCode;\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType?: string;\n  entityId?: string;\n  field?: string;\n  message: string;\n}\n\nexport interface StructuredDataDeprecatedFieldFinding {\n  kind: 'deprecated-field';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  field: string;\n  replacedBy: string | null;\n  deprecatedSince: string;\n  message: string;\n}\n\nexport interface StructuredDataCrossEntityReferenceDriftFinding {\n  kind: 'cross-entity-reference-drift';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  missingReferenceId: string;\n  message: string;\n}\n\nexport type StructuredDataReconciliationFinding =\n  | StructuredDataCatalogOverrideFinding\n  | StructuredDataCatalogMissFinding\n  | StructuredDataSpecViolationFinding\n  | StructuredDataDeprecatedFieldFinding\n  | StructuredDataCrossEntityReferenceDriftFinding;\n\nexport interface StructuredDataReconciliationPageResult {\n  pageRef: string;\n  routePath: string;\n  payloadCount: number;\n  findingCount: number;\n}\n\nexport interface StructuredDataReconciliationResult {\n  findings: StructuredDataReconciliationFinding[];\n  pages: StructuredDataReconciliationPageResult[];\n}\n\nexport interface ReconcileStructuredDataOptions {\n  catalog: readonly StructuredDataCatalogEntry[];\n  pages: readonly StructuredDataPageManifestLike[];\n  sections: readonly StructuredDataSectionDefinitionLike[];\n  pagePayloads?: readonly StructuredDataPagePayloadLike[];\n}\n\ninterface ReconciliationPayloadContext {\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  payload: StructuredDataPayload;\n}\n\nexport function reconcileStructuredDataAgainstCatalog(\n  options: ReconcileStructuredDataOptions,\n): StructuredDataReconciliationResult {\n  const findings: StructuredDataReconciliationFinding[] = [];\n  const pages: StructuredDataReconciliationPageResult[] = [];\n  const sectionsByRef = new Map(\n    options.sections.map((section) => [section.sectionRef, section] as const),\n  );\n  const pagePayloadsByPageRef = new Map<string, StructuredDataPagePayloadLike[]>();\n  for (const pagePayload of options.pagePayloads ?? []) {\n    const pagePayloads = pagePayloadsByPageRef.get(pagePayload.pageRef) ?? [];\n    pagePayloads.push(pagePayload);\n    pagePayloadsByPageRef.set(pagePayload.pageRef, pagePayloads);\n  }\n  const catalogByType = new Map<string, StructuredDataCatalogEntry>();\n  const catalogCounts = new Map<string, number>();\n\n  for (const entry of options.catalog) {\n    catalogByType.set(entry['@type'], entry);\n    catalogCounts.set(entry['@type'], (catalogCounts.get(entry['@type']) ?? 0) + 1);\n  }\n\n  for (const [entityType, count] of catalogCounts.entries()) {\n    if (count > 1) {\n      findings.push({\n        kind: 'catalog-override',\n        entityType,\n        count,\n        message:\n          `Merged catalog contains ${count} entries for @type=\"${entityType}\". ` +\n          'Replacement semantics are last-wins; duplicate array entries indicate an unresolved override.',\n      });\n    }\n  }\n\n  for (const page of options.pages) {\n    const pageFindingStart = findings.length;\n    const sectionPayloadContexts: ReconciliationPayloadContext[] = [];\n    const isTemplatedRoute = page.routePath.includes('[');\n\n    for (const sectionRef of page.sectionRefs) {\n      const section = sectionsByRef.get(sectionRef);\n      if (!section) {\n        findings.push({\n          kind: 'spec-violation',\n          code: 'missing-section-definition',\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          message:\n            `Page \"${page.ref}\" references sectionRef \"${sectionRef}\" but no matching section ` +\n            'definition was supplied to the structured-data reconciliation harness.',\n        });\n        continue;\n      }\n\n      if (!section.getStructuredData) {\n        continue;\n      }\n\n      const rawStructuredData = section.getStructuredData();\n      const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);\n\n      if (normalizedPayloads === null) {\n        findings.push({\n          kind: 'spec-violation',\n          code: 'invalid-payload-shape',\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          message:\n            `Section \"${sectionRef}\" on page \"${page.ref}\" returned an invalid ` +\n            '`getStructuredData()` shape. Expected object, array, null, or undefined.',\n        });\n        continue;\n      }\n\n      for (const candidate of normalizedPayloads) {\n        if (!isPlainObject(candidate)) {\n          findings.push({\n            kind: 'spec-violation',\n            code: 'invalid-payload-shape',\n            pageRef: page.ref,\n            routePath: page.routePath,\n            sectionRef,\n            message:\n              `Section \"${sectionRef}\" on page \"${page.ref}\" returned a non-object structured-data payload.`,\n          });\n          continue;\n        }\n\n        if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {\n          findings.push({\n            kind: 'spec-violation',\n            code: 'missing-entity-type',\n            pageRef: page.ref,\n            routePath: page.routePath,\n            sectionRef,\n            entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,\n            message:\n              `Section \"${sectionRef}\" on page \"${page.ref}\" returned a structured-data payload ` +\n              'without a non-empty string `@type`.',\n          });\n          continue;\n        }\n\n        sectionPayloadContexts.push({\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          payload: candidate as StructuredDataPayload,\n        });\n      }\n    }\n\n    const contextsByRoutePath = new Map<string, ReconciliationPayloadContext[]>();\n    const collectionFindingCountByRoutePath = new Map<string, number>();\n    const pagePayloadsForPage = pagePayloadsByPageRef.get(page.ref) ?? [];\n    pagePayloadsByPageRef.delete(page.ref);\n    const shouldEmitManifestResult =\n      (sectionPayloadContexts.length > 0 && (!isTemplatedRoute || pagePayloadsForPage.length === 0))\n      || findings.length > pageFindingStart\n      || pagePayloadsForPage.length === 0;\n    if (shouldEmitManifestResult) {\n      const manifestPayloadContexts =\n        isTemplatedRoute && pagePayloadsForPage.length > 0\n          ? []\n          : [...sectionPayloadContexts];\n      contextsByRoutePath.set(page.routePath, manifestPayloadContexts);\n      collectionFindingCountByRoutePath.set(page.routePath, findings.length - pageFindingStart);\n    }\n\n    for (const pagePayload of pagePayloadsForPage) {\n      const routePath = pagePayload.routePath ?? page.routePath;\n      const payloadContexts = contextsByRoutePath.get(routePath) ?? [];\n      if (\n        payloadContexts.length === 0\n        && isTemplatedRoute\n        && sectionPayloadContexts.length > 0\n      ) {\n        payloadContexts.push(\n          ...sectionPayloadContexts.map((context) => ({\n            ...context,\n            routePath,\n          })),\n        );\n      }\n      contextsByRoutePath.set(routePath, payloadContexts);\n      const collectionFindingStart = findings.length;\n      collectNormalizedPayloadContexts({\n        rawStructuredData: pagePayload.payloads,\n        pageRef: page.ref,\n        routePath,\n        sectionRef: pagePayload.sourceRef ?? `page:${page.ref}`,\n        findings,\n        into: payloadContexts,\n      });\n      collectionFindingCountByRoutePath.set(\n        routePath,\n        (collectionFindingCountByRoutePath.get(routePath) ?? 0)\n          + findings.length - collectionFindingStart,\n      );\n    }\n\n    for (const [routePath, payloadContexts] of contextsByRoutePath.entries()) {\n      const declaredEntityIds = new Set<string>();\n      for (const payloadContext of payloadContexts) {\n        collectDeclaredEntityIds(payloadContext.payload, declaredEntityIds);\n      }\n\n      const routeFindingStart = findings.length;\n      for (const payloadContext of payloadContexts) {\n        validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings);\n      }\n\n      pages.push({\n        pageRef: page.ref,\n        routePath,\n        payloadCount: payloadContexts.length,\n        findingCount:\n          (collectionFindingCountByRoutePath.get(routePath) ?? 0)\n          + findings.length - routeFindingStart,\n      });\n    }\n  }\n\n  for (const [pageRef, pagePayloads] of pagePayloadsByPageRef.entries()) {\n    for (const pagePayload of pagePayloads) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'orphan-page-payload',\n        pageRef,\n        routePath: pagePayload.routePath ?? '',\n        sectionRef: pagePayload.sourceRef ?? `page:${pageRef}`,\n        message:\n          `Structured-data page payload \"${pagePayload.sourceRef ?? `page:${pageRef}`}\" ` +\n          `references pageRef \"${pageRef}\" but no matching page manifest was supplied.`,\n      });\n    }\n  }\n\n  return {\n    findings,\n    pages,\n  };\n}\n\nfunction collectNormalizedPayloadContexts(input: {\n  rawStructuredData: unknown;\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  findings: StructuredDataReconciliationFinding[];\n  into: ReconciliationPayloadContext[];\n}): void {\n  const {\n    rawStructuredData,\n    pageRef,\n    routePath,\n    sectionRef,\n    findings,\n    into,\n  } = input;\n  const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);\n\n  if (normalizedPayloads === null) {\n    findings.push({\n      kind: 'spec-violation',\n      code: 'invalid-payload-shape',\n      pageRef,\n      routePath,\n      sectionRef,\n      message:\n        `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned an invalid ` +\n        'structured-data shape. Expected object, array, null, or undefined.',\n    });\n    return;\n  }\n\n  for (const candidate of normalizedPayloads) {\n    if (!isPlainObject(candidate)) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'invalid-payload-shape',\n        pageRef,\n        routePath,\n        sectionRef,\n        message:\n          `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned a non-object structured-data payload.`,\n      });\n      continue;\n    }\n\n    if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'missing-entity-type',\n        pageRef,\n        routePath,\n        sectionRef,\n        entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,\n        message:\n          `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned a structured-data payload ` +\n          'without a non-empty string `@type`.',\n      });\n      continue;\n    }\n\n    into.push({\n      pageRef,\n      routePath,\n      sectionRef,\n      payload: candidate as StructuredDataPayload,\n    });\n  }\n}\n\nfunction validatePayloadAgainstCatalog(\n  payloadContext: ReconciliationPayloadContext,\n  catalogByType: ReadonlyMap<string, StructuredDataCatalogEntry>,\n  declaredEntityIds: ReadonlySet<string>,\n  findings: StructuredDataReconciliationFinding[],\n): void {\n  const { payload, pageRef, routePath, sectionRef } = payloadContext;\n  const entityType = payload['@type'];\n  const entityId = typeof payload['@id'] === 'string' ? payload['@id'] : undefined;\n  const catalogEntry = catalogByType.get(entityType);\n\n  if (!catalogEntry) {\n    findings.push({\n      kind: 'catalog-miss',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      message:\n        `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n        `on page \"${pageRef}\" does not exist in the merged catalog.`,\n    });\n    return;\n  }\n\n  for (const requiredField of catalogEntry.requiredFields) {\n    if (!hasPresentFieldValue(payload, requiredField)) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'missing-required-field',\n        pageRef,\n        routePath,\n        sectionRef,\n        entityType,\n        entityId,\n        field: requiredField,\n        message:\n          `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n          `on page \"${pageRef}\" is missing required field \"${requiredField}\".`,\n      });\n    }\n  }\n\n  for (const deprecatedField of catalogEntry.deprecatedFields ?? []) {\n    if (!hasPresentFieldValue(payload, deprecatedField.field)) {\n      continue;\n    }\n\n    findings.push({\n      kind: 'deprecated-field',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      field: deprecatedField.field,\n      replacedBy: deprecatedField.replacedBy,\n      deprecatedSince: deprecatedField.deprecatedSince,\n      message:\n        deprecatedField.replacedBy === null\n          ? `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n            `on page \"${pageRef}\" uses deprecated field \"${deprecatedField.field}\" ` +\n            `(deprecated since ${deprecatedField.deprecatedSince}).`\n          : `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n            `on page \"${pageRef}\" uses deprecated field \"${deprecatedField.field}\". ` +\n            `Use \"${deprecatedField.replacedBy}\" instead ` +\n            `(deprecated since ${deprecatedField.deprecatedSince}).`,\n    });\n  }\n\n  const referencedIds = new Set<string>();\n  collectReferencedEntityIds(payload, referencedIds, true);\n  for (const referencedId of referencedIds) {\n    if (declaredEntityIds.has(referencedId)) {\n      continue;\n    }\n\n    findings.push({\n      kind: 'cross-entity-reference-drift',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      missingReferenceId: referencedId,\n      message:\n        `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n        `on page \"${pageRef}\" references @id \"${referencedId}\" but no emitted entity on the page defines it.`,\n    });\n  }\n}\n\nfunction normalizeStructuredDataReturn(value: unknown): unknown[] | null {\n  if (value === null || value === undefined) {\n    return [];\n  }\n\n  if (Array.isArray(value)) {\n    return value.filter((item) => item !== null && item !== undefined);\n  }\n\n  if (isPlainObject(value)) {\n    return [value];\n  }\n\n  return null;\n}\n\nfunction hasPresentFieldValue(payload: StructuredDataPayload, fieldName: string): boolean {\n  if (!Object.prototype.hasOwnProperty.call(payload, fieldName)) {\n    return false;\n  }\n\n  const value = payload[fieldName];\n  return value !== null && value !== undefined;\n}\n\nfunction collectDeclaredEntityIds(value: unknown, into: Set<string>): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      collectDeclaredEntityIds(item, into);\n    }\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    return;\n  }\n\n  const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;\n  const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;\n  if (entityId && entityType) {\n    into.add(entityId);\n  }\n\n  for (const child of Object.values(value)) {\n    collectDeclaredEntityIds(child, into);\n  }\n}\n\nfunction collectReferencedEntityIds(\n  value: unknown,\n  into: Set<string>,\n  isRootPayload: boolean,\n): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      collectReferencedEntityIds(item, into, false);\n    }\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    return;\n  }\n\n  const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;\n  const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;\n  if (!isRootPayload && entityId && !entityType) {\n    into.add(entityId);\n  }\n\n  for (const child of Object.values(value)) {\n    collectReferencedEntityIds(child, into, false);\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}
+{"version":3,"file":"structured-data-reconciliation.shared.js","sourceRoot":"","sources":["../../../../src/schemas/structured-data/structured-data-reconciliation.shared.ts"],"names":[],"mappings":"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","sourcesContent":["export interface StructuredDataDeprecatedField {\n  field: string;\n  replacedBy: string | null;\n  deprecatedSince: string;\n}\n\nexport interface StructuredDataCatalogEntry {\n  '@type': string;\n  requiredFields: readonly string[];\n  optionalFields?: readonly string[];\n  deprecatedFields?: readonly StructuredDataDeprecatedField[];\n  recommendOptionals?: boolean;\n}\n\nexport interface StructuredDataPayload {\n  '@type': string;\n  '@id'?: string;\n  [key: string]: unknown;\n}\n\nexport interface StructuredDataSectionDefinitionLike {\n  sectionRef: string;\n  getStructuredData?: () => unknown;\n}\n\nexport interface StructuredDataPageManifestLike {\n  ref: string;\n  routePath: string;\n  sectionRefs: readonly string[];\n}\n\nexport interface StructuredDataPagePayloadLike {\n  pageRef: string;\n  routePath?: string;\n  sourceRef?: string;\n  payloads: unknown;\n}\n\nexport type StructuredDataSpecViolationCode =\n  | 'invalid-payload-shape'\n  | 'missing-entity-type'\n  | 'missing-required-field'\n  | 'missing-section-definition'\n  | 'orphan-page-payload';\n\nexport interface StructuredDataCatalogOverrideFinding {\n  kind: 'catalog-override';\n  entityType: string;\n  count: number;\n  message: string;\n}\n\nexport interface StructuredDataCatalogMissFinding {\n  kind: 'catalog-miss';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  message: string;\n}\n\nexport interface StructuredDataSpecViolationFinding {\n  kind: 'spec-violation';\n  code: StructuredDataSpecViolationCode;\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType?: string;\n  entityId?: string;\n  field?: string;\n  message: string;\n}\n\nexport interface StructuredDataDeprecatedFieldFinding {\n  kind: 'deprecated-field';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  field: string;\n  replacedBy: string | null;\n  deprecatedSince: string;\n  message: string;\n}\n\nexport interface StructuredDataCrossEntityReferenceDriftFinding {\n  kind: 'cross-entity-reference-drift';\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  missingReferenceId: string;\n  message: string;\n}\n\nexport type StructuredDataReconciliationFinding =\n  | StructuredDataCatalogOverrideFinding\n  | StructuredDataCatalogMissFinding\n  | StructuredDataSpecViolationFinding\n  | StructuredDataDeprecatedFieldFinding\n  | StructuredDataCrossEntityReferenceDriftFinding;\n\n/**\n * An OPTIONAL field a payload leaves out, reported because its catalog entry opted in with\n * `recommendOptionals: true` — the entry's statement that for this type the optional fields are\n * where the richer search and answer-engine results come from.\n *\n * Deliberately NOT a finding. A finding says the payload is wrong (a missing required field, an\n * unknown type, a deprecated field) and `--strict` escalates every finding to a failure. A payload\n * without its optional fields is valid; reporting it through the same channel would fail strict CI for\n * following the vocabulary. So recommendations travel beside the findings, are shown as information,\n * and never change an audit's outcome.\n */\nexport interface StructuredDataOptionalFieldRecommendation {\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  entityType: string;\n  entityId?: string;\n  /** The entry's optional fields this payload does not carry, in catalog order. */\n  missingOptionalFields: readonly string[];\n  message: string;\n}\n\nexport interface StructuredDataReconciliationPageResult {\n  pageRef: string;\n  routePath: string;\n  payloadCount: number;\n  findingCount: number;\n}\n\nexport interface StructuredDataReconciliationResult {\n  findings: StructuredDataReconciliationFinding[];\n  /** Optional-field recommendations from entries that opted in — information, never a finding. */\n  recommendations: StructuredDataOptionalFieldRecommendation[];\n  pages: StructuredDataReconciliationPageResult[];\n}\n\nexport interface ReconcileStructuredDataOptions {\n  catalog: readonly StructuredDataCatalogEntry[];\n  pages: readonly StructuredDataPageManifestLike[];\n  sections: readonly StructuredDataSectionDefinitionLike[];\n  pagePayloads?: readonly StructuredDataPagePayloadLike[];\n}\n\ninterface ReconciliationPayloadContext {\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  payload: StructuredDataPayload;\n}\n\nexport function reconcileStructuredDataAgainstCatalog(\n  options: ReconcileStructuredDataOptions,\n): StructuredDataReconciliationResult {\n  const findings: StructuredDataReconciliationFinding[] = [];\n  const recommendations: StructuredDataOptionalFieldRecommendation[] = [];\n  const pages: StructuredDataReconciliationPageResult[] = [];\n  const sectionsByRef = new Map(\n    options.sections.map((section) => [section.sectionRef, section] as const),\n  );\n  const pagePayloadsByPageRef = new Map<string, StructuredDataPagePayloadLike[]>();\n  for (const pagePayload of options.pagePayloads ?? []) {\n    const pagePayloads = pagePayloadsByPageRef.get(pagePayload.pageRef) ?? [];\n    pagePayloads.push(pagePayload);\n    pagePayloadsByPageRef.set(pagePayload.pageRef, pagePayloads);\n  }\n  const catalogByType = new Map<string, StructuredDataCatalogEntry>();\n  const catalogCounts = new Map<string, number>();\n\n  for (const entry of options.catalog) {\n    catalogByType.set(entry['@type'], entry);\n    catalogCounts.set(entry['@type'], (catalogCounts.get(entry['@type']) ?? 0) + 1);\n  }\n\n  for (const [entityType, count] of catalogCounts.entries()) {\n    if (count > 1) {\n      findings.push({\n        kind: 'catalog-override',\n        entityType,\n        count,\n        message:\n          `Merged catalog contains ${count} entries for @type=\"${entityType}\". ` +\n          'Replacement semantics are last-wins; duplicate array entries indicate an unresolved override.',\n      });\n    }\n  }\n\n  for (const page of options.pages) {\n    const pageFindingStart = findings.length;\n    const sectionPayloadContexts: ReconciliationPayloadContext[] = [];\n    const isTemplatedRoute = page.routePath.includes('[');\n\n    for (const sectionRef of page.sectionRefs) {\n      const section = sectionsByRef.get(sectionRef);\n      if (!section) {\n        findings.push({\n          kind: 'spec-violation',\n          code: 'missing-section-definition',\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          message:\n            `Page \"${page.ref}\" references sectionRef \"${sectionRef}\" but no matching section ` +\n            'definition was supplied to the structured-data reconciliation harness.',\n        });\n        continue;\n      }\n\n      if (!section.getStructuredData) {\n        continue;\n      }\n\n      const rawStructuredData = section.getStructuredData();\n      const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);\n\n      if (normalizedPayloads === null) {\n        findings.push({\n          kind: 'spec-violation',\n          code: 'invalid-payload-shape',\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          message:\n            `Section \"${sectionRef}\" on page \"${page.ref}\" returned an invalid ` +\n            '`getStructuredData()` shape. Expected object, array, null, or undefined.',\n        });\n        continue;\n      }\n\n      for (const candidate of normalizedPayloads) {\n        if (!isPlainObject(candidate)) {\n          findings.push({\n            kind: 'spec-violation',\n            code: 'invalid-payload-shape',\n            pageRef: page.ref,\n            routePath: page.routePath,\n            sectionRef,\n            message:\n              `Section \"${sectionRef}\" on page \"${page.ref}\" returned a non-object structured-data payload.`,\n          });\n          continue;\n        }\n\n        if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {\n          findings.push({\n            kind: 'spec-violation',\n            code: 'missing-entity-type',\n            pageRef: page.ref,\n            routePath: page.routePath,\n            sectionRef,\n            entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,\n            message:\n              `Section \"${sectionRef}\" on page \"${page.ref}\" returned a structured-data payload ` +\n              'without a non-empty string `@type`.',\n          });\n          continue;\n        }\n\n        sectionPayloadContexts.push({\n          pageRef: page.ref,\n          routePath: page.routePath,\n          sectionRef,\n          payload: candidate as StructuredDataPayload,\n        });\n      }\n    }\n\n    const contextsByRoutePath = new Map<string, ReconciliationPayloadContext[]>();\n    const collectionFindingCountByRoutePath = new Map<string, number>();\n    const pagePayloadsForPage = pagePayloadsByPageRef.get(page.ref) ?? [];\n    pagePayloadsByPageRef.delete(page.ref);\n    const shouldEmitManifestResult =\n      (sectionPayloadContexts.length > 0 && (!isTemplatedRoute || pagePayloadsForPage.length === 0))\n      || findings.length > pageFindingStart\n      || pagePayloadsForPage.length === 0;\n    if (shouldEmitManifestResult) {\n      const manifestPayloadContexts =\n        isTemplatedRoute && pagePayloadsForPage.length > 0\n          ? []\n          : [...sectionPayloadContexts];\n      contextsByRoutePath.set(page.routePath, manifestPayloadContexts);\n      collectionFindingCountByRoutePath.set(page.routePath, findings.length - pageFindingStart);\n    }\n\n    for (const pagePayload of pagePayloadsForPage) {\n      const routePath = pagePayload.routePath ?? page.routePath;\n      const payloadContexts = contextsByRoutePath.get(routePath) ?? [];\n      if (\n        payloadContexts.length === 0\n        && isTemplatedRoute\n        && sectionPayloadContexts.length > 0\n      ) {\n        payloadContexts.push(\n          ...sectionPayloadContexts.map((context) => ({\n            ...context,\n            routePath,\n          })),\n        );\n      }\n      contextsByRoutePath.set(routePath, payloadContexts);\n      const collectionFindingStart = findings.length;\n      collectNormalizedPayloadContexts({\n        rawStructuredData: pagePayload.payloads,\n        pageRef: page.ref,\n        routePath,\n        sectionRef: pagePayload.sourceRef ?? `page:${page.ref}`,\n        findings,\n        into: payloadContexts,\n      });\n      collectionFindingCountByRoutePath.set(\n        routePath,\n        (collectionFindingCountByRoutePath.get(routePath) ?? 0)\n          + findings.length - collectionFindingStart,\n      );\n    }\n\n    for (const [routePath, payloadContexts] of contextsByRoutePath.entries()) {\n      const declaredEntityIds = new Set<string>();\n      for (const payloadContext of payloadContexts) {\n        collectDeclaredEntityIds(payloadContext.payload, declaredEntityIds);\n      }\n\n      const routeFindingStart = findings.length;\n      for (const payloadContext of payloadContexts) {\n        validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings, recommendations);\n      }\n\n      pages.push({\n        pageRef: page.ref,\n        routePath,\n        payloadCount: payloadContexts.length,\n        findingCount:\n          (collectionFindingCountByRoutePath.get(routePath) ?? 0)\n          + findings.length - routeFindingStart,\n      });\n    }\n  }\n\n  for (const [pageRef, pagePayloads] of pagePayloadsByPageRef.entries()) {\n    for (const pagePayload of pagePayloads) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'orphan-page-payload',\n        pageRef,\n        routePath: pagePayload.routePath ?? '',\n        sectionRef: pagePayload.sourceRef ?? `page:${pageRef}`,\n        message:\n          `Structured-data page payload \"${pagePayload.sourceRef ?? `page:${pageRef}`}\" ` +\n          `references pageRef \"${pageRef}\" but no matching page manifest was supplied.`,\n      });\n    }\n  }\n\n  return {\n    findings,\n    recommendations,\n    pages,\n  };\n}\n\nfunction collectNormalizedPayloadContexts(input: {\n  rawStructuredData: unknown;\n  pageRef: string;\n  routePath: string;\n  sectionRef: string;\n  findings: StructuredDataReconciliationFinding[];\n  into: ReconciliationPayloadContext[];\n}): void {\n  const {\n    rawStructuredData,\n    pageRef,\n    routePath,\n    sectionRef,\n    findings,\n    into,\n  } = input;\n  const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);\n\n  if (normalizedPayloads === null) {\n    findings.push({\n      kind: 'spec-violation',\n      code: 'invalid-payload-shape',\n      pageRef,\n      routePath,\n      sectionRef,\n      message:\n        `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned an invalid ` +\n        'structured-data shape. Expected object, array, null, or undefined.',\n    });\n    return;\n  }\n\n  for (const candidate of normalizedPayloads) {\n    if (!isPlainObject(candidate)) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'invalid-payload-shape',\n        pageRef,\n        routePath,\n        sectionRef,\n        message:\n          `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned a non-object structured-data payload.`,\n      });\n      continue;\n    }\n\n    if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'missing-entity-type',\n        pageRef,\n        routePath,\n        sectionRef,\n        entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,\n        message:\n          `Structured-data source \"${sectionRef}\" on page \"${pageRef}\" returned a structured-data payload ` +\n          'without a non-empty string `@type`.',\n      });\n      continue;\n    }\n\n    into.push({\n      pageRef,\n      routePath,\n      sectionRef,\n      payload: candidate as StructuredDataPayload,\n    });\n  }\n}\n\nfunction validatePayloadAgainstCatalog(\n  payloadContext: ReconciliationPayloadContext,\n  catalogByType: ReadonlyMap<string, StructuredDataCatalogEntry>,\n  declaredEntityIds: ReadonlySet<string>,\n  findings: StructuredDataReconciliationFinding[],\n  recommendations: StructuredDataOptionalFieldRecommendation[],\n): void {\n  const { payload, pageRef, routePath, sectionRef } = payloadContext;\n  const entityType = payload['@type'];\n  const entityId = typeof payload['@id'] === 'string' ? payload['@id'] : undefined;\n  const catalogEntry = catalogByType.get(entityType);\n\n  if (!catalogEntry) {\n    findings.push({\n      kind: 'catalog-miss',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      message:\n        `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n        `on page \"${pageRef}\" does not exist in the merged catalog.`,\n    });\n    return;\n  }\n\n  for (const requiredField of catalogEntry.requiredFields) {\n    if (!hasPresentFieldValue(payload, requiredField)) {\n      findings.push({\n        kind: 'spec-violation',\n        code: 'missing-required-field',\n        pageRef,\n        routePath,\n        sectionRef,\n        entityType,\n        entityId,\n        field: requiredField,\n        message:\n          `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n          `on page \"${pageRef}\" is missing required field \"${requiredField}\".`,\n      });\n    }\n  }\n\n  if (catalogEntry.recommendOptionals === true) {\n    const missingOptionalFields = (catalogEntry.optionalFields ?? []).filter((field) => !hasPresentFieldValue(payload, field));\n    if (missingOptionalFields.length > 0) {\n      recommendations.push({\n        pageRef,\n        routePath,\n        sectionRef,\n        entityType,\n        entityId,\n        missingOptionalFields,\n        message:\n          `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" on page \"${pageRef}\" ` +\n          `could carry ${missingOptionalFields.map((field) => `\"${field}\"`).join(', ')} — optional, and the catalog ` +\n          'recommends them for richer search and answer-engine results.',\n      });\n    }\n  }\n\n  for (const deprecatedField of catalogEntry.deprecatedFields ?? []) {\n    if (!hasPresentFieldValue(payload, deprecatedField.field)) {\n      continue;\n    }\n\n    findings.push({\n      kind: 'deprecated-field',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      field: deprecatedField.field,\n      replacedBy: deprecatedField.replacedBy,\n      deprecatedSince: deprecatedField.deprecatedSince,\n      message:\n        deprecatedField.replacedBy === null\n          ? `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n            `on page \"${pageRef}\" uses deprecated field \"${deprecatedField.field}\" ` +\n            `(deprecated since ${deprecatedField.deprecatedSince}).`\n          : `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n            `on page \"${pageRef}\" uses deprecated field \"${deprecatedField.field}\". ` +\n            `Use \"${deprecatedField.replacedBy}\" instead ` +\n            `(deprecated since ${deprecatedField.deprecatedSince}).`,\n    });\n  }\n\n  const referencedIds = new Set<string>();\n  collectReferencedEntityIds(payload, referencedIds, true);\n  for (const referencedId of referencedIds) {\n    if (declaredEntityIds.has(referencedId)) {\n      continue;\n    }\n\n    findings.push({\n      kind: 'cross-entity-reference-drift',\n      pageRef,\n      routePath,\n      sectionRef,\n      entityType,\n      entityId,\n      missingReferenceId: referencedId,\n      message:\n        `Structured-data payload @type=\"${entityType}\" emitted by section \"${sectionRef}\" ` +\n        `on page \"${pageRef}\" references @id \"${referencedId}\" but no emitted entity on the page defines it.`,\n    });\n  }\n}\n\nfunction normalizeStructuredDataReturn(value: unknown): unknown[] | null {\n  if (value === null || value === undefined) {\n    return [];\n  }\n\n  if (Array.isArray(value)) {\n    return value.filter((item) => item !== null && item !== undefined);\n  }\n\n  if (isPlainObject(value)) {\n    return [value];\n  }\n\n  return null;\n}\n\nfunction hasPresentFieldValue(payload: StructuredDataPayload, fieldName: string): boolean {\n  if (!Object.prototype.hasOwnProperty.call(payload, fieldName)) {\n    return false;\n  }\n\n  const value = payload[fieldName];\n  return value !== null && value !== undefined;\n}\n\nfunction collectDeclaredEntityIds(value: unknown, into: Set<string>): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      collectDeclaredEntityIds(item, into);\n    }\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    return;\n  }\n\n  const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;\n  const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;\n  if (entityId && entityType) {\n    into.add(entityId);\n  }\n\n  for (const child of Object.values(value)) {\n    collectDeclaredEntityIds(child, into);\n  }\n}\n\nfunction collectReferencedEntityIds(\n  value: unknown,\n  into: Set<string>,\n  isRootPayload: boolean,\n): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      collectReferencedEntityIds(item, into, false);\n    }\n    return;\n  }\n\n  if (!isPlainObject(value)) {\n    return;\n  }\n\n  const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;\n  const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;\n  if (!isRootPayload && entityId && !entityType) {\n    into.add(entityId);\n  }\n\n  for (const child of Object.values(value)) {\n    collectReferencedEntityIds(child, into, false);\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/esm/schemas/structured-data/website-structured-data.shared.schemas.d.ts

@@ -16,11 +16,13 @@
  *
  * - `@type` REQUIRED — the Schema.org entity kind (`'Article'`,
  *   `'BlogPosting'`, `'FAQPage'`, …). Typed as a free-form `string`
- *   here (not a closed enum) so app-side catalog extensions
- *   (e.g. `'SoftwareApplication'`, custom Schema.org-extension
- *   `@type`s) are emittable without a saas-website release. The
- *   companion's catalog reconciliation surface validates the
- *   `@type` value against the merged engine + app catalog.
+ *   here (not a closed enum) because this package ships to the browser
+ *   and must not carry the catalog: the renderer emits whatever type a
+ *   section returns. What VALIDATES the type is the Schema.org catalog,
+ *   through `wildo website audit` and the companion's reconciliation —
+ *   and that catalog is a closed enum an application can override but
+ *   not extend, so a type outside it reports `catalog-miss` until the
+ *   framework adds it.
  * - `@id?` OPTIONAL — a stable URI identifying the entity. Used for
  *   cross-referencing on the same page (e.g. `Article.publisher`
  *   referencing the page-level `Organization` via `@id`). The

package/dist/esm/schemas/structured-data/website-structured-data.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-structured-data.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/structured-data/website-structured-data.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,SAAS,4BAA4B,EAAE,GACvC,IAAI,GACJ,SAAS,CAAC;AACd,wEAAwE"}
+{"version":3,"file":"website-structured-data.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/schemas/structured-data/website-structured-data.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,SAAS,4BAA4B,EAAE,GACvC,IAAI,GACJ,SAAS,CAAC;AACd,wEAAwE"}