@tokenoftrust/storefront-runner 2.2.126 → 2.3.0

package/scripts/tenant/validate.mjs

@@ -34,9 +34,11 @@ import {
   BLOCK_PALETTE_SUPPORTED_CONTRACTS,
   FEATURED_PRODUCT_PRESENTATIONS,
   PROMO_TILE_PRESENTATIONS,
+  THEME_HEADING_LEVELS,
   isSafeRehostedAssetPath,
   isSafeRehostedAssetPathForTenant,
   isSafeStorefrontHref,
+  isThemeCssSize,
 } from "../../packages/public-runtime/src/extension-contract-values.mjs";
 import {
   foreignTenantSegments,
@@ -333,6 +335,25 @@ function validateScriptsDoc(doc, file, config) {
   return out;
 }
 
+/** theme.json `type.headings`: fixed heading sizes the renderer emits as --heading-<level>. */
+function validateThemeHeadings(theme, file) {
+  const out = [];
+  const headings = theme?.type?.headings;
+  if (headings === undefined) return out;
+  if (headings == null || typeof headings !== "object" || Array.isArray(headings)) {
+    return [mk(ERROR, "theme-token", file, "type.headings must be an object of hero/h1/h2/h3 sizes")];
+  }
+  for (const [level, size] of Object.entries(headings)) {
+    if (!(/** @type {readonly string[]} */ (THEME_HEADING_LEVELS)).includes(level)) {
+      out.push(mk(ERROR, "theme-token", file, `type.headings.${level} is not a heading level (use ${THEME_HEADING_LEVELS.join(", ")})`));
+    } else if (!isThemeCssSize(size)) {
+      out.push(mk(ERROR, "theme-token", file, `type.headings.${level} must be a CSS length such as "28px", "1.75rem" or "clamp(1.5rem, 4vw, 2rem)"`));
+    }
+  }
+  return out;
+}
+
+
 const SUPPORTED_BLOCK_CONTRACTS = new Set(BLOCK_PALETTE_SUPPORTED_CONTRACTS);
 const KNOWN_BLOCKS = new Set([
   "hero",
@@ -585,6 +606,9 @@ function validateHomeDoc(doc, file, tenantId) {
       validateVisualAsset(block.image, file, `${at}.image`, out, tenantId);
     }
     if (component === "hero" && block.slides !== undefined) validateHeroSlides(block.slides, file, at, out, tenantId);
+    if (component === "hero" && block.notice !== undefined && (typeof block.notice !== "string" || !block.notice.trim())) {
+      out.push(mk(ERROR, "block-prop", file, `${at}.notice must be a non-empty plain-text string`));
+    }
     if (component === "editorial" && block.image !== undefined) {
       validateVisualAsset(block.image, file, `${at}.image`, out, tenantId);
       if (typeof block.imageAlt !== "string") {
@@ -1088,12 +1112,14 @@ export function validateTenant(tenantDir, opts = {}) {
   // 2. theme.json — parse (a malformed one is a WHOLE-APP BUILD FAILURE)
   const themePath = located("theme.json");
   if (existsSync(themePath)) {
-    const { error } = readJsonSafe(themePath);
+    const { value: theme, error } = readJsonSafe(themePath);
     if (error) {
       findings.push(
         mk(ERROR, "theme-parse", rel(themePath),
           `invalid JSON: ${error}`, "theme.json is loaded by an eager Vite glob — a parse error fails the entire storefront build"),
       );
+    } else {
+      findings.push(...validateThemeHeadings(theme, rel(themePath)));
     }
   }