@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/server/rendering/server.mjs

@@ -272,19 +272,29 @@ function isRecord$16(value) {
 //#region ../core/src/booking-date-time.ts
 const DEFAULT_LOCALE = "en-US";
 const FALLBACK_TIMEZONE = "UTC";
+const DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+const dateTimeFormatterCache = /* @__PURE__ */ new Map();
+const timeZoneValidityCache = /* @__PURE__ */ new Map();
 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;
@@ -297,10 +307,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, {
@@ -346,23 +365,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,
@@ -371,6 +376,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);
@@ -409,10 +429,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",
@@ -551,7 +568,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(value);
 }
 function brandRelativeStoragePath(value) {
@@ -1642,6 +1660,20 @@ const blockCategoryEnum = z$1.enum([
 	"layout",
 	"interactive"
 ]);
+const blockContentSourceSchema = z$1.object({
+	kind: z$1.enum([
+		"inline",
+		"entries",
+		"mixed"
+	]),
+	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),
@@ -1672,6 +1704,12 @@ z$1.object({
 	}).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()
 });
@@ -3211,7 +3249,7 @@ function normalizeStoredObjectChildren(children, value, ctx) {
 	return normalized;
 }
 function normalizeStoredRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$1(value)) return value;
+	if (!isUnknownArray$2(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -3266,7 +3304,7 @@ function getAtFieldPath(source, path) {
 	}, source);
 }
 function normalizeRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$1(value)) return value;
+	if (!isUnknownArray$2(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -3641,7 +3679,7 @@ function isEmptyValue(value) {
 function isPlainObject$4(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isUnknownArray$1(value) {
+function isUnknownArray$2(value) {
 	return Array.isArray(value);
 }
 function isValidRichTextDoc(value) {
@@ -3863,6 +3901,14 @@ function relativeLuminance(r, g, b) {
 	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
 	return .2126 * R + .7152 * G + .0722 * B;
 }
+function contrastRatio(hex1, hex2) {
+	const { r: r1, g: g1, b: b1 } = hexToRgb(hex1);
+	const { r: r2, g: g2, b: b2 } = hexToRgb(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);
+}
 //#endregion
 //#region ../theme-core/src/palette/utils/onColor.ts
 const BACKGROUND_ROLE_NAMES = /* @__PURE__ */ new Set([
@@ -4854,6 +4900,10 @@ const modernMinimalTheme = {
 				name: "primary",
 				hex: "#1f2937"
 			},
+			{
+				name: "primaryForeground",
+				hex: "#ffffff"
+			},
 			{
 				name: "secondary",
 				hex: "#6b7280"
@@ -4882,6 +4932,14 @@ const modernMinimalTheme = {
 				name: "surface",
 				hex: "#ffffff"
 			},
+			{
+				name: "surfaceAlt",
+				hex: "#f9fafb"
+			},
+			{
+				name: "muted",
+				hex: "#f3f4f6"
+			},
 			{
 				name: "text",
 				hex: "#1f2937"
@@ -8295,6 +8353,111 @@ function boundaryKey$1(previousBlockId, nextBlockId) {
 	return makeBoundaryId(previousBlockId, nextBlockId);
 }
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+/**
+* Exhaustive live policy for every registered effect id.
+*
+* The resolver consumes the transition payload directly, so adding an effect
+* cannot update classification without also defining its runtime behavior.
+*/
+const 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" }
+};
+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";
+}
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 /**
 * Standard semantic variant roles a theme exposes.
@@ -8324,6 +8487,20 @@ function asSpecialVariantId(value) {
 * Shared between generator and renderer so neither side hard-codes the string.
 */
 const DEFAULT_VARIANT_ALIAS_ID = "default";
+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;
+}
+const 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;
+});
 const cornerStyleSchema = z$1.enum([
 	"square",
 	"rounded",
@@ -8425,7 +8602,7 @@ const buttonSizesSchema = z$1.object({
 	lg,
 	xl: xl ?? lg
 }));
-const buttonGlobalSettingsSchema = z$1.object({
+const canonicalButtonGlobalSettingsSchema = z$1.object({
 	cornerStyle: cornerStyleSchema,
 	cornerRadius: z$1.number().min(0).max(24).optional(),
 	/**
@@ -8456,11 +8633,12 @@ const buttonGlobalSettingsSchema = z$1.object({
 	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()
 });
+const buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 const gradientDirectionSchema$1 = z$1.enum([
 	"to-r",
 	"to-l",
@@ -8474,27 +8652,33 @@ const gradientDirectionSchema$1 = z$1.enum([
 const buttonBackgroundSchema = 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")
+	})
 ]);
 const effectApplicationSchema$1 = z$1.object({
 	effectId: z$1.string(),
-	options: z$1.record(z$1.string(), z$1.any()).optional()
-});
-const buttonBorderSchema = z$1.object({
-	widthClass: z$1.string(),
-	colorToken: themeColorTokenSchema
-});
-const buttonVariantAffordanceSchema = z$1.object({
-	iconId: z$1.string().min(1),
-	colorToken: themeColorTokenSchema.optional()
+	options: z$1.record(z$1.string(), z$1.json()).optional()
 });
+const buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+const buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 const variantShadowSchema = z$1.object({
 	elevation: z$1.enum([
 		"none",
@@ -8535,27 +8719,170 @@ const variantSizeOverridesSchema = z$1.object({
 * default (e.g. link-style variants declaring zero horizontal padding at
 * every size).
 */
-const buttonVariantSchema = z$1.object({
+const 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()
 });
+/**
+* Temporary persisted-theme admission boundary for issue #1206.
+*
+* Production inventory on 2026-07-22 found 22 rows using the old independent
+* `textColorToken`/border colour shape. New source and all downstream code use
+* only the canonical relationship. Delete this preprocessor after the reviewed
+* production rewrite reports zero legacy rows.
+*/
+const buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 const buttonSystemSchema = z$1.object({
 	global: buttonGlobalSettingsSchema,
 	variants: z$1.array(buttonVariantSchema).min(1).max(6),
 	sizes: buttonSizesSchema.optional()
 });
+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$1(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$1(value) {
+	return Array.isArray(value);
+}
 //#endregion
 //#region ../theme-core/src/buttons/personalities/types.ts
 function asButtonPersonalityId(value) {
@@ -8581,7 +8908,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 //#endregion
@@ -8634,19 +8961,15 @@ const brushedWash = defineButtonPersonality({
 				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",
@@ -8656,32 +8979,27 @@ const brushedWash = defineButtonPersonality({
 				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" }
@@ -8692,8 +9010,10 @@ const brushedWash = defineButtonPersonality({
 				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",
@@ -8739,7 +9059,6 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				shadow: {
 					elevation: "medium",
@@ -8749,7 +9068,7 @@ const confidentChip = defineButtonPersonality({
 				effects: {
 					hover: [{
 						effectId: "darken-background",
-						options: { amount: 60 }
+						options: { amount: 100 }
 					}],
 					active: [{
 						effectId: "scale-down",
@@ -8766,12 +9085,8 @@ const confidentChip = defineButtonPersonality({
 					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" }
@@ -8782,13 +9097,12 @@ const confidentChip = defineButtonPersonality({
 				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" }
@@ -8799,8 +9113,10 @@ const confidentChip = defineButtonPersonality({
 				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",
@@ -8863,7 +9179,6 @@ const earthPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -8889,13 +9204,12 @@ const earthPill = defineButtonPersonality({
 				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" }
@@ -8906,13 +9220,12 @@ const earthPill = defineButtonPersonality({
 				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" }
@@ -8923,8 +9236,10 @@ const earthPill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "none",
@@ -8945,11 +9260,7 @@ const earthPill = defineButtonPersonality({
 						padding: "0.625rem 0",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 25 }
-				}] }
+				}
 			}
 		]
 	}
@@ -8985,8 +9296,10 @@ const editorialLink = defineButtonPersonality({
 				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" },
@@ -9008,8 +9321,10 @@ const editorialLink = defineButtonPersonality({
 				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" },
@@ -9031,8 +9346,10 @@ const editorialLink = defineButtonPersonality({
 				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" },
@@ -9054,19 +9371,17 @@ const editorialLink = defineButtonPersonality({
 				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 }
-				}] }
+				}
 			}
 		]
 	}
@@ -9128,12 +9443,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accent"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -9147,13 +9458,12 @@ const flatInk = defineButtonPersonality({
 				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" }
@@ -9171,12 +9481,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "accent"
 				},
-				textColorToken: "accentForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accentForeground"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -9239,7 +9545,6 @@ const inkStamp = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				effects: {
 					hover: [{
@@ -9260,13 +9565,12 @@ const inkStamp = defineButtonPersonality({
 				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" }
@@ -9277,13 +9581,12 @@ const inkStamp = defineButtonPersonality({
 				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" }
@@ -9294,8 +9597,10 @@ const inkStamp = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -9388,7 +9693,6 @@ const joyStamp = defineButtonPersonality({
 				type: "solid",
 				colorToken: "primary"
 			},
-			textColorToken: "primaryForeground",
 			borderRadius: "rounded-full",
 			shadow: {
 				elevation: "high",
@@ -9402,13 +9706,12 @@ const joyStamp = defineButtonPersonality({
 			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",
@@ -9473,12 +9776,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: {
 					hover: [{
 						effectId: "background-on-hover",
@@ -9499,12 +9798,8 @@ const ornateRitual = defineButtonPersonality({
 					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" }
@@ -9515,13 +9810,12 @@ const ornateRitual = defineButtonPersonality({
 				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" }
@@ -9532,8 +9826,10 @@ const ornateRitual = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -9615,14 +9911,10 @@ const pebble = defineButtonPersonality({
 					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 }
 				}] }
 			},
 			{
@@ -9630,13 +9922,12 @@ const pebble = defineButtonPersonality({
 				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" }
@@ -9647,13 +9938,12 @@ const pebble = defineButtonPersonality({
 				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" }
@@ -9664,8 +9954,10 @@ const pebble = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				sizes: {
 					sm: {
@@ -9681,11 +9973,7 @@ const pebble = defineButtonPersonality({
 						padding: "0.75rem 1.5rem",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 30 }
-				}] }
+				}
 			}
 		]
 	}
@@ -9747,15 +10035,11 @@ const quietArrow = defineButtonPersonality({
 					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 }
 				}] }
 			},
 			{
@@ -9763,13 +10047,12 @@ const quietArrow = defineButtonPersonality({
 				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",
@@ -9781,21 +10064,22 @@ const quietArrow = defineButtonPersonality({
 				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"
 			}
 		]
@@ -9859,7 +10143,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "background",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -9868,13 +10151,12 @@ const showtimePill = defineButtonPersonality({
 				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" }] }
 			},
 			{
@@ -9886,7 +10168,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -9899,12 +10180,8 @@ const showtimePill = defineButtonPersonality({
 					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" }
@@ -9915,13 +10192,12 @@ const showtimePill = defineButtonPersonality({
 				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" }
@@ -9932,8 +10208,10 @@ const showtimePill = defineButtonPersonality({
 				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",
@@ -9979,7 +10257,6 @@ const softPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -10002,13 +10279,12 @@ const softPill = defineButtonPersonality({
 				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" }
@@ -10019,13 +10295,12 @@ const softPill = defineButtonPersonality({
 				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" }
@@ -10036,8 +10311,10 @@ const softPill = defineButtonPersonality({
 				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",
@@ -10056,9 +10333,8 @@ const solidSecondary = {
 	priority: 2,
 	background: {
 		type: "solid",
-		colorToken: "secondary"
+		colorToken: unsafeAsOpaqueButtonColourToken("secondary")
 	},
-	textColorToken: "onSecondary",
 	borderRadius: "rounded-full",
 	shadow: {
 		elevation: "none",
@@ -10491,6 +10767,282 @@ const serifDisplayQuote = { style: "serif-display" };
 /** Punchy quotation mark in the secondary accent colour. Bold / accent styles. */
 const accentGlyphQuote = { style: "accent-glyph" };
 //#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+/**
+* Gradient color stop
+*/
+const gradientStopSchema = z$1.object({
+	color: themeColorTokenSchema,
+	position: z$1.number().min(0).max(100)
+});
+/**
+* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
+* so existing radial gradients are byte-identical.
+*
+* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
+* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
+*/
+const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+/**
+* Gradient configuration.
+*
+* `type` is optional and defaults to `'linear'` so gradients persisted without a
+* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
+* `'conic'` are additive kinds:
+*   - linear: `angle` (degrees)
+*   - radial: optional `shape` (circle/ellipse) + `position`
+*   - conic:  optional `angle` (from-angle, degrees) + `position`
+*/
+const 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)
+});
+/**
+* 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-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
+			}
+		]
+	}
+].map((preset) => ({
+	...preset,
+	id: preset.id,
+	stops: preset.stops
+}));
+const GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+const gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+const gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+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];
+}
+//#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/site-styles/logoBranding.ts
 const logoTextConfidenceValues = [
 	"low",
@@ -12816,14 +13368,12 @@ const backgroundOnHoverEffect = {
 		]
 	},
 	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)};` : ""}
       }
     `;
 	}
@@ -12847,10 +13397,10 @@ const backgroundOnHoverAlphaEffect = {
 		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}`} {
@@ -13063,7 +13613,7 @@ const outerGlowEffect = {
 		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 `
@@ -14053,31 +14603,6 @@ function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elem
 	return effectPreset.generateCSS(ctx);
 }
 //#endregion
-//#region ../theme-core/src/buttons/utils/contrast.ts
-/**
-* 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";
-}
-//#endregion
 //#region ../theme-core/src/buttons/generateDefaultButtonSystem.ts
 /**
 * Map border width to border width class
@@ -14134,13 +14659,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",
@@ -14149,51 +14669,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 {
@@ -14249,6 +14757,472 @@ function affordanceIconMaskUrl(iconId) {
 	return `data:image/svg+xml,${`<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'>${paths.map((d) => `<path d='${d}'/>`).join("")}</svg>`.replace(/"/g, "'").replace(/#/g, "%23").replace(/</g, "%3C").replace(/>/g, "%3E").replace(/\s+/g, " ")}`;
 }
 //#endregion
+//#region ../theme-core/src/surfaces/foregroundRoles.ts
+const SURFACE_FOREGROUND_ROLES = [
+	"text",
+	"heading",
+	"link",
+	"supporting"
+];
+//#endregion
+//#region ../theme-core/src/surfaces/foregroundContract.ts
+const SURFACE_FOREGROUND_CSS_VARS = {
+	text: "--rb-surface-text-color",
+	heading: "--rb-surface-heading-color",
+	link: "--rb-surface-link-color",
+	supporting: "--rb-surface-supporting-color"
+};
+const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+const DEFAULT_ROLE_FALLBACKS = {
+	text: DEFAULT_SURFACE_TEXT_COLOR,
+	heading: DEFAULT_SURFACE_TEXT_COLOR,
+	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
+	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
+};
+function requireSurfaceColorValue(role, value) {
+	const normalized = value.trim();
+	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
+	return normalized;
+}
+function completeSurfaceForegrounds(input) {
+	const text = requireSurfaceColorValue("text", input.text);
+	return {
+		text,
+		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
+		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
+	};
+}
+function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
+	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
+	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
+	if (role === "text") return `var(${roleVariable}, ${fallback})`;
+	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
+}
+function surfaceForegroundValueWithOpacity(role, opacityPercent) {
+	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
+	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
+}
+function surfaceForegroundStyle(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return {
+		color: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
+		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
+		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
+	};
+}
+function surfaceForegroundDeclarations(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+const BUTTON_VISUAL_STATES = [
+	"base",
+	"hover",
+	"focus",
+	"active",
+	"disabled"
+];
+const BUTTON_CONTRAST_POLICY = {
+	textMinimumRatio: 4.5,
+	nonTextMinimumRatio: 3,
+	gradientSamplesPerSegment: 20,
+	alphaBackgrounds: "reject-without-known-surface",
+	disabled: "retain-full-colour-contract"
+};
+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(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(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$1[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(startHex);
+	const end = hexToRgb(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)}`;
+}
+//#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"]];
+}
+/**
+* Disabled buttons retain their validated colour pair and add a non-layout
+* visual affordance. `currentColor` keeps the cue inside the same contrast
+* relationship, while retaining pointer events lets the not-allowed cursor
+* remain observable.
+*/
+const 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
 /**
 * Class the `button` runtime node adds when it renders its own trailing icon,
@@ -14315,6 +15289,7 @@ const STRUCTURAL_DECLARATIONS = [
 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,
@@ -14323,34 +15298,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")) 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));
@@ -14365,12 +15415,11 @@ 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`, [
 		["content", "\"\""],
@@ -14379,7 +15428,7 @@ function variantAffordanceRule(variant, selector, tokens) {
 		["height", "1em"],
 		["margin-inline-start", "0.5em"],
 		["flex", "0 0 auto"],
-		["background-color", color],
+		["background-color", "currentColor"],
 		["-webkit-mask", mask],
 		["mask", mask]
 	]);
@@ -14389,7 +15438,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)]);
@@ -14401,18 +15450,10 @@ 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$1[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[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);
 }
@@ -14423,30 +15464,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(`: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(`: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
@@ -14461,18 +15494,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(disabledSelectors, [...RESOLVED_BUTTON_DISABLED_DECLARATIONS]), rule(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[variant.border.widthClass] || "1px" : "0px";
 	const rules = [];
@@ -14540,6 +15570,27 @@ function resolveBoxShadow(variant, global, theme, tokens) {
 	const color = shadowConfig.colorToken ? tokens.getColor(shadowConfig.colorToken) : void 0;
 	return generateShadowValue$1(shadowConfig.elevation, shadowConfig.softness, shadowConfig.position ?? "bottom", color);
 }
+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] } : {}
+	}
+}));
+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";
+	}
+}
 //#endregion
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
@@ -14776,67 +15827,6 @@ function generateDefaultCardSystem(theme) {
 	return { variants: [defaultVariant, alternativeVariant] };
 }
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-const SURFACE_FOREGROUND_ROLES = [
-	"text",
-	"heading",
-	"link",
-	"supporting"
-];
-//#endregion
-//#region ../theme-core/src/surfaces/foregroundContract.ts
-const SURFACE_FOREGROUND_CSS_VARS = {
-	text: "--rb-surface-text-color",
-	heading: "--rb-surface-heading-color",
-	link: "--rb-surface-link-color",
-	supporting: "--rb-surface-supporting-color"
-};
-const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
-const DEFAULT_ROLE_FALLBACKS = {
-	text: DEFAULT_SURFACE_TEXT_COLOR,
-	heading: DEFAULT_SURFACE_TEXT_COLOR,
-	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
-	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
-};
-function requireSurfaceColorValue(role, value) {
-	const normalized = value.trim();
-	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
-	return normalized;
-}
-function completeSurfaceForegrounds(input) {
-	const text = requireSurfaceColorValue("text", input.text);
-	return {
-		text,
-		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
-		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
-	};
-}
-function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
-	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
-	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
-	if (role === "text") return `var(${roleVariable}, ${fallback})`;
-	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
-}
-function surfaceForegroundValueWithOpacity(role, opacityPercent) {
-	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
-	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
-}
-function surfaceForegroundStyle(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return {
-		color: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
-		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
-		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
-	};
-}
-function surfaceForegroundDeclarations(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
-}
-//#endregion
 //#region ../theme-core/src/cards/generateCardCss.ts
 const PER_CORNER_RADIUS_MAP = {
 	square: "0",
@@ -15273,47 +16263,6 @@ const FONT_WEIGHT_MAP = {
 	black: "800"
 };
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-/**
-* Gradient color stop
-*/
-const gradientStopSchema = z$1.object({
-	color: themeColorTokenSchema,
-	position: z$1.number().min(0).max(100)
-});
-/**
-* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
-* so existing radial gradients are byte-identical.
-*
-* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
-* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
-*/
-const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-/**
-* Gradient configuration.
-*
-* `type` is optional and defaults to `'linear'` so gradients persisted without a
-* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
-* `'conic'` are additive kinds:
-*   - linear: `angle` (degrees)
-*   - radial: optional `shape` (circle/ellipse) + `position`
-*   - conic:  optional `angle` (from-angle, degrees) + `position`
-*/
-const 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
@@ -17066,6 +18015,19 @@ z$1.object({
 }).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;
 }
@@ -17336,24 +18298,24 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				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: {
@@ -17361,12 +18323,32 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				opacity: 1,
 				position: "center center"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
+		}
+	}
+});
+const primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+const fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+	...defaultDesignRuntimeRules,
+	sectionSurfaces: {
+		...defaultDesignRuntimeRules.sectionSurfaces,
+		"accent-band": {
+			background: {
+				type: "gradient",
+				gradientPresetId: primaryGlowGradientPresetId
+			},
+			foreground: defineSectionForegroundRuntimeTokens({
+				textColor: "primaryForeground",
+				headingColor: "primaryForeground",
+				linkColor: "primaryForeground",
+				supportingColor: "primaryForeground"
+			})
 		}
 	}
 });
@@ -18754,6 +19736,8 @@ const curatedSiteStyles = [
 		},
 		compositionBudget: quietBudget,
 		typography: fulcrumTypography,
+		designRuntimeRules: fulcrumDesignRuntimeRules,
+		recommendedAppearancePresetIds: ["cta-accent-band"],
 		themeOverrides: {
 			shadow: { colorToken: "primary" },
 			accordions: {
@@ -22139,9 +23123,15 @@ function createButtonGroup(options = {}) {
 //#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,
@@ -22150,11 +23140,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] }
 	};
 }
 //#endregion
@@ -22204,6 +23191,7 @@ const heroCtaRowFragment = defineFragment({
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -22271,7 +23259,7 @@ const ctaCopyFragment = defineFragment({
 		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
 //#region ../blocks/src/system/fragments/library/testimonialsHeading.ts
@@ -24295,6 +25283,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,
@@ -24440,6 +25429,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -24713,6 +25703,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -24898,6 +25889,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -24954,6 +25946,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",
@@ -25251,6 +26247,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",
@@ -25293,6 +26293,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -25326,6 +26327,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -25608,6 +26610,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -25670,6 +26673,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 },
@@ -25873,6 +26877,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -27609,6 +28614,7 @@ const siteHeaderManifest = createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -27814,6 +28820,7 @@ const siteFooterManifest = createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	layout: section({
 		background: "background",
@@ -27964,6 +28971,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -28122,6 +29130,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -28355,6 +29364,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -28632,6 +29642,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -29015,6 +30026,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -29415,6 +30427,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -29579,6 +30592,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -31277,6 +32291,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -31383,15 +32398,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"
@@ -31404,9 +32413,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -31781,6 +32789,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -31894,15 +32903,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"
@@ -31915,9 +32918,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -31997,6 +32999,7 @@ const eventDetailsManifest = createBlockManifest({
 	titleSource: "heading",
 	description: "Date/time, venue, map, and other dates for an event",
 	category: "content",
+	contentSource: { kind: "entries" },
 	tags: [
 		"events",
 		"venue",
@@ -32202,6 +33205,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -32493,6 +33497,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -35306,6 +36311,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -36511,6 +37517,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -36908,6 +37915,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",
@@ -37538,7 +38546,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -37591,6 +38602,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -37759,6 +38771,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -38246,6 +39259,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -38898,6 +39912,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -39068,6 +40083,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",
@@ -39179,6 +40195,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",
@@ -40198,6 +41215,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -40397,6 +41415,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -40538,6 +41557,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -40654,6 +41674,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -40736,6 +41757,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -40950,6 +41972,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -41304,6 +42327,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -41485,6 +42509,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -41925,6 +42950,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",
@@ -42931,213 +43957,6 @@ function getBlockDefinition(name) {
 	return blockStore.get(name);
 }
 //#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 ../blocks/src/system/helpers/backgroundMedia.ts
 function resolveBackgroundMedia(input) {
 	const parsedMedia = mediaSchema.safeParse(input.image);
@@ -43175,9 +43994,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString(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 = [
@@ -54153,6 +54972,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),
@@ -62833,6 +63654,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)
  *
@@ -70072,6 +70898,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -70084,7 +70911,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
@@ -70097,7 +70929,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];