@wildo-ai/saas-website 1.1.1

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

@@ -0,0 +1,355 @@
+export function reconcileStructuredDataAgainstCatalog(options) {
+    const findings = [];
+    const pages = [];
+    const sectionsByRef = new Map(options.sections.map((section) => [section.sectionRef, section]));
+    const pagePayloadsByPageRef = new Map();
+    for (const pagePayload of options.pagePayloads ?? []) {
+        const pagePayloads = pagePayloadsByPageRef.get(pagePayload.pageRef) ?? [];
+        pagePayloads.push(pagePayload);
+        pagePayloadsByPageRef.set(pagePayload.pageRef, pagePayloads);
+    }
+    const catalogByType = new Map();
+    const catalogCounts = new Map();
+    for (const entry of options.catalog) {
+        catalogByType.set(entry['@type'], entry);
+        catalogCounts.set(entry['@type'], (catalogCounts.get(entry['@type']) ?? 0) + 1);
+    }
+    for (const [entityType, count] of catalogCounts.entries()) {
+        if (count > 1) {
+            findings.push({
+                kind: 'catalog-override',
+                entityType,
+                count,
+                message: `Merged catalog contains ${count} entries for @type="${entityType}". ` +
+                    'Replacement semantics are last-wins; duplicate array entries indicate an unresolved override.',
+            });
+        }
+    }
+    for (const page of options.pages) {
+        const pageFindingStart = findings.length;
+        const sectionPayloadContexts = [];
+        const isTemplatedRoute = page.routePath.includes('[');
+        for (const sectionRef of page.sectionRefs) {
+            const section = sectionsByRef.get(sectionRef);
+            if (!section) {
+                findings.push({
+                    kind: 'spec-violation',
+                    code: 'missing-section-definition',
+                    pageRef: page.ref,
+                    routePath: page.routePath,
+                    sectionRef,
+                    message: `Page "${page.ref}" references sectionRef "${sectionRef}" but no matching section ` +
+                        'definition was supplied to the structured-data reconciliation harness.',
+                });
+                continue;
+            }
+            if (!section.getStructuredData) {
+                continue;
+            }
+            const rawStructuredData = section.getStructuredData();
+            const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);
+            if (normalizedPayloads === null) {
+                findings.push({
+                    kind: 'spec-violation',
+                    code: 'invalid-payload-shape',
+                    pageRef: page.ref,
+                    routePath: page.routePath,
+                    sectionRef,
+                    message: `Section "${sectionRef}" on page "${page.ref}" returned an invalid ` +
+                        '`getStructuredData()` shape. Expected object, array, null, or undefined.',
+                });
+                continue;
+            }
+            for (const candidate of normalizedPayloads) {
+                if (!isPlainObject(candidate)) {
+                    findings.push({
+                        kind: 'spec-violation',
+                        code: 'invalid-payload-shape',
+                        pageRef: page.ref,
+                        routePath: page.routePath,
+                        sectionRef,
+                        message: `Section "${sectionRef}" on page "${page.ref}" returned a non-object structured-data payload.`,
+                    });
+                    continue;
+                }
+                if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {
+                    findings.push({
+                        kind: 'spec-violation',
+                        code: 'missing-entity-type',
+                        pageRef: page.ref,
+                        routePath: page.routePath,
+                        sectionRef,
+                        entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,
+                        message: `Section "${sectionRef}" on page "${page.ref}" returned a structured-data payload ` +
+                            'without a non-empty string `@type`.',
+                    });
+                    continue;
+                }
+                sectionPayloadContexts.push({
+                    pageRef: page.ref,
+                    routePath: page.routePath,
+                    sectionRef,
+                    payload: candidate,
+                });
+            }
+        }
+        const contextsByRoutePath = new Map();
+        const collectionFindingCountByRoutePath = new Map();
+        const pagePayloadsForPage = pagePayloadsByPageRef.get(page.ref) ?? [];
+        pagePayloadsByPageRef.delete(page.ref);
+        const shouldEmitManifestResult = (sectionPayloadContexts.length > 0 && (!isTemplatedRoute || pagePayloadsForPage.length === 0))
+            || findings.length > pageFindingStart
+            || pagePayloadsForPage.length === 0;
+        if (shouldEmitManifestResult) {
+            const manifestPayloadContexts = isTemplatedRoute && pagePayloadsForPage.length > 0
+                ? []
+                : [...sectionPayloadContexts];
+            contextsByRoutePath.set(page.routePath, manifestPayloadContexts);
+            collectionFindingCountByRoutePath.set(page.routePath, findings.length - pageFindingStart);
+        }
+        for (const pagePayload of pagePayloadsForPage) {
+            const routePath = pagePayload.routePath ?? page.routePath;
+            const payloadContexts = contextsByRoutePath.get(routePath) ?? [];
+            if (payloadContexts.length === 0
+                && isTemplatedRoute
+                && sectionPayloadContexts.length > 0) {
+                payloadContexts.push(...sectionPayloadContexts.map((context) => ({
+                    ...context,
+                    routePath,
+                })));
+            }
+            contextsByRoutePath.set(routePath, payloadContexts);
+            const collectionFindingStart = findings.length;
+            collectNormalizedPayloadContexts({
+                rawStructuredData: pagePayload.payloads,
+                pageRef: page.ref,
+                routePath,
+                sectionRef: pagePayload.sourceRef ?? `page:${page.ref}`,
+                findings,
+                into: payloadContexts,
+            });
+            collectionFindingCountByRoutePath.set(routePath, (collectionFindingCountByRoutePath.get(routePath) ?? 0)
+                + findings.length - collectionFindingStart);
+        }
+        for (const [routePath, payloadContexts] of contextsByRoutePath.entries()) {
+            const declaredEntityIds = new Set();
+            for (const payloadContext of payloadContexts) {
+                collectDeclaredEntityIds(payloadContext.payload, declaredEntityIds);
+            }
+            const routeFindingStart = findings.length;
+            for (const payloadContext of payloadContexts) {
+                validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings);
+            }
+            pages.push({
+                pageRef: page.ref,
+                routePath,
+                payloadCount: payloadContexts.length,
+                findingCount: (collectionFindingCountByRoutePath.get(routePath) ?? 0)
+                    + findings.length - routeFindingStart,
+            });
+        }
+    }
+    for (const [pageRef, pagePayloads] of pagePayloadsByPageRef.entries()) {
+        for (const pagePayload of pagePayloads) {
+            findings.push({
+                kind: 'spec-violation',
+                code: 'orphan-page-payload',
+                pageRef,
+                routePath: pagePayload.routePath ?? '',
+                sectionRef: pagePayload.sourceRef ?? `page:${pageRef}`,
+                message: `Structured-data page payload "${pagePayload.sourceRef ?? `page:${pageRef}`}" ` +
+                    `references pageRef "${pageRef}" but no matching page manifest was supplied.`,
+            });
+        }
+    }
+    return {
+        findings,
+        pages,
+    };
+}
+function collectNormalizedPayloadContexts(input) {
+    const { rawStructuredData, pageRef, routePath, sectionRef, findings, into, } = input;
+    const normalizedPayloads = normalizeStructuredDataReturn(rawStructuredData);
+    if (normalizedPayloads === null) {
+        findings.push({
+            kind: 'spec-violation',
+            code: 'invalid-payload-shape',
+            pageRef,
+            routePath,
+            sectionRef,
+            message: `Structured-data source "${sectionRef}" on page "${pageRef}" returned an invalid ` +
+                'structured-data shape. Expected object, array, null, or undefined.',
+        });
+        return;
+    }
+    for (const candidate of normalizedPayloads) {
+        if (!isPlainObject(candidate)) {
+            findings.push({
+                kind: 'spec-violation',
+                code: 'invalid-payload-shape',
+                pageRef,
+                routePath,
+                sectionRef,
+                message: `Structured-data source "${sectionRef}" on page "${pageRef}" returned a non-object structured-data payload.`,
+            });
+            continue;
+        }
+        if (typeof candidate['@type'] !== 'string' || candidate['@type'].trim().length === 0) {
+            findings.push({
+                kind: 'spec-violation',
+                code: 'missing-entity-type',
+                pageRef,
+                routePath,
+                sectionRef,
+                entityId: typeof candidate['@id'] === 'string' ? candidate['@id'] : undefined,
+                message: `Structured-data source "${sectionRef}" on page "${pageRef}" returned a structured-data payload ` +
+                    'without a non-empty string `@type`.',
+            });
+            continue;
+        }
+        into.push({
+            pageRef,
+            routePath,
+            sectionRef,
+            payload: candidate,
+        });
+    }
+}
+function validatePayloadAgainstCatalog(payloadContext, catalogByType, declaredEntityIds, findings) {
+    const { payload, pageRef, routePath, sectionRef } = payloadContext;
+    const entityType = payload['@type'];
+    const entityId = typeof payload['@id'] === 'string' ? payload['@id'] : undefined;
+    const catalogEntry = catalogByType.get(entityType);
+    if (!catalogEntry) {
+        findings.push({
+            kind: 'catalog-miss',
+            pageRef,
+            routePath,
+            sectionRef,
+            entityType,
+            entityId,
+            message: `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" ` +
+                `on page "${pageRef}" does not exist in the merged catalog.`,
+        });
+        return;
+    }
+    for (const requiredField of catalogEntry.requiredFields) {
+        if (!hasPresentFieldValue(payload, requiredField)) {
+            findings.push({
+                kind: 'spec-violation',
+                code: 'missing-required-field',
+                pageRef,
+                routePath,
+                sectionRef,
+                entityType,
+                entityId,
+                field: requiredField,
+                message: `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" ` +
+                    `on page "${pageRef}" is missing required field "${requiredField}".`,
+            });
+        }
+    }
+    for (const deprecatedField of catalogEntry.deprecatedFields ?? []) {
+        if (!hasPresentFieldValue(payload, deprecatedField.field)) {
+            continue;
+        }
+        findings.push({
+            kind: 'deprecated-field',
+            pageRef,
+            routePath,
+            sectionRef,
+            entityType,
+            entityId,
+            field: deprecatedField.field,
+            replacedBy: deprecatedField.replacedBy,
+            deprecatedSince: deprecatedField.deprecatedSince,
+            message: deprecatedField.replacedBy === null
+                ? `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" ` +
+                    `on page "${pageRef}" uses deprecated field "${deprecatedField.field}" ` +
+                    `(deprecated since ${deprecatedField.deprecatedSince}).`
+                : `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" ` +
+                    `on page "${pageRef}" uses deprecated field "${deprecatedField.field}". ` +
+                    `Use "${deprecatedField.replacedBy}" instead ` +
+                    `(deprecated since ${deprecatedField.deprecatedSince}).`,
+        });
+    }
+    const referencedIds = new Set();
+    collectReferencedEntityIds(payload, referencedIds, true);
+    for (const referencedId of referencedIds) {
+        if (declaredEntityIds.has(referencedId)) {
+            continue;
+        }
+        findings.push({
+            kind: 'cross-entity-reference-drift',
+            pageRef,
+            routePath,
+            sectionRef,
+            entityType,
+            entityId,
+            missingReferenceId: referencedId,
+            message: `Structured-data payload @type="${entityType}" emitted by section "${sectionRef}" ` +
+                `on page "${pageRef}" references @id "${referencedId}" but no emitted entity on the page defines it.`,
+        });
+    }
+}
+function normalizeStructuredDataReturn(value) {
+    if (value === null || value === undefined) {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value.filter((item) => item !== null && item !== undefined);
+    }
+    if (isPlainObject(value)) {
+        return [value];
+    }
+    return null;
+}
+function hasPresentFieldValue(payload, fieldName) {
+    if (!Object.prototype.hasOwnProperty.call(payload, fieldName)) {
+        return false;
+    }
+    const value = payload[fieldName];
+    return value !== null && value !== undefined;
+}
+function collectDeclaredEntityIds(value, into) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectDeclaredEntityIds(item, into);
+        }
+        return;
+    }
+    if (!isPlainObject(value)) {
+        return;
+    }
+    const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;
+    const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;
+    if (entityId && entityType) {
+        into.add(entityId);
+    }
+    for (const child of Object.values(value)) {
+        collectDeclaredEntityIds(child, into);
+    }
+}
+function collectReferencedEntityIds(value, into, isRootPayload) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectReferencedEntityIds(item, into, false);
+        }
+        return;
+    }
+    if (!isPlainObject(value)) {
+        return;
+    }
+    const entityId = typeof value['@id'] === 'string' ? value['@id'] : null;
+    const entityType = typeof value['@type'] === 'string' ? value['@type'] : null;
+    if (!isRootPayload && entityId && !entityType) {
+        into.add(entityId);
+    }
+    for (const child of Object.values(value)) {
+        collectReferencedEntityIds(child, into, false);
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=structured-data-reconciliation.shared.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,58 @@
+/**
+ * @wildo_source:part:start saas.website.structured-data.payload-shape facet:layer:shared facet:family:website
+ *
+ * `WebsiteStructuredDataPayload` — the runtime JSON-LD object shape returned
+ * by a section's `getStructuredData()` and serialized into one
+ * `<script type="application/ld+json">` block per payload.
+ *
+ * **Layering note** — the payload type is defined HERE (in the
+ * website runtime) rather than imported from the specification package because
+ * runtime rendering must remain independent from companion semantics. The
+ * application's Schema.org catalog describes the same vocabulary (per-`@type`
+ * required / optional / deprecated fields); the two contracts are structurally
+ * compatible by design but independently owned.
+ *
+ * **Authoring contract**:
+ *
+ * - `@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.
+ * - `@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
+ *   renderer uses `@id` for deduplication: two payloads with the
+ *   same `@id` collapse into one emitted block (last-wins).
+ * - `@context?` OPTIONAL — the JSON-LD vocabulary URL. The renderer
+ *   auto-injects `'https://schema.org'` when omitted; the field is
+ *   exposed so consumers CAN override (Schema.org payload extended
+ *   with a custom vocabulary).
+ * - All other fields are pass-through `unknown` — the catalog
+ *   describes the FIELD NAMES per `@type`; the per-field SHAPE
+ *   (e.g. `Article.author` is a `Person | Organization`) is locked
+ *   at the section's payload-builder TS-side.
+ */
+export interface WebsiteStructuredDataPayload {
+    '@type': string;
+    '@id'?: string;
+    '@context'?: string | Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Convenience union for `getStructuredData()` return types.
+ *
+ * A section may emit:
+ *   - a single payload (most common — `FAQPage` for an FAQ section);
+ *   - a fixed-length tuple of payloads (e.g. pricing emits `Product +
+ *     AggregateOffer` together);
+ *   - `null` / `undefined` when the section has no contribution for
+ *     the current state (e.g. an empty FAQ list);
+ *   - an empty array (semantically equivalent to `null`; the renderer
+ *     short-circuits both).
+ */
+export type WebsiteStructuredDataReturn = WebsiteStructuredDataPayload | readonly WebsiteStructuredDataPayload[] | null | undefined;
+/** @wildo_source:part:end saas.website.structured-data.payload-shape */
+//# sourceMappingURL=website-structured-data.shared.schemas.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+/** @wildo_source:part:end saas.website.structured-data.payload-shape */
+//# sourceMappingURL=website-structured-data.shared.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"website-structured-data.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/schemas/structured-data/website-structured-data.shared.schemas.ts"],"names":[],"mappings":"AA6DA,wEAAwE","sourcesContent":["/**\n * @wildo_source:part:start saas.website.structured-data.payload-shape facet:layer:shared facet:family:website\n *\n * `WebsiteStructuredDataPayload` — the runtime JSON-LD object shape returned\n * by a section's `getStructuredData()` and serialized into one\n * `<script type=\"application/ld+json\">` block per payload.\n *\n * **Layering note** — the payload type is defined HERE (in the\n * website runtime) rather than imported from the specification package because\n * runtime rendering must remain independent from companion semantics. The\n * application's Schema.org catalog describes the same vocabulary (per-`@type`\n * required / optional / deprecated fields); the two contracts are structurally\n * compatible by design but independently owned.\n *\n * **Authoring contract**:\n *\n * - `@type` REQUIRED — the Schema.org entity kind (`'Article'`,\n *   `'BlogPosting'`, `'FAQPage'`, …). Typed as a free-form `string`\n *   here (not a closed enum) so app-side catalog extensions\n *   (e.g. `'SoftwareApplication'`, custom Schema.org-extension\n *   `@type`s) are emittable without a saas-website release. The\n *   companion's catalog reconciliation surface validates the\n *   `@type` value against the merged engine + app catalog.\n * - `@id?` OPTIONAL — a stable URI identifying the entity. Used for\n *   cross-referencing on the same page (e.g. `Article.publisher`\n *   referencing the page-level `Organization` via `@id`). The\n *   renderer uses `@id` for deduplication: two payloads with the\n *   same `@id` collapse into one emitted block (last-wins).\n * - `@context?` OPTIONAL — the JSON-LD vocabulary URL. The renderer\n *   auto-injects `'https://schema.org'` when omitted; the field is\n *   exposed so consumers CAN override (Schema.org payload extended\n *   with a custom vocabulary).\n * - All other fields are pass-through `unknown` — the catalog\n *   describes the FIELD NAMES per `@type`; the per-field SHAPE\n *   (e.g. `Article.author` is a `Person | Organization`) is locked\n *   at the section's payload-builder TS-side.\n */\nexport interface WebsiteStructuredDataPayload {\n  '@type': string;\n  '@id'?: string;\n  '@context'?: string | Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n/**\n * Convenience union for `getStructuredData()` return types.\n *\n * A section may emit:\n *   - a single payload (most common — `FAQPage` for an FAQ section);\n *   - a fixed-length tuple of payloads (e.g. pricing emits `Product +\n *     AggregateOffer` together);\n *   - `null` / `undefined` when the section has no contribution for\n *     the current state (e.g. an empty FAQ list);\n *   - an empty array (semantically equivalent to `null`; the renderer\n *     short-circuits both).\n */\nexport type WebsiteStructuredDataReturn =\n  | WebsiteStructuredDataPayload\n  | readonly WebsiteStructuredDataPayload[]\n  | null\n  | undefined;\n/** @wildo_source:part:end saas.website.structured-data.payload-shape */\n"]}

package/dist/esm/schemas/validators/label-pack.validator.d.ts

@@ -0,0 +1,144 @@
+import type { WebsiteLabelKey } from '../label-keys/website-label-key.schemas';
+import type { WebsitePageManifest } from '../manifests/website-page-manifest.shared.schemas';
+import type { WebsiteSectionRef } from '../refs/section-ref.schemas';
+/**
+ * @wildo_source:part:start saas.website.label-pack.validator facet:layer:shared facet:family:website
+ *
+ * `LabelPack` — flat string→string map keyed by fully-composed
+ * `WebsiteLabelKey` (e.g. `"website.landing.hero.headline"` →
+ * `"Welcome to Wonder Todos"`). One pack per locale, loaded by the
+ * Astro adapter in Phase 5 from `website/src/i18n/<locale>.json`.
+ *
+ * Stored as a plain `Record<string, string>` rather than
+ * `Record<WebsiteLabelKey, string>` because runtime JSON parses to
+ * `Record<string, string>` and re-branding every key on load would
+ * cost O(N) parses per label-pack with no observable benefit (the
+ * validator below validates the keys against the manifest contract,
+ * which is the only meaningful guarantee).
+ */
+export type LabelPack = Record<string, string>;
+/**
+ * Map from a section's `WebsiteSectionRef` to the fully-composed label
+ * keys that section's `defineWebsiteSection({ expectedLabelKeys })`
+ * declared. Built either:
+ *   - **statically** at the site-config level (consumer hands the
+ *     validator a literal map collected from imported sections), or
+ *   - **at build time** by the Phase 5 collector
+ *     (`collect-expected-label-keys.ts`) walking every manifest's
+ *     `pageComponent` to discover the `defineWebsiteSection` calls
+ *     it composes.
+ *
+ * The validator itself is build-source-agnostic — it validates whatever
+ * map it is given against the manifest registry.
+ */
+export type ExpectedLabelKeysBySectionRef = Map<WebsiteSectionRef, readonly WebsiteLabelKey[]>;
+/**
+ * Output of `validateLabelPackAgainstManifest`. Three flat lists, no
+ * grouping by page/section because the diagnostics CLI / build-time
+ * reporter wants a single sorted list per failure category.
+ *
+ * **Type-precision rationale** for the three lists:
+ *
+ * - `missing` is `WebsiteLabelKey[]`: every entry was originally declared
+ *   in a section's `expectedLabelKeys`, which means it has already been
+ *   parsed through `WebsiteLabelKeySchema` at section-definition time —
+ *   the brand carries here legitimately.
+ * - `orphaned` is `string[]`: entries come from `Object.keys(pack)`,
+ *   i.e. arbitrary keys present in the loaded JSON. They have NOT been
+ *   parsed through `WebsiteLabelKeySchema` (in fact, malformed pack
+ *   keys are a common cause of orphans — typos, prefix mistakes,
+ *   missing segments). Branding these would be a type-system lie that
+ *   would let downstream code feed an orphan key into a
+ *   `WebsiteLabelKey`-typed API and blow up at runtime.
+ * - `unmappedSectionRefs` is `WebsiteSectionRef[]`: entries come from
+ *   `manifest.sectionRefs`, which were already parsed through
+ *   `WebsiteSectionRefSchema`.
+ */
+export interface LabelPackValidationResult {
+    /**
+     * Keys the manifest commits to (declared in any section's
+     * `expectedLabelKeys`) but absent from the provided pack. A non-empty
+     * `missing` list is a HARD ERROR — the build MUST fail.
+     */
+    missing: WebsiteLabelKey[];
+    /**
+     * Raw pack keys NOT declared by any section in any manifest. A
+     * non-empty `orphaned` list is a SOFT WARNING — orphaned keys are
+     * usually stale entries left behind by a section rename or deletion,
+     * and surfacing them eagerly keeps the pack lean. The build does NOT
+     * fail on orphaned keys (a consumer might author keys for a section
+     * they haven't shipped yet).
+     *
+     * Typed `string[]` (NOT `WebsiteLabelKey[]`) because pack keys
+     * have not been validated against `WebsiteLabelKeySchema`.
+     */
+    orphaned: string[];
+    /**
+     * Sections referenced by a manifest's `sectionRefs[]` whose
+     * `expectedLabelKeys` could not be resolved (the section was missing
+     * from the `expectedKeysBySectionRef` map). This is a build-pipeline
+     * configuration bug (the collector failed to discover the section's
+     * `defineWebsiteSection` call) — distinct from `missing`, which is a
+     * content authoring bug.
+     */
+    unmappedSectionRefs: WebsiteSectionRef[];
+}
+/**
+ * Pure label-pack validator. Cross-references the keys declared by
+ * every section across every page manifest against the keys present
+ * in the supplied pack.
+ *
+ * **Algorithm**:
+ *   1. Walk every manifest's `sectionRefs` and look up
+ *      `expectedKeysBySectionRef.get(sectionRef)`. Sections whose ref
+ *      appears in a manifest but is missing from the map are
+ *      surfaced as a separate diagnostic (`unmappedSectionRefs`); the
+ *      validator does NOT silently treat an unmapped section as
+ *      "no expected keys".
+ *   2. Add every page's `metaLabelKeys.titleKey` and
+ *      `metaLabelKeys.descriptionKey` to the expected set (these are
+ *      page-level keys, not section-scoped).
+ *   3. `missing` = expected ∖ pack-keys.
+ *   4. `orphaned` = pack-keys ∖ expected.
+ *   5. Both lists are sorted lexicographically for deterministic
+ *      diagnostic output.
+ *
+ * **Why `unmappedSectionRefs` is a third bucket** (not folded into
+ * `missing`): "I don't know what keys this section needs" is a
+ * different failure mode from "I know the section needs `headline`
+ * and you didn't provide it". The first is a build-pipeline
+ * configuration bug (the collector didn't see the section); the
+ * second is a content authoring bug. Keeping them distinct makes the
+ * diagnostic actionable.
+ *
+ * **Pure / no I/O**: the validator does not read files, does not boot
+ * React, does not require Astro. It accepts already-parsed data
+ * structures and returns a result object. This keeps it usable from:
+ *   - the Astro build hook (Phase 5),
+ *   - the `wildo website audit` CLI (Phase 7),
+ *   - companion subprocesses,
+ *   - unit tests.
+ *
+ * @param manifests Every `WebsitePageManifest` registered on the site.
+ *                  Typically `WebsiteRootConfig.pageManifests`.
+ * @param expectedKeysBySectionRef Map from sectionRef to the fully-
+ *                                  composed keys that section commits to.
+ * @param pack The locale's loaded label pack.
+ * @param chromeLabelKeys OPTIONAL. The fully-composed keys read by
+ *                        site-wide chrome (header / footer / any slot
+ *                        rendered outside a section context). Declared
+ *                        on `WebsiteRootConfig.chromeLabelKeys` because
+ *                        chrome cannot register `expectedLabelKeys` via
+ *                        `defineWebsiteSection` (it lives outside the
+ *                        page+section context). Without this list, every
+ *                        `website.chrome.*` entry would surface as an
+ *                        orphan warning on every build. Defaults to `[]`
+ *                        — sites with no chrome label reads omit the
+ *                        argument entirely.
+ * @returns `LabelPackValidationResult` with three diagnostic buckets:
+ *          `missing` (hard error), `orphaned` (soft warning), and
+ *          `unmappedSectionRefs` (build-pipeline configuration bug).
+ */
+export declare function validateLabelPackAgainstManifest(manifests: readonly WebsitePageManifest[], expectedKeysBySectionRef: ExpectedLabelKeysBySectionRef, pack: LabelPack, chromeLabelKeys?: readonly WebsiteLabelKey[]): LabelPackValidationResult;
+/** @wildo_source:part:end saas.website.label-pack.validator */
+//# sourceMappingURL=label-pack.validator.d.ts.map

package/dist/esm/schemas/validators/label-pack.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-pack.validator.d.ts","sourceRoot":"","sources":["../../../../../src/schemas/validators/label-pack.validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,6BAA6B,GAAG,GAAG,CAAC,iBAAiB,EAAE,SAAS,eAAe,EAAE,CAAC,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;OAOG;IACH,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,wBAAwB,EAAE,6BAA6B,EACvD,IAAI,EAAE,SAAS,EACf,eAAe,GAAE,SAAS,eAAe,EAAO,GAC/C,yBAAyB,CAiD3B;AACD,+DAA+D"}