npm - @duffcloudservices/cms - Versions diffs - 0.10.0 → 0.11.0 - Mend

@duffcloudservices/cms 0.10.0 → 0.11.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.

Files changed (28) hide show

package/README.md +59 -2
package/dist/chunk-DAYLLSEE.js +3 -0
package/dist/{chunk-KCWMS7P4.js.map → chunk-DAYLLSEE.js.map} +1 -1
package/dist/{chunk-UPAMLKOQ.js → chunk-F3EIWEZD.js} +158 -11
package/dist/chunk-F3EIWEZD.js.map +1 -0
package/dist/index.d.ts +74 -6
package/dist/index.js +88 -6
package/dist/index.js.map +1 -1
package/dist/plugins/index.d.ts +91 -3
package/dist/plugins/index.js +350 -82
package/dist/plugins/index.js.map +1 -1
package/dist/seo/index.d.ts +132 -226
package/dist/seo/index.js +2 -2
package/dist/spliceHeadHtml-CsBEucGy.d.ts +254 -0
package/dist/{vitepressTransform-DeEzgGWU.d.ts → vitepressTransform-DfmABXmK.d.ts} +53 -2
package/package.json +14 -2
package/src/components/DcsCallButton.test.ts +126 -0
package/src/components/DcsCallButton.vue +185 -0
package/src/components/DcsReviewShowcase.vue +13 -2
package/src/components/LiteMediaEmbed.test.ts +229 -0
package/src/components/LiteMediaEmbed.vue +399 -0
package/src/composables/useMediaCarousel.ts +6 -1
package/src/composables/useReviewContent.test.ts +86 -0
package/src/composables/useReviewContent.ts +34 -2
package/src/composables/useSiteVisitorSession.test.ts +120 -0
package/src/composables/useSiteVisitorSession.ts +160 -0
package/dist/chunk-KCWMS7P4.js +0 -3
package/dist/chunk-UPAMLKOQ.js.map +0 -1

package/README.md CHANGED Viewed

@@ -208,17 +208,46 @@ dcsContentPlugin({
 ### dcsSeoPlugin
-Injects `.dcs/seo.yaml` at build time.
+Injects `.dcs/seo.yaml` at build time and, opt-in, emits per-route static SEO.
 ```typescript
 import { dcsSeoPlugin } from '@duffcloudservices/cms/plugins'
 dcsSeoPlugin({
   seoPath: '.dcs/seo.yaml',  // default
-  debug: false                // default
+  debug: false,               // default
+  // Vue-SPA per-route static SEO (VitePress sites leave this off):
+  emitStaticHtml: true,           // emit dist/<route>/index.html with baked
+                                  // <head> meta + JSON-LD, plus sitemap/robots/llms
+  noindex: ['account', 'projects'], // auth-gated routes → robots noindex,nofollow
 })
 ```
+#### Body prerender (crawler-visible body content)
+When `emitStaticHtml` is on, the plugin also **prerenders each indexable
+route's body** so non-JS AI crawlers see the real page prose — not just
+`<div id="app"></div>`. After the per-route `<head>` is emitted, it drives the
+just-built SPA in headless Chromium (via the site's `playwright`), captures each
+route's rendered `#app` DOM, and splices it into the mount container. On the
+client, `app.mount('#app')` replaces that DOM (no hydration), so users are
+unaffected while crawlers get the body.
+- **Default ON** whenever `emitStaticHtml` is on — a cms bump enables it with no
+  per-site edit. `playwright` is already a fleet devDependency; if it is absent
+  the pass is a graceful no-op (head + JSON-LD still emitted).
+- **noindex / auth-gated routes are never body-prerendered** (they get a
+  head-only file).
+- A route that **crashes** at render time fails the build loud rather than
+  shipping a broken/empty body. Because it renders the PRODUCTION bundle,
+  dev-only fallback defaults (e.g. sample reviews) stay off — no fabricated
+  content is baked.
+- **Per-site escape hatch (no code change, no cms republish):** set
+  `prerenderBody: false` at the root of `.dcs/seo.yaml` to disable body
+  prerender for one site, or pass `dcsSeoPlugin({ prerenderBody: false })`.
+  Preview builds skip it automatically.
 ## Configuration Files
 ### .dcs/content.yaml
@@ -349,6 +378,34 @@ pages:
 For repeated galleries or cards, use indexed keys such as `gallery.item-0.image.url` and `gallery.item-0.image.alt`, then pass those keys through the rendered item. Do not make editable images CSS-only backgrounds; if a design needs background behavior, render a real managed image layer behind the content.
+### Click-to-call (NAP phone)
+`DcsCallButton` renders a `tel:` call affordance driven by the portal-managed `business.phone` NAP key (the same `global` content key used for LocalBusiness identity). Use it for the above-the-fold mobile call path service sites need.
+```vue
+<script setup lang="ts">
+import DcsCallButton from '@duffcloudservices/cms/call-button'
+</script>
+<template>
+  <!-- compact, above-the-fold mobile header affordance -->
+  <DcsCallButton variant="icon" />
+  <!-- icon + label + number for a nav/menu row or hero -->
+  <DcsCallButton variant="inline" />
+</template>
+```
+`business.phone` lives in `.dcs/content.yaml` under `global` (create-dcs-site scaffolds it empty):
+```yaml
+global:
+  business.phone: "(248) 385-2926"
+  business.name: Iron Oak Contractors
+```
+The number is read through `useTextContent`, so it is SSR-safe (no `window`/`document` at setup) and portal-editable. The component **renders nothing** until `business.phone` is set — it never fabricates a placeholder number into prod SSR. The `tel:` href strips formatting to digits (preserving a leading `+` for E.164), the visible number carries `data-dcs-text="business.phone"` for inline editing, and styling is themeable via `--dcs-call-*` custom properties (icon inherits `currentColor` and stays unobtrusive on desktop).
 Current first-party surfaces:
 - **Managed forms** — discovers `[data-form-key]`, reports

package/dist/chunk-DAYLLSEE.js ADDED Viewed

@@ -0,0 +1,3 @@
+//# sourceMappingURL=chunk-DAYLLSEE.js.map
+//# sourceMappingURL=chunk-DAYLLSEE.js.map

package/dist/{chunk-KCWMS7P4.js.map → chunk-DAYLLSEE.js.map} RENAMED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-~~KCWMS7P4~~.js"}
1	+ {"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-DAYLLSEE.js"}

package/dist/{chunk-UPAMLKOQ.js → chunk-F3EIWEZD.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import fs from 'fs';
+import fs2 from 'fs';
 import path from 'path';
 import yaml from 'js-yaml';
@@ -141,6 +141,16 @@ function buildReviewSchemaParts(items) {
   };
   return { review, aggregateRating };
 }
+var LICENSE_CREDENTIAL_CATEGORY = "license";
+function buildHasCredential(license) {
+  const value = typeof license === "string" ? license.trim() : "";
+  if (!value) return void 0;
+  return {
+    "@type": "EducationalOccupationalCredential",
+    credentialCategory: LICENSE_CREDENTIAL_CATEGORY,
+    name: value
+  };
+}
 function buildGlobalGraph(global, opts = {}) {
   const siteUrl = global.siteUrl ? trimSlash(global.siteUrl) : "";
   if (!siteUrl) return [];
@@ -183,6 +193,10 @@ function buildGlobalGraph(global, opts = {}) {
         localBusiness.aggregateRating = reviewParts.aggregateRating;
       }
     }
+    const credential = buildHasCredential(opts.license);
+    if (credential) {
+      localBusiness.hasCredential = credential;
+    }
     graph.push(localBusiness);
   }
   return [
@@ -306,6 +320,21 @@ function findReviewItemsForPage(content, pageSlug) {
   const page = content.pages?.[pageSlug];
   return fromBlock(page) ?? fromBlock(content.global) ?? [];
 }
+var BUSINESS_LICENSE_KEY = "business.license";
+function findBusinessLicense(content, pageSlug) {
+  if (!content) return void 0;
+  const fromBlock = (block) => {
+    if (!block) return void 0;
+    const raw = block[BUSINESS_LICENSE_KEY];
+    if (typeof raw === "string") {
+      const trimmed = raw.trim();
+      return trimmed.length > 0 ? trimmed : void 0;
+    }
+    if (typeof raw === "number" && Number.isFinite(raw)) return String(raw);
+    return void 0;
+  };
+  return fromBlock(content.pages?.[pageSlug]) ?? fromBlock(content.global);
+}
 function absolutizeUrl(value, siteUrl, fallback = "") {
   const v = (value ?? "").trim();
   if (!v) return fallback;
@@ -409,8 +438,8 @@ function resolvePageSeo(pageSlug, pagePath, seoConfig, fallbackTitle) {
   const page = seoConfig?.pages?.[pageSlug] ?? {};
   let canonical = page.canonical || "";
   if (!canonical && global.siteUrl) {
-    const path2 = pagePath ?? (pageSlug === "home" ? "/" : `/${pageSlug}`);
-    canonical = `${global.siteUrl.replace(/\/$/, "")}${path2}`;
+    const path3 = pagePath ?? (pageSlug === "home" ? "/" : `/${pageSlug}`);
+    canonical = `${global.siteUrl.replace(/\/$/, "")}${path3}`;
   }
   const pageSpecificTitle = page.title || fallbackTitle;
   let title;
@@ -492,7 +521,10 @@ function buildJsonLd(resolved, global, overrides) {
   const emitGraph = overrides?.emitGraph === true;
   let perSchema = resolved.schemas;
   if (emitGraph) {
-    const graph = buildGlobalGraph(global, { reviews: overrides?.reviews });
+    const graph = buildGlobalGraph(global, {
+      reviews: overrides?.reviews,
+      license: overrides?.license
+    });
     if (graph.length > 0) {
       out.push(...graph);
       perSchema = resolved.schemas.filter((s) => !graphAbsorbs(s, global));
@@ -597,7 +629,7 @@ function loadPagesManifest(projectRoot, relativePagesPath, debug = false) {
   ];
   let foundPath;
   for (const testPath of possiblePaths) {
-    if (fs.existsSync(testPath)) {
+    if (fs2.existsSync(testPath)) {
       foundPath = testPath;
       break;
     }
@@ -611,7 +643,7 @@ function loadPagesManifest(projectRoot, relativePagesPath, debug = false) {
   }
   let raw;
   try {
-    raw = yaml.load(fs.readFileSync(foundPath, "utf8"));
+    raw = yaml.load(fs2.readFileSync(foundPath, "utf8"));
   } catch (error) {
     console.warn(`[dcs-seo] Failed to parse ${foundPath}:`, error);
     return null;
@@ -832,6 +864,119 @@ function buildLlmsTxt(params) {
   }
   return out.join("\n") + "\n";
 }
+function routeToOutputFile(outDir, routePath) {
+  const trimmed = routePath.replace(/^\/+/, "").replace(/\/+$/, "");
+  if (trimmed === "") return path.join(outDir, "index.html");
+  return path.join(outDir, ...trimmed.split("/"), "index.html");
+}
+var BodyPrerenderError = class extends Error {
+  route;
+  errors;
+  constructor(route, errors) {
+    super(
+      `[dcs-seo] body prerender FAILED for route ${route}: ${errors.join(" | ")}. Refusing to ship a broken/empty body \u2014 fix the route or disable body prerender for this site (seo.yaml prerenderBody: false).`
+    );
+    this.name = "BodyPrerenderError";
+    this.route = route;
+    this.errors = errors;
+  }
+};
+function spliceBodyHtml(html, bodyInnerHtml) {
+  const openRe = /<div\s+[^>]*\bid=["']app["'][^>]*>/i;
+  const openMatch = openRe.exec(html);
+  if (!openMatch) return html;
+  const openEnd = openMatch.index + openMatch[0].length;
+  const tagRe = /<(\/?)div\b[^>]*>/gi;
+  tagRe.lastIndex = openEnd;
+  let depth = 1;
+  let closeStart = -1;
+  let m;
+  while ((m = tagRe.exec(html)) !== null) {
+    if (m[1] === "/") {
+      depth -= 1;
+      if (depth === 0) {
+        closeStart = m.index;
+        break;
+      }
+    } else {
+      depth += 1;
+    }
+  }
+  if (closeStart === -1) return html;
+  return html.slice(0, openEnd) + bodyInnerHtml + html.slice(closeStart);
+}
+async function prerenderBodies(params) {
+  const {
+    outDir,
+    routes,
+    renderer,
+    exclude = [],
+    noindex = [],
+    excludedGlobs = [],
+    debug = false
+  } = params;
+  const excludeSet = new Set(exclude);
+  const noindexSet = new Set(noindex);
+  let prerendered = 0;
+  let skipped = 0;
+  const done = [];
+  for (const route of routes) {
+    if (excludeSet.has(route.path) || route.slug && excludeSet.has(route.slug)) {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (excluded): ${route.path}`);
+      continue;
+    }
+    if (matchesExcludedGlob(route.path, excludedGlobs)) {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (excluded glob): ${route.path}`);
+      continue;
+    }
+    if (noindexSet.has(route.path) || route.slug && noindexSet.has(route.slug)) {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (noindex/auth): ${route.path}`);
+      continue;
+    }
+    const outFile = routeToOutputFile(outDir, route.path);
+    if (!fs2.existsSync(outFile)) {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (no head file): ${route.path}`);
+      continue;
+    }
+    const rendered = await renderer.renderRoute(route.path);
+    if (rendered.errors.length > 0) {
+      throw new BodyPrerenderError(route.path, rendered.errors);
+    }
+    const body = (rendered.bodyHtml ?? "").trim();
+    if (body === "") {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (empty render): ${route.path}`);
+      continue;
+    }
+    const html = fs2.readFileSync(outFile, "utf8");
+    const spliced = spliceBodyHtml(html, body);
+    if (spliced === html) {
+      skipped += 1;
+      if (debug) console.log(`[dcs-seo] body-prerender skip (no #app container): ${route.path}`);
+      continue;
+    }
+    fs2.writeFileSync(outFile, spliced, "utf8");
+    prerendered += 1;
+    done.push(route.path);
+    if (debug) {
+      console.log(
+        `[dcs-seo] body-prerender wrote ${path.relative(outDir, outFile)} (${body.length} bytes)`
+      );
+    }
+  }
+  return { prerendered, skipped, routes: done };
+}
+function isBodyPrerenderEnabled(input) {
+  if (!input.emitStaticHtml) return false;
+  if (input.preview) return false;
+  if (input.prerenderBodyOption === false) return false;
+  if (input.seoPrerenderBody === false) return false;
+  return true;
+}
 // src/seo/vitepressTransform.ts
 function defaultRelativePathToRoute(relativePath, params) {
@@ -865,7 +1010,8 @@ function buildVitePressSeoHead(pageData, options) {
     emitBlogPosting = false,
     blogMatch,
     emitFaq = false,
-    resolveReviews
+    resolveReviews,
+    resolveLicense
   } = options;
   const global = seoConfig?.global ?? {};
   const siteUrl = normaliseSiteUrl(global.siteUrl);
@@ -924,7 +1070,8 @@ function buildVitePressSeoHead(pageData, options) {
   let globalSchemas = resolved.schemas;
   if (emitGraph) {
     const reviews = resolveReviews?.(ctx);
-    const graph = buildGlobalGraph(global, { reviews });
+    const license = resolveLicense?.(ctx);
+    const graph = buildGlobalGraph(global, { reviews, license });
     if (graph.length > 0) {
       for (const obj of graph) head.push(ldScript(obj));
       globalSchemas = resolved.schemas.filter((s) => !graphAbsorbs(s, global));
@@ -1017,6 +1164,6 @@ function createSeoTransformPageData(options) {
   };
 }
-export { AI_BOTS, absolutizeUrl, breadcrumbTrailFromRoute, buildBlogPosting, buildBreadcrumbList, buildFaqPage, buildGlobalGraph, buildHeadTags, buildLlmsTxt, buildReviewSchemaParts, buildRobotsTxt, buildSitemapXml, buildVitePressSeoHead, createSeoTransformPageData, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, filterRealFaq, filterRealReviews, findLocalBusinessSchema, findReviewItemsForPage, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, graphAbsorbs, graphIds, isHandAuthoredRobotsAcceptable, isLocalBusinessType, isRouteIndexable, loadPagesManifest, matchesExcludedGlob, parsePagesManifest, renderHeadTags, resolvePageSeo, slugToTitle, spliceHeadHtml, stripManagedHeadTags };
-//# sourceMappingURL=chunk-UPAMLKOQ.js.map
-//# sourceMappingURL=chunk-UPAMLKOQ.js.map
+export { AI_BOTS, BodyPrerenderError, absolutizeUrl, breadcrumbTrailFromRoute, buildBlogPosting, buildBreadcrumbList, buildFaqPage, buildGlobalGraph, buildHasCredential, buildHeadTags, buildLlmsTxt, buildReviewSchemaParts, buildRobotsTxt, buildSitemapXml, buildVitePressSeoHead, createSeoTransformPageData, defaultRelativePathToRoute, deriveSameAs, escapeJsonLd, filterRealFaq, filterRealReviews, findBusinessLicense, findLocalBusinessSchema, findReviewItemsForPage, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, graphAbsorbs, graphIds, isBodyPrerenderEnabled, isHandAuthoredRobotsAcceptable, isLocalBusinessType, isRouteIndexable, loadPagesManifest, matchesExcludedGlob, parsePagesManifest, prerenderBodies, renderHeadTags, resolvePageSeo, routeToOutputFile, slugToTitle, spliceBodyHtml, spliceHeadHtml, stripManagedHeadTags };
+//# sourceMappingURL=chunk-F3EIWEZD.js.map
+//# sourceMappingURL=chunk-F3EIWEZD.js.map