@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/server/next.mjs

@@ -6329,6 +6329,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",
@@ -7447,19 +7482,29 @@ function isRecord$33(value) {
 //#region ../core/src/booking-date-time.ts
 const DEFAULT_LOCALE = "en-US";
 const FALLBACK_TIMEZONE = "UTC";
+const DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+const dateTimeFormatterCache = /* @__PURE__ */ new Map();
+const timeZoneValidityCache = /* @__PURE__ */ new Map();
 function isValidTimeZone$1(timeZone) {
+	const cached = timeZoneValidityCache.get(timeZone);
+	if (cached !== void 0) return cached;
+	let isValid;
 	try {
 		new Intl.DateTimeFormat(DEFAULT_LOCALE, { timeZone }).format(/* @__PURE__ */ new Date());
-		return true;
+		isValid = true;
 	} catch {
-		return false;
+		isValid = false;
 	}
+	if (timeZoneValidityCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) timeZoneValidityCache.clear();
+	timeZoneValidityCache.set(timeZone, isValid);
+	return isValid;
 }
 function getSafeTimeZone(timeZone) {
 	const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
 	return normalized.length > 0 && isValidTimeZone$1(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone$1(normalized)) return null;
 	return normalized;
@@ -7472,10 +7517,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, {
@@ -7521,23 +7575,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,
@@ -7546,6 +7586,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);
@@ -7584,10 +7639,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",
@@ -8025,7 +8077,8 @@ function validateRelativeStoragePath(value) {
 	if (value.startsWith("sites/")) return fail({ tag: "SITE_SCOPED_PATH" });
 	if (value.startsWith("/")) return fail({ tag: "LEADING_SLASH" });
 	if (value.includes("//")) return fail({ tag: "DOUBLE_SLASH" });
-	if (value.split("/").some((segment) => segment === "..")) return fail({ tag: "TRAVERSAL" });
+	if (value.includes("%")) return fail({ tag: "PERCENT_ENCODING" });
+	if (value.split("/").some((segment) => segment === "." || segment === "..")) return fail({ tag: "TRAVERSAL" });
 	return ok$2(value);
 }
 function brandRelativeStoragePath(value) {
@@ -9342,6 +9395,20 @@ const blockCategoryEnum = z$1.enum([
 	"layout",
 	"interactive"
 ]);
+const blockContentSourceSchema = z$1.object({
+	kind: z$1.enum([
+		"inline",
+		"entries",
+		"mixed"
+	]),
+	contentType: z$1.string().min(1).optional()
+}).superRefine((value, ctx) => {
+	if (value.kind === "inline" && value.contentType) ctx.addIssue({
+		code: z$1.ZodIssueCode.custom,
+		path: ["contentType"],
+		message: "contentType is not allowed when contentSource.kind is \"inline\""
+	});
+});
 z$1.object({
 	name: z$1.string().min(1),
 	version: z$1.string().min(1),
@@ -9372,6 +9439,12 @@ z$1.object({
 	}).optional()).optional(),
 	category: blockCategoryEnum.optional(),
 	contentTypes: z$1.array(z$1.string()).optional(),
+	/**
+	* Explicit content-source classification (inline / entries / mixed). Optional at the
+	* schema level for backward compatibility with SDK-defined custom blocks, but every
+	* registered SYSTEM block must declare it (enforced by a registry-wide test).
+	*/
+	contentSource: blockContentSourceSchema.optional(),
 	tags: z$1.array(z$1.string()).optional(),
 	icon: z$1.string().optional()
 });
@@ -10915,7 +10988,7 @@ function normalizeStoredObjectChildren(children, value, ctx) {
 	return normalized;
 }
 function normalizeStoredRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$2(value)) return value;
+	if (!isUnknownArray$3(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -10974,7 +11047,7 @@ function getAtFieldPath(source, path) {
 	}, source);
 }
 function normalizeRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$2(value)) return value;
+	if (!isUnknownArray$3(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -11002,7 +11075,7 @@ function validateNormalizedFieldValue(plan, value, ctx) {
 		case "select": return validateSelectPlan(plan, value);
 		case "richText": return isValidRichTextDoc(value) ? [] : [issue(plan, "invalidRichText")];
 		case "inlineText": return validateInlineTextPlan(plan, value);
-		case "media": return isPlainObject$4(value) ? [] : [issue(plan, "invalidMedia")];
+		case "media": return isPlainObject$5(value) ? [] : [issue(plan, "invalidMedia")];
 		case "link": return linkSchema.safeParse(value).success ? [] : [issue(plan, "invalidLink")];
 		case "repeater": return validateRepeaterPlan(plan, value, ctx);
 		case "group": return validateGroupPlan(plan, value, ctx);
@@ -11095,7 +11168,7 @@ function validateRepeaterPlan(plan, value, ctx) {
 	}), ...value.flatMap((item, index) => validateRepeaterItem(plan, item, index, ctx))];
 }
 function validateRepeaterItem(plan, item, index, ctx) {
-	if (!isPlainObject$4(item)) return [];
+	if (!isPlainObject$5(item)) return [];
 	const itemType = item._type;
 	const fields = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === itemType)?.fields : plan.repeatedItemPlan;
 	if (!fields) return [];
@@ -11104,7 +11177,7 @@ function validateRepeaterItem(plan, item, index, ctx) {
 	});
 }
 function validateGroupPlan(plan, value, ctx) {
-	if (!isPlainObject$4(value)) return [issue(plan, "wrongType", { expected: "an object" })];
+	if (!isPlainObject$5(value)) return [issue(plan, "wrongType", { expected: "an object" })];
 	const childCtx = childValidationContext(plan, ctx);
 	return plan.children.flatMap((childPlan) => validateNormalizedFieldValue(childPlan, value[childPlan.fieldId], childCtx));
 }
@@ -11301,7 +11374,7 @@ function sameFieldPath(left, right) {
 	return left.length === right.length && left.every((segment, index) => segment === right[index]);
 }
 function validateExplicitNullsForPush(plans, content, ctx) {
-	if (!isPlainObject$4(content)) return [];
+	if (!isPlainObject$5(content)) return [];
 	return plans.flatMap((plan) => validateExplicitNullForPushPlan(plan, content[plan.fieldId], ctx));
 }
 function validateExplicitNullForPushPlan(plan, value, ctx) {
@@ -11322,9 +11395,9 @@ function validateExplicitNullForPushPlan(plan, value, ctx) {
 	}
 }
 function validateExplicitNullsForPushRepeater(plan, value, ctx) {
-	if (!isUnknownArray$2(value)) return [];
+	if (!isUnknownArray$3(value)) return [];
 	return value.flatMap((item, index) => {
-		if (!isPlainObject$4(item)) return [];
+		if (!isPlainObject$5(item)) return [];
 		const childPlans = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === item._type)?.fields : plan.repeatedItemPlan;
 		if (!childPlans) return [];
 		return childPlans.flatMap((childPlan) => validateExplicitNullForPushPlan(materializeRepeaterItemPlan(childPlan, plan.path, index), item[childPlan.fieldId], ctx));
@@ -11407,19 +11480,19 @@ function isEmptyValue$1(value) {
 	if (isEmptyRichTextDoc(value)) return true;
 	return false;
 }
-function isPlainObject$4(value) {
+function isPlainObject$5(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isUnknownArray$2(value) {
+function isUnknownArray$3(value) {
 	return Array.isArray(value);
 }
 function isValidRichTextDoc(value) {
 	const doc = richTextDoc(value);
-	return Boolean(isPlainObject$4(doc) && doc.type === "doc");
+	return Boolean(isPlainObject$5(doc) && doc.type === "doc");
 }
 function isEmptyRichTextDoc(value) {
 	const doc = richTextDoc(value);
-	if (!isPlainObject$4(doc)) return false;
+	if (!isPlainObject$5(doc)) return false;
 	if (doc.type !== "doc") return false;
 	const content = doc.content;
 	if (!Array.isArray(content) || content.length === 0) return true;
@@ -11428,8 +11501,8 @@ function isEmptyRichTextDoc(value) {
 	return first?.type === "paragraph" && (!Array.isArray(first.content) || first.content.length === 0);
 }
 function richTextDoc(value) {
-	if (!isPlainObject$4(value)) return value;
-	return isPlainObject$4(value.doc) ? value.doc : value;
+	if (!isPlainObject$5(value)) return value;
+	return isPlainObject$5(value.doc) ? value.doc : value;
 }
 //#endregion
 //#region ../blocks/src/system/manifest/registry.ts
@@ -11497,7 +11570,7 @@ function resolveVariantKey(manifest, content) {
 const clamp01$3 = (x) => Math.max(0, Math.min(1, x));
 const mod = (a, n) => (a % n + n) % n;
 const deg = (x) => mod(x, 360);
-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");
@@ -11606,7 +11679,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);
@@ -11633,8 +11706,8 @@ 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];
@@ -12656,6 +12729,10 @@ const modernMinimalTheme = {
 				name: "primary",
 				hex: "#1f2937"
 			},
+			{
+				name: "primaryForeground",
+				hex: "#ffffff"
+			},
 			{
 				name: "secondary",
 				hex: "#6b7280"
@@ -12684,6 +12761,14 @@ const modernMinimalTheme = {
 				name: "surface",
 				hex: "#ffffff"
 			},
+			{
+				name: "surfaceAlt",
+				hex: "#f9fafb"
+			},
+			{
+				name: "muted",
+				hex: "#f3f4f6"
+			},
 			{
 				name: "text",
 				hex: "#1f2937"
@@ -12792,7 +12877,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;
@@ -12859,7 +12944,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])),
@@ -16083,6 +16168,111 @@ function boundaryKey$1(previousBlockId, nextBlockId) {
 	return makeBoundaryId(previousBlockId, nextBlockId);
 }
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+/**
+* Exhaustive live policy for every registered effect id.
+*
+* The resolver consumes the transition payload directly, so adding an effect
+* cannot update classification without also defining its runtime behavior.
+*/
+const BUTTON_EFFECT_POLICIES = {
+	"darken-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "darker"
+		}
+	},
+	"lighten-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "lighter"
+		}
+	},
+	"background-on-hover": {
+		classification: "colour-transition",
+		transition: { kind: "replace-background" }
+	},
+	"background-on-hover-alpha": {
+		classification: "unsupported-colour",
+		reason: "alpha_requires_surface"
+	},
+	"fade-background": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"opacity-reduce": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"gradient-text": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"text-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"border-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_border"
+	},
+	"aurora-glow": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"cosmic-stardust": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"animated-gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"nav-underline": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-base": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-hover": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-active": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"animated-gradient": { classification: "non-colour" },
+	"border-glow": { classification: "non-colour" },
+	"drop-shadow": { classification: "non-colour" },
+	"inner-shadow": { classification: "non-colour" },
+	"neumorphic-shadow": { classification: "non-colour" },
+	"outer-glow": { classification: "non-colour" },
+	"retro-3d-shadow": { classification: "non-colour" },
+	"scale-up": { classification: "non-colour" },
+	"scale-down": { classification: "non-colour" },
+	lift: { classification: "non-colour" },
+	"press-down": { classification: "non-colour" },
+	pop: { classification: "non-colour" },
+	"border-bottom-grow": { classification: "non-colour" },
+	"sketchy-border": { classification: "non-colour" },
+	"pulse-animation": { classification: "non-colour" }
+};
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 /**
 * Standard semantic variant roles a theme exposes.
@@ -16112,6 +16302,20 @@ function asSpecialVariantId(value) {
 * Shared between generator and renderer so neither side hard-codes the string.
 */
 const DEFAULT_VARIANT_ALIAS_ID = "default";
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+const opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+	const token = parseOpaqueButtonColourToken(value);
+	if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+	return token;
+});
 const cornerStyleSchema = z$1.enum([
 	"square",
 	"rounded",
@@ -16213,7 +16417,7 @@ const buttonSizesSchema = z$1.object({
 	lg,
 	xl: xl ?? lg
 }));
-const buttonGlobalSettingsSchema = z$1.object({
+const canonicalButtonGlobalSettingsSchema = z$1.object({
 	cornerStyle: cornerStyleSchema,
 	cornerRadius: z$1.number().min(0).max(24).optional(),
 	/**
@@ -16244,11 +16448,12 @@ const buttonGlobalSettingsSchema = z$1.object({
 	paddingPreset: buttonPaddingPresetSchema.optional(),
 	hoverTransform: hoverTransformSchema,
 	hoverColor: hoverColorSchema,
-	hoverColorToken: themeColorTokenSchema.optional(),
+	hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 	gradientStyle: gradientStyleSchema.optional(),
 	gradientAngle: z$1.number().min(0).max(360).optional(),
 	gradientSharpness: gradientSharpnessSchema.optional()
 });
+const buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 const gradientDirectionSchema$1 = z$1.enum([
 	"to-r",
 	"to-l",
@@ -16262,27 +16467,33 @@ const gradientDirectionSchema$1 = z$1.enum([
 const buttonBackgroundSchema = z$1.discriminatedUnion("type", [
 	z$1.object({
 		type: z$1.literal("solid"),
-		colorToken: themeColorTokenSchema
+		colorToken: opaqueButtonColourTokenSchema
 	}),
 	z$1.object({
 		type: z$1.literal("gradient"),
-		stops: z$1.array(themeColorTokenSchema).min(2),
-		direction: gradientDirectionSchema$1
+		stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+			const [first, second, ...rest] = stops;
+			if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+			return [
+				first,
+				second,
+				...rest
+			];
+		}),
+		direction: gradientDirectionSchema$1,
+		foregroundToken: opaqueButtonColourTokenSchema
 	}),
-	z$1.object({ type: z$1.literal("transparent") })
+	z$1.object({
+		type: z$1.literal("surface"),
+		role: z$1.literal("link")
+	})
 ]);
 const effectApplicationSchema$1 = z$1.object({
 	effectId: z$1.string(),
-	options: z$1.record(z$1.string(), z$1.any()).optional()
-});
-const buttonBorderSchema = z$1.object({
-	widthClass: z$1.string(),
-	colorToken: themeColorTokenSchema
-});
-const buttonVariantAffordanceSchema = z$1.object({
-	iconId: z$1.string().min(1),
-	colorToken: themeColorTokenSchema.optional()
+	options: z$1.record(z$1.string(), z$1.json()).optional()
 });
+const buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+const buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 const variantShadowSchema = z$1.object({
 	elevation: z$1.enum([
 		"none",
@@ -16323,27 +16534,170 @@ const variantSizeOverridesSchema = z$1.object({
 * default (e.g. link-style variants declaring zero horizontal padding at
 * every size).
 */
-const buttonVariantSchema = z$1.object({
+const canonicalButtonVariantSchema = z$1.object({
 	id: z$1.string(),
 	name: z$1.string().min(1).max(20),
 	enabled: z$1.boolean(),
 	priority: prioritySchema,
 	background: buttonBackgroundSchema,
-	textColorToken: themeColorTokenSchema,
 	/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 	borderRadius: z$1.string().optional(),
 	shadow: variantShadowSchema.optional(),
 	border: buttonBorderSchema.optional(),
-	hoverBackgroundToken: z$1.string().optional(),
+	hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 	effects: variantEffectsSchema.optional(),
 	sizes: variantSizeOverridesSchema.optional(),
 	affordance: buttonVariantAffordanceSchema.optional()
 });
+/**
+* Temporary persisted-theme admission boundary for issue #1206.
+*
+* Production inventory on 2026-07-22 found 22 rows using the old independent
+* `textColorToken`/border colour shape. New source and all downstream code use
+* only the canonical relationship. Delete this preprocessor after the reviewed
+* production rewrite reports zero legacy rows.
+*/
+const buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 const buttonSystemSchema = z$1.object({
 	global: buttonGlobalSettingsSchema,
 	variants: z$1.array(buttonVariantSchema).min(1).max(6),
 	sizes: buttonSizesSchema.optional()
 });
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray$2(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$2(value) {
+	return Array.isArray(value);
+}
 //#endregion
 //#region ../theme-core/src/buttons/personalities/types.ts
 function asButtonPersonalityId(value) {
@@ -16369,7 +16723,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 //#endregion
@@ -16422,19 +16776,15 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["primary", "accent"],
-					direction: "to-r"
+					direction: "to-r",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "secondary",
@@ -16444,32 +16794,27 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["secondary", "accent"],
-					direction: "to-br"
+					direction: "to-br",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "outline",
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -16480,8 +16825,10 @@ const brushedWash = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-lg",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -16527,7 +16874,6 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				shadow: {
 					elevation: "medium",
@@ -16537,7 +16883,7 @@ const confidentChip = defineButtonPersonality({
 				effects: {
 					hover: [{
 						effectId: "darken-background",
-						options: { amount: 60 }
+						options: { amount: 100 }
 					}],
 					active: [{
 						effectId: "scale-down",
@@ -16554,12 +16900,8 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "surface"
 				},
-				textColorToken: "text",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -16570,13 +16912,12 @@ const confidentChip = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -16587,8 +16928,10 @@ const confidentChip = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-md",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -16651,7 +16994,6 @@ const earthPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -16677,13 +17019,12 @@ const earthPill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -16694,13 +17035,12 @@ const earthPill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surfaceAlt" }
@@ -16711,8 +17051,10 @@ const earthPill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "none",
@@ -16733,11 +17075,7 @@ const earthPill = defineButtonPersonality({
 						padding: "0.625rem 0",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 25 }
-				}] }
+				}
 			}
 		]
 	}
@@ -16773,8 +17111,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Primary",
 				enabled: true,
 				priority: 1,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -16796,8 +17136,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -16819,8 +17161,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -16842,19 +17186,17 @@ const editorialLink = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
 					md: { padding: "0.5rem 0" },
 					lg: { padding: "0.625rem 0" },
 					xl: { padding: "0.75rem 0" }
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -20 }
-				}] }
+				}
 			}
 		]
 	}
@@ -16916,12 +17258,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accent"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -16935,13 +17273,12 @@ const flatInk = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -16959,12 +17296,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "accent"
 				},
-				textColorToken: "accentForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accentForeground"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -17027,7 +17360,6 @@ const inkStamp = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				effects: {
 					hover: [{
@@ -17048,13 +17380,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17065,13 +17396,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17082,8 +17412,10 @@ const inkStamp = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -17176,7 +17508,6 @@ const joyStamp = defineButtonPersonality({
 				type: "solid",
 				colorToken: "primary"
 			},
-			textColorToken: "primaryForeground",
 			borderRadius: "rounded-full",
 			shadow: {
 				elevation: "high",
@@ -17190,13 +17521,12 @@ const joyStamp = defineButtonPersonality({
 			name: "Secondary",
 			enabled: true,
 			priority: 2,
-			background: { type: "transparent" },
-			textColorToken: "text",
-			borderRadius: "rounded-full",
-			border: {
-				widthClass: "border-2",
-				colorToken: "text"
+			background: {
+				type: "surface",
+				role: "link"
 			},
+			borderRadius: "rounded-full",
+			border: { widthClass: "border-2" },
 			shadow: {
 				elevation: "high",
 				softness: "hard",
@@ -17261,12 +17591,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: {
 					hover: [{
 						effectId: "background-on-hover",
@@ -17287,12 +17613,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17303,13 +17625,12 @@ const ornateRitual = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -17320,8 +17641,10 @@ const ornateRitual = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -17403,14 +17726,10 @@ const pebble = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 88
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -17418,13 +17737,12 @@ const pebble = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "accent"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "accent" }
@@ -17435,13 +17753,12 @@ const pebble = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17452,8 +17769,10 @@ const pebble = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				sizes: {
 					sm: {
@@ -17469,11 +17788,7 @@ const pebble = defineButtonPersonality({
 						padding: "0.75rem 1.5rem",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 30 }
-				}] }
+				}
 			}
 		]
 	}
@@ -17535,15 +17850,11 @@ const quietArrow = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-xl",
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 90
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -17551,13 +17862,12 @@ const quietArrow = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-xl",
+				border: { widthClass: "border" },
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -17569,21 +17879,22 @@ const quietArrow = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				}
+				border: { widthClass: "border" }
 			},
 			{
 				id: "ghost",
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl"
 			}
 		]
@@ -17647,7 +17958,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "background",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -17656,13 +17966,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{ effectId: "pop" }] }
 			},
 			{
@@ -17674,7 +17983,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -17687,12 +17995,8 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "background"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17703,13 +18007,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -17720,8 +18023,10 @@ const showtimePill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -17767,7 +18072,6 @@ const softPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -17790,13 +18094,12 @@ const softPill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17807,13 +18110,12 @@ const softPill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -17824,8 +18126,10 @@ const softPill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -17844,9 +18148,8 @@ const solidSecondary = {
 	priority: 2,
 	background: {
 		type: "solid",
-		colorToken: "secondary"
+		colorToken: unsafeAsOpaqueButtonColourToken("secondary")
 	},
-	textColorToken: "onSecondary",
 	borderRadius: "rounded-full",
 	shadow: {
 		elevation: "none",
@@ -18279,6 +18582,282 @@ const serifDisplayQuote = { style: "serif-display" };
 /** Punchy quotation mark in the secondary accent colour. Bold / accent styles. */
 const accentGlyphQuote = { style: "accent-glyph" };
 //#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+/**
+* Gradient color stop
+*/
+const gradientStopSchema = z$1.object({
+	color: themeColorTokenSchema,
+	position: z$1.number().min(0).max(100)
+});
+/**
+* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
+* so existing radial gradients are byte-identical.
+*
+* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
+* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
+*/
+const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+/**
+* Gradient configuration.
+*
+* `type` is optional and defaults to `'linear'` so gradients persisted without a
+* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
+* `'conic'` are additive kinds:
+*   - linear: `angle` (degrees)
+*   - radial: optional `shape` (circle/ellipse) + `position`
+*   - conic:  optional `angle` (from-angle, degrees) + `position`
+*/
+const gradientConfigSchema = z$1.object({
+	type: z$1.enum([
+		"linear",
+		"radial",
+		"conic"
+	]).default("linear"),
+	angle: z$1.number().min(0).max(360).optional(),
+	shape: radialGradientShapeSchema.optional(),
+	position: z$1.string().optional(),
+	stops: z$1.array(gradientStopSchema).min(2)
+});
+/**
+* Curated library of gradient presets.
+* All gradients use theme color tokens, so they adapt to the site's palette.
+*/
+const GRADIENT_PRESETS = [
+	{
+		id: "primary-secondary",
+		name: "Primary to Secondary",
+		description: "Blend your primary and secondary brand colors",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "secondary-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-accent",
+		name: "Primary to Accent",
+		description: "Energetic gradient from primary to accent",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-accent",
+		name: "Secondary to Accent",
+		description: "Vibrant secondary to accent blend",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-light-dark",
+		name: "Primary Light to Dark",
+		description: "Subtle primary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "primary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-dark-light",
+		name: "Primary Dark to Light",
+		description: "Reverse primary fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-50",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-light-dark",
+		name: "Secondary Light to Dark",
+		description: "Subtle secondary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "secondary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "accent-light-dark",
+		name: "Accent Light to Dark",
+		description: "Accent color depth fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "accent-500",
+			position: 0
+		}, {
+			color: "accent-900",
+			position: 100
+		}]
+	},
+	{
+		id: "background-surface",
+		name: "Background to Surface",
+		description: "Subtle depth using base colors",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "background",
+			position: 0
+		}, {
+			color: "surface",
+			position: 100
+		}]
+	},
+	{
+		id: "neutral-fade",
+		name: "Neutral Gradient",
+		description: "Elegant neutral color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "neutral-900",
+			position: 0
+		}, {
+			color: "neutral-50",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-glow",
+		name: "Primary glow",
+		description: "A soft top-centred glow using your primary palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onPrimary900",
+			headingColor: "onPrimary900",
+			linkColor: "onPrimary900",
+			supportingColor: "onPrimary900"
+		}
+	},
+	{
+		id: "accent-glow",
+		name: "Accent glow",
+		description: "A soft top-centred glow using your accent palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "accent-900",
+			position: 0
+		}, {
+			color: "accent-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onAccent900",
+			headingColor: "onAccent900",
+			linkColor: "onAccent900",
+			supportingColor: "onAccent900"
+		}
+	},
+	{
+		id: "primary-secondary-accent",
+		name: "Brand Trio",
+		description: "All three brand colors in harmony",
+		type: "linear",
+		angle: 135,
+		stops: [
+			{
+				color: "primary-500",
+				position: 0
+			},
+			{
+				color: "secondary-500",
+				position: 50
+			},
+			{
+				color: "accent-500",
+				position: 100
+			}
+		]
+	}
+].map((preset) => ({
+	...preset,
+	id: preset.id,
+	stops: preset.stops
+}));
+const GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+const gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+const gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+function getGradientPreset(id) {
+	return gradientPresetById[id];
+}
+//#endregion
+//#region ../theme-core/src/gradients/utils.ts
+/**
+* Convert a GradientConfig to a CSS gradient string
+*
+* @param config - The gradient configuration using theme tokens
+* @param tokens - Map of theme color tokens to hex values
+* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
+*/
+function gradientToCss(config, tokens) {
+	const stops = config.stops.map((stop) => {
+		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
+	}).join(", ");
+	const type = config.type ?? "linear";
+	if (type === "radial") {
+		const position = config.position ?? "center";
+		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
+	}
+	if (type === "conic") {
+		const position = config.position ?? "center";
+		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
+	}
+	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
+}
+//#endregion
 //#region ../theme-core/src/site-styles/logoBranding.ts
 const logoTextConfidenceValues = [
 	"low",
@@ -20600,14 +21179,12 @@ const backgroundOnHoverEffect = {
 		]
 	},
 	generateCSS: (ctx) => {
-		const { themeId, variantId, options, tokens } = ctx;
+		const { themeId, variantId, options, tokens, buttonConfig } = ctx;
 		const colorToken = options.colorToken || "neutral-800";
-		const color = tokens.getColor(colorToken);
-		const textColorToken = typeof options.textColorToken === "string" ? options.textColorToken : null;
 		return `
       /* Add background on hover */
       :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${color};${textColorToken ? `\n        color: ${tokens.getColor(textColorToken)};` : ""}
+        background-color: ${tokens.getColor(colorToken)};${"textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : ""}
       }
     `;
 	}
@@ -20631,10 +21208,10 @@ const backgroundOnHoverAlphaEffect = {
 		default: 50
 	},
 	generateCSS: (ctx) => {
-		const { themeId, variantId, stateGroup, options, buttonConfig } = ctx;
+		const { themeId, variantId, stateGroup, options } = ctx;
 		const rawOpacity = options.opacity;
 		const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
-		const cssVar = `var(--tb-${options.colorToken || buttonConfig.textColorToken || "neutral-800"})`;
+		const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
 		return `
       /* Add semi-transparent background (${stateGroup}) */
       :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
@@ -20847,7 +21424,7 @@ const outerGlowEffect = {
 		const spread = options.spread || 10;
 		let glowColor;
 		if (options.glowColorToken && typeof options.glowColorToken === "string") glowColor = tokens.getColor(options.glowColorToken);
-		else if (buttonConfig.border?.colorToken) glowColor = tokens.getColor(buttonConfig.border.colorToken);
+		else if (buttonConfig.border) glowColor = "colorToken" in buttonConfig.border ? tokens.getColor(buttonConfig.border.colorToken) : "currentColor";
 		else if (buttonConfig.background.type === "solid") glowColor = tokens.getColor(buttonConfig.background.colorToken ?? "primary-400");
 		else glowColor = tokens.getColor("primary-400");
 		return `
@@ -20906,7 +21483,7 @@ const retro3DShadowEffect = {
 /**
 * Map Tailwind-style gradient direction tokens to CSS gradient directions
 */
-const GRADIENT_DIRECTION_MAP$3 = {
+const GRADIENT_DIRECTION_MAP$2 = {
 	"to-r": "to right",
 	"to-l": "to left",
 	"to-t": "to top",
@@ -21836,29 +22413,6 @@ function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elem
 	};
 	return effectPreset.generateCSS(ctx);
 }
-/**
-* Get contrasting text color for a button background
-*
-* This function returns theme-aware text colors using the neutral scale,
-* which is guaranteed to exist in every theme and harmonizes with the design.
-*
-* Uses neutral-50 (lightest) for dark backgrounds and neutral-950 (darkest)
-* for light backgrounds. This ensures excellent contrast while respecting
-* the theme's neutral palette (warm/cool tinting).
-*
-* For solid backgrounds with primary/secondary/neutral colors:
-* - Dark backgrounds (shade >= 500): neutral-50 (very light)
-* - Light backgrounds (shade < 500): neutral-950 (very dark)
-*/
-function getContrastingTextColorToken(backgroundToken, theme) {
-	const isLightTheme = theme.palette.meta.mode === "light";
-	if (backgroundToken.startsWith("primary-") || backgroundToken.startsWith("secondary-")) return "neutral-50";
-	if (backgroundToken.startsWith("neutral-")) {
-		const match = backgroundToken.match(/neutral-(\d+)/);
-		if (match?.[1]) return parseInt(match[1], 10) >= 500 ? "neutral-50" : "neutral-950";
-	}
-	return isLightTheme ? "neutral-50" : "neutral-950";
-}
 //#endregion
 //#region ../theme-core/src/buttons/generateDefaultButtonSystem.ts
 /**
@@ -21916,13 +22470,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",
@@ -21931,51 +22480,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 {
@@ -22031,6 +22568,472 @@ function affordanceIconMaskUrl(iconId) {
 	return `data:image/svg+xml,${`<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'>${paths.map((d) => `<path d='${d}'/>`).join("")}</svg>`.replace(/"/g, "'").replace(/#/g, "%23").replace(/</g, "%3C").replace(/>/g, "%3E").replace(/\s+/g, " ")}`;
 }
 //#endregion
+//#region ../theme-core/src/surfaces/foregroundRoles.ts
+const SURFACE_FOREGROUND_ROLES = [
+	"text",
+	"heading",
+	"link",
+	"supporting"
+];
+//#endregion
+//#region ../theme-core/src/surfaces/foregroundContract.ts
+const SURFACE_FOREGROUND_CSS_VARS = {
+	text: "--rb-surface-text-color",
+	heading: "--rb-surface-heading-color",
+	link: "--rb-surface-link-color",
+	supporting: "--rb-surface-supporting-color"
+};
+const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+const DEFAULT_ROLE_FALLBACKS = {
+	text: DEFAULT_SURFACE_TEXT_COLOR,
+	heading: DEFAULT_SURFACE_TEXT_COLOR,
+	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
+	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
+};
+function requireSurfaceColorValue(role, value) {
+	const normalized = value.trim();
+	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
+	return normalized;
+}
+function completeSurfaceForegrounds(input) {
+	const text = requireSurfaceColorValue("text", input.text);
+	return {
+		text,
+		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
+		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
+	};
+}
+function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
+	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
+	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
+	if (role === "text") return `var(${roleVariable}, ${fallback})`;
+	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
+}
+function surfaceForegroundValueWithOpacity(role, opacityPercent) {
+	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
+	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
+}
+function surfaceForegroundStyle(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return {
+		color: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
+		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
+		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
+	};
+}
+function surfaceForegroundDeclarations(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+const BUTTON_VISUAL_STATES = [
+	"base",
+	"hover",
+	"focus",
+	"active",
+	"disabled"
+];
+const BUTTON_CONTRAST_POLICY = {
+	textMinimumRatio: 4.5,
+	nonTextMinimumRatio: 3,
+	gradientSamplesPerSegment: 20,
+	alphaBackgrounds: "reject-without-known-surface",
+	disabled: "retain-full-colour-contract"
+};
+function compileButtonColourStates(input) {
+	const baseTransition = applyColourEffects({
+		variantId: input.variant.id,
+		state: "base",
+		treatment: input.variant.background,
+		effects: input.variant.effects?.base,
+		palette: input.palette
+	});
+	if (!baseTransition.ok) return baseTransition;
+	const stateTreatments = {
+		base: baseTransition.treatment,
+		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
+		focus: baseTransition.treatment,
+		active: baseTransition.treatment,
+		disabled: baseTransition.treatment
+	};
+	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) {
+		const transition = applyColourEffects({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			effects: input.variant.effects?.[state],
+			palette: input.palette
+		});
+		if (!transition.ok) return transition;
+		stateTreatments[state] = transition.treatment;
+		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
+	}
+	const resolved = {};
+	for (const state of BUTTON_VISUAL_STATES) {
+		const result = resolveTreatment$1({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			palette: input.palette
+		});
+		if (!result.ok) return result;
+		resolved[state] = result.colour;
+	}
+	return {
+		ok: true,
+		states: resolved,
+		focusIndicator: resolveFocusIndicator(resolved.focus),
+		nonColourEffects
+	};
+}
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function hoverTreatment(variant, global, fallback) {
+	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
+	return token === void 0 ? fallback : {
+		type: "solid",
+		colorToken: token
+	};
+}
+function applyColourEffects(input) {
+	let treatment = input.treatment;
+	const nonColourEffects = [];
+	for (const effect of input.effects ?? []) {
+		const policy = getButtonEffectPolicy(effect.effectId);
+		if (policy === null) return unknownEffect(input, effect);
+		switch (policy.classification) {
+			case "non-colour":
+				nonColourEffects.push(effect);
+				break;
+			case "unsupported-colour":
+			case "unsupported-background-overlay":
+			case "not-button": return unsupportedEffect(input, effect, policy.reason);
+			case "colour-transition":
+				if (policy.transition.kind === "adjust-shade") {
+					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
+					const amount = readShadeAmount(effect);
+					if (amount === null) return invalidEffectOption(input, effect, "amount");
+					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
+					treatment = {
+						type: "solid",
+						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
+					};
+					break;
+				}
+				if (policy.transition.kind === "replace-background") {
+					const colorToken = readOpaqueToken(effect, "colorToken", "neutral-800");
+					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
+					treatment = {
+						type: "solid",
+						colorToken
+					};
+					break;
+				}
+				return unknownEffect(input, effect);
+		}
+	}
+	return {
+		ok: true,
+		treatment,
+		nonColourEffects
+	};
+}
+function resolveTreatment$1(input) {
+	const treatment = input.treatment;
+	switch (treatment.type) {
+		case "surface": return {
+			ok: true,
+			colour: {
+				kind: "surface",
+				role: treatment.role,
+				backgroundCss: "transparent",
+				foregroundCss: surfaceForegroundValue(treatment.role)
+			}
+		};
+		case "solid": return resolveSolid(input, treatment.colorToken);
+		case "gradient": return resolveGradient$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)}`;
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolvedButtonCss.ts
+/**
+* Canonical colour declaration mapping shared by full themes and ThemeBridge.
+* Both background properties are always emitted so transitions cannot retain
+* a stale gradient or solid layer.
+*/
+function resolvedButtonColourDeclarations(colour) {
+	switch (colour.kind) {
+		case "solid": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+		case "gradient": return [
+			["background-color", "transparent"],
+			["background-image", colour.backgroundCss],
+			["color", colour.foregroundCss]
+		];
+		case "surface": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+	}
+}
+function resolvedButtonFocusDeclarations(indicator) {
+	return indicator.kind === "two-tone" ? [
+		["outline", `2px solid ${indicator.innerCss}`],
+		["outline-offset", "2px"],
+		["box-shadow", `0 0 0 4px ${indicator.outerCss}`]
+	] : [["outline", `3px solid ${indicator.colorCss}`], ["outline-offset", "3px"]];
+}
+/**
+* Disabled buttons retain their validated colour pair and add a non-layout
+* visual affordance. `currentColor` keeps the cue inside the same contrast
+* relationship, while retaining pointer events lets the not-allowed cursor
+* remain observable.
+*/
+const RESOLVED_BUTTON_DISABLED_DECLARATIONS = [
+	["cursor", "not-allowed"],
+	["transform", "none"],
+	["box-shadow", "none"],
+	["outline", "2px dashed currentColor"],
+	["outline-offset", "-4px"]
+];
+//#endregion
 //#region ../theme-core/src/buttons/generateButtonCss.ts
 /**
 * Class the `button` runtime node adds when it renders its own trailing icon,
@@ -22047,7 +23050,7 @@ const LETTER_SPACING_MAP = {
 	normal: "0",
 	loose: "0.05em"
 };
-function rule(selector, declarations) {
+function rule$1(selector, declarations) {
 	return {
 		selectors: typeof selector === "string" ? [selector] : selector,
 		declarations
@@ -22097,6 +23100,7 @@ const STRUCTURAL_DECLARATIONS = [
 function generateButtonCss(options) {
 	const { themeId, theme, buttonSystem: providedButtonSystem } = options;
 	const tokens = new TokenResolver(theme);
+	const palette = expandPalette(theme.palette);
 	const buttonSystem = providedButtonSystem ?? generateDefaultButtonSystem(theme);
 	const themeSizes = {
 		...DEFAULT_BUTTON_SIZES,
@@ -22105,34 +23109,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));
@@ -22147,21 +23226,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]
 	]);
@@ -22171,7 +23249,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)]);
@@ -22183,20 +23261,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.
@@ -22205,30 +23275,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 variantStateColourRule(variantId, themeId, state, colour) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:${state}`, resolvedButtonColourDeclarations(colour));
 }
-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 variantFocusVisibleRule(variantId, themeId, focusIndicator) {
+	return rule$1(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, resolvedButtonFocusDeclarations(focusIndicator));
 }
-function variantFocusVisibleRule(variantId, themeId) {
-	return rule(`:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}:focus-visible`, [["outline", "2px solid currentColor"], ["outline-offset", "3px"]]);
-}
-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
@@ -22243,18 +23305,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 = [];
@@ -22264,7 +23323,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;
 }
@@ -22322,6 +23381,27 @@ function resolveBoxShadow(variant, global, theme, tokens) {
 	const color = shadowConfig.colorToken ? tokens.getColor(shadowConfig.colorToken) : void 0;
 	return generateShadowValue$1(shadowConfig.elevation, shadowConfig.softness, shadowConfig.position ?? "bottom", color);
 }
+buttonPersonalities.map((personality) => ({
+	id: personality.id,
+	name: personality.name,
+	description: personality.description,
+	category: presetCategory(personality),
+	buttonSystem: personality.buttonSystem,
+	compatibility: {
+		...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+		...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+	}
+}));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
 //#endregion
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
@@ -22558,67 +23638,6 @@ function generateDefaultCardSystem(theme) {
 	return { variants: [defaultVariant, alternativeVariant] };
 }
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-const SURFACE_FOREGROUND_ROLES = [
-	"text",
-	"heading",
-	"link",
-	"supporting"
-];
-//#endregion
-//#region ../theme-core/src/surfaces/foregroundContract.ts
-const SURFACE_FOREGROUND_CSS_VARS = {
-	text: "--rb-surface-text-color",
-	heading: "--rb-surface-heading-color",
-	link: "--rb-surface-link-color",
-	supporting: "--rb-surface-supporting-color"
-};
-const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
-const DEFAULT_ROLE_FALLBACKS = {
-	text: DEFAULT_SURFACE_TEXT_COLOR,
-	heading: DEFAULT_SURFACE_TEXT_COLOR,
-	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
-	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
-};
-function requireSurfaceColorValue(role, value) {
-	const normalized = value.trim();
-	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
-	return normalized;
-}
-function completeSurfaceForegrounds(input) {
-	const text = requireSurfaceColorValue("text", input.text);
-	return {
-		text,
-		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
-		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
-	};
-}
-function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
-	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
-	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
-	if (role === "text") return `var(${roleVariable}, ${fallback})`;
-	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
-}
-function surfaceForegroundValueWithOpacity(role, opacityPercent) {
-	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
-	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
-}
-function surfaceForegroundStyle(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return {
-		color: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
-		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
-		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
-	};
-}
-function surfaceForegroundDeclarations(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
-}
-//#endregion
 //#region ../theme-core/src/cards/generateCardCss.ts
 const PER_CORNER_RADIUS_MAP$1 = {
 	square: "0",
@@ -23055,47 +24074,6 @@ const FONT_WEIGHT_MAP = {
 	black: "800"
 };
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-/**
-* Gradient color stop
-*/
-const gradientStopSchema = z$1.object({
-	color: themeColorTokenSchema,
-	position: z$1.number().min(0).max(100)
-});
-/**
-* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
-* so existing radial gradients are byte-identical.
-*
-* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
-* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
-*/
-const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-/**
-* Gradient configuration.
-*
-* `type` is optional and defaults to `'linear'` so gradients persisted without a
-* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
-* `'conic'` are additive kinds:
-*   - linear: `angle` (degrees)
-*   - radial: optional `shape` (circle/ellipse) + `position`
-*   - conic:  optional `angle` (from-angle, degrees) + `position`
-*/
-const gradientConfigSchema = z$1.object({
-	type: z$1.enum([
-		"linear",
-		"radial",
-		"conic"
-	]).default("linear"),
-	angle: z$1.number().min(0).max(360).optional(),
-	shape: radialGradientShapeSchema.optional(),
-	position: z$1.string().optional(),
-	stops: z$1.array(gradientStopSchema).min(2)
-});
-//#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
 /**
 * Shared Base Schemas for Interactive Elements
@@ -24846,6 +25824,21 @@ z$1.object({
 	blocks: z$1.array(blockDesignPlanSchema),
 	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;
 }
@@ -25116,24 +26109,24 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				type: "color",
 				color: "muted"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"brand-depth-band": {
 			background: {
 				type: "color",
 				color: "primary-800"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"hero-image": {
 			background: {
@@ -25141,12 +26134,32 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				opacity: 1,
 				position: "center center"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
+		}
+	}
+});
+const primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+const fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+	...defaultDesignRuntimeRules,
+	sectionSurfaces: {
+		...defaultDesignRuntimeRules.sectionSurfaces,
+		"accent-band": {
+			background: {
+				type: "gradient",
+				gradientPresetId: primaryGlowGradientPresetId
+			},
+			foreground: defineSectionForegroundRuntimeTokens({
+				textColor: "primaryForeground",
+				headingColor: "primaryForeground",
+				linkColor: "primaryForeground",
+				supportingColor: "primaryForeground"
+			})
 		}
 	}
 });
@@ -26534,6 +27547,8 @@ const curatedSiteStyles = [
 		},
 		compositionBudget: quietBudget,
 		typography: fulcrumTypography,
+		designRuntimeRules: fulcrumDesignRuntimeRules,
+		recommendedAppearancePresetIds: ["cta-accent-band"],
 		themeOverrides: {
 			shadow: { colorToken: "primary" },
 			accordions: {
@@ -30002,9 +31017,15 @@ function createButtonGroup(options = {}) {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -30013,11 +31034,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 //#endregion
@@ -30067,6 +31085,7 @@ const heroCtaRowFragment = defineFragment({
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -30134,7 +31153,7 @@ const ctaCopyFragment = defineFragment({
 		eyebrowPath: "content.eyebrow",
 		titlePath: "content.title",
 		className: "cta-heading"
-	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 });
 //#endregion
 //#region ../blocks/src/system/fragments/library/testimonialsHeading.ts
@@ -32351,6 +33370,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,
@@ -32496,6 +33516,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -32769,6 +33790,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -32954,6 +33976,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -33010,6 +34033,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",
@@ -33307,6 +34334,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",
@@ -33349,6 +34380,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -33382,6 +34414,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -33664,6 +34697,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -33726,6 +34760,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 },
@@ -33929,6 +34964,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -34229,7 +35265,7 @@ const heroTitleLengthThresholds = {
 		maxWords: 11
 	}
 };
-function isPlainObject$3(value) {
+function isPlainObject$4(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function readString$1(obj, key) {
@@ -34238,7 +35274,7 @@ function readString$1(obj, key) {
 }
 function resolveGeneratedHeroLayoutStyles(content) {
 	const raw = content._heroLayoutStyles;
-	return isPlainObject$3(raw) ? raw : null;
+	return isPlainObject$4(raw) ? raw : null;
 }
 function readHeroLayoutString(content, generatedKey, fallbackKey = generatedKey) {
 	const explicitValue = readString$1(content, fallbackKey);
@@ -34294,7 +35330,7 @@ const heroContentWrapperClassTransform = {
 	summary: "Resolve hero content wrapper className from alignment + max width controls",
 	schema: z$1.object({ base: z$1.string().optional() }),
 	run: (value, options, context) => {
-		const content = isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {};
+		const content = isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {};
 		const alignment = resolveHeroContentAlignment(content);
 		const maxWidth = resolveHeroContentMaxWidth(content);
 		const typographyScale = resolveHeroTypographyScale(content);
@@ -34317,7 +35353,7 @@ const heroCtaJustifyTransform = {
 	kind: "string",
 	summary: "Map hero contentAlignment to CTA row justify value",
 	run: (value, _options, context) => {
-		const alignment = resolveHeroContentAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const alignment = resolveHeroContentAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		return alignment === "left" ? "start" : alignment === "right" ? "end" : "center";
 	}
 };
@@ -34326,7 +35362,7 @@ const heroStackJustifyFromVerticalAlignmentTransform = {
 	kind: "string",
 	summary: "Map hero verticalAlignment to stack justify value",
 	run: (value, _options, context) => {
-		const vertical = resolveHeroVerticalAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const vertical = resolveHeroVerticalAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		return vertical === "top" ? "start" : vertical === "bottom" ? "end" : "center";
 	}
 };
@@ -34336,7 +35372,7 @@ const heroGridClassFromVerticalAlignmentTransform = {
 	summary: "Append align-items class for hero split layouts based on verticalAlignment",
 	schema: z$1.object({ base: z$1.string() }),
 	run: (value, options, context) => {
-		const vertical = resolveHeroVerticalAlignment(isPlainObject$3(value) ? value : isPlainObject$3(context.data) ? context.data : {});
+		const vertical = resolveHeroVerticalAlignment(isPlainObject$4(value) ? value : isPlainObject$4(context.data) ? context.data : {});
 		const itemsClass = vertical === "top" ? "rb-items-start" : vertical === "bottom" ? "rb-items-end" : "rb-items-center";
 		return joinClasses$3([options.base, itemsClass]);
 	}
@@ -35653,6 +36689,7 @@ const siteHeaderBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -35857,6 +36894,7 @@ const siteFooterBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	layout: section$1({
 		background: "background",
@@ -36006,6 +37044,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -36164,6 +37203,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -36397,6 +37437,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -36684,6 +37725,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -37067,6 +38109,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -37467,6 +38510,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -37631,6 +38675,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -39326,6 +40371,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -39432,15 +40478,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"
@@ -39453,9 +40493,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -39830,6 +40869,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -39943,15 +40983,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"
@@ -39964,9 +40998,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -40046,6 +41079,7 @@ const eventDetailsManifest = createBlockManifest({
 	titleSource: "heading",
 	description: "Date/time, venue, map, and other dates for an event",
 	category: "content",
+	contentSource: { kind: "entries" },
 	tags: [
 		"events",
 		"venue",
@@ -40251,6 +41285,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -40542,6 +41577,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -43385,6 +44421,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -44590,6 +45627,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -44987,6 +46025,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",
@@ -45617,7 +46656,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -45670,6 +46712,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -45838,6 +46881,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -46325,6 +47369,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -46977,6 +48022,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -47147,6 +48193,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",
@@ -47258,6 +48305,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",
@@ -48277,6 +49325,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -48476,6 +49525,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -48617,6 +49667,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -48733,6 +49784,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -48815,6 +49867,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -49029,6 +50082,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -49401,6 +50455,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -49582,6 +50637,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -50022,6 +51078,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",
@@ -51028,213 +52085,6 @@ function getBlockDefinition(name) {
 	return blockStore.get(name);
 }
 //#endregion
-//#region ../theme-core/src/gradients/presets.ts
-/**
-* Curated library of gradient presets
-* All gradients use theme color tokens, so they adapt to the site's palette
-*/
-const GRADIENT_PRESETS = [
-	{
-		id: "primary-secondary",
-		name: "Primary to Secondary",
-		description: "Blend your primary and secondary brand colors",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "secondary-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-accent",
-		name: "Primary to Accent",
-		description: "Energetic gradient from primary to accent",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-accent",
-		name: "Secondary to Accent",
-		description: "Vibrant secondary to accent blend",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-light-dark",
-		name: "Primary Light to Dark",
-		description: "Subtle primary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-dark-light",
-		name: "Primary Dark to Light",
-		description: "Reverse primary fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-900",
-			position: 0
-		}, {
-			color: "primary-50",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-light-dark",
-		name: "Secondary Light to Dark",
-		description: "Subtle secondary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "secondary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-light-dark",
-		name: "Accent Light to Dark",
-		description: "Accent color depth fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "background-surface",
-		name: "Background to Surface",
-		description: "Subtle depth using base colors",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "background",
-			position: 0
-		}, {
-			color: "surface",
-			position: 100
-		}]
-	},
-	{
-		id: "neutral-fade",
-		name: "Neutral Gradient",
-		description: "Elegant neutral color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "neutral-900",
-			position: 0
-		}, {
-			color: "neutral-50",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-radial",
-		name: "Primary Spotlight",
-		description: "Radial primary gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-radial",
-		name: "Accent Spotlight",
-		description: "Radial accent gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-secondary-accent",
-		name: "Brand Trio",
-		description: "All three brand colors in harmony",
-		type: "linear",
-		angle: 135,
-		stops: [
-			{
-				color: "primary-500",
-				position: 0
-			},
-			{
-				color: "secondary-500",
-				position: 50
-			},
-			{
-				color: "accent-500",
-				position: 100
-			}
-		]
-	}
-];
-//#endregion
-//#region ../theme-core/src/gradients/utils.ts
-/**
-* Convert a GradientConfig to a CSS gradient string
-*
-* @param config - The gradient configuration using theme tokens
-* @param tokens - Map of theme color tokens to hex values
-* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
-*/
-function gradientToCss(config, tokens) {
-	const stops = config.stops.map((stop) => {
-		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
-	}).join(", ");
-	const type = config.type ?? "linear";
-	if (type === "radial") {
-		const position = config.position ?? "center";
-		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
-	}
-	if (type === "conic") {
-		const position = config.position ?? "center";
-		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
-	}
-	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
-}
-//#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 function resolveBackgroundMedia(input) {
 	const parsedMedia = mediaSchema.safeParse(input.image);
@@ -51272,9 +52122,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString$1(value)) return null;
-	const preset = GRADIENT_PRESETS.find((candidate) => candidate.id === value.trim());
-	if (!preset) return null;
+	const presetId = parseGradientPresetId(value);
+	if (!presetId) return null;
+	const preset = getGradientPreset(presetId);
 	return gradientToCss(preset, Object.fromEntries(preset.stops.map((stop) => [stop.color, `rgb(var(--tb-${stop.color}))`])));
 }
 const backgroundTransforms = [
@@ -60366,7 +61216,7 @@ function readFromSource$1(source, segments) {
 /**
 * Type guard for plain objects.
 */
-function isPlainObject$2(value) {
+function isPlainObject$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -60375,18 +61225,18 @@ function isPlainObject$2(value) {
 function parseRouteEntry(routeId, value) {
 	if (typeof routeId !== "string" || routeId.length === 0) return null;
 	if (typeof value === "string") return [routeId, value];
-	if (isPlainObject$2(value)) return [routeId, value];
+	if (isPlainObject$3(value)) return [routeId, value];
 	return null;
 }
 /**
 * Extracts route map from $root.routes in the viewModel.
 */
 function extractRouteMapFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const routes = root.routes;
-	if (!isPlainObject$2(routes)) return void 0;
+	if (!isPlainObject$3(routes)) return void 0;
 	const entries = Object.entries(routes).map(([routeId, value]) => parseRouteEntry(routeId, value)).filter((entry) => entry !== null);
 	if (entries.length === 0) return void 0;
 	return Object.fromEntries(entries);
@@ -60395,22 +61245,22 @@ function extractRouteMapFromViewModel(viewModel) {
 * Extracts pagesByIdentifier from $root.pagesByIdentifier in the viewModel.
 */
 function extractPagesByIdentifierFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const pagesByIdentifier = root.pagesByIdentifier;
-	if (!isPlainObject$2(pagesByIdentifier)) return void 0;
+	if (!isPlainObject$3(pagesByIdentifier)) return void 0;
 	return pagesByIdentifier;
 }
 /**
 * Extracts entriesByIdentifier from $root.entriesByIdentifier in the viewModel.
 */
 function extractEntriesByIdentifierFromViewModel(viewModel) {
-	if (!isPlainObject$2(viewModel)) return void 0;
+	if (!isPlainObject$3(viewModel)) return void 0;
 	const root = viewModel.$root;
-	if (!isPlainObject$2(root)) return void 0;
+	if (!isPlainObject$3(root)) return void 0;
 	const entriesByIdentifier = root.entriesByIdentifier;
-	if (!isPlainObject$2(entriesByIdentifier)) return void 0;
+	if (!isPlainObject$3(entriesByIdentifier)) return void 0;
 	return entriesByIdentifier;
 }
 /**
@@ -60432,7 +61282,7 @@ function applyTransformsAndFallback(value, binding, context) {
 	const routeMap = context.routes ?? extractRouteMapFromViewModel(context.viewModel);
 	const pagesByIdentifier = context.pagesByIdentifier ?? extractPagesByIdentifierFromViewModel(context.viewModel);
 	const entriesByIdentifier = context.entriesByIdentifier ?? extractEntriesByIdentifierFromViewModel(context.viewModel);
-	const stage = (isPlainObject$2(context.viewModel.$root) ? context.viewModel.$root : null)?.previewStage === "preview" ? "preview" : "published";
+	const stage = (isPlainObject$3(context.viewModel.$root) ? context.viewModel.$root : null)?.previewStage === "preview" ? "preview" : "published";
 	const transformed = runTransforms(value, binding.transforms?.map((step) => ({
 		id: step.id,
 		options: step.options
@@ -60461,15 +61311,15 @@ function resolveTransformData(context, bindingPath) {
 	const [first] = splitPath$1(bindingPath);
 	if (typeof first === "string" && first !== "$root") {
 		const namedScope = context.scopes.find((entry) => entry.name === first);
-		if (namedScope && isPlainObject$2(namedScope.value)) return namedScope.value;
+		if (namedScope && isPlainObject$3(namedScope.value)) return namedScope.value;
 	}
 	for (let i = context.scopes.length - 1; i >= 0; i -= 1) {
 		const scope = context.scopes[i];
-		if (scope && isPlainObject$2(scope.value)) return scope.value;
+		if (scope && isPlainObject$3(scope.value)) return scope.value;
 	}
 	const content = context.viewModel.content;
-	if (isPlainObject$2(content)) return content;
-	if (isPlainObject$2(context.viewModel)) return context.viewModel;
+	if (isPlainObject$3(content)) return content;
+	if (isPlainObject$3(context.viewModel)) return context.viewModel;
 }
 function coerceBindingValue(value, binding) {
 	const mode = binding.coerce;
@@ -60531,7 +61381,7 @@ function isRichTextConditionValueEmpty(value) {
 	return richTextStructuralPresence(root).kind === "empty";
 }
 function isTipTapNode(value) {
-	return isPlainObject$2(value) && typeof value.type === "string";
+	return isPlainObject$3(value) && typeof value.type === "string";
 }
 function richTextStructuralPresence(node) {
 	if (typeof node.text === "string" && node.text.trim().length > 0) return {
@@ -60560,7 +61410,7 @@ function richTextSelfPresence(node) {
 	}
 }
 function hasResolvableRichTextImageSource(node) {
-	const attrs = isPlainObject$2(node.attrs) ? node.attrs : {};
+	const attrs = isPlainObject$3(node.attrs) ? node.attrs : {};
 	return hasNonBlankStringAttr(attrs, "src") || hasNonBlankStringAttr(attrs, "identifier");
 }
 function hasNonBlankStringAttr(attrs, key) {
@@ -60752,7 +61602,7 @@ function getNestedBinding(bindings, path) {
 	const segments = path.split(".");
 	let current = bindings;
 	for (const segment of segments) {
-		if (!isPlainObject$2(current)) return void 0;
+		if (!isPlainObject$3(current)) return void 0;
 		current = current[segment];
 	}
 	return current;
@@ -60775,7 +61625,7 @@ function resolveBindingToEditorPath(fieldName, bindings, editableRouteMetadataFi
 	};
 	const binding = bindings[fieldName] ?? getNestedBinding(bindings, fieldName);
 	if (!binding) return null;
-	if (isPlainObject$2(binding) && "source" in binding) {
+	if (isPlainObject$3(binding) && "source" in binding) {
 		const source = binding.source;
 		if (source === "field" && "path" in binding) {
 			const path = binding.path;
@@ -60792,7 +61642,7 @@ function resolveBindingToEditorPath(fieldName, bindings, editableRouteMetadataFi
 			if (!Array.isArray(options)) return null;
 			for (const option of options) {
 				if (typeof option === "string") return `content.${option}`;
-				if (isPlainObject$2(option) && "source" in option) {
+				if (isPlainObject$3(option) && "source" in option) {
 					const optSource = option.source;
 					if (optSource === "field" && "path" in option) {
 						const path = option.path;
@@ -60844,7 +61694,7 @@ function derivePreviewTextEditableTarget(parsedBinding, context) {
 		};
 	}
 	const root = context.viewModel?.$root;
-	if (isPlainObject$2(root) && root.contentEntry != null && context.pathBase) return {
+	if (isPlainObject$3(root) && root.contentEntry != null && context.pathBase) return {
 		kind: "read-only",
 		reason: "entry-template-block-field"
 	};
@@ -60903,7 +61753,7 @@ function injectMediaSlotPath(props, node, parsedBinding, context) {
 		if (resolveBindingToEditorPath(fieldPath, context.blockBindings, context.editableRouteMetadataFieldIds)) return props;
 	}
 	const root = context.viewModel?.$root;
-	if (isPlainObject$2(root) && root.contentEntry != null && context.pathBase) return props;
+	if (isPlainObject$3(root) && root.contentEntry != null && context.pathBase) return props;
 	return {
 		...props,
 		fieldPath
@@ -61050,7 +61900,7 @@ function getNodeProps(node) {
 		if (key.startsWith("$")) continue;
 		legacy[key] = value;
 	}
-	const props = isPlainObject$2(node.props) ? node.props : {};
+	const props = isPlainObject$3(node.props) ? node.props : {};
 	return {
 		...legacy,
 		...props
@@ -61162,7 +62012,7 @@ function generateHoverEffects(axes, _space) {
 //#endregion
 //#region ../theme-core/src/blockOverrides.ts
 const BLOCK_PREFIX = "block.";
-function isPlainObject$1(value) {
+function isPlainObject$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isUnknownArray$1(value) {
@@ -61170,7 +62020,7 @@ function isUnknownArray$1(value) {
 }
 function cloneValue(value) {
 	if (isUnknownArray$1(value)) return value.map((item) => cloneValue(item));
-	if (isPlainObject$1(value)) {
+	if (isPlainObject$2(value)) {
 		const cloned = {};
 		for (const [key, child] of Object.entries(value)) cloned[key] = cloneValue(child);
 		return cloned;
@@ -61180,7 +62030,7 @@ function cloneValue(value) {
 function mergeDeep(defaultValue, overrideValue) {
 	if (overrideValue === void 0) return cloneValue(defaultValue);
 	if (overrideValue === null) return null;
-	if (isPlainObject$1(defaultValue) && isPlainObject$1(overrideValue)) {
+	if (isPlainObject$2(defaultValue) && isPlainObject$2(overrideValue)) {
 		const merged = {};
 		const keys = /* @__PURE__ */ new Set([...Object.keys(defaultValue), ...Object.keys(overrideValue)]);
 		for (const key of keys) merged[key] = mergeDeep(defaultValue[key], overrideValue[key]);
@@ -61237,7 +62087,7 @@ function mergeContentWithBlockStyleOverrides(content, theme, blockKind) {
 */
 function applyHeadingDecorationSignature(target, themeDecoration) {
 	const existing = target["_sectionStyles"];
-	const existingObj = isPlainObject$1(existing) ? existing : void 0;
+	const existingObj = isPlainObject$2(existing) ? existing : void 0;
 	const rawOverride = existingObj?.["headingDecorationOverride"];
 	const effective = resolveEffectiveHeadingDecoration(themeDecoration, rawOverride === "site-default" || rawOverride === "off" ? rawOverride : void 0);
 	if (effective.kind === "none") {
@@ -64764,6 +65614,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),
@@ -73425,6 +74277,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)
  *
@@ -79039,35 +79896,35 @@ z$1.object({
 //#endregion
 //#region ../blocks/src/system/runtime/bindings.ts
 const shouldLogWarnings = isNonProductionEnv();
-function isPlainObject(value) {
+function isPlainObject$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isRouteMapEntry(value) {
 	if (typeof value === "string") return true;
-	return isPlainObject(value);
+	return isPlainObject$1(value);
 }
 function isRouteMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	return Object.values(value).every(isRouteMapEntry);
 }
 function isPageIdentifierMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	return Object.values(value).every((v) => typeof v === "string");
 }
 function isEntryIdentifierMap(value) {
-	if (!isPlainObject(value)) return false;
+	if (!isPlainObject$1(value)) return false;
 	for (const v of Object.values(value)) {
-		if (!isPlainObject(v)) return false;
+		if (!isPlainObject$1(v)) return false;
 		if (!Object.values(v).every((inner) => typeof inner === "string")) return false;
 	}
 	return true;
 }
 function buildTransformContext(vm) {
 	const root = vm.$root;
-	const stage = root && isPlainObject(root) && root.previewStage === "preview" ? "preview" : "published";
-	const routes = root && isPlainObject(root) && isRouteMap(root.routes) ? root.routes : void 0;
-	const pagesByIdentifier = root && isPlainObject(root) && isPageIdentifierMap(root.pagesByIdentifier) ? root.pagesByIdentifier : void 0;
-	const entriesByIdentifier = root && isPlainObject(root) && isEntryIdentifierMap(root.entriesByIdentifier) ? root.entriesByIdentifier : void 0;
+	const stage = root && isPlainObject$1(root) && root.previewStage === "preview" ? "preview" : "published";
+	const routes = root && isPlainObject$1(root) && isRouteMap(root.routes) ? root.routes : void 0;
+	const pagesByIdentifier = root && isPlainObject$1(root) && isPageIdentifierMap(root.pagesByIdentifier) ? root.pagesByIdentifier : void 0;
+	const entriesByIdentifier = root && isPlainObject$1(root) && isEntryIdentifierMap(root.entriesByIdentifier) ? root.entriesByIdentifier : void 0;
 	return {
 		theme: defaultThemeTokens,
 		stage,
@@ -79461,8 +80318,6 @@ function parseBackgroundColorToken(value) {
 	if (!token) return null;
 	return token ? token : null;
 }
-const gradientPresetIds = GRADIENT_PRESETS.map((preset) => preset.id);
-new Set(gradientPresetIds);
 //#endregion
 //#region ../api/src/sdkConfig/contracts.ts
 /**
@@ -80149,6 +81004,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -80161,7 +81017,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
@@ -80174,7 +81035,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];
@@ -82744,6 +83608,225 @@ function isDisplayMediaKind(value) {
 function isFileFieldKind(value) {
 	return FILE_FIELD_KINDS.includes(value);
 }
+/** Matches the closed sentinel shape `"<REQUIRED: …>"`. */
+const SENTINEL_PATTERN = /^<REQUIRED:.*>$/;
+/**
+* True when a value is an unfilled placeholder sentinel. Shared by the emitter
+* (self-check) and the validator (rejection) so recognition can't drift.
+*/
+function isPlaceholderSentinel(value) {
+	return typeof value === "string" && SENTINEL_PATTERN.test(value);
+}
+function effectiveReferenceKind(field) {
+	const kind = field.referenceKind;
+	const legacy = field.reference?.type;
+	return kind ?? legacy;
+}
+function selectOptionValues$1(field) {
+	const options = field.options;
+	return options ? options.map((o) => o.value) : [];
+}
+/**
+* The placeholder sentinel for a leaf field. Container types (group/button/
+* repeater) do not have a leaf sentinel — they expand structurally — and calling
+* this for them returns a generic marker only for completeness.
+*/
+function buildSentinel(field) {
+	switch (field.type) {
+		case "text":
+		case "textarea": return "<REQUIRED: text>";
+		case "richText": return "<REQUIRED: rich-text>";
+		case "number": return "<REQUIRED: number>";
+		case "date": return "<REQUIRED: date (YYYY-MM-DD)>";
+		case "datetime": return "<REQUIRED: datetime (ISO 8601)>";
+		case "url": return "<REQUIRED: url>";
+		case "link": return "<REQUIRED: link>";
+		case "media": return "<REQUIRED: media-identifier>";
+		case "file": return "<REQUIRED: file-identifier>";
+		case "boolean": return "<REQUIRED: boolean>";
+		case "select": {
+			const values = selectOptionValues$1(field);
+			return values.length > 0 ? `<REQUIRED: select (${values.join("|")})>` : "<REQUIRED: select>";
+		}
+		case "reference": {
+			const kind = effectiveReferenceKind(field);
+			return kind ? `<REQUIRED: reference-identifier (${kind})>` : "<REQUIRED: reference-identifier>";
+		}
+		case "group": return "<REQUIRED: group>";
+		case "button": return "<REQUIRED: button>";
+		case "repeater": return "<REQUIRED: repeater>";
+	}
+}
+//#endregion
+//#region ../content-model/src/content-types/entryValidation.ts
+function subfieldsOf$1(field) {
+	const direct = field.fields;
+	if (direct && direct.length > 0) return direct;
+	return field.schema?.fields ?? [];
+}
+function selectOptionValues(field) {
+	const options = field.options;
+	return options ? options.map((o) => o.value) : [];
+}
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Field types whose value must be a string. */
+const STRING_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"textarea",
+	"url",
+	"link",
+	"media",
+	"file",
+	"reference",
+	"date",
+	"datetime",
+	"select"
+]);
+function checkLeafType(field, value, path, errors) {
+	const push = (code, message) => {
+		errors.push({
+			path,
+			fieldType: field.type,
+			code,
+			message
+		});
+	};
+	if (field.type === "number") {
+		if (typeof value !== "number" || Number.isNaN(value)) push("wrong_type", `"${path}" must be a number.`);
+		return;
+	}
+	if (field.type === "boolean") {
+		if (typeof value !== "boolean") push("wrong_type", `"${path}" must be a boolean.`);
+		return;
+	}
+	if (field.type === "richText") {
+		if (typeof value !== "string" && !isPlainObject(value)) push("wrong_type", `"${path}" must be rich-text (string or document object).`);
+		return;
+	}
+	if (field.type === "select") {
+		if (typeof value !== "string") {
+			push("wrong_type", `"${path}" must be a string.`);
+			return;
+		}
+		const options = selectOptionValues(field);
+		if (options.length > 0 && !options.includes(value)) push("invalid_option", `"${path}" must be one of: ${options.join(", ")}.`);
+		return;
+	}
+	if (STRING_TYPES.has(field.type)) {
+		if (typeof value !== "string") push("wrong_type", `"${path}" must be a string.`);
+	}
+}
+function validateField(field, value, path, errors) {
+	if (value === void 0 || value === null || value === "") {
+		if (field.required === true) errors.push({
+			path,
+			fieldType: field.type,
+			code: "missing_required",
+			message: `Required field "${path}" is missing.`
+		});
+		return;
+	}
+	if (isPlaceholderSentinel(value)) {
+		errors.push({
+			path,
+			fieldType: field.type,
+			code: "unfilled_placeholder",
+			message: `"${path}" still contains an unfilled placeholder (${value}).`
+		});
+		return;
+	}
+	if (field.type === "group" || field.type === "button") {
+		if (!isPlainObject(value)) {
+			errors.push({
+				path,
+				fieldType: field.type,
+				code: "wrong_type",
+				message: `"${path}" must be an object.`
+			});
+			return;
+		}
+		validateFields(subfieldsOf$1(field), value, path, errors);
+		return;
+	}
+	if (field.type === "repeater") {
+		if (!Array.isArray(value)) {
+			errors.push({
+				path,
+				fieldType: field.type,
+				code: "wrong_type",
+				message: `"${path}" must be an array.`
+			});
+			return;
+		}
+		const itemFields = subfieldsOf$1(field);
+		value.forEach((item, index) => {
+			const itemPath = `${path}[${index}]`;
+			if (!isPlainObject(item)) {
+				errors.push({
+					path: itemPath,
+					fieldType: "repeater",
+					code: "wrong_type",
+					message: `"${itemPath}" must be an object.`
+				});
+				return;
+			}
+			validateFields(itemFields, item, itemPath, errors);
+		});
+		return;
+	}
+	checkLeafType(field, value, path, errors);
+}
+function validateFields(fields, data, pathPrefix, errors) {
+	for (const field of fields) {
+		const path = pathPrefix ? `${pathPrefix}.${field.id}` : field.id;
+		validateField(field, data[field.id], path, errors);
+	}
+}
+//#endregion
+//#region ../content-model/src/content-types/scaffold.ts
+/** Nested subfields for group/repeater/button-style fields (both DSL shapes). */
+function subfieldsOf(field) {
+	const direct = field.fields;
+	if (direct && direct.length > 0) return direct;
+	return field.schema?.fields ?? [];
+}
+const CONTAINER_TYPES = /* @__PURE__ */ new Set([
+	"group",
+	"button",
+	"repeater"
+]);
+/**
+* Build the placeholder value for a required field. Group/button fields recurse
+* into their required subfields; repeaters emit a single seed item so agents see
+* the item shape.
+*/
+function buildFieldValue(field) {
+	if (field.type === "repeater") return [buildObjectFromFields(subfieldsOf(field))];
+	if (CONTAINER_TYPES.has(field.type)) {
+		const subfields = subfieldsOf(field);
+		if (subfields.length > 0) return buildObjectFromFields(subfields);
+		if (field.type === "button") return {
+			label: "<REQUIRED: text>",
+			link: "<REQUIRED: link>"
+		};
+		return {};
+	}
+	return buildSentinel(field);
+}
+/**
+* Build a template object from a list of fields, stubbing required fields and
+* omitting optional ones.
+*/
+function buildObjectFromFields(fields) {
+	const template = {};
+	for (const field of fields) {
+		if (field.required !== true) continue;
+		template[field.id] = buildFieldValue(field);
+	}
+	return template;
+}
 //#endregion
 //#region ../content-model/src/content-types/builtins.ts
 /**
@@ -86184,7 +87267,7 @@ var CircuitOpenError = class extends Error {
 * 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/next/content-load-failure.ts
 const SdkContentLoadError = RiverbankContentLoadError;