@duffcloudservices/cms 0.13.13 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,9 @@
1
- import { H as HeadMetaTag, l as HeadLinkTag } from '../installSeoHead-CuVdVCis.js';
2
- 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';
3
- import { Z as PageRouteEntry } from '../vitepressTransform-CZ_IB3dq.js';
4
- 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';
5
- import { a as HeadObservation, H as HonestyMode } from '../headHonesty-OzxvLuwd.js';
6
- 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';
1
+ import { a as HeadMetaTag, H as HeadLinkTag } from '../installSeoHead-CcNfcxNF.js';
2
+ export { b as HeadScriptTag, c as HeadTagOverrides, I as InstallSeoHeadOptions, R as ResolvedHeadTags, z as SEO_HEAD_ROUTE_HAS_NO_META, S as SeoHeadClientLike, d as SeoHeadEntryLike, e as SeoHeadInput, f as SeoHeadPageRoute, g as SeoHeadPagesManifest, h as SeoHeadResolution, i as SeoHeadResolutionReason, A as SeoHeadRouteHasNoMeta, j as SeoHeadRouteLike, k as SeoHeadRouterLike, l as buildHeadTags, m as buildSeoHeadRouteMap, n as escapeJsonLd, B as findDuplicateNormalizedPaths, C as formatDuplicateNormalizedPaths, o as generateJsonLd, p as generateOpenGraphMeta, q as generateTwitterMeta, r as installSeoHead, s as isManagedLinkRel, t as isManagedMetaTag, u as normalizeSeoHeadPath, v as renderHeadTags, w as resolvePageSeo, x as spliceHeadHtml, y as stripManagedHeadTags } from '../installSeoHead-CcNfcxNF.js';
3
+ import { a7 as PageRouteEntry } from '../vitepressTransform-CQXBpYEC.js';
4
+ export { A as AI_BOTS, a as AI_BOT_TIERS, b as AI_TRAINING_OPT_OUT_MARKER, c as AiBotTier, B as BlogMeta, d as BreadcrumbCrumb, e as BuildLlmsParams, f as BuildRobotsParams, g as BuildSitemapParams, C as ContentConfig, h as CreateSeoTransformPageDataOptions, D as DcsRobotsOptions, F as FIRST_PARTY_REVIEW_PLATFORMS, i as FaqSource, a9 as NormalisedFaq, aa as NormalisedReview, ab as PostalAddressGap, ac as REQUIRED_POSTAL_ADDRESS_FIELDS, R as ResolvedPageOverrides, ad as ReviewSchemaParts, k as ReviewSource, l as RobotsAiTrainingConflict, m as RobotsAiTrainingConflictError, ae as RouteEmissionRules, af as RouteExclusionReason, S as SchemaObject, s as SeoPageContext, t as SeoPageTypeRule, V as VitePressHeadConfig, z as VitePressPageData, E as absolutizeUrl, I as aiTrainingBots, J as appendAiTrainingOptOut, K as breadcrumbTrailFromRoute, L as buildBlogPosting, M as buildBreadcrumbList, N as buildFaqPage, O as buildGlobalGraph, ag as buildHasCredential, Q as buildLlmsTxt, T as buildReviewSchemaParts, W as buildRobotsTxt, X as buildSitemapXml, Y as buildVitePressSeoHead, Z as createSeoTransformPageData, _ as dedupeGraphAgainstRules, $ as defaultRelativePathToRoute, ah as deriveSameAs, a0 as filterRealFaq, a1 as filterRealReviews, a2 as findAiTrainingRobotsConflicts, ai as findBusinessLicense, aj as findGlobalSchemasOfType, ak as findLocalBusinessSchema, al as findPostalAddressGaps, a3 as findReviewItemsForPage, am as formatPostalAddressGapReport, an as graphAbsorbs, ao as graphIds, a4 as isFirstPartyReviewPlatform, ap as isLocalBusinessType, aq as isRouteEmitted, a5 as isRouteIndexable, ar as loadPagesManifest, as as parsePagesManifest, at as routeExclusionReason, a6 as slugToTitle } from '../vitepressTransform-CQXBpYEC.js';
5
+ import { a as HeadObservation, H as HonestyMode } from '../headHonesty-k1IhGblP.js';
6
+ export { B as BakedHead, b as HeadHonestyError, c as HeadHonestyExecution, d as HeadHonestyNotRunError, e as HeadHonestyOptions, f as HeadHonestyViolation, g as HonestyModeInput, h as assertHeadHonesty, i as assertHeadHonestyExecuted, j as decodeHtmlEntities, k as extractBakedHead, l as findHeadHonestyExecutionFaults, m as findHeadHonestyViolations, n as formatHeadHonestyExecutionReport, o as formatHeadHonestyReport, p as normalizeHeadText, r as resolveHonestyMode } from '../headHonesty-k1IhGblP.js';
7
7
  import 'vue';
8
8
 
9
9
  /**
package/dist/seo/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { FaqBodyHonestyError, HeadContractError, MIN_EXEMPTION_REASON_LENGTH, assertFaqBodyHonesty, assertHeadContract, auditExemptionHosts, auditHeadContract, blankComments, extractFaqQuestions, extractPrerenderedBodyText, findFaqBodyHonestyViolations, formatExemptionAudit, formatFaqBodyHonestyReport, formatHeadContractReport, hostsNamedIn, normalizeExemption, normalizeForPresence, parseHostProbeHtml } from '../chunk-P6HQW635.js';
2
- 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-JWXI5HAZ.js';
1
+ export { FaqBodyHonestyError, HeadContractError, MIN_EXEMPTION_REASON_LENGTH, assertFaqBodyHonesty, assertHeadContract, auditExemptionHosts, auditHeadContract, blankComments, extractFaqQuestions, extractPrerenderedBodyText, findFaqBodyHonestyViolations, formatExemptionAudit, formatFaqBodyHonestyReport, formatHeadContractReport, hostsNamedIn, normalizeExemption, normalizeForPresence, parseHostProbeHtml } from '../chunk-56RSSOAM.js';
2
+ export { AI_BOTS, AI_BOT_TIERS, AI_TRAINING_OPT_OUT_MARKER, BodyPrerenderError, CANONICAL_CHARSET_META, CHARSET_BUDGET_BYTES, CHARSET_HEADROOM_WARN_BYTES, CharsetBudgetError, EmittedUrlError, EmittedUrlNotRunError, FIRST_PARTY_REVIEW_PLATFORMS, HeadHonestyError, HeadHonestyNotRunError, REQUIRED_POSTAL_ADDRESS_FIELDS, RobotsAiTrainingConflictError, SEO_HEAD_ROUTE_HAS_NO_META, absolutizeUrl, aiTrainingBots, appendAiTrainingOptOut, 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, dedupeGraphAgainstRules, dedupeUrls, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, extractBakedHead, filterRealFaq, filterRealReviews, findAiTrainingRobotsConflicts, 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, isFirstPartyReviewPlatform, isLocalBusinessType, isManagedLinkRel, isManagedMetaTag, isRouteEmitted, isRouteIndexable, loadPagesManifest, normalizeHeadText, normalizeSeoHeadPath, parsePagesManifest, prerenderBodies, renderHeadTags, resolveHonestyMode, resolvePageSeo, routeExclusionReason, routeToOutputFile, slugToTitle, snapshotBakedManagedHeadTags, spliceBodyHtml, spliceHeadHtml, stripManagedHeadTags, sweepBakedManagedHeadTags } from '../chunk-CJATCOZJ.js';
3
3
  //# sourceMappingURL=index.js.map
4
4
  //# sourceMappingURL=index.js.map
@@ -10,7 +10,10 @@ import * as vue from 'vue';
10
10
  interface SeoConfiguration {
11
11
  /** Schema version */
12
12
  version: number;
13
- /** ISO timestamp of last update */
13
+ /**
14
+ * ISO timestamp of the last seo.yaml edit (portal bookkeeping). NOT a page
15
+ * date: since cms 0.14.0 it is never stamped into sitemap `<lastmod>`.
16
+ */
14
17
  lastUpdated?: string;
15
18
  /** Email or identifier of who made the update */
16
19
  updatedBy?: string;
@@ -45,6 +48,41 @@ interface SeoConfiguration {
45
48
  * outside the 1024-byte sniffing window without failing the build.
46
49
  */
47
50
  charsetBudget?: boolean | 'error' | 'warn' | 'off' | SeoHonestyBlock;
51
+ /** robots.txt policy owned by the site (portal-editable). */
52
+ robots?: SeoRobotsBlock;
53
+ /** sitemap.xml policy owned by the site. */
54
+ sitemap?: SeoSitemapBlock;
55
+ }
56
+ /** `.dcs/seo.yaml` `sitemap:` block. */
57
+ interface SeoSitemapBlock {
58
+ /**
59
+ * Opt in to BEST-EFFORT git-derived `<lastmod>` for routes without a
60
+ * `.dcs/pages.yaml` date (default `false`: the factory never infers a date,
61
+ * so such a URL carries no `<lastmod>`). Known gaps: composables, stores,
62
+ * lib and utils are excluded rather than inspected; markdown includes are
63
+ * not traced; a VitePress route with a custom frontmatter `layout:` is
64
+ * omitted. Tune with `lastmodExclude`.
65
+ */
66
+ lastmodFromGit?: boolean;
67
+ /**
68
+ * Extra globs (relative to the build's project root; a glob without `/`
69
+ * matches the basename) for local modules that are NOT page content and so
70
+ * never date a route's `<lastmod>` nor get walked into. Added to the cms
71
+ * default list (app shell, layouts, header/footer/nav/banner, composables,
72
+ * stores, lib, utils, router, components/ui, styles). A `!glob` entry
73
+ * re-includes a module the defaults exclude.
74
+ */
75
+ lastmodExclude?: string[];
76
+ }
77
+ /** `.dcs/seo.yaml` `robots:` block. */
78
+ interface SeoRobotsBlock {
79
+ /**
80
+ * Allow AI model-training crawlers (GPTBot, ClaudeBot, CCBot) and control
81
+ * tokens (Google-Extended, Applebot-Extended). Default `true` (owner R-Q2 =
82
+ * A). `false` emits `Disallow: /` for those groups; AI search and
83
+ * user-triggered fetchers stay allowed either way.
84
+ */
85
+ aiTraining?: boolean;
48
86
  }
49
87
  /**
50
88
  * The expanded form of a `.dcs/seo.yaml` honesty-rail escape hatch — a severity
@@ -366,7 +404,25 @@ interface ReviewSource {
366
404
  authorName?: unknown;
367
405
  date?: unknown;
368
406
  locationName?: unknown;
407
+ /**
408
+ * Where the review was collected (`site`, `google`, `meta`, ...). Only items
409
+ * whose platform is in {@link FIRST_PARTY_REVIEW_PLATFORMS} become Review /
410
+ * AggregateRating schema; a missing or empty platform is NOT first-party
411
+ * (`useReviewContent` defaults it to `google`).
412
+ */
413
+ platform?: unknown;
369
414
  }
415
+ /**
416
+ * Review platforms whose items the site collected itself. Google's review
417
+ * snippet guidelines disallow marking up reviews sourced from third-party
418
+ * platforms (Google, Meta, Yelp, ...) on the business's own site, so Review
419
+ * and AggregateRating schema is emitted ONLY for these platforms (owner R-Q1 =
420
+ * A, 2026-11-08). Visible testimonial components are unaffected. Compared
421
+ * case-insensitively after trimming.
422
+ */
423
+ declare const FIRST_PARTY_REVIEW_PLATFORMS: ReadonlySet<string>;
424
+ /** True when `platform` names a first-party review source (trimmed, case-insensitive). */
425
+ declare function isFirstPartyReviewPlatform(platform: unknown): boolean;
370
426
  /** A structured FAQ entry: `{ q, a }` (frontmatter) — honesty-gated. */
371
427
  interface FaqSource {
372
428
  q?: unknown;
@@ -495,9 +551,11 @@ interface NormalisedReview {
495
551
  locationName?: string;
496
552
  }
497
553
  /**
498
- * Keep ONLY real review items: a numeric `rating`, a non-empty `text`, and a
499
- * non-empty `authorName`. Anything missing any of the three is dropped (never
500
- * back-filled). Returns `[]` when nothing qualifies.
554
+ * Keep ONLY real, first-party review items: a first-party `platform` (see
555
+ * {@link FIRST_PARTY_REVIEW_PLATFORMS}; missing/empty/third-party is dropped),
556
+ * a numeric `rating`, a non-empty `text`, and a non-empty `authorName`.
557
+ * Anything failing any check is dropped (never back-filled). Returns `[]` when
558
+ * nothing qualifies.
501
559
  */
502
560
  declare function filterRealReviews(items: ReviewSource[] | undefined): NormalisedReview[];
503
561
  /** A `Review` schema.org node array + an `aggregateRating`, both honesty-gated. */
@@ -712,8 +770,8 @@ interface PageRouteEntry {
712
770
  /**
713
771
  * Per-page last-modification date for the sitemap `<lastmod>`. A W3C-datetime
714
772
  * string authored in `pages.yaml` (`lastmod` / `lastUpdated` / `dateModified`).
715
- * Validated + de-fabricated at emit time; an invalid or absent value falls
716
- * back to the site-wide lastmod. Never invented.
773
+ * Validated at emit time; an invalid or absent value falls back to the
774
+ * route's git-derived date, else no `<lastmod>`. Never invented.
717
775
  */
718
776
  lastmod?: string;
719
777
  }
@@ -793,11 +851,39 @@ declare function isRouteEmitted(route: Pick<PageRouteEntry, 'slug' | 'path'>, ru
793
851
  */
794
852
 
795
853
  /**
796
- * AI-crawler user agents emitted as explicit allow/deny groups in robots.txt so
797
- * AI discovery is opt-in-friendly (and explicitly gated off in preview). A site
798
- * can opt the whole tier out via `robots.aiBots: false`.
854
+ * AI-crawler user agents, by purpose tier (RFQ-002427 shared constants, cms
855
+ * 0.14.0). Each is emitted as an explicit named robots.txt group:
856
+ *
857
+ * - `search` - AI search indexers that cite and link the site.
858
+ * - `userTriggered` - fetches made on behalf of a person's live request.
859
+ * - `training` - model-training crawlers.
860
+ * - `controlTokens` - not crawlers: product tokens that gate use of content
861
+ * the vendor's normal crawler already fetched (Gemini /
862
+ * Apple Intelligence training).
863
+ *
864
+ * `search` and `userTriggered` are always allowed in production. `training` and
865
+ * `controlTokens` are allowed by default and get `Disallow: /` when a site sets
866
+ * `robots.aiTraining: false` in `.dcs/seo.yaml` (owner R-Q2 = A, 2026-11-08).
867
+ * The obsolete `anthropic-ai` and `Claude-Web` tokens are never emitted.
868
+ */
869
+ declare const AI_BOT_TIERS: {
870
+ readonly search: readonly ["OAI-SearchBot", "Claude-SearchBot", "PerplexityBot"];
871
+ readonly userTriggered: readonly ["ChatGPT-User", "Claude-User", "Perplexity-User"];
872
+ readonly training: readonly ["GPTBot", "ClaudeBot", "CCBot"];
873
+ readonly controlTokens: readonly ["Google-Extended", "Applebot-Extended"];
874
+ };
875
+ /** A purpose tier key of {@link AI_BOT_TIERS}. */
876
+ type AiBotTier = keyof typeof AI_BOT_TIERS;
877
+ /**
878
+ * Back-compat flat list: every AI bot the factory ALLOWS by default (all four
879
+ * tiers, since `aiTraining` defaults to `true`). The 0.13.x bots keep their
880
+ * 0.13.x positions (indices 0-6) and the four 0.14.0 additions are appended,
881
+ * so a consumer indexing or iterating it sees a superset, never a reshuffle.
882
+ * Prefer {@link AI_BOT_TIERS} for new code.
799
883
  */
800
- declare const AI_BOTS: readonly ["GPTBot", "ClaudeBot", "PerplexityBot", "Google-Extended", "CCBot", "OAI-SearchBot", "Applebot-Extended"];
884
+ declare const AI_BOTS: readonly ["GPTBot", "ClaudeBot", "PerplexityBot", "Google-Extended", "CCBot", "OAI-SearchBot", "Applebot-Extended", "Claude-SearchBot", "ChatGPT-User", "Claude-User", "Perplexity-User"];
885
+ /** The AI bots `aiTraining: false` disallows (training + control tokens). */
886
+ declare function aiTrainingBots(): string[];
801
887
  /**
802
888
  * The SINGLE indexability predicate shared by `buildSitemapXml` and
803
889
  * `buildLlmsTxt` so the two outputs always agree on which routes appear.
@@ -824,7 +910,21 @@ interface BuildSitemapParams {
824
910
  noindex?: string[];
825
911
  /** `pages.yaml` top-level `excluded:` globs (coron8 parity). */
826
912
  excludedGlobs?: string[];
827
- /** Optional single site-wide `<lastmod>` (ISO date) — no fabricated per-page dates. */
913
+ /**
914
+ * Per-route `<lastmod>` values derived from the route's source files (git
915
+ * last-commit time), keyed by `route.path`. Used only when the route carries
916
+ * no `pages.yaml` date of its own. The cms factory passes only this: it no
917
+ * longer stamps one site-wide date (cms 0.14.0), because one date on every
918
+ * URL is false on most of them.
919
+ */
920
+ routeLastmods?: ReadonlyMap<string, string> | Readonly<Record<string, string>>;
921
+ /**
922
+ * @deprecated since 0.14.0. A single site-wide `<lastmod>`, applied to every
923
+ * route that has neither its own `pages.yaml` date nor a `routeLastmods`
924
+ * entry. Kept for back-compat: an explicit value is still honoured exactly as
925
+ * in 0.13.x (validated, never fabricated), but it is the caller's choice and
926
+ * the cms factory never passes it. Prefer per-route dates.
927
+ */
828
928
  lastmod?: string;
829
929
  }
830
930
  /**
@@ -850,12 +950,20 @@ interface DcsRobotsOptions {
850
950
  /** Raw lines appended verbatim after the generated directives. */
851
951
  extra?: string[];
852
952
  /**
853
- * Emit explicit AI-crawler allow/deny groups (GPTBot, ClaudeBot,
854
- * PerplexityBot, Google-Extended, CCBot, OAI-SearchBot, Applebot-Extended).
855
- * Default `true` — each `Allow: /` in
856
- * production, each `Disallow: /` in preview. Set `false` to drop the tier.
953
+ * Emit explicit AI-crawler groups for every bot in {@link AI_BOT_TIERS}.
954
+ * Default `true`. In production each allowed group repeats the `*` group's
955
+ * Allow/Disallow lines; in preview each is `Disallow: /`. Set `false` to drop
956
+ * the allow groups (bots then fall back to `*`); an `aiTraining: false`
957
+ * opt-out still emits its Disallow groups.
857
958
  */
858
959
  aiBots?: boolean;
960
+ /**
961
+ * Allow AI model-training crawlers and control tokens (default `true`, owner
962
+ * R-Q2 = A). `false` gives the `training` and `controlTokens` tiers
963
+ * `Disallow: /`; the `search` and `userTriggered` tiers stay allowed. Sites
964
+ * set this in `.dcs/seo.yaml` as `robots: { aiTraining: false }`.
965
+ */
966
+ aiTraining?: boolean;
859
967
  /**
860
968
  * Overwrite an existing `dist/robots.txt` (e.g. a hand-authored
861
969
  * `public/robots.txt` Vite already copied). Default `false` — do not clobber.
@@ -886,6 +994,53 @@ interface BuildRobotsParams {
886
994
  * - `extra` lines are appended verbatim.
887
995
  */
888
996
  declare function buildRobotsTxt(params: BuildRobotsParams): string;
997
+ /** One training bot / control token a hand-authored robots.txt names with rules other than `Disallow: /`. */
998
+ interface RobotsAiTrainingConflict {
999
+ bot: string;
1000
+ /** The rule lines of every group naming the bot (empty when the group has none). */
1001
+ rules: string[];
1002
+ }
1003
+ /**
1004
+ * Under `robots.aiTraining: false`, find every training bot / control token
1005
+ * ({@link aiTrainingBots}) the hand-authored robots.txt already names whose
1006
+ * group rules are anything other than exactly `Disallow: /`: an `Allow:`, a
1007
+ * partial `Disallow: /admin`, an empty group, or a shared group with `*`. Such
1008
+ * a group would keep allowing that bot, so the opt-out cannot be honoured
1009
+ * without editing the site's file. Consecutive `User-agent` lines share one
1010
+ * group; a bot named in several groups is judged on all their rules.
1011
+ *
1012
+ * Pure: string in, conflicts out.
1013
+ */
1014
+ declare function findAiTrainingRobotsConflicts(text: string): RobotsAiTrainingConflict[];
1015
+ /**
1016
+ * Thrown (and NOT swallowed by the emitter's catch) when `robots.aiTraining`
1017
+ * is `false` but a hand-authored robots.txt names a training bot or control
1018
+ * token with anything other than `Disallow: /`. The build fails rather than
1019
+ * silently keep allowing the bot.
1020
+ */
1021
+ declare class RobotsAiTrainingConflictError extends Error {
1022
+ readonly file: string;
1023
+ readonly conflicts: RobotsAiTrainingConflict[];
1024
+ constructor(file: string, conflicts: RobotsAiTrainingConflict[]);
1025
+ }
1026
+ /** The marker comment above the groups {@link appendAiTrainingOptOut} appends. */
1027
+ declare const AI_TRAINING_OPT_OUT_MARKER = "# AI training opt-out (.dcs/seo.yaml robots.aiTraining: false), appended by @duffcloudservices/cms";
1028
+ /**
1029
+ * Honour `robots.aiTraining: false` on a HAND-AUTHORED robots.txt without
1030
+ * replacing it: every existing line is kept byte-for-byte, and a
1031
+ * `User-agent: <bot>` / `Disallow: /` group is APPENDED for each training bot
1032
+ * and control token ({@link aiTrainingBots}) the file does not already name.
1033
+ * A bot the file already has a group for is left to that group (`skipped`); the
1034
+ * caller first rejects any such group that is not exactly `Disallow: /`
1035
+ * ({@link findAiTrainingRobotsConflicts}), so a skipped bot is already blocked.
1036
+ *
1037
+ * Pure: string in, string out.
1038
+ */
1039
+ declare function appendAiTrainingOptOut(text: string): {
1040
+ text: string;
1041
+ added: string[];
1042
+ skipped: string[];
1043
+ };
889
1044
  interface BuildLlmsParams {
890
1045
  /** Route list (from `loadPagesManifest`). */
891
1046
  routes: PageRouteEntry[];
@@ -1101,14 +1256,17 @@ interface CreateSeoTransformPageDataOptions {
1101
1256
  * promoted LocalBusiness node) in place of the flat per-schema global JSON-LD.
1102
1257
  * When ON, the LocalBusiness subtype in `global.schemas` is ABSORBED into the
1103
1258
  * graph (not emitted twice); other global schemas (Person, etc.) are still
1104
- * emitted standalone. Default `false`, so existing sites (which supply their
1105
- * own graph via `global.schemas`) are unchanged until they opt in.
1259
+ * emitted standalone. Default `false` (opt in with `true`). cms 0.14.0 kept
1260
+ * the flat default: graph absorption still drops page-level Organization /
1261
+ * WebSite schemas by type, so the default flip waits for C-2588 (ledger
1262
+ * cut-scope RFQ-002523). Review an opt-in site's page schemas first.
1106
1263
  */
1107
1264
  emitGraph?: boolean;
1108
1265
  /**
1109
1266
  * Emit an automatic `BreadcrumbList` derived from the route depth on every
1110
- * non-home page. Default `false` (sites that already emit breadcrumbs via
1111
- * `pageTypeRules` should leave this off to avoid duplicates). Intermediate /
1267
+ * non-home page. Default `false` (opt in with `true`). The automatic list is
1268
+ * skipped on a page whose `pageTypeRules` already emit a BreadcrumbList.
1269
+ * Intermediate /
1112
1270
  * leaf crumb titles come from `breadcrumbTitles(ctx)` when provided, else a
1113
1271
  * slug-derived Title Case.
1114
1272
  */
@@ -1169,6 +1327,26 @@ declare function buildVitePressSeoHead(pageData: VitePressPageData, options: Cre
1169
1327
  description?: string;
1170
1328
  setPageTitle: boolean;
1171
1329
  };
1330
+ /**
1331
+ * Reconcile the default `@graph` with a page's `pageTypeRules` output BY
1332
+ * IDENTITY ONLY (cms 0.14.0, Codex Terra r2 / judge A2 receipt):
1333
+ *
1334
+ * - A default-graph node is dropped ONLY when a rule node carries the
1335
+ * IDENTICAL `@id`. Every property the rule node lacks is then merged into
1336
+ * the rule node (the rule wins on conflict), so nothing the site configured
1337
+ * in `seo.yaml` is lost and references to that `@id` still resolve.
1338
+ * - Same-type entities with different `@id`s (a brokerage Organization on one
1339
+ * page, the site's own Organization) are BOTH kept, and the graph's own
1340
+ * references (e.g. `WebSite.publisher`) keep pointing at the site's node.
1341
+ * - An emptied graph block is dropped (its nodes all live on in rule nodes).
1342
+ *
1343
+ * Pure: returns the reconciled graph and CLONES of the rule objects carrying
1344
+ * the merges; the inputs are not mutated.
1345
+ */
1346
+ declare function dedupeGraphAgainstRules(graphObjects: Array<Record<string, unknown>>, ruleObjects: Array<Record<string, unknown>>): {
1347
+ graph: Array<Record<string, unknown>>;
1348
+ rules: Array<Record<string, unknown>>;
1349
+ };
1172
1350
  /**
1173
1351
  * Create a VitePress `transformPageData(pageData)` function that bakes DCS SEO
1174
1352
  * (global meta/OG/Twitter/canonical + global JSON-LD graph + pluggable
@@ -1190,4 +1368,4 @@ declare function buildVitePressSeoHead(pageData: VitePressPageData, options: Cre
1190
1368
  */
1191
1369
  declare function createSeoTransformPageData(options: CreateSeoTransformPageDataOptions): (pageData: VitePressPageData) => void;
1192
1370
 
1193
- 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 };
1371
+ export { defaultRelativePathToRoute as $, AI_BOTS as A, type BlogMeta as B, type ContentConfig as C, type DcsRobotsOptions as D, absolutizeUrl as E, FIRST_PARTY_REVIEW_PLATFORMS as F, type GlobalSeoConfig as G, type HeadOverrides as H, aiTrainingBots as I, appendAiTrainingOptOut as J, breadcrumbTrailFromRoute as K, buildBlogPosting as L, buildBreadcrumbList as M, buildFaqPage as N, buildGlobalGraph as O, type PageSeoConfig as P, buildLlmsTxt as Q, type ResolvedPageOverrides as R, type SchemaObject as S, buildReviewSchemaParts as T, type UseSeoReturn as U, type VitePressHeadConfig as V, buildRobotsTxt as W, buildSitemapXml as X, buildVitePressSeoHead as Y, createSeoTransformPageData as Z, dedupeGraphAgainstRules as _, AI_BOT_TIERS as a, filterRealFaq as a0, filterRealReviews as a1, findAiTrainingRobotsConflicts as a2, findReviewItemsForPage as a3, isFirstPartyReviewPlatform as a4, isRouteIndexable as a5, slugToTitle as a6, type PageRouteEntry as a7, type SeoHonestyBlock as a8, type NormalisedFaq as a9, type NormalisedReview as aa, type PostalAddressGap as ab, REQUIRED_POSTAL_ADDRESS_FIELDS as ac, type ReviewSchemaParts as ad, type RouteEmissionRules as ae, type RouteExclusionReason as af, buildHasCredential as ag, deriveSameAs as ah, findBusinessLicense as ai, findGlobalSchemasOfType as aj, findLocalBusinessSchema as ak, findPostalAddressGaps as al, formatPostalAddressGapReport as am, graphAbsorbs as an, graphIds as ao, isLocalBusinessType as ap, isRouteEmitted as aq, loadPagesManifest as ar, parsePagesManifest as as, routeExclusionReason as at, AI_TRAINING_OPT_OUT_MARKER as b, type AiBotTier as c, type BreadcrumbCrumb as d, type BuildLlmsParams as e, type BuildRobotsParams as f, type BuildSitemapParams as g, type CreateSeoTransformPageDataOptions as h, type FaqSource as i, type ResolvedPageSeo as j, type ReviewSource as k, type RobotsAiTrainingConflict as l, RobotsAiTrainingConflictError as m, type SeoAlternateConfig as n, type SeoAuthorConfig as o, type SeoConfiguration as p, type SeoImagesConfig as q, type SeoOpenGraphConfig as r, type SeoPageContext as s, type SeoPageTypeRule as t, type SeoSchemaConfig as u, type SeoSocialConfig as v, type SeoTwitterConfig as w, type SeoVerificationConfig as x, type UseSeoConfig as y, type VitePressPageData as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@duffcloudservices/cms",
3
- "version": "0.13.13",
3
+ "version": "0.14.0",
4
4
  "description": "Vue 3 composables and Vite plugins for DCS CMS integration",
5
5
  "type": "module",
6
6
  "config": {
@@ -62,7 +62,7 @@
62
62
  },
63
63
  "dependencies": {
64
64
  "js-yaml": "^4.1.0",
65
- "@duffcloudservices/cms-core": "0.8.10"
65
+ "@duffcloudservices/cms-core": "0.8.11"
66
66
  },
67
67
  "devDependencies": {
68
68
  "@types/js-yaml": "^4.0.9",
@@ -77,12 +77,13 @@
77
77
  "eslint": "^9.31.0",
78
78
  "eslint-plugin-vue": "~10.3.0",
79
79
  "jiti": "^2.4.2",
80
- "markdown-it": "^14.0.0",
80
+ "markdown-it": "^14.3.3",
81
81
  "tsup": "^8.0.0",
82
82
  "typescript": "~5.6.3",
83
83
  "vite": "^6.3.5",
84
+ "vitepress": "1.6.4",
84
85
  "vitest": "^3.2.3",
85
- "vue": "^3.5.16",
86
+ "vue": "^3.5.44",
86
87
  "vue-router": "^4.5.1",
87
88
  "@dcs/eslint-rules": "0.1.0",
88
89
  "@dcs/test-utils": "0.1.0"