@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/client/client.mjs

@@ -6314,6 +6314,41 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
+	sdkCatalogTheme: {
+		path: "/sdk/{siteId}/catalog/theme",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCatalogBlocks: {
+		path: "/sdk/{siteId}/catalog/blocks",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCatalogContentTypes: {
+		path: "/sdk/{siteId}/catalog/content-types",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCapabilities: {
+		path: "/sdk/{siteId}/capabilities",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkListDemoContent: {
+		path: "/sdk/{siteId}/demo-content",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
 	sdkPullPages: {
 		path: "/sdk/{siteId}/pull/pages",
 		method: "GET",
@@ -7572,18 +7607,25 @@ var init_booking_instalments = __esmMin((() => {}));
 //#endregion
 //#region ../core/src/booking-date-time.ts
 function isValidTimeZone$1(timeZone) {
+	const cached = timeZoneValidityCache.get(timeZone);
+	if (cached !== void 0) return cached;
+	let isValid;
 	try {
 		new Intl.DateTimeFormat(DEFAULT_LOCALE, { timeZone }).format(/* @__PURE__ */ new Date());
-		return true;
+		isValid = true;
 	} catch {
-		return false;
+		isValid = false;
 	}
+	if (timeZoneValidityCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) timeZoneValidityCache.clear();
+	timeZoneValidityCache.set(timeZone, isValid);
+	return isValid;
 }
 function getSafeTimeZone(timeZone) {
 	const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
 	return normalized.length > 0 && isValidTimeZone$1(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone$1(normalized)) return null;
 	return normalized;
@@ -7596,10 +7638,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, {
@@ -7652,23 +7703,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,
@@ -7677,6 +7714,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);
@@ -7715,10 +7767,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",
@@ -7806,7 +7855,7 @@ function addLocalScheduleDays(date, days) {
 		day: utcDate.getUTCDate()
 	};
 }
-var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN;
+var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN, DATE_TIME_FORMATTER_CACHE_LIMIT, dateTimeFormatterCache, timeZoneValidityCache;
 var init_booking_date_time = __esmMin((() => {
 	init_result();
 	DEFAULT_LOCALE = "en-US";
@@ -7819,6 +7868,9 @@ var init_booking_date_time = __esmMin((() => {
 		minute: "2-digit"
 	};
 	LOCAL_DATE_PATTERN = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/u;
+	DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+	dateTimeFormatterCache = /* @__PURE__ */ new Map();
+	timeZoneValidityCache = /* @__PURE__ */ new Map();
 })), init_dated_offering_settlement = __esmMin((() => {
 	init_result();
 }));
@@ -8393,7 +8445,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$1(value);
 }
 function brandRelativeStoragePath(value) {
@@ -9278,7 +9331,7 @@ var init_repeaterGrid = __esmMin((() => {
 	DEFAULT_REPEATER_GRID_COLUMN_FIELD_ID = "gridColumn";
 }));
 var ICON_PICKER_PRESETS;
-var init_presets$1 = __esmMin((() => {
+var init_presets$2 = __esmMin((() => {
 	ICON_PICKER_PRESETS = ["cta", "feature"];
 }));
 //#endregion
@@ -9365,11 +9418,11 @@ function createSdkSelectField(input) {
 		}
 	}));
 }
-var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens$1, colorTokens$1, spacingTokens$1, radiusTokens$1, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum;
+var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens$1, colorTokens$1, spacingTokens$1, radiusTokens$1, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum, blockContentSourceKinds, blockContentSourceSchema;
 var init_schema$1 = __esmMin((() => {
 	init_node();
 	init_repeaterGrid();
-	init_presets$1();
+	init_presets$2();
 	visibilityLevels = [
 		"admin",
 		"designer",
@@ -9895,6 +9948,21 @@ var init_schema$1 = __esmMin((() => {
 		"layout",
 		"interactive"
 	]);
+	blockContentSourceKinds = [
+		"inline",
+		"entries",
+		"mixed"
+	];
+	blockContentSourceSchema = z$1.object({
+		kind: z$1.enum(blockContentSourceKinds),
+		contentType: z$1.string().min(1).optional()
+	}).superRefine((value, ctx) => {
+		if (value.kind === "inline" && value.contentType) ctx.addIssue({
+			code: z$1.ZodIssueCode.custom,
+			path: ["contentType"],
+			message: "contentType is not allowed when contentSource.kind is \"inline\""
+		});
+	});
 	z$1.object({
 		name: z$1.string().min(1),
 		version: z$1.string().min(1),
@@ -9925,6 +9993,12 @@ var init_schema$1 = __esmMin((() => {
 		}).optional()).optional(),
 		category: blockCategoryEnum.optional(),
 		contentTypes: z$1.array(z$1.string()).optional(),
+		/**
+		* Explicit content-source classification (inline / entries / mixed). Optional at the
+		* schema level for backward compatibility with SDK-defined custom blocks, but every
+		* registered SYSTEM block must declare it (enforced by a registry-wide test).
+		*/
+		contentSource: blockContentSourceSchema.optional(),
 		tags: z$1.array(z$1.string()).optional(),
 		icon: z$1.string().optional()
 	});
@@ -11479,7 +11553,7 @@ function normalizeStoredObjectChildren(children, value, ctx) {
 	return normalized;
 }
 function normalizeStoredRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$3(value)) return value;
+	if (!isUnknownArray$4(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -11538,7 +11612,7 @@ function getAtFieldPath(source, path) {
 	}, source);
 }
 function normalizeRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$3(value)) return value;
+	if (!isUnknownArray$4(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -11886,7 +11960,7 @@ function validateExplicitNullForPushPlan(plan, value, ctx) {
 	}
 }
 function validateExplicitNullsForPushRepeater(plan, value, ctx) {
-	if (!isUnknownArray$3(value)) return [];
+	if (!isUnknownArray$4(value)) return [];
 	return value.flatMap((item, index) => {
 		if (!isPlainObject$4(item)) return [];
 		const childPlans = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === item._type)?.fields : plan.repeatedItemPlan;
@@ -11974,7 +12048,7 @@ function isEmptyValue$1(value) {
 function isPlainObject$4(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isUnknownArray$3(value) {
+function isUnknownArray$4(value) {
 	return Array.isArray(value);
 }
 function isValidRichTextDoc(value) {
@@ -12062,7 +12136,7 @@ init_augmentManifest();
 init_schema$1();
 //#endregion
 //#region ../theme-core/src/palette/utils/colorConversion.ts
-function hexToRgb$2(hex) {
+function hexToRgb$1(hex) {
 	const h = hex.replace(/^#/, "");
 	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
 	if (m.length !== 6) throw new Error("Bad hex");
@@ -12172,7 +12246,7 @@ function oklchToHexGamut(L, C, h) {
 	return rgbToHex$1(r, g, bb);
 }
 function featuresFromHex(hex) {
-	const { r, g, b } = hexToRgb$2(hex);
+	const { r, g, b } = hexToRgb$1(hex);
 	const { h, s, l } = rgbToHsl$1(r, g, b);
 	const { L, a, b: b2 } = srgbToOklab(r, g, b);
 	const { L: okL, C: okC, h: okH } = oklabToOklch(L, a, b2);
@@ -12205,14 +12279,14 @@ function relativeLuminance(r, g, b) {
 	return .2126 * R + .7152 * G + .0722 * B;
 }
 function contrastRatio(hex1, hex2) {
-	const { r: r1, g: g1, b: b1 } = hexToRgb$2(hex1);
-	const { r: r2, g: g2, b: b2 } = hexToRgb$2(hex2);
+	const { r: r1, g: g1, b: b1 } = hexToRgb$1(hex1);
+	const { r: r2, g: g2, b: b2 } = hexToRgb$1(hex2);
 	const L1 = relativeLuminance(r1, g1, b1);
 	const L2 = relativeLuminance(r2, g2, b2);
 	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
 	return (hi + .05) / (lo + .05);
 }
-var init_contrast$2 = __esmMin((() => {
+var init_contrast$1 = __esmMin((() => {
 	init_colorConversion();
 }));
 //#endregion
@@ -12268,7 +12342,7 @@ function asAccessibleSurfaceToken(token) {
 }
 var ON_BACKGROUND;
 var init_accessibleSurfaces = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 	init_onColor();
 }));
 //#endregion
@@ -13273,6 +13347,10 @@ var init_modern_minimal = __esmMin((() => {
 					name: "primary",
 					hex: "#1f2937"
 				},
+				{
+					name: "primaryForeground",
+					hex: "#ffffff"
+				},
 				{
 					name: "secondary",
 					hex: "#6b7280"
@@ -13301,6 +13379,14 @@ var init_modern_minimal = __esmMin((() => {
 					name: "surface",
 					hex: "#ffffff"
 				},
+				{
+					name: "surfaceAlt",
+					hex: "#f9fafb"
+				},
+				{
+					name: "muted",
+					hex: "#f3f4f6"
+				},
 				{
 					name: "text",
 					hex: "#1f2937"
@@ -13411,7 +13497,7 @@ function generateCssVars(palette) {
 	const cssVars = {};
 	Object.entries(palette).forEach(([key, value]) => {
 		if (key === "meta" || value === null || value === void 0 || typeof value !== "string") return;
-		const { r, g, b } = hexToRgb$2(value);
+		const { r, g, b } = hexToRgb$1(value);
 		cssVars[`--tb-${key}`] = `${r} ${g} ${b}`;
 	});
 	return cssVars;
@@ -13458,48 +13544,48 @@ var init_neutralScale = __esmMin((() => {
 }));
 var init_colorPlacement = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 }));
 var init_backgroundGeneration = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_analogous_harmony = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_colorConversion();
 }));
 var init_complementary_contrast = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_earthy_natural = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_high_contrast_modern = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_jewel_dark = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_minimal_monochrome = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_neon_pop = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_pastel_light = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_colorConversion();
 }));
 var init_soft_modern = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_split_complementary = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_tetradic = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 var init_triadic_balance = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 })), init_allRecipes = __esmMin((() => {
 	init_analogous_harmony();
 	init_complementary_contrast();
@@ -13515,7 +13601,7 @@ var init_triadic_balance = __esmMin((() => {
 	init_triadic_balance();
 }));
 var init_legs = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 	init_colorConversion();
 })), init_supportRoles = __esmMin((() => {
 	init_colorConversion();
@@ -13523,7 +13609,7 @@ var init_legs = __esmMin((() => {
 })), init_generatePalette = __esmMin((() => {
 	init_backgroundGeneration();
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_legs();
 	init_supportRoles();
 }));
@@ -13533,7 +13619,7 @@ var init_classifyColor = __esmMin((() => {
 var init_suggestRecipes = __esmMin((() => {
 	init_allRecipes();
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_generatePalette();
 	init_classifyColor();
 }));
@@ -13565,7 +13651,7 @@ function getTextColorForBackground(background) {
 }
 function parseColorToRgb(input) {
 	const trimmed = input.trim();
-	if (trimmed.startsWith("#")) return hexToRgb$2(trimmed);
+	if (trimmed.startsWith("#")) return hexToRgb$1(trimmed);
 	const rgbMatch = trimmed.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})(?:\s*,\s*(?:0|1|0?\.\d+))?\s*\)$/i);
 	if (rgbMatch?.[1] && rgbMatch[2] && rgbMatch[3]) return {
 		r: clamp255(Number(rgbMatch[1])),
@@ -13580,16 +13666,16 @@ function clamp255(value) {
 }
 var init_textColor = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 }));
 var init_legibility = __esmMin((() => {
-	init_contrast$2();
+	init_contrast$1();
 }));
 //#endregion
 //#region ../theme-core/src/palette/utils/index.ts
-var init_utils$5 = __esmMin((() => {
+var init_utils$6 = __esmMin((() => {
 	init_colorConversion();
-	init_contrast$2();
+	init_contrast$1();
 	init_colorPlacement();
 	init_backgroundGeneration();
 	init_suggestRecipes();
@@ -13710,7 +13796,7 @@ var init_swatch = __esmMin((() => {}));
 var init_PaletteCard = __esmMin((() => {
 	init_generateCssVars();
 	init_neutralScale();
-	init_utils$5();
+	init_utils$6();
 	init_paletteAccess();
 	init_expandPalette();
 	init_swatch();
@@ -13942,7 +14028,7 @@ function assignDeep(target, ...sources) {
 	});
 	return target;
 }
-var init_utils$4 = __esmMin((() => {}));
+var init_utils$5 = __esmMin((() => {}));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/options.js
 function buildProcessOptions(opts, override) {
@@ -13960,13 +14046,13 @@ function buildProcessOptions(opts, override) {
 	}, override);
 }
 var init_options = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/builder.js
 var Builder;
 var init_builder$2 = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 	init_esm$2();
 	Builder = class {
 		/**
@@ -14328,7 +14414,7 @@ var init_esm$3 = __esmMin((() => {
 var init_client$2 = __esmMin((() => {
 	init_esm$4();
 	init_esm$3();
-	init_utils$4();
+	init_utils$5();
 }));
 var init_host = __esmMin((() => {
 	init_esm$4();
@@ -14339,7 +14425,7 @@ var _Vibrant, Vibrant;
 var init_esm$2 = __esmMin((() => {
 	init_options();
 	init_builder$2();
-	init_utils$4();
+	init_utils$5();
 	init_pipeline$1();
 	init_client$2();
 	init_host();
@@ -16567,12 +16653,8 @@ var init_sitePalettePersistence = __esmMin((() => {
 	init_colors();
 	init_selection();
 }));
-var init_themePaletteCompatibility = __esmMin((() => {
-	init_themeColorTokens();
-	init_colors();
-}));
 var init_fromVibrant = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 //#endregion
 //#region ../theme-core/src/palette/index.ts
@@ -16584,7 +16666,7 @@ var init_palette$1 = __esmMin((() => {
 	init_generateShades();
 	init_neutralScale();
 	init_types$16();
-	init_utils$5();
+	init_utils$6();
 	init_paletteAccess();
 	init_extractPalette();
 	init_colors();
@@ -16594,7 +16676,6 @@ var init_palette$1 = __esmMin((() => {
 	init_resolveSelection();
 	init_selection();
 	init_sitePalettePersistence();
-	init_themePaletteCompatibility();
 	init_fromVibrant();
 	init_suggestRecipes();
 	init_allRecipes();
@@ -17040,6 +17121,108 @@ var init_contentTemplateDesignIntent = __esmMin((() => {
 	init_types$17();
 }));
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+var BUTTON_EFFECT_POLICIES;
+var init_effectClassification = __esmMin((() => {
+	BUTTON_EFFECT_POLICIES = {
+		"darken-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "darker"
+			}
+		},
+		"lighten-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "lighter"
+			}
+		},
+		"background-on-hover": {
+			classification: "colour-transition",
+			transition: { kind: "replace-background" }
+		},
+		"background-on-hover-alpha": {
+			classification: "unsupported-colour",
+			reason: "alpha_requires_surface"
+		},
+		"fade-background": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"opacity-reduce": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"gradient-text": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"text-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"border-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_border"
+		},
+		"aurora-glow": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"cosmic-stardust": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"animated-gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"nav-underline": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-base": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-hover": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-active": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"animated-gradient": { classification: "non-colour" },
+		"border-glow": { classification: "non-colour" },
+		"drop-shadow": { classification: "non-colour" },
+		"inner-shadow": { classification: "non-colour" },
+		"neumorphic-shadow": { classification: "non-colour" },
+		"outer-glow": { classification: "non-colour" },
+		"retro-3d-shadow": { classification: "non-colour" },
+		"scale-up": { classification: "non-colour" },
+		"scale-down": { classification: "non-colour" },
+		lift: { classification: "non-colour" },
+		"press-down": { classification: "non-colour" },
+		pop: { classification: "non-colour" },
+		"border-bottom-grow": { classification: "non-colour" },
+		"sketchy-border": { classification: "non-colour" },
+		"pulse-animation": { classification: "non-colour" }
+	};
+}));
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 function isVariantRole(value) {
 	return VARIANT_ROLES.includes(value);
@@ -17048,9 +17231,155 @@ function asSpecialVariantId(value) {
 	if (value.length === 0) throw new Error("SpecialVariantId must be a non-empty string");
 	return value;
 }
-var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, buttonVariantSchema, buttonSystemSchema;
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray$3(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$3(value) {
+	return Array.isArray(value);
+}
+var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, opaqueButtonColourTokenSchema, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, canonicalButtonGlobalSettingsSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonColourTreatmentSchema, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, canonicalButtonVariantSchema, buttonVariantSchema, buttonSystemSchema;
 var init_types$14 = __esmMin((() => {
+	init_effectClassification();
 	init_themeColorTokens();
+	init_colorTokenParts();
 	VARIANT_ROLES = [
 		"primary",
 		"secondary",
@@ -17061,6 +17390,11 @@ var init_types$14 = __esmMin((() => {
 		"accent"
 	];
 	DEFAULT_VARIANT_ALIAS_ID = "default";
+	opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+		const token = parseOpaqueButtonColourToken(value);
+		if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+		return token;
+	});
 	cornerStyleSchema = z$1.enum([
 		"square",
 		"rounded",
@@ -17149,7 +17483,7 @@ var init_types$14 = __esmMin((() => {
 		lg,
 		xl: xl ?? lg
 	}));
-	buttonGlobalSettingsSchema = z$1.object({
+	canonicalButtonGlobalSettingsSchema = z$1.object({
 		cornerStyle: cornerStyleSchema,
 		cornerRadius: z$1.number().min(0).max(24).optional(),
 		/**
@@ -17180,11 +17514,12 @@ var init_types$14 = __esmMin((() => {
 		paddingPreset: buttonPaddingPresetSchema.optional(),
 		hoverTransform: hoverTransformSchema,
 		hoverColor: hoverColorSchema,
-		hoverColorToken: themeColorTokenSchema.optional(),
+		hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 		gradientStyle: gradientStyleSchema.optional(),
 		gradientAngle: z$1.number().min(0).max(360).optional(),
 		gradientSharpness: gradientSharpnessSchema.optional()
 	});
+	buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 	gradientDirectionSchema$1 = z$1.enum([
 		"to-r",
 		"to-l",
@@ -17195,30 +17530,37 @@ var init_types$14 = __esmMin((() => {
 		"to-br",
 		"to-bl"
 	]);
-	buttonBackgroundSchema = z$1.discriminatedUnion("type", [
+	buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
 		z$1.object({
 			type: z$1.literal("solid"),
-			colorToken: themeColorTokenSchema
+			colorToken: opaqueButtonColourTokenSchema
 		}),
 		z$1.object({
 			type: z$1.literal("gradient"),
-			stops: z$1.array(themeColorTokenSchema).min(2),
-			direction: gradientDirectionSchema$1
+			stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+				const [first, second, ...rest] = stops;
+				if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+				return [
+					first,
+					second,
+					...rest
+				];
+			}),
+			direction: gradientDirectionSchema$1,
+			foregroundToken: opaqueButtonColourTokenSchema
 		}),
-		z$1.object({ type: z$1.literal("transparent") })
+		z$1.object({
+			type: z$1.literal("surface"),
+			role: z$1.literal("link")
+		})
 	]);
+	buttonBackgroundSchema = buttonColourTreatmentSchema;
 	effectApplicationSchema$1 = z$1.object({
 		effectId: z$1.string(),
-		options: z$1.record(z$1.string(), z$1.any()).optional()
-	});
-	buttonBorderSchema = z$1.object({
-		widthClass: z$1.string(),
-		colorToken: themeColorTokenSchema
-	});
-	buttonVariantAffordanceSchema = z$1.object({
-		iconId: z$1.string().min(1),
-		colorToken: themeColorTokenSchema.optional()
+		options: z$1.record(z$1.string(), z$1.json()).optional()
 	});
+	buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+	buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 	variantShadowSchema = z$1.object({
 		elevation: z$1.enum([
 			"none",
@@ -17246,22 +17588,22 @@ var init_types$14 = __esmMin((() => {
 		lg: buttonSizeConfigSchema.optional(),
 		xl: buttonSizeConfigSchema.optional()
 	});
-	buttonVariantSchema = z$1.object({
+	canonicalButtonVariantSchema = z$1.object({
 		id: z$1.string(),
 		name: z$1.string().min(1).max(20),
 		enabled: z$1.boolean(),
 		priority: prioritySchema,
 		background: buttonBackgroundSchema,
-		textColorToken: themeColorTokenSchema,
 		/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 		borderRadius: z$1.string().optional(),
 		shadow: variantShadowSchema.optional(),
 		border: buttonBorderSchema.optional(),
-		hoverBackgroundToken: z$1.string().optional(),
+		hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 		effects: variantEffectsSchema.optional(),
 		sizes: variantSizeOverridesSchema.optional(),
 		affordance: buttonVariantAffordanceSchema.optional()
 	});
+	buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 	buttonSystemSchema = z$1.object({
 		global: buttonGlobalSettingsSchema,
 		variants: z$1.array(buttonVariantSchema).min(1).max(6),
@@ -17285,7 +17627,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 var buttonPersonalityIdSchema;
@@ -17350,19 +17692,15 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["primary", "accent"],
-						direction: "to-r"
+						direction: "to-r",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "secondary",
@@ -17372,32 +17710,27 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["secondary", "accent"],
-						direction: "to-br"
+						direction: "to-br",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "outline",
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -17408,8 +17741,10 @@ var init_brushed_wash = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-lg",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -17455,7 +17790,6 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					shadow: {
 						elevation: "medium",
@@ -17465,7 +17799,7 @@ var init_confident_chip = __esmMin((() => {
 					effects: {
 						hover: [{
 							effectId: "darken-background",
-							options: { amount: 60 }
+							options: { amount: 100 }
 						}],
 						active: [{
 							effectId: "scale-down",
@@ -17482,12 +17816,8 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "surface"
 					},
-					textColorToken: "text",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -17498,13 +17828,12 @@ var init_confident_chip = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -17515,8 +17844,10 @@ var init_confident_chip = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-md",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -17579,7 +17910,6 @@ var init_earth_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -17605,13 +17935,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -17622,13 +17951,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surfaceAlt" }
@@ -17639,8 +17967,10 @@ var init_earth_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "none",
@@ -17661,11 +17991,7 @@ var init_earth_pill = __esmMin((() => {
 							padding: "0.625rem 0",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 25 }
-					}] }
+					}
 				}
 			]
 		}
@@ -17701,8 +18027,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Primary",
 					enabled: true,
 					priority: 1,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -17724,8 +18052,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -17747,8 +18077,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -17770,19 +18102,17 @@ var init_editorial_link = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
 						md: { padding: "0.5rem 0" },
 						lg: { padding: "0.625rem 0" },
 						xl: { padding: "0.75rem 0" }
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -20 }
-					}] }
+					}
 				}
 			]
 		}
@@ -17840,12 +18170,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accent"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -17859,13 +18185,12 @@ var init_flat_ink = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -17883,12 +18208,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "accent"
 					},
-					textColorToken: "accentForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accentForeground"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -17951,7 +18272,6 @@ var init_ink_stamp = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					effects: {
 						hover: [{
@@ -17972,13 +18292,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -17989,13 +18308,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18006,8 +18324,10 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -18094,7 +18414,6 @@ var init_joy_stamp = __esmMin((() => {
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "high",
@@ -18108,13 +18427,12 @@ var init_joy_stamp = __esmMin((() => {
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "text"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				shadow: {
 					elevation: "high",
 					softness: "hard",
@@ -18179,12 +18497,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: {
 						hover: [{
 							effectId: "background-on-hover",
@@ -18205,12 +18519,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18221,13 +18531,12 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -18238,8 +18547,10 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -18321,14 +18632,10 @@ var init_pebble = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 88
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -18336,13 +18643,12 @@ var init_pebble = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "accent"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "accent" }
@@ -18353,13 +18659,12 @@ var init_pebble = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18370,8 +18675,10 @@ var init_pebble = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					sizes: {
 						sm: {
@@ -18387,11 +18694,7 @@ var init_pebble = __esmMin((() => {
 							padding: "0.75rem 1.5rem",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 30 }
-					}] }
+					}
 				}
 			]
 		}
@@ -18452,15 +18755,11 @@ var init_quiet_arrow = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-xl",
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 90
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -18468,13 +18767,12 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-xl",
+					border: { widthClass: "border" },
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -18486,21 +18784,22 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					}
+					border: { widthClass: "border" }
 				},
 				{
 					id: "ghost",
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl"
 				}
 			]
@@ -18563,7 +18862,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "background",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -18572,13 +18870,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{ effectId: "pop" }] }
 				},
 				{
@@ -18590,7 +18887,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -18603,12 +18899,8 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "background"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18619,13 +18911,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -18636,8 +18927,10 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -18683,7 +18976,6 @@ var init_soft_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -18706,13 +18998,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18723,13 +19014,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -18740,8 +19030,10 @@ var init_soft_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -18756,6 +19048,7 @@ var init_soft_pill = __esmMin((() => {
 //#region ../theme-core/src/buttons/personalities/two-tone-pill.ts
 var solidSecondary, twoTonePill;
 var init_two_tone_pill = __esmMin((() => {
+	init_types$14();
 	init_soft_pill();
 	init_types$13();
 	solidSecondary = {
@@ -18765,9 +19058,8 @@ var init_two_tone_pill = __esmMin((() => {
 		priority: 2,
 		background: {
 			type: "solid",
-			colorToken: "secondary"
+			colorToken: unsafeAsOpaqueButtonColourToken("secondary")
 		},
-		textColorToken: "onSecondary",
 		borderRadius: "rounded-full",
 		shadow: {
 			elevation: "none",
@@ -19148,6 +19440,276 @@ var init_testimonialQuotePresets = __esmMin((() => {
 	serifDisplayQuote = { style: "serif-display" };
 	accentGlyphQuote = { style: "accent-glyph" };
 }));
+//#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
+var init_types$12 = __esmMin((() => {
+	init_themeColorTokens();
+	gradientStopSchema = z$1.object({
+		color: themeColorTokenSchema,
+		position: z$1.number().min(0).max(100)
+	});
+	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+	gradientConfigSchema = z$1.object({
+		type: z$1.enum([
+			"linear",
+			"radial",
+			"conic"
+		]).default("linear"),
+		angle: z$1.number().min(0).max(360).optional(),
+		shape: radialGradientShapeSchema.optional(),
+		position: z$1.string().optional(),
+		stops: z$1.array(gradientStopSchema).min(2)
+	});
+}));
+//#endregion
+//#region ../theme-core/src/gradients/presets.ts
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+function getGradientPreset(id) {
+	return gradientPresetById[id];
+}
+var rawGradientPresets, GRADIENT_PRESETS, GRADIENT_PRESET_IDS, gradientPresetIdSet, gradientPresetById;
+var init_presets$1 = __esmMin((() => {
+	rawGradientPresets = [
+		{
+			id: "primary-secondary",
+			name: "Primary to Secondary",
+			description: "Blend your primary and secondary brand colors",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "secondary-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-accent",
+			name: "Primary to Accent",
+			description: "Energetic gradient from primary to accent",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-accent",
+			name: "Secondary to Accent",
+			description: "Vibrant secondary to accent blend",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-light-dark",
+			name: "Primary Light to Dark",
+			description: "Subtle primary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "primary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-dark-light",
+			name: "Primary Dark to Light",
+			description: "Reverse primary fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-50",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-light-dark",
+			name: "Secondary Light to Dark",
+			description: "Subtle secondary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "secondary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "accent-light-dark",
+			name: "Accent Light to Dark",
+			description: "Accent color depth fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "accent-500",
+				position: 0
+			}, {
+				color: "accent-900",
+				position: 100
+			}]
+		},
+		{
+			id: "background-surface",
+			name: "Background to Surface",
+			description: "Subtle depth using base colors",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "background",
+				position: 0
+			}, {
+				color: "surface",
+				position: 100
+			}]
+		},
+		{
+			id: "neutral-fade",
+			name: "Neutral Gradient",
+			description: "Elegant neutral color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "neutral-900",
+				position: 0
+			}, {
+				color: "neutral-50",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-glow",
+			name: "Primary glow",
+			description: "A soft top-centred glow using your primary palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onPrimary900",
+				headingColor: "onPrimary900",
+				linkColor: "onPrimary900",
+				supportingColor: "onPrimary900"
+			}
+		},
+		{
+			id: "accent-glow",
+			name: "Accent glow",
+			description: "A soft top-centred glow using your accent palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "accent-900",
+				position: 0
+			}, {
+				color: "accent-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onAccent900",
+				headingColor: "onAccent900",
+				linkColor: "onAccent900",
+				supportingColor: "onAccent900"
+			}
+		},
+		{
+			id: "primary-secondary-accent",
+			name: "Brand Trio",
+			description: "All three brand colors in harmony",
+			type: "linear",
+			angle: 135,
+			stops: [
+				{
+					color: "primary-500",
+					position: 0
+				},
+				{
+					color: "secondary-500",
+					position: 50
+				},
+				{
+					color: "accent-500",
+					position: 100
+				}
+			]
+		}
+	];
+	GRADIENT_PRESETS = rawGradientPresets.map((preset) => ({
+		...preset,
+		id: preset.id,
+		stops: preset.stops
+	}));
+	GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+	gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+	gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+}));
+//#endregion
+//#region ../theme-core/src/gradients/utils.ts
+/**
+* Convert a GradientConfig to a CSS gradient string
+*
+* @param config - The gradient configuration using theme tokens
+* @param tokens - Map of theme color tokens to hex values
+* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
+*/
+function gradientToCss(config, tokens) {
+	const stops = config.stops.map((stop) => {
+		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
+	}).join(", ");
+	const type = config.type ?? "linear";
+	if (type === "radial") {
+		const position = config.position ?? "center";
+		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
+	}
+	if (type === "conic") {
+		const position = config.position ?? "center";
+		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
+	}
+	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
+}
+var init_utils$4 = __esmMin((() => {}));
+//#endregion
+//#region ../theme-core/src/gradients/index.ts
+var init_gradients = __esmMin((() => {
+	init_types$12();
+	init_presets$1();
+	init_utils$4();
+}));
 var init_customizableSurfaces = __esmMin((() => {
 	init_types$17();
 })), logoTextConfidenceValues, logoAssetShapeValues, logoKindValues, logoDensityValues, logoContainsTextSchema, logoAnalysisSourceSchema, brandDisplayModeValues, logoAccommodationPatternValues, logoSizePolicyValues;
@@ -21469,14 +22031,12 @@ var init_background$2 = __esmMin((() => {
 			]
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, options, tokens } = ctx;
+			const { themeId, variantId, options, tokens, buttonConfig } = ctx;
 			const colorToken = options.colorToken || "neutral-800";
-			const color = tokens.getColor(colorToken);
-			const textColorToken = typeof options.textColorToken === "string" ? options.textColorToken : null;
 			return `
       /* Add background on hover */
       :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${color};${textColorToken ? `\n        color: ${tokens.getColor(textColorToken)};` : ""}
+        background-color: ${tokens.getColor(colorToken)};${"textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : ""}
       }
     `;
 		}
@@ -21495,10 +22055,10 @@ var init_background$2 = __esmMin((() => {
 			default: 50
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, stateGroup, options, buttonConfig } = ctx;
+			const { themeId, variantId, stateGroup, options } = ctx;
 			const rawOpacity = options.opacity;
 			const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
-			const cssVar = `var(--tb-${options.colorToken || buttonConfig.textColorToken || "neutral-800"})`;
+			const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
 			return `
       /* Add semi-transparent background (${stateGroup}) */
       :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
@@ -21675,7 +22235,7 @@ var init_shadow = __esmMin((() => {
 			const spread = options.spread || 10;
 			let glowColor;
 			if (options.glowColorToken && typeof options.glowColorToken === "string") glowColor = tokens.getColor(options.glowColorToken);
-			else if (buttonConfig.border?.colorToken) glowColor = tokens.getColor(buttonConfig.border.colorToken);
+			else if (buttonConfig.border) glowColor = "colorToken" in buttonConfig.border ? tokens.getColor(buttonConfig.border.colorToken) : "currentColor";
 			else if (buttonConfig.background.type === "solid") glowColor = tokens.getColor(buttonConfig.background.colorToken ?? "primary-400");
 			else glowColor = tokens.getColor("primary-400");
 			return `
@@ -21757,9 +22317,9 @@ function generateShadowValue$1(elevation, softness, position = "bottom", color)
 		case "crisp": return `${xOffset}px ${yOffset}px ${baseOffset}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.4)"}`;
 	}
 }
-var GRADIENT_DIRECTION_MAP$3, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
+var GRADIENT_DIRECTION_MAP$2, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
 var init_constants$2 = __esmMin((() => {
-	GRADIENT_DIRECTION_MAP$3 = {
+	GRADIENT_DIRECTION_MAP$2 = {
 		"to-r": "to right",
 		"to-l": "to left",
 		"to-t": "to top",
@@ -22704,30 +23264,6 @@ function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elem
 var init_generateEffectsCSS = __esmMin((() => {
 	init_registry$1();
 }));
-/**
-* Get contrasting text color for a button background
-*
-* This function returns theme-aware text colors using the neutral scale,
-* which is guaranteed to exist in every theme and harmonizes with the design.
-*
-* Uses neutral-50 (lightest) for dark backgrounds and neutral-950 (darkest)
-* for light backgrounds. This ensures excellent contrast while respecting
-* the theme's neutral palette (warm/cool tinting).
-*
-* For solid backgrounds with primary/secondary/neutral colors:
-* - Dark backgrounds (shade >= 500): neutral-50 (very light)
-* - Light backgrounds (shade < 500): neutral-950 (very dark)
-*/
-function getContrastingTextColorToken(backgroundToken, theme) {
-	const isLightTheme = theme.palette.meta.mode === "light";
-	if (backgroundToken.startsWith("primary-") || backgroundToken.startsWith("secondary-")) return "neutral-50";
-	if (backgroundToken.startsWith("neutral-")) {
-		const match = backgroundToken.match(/neutral-(\d+)/);
-		if (match?.[1]) return parseInt(match[1], 10) >= 500 ? "neutral-50" : "neutral-950";
-	}
-	return isLightTheme ? "neutral-50" : "neutral-950";
-}
-var init_contrast$1 = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/buttons/generateDefaultButtonSystem.ts
 /**
@@ -22771,13 +23307,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",
@@ -22786,51 +23317,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 {
@@ -22847,7 +23366,7 @@ function generateDefaultButtonSystem(theme) {
 }
 var BORDER_WIDTH_TO_CLASS_MAP, VALID_CORNER_STYLES;
 var init_generateDefaultButtonSystem = __esmMin((() => {
-	init_contrast$1();
+	init_types$14();
 	BORDER_WIDTH_TO_CLASS_MAP = {
 		none: "border-0",
 		hairline: "border",
@@ -22883,8 +23402,490 @@ var init_affordanceIcons = __esmMin((() => {
 	};
 }));
 //#endregion
+//#region ../theme-core/src/surfaces/foregroundRoles.ts
+var SURFACE_FOREGROUND_ROLES;
+var init_foregroundRoles = __esmMin((() => {
+	SURFACE_FOREGROUND_ROLES = [
+		"text",
+		"heading",
+		"link",
+		"supporting"
+	];
+}));
+//#endregion
+//#region ../theme-core/src/surfaces/foregroundContract.ts
+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]}`)];
+}
+var SURFACE_FOREGROUND_CSS_VARS, DEFAULT_SURFACE_TEXT_COLOR, DEFAULT_SURFACE_LINK_COLOR, DEFAULT_SURFACE_SUPPORTING_COLOR, DEFAULT_ROLE_FALLBACKS;
+var init_foregroundContract = __esmMin((() => {
+	init_foregroundRoles();
+	SURFACE_FOREGROUND_CSS_VARS = {
+		text: "--rb-surface-text-color",
+		heading: "--rb-surface-heading-color",
+		link: "--rb-surface-link-color",
+		supporting: "--rb-surface-supporting-color"
+	};
+	DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+	DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
+	DEFAULT_SURFACE_SUPPORTING_COLOR = "rgb(var(--tb-mutedText, 100 116 139))";
+	DEFAULT_ROLE_FALLBACKS = {
+		text: DEFAULT_SURFACE_TEXT_COLOR,
+		heading: DEFAULT_SURFACE_TEXT_COLOR,
+		link: DEFAULT_SURFACE_LINK_COLOR,
+		supporting: DEFAULT_SURFACE_SUPPORTING_COLOR
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+function compileButtonColourStates(input) {
+	const baseTransition = applyColourEffects({
+		variantId: input.variant.id,
+		state: "base",
+		treatment: input.variant.background,
+		effects: input.variant.effects?.base,
+		palette: input.palette
+	});
+	if (!baseTransition.ok) return baseTransition;
+	const stateTreatments = {
+		base: baseTransition.treatment,
+		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
+		focus: baseTransition.treatment,
+		active: baseTransition.treatment,
+		disabled: baseTransition.treatment
+	};
+	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) {
+		const transition = applyColourEffects({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			effects: input.variant.effects?.[state],
+			palette: input.palette
+		});
+		if (!transition.ok) return transition;
+		stateTreatments[state] = transition.treatment;
+		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
+	}
+	const resolved = {};
+	for (const state of BUTTON_VISUAL_STATES) {
+		const result = resolveTreatment$1({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			palette: input.palette
+		});
+		if (!result.ok) return result;
+		resolved[state] = result.colour;
+	}
+	return {
+		ok: true,
+		states: resolved,
+		focusIndicator: resolveFocusIndicator(resolved.focus),
+		nonColourEffects
+	};
+}
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function hoverTreatment(variant, global, fallback) {
+	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
+	return token === void 0 ? fallback : {
+		type: "solid",
+		colorToken: token
+	};
+}
+function applyColourEffects(input) {
+	let treatment = input.treatment;
+	const nonColourEffects = [];
+	for (const effect of input.effects ?? []) {
+		const policy = getButtonEffectPolicy(effect.effectId);
+		if (policy === null) return unknownEffect(input, effect);
+		switch (policy.classification) {
+			case "non-colour":
+				nonColourEffects.push(effect);
+				break;
+			case "unsupported-colour":
+			case "unsupported-background-overlay":
+			case "not-button": return unsupportedEffect(input, effect, policy.reason);
+			case "colour-transition":
+				if (policy.transition.kind === "adjust-shade") {
+					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
+					const amount = readShadeAmount(effect);
+					if (amount === null) return invalidEffectOption(input, effect, "amount");
+					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
+					treatment = {
+						type: "solid",
+						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
+					};
+					break;
+				}
+				if (policy.transition.kind === "replace-background") {
+					const colorToken = readOpaqueToken(effect, "colorToken", "neutral-800");
+					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
+					treatment = {
+						type: "solid",
+						colorToken
+					};
+					break;
+				}
+				return unknownEffect(input, effect);
+		}
+	}
+	return {
+		ok: true,
+		treatment,
+		nonColourEffects
+	};
+}
+function resolveTreatment$1(input) {
+	const treatment = input.treatment;
+	switch (treatment.type) {
+		case "surface": return {
+			ok: true,
+			colour: {
+				kind: "surface",
+				role: treatment.role,
+				backgroundCss: "transparent",
+				foregroundCss: surfaceForegroundValue(treatment.role)
+			}
+		};
+		case "solid": return resolveSolid(input, treatment.colorToken);
+		case "gradient": return resolveGradient$2(input, treatment);
+	}
+}
+function resolveFocusIndicator(colour) {
+	switch (colour.kind) {
+		case "solid": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: colour.backgroundCss,
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "gradient": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: tokenCss(colour.backgroundTokens[0]),
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "surface": return {
+			kind: "surface-role",
+			colorCss: colour.foregroundCss,
+			minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+		};
+	}
+}
+function resolveSolid(input, backgroundToken) {
+	const backgroundHex = paletteHex(input, backgroundToken);
+	if (!backgroundHex.ok) return backgroundHex;
+	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
+	const foregroundHex = input.palette[foregroundToken];
+	if (typeof foregroundHex !== "string") return {
+		ok: false,
+		error: {
+			tag: "missing_on_colour",
+			variantId: input.variantId,
+			state: input.state,
+			backgroundToken,
+			foregroundToken
+		}
+	};
+	const contrast = validateContrast({
+		...input,
+		background: backgroundToken,
+		backgroundHex: backgroundHex.hex,
+		foreground: foregroundToken,
+		foregroundHex
+	});
+	if (!contrast.ok) return contrast;
+	return {
+		ok: true,
+		colour: {
+			kind: "solid",
+			backgroundToken,
+			foregroundToken,
+			backgroundCss: tokenCss(backgroundToken),
+			foregroundCss: tokenCss(foregroundToken)
+		}
+	};
+}
+function resolveGradient$2(input, treatment) {
+	const foregroundHex = paletteHex(input, treatment.foregroundToken);
+	if (!foregroundHex.ok) return foregroundHex;
+	const stopHexes = [];
+	for (const token of treatment.stops) {
+		const stop = paletteHex(input, token);
+		if (!stop.ok) return stop;
+		stopHexes.push(stop.hex);
+	}
+	for (let segment = 0; segment < stopHexes.length - 1; segment += 1) {
+		const start = stopHexes[segment];
+		const end = stopHexes[segment + 1];
+		const startToken = treatment.stops[segment];
+		const endToken = treatment.stops[segment + 1];
+		if (start === void 0 || end === void 0 || startToken === void 0 || endToken === void 0) continue;
+		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
+			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
+			const sampleHex = interpolateHex(start, end, position);
+			const contrast = validateContrast({
+				...input,
+				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
+				backgroundHex: sampleHex,
+				foreground: treatment.foregroundToken,
+				foregroundHex: foregroundHex.hex
+			});
+			if (!contrast.ok) return contrast;
+		}
+	}
+	const direction = GRADIENT_DIRECTION_MAP$2[treatment.direction] ?? "to right";
+	return {
+		ok: true,
+		colour: {
+			kind: "gradient",
+			backgroundTokens: treatment.stops,
+			foregroundToken: treatment.foregroundToken,
+			backgroundCss: `linear-gradient(${direction}, ${treatment.stops.map(tokenCss).join(", ")})`,
+			foregroundCss: tokenCss(treatment.foregroundToken)
+		}
+	};
+}
+function paletteHex(input, token) {
+	const hex = input.palette[token];
+	return typeof hex === "string" ? {
+		ok: true,
+		hex
+	} : {
+		ok: false,
+		error: {
+			tag: "unknown_palette_token",
+			variantId: input.variantId,
+			state: input.state,
+			token
+		}
+	};
+}
+function validateContrast(input) {
+	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			background: input.background,
+			foreground: input.foreground,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		}
+	};
+}
+function tokenCss(token) {
+	return `rgb(var(--tb-${token}))`;
+}
+function adjustShade(token, amount, palette) {
+	const match = token.match(/^(.*)-(\d{2,3})$/);
+	const base = match?.[1] ?? token;
+	const currentShade = match?.[2] === void 0 ? 500 : Number(match[2]);
+	const availableShades = [
+		50,
+		100,
+		200,
+		300,
+		400,
+		500,
+		600,
+		700,
+		800,
+		900,
+		950
+	].filter((shade) => typeof palette[`${base}-${shade}`] === "string");
+	if (availableShades.length === 0) return token;
+	const firstShade = availableShades[0];
+	if (firstShade === void 0) return token;
+	const exactIndex = availableShades.indexOf(currentShade);
+	const startingIndex = exactIndex >= 0 ? exactIndex : availableShades.indexOf(availableShades.reduce((closestShade, shade) => Math.abs(shade - currentShade) < Math.abs(closestShade - currentShade) ? shade : closestShade, firstShade));
+	const stepCount = Math.abs(amount) / 100;
+	const direction = amount < 0 ? -1 : 1;
+	const targetShade = availableShades[Math.max(0, Math.min(availableShades.length - 1, startingIndex + direction * stepCount))];
+	return targetShade === void 0 ? token : unsafeAsOpaqueButtonColourToken(`${base}-${targetShade}`);
+}
+function readShadeAmount(effect) {
+	const value = effect.options?.amount ?? 100;
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value % 100 === 0 ? value : null;
+}
+function readOpaqueToken(effect, key, fallback) {
+	return parseOpaqueButtonColourToken(effect.options?.[key] ?? fallback);
+}
+function unsupportedEffect(input, effect, reason) {
+	return {
+		ok: false,
+		error: {
+			tag: "unsupported_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			reason
+		}
+	};
+}
+function invalidEffectOption(input, effect, option) {
+	return {
+		ok: false,
+		error: {
+			tag: "invalid_colour_effect_options",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			option
+		}
+	};
+}
+function inapplicableEffect(input, effect, treatment) {
+	return {
+		ok: false,
+		error: {
+			tag: "inapplicable_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			treatment: treatment.type
+		}
+	};
+}
+function unknownEffect(input, effect) {
+	return {
+		ok: false,
+		error: {
+			tag: "unknown_button_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId
+		}
+	};
+}
+function interpolateHex(startHex, endHex, position) {
+	const start = hexToRgb$1(startHex);
+	const end = hexToRgb$1(endHex);
+	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
+	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
+}
+var BUTTON_VISUAL_STATES, BUTTON_CONTRAST_POLICY;
+var init_resolveButtonColourStates = __esmMin((() => {
+	init_contrast$1();
+	init_colorConversion();
+	init_onColor();
+	init_foregroundContract();
+	init_types$14();
+	init_constants$2();
+	init_effectClassification();
+	BUTTON_VISUAL_STATES = [
+		"base",
+		"hover",
+		"focus",
+		"active",
+		"disabled"
+	];
+	BUTTON_CONTRAST_POLICY = {
+		textMinimumRatio: 4.5,
+		nonTextMinimumRatio: 3,
+		gradientSamplesPerSegment: 20,
+		alphaBackgrounds: "reject-without-known-surface",
+		disabled: "retain-full-colour-contract"
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/resolvedButtonCss.ts
+/**
+* Canonical colour declaration mapping shared by full themes and ThemeBridge.
+* Both background properties are always emitted so transitions cannot retain
+* a stale gradient or solid layer.
+*/
+function resolvedButtonColourDeclarations(colour) {
+	switch (colour.kind) {
+		case "solid": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+		case "gradient": return [
+			["background-color", "transparent"],
+			["background-image", colour.backgroundCss],
+			["color", colour.foregroundCss]
+		];
+		case "surface": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+	}
+}
+function resolvedButtonFocusDeclarations(indicator) {
+	return indicator.kind === "two-tone" ? [
+		["outline", `2px solid ${indicator.innerCss}`],
+		["outline-offset", "2px"],
+		["box-shadow", `0 0 0 4px ${indicator.outerCss}`]
+	] : [["outline", `3px solid ${indicator.colorCss}`], ["outline-offset", "3px"]];
+}
+var RESOLVED_BUTTON_DISABLED_DECLARATIONS;
+var init_resolvedButtonCss = __esmMin((() => {
+	RESOLVED_BUTTON_DISABLED_DECLARATIONS = [
+		["cursor", "not-allowed"],
+		["transform", "none"],
+		["box-shadow", "none"],
+		["outline", "2px dashed currentColor"],
+		["outline-offset", "-4px"]
+	];
+}));
+//#endregion
 //#region ../theme-core/src/buttons/generateButtonCss.ts
-function rule(selector, declarations) {
+function rule$1(selector, declarations) {
 	return {
 		selectors: typeof selector === "string" ? [selector] : selector,
 		declarations
@@ -22925,6 +23926,7 @@ function shadowSizeToShadow(size, theme) {
 function generateButtonCss(options) {
 	const { themeId, theme, buttonSystem: providedButtonSystem } = options;
 	const tokens = new TokenResolver(theme);
+	const palette = expandPalette(theme.palette);
 	const buttonSystem = providedButtonSystem ?? generateDefaultButtonSystem(theme);
 	const themeSizes = {
 		...DEFAULT_BUTTON_SIZES,
@@ -22933,34 +23935,109 @@ function generateButtonCss(options) {
 	const enabledVariants = buttonSystem.variants.filter((v) => v.enabled);
 	const aliasSource = resolveAliasSource(enabledVariants);
 	const chunks = [];
-	for (const variant of enabledVariants) chunks.push(...variantChunks(variant, buttonSystem.global, themeSizes, themeId, tokens, theme));
+	for (const variant of enabledVariants) {
+		const compiled = compileRuntimeVariant(variant, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
+	}
 	if (aliasSource) {
-		const alias = {
+		const compiled = compileRuntimeVariant({
 			...aliasSource,
 			id: DEFAULT_VARIANT_ALIAS_ID,
 			name: "Default"
-		};
-		chunks.push(...variantChunks(alias, buttonSystem.global, themeSizes, themeId, tokens, theme));
+		}, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
 	}
 	return chunks.map(renderChunk).join("\n\n");
 }
+function compileRuntimeVariant(variant, global, palette) {
+	const result = compileButtonColourStates({
+		variant,
+		global,
+		palette
+	});
+	if (result.ok) return {
+		variant,
+		global,
+		colours: result.states,
+		focusIndicator: result.focusIndicator,
+		nonColourEffects: result.nonColourEffects
+	};
+	const fallbackVariant = {
+		...variant,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		hoverBackgroundToken: void 0,
+		effects: void 0
+	};
+	const fallbackGlobal = {
+		...global,
+		hoverColor: "none",
+		hoverColorToken: void 0
+	};
+	const fallback = compileButtonColourStates({
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		palette
+	});
+	if (!fallback.ok) {
+		const colour = {
+			kind: "surface",
+			role: "link",
+			backgroundCss: "transparent",
+			foregroundCss: surfaceForegroundValue("link")
+		};
+		return {
+			variant: fallbackVariant,
+			global: fallbackGlobal,
+			colours: {
+				base: colour,
+				hover: colour,
+				focus: colour,
+				active: colour,
+				disabled: colour
+			},
+			focusIndicator: {
+				kind: "surface-role",
+				colorCss: colour.foregroundCss,
+				minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+			},
+			nonColourEffects: {},
+			fallbackError: result.error
+		};
+	}
+	return {
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		colours: fallback.states,
+		focusIndicator: fallback.focusIndicator,
+		nonColourEffects: fallback.nonColourEffects,
+		fallbackError: result.error
+	};
+}
 /** Pick the highest-priority variant whose role we'll alias to `.default`. */
 function resolveAliasSource(enabled) {
 	if (enabled.some((v) => v.id === DEFAULT_VARIANT_ALIAS_ID)) return null;
 	return enabled.slice().sort((a, b) => a.priority - b.priority)[0] ?? null;
 }
-function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
+function variantChunks(variant, global, themeSizes, themeId, tokens, theme, colours, focusIndicator, nonColourEffects) {
 	const out = [];
 	const variantId = parseButtonVariantIdForCss(variant.id);
 	const selector = `:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}`;
-	out.push(variantBaseRule(variant, selector, global, tokens, theme));
+	out.push(variantBaseRule(variant, selector, global, tokens, theme, colours.base));
 	out.push({ raw: generateInteractiveChildInheritanceCSS(selector) });
-	const hoverBg = variantHoverBackgroundRule(variant, variantId, global, themeId, tokens);
-	if (hoverBg) out.push(hoverBg);
-	out.push(variantFocusVisibleRule(variantId, themeId));
-	const effects = variantEffectsCss(variant, themeId, tokens, theme);
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) if (!resolvedColoursEqual(colours.base, colours[state])) out.push(variantStateColourRule(variantId, themeId, state, colours[state]));
+	const effects = variantEffectsCss(variant, nonColourEffects, themeId, tokens, theme);
 	if (effects) out.push({ raw: effects });
-	const affordance = variantAffordanceRule(variant, selector, tokens);
+	out.push(variantFocusVisibleRule(variantId, themeId, focusIndicator));
+	const affordance = variantAffordanceRule(variant, selector);
 	if (affordance) out.push(affordance);
 	out.push(...variantDisabledRules(variantId, themeId));
 	out.push(...variantSizeRules(variant, variantId, themeSizes, themeId));
@@ -22975,21 +24052,20 @@ function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
 * one (node overrides personality). Colour comes from the affordance token, or
 * `currentColor` (the button text colour) when no token is given.
 */
-function variantAffordanceRule(variant, selector, tokens) {
+function variantAffordanceRule(variant, selector) {
 	const affordance = variant.affordance;
 	if (!affordance) return null;
 	const maskUrl = affordanceIconMaskUrl(affordance.iconId);
 	if (!maskUrl) return null;
-	const color = affordance.colorToken ? variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(affordance.colorToken)) : tokens.getColor(affordance.colorToken) : "currentColor";
 	const mask = `url("${maskUrl}") no-repeat center / contain`;
-	return rule(`${selector}:not(.${AFFORDANCE_SUPPRESS_CLASS})::after`, [
+	return rule$1(`${selector}:not(.${AFFORDANCE_SUPPRESS_CLASS})::after`, [
 		["content", "\"\""],
 		["display", "inline-block"],
 		["width", "1em"],
 		["height", "1em"],
 		["margin-inline-start", "0.5em"],
 		["flex", "0 0 auto"],
-		["background-color", color],
+		["background-color", "currentColor"],
 		["-webkit-mask", mask],
 		["mask", mask]
 	]);
@@ -22999,7 +24075,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)]);
@@ -23011,20 +24087,12 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 	for (const decl of STRUCTURAL_DECLARATIONS) decls.push(decl);
 	decls.push(["border-radius", resolveBorderRadius(variant, global)]);
 	decls.push(["box-shadow", resolveBoxShadow(variant, global, theme, tokens)]);
-	if (variant.background.type === "solid") decls.push(["background-color", tokens.getColor(variant.background.colorToken)]);
-	else if (variant.background.type === "gradient") {
-		const colors = variant.background.stops.map((stop) => tokens.getColor(stop)).join(", ");
-		const direction = GRADIENT_DIRECTION_MAP$3[variant.background.direction] || "to right";
-		decls.push(["background-image", `linear-gradient(${direction}, ${colors})`]);
-	} else decls.push(["background-color", "transparent"]);
-	const foregroundColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.textColorToken)) : tokens.getColor(variant.textColorToken);
-	decls.push(["color", foregroundColor]);
+	decls.push(...resolvedButtonColourDeclarations(colour));
 	if (variant.border) {
 		const borderWidth = BORDER_WIDTH_MAP$4[variant.border.widthClass] || "1px";
-		const borderColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.border.colorToken)) : tokens.getColor(variant.border.colorToken);
-		decls.push(["border", `${borderWidth} solid ${borderColor}`]);
+		decls.push(["border", `${borderWidth} solid currentColor`]);
 	}
-	return rule(selector, decls);
+	return rule$1(selector, decls);
 }
 /**
 * Resolve a colour for a button that does not own its own background.
@@ -23033,30 +24101,22 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 * token fallback keeps buttons usable in contexts that do not provide that
 * contract (and preserves the existing theme behaviour there).
 */
-function surfaceLinkColor(fallbackColor) {
-	return `var(--rb-surface-link-color, ${fallbackColor})`;
-}
-function variantHoverBackgroundRule(variant, variantId, global, themeId, tokens) {
-	let hoverToken = variant.hoverBackgroundToken;
-	if (!hoverToken && global.hoverColor === "token" && global.hoverColorToken) hoverToken = global.hoverColorToken;
-	if (!hoverToken) return null;
-	return rule(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:hover`, [["background-color", tokens.getColor(hoverToken)]]);
+function variantStateColourRule(variantId, themeId, state, colour) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:${state}`, resolvedButtonColourDeclarations(colour));
 }
-function variantFocusVisibleRule(variantId, themeId) {
-	return rule(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, [["outline", "2px solid currentColor"], ["outline-offset", "3px"]]);
+function variantFocusVisibleRule(variantId, themeId, focusIndicator) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, resolvedButtonFocusDeclarations(focusIndicator));
 }
-function variantEffectsCss(variant, themeId, tokens, theme) {
-	if (!variant.effects) return "";
+function variantEffectsCss(variant, effects, themeId, tokens, theme) {
+	if (!effects) return "";
 	const elementConfig = {
-		background: variant.background,
-		textColorToken: variant.textColorToken,
-		border: variant.border ? { colorToken: variant.border.colorToken } : void 0,
+		background: variant.background.type === "surface" ? { type: "transparent" } : variant.background,
 		shadow: variant.shadow
 	};
 	return generateEffectsCSS({
 		themeId,
 		variantId: variant.id,
-		effects: variant.effects,
+		effects,
 		elementConfig,
 		tokens,
 		theme
@@ -23071,18 +24131,15 @@ function variantDisabledRules(variantId, themeId) {
 		`${base}:focus`
 	];
 	const pseudoSelectors = [`${base}::before`, `${base}::after`];
-	return [rule(disabledSelectors, [
-		["opacity", "0.5"],
-		["cursor", "not-allowed"],
-		["pointer-events", "none"],
-		["transform", "none"],
-		["box-shadow", "none"]
-	]), rule(pseudoSelectors, [
+	return [rule$1(disabledSelectors, [...RESOLVED_BUTTON_DISABLED_DECLARATIONS]), rule$1(pseudoSelectors, [
 		["opacity", "0"],
 		["animation", "none"],
 		["pointer-events", "none"]
 	])];
 }
+function resolvedColoursEqual(left, right) {
+	return JSON.stringify(left) === JSON.stringify(right);
+}
 function variantSizeRules(variant, variantId, themeSizes, themeId) {
 	const borderWidth = variant.border ? BORDER_WIDTH_MAP$4[variant.border.widthClass] || "1px" : "0px";
 	const rules = [];
@@ -23092,7 +24149,7 @@ function variantSizeRules(variant, variantId, themeSizes, themeId) {
 		const decls = [];
 		for (const decl of paddingDeclarations(config.padding, borderWidth)) decls.push(decl);
 		if (config.fontSize) decls.push(["font-size", FONT_SIZE_MAP[config.fontSize] || "1rem"]);
-		rules.push(rule(selector, decls));
+		rules.push(rule$1(selector, decls));
 	}
 	return rules;
 }
@@ -23161,6 +24218,10 @@ var init_generateButtonCss = __esmMin((() => {
 	init_constants$2();
 	init_generateDefaultButtonSystem();
 	init_affordanceIcons();
+	init_expandPalette();
+	init_foregroundContract();
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
 	AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 	BUTTON_SIZE_NAMES = buttonSizeNameSchema.options;
 	LETTER_SPACING_MAP = {
@@ -23177,23 +24238,51 @@ var init_generateButtonCss = __esmMin((() => {
 		["outline", "none"]
 	];
 }));
-var init_presets = __esmMin((() => {}));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
+var init_presets = __esmMin((() => {
+	init_personalities();
+	buttonPersonalities.map((personality) => ({
+		id: personality.id,
+		name: personality.name,
+		description: personality.description,
+		category: presetCategory(personality),
+		buttonSystem: personality.buttonSystem,
+		compatibility: {
+			...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+			...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+		}
+	}));
+}));
 //#endregion
 //#region ../theme-core/src/buttons/effects/types.ts
-var init_types$12 = __esmMin((() => {}));
-var init_core$2 = __esmMin((() => {}));
+var init_types$11 = __esmMin((() => {}));
+var init_core$2 = __esmMin((() => {
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
+	init_types$14();
+}));
 //#endregion
 //#region ../theme-core/src/buttons/index.ts
 var init_buttons = __esmMin((() => {
 	init_types$14();
 	init_classNames();
 	init_generateButtonCss();
+	init_resolveButtonColourStates();
 	init_affordanceIcons();
 	init_generateDefaultButtonSystem();
 	init_constants$2();
 	init_presets();
 	init_personalities();
-	init_types$12();
+	init_types$11();
 	init_registry$1();
 	init_transform();
 	init_core$2();
@@ -23213,7 +24302,7 @@ function normalizeBoxStylesCardVariant(value) {
 	return normalizeCardVariantRole(value);
 }
 var cardVariantRoleValues, boxlessCardVariantValue, legacyCardVariantRoleAliases, cardSpacingSchema, gradientDirectionSchema, cardVariantRoleSchema, boxStylesCardVariantSchema, cardBackgroundSchema, cardBorderSchema, cardCornerValueSchema, cardAccentEdgeSchema, cardCornerRadiiSchema, cardVariantSchema, cardSystemSchema;
-var init_types$11 = __esmMin((() => {
+var init_types$10 = __esmMin((() => {
 	init_themeColorTokens();
 	cardVariantRoleValues = ["default", "alternative"];
 	boxlessCardVariantValue = "none";
@@ -23429,76 +24518,6 @@ function generateDefaultCardSystem(theme) {
 }
 var init_generateDefaultCardSystem = __esmMin((() => {}));
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-var SURFACE_FOREGROUND_ROLES;
-var init_foregroundRoles = __esmMin((() => {
-	SURFACE_FOREGROUND_ROLES = [
-		"text",
-		"heading",
-		"link",
-		"supporting"
-	];
-}));
-//#endregion
-//#region ../theme-core/src/surfaces/foregroundContract.ts
-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]}`)];
-}
-var SURFACE_FOREGROUND_CSS_VARS, DEFAULT_SURFACE_TEXT_COLOR, DEFAULT_SURFACE_LINK_COLOR, DEFAULT_SURFACE_SUPPORTING_COLOR, DEFAULT_ROLE_FALLBACKS;
-var init_foregroundContract = __esmMin((() => {
-	init_foregroundRoles();
-	SURFACE_FOREGROUND_CSS_VARS = {
-		text: "--rb-surface-text-color",
-		heading: "--rb-surface-heading-color",
-		link: "--rb-surface-link-color",
-		supporting: "--rb-surface-supporting-color"
-	};
-	DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
-	DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
-	DEFAULT_SURFACE_SUPPORTING_COLOR = "rgb(var(--tb-mutedText, 100 116 139))";
-	DEFAULT_ROLE_FALLBACKS = {
-		text: DEFAULT_SURFACE_TEXT_COLOR,
-		heading: DEFAULT_SURFACE_TEXT_COLOR,
-		link: DEFAULT_SURFACE_LINK_COLOR,
-		supporting: DEFAULT_SURFACE_SUPPORTING_COLOR
-	};
-}));
-//#endregion
 //#region ../theme-core/src/surfaces/index.ts
 var init_surfaces = __esmMin((() => {
 	init_foregroundContract();
@@ -23631,7 +24650,7 @@ var init_core$1 = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/cards/index.ts
 var init_cards = __esmMin((() => {
-	init_types$11();
+	init_types$10();
 	init_constants$1();
 	init_generateCardCss();
 	init_generateDefaultCardSystem();
@@ -23640,7 +24659,7 @@ var init_cards = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/accordions/types.ts
 var accordionIconSchema, accordionSystemSchema, ICON_CONFIG, ICON_SIZE_PX, ACCORDION_SPACING_MAP, ACCORDION_TRIGGER_FONT_SCALE, ACCORDION_TRIGGER_LETTER_SPACING, ACCORDION_OPEN_ACCENT_THICKNESS;
-var init_types$10 = __esmMin((() => {
+var init_types$9 = __esmMin((() => {
 	init_themeColorTokens();
 	accordionIconSchema = z$1.enum([
 		"plus-minus",
@@ -23797,7 +24816,7 @@ var init_types$10 = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/inputs/types.ts
 var inputSystemSchema, INPUT_SPACING_MAP, INPUT_FONT_SIZE_MAP, LABEL_FONT_SIZE_MAP, FONT_WEIGHT_MAP;
-var init_types$9 = __esmMin((() => {
+var init_types$8 = __esmMin((() => {
 	init_themeColorTokens();
 	inputSystemSchema = z$1.object({
 		base: z$1.object({
@@ -23916,31 +24935,6 @@ var init_types$9 = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
-var init_types$8 = __esmMin((() => {
-	init_themeColorTokens();
-	gradientStopSchema = z$1.object({
-		color: themeColorTokenSchema,
-		position: z$1.number().min(0).max(100)
-	});
-	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-	gradientConfigSchema = z$1.object({
-		type: z$1.enum([
-			"linear",
-			"radial",
-			"conic"
-		]).default("linear"),
-		angle: z$1.number().min(0).max(360).optional(),
-		shape: radialGradientShapeSchema.optional(),
-		position: z$1.string().optional(),
-		stops: z$1.array(gradientStopSchema).min(2)
-	});
-}));
-//#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
 /**
 * Shared Base Schemas for Interactive Elements
@@ -24612,9 +25606,9 @@ var init_schema = __esmMin((() => {
 	init_media$2();
 	init_buttons();
 	init_cards();
-	init_types$10();
 	init_types$9();
 	init_types$8();
+	init_types$12();
 	init_types$7();
 	init_validation$2();
 	init_atRuleValidation();
@@ -25619,6 +26613,21 @@ var init_designState = __esmMin((() => {
 		styleAuthorities: z$1.array(blockRuntimeStyleAuthoritySchema)
 	}).strict();
 }));
+//#endregion
+//#region ../theme-core/src/site-styles/runtimeCompiler.ts
+function defineSectionForegroundRuntimeTokens(input) {
+	return {
+		textColor: requireThemeColorToken(input.textColor),
+		headingColor: requireThemeColorToken(input.headingColor),
+		linkColor: requireThemeColorToken(input.linkColor),
+		supportingColor: requireThemeColorToken(input.supportingColor)
+	};
+}
+function requireThemeColorToken(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) throw new Error(`Invalid section foreground Theme color token: ${String(value)}`);
+	return token;
+}
 function defineDesignRuntimeRules(rules) {
 	return rules;
 }
@@ -25644,6 +26653,8 @@ var init_runtimeCompiler = __esmMin((() => {
 	init_types$17();
 	init_accessibleSurfaces();
 	init_sectionTransitions();
+	init_tokens();
+	init_gradients();
 	defaultDesignRuntimeRules = defineDesignRuntimeRules({
 		sectionSurfaces: {
 			base: {},
@@ -26042,13 +27053,14 @@ function inferHeaderCurationFromLegacyLooks(lookIds, recipes) {
 function getCuratedSiteStyle(id) {
 	return curatedSiteStylesById.get(id) ?? null;
 }
-var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles, curatedSiteStylesById;
+var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, primaryGlowGradientPresetId, fulcrumDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles, curatedSiteStylesById;
 var init_curatedSiteStyles = __esmMin((() => {
 	init_personalities();
 	init_curated();
 	init_siteStyleDefaults$1();
 	init_siteStyleDefaults();
 	init_testimonialQuotePresets();
+	init_gradients();
 	init_headerLooks();
 	init_footerLooks();
 	init_curatedChoices();
@@ -26116,24 +27128,24 @@ var init_curatedSiteStyles = __esmMin((() => {
 					type: "color",
 					color: "muted"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"brand-depth-band": {
 				background: {
 					type: "color",
 					color: "primary-800"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"hero-image": {
 				background: {
@@ -26141,12 +27153,32 @@ var init_curatedSiteStyles = __esmMin((() => {
 					opacity: 1,
 					position: "center center"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
+			}
+		}
+	});
+	primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+	if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+	fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+		...defaultDesignRuntimeRules,
+		sectionSurfaces: {
+			...defaultDesignRuntimeRules.sectionSurfaces,
+			"accent-band": {
+				background: {
+					type: "gradient",
+					gradientPresetId: primaryGlowGradientPresetId
+				},
+				foreground: defineSectionForegroundRuntimeTokens({
+					textColor: "primaryForeground",
+					headingColor: "primaryForeground",
+					linkColor: "primaryForeground",
+					supportingColor: "primaryForeground"
+				})
 			}
 		}
 	});
@@ -27323,6 +28355,8 @@ var init_curatedSiteStyles = __esmMin((() => {
 			},
 			compositionBudget: quietBudget,
 			typography: fulcrumTypography,
+			designRuntimeRules: fulcrumDesignRuntimeRules,
+			recommendedAppearancePresetIds: ["cta-accent-band"],
 			themeOverrides: {
 				shadow: { colorToken: "primary" },
 				accordions: {
@@ -30927,9 +31961,15 @@ var init_button = __esmMin((() => {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -30938,11 +31978,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 var init_ctas = __esmMin((() => {
@@ -31004,6 +32041,7 @@ var init_heroCtaRow = __esmMin((() => {
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -31082,7 +32120,7 @@ var init_ctaCopy = __esmMin((() => {
 			eyebrowPath: "content.eyebrow",
 			titlePath: "content.title",
 			className: "cta-heading"
-		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 	});
 }));
 //#endregion
@@ -33484,6 +34522,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,
@@ -33640,6 +34679,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -33917,6 +34957,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -34106,6 +35147,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -34165,6 +35207,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",
@@ -34468,6 +35514,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",
@@ -34514,6 +35564,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -34551,6 +35602,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -34941,6 +35993,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -35008,6 +36061,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 },
@@ -35218,6 +36272,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -36961,6 +38016,7 @@ const siteHeaderBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -37174,6 +38230,7 @@ const siteFooterBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	layout: section$1({
 		background: "background",
@@ -37332,6 +38389,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -37496,6 +38554,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -37736,6 +38795,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -38030,6 +39090,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -38422,6 +39483,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -38830,6 +39892,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -39000,6 +40063,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -40751,6 +41815,7 @@ var init_event_registration_interactive = __esmMin((() => {
 init_builder$1();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared$4();
 init_shop_shared();
@@ -40765,6 +41830,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -40871,15 +41937,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"
@@ -40892,9 +41952,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -41301,6 +42360,7 @@ var init_course_registration_interactive = __esmMin((() => {
 init_builder$1();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared$3();
 init_defineBlock();
@@ -41313,6 +42373,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -41426,15 +42487,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"
@@ -41447,9 +42502,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -41527,6 +42581,7 @@ var init_event_details = __esmMin((() => {
 		titleSource: "heading",
 		description: "Date/time, venue, map, and other dates for an event",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"venue",
@@ -41741,6 +42796,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -42040,6 +43096,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -45036,6 +46093,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -46298,6 +47356,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -46705,6 +47764,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",
@@ -47345,7 +48405,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -47398,6 +48461,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -47573,6 +48637,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -48065,6 +49130,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -48723,6 +49789,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -48928,6 +49995,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",
@@ -49017,6 +50085,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",
@@ -50233,6 +51302,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -50442,6 +51512,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -50593,6 +51664,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -50718,6 +51790,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -50809,6 +51882,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -51048,6 +52122,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -51429,6 +52504,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -51616,6 +52692,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -52065,6 +53142,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",
@@ -53076,216 +54154,6 @@ function getBlockDefinition(name) {
 //#region ../blocks/src/system/theme/index.ts
 init_tokens();
 //#endregion
-//#region ../theme-core/src/gradients/presets.ts
-/**
-* Curated library of gradient presets
-* All gradients use theme color tokens, so they adapt to the site's palette
-*/
-const GRADIENT_PRESETS = [
-	{
-		id: "primary-secondary",
-		name: "Primary to Secondary",
-		description: "Blend your primary and secondary brand colors",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "secondary-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-accent",
-		name: "Primary to Accent",
-		description: "Energetic gradient from primary to accent",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-accent",
-		name: "Secondary to Accent",
-		description: "Vibrant secondary to accent blend",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-light-dark",
-		name: "Primary Light to Dark",
-		description: "Subtle primary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-dark-light",
-		name: "Primary Dark to Light",
-		description: "Reverse primary fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-900",
-			position: 0
-		}, {
-			color: "primary-50",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-light-dark",
-		name: "Secondary Light to Dark",
-		description: "Subtle secondary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "secondary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-light-dark",
-		name: "Accent Light to Dark",
-		description: "Accent color depth fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "background-surface",
-		name: "Background to Surface",
-		description: "Subtle depth using base colors",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "background",
-			position: 0
-		}, {
-			color: "surface",
-			position: 100
-		}]
-	},
-	{
-		id: "neutral-fade",
-		name: "Neutral Gradient",
-		description: "Elegant neutral color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "neutral-900",
-			position: 0
-		}, {
-			color: "neutral-50",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-radial",
-		name: "Primary Spotlight",
-		description: "Radial primary gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-radial",
-		name: "Accent Spotlight",
-		description: "Radial accent gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-secondary-accent",
-		name: "Brand Trio",
-		description: "All three brand colors in harmony",
-		type: "linear",
-		angle: 135,
-		stops: [
-			{
-				color: "primary-500",
-				position: 0
-			},
-			{
-				color: "secondary-500",
-				position: 50
-			},
-			{
-				color: "accent-500",
-				position: 100
-			}
-		]
-	}
-];
-//#endregion
-//#region ../theme-core/src/gradients/utils.ts
-/**
-* Convert a GradientConfig to a CSS gradient string
-*
-* @param config - The gradient configuration using theme tokens
-* @param tokens - Map of theme color tokens to hex values
-* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
-*/
-function gradientToCss(config, tokens) {
-	const stops = config.stops.map((stop) => {
-		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
-	}).join(", ");
-	const type = config.type ?? "linear";
-	if (type === "radial") {
-		const position = config.position ?? "center";
-		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
-	}
-	if (type === "conic") {
-		const position = config.position ?? "center";
-		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
-	}
-	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
-}
-//#endregion
-//#region ../theme-core/src/gradients/index.ts
-init_types$8();
-//#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 init_media$1();
 function resolveBackgroundMedia(input) {
@@ -53307,6 +54175,7 @@ function backgroundVideoMobileClassNames(input) {
 //#endregion
 //#region ../blocks/src/system/transforms/registry/background.ts
 init_background$1();
+init_gradients();
 init_themeColorResolution();
 init_surfaceForegroundStyles();
 init_media();
@@ -53328,9 +54197,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString$2(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 = [
@@ -54436,7 +55305,7 @@ function getSocialIconComponent(value) {
 }
 //#endregion
 //#region ../blocks/src/system/icons/registry.ts
-init_presets$1();
+init_presets$2();
 function buildSearchText(parts) {
 	return parts.map((part) => part.trim()).filter(Boolean).join(" ");
 }
@@ -54654,7 +55523,7 @@ const IconNode = ({ value, title, className, blockId: _blockId, blockKind: _bloc
 };
 //#endregion
 //#region ../blocks/src/system/icons/index.ts
-init_presets$1();
+init_presets$2();
 init_svg();
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/feature-card-icon.tsx
@@ -55157,7 +56026,7 @@ function normalizeBoolean$1(value) {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/accordionIconTreatment.ts
-init_types$10();
+init_types$9();
 init_colorStyles();
 function resolveAccordionIconStyle(iconStyle, iconTreatment) {
 	if (iconTreatment) switch (iconTreatment.iconSet) {
@@ -55189,7 +56058,7 @@ init_clsx();
 init_RichText();
 init_richText_coerce();
 init_svg();
-init_types$10();
+init_types$9();
 /**
 * Lookup map for accordion icons - only these 6 icons are bundled
 */
@@ -61883,7 +62752,7 @@ function parseBorderWidth(widthClass) {
 }
 //#endregion
 //#region ../theme-core/src/accordions/generateAccordionCss.ts
-init_types$10();
+init_types$9();
 init_constants$1();
 init_colorStyles();
 init_surfaces();
@@ -62068,7 +62937,7 @@ function generateAccordionCss({ themeId, theme, accordionSystem }) {
 }
 //#endregion
 //#region ../theme-core/src/inputs/generateInputCss.ts
-init_types$9();
+init_types$8();
 init_constants$2();
 init_colorStyles();
 /**
@@ -65005,6 +65874,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),
@@ -73689,6 +74560,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)
  *
@@ -79269,6 +80145,8 @@ function ResponsiveScope({ children, responsiveMode = DEFAULT_THEME_RESPONSIVE_M
 * always emitting the structural CSS contract system blocks rely on.
 */
 init_colorConversion();
+init_textColor();
+init_onColor();
 init_core$2();
 init_core$1();
 z$1.object({
@@ -79717,6 +80595,7 @@ init_RichText();
 * behavior of the default declarative block system.
 */
 init_clsx();
+init_gradients();
 init_background$1();
 init_media();
 //#endregion
@@ -79746,6 +80625,7 @@ Array.from(new Set(systemCustomizeFacetDefinitions.flatMap((definition) => defin
 //#region ../blocks/src/system/customize/backgrounds.ts
 init_src$3();
 init_site_styles();
+init_gradients();
 const backgroundColorTokenNames = backgroundAppearanceColorTokenNames;
 const backgroundColorTokenNameSet = new Set(backgroundColorTokenNames);
 const backgroundColorTokens = toBackgroundColorTokens(backgroundColorTokenNames);
@@ -79766,18 +80646,17 @@ function parseBackgroundColorToken(value) {
 	if (!token) return null;
 	return token ? token : null;
 }
-const gradientPresetIds = GRADIENT_PRESETS.map((preset) => preset.id);
-new Set(gradientPresetIds);
 //#endregion
 //#region ../blocks/src/index.ts
 init_palette$1();
 init_generateShades();
-init_utils$5();
+init_utils$6();
 init_schema();
 init_site_styles();
 init_buttons();
 init_cards();
 init_tokens();
+init_gradients();
 init_richTextSchema();
 init_media();
 init_media$1();
@@ -80472,6 +81351,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -80484,7 +81364,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
@@ -80497,7 +81382,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];
@@ -159337,7 +160225,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.108.0";
+const SDK_VERSION = "0.109.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;