@duffcloudservices/cms 0.13.15 → 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.
- package/dist/{chunk-P6HQW635.js → chunk-56RSSOAM.js} +3 -3
- package/dist/{chunk-P6HQW635.js.map → chunk-56RSSOAM.js.map} +1 -1
- package/dist/{chunk-JWXI5HAZ.js → chunk-CJATCOZJ.js} +198 -33
- package/dist/chunk-CJATCOZJ.js.map +1 -0
- package/dist/index.d.ts +3 -3
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/{installSeoHead-DPVmX-eY.d.ts → installSeoHead-CcNfcxNF.d.ts} +1 -1
- package/dist/plugins/index.d.ts +160 -4
- package/dist/plugins/index.js +644 -81
- package/dist/plugins/index.js.map +1 -1
- package/dist/seo/index.d.ts +4 -4
- package/dist/seo/index.js +2 -2
- package/dist/{vitepressTransform-BJrpGbVT.d.ts → vitepressTransform-CQXBpYEC.d.ts} +198 -20
- package/package.json +1 -1
- package/dist/chunk-JWXI5HAZ.js.map +0 -1
package/dist/seo/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { a as HeadMetaTag, H as HeadLinkTag } from '../installSeoHead-
|
|
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-
|
|
3
|
-
import {
|
|
4
|
-
export { A as AI_BOTS, B as BlogMeta,
|
|
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
5
|
import { a as HeadObservation, H as HonestyMode } from '../headHonesty-k1IhGblP.js';
|
|
6
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';
|
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-
|
|
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-
|
|
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
|
-
/**
|
|
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
|
|
499
|
-
*
|
|
500
|
-
*
|
|
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
|
|
716
|
-
*
|
|
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
|
|
797
|
-
*
|
|
798
|
-
*
|
|
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
|
-
/**
|
|
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
|
|
854
|
-
*
|
|
855
|
-
*
|
|
856
|
-
*
|
|
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
|
|
1105
|
-
*
|
|
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` (
|
|
1111
|
-
*
|
|
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 {
|
|
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 };
|