@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/server/rendering/server.mjs

@@ -272,19 +272,29 @@ function isRecord$16(value) {
 //#region ../core/src/booking-date-time.ts
 const DEFAULT_LOCALE = "en-US";
 const FALLBACK_TIMEZONE = "UTC";
+const DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+const dateTimeFormatterCache = /* @__PURE__ */ new Map();
+const timeZoneValidityCache = /* @__PURE__ */ new Map();
 function isValidTimeZone$1(timeZone) {
+	const cached = timeZoneValidityCache.get(timeZone);
+	if (cached !== void 0) return cached;
+	let isValid;
 	try {
 		new Intl.DateTimeFormat(DEFAULT_LOCALE, { timeZone }).format(/* @__PURE__ */ new Date());
-		return true;
+		isValid = true;
 	} catch {
-		return false;
+		isValid = false;
 	}
+	if (timeZoneValidityCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) timeZoneValidityCache.clear();
+	timeZoneValidityCache.set(timeZone, isValid);
+	return isValid;
 }
 function getSafeTimeZone(timeZone) {
 	const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
 	return normalized.length > 0 && isValidTimeZone$1(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone$1(normalized)) return null;
 	return normalized;
@@ -297,10 +307,19 @@ function formatParseError(error) {
 	}
 }
 function formatToPartsLookup(date, locale, timeZone, format) {
-	return new Map(new Intl.DateTimeFormat(locale, {
+	return new Map(getCachedDateTimeFormatter(locale, timeZone, format).formatToParts(date).map((part) => [part.type, part.value]));
+}
+function getCachedDateTimeFormatter(locale, timeZone, format) {
+	const key = `${locale}\u0000${timeZone}\u0000${JSON.stringify(Object.entries(format).sort(([left], [right]) => left.localeCompare(right)))}`;
+	const cached = dateTimeFormatterCache.get(key);
+	if (cached !== void 0) return cached;
+	const formatter = new Intl.DateTimeFormat(locale, {
 		...format,
 		timeZone
-	}).formatToParts(date).map((part) => [part.type, part.value]));
+	});
+	if (dateTimeFormatterCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) dateTimeFormatterCache.clear();
+	dateTimeFormatterCache.set(key, formatter);
+	return formatter;
 }
 function getZonedDateTimeParts(date, timeZone) {
 	const parts = formatToPartsLookup(date, "en-GB", timeZone, {
@@ -346,23 +365,9 @@ function toUtcIsoDateTimeString(value) {
 	return parsed.value;
 }
 function parseScheduledBookingDateTime(input) {
+	let startsAt;
 	try {
-		const startsAt = toUtcIsoDateTimeString(input.startsAt);
-		const timeZone = parseStrictBookingTimeZone(input.timeZone);
-		if (timeZone === null) return {
-			ok: false,
-			field: "timeZone",
-			reason: "invalid_time_zone",
-			value: input.timeZone
-		};
-		return {
-			ok: true,
-			value: {
-				startsAt,
-				timeZone,
-				locale: input.locale
-			}
-		};
+		startsAt = toUtcIsoDateTimeString(input.startsAt);
 	} catch {
 		return {
 			ok: false,
@@ -371,6 +376,21 @@ function parseScheduledBookingDateTime(input) {
 			value: input.startsAt
 		};
 	}
+	const timeZone = parseStrictBookingTimeZone(input.timeZone);
+	if (timeZone === null) return {
+		ok: false,
+		field: "timeZone",
+		reason: "invalid_time_zone",
+		value: typeof input.timeZone === "string" ? input.timeZone : ""
+	};
+	return {
+		ok: true,
+		value: {
+			startsAt,
+			timeZone,
+			locale: input.locale
+		}
+	};
 }
 function parseScheduledBookingDateRange(input) {
 	const start = parseScheduledBookingDateTime(input);
@@ -409,10 +429,7 @@ function toScheduledBookingDateRange(input) {
 function formatBookingInstant(isoString, options) {
 	const date = new Date(isoString);
 	if (Number.isNaN(date.getTime())) return isoString;
-	return new Intl.DateTimeFormat(options.locale ?? DEFAULT_LOCALE, {
-		...options.format,
-		timeZone: getSafeTimeZone(options.timeZone)
-	}).format(date);
+	return getCachedDateTimeFormatter(options.locale ?? DEFAULT_LOCALE, getSafeTimeZone(options.timeZone), options.format).format(date);
 }
 function formatBookingDate(input, format = {
 	weekday: "long",
@@ -551,7 +568,8 @@ function validateRelativeStoragePath(value) {
 	if (value.startsWith("sites/")) return fail({ tag: "SITE_SCOPED_PATH" });
 	if (value.startsWith("/")) return fail({ tag: "LEADING_SLASH" });
 	if (value.includes("//")) return fail({ tag: "DOUBLE_SLASH" });
-	if (value.split("/").some((segment) => segment === "..")) return fail({ tag: "TRAVERSAL" });
+	if (value.includes("%")) return fail({ tag: "PERCENT_ENCODING" });
+	if (value.split("/").some((segment) => segment === "." || segment === "..")) return fail({ tag: "TRAVERSAL" });
 	return ok(value);
 }
 function brandRelativeStoragePath(value) {
@@ -987,7 +1005,7 @@ function mqBetween(minPx, maxPx) {
 	return `${mqUp(minPx)} and ${mqDown(maxPx)}`;
 }
 const MQ_SM_UP = mqUp(640);
-mqUp(768);
+const MQ_MD_UP = mqUp(768);
 const MQ_LG_UP = mqUp(BREAKPOINT_LG);
 mqUp(BREAKPOINT_XL);
 const MQ_SM_DOWN = mqDown(639);
@@ -1642,6 +1660,20 @@ const blockCategoryEnum = z$1.enum([
 	"layout",
 	"interactive"
 ]);
+const blockContentSourceSchema = z$1.object({
+	kind: z$1.enum([
+		"inline",
+		"entries",
+		"mixed"
+	]),
+	contentType: z$1.string().min(1).optional()
+}).superRefine((value, ctx) => {
+	if (value.kind === "inline" && value.contentType) ctx.addIssue({
+		code: z$1.ZodIssueCode.custom,
+		path: ["contentType"],
+		message: "contentType is not allowed when contentSource.kind is \"inline\""
+	});
+});
 z$1.object({
 	name: z$1.string().min(1),
 	version: z$1.string().min(1),
@@ -1672,6 +1704,12 @@ z$1.object({
 	}).optional()).optional(),
 	category: blockCategoryEnum.optional(),
 	contentTypes: z$1.array(z$1.string()).optional(),
+	/**
+	* Explicit content-source classification (inline / entries / mixed). Optional at the
+	* schema level for backward compatibility with SDK-defined custom blocks, but every
+	* registered SYSTEM block must declare it (enforced by a registry-wide test).
+	*/
+	contentSource: blockContentSourceSchema.optional(),
 	tags: z$1.array(z$1.string()).optional(),
 	icon: z$1.string().optional()
 });
@@ -3211,7 +3249,7 @@ function normalizeStoredObjectChildren(children, value, ctx) {
 	return normalized;
 }
 function normalizeStoredRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$1(value)) return value;
+	if (!isUnknownArray$2(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -3266,7 +3304,7 @@ function getAtFieldPath(source, path) {
 	}, source);
 }
 function normalizeRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$1(value)) return value;
+	if (!isUnknownArray$2(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -3641,7 +3679,7 @@ function isEmptyValue(value) {
 function isPlainObject$4(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isUnknownArray$1(value) {
+function isUnknownArray$2(value) {
 	return Array.isArray(value);
 }
 function isValidRichTextDoc(value) {
@@ -3863,6 +3901,14 @@ function relativeLuminance(r, g, b) {
 	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
 	return .2126 * R + .7152 * G + .0722 * B;
 }
+function contrastRatio(hex1, hex2) {
+	const { r: r1, g: g1, b: b1 } = hexToRgb(hex1);
+	const { r: r2, g: g2, b: b2 } = hexToRgb(hex2);
+	const L1 = relativeLuminance(r1, g1, b1);
+	const L2 = relativeLuminance(r2, g2, b2);
+	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
+	return (hi + .05) / (lo + .05);
+}
 //#endregion
 //#region ../theme-core/src/palette/utils/onColor.ts
 const BACKGROUND_ROLE_NAMES = /* @__PURE__ */ new Set([
@@ -4854,6 +4900,10 @@ const modernMinimalTheme = {
 				name: "primary",
 				hex: "#1f2937"
 			},
+			{
+				name: "primaryForeground",
+				hex: "#ffffff"
+			},
 			{
 				name: "secondary",
 				hex: "#6b7280"
@@ -4882,6 +4932,14 @@ const modernMinimalTheme = {
 				name: "surface",
 				hex: "#ffffff"
 			},
+			{
+				name: "surfaceAlt",
+				hex: "#f9fafb"
+			},
+			{
+				name: "muted",
+				hex: "#f3f4f6"
+			},
 			{
 				name: "text",
 				hex: "#1f2937"
@@ -8295,6 +8353,111 @@ function boundaryKey$1(previousBlockId, nextBlockId) {
 	return makeBoundaryId(previousBlockId, nextBlockId);
 }
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+/**
+* Exhaustive live policy for every registered effect id.
+*
+* The resolver consumes the transition payload directly, so adding an effect
+* cannot update classification without also defining its runtime behavior.
+*/
+const BUTTON_EFFECT_POLICIES = {
+	"darken-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "darker"
+		}
+	},
+	"lighten-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "lighter"
+		}
+	},
+	"background-on-hover": {
+		classification: "colour-transition",
+		transition: { kind: "replace-background" }
+	},
+	"background-on-hover-alpha": {
+		classification: "unsupported-colour",
+		reason: "alpha_requires_surface"
+	},
+	"fade-background": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"opacity-reduce": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"gradient-text": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"text-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"border-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_border"
+	},
+	"aurora-glow": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"cosmic-stardust": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"animated-gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"nav-underline": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-base": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-hover": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-active": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"animated-gradient": { classification: "non-colour" },
+	"border-glow": { classification: "non-colour" },
+	"drop-shadow": { classification: "non-colour" },
+	"inner-shadow": { classification: "non-colour" },
+	"neumorphic-shadow": { classification: "non-colour" },
+	"outer-glow": { classification: "non-colour" },
+	"retro-3d-shadow": { classification: "non-colour" },
+	"scale-up": { classification: "non-colour" },
+	"scale-down": { classification: "non-colour" },
+	lift: { classification: "non-colour" },
+	"press-down": { classification: "non-colour" },
+	pop: { classification: "non-colour" },
+	"border-bottom-grow": { classification: "non-colour" },
+	"sketchy-border": { classification: "non-colour" },
+	"pulse-animation": { classification: "non-colour" }
+};
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 /**
 * Standard semantic variant roles a theme exposes.
@@ -8324,6 +8487,20 @@ function asSpecialVariantId(value) {
 * Shared between generator and renderer so neither side hard-codes the string.
 */
 const DEFAULT_VARIANT_ALIAS_ID = "default";
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+const opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+	const token = parseOpaqueButtonColourToken(value);
+	if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+	return token;
+});
 const cornerStyleSchema = z$1.enum([
 	"square",
 	"rounded",
@@ -8425,7 +8602,7 @@ const buttonSizesSchema = z$1.object({
 	lg,
 	xl: xl ?? lg
 }));
-const buttonGlobalSettingsSchema = z$1.object({
+const canonicalButtonGlobalSettingsSchema = z$1.object({
 	cornerStyle: cornerStyleSchema,
 	cornerRadius: z$1.number().min(0).max(24).optional(),
 	/**
@@ -8456,11 +8633,12 @@ const buttonGlobalSettingsSchema = z$1.object({
 	paddingPreset: buttonPaddingPresetSchema.optional(),
 	hoverTransform: hoverTransformSchema,
 	hoverColor: hoverColorSchema,
-	hoverColorToken: themeColorTokenSchema.optional(),
+	hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 	gradientStyle: gradientStyleSchema.optional(),
 	gradientAngle: z$1.number().min(0).max(360).optional(),
 	gradientSharpness: gradientSharpnessSchema.optional()
 });
+const buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 const gradientDirectionSchema$1 = z$1.enum([
 	"to-r",
 	"to-l",
@@ -8474,27 +8652,33 @@ const gradientDirectionSchema$1 = z$1.enum([
 const buttonBackgroundSchema = z$1.discriminatedUnion("type", [
 	z$1.object({
 		type: z$1.literal("solid"),
-		colorToken: themeColorTokenSchema
+		colorToken: opaqueButtonColourTokenSchema
 	}),
 	z$1.object({
 		type: z$1.literal("gradient"),
-		stops: z$1.array(themeColorTokenSchema).min(2),
-		direction: gradientDirectionSchema$1
+		stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+			const [first, second, ...rest] = stops;
+			if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+			return [
+				first,
+				second,
+				...rest
+			];
+		}),
+		direction: gradientDirectionSchema$1,
+		foregroundToken: opaqueButtonColourTokenSchema
 	}),
-	z$1.object({ type: z$1.literal("transparent") })
+	z$1.object({
+		type: z$1.literal("surface"),
+		role: z$1.literal("link")
+	})
 ]);
 const effectApplicationSchema$1 = z$1.object({
 	effectId: z$1.string(),
-	options: z$1.record(z$1.string(), z$1.any()).optional()
-});
-const buttonBorderSchema = z$1.object({
-	widthClass: z$1.string(),
-	colorToken: themeColorTokenSchema
-});
-const buttonVariantAffordanceSchema = z$1.object({
-	iconId: z$1.string().min(1),
-	colorToken: themeColorTokenSchema.optional()
+	options: z$1.record(z$1.string(), z$1.json()).optional()
 });
+const buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+const buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 const variantShadowSchema = z$1.object({
 	elevation: z$1.enum([
 		"none",
@@ -8535,27 +8719,170 @@ const variantSizeOverridesSchema = z$1.object({
 * default (e.g. link-style variants declaring zero horizontal padding at
 * every size).
 */
-const buttonVariantSchema = z$1.object({
+const canonicalButtonVariantSchema = z$1.object({
 	id: z$1.string(),
 	name: z$1.string().min(1).max(20),
 	enabled: z$1.boolean(),
 	priority: prioritySchema,
 	background: buttonBackgroundSchema,
-	textColorToken: themeColorTokenSchema,
 	/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 	borderRadius: z$1.string().optional(),
 	shadow: variantShadowSchema.optional(),
 	border: buttonBorderSchema.optional(),
-	hoverBackgroundToken: z$1.string().optional(),
+	hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 	effects: variantEffectsSchema.optional(),
 	sizes: variantSizeOverridesSchema.optional(),
 	affordance: buttonVariantAffordanceSchema.optional()
 });
+/**
+* Temporary persisted-theme admission boundary for issue #1206.
+*
+* Production inventory on 2026-07-22 found 22 rows using the old independent
+* `textColorToken`/border colour shape. New source and all downstream code use
+* only the canonical relationship. Delete this preprocessor after the reviewed
+* production rewrite reports zero legacy rows.
+*/
+const buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 const buttonSystemSchema = z$1.object({
 	global: buttonGlobalSettingsSchema,
 	variants: z$1.array(buttonVariantSchema).min(1).max(6),
 	sizes: buttonSizesSchema.optional()
 });
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray$1(background.stops) ? background.stops : [];
+	return [
+		input.hoverBackgroundToken,
+		background.colorToken,
+		background.foregroundToken,
+		...stops
+	].some((token) => stripLegacyTokenAlpha(token) !== token);
+}
+function stripLegacyTokenAlpha(value) {
+	if (typeof value !== "string") return value;
+	const slashIndex = value.indexOf("/");
+	return slashIndex < 0 ? value : value.slice(0, slashIndex);
+}
+function hasLegacyButtonEffects(input) {
+	if (!isUnknownRecord(input)) return false;
+	return [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	].some((state) => {
+		const effects = input[state];
+		return Array.isArray(effects) && effects.some((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return true;
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification !== "colour-transition" && classification !== "non-colour") return true;
+			return effect.effectId === "background-on-hover" && isUnknownRecord(effect.options) && stripLegacyTokenAlpha(effect.options.colorToken) !== effect.options.colorToken;
+		});
+	});
+}
+function normalizeLegacyButtonEffects(input, backgroundType) {
+	if (!isUnknownRecord(input)) return input;
+	const normalized = {};
+	for (const state of [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	]) {
+		const effects = input[state];
+		if (!Array.isArray(effects)) continue;
+		const safeEffects = effects.flatMap((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return [];
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification === "non-colour") return [effect];
+			if (classification !== "colour-transition") return [];
+			if (effect.effectId === "background-on-hover") {
+				const options = isUnknownRecord(effect.options) ? effect.options : null;
+				const colorToken = options === null ? null : parseOpaqueButtonColourToken(stripLegacyTokenAlpha(options.colorToken));
+				return colorToken === null ? [] : [{
+					...effect,
+					options: {
+						...options,
+						colorToken
+					}
+				}];
+			}
+			if (backgroundType !== "solid") return [];
+			const rawAmount = isUnknownRecord(effect.options) ? effect.options.amount : void 0;
+			const amount = typeof rawAmount === "number" && rawAmount > 0 ? Math.max(100, Math.round(rawAmount / 100) * 100) : 100;
+			return [{
+				...effect,
+				options: {
+					...isUnknownRecord(effect.options) ? effect.options : {},
+					amount
+				}
+			}];
+		});
+		if (safeEffects.length > 0) normalized[state] = safeEffects;
+	}
+	return Object.keys(normalized).length === 0 ? void 0 : normalized;
+}
+function isUnknownRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownArray$1(value) {
+	return Array.isArray(value);
+}
 //#endregion
 //#region ../theme-core/src/buttons/personalities/types.ts
 function asButtonPersonalityId(value) {
@@ -8581,7 +8908,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 //#endregion
@@ -8634,19 +8961,15 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["primary", "accent"],
-					direction: "to-r"
+					direction: "to-r",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "secondary",
@@ -8656,32 +8979,27 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["secondary", "accent"],
-					direction: "to-br"
+					direction: "to-br",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "outline",
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -8692,8 +9010,10 @@ const brushedWash = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-lg",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -8739,7 +9059,6 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				shadow: {
 					elevation: "medium",
@@ -8749,7 +9068,7 @@ const confidentChip = defineButtonPersonality({
 				effects: {
 					hover: [{
 						effectId: "darken-background",
-						options: { amount: 60 }
+						options: { amount: 100 }
 					}],
 					active: [{
 						effectId: "scale-down",
@@ -8766,12 +9085,8 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "surface"
 				},
-				textColorToken: "text",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -8782,13 +9097,12 @@ const confidentChip = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -8799,8 +9113,10 @@ const confidentChip = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-md",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -8863,7 +9179,6 @@ const earthPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -8889,13 +9204,12 @@ const earthPill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -8906,13 +9220,12 @@ const earthPill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surfaceAlt" }
@@ -8923,8 +9236,10 @@ const earthPill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "none",
@@ -8945,11 +9260,7 @@ const earthPill = defineButtonPersonality({
 						padding: "0.625rem 0",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 25 }
-				}] }
+				}
 			}
 		]
 	}
@@ -8985,8 +9296,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Primary",
 				enabled: true,
 				priority: 1,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -9008,8 +9321,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -9031,8 +9346,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -9054,19 +9371,17 @@ const editorialLink = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
 					md: { padding: "0.5rem 0" },
 					lg: { padding: "0.625rem 0" },
 					xl: { padding: "0.75rem 0" }
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -20 }
-				}] }
+				}
 			}
 		]
 	}
@@ -9128,12 +9443,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accent"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -9147,13 +9458,12 @@ const flatInk = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -9171,12 +9481,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "accent"
 				},
-				textColorToken: "accentForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accentForeground"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -9239,7 +9545,6 @@ const inkStamp = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				effects: {
 					hover: [{
@@ -9260,13 +9565,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -9277,13 +9581,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -9294,8 +9597,10 @@ const inkStamp = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -9388,7 +9693,6 @@ const joyStamp = defineButtonPersonality({
 				type: "solid",
 				colorToken: "primary"
 			},
-			textColorToken: "primaryForeground",
 			borderRadius: "rounded-full",
 			shadow: {
 				elevation: "high",
@@ -9402,13 +9706,12 @@ const joyStamp = defineButtonPersonality({
 			name: "Secondary",
 			enabled: true,
 			priority: 2,
-			background: { type: "transparent" },
-			textColorToken: "text",
-			borderRadius: "rounded-full",
-			border: {
-				widthClass: "border-2",
-				colorToken: "text"
+			background: {
+				type: "surface",
+				role: "link"
 			},
+			borderRadius: "rounded-full",
+			border: { widthClass: "border-2" },
 			shadow: {
 				elevation: "high",
 				softness: "hard",
@@ -9473,12 +9776,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: {
 					hover: [{
 						effectId: "background-on-hover",
@@ -9499,12 +9798,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -9515,13 +9810,12 @@ const ornateRitual = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -9532,8 +9826,10 @@ const ornateRitual = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -9615,14 +9911,10 @@ const pebble = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 88
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -9630,13 +9922,12 @@ const pebble = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "accent"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "accent" }
@@ -9647,13 +9938,12 @@ const pebble = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -9664,8 +9954,10 @@ const pebble = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				sizes: {
 					sm: {
@@ -9681,11 +9973,7 @@ const pebble = defineButtonPersonality({
 						padding: "0.75rem 1.5rem",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 30 }
-				}] }
+				}
 			}
 		]
 	}
@@ -9747,15 +10035,11 @@ const quietArrow = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-xl",
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 90
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -9763,13 +10047,12 @@ const quietArrow = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-xl",
+				border: { widthClass: "border" },
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -9781,21 +10064,22 @@ const quietArrow = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				}
+				border: { widthClass: "border" }
 			},
 			{
 				id: "ghost",
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl"
 			}
 		]
@@ -9859,7 +10143,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "background",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -9868,13 +10151,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{ effectId: "pop" }] }
 			},
 			{
@@ -9886,7 +10168,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -9899,12 +10180,8 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "background"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -9915,13 +10192,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -9932,8 +10208,10 @@ const showtimePill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -9944,104 +10222,151 @@ const showtimePill = defineButtonPersonality({
 	}
 });
 //#endregion
-//#region ../theme-core/src/buttons/personalities/index.ts
-const buttonPersonalities = [
-	defineButtonPersonality({
-		id: "soft-pill",
-		name: "Soft Pill",
-		description: "Rounded pills with a gentle lift on hover. Quietly modern.",
-		tags: {
-			tone: "classic",
-			energy: "calm",
-			motion: "subtle",
-			era: "organic"
+//#region ../theme-core/src/buttons/personalities/soft-pill.ts
+/**
+* Soft Pill — rounded-full pill buttons with a hover lift. The default for
+* Calm Studio and Modern Wellness; reads as quietly modern and welcoming.
+*/
+const softPill = defineButtonPersonality({
+	id: "soft-pill",
+	name: "Soft Pill",
+	description: "Rounded pills with a gentle lift on hover. Quietly modern.",
+	tags: {
+		tone: "classic",
+		energy: "calm",
+		motion: "subtle",
+		era: "organic"
+	},
+	buttonSystem: {
+		global: {
+			cornerStyle: "pill",
+			shadow: "low",
+			textTransform: "none",
+			fontWeight: 500,
+			borderWidth: 2,
+			hoverTransform: "lift",
+			hoverColor: "none"
 		},
-		buttonSystem: {
-			global: {
-				cornerStyle: "pill",
-				shadow: "low",
-				textTransform: "none",
-				fontWeight: 500,
-				borderWidth: 2,
-				hoverTransform: "lift",
-				hoverColor: "none"
+		variants: [
+			{
+				id: "primary",
+				name: "Primary",
+				enabled: true,
+				priority: 1,
+				background: {
+					type: "solid",
+					colorToken: "primary"
+				},
+				borderRadius: "rounded-full",
+				shadow: {
+					elevation: "low",
+					softness: "soft",
+					position: "bottom"
+				},
+				effects: {
+					hover: [{
+						effectId: "lift",
+						options: { translateY: "-1px" }
+					}],
+					active: [{
+						effectId: "scale-down",
+						options: { scale: "0.98" }
+					}]
+				}
 			},
-			variants: [
-				{
-					id: "primary",
-					name: "Primary",
-					enabled: true,
-					priority: 1,
-					background: {
-						type: "solid",
-						colorToken: "primary"
-					},
-					textColorToken: "primaryForeground",
-					borderRadius: "rounded-full",
-					shadow: {
-						elevation: "low",
-						softness: "soft",
-						position: "bottom"
-					},
-					effects: {
-						hover: [{
-							effectId: "lift",
-							options: { translateY: "-1px" }
-						}],
-						active: [{
-							effectId: "scale-down",
-							options: { scale: "0.98" }
-						}]
-					}
+			{
+				id: "secondary",
+				name: "Secondary",
+				enabled: true,
+				priority: 2,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "secondary",
-					name: "Secondary",
-					enabled: true,
-					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
-					},
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			},
+			{
+				id: "outline",
+				name: "Outline",
+				enabled: true,
+				priority: 3,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "outline",
-					name: "Outline",
-					enabled: true,
-					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
-					},
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			},
+			{
+				id: "ghost",
+				name: "Ghost",
+				enabled: true,
+				priority: 3,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "ghost",
-					name: "Ghost",
-					enabled: true,
-					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
-				}
-			]
+				borderRadius: "rounded-full",
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			}
+		]
+	}
+});
+//#endregion
+//#region ../theme-core/src/buttons/personalities/two-tone-pill.ts
+const solidSecondary = {
+	id: "secondary",
+	name: "Secondary",
+	enabled: true,
+	priority: 2,
+	background: {
+		type: "solid",
+		colorToken: unsafeAsOpaqueButtonColourToken("secondary")
+	},
+	borderRadius: "rounded-full",
+	shadow: {
+		elevation: "none",
+		softness: null,
+		position: "bottom"
+	},
+	effects: {
+		hover: [{
+			effectId: "background-on-hover-alpha",
+			options: {
+				colorToken: "secondary",
+				opacity: 88
+			}
+		}],
+		active: [{
+			effectId: "scale-down",
+			options: { scale: "0.98" }
+		}]
+	}
+};
+//#endregion
+//#region ../theme-core/src/buttons/personalities/index.ts
+const buttonPersonalities = [
+	softPill,
+	defineButtonPersonality({
+		id: "two-tone-pill",
+		name: "Two-tone Pill",
+		description: "Rounded pills with distinct solid primary and secondary brand colours.",
+		tags: softPill.tags,
+		buttonSystem: {
+			...softPill.buttonSystem,
+			variants: softPill.buttonSystem.variants.map((variant) => variant.id === "secondary" ? solidSecondary : variant)
 		}
 	}),
 	earthPill,
@@ -10442,6 +10767,282 @@ const serifDisplayQuote = { style: "serif-display" };
 /** Punchy quotation mark in the secondary accent colour. Bold / accent styles. */
 const accentGlyphQuote = { style: "accent-glyph" };
 //#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+/**
+* Gradient color stop
+*/
+const gradientStopSchema = z$1.object({
+	color: themeColorTokenSchema,
+	position: z$1.number().min(0).max(100)
+});
+/**
+* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
+* so existing radial gradients are byte-identical.
+*
+* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
+* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
+*/
+const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+/**
+* Gradient configuration.
+*
+* `type` is optional and defaults to `'linear'` so gradients persisted without a
+* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
+* `'conic'` are additive kinds:
+*   - linear: `angle` (degrees)
+*   - radial: optional `shape` (circle/ellipse) + `position`
+*   - conic:  optional `angle` (from-angle, degrees) + `position`
+*/
+const gradientConfigSchema = z$1.object({
+	type: z$1.enum([
+		"linear",
+		"radial",
+		"conic"
+	]).default("linear"),
+	angle: z$1.number().min(0).max(360).optional(),
+	shape: radialGradientShapeSchema.optional(),
+	position: z$1.string().optional(),
+	stops: z$1.array(gradientStopSchema).min(2)
+});
+/**
+* Curated library of gradient presets.
+* All gradients use theme color tokens, so they adapt to the site's palette.
+*/
+const GRADIENT_PRESETS = [
+	{
+		id: "primary-secondary",
+		name: "Primary to Secondary",
+		description: "Blend your primary and secondary brand colors",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "secondary-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-accent",
+		name: "Primary to Accent",
+		description: "Energetic gradient from primary to accent",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-accent",
+		name: "Secondary to Accent",
+		description: "Vibrant secondary to accent blend",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-light-dark",
+		name: "Primary Light to Dark",
+		description: "Subtle primary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "primary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-dark-light",
+		name: "Primary Dark to Light",
+		description: "Reverse primary fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-50",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-light-dark",
+		name: "Secondary Light to Dark",
+		description: "Subtle secondary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "secondary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "accent-light-dark",
+		name: "Accent Light to Dark",
+		description: "Accent color depth fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "accent-500",
+			position: 0
+		}, {
+			color: "accent-900",
+			position: 100
+		}]
+	},
+	{
+		id: "background-surface",
+		name: "Background to Surface",
+		description: "Subtle depth using base colors",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "background",
+			position: 0
+		}, {
+			color: "surface",
+			position: 100
+		}]
+	},
+	{
+		id: "neutral-fade",
+		name: "Neutral Gradient",
+		description: "Elegant neutral color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "neutral-900",
+			position: 0
+		}, {
+			color: "neutral-50",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-glow",
+		name: "Primary glow",
+		description: "A soft top-centred glow using your primary palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onPrimary900",
+			headingColor: "onPrimary900",
+			linkColor: "onPrimary900",
+			supportingColor: "onPrimary900"
+		}
+	},
+	{
+		id: "accent-glow",
+		name: "Accent glow",
+		description: "A soft top-centred glow using your accent palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "accent-900",
+			position: 0
+		}, {
+			color: "accent-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onAccent900",
+			headingColor: "onAccent900",
+			linkColor: "onAccent900",
+			supportingColor: "onAccent900"
+		}
+	},
+	{
+		id: "primary-secondary-accent",
+		name: "Brand Trio",
+		description: "All three brand colors in harmony",
+		type: "linear",
+		angle: 135,
+		stops: [
+			{
+				color: "primary-500",
+				position: 0
+			},
+			{
+				color: "secondary-500",
+				position: 50
+			},
+			{
+				color: "accent-500",
+				position: 100
+			}
+		]
+	}
+].map((preset) => ({
+	...preset,
+	id: preset.id,
+	stops: preset.stops
+}));
+const GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+const gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+const gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+function getGradientPreset(id) {
+	return gradientPresetById[id];
+}
+//#endregion
+//#region ../theme-core/src/gradients/utils.ts
+/**
+* Convert a GradientConfig to a CSS gradient string
+*
+* @param config - The gradient configuration using theme tokens
+* @param tokens - Map of theme color tokens to hex values
+* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
+*/
+function gradientToCss(config, tokens) {
+	const stops = config.stops.map((stop) => {
+		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
+	}).join(", ");
+	const type = config.type ?? "linear";
+	if (type === "radial") {
+		const position = config.position ?? "center";
+		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
+	}
+	if (type === "conic") {
+		const position = config.position ?? "center";
+		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
+	}
+	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
+}
+//#endregion
 //#region ../theme-core/src/site-styles/logoBranding.ts
 const logoTextConfidenceValues = [
 	"low",
@@ -10665,7 +11266,7 @@ const overlayLogoAccommodations = [
 * optional nested styling fields that would otherwise leak from another Look.
 */
 function baseHeader(theme) {
-	const { navLinkStyle: _navLinkStyle, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
+	const { navLinkStyle: _navLinkStyle, navFontRole: _navFontRole, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
 	return {
 		...header,
 		navContainer: {
@@ -10814,6 +11415,17 @@ const headerStyleCatalog = defineExactCatalog()([
 		navTypography: "brand-caps",
 		moods: ["expressive"]
 	},
+	{
+		id: asHeaderStyleId("brand-capsule"),
+		label: "Brand Capsule",
+		description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.",
+		supportedLayoutIds: supportedLayouts(["classic"]),
+		navInteraction: "pill-background",
+		surface: "brand-solid",
+		defaultDepth: "shadow",
+		navTypography: "quiet-caps",
+		moods: ["expressive", "professional"]
+	},
 	{
 		id: asHeaderStyleId("serif-line"),
 		label: "Serif Line",
@@ -10907,6 +11519,7 @@ const headerStyleCompatibilityOrder = /* @__PURE__ */ new Map([
 		"brand-bar",
 		"brand-underline",
 		"brand-pill",
+		"brand-capsule",
 		"serif-line",
 		"flat-tabs"
 	])],
@@ -10944,6 +11557,11 @@ headerStyleRepairChain([
 	"brand-pill",
 	"brand-bar",
 	"minimal"
+]), headerStyleRepairChain([
+	"brand-capsule",
+	"brand-pill",
+	"brand-bar",
+	"minimal"
 ]), headerStyleRepairChain([
 	"pill-nav",
 	"soft-bar",
@@ -12750,14 +13368,12 @@ const backgroundOnHoverEffect = {
 		]
 	},
 	generateCSS: (ctx) => {
-		const { themeId, variantId, options, tokens } = ctx;
+		const { themeId, variantId, options, tokens, buttonConfig } = ctx;
 		const colorToken = options.colorToken || "neutral-800";
-		const color = tokens.getColor(colorToken);
-		const textColorToken = typeof options.textColorToken === "string" ? options.textColorToken : null;
 		return `
       /* Add background on hover */
       :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${color};${textColorToken ? `\n        color: ${tokens.getColor(textColorToken)};` : ""}
+        background-color: ${tokens.getColor(colorToken)};${"textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : ""}
       }
     `;
 	}
@@ -12781,10 +13397,10 @@ const backgroundOnHoverAlphaEffect = {
 		default: 50
 	},
 	generateCSS: (ctx) => {
-		const { themeId, variantId, stateGroup, options, buttonConfig } = ctx;
+		const { themeId, variantId, stateGroup, options } = ctx;
 		const rawOpacity = options.opacity;
 		const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
-		const cssVar = `var(--tb-${options.colorToken || buttonConfig.textColorToken || "neutral-800"})`;
+		const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
 		return `
       /* Add semi-transparent background (${stateGroup}) */
       :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
@@ -12997,7 +13613,7 @@ const outerGlowEffect = {
 		const spread = options.spread || 10;
 		let glowColor;
 		if (options.glowColorToken && typeof options.glowColorToken === "string") glowColor = tokens.getColor(options.glowColorToken);
-		else if (buttonConfig.border?.colorToken) glowColor = tokens.getColor(buttonConfig.border.colorToken);
+		else if (buttonConfig.border) glowColor = "colorToken" in buttonConfig.border ? tokens.getColor(buttonConfig.border.colorToken) : "currentColor";
 		else if (buttonConfig.background.type === "solid") glowColor = tokens.getColor(buttonConfig.background.colorToken ?? "primary-400");
 		else glowColor = tokens.getColor("primary-400");
 		return `
@@ -13987,31 +14603,6 @@ function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elem
 	return effectPreset.generateCSS(ctx);
 }
 //#endregion
-//#region ../theme-core/src/buttons/utils/contrast.ts
-/**
-* Get contrasting text color for a button background
-*
-* This function returns theme-aware text colors using the neutral scale,
-* which is guaranteed to exist in every theme and harmonizes with the design.
-*
-* Uses neutral-50 (lightest) for dark backgrounds and neutral-950 (darkest)
-* for light backgrounds. This ensures excellent contrast while respecting
-* the theme's neutral palette (warm/cool tinting).
-*
-* For solid backgrounds with primary/secondary/neutral colors:
-* - Dark backgrounds (shade >= 500): neutral-50 (very light)
-* - Light backgrounds (shade < 500): neutral-950 (very dark)
-*/
-function getContrastingTextColorToken(backgroundToken, theme) {
-	const isLightTheme = theme.palette.meta.mode === "light";
-	if (backgroundToken.startsWith("primary-") || backgroundToken.startsWith("secondary-")) return "neutral-50";
-	if (backgroundToken.startsWith("neutral-")) {
-		const match = backgroundToken.match(/neutral-(\d+)/);
-		if (match?.[1]) return parseInt(match[1], 10) >= 500 ? "neutral-50" : "neutral-950";
-	}
-	return isLightTheme ? "neutral-50" : "neutral-950";
-}
-//#endregion
 //#region ../theme-core/src/buttons/generateDefaultButtonSystem.ts
 /**
 * Map border width to border width class
@@ -14068,13 +14659,8 @@ function generateDefaultButtonSystem(theme) {
 			priority: 1,
 			background: {
 				type: "solid",
-				colorToken: "primary"
-			},
-			textColorToken: getContrastingTextColorToken("primary", theme),
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+				colorToken: unsafeAsOpaqueButtonColourToken("primary")
+			}
 		},
 		{
 			id: "secondary",
@@ -14083,51 +14669,39 @@ function generateDefaultButtonSystem(theme) {
 			priority: 2,
 			background: {
 				type: "solid",
-				colorToken: "neutral-700"
-			},
-			textColorToken: getContrastingTextColorToken("neutral-700", theme),
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+				colorToken: unsafeAsOpaqueButtonColourToken("neutral-700")
+			}
 		},
 		{
 			id: "outline",
 			name: "Outline",
 			enabled: true,
 			priority: 3,
-			background: { type: "transparent" },
-			textColorToken: "primary",
+			background: {
+				type: "surface",
+				role: "link"
+			},
 			shadow: {
 				elevation: "none",
 				softness: null,
 				position: "bottom"
 			},
-			border: {
-				colorToken: "primary",
-				widthClass: borderWidthClass
-			},
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+			border: { widthClass: borderWidthClass }
 		},
 		{
 			id: "ghost",
 			name: "Ghost",
 			enabled: true,
 			priority: 3,
-			background: { type: "transparent" },
-			textColorToken: "primary",
+			background: {
+				type: "surface",
+				role: "link"
+			},
 			shadow: {
 				elevation: "none",
 				softness: null,
 				position: "bottom"
-			},
-			effects: { hover: [{
-				effectId: "opacity-reduce",
-				options: { reduction: 15 }
-			}] }
+			}
 		}
 	];
 	return {
@@ -14183,6 +14757,472 @@ function affordanceIconMaskUrl(iconId) {
 	return `data:image/svg+xml,${`<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'>${paths.map((d) => `<path d='${d}'/>`).join("")}</svg>`.replace(/"/g, "'").replace(/#/g, "%23").replace(/</g, "%3C").replace(/>/g, "%3E").replace(/\s+/g, " ")}`;
 }
 //#endregion
+//#region ../theme-core/src/surfaces/foregroundRoles.ts
+const SURFACE_FOREGROUND_ROLES = [
+	"text",
+	"heading",
+	"link",
+	"supporting"
+];
+//#endregion
+//#region ../theme-core/src/surfaces/foregroundContract.ts
+const SURFACE_FOREGROUND_CSS_VARS = {
+	text: "--rb-surface-text-color",
+	heading: "--rb-surface-heading-color",
+	link: "--rb-surface-link-color",
+	supporting: "--rb-surface-supporting-color"
+};
+const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+const DEFAULT_ROLE_FALLBACKS = {
+	text: DEFAULT_SURFACE_TEXT_COLOR,
+	heading: DEFAULT_SURFACE_TEXT_COLOR,
+	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
+	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
+};
+function requireSurfaceColorValue(role, value) {
+	const normalized = value.trim();
+	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
+	return normalized;
+}
+function completeSurfaceForegrounds(input) {
+	const text = requireSurfaceColorValue("text", input.text);
+	return {
+		text,
+		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
+		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
+	};
+}
+function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
+	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
+	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
+	if (role === "text") return `var(${roleVariable}, ${fallback})`;
+	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
+}
+function surfaceForegroundValueWithOpacity(role, opacityPercent) {
+	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
+	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
+}
+function surfaceForegroundStyle(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return {
+		color: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
+		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
+		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
+	};
+}
+function surfaceForegroundDeclarations(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+const BUTTON_VISUAL_STATES = [
+	"base",
+	"hover",
+	"focus",
+	"active",
+	"disabled"
+];
+const BUTTON_CONTRAST_POLICY = {
+	textMinimumRatio: 4.5,
+	nonTextMinimumRatio: 3,
+	gradientSamplesPerSegment: 20,
+	alphaBackgrounds: "reject-without-known-surface",
+	disabled: "retain-full-colour-contract"
+};
+function compileButtonColourStates(input) {
+	const baseTransition = applyColourEffects({
+		variantId: input.variant.id,
+		state: "base",
+		treatment: input.variant.background,
+		effects: input.variant.effects?.base,
+		palette: input.palette
+	});
+	if (!baseTransition.ok) return baseTransition;
+	const stateTreatments = {
+		base: baseTransition.treatment,
+		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
+		focus: baseTransition.treatment,
+		active: baseTransition.treatment,
+		disabled: baseTransition.treatment
+	};
+	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) {
+		const transition = applyColourEffects({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			effects: input.variant.effects?.[state],
+			palette: input.palette
+		});
+		if (!transition.ok) return transition;
+		stateTreatments[state] = transition.treatment;
+		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
+	}
+	const resolved = {};
+	for (const state of BUTTON_VISUAL_STATES) {
+		const result = resolveTreatment$1({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			palette: input.palette
+		});
+		if (!result.ok) return result;
+		resolved[state] = result.colour;
+	}
+	return {
+		ok: true,
+		states: resolved,
+		focusIndicator: resolveFocusIndicator(resolved.focus),
+		nonColourEffects
+	};
+}
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function hoverTreatment(variant, global, fallback) {
+	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
+	return token === void 0 ? fallback : {
+		type: "solid",
+		colorToken: token
+	};
+}
+function applyColourEffects(input) {
+	let treatment = input.treatment;
+	const nonColourEffects = [];
+	for (const effect of input.effects ?? []) {
+		const policy = getButtonEffectPolicy(effect.effectId);
+		if (policy === null) return unknownEffect(input, effect);
+		switch (policy.classification) {
+			case "non-colour":
+				nonColourEffects.push(effect);
+				break;
+			case "unsupported-colour":
+			case "unsupported-background-overlay":
+			case "not-button": return unsupportedEffect(input, effect, policy.reason);
+			case "colour-transition":
+				if (policy.transition.kind === "adjust-shade") {
+					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
+					const amount = readShadeAmount(effect);
+					if (amount === null) return invalidEffectOption(input, effect, "amount");
+					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
+					treatment = {
+						type: "solid",
+						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
+					};
+					break;
+				}
+				if (policy.transition.kind === "replace-background") {
+					const colorToken = readOpaqueToken(effect, "colorToken", "neutral-800");
+					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
+					treatment = {
+						type: "solid",
+						colorToken
+					};
+					break;
+				}
+				return unknownEffect(input, effect);
+		}
+	}
+	return {
+		ok: true,
+		treatment,
+		nonColourEffects
+	};
+}
+function resolveTreatment$1(input) {
+	const treatment = input.treatment;
+	switch (treatment.type) {
+		case "surface": return {
+			ok: true,
+			colour: {
+				kind: "surface",
+				role: treatment.role,
+				backgroundCss: "transparent",
+				foregroundCss: surfaceForegroundValue(treatment.role)
+			}
+		};
+		case "solid": return resolveSolid(input, treatment.colorToken);
+		case "gradient": return resolveGradient(input, treatment);
+	}
+}
+function resolveFocusIndicator(colour) {
+	switch (colour.kind) {
+		case "solid": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: colour.backgroundCss,
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "gradient": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: tokenCss(colour.backgroundTokens[0]),
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "surface": return {
+			kind: "surface-role",
+			colorCss: colour.foregroundCss,
+			minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+		};
+	}
+}
+function resolveSolid(input, backgroundToken) {
+	const backgroundHex = paletteHex(input, backgroundToken);
+	if (!backgroundHex.ok) return backgroundHex;
+	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
+	const foregroundHex = input.palette[foregroundToken];
+	if (typeof foregroundHex !== "string") return {
+		ok: false,
+		error: {
+			tag: "missing_on_colour",
+			variantId: input.variantId,
+			state: input.state,
+			backgroundToken,
+			foregroundToken
+		}
+	};
+	const contrast = validateContrast({
+		...input,
+		background: backgroundToken,
+		backgroundHex: backgroundHex.hex,
+		foreground: foregroundToken,
+		foregroundHex
+	});
+	if (!contrast.ok) return contrast;
+	return {
+		ok: true,
+		colour: {
+			kind: "solid",
+			backgroundToken,
+			foregroundToken,
+			backgroundCss: tokenCss(backgroundToken),
+			foregroundCss: tokenCss(foregroundToken)
+		}
+	};
+}
+function resolveGradient(input, treatment) {
+	const foregroundHex = paletteHex(input, treatment.foregroundToken);
+	if (!foregroundHex.ok) return foregroundHex;
+	const stopHexes = [];
+	for (const token of treatment.stops) {
+		const stop = paletteHex(input, token);
+		if (!stop.ok) return stop;
+		stopHexes.push(stop.hex);
+	}
+	for (let segment = 0; segment < stopHexes.length - 1; segment += 1) {
+		const start = stopHexes[segment];
+		const end = stopHexes[segment + 1];
+		const startToken = treatment.stops[segment];
+		const endToken = treatment.stops[segment + 1];
+		if (start === void 0 || end === void 0 || startToken === void 0 || endToken === void 0) continue;
+		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
+			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
+			const sampleHex = interpolateHex(start, end, position);
+			const contrast = validateContrast({
+				...input,
+				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
+				backgroundHex: sampleHex,
+				foreground: treatment.foregroundToken,
+				foregroundHex: foregroundHex.hex
+			});
+			if (!contrast.ok) return contrast;
+		}
+	}
+	const direction = GRADIENT_DIRECTION_MAP$1[treatment.direction] ?? "to right";
+	return {
+		ok: true,
+		colour: {
+			kind: "gradient",
+			backgroundTokens: treatment.stops,
+			foregroundToken: treatment.foregroundToken,
+			backgroundCss: `linear-gradient(${direction}, ${treatment.stops.map(tokenCss).join(", ")})`,
+			foregroundCss: tokenCss(treatment.foregroundToken)
+		}
+	};
+}
+function paletteHex(input, token) {
+	const hex = input.palette[token];
+	return typeof hex === "string" ? {
+		ok: true,
+		hex
+	} : {
+		ok: false,
+		error: {
+			tag: "unknown_palette_token",
+			variantId: input.variantId,
+			state: input.state,
+			token
+		}
+	};
+}
+function validateContrast(input) {
+	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			background: input.background,
+			foreground: input.foreground,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		}
+	};
+}
+function tokenCss(token) {
+	return `rgb(var(--tb-${token}))`;
+}
+function adjustShade(token, amount, palette) {
+	const match = token.match(/^(.*)-(\d{2,3})$/);
+	const base = match?.[1] ?? token;
+	const currentShade = match?.[2] === void 0 ? 500 : Number(match[2]);
+	const availableShades = [
+		50,
+		100,
+		200,
+		300,
+		400,
+		500,
+		600,
+		700,
+		800,
+		900,
+		950
+	].filter((shade) => typeof palette[`${base}-${shade}`] === "string");
+	if (availableShades.length === 0) return token;
+	const firstShade = availableShades[0];
+	if (firstShade === void 0) return token;
+	const exactIndex = availableShades.indexOf(currentShade);
+	const startingIndex = exactIndex >= 0 ? exactIndex : availableShades.indexOf(availableShades.reduce((closestShade, shade) => Math.abs(shade - currentShade) < Math.abs(closestShade - currentShade) ? shade : closestShade, firstShade));
+	const stepCount = Math.abs(amount) / 100;
+	const direction = amount < 0 ? -1 : 1;
+	const targetShade = availableShades[Math.max(0, Math.min(availableShades.length - 1, startingIndex + direction * stepCount))];
+	return targetShade === void 0 ? token : unsafeAsOpaqueButtonColourToken(`${base}-${targetShade}`);
+}
+function readShadeAmount(effect) {
+	const value = effect.options?.amount ?? 100;
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value % 100 === 0 ? value : null;
+}
+function readOpaqueToken(effect, key, fallback) {
+	return parseOpaqueButtonColourToken(effect.options?.[key] ?? fallback);
+}
+function unsupportedEffect(input, effect, reason) {
+	return {
+		ok: false,
+		error: {
+			tag: "unsupported_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			reason
+		}
+	};
+}
+function invalidEffectOption(input, effect, option) {
+	return {
+		ok: false,
+		error: {
+			tag: "invalid_colour_effect_options",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			option
+		}
+	};
+}
+function inapplicableEffect(input, effect, treatment) {
+	return {
+		ok: false,
+		error: {
+			tag: "inapplicable_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			treatment: treatment.type
+		}
+	};
+}
+function unknownEffect(input, effect) {
+	return {
+		ok: false,
+		error: {
+			tag: "unknown_button_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId
+		}
+	};
+}
+function interpolateHex(startHex, endHex, position) {
+	const start = hexToRgb(startHex);
+	const end = hexToRgb(endHex);
+	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
+	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolvedButtonCss.ts
+/**
+* Canonical colour declaration mapping shared by full themes and ThemeBridge.
+* Both background properties are always emitted so transitions cannot retain
+* a stale gradient or solid layer.
+*/
+function resolvedButtonColourDeclarations(colour) {
+	switch (colour.kind) {
+		case "solid": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+		case "gradient": return [
+			["background-color", "transparent"],
+			["background-image", colour.backgroundCss],
+			["color", colour.foregroundCss]
+		];
+		case "surface": return [
+			["background-color", colour.backgroundCss],
+			["background-image", "none"],
+			["color", colour.foregroundCss]
+		];
+	}
+}
+function resolvedButtonFocusDeclarations(indicator) {
+	return indicator.kind === "two-tone" ? [
+		["outline", `2px solid ${indicator.innerCss}`],
+		["outline-offset", "2px"],
+		["box-shadow", `0 0 0 4px ${indicator.outerCss}`]
+	] : [["outline", `3px solid ${indicator.colorCss}`], ["outline-offset", "3px"]];
+}
+/**
+* Disabled buttons retain their validated colour pair and add a non-layout
+* visual affordance. `currentColor` keeps the cue inside the same contrast
+* relationship, while retaining pointer events lets the not-allowed cursor
+* remain observable.
+*/
+const RESOLVED_BUTTON_DISABLED_DECLARATIONS = [
+	["cursor", "not-allowed"],
+	["transform", "none"],
+	["box-shadow", "none"],
+	["outline", "2px dashed currentColor"],
+	["outline-offset", "-4px"]
+];
+//#endregion
 //#region ../theme-core/src/buttons/generateButtonCss.ts
 /**
 * Class the `button` runtime node adds when it renders its own trailing icon,
@@ -14249,6 +15289,7 @@ const STRUCTURAL_DECLARATIONS = [
 function generateButtonCss(options) {
 	const { themeId, theme, buttonSystem: providedButtonSystem } = options;
 	const tokens = new TokenResolver(theme);
+	const palette = expandPalette(theme.palette);
 	const buttonSystem = providedButtonSystem ?? generateDefaultButtonSystem(theme);
 	const themeSizes = {
 		...DEFAULT_BUTTON_SIZES,
@@ -14257,34 +15298,109 @@ function generateButtonCss(options) {
 	const enabledVariants = buttonSystem.variants.filter((v) => v.enabled);
 	const aliasSource = resolveAliasSource(enabledVariants);
 	const chunks = [];
-	for (const variant of enabledVariants) chunks.push(...variantChunks(variant, buttonSystem.global, themeSizes, themeId, tokens, theme));
+	for (const variant of enabledVariants) {
+		const compiled = compileRuntimeVariant(variant, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
+	}
 	if (aliasSource) {
-		const alias = {
+		const compiled = compileRuntimeVariant({
 			...aliasSource,
 			id: DEFAULT_VARIANT_ALIAS_ID,
 			name: "Default"
-		};
-		chunks.push(...variantChunks(alias, buttonSystem.global, themeSizes, themeId, tokens, theme));
+		}, buttonSystem.global, palette);
+		if (compiled.fallbackError) chunks.push({ raw: `/* ${formatButtonColourContractError(compiled.fallbackError)} Using contrast-safe surface fallback. */` });
+		chunks.push(...variantChunks(compiled.variant, compiled.global, themeSizes, themeId, tokens, theme, compiled.colours, compiled.focusIndicator, compiled.nonColourEffects));
 	}
 	return chunks.map(renderChunk).join("\n\n");
 }
+function compileRuntimeVariant(variant, global, palette) {
+	const result = compileButtonColourStates({
+		variant,
+		global,
+		palette
+	});
+	if (result.ok) return {
+		variant,
+		global,
+		colours: result.states,
+		focusIndicator: result.focusIndicator,
+		nonColourEffects: result.nonColourEffects
+	};
+	const fallbackVariant = {
+		...variant,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		hoverBackgroundToken: void 0,
+		effects: void 0
+	};
+	const fallbackGlobal = {
+		...global,
+		hoverColor: "none",
+		hoverColorToken: void 0
+	};
+	const fallback = compileButtonColourStates({
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		palette
+	});
+	if (!fallback.ok) {
+		const colour = {
+			kind: "surface",
+			role: "link",
+			backgroundCss: "transparent",
+			foregroundCss: surfaceForegroundValue("link")
+		};
+		return {
+			variant: fallbackVariant,
+			global: fallbackGlobal,
+			colours: {
+				base: colour,
+				hover: colour,
+				focus: colour,
+				active: colour,
+				disabled: colour
+			},
+			focusIndicator: {
+				kind: "surface-role",
+				colorCss: colour.foregroundCss,
+				minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+			},
+			nonColourEffects: {},
+			fallbackError: result.error
+		};
+	}
+	return {
+		variant: fallbackVariant,
+		global: fallbackGlobal,
+		colours: fallback.states,
+		focusIndicator: fallback.focusIndicator,
+		nonColourEffects: fallback.nonColourEffects,
+		fallbackError: result.error
+	};
+}
 /** Pick the highest-priority variant whose role we'll alias to `.default`. */
 function resolveAliasSource(enabled) {
 	if (enabled.some((v) => v.id === "default")) return null;
 	return enabled.slice().sort((a, b) => a.priority - b.priority)[0] ?? null;
 }
-function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
+function variantChunks(variant, global, themeSizes, themeId, tokens, theme, colours, focusIndicator, nonColourEffects) {
 	const out = [];
 	const variantId = parseButtonVariantIdForCss(variant.id);
 	const selector = `:where([data-theme-scope="${themeId}"]) ${themeButtonSelector(variantId)}`;
-	out.push(variantBaseRule(variant, selector, global, tokens, theme));
+	out.push(variantBaseRule(variant, selector, global, tokens, theme, colours.base));
 	out.push({ raw: generateInteractiveChildInheritanceCSS(selector) });
-	const hoverBg = variantHoverBackgroundRule(variant, variantId, global, themeId, tokens);
-	if (hoverBg) out.push(hoverBg);
-	out.push(variantFocusVisibleRule(variantId, themeId));
-	const effects = variantEffectsCss(variant, themeId, tokens, theme);
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) if (!resolvedColoursEqual(colours.base, colours[state])) out.push(variantStateColourRule(variantId, themeId, state, colours[state]));
+	const effects = variantEffectsCss(variant, nonColourEffects, themeId, tokens, theme);
 	if (effects) out.push({ raw: effects });
-	const affordance = variantAffordanceRule(variant, selector, tokens);
+	out.push(variantFocusVisibleRule(variantId, themeId, focusIndicator));
+	const affordance = variantAffordanceRule(variant, selector);
 	if (affordance) out.push(affordance);
 	out.push(...variantDisabledRules(variantId, themeId));
 	out.push(...variantSizeRules(variant, variantId, themeSizes, themeId));
@@ -14299,12 +15415,11 @@ function variantChunks(variant, global, themeSizes, themeId, tokens, theme) {
 * one (node overrides personality). Colour comes from the affordance token, or
 * `currentColor` (the button text colour) when no token is given.
 */
-function variantAffordanceRule(variant, selector, tokens) {
+function variantAffordanceRule(variant, selector) {
 	const affordance = variant.affordance;
 	if (!affordance) return null;
 	const maskUrl = affordanceIconMaskUrl(affordance.iconId);
 	if (!maskUrl) return null;
-	const color = affordance.colorToken ? variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(affordance.colorToken)) : tokens.getColor(affordance.colorToken) : "currentColor";
 	const mask = `url("${maskUrl}") no-repeat center / contain`;
 	return rule(`${selector}:not(.${AFFORDANCE_SUPPRESS_CLASS})::after`, [
 		["content", "\"\""],
@@ -14313,7 +15428,7 @@ function variantAffordanceRule(variant, selector, tokens) {
 		["height", "1em"],
 		["margin-inline-start", "0.5em"],
 		["flex", "0 0 auto"],
-		["background-color", color],
+		["background-color", "currentColor"],
 		["-webkit-mask", mask],
 		["mask", mask]
 	]);
@@ -14323,7 +15438,7 @@ function parseButtonVariantIdForCss(value) {
 	if (!variantId) throw new Error("Button variant id must be a non-empty string");
 	return variantId;
 }
-function variantBaseRule(variant, selector, global, tokens, theme) {
+function variantBaseRule(variant, selector, global, tokens, theme, colour) {
 	const decls = [];
 	decls.push(["font-weight", String(global.fontWeight)]);
 	decls.push(["font-family", resolveFontFamily(global)]);
@@ -14335,18 +15450,10 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 	for (const decl of STRUCTURAL_DECLARATIONS) decls.push(decl);
 	decls.push(["border-radius", resolveBorderRadius(variant, global)]);
 	decls.push(["box-shadow", resolveBoxShadow(variant, global, theme, tokens)]);
-	if (variant.background.type === "solid") decls.push(["background-color", tokens.getColor(variant.background.colorToken)]);
-	else if (variant.background.type === "gradient") {
-		const colors = variant.background.stops.map((stop) => tokens.getColor(stop)).join(", ");
-		const direction = GRADIENT_DIRECTION_MAP$1[variant.background.direction] || "to right";
-		decls.push(["background-image", `linear-gradient(${direction}, ${colors})`]);
-	} else decls.push(["background-color", "transparent"]);
-	const foregroundColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.textColorToken)) : tokens.getColor(variant.textColorToken);
-	decls.push(["color", foregroundColor]);
+	decls.push(...resolvedButtonColourDeclarations(colour));
 	if (variant.border) {
 		const borderWidth = BORDER_WIDTH_MAP[variant.border.widthClass] || "1px";
-		const borderColor = variant.background.type === "transparent" ? surfaceLinkColor(tokens.getColor(variant.border.colorToken)) : tokens.getColor(variant.border.colorToken);
-		decls.push(["border", `${borderWidth} solid ${borderColor}`]);
+		decls.push(["border", `${borderWidth} solid currentColor`]);
 	}
 	return rule(selector, decls);
 }
@@ -14357,30 +15464,22 @@ function variantBaseRule(variant, selector, global, tokens, theme) {
 * token fallback keeps buttons usable in contexts that do not provide that
 * contract (and preserves the existing theme behaviour there).
 */
-function surfaceLinkColor(fallbackColor) {
-	return `var(--rb-surface-link-color, ${fallbackColor})`;
+function variantStateColourRule(variantId, themeId, state, colour) {
+	return rule(`: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(`: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
@@ -14395,18 +15494,15 @@ function variantDisabledRules(variantId, themeId) {
 		`${base}:focus`
 	];
 	const pseudoSelectors = [`${base}::before`, `${base}::after`];
-	return [rule(disabledSelectors, [
-		["opacity", "0.5"],
-		["cursor", "not-allowed"],
-		["pointer-events", "none"],
-		["transform", "none"],
-		["box-shadow", "none"]
-	]), rule(pseudoSelectors, [
+	return [rule(disabledSelectors, [...RESOLVED_BUTTON_DISABLED_DECLARATIONS]), rule(pseudoSelectors, [
 		["opacity", "0"],
 		["animation", "none"],
 		["pointer-events", "none"]
 	])];
 }
+function resolvedColoursEqual(left, right) {
+	return JSON.stringify(left) === JSON.stringify(right);
+}
 function variantSizeRules(variant, variantId, themeSizes, themeId) {
 	const borderWidth = variant.border ? BORDER_WIDTH_MAP[variant.border.widthClass] || "1px" : "0px";
 	const rules = [];
@@ -14474,6 +15570,27 @@ function resolveBoxShadow(variant, global, theme, tokens) {
 	const color = shadowConfig.colorToken ? tokens.getColor(shadowConfig.colorToken) : void 0;
 	return generateShadowValue$1(shadowConfig.elevation, shadowConfig.softness, shadowConfig.position ?? "bottom", color);
 }
+buttonPersonalities.map((personality) => ({
+	id: personality.id,
+	name: personality.name,
+	description: personality.description,
+	category: presetCategory(personality),
+	buttonSystem: personality.buttonSystem,
+	compatibility: {
+		...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+		...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+	}
+}));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
 //#endregion
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
@@ -14710,67 +15827,6 @@ function generateDefaultCardSystem(theme) {
 	return { variants: [defaultVariant, alternativeVariant] };
 }
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-const SURFACE_FOREGROUND_ROLES = [
-	"text",
-	"heading",
-	"link",
-	"supporting"
-];
-//#endregion
-//#region ../theme-core/src/surfaces/foregroundContract.ts
-const SURFACE_FOREGROUND_CSS_VARS = {
-	text: "--rb-surface-text-color",
-	heading: "--rb-surface-heading-color",
-	link: "--rb-surface-link-color",
-	supporting: "--rb-surface-supporting-color"
-};
-const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
-const DEFAULT_ROLE_FALLBACKS = {
-	text: DEFAULT_SURFACE_TEXT_COLOR,
-	heading: DEFAULT_SURFACE_TEXT_COLOR,
-	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
-	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
-};
-function requireSurfaceColorValue(role, value) {
-	const normalized = value.trim();
-	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
-	return normalized;
-}
-function completeSurfaceForegrounds(input) {
-	const text = requireSurfaceColorValue("text", input.text);
-	return {
-		text,
-		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
-		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
-	};
-}
-function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
-	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
-	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
-	if (role === "text") return `var(${roleVariable}, ${fallback})`;
-	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
-}
-function surfaceForegroundValueWithOpacity(role, opacityPercent) {
-	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
-	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
-}
-function surfaceForegroundStyle(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return {
-		color: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
-		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
-		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
-		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
-	};
-}
-function surfaceForegroundDeclarations(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
-}
-//#endregion
 //#region ../theme-core/src/cards/generateCardCss.ts
 const PER_CORNER_RADIUS_MAP = {
 	square: "0",
@@ -14881,7 +15937,7 @@ function generateVariantCSS(variant, themeId, tokens, theme) {
 	rules.push(`display: flex`);
 	rules.push(`flex-direction: column`);
 	rules.push(`position: relative`);
-	rules.push(`overflow: hidden`);
+	rules.push(`overflow: visible`);
 	const mediaRadius = MEDIA_CORNER_MAP[corners];
 	const mediaRules = [`border-top-left-radius: ${mediaRadius}`, `border-top-right-radius: ${mediaRadius}`];
 	const contentRules = [`padding: ${CONTENT_PADDING_MAP[variant.spacing] || CONTENT_PADDING_MAP.comfortable}`];
@@ -15207,47 +16263,6 @@ const FONT_WEIGHT_MAP = {
 	black: "800"
 };
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-/**
-* Gradient color stop
-*/
-const gradientStopSchema = z$1.object({
-	color: themeColorTokenSchema,
-	position: z$1.number().min(0).max(100)
-});
-/**
-* Radial gradient shape. Optional; defaults to `circle` (the historical shape)
-* so existing radial gradients are byte-identical.
-*
-* Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
-* `GradientShape` (which names the gradient *kind*: linear/radial/conic).
-*/
-const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-/**
-* Gradient configuration.
-*
-* `type` is optional and defaults to `'linear'` so gradients persisted without a
-* type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
-* `'conic'` are additive kinds:
-*   - linear: `angle` (degrees)
-*   - radial: optional `shape` (circle/ellipse) + `position`
-*   - conic:  optional `angle` (from-angle, degrees) + `position`
-*/
-const gradientConfigSchema = z$1.object({
-	type: z$1.enum([
-		"linear",
-		"radial",
-		"conic"
-	]).default("linear"),
-	angle: z$1.number().min(0).max(360).optional(),
-	shape: radialGradientShapeSchema.optional(),
-	position: z$1.string().optional(),
-	stops: z$1.array(gradientStopSchema).min(2)
-});
-//#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
 /**
 * Shared Base Schemas for Interactive Elements
@@ -16405,6 +17420,7 @@ const navFontWeight = z$1.enum([
 	"bold"
 ]);
 const headerMaxWidth = z$1.enum(["container", "full"]);
+const headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
 const headerContainerSchema = z$1.object({
 	rounded: z$1.enum([
 		"none",
@@ -16549,6 +17565,7 @@ const headerSchema = z$1.object({
 	positioning: headerPositioning,
 	shrinkOnScroll: z$1.boolean(),
 	maxWidth: headerMaxWidth,
+	barFrame: headerBarFrame.optional(),
 	logoOverride: mediaSchema$1.nullable().optional(),
 	background: headerBackgroundSchema.default({
 		type: "color",
@@ -16558,6 +17575,7 @@ const headerSchema = z$1.object({
 	navStyle: headerNavStyle,
 	navColor: themeColorTokenSchema.nullable().optional(),
 	navWeight: navFontWeight.default("medium"),
+	navFontRole: z$1.enum(["body", "heading"]).optional(),
 	navTypography: z$1.enum(["body", "heading"]).optional(),
 	navTextSize: navLinkStyleSchema.shape.textSize,
 	navPlacement: z$1.enum(["end", "center"]).optional(),
@@ -16573,7 +17591,21 @@ const headerSchema = z$1.object({
 	ctaTreatment: headerCtaTreatmentSchema.optional(),
 	ctaVariant: z$1.string().min(1).optional(),
 	dropdownStyle: dropdownStyleSchema
-});
+}).transform(normaliseHeaderNavFontRole);
+/**
+* Normalises the legacy `navTypography` font-role alias into the canonical
+* `navFontRole` field so persisted themes migrate at the parse boundary without
+* a data migration. `navFontRole` always wins when both are present; the legacy
+* field is dropped so we never carry a dual write forward.
+*/
+function normaliseHeaderNavFontRole(header) {
+	if (header.navTypography === void 0) return header;
+	const { navTypography, ...rest } = header;
+	return header.navFontRole === void 0 ? {
+		...rest,
+		navFontRole: navTypography
+	} : rest;
+}
 const footerVariant = z$1.enum([
 	"simple",
 	"columns",
@@ -16983,6 +18015,19 @@ z$1.object({
 }).strict();
 //#endregion
 //#region ../theme-core/src/site-styles/runtimeCompiler.ts
+function defineSectionForegroundRuntimeTokens(input) {
+	return {
+		textColor: requireThemeColorToken(input.textColor),
+		headingColor: requireThemeColorToken(input.headingColor),
+		linkColor: requireThemeColorToken(input.linkColor),
+		supportingColor: requireThemeColorToken(input.supportingColor)
+	};
+}
+function requireThemeColorToken(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) throw new Error(`Invalid section foreground Theme color token: ${String(value)}`);
+	return token;
+}
 function defineDesignRuntimeRules(rules) {
 	return rules;
 }
@@ -17253,24 +18298,24 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				type: "color",
 				color: "muted"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"brand-depth-band": {
 			background: {
 				type: "color",
 				color: "primary-800"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"hero-image": {
 			background: {
@@ -17278,12 +18323,32 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				opacity: 1,
 				position: "center center"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
+		}
+	}
+});
+const primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+const fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+	...defaultDesignRuntimeRules,
+	sectionSurfaces: {
+		...defaultDesignRuntimeRules.sectionSurfaces,
+		"accent-band": {
+			background: {
+				type: "gradient",
+				gradientPresetId: primaryGlowGradientPresetId
+			},
+			foreground: defineSectionForegroundRuntimeTokens({
+				textColor: "primaryForeground",
+				headingColor: "primaryForeground",
+				linkColor: "primaryForeground",
+				supportingColor: "primaryForeground"
+			})
 		}
 	}
 });
@@ -17607,6 +18672,7 @@ const curatedSiteStyles = [
 		],
 		buttonPersonalityChoices: [
 			buttonChoice("soft-pill"),
+			buttonChoice("two-tone-pill"),
 			buttonChoice("pebble"),
 			buttonChoice("editorial-link"),
 			buttonChoice("brushed-wash")
@@ -18670,6 +19736,8 @@ const curatedSiteStyles = [
 		},
 		compositionBudget: quietBudget,
 		typography: fulcrumTypography,
+		designRuntimeRules: fulcrumDesignRuntimeRules,
+		recommendedAppearancePresetIds: ["cta-accent-band"],
 		themeOverrides: {
 			shadow: { colorToken: "primary" },
 			accordions: {
@@ -18786,6 +19854,7 @@ const curatedSiteStyles = [
 		],
 		buttonPersonalityChoices: [
 			buttonChoice("quiet-arrow"),
+			buttonChoice("two-tone-pill"),
 			buttonChoice("flat-ink"),
 			buttonChoice("editorial-link")
 		],
@@ -18995,6 +20064,21 @@ function toSiteChromeBackgroundColorTokens(tokenNames) {
 }
 //#endregion
 //#region ../theme-core/src/site-styles/siteChromeNavPreferences.ts
+/**
+* Applies the user's nav font-role/size overrides on top of a style-resolved
+* nav link style. This is where the precedence contract lands:
+*
+* - The nav typography TREATMENT (case/tracking identity: plain / heading /
+*   quiet-caps / brand-caps) is ALWAYS owned by the active header style and is
+*   baked into `style` before this call (see `applyNavTypography` in
+*   headerLooks.ts).
+* - Each treatment resolves through a DEFAULT font role: `heading` resolves
+*   through the heading role; `plain` / `quiet-caps` / `brand-caps` resolve
+*   through the body role.
+* - The user's `navFontRole` (surfaced here as `preferences.typography`) only
+*   overrides which font ROLE the treatment resolves through. It never changes
+*   the treatment. `'inherit'` keeps the treatment's default role.
+*/
 function mergeHeaderNavTypographyPreference(style, preferences) {
 	return preferences.typography === "inherit" && preferences.fontSize === "inherit" ? style : {
 		...style,
@@ -20029,6 +21113,7 @@ function devValidate(node) {
 }
 //#endregion
 //#region ../blocks/src/system/node/fragments/backgroundLayer.ts
+const BACKGROUND_FRAME_BASE_CLASS = "rb-background-frame rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-isolate rb-pointer-events-none";
 /**
 * Creates background layer nodes for rendering backgrounds from field data.
 *
@@ -20094,6 +21179,34 @@ function backgroundLayer(path, options = {}) {
 	];
 }
 /**
+* Wrap decorative background layers in their own clipping frame.
+*
+* Foreground content remains outside this frame, so editor outlines, focus
+* rings, and floating controls are never clipped by a visual background.
+* Backgrounds that explicitly opt into overflow keep that behavior within
+* the decorative layer rather than changing the content root.
+*/
+function backgroundFrame(path, options = {}) {
+	const { leadingNodes = [], ...layerOptions } = options;
+	const framedLayerOptions = {
+		...layerOptions,
+		styleClassName: layerOptions.styleClassName ?? "background-style rb-absolute rb-inset-0 rb-z-0 rb-h-full rb-w-full rb-pointer-events-none",
+		imageClassName: layerOptions.imageClassName ?? "rb-absolute rb-z-0",
+		overlayClassName: layerOptions.overlayClassName ?? "background-overlay rb-absolute rb-inset-0 rb-z-0 rb-h-full rb-w-full rb-pointer-events-none"
+	};
+	return el("div", {
+		className: { $bind: {
+			from: path,
+			transforms: [{
+				id: "background.resolveFrameClassName",
+				options: { baseClass: BACKGROUND_FRAME_BASE_CLASS }
+			}],
+			fallback: `${BACKGROUND_FRAME_BASE_CLASS} rb-overflow-hidden`
+		} },
+		style: { borderRadius: "inherit" }
+	}, [...leadingNodes, ...backgroundLayer(path, framedLayerOptions)]);
+}
+/**
 * Creates a media node for rendering background image/video media with conditional rendering.
 *
 * This helper creates a media element that:
@@ -20255,8 +21368,8 @@ function sectionContainer(children, opts) {
 *     - content
 */
 function styledContainer(config) {
-	const { children, rootType = "div", rootProps, bindFrom = "_containerStyles", baseClassName = "rb-relative rb-isolate rb-overflow-hidden", imageClassName = "rb-absolute rb-z-neg-10", constrainWidth = true } = config;
-	const backgroundNodes = backgroundLayer(`${bindFrom}.background`, { imageClassName });
+	const { children, rootType = "div", rootProps, bindFrom = "_containerStyles", baseClassName = "rb-relative rb-isolate rb-overflow-visible", imageClassName = "rb-absolute rb-z-0", constrainWidth = true } = config;
+	const backgroundNode = backgroundFrame(`${bindFrom}.background`, { imageClassName });
 	const childrenArray = Array.isArray(children) ? children : [children];
 	const { className: _ignoredClassName, style: _ignoredStyle, ...safeRootProps } = rootProps ?? {};
 	return el(rootType, {
@@ -20279,7 +21392,7 @@ function styledContainer(config) {
 			}],
 			fallback: constrainWidth ? `${baseClassName} rb-container` : baseClassName
 		} }
-	}, [...backgroundNodes, ...childrenArray]);
+	}, [backgroundNode, ...childrenArray]);
 }
 //#endregion
 //#region ../blocks/src/system/spacing.ts
@@ -20412,7 +21525,7 @@ const DEFAULT_SECTION_SPACING = "medium";
 * - Creating a section wrapper with background theme
 * - Adding background color/gradient/image layers
 * - Binding className to section styles with transform
-* - Binding allowOverflow for background positioning
+* - Keeping foreground overflow visible while decorative backgrounds clip independently
 * - Wrapping content children
 *
 * Use this helper to eliminate 25+ lines of boilerplate section setup code.
@@ -20448,8 +21561,8 @@ const DEFAULT_SECTION_SPACING = "medium";
 * });
 */
 function styledSection(config) {
-	const { children, baseClass = "rb-px-6", spacing = DEFAULT_SECTION_SPACING, background = "background", bindFrom = "_sectionStyles", imageClassName = "rb-absolute rb-z-neg-10", renderBackgroundImage = true, backgroundImageLoading, backgroundImageFetchPriority, allowOverflow = false, fullWidthPath } = config;
-	const renderedBackgroundNodes = backgroundLayer(`${bindFrom}.background`, {
+	const { children, baseClass = "rb-px-6", spacing = DEFAULT_SECTION_SPACING, background = "background", bindFrom = "_sectionStyles", imageClassName = "rb-absolute rb-z-0", renderBackgroundImage = true, backgroundImageLoading, backgroundImageFetchPriority, fullWidthPath } = config;
+	const renderedBackgroundNode = backgroundFrame(`${bindFrom}.background`, {
 		imageClassName,
 		fallbackToken: background,
 		omitImageLayer: !renderBackgroundImage,
@@ -20472,13 +21585,8 @@ function styledSection(config) {
 					fullWidthPath
 				}
 			}]
-		} },
-		allowOverflow: allowOverflow ? true : { $bind: {
-			from: `${bindFrom}.background`,
-			transforms: [{ id: "background.resolveAllowOverflow" }],
-			fallback: false
 		} }
-	}, [...renderedBackgroundNodes, ...childrenArray]);
+	}, [renderedBackgroundNode, ...childrenArray]);
 }
 //#endregion
 //#region ../blocks/src/system/node/fragments/ctaButton.ts
@@ -21339,9 +22447,12 @@ function responsiveTwoColumn({ image, text, ratioFrom, imagePositionFrom, gapCla
 //#endregion
 //#region ../blocks/src/system/node/fragments/styledCard.ts
 function styledCard(children, opts, ...mods) {
-	const baseClassName = opts.baseClassName ?? "rb-relative rb-isolate rb-overflow-hidden rb-border";
-	const defaultBackgroundLayer = el("div", { className: "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-pointer-events-none rb-bg-surface" });
-	const backgroundNodes = backgroundLayer(opts.backgroundFrom);
+	const baseClassName = opts.baseClassName ?? "rb-relative rb-isolate rb-overflow-visible rb-border";
+	const defaultBackgroundLayer = el("div", {
+		className: "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-pointer-events-none rb-bg-surface",
+		style: { borderRadius: "inherit" }
+	});
+	const backgroundNode = backgroundFrame(opts.backgroundFrom);
 	const style = {
 		...opts.style ?? {},
 		borderColor: { $bind: {
@@ -21368,7 +22479,7 @@ function styledCard(children, opts, ...mods) {
 		...style ? { style } : {}
 	}, [
 		defaultBackgroundLayer,
-		...backgroundNodes,
+		backgroundNode,
 		...children
 	], ...mods);
 }
@@ -22012,9 +23123,15 @@ function createButtonGroup(options = {}) {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -22023,11 +23140,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 //#endregion
@@ -22077,6 +23191,7 @@ const heroCtaRowFragment = defineFragment({
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -22144,7 +23259,7 @@ const ctaCopyFragment = defineFragment({
 		eyebrowPath: "content.eyebrow",
 		titlePath: "content.title",
 		className: "cta-heading"
-	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 });
 //#endregion
 //#region ../blocks/src/system/fragments/library/testimonialsHeading.ts
@@ -22241,7 +23356,7 @@ function buildTestimonialCard(...mods) {
 	}, props({ value: "“" })), richText({ className: "rb-prose rb-max-w-none" }, bind("testimonial.content.body"), when("testimonial.content.body"))]), el("div", { className: "rb-testimonial-attribution" }, buildAttributionNodes())])], {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-testimonial-card rb-relative rb-isolate rb-flex rb-h-full rb-flex-col rb-overflow-hidden rb-p-8"
+		baseClassName: "rb-testimonial-card rb-relative rb-isolate rb-flex rb-h-full rb-flex-col rb-overflow-visible rb-p-8"
 	}, ...mods);
 }
 /**
@@ -22969,7 +24084,7 @@ function createFaqAccordionLayout(options = {}) {
 						options: {
 							axis: "all",
 							includeSpacing: false,
-							baseClass: "rb-faq-item rb-relative rb-isolate rb-overflow-hidden"
+							baseClass: "rb-faq-item rb-relative rb-isolate rb-overflow-visible"
 						}
 					}]
 				},
@@ -24168,6 +25283,7 @@ function createBlockManifest(config) {
 		previewCustomize: config.previewCustomize,
 		category: config.category,
 		contentTypes: config.contentTypes ? [...config.contentTypes] : void 0,
+		contentSource: config.contentSource,
 		tags: config.tags ? [...config.tags] : [],
 		icon: config.icon ?? "Box",
 		layout,
@@ -24301,7 +25417,6 @@ function splitLayoutWith(children) {
 			}
 		}),
 		renderBackgroundImage: false,
-		allowOverflow: true,
 		baseClass: ""
 	});
 }
@@ -24314,6 +25429,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -24587,6 +25703,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -24772,6 +25889,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -24828,6 +25946,10 @@ const blogPostBlockDefinition = {
 		description: "Highlights a single blog post with title, image, and excerpt.",
 		category: "blog",
 		contentTypes: ["post"],
+		contentSource: {
+			kind: "entries",
+			contentType: "post"
+		},
 		tags: [
 			"blog",
 			"post",
@@ -24929,7 +26051,7 @@ function postCard(children, ...mods) {
 	return styledCard(children, {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border rb-flex rb-flex-col rb-h-full"
+		baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border rb-flex rb-flex-col rb-h-full"
 	}, ...mods);
 }
 const gridPostCard = postCard([postImageLink("rb-h-48 rb-w-full rb-object-cover rb-transition-transform rb-hover-scale-105", {
@@ -24965,7 +26087,7 @@ const stackPostCard = styledCard([inline({
 ])])], {
 	stylesFrom: "content._cardStyles",
 	backgroundFrom: "content._cardStyles.background",
-	baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border"
+	baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border"
 }, repeat("data.posts", "post"));
 const emptyState$2 = {
 	...styledCard([text({
@@ -24974,7 +26096,7 @@ const emptyState$2 = {
 	}, bind("content.emptyMessage", { fallback: "No posts published yet." }))], {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border rb-border-dashed rb-p-8 rb-text-center"
+		baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border rb-border-dashed rb-p-8 rb-text-center"
 	}),
 	$when: {
 		when: { from: "data.posts[0]" },
@@ -24984,7 +26106,7 @@ const emptyState$2 = {
 function blogListingShell(children) {
 	return styledSection({
 		children: styledContainer({
-			baseClassName: "rb-relative rb-isolate rb-overflow-hidden",
+			baseClassName: "rb-relative rb-isolate rb-overflow-visible",
 			children
 		}),
 		baseClass: ""
@@ -25125,6 +26247,10 @@ const blogListingManifest = createBlockManifest({
 	],
 	description: "Display a collection of blog posts in grid or stack layout.",
 	contentTypes: ["post"],
+	contentSource: {
+		kind: "entries",
+		contentType: "post"
+	},
 	tags: [
 		"blog",
 		"posts",
@@ -25167,6 +26293,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -25200,6 +26327,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -25418,7 +26546,7 @@ const copyLayout = fragmentLayoutNode$1(formCopyFragment.layout);
 const formSurface = styledContainer({
 	bindFrom: "_containerStyles",
 	constrainWidth: false,
-	baseClassName: "rb-form-surface rb-relative rb-isolate rb-overflow-hidden",
+	baseClassName: "rb-form-surface rb-relative rb-isolate rb-overflow-visible",
 	children: fragmentLayoutNode$1(formEmbedFragment.layout)
 });
 function createFormLayout(variant) {
@@ -25482,6 +26610,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -25544,6 +26673,7 @@ const contactNewsletterBlockDefinition = {
 		titleSource: "contactTitle",
 		description: "Two-column newsletter signup and contact form section.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		layout: contactNewsletterLayout,
 		defaultVariant: "default",
 		variants: { default: contactNewsletterLayout },
@@ -25747,6 +26877,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -26695,6 +27826,7 @@ const headerRootClassTransform = {
 		];
 		const variant = header?.variant;
 		if (variant && VALID_VARIANTS.includes(variant)) classes.push(`header-variant-${variant}`);
+		if (header?.barFrame === "inset-shell" && variant === "classic") classes.push("header-bar-frame-inset-shell");
 		return joinClasses$2(classes);
 	}
 };
@@ -27251,7 +28383,7 @@ function markEditableSurfaceForwarding(component) {
 const SITE_CHROME_VISIBLE_HEADER_ATTR = "data-site-chrome-visible-header";
 //#endregion
 //#region ../blocks/src/system/blocks/site-header.ts
-const whenTransformed$1 = (from, transformId, equals = true) => (node) => ({
+const whenTransformed = (from, transformId, equals = true) => (node) => ({
 	...node,
 	$when: {
 		when: {
@@ -27279,7 +28411,7 @@ const logoRow = link({
 	text({
 		as: "strong",
 		className: "header-logo-text rb-truncate"
-	}, whenTransformed$1("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
+	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
 ]);
 const centeredLogoRow = link({
 	href: "/",
@@ -27299,7 +28431,7 @@ const centeredLogoRow = link({
 	text({
 		as: "strong",
 		className: "header-logo-text"
-	}, whenTransformed$1("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
+	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
 ]);
 const createNavRow = (className, align = "end") => navRow({
 	className: `${className} header-nav-row`,
@@ -27431,7 +28563,7 @@ const classicLayout = inline({
 	logoRow,
 	createNavRow(`rb-ml-auto ${desktopOnlyDisplay("flex")} rb-gap-6`),
 	headerCta
-], whenTransformed$1("$root.theme.header", "layout.classicNavMode", "inline"));
+], whenTransformed("$root.theme.header", "layout.classicNavMode", "inline"));
 const classicCenteredNavLayout = inline({
 	className: bindProp("$root.theme.header.maxWidth", {
 		transforms: pipe(tx("layout.maxWidthClass", { base: `rb-header-layout ${desktopOnlyDisplay("flex")} rb-w-full rb-items-center rb-gap-6` })),
@@ -27442,7 +28574,7 @@ const classicCenteredNavLayout = inline({
 	logoRow,
 	createNavRow(`rb-flex-1 rb-justify-center ${desktopOnlyDisplay("flex")} rb-gap-6`, "center"),
 	headerCta
-], whenTransformed$1("$root.theme.header", "layout.classicNavMode", "centered"));
+], whenTransformed("$root.theme.header", "layout.classicNavMode", "centered"));
 const centeredLayout = stack({
 	gap: "md",
 	align: "center",
@@ -27482,6 +28614,7 @@ const siteHeaderManifest = createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -27505,7 +28638,6 @@ const siteHeaderManifest = createBlockManifest({
 			transforms: pipe(tx("layout.headerSectionBackground")),
 			fallback: "background"
 		}),
-		allowOverflow: true,
 		className: bindProp("$root.theme.header", {
 			transforms: pipe(tx("layout.headerRootClass")),
 			fallback: "header-root rb-z-40 rb-w-full transition-theme"
@@ -27556,218 +28688,155 @@ const footerNavGroupsLayout = stack({
 	linkRequired: true,
 	target: { $bind: { from: "entry.target" } },
 	rel: { $bind: { from: "entry.rel" } }
-}, [text({ as: "span" }, bind("entry.label"))], repeat("group.children", "entry"))])], repeat("footerMenu.groups", "group"))], when("footerMenu.groups"));
+}, [text({ as: "span" }, bind("entry.label"))], repeat("group.children", "entry"))])], repeat("footerMenu.groups", "group"))], whenCollectionHasItems("footerMenu.groups"));
 //#endregion
 //#region ../blocks/src/system/blocks/site-footer.ts
-const footerTextLayout = () => materializeFragment({ fragment: footerBottomTextFragment }).layout;
-const whenTransformed = (from, transformId, equals = true) => (node) => ({
-	...node,
-	$when: {
-		when: {
-			from,
-			transforms: [{ id: transformId }]
-		},
-		equals
-	}
-});
-const bottomBarTextLayout = () => {
-	const bottomTextNode = footerTextLayout()[1];
-	return bottomTextNode ? [bottomTextNode] : [];
-};
-const bodyTextLayout = () => {
-	const bodyTextNode = footerTextLayout()[0];
-	return bodyTextNode ? [bodyTextNode] : [];
-};
-const businessAddressLayout = () => [text({
-	as: "p",
-	className: "rb-caption rb-opacity-80"
-}, bind("site.businessAddress.displayAddress"), when("content.showBusinessAddress", { equals: true }))];
-const inlineBottomTextLayout = () => {
-	const bottomTextNode = footerTextLayout()[1];
-	if (!bottomTextNode) return [];
-	return [when("$root.theme.footer.bottomBar.enabled", {
-		equals: true,
-		not: true
-	})(bottomTextNode)];
-};
-const simpleFooterLayout = stack({
-	gap: "md",
-	align: "start",
-	className: { $bind: {
-		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerSimpleRootClass" }],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-items-start rb-gap-4 rb-py-10 rb-text-left"
-	} }
-}, [
-	link({
-		href: "/",
-		className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{
-				id: "layout.footerLogoClass",
-				options: { requireExplicitShow: true }
-			}],
-			fallback: "rb-hidden"
-		} }
-	}, [
-		media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("content.logo"), bind("content.logo")),
-		stack({ className: "rb-contents" }, [media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-		text({
-			as: "strong",
-			className: "footer-logo-text rb-nav-text"
-		}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-	]),
-	footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "flatten",
-		className: { $bind: {
-			from: "$root.theme.footer.navLayout",
-			transforms: [{ id: "layout.footerSimpleNavClass" }],
-			fallback: "footer-nav rb-flex rb-flex-wrap rb-justify-start rb-gap-x-6 rb-gap-y-3"
-		} },
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-px-4 rb-py-2 rb-nav-text transition-theme-standard"
-	}),
-	...bodyTextLayout(),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "simple" }));
-const columnsFooterLayout = stack({
-	gap: "xl",
-	align: "start",
+const brandLogo = link({
+	href: "/",
 	className: { $bind: {
-		from: "$root.theme.footer.maxWidth",
+		from: "$root.theme.footer.logo",
 		transforms: [{
-			id: "layout.maxWidthClass",
-			options: { base: "rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12" }
+			id: "layout.footerLogoClass",
+			options: { base: "footer-logo rb-inline-flex rb-items-center rb-gap-3 rb-no-underline" }
 		}],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12"
+		fallback: "footer-logo rb-inline-flex rb-items-center rb-gap-3 rb-no-underline"
 	} }
-}, [
-	footerNavGroupsLayout,
-	inline({ className: "rb-flex rb-w-full rb-flex-wrap rb-items-center rb-justify-between rb-gap-4" }, [text({
-		as: "strong",
-		className: "rb-block rb-nav-text",
-		style: textColorStyle("text")
-	}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" })), footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "links-only",
-		className: "rb-flex rb-flex-wrap rb-justify-end rb-gap-x-6 rb-gap-y-3",
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-px-4 rb-py-2 rb-nav-text transition-theme-standard"
-	})]),
-	...bodyTextLayout(),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "columns" }));
-const splitFooterLayout = stack({
-	gap: "xl",
-	align: "start",
+}, [media({ className: { $bind: {
+	from: "$root.theme.footer.logo",
+	transforms: [{
+		id: "layout.footerLogoMediaClass",
+		options: { base: "rb-h-10 rb-w-auto" }
+	}],
+	fallback: "rb-h-10 rb-w-auto"
+} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content.logo")), text({
+	as: "strong",
+	className: "footer-logo-text rb-nav-text"
+}, when("module.showTitle", { equals: true }), bind("site.title", { fallback: "Your Site" }))], when("module.kind", { equals: "brand" }));
+const navigation = stack({
+	gap: "md",
+	className: "rb-w-full"
+}, [footerNavGroupsLayout, footerNav({
+	collectionPath: "footerMenu.items",
+	mode: "links-only",
 	className: { $bind: {
-		from: "$root.theme.footer.maxWidth",
-		transforms: [{
-			id: "layout.maxWidthClass",
-			options: { base: "rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12" }
-		}],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12"
-	} }
+		from: "module.navigationClassName",
+		fallback: "footer-nav rb-flex rb-flex-wrap rb-gap-x-6 rb-gap-y-3"
+	} },
+	linkClassName: "footer-nav-link rb-nav-text transition-theme-standard"
+})], when("module.kind", { equals: "navigation" }));
+const legalNavigation = footerNav({
+	collectionPath: "legalFooterMenu.items",
+	mode: "links-only",
+	className: "rb-flex rb-flex-wrap rb-gap-x-4 rb-gap-y-2",
+	linkClassName: "footer-nav-link rb-caption transition-theme-standard"
+});
+const address = text({
+	as: "address",
+	className: "rb-not-italic rb-opacity-80"
+}, when("module.kind", { equals: "business-address" }), bind("module.address"));
+const contact = stack({
+	gap: "sm",
+	className: "rb-items-start"
+}, [link({
+	href: { $bind: { from: "contactLink.href" } },
+	className: "rb-nav-text rb-break-words transition-theme-standard"
+}, [text({ as: "span" }, bind("contactLink.label"))], repeat("module.contactLinks", "contactLink"))], when("module.kind", { equals: "contact" }));
+const hours = stack({
+	gap: "sm",
+	className: "rb-w-full"
+}, [inline({ className: "rb-flex rb-w-full rb-justify-between rb-gap-4" }, [text({
+	as: "span",
+	className: "rb-label"
+}, bind("hoursDay.weekday")), text({
+	as: "span",
+	className: "rb-caption rb-opacity-80"
+}, bind("hoursDay.hours"))], repeat("module.openingHours", "hoursDay")), text({
+	as: "p",
+	className: "rb-caption rb-opacity-70"
+}, bind("module.timeZone"), when("module.timeZone"))], when("module.kind", { equals: "opening-hours" }));
+const socials = inline({ className: "rb-flex rb-flex-wrap rb-gap-x-5 rb-gap-y-3" }, [link({
+	href: { $bind: { from: "social.href" } },
+	target: "_blank",
+	rel: "noreferrer noopener",
+	"aria-label": { $bind: { from: "social.label" } },
+	className: "rb-nav-text transition-theme-standard"
+}, [icon({ className: "rb-h-5 rb-w-5" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
+const authoredCopy = richText({
+	className: "rb-prose rb-prose-sm rb-max-w-none",
+	style: textColorStyle("text/80")
+}, when("module.content"), bind("module.content", { transforms: [{
+	id: "content.interpolateRichTextTokens",
+	options: { tokens: ["year", "site_name"] }
+}] }));
+const footerGroup = stack({
+	gap: "md",
+	align: "stretch",
+	className: "rb-min-w-0",
+	"data-footer-group": { $bind: { from: "group.kind" } }
+}, [stack({
+	gap: "md",
+	align: "start",
+	"data-preview-footer-module-id": { $bind: { from: "module.id" } }
 }, [
-	inline({ className: { $bind: {
-		from: "$root.theme.footer.logo",
-		transforms: [{ id: "layout.footerSplitMainClass" }],
-		fallback: "rb-flex rb-w-full rb-flex-col rb-items-start rb-justify-between rb-gap-8 rb-md-flex-row rb-md-items-end"
-	} } }, [stack({}, [footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "flatten",
-		className: { $bind: {
-			from: "$root.theme.footer.navLayout",
-			transforms: [{ id: "layout.footerSplitNavSingleClass" }],
-			fallback: "rb-w-full rb-space-y-3 rb-text-left"
-		} },
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-whitespace-nowrap rb-nav-text transition-theme-standard"
-	})]), link({
-		href: "/",
-		className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoClass" }],
-			fallback: "footer-logo rb-inline-flex rb-items-center rb-justify-end rb-gap-3 rb-self-end rb-no-underline rb-text-right rb-transition-opacity rb-hover-opacity-80"
-		} }
-	}, [
-		media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("content.logo"), bind("content.logo")),
-		stack({ className: "rb-contents" }, [media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-		text({
-			as: "strong",
-			className: "footer-logo-text rb-nav-text"
-		}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-	])]),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "split" }));
-const footerLayout = section({
-	background: "background",
+	text({
+		as: "h2",
+		className: "rb-label",
+		style: textColorStyle("text/70")
+	}, bind("module.heading"), when("module.heading")),
+	brandLogo,
+	navigation,
+	stack({
+		gap: "sm",
+		className: "rb-w-full"
+	}, [legalNavigation], when("module.kind", { equals: "legal-navigation" })),
+	address,
+	contact,
+	hours,
+	socials,
+	stack({ className: "rb-w-full" }, [authoredCopy], when("module.kind", { equals: "supporting-text" })),
+	stack({ className: "rb-w-full rb-lg-col-span-3" }, [authoredCopy], when("module.kind", { equals: "legal" }))
+], repeat("group.modules", "module"))], repeat("region.groups", "group"));
+const footerMainRegion = stack({
+	className: { $bind: { from: "region.className" } },
+	"data-footer-region": { $bind: { from: "region.kind" } }
+}, [footerGroup], when("region.kind", { equals: "main" }), repeat("content.footerRuntime.regions", "region"));
+const footerBottomRegion = stack({ className: { $bind: {
+	from: "$root.theme.footer",
+	transforms: [{ id: "layout.footerBottomBarContainerClass" }],
+	fallback: "rb-w-full"
+} } }, [stack({
 	className: { $bind: {
 		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerRootClass" }],
-		fallback: "rb-w-full rb-border-t transition-theme"
+		transforms: [{ id: "layout.footerBottomBarClass" }],
+		fallback: "rb-w-full rb-border-t rb-px-6 rb-py-6 rb-text-center"
 	} },
 	style: { $bind: {
 		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerRootStyle" }],
-		fallback: mergeStyles(backgroundColorStyle("surface"), surfaceForegroundStyle({ text: "rgb(var(--tb-text))" }), borderColorStyle("border"))
-	} }
-}, [
-	simpleFooterLayout,
-	columnsFooterLayout,
-	splitFooterLayout,
-	stack({
-		className: { $bind: {
-			from: "$root.theme.footer",
-			transforms: [{ id: "layout.footerBottomBarClass" }],
-			fallback: "rb-w-full rb-border-t rb-py-5"
-		} },
-		style: { $bind: {
-			from: "$root.theme.footer",
-			transforms: [{ id: "layout.footerBottomBarStyle" }]
-		} }
-	}, [stack({ className: { $bind: {
-		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerBottomBarContainerClass" }],
-		fallback: "rb-container"
-	} } }, [...bottomBarTextLayout()])], when("$root.theme.footer.bottomBar.enabled", { equals: true }))
-]);
+		transforms: [{ id: "layout.footerBottomBarStyle" }]
+	} },
+	"data-footer-region": "bottom"
+}, [footerGroup])], when("region.kind", { equals: "bottom" }), repeat("content.footerRuntime.regions", "region"));
 const siteFooterManifest = createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
-	fragments: [{
-		fragment: footerBottomTextFragment,
-		fieldPriority: 0
-	}],
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
-	additionalFields: [{
-		id: "showBusinessAddress",
-		type: "boolean",
-		label: "Add business address to site footer?",
-		required: false,
-		defaultValue: false,
-		ui: { intent: "content" }
-	}],
-	layout: footerLayout,
-	description: "Site-wide footer with navigation links and optional columns.",
+	layout: section({
+		background: "background",
+		className: { $bind: {
+			from: "$root.theme.footer",
+			transforms: [{ id: "layout.footerRootClass" }],
+			fallback: "rb-w-full rb-border-t transition-theme"
+		} },
+		style: { $bind: {
+			from: "$root.theme.footer",
+			transforms: [{ id: "layout.footerRootStyle" }],
+			fallback: mergeStyles(backgroundColorStyle("surface"), surfaceForegroundStyle({ text: "rgb(var(--tb-text))" }), borderColorStyle("border"))
+		} },
+		"data-footer-membership": { $bind: { from: "content.footerRuntime.membershipKey" } }
+	}, [footerMainRegion, footerBottomRegion]),
+	description: "Site-wide composed footer with canonical shared details.",
 	styleTokens: { spacing: "md" },
 	paletteHidden: true
 });
@@ -27902,6 +28971,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -28060,6 +29130,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -28246,7 +29317,7 @@ const repeatedItemsNode = repeaterFragmentLayout({
 				id: "boxStyles.all",
 				options: {
 					axis: "all",
-					baseClass: "rb-collection-item rb-relative rb-isolate rb-overflow-hidden rb-border"
+					baseClass: "rb-collection-item rb-relative rb-isolate rb-overflow-visible rb-border"
 				}
 			}]
 		},
@@ -28293,6 +29364,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -28570,6 +29642,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -28953,6 +30026,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -29353,6 +30427,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -29517,6 +30592,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -31215,6 +32291,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -31321,15 +32398,9 @@ const eventRegistrationBlockDefinition = {
 				defaultValue: "Complete Registration",
 				maxLength: 40
 			},
-			{
-				id: "buttonVariant",
-				type: "select",
-				label: "Button style",
+			createButtonVariantField({
 				description: "Choose a button style from your theme",
-				required: false,
-				multiple: false,
-				defaultValue: "primary",
-				options: [
+				variants: [
 					{
 						value: "primary",
 						label: "Primary"
@@ -31342,9 +32413,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -31719,6 +32789,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -31832,15 +32903,9 @@ const courseRegistrationBlockDefinition = {
 				defaultValue: "Sign up",
 				maxLength: 40
 			},
-			{
-				id: "buttonVariant",
-				type: "select",
-				label: "Button style",
+			createButtonVariantField({
 				description: "Choose a button style from your theme",
-				required: false,
-				multiple: false,
-				defaultValue: "primary",
-				options: [
+				variants: [
 					{
 						value: "primary",
 						label: "Primary"
@@ -31853,9 +32918,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -31935,6 +32999,7 @@ const eventDetailsManifest = createBlockManifest({
 	titleSource: "heading",
 	description: "Date/time, venue, map, and other dates for an event",
 	category: "content",
+	contentSource: { kind: "entries" },
 	tags: [
 		"events",
 		"venue",
@@ -32140,6 +33205,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -32431,6 +33497,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -35244,6 +36311,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -36449,6 +37517,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -36846,6 +37915,7 @@ const recurringScheduleBlockDefinition = {
 		titleSource: "heading",
 		description: "A compact weekly schedule with one row per recurring series.",
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		icon: "CalendarDays",
 		tags: [
 			"schedule",
@@ -37476,7 +38546,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -37529,6 +38602,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -37697,6 +38771,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -38184,6 +39259,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -38836,6 +39912,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -39006,6 +40083,7 @@ const audioPlayerBlockDefinition = { manifest: createBlockManifest({
 	title: "Audio Player",
 	titleSource: "title",
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a branded audio player for a single track.",
 	tags: [
 		"audio",
@@ -39117,6 +40195,7 @@ const fileDownloadBlockDefinition = { manifest: createBlockManifest({
 	title: "File Download",
 	titleSource: ["title", "file.filename"],
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a simple public download link for a document, ZIP, or audio file.",
 	tags: [
 		"file",
@@ -40136,6 +41215,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -40335,6 +41415,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -40476,6 +41557,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -40592,6 +41674,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -40674,6 +41757,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -40888,6 +41972,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -41242,6 +42327,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -41423,6 +42509,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -41863,6 +42950,7 @@ const locationMapBlockDefinition = {
 		titleSource: "heading",
 		description: "Show a business location with an interactive map and directions link.",
 		category: "content",
+		contentSource: { kind: "inline" },
 		tags: [
 			"map",
 			"location",
@@ -42869,213 +43957,6 @@ function getBlockDefinition(name) {
 	return blockStore.get(name);
 }
 //#endregion
-//#region ../theme-core/src/gradients/presets.ts
-/**
-* Curated library of gradient presets
-* All gradients use theme color tokens, so they adapt to the site's palette
-*/
-const GRADIENT_PRESETS = [
-	{
-		id: "primary-secondary",
-		name: "Primary to Secondary",
-		description: "Blend your primary and secondary brand colors",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "secondary-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-accent",
-		name: "Primary to Accent",
-		description: "Energetic gradient from primary to accent",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-accent",
-		name: "Secondary to Accent",
-		description: "Vibrant secondary to accent blend",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-light-dark",
-		name: "Primary Light to Dark",
-		description: "Subtle primary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-dark-light",
-		name: "Primary Dark to Light",
-		description: "Reverse primary fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-900",
-			position: 0
-		}, {
-			color: "primary-50",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-light-dark",
-		name: "Secondary Light to Dark",
-		description: "Subtle secondary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "secondary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-light-dark",
-		name: "Accent Light to Dark",
-		description: "Accent color depth fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "background-surface",
-		name: "Background to Surface",
-		description: "Subtle depth using base colors",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "background",
-			position: 0
-		}, {
-			color: "surface",
-			position: 100
-		}]
-	},
-	{
-		id: "neutral-fade",
-		name: "Neutral Gradient",
-		description: "Elegant neutral color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "neutral-900",
-			position: 0
-		}, {
-			color: "neutral-50",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-radial",
-		name: "Primary Spotlight",
-		description: "Radial primary gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-radial",
-		name: "Accent Spotlight",
-		description: "Radial accent gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-secondary-accent",
-		name: "Brand Trio",
-		description: "All three brand colors in harmony",
-		type: "linear",
-		angle: 135,
-		stops: [
-			{
-				color: "primary-500",
-				position: 0
-			},
-			{
-				color: "secondary-500",
-				position: 50
-			},
-			{
-				color: "accent-500",
-				position: 100
-			}
-		]
-	}
-];
-//#endregion
-//#region ../theme-core/src/gradients/utils.ts
-/**
-* Convert a GradientConfig to a CSS gradient string
-*
-* @param config - The gradient configuration using theme tokens
-* @param tokens - Map of theme color tokens to hex values
-* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
-*/
-function gradientToCss(config, tokens) {
-	const stops = config.stops.map((stop) => {
-		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
-	}).join(", ");
-	const type = config.type ?? "linear";
-	if (type === "radial") {
-		const position = config.position ?? "center";
-		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
-	}
-	if (type === "conic") {
-		const position = config.position ?? "center";
-		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
-	}
-	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
-}
-//#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 function resolveBackgroundMedia(input) {
 	const parsedMedia = mediaSchema.safeParse(input.image);
@@ -43113,9 +43994,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString(value)) return null;
-	const preset = GRADIENT_PRESETS.find((candidate) => candidate.id === value.trim());
-	if (!preset) return null;
+	const presetId = parseGradientPresetId(value);
+	if (!presetId) return null;
+	const preset = getGradientPreset(presetId);
 	return gradientToCss(preset, Object.fromEntries(preset.stops.map((stop) => [stop.color, `rgb(var(--tb-${stop.color}))`])));
 }
 const backgroundTransforms = [
@@ -43154,16 +44035,17 @@ const backgroundTransforms = [
 		run: (value, _options, context) => resolveSurfaceForegroundStyles(value, context)
 	},
 	{
-		id: "background.resolveAllowOverflow",
+		id: "background.resolveFrameClassName",
 		kind: "formatter",
-		summary: "Resolve allowOverflow from background config (explicit overflow or scaled image)",
-		run: (value) => {
-			if (!value || typeof value !== "object") return false;
+		summary: "Resolve clipping on a decorative background frame without clipping foreground content",
+		run: (value, options) => {
+			const baseClass = options?.baseClass?.trim() ?? "";
+			if (!value || typeof value !== "object") return `${baseClass} rb-overflow-hidden`.trim();
 			const input = value;
-			if (input.overflow === true) return true;
+			if (input.overflow === true) return `${baseClass} rb-overflow-visible`.trim();
 			const objectFit = isString(input.objectFit) ? input.objectFit.trim() : null;
 			const scale = isString(input.scale) ? input.scale.trim() : isNumber(input.scale) ? String(input.scale) : null;
-			return Boolean((objectFit === "custom" || objectFit === "original") && scale && scale.trim().length > 0);
+			return `${baseClass} ${Boolean((objectFit === "custom" || objectFit === "original") && scale && scale.trim().length > 0) ? "rb-overflow-visible" : "rb-overflow-hidden"}`.trim();
 		}
 	},
 	{
@@ -43713,10 +44595,10 @@ function isRecord$7(value) {
 }
 //#endregion
 //#region ../blocks/src/primitives/layout/Section.tsx
-const Section = forwardRef(function Section({ as: Comp = "section", children, background, className = "", allowOverflow = false, style, "data-slot": dataSlot }, ref) {
+const Section = forwardRef(function Section({ as: Comp = "section", children, background, className = "", style, "data-slot": dataSlot }, ref) {
 	return /* @__PURE__ */ jsx(Comp, {
 		ref,
-		className: clsx("rb-relative rb-isolate", allowOverflow ? "rb-overflow-visible" : "rb-overflow-hidden", className),
+		className: clsx("rb-relative rb-isolate rb-overflow-visible", className),
 		style: mergeStyles(typeof background === "string" && background.trim().length > 0 ? backgroundColorStyle(background.trim()) : void 0, style),
 		"data-slot": dataSlot ?? "section",
 		children
@@ -43837,10 +44719,7 @@ function Grid({ as: Comp = "div", cols = {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/layout.tsx
-const SectionNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, allowOverflow, ...props }) => /* @__PURE__ */ jsx(Section, {
-	...props,
-	allowOverflow
-});
+const SectionNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Section, { ...props });
 const StackNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Stack, { ...props });
 const InlineNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Inline, { ...props });
 const GridNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Grid, { ...props });
@@ -43850,6 +44729,28 @@ const FigureNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _b
 //#region ../path-utils/src/index.ts
 const PATH_SEPARATOR_REGEX$1 = /\./g;
 const BRACKET_ACCESS_REGEX$1 = /\[([^\]]+)\]/g;
+/**
+* Segments that would traverse or mutate the prototype chain.
+*
+* `setAtPath` creates nested objects along the path, so allowing these
+* segments is a prototype-pollution vector. They are rejected everywhere a
+* path is parsed (string or pre-parsed array form) — fail closed.
+*/
+const UNSAFE_PATH_SEGMENTS = /* @__PURE__ */ new Set([
+	"__proto__",
+	"constructor",
+	"prototype"
+]);
+var UnsafePathSegmentError = class extends Error {
+	constructor(segment) {
+		super(`Unsafe path segment: "${segment}"`);
+		this.name = "UnsafePathSegmentError";
+		this.segment = segment;
+	}
+};
+function assertSafePathSegments(segments) {
+	for (const segment of segments) if (typeof segment === "string" && UNSAFE_PATH_SEGMENTS.has(segment)) throw new UnsafePathSegmentError(segment);
+}
 function isRecord$6(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -43861,7 +44762,10 @@ function getContainerValue(container, segment) {
 	if (segment in container) return Reflect.get(container, segment);
 }
 function parsePath(path) {
-	if (Array.isArray(path)) return path;
+	if (Array.isArray(path)) {
+		assertSafePathSegments(path);
+		return path;
+	}
 	const segments = [];
 	const parts = path.split(PATH_SEPARATOR_REGEX$1);
 	for (const raw of parts) {
@@ -43881,6 +44785,7 @@ function parsePath(path) {
 		}
 		if (baseMatch === null && !raw.includes("[")) segments.push(raw);
 	}
+	assertSafePathSegments(segments);
 	return segments;
 }
 function getAtPath(source, path) {
@@ -44122,6 +45027,58 @@ function getCtaIconComponent(name) {
 	return CTA_ICON_COMPONENTS[name] ?? null;
 }
 //#endregion
+//#region ../blocks/src/system/icons/social.tsx
+const SOCIAL_ICON_NAMES = [
+	"SocialFacebook",
+	"SocialInstagram",
+	"SocialLinkedIn",
+	"SocialTikTok",
+	"SocialX",
+	"SocialYouTube"
+];
+const socialIcons = {
+	SocialFacebook: createIcon("SocialFacebookIcon", /* @__PURE__ */ jsx("path", { d: "M14 8h3V4h-3c-3 0-5 2-5 5v3H6v4h3v6h4v-6h3l1-4h-4V9c0-.7.3-1 1-1Z" })),
+	SocialInstagram: createIcon("SocialInstagramIcon", /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx("rect", {
+			x: "3",
+			y: "3",
+			width: "18",
+			height: "18",
+			rx: "5"
+		}),
+		/* @__PURE__ */ jsx("circle", {
+			cx: "12",
+			cy: "12",
+			r: "4"
+		}),
+		/* @__PURE__ */ jsx("circle", {
+			cx: "17.5",
+			cy: "6.5",
+			r: ".75",
+			fill: "currentColor",
+			stroke: "none"
+		})
+	] })),
+	SocialLinkedIn: createIcon("SocialLinkedInIcon", /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx("path", { d: "M6 9v10" }),
+		/* @__PURE__ */ jsx("path", {
+			d: "M6 5.5v.01",
+			strokeWidth: "3"
+		}),
+		/* @__PURE__ */ jsx("path", { d: "M10.5 19v-6a4 4 0 0 1 8 0v6" }),
+		/* @__PURE__ */ jsx("path", { d: "M10.5 9v10" })
+	] })),
+	SocialTikTok: createIcon("SocialTikTokIcon", /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("path", { d: "M14 4v11.5a4.5 4.5 0 1 1-4-4.47" }), /* @__PURE__ */ jsx("path", { d: "M14 4c.7 3 2.4 4.5 5 4.5" })] })),
+	SocialX: createIcon("SocialXIcon", /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("path", { d: "m5 4 14 16" }), /* @__PURE__ */ jsx("path", { d: "M19 4 5 20" })] })),
+	SocialYouTube: createIcon("SocialYouTubeIcon", /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("path", { d: "M21 12c0 3.5-.5 5.5-1.3 6.3S16.5 19.5 12 19.5s-6.9-.4-7.7-1.2S3 15.5 3 12s.5-5.5 1.3-6.3S7.5 4.5 12 4.5s6.9.4 7.7 1.2S21 8.5 21 12Z" }), /* @__PURE__ */ jsx("path", { d: "m10 9 5 3-5 3Z" })] }))
+};
+function isSocialIconName(value) {
+	return typeof value === "string" && SOCIAL_ICON_NAMES.includes(value);
+}
+function getSocialIconComponent(value) {
+	return isSocialIconName(value) ? socialIcons[value] : null;
+}
+//#endregion
 //#region ../blocks/src/system/icons/registry.ts
 function buildSearchText(parts) {
 	return parts.map((part) => part.trim()).filter(Boolean).join(" ");
@@ -44151,7 +45108,7 @@ function semanticOptionsForPreset(preset) {
 }
 semanticOptionsForPreset("feature");
 function getIconComponent(name) {
-	return getCtaIconComponent(name) ?? getSemanticIconComponent(name);
+	return getCtaIconComponent(name) ?? getSemanticIconComponent(name) ?? getSocialIconComponent(name);
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/buttonAffordance.ts
@@ -44943,7 +45900,6 @@ const HeaderSectionNode = ({ blockId, children, className, "data-preview-site-ch
 	const asProp = rest.as;
 	const styleProp = rest.style;
 	const backgroundProp = typeof rest.background === "string" ? rest.background : void 0;
-	const allowOverflowProp = typeof rest.allowOverflow === "boolean" ? rest.allowOverflow : void 0;
 	const dataSlotProp = typeof rest["data-slot"] === "string" ? rest["data-slot"] : void 0;
 	return /* @__PURE__ */ jsxs("nav", {
 		...getIslandRootProps("headerSection", blockId),
@@ -44958,7 +45914,6 @@ const HeaderSectionNode = ({ blockId, children, className, "data-preview-site-ch
 			as: asProp,
 			style: styleProp,
 			background: backgroundProp ?? "background",
-			allowOverflow: allowOverflowProp,
 			"data-slot": dataSlotProp,
 			className: sectionClasses || void 0,
 			children
@@ -47205,7 +48160,7 @@ function resolveGroupFrame(cardStyles) {
 		contentClassName: "offerings-preview-card-content rb-flex rb-h-full rb-min-h-full rb-flex-col rb-gap-5"
 	};
 	return {
-		containerClassName: ["offerings-preview-card offerings-preview-card--framed rb-relative rb-isolate rb-h-full rb-min-h-full rb-overflow-hidden rb-bg-surface rb-border rb-border-border", resolveGroupFrameClasses(cardStyles)].filter(Boolean).join(" "),
+		containerClassName: ["offerings-preview-card offerings-preview-card--framed rb-relative rb-isolate rb-h-full rb-min-h-full rb-overflow-visible rb-bg-surface rb-border rb-border-border", resolveGroupFrameClasses(cardStyles)].filter(Boolean).join(" "),
 		containerStyle: resolveGroupFrameStyle(cardStyles),
 		contentClassName: "card-content offerings-preview-card-content rb-flex rb-h-full rb-min-h-full rb-flex-col rb-gap-5"
 	};
@@ -50238,9 +51193,9 @@ function isReactNode(value) {
 * Handles conditionals ($when), scopes ($scopes), repeaters ($repeat), bindings ($bind), and children.
 */
 function resolveNode(node, context, indexFallback) {
-	if (!shouldRenderNode(node, context)) return null;
 	const scopeContext = applyScopes(node, context);
 	if (node.$repeat) return resolveRepeater(node, scopeContext);
+	if (!shouldRenderNode(node, scopeContext)) return null;
 	const registry = scopeContext.registry ?? serverComponentRegistry;
 	const normalizedType = node.type.toLowerCase();
 	const component = registry[node.type] ?? registry[normalizedType] ?? (normalizedType === "section" ? SectionNode : void 0);
@@ -51613,6 +52568,19 @@ const NAV_DROPDOWN_CONTAINER_RAIL_CSS_RULES = [
 //#region ../theme-core/src/header/generateHeaderCss.ts
 const HEADER_BLUR = "blur(12px)";
 const FLOATING_BLUR = "blur(16px)";
+const INSET_SHELL_MARKER_CLASS = "header-bar-frame-inset-shell";
+const INSET_SHELL_EDGE = "1rem";
+const INSET_SHELL_INSET_BLOCK = "0.875rem";
+const INSET_SHELL_RADIUS = "9999px";
+const INSET_SHELL_CONTAINER_MAX = "80rem";
+const INSET_SHELL_INTERIOR_PADDING_X = "1.75rem";
+/**
+* Whether the classic header should render as an inset "brand capsule" shell.
+* The facet is only meaningful for the classic layout; other variants ignore it.
+*/
+function usesInsetShell(header) {
+	return header.barFrame === "inset-shell" && header.variant === "classic";
+}
 /**
 * Generate complete CSS for header system from theme config
 *
@@ -51712,7 +52680,36 @@ function generateHeaderRootStyles(header, themeId, tokens, _theme) {
 	const baseBlock = `\n${selector} {\n  ${rules.join("\n  ")}\n}\n`;
 	const overlayFix = `\n${`${selector}:has([data-nav-mobile-overlay][aria-hidden="false"])`} {\n  backdrop-filter: none !important;\n  -webkit-backdrop-filter: none !important;\n}\n`;
 	if (isContainedNav || backgroundRules.length === 0) return `${baseBlock}\n${overlayFix}`;
-	return `${baseBlock}\n${`\n${backgroundSelector} {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  pointer-events: none;\n  border-radius: inherit;\n  z-index: -1;\n  ${backgroundRules.join("\n  ")}\n}\n`}\n${overlayFix}`;
+	return `${baseBlock}\n${`\n${backgroundSelector} {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  pointer-events: none;\n  border-radius: inherit;\n  z-index: -1;\n  ${backgroundRules.join("\n  ")}\n}\n`}\n${overlayFix}${usesInsetShell(header) ? generateInsetShellStyles(header, themeId) : ""}`;
+}
+/**
+* Reshapes the full-bleed header paint layer into a contained brand capsule at
+* the desktop breakpoint. The capsule is centred, capped to the page container
+* width, inset from the top, fully rounded, and carries the header depth so it
+* reads as a floating pill. Root border/shadow are neutralised on desktop so a
+* bordered style does not leave a full-width hairline around the capsule. Sticky
+* positioning is unaffected — the root stays full width and sticky while the
+* ::before paint provides the capsule.
+*/
+function generateInsetShellStyles(header, themeId) {
+	const scope = `:where([data-theme-scope="${themeId}"])`;
+	const shellRootSelector = `${scope} .header-root.${INSET_SHELL_MARKER_CLASS}`;
+	const shellBeforeSelector = `${scope} .header-root.${INSET_SHELL_MARKER_CLASS}::before`;
+	const layoutSelector = `${scope} .header-root.${INSET_SHELL_MARKER_CLASS} .rb-header-layout`;
+	const widthValue = header.maxWidth === "full" ? `calc(100% - (${INSET_SHELL_EDGE} * 2))` : `min(${INSET_SHELL_CONTAINER_MAX}, calc(100% - (${INSET_SHELL_EDGE} * 2)))`;
+	const shadowVar = getComponentShadowVar(header.shadow?.elevation ?? "none");
+	const rootRules = ["border: none;", "box-shadow: none;"];
+	const beforeRules = [
+		`inset: ${INSET_SHELL_INSET_BLOCK} auto;`,
+		"left: 50%;",
+		"right: auto;",
+		"transform: translateX(-50%);",
+		`width: ${widthValue};`,
+		`border-radius: ${INSET_SHELL_RADIUS};`,
+		...shadowVar ? [`box-shadow: ${shadowVar};`] : []
+	];
+	const layoutRules = [`padding-inline: ${INSET_SHELL_INTERIOR_PADDING_X};`];
+	return `\n@media ${MQ_MD_UP} {\n${shellRootSelector} {\n  ${rootRules.join("\n  ")}\n}\n${shellBeforeSelector} {\n  ${beforeRules.join("\n  ")}\n}\n${layoutSelector} {\n  ${layoutRules.join("\n  ")}\n}\n}\n`;
 }
 /**
 * Generate logo typography styles
@@ -51790,7 +52787,7 @@ function generateLogoTextBehaviorStyles(logoText, themeId) {
 */
 function generateNavLinkStyles(header, themeId, tokens, theme, contrastTreatment, navTextSize) {
 	const navPreferences = {
-		typography: header.navTypography ?? "inherit",
+		typography: header.navFontRole ?? header.navTypography ?? "inherit",
 		fontSize: readHeaderNavFontSizePreference(header.navTextSize)
 	};
 	if (header.navLinkStyle) return generateNavLinkCSS({
@@ -53975,6 +54972,8 @@ function buildThemeCssVars(theme) {
 	const inputRadius = mapInputRadius(inputSystem.base.corners, theme.corners);
 	return {
 		...generateCssVars(theme.palette),
+		["--tb-secondaryForeground"]: "var(--tb-onSecondary)",
+		["--tb-accentForeground"]: "var(--tb-onAccent)",
 		["--tb-scrim"]: "0 0 0",
 		["--tb-shadow"]: "0 0 0",
 		...generateShadowCssVars(theme),
@@ -56140,6 +57139,12 @@ const containerResponsiveThemeCss = `/*
       .rb-lg-hidden {
         display: none;
       }
+      .rb-lg-flex-row {
+        flex-direction: row;
+      }
+      .rb-lg-items-center {
+        align-items: center;
+      }
     }
 
 }
@@ -62649,6 +63654,11 @@ const containerResponsiveThemeCss = `/*
   flex-wrap: wrap;
 }
 
+/* Text-style CTA actions belong to the section foreground contract. */
+:where(.theme-scope) [data-block="cta-full"] .cta-row .button-link {
+  color: var(--rb-surface-link-color, var(--rb-surface-text-color, rgb(var(--tb-primary))));
+}
+
 /* =============================================================================
  * Block: Body Text (content block, Phase 2)
  *
@@ -67576,7 +68586,7 @@ const containerResponsiveThemeCss = `/*
   [data-block="feature-cards"][data-block-composition="asymmetric-emphasis"]
   .rb-feature-card {
   height: auto;
-  overflow: hidden;
+  overflow: visible;
   border: 0;
   border-radius: 0;
   background: transparent;
@@ -68607,19 +69617,9 @@ function getPrimaryNavigation(navigation) {
 		return a.id.localeCompare(b.id);
 	})[0] ?? null;
 }
-/**
-* Get the footer navigation menu object.
-* Returns menu marked as isFooter, or null if none marked.
-*
-* @example
-* ```ts
-* const menu = getFooterNavigation(siteData.navigation);
-* console.log(menu?.name); // "Footer menu"
-* ```
-*/
-function getFooterNavigation(navigation) {
+function getFooterNavigationByRole(navigation, role) {
 	if (!navigation || navigation.length === 0) return null;
-	const footerMenus = navigation.filter((menu) => menu.isFooter);
+	const footerMenus = navigation.filter((menu) => menu.footerRole === role || role === "main" && menu.footerRole == null && menu.isFooter);
 	if (footerMenus.length > 1) console.warn(`[riverbank/sdk] Multiple footer navigation menus detected (${footerMenus.length}); using first flagged menu by input order.`);
 	return footerMenus[0] ?? null;
 }
@@ -68832,7 +69832,10 @@ function buildMenu(navigation, routes, options) {
 * ```
 */
 function buildFooterMenu(navigation, routes, options) {
-	const menu = getFooterNavigation(navigation);
+	return buildFooterMenuForRole(navigation, routes, "main", options);
+}
+function buildFooterMenuForRole(navigation, routes, role, options) {
+	const menu = getFooterNavigationByRole(navigation, role);
 	if (!menu) return {
 		items: [],
 		ctaItem: null,
@@ -68999,6 +70002,7 @@ async function Layout({ siteData: providedSiteData, client, siteId, slug, domain
 	};
 	const menuViewModel = buildMenu(navigation, routes, navigationOptions);
 	const footerMenuViewModel = buildFooterMenu(navigation, routes, navigationOptions);
+	const legalFooterMenuViewModel = buildFooterMenuForRole(navigation, routes, "legal-policy", navigationOptions);
 	const logoViewModel = buildLogo(layout.logo ?? null, site.title);
 	const headerData = {
 		menu: menuViewModel,
@@ -69010,6 +70014,7 @@ async function Layout({ siteData: providedSiteData, client, siteId, slug, domain
 	const footerData = {
 		menu: menuViewModel,
 		footerMenu: footerMenuViewModel,
+		legalFooterMenu: legalFooterMenuViewModel,
 		logo: logoViewModel,
 		site,
 		theme,
@@ -69045,6 +70050,7 @@ async function Layout({ siteData: providedSiteData, client, siteId, slug, domain
 		site,
 		menu: menuViewModel,
 		footerMenu: footerMenuViewModel,
+		legalFooterMenu: legalFooterMenuViewModel,
 		content: { logo: logoViewModel }
 	};
 	let headerElement = null;
@@ -69471,8 +70477,6 @@ function normalizeLoaderParams(endpoint, params, context) {
 	ensureSiteId(out, context);
 	return out;
 }
-//#endregion
-//#region ../api/src/apiEndpointTypes.ts
 function blockedDemoMutationPolicy(classification, publicMessage) {
 	if (publicMessage.trim() === "") throw new Error(`Demo mutation policy ${classification} requires publicMessage.`);
 	return {
@@ -69500,6 +70504,7 @@ const TAG_TEMPLATES = {
 	siteRouteOutcomes: "riverbank:site:{siteId}:route-outcomes",
 	routeById: "riverbank:route:{routeId}",
 	pageById: "riverbank:page:{pageId}",
+	pageSurfaceById: "riverbank:page-surface:{pageSurfaceId}",
 	workflowRunById: "riverbank:workflow-run:{runId}",
 	siteForms: "riverbank:site:{siteId}:forms",
 	formById: "riverbank:form:{formId}",
@@ -69523,7 +70528,7 @@ const TAG_TEMPLATES = {
 blockedDemoMutationPolicy("blocked-hidden", "This action is not available in demo sites.");
 blockedDemoMutationPolicy("blocked-disabled", "This setting is disabled in demo sites.");
 blockedDemoMutationPolicy("internal-only", "This internal operation is not available in demo sites.");
-TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.formById, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicTeamMembers, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicPasses, TAG_TEMPLATES.publicMemberships, TAG_TEMPLATES.publicProducts, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents;
+TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.formById, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicTeamMembers, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicCourses, TAG_TEMPLATES.publicPasses, TAG_TEMPLATES.publicMemberships, TAG_TEMPLATES.publicProducts, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicGifting, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents;
 z$1.object({
 	formulaVersion: z$1.literal("managed-domain-overage-v1"),
 	conversionRule: z$1.literal("usd-to-gbp-1-to-1-v1"),
@@ -69893,6 +70898,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -69905,7 +70911,12 @@ const CANONICAL_ADMIN_REFUND_FAILURE_CODES = [
 	"payment_intent_not_found",
 	"stripe_error",
 	"stale_pending_missing_context",
-	"non_refundable_deposit_remaining"
+	"non_refundable_deposit_remaining",
+	"deposit_refund_override_required",
+	"refund_revoke_requires_full_line_refund",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 [...CANONICAL_REFUND_PLANNER_ERROR_CODES];
 //#endregion
@@ -69918,7 +70929,10 @@ const STANDARD_LINE_ITEM_REFUND_INVALID_CODES = [
 	"missing_credit_customer",
 	"deposit_refund_override_required",
 	"refund_revoke_requires_full_line_refund",
-	"unified_order_link_required"
+	"unified_order_link_required",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 const EVENT_ATTENDEE_REFUND_INVALID_CODES = ["manual_booking_not_refundable", ...STANDARD_LINE_ITEM_REFUND_INVALID_CODES];
 [...CANONICAL_ADMIN_REFUND_FAILURE_CODES];