@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/client/rendering.mjs

@@ -521,18 +521,25 @@ var init_booking_instalments = __esmMin((() => {}));
 //#endregion
 //#region ../core/src/booking-date-time.ts
 function isValidTimeZone$1(timeZone) {
+	const cached = timeZoneValidityCache.get(timeZone);
+	if (cached !== void 0) return cached;
+	let isValid;
 	try {
 		new Intl.DateTimeFormat(DEFAULT_LOCALE, { timeZone }).format(/* @__PURE__ */ new Date());
-		return true;
+		isValid = true;
 	} catch {
-		return false;
+		isValid = false;
 	}
+	if (timeZoneValidityCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) timeZoneValidityCache.clear();
+	timeZoneValidityCache.set(timeZone, isValid);
+	return isValid;
 }
 function getSafeTimeZone(timeZone) {
 	const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
 	return normalized.length > 0 && isValidTimeZone$1(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone$1(normalized)) return null;
 	return normalized;
@@ -545,10 +552,19 @@ function formatParseError(error) {
 	}
 }
 function formatToPartsLookup(date, locale, timeZone, format) {
-	return new Map(new Intl.DateTimeFormat(locale, {
+	return new Map(getCachedDateTimeFormatter(locale, timeZone, format).formatToParts(date).map((part) => [part.type, part.value]));
+}
+function getCachedDateTimeFormatter(locale, timeZone, format) {
+	const key = `${locale}\u0000${timeZone}\u0000${JSON.stringify(Object.entries(format).sort(([left], [right]) => left.localeCompare(right)))}`;
+	const cached = dateTimeFormatterCache.get(key);
+	if (cached !== void 0) return cached;
+	const formatter = new Intl.DateTimeFormat(locale, {
 		...format,
 		timeZone
-	}).formatToParts(date).map((part) => [part.type, part.value]));
+	});
+	if (dateTimeFormatterCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) dateTimeFormatterCache.clear();
+	dateTimeFormatterCache.set(key, formatter);
+	return formatter;
 }
 function getZonedDateTimeParts(date, timeZone) {
 	const parts = formatToPartsLookup(date, "en-GB", timeZone, {
@@ -601,23 +617,9 @@ function toUtcIsoDateTimeString(value) {
 	return parsed.value;
 }
 function parseScheduledBookingDateTime(input) {
+	let startsAt;
 	try {
-		const startsAt = toUtcIsoDateTimeString(input.startsAt);
-		const timeZone = parseStrictBookingTimeZone(input.timeZone);
-		if (timeZone === null) return {
-			ok: false,
-			field: "timeZone",
-			reason: "invalid_time_zone",
-			value: input.timeZone
-		};
-		return {
-			ok: true,
-			value: {
-				startsAt,
-				timeZone,
-				locale: input.locale
-			}
-		};
+		startsAt = toUtcIsoDateTimeString(input.startsAt);
 	} catch {
 		return {
 			ok: false,
@@ -626,6 +628,21 @@ function parseScheduledBookingDateTime(input) {
 			value: input.startsAt
 		};
 	}
+	const timeZone = parseStrictBookingTimeZone(input.timeZone);
+	if (timeZone === null) return {
+		ok: false,
+		field: "timeZone",
+		reason: "invalid_time_zone",
+		value: typeof input.timeZone === "string" ? input.timeZone : ""
+	};
+	return {
+		ok: true,
+		value: {
+			startsAt,
+			timeZone,
+			locale: input.locale
+		}
+	};
 }
 function parseScheduledBookingDateRange(input) {
 	const start = parseScheduledBookingDateTime(input);
@@ -664,10 +681,7 @@ function toScheduledBookingDateRange(input) {
 function formatBookingInstant(isoString, options) {
 	const date = new Date(isoString);
 	if (Number.isNaN(date.getTime())) return isoString;
-	return new Intl.DateTimeFormat(options.locale ?? DEFAULT_LOCALE, {
-		...options.format,
-		timeZone: getSafeTimeZone(options.timeZone)
-	}).format(date);
+	return getCachedDateTimeFormatter(options.locale ?? DEFAULT_LOCALE, getSafeTimeZone(options.timeZone), options.format).format(date);
 }
 function formatBookingDate(input, format = {
 	weekday: "long",
@@ -755,7 +769,7 @@ function addLocalScheduleDays(date, days) {
 		day: utcDate.getUTCDate()
 	};
 }
-var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN;
+var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN, DATE_TIME_FORMATTER_CACHE_LIMIT, dateTimeFormatterCache, timeZoneValidityCache;
 var init_booking_date_time = __esmMin((() => {
 	init_result();
 	DEFAULT_LOCALE = "en-US";
@@ -768,6 +782,9 @@ var init_booking_date_time = __esmMin((() => {
 		minute: "2-digit"
 	};
 	LOCAL_DATE_PATTERN = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/u;
+	DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+	dateTimeFormatterCache = /* @__PURE__ */ new Map();
+	timeZoneValidityCache = /* @__PURE__ */ new Map();
 })), init_dated_offering_settlement = __esmMin((() => {
 	init_result();
 }));
@@ -1061,7 +1078,8 @@ function validateRelativeStoragePath(value) {
 	if (value.startsWith("sites/")) return fail({ tag: "SITE_SCOPED_PATH" });
 	if (value.startsWith("/")) return fail({ tag: "LEADING_SLASH" });
 	if (value.includes("//")) return fail({ tag: "DOUBLE_SLASH" });
-	if (value.split("/").some((segment) => segment === "..")) return fail({ tag: "TRAVERSAL" });
+	if (value.includes("%")) return fail({ tag: "PERCENT_ENCODING" });
+	if (value.split("/").some((segment) => segment === "." || segment === "..")) return fail({ tag: "TRAVERSAL" });
 	return ok$2(value);
 }
 function brandRelativeStoragePath(value) {
@@ -3658,7 +3676,7 @@ function createTransformRegistry(definitions) {
 var init_core$2 = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/palette/utils/colorConversion.ts
-function hexToRgb$2(hex) {
+function hexToRgb$1(hex) {
 	const h = hex.replace(/^#/, "");
 	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
 	if (m.length !== 6) throw new Error("Bad hex");
@@ -3768,7 +3786,7 @@ function oklchToHexGamut(L, C, h) {
 	return rgbToHex$1(r, g, bb);
 }
 function featuresFromHex(hex) {
-	const { r, g, b } = hexToRgb$2(hex);
+	const { r, g, b } = hexToRgb$1(hex);
 	const { h, s, l } = rgbToHsl$1(r, g, b);
 	const { L, a, b: b2 } = srgbToOklab(r, g, b);
 	const { L: okL, C: okC, h: okH } = oklabToOklch(L, a, b2);
@@ -3801,14 +3819,14 @@ function relativeLuminance(r, g, b) {
 	return .2126 * R + .7152 * G + .0722 * B;
 }
 function contrastRatio(hex1, hex2) {
-	const { r: r1, g: g1, b: b1 } = hexToRgb$2(hex1);
-	const { r: r2, g: g2, b: b2 } = hexToRgb$2(hex2);
+	const { r: r1, g: g1, b: b1 } = hexToRgb$1(hex1);
+	const { r: r2, g: g2, b: b2 } = hexToRgb$1(hex2);
 	const L1 = relativeLuminance(r1, g1, b1);
 	const L2 = relativeLuminance(r2, g2, b2);
 	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
 	return (hi + .05) / (lo + .05);
 }
-var init_contrast$2 = __esmMin((() => {
+var init_contrast$1 = __esmMin((() => {
 	init_colorConversion();
 }));
 //#endregion
@@ -3864,7 +3882,7 @@ function asAccessibleSurfaceToken(token) {
 }
 var ON_BACKGROUND;
 var init_accessibleSurfaces = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 	init_onColor();
 }));
 //#endregion
@@ -4869,6 +4887,10 @@ var init_modern_minimal = __esmMin((() => {
 					name: "primary",
 					hex: "#1f2937"
 				},
+				{
+					name: "primaryForeground",
+					hex: "#ffffff"
+				},
 				{
 					name: "secondary",
 					hex: "#6b7280"
@@ -4897,6 +4919,14 @@ var init_modern_minimal = __esmMin((() => {
 					name: "surface",
 					hex: "#ffffff"
 				},
+				{
+					name: "surfaceAlt",
+					hex: "#f9fafb"
+				},
+				{
+					name: "muted",
+					hex: "#f3f4f6"
+				},
 				{
 					name: "text",
 					hex: "#1f2937"
@@ -5007,7 +5037,7 @@ function generateCssVars(palette) {
 	const cssVars = {};
 	Object.entries(palette).forEach(([key, value]) => {
 		if (key === "meta" || value === null || value === void 0 || typeof value !== "string") return;
-		const { r, g, b } = hexToRgb$2(value);
+		const { r, g, b } = hexToRgb$1(value);
 		cssVars[`--tb-${key}`] = `${r} ${g} ${b}`;
 	});
 	return cssVars;
@@ -5054,48 +5084,48 @@ var init_neutralScale = __esmMin((() => {
 }));
 var init_colorPlacement = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 }));
 var init_backgroundGeneration = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_analogous_harmony = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_colorConversion();
 }));
 var init_complementary_contrast = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_earthy_natural = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_high_contrast_modern = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_jewel_dark = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_minimal_monochrome = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_neon_pop = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_pastel_light = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_colorConversion();
 }));
 var init_soft_modern = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_split_complementary = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_tetradic = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_triadic_balance = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 })), init_allRecipes = __esmMin((() => {
 	init_analogous_harmony();
 	init_complementary_contrast();
@@ -5111,7 +5141,7 @@ var init_triadic_balance = __esmMin((() => {
 	init_triadic_balance();
 }));
 var init_legs = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 	init_colorConversion();
 })), init_supportRoles = __esmMin((() => {
 	init_colorConversion();
@@ -5119,7 +5149,7 @@ var init_legs = __esmMin((() => {
 })), init_generatePalette = __esmMin((() => {
 	init_backgroundGeneration();
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_legs();
 	init_supportRoles();
 }));
@@ -5129,7 +5159,7 @@ var init_classifyColor = __esmMin((() => {
 var init_suggestRecipes = __esmMin((() => {
 	init_allRecipes();
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_generatePalette();
 	init_classifyColor();
 }));
@@ -5161,7 +5191,7 @@ function getTextColorForBackground(background) {
 }
 function parseColorToRgb(input) {
 	const trimmed = input.trim();
-	if (trimmed.startsWith("#")) return hexToRgb$2(trimmed);
+	if (trimmed.startsWith("#")) return hexToRgb$1(trimmed);
 	const rgbMatch = trimmed.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})(?:\s*,\s*(?:0|1|0?\.\d+))?\s*\)$/i);
 	if (rgbMatch?.[1] && rgbMatch[2] && rgbMatch[3]) return {
 		r: clamp255(Number(rgbMatch[1])),
@@ -5176,16 +5206,16 @@ function clamp255(value) {
 }
 var init_textColor = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 }));
 var init_legibility = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 }));
 //#endregion
 //#region ../theme-core/src/palette/utils/index.ts
-var init_utils$5 = __esmMin((() => {
+var init_utils$6 = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_colorPlacement();
 	init_backgroundGeneration();
 	init_suggestRecipes();
@@ -5306,7 +5336,7 @@ var init_swatch = __esmMin((() => {}));
 var init_PaletteCard = __esmMin((() => {
 	init_generateCssVars();
 	init_neutralScale();
-	init_utils$5();
+	init_utils$6();
 	init_paletteAccess();
 	init_expandPalette();
 	init_swatch();
@@ -5538,7 +5568,7 @@ function assignDeep(target, ...sources) {
 	});
 	return target;
 }
-var init_utils$4 = __esmMin((() => {}));
+var init_utils$5 = __esmMin((() => {}));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/options.js
 function buildProcessOptions(opts, override) {
@@ -5556,13 +5586,13 @@ function buildProcessOptions(opts, override) {
 	}, override);
 }
 var init_options = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/builder.js
 var Builder;
 var init_builder$1 = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 	init_esm$2();
 	Builder = class {
 		/**
@@ -5924,7 +5954,7 @@ var init_esm$3 = __esmMin((() => {
 var init_client$2 = __esmMin((() => {
 	init_esm$4();
 	init_esm$3();
-	init_utils$4();
+	init_utils$5();
 }));
 var init_host = __esmMin((() => {
 	init_esm$4();
@@ -5935,7 +5965,7 @@ var _Vibrant, Vibrant;
 var init_esm$2 = __esmMin((() => {
 	init_options();
 	init_builder$1();
-	init_utils$4();
+	init_utils$5();
 	init_pipeline$1();
 	init_client$2();
 	init_host();
@@ -8124,12 +8154,8 @@ var init_sitePalettePersistence = __esmMin((() => {
 	init_colors();
 	init_selection();
 }));
-var init_themePaletteCompatibility = __esmMin((() => {
-	init_themeColorTokens();
-	init_colors();
-}));
 var init_fromVibrant = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 //#endregion
 //#region ../theme-core/src/palette/index.ts
@@ -8141,7 +8167,7 @@ var init_palette$1 = __esmMin((() => {
 	init_generateShades();
 	init_neutralScale();
 	init_types$15();
-	init_utils$5();
+	init_utils$6();
 	init_paletteAccess();
 	init_extractPalette();
 	init_colors();
@@ -8151,7 +8177,6 @@ var init_palette$1 = __esmMin((() => {
 	init_resolveSelection();
 	init_selection();
 	init_sitePalettePersistence();
-	init_themePaletteCompatibility();
 	init_fromVibrant();
 	init_suggestRecipes();
 	init_allRecipes();
@@ -8597,6 +8622,108 @@ var init_contentTemplateDesignIntent = __esmMin((() => {
 	init_types$16();
 }));
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+var BUTTON_EFFECT_POLICIES;
+var init_effectClassification = __esmMin((() => {
+	BUTTON_EFFECT_POLICIES = {
+		"darken-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "darker"
+			}
+		},
+		"lighten-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "lighter"
+			}
+		},
+		"background-on-hover": {
+			classification: "colour-transition",
+			transition: { kind: "replace-background" }
+		},
+		"background-on-hover-alpha": {
+			classification: "unsupported-colour",
+			reason: "alpha_requires_surface"
+		},
+		"fade-background": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"opacity-reduce": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"gradient-text": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"text-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"border-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_border"
+		},
+		"aurora-glow": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"cosmic-stardust": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"animated-gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"nav-underline": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-base": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-hover": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-active": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"animated-gradient": { classification: "non-colour" },
+		"border-glow": { classification: "non-colour" },
+		"drop-shadow": { classification: "non-colour" },
+		"inner-shadow": { classification: "non-colour" },
+		"neumorphic-shadow": { classification: "non-colour" },
+		"outer-glow": { classification: "non-colour" },
+		"retro-3d-shadow": { classification: "non-colour" },
+		"scale-up": { classification: "non-colour" },
+		"scale-down": { classification: "non-colour" },
+		lift: { classification: "non-colour" },
+		"press-down": { classification: "non-colour" },
+		pop: { classification: "non-colour" },
+		"border-bottom-grow": { classification: "non-colour" },
+		"sketchy-border": { classification: "non-colour" },
+		"pulse-animation": { classification: "non-colour" }
+	};
+}));
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 function isVariantRole(value) {
 	return VARIANT_ROLES.includes(value);
@@ -8605,9 +8732,155 @@ function asSpecialVariantId(value) {
 	if (value.length === 0) throw new Error("SpecialVariantId must be a non-empty string");
 	return value;
 }
-var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, buttonVariantSchema, buttonSystemSchema;
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray$4(background.stops) ? background.stops : [];
+	return [
+		input.hoverBackgroundToken,
+		background.colorToken,
+		background.foregroundToken,
+		...stops
+	].some((token) => stripLegacyTokenAlpha(token) !== token);
+}
+function stripLegacyTokenAlpha(value) {
+	if (typeof value !== "string") return value;
+	const slashIndex = value.indexOf("/");
+	return slashIndex < 0 ? value : value.slice(0, slashIndex);
+}
+function hasLegacyButtonEffects(input) {
+	if (!isUnknownRecord(input)) return false;
+	return [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	].some((state) => {
+		const effects = input[state];
+		return Array.isArray(effects) && effects.some((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return true;
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification !== "colour-transition" && classification !== "non-colour") return true;
+			return effect.effectId === "background-on-hover" && isUnknownRecord(effect.options) && stripLegacyTokenAlpha(effect.options.colorToken) !== effect.options.colorToken;
+		});
+	});
+}
+function normalizeLegacyButtonEffects(input, backgroundType) {
+	if (!isUnknownRecord(input)) return input;
+	const normalized = {};
+	for (const state of [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	]) {
+		const effects = input[state];
+		if (!Array.isArray(effects)) continue;
+		const safeEffects = effects.flatMap((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return [];
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification === "non-colour") return [effect];
+			if (classification !== "colour-transition") return [];
+			if (effect.effectId === "background-on-hover") {
+				const options = isUnknownRecord(effect.options) ? effect.options : null;
+				const colorToken = options === null ? null : parseOpaqueButtonColourToken(stripLegacyTokenAlpha(options.colorToken));
+				return colorToken === null ? [] : [{
+					...effect,
+					options: {
+						...options,
+						colorToken
+					}
+				}];
+			}
+			if (backgroundType !== "solid") return [];
+			const rawAmount = isUnknownRecord(effect.options) ? effect.options.amount : void 0;
+			const amount = typeof rawAmount === "number" && rawAmount > 0 ? Math.max(100, Math.round(rawAmount / 100) * 100) : 100;
+			return [{
+				...effect,
+				options: {
+					...isUnknownRecord(effect.options) ? effect.options : {},
+					amount
+				}
+			}];
+		});
+		if (safeEffects.length > 0) normalized[state] = safeEffects;
+	}
+	return Object.keys(normalized).length === 0 ? void 0 : normalized;
+}
+function isUnknownRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownArray$4(value) {
+	return Array.isArray(value);
+}
+var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, opaqueButtonColourTokenSchema, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, canonicalButtonGlobalSettingsSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonColourTreatmentSchema, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, canonicalButtonVariantSchema, buttonVariantSchema, buttonSystemSchema;
 var init_types$13 = __esmMin((() => {
+	init_effectClassification();
 	init_themeColorTokens();
+	init_colorTokenParts();
 	VARIANT_ROLES = [
 		"primary",
 		"secondary",
@@ -8618,6 +8891,11 @@ var init_types$13 = __esmMin((() => {
 		"accent"
 	];
 	DEFAULT_VARIANT_ALIAS_ID = "default";
+	opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+		const token = parseOpaqueButtonColourToken(value);
+		if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+		return token;
+	});
 	cornerStyleSchema = z$1.enum([
 		"square",
 		"rounded",
@@ -8706,7 +8984,7 @@ var init_types$13 = __esmMin((() => {
 		lg,
 		xl: xl ?? lg
 	}));
-	buttonGlobalSettingsSchema = z$1.object({
+	canonicalButtonGlobalSettingsSchema = z$1.object({
 		cornerStyle: cornerStyleSchema,
 		cornerRadius: z$1.number().min(0).max(24).optional(),
 		/**
@@ -8737,11 +9015,12 @@ var init_types$13 = __esmMin((() => {
 		paddingPreset: buttonPaddingPresetSchema.optional(),
 		hoverTransform: hoverTransformSchema,
 		hoverColor: hoverColorSchema,
-		hoverColorToken: themeColorTokenSchema.optional(),
+		hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 		gradientStyle: gradientStyleSchema.optional(),
 		gradientAngle: z$1.number().min(0).max(360).optional(),
 		gradientSharpness: gradientSharpnessSchema.optional()
 	});
+	buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 	gradientDirectionSchema$1 = z$1.enum([
 		"to-r",
 		"to-l",
@@ -8752,30 +9031,37 @@ var init_types$13 = __esmMin((() => {
 		"to-br",
 		"to-bl"
 	]);
-	buttonBackgroundSchema = z$1.discriminatedUnion("type", [
+	buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
 		z$1.object({
 			type: z$1.literal("solid"),
-			colorToken: themeColorTokenSchema
+			colorToken: opaqueButtonColourTokenSchema
 		}),
 		z$1.object({
 			type: z$1.literal("gradient"),
-			stops: z$1.array(themeColorTokenSchema).min(2),
-			direction: gradientDirectionSchema$1
+			stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+				const [first, second, ...rest] = stops;
+				if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+				return [
+					first,
+					second,
+					...rest
+				];
+			}),
+			direction: gradientDirectionSchema$1,
+			foregroundToken: opaqueButtonColourTokenSchema
 		}),
-		z$1.object({ type: z$1.literal("transparent") })
+		z$1.object({
+			type: z$1.literal("surface"),
+			role: z$1.literal("link")
+		})
 	]);
+	buttonBackgroundSchema = buttonColourTreatmentSchema;
 	effectApplicationSchema$1 = z$1.object({
 		effectId: z$1.string(),
-		options: z$1.record(z$1.string(), z$1.any()).optional()
-	});
-	buttonBorderSchema = z$1.object({
-		widthClass: z$1.string(),
-		colorToken: themeColorTokenSchema
-	});
-	buttonVariantAffordanceSchema = z$1.object({
-		iconId: z$1.string().min(1),
-		colorToken: themeColorTokenSchema.optional()
+		options: z$1.record(z$1.string(), z$1.json()).optional()
 	});
+	buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+	buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 	variantShadowSchema = z$1.object({
 		elevation: z$1.enum([
 			"none",
@@ -8803,22 +9089,22 @@ var init_types$13 = __esmMin((() => {
 		lg: buttonSizeConfigSchema.optional(),
 		xl: buttonSizeConfigSchema.optional()
 	});
-	buttonVariantSchema = z$1.object({
+	canonicalButtonVariantSchema = z$1.object({
 		id: z$1.string(),
 		name: z$1.string().min(1).max(20),
 		enabled: z$1.boolean(),
 		priority: prioritySchema,
 		background: buttonBackgroundSchema,
-		textColorToken: themeColorTokenSchema,
 		/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 		borderRadius: z$1.string().optional(),
 		shadow: variantShadowSchema.optional(),
 		border: buttonBorderSchema.optional(),
-		hoverBackgroundToken: z$1.string().optional(),
+		hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 		effects: variantEffectsSchema.optional(),
 		sizes: variantSizeOverridesSchema.optional(),
 		affordance: buttonVariantAffordanceSchema.optional()
 	});
+	buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 	buttonSystemSchema = z$1.object({
 		global: buttonGlobalSettingsSchema,
 		variants: z$1.array(buttonVariantSchema).min(1).max(6),
@@ -8842,7 +9128,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 var buttonPersonalityIdSchema;
@@ -8907,19 +9193,15 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["primary", "accent"],
-						direction: "to-r"
+						direction: "to-r",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "secondary",
@@ -8929,32 +9211,27 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["secondary", "accent"],
-						direction: "to-br"
+						direction: "to-br",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "outline",
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -8965,8 +9242,10 @@ var init_brushed_wash = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-lg",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -9012,7 +9291,6 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					shadow: {
 						elevation: "medium",
@@ -9022,7 +9300,7 @@ var init_confident_chip = __esmMin((() => {
 					effects: {
 						hover: [{
 							effectId: "darken-background",
-							options: { amount: 60 }
+							options: { amount: 100 }
 						}],
 						active: [{
 							effectId: "scale-down",
@@ -9039,12 +9317,8 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "surface"
 					},
-					textColorToken: "text",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -9055,13 +9329,12 @@ var init_confident_chip = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -9072,8 +9345,10 @@ var init_confident_chip = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-md",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -9136,7 +9411,6 @@ var init_earth_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -9162,13 +9436,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -9179,13 +9452,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surfaceAlt" }
@@ -9196,8 +9468,10 @@ var init_earth_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "none",
@@ -9218,11 +9492,7 @@ var init_earth_pill = __esmMin((() => {
 							padding: "0.625rem 0",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 25 }
-					}] }
+					}
 				}
 			]
 		}
@@ -9258,8 +9528,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Primary",
 					enabled: true,
 					priority: 1,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -9281,8 +9553,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -9304,8 +9578,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -9327,19 +9603,17 @@ var init_editorial_link = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
 						md: { padding: "0.5rem 0" },
 						lg: { padding: "0.625rem 0" },
 						xl: { padding: "0.75rem 0" }
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -20 }
-					}] }
+					}
 				}
 			]
 		}
@@ -9397,12 +9671,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accent"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -9416,13 +9686,12 @@ var init_flat_ink = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -9440,12 +9709,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "accent"
 					},
-					textColorToken: "accentForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accentForeground"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -9508,7 +9773,6 @@ var init_ink_stamp = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					effects: {
 						hover: [{
@@ -9529,13 +9793,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -9546,13 +9809,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -9563,8 +9825,10 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -9651,7 +9915,6 @@ var init_joy_stamp = __esmMin((() => {
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "high",
@@ -9665,13 +9928,12 @@ var init_joy_stamp = __esmMin((() => {
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "text"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				shadow: {
 					elevation: "high",
 					softness: "hard",
@@ -9736,12 +9998,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: {
 						hover: [{
 							effectId: "background-on-hover",
@@ -9762,12 +10020,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -9778,13 +10032,12 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -9795,8 +10048,10 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -9878,14 +10133,10 @@ var init_pebble = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 88
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -9893,13 +10144,12 @@ var init_pebble = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "accent"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "accent" }
@@ -9910,13 +10160,12 @@ var init_pebble = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -9927,8 +10176,10 @@ var init_pebble = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					sizes: {
 						sm: {
@@ -9944,11 +10195,7 @@ var init_pebble = __esmMin((() => {
 							padding: "0.75rem 1.5rem",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 30 }
-					}] }
+					}
 				}
 			]
 		}
@@ -10009,15 +10256,11 @@ var init_quiet_arrow = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-xl",
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 90
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -10025,13 +10268,12 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-xl",
+					border: { widthClass: "border" },
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -10043,21 +10285,22 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					}
+					border: { widthClass: "border" }
 				},
 				{
 					id: "ghost",
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl"
 				}
 			]
@@ -10120,7 +10363,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "background",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -10129,13 +10371,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{ effectId: "pop" }] }
 				},
 				{
@@ -10147,7 +10388,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -10160,12 +10400,8 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "background"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -10176,13 +10412,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -10193,8 +10428,10 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -10240,7 +10477,6 @@ var init_soft_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -10263,13 +10499,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -10280,13 +10515,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -10297,8 +10531,10 @@ var init_soft_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -10313,6 +10549,7 @@ var init_soft_pill = __esmMin((() => {
 //#region ../theme-core/src/buttons/personalities/two-tone-pill.ts
 var solidSecondary, twoTonePill;
 var init_two_tone_pill = __esmMin((() => {
+	init_types$13();
 	init_soft_pill();
 	init_types$12();
 	solidSecondary = {
@@ -10322,9 +10559,8 @@ var init_two_tone_pill = __esmMin((() => {
 		priority: 2,
 		background: {
 			type: "solid",
-			colorToken: "secondary"
+			colorToken: unsafeAsOpaqueButtonColourToken("secondary")
 		},
-		textColorToken: "onSecondary",
 		borderRadius: "rounded-full",
 		shadow: {
 			elevation: "none",
@@ -10705,6 +10941,276 @@ var init_testimonialQuotePresets = __esmMin((() => {
 	serifDisplayQuote = { style: "serif-display" };
 	accentGlyphQuote = { style: "accent-glyph" };
 }));
+//#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
+var init_types$11 = __esmMin((() => {
+	init_themeColorTokens();
+	gradientStopSchema = z$1.object({
+		color: themeColorTokenSchema,
+		position: z$1.number().min(0).max(100)
+	});
+	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+	gradientConfigSchema = z$1.object({
+		type: z$1.enum([
+			"linear",
+			"radial",
+			"conic"
+		]).default("linear"),
+		angle: z$1.number().min(0).max(360).optional(),
+		shape: radialGradientShapeSchema.optional(),
+		position: z$1.string().optional(),
+		stops: z$1.array(gradientStopSchema).min(2)
+	});
+}));
+//#endregion
+//#region ../theme-core/src/gradients/presets.ts
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+function getGradientPreset(id) {
+	return gradientPresetById[id];
+}
+var rawGradientPresets, GRADIENT_PRESETS, GRADIENT_PRESET_IDS, gradientPresetIdSet, gradientPresetById;
+var init_presets$2 = __esmMin((() => {
+	rawGradientPresets = [
+		{
+			id: "primary-secondary",
+			name: "Primary to Secondary",
+			description: "Blend your primary and secondary brand colors",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "secondary-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-accent",
+			name: "Primary to Accent",
+			description: "Energetic gradient from primary to accent",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-accent",
+			name: "Secondary to Accent",
+			description: "Vibrant secondary to accent blend",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-light-dark",
+			name: "Primary Light to Dark",
+			description: "Subtle primary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "primary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-dark-light",
+			name: "Primary Dark to Light",
+			description: "Reverse primary fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-50",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-light-dark",
+			name: "Secondary Light to Dark",
+			description: "Subtle secondary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "secondary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "accent-light-dark",
+			name: "Accent Light to Dark",
+			description: "Accent color depth fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "accent-500",
+				position: 0
+			}, {
+				color: "accent-900",
+				position: 100
+			}]
+		},
+		{
+			id: "background-surface",
+			name: "Background to Surface",
+			description: "Subtle depth using base colors",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "background",
+				position: 0
+			}, {
+				color: "surface",
+				position: 100
+			}]
+		},
+		{
+			id: "neutral-fade",
+			name: "Neutral Gradient",
+			description: "Elegant neutral color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "neutral-900",
+				position: 0
+			}, {
+				color: "neutral-50",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-glow",
+			name: "Primary glow",
+			description: "A soft top-centred glow using your primary palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onPrimary900",
+				headingColor: "onPrimary900",
+				linkColor: "onPrimary900",
+				supportingColor: "onPrimary900"
+			}
+		},
+		{
+			id: "accent-glow",
+			name: "Accent glow",
+			description: "A soft top-centred glow using your accent palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "accent-900",
+				position: 0
+			}, {
+				color: "accent-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onAccent900",
+				headingColor: "onAccent900",
+				linkColor: "onAccent900",
+				supportingColor: "onAccent900"
+			}
+		},
+		{
+			id: "primary-secondary-accent",
+			name: "Brand Trio",
+			description: "All three brand colors in harmony",
+			type: "linear",
+			angle: 135,
+			stops: [
+				{
+					color: "primary-500",
+					position: 0
+				},
+				{
+					color: "secondary-500",
+					position: 50
+				},
+				{
+					color: "accent-500",
+					position: 100
+				}
+			]
+		}
+	];
+	GRADIENT_PRESETS = rawGradientPresets.map((preset) => ({
+		...preset,
+		id: preset.id,
+		stops: preset.stops
+	}));
+	GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+	gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+	gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+}));
+//#endregion
+//#region ../theme-core/src/gradients/utils.ts
+/**
+* Convert a GradientConfig to a CSS gradient string
+*
+* @param config - The gradient configuration using theme tokens
+* @param tokens - Map of theme color tokens to hex values
+* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
+*/
+function gradientToCss(config, tokens) {
+	const stops = config.stops.map((stop) => {
+		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
+	}).join(", ");
+	const type = config.type ?? "linear";
+	if (type === "radial") {
+		const position = config.position ?? "center";
+		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
+	}
+	if (type === "conic") {
+		const position = config.position ?? "center";
+		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
+	}
+	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
+}
+var init_utils$4 = __esmMin((() => {}));
+//#endregion
+//#region ../theme-core/src/gradients/index.ts
+var init_gradients = __esmMin((() => {
+	init_types$11();
+	init_presets$2();
+	init_utils$4();
+}));
 var init_customizableSurfaces = __esmMin((() => {
 	init_types$16();
 })), logoTextConfidenceValues, logoAssetShapeValues, logoKindValues, logoDensityValues, logoContainsTextSchema, logoAnalysisSourceSchema, brandDisplayModeValues, logoAccommodationPatternValues, logoSizePolicyValues;
@@ -13026,14 +13532,12 @@ var init_background$2 = __esmMin((() => {
 			]
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, options, tokens } = ctx;
+			const { themeId, variantId, options, tokens, buttonConfig } = ctx;
 			const colorToken = options.colorToken || "neutral-800";
-			const color = tokens.getColor(colorToken);
-			const textColorToken = typeof options.textColorToken === "string" ? options.textColorToken : null;
 			return `
       /* Add background on hover */
       :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${color};${textColorToken ? `\n        color: ${tokens.getColor(textColorToken)};` : ""}
+        background-color: ${tokens.getColor(colorToken)};${"textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : ""}
       }
     `;
 		}
@@ -13052,10 +13556,10 @@ var init_background$2 = __esmMin((() => {
 			default: 50
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, stateGroup, options, buttonConfig } = ctx;
+			const { themeId, variantId, stateGroup, options } = ctx;
 			const rawOpacity = options.opacity;
 			const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
-			const cssVar = `var(--tb-${options.colorToken || buttonConfig.textColorToken || "neutral-800"})`;
+			const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
 			return `
       /* Add semi-transparent background (${stateGroup}) */
       :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
@@ -13232,7 +13736,7 @@ var init_shadow = __esmMin((() => {
 			const spread = options.spread || 10;
 			let glowColor;
 			if (options.glowColorToken && typeof options.glowColorToken === "string") glowColor = tokens.getColor(options.glowColorToken);
-			else if (buttonConfig.border?.colorToken) glowColor = tokens.getColor(buttonConfig.border.colorToken);
+			else if (buttonConfig.border) glowColor = "colorToken" in buttonConfig.border ? tokens.getColor(buttonConfig.border.colorToken) : "currentColor";
 			else if (buttonConfig.background.type === "solid") glowColor = tokens.getColor(buttonConfig.background.colorToken ?? "primary-400");
 			else glowColor = tokens.getColor("primary-400");
 			return `
@@ -13314,9 +13818,9 @@ function generateShadowValue$1(elevation, softness, position = "bottom", color)
 		case "crisp": return `${xOffset}px ${yOffset}px ${baseOffset}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.4)"}`;
 	}
 }
-var GRADIENT_DIRECTION_MAP$3, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
+var GRADIENT_DIRECTION_MAP$2, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
 var init_constants$2 = __esmMin((() => {
-	GRADIENT_DIRECTION_MAP$3 = {
+	GRADIENT_DIRECTION_MAP$2 = {
 		"to-r": "to right",
 		"to-l": "to left",
 		"to-t": "to top",
@@ -14261,30 +14765,6 @@ function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elem
 var init_generateEffectsCSS = __esmMin((() => {
 	init_registry$1();
 }));
-/**
-* Get contrasting text color for a button background
-*
-* This function returns theme-aware text colors using the neutral scale,
-* which is guaranteed to exist in every theme and harmonizes with the design.
-*
-* Uses neutral-50 (lightest) for dark backgrounds and neutral-950 (darkest)
-* for light backgrounds. This ensures excellent contrast while respecting
-* the theme's neutral palette (warm/cool tinting).
-*
-* For solid backgrounds with primary/secondary/neutral colors:
-* - Dark backgrounds (shade >= 500): neutral-50 (very light)
-* - Light backgrounds (shade < 500): neutral-950 (very dark)
-*/
-function getContrastingTextColorToken(backgroundToken, theme) {
-	const isLightTheme = theme.palette.meta.mode === "light";
-	if (backgroundToken.startsWith("primary-") || backgroundToken.startsWith("secondary-")) return "neutral-50";
-	if (backgroundToken.startsWith("neutral-")) {
-		const match = backgroundToken.match(/neutral-(\d+)/);
-		if (match?.[1]) return parseInt(match[1], 10) >= 500 ? "neutral-50" : "neutral-950";
-	}
-	return isLightTheme ? "neutral-50" : "neutral-950";
-}
-var init_contrast$1 = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/buttons/generateDefaultButtonSystem.ts
 /**
@@ -14328,13 +14808,8 @@ function generateDefaultButtonSystem(theme) {
 			priority: 1,
 			background: {
 				type: "solid",
-				colorToken: "primary"
-			},
-			textColorToken: getContrastingTextColorToken("primary", theme),
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+				colorToken: unsafeAsOpaqueButtonColourToken("primary")
+			}
 		},
 		{
 			id: "secondary",
@@ -14343,51 +14818,39 @@ function generateDefaultButtonSystem(theme) {
 			priority: 2,
 			background: {
 				type: "solid",
-				colorToken: "neutral-700"
-			},
-			textColorToken: getContrastingTextColorToken("neutral-700", theme),
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+				colorToken: unsafeAsOpaqueButtonColourToken("neutral-700")
+			}
 		},
 		{
 			id: "outline",
 			name: "Outline",
 			enabled: true,
 			priority: 3,
-			background: { type: "transparent" },
-			textColorToken: "primary",
+			background: {
+				type: "surface",
+				role: "link"
+			},
 			shadow: {
 				elevation: "none",
 				softness: null,
 				position: "bottom"
 			},
-			border: {
-				colorToken: "primary",
-				widthClass: borderWidthClass
-			},
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+			border: { widthClass: borderWidthClass }
 		},
 		{
 			id: "ghost",
 			name: "Ghost",
 			enabled: true,
 			priority: 3,
-			background: { type: "transparent" },
-			textColorToken: "primary",
+			background: {
+				type: "surface",
+				role: "link"
+			},
 			shadow: {
 				elevation: "none",
 				softness: null,
 				position: "bottom"
-			},
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+			}
 		}
 	];
 	return {
@@ -14404,7 +14867,7 @@ function generateDefaultButtonSystem(theme) {
 }
 var BORDER_WIDTH_TO_CLASS_MAP, VALID_CORNER_STYLES;
 var init_generateDefaultButtonSystem = __esmMin((() => {
-	init_contrast$1();
+	init_types$13();
 	BORDER_WIDTH_TO_CLASS_MAP = {
 		none: "border-0",
 		hairline: "border",
@@ -14440,8 +14903,420 @@ var init_affordanceIcons = __esmMin((() => {
 	};
 }));
 //#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+function compileButtonColourStates(input) {
+	const baseTransition = applyColourEffects({
+		variantId: input.variant.id,
+		state: "base",
+		treatment: input.variant.background,
+		effects: input.variant.effects?.base,
+		palette: input.palette
+	});
+	if (!baseTransition.ok) return baseTransition;
+	const stateTreatments = {
+		base: baseTransition.treatment,
+		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
+		focus: baseTransition.treatment,
+		active: baseTransition.treatment,
+		disabled: baseTransition.treatment
+	};
+	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) {
+		const transition = applyColourEffects({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			effects: input.variant.effects?.[state],
+			palette: input.palette
+		});
+		if (!transition.ok) return transition;
+		stateTreatments[state] = transition.treatment;
+		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
+	}
+	const resolved = {};
+	for (const state of BUTTON_VISUAL_STATES) {
+		const result = resolveTreatment$1({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			palette: input.palette
+		});
+		if (!result.ok) return result;
+		resolved[state] = result.colour;
+	}
+	return {
+		ok: true,
+		states: resolved,
+		focusIndicator: resolveFocusIndicator(resolved.focus),
+		nonColourEffects
+	};
+}
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function hoverTreatment(variant, global, fallback) {
+	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
+	return token === void 0 ? fallback : {
+		type: "solid",
+		colorToken: token
+	};
+}
+function applyColourEffects(input) {
+	let treatment = input.treatment;
+	const nonColourEffects = [];
+	for (const effect of input.effects ?? []) {
+		const policy = getButtonEffectPolicy(effect.effectId);
+		if (policy === null) return unknownEffect(input, effect);
+		switch (policy.classification) {
+			case "non-colour":
+				nonColourEffects.push(effect);
+				break;
+			case "unsupported-colour":
+			case "unsupported-background-overlay":
+			case "not-button": return unsupportedEffect(input, effect, policy.reason);
+			case "colour-transition":
+				if (policy.transition.kind === "adjust-shade") {
+					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
+					const amount = readShadeAmount(effect);
+					if (amount === null) return invalidEffectOption(input, effect, "amount");
+					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
+					treatment = {
+						type: "solid",
+						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
+					};
+					break;
+				}
+				if (policy.transition.kind === "replace-background") {
+					const colorToken = readOpaqueToken(effect, "colorToken", "neutral-800");
+					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
+					treatment = {
+						type: "solid",
+						colorToken
+					};
+					break;
+				}
+				return unknownEffect(input, effect);
+		}
+	}
+	return {
+		ok: true,
+		treatment,
+		nonColourEffects
+	};
+}
+function resolveTreatment$1(input) {
+	const treatment = input.treatment;
+	switch (treatment.type) {
+		case "surface": return {
+			ok: true,
+			colour: {
+				kind: "surface",
+				role: treatment.role,
+				backgroundCss: "transparent",
+				foregroundCss: surfaceForegroundValue(treatment.role)
+			}
+		};
+		case "solid": return resolveSolid(input, treatment.colorToken);
+		case "gradient": return resolveGradient$2(input, treatment);
+	}
+}
+function resolveFocusIndicator(colour) {
+	switch (colour.kind) {
+		case "solid": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: colour.backgroundCss,
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "gradient": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: tokenCss(colour.backgroundTokens[0]),
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "surface": return {
+			kind: "surface-role",
+			colorCss: colour.foregroundCss,
+			minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+		};
+	}
+}
+function resolveSolid(input, backgroundToken) {
+	const backgroundHex = paletteHex(input, backgroundToken);
+	if (!backgroundHex.ok) return backgroundHex;
+	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
+	const foregroundHex = input.palette[foregroundToken];
+	if (typeof foregroundHex !== "string") return {
+		ok: false,
+		error: {
+			tag: "missing_on_colour",
+			variantId: input.variantId,
+			state: input.state,
+			backgroundToken,
+			foregroundToken
+		}
+	};
+	const contrast = validateContrast({
+		...input,
+		background: backgroundToken,
+		backgroundHex: backgroundHex.hex,
+		foreground: foregroundToken,
+		foregroundHex
+	});
+	if (!contrast.ok) return contrast;
+	return {
+		ok: true,
+		colour: {
+			kind: "solid",
+			backgroundToken,
+			foregroundToken,
+			backgroundCss: tokenCss(backgroundToken),
+			foregroundCss: tokenCss(foregroundToken)
+		}
+	};
+}
+function resolveGradient$2(input, treatment) {
+	const foregroundHex = paletteHex(input, treatment.foregroundToken);
+	if (!foregroundHex.ok) return foregroundHex;
+	const stopHexes = [];
+	for (const token of treatment.stops) {
+		const stop = paletteHex(input, token);
+		if (!stop.ok) return stop;
+		stopHexes.push(stop.hex);
+	}
+	for (let segment = 0; segment < stopHexes.length - 1; segment += 1) {
+		const start = stopHexes[segment];
+		const end = stopHexes[segment + 1];
+		const startToken = treatment.stops[segment];
+		const endToken = treatment.stops[segment + 1];
+		if (start === void 0 || end === void 0 || startToken === void 0 || endToken === void 0) continue;
+		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
+			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
+			const sampleHex = interpolateHex(start, end, position);
+			const contrast = validateContrast({
+				...input,
+				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
+				backgroundHex: sampleHex,
+				foreground: treatment.foregroundToken,
+				foregroundHex: foregroundHex.hex
+			});
+			if (!contrast.ok) return contrast;
+		}
+	}
+	const direction = GRADIENT_DIRECTION_MAP$2[treatment.direction] ?? "to right";
+	return {
+		ok: true,
+		colour: {
+			kind: "gradient",
+			backgroundTokens: treatment.stops,
+			foregroundToken: treatment.foregroundToken,
+			backgroundCss: `linear-gradient(${direction}, ${treatment.stops.map(tokenCss).join(", ")})`,
+			foregroundCss: tokenCss(treatment.foregroundToken)
+		}
+	};
+}
+function paletteHex(input, token) {
+	const hex = input.palette[token];
+	return typeof hex === "string" ? {
+		ok: true,
+		hex
+	} : {
+		ok: false,
+		error: {
+			tag: "unknown_palette_token",
+			variantId: input.variantId,
+			state: input.state,
+			token
+		}
+	};
+}
+function validateContrast(input) {
+	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			background: input.background,
+			foreground: input.foreground,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		}
+	};
+}
+function tokenCss(token) {
+	return `rgb(var(--tb-${token}))`;
+}
+function adjustShade(token, amount, palette) {
+	const match = token.match(/^(.*)-(\d{2,3})$/);
+	const base = match?.[1] ?? token;
+	const currentShade = match?.[2] === void 0 ? 500 : Number(match[2]);
+	const availableShades = [
+		50,
+		100,
+		200,
+		300,
+		400,
+		500,
+		600,
+		700,
+		800,
+		900,
+		950
+	].filter((shade) => typeof palette[`${base}-${shade}`] === "string");
+	if (availableShades.length === 0) return token;
+	const firstShade = availableShades[0];
+	if (firstShade === void 0) return token;
+	const exactIndex = availableShades.indexOf(currentShade);
+	const startingIndex = exactIndex >= 0 ? exactIndex : availableShades.indexOf(availableShades.reduce((closestShade, shade) => Math.abs(shade - currentShade) < Math.abs(closestShade - currentShade) ? shade : closestShade, firstShade));
+	const stepCount = Math.abs(amount) / 100;
+	const direction = amount < 0 ? -1 : 1;
+	const targetShade = availableShades[Math.max(0, Math.min(availableShades.length - 1, startingIndex + direction * stepCount))];
+	return targetShade === void 0 ? token : unsafeAsOpaqueButtonColourToken(`${base}-${targetShade}`);
+}
+function readShadeAmount(effect) {
+	const value = effect.options?.amount ?? 100;
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value % 100 === 0 ? value : null;
+}
+function readOpaqueToken(effect, key, fallback) {
+	return parseOpaqueButtonColourToken(effect.options?.[key] ?? fallback);
+}
+function unsupportedEffect(input, effect, reason) {
+	return {
+		ok: false,
+		error: {
+			tag: "unsupported_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			reason
+		}
+	};
+}
+function invalidEffectOption(input, effect, option) {
+	return {
+		ok: false,
+		error: {
+			tag: "invalid_colour_effect_options",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			option
+		}
+	};
+}
+function inapplicableEffect(input, effect, treatment) {
+	return {
+		ok: false,
+		error: {
+			tag: "inapplicable_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			treatment: treatment.type
+		}
+	};
+}
+function unknownEffect(input, effect) {
+	return {
+		ok: false,
+		error: {
+			tag: "unknown_button_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId
+		}
+	};
+}
+function interpolateHex(startHex, endHex, position) {
+	const start = hexToRgb$1(startHex);
+	const end = hexToRgb$1(endHex);
+	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
+	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
+}
+var BUTTON_VISUAL_STATES, BUTTON_CONTRAST_POLICY;
+var init_resolveButtonColourStates = __esmMin((() => {
+	init_contrast$1();
+	init_colorConversion();
+	init_onColor();
+	init_foregroundContract();
+	init_types$13();
+	init_constants$2();
+	init_effectClassification();
+	BUTTON_VISUAL_STATES = [
+		"base",
+		"hover",
+		"focus",
+		"active",
+		"disabled"
+	];
+	BUTTON_CONTRAST_POLICY = {
+		textMinimumRatio: 4.5,
+		nonTextMinimumRatio: 3,
+		gradientSamplesPerSegment: 20,
+		alphaBackgrounds: "reject-without-known-surface",
+		disabled: "retain-full-colour-contract"
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/resolvedButtonCss.ts
+/**
+* Canonical colour declaration mapping shared by full themes and ThemeBridge.
+* Both background properties are always emitted so transitions cannot retain
+* a stale gradient or solid layer.
+*/
+function resolvedButtonColourDeclarations(colour) {
+	switch (colour.kind) {
+		case "solid": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+		case "gradient": return [
+			["background-color", "transparent"],
+			["background-image", colour.backgroundCss],
+			["color", colour.foregroundCss]
+		];
+		case "surface": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+	}
+}
+function resolvedButtonFocusDeclarations(indicator) {
+	return indicator.kind === "two-tone" ? [
+		["outline", `2px solid ${indicator.innerCss}`],
+		["outline-offset", "2px"],
+		["box-shadow", `0 0 0 4px ${indicator.outerCss}`]
+	] : [["outline", `3px solid ${indicator.colorCss}`], ["outline-offset", "3px"]];
+}
+var RESOLVED_BUTTON_DISABLED_DECLARATIONS;
+var init_resolvedButtonCss = __esmMin((() => {
+	RESOLVED_BUTTON_DISABLED_DECLARATIONS = [
+		["cursor", "not-allowed"],
+		["transform", "none"],
+		["box-shadow", "none"],
+		["outline", "2px dashed currentColor"],
+		["outline-offset", "-4px"]
+	];
+}));
+//#endregion
 //#region ../theme-core/src/buttons/generateButtonCss.ts
-function rule(selector, declarations) {
+function rule$1(selector, declarations) {
 	return {
 		selectors: typeof selector === "string" ? [selector] : selector,
 		declarations
@@ -14482,6 +15357,7 @@ function shadowSizeToShadow(size, theme) {
 function generateButtonCss(options) {
 	const { themeId, theme, buttonSystem: providedButtonSystem } = options;
 	const tokens = new TokenResolver(theme);
+	const palette = expandPalette(theme.palette);
 	const buttonSystem = providedButtonSystem ?? generateDefaultButtonSystem(theme);
 	const themeSizes = {
 		...DEFAULT_BUTTON_SIZES,
@@ -14490,34 +15366,109 @@ function generateButtonCss(options) {
 	const enabledVariants = buttonSystem.variants.filter((v) => v.enabled);
 	const aliasSource = resolveAliasSource(enabledVariants);
 	const chunks = [];
-	for (const variant of enabledVariants) chunks.push(...variantChunks(variant, buttonSystem.global, themeSizes, themeId, tokens, theme));
+	for (const variant of enabledVariants) {
+		const compiled = compileRuntimeVariant(variant, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
+	}
 	if (aliasSource) {
-		const alias = {
+		const compiled = compileRuntimeVariant({
 			...aliasSource,
 			id: DEFAULT_VARIANT_ALIAS_ID,
 			name: "Default"
-		};
-		chunks.push(...variantChunks(alias, buttonSystem.global, themeSizes, themeId, tokens, theme));
+		}, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
 	}
 	return chunks.map(renderChunk).join("\n\n");
 }
+function compileRuntimeVariant(variant, global, palette) {
+	const result = compileButtonColourStates({
+		variant,
+		global,
+		palette
+	});
+	if (result.ok) return {
+		variant,
+		global,
+		colours: result.states,
+		focusIndicator: result.focusIndicator,
+		nonColourEffects: result.nonColourEffects
+	};
+	const fallbackVariant = {
+		...variant,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		hoverBackgroundToken: void 0,
+		effects: void 0
+	};
+	const fallbackGlobal = {
+		...global,
+		hoverColor: "none",
+		hoverColorToken: void 0
+	};
+	const fallback = compileButtonColourStates({
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		palette
+	});
+	if (!fallback.ok) {
+		const colour = {
+			kind: "surface",
+			role: "link",
+			backgroundCss: "transparent",
+			foregroundCss: surfaceForegroundValue("link")
+		};
+		return {
+			variant: fallbackVariant,
+			global: fallbackGlobal,
+			colours: {
+				base: colour,
+				hover: colour,
+				focus: colour,
+				active: colour,
+				disabled: colour
+			},
+			focusIndicator: {
+				kind: "surface-role",
+				colorCss: colour.foregroundCss,
+				minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+			},
+			nonColourEffects: {},
+			fallbackError: result.error
+		};
+	}
+	return {
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		colours: fallback.states,
+		focusIndicator: fallback.focusIndicator,
+		nonColourEffects: fallback.nonColourEffects,
+		fallbackError: result.error
+	};
+}
 /** Pick the highest-priority variant whose role we'll alias to `.default`. */
 function resolveAliasSource(enabled) {
 	if (enabled.some((v) => v.id === DEFAULT_VARIANT_ALIAS_ID)) return null;
 	return enabled.slice().sort((a, b) => a.priority - b.priority)[0] ?? null;
 }
-function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
+function variantChunks(variant, global, themeSizes, themeId, tokens, theme, colours, focusIndicator, nonColourEffects) {
 	const out = [];
 	const variantId = parseButtonVariantIdForCss(variant.id);
 	const selector = `:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}`;
-	out.push(variantBaseRule(variant, selector, global, tokens, theme));
+	out.push(variantBaseRule(variant, selector, global, tokens, theme, colours.base));
 	out.push({ raw: generateInteractiveChildInheritanceCSS(selector) });
-	const hoverBg = variantHoverBackgroundRule(variant, variantId, global, themeId, tokens);
-	if (hoverBg) out.push(hoverBg);
-	out.push(variantFocusVisibleRule(variantId, themeId));
-	const effects = variantEffectsCss(variant, themeId, tokens, theme);
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) if (!resolvedColoursEqual(colours.base, colours[state])) out.push(variantStateColourRule(variantId, themeId, state, colours[state]));
+	const effects = variantEffectsCss(variant, nonColourEffects, themeId, tokens, theme);
 	if (effects) out.push({ raw: effects });
-	const affordance = variantAffordanceRule(variant, selector, tokens);
+	out.push(variantFocusVisibleRule(variantId, themeId, focusIndicator));
+	const affordance = variantAffordanceRule(variant, selector);
 	if (affordance) out.push(affordance);
 	out.push(...variantDisabledRules(variantId, themeId));
 	out.push(...variantSizeRules(variant, variantId, themeSizes, themeId));
@@ -14532,21 +15483,20 @@ function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
 * one (node overrides personality). Colour comes from the affordance token, or
 * `currentColor` (the button text colour) when no token is given.
 */
-function variantAffordanceRule(variant, selector, tokens) {
+function variantAffordanceRule(variant, selector) {
 	const affordance = variant.affordance;
 	if (!affordance) return null;
 	const maskUrl = affordanceIconMaskUrl(affordance.iconId);
 	if (!maskUrl) return null;
-	const color = affordance.colorToken ? variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(affordance.colorToken)) : tokens.getColor(affordance.colorToken) : "currentColor";
 	const mask = `url("${maskUrl}") no-repeat center / contain`;
-	return rule(`${selector}:not(.${AFFORDANCE_SUPPRESS_CLASS})::after`, [
+	return rule$1(`${selector}:not(.${AFFORDANCE_SUPPRESS_CLASS})::after`, [
 		["content", "\"\""],
 		["display", "inline-block"],
 		["width", "1em"],
 		["height", "1em"],
 		["margin-inline-start", "0.5em"],
 		["flex", "0 0 auto"],
-		["background-color", color],
+		["background-color", "currentColor"],
 		["-webkit-mask", mask],
 		["mask", mask]
 	]);
@@ -14556,7 +15506,7 @@ function parseButtonVariantIdForCss(value) {
 	if (!variantId) throw new Error("Button variant id must be a non-empty string");
 	return variantId;
 }
-function variantBaseRule(variant, selector, global, tokens, theme) {
+function variantBaseRule(variant, selector, global, tokens, theme, colour) {
 	const decls = [];
 	decls.push(["font-weight", String(global.fontWeight)]);
 	decls.push(["font-family", resolveFontFamily(global)]);
@@ -14568,20 +15518,12 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 	for (const decl of STRUCTURAL_DECLARATIONS) decls.push(decl);
 	decls.push(["border-radius", resolveBorderRadius(variant, global)]);
 	decls.push(["box-shadow", resolveBoxShadow(variant, global, theme, tokens)]);
-	if (variant.background.type === "solid") decls.push(["background-color", tokens.getColor(variant.background.colorToken)]);
-	else if (variant.background.type === "gradient") {
-		const colors = variant.background.stops.map((stop) => tokens.getColor(stop)).join(", ");
-		const direction = GRADIENT_DIRECTION_MAP$3[variant.background.direction] || "to right";
-		decls.push(["background-image", `linear-gradient(${direction}, ${colors})`]);
-	} else decls.push(["background-color", "transparent"]);
-	const foregroundColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.textColorToken)) : tokens.getColor(variant.textColorToken);
-	decls.push(["color", foregroundColor]);
+	decls.push(...resolvedButtonColourDeclarations(colour));
 	if (variant.border) {
 		const borderWidth = BORDER_WIDTH_MAP$4[variant.border.widthClass] || "1px";
-		const borderColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.border.colorToken)) : tokens.getColor(variant.border.colorToken);
-		decls.push(["border", `${borderWidth} solid ${borderColor}`]);
+		decls.push(["border", `${borderWidth} solid currentColor`]);
 	}
-	return rule(selector, decls);
+	return rule$1(selector, decls);
 }
 /**
 * Resolve a colour for a button that does not own its own background.
@@ -14590,30 +15532,22 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 * token fallback keeps buttons usable in contexts that do not provide that
 * contract (and preserves the existing theme behaviour there).
 */
-function surfaceLinkColor(fallbackColor) {
-	return `var(--rb-surface-link-color, ${fallbackColor})`;
-}
-function variantHoverBackgroundRule(variant, variantId, global, themeId, tokens) {
-	let hoverToken = variant.hoverBackgroundToken;
-	if (!hoverToken && global.hoverColor === "token" && global.hoverColorToken) hoverToken = global.hoverColorToken;
-	if (!hoverToken) return null;
-	return rule(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:hover`, [["background-color", tokens.getColor(hoverToken)]]);
+function variantStateColourRule(variantId, themeId, state, colour) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:${state}`, resolvedButtonColourDeclarations(colour));
 }
-function variantFocusVisibleRule(variantId, themeId) {
-	return rule(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, [["outline", "2px solid currentColor"], ["outline-offset", "3px"]]);
+function variantFocusVisibleRule(variantId, themeId, focusIndicator) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, resolvedButtonFocusDeclarations(focusIndicator));
 }
-function variantEffectsCss(variant, themeId, tokens, theme) {
-	if (!variant.effects) return "";
+function variantEffectsCss(variant, effects, themeId, tokens, theme) {
+	if (!effects) return "";
 	const elementConfig = {
-		background: variant.background,
-		textColorToken: variant.textColorToken,
-		border: variant.border ? { colorToken: variant.border.colorToken } : void 0,
+		background: variant.background.type === "surface" ? { type: "transparent" } : variant.background,
 		shadow: variant.shadow
 	};
 	return generateEffectsCSS({
 		themeId,
 		variantId: variant.id,
-		effects: variant.effects,
+		effects,
 		elementConfig,
 		tokens,
 		theme
@@ -14628,18 +15562,15 @@ function variantDisabledRules(variantId, themeId) {
 		`${base}:focus`
 	];
 	const pseudoSelectors = [`${base}::before`, `${base}::after`];
-	return [rule(disabledSelectors, [
-		["opacity", "0.5"],
-		["cursor", "not-allowed"],
-		["pointer-events", "none"],
-		["transform", "none"],
-		["box-shadow", "none"]
-	]), rule(pseudoSelectors, [
+	return [rule$1(disabledSelectors, [...RESOLVED_BUTTON_DISABLED_DECLARATIONS]), rule$1(pseudoSelectors, [
 		["opacity", "0"],
 		["animation", "none"],
 		["pointer-events", "none"]
 	])];
 }
+function resolvedColoursEqual(left, right) {
+	return JSON.stringify(left) === JSON.stringify(right);
+}
 function variantSizeRules(variant, variantId, themeSizes, themeId) {
 	const borderWidth = variant.border ? BORDER_WIDTH_MAP$4[variant.border.widthClass] || "1px" : "0px";
 	const rules = [];
@@ -14649,7 +15580,7 @@ function variantSizeRules(variant, variantId, themeSizes, themeId) {
 		const decls = [];
 		for (const decl of paddingDeclarations(config.padding, borderWidth)) decls.push(decl);
 		if (config.fontSize) decls.push(["font-size", FONT_SIZE_MAP[config.fontSize] || "1rem"]);
-		rules.push(rule(selector, decls));
+		rules.push(rule$1(selector, decls));
 	}
 	return rules;
 }
@@ -14718,6 +15649,10 @@ var init_generateButtonCss = __esmMin((() => {
 	init_constants$2();
 	init_generateDefaultButtonSystem();
 	init_affordanceIcons();
+	init_expandPalette();
+	init_foregroundContract();
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
 	AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 	BUTTON_SIZE_NAMES = buttonSizeNameSchema.options;
 	LETTER_SPACING_MAP = {
@@ -14734,23 +15669,51 @@ var init_generateButtonCss = __esmMin((() => {
 		["outline", "none"]
 	];
 }));
-var init_presets$1 = __esmMin((() => {}));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
+var init_presets$1 = __esmMin((() => {
+	init_personalities();
+	buttonPersonalities.map((personality) => ({
+		id: personality.id,
+		name: personality.name,
+		description: personality.description,
+		category: presetCategory(personality),
+		buttonSystem: personality.buttonSystem,
+		compatibility: {
+			...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+			...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+		}
+	}));
+}));
 //#endregion
 //#region ../theme-core/src/buttons/effects/types.ts
-var init_types$11 = __esmMin((() => {}));
-var init_core$1 = __esmMin((() => {}));
+var init_types$10 = __esmMin((() => {}));
+var init_core$1 = __esmMin((() => {
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
+	init_types$13();
+}));
 //#endregion
 //#region ../theme-core/src/buttons/index.ts
 var init_buttons = __esmMin((() => {
 	init_types$13();
 	init_classNames();
 	init_generateButtonCss();
+	init_resolveButtonColourStates();
 	init_affordanceIcons();
 	init_generateDefaultButtonSystem();
 	init_constants$2();
 	init_presets$1();
 	init_personalities();
-	init_types$11();
+	init_types$10();
 	init_registry$1();
 	init_transform();
 	init_core$1();
@@ -14770,7 +15733,7 @@ function normalizeBoxStylesCardVariant(value) {
 	return normalizeCardVariantRole(value);
 }
 var cardVariantRoleValues, boxlessCardVariantValue, legacyCardVariantRoleAliases, cardSpacingSchema, gradientDirectionSchema, cardVariantRoleSchema, boxStylesCardVariantSchema, cardBackgroundSchema, cardBorderSchema, cardCornerValueSchema, cardAccentEdgeSchema, cardCornerRadiiSchema, cardVariantSchema, cardSystemSchema;
-var init_types$10 = __esmMin((() => {
+var init_types$9 = __esmMin((() => {
 	init_themeColorTokens();
 	cardVariantRoleValues = ["default", "alternative"];
 	boxlessCardVariantValue = "none";
@@ -15112,7 +16075,7 @@ var init_core = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/cards/index.ts
 var init_cards = __esmMin((() => {
-	init_types$10();
+	init_types$9();
 	init_constants$1();
 	init_generateCardCss();
 	init_generateDefaultCardSystem();
@@ -15121,7 +16084,7 @@ var init_cards = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/accordions/types.ts
 var accordionIconSchema, accordionSystemSchema, ICON_CONFIG, ICON_SIZE_PX, ACCORDION_SPACING_MAP, ACCORDION_TRIGGER_FONT_SCALE, ACCORDION_TRIGGER_LETTER_SPACING, ACCORDION_OPEN_ACCENT_THICKNESS;
-var init_types$9 = __esmMin((() => {
+var init_types$8 = __esmMin((() => {
 	init_themeColorTokens();
 	accordionIconSchema = z$1.enum([
 		"plus-minus",
@@ -15278,7 +16241,7 @@ var init_types$9 = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/inputs/types.ts
 var inputSystemSchema, INPUT_SPACING_MAP, INPUT_FONT_SIZE_MAP, LABEL_FONT_SIZE_MAP, FONT_WEIGHT_MAP;
-var init_types$8 = __esmMin((() => {
+var init_types$7 = __esmMin((() => {
 	init_themeColorTokens();
 	inputSystemSchema = z$1.object({
 		base: z$1.object({
@@ -15397,31 +16360,6 @@ var init_types$8 = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
-var init_types$7 = __esmMin((() => {
-	init_themeColorTokens();
-	gradientStopSchema = z$1.object({
-		color: themeColorTokenSchema,
-		position: z$1.number().min(0).max(100)
-	});
-	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-	gradientConfigSchema = z$1.object({
-		type: z$1.enum([
-			"linear",
-			"radial",
-			"conic"
-		]).default("linear"),
-		angle: z$1.number().min(0).max(360).optional(),
-		shape: radialGradientShapeSchema.optional(),
-		position: z$1.string().optional(),
-		stops: z$1.array(gradientStopSchema).min(2)
-	});
-}));
-//#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
 /**
 * Shared Base Schemas for Interactive Elements
@@ -15977,9 +16915,9 @@ var init_schema$1 = __esmMin((() => {
 	init_media$1();
 	init_buttons();
 	init_cards();
-	init_types$9();
 	init_types$8();
 	init_types$7();
+	init_types$11();
 	init_types$6();
 	init_validation$2();
 	init_atRuleValidation();
@@ -16984,6 +17922,21 @@ var init_designState = __esmMin((() => {
 		styleAuthorities: z$1.array(blockRuntimeStyleAuthoritySchema)
 	}).strict();
 }));
+//#endregion
+//#region ../theme-core/src/site-styles/runtimeCompiler.ts
+function defineSectionForegroundRuntimeTokens(input) {
+	return {
+		textColor: requireThemeColorToken(input.textColor),
+		headingColor: requireThemeColorToken(input.headingColor),
+		linkColor: requireThemeColorToken(input.linkColor),
+		supportingColor: requireThemeColorToken(input.supportingColor)
+	};
+}
+function requireThemeColorToken(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) throw new Error(`Invalid section foreground Theme color token: ${String(value)}`);
+	return token;
+}
 function defineDesignRuntimeRules(rules) {
 	return rules;
 }
@@ -17009,6 +17962,8 @@ var init_runtimeCompiler = __esmMin((() => {
 	init_types$16();
 	init_accessibleSurfaces();
 	init_sectionTransitions();
+	init_tokens();
+	init_gradients();
 	defaultDesignRuntimeRules = defineDesignRuntimeRules({
 		sectionSurfaces: {
 			base: {},
@@ -17407,13 +18362,14 @@ function inferHeaderCurationFromLegacyLooks(lookIds, recipes) {
 function getCuratedSiteStyle(id) {
 	return curatedSiteStylesById.get(id) ?? null;
 }
-var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles, curatedSiteStylesById;
+var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, primaryGlowGradientPresetId, fulcrumDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles, curatedSiteStylesById;
 var init_curatedSiteStyles = __esmMin((() => {
 	init_personalities();
 	init_curated();
 	init_siteStyleDefaults$1();
 	init_siteStyleDefaults();
 	init_testimonialQuotePresets();
+	init_gradients();
 	init_headerLooks();
 	init_footerLooks();
 	init_curatedChoices();
@@ -17481,24 +18437,24 @@ var init_curatedSiteStyles = __esmMin((() => {
 					type: "color",
 					color: "muted"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"brand-depth-band": {
 				background: {
 					type: "color",
 					color: "primary-800"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"hero-image": {
 				background: {
@@ -17506,12 +18462,32 @@ var init_curatedSiteStyles = __esmMin((() => {
 					opacity: 1,
 					position: "center center"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
+			}
+		}
+	});
+	primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+	if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+	fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+		...defaultDesignRuntimeRules,
+		sectionSurfaces: {
+			...defaultDesignRuntimeRules.sectionSurfaces,
+			"accent-band": {
+				background: {
+					type: "gradient",
+					gradientPresetId: primaryGlowGradientPresetId
+				},
+				foreground: defineSectionForegroundRuntimeTokens({
+					textColor: "primaryForeground",
+					headingColor: "primaryForeground",
+					linkColor: "primaryForeground",
+					supportingColor: "primaryForeground"
+				})
 			}
 		}
 	});
@@ -18688,6 +19664,8 @@ var init_curatedSiteStyles = __esmMin((() => {
 			},
 			compositionBudget: quietBudget,
 			typography: fulcrumTypography,
+			designRuntimeRules: fulcrumDesignRuntimeRules,
+			recommendedAppearancePresetIds: ["cta-accent-band"],
 			themeOverrides: {
 				shadow: { colorToken: "primary" },
 				accordions: {
@@ -20599,7 +21577,7 @@ function createSdkSelectField(input) {
 		}
 	}));
 }
-var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS$2, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens, colorTokens, spacingTokens, radiusTokens, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum;
+var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS$2, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens, colorTokens, spacingTokens, radiusTokens, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum, blockContentSourceKinds, blockContentSourceSchema;
 var init_schema = __esmMin((() => {
 	init_src$2();
 	init_node();
@@ -21130,6 +22108,21 @@ var init_schema = __esmMin((() => {
 		"layout",
 		"interactive"
 	]);
+	blockContentSourceKinds = [
+		"inline",
+		"entries",
+		"mixed"
+	];
+	blockContentSourceSchema = z$1.object({
+		kind: z$1.enum(blockContentSourceKinds),
+		contentType: z$1.string().min(1).optional()
+	}).superRefine((value, ctx) => {
+		if (value.kind === "inline" && value.contentType) ctx.addIssue({
+			code: z$1.ZodIssueCode.custom,
+			path: ["contentType"],
+			message: "contentType is not allowed when contentSource.kind is \"inline\""
+		});
+	});
 	z$1.object({
 		name: z$1.string().min(1),
 		version: z$1.string().min(1),
@@ -21160,6 +22153,12 @@ var init_schema = __esmMin((() => {
 		}).optional()).optional(),
 		category: blockCategoryEnum.optional(),
 		contentTypes: z$1.array(z$1.string()).optional(),
+		/**
+		* Explicit content-source classification (inline / entries / mixed). Optional at the
+		* schema level for backward compatibility with SDK-defined custom blocks, but every
+		* registered SYSTEM block must declare it (enforced by a registry-wide test).
+		*/
+		contentSource: blockContentSourceSchema.optional(),
 		tags: z$1.array(z$1.string()).optional(),
 		icon: z$1.string().optional()
 	});
@@ -21555,9 +22554,15 @@ var init_heroCopy = __esmMin((() => {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -21566,11 +22571,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 var init_ctas = __esmMin((() => {
@@ -21632,6 +22634,7 @@ var init_heroCtaRow = __esmMin((() => {
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -21710,7 +22713,7 @@ var init_ctaCopy = __esmMin((() => {
 			eyebrowPath: "content.eyebrow",
 			titlePath: "content.title",
 			className: "cta-heading"
-		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 	});
 }));
 //#endregion
@@ -24887,6 +25890,7 @@ function createBlockManifest(config) {
 		previewCustomize: config.previewCustomize,
 		category: config.category,
 		contentTypes: config.contentTypes ? [...config.contentTypes] : void 0,
+		contentSource: config.contentSource,
 		tags: config.tags ? [...config.tags] : [],
 		icon: config.icon ?? "Box",
 		layout,
@@ -24942,6 +25946,7 @@ var init_event_details = __esmMin((() => {
 		titleSource: "heading",
 		description: "Date/time, venue, map, and other dates for an event",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"venue",
@@ -111950,7 +112955,7 @@ function validateNormalizedFieldValue(plan, value, ctx) {
 		case "select": return validateSelectPlan(plan, value);
 		case "richText": return isValidRichTextDoc(value) ? [] : [issue(plan, "invalidRichText")];
 		case "inlineText": return validateInlineTextPlan(plan, value);
-		case "media": return isPlainObject$4(value) ? [] : [issue(plan, "invalidMedia")];
+		case "media": return isPlainObject$5(value) ? [] : [issue(plan, "invalidMedia")];
 		case "link": return linkSchema.safeParse(value).success ? [] : [issue(plan, "invalidLink")];
 		case "repeater": return validateRepeaterPlan(plan, value, ctx);
 		case "group": return validateGroupPlan(plan, value, ctx);
@@ -112043,7 +113048,7 @@ function validateRepeaterPlan(plan, value, ctx) {
 	}), ...value.flatMap((item, index) => validateRepeaterItem(plan, item, index, ctx))];
 }
 function validateRepeaterItem(plan, item, index, ctx) {
-	if (!isPlainObject$4(item)) return [];
+	if (!isPlainObject$5(item)) return [];
 	const itemType = item._type;
 	const fields = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === itemType)?.fields : plan.repeatedItemPlan;
 	if (!fields) return [];
@@ -112052,7 +113057,7 @@ function validateRepeaterItem(plan, item, index, ctx) {
 	});
 }
 function validateGroupPlan(plan, value, ctx) {
-	if (!isPlainObject$4(value)) return [issue(plan, "wrongType", { expected: "an object" })];
+	if (!isPlainObject$5(value)) return [issue(plan, "wrongType", { expected: "an object" })];
 	const childCtx = childValidationContext(plan, ctx);
 	return plan.children.flatMap((childPlan) => validateNormalizedFieldValue(childPlan, value[childPlan.fieldId], childCtx));
 }
@@ -112249,7 +113254,7 @@ function sameFieldPath(left, right) {
 	return left.length === right.length && left.every((segment, index) => segment === right[index]);
 }
 function validateExplicitNullsForPush(plans, content, ctx) {
-	if (!isPlainObject$4(content)) return [];
+	if (!isPlainObject$5(content)) return [];
 	return plans.flatMap((plan) => validateExplicitNullForPushPlan(plan, content[plan.fieldId], ctx));
 }
 function validateExplicitNullForPushPlan(plan, value, ctx) {
@@ -112272,7 +113277,7 @@ function validateExplicitNullForPushPlan(plan, value, ctx) {
 function validateExplicitNullsForPushRepeater(plan, value, ctx) {
 	if (!isUnknownArray$2(value)) return [];
 	return value.flatMap((item, index) => {
-		if (!isPlainObject$4(item)) return [];
+		if (!isPlainObject$5(item)) return [];
 		const childPlans = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === item._type)?.fields : plan.repeatedItemPlan;
 		if (!childPlans) return [];
 		return childPlans.flatMap((childPlan) => validateExplicitNullForPushPlan(materializeRepeaterItemPlan(childPlan, plan.path, index), item[childPlan.fieldId], ctx));
@@ -112355,7 +113360,7 @@ function isEmptyValue$1(value) {
 	if (isEmptyRichTextDoc(value)) return true;
 	return false;
 }
-function isPlainObject$4(value) {
+function isPlainObject$5(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isUnknownArray$2(value) {
@@ -112363,11 +113368,11 @@ function isUnknownArray$2(value) {
 }
 function isValidRichTextDoc(value) {
 	const doc = richTextDoc(value);
-	return Boolean(isPlainObject$4(doc) && doc.type === "doc");
+	return Boolean(isPlainObject$5(doc) && doc.type === "doc");
 }
 function isEmptyRichTextDoc(value) {
 	const doc = richTextDoc(value);
-	if (!isPlainObject$4(doc)) return false;
+	if (!isPlainObject$5(doc)) return false;
 	if (doc.type !== "doc") return false;
 	const content = doc.content;
 	if (!Array.isArray(content) || content.length === 0) return true;
@@ -112376,8 +113381,8 @@ function isEmptyRichTextDoc(value) {
 	return first?.type === "paragraph" && (!Array.isArray(first.content) || first.content.length === 0);
 }
 function richTextDoc(value) {
-	if (!isPlainObject$4(value)) return value;
-	return isPlainObject$4(value.doc) ? value.doc : value;
+	if (!isPlainObject$5(value)) return value;
+	return isPlainObject$5(value.doc) ? value.doc : value;
 }
 //#endregion
 //#region ../blocks/src/system/manifest/registry.ts
@@ -112638,6 +113643,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -112915,6 +113921,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -113104,6 +114111,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -113163,6 +114171,10 @@ const blogPostBlockDefinition = {
 		description: "Highlights a single blog post with title, image, and excerpt.",
 		category: "blog",
 		contentTypes: ["post"],
+		contentSource: {
+			kind: "entries",
+			contentType: "post"
+		},
 		tags: [
 			"blog",
 			"post",
@@ -113466,6 +114478,10 @@ const blogListingManifest = createBlockManifest({
 	],
 	description: "Display a collection of blog posts in grid or stack layout.",
 	contentTypes: ["post"],
+	contentSource: {
+		kind: "entries",
+		contentType: "post"
+	},
 	tags: [
 		"blog",
 		"posts",
@@ -113512,6 +114528,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -113549,6 +114566,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -113655,6 +114673,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -113722,6 +114741,7 @@ const contactNewsletterBlockDefinition = {
 		titleSource: "contactTitle",
 		description: "Two-column newsletter signup and contact form section.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		layout: contactNewsletterLayout,
 		defaultVariant: "default",
 		variants: { default: contactNewsletterLayout },
@@ -113932,6 +114952,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -114237,7 +115258,7 @@ const heroTitleLengthThresholds = {
 		maxWords: 11
 	}
 };
-function isPlainObject$3(value) {
+function isPlainObject$4(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function readString$1(obj, key) {
@@ -114246,7 +115267,7 @@ function readString$1(obj, key) {
 }
 function resolveGeneratedHeroLayoutStyles(content) {
 	const raw = content._heroLayoutStyles;
-	return isPlainObject$3(raw) ? raw : null;
+	return isPlainObject$4(raw) ? raw : null;
 }
 function readHeroLayoutString(content, generatedKey, fallbackKey = generatedKey) {
 	const explicitValue = readString$1(content, fallbackKey);
@@ -114302,7 +115323,7 @@ const heroContentWrapperClassTransform = {
 	summary: "Resolve hero content wrapper className from alignment + max width controls",
 	schema: z$1.object({ base: z$1.string().optional() }),
 	run: (value, options, context) => {
-		const content = isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {};
+		const content = isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {};
 		const alignment = resolveHeroContentAlignment(content);
 		const maxWidth = resolveHeroContentMaxWidth(content);
 		const typographyScale = resolveHeroTypographyScale(content);
@@ -114325,7 +115346,7 @@ const heroCtaJustifyTransform = {
 	kind: "string",
 	summary: "Map hero contentAlignment to CTA row justify value",
 	run: (value, _options, context) => {
-		const alignment = resolveHeroContentAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const alignment = resolveHeroContentAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		return alignment === "left" ? "start" : alignment === "right" ? "end" : "center";
 	}
 };
@@ -114334,7 +115355,7 @@ const heroStackJustifyFromVerticalAlignmentTransform = {
 	kind: "string",
 	summary: "Map hero verticalAlignment to stack justify value",
 	run: (value, _options, context) => {
-		const vertical = resolveHeroVerticalAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const vertical = resolveHeroVerticalAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		return vertical === "top" ? "start" : vertical === "bottom" ? "end" : "center";
 	}
 };
@@ -114344,7 +115365,7 @@ const heroGridClassFromVerticalAlignmentTransform = {
 	summary: "Append align-items class for hero split layouts based on verticalAlignment",
 	schema: z$1.object({ base: z$1.string() }),
 	run: (value, options, context) => {
-		const vertical = resolveHeroVerticalAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const vertical = resolveHeroVerticalAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		const itemsClass = vertical === "top" ? "rb-items-start" : vertical === "bottom" ? "rb-items-end" : "rb-items-center";
 		return joinClasses$2([options.base, itemsClass]);
 	}
@@ -115656,6 +116677,7 @@ const siteHeaderManifest = createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -115870,6 +116892,7 @@ const siteFooterManifest = createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	layout: section$1({
 		background: "background",
@@ -116029,6 +117052,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -116193,6 +117217,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -116433,6 +117458,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -116727,6 +117753,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -117119,6 +118146,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -117527,6 +118555,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -117697,6 +118726,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -117790,6 +118820,7 @@ const weeklySlotAvailabilityBlockDefinition = {
 init_builder$2();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared$4();
 init_shop_shared();
@@ -117804,6 +118835,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -117910,15 +118942,9 @@ const eventRegistrationBlockDefinition = {
 				defaultValue: "Complete Registration",
 				maxLength: 40
 			},
-			{
-				id: "buttonVariant",
-				type: "select",
-				label: "Button style",
+			createButtonVariantField({
 				description: "Choose a button style from your theme",
-				required: false,
-				multiple: false,
-				defaultValue: "primary",
-				options: [
+				variants: [
 					{
 						value: "primary",
 						label: "Primary"
@@ -117931,9 +118957,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -118022,6 +119047,7 @@ const eventRegistrationBlockDefinition = {
 init_builder$2();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared();
 init_defineBlock();
@@ -118034,6 +119060,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -118147,15 +119174,9 @@ const courseRegistrationBlockDefinition = {
 				defaultValue: "Sign up",
 				maxLength: 40
 			},
-			{
-				id: "buttonVariant",
-				type: "select",
-				label: "Button style",
+			createButtonVariantField({
 				description: "Choose a button style from your theme",
-				required: false,
-				multiple: false,
-				defaultValue: "primary",
-				options: [
+				variants: [
 					{
 						value: "primary",
 						label: "Primary"
@@ -118168,9 +119189,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -118246,6 +119266,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -118545,6 +119566,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -118878,6 +119900,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -119888,6 +120911,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -120295,6 +121319,7 @@ const recurringScheduleBlockDefinition = {
 		titleSource: "heading",
 		description: "A compact weekly schedule with one row per recurring series.",
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		icon: "CalendarDays",
 		tags: [
 			"schedule",
@@ -120935,7 +121960,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -120988,6 +122016,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -121163,6 +122192,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -121655,6 +122685,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -122313,6 +123344,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -122518,6 +123550,7 @@ const audioPlayerBlockDefinition = { manifest: createBlockManifest({
 	title: "Audio Player",
 	titleSource: "title",
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a branded audio player for a single track.",
 	tags: [
 		"audio",
@@ -122607,6 +123640,7 @@ const fileDownloadBlockDefinition = { manifest: createBlockManifest({
 	title: "File Download",
 	titleSource: ["title", "file.filename"],
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a simple public download link for a document, ZIP, or audio file.",
 	tags: [
 		"file",
@@ -122866,6 +123900,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -123075,6 +124110,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -123226,6 +124262,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -123351,6 +124388,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -123442,6 +124480,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -123561,6 +124600,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -123656,6 +124696,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -123843,6 +124884,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -124141,6 +125183,7 @@ const locationMapBlockDefinition = {
 		titleSource: "heading",
 		description: "Show a business location with an interactive map and directions link.",
 		category: "content",
+		contentSource: { kind: "inline" },
 		tags: [
 			"map",
 			"location",
@@ -125153,216 +126196,6 @@ function getBlockDefinition(name) {
 //#region ../blocks/src/system/theme/index.ts
 init_tokens();
 //#endregion
-//#region ../theme-core/src/gradients/presets.ts
-/**
-* Curated library of gradient presets
-* All gradients use theme color tokens, so they adapt to the site's palette
-*/
-const GRADIENT_PRESETS = [
-	{
-		id: "primary-secondary",
-		name: "Primary to Secondary",
-		description: "Blend your primary and secondary brand colors",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "secondary-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-accent",
-		name: "Primary to Accent",
-		description: "Energetic gradient from primary to accent",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-accent",
-		name: "Secondary to Accent",
-		description: "Vibrant secondary to accent blend",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-light-dark",
-		name: "Primary Light to Dark",
-		description: "Subtle primary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-dark-light",
-		name: "Primary Dark to Light",
-		description: "Reverse primary fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-900",
-			position: 0
-		}, {
-			color: "primary-50",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-light-dark",
-		name: "Secondary Light to Dark",
-		description: "Subtle secondary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "secondary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-light-dark",
-		name: "Accent Light to Dark",
-		description: "Accent color depth fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "background-surface",
-		name: "Background to Surface",
-		description: "Subtle depth using base colors",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "background",
-			position: 0
-		}, {
-			color: "surface",
-			position: 100
-		}]
-	},
-	{
-		id: "neutral-fade",
-		name: "Neutral Gradient",
-		description: "Elegant neutral color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "neutral-900",
-			position: 0
-		}, {
-			color: "neutral-50",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-radial",
-		name: "Primary Spotlight",
-		description: "Radial primary gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-radial",
-		name: "Accent Spotlight",
-		description: "Radial accent gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-secondary-accent",
-		name: "Brand Trio",
-		description: "All three brand colors in harmony",
-		type: "linear",
-		angle: 135,
-		stops: [
-			{
-				color: "primary-500",
-				position: 0
-			},
-			{
-				color: "secondary-500",
-				position: 50
-			},
-			{
-				color: "accent-500",
-				position: 100
-			}
-		]
-	}
-];
-//#endregion
-//#region ../theme-core/src/gradients/utils.ts
-/**
-* Convert a GradientConfig to a CSS gradient string
-*
-* @param config - The gradient configuration using theme tokens
-* @param tokens - Map of theme color tokens to hex values
-* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
-*/
-function gradientToCss(config, tokens) {
-	const stops = config.stops.map((stop) => {
-		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
-	}).join(", ");
-	const type = config.type ?? "linear";
-	if (type === "radial") {
-		const position = config.position ?? "center";
-		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
-	}
-	if (type === "conic") {
-		const position = config.position ?? "center";
-		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
-	}
-	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
-}
-//#endregion
-//#region ../theme-core/src/gradients/index.ts
-init_types$7();
-//#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 init_media$2();
 function resolveBackgroundMedia(input) {
@@ -125384,6 +126217,7 @@ function backgroundVideoMobileClassNames(input) {
 //#endregion
 //#region ../blocks/src/system/transforms/registry/background.ts
 init_background$1();
+init_gradients();
 init_themeColorResolution();
 init_surfaceForegroundStyles();
 init_media();
@@ -125405,9 +126239,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString$1(value)) return null;
-	const preset = GRADIENT_PRESETS.find((candidate) => candidate.id === value.trim());
-	if (!preset) return null;
+	const presetId = parseGradientPresetId(value);
+	if (!presetId) return null;
+	const preset = getGradientPreset(presetId);
 	return gradientToCss(preset, Object.fromEntries(preset.stops.map((stop) => [stop.color, `rgb(var(--tb-${stop.color}))`])));
 }
 const backgroundTransforms = [
@@ -127018,7 +127852,7 @@ function normalizeBoolean(value) {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/accordionIconTreatment.ts
-init_types$9();
+init_types$8();
 init_colorStyles();
 function resolveAccordionIconStyle(iconStyle, iconTreatment) {
 	if (iconTreatment) switch (iconTreatment.iconSet) {
@@ -127050,7 +127884,7 @@ init_clsx();
 init_RichText();
 init_richText_coerce();
 init_svg();
-init_types$9();
+init_types$8();
 /**
 * Lookup map for accordion icons - only these 6 icons are bundled
 */
@@ -130239,7 +131073,7 @@ function readFromSource$1(source, segments) {
 /**
 * Type guard for plain objects.
 */
-function isPlainObject$2(value) {
+function isPlainObject$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -130248,18 +131082,18 @@ function isPlainObject$2(value) {
 function parseRouteEntry(routeId, value) {
 	if (typeof routeId !== "string" || routeId.length === 0) return null;
 	if (typeof value === "string") return [routeId, value];
-	if (isPlainObject$2(value)) return [routeId, value];
+	if (isPlainObject$3(value)) return [routeId, value];
 	return null;
 }
 /**
 * Extracts route map from $root.routes in the viewModel.
 */
 function extractRouteMapFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const routes = root.routes;
-	if (!isPlainObject$2(routes)) return void 0;
+	if (!isPlainObject$3(routes)) return void 0;
 	const entries = Object.entries(routes).map(([routeId, value]) => parseRouteEntry(routeId, value)).filter((entry) => entry !== null);
 	if (entries.length === 0) return void 0;
 	return Object.fromEntries(entries);
@@ -130268,22 +131102,22 @@ function extractRouteMapFromViewModel(viewModel) {
 * Extracts pagesByIdentifier from $root.pagesByIdentifier in the viewModel.
 */
 function extractPagesByIdentifierFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const pagesByIdentifier = root.pagesByIdentifier;
-	if (!isPlainObject$2(pagesByIdentifier)) return void 0;
+	if (!isPlainObject$3(pagesByIdentifier)) return void 0;
 	return pagesByIdentifier;
 }
 /**
 * Extracts entriesByIdentifier from $root.entriesByIdentifier in the viewModel.
 */
 function extractEntriesByIdentifierFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const entriesByIdentifier = root.entriesByIdentifier;
-	if (!isPlainObject$2(entriesByIdentifier)) return void 0;
+	if (!isPlainObject$3(entriesByIdentifier)) return void 0;
 	return entriesByIdentifier;
 }
 /**
@@ -130305,7 +131139,7 @@ function applyTransformsAndFallback(value, binding, context) {
 	const routeMap = context.routes ?? extractRouteMapFromViewModel(context.viewModel);
 	const pagesByIdentifier = context.pagesByIdentifier ?? extractPagesByIdentifierFromViewModel(context.viewModel);
 	const entriesByIdentifier = context.entriesByIdentifier ?? extractEntriesByIdentifierFromViewModel(context.viewModel);
-	const stage = (isPlainObject$2(context.viewModel.$root) ? context.viewModel.$root : null)?.previewStage === "preview" ? "preview" : "published";
+	const stage = (isPlainObject$3(context.viewModel.$root) ? context.viewModel.$root : null)?.previewStage === "preview" ? "preview" : "published";
 	const transformed = runTransforms(value, binding.transforms?.map((step) => ({
 		id: step.id,
 		options: step.options
@@ -130334,15 +131168,15 @@ function resolveTransformData(context, bindingPath) {
 	const [first] = splitPath$1(bindingPath);
 	if (typeof first === "string" && first !== "$root") {
 		const namedScope = context.scopes.find((entry) => entry.name === first);
-		if (namedScope && isPlainObject$2(namedScope.value)) return namedScope.value;
+		if (namedScope && isPlainObject$3(namedScope.value)) return namedScope.value;
 	}
 	for (let i = context.scopes.length - 1; i >= 0; i -= 1) {
 		const scope = context.scopes[i];
-		if (scope && isPlainObject$2(scope.value)) return scope.value;
+		if (scope && isPlainObject$3(scope.value)) return scope.value;
 	}
 	const content = context.viewModel.content;
-	if (isPlainObject$2(content)) return content;
-	if (isPlainObject$2(context.viewModel)) return context.viewModel;
+	if (isPlainObject$3(content)) return content;
+	if (isPlainObject$3(context.viewModel)) return context.viewModel;
 }
 function coerceBindingValue(value, binding) {
 	const mode = binding.coerce;
@@ -130404,7 +131238,7 @@ function isRichTextConditionValueEmpty(value) {
 	return richTextStructuralPresence(root).kind === "empty";
 }
 function isTipTapNode(value) {
-	return isPlainObject$2(value) && typeof value.type === "string";
+	return isPlainObject$3(value) && typeof value.type === "string";
 }
 function richTextStructuralPresence(node) {
 	if (typeof node.text === "string" && node.text.trim().length > 0) return {
@@ -130433,7 +131267,7 @@ function richTextSelfPresence(node) {
 	}
 }
 function hasResolvableRichTextImageSource(node) {
-	const attrs = isPlainObject$2(node.attrs) ? node.attrs : {};
+	const attrs = isPlainObject$3(node.attrs) ? node.attrs : {};
 	return hasNonBlankStringAttr(attrs, "src") || hasNonBlankStringAttr(attrs, "identifier");
 }
 function hasNonBlankStringAttr(attrs, key) {
@@ -130625,7 +131459,7 @@ function getNestedBinding(bindings, path) {
 	const segments = path.split(".");
 	let current = bindings;
 	for (const segment of segments) {
-		if (!isPlainObject$2(current)) return void 0;
+		if (!isPlainObject$3(current)) return void 0;
 		current = current[segment];
 	}
 	return current;
@@ -130648,7 +131482,7 @@ function resolveBindingToEditorPath(fieldName, bindings, editableRouteMetadataFi
 	};
 	const binding = bindings[fieldName] ?? getNestedBinding(bindings, fieldName);
 	if (!binding) return null;
-	if (isPlainObject$2(binding) && "source" in binding) {
+	if (isPlainObject$3(binding) && "source" in binding) {
 		const source = binding.source;
 		if (source === "field" && "path" in binding) {
 			const path = binding.path;
@@ -130665,7 +131499,7 @@ function resolveBindingToEditorPath(fieldName, bindings, editableRouteMetadataFi
 			if (!Array.isArray(options)) return null;
 			for (const option of options) {
 				if (typeof option === "string") return `content.${option}`;
-				if (isPlainObject$2(option) && "source" in option) {
+				if (isPlainObject$3(option) && "source" in option) {
 					const optSource = option.source;
 					if (optSource === "field" && "path" in option) {
 						const path = option.path;
@@ -130717,7 +131551,7 @@ function derivePreviewTextEditableTarget(parsedBinding, context) {
 		};
 	}
 	const root = context.viewModel?.$root;
-	if (isPlainObject$2(root) && root.contentEntry != null && context.pathBase) return {
+	if (isPlainObject$3(root) && root.contentEntry != null && context.pathBase) return {
 		kind: "read-only",
 		reason: "entry-template-block-field"
 	};
@@ -130776,7 +131610,7 @@ function injectMediaSlotPath(props, node, parsedBinding, context) {
 		if (resolveBindingToEditorPath(fieldPath, context.blockBindings, context.editableRouteMetadataFieldIds)) return props;
 	}
 	const root = context.viewModel?.$root;
-	if (isPlainObject$2(root) && root.contentEntry != null && context.pathBase) return props;
+	if (isPlainObject$3(root) && root.contentEntry != null && context.pathBase) return props;
 	return {
 		...props,
 		fieldPath
@@ -130923,7 +131757,7 @@ function getNodeProps(node) {
 		if (key.startsWith("$")) continue;
 		legacy[key] = value;
 	}
-	const props = isPlainObject$2(node.props) ? node.props : {};
+	const props = isPlainObject$3(node.props) ? node.props : {};
 	return {
 		...legacy,
 		...props
@@ -131036,7 +131870,7 @@ function generateHoverEffects(axes, _space) {
 //#endregion
 //#region ../theme-core/src/blockOverrides.ts
 const BLOCK_PREFIX = "block.";
-function isPlainObject$1(value) {
+function isPlainObject$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isUnknownArray$1(value) {
@@ -131044,7 +131878,7 @@ function isUnknownArray$1(value) {
 }
 function cloneValue(value) {
 	if (isUnknownArray$1(value)) return value.map((item) => cloneValue(item));
-	if (isPlainObject$1(value)) {
+	if (isPlainObject$2(value)) {
 		const cloned = {};
 		for (const [key, child] of Object.entries(value)) cloned[key] = cloneValue(child);
 		return cloned;
@@ -131054,7 +131888,7 @@ function cloneValue(value) {
 function mergeDeep(defaultValue, overrideValue) {
 	if (overrideValue === void 0) return cloneValue(defaultValue);
 	if (overrideValue === null) return null;
-	if (isPlainObject$1(defaultValue) && isPlainObject$1(overrideValue)) {
+	if (isPlainObject$2(defaultValue) && isPlainObject$2(overrideValue)) {
 		const merged = {};
 		const keys = /* @__PURE__ */ new Set([...Object.keys(defaultValue), ...Object.keys(overrideValue)]);
 		for (const key of keys) merged[key] = mergeDeep(defaultValue[key], overrideValue[key]);
@@ -131111,7 +131945,7 @@ function mergeContentWithBlockStyleOverrides(content, theme, blockKind) {
 */
 function applyHeadingDecorationSignature(target, themeDecoration) {
 	const existing = target["_sectionStyles"];
-	const existingObj = isPlainObject$1(existing) ? existing : void 0;
+	const existingObj = isPlainObject$2(existing) ? existing : void 0;
 	const rawOverride = existingObj?.["headingDecorationOverride"];
 	const effective = resolveEffectiveHeadingDecoration(themeDecoration, rawOverride === "site-default" || rawOverride === "off" ? rawOverride : void 0);
 	if (effective.kind === "none") {
@@ -131606,7 +132440,7 @@ function parseBorderWidth(widthClass) {
 }
 //#endregion
 //#region ../theme-core/src/accordions/generateAccordionCss.ts
-init_types$9();
+init_types$8();
 init_constants$1();
 init_colorStyles();
 init_surfaces();
@@ -131791,7 +132625,7 @@ function generateAccordionCss({ themeId, theme, accordionSystem }) {
 }
 //#endregion
 //#region ../theme-core/src/inputs/generateInputCss.ts
-init_types$8();
+init_types$7();
 init_constants$2();
 init_colorStyles();
 /**
@@ -134715,6 +135549,8 @@ function buildThemeCssVars(theme) {
 	const inputRadius = mapInputRadius(inputSystem.base.corners, theme.corners);
 	return {
 		...generateCssVars(theme.palette),
+		["--tb-secondaryForeground"]: "var(--tb-onSecondary)",
+		["--tb-accentForeground"]: "var(--tb-onAccent)",
 		["--tb-scrim"]: "0 0 0",
 		["--tb-shadow"]: "0 0 0",
 		...generateShadowCssVars(theme),
@@ -143368,6 +144204,11 @@ const containerResponsiveThemeCss = `/*
   flex-wrap: wrap;
 }
 
+/* Text-style CTA actions belong to the section foreground contract. */
+:where(.theme-scope) [data-block="cta-full"] .cta-row .button-link {
+  color: var(--rb-surface-link-color, var(--rb-surface-text-color, rgb(var(--tb-primary))));
+}
+
 /* =============================================================================
  * Block: Body Text (content block, Phase 2)
  *
@@ -148992,6 +149833,8 @@ init_types$16();
 * always emitting the structural CSS contract system blocks rely on.
 */
 init_colorConversion();
+init_textColor();
+init_onColor();
 init_core$1();
 init_core();
 z$1.object({
@@ -149954,35 +150797,35 @@ init_expandPalette();
 //#region ../blocks/src/system/runtime/bindings.ts
 init_node();
 const shouldLogWarnings = isNonProductionEnv();
-function isPlainObject(value) {
+function isPlainObject$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isRouteMapEntry(value) {
 	if (typeof value === "string") return true;
-	return isPlainObject(value);
+	return isPlainObject$1(value);
 }
 function isRouteMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	return Object.values(value).every(isRouteMapEntry);
 }
 function isPageIdentifierMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	return Object.values(value).every((v) => typeof v === "string");
 }
 function isEntryIdentifierMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	for (const v of Object.values(value)) {
-		if (!isPlainObject(v)) return false;
+		if (!isPlainObject$1(v)) return false;
 		if (!Object.values(v).every((inner) => typeof inner === "string")) return false;
 	}
 	return true;
 }
 function buildTransformContext(vm) {
 	const root = vm.$root;
-	const stage = root && isPlainObject(root) && root.previewStage === "preview" ? "preview" : "published";
-	const routes = root && isPlainObject(root) && isRouteMap(root.routes) ? root.routes : void 0;
-	const pagesByIdentifier = root && isPlainObject(root) && isPageIdentifierMap(root.pagesByIdentifier) ? root.pagesByIdentifier : void 0;
-	const entriesByIdentifier = root && isPlainObject(root) && isEntryIdentifierMap(root.entriesByIdentifier) ? root.entriesByIdentifier : void 0;
+	const stage = root && isPlainObject$1(root) && root.previewStage === "preview" ? "preview" : "published";
+	const routes = root && isPlainObject$1(root) && isRouteMap(root.routes) ? root.routes : void 0;
+	const pagesByIdentifier = root && isPlainObject$1(root) && isPageIdentifierMap(root.pagesByIdentifier) ? root.pagesByIdentifier : void 0;
+	const entriesByIdentifier = root && isPlainObject$1(root) && isEntryIdentifierMap(root.entriesByIdentifier) ? root.entriesByIdentifier : void 0;
 	return {
 		theme: defaultThemeTokens,
 		stage,
@@ -150353,6 +151196,7 @@ const RichText$1 = RichText$2;
 * behavior of the default declarative block system.
 */
 init_clsx();
+init_gradients();
 init_background$1();
 init_media();
 //#endregion
@@ -150382,6 +151226,7 @@ Array.from(new Set(systemCustomizeFacetDefinitions.flatMap((definition) => defin
 //#region ../blocks/src/system/customize/backgrounds.ts
 init_src$3();
 init_site_styles();
+init_gradients();
 const backgroundColorTokenNames = backgroundAppearanceColorTokenNames;
 const backgroundColorTokenNameSet = new Set(backgroundColorTokenNames);
 const backgroundColorTokens = toBackgroundColorTokens(backgroundColorTokenNames);
@@ -150402,18 +151247,17 @@ function parseBackgroundColorToken(value) {
 	if (!token) return null;
 	return token ? token : null;
 }
-const gradientPresetIds = GRADIENT_PRESETS.map((preset) => preset.id);
-new Set(gradientPresetIds);
 //#endregion
 //#region ../blocks/src/index.ts
 init_palette$1();
 init_generateShades();
-init_utils$5();
+init_utils$6();
 init_schema$1();
 init_site_styles();
 init_buttons();
 init_cards();
 init_tokens();
+init_gradients();
 init_richTextSchema();
 init_media();
 init_media$2();
@@ -150974,6 +151818,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -150986,7 +151831,12 @@ const CANONICAL_ADMIN_REFUND_FAILURE_CODES = [
 	"payment_intent_not_found",
 	"stripe_error",
 	"stale_pending_missing_context",
-	"non_refundable_deposit_remaining"
+	"non_refundable_deposit_remaining",
+	"deposit_refund_override_required",
+	"refund_revoke_requires_full_line_refund",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 [...CANONICAL_REFUND_PLANNER_ERROR_CODES];
 //#endregion
@@ -150999,7 +151849,10 @@ const STANDARD_LINE_ITEM_REFUND_INVALID_CODES = [
 	"missing_credit_customer",
 	"deposit_refund_override_required",
 	"refund_revoke_requires_full_line_refund",
-	"unified_order_link_required"
+	"unified_order_link_required",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 const EVENT_ATTENDEE_REFUND_INVALID_CODES = ["manual_booking_not_refundable", ...STANDARD_LINE_ITEM_REFUND_INVALID_CODES];
 [...CANONICAL_ADMIN_REFUND_FAILURE_CODES];
@@ -153807,6 +154660,225 @@ function isDisplayMediaKind(value) {
 function isFileFieldKind(value) {
 	return FILE_FIELD_KINDS.includes(value);
 }
+/** Matches the closed sentinel shape `"<REQUIRED: …>"`. */
+const SENTINEL_PATTERN = /^<REQUIRED:.*>$/;
+/**
+* True when a value is an unfilled placeholder sentinel. Shared by the emitter
+* (self-check) and the validator (rejection) so recognition can't drift.
+*/
+function isPlaceholderSentinel(value) {
+	return typeof value === "string" && SENTINEL_PATTERN.test(value);
+}
+function effectiveReferenceKind(field) {
+	const kind = field.referenceKind;
+	const legacy = field.reference?.type;
+	return kind ?? legacy;
+}
+function selectOptionValues$1(field) {
+	const options = field.options;
+	return options ? options.map((o) => o.value) : [];
+}
+/**
+* The placeholder sentinel for a leaf field. Container types (group/button/
+* repeater) do not have a leaf sentinel — they expand structurally — and calling
+* this for them returns a generic marker only for completeness.
+*/
+function buildSentinel(field) {
+	switch (field.type) {
+		case "text":
+		case "textarea": return "<REQUIRED: text>";
+		case "richText": return "<REQUIRED: rich-text>";
+		case "number": return "<REQUIRED: number>";
+		case "date": return "<REQUIRED: date (YYYY-MM-DD)>";
+		case "datetime": return "<REQUIRED: datetime (ISO 8601)>";
+		case "url": return "<REQUIRED: url>";
+		case "link": return "<REQUIRED: link>";
+		case "media": return "<REQUIRED: media-identifier>";
+		case "file": return "<REQUIRED: file-identifier>";
+		case "boolean": return "<REQUIRED: boolean>";
+		case "select": {
+			const values = selectOptionValues$1(field);
+			return values.length > 0 ? `<REQUIRED: select (${values.join("|")})>` : "<REQUIRED: select>";
+		}
+		case "reference": {
+			const kind = effectiveReferenceKind(field);
+			return kind ? `<REQUIRED: reference-identifier (${kind})>` : "<REQUIRED: reference-identifier>";
+		}
+		case "group": return "<REQUIRED: group>";
+		case "button": return "<REQUIRED: button>";
+		case "repeater": return "<REQUIRED: repeater>";
+	}
+}
+//#endregion
+//#region ../content-model/src/content-types/entryValidation.ts
+function subfieldsOf$1(field) {
+	const direct = field.fields;
+	if (direct && direct.length > 0) return direct;
+	return field.schema?.fields ?? [];
+}
+function selectOptionValues(field) {
+	const options = field.options;
+	return options ? options.map((o) => o.value) : [];
+}
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Field types whose value must be a string. */
+const STRING_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"textarea",
+	"url",
+	"link",
+	"media",
+	"file",
+	"reference",
+	"date",
+	"datetime",
+	"select"
+]);
+function checkLeafType(field, value, path, errors) {
+	const push = (code, message) => {
+		errors.push({
+			path,
+			fieldType: field.type,
+			code,
+			message
+		});
+	};
+	if (field.type === "number") {
+		if (typeof value !== "number" || Number.isNaN(value)) push("wrong_type", `"${path}" must be a number.`);
+		return;
+	}
+	if (field.type === "boolean") {
+		if (typeof value !== "boolean") push("wrong_type", `"${path}" must be a boolean.`);
+		return;
+	}
+	if (field.type === "richText") {
+		if (typeof value !== "string" && !isPlainObject(value)) push("wrong_type", `"${path}" must be rich-text (string or document object).`);
+		return;
+	}
+	if (field.type === "select") {
+		if (typeof value !== "string") {
+			push("wrong_type", `"${path}" must be a string.`);
+			return;
+		}
+		const options = selectOptionValues(field);
+		if (options.length > 0 && !options.includes(value)) push("invalid_option", `"${path}" must be one of: ${options.join(", ")}.`);
+		return;
+	}
+	if (STRING_TYPES.has(field.type)) {
+		if (typeof value !== "string") push("wrong_type", `"${path}" must be a string.`);
+	}
+}
+function validateField(field, value, path, errors) {
+	if (value === void 0 || value === null || value === "") {
+		if (field.required === true) errors.push({
+			path,
+			fieldType: field.type,
+			code: "missing_required",
+			message: `Required field "${path}" is missing.`
+		});
+		return;
+	}
+	if (isPlaceholderSentinel(value)) {
+		errors.push({
+			path,
+			fieldType: field.type,
+			code: "unfilled_placeholder",
+			message: `"${path}" still contains an unfilled placeholder (${value}).`
+		});
+		return;
+	}
+	if (field.type === "group" || field.type === "button") {
+		if (!isPlainObject(value)) {
+			errors.push({
+				path,
+				fieldType: field.type,
+				code: "wrong_type",
+				message: `"${path}" must be an object.`
+			});
+			return;
+		}
+		validateFields(subfieldsOf$1(field), value, path, errors);
+		return;
+	}
+	if (field.type === "repeater") {
+		if (!Array.isArray(value)) {
+			errors.push({
+				path,
+				fieldType: field.type,
+				code: "wrong_type",
+				message: `"${path}" must be an array.`
+			});
+			return;
+		}
+		const itemFields = subfieldsOf$1(field);
+		value.forEach((item, index) => {
+			const itemPath = `${path}[${index}]`;
+			if (!isPlainObject(item)) {
+				errors.push({
+					path: itemPath,
+					fieldType: "repeater",
+					code: "wrong_type",
+					message: `"${itemPath}" must be an object.`
+				});
+				return;
+			}
+			validateFields(itemFields, item, itemPath, errors);
+		});
+		return;
+	}
+	checkLeafType(field, value, path, errors);
+}
+function validateFields(fields, data, pathPrefix, errors) {
+	for (const field of fields) {
+		const path = pathPrefix ? `${pathPrefix}.${field.id}` : field.id;
+		validateField(field, data[field.id], path, errors);
+	}
+}
+//#endregion
+//#region ../content-model/src/content-types/scaffold.ts
+/** Nested subfields for group/repeater/button-style fields (both DSL shapes). */
+function subfieldsOf(field) {
+	const direct = field.fields;
+	if (direct && direct.length > 0) return direct;
+	return field.schema?.fields ?? [];
+}
+const CONTAINER_TYPES = /* @__PURE__ */ new Set([
+	"group",
+	"button",
+	"repeater"
+]);
+/**
+* Build the placeholder value for a required field. Group/button fields recurse
+* into their required subfields; repeaters emit a single seed item so agents see
+* the item shape.
+*/
+function buildFieldValue(field) {
+	if (field.type === "repeater") return [buildObjectFromFields(subfieldsOf(field))];
+	if (CONTAINER_TYPES.has(field.type)) {
+		const subfields = subfieldsOf(field);
+		if (subfields.length > 0) return buildObjectFromFields(subfields);
+		if (field.type === "button") return {
+			label: "<REQUIRED: text>",
+			link: "<REQUIRED: link>"
+		};
+		return {};
+	}
+	return buildSentinel(field);
+}
+/**
+* Build a template object from a list of fields, stubbing required fields and
+* omitting optional ones.
+*/
+function buildObjectFromFields(fields) {
+	const template = {};
+	for (const field of fields) {
+		if (field.required !== true) continue;
+		template[field.id] = buildFieldValue(field);
+	}
+	return template;
+}
 //#endregion
 //#region ../content-model/src/content-types/builtins.ts
 /**