@riverbankcms/sdk 0.102.0 → 0.104.0

package/dist/server/theme-bridge.mjs

@@ -2509,7 +2509,8 @@ const navLinkTextSizeSchema = z$1.enum([
 	"xs",
 	"sm",
 	"base",
-	"lg"
+	"lg",
+	"xl"
 ]);
 /**
 * Letter spacing options for nav links.
@@ -2839,6 +2840,9 @@ function asDesignBlockId(value) {
 function asAppearancePresetId(value) {
 	return brandNonEmptyString(value, "AppearancePresetId");
 }
+function asBoundaryOptionId(value) {
+	return brandNonEmptyString(value, "BoundaryOptionId");
+}
 function asSiteStyleId(value) {
 	const siteStyleId = brandNonEmptyString(value, "SiteStyleId");
 	if (!siteStyleId.startsWith("site-style:")) throw new Error(`SiteStyleId must start with "site-style:". Received: ${value}`);
@@ -3609,6 +3613,8 @@ const headerSchema = z$1.object({
 	navStyle: headerNavStyle,
 	navColor: themeColorTokenSchema.nullable().optional(),
 	navWeight: navFontWeight.default("medium"),
+	navTypography: z$1.enum(["body", "heading"]).optional(),
+	navTextSize: navLinkStyleSchema.shape.textSize,
 	container: headerContainerSchema,
 	border: headerBorderSchema,
 	shadow: componentShadowSchema.optional(),
@@ -3973,36 +3979,108 @@ function generateShadowCssVars(theme) {
 	};
 }
 //#endregion
-//#region ../theme-core/src/palette/variants/types.ts
-function asPaletteVariantId(value) {
-	if (value.length === 0) throw new Error("PaletteVariantId must be a non-empty string");
+//#region ../theme-core/src/palette/colors.ts
+const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/;
+const NORMALIZABLE_HEX_REGEX = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
+const hexColorSchema = z$1.string().regex(HEX_COLOR_REGEX, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
+const paletteModeSchema = z$1.enum(["light", "dark"]);
+z$1.string().regex(/^[0-9a-f]{64}$/, "Palette hash must be a lowercase SHA-256 value").transform((value) => value);
+const paletteColorsSchema = z$1.object({
+	primary: hexColorSchema,
+	primaryForeground: hexColorSchema,
+	secondary: hexColorSchema,
+	accent: hexColorSchema,
+	success: hexColorSchema,
+	warning: hexColorSchema,
+	destructive: hexColorSchema,
+	background: hexColorSchema,
+	surface: hexColorSchema,
+	surfaceAlt: hexColorSchema,
+	muted: hexColorSchema,
+	text: hexColorSchema,
+	border: hexColorSchema
+}).strict().transform((value) => value);
+function normalizePaletteHex(value) {
+	if (!NORMALIZABLE_HEX_REGEX.test(value)) return null;
+	const normalized = value.toLowerCase();
+	if (normalized.length === 7) return normalized;
+	const triplet = normalized.slice(1);
+	const red = triplet.charAt(0);
+	const green = triplet.charAt(1);
+	const blue = triplet.charAt(2);
+	return `#${red}${red}${green}${green}${blue}${blue}`;
+}
+function paletteColorsFromEntries(entries) {
+	const values = {};
+	for (const entry of entries) {
+		const parsedRole = paletteTokenNameSchema.safeParse(entry.name);
+		if (!parsedRole.success) return {
+			ok: false,
+			error: {
+				kind: "unknown-role",
+				role: entry.name
+			}
+		};
+		const role = parsedRole.data;
+		if (values[role] !== void 0) return {
+			ok: false,
+			error: {
+				kind: "duplicate-role",
+				role
+			}
+		};
+		const hex = normalizePaletteHex(entry.hex);
+		if (!hex) return {
+			ok: false,
+			error: {
+				kind: "invalid-color",
+				role,
+				value: entry.hex
+			}
+		};
+		values[role] = hex;
+	}
+	const missing = PALETTE_TOKEN_NAMES.filter((role) => values[role] === void 0);
+	if (missing.length > 0) return {
+		ok: false,
+		error: {
+			kind: "missing-roles",
+			roles: missing
+		}
+	};
+	return {
+		ok: true,
+		colors: paletteColorsSchema.parse(values)
+	};
+}
+function requirePaletteColorsFromEntries(entries) {
+	const result = paletteColorsFromEntries(entries);
+	if (result.ok) return result.colors;
+	throw new Error(`Invalid complete palette: ${result.error.kind}`);
+}
+//#endregion
+//#region ../theme-core/src/palette/curated/types.ts
+function asCuratedPaletteId(value) {
+	if (value.length === 0) throw new Error("CuratedPaletteId must be a non-empty string");
 	return value;
 }
-const paletteVariantIdSchema = z$1.string().min(1).transform((value) => asPaletteVariantId(value));
-const hexColorSchema = z$1.string().regex(/^#[0-9a-f]{6}$/, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
-/**
-* Variant-local palette colour schema. Tightens `paletteColorSchema` (which
-* accepts any non-empty `name`) so unknown token names like `'priamry'` cannot
-* be parsed into a curated variant; the runtime contract and the static
-* `PaletteColor` type now agree.
-*/
-const variantPaletteColorSchema = paletteColorSchema.extend({ name: paletteTokenNameSchema });
+const curatedPaletteIdSchema = z$1.string().min(1).transform((value) => asCuratedPaletteId(value));
 z$1.object({
-	id: paletteVariantIdSchema,
+	id: curatedPaletteIdSchema,
 	name: z$1.string().min(1),
 	description: z$1.string().min(1),
 	tags: styleTagsSchema,
-	mode: z$1.enum(["light", "dark"]),
-	colors: z$1.array(variantPaletteColorSchema).min(1)
+	mode: paletteModeSchema,
+	colors: paletteColorsSchema
 });
-function definePaletteVariant(input) {
+function defineCuratedPalette(input) {
 	return {
-		id: asPaletteVariantId(input.id),
+		id: asCuratedPaletteId(input.id),
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
 		mode: input.mode,
-		colors: input.colors
+		colors: requirePaletteColorsFromEntries(input.colors)
 	};
 }
 z$1.object({
@@ -4021,12 +4099,12 @@ z$1.object({
 	border: hexColorSchema.optional()
 }).strict().transform((value) => value);
 //#endregion
-//#region ../theme-core/src/palette/variants/brand-led.ts
+//#region ../theme-core/src/palette/curated/brand-led.ts
 /**
 * Brand-led family — confident, modern, contemporary brand voices. Pairs
 * with Clear Professional, Bright Community, Practical Services site styles.
 */
-const brandLedCool = definePaletteVariant({
+const brandLedCool = defineCuratedPalette({
 	id: "brand-led-cool",
 	name: "Brand-led — Cool",
 	description: "Confident blue primary with slate neutrals.",
@@ -4091,7 +4169,7 @@ const brandLedCool = definePaletteVariant({
 		}
 	]
 });
-const brandLedWarm = definePaletteVariant({
+const brandLedWarm = defineCuratedPalette({
 	id: "brand-led-warm",
 	name: "Brand-led — Warm",
 	description: "Sunset orange primary with warm grey neutrals.",
@@ -4156,7 +4234,7 @@ const brandLedWarm = definePaletteVariant({
 		}
 	]
 });
-const brandLedJewel = definePaletteVariant({
+const brandLedJewel = defineCuratedPalette({
 	id: "brand-led-jewel",
 	name: "Brand-led — Jewel",
 	description: "Deep emerald primary with rich neutrals.",
@@ -4221,7 +4299,7 @@ const brandLedJewel = definePaletteVariant({
 		}
 	]
 });
-const brandLedBurgundyGold = definePaletteVariant({
+const brandLedBurgundyGold = defineCuratedPalette({
 	id: "brand-led-burgundy-gold",
 	name: "Brand-led — Burgundy Gold",
 	description: "Deep burgundy with warm gold accents and soft neutral grounds.",
@@ -4287,12 +4365,12 @@ const brandLedBurgundyGold = definePaletteVariant({
 	]
 });
 //#endregion
-//#region ../theme-core/src/palette/variants/high-contrast.ts
+//#region ../theme-core/src/palette/curated/high-contrast.ts
 /**
 * High-contrast family — editorial and minimal voices with high legibility.
 * Pairs with Quiet Luxury, Bold Launch, Practical Services site styles.
 */
-const highContrastInk = definePaletteVariant({
+const highContrastInk = defineCuratedPalette({
 	id: "high-contrast-ink",
 	name: "High Contrast — Ink",
 	description: "Near-black primary with cool greys.",
@@ -4357,7 +4435,7 @@ const highContrastInk = definePaletteVariant({
 		}
 	]
 });
-const highContrastCharcoal = definePaletteVariant({
+const highContrastCharcoal = defineCuratedPalette({
 	id: "high-contrast-charcoal",
 	name: "High Contrast — Charcoal",
 	description: "Warm charcoal primary on a soft cream ground.",
@@ -4422,7 +4500,7 @@ const highContrastCharcoal = definePaletteVariant({
 		}
 	]
 });
-const highContrastMonochrome = definePaletteVariant({
+const highContrastMonochrome = defineCuratedPalette({
 	id: "high-contrast-monochrome",
 	name: "High Contrast — Monochrome",
 	description: "Pure black-on-white with a single saturated accent.",
@@ -4488,12 +4566,12 @@ const highContrastMonochrome = definePaletteVariant({
 	]
 });
 //#endregion
-//#region ../theme-core/src/palette/variants/soft-natural.ts
+//#region ../theme-core/src/palette/curated/soft-natural.ts
 /**
 * Soft-natural family — calm, organic, plant-led voices. Pairs with Calm
 * Studio, Modern Wellness, Warm Editorial site styles.
 */
-const softNaturalSage = definePaletteVariant({
+const softNaturalSage = defineCuratedPalette({
 	id: "soft-natural-sage",
 	name: "Soft Natural — Sage",
 	description: "Olive sage primary on an off-white ground.",
@@ -4558,7 +4636,7 @@ const softNaturalSage = definePaletteVariant({
 		}
 	]
 });
-const softNaturalStone = definePaletteVariant({
+const softNaturalStone = defineCuratedPalette({
 	id: "soft-natural-stone",
 	name: "Soft Natural — Stone",
 	description: "River-stone grey-green primary with cool neutrals.",
@@ -4623,7 +4701,7 @@ const softNaturalStone = definePaletteVariant({
 		}
 	]
 });
-const softNaturalWatercolor = definePaletteVariant({
+const softNaturalWatercolor = defineCuratedPalette({
 	id: "soft-natural-watercolor",
 	name: "Soft Natural — Watercolor",
 	description: "Soft sand primary with watercolour sage accents.",
@@ -4688,7 +4766,7 @@ const softNaturalWatercolor = definePaletteVariant({
 		}
 	]
 });
-const softNaturalLilac = definePaletteVariant({
+const softNaturalLilac = defineCuratedPalette({
 	id: "soft-natural-lilac",
 	name: "Soft Natural — Lilac",
 	description: "Watercolour periwinkle-lilac primary with warm ivory grounds and a sage accent.",
@@ -4754,13 +4832,13 @@ const softNaturalLilac = definePaletteVariant({
 	]
 });
 //#endregion
-//#region ../theme-core/src/palette/variants/index.ts
-const paletteVariants = [
+//#region ../theme-core/src/palette/curated/index.ts
+const curatedPalettes = [
 	brandLedCool,
 	brandLedWarm,
 	brandLedJewel,
 	brandLedBurgundyGold,
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-neutral-clay",
 		name: "Warm Neutral — Clay",
 		description: "Terracotta primary on a cream ground.",
@@ -4825,7 +4903,7 @@ const paletteVariants = [
 			}
 		]
 	}),
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-neutral-cream",
 		name: "Warm Neutral — Cream",
 		description: "Soft sand primary with pale cream surfaces.",
@@ -4890,7 +4968,7 @@ const paletteVariants = [
 			}
 		]
 	}),
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-neutral-soft-earth",
 		name: "Warm Neutral — Soft Earth",
 		description: "Cream ground with terracotta primary, clay accents, and olive depth.",
@@ -4955,7 +5033,7 @@ const paletteVariants = [
 			}
 		]
 	}),
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-neutral-forest",
 		name: "Warm Neutral — Forest",
 		description: "Deep forest green primary with earthy neutrals.",
@@ -5027,7 +5105,7 @@ const paletteVariants = [
 	softNaturalStone,
 	softNaturalWatercolor,
 	softNaturalLilac,
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-dark-ember",
 		name: "Warm Dark — Ember",
 		description: "Deep clay-brown ground with burnt-orange accent and warm cream text.",
@@ -5092,7 +5170,7 @@ const paletteVariants = [
 			}
 		]
 	}),
-	definePaletteVariant({
+	defineCuratedPalette({
 		id: "warm-dark-kirtan-gold",
 		name: "Warm Dark — Kirtan Gold",
 		description: "Deep plum ground with pale gold primary, rose accent, and soft devotional text.",
@@ -5158,7 +5236,7 @@ const paletteVariants = [
 		]
 	})
 ];
-new Map(paletteVariants.map((v) => [v.id, v]));
+new Map(curatedPalettes.map((v) => [v.id, v]));
 //#endregion
 //#region ../theme-core/src/accordions/siteStyleDefaults.ts
 /**
@@ -5696,7 +5774,7 @@ const overlayLogoAccommodations = [
 * optional nested styling fields that would otherwise leak from another Look.
 */
 function baseHeader(theme) {
-	const { navLinkStyle: _navLinkStyle, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
+	const { navLinkStyle: _navLinkStyle, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
 	return {
 		...header,
 		navContainer: {
@@ -7661,6 +7739,29 @@ z$1.object({
 	styleAuthorities: z$1.array(blockRuntimeStyleAuthoritySchema)
 }).strict();
 //#endregion
+//#region ../theme-core/src/site-styles/sectionTransitions.ts
+function boundaryRuntimeMetrics(family, size, heightExpression) {
+	return {
+		family,
+		size,
+		heightCss: heightExpression.includes(" ") ? `calc(${heightExpression})` : heightExpression,
+		reserveCss: `calc((${heightExpression}) / 2)`
+	};
+}
+boundaryRuntimeMetrics("gradient", "medium", "6rem + 2px"), boundaryRuntimeMetrics("gradient", "spacious", "10rem"), boundaryRuntimeMetrics("gradient", "expansive", "14rem"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("wave", "large", "7rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("angle", "large", "7rem + 2px");
+asBoundaryOptionId("break:none");
+asBoundaryOptionId("break:soft");
+asBoundaryOptionId("break:spacious");
+asBoundaryOptionId("break:expansive");
+asBoundaryOptionId("break:wave");
+asBoundaryOptionId("break:wave-balanced");
+asBoundaryOptionId("break:wave-gentle");
+asBoundaryOptionId("break:wave-bold");
+asBoundaryOptionId("break:wave-drift");
+asBoundaryOptionId("break:angle-subtle");
+asBoundaryOptionId("break:angle-balanced");
+asBoundaryOptionId("break:angle-steep");
+//#endregion
 //#region ../theme-core/src/site-styles/runtimeCompiler.ts
 function defineDesignRuntimeRules(rules) {
 	return rules;
@@ -7908,7 +8009,7 @@ function defineCuratedSiteStyle(input) {
 		recommendedHeaderLookIds: legacyHeaderLookIds.map(asHeaderLookId),
 		recommendedFooterLookIds: (input.recommendedFooterLookIds ?? []).map(asFooterLookId),
 		buttonPersonalityChoices: input.buttonPersonalityChoices,
-		paletteVariantChoices: input.paletteVariantChoices,
+		paletteRecommendations: input.paletteRecommendations,
 		typographyPresetChoices,
 		defaultTypographyPresetId
 	};
@@ -7919,11 +8020,11 @@ function buttonChoice(id, note) {
 		note
 	} : { id: asButtonPersonalityId(id) };
 }
-function paletteChoice(id, note) {
+function paletteRecommendation(id, note) {
 	return note ? {
-		id: asPaletteVariantId(id),
+		id: asCuratedPaletteId(id),
 		note
-	} : { id: asPaletteVariantId(id) };
+	} : { id: asCuratedPaletteId(id) };
 }
 function headerLayoutChoice(id, note) {
 	return note ? {
@@ -8137,11 +8238,11 @@ const curatedSiteStyles = [
 			buttonChoice("editorial-link"),
 			buttonChoice("brushed-wash")
 		],
-		paletteVariantChoices: [
-			paletteChoice("soft-natural-sage"),
-			paletteChoice("soft-natural-stone"),
-			paletteChoice("warm-neutral-clay"),
-			paletteChoice("soft-natural-watercolor")
+		paletteRecommendations: [
+			paletteRecommendation("soft-natural-sage"),
+			paletteRecommendation("soft-natural-stone"),
+			paletteRecommendation("warm-neutral-clay"),
+			paletteRecommendation("soft-natural-watercolor")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8173,10 +8274,10 @@ const curatedSiteStyles = [
 			buttonChoice("soft-pill"),
 			buttonChoice("editorial-link")
 		],
-		paletteVariantChoices: [
-			paletteChoice("brand-led-cool"),
-			paletteChoice("high-contrast-ink"),
-			paletteChoice("brand-led-jewel")
+		paletteRecommendations: [
+			paletteRecommendation("brand-led-cool"),
+			paletteRecommendation("high-contrast-ink"),
+			paletteRecommendation("brand-led-jewel")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8212,11 +8313,11 @@ const curatedSiteStyles = [
 			buttonChoice("soft-pill"),
 			buttonChoice("brushed-wash")
 		],
-		paletteVariantChoices: [
-			paletteChoice("warm-neutral-cream"),
-			paletteChoice("warm-neutral-clay"),
-			paletteChoice("warm-neutral-forest"),
-			paletteChoice("soft-natural-stone")
+		paletteRecommendations: [
+			paletteRecommendation("warm-neutral-cream"),
+			paletteRecommendation("warm-neutral-clay"),
+			paletteRecommendation("warm-neutral-forest"),
+			paletteRecommendation("soft-natural-stone")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8252,10 +8353,10 @@ const curatedSiteStyles = [
 			buttonChoice("brushed-wash"),
 			buttonChoice("confident-chip")
 		],
-		paletteVariantChoices: [
-			paletteChoice("brand-led-warm"),
-			paletteChoice("brand-led-jewel"),
-			paletteChoice("soft-natural-watercolor")
+		paletteRecommendations: [
+			paletteRecommendation("brand-led-warm"),
+			paletteRecommendation("brand-led-jewel"),
+			paletteRecommendation("soft-natural-watercolor")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8313,10 +8414,10 @@ const curatedSiteStyles = [
 			buttonChoice("confident-chip"),
 			buttonChoice("soft-pill")
 		],
-		paletteVariantChoices: [
-			paletteChoice("high-contrast-charcoal"),
-			paletteChoice("high-contrast-ink"),
-			paletteChoice("warm-neutral-cream")
+		paletteRecommendations: [
+			paletteRecommendation("high-contrast-charcoal"),
+			paletteRecommendation("high-contrast-ink"),
+			paletteRecommendation("warm-neutral-cream")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8375,10 +8476,10 @@ const curatedSiteStyles = [
 			buttonChoice("pebble"),
 			buttonChoice("ink-stamp")
 		],
-		paletteVariantChoices: [
-			paletteChoice("brand-led-cool"),
-			paletteChoice("high-contrast-ink"),
-			paletteChoice("brand-led-warm")
+		paletteRecommendations: [
+			paletteRecommendation("brand-led-cool"),
+			paletteRecommendation("high-contrast-ink"),
+			paletteRecommendation("brand-led-warm")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8414,10 +8515,10 @@ const curatedSiteStyles = [
 			buttonChoice("pebble"),
 			buttonChoice("confident-chip")
 		],
-		paletteVariantChoices: [
-			paletteChoice("soft-natural-sage"),
-			paletteChoice("soft-natural-stone"),
-			paletteChoice("warm-neutral-forest")
+		paletteRecommendations: [
+			paletteRecommendation("soft-natural-sage"),
+			paletteRecommendation("soft-natural-stone"),
+			paletteRecommendation("warm-neutral-forest")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8487,10 +8588,10 @@ const curatedSiteStyles = [
 			buttonChoice("soft-pill"),
 			buttonChoice("editorial-link")
 		],
-		paletteVariantChoices: [
-			paletteChoice("soft-natural-stone"),
-			paletteChoice("soft-natural-sage"),
-			paletteChoice("warm-neutral-clay")
+		paletteRecommendations: [
+			paletteRecommendation("soft-natural-stone"),
+			paletteRecommendation("soft-natural-sage"),
+			paletteRecommendation("warm-neutral-clay")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8613,11 +8714,11 @@ const curatedSiteStyles = [
 			buttonChoice("pebble"),
 			buttonChoice("editorial-link")
 		],
-		paletteVariantChoices: [
-			paletteChoice("soft-natural-lilac"),
-			paletteChoice("soft-natural-watercolor"),
-			paletteChoice("soft-natural-stone"),
-			paletteChoice("warm-neutral-cream")
+		paletteRecommendations: [
+			paletteRecommendation("soft-natural-lilac"),
+			paletteRecommendation("soft-natural-watercolor"),
+			paletteRecommendation("soft-natural-stone"),
+			paletteRecommendation("warm-neutral-cream")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8687,10 +8788,10 @@ const curatedSiteStyles = [
 			buttonChoice("soft-pill"),
 			buttonChoice("brushed-wash")
 		],
-		paletteVariantChoices: [
-			paletteChoice("warm-neutral-forest"),
-			paletteChoice("warm-neutral-clay"),
-			paletteChoice("soft-natural-stone")
+		paletteRecommendations: [
+			paletteRecommendation("warm-neutral-forest"),
+			paletteRecommendation("warm-neutral-clay"),
+			paletteRecommendation("soft-natural-stone")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8762,11 +8863,11 @@ const curatedSiteStyles = [
 			buttonChoice("ink-stamp"),
 			buttonChoice("editorial-link")
 		],
-		paletteVariantChoices: [
-			paletteChoice("brand-led-warm"),
-			paletteChoice("brand-led-cool"),
-			paletteChoice("soft-natural-watercolor"),
-			paletteChoice("warm-neutral-clay")
+		paletteRecommendations: [
+			paletteRecommendation("brand-led-warm"),
+			paletteRecommendation("brand-led-cool"),
+			paletteRecommendation("soft-natural-watercolor"),
+			paletteRecommendation("warm-neutral-clay")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8885,11 +8986,11 @@ const curatedSiteStyles = [
 			buttonChoice("pebble"),
 			buttonChoice("editorial-link")
 		],
-		paletteVariantChoices: [
-			paletteChoice("warm-neutral-soft-earth"),
-			paletteChoice("warm-neutral-clay"),
-			paletteChoice("warm-neutral-forest"),
-			paletteChoice("soft-natural-sage")
+		paletteRecommendations: [
+			paletteRecommendation("warm-neutral-soft-earth"),
+			paletteRecommendation("warm-neutral-clay"),
+			paletteRecommendation("warm-neutral-forest"),
+			paletteRecommendation("soft-natural-sage")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -8956,11 +9057,11 @@ const curatedSiteStyles = [
 			buttonChoice("brushed-wash"),
 			buttonChoice("pebble")
 		],
-		paletteVariantChoices: [
-			paletteChoice("high-contrast-monochrome"),
-			paletteChoice("high-contrast-ink"),
-			paletteChoice("brand-led-jewel"),
-			paletteChoice("brand-led-warm")
+		paletteRecommendations: [
+			paletteRecommendation("high-contrast-monochrome"),
+			paletteRecommendation("high-contrast-ink"),
+			paletteRecommendation("brand-led-jewel"),
+			paletteRecommendation("brand-led-warm")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -9017,11 +9118,11 @@ const curatedSiteStyles = [
 			buttonChoice("ink-stamp"),
 			buttonChoice("brushed-wash")
 		],
-		paletteVariantChoices: [
-			paletteChoice("brand-led-burgundy-gold"),
-			paletteChoice("brand-led-jewel"),
-			paletteChoice("brand-led-warm"),
-			paletteChoice("high-contrast-ink")
+		paletteRecommendations: [
+			paletteRecommendation("brand-led-burgundy-gold"),
+			paletteRecommendation("brand-led-jewel"),
+			paletteRecommendation("brand-led-warm"),
+			paletteRecommendation("high-contrast-ink")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -9103,10 +9204,10 @@ const curatedSiteStyles = [
 			buttonChoice("joy-stamp"),
 			buttonChoice("ink-stamp")
 		],
-		paletteVariantChoices: [
-			paletteChoice("warm-dark-kirtan-gold"),
-			paletteChoice("warm-dark-ember"),
-			paletteChoice("brand-led-burgundy-gold")
+		paletteRecommendations: [
+			paletteRecommendation("warm-dark-kirtan-gold"),
+			paletteRecommendation("warm-dark-ember"),
+			paletteRecommendation("brand-led-burgundy-gold")
 		]
 	}),
 	defineCuratedSiteStyle({
@@ -9165,7 +9266,7 @@ const curatedSiteStyles = [
 			buttonChoice("ink-stamp"),
 			buttonChoice("showtime-pill")
 		],
-		paletteVariantChoices: [paletteChoice("warm-dark-ember")]
+		paletteRecommendations: [paletteRecommendation("warm-dark-ember")]
 	})
 ];
 new Map(curatedSiteStyles.map((style) => [style.id, style]));
@@ -11709,52 +11810,53 @@ const containerResponsiveThemeCss = `/*
 
   /* Semantic spacing tokens (replaces Tailwind maps in src/system/spacing.ts) */
   .rb-section-pad-none {
-    padding-top: 0;
-    padding-bottom: 0;
+    --rb-section-pad-y: 0rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
   .rb-section-pad-compact {
-    padding-top: 1.5rem;
-    padding-bottom: 1.5rem;
+    --rb-section-pad-y: 1.5rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
   .rb-section-pad-cozy {
-    padding-top: 2.5rem;
-    padding-bottom: 2.5rem;
+    --rb-section-pad-y: 2.5rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
   .rb-section-pad-medium {
-    padding-top: 3rem;
-    padding-bottom: 3rem;
+    --rb-section-pad-y: 3rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
   .rb-section-pad-comfortable {
-    padding-top: 4rem;
-    padding-bottom: 4rem;
+    --rb-section-pad-y: 4rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
   .rb-section-pad-spacious {
-    padding-top: 5rem;
-    padding-bottom: 5rem;
+    --rb-section-pad-y: 5rem;
+    padding-top: var(--rb-section-pad-y);
+    padding-bottom: var(--rb-section-pad-y);
   }
 
   @container rb-site (min-width: 640px) {
 
     @scope ([data-rb-responsive-mode="container"]) to (:scope [data-rb-responsive-mode]) {
       .rb-section-pad-compact {
-        padding-top: 2rem;
-        padding-bottom: 2rem;
+        --rb-section-pad-y: 2rem;
       }
       .rb-section-pad-cozy {
-        padding-top: 3.5rem;
-        padding-bottom: 3.5rem;
+        --rb-section-pad-y: 3.5rem;
       }
       .rb-section-pad-medium {
-        padding-top: 4rem;
-        padding-bottom: 4rem;
+        --rb-section-pad-y: 4rem;
       }
       .rb-section-pad-comfortable {
-        padding-top: 5rem;
-        padding-bottom: 5rem;
+        --rb-section-pad-y: 5rem;
       }
       .rb-section-pad-spacious {
-        padding-top: 7rem;
-        padding-bottom: 7rem;
+        --rb-section-pad-y: 7rem;
       }
     }
 
@@ -13144,30 +13246,122 @@ const containerResponsiveThemeCss = `/*
   :where(.theme-scope) .header-logo-text {
     font-size: 1.125rem; /* matches rb-text-lg */
     line-height: 1.75rem;
+    margin-inline: -0.18em;
+    padding-inline: 0.18em;
     transition: font-size 300ms var(--motion-ease, ease);
   }
 
-  /* Mobile: reduce site title size (~30%) to keep header compact */
+  /* Centered variant uses larger title */
+  :where(.theme-scope) .header-variant-centered .header-logo-text {
+    font-size: 1.25rem; /* matches rb-text-xl */
+    line-height: 1.75rem;
+  }
+
+  :where(.theme-scope) .header-logo-size-compact .header-logo-text {
+    font-size: 0.95rem;
+    line-height: 1.5rem;
+  }
+  :where(.theme-scope) .header-logo-size-standard .header-logo-text {
+    font-size: 1.125rem;
+    line-height: 1.75rem;
+  }
+  :where(.theme-scope) .header-logo-size-generous .header-logo-text {
+    font-size: 1.35rem;
+    line-height: 1.9rem;
+  }
+  :where(.theme-scope) .header-logo-size-display .header-logo-text {
+    font-size: 1.75rem;
+    line-height: 2.25rem;
+  }
+
+  :where(.theme-scope)
+    .header-variant-centered
+    .header-logo-size-compact
+    .header-logo-text {
+    font-size: 1.125rem;
+    line-height: 1.75rem;
+  }
+  :where(.theme-scope)
+    .header-variant-centered
+    .header-logo-size-standard
+    .header-logo-text {
+    font-size: 1.25rem;
+    line-height: 1.75rem;
+  }
+  :where(.theme-scope)
+    .header-variant-centered
+    .header-logo-size-generous
+    .header-logo-text {
+    font-size: 1.6rem;
+    line-height: 2rem;
+  }
+  :where(.theme-scope)
+    .header-variant-centered
+    .header-logo-size-display
+    .header-logo-text {
+    font-size: 2.1rem;
+    line-height: 2.5rem;
+  }
+
+  /* Mobile: reduce site title size to keep header compact */
   @container rb-site (max-width: 767px) {
 @scope ([data-rb-responsive-mode="container"]) to (:scope [data-rb-responsive-mode]) {
-:where(.theme-scope) .header-logo-text {
+:where(.theme-scope) .header-logo-text,
+    :where(.theme-scope) .header-logo-size-standard .header-logo-text {
       font-size: 0.8rem;
       line-height: 1.25rem;
     }
 
-    :where(.theme-scope) .header-variant-centered .header-logo-text {
+    :where(.theme-scope) .header-logo-size-compact .header-logo-text {
+      font-size: 0.75rem;
+      line-height: 1.15rem;
+    }
+
+    :where(.theme-scope) .header-logo-size-generous .header-logo-text {
+      font-size: 1rem;
+      line-height: 1.4rem;
+    }
+
+    :where(.theme-scope) .header-logo-size-display .header-logo-text {
+      font-size: 1.25rem;
+      line-height: 1.65rem;
+    }
+
+    :where(.theme-scope) .header-variant-centered .header-logo-text,
+    :where(.theme-scope)
+      .header-variant-centered
+      .header-logo-size-standard
+      .header-logo-text {
       font-size: 0.875rem;
       line-height: 1.25rem;
     }
+
+    :where(.theme-scope)
+      .header-variant-centered
+      .header-logo-size-compact
+      .header-logo-text {
+      font-size: 0.8rem;
+      line-height: 1.2rem;
+    }
+
+    :where(.theme-scope)
+      .header-variant-centered
+      .header-logo-size-generous
+      .header-logo-text {
+      font-size: 1.125rem;
+      line-height: 1.5rem;
+    }
+
+    :where(.theme-scope)
+      .header-variant-centered
+      .header-logo-size-display
+      .header-logo-text {
+      font-size: 1.35rem;
+      line-height: 1.75rem;
+    }
 }
 }
 
-  /* Centered variant uses larger title */
-  :where(.theme-scope) .header-variant-centered .header-logo-text {
-    font-size: 1.25rem; /* matches rb-text-xl */
-    line-height: 1.75rem;
-  }
-
   /* =================================================================
    Shrink on Scroll - Logo & Title
    ================================================================= */
@@ -20857,11 +21051,31 @@ const containerResponsiveThemeCss = `/*
   object-fit: contain;
 }
 
+:where(.theme-scope) .rb-feature-card-icon-zone--generated {
+  align-self: center;
+  inline-size: min(var(--rb-feature-card-generated-icon-size, 75px), 100%);
+  max-inline-size: 100%;
+  block-size: auto;
+  aspect-ratio: 1;
+  margin-inline: auto;
+  padding: 0;
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+  box-shadow: none;
+}
+
 :where(.theme-scope) .rb-feature-card-icon-zone--plain .rb-feature-card-icon {
   width: 1.5rem;
   height: 1.5rem;
 }
 
+:where(.theme-scope) .rb-feature-card-icon-zone--generated .rb-feature-card-icon--generated {
+  inline-size: 100%;
+  max-inline-size: 100%;
+  block-size: 100%;
+}
+
 /* --- Card marker mode (icons / numbers / none) -----------------------------
  *
  * The icon zone and the number zone both sit in the DOM; the grid's