@riverbankcms/sdk 0.79.0 → 0.80.0

package/dist/server/theme.mjs

@@ -34,14 +34,8 @@ var visibleHeadingDecorationFamilyValues = [
   "organic-squiggle",
   "short-center-rule"
 ];
-var visibleHeadingDecorationPlacementValues = [
-  "after-heading",
-  "between-heading-and-body",
-  "under-centered-heading"
-];
 var headingDecorationOverrideValues = [
   "site-default",
-  "on",
   "off"
 ];
 var headingDecorationColorTokenValues = [
@@ -1116,7 +1110,7 @@ var personalitiesById = new Map(
 );
 
 // ../theme-core/src/schema.ts
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 
 // ../theme-core/src/lib/media.ts
 import z5 from "zod";
@@ -1166,8 +1160,15 @@ var BUTTON_SIZE_NAMES = buttonSizeNameSchema.options;
 
 // ../theme-core/src/cards/types.ts
 import { z as z6 } from "zod";
+var cardVariantRoleValues = ["default", "alternative"];
+var boxlessCardVariantValue = "none";
 var cardSpacingSchema = z6.enum(["none", "compact", "cozy", "medium", "comfortable", "spacious"]);
 var gradientDirectionSchema2 = z6.enum(["to-r", "to-l", "to-t", "to-b", "to-tr", "to-tl", "to-br", "to-bl"]);
+var cardVariantRoleSchema = z6.enum(cardVariantRoleValues);
+var boxStylesCardVariantSchema = z6.enum([
+  ...cardVariantRoleValues,
+  boxlessCardVariantValue
+]);
 var cardBackgroundSchema = z6.discriminatedUnion("type", [
   z6.object({ type: z6.literal("solid"), colorToken: themeColorTokenSchema }),
   z6.object({
@@ -1182,6 +1183,24 @@ var cardBorderSchema = z6.object({
   widthClass: z6.string(),
   colorToken: themeColorTokenSchema
 });
+var cardCornerValueSchema = z6.enum([
+  "square",
+  "soft",
+  "rounded",
+  "pill",
+  "expressive"
+]);
+var cardAccentEdgeSchema = z6.object({
+  edge: z6.enum(["left", "top", "right", "bottom"]),
+  colorToken: themeColorTokenSchema,
+  width: z6.enum(["thin", "medium", "thick", "heavy"])
+});
+var cardCornerRadiiSchema = z6.object({
+  topLeft: cardCornerValueSchema.optional(),
+  topRight: cardCornerValueSchema.optional(),
+  bottomLeft: cardCornerValueSchema.optional(),
+  bottomRight: cardCornerValueSchema.optional()
+});
 var cardVariantSchema = z6.object({
   id: z6.string(),
   name: z6.string().min(1).max(20),
@@ -1190,6 +1209,8 @@ var cardVariantSchema = z6.object({
   // Appearance (token-based)
   background: cardBackgroundSchema,
   spacing: cardSpacingSchema,
+  // Optional foreground (card text) color, for cards on a strong fill.
+  foregroundToken: themeColorTokenSchema.optional(),
   // Optional overrides (uses theme defaults if not specified)
   shadow: z6.object({
     elevation: z6.enum(["none", "low", "medium", "high"]),
@@ -1197,8 +1218,12 @@ var cardVariantSchema = z6.object({
     position: z6.enum(["bottom", "bottom-right"]).default("bottom")
   }).optional(),
   corners: z6.enum(["square", "soft", "rounded", "pill"]).optional(),
+  // Per-corner radius override; wins over `corners` when set.
+  cornerRadii: cardCornerRadiiSchema.optional(),
   // Border (optional)
-  border: cardBorderSchema.optional()
+  border: cardBorderSchema.optional(),
+  // Single accent edge; replaces `border` when set.
+  accentEdge: cardAccentEdgeSchema.optional()
 });
 var cardSystemSchema = z6.object({
   variants: z6.array(cardVariantSchema).min(1).max(3)
@@ -1219,11 +1244,13 @@ var accordionIconSchema = z7.enum([
   // ⊕ becomes ⊖ (swap with fade)
 ]);
 var accordionSystemSchema = z7.object({
-  // Visual styling (solid color only - gradients can be added later if needed)
+  // Visual styling (solid color only - gradients can be added later if needed).
+  // null = no fill, so the accordion sits transparently on the section
+  // surface (used by open, boxless "divided" looks).
   background: z7.object({
     type: z7.literal("solid"),
     colorToken: themeColorTokenSchema
-  }),
+  }).nullable(),
   // Spacing (padding inside items)
   spacing: z7.enum(["none", "compact", "cozy", "medium", "comfortable", "spacious"]),
   // Border radius (null = inherit from theme.corners)
@@ -1250,8 +1277,16 @@ var accordionSystemSchema = z7.object({
   // Trigger (question) styling
   trigger: z7.object({
     textColorToken: themeColorTokenSchema,
-    fontWeight: z7.enum(["regular", "medium", "semibold", "bold"]).nullable()
+    fontWeight: z7.enum(["regular", "medium", "semibold", "bold"]).nullable(),
     // null = inherit from theme
+    // Question typography. Defaults keep the historical body-font look; set
+    // fontFamily 'heading' + a larger scale to give questions real presence.
+    fontFamily: z7.enum(["body", "heading"]).optional(),
+    // default 'body'
+    fontScale: z7.enum(["body", "md", "lg"]).optional(),
+    // default 'body'
+    letterSpacing: z7.enum(["normal", "tight", "wide"]).optional(),
+    textTransform: z7.enum(["none", "uppercase"]).optional()
   }),
   // Hover state styling
   hover: z7.object({
@@ -1259,6 +1294,17 @@ var accordionSystemSchema = z7.object({
     textColorToken: themeColorTokenSchema.optional(),
     borderColorToken: themeColorTokenSchema.optional()
   }),
+  // Open-state emphasis: how an expanded item is visually rewarded. All
+  // optional; omit for the historical "only the text recolors" behaviour.
+  openState: z7.object({
+    backgroundColorToken: themeColorTokenSchema.optional(),
+    triggerColorToken: themeColorTokenSchema.optional(),
+    accent: z7.object({
+      edge: z7.enum(["left", "top", "bottom"]),
+      colorToken: themeColorTokenSchema,
+      thickness: z7.enum(["thin", "medium", "thick"])
+    }).optional()
+  }).optional(),
   // Content (answer) styling
   content: z7.object({
     textColorToken: themeColorTokenSchema
@@ -1581,79 +1627,190 @@ var componentShadowSchema = z14.object({
   elevation: z14.enum(["none", "sm", "md", "lg", "xl", "2xl"]).default("sm")
 });
 
-// ../theme-core/src/utils/tokenOrColor.ts
+// ../theme-core/src/site-styles/logoBranding.ts
 import { z as z15 } from "zod";
-var tokenOrCssColorValueSchema = z15.string();
+var logoTextConfidenceValues = ["low", "medium", "high"];
+var logoAssetShapeValues = [
+  "none",
+  "horizontal",
+  "square",
+  "portrait",
+  "tall"
+];
+var logoKindValues = [
+  "mark",
+  "wordmark",
+  "lockup",
+  "badge",
+  "stacked-wordmark",
+  "unknown"
+];
+var logoDensityValues = ["simple", "detailed", "unknown"];
+var logoContainsTextSchema = z15.discriminatedUnion("kind", [
+  z15.object({
+    kind: z15.literal("contains-text"),
+    confidence: z15.enum(logoTextConfidenceValues),
+    text: z15.string().trim().min(1).max(200).optional()
+  }),
+  z15.object({
+    kind: z15.literal("no-text"),
+    confidence: z15.enum(logoTextConfidenceValues)
+  }),
+  z15.object({
+    kind: z15.literal("unknown"),
+    reason: z15.enum([
+      "analysis-unavailable",
+      "unsupported-file",
+      "low-confidence"
+    ])
+  })
+]);
+var logoAnalysisSourceSchema = z15.discriminatedUnion("kind", [
+  z15.object({ kind: z15.literal("none") }),
+  z15.object({
+    kind: z15.literal("deterministic"),
+    reason: z15.enum(["dimensions", "fallback"])
+  }),
+  z15.object({
+    kind: z15.literal("llm"),
+    model: z15.literal("gpt-5.4-mini"),
+    analyzedAt: z15.string().trim().min(1).max(80).optional()
+  }),
+  z15.object({ kind: z15.literal("manual-override") })
+]);
+var logoFactsSchema = z15.object({
+  shape: z15.enum(logoAssetShapeValues),
+  containsText: logoContainsTextSchema,
+  kind: z15.enum(logoKindValues),
+  density: z15.enum(logoDensityValues),
+  source: logoAnalysisSourceSchema
+});
+var brandDisplayModeValues = [
+  "auto",
+  "logo-only",
+  "logo-plus-title",
+  "title-only"
+];
+var logoAccommodationPatternValues = [
+  "title-only",
+  "inline-logo-only",
+  "inline-wordmark",
+  "inline-mark-with-title",
+  "logo-plate",
+  "centered-badge",
+  "popout-badge",
+  "centered-masthead",
+  "hero-badge"
+];
+var logoSizePolicyValues = [
+  "auto",
+  "compact",
+  "standard",
+  "generous",
+  "display"
+];
+
+// ../theme-core/src/site-styles/rawStyleFields.ts
+var themeV2RuntimeStyleFieldNames = [
+  "_frameStyles",
+  "_sectionStyles",
+  "_containerStyles",
+  "_cardStyles",
+  // styleGroup is legacy runtime transition wiring rather than a nested
+  // override object, but normal editors should still never see it directly.
+  "styleGroup"
+];
+var themeV2BlockSpecificRawStyleFieldNames = [
+  "_contentCardStyles",
+  "_heroLayoutStyles",
+  "_textCardStyles"
+];
+var themeV2NormalEditorRawStyleFieldNames = [
+  ...themeV2RuntimeStyleFieldNames,
+  ...themeV2BlockSpecificRawStyleFieldNames
+];
+var themeV2NormalEditorRawStyleFieldNameSet = new Set(
+  themeV2NormalEditorRawStyleFieldNames
+);
+var themeV2CompilerOwnedFieldNames = [
+  ...themeV2RuntimeStyleFieldNames,
+  ...themeV2BlockSpecificRawStyleFieldNames
+];
+var pageDesignEditorBackgroundOverrideOwner = "page-design-editor";
+
+// ../theme-core/src/utils/tokenOrColor.ts
+import { z as z16 } from "zod";
+var tokenOrCssColorValueSchema = z16.string();
 
 // ../theme-core/src/schema.ts
-var axesSchema = z16.object({
-  tone: z16.enum(["minimal", "classic", "bold"]),
-  energy: z16.enum(["calm", "vibrant"]),
-  density: z16.enum(["airy", "regular", "compact"]),
-  mediaBias: z16.enum(["text", "media", "mixed"]),
-  conversionBias: z16.enum(["low", "med", "high"]),
-  motion: z16.enum(["subtle", "standard", "expressive"])
-});
-var colourHexString = z16.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
-var paletteColorSchema = z16.object({
-  name: z16.string().min(1),
+var axesSchema = z17.object({
+  tone: z17.enum(["minimal", "classic", "bold"]),
+  energy: z17.enum(["calm", "vibrant"]),
+  density: z17.enum(["airy", "regular", "compact"]),
+  mediaBias: z17.enum(["text", "media", "mixed"]),
+  conversionBias: z17.enum(["low", "med", "high"]),
+  motion: z17.enum(["subtle", "standard", "expressive"])
+});
+var colourHexString = z17.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
+var paletteColorSchema = z17.object({
+  name: z17.string().min(1),
   hex: colourHexString
 });
-var paletteMetaSchema = z16.object({
-  mode: z16.enum(["light", "dark"])
+var paletteMetaSchema = z17.object({
+  mode: z17.enum(["light", "dark"])
 });
-var paletteSchema = z16.object({
-  colors: z16.array(paletteColorSchema),
+var paletteSchema = z17.object({
+  colors: z17.array(paletteColorSchema),
   meta: paletteMetaSchema
 });
-var typographyStyleSchema = z16.object({
-  family: z16.string().min(1),
-  weight: z16.enum(["light", "regular", "medium", "semibold", "bold"]),
-  letterSpacing: z16.enum(["tight", "normal", "loose"]),
-  lineHeight: z16.enum(["normal", "relaxed", "loose"])
+var typographyStyleSchema = z17.object({
+  family: z17.string().min(1),
+  weight: z17.enum(["light", "regular", "medium", "semibold", "bold"]),
+  letterSpacing: z17.enum(["tight", "normal", "loose"]),
+  lineHeight: z17.enum(["normal", "relaxed", "loose"])
 });
 var bodyTypographyStyleSchema = typographyStyleSchema.extend({
-  size: z16.enum(["md", "lg", "xl"])
+  size: z17.enum(["md", "lg", "xl"])
 });
-var headingSizeSchema = z16.enum(["xs", "sm", "md", "lg", "xl", "2xl"]);
-var headingTypographyOverridesSchema = z16.object({
-  weight: z16.enum(["light", "regular", "medium", "semibold", "bold"]).nullable().optional(),
-  letterSpacing: z16.enum(["tight", "normal", "loose"]).nullable().optional(),
+var headingSizeSchema = z17.enum(["xs", "sm", "md", "lg", "xl", "2xl"]);
+var headingTypographyOverridesSchema = z17.object({
+  weight: z17.enum(["light", "regular", "medium", "semibold", "bold"]).nullable().optional(),
+  letterSpacing: z17.enum(["tight", "normal", "loose"]).nullable().optional(),
   size: headingSizeSchema.nullable().optional(),
-  lineHeight: z16.enum(["normal", "relaxed", "loose"]).nullable().optional(),
-  italic: z16.boolean().nullable().optional(),
+  lineHeight: z17.enum(["normal", "relaxed", "loose"]).nullable().optional(),
+  italic: z17.boolean().nullable().optional(),
   colorToken: themeColorTokenSchema.nullable().optional()
 });
 var headingTypographyStyleSchema = typographyStyleSchema.extend({
-  case: z16.enum(["uppercase", "normal", "smallCaps"]).nullable(),
-  italic: z16.boolean().nullable(),
+  case: z17.enum(["uppercase", "normal", "smallCaps"]).nullable(),
+  italic: z17.boolean().nullable(),
   colorToken: themeColorTokenSchema.nullable().optional()
 });
-var proseLinkUnderlineStyleSchema = z16.enum(["solid", "dotted", "dashed"]);
-var proseLinkUnderlineThicknessSchema = z16.enum([
+var proseLinkUnderlineStyleSchema = z17.enum(["solid", "dotted", "dashed"]);
+var proseLinkUnderlineThicknessSchema = z17.enum([
   "auto",
   "fromFont",
   "thin",
   "medium",
   "thick"
 ]);
-var proseLinkUnderlineOffsetSchema = z16.enum([
+var proseLinkUnderlineOffsetSchema = z17.enum([
   "auto",
   "tight",
   "normal",
   "loose"
 ]);
-var proseLinkStyleSchema = z16.object({
+var proseLinkStyleSchema = z17.object({
   colorToken: themeColorTokenSchema.optional(),
   hoverColorToken: themeColorTokenSchema.optional(),
-  underline: z16.boolean().optional(),
+  underline: z17.boolean().optional(),
   decorationColorToken: themeColorTokenSchema.optional(),
   hoverDecorationColorToken: themeColorTokenSchema.optional(),
   underlineStyle: proseLinkUnderlineStyleSchema.optional(),
   underlineThickness: proseLinkUnderlineThicknessSchema.optional(),
   underlineOffset: proseLinkUnderlineOffsetSchema.optional()
 });
-var semanticSpacingSchema = z16.enum([
+var semanticSpacingSchema = z17.enum([
   "none",
   "compact",
   "cozy",
@@ -1661,91 +1818,108 @@ var semanticSpacingSchema = z16.enum([
   "comfortable",
   "spacious"
 ]);
-var boxRoundedSchema = z16.enum(["none", "sm", "md", "lg", "xl", "2xl", "full"]);
-var boxBackgroundOverlaySchema = z16.object({
-  type: z16.enum(["none", "color", "gradient"]).nullable().optional(),
+var boxRoundedSchema = z17.enum(["none", "sm", "md", "lg", "xl", "2xl", "full"]);
+var boxBackgroundOverlaySchema = z17.object({
+  type: z17.enum(["none", "color", "gradient"]).nullable().optional(),
   color: tokenOrCssColorValueSchema.nullable().optional(),
-  gradient: z16.string().nullable().optional(),
-  opacity: z16.number().min(0).max(1).nullable().optional()
+  gradient: z17.string().nullable().optional(),
+  opacity: z17.number().min(0).max(1).nullable().optional()
 });
-var boxBackgroundSchema = z16.object({
-  type: z16.enum(["color", "gradient", "image"]).optional(),
+var boxBackgroundSchema = z17.object({
+  type: z17.enum(["color", "gradient", "image"]).optional(),
+  contentOwner: z17.literal(pageDesignEditorBackgroundOverrideOwner).optional(),
   color: tokenOrCssColorValueSchema.nullable().optional(),
-  gradient: z16.string().nullable().optional(),
+  gradient: z17.string().nullable().optional(),
+  gradientPresetId: z17.string().min(1).nullable().optional(),
   image: mediaSchema.nullable().optional(),
-  objectFit: z16.enum(["fill", "fit", "original", "custom"]).nullable().optional(),
-  scale: z16.string().nullable().optional(),
-  position: z16.string().nullable().optional(),
-  opacity: z16.number().min(0).max(1).nullable().optional(),
-  motion: z16.enum(["static", "fixed-frame"]).nullable().optional(),
+  objectFit: z17.enum(["fill", "fit", "original", "custom"]).nullable().optional(),
+  scale: z17.string().nullable().optional(),
+  position: z17.string().nullable().optional(),
+  opacity: z17.number().min(0).max(1).nullable().optional(),
+  motion: z17.enum(["static", "fixed-frame"]).nullable().optional(),
   overlay: boxBackgroundOverlaySchema.nullable().optional(),
   textColor: tokenOrCssColorValueSchema.nullable().optional(),
   headingColor: tokenOrCssColorValueSchema.nullable().optional()
 });
-var noHeadingDecorationSchema = z16.object({
-  family: z16.literal("none"),
-  placement: z16.literal("none")
+var noHeadingDecorationSchema = z17.object({
+  family: z17.literal("none")
 });
-var visibleHeadingDecorationSchema = z16.object({
-  family: z16.enum(visibleHeadingDecorationFamilyValues),
-  placement: z16.enum(visibleHeadingDecorationPlacementValues),
-  colorToken: z16.enum(headingDecorationColorTokenValues).optional()
+var visibleHeadingDecorationSchema = z17.object({
+  family: z17.enum(visibleHeadingDecorationFamilyValues),
+  colorToken: z17.enum(headingDecorationColorTokenValues).optional()
 });
-var headingDecorationSchema = z16.union([
+var headingDecorationSchema = z17.union([
   noHeadingDecorationSchema,
   visibleHeadingDecorationSchema
 ]);
-var accordionIconTreatmentSchema = z16.object({
-  iconSet: z16.enum(accordionIconSetValues),
-  colorToken: z16.enum(accordionIconColorTokenValues),
-  openColorToken: z16.enum(accordionIconColorTokenValues).optional(),
-  motion: z16.enum(accordionIconMotionValues)
+var headingDecorationOverrideSchema = z17.union([
+  z17.enum(headingDecorationOverrideValues),
+  // Legacy authoring value from the earlier model. In the render-time model
+  // "on" cannot force a fragment into a block, so it is equivalent to default.
+  z17.literal("on").transform(() => "site-default")
+]);
+var accordionIconTreatmentSchema = z17.object({
+  iconSet: z17.enum(accordionIconSetValues),
+  colorToken: z17.enum(accordionIconColorTokenValues),
+  openColorToken: z17.enum(accordionIconColorTokenValues).optional(),
+  motion: z17.enum(accordionIconMotionValues)
 });
-var sectionStylesOverrideSchema = z16.object({
+var sectionStylesOverrideSchema = z17.object({
   background: boxBackgroundSchema.nullable().optional(),
   spacing: semanticSpacingSchema.nullable().optional(),
-  minHeight: z16.enum(["none", "banner", "hero", "immersive"]).nullable().optional(),
-  tileTreatment: z16.enum(tileTreatmentValues).nullable().optional(),
-  eventListTreatment: z16.enum(eventListTreatmentValues).nullable().optional(),
-  eyebrowTreatment: z16.enum(eyebrowTreatmentValues).nullable().optional(),
+  minHeight: z17.enum(["none", "banner", "hero", "immersive"]).nullable().optional(),
+  tileTreatment: z17.enum(tileTreatmentValues).nullable().optional(),
+  eventListTreatment: z17.enum(eventListTreatmentValues).nullable().optional(),
+  eyebrowTreatment: z17.enum(eyebrowTreatmentValues).nullable().optional(),
   headingDecoration: headingDecorationSchema.nullable().optional(),
-  // Author-level override consumed by later block/editor rendering phases.
-  // Keeping it in section styles lets existing block save APIs persist it.
-  headingDecorationOverride: z16.enum(headingDecorationOverrideValues).nullable().optional(),
+  // Author-level opt-out consumed by render-time theme projection. Persisted
+  // content may also carry legacy `headingDecoration` / `on` values; those are
+  // tolerated at the schema boundary but the renderer treats the compiled theme
+  // as the only source of the resolved signature.
+  headingDecorationOverride: headingDecorationOverrideSchema.nullable().optional(),
   accordionIconTreatment: accordionIconTreatmentSchema.nullable().optional()
 });
-var containerStylesOverrideSchema = z16.object({
+var containerStylesOverrideSchema = z17.object({
   background: boxBackgroundSchema.nullable().optional(),
   spacing: semanticSpacingSchema.nullable().optional(),
-  raised: z16.boolean().nullable().optional(),
+  raised: z17.boolean().nullable().optional(),
   rounded: boxRoundedSchema.nullable().optional(),
-  fullWidth: z16.boolean().nullable().optional()
+  fullWidth: z17.boolean().nullable().optional()
 });
-var cardBorderOverrideSchema = z16.object({
-  enabled: z16.boolean().nullable().optional(),
-  width: z16.enum(["none", "1", "2", "3"]).nullable().optional(),
+var cardBorderOverrideSchema = z17.object({
+  enabled: z17.boolean().nullable().optional(),
+  width: z17.enum(["none", "1", "2", "3"]).nullable().optional(),
   colorToken: themeColorTokenSchema.nullable().optional()
 });
-var cardStylesOverrideSchema = z16.object({
+var cardStylesOverrideSchema = z17.object({
   background: boxBackgroundSchema.nullable().optional(),
   border: cardBorderOverrideSchema.nullable().optional(),
   spacing: semanticSpacingSchema.nullable().optional(),
-  raised: z16.boolean().nullable().optional(),
+  raised: z17.boolean().nullable().optional(),
   rounded: boxRoundedSchema.nullable().optional(),
-  treatment: z16.enum(["accent-quote"]).nullable().optional()
-});
-var blockStyleOverridesSchema = z16.object({
+  treatment: z17.enum([
+    "accent-quote",
+    "editorial-rule",
+    "soft-panel",
+    "editorial-serif-quote",
+    "editorial-open"
+  ]).nullable().optional(),
+  // Which site-style card variant the card adopts (emits a `.card-{id}` class).
+  // 'none' is boxless. Driven by the block look via testimonialCardTreatment.
+  cardVariant: boxStylesCardVariantSchema.nullable().optional()
+});
+var blockStyleOverridesSchema = z17.object({
   sectionStyles: sectionStylesOverrideSchema.nullable().optional(),
   containerStyles: containerStylesOverrideSchema.nullable().optional(),
   cardStyles: cardStylesOverrideSchema.nullable().optional()
 });
-var blockThemeOverrideSchema = z16.object({
-  typography: z16.object({
+var blockThemeOverrideSchema = z17.object({
+  typography: z17.object({
     proseLinkStyle: proseLinkStyleSchema.optional()
   }).optional(),
   styles: blockStyleOverridesSchema.optional()
 });
-var typographyScaleSchema = z16.enum([
+var typographyScaleSchema = z17.enum([
   // New intuitive names
   "compact",
   // ratio 1.2 (was minorThird)
@@ -1758,9 +1932,9 @@ var typographyScaleSchema = z16.enum([
   "majorThird",
   "perfectFourth"
 ]);
-var typographySchema = z16.object({
+var typographySchema = z17.object({
   body: bodyTypographyStyleSchema,
-  headings: z16.object({
+  headings: z17.object({
     default: headingTypographyStyleSchema,
     h1: headingTypographyOverridesSchema,
     h2: headingTypographyOverridesSchema,
@@ -1773,41 +1947,41 @@ var typographySchema = z16.object({
   scale: typographyScaleSchema,
   proseLinkStyle: proseLinkStyleSchema.optional()
 });
-var spaceSchema = z16.enum(["comfortable", "standard", "dense"]);
-var corners = z16.enum(["square", "soft", "rounded", "pill"]);
-var shadow = z16.object({
-  elevation: z16.enum(["none", "low", "medium", "high"]),
-  softness: z16.enum(["crisp", "soft", "hard"]).nullable(),
-  position: z16.enum(["bottom", "bottom-right"]).default("bottom")
+var spaceSchema = z17.enum(["comfortable", "standard", "dense"]);
+var corners = z17.enum(["square", "soft", "rounded", "pill"]);
+var shadow = z17.object({
+  elevation: z17.enum(["none", "low", "medium", "high"]),
+  softness: z17.enum(["crisp", "soft", "hard"]).nullable(),
+  position: z17.enum(["bottom", "bottom-right"]).default("bottom")
 });
-var border = z16.object({
-  width: z16.enum(["none", "hairline", "thin", "thick"]),
-  style: z16.enum(["solid", "dashed"])
+var border = z17.object({
+  width: z17.enum(["none", "hairline", "thin", "thick"]),
+  style: z17.enum(["solid", "dashed"])
 });
-var motion = z16.object({
-  level: z16.enum(["off", "low", "medium", "high"]),
-  easing: z16.enum(["standard", "snappy", "gentle"]).nullable()
+var motion = z17.object({
+  level: z17.enum(["off", "low", "medium", "high"]),
+  easing: z17.enum(["standard", "snappy", "gentle"]).nullable()
 });
-var buttonStyle = z16.object({
+var buttonStyle = z17.object({
   shape: corners
   // Used for --radius-control CSS variable
 });
-var cardStyle = z16.object({
-  elevation: z16.enum(["none", "low", "medium", "high"]),
-  border: z16.enum(["none", "subtle", "defined"]),
+var cardStyle = z17.object({
+  elevation: z17.enum(["none", "low", "medium", "high"]),
+  border: z17.enum(["none", "subtle", "defined"]),
   shape: corners,
-  headerStyle: z16.enum(["plain", "accentBar", "subtleBg"]).nullable(),
-  mediaTreatment: z16.enum(["square", "rounded", "bleed"]).nullable()
+  headerStyle: z17.enum(["plain", "accentBar", "subtleBg"]).nullable(),
+  mediaTreatment: z17.enum(["square", "rounded", "bleed"]).nullable()
 });
-var inputStyle = z16.object({
+var inputStyle = z17.object({
   shape: corners,
-  border: z16.enum(["subtle", "defined", "underline"]),
-  focus: z16.enum(["glow", "ring", "underline"]),
-  label: z16.enum(["inside", "above"])
+  border: z17.enum(["subtle", "defined", "underline"]),
+  focus: z17.enum(["glow", "ring", "underline"]),
+  label: z17.enum(["inside", "above"])
 });
-var headerVariant = z16.enum(["classic", "centered", "transparent", "floating"]);
-var headerPositioning = z16.enum(["static", "sticky", "fixed"]);
-var headerNavStyle = z16.enum([
+var headerVariant = z17.enum(["classic", "centered", "transparent", "floating"]);
+var headerPositioning = z17.enum(["static", "sticky", "fixed"]);
+var headerNavStyle = z17.enum([
   "minimal",
   "underline",
   "underline-grow",
@@ -1816,54 +1990,57 @@ var headerNavStyle = z16.enum([
   "frosted",
   "solid"
 ]);
-var navFontWeight = z16.enum(["regular", "medium", "semibold", "bold"]);
-var headerMaxWidth = z16.enum(["container", "full"]);
-var headerContainerSchema = z16.object({
-  rounded: z16.enum(["none", "sm", "md", "lg", "xl", "2xl"]).default("xl"),
-  border: z16.boolean().default(true),
-  shadow: z16.boolean().default(true),
-  padding: z16.enum(["sm", "md", "lg"]).default("md"),
-  tint: z16.string().nullable().optional(),
-  opacity: z16.number().min(0).max(1).default(0.12)
+var navFontWeight = z17.enum(["regular", "medium", "semibold", "bold"]);
+var headerMaxWidth = z17.enum(["container", "full"]);
+var headerContainerSchema = z17.object({
+  rounded: z17.enum(["none", "sm", "md", "lg", "xl", "2xl"]).default("xl"),
+  border: z17.boolean().default(true),
+  shadow: z17.boolean().default(true),
+  padding: z17.enum(["sm", "md", "lg"]).default("md"),
+  tint: z17.string().nullable().optional(),
+  opacity: z17.number().min(0).max(1).default(0.12)
 }).optional();
 var headerBorderSchema = componentBorderSchema.extend({
-  position: z16.enum(["bottom", "top", "both", "none"]).default("bottom")
+  position: z17.enum(["bottom", "top", "both", "none"]).default("bottom")
 }).optional();
-var logoStyleSchema = z16.object({
-  fontFamily: z16.enum(["heading", "body"]).default("heading"),
-  letterSpacing: z16.enum(["normal", "wide", "wider", "widest"]).default("normal"),
-  gradient: z16.boolean().default(false)
+var logoStyleSchema = z17.object({
+  fontFamily: z17.enum(["heading", "body"]).default("heading"),
+  letterSpacing: z17.enum(["normal", "wide", "wider", "widest"]).default("normal"),
+  gradient: z17.boolean().default(false),
+  brandDisplay: z17.enum(brandDisplayModeValues).optional(),
+  size: z17.enum(logoSizePolicyValues).optional(),
+  accommodation: z17.enum(logoAccommodationPatternValues).optional()
 }).optional();
-var headerLogoTextSchema = z16.object({
-  mobileWrapLines: z16.union([z16.literal(1), z16.literal(2)]).optional(),
-  mobileMaxWidth: z16.enum(["xs", "sm", "md"]).optional(),
-  hideOnShrink: z16.boolean().optional()
+var headerLogoTextSchema = z17.object({
+  mobileWrapLines: z17.union([z17.literal(1), z17.literal(2)]).optional(),
+  mobileMaxWidth: z17.enum(["xs", "sm", "md"]).optional(),
+  hideOnShrink: z17.boolean().optional()
 }).optional();
-var navEffectsSchema = z16.object({
-  underlineGradient: z16.boolean().default(false),
-  glow: z16.boolean().default(false),
-  glowColor: z16.string().optional(),
-  neumorphic: z16.boolean().default(false)
+var navEffectsSchema = z17.object({
+  underlineGradient: z17.boolean().default(false),
+  glow: z17.boolean().default(false),
+  glowColor: z17.string().optional(),
+  neumorphic: z17.boolean().default(false)
 }).optional();
-var dropdownStyleSchema = z16.object({
+var dropdownStyleSchema = z17.object({
   // Container styling
   background: themeColorTokenSchema.default("surface"),
   textColor: themeColorTokenSchema.default("text"),
   borderColor: themeColorTokenSchema.nullable().default("border"),
-  shadow: z16.enum(["none", "sm", "md", "lg"]).default("md"),
-  borderRadius: z16.enum(["none", "sm", "md", "lg"]).default("md"),
+  shadow: z17.enum(["none", "sm", "md", "lg"]).default("md"),
+  borderRadius: z17.enum(["none", "sm", "md", "lg"]).default("md"),
   // Link hover states (explicit control)
   hoverBackground: themeColorTokenSchema.nullable().optional(),
   hoverTextColor: themeColorTokenSchema.nullable().optional(),
   // Typography
-  textTransform: z16.enum(["none", "uppercase", "capitalize"]).default("none"),
-  letterSpacing: z16.enum(["normal", "wide", "wider"]).default("normal"),
-  fontWeight: z16.enum(["regular", "medium", "semibold", "bold"]).optional(),
+  textTransform: z17.enum(["none", "uppercase", "capitalize"]).default("none"),
+  letterSpacing: z17.enum(["normal", "wide", "wider"]).default("normal"),
+  fontWeight: z17.enum(["regular", "medium", "semibold", "bold"]).optional(),
   // optional = inherit from navWeight
-  textSize: z16.enum(["xs", "sm", "base", "lg"]).optional()
+  textSize: z17.enum(["xs", "sm", "base", "lg"]).optional()
   // optional = no override (browser default)
 }).optional();
-var headerCtaGapSchema = z16.enum([
+var headerCtaGapSchema = z17.enum([
   "none",
   "tight",
   "compact",
@@ -1871,7 +2048,7 @@ var headerCtaGapSchema = z16.enum([
   "relaxed",
   "spacious"
 ]);
-var headerCtaTreatmentSchema = z16.enum([
+var headerCtaTreatmentSchema = z17.enum([
   "default",
   "primary",
   "secondary",
@@ -1879,22 +2056,22 @@ var headerCtaTreatmentSchema = z16.enum([
   "outline",
   "ghost"
 ]);
-var navContainerSchema = z16.object({
-  type: z16.enum(["none", "pill", "glass"]).default("none"),
-  tint: z16.string().nullable().optional(),
-  opacity: z16.number().min(0).max(1).default(0.15)
+var navContainerSchema = z17.object({
+  type: z17.enum(["none", "pill", "glass"]).default("none"),
+  tint: z17.string().nullable().optional(),
+  opacity: z17.number().min(0).max(1).default(0.15)
 }).default({ type: "none", tint: null, opacity: 0.15 });
-var headerBackgroundSchema = z16.object({
-  type: z16.enum(["color", "gradient", "image"]),
+var headerBackgroundSchema = z17.object({
+  type: z17.enum(["color", "gradient", "image"]),
   color: tokenOrCssColorValueSchema.nullable().optional(),
   gradient: gradientConfigSchema.nullable().optional(),
   image: mediaSchema.nullable().optional(),
   textColor: tokenOrCssColorValueSchema.nullable().optional()
 });
-var headerSchema = z16.object({
+var headerSchema = z17.object({
   variant: headerVariant,
   positioning: headerPositioning,
-  shrinkOnScroll: z16.boolean(),
+  shrinkOnScroll: z17.boolean(),
   maxWidth: headerMaxWidth,
   logoOverride: mediaSchema.nullable().optional(),
   background: headerBackgroundSchema.default({
@@ -1924,16 +2101,16 @@ var headerSchema = z16.object({
   // Optional theme-level CTA variant for header/nav CTA buttons.
   // Internal runtime bridge for the block renderer; prefer ctaTreatment in
   // authored Theme V2 concepts.
-  ctaVariant: z16.string().min(1).optional(),
+  ctaVariant: z17.string().min(1).optional(),
   // Dropdown menu styling (nav dropdowns and mobile drawer)
   dropdownStyle: dropdownStyleSchema
 });
-var footerVariant = z16.enum(["simple", "columns", "split"]);
-var footerMaxWidth = z16.enum(["container", "full"]);
-var footerMode = z16.enum(["default", "blocks", "default+blocks", "none"]);
-var footerNavLayoutMode = z16.enum(["stack", "inline", "inline-wrap"]);
-var footerNavLayoutAlign = z16.enum(["start", "center", "end", "space-between"]);
-var footerSpacing = z16.enum([
+var footerVariant = z17.enum(["simple", "columns", "split"]);
+var footerMaxWidth = z17.enum(["container", "full"]);
+var footerMode = z17.enum(["default", "blocks", "default+blocks", "none"]);
+var footerNavLayoutMode = z17.enum(["stack", "inline", "inline-wrap"]);
+var footerNavLayoutAlign = z17.enum(["start", "center", "end", "space-between"]);
+var footerSpacing = z17.enum([
   "none",
   "tight",
   "compact",
@@ -1941,44 +2118,44 @@ var footerSpacing = z16.enum([
   "relaxed",
   "spacious"
 ]);
-var footerLogoPlacement = z16.enum(["left", "right", "above", "below"]);
-var footerLogoSize = z16.enum(["sm", "md", "lg", "xl"]);
-var footerLogoMaxHeight = z16.enum(["sm", "md", "lg", "xl"]);
-var footerBottomTextLinkStyleSchema = z16.object({
+var footerLogoPlacement = z17.enum(["left", "right", "above", "below"]);
+var footerLogoSize = z17.enum(["sm", "md", "lg", "xl"]);
+var footerLogoMaxHeight = z17.enum(["sm", "md", "lg", "xl"]);
+var footerBottomTextLinkStyleSchema = z17.object({
   colorToken: themeColorTokenSchema.optional(),
   hoverColorToken: themeColorTokenSchema.nullable().optional(),
   decorationColorToken: themeColorTokenSchema.nullable().optional(),
-  underline: z16.boolean().optional()
+  underline: z17.boolean().optional()
 });
-var footerBottomBarSchema = z16.object({
-  enabled: z16.boolean().optional(),
-  fullBleed: z16.boolean().optional(),
+var footerBottomBarSchema = z17.object({
+  enabled: z17.boolean().optional(),
+  fullBleed: z17.boolean().optional(),
   background: headerBackgroundSchema.optional(),
   textColor: themeColorTokenSchema.nullable().optional(),
-  textAlign: z16.enum(["left", "center", "right"]).optional(),
+  textAlign: z17.enum(["left", "center", "right"]).optional(),
   paddingY: footerSpacing.optional(),
   paddingX: footerSpacing.optional(),
-  borderTop: z16.object({
+  borderTop: z17.object({
     colorToken: themeColorTokenSchema.nullable().optional(),
-    width: z16.enum(["none", "thin", "medium", "thick"]).optional()
+    width: z17.enum(["none", "thin", "medium", "thick"]).optional()
   }).optional()
 });
-var footerNavLayoutSchema = z16.object({
+var footerNavLayoutSchema = z17.object({
   layout: footerNavLayoutMode.optional(),
   align: footerNavLayoutAlign.optional(),
   gapX: footerSpacing.optional(),
   gapY: footerSpacing.optional(),
-  columns: z16.number().int().min(1).max(6).optional()
+  columns: z17.number().int().min(1).max(6).optional()
 });
-var footerLogoSchema = z16.object({
-  showLogo: z16.boolean().default(true),
-  showLogoText: z16.boolean().optional(),
+var footerLogoSchema = z17.object({
+  showLogo: z17.boolean().default(true),
+  showLogoText: z17.boolean().optional(),
   placement: footerLogoPlacement.optional(),
   size: footerLogoSize.optional(),
   maxHeight: footerLogoMaxHeight.optional(),
-  align: z16.enum(["start", "center", "end"]).optional()
+  align: z17.enum(["start", "center", "end"]).optional()
 });
-var footerSchema = z16.object({
+var footerSchema = z17.object({
   /**
    * SDK-only footer rendering mode.
    *
@@ -1987,7 +2164,7 @@ var footerSchema = z16.object({
   mode: footerMode.optional(),
   variant: footerVariant,
   maxWidth: footerMaxWidth,
-  showLogoText: z16.boolean().optional(),
+  showLogoText: z17.boolean().optional(),
   background: headerBackgroundSchema.default({
     type: "color",
     color: "surface"
@@ -2005,20 +2182,20 @@ var footerSchema = z16.object({
   logo: footerLogoSchema.optional(),
   bottomBar: footerBottomBarSchema.optional()
 });
-var containerPaddingPresetSchema = z16.enum([
+var containerPaddingPresetSchema = z17.enum([
   "tight",
   "compact",
   "default",
   "relaxed"
 ]);
-var layoutSchema = z16.object({
-  containerPadding: z16.object({
+var layoutSchema = z17.object({
+  containerPadding: z17.object({
     mobile: containerPaddingPresetSchema.optional(),
     tablet: containerPaddingPresetSchema.optional(),
     desktop: containerPaddingPresetSchema.optional()
   }).optional()
 }).optional();
-var heroTypographySizeSchema = z16.enum([
+var heroTypographySizeSchema = z17.enum([
   "sm",
   "base",
   "lg",
@@ -2030,19 +2207,19 @@ var heroTypographySizeSchema = z16.enum([
   "6xl",
   "editorial"
 ]);
-var heroTypographyLineHeightSchema = z16.enum([
+var heroTypographyLineHeightSchema = z17.enum([
   "tight",
   "snug",
   "normal",
   "relaxed"
 ]);
-var heroResponsiveTypographySchema = z16.object({
+var heroResponsiveTypographySchema = z17.object({
   headlineSize: heroTypographySizeSchema.optional(),
   headlineLineHeight: heroTypographyLineHeightSchema.optional(),
   subheadlineSize: heroTypographySizeSchema.optional(),
   subheadlineLineHeight: heroTypographyLineHeightSchema.optional()
 });
-var heroTypographySchema = z16.object({
+var heroTypographySchema = z17.object({
   headlineSize: heroTypographySizeSchema.optional(),
   headlineLineHeight: heroTypographyLineHeightSchema.optional(),
   subheadlineSize: heroTypographySizeSchema.optional(),
@@ -2051,31 +2228,38 @@ var heroTypographySchema = z16.object({
   microHeadlineLineHeight: heroTypographyLineHeightSchema.optional(),
   microSubheadlineSize: heroTypographySizeSchema.optional(),
   microSubheadlineLineHeight: heroTypographyLineHeightSchema.optional(),
-  responsive: z16.object({
+  responsive: z17.object({
     tablet: heroResponsiveTypographySchema.optional(),
     mobile: heroResponsiveTypographySchema.optional()
   }).optional()
 });
-var heroSchema = z16.object({
+var heroSchema = z17.object({
   typography: heroTypographySchema.optional()
 }).optional();
-var bodyTextIntroTypographySizeSchema = z16.enum(["default", "editorial"]);
-var bodyTextSchema = z16.object({
-  intro: z16.object({
+var bodyTextIntroTypographySizeSchema = z17.enum(["default", "editorial"]);
+var bodyTextSchema = z17.object({
+  intro: z17.object({
     paragraphSize: bodyTextIntroTypographySizeSchema.optional(),
     headingSize: bodyTextIntroTypographySizeSchema.optional()
   }).optional()
 }).optional();
-var gradientsSchema = z16.object({
-  button: z16.string().min(1).nullable().optional(),
-  hero: z16.string().min(1).nullable().optional(),
-  background: z16.string().min(1).nullable().optional()
-});
-var themeSchema = z16.object({
-  name: z16.string().min(1).max(30),
-  description: z16.string().min(1).max(400),
-  rationale: z16.string().min(1).max(400),
-  siteStyleId: z16.string().min(1).transform((value) => asSiteStyleId(value)).optional(),
+var gradientsSchema = z17.object({
+  button: z17.string().min(1).nullable().optional(),
+  hero: z17.string().min(1).nullable().optional(),
+  background: z17.string().min(1).nullable().optional()
+});
+var testimonialQuoteTreatmentSchema = z17.object({
+  style: z17.enum(["serif-display", "accent-glyph", "none"]),
+  fontFamily: z17.enum(["heading", "body"]).optional(),
+  scale: z17.enum(["sm", "md", "lg", "xl"]).optional(),
+  colorToken: themeColorTokenSchema.optional(),
+  opacity: z17.number().min(0).max(1).optional()
+});
+var themeSchema = z17.object({
+  name: z17.string().min(1).max(30),
+  description: z17.string().min(1).max(400),
+  rationale: z17.string().min(1).max(400),
+  siteStyleId: z17.string().min(1).transform((value) => asSiteStyleId(value)).optional(),
   axes: axesSchema,
   palette: paletteSchema,
   typography: typographySchema,
@@ -2096,6 +2280,8 @@ var themeSchema = z16.object({
   // Card variant system (optional for backwards compatibility)
   accordions: accordionSystemSchema.optional(),
   // Accordion system (optional - generated if not provided)
+  testimonialQuote: testimonialQuoteTreatmentSchema.optional(),
+  // Testimonial quote-mark treatment (site-style-owned)
   inputs: inputSystemSchema.optional(),
   // Input system (optional - generated if not provided)
   inputStyle: inputStyle.optional(),
@@ -2103,15 +2289,19 @@ var themeSchema = z16.object({
   // Block-specific customization (Tier 3)
   // blockCustomVars: Per-block CSS variable overrides as bare values
   // Example: { "event-registration": { "--step-color": "#6d28d9" } }
-  blockCustomVars: z16.record(
-    z16.string(),
+  blockCustomVars: z17.record(
+    z17.string(),
     // block kind (matches data-block attribute)
-    z16.record(z16.string(), z16.string())
+    z17.record(z17.string(), z17.string())
     // { '--var-name': 'value' }
   ).optional(),
   // Structured block-kind theme overrides (v1: typography prose-link style only)
   // Keyed by block kind (usually data-block value like "hero"; "block.hero" also accepted)
-  blockOverrides: z16.record(z16.string(), blockThemeOverrideSchema).optional(),
+  blockOverrides: z17.record(z17.string(), blockThemeOverrideSchema).optional(),
+  // Site-wide heading decoration signature (family + colour). Set once per Look
+  // and projected transiently onto eligible block headings at render time.
+  // Alignment is inherited from the heading, so no placement is stored.
+  headingDecoration: headingDecorationSchema.optional(),
   // Structured custom CSS rules
   // Validated, scoped, and safe by construction - no @import, remote url(), or global selectors
   customCssRules: customCssRulesSchema,
@@ -2145,11 +2335,11 @@ var themeSchema = z16.object({
    * }
    * ```
    */
-  styleGroups: z16.record(z16.string(), z16.array(z16.string())).optional()
+  styleGroups: z17.record(z17.string(), z17.array(z17.string())).optional()
 });
-var themesTurnSchema = z16.object({
-  message: z16.string().min(1),
-  themes: z16.array(themeSchema).length(3)
+var themesTurnSchema = z17.object({
+  message: z17.string().min(1),
+  themes: z17.array(themeSchema).length(3)
 });
 
 // src/theme/loader.ts