@duffcloudservices/cms 0.13.2 → 0.13.4

package/dist/seo/index.d.ts

@@ -1,9 +1,9 @@
-import { H as HeadMetaTag, l as HeadLinkTag } from '../installSeoHead-EE0Z7UmK.js';
-export { m as HeadScriptTag, o as HeadTagOverrides, I as InstallSeoHeadOptions, R as ResolvedHeadTags, B as SEO_HEAD_ROUTE_HAS_NO_META, q as SeoHeadClientLike, t as SeoHeadEntryLike, u as SeoHeadInput, v as SeoHeadPageRoute, w as SeoHeadPagesManifest, x as SeoHeadResolution, y as SeoHeadResolutionReason, C as SeoHeadRouteHasNoMeta, p as SeoHeadRouteLike, S as SeoHeadRouterLike, b as buildHeadTags, k as buildSeoHeadRouteMap, f as escapeJsonLd, z as findDuplicateNormalizedPaths, A as formatDuplicateNormalizedPaths, g as generateJsonLd, a as generateOpenGraphMeta, c as generateTwitterMeta, j as installSeoHead, h as isManagedLinkRel, i as isManagedMetaTag, n as normalizeSeoHeadPath, d as renderHeadTags, r as resolvePageSeo, s as spliceHeadHtml, e as stripManagedHeadTags } from '../installSeoHead-EE0Z7UmK.js';
-import { Z as PageRouteEntry } from '../vitepressTransform-Ds5Hff8t.js';
-export { A as AI_BOTS, y as BlogMeta, x as BreadcrumbCrumb, v as BuildLlmsParams, u as BuildRobotsParams, B as BuildSitemapParams, E as ContentConfig, C as CreateSeoTransformPageDataOptions, D as DcsRobotsOptions, F as FaqSource, ad as NormalisedFaq, ac as NormalisedReview, R as ResolvedPageOverrides, ae as ReviewSchemaParts, z as ReviewSource, a2 as RouteEmissionRules, a3 as RouteExclusionReason, w as SchemaObject, S as SeoPageContext, r as SeoPageTypeRule, t as VitePressHeadConfig, V as VitePressPageData, q as absolutizeUrl, j as breadcrumbTrailFromRoute, k as buildBlogPosting, h as buildBreadcrumbList, l as buildFaqPage, g as buildGlobalGraph, a4 as buildHasCredential, f as buildLlmsTxt, m as buildReviewSchemaParts, e as buildRobotsTxt, a as buildSitemapXml, b as buildVitePressSeoHead, c as createSeoTransformPageData, d as defaultRelativePathToRoute, a9 as deriveSameAs, o as filterRealFaq, n as filterRealReviews, a8 as findBusinessLicense, a6 as findGlobalSchemasOfType, a5 as findLocalBusinessSchema, p as findReviewItemsForPage, a7 as graphAbsorbs, aa as graphIds, ab as isLocalBusinessType, a0 as isRouteEmitted, i as isRouteIndexable, _ as loadPagesManifest, $ as parsePagesManifest, a1 as routeExclusionReason, s as slugToTitle } from '../vitepressTransform-Ds5Hff8t.js';
-import { a as HeadObservation } from '../headHonesty-OzxvLuwd.js';
-export { B as BakedHead, g as HeadHonestyError, l as HeadHonestyExecution, k as HeadHonestyNotRunError, p as HeadHonestyOptions, o as HeadHonestyViolation, H as HonestyMode, m as HonestyModeInput, b as assertHeadHonesty, h as assertHeadHonestyExecuted, d as decodeHtmlEntities, e as extractBakedHead, i as findHeadHonestyExecutionFaults, f as findHeadHonestyViolations, j as formatHeadHonestyExecutionReport, c as formatHeadHonestyReport, n as normalizeHeadText, r as resolveHonestyMode } from '../headHonesty-OzxvLuwd.js';
+import { H as HeadMetaTag, l as HeadLinkTag } from '../installSeoHead-CuVdVCis.js';
+export { m as HeadScriptTag, o as HeadTagOverrides, I as InstallSeoHeadOptions, R as ResolvedHeadTags, B as SEO_HEAD_ROUTE_HAS_NO_META, q as SeoHeadClientLike, t as SeoHeadEntryLike, u as SeoHeadInput, v as SeoHeadPageRoute, w as SeoHeadPagesManifest, x as SeoHeadResolution, y as SeoHeadResolutionReason, C as SeoHeadRouteHasNoMeta, p as SeoHeadRouteLike, S as SeoHeadRouterLike, b as buildHeadTags, k as buildSeoHeadRouteMap, f as escapeJsonLd, z as findDuplicateNormalizedPaths, A as formatDuplicateNormalizedPaths, g as generateJsonLd, a as generateOpenGraphMeta, c as generateTwitterMeta, j as installSeoHead, h as isManagedLinkRel, i as isManagedMetaTag, n as normalizeSeoHeadPath, d as renderHeadTags, r as resolvePageSeo, s as spliceHeadHtml, e as stripManagedHeadTags } from '../installSeoHead-CuVdVCis.js';
+import { Z as PageRouteEntry } from '../vitepressTransform-CZ_IB3dq.js';
+export { A as AI_BOTS, y as BlogMeta, x as BreadcrumbCrumb, v as BuildLlmsParams, u as BuildRobotsParams, B as BuildSitemapParams, E as ContentConfig, C as CreateSeoTransformPageDataOptions, D as DcsRobotsOptions, F as FaqSource, ag as NormalisedFaq, af as NormalisedReview, ai as PostalAddressGap, ab as REQUIRED_POSTAL_ADDRESS_FIELDS, R as ResolvedPageOverrides, ah as ReviewSchemaParts, z as ReviewSource, a2 as RouteEmissionRules, a3 as RouteExclusionReason, w as SchemaObject, S as SeoPageContext, r as SeoPageTypeRule, t as VitePressHeadConfig, V as VitePressPageData, q as absolutizeUrl, j as breadcrumbTrailFromRoute, k as buildBlogPosting, h as buildBreadcrumbList, l as buildFaqPage, g as buildGlobalGraph, a4 as buildHasCredential, f as buildLlmsTxt, m as buildReviewSchemaParts, e as buildRobotsTxt, a as buildSitemapXml, b as buildVitePressSeoHead, c as createSeoTransformPageData, d as defaultRelativePathToRoute, ac as deriveSameAs, o as filterRealFaq, n as filterRealReviews, a8 as findBusinessLicense, a6 as findGlobalSchemasOfType, a5 as findLocalBusinessSchema, a9 as findPostalAddressGaps, p as findReviewItemsForPage, aa as formatPostalAddressGapReport, a7 as graphAbsorbs, ad as graphIds, ae as isLocalBusinessType, a0 as isRouteEmitted, i as isRouteIndexable, _ as loadPagesManifest, $ as parsePagesManifest, a1 as routeExclusionReason, s as slugToTitle } from '../vitepressTransform-CZ_IB3dq.js';
+import { a as HeadObservation, H as HonestyMode } from '../headHonesty-OzxvLuwd.js';
+export { B as BakedHead, g as HeadHonestyError, l as HeadHonestyExecution, k as HeadHonestyNotRunError, p as HeadHonestyOptions, o as HeadHonestyViolation, m as HonestyModeInput, b as assertHeadHonesty, h as assertHeadHonestyExecuted, d as decodeHtmlEntities, e as extractBakedHead, i as findHeadHonestyExecutionFaults, f as findHeadHonestyViolations, j as formatHeadHonestyExecutionReport, c as formatHeadHonestyReport, n as normalizeHeadText, r as resolveHonestyMode } from '../headHonesty-OzxvLuwd.js';
 import 'vue';
 
 /**
@@ -344,6 +344,131 @@ interface BodyPrerenderEnableInput {
  */
 declare function isBodyPrerenderEnabled(input: BodyPrerenderEnableInput): boolean;
 
+/**
+ * FAQ body-honesty rail — a `FAQPage` node must describe copy the page RENDERS.
+ *
+ * ## The defect class
+ *
+ * `buildFaqPage` (`./schemaGraph.ts`) emits a `FAQPage` from any well-formed
+ * `{q,a}` pair it finds in `.dcs/content.yaml`. That gate enforces the SHAPE of
+ * the honesty rule (no invented Q&A) but it cannot enforce its SUBSTANCE: the
+ * builder is pure and has no idea whether the page it decorates renders those
+ * questions anywhere a human — or a crawler — can see them. Seeding
+ * `pages.<slug>.faq` without also rendering a visible FAQ section therefore
+ * ships structured data for content that does not exist on the page. Google's
+ * FAQPage guidance requires the Q&A be visible to the user; markup for invisible
+ * content is a spam signal, and it is the exact fabrication class the rest of
+ * this module tree exists to prevent.
+ *
+ * Measured origin: the 2026-08-30 Iron Oak drafting pass
+ * (`.docs/analysis/iron-oak-seo-drafts-2026-08-30.md` §3, "The honesty condition
+ * on all of the above") — Iron Oak has Q&A-shaped copy and no FAQ section, so
+ * applying the FAQPage finding as a one-step content seed would have produced
+ * exactly this defect on a live customer site.
+ *
+ * ## The rail
+ *
+ * Given an emitted document, take every `Question.name` out of every `FAQPage`
+ * JSON-LD node and require each one to appear in the PRERENDERED BODY TEXT.
+ *
+ * ## The vacuity trap this rail is built around
+ *
+ * The question text is, by construction, already present in the document — it is
+ * sitting in the `<script type="application/ld+json">` block being audited.
+ * `dcsSeoPlugin` bakes that block into `<head>`, which `extractPrerenderedBodyText`
+ * never reads, but not every emitter does (vite-ssg and hand-rolled prerenders
+ * put JSON-LD in the body), and a body extractor that keeps `<script>` content
+ * would then find every question in every document — green against a site with
+ * no FAQ section at all. `extractPrerenderedBodyText` therefore strips
+ * `<script>`, `<style>`, `<noscript>` and comments CONTENT-AND-ALL, and
+ * `faqBodyHonesty.test.ts` exercises the body-placed case explicitly.
+ */
+
+/** One emitted document to audit. */
+interface FaqBodyObservation {
+    /** Route path as it appears in `pages.yaml` (e.g. `/` or `/services`). */
+    route: string;
+    /** The emitted HTML for that route, exactly as written to `dist/`. */
+    html: string;
+}
+/** A `FAQPage` question with no counterpart in the rendered body. */
+interface FaqBodyViolation {
+    route: string;
+    /** The `Question.name` verbatim, as authored in the JSON-LD. */
+    question: string;
+    /** How many questions that document's FAQPage node(s) declared in total. */
+    questionCount: number;
+}
+/** Configuration for the rail. */
+interface FaqBodyHonestyOptions {
+    /**
+     * Route paths exempted from the comparison. An exemption is still the caller's
+     * to LOG — same contract as `HeadHonestyOptions.allow`.
+     */
+    allow?: string[];
+}
+/**
+ * Normalise a string for PRESENCE comparison (is this text on the page?), which
+ * is a weaker question than head honesty's IDENTITY comparison and so normalises
+ * more:
+ *   - HTML entities decoded (`&amp;` ⇒ `&`) — the two sides are escaped
+ *     differently: JSON-LD escapes for JSON, body copy escapes for HTML.
+ *   - typographic look-alikes folded to ASCII (`’ ‘ “ ” — –` ⇒ `' ' " " - -`) —
+ *     the schema string and the rendered string come from the SAME content key
+ *     but the rendered one may pass through a typography transform. A rail that
+ *     reds because a renderer curled an apostrophe is an accusation, not a find.
+ *   - whitespace collapsed — rendered copy is wrapped and indented.
+ *   - lowercased — a question rendered as a title-cased heading is still visible.
+ *
+ * Deliberately NOT normalised: words. Nothing is stemmed, dropped or fuzzy-
+ * matched, so a "close enough" body text does not satisfy the rail.
+ */
+declare function normalizeForPresence(value: string): string;
+/**
+ * Collect every `Question.name` declared by every `FAQPage` node in a document.
+ *
+ * Unparseable JSON-LD is SKIPPED, not reported — `cli/seo-coverage-audit.mjs`
+ * already fails a route for unparseable structured data, and this rail must not
+ * double-report someone else's finding as an FAQ defect.
+ */
+declare function extractFaqQuestions(html: string): string[];
+/**
+ * The visible text of the PRERENDERED BODY — what a non-JS crawler receives.
+ *
+ * `<script>`, `<style>`, `<noscript>` and HTML comments are removed CONTENT AND
+ * ALL before tags are stripped. That is not tidiness: the JSON-LD under audit
+ * lives in a `<script>`, so leaving script content in would make every question
+ * trivially "present" and the rail vacuous (see the module header).
+ *
+ * Returns `''` when there is no `<body>` — an SPA shell with no prerendered body
+ * has no visible copy, which is the honest answer, not a parse failure.
+ */
+declare function extractPrerenderedBodyText(html: string): string;
+/**
+ * Report every `FAQPage` question that the route's prerendered body does not
+ * render. A document with no `FAQPage` node yields nothing — the rail is about
+ * schema that over-claims, never about pages that decline to have an FAQ.
+ */
+declare function findFaqBodyHonestyViolations(observations: FaqBodyObservation[], options?: FaqBodyHonestyOptions): FaqBodyViolation[];
+/**
+ * Render the full report. Names the route, the question, and the fix — both
+ * halves of the fix, because deleting the schema and rendering the section are
+ * both valid resolutions and the operator picks.
+ */
+declare function formatFaqBodyHonestyReport(violations: FaqBodyViolation[]): string;
+/** Thrown in `error` mode so the build goes red on invisible FAQ markup. */
+declare class FaqBodyHonestyError extends Error {
+    readonly violations: FaqBodyViolation[];
+    constructor(violations: FaqBodyViolation[]);
+}
+/**
+ * Enforce the rail. `error` throws, `warn` logs, `off` does nothing.
+ * Mirrors `assertHeadHonesty` so the three-mode contract is uniform across rails.
+ */
+declare function assertFaqBodyHonesty(observations: FaqBodyObservation[], options?: FaqBodyHonestyOptions & {
+    mode?: HonestyMode;
+}): FaqBodyViolation[];
+
 /**
  * THE HEAD-AUTHORITY CONTRACT (C-356) — a source-level audit.
  *
@@ -1045,4 +1170,4 @@ declare class CharsetBudgetError extends Error {
  */
 declare function formatCharsetHeadroomWarning(file: string, result: CharsetBudgetResult, warnBelow?: number): string | null;
 
-export { type BodyPrerenderEnableInput, BodyPrerenderError, CANONICAL_CHARSET_META, CHARSET_BUDGET_BYTES, CHARSET_HEADROOM_WARN_BYTES, CharsetBudgetError, type CharsetBudgetResult, type ClassifiedUrl, type EmittedUrl, type EmittedUrlAudit, EmittedUrlError, EmittedUrlNotRunError, type EmittedUrlViolation, type EmittedUrlWarning, type FilteredRoute, type ForeignWriterSite, HeadContractError, type HeadContractExemptionAudit, type HeadContractExemptionCheck, type HeadContractExemptionExpectation, type HeadContractExemptionRecord, type HeadContractExemptionValue, type HeadContractExemptionVerdict, type HeadContractHostProbe, type HeadContractInput, type HeadContractMode, type HeadContractReport, type HeadContractSeoConfig, type HeadContractSourceFile, type HeadContractViolation, type HeadContractViolationCode, type HeadContractWarning, type HeadContractWarningCode, HeadLinkTag, HeadMetaTag, HeadObservation, MIN_EXEMPTION_REASON_LENGTH, PageRouteEntry, type PrerenderBodiesParams, type PrerenderBodiesResult, type PrerenderFilterReason, type RemoteCheckOptions, type RemoteCheckResult, type RenderedHead, type RenderedRoute, type RouteRenderer, type SameOriginAuditResult, type UrlExpectation, type UrlLocality, assertHeadContract, auditCheckedTotal, auditExemptionHosts, auditHeadContract, auditSameOriginAssets, blankComments, checkCharsetBudget, checkRemoteAssets, checkSameOriginAssets, classifyUrl, collectUrlsFromHtml, collectUrlsFromLlmsTxt, collectUrlsFromSitemap, dedupeUrls, findCharsetByteOffset, formatCharsetHeadroomWarning, formatEmittedUrlAudit, formatEmittedUrlReport, formatExemptionAudit, formatHeadContractReport, headInputIdentities, hoistCharsetMeta, hostsNamedIn, isBodyPrerenderEnabled, normalizeExemption, parseHostProbeHtml, prerenderBodies, routeToOutputFile, snapshotBakedManagedHeadTags, spliceBodyHtml, sweepBakedManagedHeadTags };
+export { type BodyPrerenderEnableInput, BodyPrerenderError, CANONICAL_CHARSET_META, CHARSET_BUDGET_BYTES, CHARSET_HEADROOM_WARN_BYTES, CharsetBudgetError, type CharsetBudgetResult, type ClassifiedUrl, type EmittedUrl, type EmittedUrlAudit, EmittedUrlError, EmittedUrlNotRunError, type EmittedUrlViolation, type EmittedUrlWarning, FaqBodyHonestyError, type FaqBodyHonestyOptions, type FaqBodyObservation, type FaqBodyViolation, type FilteredRoute, type ForeignWriterSite, HeadContractError, type HeadContractExemptionAudit, type HeadContractExemptionCheck, type HeadContractExemptionExpectation, type HeadContractExemptionRecord, type HeadContractExemptionValue, type HeadContractExemptionVerdict, type HeadContractHostProbe, type HeadContractInput, type HeadContractMode, type HeadContractReport, type HeadContractSeoConfig, type HeadContractSourceFile, type HeadContractViolation, type HeadContractViolationCode, type HeadContractWarning, type HeadContractWarningCode, HeadLinkTag, HeadMetaTag, HeadObservation, HonestyMode, MIN_EXEMPTION_REASON_LENGTH, PageRouteEntry, type PrerenderBodiesParams, type PrerenderBodiesResult, type PrerenderFilterReason, type RemoteCheckOptions, type RemoteCheckResult, type RenderedHead, type RenderedRoute, type RouteRenderer, type SameOriginAuditResult, type UrlExpectation, type UrlLocality, assertFaqBodyHonesty, assertHeadContract, auditCheckedTotal, auditExemptionHosts, auditHeadContract, auditSameOriginAssets, blankComments, checkCharsetBudget, checkRemoteAssets, checkSameOriginAssets, classifyUrl, collectUrlsFromHtml, collectUrlsFromLlmsTxt, collectUrlsFromSitemap, dedupeUrls, extractFaqQuestions, extractPrerenderedBodyText, findCharsetByteOffset, findFaqBodyHonestyViolations, formatCharsetHeadroomWarning, formatEmittedUrlAudit, formatEmittedUrlReport, formatExemptionAudit, formatFaqBodyHonestyReport, formatHeadContractReport, headInputIdentities, hoistCharsetMeta, hostsNamedIn, isBodyPrerenderEnabled, normalizeExemption, normalizeForPresence, parseHostProbeHtml, prerenderBodies, routeToOutputFile, snapshotBakedManagedHeadTags, spliceBodyHtml, sweepBakedManagedHeadTags };

package/dist/seo/index.js

@@ -1,4 +1,4 @@
-export { HeadContractError, MIN_EXEMPTION_REASON_LENGTH, assertHeadContract, auditExemptionHosts, auditHeadContract, blankComments, formatExemptionAudit, formatHeadContractReport, hostsNamedIn, normalizeExemption, parseHostProbeHtml } from '../chunk-OGAJX4KM.js';
-export { AI_BOTS, BodyPrerenderError, CANONICAL_CHARSET_META, CHARSET_BUDGET_BYTES, CHARSET_HEADROOM_WARN_BYTES, CharsetBudgetError, EmittedUrlError, EmittedUrlNotRunError, HeadHonestyError, HeadHonestyNotRunError, SEO_HEAD_ROUTE_HAS_NO_META, absolutizeUrl, assertHeadHonesty, assertHeadHonestyExecuted, auditCheckedTotal, auditSameOriginAssets, breadcrumbTrailFromRoute, buildBlogPosting, buildBreadcrumbList, buildFaqPage, buildGlobalGraph, buildHasCredential, buildHeadTags, buildLlmsTxt, buildReviewSchemaParts, buildRobotsTxt, buildSeoHeadRouteMap, buildSitemapXml, buildVitePressSeoHead, checkCharsetBudget, checkRemoteAssets, checkSameOriginAssets, classifyUrl, collectUrlsFromHtml, collectUrlsFromLlmsTxt, collectUrlsFromSitemap, createSeoTransformPageData, decodeHtmlEntities, dedupeUrls, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, extractBakedHead, filterRealFaq, filterRealReviews, findBusinessLicense, findCharsetByteOffset, findDuplicateNormalizedPaths, findGlobalSchemasOfType, findHeadHonestyExecutionFaults, findHeadHonestyViolations, findLocalBusinessSchema, findReviewItemsForPage, formatCharsetHeadroomWarning, formatDuplicateNormalizedPaths, formatEmittedUrlAudit, formatEmittedUrlReport, formatHeadHonestyExecutionReport, formatHeadHonestyReport, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, graphAbsorbs, graphIds, headInputIdentities, hoistCharsetMeta, installSeoHead, isBodyPrerenderEnabled, isLocalBusinessType, isManagedLinkRel, isManagedMetaTag, isRouteEmitted, isRouteIndexable, loadPagesManifest, normalizeHeadText, normalizeSeoHeadPath, parsePagesManifest, prerenderBodies, renderHeadTags, resolveHonestyMode, resolvePageSeo, routeExclusionReason, routeToOutputFile, slugToTitle, snapshotBakedManagedHeadTags, spliceBodyHtml, spliceHeadHtml, stripManagedHeadTags, sweepBakedManagedHeadTags } from '../chunk-64BUBTW7.js';
+export { FaqBodyHonestyError, HeadContractError, MIN_EXEMPTION_REASON_LENGTH, assertFaqBodyHonesty, assertHeadContract, auditExemptionHosts, auditHeadContract, blankComments, extractFaqQuestions, extractPrerenderedBodyText, findFaqBodyHonestyViolations, formatExemptionAudit, formatFaqBodyHonestyReport, formatHeadContractReport, hostsNamedIn, normalizeExemption, normalizeForPresence, parseHostProbeHtml } from '../chunk-GBHJVHXR.js';
+export { AI_BOTS, BodyPrerenderError, CANONICAL_CHARSET_META, CHARSET_BUDGET_BYTES, CHARSET_HEADROOM_WARN_BYTES, CharsetBudgetError, EmittedUrlError, EmittedUrlNotRunError, HeadHonestyError, HeadHonestyNotRunError, REQUIRED_POSTAL_ADDRESS_FIELDS, SEO_HEAD_ROUTE_HAS_NO_META, absolutizeUrl, assertHeadHonesty, assertHeadHonestyExecuted, auditCheckedTotal, auditSameOriginAssets, breadcrumbTrailFromRoute, buildBlogPosting, buildBreadcrumbList, buildFaqPage, buildGlobalGraph, buildHasCredential, buildHeadTags, buildLlmsTxt, buildReviewSchemaParts, buildRobotsTxt, buildSeoHeadRouteMap, buildSitemapXml, buildVitePressSeoHead, checkCharsetBudget, checkRemoteAssets, checkSameOriginAssets, classifyUrl, collectUrlsFromHtml, collectUrlsFromLlmsTxt, collectUrlsFromSitemap, createSeoTransformPageData, decodeHtmlEntities, dedupeUrls, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, extractBakedHead, filterRealFaq, filterRealReviews, findBusinessLicense, findCharsetByteOffset, findDuplicateNormalizedPaths, findGlobalSchemasOfType, findHeadHonestyExecutionFaults, findHeadHonestyViolations, findLocalBusinessSchema, findPostalAddressGaps, findReviewItemsForPage, formatCharsetHeadroomWarning, formatDuplicateNormalizedPaths, formatEmittedUrlAudit, formatEmittedUrlReport, formatHeadHonestyExecutionReport, formatHeadHonestyReport, formatPostalAddressGapReport, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, graphAbsorbs, graphIds, headInputIdentities, hoistCharsetMeta, installSeoHead, isBodyPrerenderEnabled, isLocalBusinessType, isManagedLinkRel, isManagedMetaTag, isRouteEmitted, isRouteIndexable, loadPagesManifest, normalizeHeadText, normalizeSeoHeadPath, parsePagesManifest, prerenderBodies, renderHeadTags, resolveHonestyMode, resolvePageSeo, routeExclusionReason, routeToOutputFile, slugToTitle, snapshotBakedManagedHeadTags, spliceBodyHtml, spliceHeadHtml, stripManagedHeadTags, sweepBakedManagedHeadTags } from '../chunk-W5Q6SOAP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{vitepressTransform-Ds5Hff8t.d.ts → vitepressTransform-CZ_IB3dq.d.ts}

@@ -420,6 +420,52 @@ declare function findLocalBusinessSchema(global: GlobalSeoConfig): {
     schema: SeoSchemaConfig;
     index: number;
 } | null;
+/**
+ * The `PostalAddress` fields that together make a NAP a real, mappable address.
+ * Order is the order a human writes one, which is the order the warning prints.
+ */
+declare const REQUIRED_POSTAL_ADDRESS_FIELDS: readonly ["streetAddress", "addressLocality", "addressRegion", "postalCode", "addressCountry"];
+/** A LocalBusiness node that CLAIMS an address but does not finish it. */
+interface PostalAddressGap {
+    /** The LocalBusiness `@type` as authored (e.g. `HomeAndConstructionBusiness`). */
+    businessType: string;
+    /** Required fields absent or blank, in `REQUIRED_POSTAL_ADDRESS_FIELDS` order. */
+    missing: string[];
+    /** Required fields actually supplied — what makes the node look answered. */
+    present: string[];
+}
+/**
+ * Report a LocalBusiness `address` that is PRESENT BUT PARTIAL.
+ *
+ * `buildGlobalGraph` spreads the hand-authored node's properties verbatim
+ * (`...props`), so a `PostalAddress` carrying only a locality and a region ships
+ * to crawlers exactly as authored, with nothing anywhere saying it is half an
+ * address. Google matches a LocalBusiness to a place using the NAP; a partial
+ * address is the shape that silently fails that match while every audit that
+ * only asks "is there an address node?" stays green.
+ *
+ * ## Why an ABSENT address is not reported
+ *
+ * A service-area business (a contractor working out of a home, a mobile trade)
+ * is *supposed* to omit `address` — that is Google's own guidance, and several
+ * DCS fleet sites are exactly that. Warning there would be an accusation
+ * levelled at correct configuration, and a warning people learn to ignore is
+ * worth less than no warning. The defect is the CLAIM that is not finished, so
+ * the trigger is an address node that exists and is incomplete.
+ *
+ * A non-object `address` (a plain string) is also skipped: it is unstructured,
+ * not partial, and belongs to a different finding.
+ *
+ * @returns one gap per incomplete address, or `[]` when complete/absent.
+ */
+declare function findPostalAddressGaps(global: GlobalSeoConfig): PostalAddressGap[];
+/**
+ * Render the partial-address warning. Names the type, what is there, and what is
+ * not — an operator must be able to act without re-deriving the finding, and the
+ * "or drop the address entirely" branch is stated because for a service-area
+ * business that is the CORRECT fix, not a workaround.
+ */
+declare function formatPostalAddressGapReport(gaps: PostalAddressGap[]): string;
 /**
  * True when `buildGlobalGraph` provides this schema canonically, so it must NOT
  * also be emitted standalone: the LocalBusiness subtype it folds in, or a global
@@ -1144,4 +1190,4 @@ declare function buildVitePressSeoHead(pageData: VitePressPageData, options: Cre
  */
 declare function createSeoTransformPageData(options: CreateSeoTransformPageDataOptions): (pageData: VitePressPageData) => void;
 
-export { parsePagesManifest as $, AI_BOTS as A, type BuildSitemapParams as B, type CreateSeoTransformPageDataOptions as C, type DcsRobotsOptions as D, type ContentConfig as E, type FaqSource as F, type GlobalSeoConfig as G, type SeoConfiguration as H, type SeoAuthorConfig as I, type SeoSocialConfig as J, type SeoImagesConfig as K, type SeoOpenGraphConfig as L, type SeoTwitterConfig as M, type SeoSchemaConfig as N, type SeoAlternateConfig as O, type PageSeoConfig as P, type SeoVerificationConfig as Q, type ResolvedPageOverrides as R, type SeoPageContext as S, type ResolvedPageSeo as T, type UseSeoReturn as U, type VitePressPageData as V, type UseSeoConfig as W, type HeadOverrides as X, type SeoHonestyBlock as Y, type PageRouteEntry as Z, loadPagesManifest as _, buildSitemapXml as a, isRouteEmitted as a0, routeExclusionReason as a1, type RouteEmissionRules as a2, type RouteExclusionReason as a3, buildHasCredential as a4, findLocalBusinessSchema as a5, findGlobalSchemasOfType as a6, graphAbsorbs as a7, findBusinessLicense as a8, deriveSameAs as a9, graphIds as aa, isLocalBusinessType as ab, type NormalisedReview as ac, type NormalisedFaq as ad, type ReviewSchemaParts as ae, buildVitePressSeoHead as b, createSeoTransformPageData as c, defaultRelativePathToRoute as d, buildRobotsTxt as e, buildLlmsTxt as f, buildGlobalGraph as g, buildBreadcrumbList as h, isRouteIndexable as i, breadcrumbTrailFromRoute as j, buildBlogPosting as k, buildFaqPage as l, buildReviewSchemaParts as m, filterRealReviews as n, filterRealFaq as o, findReviewItemsForPage as p, absolutizeUrl as q, type SeoPageTypeRule as r, slugToTitle as s, type VitePressHeadConfig as t, type BuildRobotsParams as u, type BuildLlmsParams as v, type SchemaObject as w, type BreadcrumbCrumb as x, type BlogMeta as y, type ReviewSource as z };
+export { parsePagesManifest as $, AI_BOTS as A, type BuildSitemapParams as B, type CreateSeoTransformPageDataOptions as C, type DcsRobotsOptions as D, type ContentConfig as E, type FaqSource as F, type GlobalSeoConfig as G, type SeoConfiguration as H, type SeoAuthorConfig as I, type SeoSocialConfig as J, type SeoImagesConfig as K, type SeoOpenGraphConfig as L, type SeoTwitterConfig as M, type SeoSchemaConfig as N, type SeoAlternateConfig as O, type PageSeoConfig as P, type SeoVerificationConfig as Q, type ResolvedPageOverrides as R, type SeoPageContext as S, type ResolvedPageSeo as T, type UseSeoReturn as U, type VitePressPageData as V, type UseSeoConfig as W, type HeadOverrides as X, type SeoHonestyBlock as Y, type PageRouteEntry as Z, loadPagesManifest as _, buildSitemapXml as a, isRouteEmitted as a0, routeExclusionReason as a1, type RouteEmissionRules as a2, type RouteExclusionReason as a3, buildHasCredential as a4, findLocalBusinessSchema as a5, findGlobalSchemasOfType as a6, graphAbsorbs as a7, findBusinessLicense as a8, findPostalAddressGaps as a9, formatPostalAddressGapReport as aa, REQUIRED_POSTAL_ADDRESS_FIELDS as ab, deriveSameAs as ac, graphIds as ad, isLocalBusinessType as ae, type NormalisedReview as af, type NormalisedFaq as ag, type ReviewSchemaParts as ah, type PostalAddressGap as ai, buildVitePressSeoHead as b, createSeoTransformPageData as c, defaultRelativePathToRoute as d, buildRobotsTxt as e, buildLlmsTxt as f, buildGlobalGraph as g, buildBreadcrumbList as h, isRouteIndexable as i, breadcrumbTrailFromRoute as j, buildBlogPosting as k, buildFaqPage as l, buildReviewSchemaParts as m, filterRealReviews as n, filterRealFaq as o, findReviewItemsForPage as p, absolutizeUrl as q, type SeoPageTypeRule as r, slugToTitle as s, type VitePressHeadConfig as t, type BuildRobotsParams as u, type BuildLlmsParams as v, type SchemaObject as w, type BreadcrumbCrumb as x, type BlogMeta as y, type ReviewSource as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duffcloudservices/cms",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "Vue 3 composables and Vite plugins for DCS CMS integration",
   "type": "module",
   "exports": {
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "js-yaml": "^4.1.0",
-    "@duffcloudservices/cms-core": "0.8.2"
+    "@duffcloudservices/cms-core": "0.8.4"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",