@actuate-media/cms-core 0.41.0 → 0.43.0

package/dist/seo/page-meta.js

@@ -1,5 +1,6 @@
-import { generateMetaTags, generateNextMetadata, renderMetaTagsHtml } from './meta-tags.js';
+import { buildNextVerification, buildVerificationMetaEntries, generateMetaTags, generateNextMetadata, renderMetaTagsHtml, renderVerificationMetaHtml, } from './meta-tags.js';
 import { resolveRobotsDirectives, resolveSeoEnvironment } from './robots.js';
+import { applySiteTitleTemplate } from './title-templates.js';
 /**
  * Maps a collection slug to the most appropriate Schema.org type when the
  * config doesn't specify one. Conservative fallback to WebPage.
@@ -167,8 +168,32 @@ export function composePageMeta(input) {
     const slug = (doc.slug ?? data.slug ?? '') || '';
     const isHome = slug === 'home' || slug === 'index' || slug === '';
     const url = buildDocUrl(siteUrl, collection?.urlPrefix, slug, isHome);
-    const title = pickString(page.metaTitle, data.metaTitle, data.title, page.title) ?? 'Untitled';
-    const description = pickString(page.metaDescription, data.metaDescription, data.excerpt, data.description);
+    const schemaType = pickString(page.schemaType, data.schemaType, collectionSeo?.defaultSchemaType) ??
+        input.defaultSchemaType ??
+        (collection?.slug ? detectSchemaType(collection.slug) : 'WebPage');
+    // Title: an explicit per-document SEO title always wins. Otherwise apply the
+    // site-wide title template (Settings → SEO "Meta Defaults"), falling back to
+    // the raw document title when no template is configured.
+    const explicitTitle = pickString(page.metaTitle, data.metaTitle);
+    const rawTitle = pickString(data.title, page.title) ?? 'Untitled';
+    // Apply the site-wide template only when one is configured, so sites that
+    // never set a template keep their existing bare-title behaviour.
+    const hasTitleTemplate = typeof site?.titleTemplate === 'string' && site.titleTemplate.trim() !== '';
+    const title = explicitTitle
+        ? explicitTitle
+        : hasTitleTemplate
+            ? applySiteTitleTemplate(site.titleTemplate, {
+                page: rawTitle,
+                site: siteName,
+                type: pickString(collection?.labels?.singular, schemaType),
+                author: pickString(data.authorName, data.author),
+                date: asIsoDate(doc.publishedAt ?? data.publishedAt)?.slice(0, 10),
+                category: pickString(data.category, data.categories?.[0]),
+                tag: pickString(data.tags?.[0], data.tag),
+            })
+            : rawTitle;
+    // Description: per-document value wins, then the site-wide default.
+    const description = pickString(page.metaDescription, data.metaDescription, data.excerpt, data.description, site?.defaultMetaDescription);
     const canonical = pickString(page.canonical, data.canonical) ?? url;
     // Single source of truth for robots resolution (shared with the /seo/meta
     // render path). Honors the `robotsPolicy` select field, explicit
@@ -192,9 +217,6 @@ export function composePageMeta(input) {
         // under /api/cms — not the site root — so the default must include it or it
         // 404s for social crawlers.
         (siteUrl ? `${siteUrl}/api/cms/og.png?title=${encodeURIComponent(title)}` : undefined);
-    const schemaType = pickString(page.schemaType, data.schemaType, collectionSeo?.defaultSchemaType) ??
-        input.defaultSchemaType ??
-        (collection?.slug ? detectSchemaType(collection.slug) : 'WebPage');
     const metaInput = {
         title,
         description,
@@ -214,8 +236,25 @@ export function composePageMeta(input) {
         locale: config?.i18n?.defaultLocale,
     };
     const meta = generateMetaTags(metaInput);
-    const metaHtml = renderMetaTagsHtml(metaInput);
-    const metadata = generateNextMetadata(metaInput);
+    let metaHtml = renderMetaTagsHtml(metaInput);
+    let metadata = generateNextMetadata(metaInput);
+    // Site-wide search-engine verification meta tags (Settings → SEO). These are
+    // injected into every public page's head; values are escaped and emitted only
+    // as safe `<meta>` tags.
+    const verificationEntries = buildVerificationMetaEntries(site?.verification);
+    if (verificationEntries.length > 0) {
+        for (const e of verificationEntries) {
+            const key = e.name ?? e.property;
+            if (key)
+                meta[key] = e.content;
+        }
+        const verificationHtml = renderVerificationMetaHtml(site?.verification);
+        if (verificationHtml)
+            metaHtml = `${metaHtml}\n${verificationHtml}`;
+        const nextVerification = buildNextVerification(site?.verification);
+        if (nextVerification)
+            metadata = { ...metadata, verification: nextVerification };
+    }
     const jsonLd = composeJsonLd(schemaType, doc, { title, description, url, image: ogImageUrl }, site);
     const jsonLdHtml = jsonLd
         ? `<script type="application/ld+json">${JSON.stringify(jsonLd).replace(/</g, '\\u003c')}</script>`

package/dist/seo/page-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-meta.js","sourceRoot":"","sources":["../../src/seo/page-meta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"page-meta.js","sourceRoot":"","sources":["../../src/seo/page-meta.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAgE7D;;;;;;GAMG;AACH,MAAM,cAAc,GAA2B;IAC7C,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,eAAe;IACzB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,SAAS;IACzB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,cAAc;CAC1B,CAAA;AAED,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,EAAE,CAAA;IAC/C,IAAI,cAAc,CAAC,UAAU,CAAC;QAAE,OAAO,cAAc,CAAC,UAAU,CAAE,CAAA;IAClE,gDAAgD;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/D,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,UAAU,CAAA;IACjD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,WAAW,CAClB,OAAe,EACf,SAA6B,EAC7B,IAAY,EACZ,MAAe;IAEf,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,MAAM;QAAE,OAAO,IAAI,IAAI,GAAG,CAAA;IAC9B,MAAM,MAAM,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IACxD,IAAI,MAAM;QAAE,OAAO,GAAG,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAA;IAC9C,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,GAAG,UAA0B;IAC/C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxB,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;IAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;QACrB,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACzD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,IAAY,EACZ,GAAyB,EACzB,IAA0E,EAC1E,IAA+B;IAE/B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAA;IACxD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAA4B,CAAA;IAEhE,8EAA8E;IAC9E,kEAAkE;IAClE,IACE,GAAG,CAAC,cAAc;QAClB,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ;QACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAC1C,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,cAAyC,CAAA;QACxD,OAAO;YACL,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,oBAAoB;YAClD,GAAG,EAAE;SACN,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAA4B;QACtC,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI,CAAC,KAAK;QAChB,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAA;IAED,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAEzC,wBAAwB;IACxB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3E,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACxF,MAAM,YAAY,GAChB,SAAS,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,aAAa,CAAA;QAC/E,IAAI,aAAa;YAAE,MAAM,CAAC,aAAa,GAAG,aAAa,CAAA;QACvD,IAAI,YAAY;YAAE,MAAM,CAAC,YAAY,GAAG,YAAY,CAAA;QACpD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAG,IAAI,CAAC,MAAc,EAAE,IAAI,CAAC,CAAA;QACvF,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;QACzD,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,IAAI,EAAE,QAAQ,CAAA;QAC1D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,SAAS,GAAG;gBACjB,OAAO,EAAE,cAAc;gBACvB,IAAI,EAAE,OAAO;gBACb,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI;oBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE;oBACnE,CAAC,CAAC,EAAE,CAAC;aACR,CAAA;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAA;QAC5C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,GAAI,OAAmC,EAAE,CAAA;QACxF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAChE,IAAI,KAAK;YAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;QACnC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/D,IAAI,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAChD,CAAC;IAED,sCAAsC;IACtC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACzC,MAAM,IAAI,GAAG,MAAM,EAAE,GAAG,CAAA;IACxB,MAAM,aAAa,GAAG,UAAU,EAAE,GAAG,CAAA;IACrC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAA;IACxD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAA4B,CAAA;IAEhE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;IAC9F,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,MAAM,CAAA;IAEzC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAK,IAAI,CAAC,IAA2B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;IACxE,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,EAAE,CAAA;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAErE,MAAM,UAAU,GACd,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,iBAAiB,CAAC;QAC9E,KAAK,CAAC,iBAAiB;QACvB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAEpE,6EAA6E;IAC7E,6EAA6E;IAC7E,yDAAyD;IACzD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAChE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,CAAA;IACjE,0EAA0E;IAC1E,iEAAiE;IACjE,MAAM,gBAAgB,GACpB,OAAO,IAAI,EAAE,aAAa,KAAK,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7E,MAAM,KAAK,GAAG,aAAa;QACzB,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,gBAAgB;YAChB,CAAC,CAAC,sBAAsB,CAAC,IAAK,CAAC,aAAa,EAAE;gBAC1C,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU,CACb,UAAwD,EAAE,MAAM,EAAE,QAAQ,EAC3E,UAAU,CACX;gBACD,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAoB,EAAE,IAAI,CAAC,MAAgB,CAAC;gBACpE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,WAAW,IAAK,IAAI,CAAC,WAAsB,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC9E,QAAQ,EAAE,UAAU,CAClB,IAAI,CAAC,QAAkB,EACtB,IAAI,CAAC,UAAmC,EAAE,CAAC,CAAC,CAAC,CAC/C;gBACD,GAAG,EAAE,UAAU,CAAE,IAAI,CAAC,IAA6B,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAa,CAAC;aAC9E,CAAC;YACJ,CAAC,CAAC,QAAQ,CAAA;IAEd,oEAAoE;IACpE,MAAM,WAAW,GAAG,UAAU,CAC5B,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,WAAW,EAChB,IAAI,EAAE,sBAAsB,CAC7B,CAAA;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAA;IAEnE,0EAA0E;IAC1E,iEAAiE;IACjE,qEAAqE;IACrE,mEAAmE;IACnE,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACrC,QAAQ,EAAE;YACR,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY;YACpD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,aAAa,EAAE,aAAa,EAAE,OAAO;YAC9E,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,aAAa,EAAE,aAAa,EAAE,QAAQ;SACnF;QACD,QAAQ,EAAE;YACR,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc;YAC5C,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe;YAC9C,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB;SACzD;QACD,WAAW,EAAE,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC;KACtD,CAAC,CAAA;IAEF,MAAM,UAAU,GACd,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC;QAC5D,4EAA4E;QAC5E,4EAA4E;QAC5E,4BAA4B;QAC5B,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,yBAAyB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAExF,MAAM,SAAS,GAAiB;QAC9B,KAAK;QACL,WAAW;QACX,GAAG;QACH,QAAQ;QACR,SAAS;QACT,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EACF,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,aAAa,IAAI,UAAU,KAAK,aAAa;YACtF,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS;QACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;QACrD,WAAW,EAAE,IAAI,EAAE,aAAa;QAChC,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC;QACzC,YAAY,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa;KACpC,CAAA;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACxC,IAAI,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,QAAQ,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;IAE9C,6EAA6E;IAC7E,8EAA8E;IAC9E,yBAAyB;IACzB,MAAM,mBAAmB,GAAG,4BAA4B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IAC5E,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAA;YAChC,IAAI,GAAG;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;QAChC,CAAC;QACD,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QACvE,IAAI,gBAAgB;YAAE,QAAQ,GAAG,GAAG,QAAQ,KAAK,gBAAgB,EAAE,CAAA;QACnE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QAClE,IAAI,gBAAgB;YAAE,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;IAClF,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAC1B,UAAU,EACV,GAAG,EACH,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,EAC9C,IAAI,CACL,CAAA;IAED,MAAM,UAAU,GAAG,MAAM;QACvB,CAAC,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW;QAClG,CAAC,CAAC,EAAE,CAAA;IAEN,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AAC7F,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/seo/sitemap-notify.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Sitemap regeneration + search-engine ping orchestration.
+ *
+ * Triggered as a best-effort side effect after public content is published,
+ * updated, or removed (see `actions.ts` → `sitemap-notify` pending effect).
+ * The CMS serves `/sitemap.xml` dynamically, so "regeneration" here means:
+ *   1. bump `sitemapLastGeneratedAt` so the Settings/Technical UI reflects the
+ *      change, and
+ *   2. invalidate the sitemap cache tag so the next request rebuilds it.
+ *
+ * Pinging is **production-gated** and **SSRF-aware**:
+ *   - Pings only fire when the resolved environment is `production` (or the
+ *     caller explicitly opts in via `allowNonProduction`), so preview/local
+ *     deploys never notify Google/Bing about throwaway URLs.
+ *   - The site URL is validated as a public http(s) URL before it's embedded
+ *     in a ping request, so a misconfigured `siteUrl` can't point search
+ *     engines (or our own fetch) at an internal address.
+ *
+ * Note on endpoints: Google retired its standalone sitemap-ping endpoint in
+ * 2023 (it now returns 404) and recommends discovery via robots.txt / Search
+ * Console instead. We keep the call for completeness/back-compat but treat any
+ * non-2xx response as a soft failure — Bing's endpoint still honors pings.
+ */
+import type { SeoModuleSettings } from './config-store.js';
+export interface SitemapPingTarget {
+    name: string;
+    url: string;
+}
+/** Build the canonical `/sitemap.xml` URL from a configured site URL. */
+export declare function buildSitemapUrl(siteUrl: string | null | undefined): string | null;
+/** Search-engine ping targets for a given (already validated) sitemap URL. */
+export declare function buildSearchEnginePings(sitemapUrl: string): SitemapPingTarget[];
+/**
+ * Default debounce window for the expensive half of the cycle (timestamp write
+ * + search-engine ping). Bursts of publishes (bulk imports, "publish all")
+ * collapse to one regeneration per window so we don't hammer the single hot
+ * `__seo_config__` row or spam search engines. Cache invalidation is NOT
+ * debounced — it's cheap and must happen on every change for correctness.
+ */
+export declare const DEFAULT_SITEMAP_DEBOUNCE_MS = 60000;
+export interface SitemapNotifyOptions {
+    settings: Pick<SeoModuleSettings, 'sitemapEnabled' | 'autoRegenerateSitemapOnPublish' | 'pingSearchEnginesOnPublish'>;
+    /** Configured public site URL (e.g. from `NEXT_PUBLIC_SITE_URL` or seo.siteUrl). */
+    siteUrl?: string | null;
+    /** Explicit environment override; defaults to `resolveSeoEnvironment()`. */
+    environment?: string;
+    /** ISO timestamp of the last regeneration, used to debounce the write + ping. */
+    lastGeneratedAt?: string | null;
+    /** Debounce window in ms (default {@link DEFAULT_SITEMAP_DEBOUNCE_MS}). */
+    debounceMs?: number;
+    /** Injectable fetch for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Bypass the production gate (tests / explicit opt-in only). */
+    allowNonProduction?: boolean;
+    /** Per-ping timeout in ms (default 5000). */
+    timeoutMs?: number;
+}
+export interface SitemapNotifyResult {
+    /**
+     * Whether the caller should drop the sitemap cache tag. True on every
+     * sitemap-relevant change (not debounced) so the next request rebuilds.
+     */
+    invalidateCache: boolean;
+    /**
+     * Whether the caller should persist a fresh `sitemapLastGeneratedAt`. Only
+     * true once per debounce window — this is the write that was amplifying.
+     */
+    regenerated: boolean;
+    sitemapUrl: string | null;
+    /** Names of search engines successfully pinged (2xx). */
+    pinged: string[];
+    /** Targets that were not pinged, with a machine-readable reason. */
+    skipped: Array<{
+        target: string;
+        reason: string;
+    }>;
+}
+/**
+ * Decide what to do after a public-content change and perform the pings.
+ * Pure-ish: all I/O goes through `fetchImpl` and the result tells the caller
+ * whether to persist a regeneration timestamp. Never throws — sitemap upkeep
+ * must not fail a content write that already committed.
+ */
+export declare function notifySitemapOnPublish(opts: SitemapNotifyOptions): Promise<SitemapNotifyResult>;
+//# sourceMappingURL=sitemap-notify.d.ts.map

package/dist/seo/sitemap-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-notify.d.ts","sourceRoot":"","sources":["../../src/seo/sitemap-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASjF;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAM9E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,IAAI,CACZ,iBAAiB,EACjB,gBAAgB,GAAG,gCAAgC,GAAG,4BAA4B,CACnF,CAAA;IACD,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,oEAAoE;IACpE,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA2G9B"}

package/dist/seo/sitemap-notify.js

@@ -0,0 +1,159 @@
+/**
+ * Sitemap regeneration + search-engine ping orchestration.
+ *
+ * Triggered as a best-effort side effect after public content is published,
+ * updated, or removed (see `actions.ts` → `sitemap-notify` pending effect).
+ * The CMS serves `/sitemap.xml` dynamically, so "regeneration" here means:
+ *   1. bump `sitemapLastGeneratedAt` so the Settings/Technical UI reflects the
+ *      change, and
+ *   2. invalidate the sitemap cache tag so the next request rebuilds it.
+ *
+ * Pinging is **production-gated** and **SSRF-aware**:
+ *   - Pings only fire when the resolved environment is `production` (or the
+ *     caller explicitly opts in via `allowNonProduction`), so preview/local
+ *     deploys never notify Google/Bing about throwaway URLs.
+ *   - The site URL is validated as a public http(s) URL before it's embedded
+ *     in a ping request, so a misconfigured `siteUrl` can't point search
+ *     engines (or our own fetch) at an internal address.
+ *
+ * Note on endpoints: Google retired its standalone sitemap-ping endpoint in
+ * 2023 (it now returns 404) and recommends discovery via robots.txt / Search
+ * Console instead. We keep the call for completeness/back-compat but treat any
+ * non-2xx response as a soft failure — Bing's endpoint still honors pings.
+ */
+import { resolveSeoEnvironment } from './robots.js';
+import { validateWebhookUrl } from '../security/webhook.js';
+/** Build the canonical `/sitemap.xml` URL from a configured site URL. */
+export function buildSitemapUrl(siteUrl) {
+    if (!siteUrl)
+        return null;
+    try {
+        const u = new URL(siteUrl);
+        if (u.protocol !== 'https:' && u.protocol !== 'http:')
+            return null;
+        return `${u.origin}/sitemap.xml`;
+    }
+    catch {
+        return null;
+    }
+}
+/** Search-engine ping targets for a given (already validated) sitemap URL. */
+export function buildSearchEnginePings(sitemapUrl) {
+    const enc = encodeURIComponent(sitemapUrl);
+    return [
+        { name: 'google', url: `https://www.google.com/ping?sitemap=${enc}` },
+        { name: 'bing', url: `https://www.bing.com/ping?sitemap=${enc}` },
+    ];
+}
+/**
+ * Default debounce window for the expensive half of the cycle (timestamp write
+ * + search-engine ping). Bursts of publishes (bulk imports, "publish all")
+ * collapse to one regeneration per window so we don't hammer the single hot
+ * `__seo_config__` row or spam search engines. Cache invalidation is NOT
+ * debounced — it's cheap and must happen on every change for correctness.
+ */
+export const DEFAULT_SITEMAP_DEBOUNCE_MS = 60_000;
+/**
+ * Decide what to do after a public-content change and perform the pings.
+ * Pure-ish: all I/O goes through `fetchImpl` and the result tells the caller
+ * whether to persist a regeneration timestamp. Never throws — sitemap upkeep
+ * must not fail a content write that already committed.
+ */
+export async function notifySitemapOnPublish(opts) {
+    const { settings } = opts;
+    const result = {
+        invalidateCache: false,
+        regenerated: false,
+        sitemapUrl: null,
+        pinged: [],
+        skipped: [],
+    };
+    // Sitemap disabled entirely → nothing to do (no cache drop, no write).
+    if (!settings.sitemapEnabled) {
+        result.skipped.push({ target: 'sitemap', reason: 'sitemap-disabled' });
+        return result;
+    }
+    // Auto-regenerate off → the admin opted out of publish-time refresh entirely.
+    if (!settings.autoRegenerateSitemapOnPublish) {
+        result.skipped.push({ target: 'sitemap', reason: 'auto-regenerate-disabled' });
+        return result;
+    }
+    // The sitemap content changed and auto-regenerate is on → the cache must be
+    // dropped on EVERY change so the next request rebuilds. This is the cheap,
+    // un-debounced half of the cycle.
+    result.invalidateCache = true;
+    // Debounce the expensive half (DB timestamp write + outbound ping): if we
+    // regenerated within the window, collapse this publish into the prior one.
+    const debounceMs = opts.debounceMs ?? DEFAULT_SITEMAP_DEBOUNCE_MS;
+    const lastMs = opts.lastGeneratedAt ? Date.parse(opts.lastGeneratedAt) : NaN;
+    if (!Number.isNaN(lastMs) && Date.now() - lastMs < debounceMs) {
+        result.skipped.push({ target: 'sitemap', reason: 'debounced' });
+        return result;
+    }
+    result.regenerated = true;
+    if (!settings.pingSearchEnginesOnPublish) {
+        result.skipped.push({ target: 'ping', reason: 'ping-disabled' });
+        return result;
+    }
+    const environment = resolveSeoEnvironment(opts.environment);
+    const isProduction = environment === 'production';
+    if (!isProduction && !opts.allowNonProduction) {
+        result.skipped.push({ target: 'ping', reason: `non-production:${environment ?? 'unknown'}` });
+        return result;
+    }
+    const sitemapUrl = buildSitemapUrl(opts.siteUrl);
+    if (!sitemapUrl) {
+        result.skipped.push({ target: 'ping', reason: 'missing-or-invalid-site-url' });
+        return result;
+    }
+    result.sitemapUrl = sitemapUrl;
+    // In production the site URL must be a public https URL — reject internal /
+    // http / IP-literal targets so a misconfigured siteUrl can't be weaponized.
+    const urlCheck = validateWebhookUrl(sitemapUrl);
+    if (!urlCheck.valid) {
+        result.skipped.push({
+            target: 'ping',
+            reason: `unsafe-site-url:${urlCheck.error ?? 'invalid'}`,
+        });
+        return result;
+    }
+    if (isProduction && !sitemapUrl.startsWith('https://')) {
+        result.skipped.push({ target: 'ping', reason: 'non-https-site-url' });
+        return result;
+    }
+    const doFetch = opts.fetchImpl ?? globalThis.fetch;
+    if (typeof doFetch !== 'function') {
+        result.skipped.push({ target: 'ping', reason: 'fetch-unavailable' });
+        return result;
+    }
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    const targets = buildSearchEnginePings(sitemapUrl);
+    await Promise.all(targets.map(async (target) => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await doFetch(target.url, {
+                method: 'GET',
+                redirect: 'error',
+                signal: controller.signal,
+            });
+            if (res.ok) {
+                result.pinged.push(target.name);
+            }
+            else {
+                result.skipped.push({ target: target.name, reason: `http-${res.status}` });
+            }
+        }
+        catch (err) {
+            result.skipped.push({
+                target: target.name,
+                reason: err instanceof Error ? `fetch-error:${err.name}` : 'fetch-error',
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }));
+    return result;
+}
+//# sourceMappingURL=sitemap-notify.js.map

package/dist/seo/sitemap-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-notify.js","sourceRoot":"","sources":["../../src/seo/sitemap-notify.ts"],"names":[],"mappings":"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"}

package/dist/seo/title-templates.d.ts

@@ -6,6 +6,32 @@ export interface TitleTemplateConfig {
 }
 export type TitleVariable = 'title' | 'siteName' | 'sep' | 'collection' | 'category' | 'tag' | 'page' | 'year' | 'month';
 export declare function resolveTitle(template: string, variables: Partial<Record<TitleVariable, string>>): string;
+/** Tokens supported by the site-wide title template. */
+export declare const SITE_TITLE_TOKENS: readonly ["page", "site", "type", "separator", "author", "date", "category", "tag"];
+export type SiteTitleToken = (typeof SITE_TITLE_TOKENS)[number];
+/** Fallback used when no template is configured or the configured one is blank. */
+export declare const DEFAULT_SITE_TITLE_TEMPLATE = "%page% \u2014 %site%";
+export interface TitleTemplateValidation {
+    valid: boolean;
+    /** Tokens present in the template that aren't recognised. */
+    unknownTokens: string[];
+    /** Human-readable error messages (empty when valid). */
+    errors: string[];
+}
+/**
+ * Validate a site-wide title template. An empty/whitespace template is treated
+ * as valid (the renderer falls back to {@link DEFAULT_SITE_TITLE_TEMPLATE}).
+ * Unknown `%tokens%` and a template with no token *and* no literal text are
+ * rejected.
+ */
+export declare function validateTitleTemplate(template: string): TitleTemplateValidation;
+/**
+ * Apply a site-wide title template. Unknown / empty tokens collapse cleanly so
+ * the result never contains dangling separators or double spaces. Falls back to
+ * {@link DEFAULT_SITE_TITLE_TEMPLATE} when the template is blank, and to the
+ * page title (then site name) if the rendered result is empty.
+ */
+export declare function applySiteTitleTemplate(template: string | undefined, vars: Partial<Record<SiteTitleToken, string>>): string;
 export declare function getDocumentTitle(config: TitleTemplateConfig, options: {
     title: string;
     collection?: string;

package/dist/seo/title-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title-templates.d.ts","sourceRoot":"","sources":["../../src/seo/title-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,UAAU,GACV,KAAK,GACL,YAAY,GACZ,UAAU,GACV,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,CAAA;AAIX,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAChD,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GACA,MAAM,CAuBR"}
+{"version":3,"file":"title-templates.d.ts","sourceRoot":"","sources":["../../src/seo/title-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,UAAU,GACV,KAAK,GACL,YAAY,GACZ,UAAU,GACV,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,CAAA;AAIX,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAChD,MAAM,CAIR;AAUD,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,qFASpB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,yBAAoB,CAAA;AAI5D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAkC/E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAC5C,MAAM,CAuBR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GACA,MAAM,CAuBR"}

package/dist/seo/title-templates.js

@@ -4,6 +4,89 @@ export function resolveTitle(template, variables) {
         return variables[key] ?? '';
     });
 }
+// ---------------------------------------------------------------------------
+// Site-wide title template (percent-token syntax).
+//
+// The Settings → SEO "Meta Defaults" title template uses `%token%` syntax so
+// it reads naturally to non-developers (`%page% — %site%`). This is distinct
+// from the `{{mustache}}` helper above, which powers per-collection templates.
+// ---------------------------------------------------------------------------
+/** Tokens supported by the site-wide title template. */
+export const SITE_TITLE_TOKENS = [
+    'page',
+    'site',
+    'type',
+    'separator',
+    'author',
+    'date',
+    'category',
+    'tag',
+];
+/** Fallback used when no template is configured or the configured one is blank. */
+export const DEFAULT_SITE_TITLE_TEMPLATE = '%page% — %site%';
+const SITE_TOKEN_RE = /%(\w+)%/g;
+/**
+ * Validate a site-wide title template. An empty/whitespace template is treated
+ * as valid (the renderer falls back to {@link DEFAULT_SITE_TITLE_TEMPLATE}).
+ * Unknown `%tokens%` and a template with no token *and* no literal text are
+ * rejected.
+ */
+export function validateTitleTemplate(template) {
+    const errors = [];
+    const unknownTokens = [];
+    if (!template || template.trim() === '') {
+        return { valid: true, unknownTokens, errors };
+    }
+    const known = new Set(SITE_TITLE_TOKENS);
+    const seen = [];
+    for (const match of template.matchAll(SITE_TOKEN_RE)) {
+        const token = match[1];
+        seen.push(token);
+        if (!known.has(token) && !unknownTokens.includes(token)) {
+            unknownTokens.push(token);
+        }
+    }
+    if (unknownTokens.length > 0) {
+        errors.push(`Unsupported token${unknownTokens.length > 1 ? 's' : ''}: ${unknownTokens
+            .map((t) => `%${t}%`)
+            .join(', ')}`);
+    }
+    // Must contain at least one known token OR some literal (non-token) text.
+    const literal = template.replace(SITE_TOKEN_RE, '').trim();
+    const hasKnownToken = seen.some((t) => known.has(t));
+    if (!hasKnownToken && literal === '') {
+        errors.push('Template must include at least one token or some literal text.');
+    }
+    return { valid: errors.length === 0, unknownTokens, errors };
+}
+/**
+ * Apply a site-wide title template. Unknown / empty tokens collapse cleanly so
+ * the result never contains dangling separators or double spaces. Falls back to
+ * {@link DEFAULT_SITE_TITLE_TEMPLATE} when the template is blank, and to the
+ * page title (then site name) if the rendered result is empty.
+ */
+export function applySiteTitleTemplate(template, vars) {
+    const tpl = template && template.trim() !== '' ? template : DEFAULT_SITE_TITLE_TEMPLATE;
+    const values = {
+        page: vars.page,
+        site: vars.site,
+        type: vars.type,
+        separator: vars.separator ?? '|',
+        author: vars.author,
+        date: vars.date,
+        category: vars.category,
+        tag: vars.tag,
+    };
+    const replaced = tpl.replace(SITE_TOKEN_RE, (_, key) => values[key] ?? '');
+    // Tidy up: collapse whitespace, then strip leading/trailing separator-only
+    // fragments left behind by empty tokens (e.g. "Page — " → "Page").
+    const cleaned = replaced
+        .replace(/\s+/g, ' ')
+        .replace(/^[\s\-–—|·•]+/, '')
+        .replace(/[\s\-–—|·•]+$/, '')
+        .trim();
+    return cleaned || vars.page?.trim() || vars.site?.trim() || '';
+}
 export function getDocumentTitle(config, options) {
     if (options.metaTitle)
         return options.metaTitle;

package/dist/seo/title-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"title-templates.js","sourceRoot":"","sources":["../../src/seo/title-templates.ts"],"names":[],"mappings":"AAkBA,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAEvC,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,SAAiD;IAEjD,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACzD,OAAQ,SAAgD,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA2B,EAC3B,OAOC;IAED,IAAI,OAAO,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,SAAS,CAAA;IAE/C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAA;IACrC,MAAM,QAAQ,GACZ,CAAC,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,eAAe;QACtB,8BAA8B,CAAA;IAEhC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,SAAS,GAA2C;QACxD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;KACnD,CAAA;IAED,OAAO,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"title-templates.js","sourceRoot":"","sources":["../../src/seo/title-templates.ts"],"names":[],"mappings":"AAkBA,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAEvC,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,SAAiD;IAEjD,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACzD,OAAQ,SAAgD,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,8EAA8E;AAC9E,mDAAmD;AACnD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,KAAK;CACG,CAAA;AAIV,mFAAmF;AACnF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAA;AAE5D,MAAM,aAAa,GAAG,UAAU,CAAA;AAUhC;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,aAAa,GAAa,EAAE,CAAA;IAElC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAA;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,iBAAiB,CAAC,CAAA;IAChD,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACvB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,oBAAoB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa;aACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,IAAI,CAAC,aAAa,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAA;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA4B,EAC5B,IAA6C;IAE7C,MAAM,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B,CAAA;IACvF,MAAM,MAAM,GAAuC;QACjD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG;QAChC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAA;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAClF,2EAA2E;IAC3E,mEAAmE;IACnE,MAAM,OAAO,GAAG,QAAQ;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,IAAI,EAAE,CAAA;IAET,OAAO,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA2B,EAC3B,OAOC;IAED,IAAI,OAAO,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,SAAS,CAAA;IAE/C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAA;IACrC,MAAM,QAAQ,GACZ,CAAC,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,eAAe;QACtB,8BAA8B,CAAA;IAEhC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,SAAS,GAA2C;QACxD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG;QACH,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;KACnD,CAAA;IAED,OAAO,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cms-core",
-  "version": "0.41.0",
+  "version": "0.43.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/actuate-media/actuatecms.git",