@bendyline/squisq 2.0.1 → 2.2.0

package/dist/{chunk-W4O2TX5I.js → chunk-C33GTPUZ.js}

@@ -1,9 +1,9 @@
 import {
   cloneAndFreezeData
-} from "./chunk-5J4HKRJF.js";
+} from "./chunk-BAOV476U.js";
 import {
   isTransitionType
-} from "./chunk-QE7TWGVT.js";
+} from "./chunk-4VOD55SX.js";
 
 // src/schemas/CustomTemplates.ts
 var FRONTMATTER_CUSTOM_TEMPLATES_KEY = "squisq-custom-templates";
@@ -142,8 +142,99 @@ function deriveScale(seedHex, spread = 0.15) {
   };
 }
 
+// src/schemas/PageStyle.ts
+var PAGE_SECTION_KINDS = [
+  "hero",
+  "banner",
+  "stat-band",
+  "quote-band",
+  "feature-split",
+  "media-figure",
+  "gallery",
+  "callout",
+  "card-grid",
+  "item-list",
+  "timeline-rail",
+  "table-section",
+  "canvas-embed",
+  "prose",
+  "footer"
+];
+var PAGE_DESIGN_FAMILIES = [
+  "clean",
+  "editorial",
+  "brutalist",
+  "terminal",
+  "cinematic",
+  "documentary",
+  "organic",
+  "soft"
+];
+var PAGE_SECTION_SPACINGS = ["compact", "comfortable", "generous"];
+var PAGE_DIVIDERS = [
+  "none",
+  "gap-only",
+  "hairline",
+  "thick-rule",
+  "double-rule",
+  "dotted"
+];
+var PAGE_BACKGROUND_RHYTHMS = [
+  "flat",
+  "alternate",
+  "accent-bands",
+  "tinted-panels"
+];
+var PAGE_HERO_STYLES = [
+  "stacked",
+  "split",
+  "full-bleed",
+  "letterbox",
+  "oversized-type"
+];
+var PAGE_EYEBROWS = ["none", "kicker", "numbered", "mono-tag"];
+var PAGE_HEADING_SCALES = ["regular", "display", "oversized"];
+var PAGE_HEADING_CASES = ["none", "uppercase"];
+var PAGE_HEADING_UNDERLINES = ["none", "accent-bar", "full-rule"];
+var PAGE_IMAGE_FRAMINGS = [
+  "flush",
+  "rounded",
+  "bordered",
+  "polaroid",
+  "letterboxed",
+  "circle-accent"
+];
+var PAGE_SHADOWS = ["none", "soft", "crisp", "heavy"];
+var PAGE_QUOTE_MARKS = ["none", "oversized-glyph", "accent-bar"];
+var PAGE_NUMERAL_STYLES = ["plain", "oversized", "boxed", "mono"];
+var PAGE_PATTERNS = ["none", "dots", "grid", "diagonal", "noise"];
+var PAGE_EMPHASES = ["lead", "strong", "standard", "quiet"];
+var PAGE_BACKGROUNDS = ["base", "alternate", "accent", "media"];
+var PAGE_ACCENT_STRATEGIES = ["primary-only", "cycle", "alternate-two", "none"];
+
 // src/schemas/themeValidator.ts
 var VALID_FALLBACK = /* @__PURE__ */ new Set(["serif", "sans-serif", "monospace", "system-ui"]);
+var VALID_SECTION_KINDS = new Set(PAGE_SECTION_KINDS);
+var VALID_DESIGN_FAMILIES = new Set(PAGE_DESIGN_FAMILIES);
+var VALID_PAGE_EMPHASES = new Set(PAGE_EMPHASES);
+var VALID_PAGE_BACKGROUNDS = new Set(PAGE_BACKGROUNDS);
+var VALID_ACCENT_STRATEGIES = new Set(PAGE_ACCENT_STRATEGIES);
+var PAGE_TOKEN_ENUMS = {
+  sectionSpacing: new Set(PAGE_SECTION_SPACINGS),
+  divider: new Set(PAGE_DIVIDERS),
+  backgroundRhythm: new Set(PAGE_BACKGROUND_RHYTHMS),
+  heroStyle: new Set(PAGE_HERO_STYLES),
+  imageFraming: new Set(PAGE_IMAGE_FRAMINGS),
+  shadow: new Set(PAGE_SHADOWS),
+  quoteMark: new Set(PAGE_QUOTE_MARKS),
+  numeralStyle: new Set(PAGE_NUMERAL_STYLES)
+};
+var HEADING_TREATMENT_ENUMS = {
+  eyebrow: { values: new Set(PAGE_EYEBROWS), required: true },
+  scale: { values: new Set(PAGE_HEADING_SCALES), required: true },
+  case: { values: new Set(PAGE_HEADING_CASES), required: false },
+  underline: { values: new Set(PAGE_HEADING_UNDERLINES), required: false }
+};
 var VALID_TITLE_WEIGHT = /* @__PURE__ */ new Set(["normal", "bold"]);
 var VALID_GRADIENT_PRESETS = /* @__PURE__ */ new Set([
   "dark-vignette",
@@ -232,6 +323,14 @@ var V = class {
       }
       if (!this.isString(c.name) || c.name.length === 0) {
         this.err(`${path}.custom.name`, "expected non-empty string");
+      } else if (/[<>{};]/.test(c.name) || [...c.name].some((char) => {
+        const code = char.codePointAt(0);
+        return code < 32 || code === 127;
+      })) {
+        this.err(
+          `${path}.custom.name`,
+          "font name contains control characters or CSS/HTML delimiters"
+        );
       }
       if (!this.isString(c.fallback) || !VALID_FALLBACK.has(c.fallback)) {
         this.err(
@@ -444,6 +543,130 @@ var V = class {
       arr.forEach((entry, i) => this.persistentLayer(`${path}.${side}[${i}]`, entry));
     }
   }
+  scalarHints(path, v) {
+    if (!this.isObject(v)) {
+      this.err(path, "expected object");
+      return;
+    }
+    for (const key of Object.keys(v)) {
+      const t = typeof v[key];
+      if (t !== "string" && t !== "number" && t !== "boolean") {
+        this.err(`${path}.${key}`, `expected string|number|boolean, got ${t}`);
+      }
+    }
+  }
+  pageSectionOverride(path, v) {
+    if (!this.isObject(v)) {
+      this.err(path, "expected object");
+      return;
+    }
+    if (v.kind !== void 0 && (!this.isString(v.kind) || !VALID_SECTION_KINDS.has(v.kind))) {
+      this.err(`${path}.kind`, `expected one of: ${PAGE_SECTION_KINDS.join(", ")}`);
+    }
+    if (v.variant !== void 0 && !this.isString(v.variant)) {
+      this.err(`${path}.variant`, "expected string");
+    }
+    if (v.emphasis !== void 0 && (!this.isString(v.emphasis) || !VALID_PAGE_EMPHASES.has(v.emphasis))) {
+      this.err(`${path}.emphasis`, `expected one of: ${PAGE_EMPHASES.join(", ")}`);
+    }
+    if (v.background !== void 0 && (!this.isString(v.background) || !VALID_PAGE_BACKGROUNDS.has(v.background))) {
+      this.err(`${path}.background`, `expected one of: ${PAGE_BACKGROUNDS.join(", ")}`);
+    }
+    if (v.hints !== void 0) this.scalarHints(`${path}.hints`, v.hints);
+  }
+  pageTokens(path, v) {
+    if (!this.isObject(v)) {
+      this.err(path, "expected object");
+      return;
+    }
+    for (const k of ["contentMaxWidth", "wideMaxWidth", "cornerRadius"]) {
+      if (!this.isNumber(v[k])) {
+        this.err(`${path}.${k}`, "expected number");
+      }
+    }
+    for (const [k, values] of Object.entries(PAGE_TOKEN_ENUMS)) {
+      if (!this.isString(v[k]) || !values.has(v[k])) {
+        this.err(`${path}.${k}`, `expected one of: ${Array.from(values).join(", ")}`);
+      }
+    }
+    if (v.pattern !== void 0) {
+      if (!this.isString(v.pattern) || !PAGE_PATTERNS.includes(v.pattern)) {
+        this.err(`${path}.pattern`, `expected one of: ${PAGE_PATTERNS.join(", ")}`);
+      }
+    }
+    const ht = v.headingTreatment;
+    if (!this.isObject(ht)) {
+      this.err(`${path}.headingTreatment`, "expected object");
+      return;
+    }
+    for (const [k, spec] of Object.entries(HEADING_TREATMENT_ENUMS)) {
+      const val = ht[k];
+      if (val === void 0) {
+        if (spec.required) this.err(`${path}.headingTreatment.${k}`, "required");
+        continue;
+      }
+      if (!this.isString(val) || !spec.values.has(val)) {
+        this.err(
+          `${path}.headingTreatment.${k}`,
+          `expected one of: ${Array.from(spec.values).join(", ")}`
+        );
+      }
+    }
+  }
+  pageStyle(path, v) {
+    if (!this.isObject(v)) {
+      this.err(path, "expected object");
+      return;
+    }
+    if (!this.isString(v.family) || !VALID_DESIGN_FAMILIES.has(v.family)) {
+      this.err(`${path}.family`, `expected one of: ${PAGE_DESIGN_FAMILIES.join(", ")}`);
+    }
+    if (v.tokens === void 0) {
+      this.err(`${path}.tokens`, "required");
+    } else {
+      this.pageTokens(`${path}.tokens`, v.tokens);
+    }
+    if (v.sections !== void 0) {
+      if (!this.isObject(v.sections)) {
+        this.err(`${path}.sections`, "expected object map");
+      } else {
+        for (const key of Object.keys(v.sections)) {
+          if (!VALID_SECTION_KINDS.has(key)) {
+            this.err(`${path}.sections.${key}`, `unknown section kind`);
+            continue;
+          }
+          this.pageSectionOverride(`${path}.sections.${key}`, v.sections[key]);
+        }
+      }
+    }
+    if (v.templates !== void 0) {
+      if (!this.isObject(v.templates)) {
+        this.err(`${path}.templates`, "expected object map");
+      } else {
+        for (const key of Object.keys(v.templates)) {
+          this.pageSectionOverride(`${path}.templates.${key}`, v.templates[key]);
+        }
+      }
+    }
+    if (v.accentRotation === void 0) {
+      this.err(`${path}.accentRotation`, "required");
+    } else if (!this.isObject(v.accentRotation)) {
+      this.err(`${path}.accentRotation`, "expected object");
+    } else {
+      const rotation = v.accentRotation;
+      if (!this.isString(rotation.strategy) || !VALID_ACCENT_STRATEGIES.has(rotation.strategy)) {
+        this.err(
+          `${path}.accentRotation.strategy`,
+          `expected one of: ${PAGE_ACCENT_STRATEGIES.join(", ")}`
+        );
+      }
+      if (rotation.schemes !== void 0) {
+        if (!Array.isArray(rotation.schemes) || rotation.schemes.some((s) => typeof s !== "string")) {
+          this.err(`${path}.accentRotation.schemes`, "expected array of strings");
+        }
+      }
+    }
+  }
 };
 function validateTheme(input) {
   const v = new V();
@@ -497,6 +720,9 @@ function validateTheme(input) {
   if (input.persistentLayers !== void 0) {
     v.persistentLayers("persistentLayers", input.persistentLayers);
   }
+  if (input.pageStyle !== void 0) {
+    v.pageStyle("pageStyle", input.pageStyle);
+  }
   if (v.errors.length === 0) {
     return { valid: true, errors: [], theme: input };
   }
@@ -671,6 +897,30 @@ var standard_default = {
       text: "#115e59",
       accent: "#0d9488"
     }
+  },
+  pageStyle: {
+    family: "clean",
+    tokens: {
+      contentMaxWidth: 760,
+      wideMaxWidth: 1100,
+      sectionSpacing: "comfortable",
+      cornerRadius: 8,
+      divider: "hairline",
+      backgroundRhythm: "alternate",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "regular",
+        underline: "none"
+      },
+      imageFraming: "rounded",
+      shadow: "soft",
+      quoteMark: "accent-bar",
+      numeralStyle: "plain"
+    },
+    accentRotation: {
+      strategy: "cycle"
+    }
   }
 };
 
@@ -758,6 +1008,30 @@ var standard_dark_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "clean",
+    tokens: {
+      contentMaxWidth: 760,
+      wideMaxWidth: 1100,
+      sectionSpacing: "comfortable",
+      cornerRadius: 8,
+      divider: "hairline",
+      backgroundRhythm: "tinted-panels",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "regular",
+        underline: "none"
+      },
+      imageFraming: "rounded",
+      shadow: "none",
+      quoteMark: "accent-bar",
+      numeralStyle: "oversized"
+    },
+    accentRotation: {
+      strategy: "cycle"
+    }
   }
 };
 
@@ -856,6 +1130,35 @@ var documentary_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "documentary",
+    tokens: {
+      contentMaxWidth: 680,
+      wideMaxWidth: 1e3,
+      sectionSpacing: "generous",
+      cornerRadius: 2,
+      divider: "thick-rule",
+      backgroundRhythm: "flat",
+      heroStyle: "letterbox",
+      headingTreatment: {
+        eyebrow: "numbered",
+        scale: "display",
+        underline: "none"
+      },
+      imageFraming: "letterboxed",
+      shadow: "none",
+      quoteMark: "accent-bar",
+      numeralStyle: "boxed"
+    },
+    sections: {
+      "quote-band": {
+        variant: "editorial"
+      }
+    },
+    accentRotation: {
+      strategy: "primary-only"
+    }
   }
 };
 
@@ -903,6 +1206,35 @@ var minimalist_default = {
     red: { bg: "#fff5f5", text: "#c53030", accent: "#e53e3e" },
     orange: { bg: "#fffaf0", text: "#c05621", accent: "#dd6b20" },
     teal: { bg: "#e6fffa", text: "#285e61", accent: "#319795" }
+  },
+  pageStyle: {
+    family: "clean",
+    tokens: {
+      contentMaxWidth: 720,
+      wideMaxWidth: 1e3,
+      sectionSpacing: "generous",
+      cornerRadius: 8,
+      divider: "gap-only",
+      backgroundRhythm: "flat",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "none",
+        scale: "display",
+        underline: "none"
+      },
+      imageFraming: "flush",
+      shadow: "none",
+      quoteMark: "none",
+      numeralStyle: "plain"
+    },
+    sections: {
+      "quote-band": {
+        emphasis: "quiet"
+      }
+    },
+    accentRotation: {
+      strategy: "primary-only"
+    }
   }
 };
 
@@ -953,6 +1285,35 @@ var bold_default = {
     red: { bg: "#1a202c", text: "#fc8181", accent: "#feb2b2" },
     orange: { bg: "#1a202c", text: "#f6ad55", accent: "#fbd38d" },
     teal: { bg: "#1a202c", text: "#4fd1c5", accent: "#81e6d9" }
+  },
+  pageStyle: {
+    family: "brutalist",
+    tokens: {
+      contentMaxWidth: 760,
+      wideMaxWidth: 1200,
+      sectionSpacing: "compact",
+      cornerRadius: 0,
+      divider: "thick-rule",
+      backgroundRhythm: "accent-bands",
+      heroStyle: "oversized-type",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "oversized",
+        case: "uppercase"
+      },
+      imageFraming: "bordered",
+      shadow: "heavy",
+      quoteMark: "none",
+      numeralStyle: "oversized"
+    },
+    sections: {
+      "quote-band": {
+        background: "accent"
+      }
+    },
+    accentRotation: {
+      strategy: "cycle"
+    }
   }
 };
 
@@ -1040,6 +1401,38 @@ var morning_light_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "soft",
+    tokens: {
+      contentMaxWidth: 760,
+      wideMaxWidth: 1100,
+      sectionSpacing: "comfortable",
+      cornerRadius: 14,
+      divider: "dotted",
+      backgroundRhythm: "tinted-panels",
+      heroStyle: "split",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "regular",
+        underline: "none"
+      },
+      imageFraming: "rounded",
+      shadow: "soft",
+      quoteMark: "oversized-glyph",
+      numeralStyle: "plain",
+      pattern: "noise"
+    },
+    sections: {
+      callout: {
+        hints: {
+          framing: "circle-accent"
+        }
+      }
+    },
+    accentRotation: {
+      strategy: "alternate-two"
+    }
   }
 };
 
@@ -1143,6 +1536,48 @@ var tech_dark_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "terminal",
+    tokens: {
+      contentMaxWidth: 820,
+      wideMaxWidth: 1200,
+      sectionSpacing: "compact",
+      cornerRadius: 2,
+      divider: "hairline",
+      backgroundRhythm: "tinted-panels",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "mono-tag",
+        scale: "regular",
+        underline: "none"
+      },
+      imageFraming: "bordered",
+      shadow: "none",
+      quoteMark: "none",
+      numeralStyle: "mono",
+      pattern: "grid"
+    },
+    templates: {
+      diagram: {
+        hints: {
+          frame: "terminal"
+        }
+      },
+      tree: {
+        hints: {
+          frame: "terminal"
+        }
+      },
+      timeline: {
+        hints: {
+          frame: "terminal"
+        }
+      }
+    },
+    accentRotation: {
+      strategy: "primary-only"
+    }
   }
 };
 
@@ -1234,6 +1669,43 @@ var magazine_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "editorial",
+    tokens: {
+      contentMaxWidth: 720,
+      wideMaxWidth: 1240,
+      sectionSpacing: "comfortable",
+      cornerRadius: 6,
+      divider: "double-rule",
+      backgroundRhythm: "flat",
+      heroStyle: "split",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "display",
+        underline: "none"
+      },
+      imageFraming: "flush",
+      shadow: "none",
+      quoteMark: "oversized-glyph",
+      numeralStyle: "oversized",
+      pattern: "diagonal"
+    },
+    sections: {
+      prose: {
+        hints: {
+          dropCap: true
+        }
+      },
+      "feature-split": {
+        hints: {
+          alternate: true
+        }
+      }
+    },
+    accentRotation: {
+      strategy: "alternate-two"
+    }
   }
 };
 
@@ -1347,6 +1819,38 @@ var cinematic_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "cinematic",
+    tokens: {
+      contentMaxWidth: 760,
+      wideMaxWidth: 1100,
+      sectionSpacing: "generous",
+      cornerRadius: 0,
+      divider: "gap-only",
+      backgroundRhythm: "flat",
+      heroStyle: "full-bleed",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "display",
+        case: "uppercase"
+      },
+      imageFraming: "letterboxed",
+      shadow: "none",
+      quoteMark: "none",
+      numeralStyle: "oversized",
+      pattern: "noise"
+    },
+    sections: {
+      "quote-band": {
+        hints: {
+          vignette: true
+        }
+      }
+    },
+    accentRotation: {
+      strategy: "primary-only"
+    }
   }
 };
 
@@ -1399,6 +1903,30 @@ var warm_earth_default = {
         config: { type: "gradientBackground", preset: "earth-tones" }
       }
     ]
+  },
+  pageStyle: {
+    family: "organic",
+    tokens: {
+      contentMaxWidth: 740,
+      wideMaxWidth: 1080,
+      sectionSpacing: "comfortable",
+      cornerRadius: 12,
+      divider: "thick-rule",
+      backgroundRhythm: "tinted-panels",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "regular",
+        underline: "accent-bar"
+      },
+      imageFraming: "polaroid",
+      shadow: "soft",
+      quoteMark: "oversized-glyph",
+      numeralStyle: "boxed"
+    },
+    accentRotation: {
+      strategy: "alternate-two"
+    }
   }
 };
 
@@ -1494,6 +2022,36 @@ var gezellig_default = {
         }
       }
     ]
+  },
+  pageStyle: {
+    family: "soft",
+    tokens: {
+      contentMaxWidth: 740,
+      wideMaxWidth: 1060,
+      sectionSpacing: "comfortable",
+      cornerRadius: 16,
+      divider: "dotted",
+      backgroundRhythm: "tinted-panels",
+      heroStyle: "stacked",
+      headingTreatment: {
+        eyebrow: "kicker",
+        scale: "regular",
+        case: "none"
+      },
+      imageFraming: "circle-accent",
+      shadow: "soft",
+      quoteMark: "oversized-glyph",
+      numeralStyle: "plain",
+      pattern: "noise"
+    },
+    sections: {
+      "quote-band": {
+        background: "alternate"
+      }
+    },
+    accentRotation: {
+      strategy: "alternate-two"
+    }
   }
 };
 
@@ -1711,7 +2269,7 @@ function resolveFontFamily(family, roleFallback) {
   if ("custom" in family) {
     const { name, fallback } = family.custom;
     const fb = fallback === "system-ui" ? "system-ui, sans-serif" : fallback === "serif" ? "Georgia, serif" : fallback === "monospace" ? "Consolas, monospace" : "system-ui, sans-serif";
-    const safeName = name.includes(" ") || name.includes(",") ? `"${name}"` : name;
+    const safeName = `"${name.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/[\n\r\f]/g, (ch) => `\\${ch.codePointAt(0).toString(16)} `).replace(/</g, "\\3c ")}"`;
     return `${safeName}, ${fb}`;
   }
   return roleFallback;
@@ -1789,6 +2347,24 @@ export {
   contrastRatio,
   pickContrastingText,
   deriveScale,
+  PAGE_SECTION_KINDS,
+  PAGE_DESIGN_FAMILIES,
+  PAGE_SECTION_SPACINGS,
+  PAGE_DIVIDERS,
+  PAGE_BACKGROUND_RHYTHMS,
+  PAGE_HERO_STYLES,
+  PAGE_EYEBROWS,
+  PAGE_HEADING_SCALES,
+  PAGE_HEADING_CASES,
+  PAGE_HEADING_UNDERLINES,
+  PAGE_IMAGE_FRAMINGS,
+  PAGE_SHADOWS,
+  PAGE_QUOTE_MARKS,
+  PAGE_NUMERAL_STYLES,
+  PAGE_PATTERNS,
+  PAGE_EMPHASES,
+  PAGE_BACKGROUNDS,
+  PAGE_ACCENT_STRATEGIES,
   validateTheme,
   assertTheme,
   FRONTMATTER_CUSTOM_THEMES_KEY,
@@ -1812,4 +2388,3 @@ export {
   guessFontFallback,
   matchFontFamily
 };
-//# sourceMappingURL=chunk-W4O2TX5I.js.map