@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/client/rendering/client.mjs

@@ -509,7 +509,7 @@ function encodePublicProductCategorySelector(selector) {
 			};
 	}
 }
-function isRecord$20(value) {
+function isRecord$22(value) {
 	return typeof value === "object" && value !== null;
 }
 function isJsonResponseContentType(contentType) {
@@ -533,8 +533,8 @@ async function parseJsonBody(response) {
 	}
 }
 function getBlockApiErrorDetails(data) {
-	if (!isRecord$20(data)) return {};
-	const nestedError = isRecord$20(data.error) ? data.error : void 0;
+	if (!isRecord$22(data)) return {};
+	const nestedError = isRecord$22(data.error) ? data.error : void 0;
 	return {
 		message: typeof nestedError?.message === "string" ? nestedError.message : typeof data.message === "string" ? data.message : void 0,
 		code: typeof nestedError?.code === "string" ? nestedError.code : typeof data.code === "string" ? data.code : void 0
@@ -1496,10 +1496,10 @@ var init_colorStyles = __esmMin((() => {
 init_api();
 init_clsx();
 init_colorStyles();
-const Section$1 = forwardRef(function Section({ as: Comp = "section", children, background, className = "", allowOverflow = false, style, "data-slot": dataSlot }, ref) {
+const Section$1 = 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
@@ -1623,16 +1623,114 @@ 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$1, {
-	...props,
-	allowOverflow
-});
+const SectionNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Section$1, { ...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 });
 const DivNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("div", { ...props });
 const FigureNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("figure", { ...props });
-var blockColorTokenNames;
+//#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+var BUTTON_EFFECT_POLICIES;
+var init_effectClassification = __esmMin((() => {
+	BUTTON_EFFECT_POLICIES = {
+		"darken-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "darker"
+			}
+		},
+		"lighten-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "lighter"
+			}
+		},
+		"background-on-hover": {
+			classification: "colour-transition",
+			transition: { kind: "replace-background" }
+		},
+		"background-on-hover-alpha": {
+			classification: "unsupported-colour",
+			reason: "alpha_requires_surface"
+		},
+		"fade-background": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"opacity-reduce": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"gradient-text": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"text-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"border-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_border"
+		},
+		"aurora-glow": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"cosmic-stardust": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"animated-gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"nav-underline": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-base": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-hover": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-active": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"animated-gradient": { classification: "non-colour" },
+		"border-glow": { classification: "non-colour" },
+		"drop-shadow": { classification: "non-colour" },
+		"inner-shadow": { classification: "non-colour" },
+		"neumorphic-shadow": { classification: "non-colour" },
+		"outer-glow": { classification: "non-colour" },
+		"retro-3d-shadow": { classification: "non-colour" },
+		"scale-up": { classification: "non-colour" },
+		"scale-down": { classification: "non-colour" },
+		lift: { classification: "non-colour" },
+		"press-down": { classification: "non-colour" },
+		pop: { classification: "non-colour" },
+		"border-bottom-grow": { classification: "non-colour" },
+		"sketchy-border": { classification: "non-colour" },
+		"pulse-animation": { classification: "non-colour" }
+	};
+})), blockColorTokenNames;
 var init_blockColorTokens = __esmMin((() => {
 	init_colorTokenParts();
 	blockColorTokenNames = [
@@ -1743,9 +1841,155 @@ function asSpecialVariantId(value) {
 	if (value.length === 0) throw new Error("SpecialVariantId must be a non-empty string");
 	return value;
 }
-var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, buttonVariantSchema, buttonSystemSchema;
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray$2(background.stops) ? background.stops : [];
+	return [
+		input.hoverBackgroundToken,
+		background.colorToken,
+		background.foregroundToken,
+		...stops
+	].some((token) => stripLegacyTokenAlpha(token) !== token);
+}
+function stripLegacyTokenAlpha(value) {
+	if (typeof value !== "string") return value;
+	const slashIndex = value.indexOf("/");
+	return slashIndex < 0 ? value : value.slice(0, slashIndex);
+}
+function hasLegacyButtonEffects(input) {
+	if (!isUnknownRecord(input)) return false;
+	return [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	].some((state) => {
+		const effects = input[state];
+		return Array.isArray(effects) && effects.some((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return true;
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification !== "colour-transition" && classification !== "non-colour") return true;
+			return effect.effectId === "background-on-hover" && isUnknownRecord(effect.options) && stripLegacyTokenAlpha(effect.options.colorToken) !== effect.options.colorToken;
+		});
+	});
+}
+function normalizeLegacyButtonEffects(input, backgroundType) {
+	if (!isUnknownRecord(input)) return input;
+	const normalized = {};
+	for (const state of [
+		"base",
+		"hover",
+		"active",
+		"focus"
+	]) {
+		const effects = input[state];
+		if (!Array.isArray(effects)) continue;
+		const safeEffects = effects.flatMap((effect) => {
+			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return [];
+			const classification = classifyButtonEffectId(effect.effectId);
+			if (classification === "non-colour") return [effect];
+			if (classification !== "colour-transition") return [];
+			if (effect.effectId === "background-on-hover") {
+				const options = isUnknownRecord(effect.options) ? effect.options : null;
+				const colorToken = options === null ? null : parseOpaqueButtonColourToken(stripLegacyTokenAlpha(options.colorToken));
+				return colorToken === null ? [] : [{
+					...effect,
+					options: {
+						...options,
+						colorToken
+					}
+				}];
+			}
+			if (backgroundType !== "solid") return [];
+			const rawAmount = isUnknownRecord(effect.options) ? effect.options.amount : void 0;
+			const amount = typeof rawAmount === "number" && rawAmount > 0 ? Math.max(100, Math.round(rawAmount / 100) * 100) : 100;
+			return [{
+				...effect,
+				options: {
+					...isUnknownRecord(effect.options) ? effect.options : {},
+					amount
+				}
+			}];
+		});
+		if (safeEffects.length > 0) normalized[state] = safeEffects;
+	}
+	return Object.keys(normalized).length === 0 ? void 0 : normalized;
+}
+function isUnknownRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownArray$2(value) {
+	return Array.isArray(value);
+}
+var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, opaqueButtonColourTokenSchema, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, canonicalButtonGlobalSettingsSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonColourTreatmentSchema, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, canonicalButtonVariantSchema, buttonVariantSchema, buttonSystemSchema;
 var init_types$17 = __esmMin((() => {
+	init_effectClassification();
 	init_themeColorTokens();
+	init_colorTokenParts();
 	VARIANT_ROLES = [
 		"primary",
 		"secondary",
@@ -1756,6 +2000,11 @@ var init_types$17 = __esmMin((() => {
 		"accent"
 	];
 	DEFAULT_VARIANT_ALIAS_ID = "default";
+	opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+		const token = parseOpaqueButtonColourToken(value);
+		if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+		return token;
+	});
 	cornerStyleSchema = z$1.enum([
 		"square",
 		"rounded",
@@ -1844,7 +2093,7 @@ var init_types$17 = __esmMin((() => {
 		lg,
 		xl: xl ?? lg
 	}));
-	buttonGlobalSettingsSchema = z$1.object({
+	canonicalButtonGlobalSettingsSchema = z$1.object({
 		cornerStyle: cornerStyleSchema,
 		cornerRadius: z$1.number().min(0).max(24).optional(),
 		/**
@@ -1875,11 +2124,12 @@ var init_types$17 = __esmMin((() => {
 		paddingPreset: buttonPaddingPresetSchema.optional(),
 		hoverTransform: hoverTransformSchema,
 		hoverColor: hoverColorSchema,
-		hoverColorToken: themeColorTokenSchema.optional(),
+		hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 		gradientStyle: gradientStyleSchema.optional(),
 		gradientAngle: z$1.number().min(0).max(360).optional(),
 		gradientSharpness: gradientSharpnessSchema.optional()
 	});
+	buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 	gradientDirectionSchema$1 = z$1.enum([
 		"to-r",
 		"to-l",
@@ -1890,30 +2140,37 @@ var init_types$17 = __esmMin((() => {
 		"to-br",
 		"to-bl"
 	]);
-	buttonBackgroundSchema = z$1.discriminatedUnion("type", [
+	buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
 		z$1.object({
 			type: z$1.literal("solid"),
-			colorToken: themeColorTokenSchema
+			colorToken: opaqueButtonColourTokenSchema
 		}),
 		z$1.object({
 			type: z$1.literal("gradient"),
-			stops: z$1.array(themeColorTokenSchema).min(2),
-			direction: gradientDirectionSchema$1
+			stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+				const [first, second, ...rest] = stops;
+				if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+				return [
+					first,
+					second,
+					...rest
+				];
+			}),
+			direction: gradientDirectionSchema$1,
+			foregroundToken: opaqueButtonColourTokenSchema
 		}),
-		z$1.object({ type: z$1.literal("transparent") })
+		z$1.object({
+			type: z$1.literal("surface"),
+			role: z$1.literal("link")
+		})
 	]);
+	buttonBackgroundSchema = buttonColourTreatmentSchema;
 	effectApplicationSchema$1 = z$1.object({
 		effectId: z$1.string(),
-		options: z$1.record(z$1.string(), z$1.any()).optional()
-	});
-	buttonBorderSchema = z$1.object({
-		widthClass: z$1.string(),
-		colorToken: themeColorTokenSchema
-	});
-	buttonVariantAffordanceSchema = z$1.object({
-		iconId: z$1.string().min(1),
-		colorToken: themeColorTokenSchema.optional()
+		options: z$1.record(z$1.string(), z$1.json()).optional()
 	});
+	buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+	buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 	variantShadowSchema = z$1.object({
 		elevation: z$1.enum([
 			"none",
@@ -1941,22 +2198,22 @@ var init_types$17 = __esmMin((() => {
 		lg: buttonSizeConfigSchema.optional(),
 		xl: buttonSizeConfigSchema.optional()
 	});
-	buttonVariantSchema = z$1.object({
+	canonicalButtonVariantSchema = z$1.object({
 		id: z$1.string(),
 		name: z$1.string().min(1).max(20),
 		enabled: z$1.boolean(),
 		priority: prioritySchema,
 		background: buttonBackgroundSchema,
-		textColorToken: themeColorTokenSchema,
 		/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 		borderRadius: z$1.string().optional(),
 		shadow: variantShadowSchema.optional(),
 		border: buttonBorderSchema.optional(),
-		hoverBackgroundToken: z$1.string().optional(),
+		hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 		effects: variantEffectsSchema.optional(),
 		sizes: variantSizeOverridesSchema.optional(),
 		affordance: buttonVariantAffordanceSchema.optional()
 	});
+	buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 	buttonSystemSchema = z$1.object({
 		global: buttonGlobalSettingsSchema,
 		variants: z$1.array(buttonVariantSchema).min(1).max(6),
@@ -1995,8 +2252,7 @@ var init_classNames = __esmMin((() => {
 }));
 var init_resolver$1 = __esmMin((() => {}));
 var init_generateBaseCSS = __esmMin((() => {}));
-var init_background$2 = __esmMin((() => {}));
-var STATE_SELECTORS, init_cssUtils = __esmMin((() => {
+var init_background$2 = __esmMin((() => {})), STATE_SELECTORS, init_cssUtils = __esmMin((() => {
 	STATE_SELECTORS = {
 		hover: ":hover, [data-force-hover=\"true\"]",
 		active: ":active",
@@ -2032,13 +2288,130 @@ var init_registry$1 = __esmMin((() => {
 	init_border();
 	init_animation();
 	init_effects();
-}));
-var init_generateEffectsCSS = __esmMin((() => {
+})), init_generateEffectsCSS = __esmMin((() => {
 	init_registry$1();
-})), init_contrast$2 = __esmMin((() => {}));
+}));
 var init_generateDefaultButtonSystem = __esmMin((() => {
-	init_contrast$2();
-})), init_affordanceIcons = __esmMin((() => {})), AFFORDANCE_SUPPRESS_CLASS;
+	init_types$17();
+}));
+var init_affordanceIcons = __esmMin((() => {}));
+//#endregion
+//#region ../theme-core/src/palette/utils/colorConversion.ts
+function hexToRgb$1(hex) {
+	const h = hex.replace(/^#/, "");
+	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
+	if (m.length !== 6) throw new Error("Bad hex");
+	const int = parseInt(m, 16);
+	return {
+		r: int >> 16 & 255,
+		g: int >> 8 & 255,
+		b: int & 255
+	};
+}
+function srgbToLinear(u) {
+	const x = u / 255;
+	return x <= .04045 ? x / 12.92 : Math.pow((x + .055) / 1.055, 2.4);
+}
+function linearToSrgb(x) {
+	const y = x <= .0031308 ? 12.92 * x : 1.055 * Math.pow(x, 1 / 2.4) - .055;
+	return clamp01$2(y) * 255;
+}
+var clamp01$2, mod, deg;
+var init_colorConversion = __esmMin((() => {
+	clamp01$2 = (x) => Math.max(0, Math.min(1, x));
+	mod = (a, n) => (a % n + n) % n;
+	deg = (x) => mod(x, 360);
+}));
+var init_generateShades = __esmMin((() => {
+	init_colorConversion();
+}));
+var init_neutralScale = __esmMin((() => {
+	init_colorConversion();
+}));
+//#endregion
+//#region ../theme-core/src/palette/utils/contrast.ts
+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$1(hex1);
+	const { r: r2, g: g2, b: b2 } = hexToRgb$1(hex2);
+	const L1 = relativeLuminance(r1, g1, b1);
+	const L2 = relativeLuminance(r2, g2, b2);
+	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
+	return (hi + .05) / (lo + .05);
+}
+var init_contrast$1 = __esmMin((() => {
+	init_colorConversion();
+}));
+//#endregion
+//#region ../theme-core/src/palette/utils/textColor.ts
+/**
+* Pick the better of black/white text for a given background using actual
+* contrast ratios, not a simple luminance cutoff.
+*
+* @param background - Background color in hex or rgb/rgba format (e.g., '#FFFFFF' or 'rgb(255, 255, 255)')
+* @param minContrast - Preferred minimum contrast ratio for body-sized text
+* @returns '#000000' for light backgrounds, '#FFFFFF' for dark backgrounds
+*/
+function pickBlackOrWhiteTextColor(background, minContrast = 4.5) {
+	const { r, g, b } = parseColorToRgb(background);
+	const luminance = relativeLuminance(r, g, b);
+	const blackContrast = (luminance + .05) / .05;
+	const whiteContrast = 1.05 / (luminance + .05);
+	if (blackContrast >= minContrast && whiteContrast < minContrast) return "#000000";
+	if (whiteContrast >= minContrast && blackContrast < minContrast) return "#FFFFFF";
+	return blackContrast >= whiteContrast ? "#000000" : "#FFFFFF";
+}
+/**
+* Backwards-compatible alias for callers that want the best black/white text
+* color for a background.
+*/
+function getTextColorForBackground(background) {
+	return pickBlackOrWhiteTextColor(background);
+}
+function parseColorToRgb(input) {
+	const trimmed = input.trim();
+	if (trimmed.startsWith("#")) return hexToRgb$1(trimmed);
+	const rgbMatch = trimmed.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})(?:\s*,\s*(?:0|1|0?\.\d+))?\s*\)$/i);
+	if (rgbMatch?.[1] && rgbMatch[2] && rgbMatch[3]) return {
+		r: clamp255(Number(rgbMatch[1])),
+		g: clamp255(Number(rgbMatch[2])),
+		b: clamp255(Number(rgbMatch[3]))
+	};
+	throw new Error("Unsupported color format");
+}
+function clamp255(value) {
+	if (Number.isNaN(value)) return 0;
+	return Math.max(0, Math.min(255, value));
+}
+var init_textColor = __esmMin((() => {
+	init_colorConversion();
+	init_contrast$1();
+}));
+//#endregion
+//#region ../theme-core/src/palette/utils/onColor.ts
+function onColorTokenName(backgroundToken) {
+	return `on${backgroundToken.split("-").filter((part) => part.length > 0).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("")}`;
+}
+var init_onColor = __esmMin((() => {}));
+var init_expandPalette = __esmMin((() => {
+	init_generateShades();
+	init_neutralScale();
+	init_colorConversion();
+	init_textColor();
+	init_onColor();
+}));
+var init_resolveButtonColourStates = __esmMin((() => {
+	init_contrast$1();
+	init_colorConversion();
+	init_onColor();
+	init_foregroundContract();
+	init_types$17();
+	init_constants$2();
+	init_effectClassification();
+})), init_resolvedButtonCss = __esmMin((() => {})), AFFORDANCE_SUPPRESS_CLASS;
 var init_generateButtonCss = __esmMin((() => {
 	init_types$17();
 	init_classNames();
@@ -2048,10 +2421,13 @@ var init_generateButtonCss = __esmMin((() => {
 	init_constants$2();
 	init_generateDefaultButtonSystem();
 	init_affordanceIcons();
+	init_expandPalette();
+	init_foregroundContract();
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
 	AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 	buttonSizeNameSchema.options;
 }));
-var init_presets$1 = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/site-styles/styleTags.ts
 var STYLE_AXIS_VALUES, styleTagsSchema;
@@ -2100,7 +2476,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 var buttonPersonalityIdSchema;
@@ -2165,19 +2541,15 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["primary", "accent"],
-						direction: "to-r"
+						direction: "to-r",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "secondary",
@@ -2187,32 +2559,27 @@ var init_brushed_wash = __esmMin((() => {
 					background: {
 						type: "gradient",
 						stops: ["secondary", "accent"],
-						direction: "to-br"
+						direction: "to-br",
+						foregroundToken: "primaryForeground"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
 					shadow: {
 						elevation: "low",
 						softness: "soft",
 						position: "bottom"
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -15 }
-					}] }
+					}
 				},
 				{
 					id: "outline",
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -2223,8 +2590,10 @@ var init_brushed_wash = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-lg",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -2270,7 +2639,6 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					shadow: {
 						elevation: "medium",
@@ -2280,7 +2648,7 @@ var init_confident_chip = __esmMin((() => {
 					effects: {
 						hover: [{
 							effectId: "darken-background",
-							options: { amount: 60 }
+							options: { amount: 100 }
 						}],
 						active: [{
 							effectId: "scale-down",
@@ -2297,12 +2665,8 @@ var init_confident_chip = __esmMin((() => {
 						type: "solid",
 						colorToken: "surface"
 					},
-					textColorToken: "text",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -2313,13 +2677,12 @@ var init_confident_chip = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -2330,8 +2693,10 @@ var init_confident_chip = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-md",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -2394,7 +2759,6 @@ var init_earth_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -2420,13 +2784,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -2437,13 +2800,12 @@ var init_earth_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surfaceAlt" }
@@ -2454,8 +2816,10 @@ var init_earth_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "none",
@@ -2476,11 +2840,7 @@ var init_earth_pill = __esmMin((() => {
 							padding: "0.625rem 0",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 25 }
-					}] }
+					}
 				}
 			]
 		}
@@ -2516,8 +2876,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Primary",
 					enabled: true,
 					priority: 1,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -2539,8 +2901,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -2562,8 +2926,10 @@ var init_editorial_link = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
@@ -2585,19 +2951,17 @@ var init_editorial_link = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "mutedText",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: { padding: "0.25rem 0" },
 						md: { padding: "0.5rem 0" },
 						lg: { padding: "0.625rem 0" },
 						xl: { padding: "0.75rem 0" }
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: -20 }
-					}] }
+					}
 				}
 			]
 		}
@@ -2655,12 +3019,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accent"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -2674,13 +3034,12 @@ var init_flat_ink = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-lg",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-lg",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -2698,12 +3057,8 @@ var init_flat_ink = __esmMin((() => {
 						type: "solid",
 						colorToken: "accent"
 					},
-					textColorToken: "accentForeground",
 					borderRadius: "rounded-lg",
-					affordance: {
-						iconId: "ArrowRight",
-						colorToken: "accentForeground"
-					},
+					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "lift",
 						options: { translateY: "-2px" }
@@ -2766,7 +3121,6 @@ var init_ink_stamp = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
 					effects: {
 						hover: [{
@@ -2787,13 +3141,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -2804,13 +3157,12 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border-2",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -2821,8 +3173,10 @@ var init_ink_stamp = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -2909,7 +3263,6 @@ var init_joy_stamp = __esmMin((() => {
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "high",
@@ -2923,13 +3276,12 @@ var init_joy_stamp = __esmMin((() => {
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "text"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				shadow: {
 					elevation: "high",
 					softness: "hard",
@@ -2994,12 +3346,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: {
 						hover: [{
 							effectId: "background-on-hover",
@@ -3020,12 +3368,8 @@ var init_ornate_ritual = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -3036,13 +3380,12 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-md",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-md",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "muted" }
@@ -3053,8 +3396,10 @@ var init_ornate_ritual = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "accent",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-none",
 					sizes: {
 						sm: {
@@ -3136,14 +3481,10 @@ var init_pebble = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 88
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -3151,13 +3492,12 @@ var init_pebble = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "accent"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "accent" }
@@ -3168,13 +3508,12 @@ var init_pebble = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -3185,8 +3524,10 @@ var init_pebble = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					sizes: {
 						sm: {
@@ -3202,11 +3543,7 @@ var init_pebble = __esmMin((() => {
 							padding: "0.75rem 1.5rem",
 							fontSize: "text-xl"
 						}
-					},
-					effects: { hover: [{
-						effectId: "opacity-reduce",
-						options: { reduction: 30 }
-					}] }
+					}
 				}
 			]
 		}
@@ -3267,15 +3604,11 @@ var init_quiet_arrow = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-xl",
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
-						effectId: "background-on-hover-alpha",
-						options: {
-							colorToken: "primary",
-							opacity: 90
-						}
+						effectId: "darken-background",
+						options: { amount: 100 }
 					}] }
 				},
 				{
@@ -3283,13 +3616,12 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-xl",
+					border: { widthClass: "border" },
 					affordance: { iconId: "ArrowRight" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -3301,21 +3633,22 @@ var init_quiet_arrow = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl",
-					border: {
-						widthClass: "border",
-						colorToken: "primary"
-					}
+					border: { widthClass: "border" }
 				},
 				{
 					id: "ghost",
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-xl"
 				}
 			]
@@ -3378,7 +3711,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "background",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -3387,13 +3719,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{ effectId: "pop" }] }
 				},
 				{
@@ -3405,7 +3736,6 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "secondary"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
 					effects: { hover: [{ effectId: "pop" }] }
 				},
@@ -3418,12 +3748,8 @@ var init_showtime_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "background"
 					},
-					textColorToken: "primary",
 					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
-					},
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -3434,13 +3760,12 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "background" }
@@ -3451,8 +3776,10 @@ var init_showtime_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "primary",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -3498,7 +3825,6 @@ var init_soft_pill = __esmMin((() => {
 						type: "solid",
 						colorToken: "primary"
 					},
-					textColorToken: "primaryForeground",
 					borderRadius: "rounded-full",
 					shadow: {
 						elevation: "low",
@@ -3521,13 +3847,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Secondary",
 					enabled: true,
 					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border-2" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -3538,13 +3863,12 @@ var init_soft_pill = __esmMin((() => {
 					name: "Outline",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
+					background: {
+						type: "surface",
+						role: "link"
 					},
+					borderRadius: "rounded-full",
+					border: { widthClass: "border" },
 					effects: { hover: [{
 						effectId: "background-on-hover",
 						options: { colorToken: "surface" }
@@ -3555,8 +3879,10 @@ var init_soft_pill = __esmMin((() => {
 					name: "Ghost",
 					enabled: true,
 					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
+					background: {
+						type: "surface",
+						role: "link"
+					},
 					borderRadius: "rounded-full",
 					effects: { hover: [{
 						effectId: "background-on-hover",
@@ -3566,6 +3892,53 @@ var init_soft_pill = __esmMin((() => {
 			]
 		}
 	});
+}));
+//#endregion
+//#region ../theme-core/src/buttons/personalities/two-tone-pill.ts
+var solidSecondary, twoTonePill;
+var init_two_tone_pill = __esmMin((() => {
+	init_types$17();
+	init_soft_pill();
+	init_types$16();
+	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" }
+			}]
+		}
+	};
+	twoTonePill = 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)
+		}
+	});
 })), buttonPersonalities;
 var init_personalities = __esmMin((() => {
 	init_brushed_wash();
@@ -3580,9 +3953,11 @@ var init_personalities = __esmMin((() => {
 	init_quiet_arrow();
 	init_showtime_pill();
 	init_soft_pill();
+	init_two_tone_pill();
 	init_types$16();
 	buttonPersonalities = [
 		softPill,
+		twoTonePill,
 		earthPill,
 		confidentChip,
 		editorialLink,
@@ -3597,20 +3972,49 @@ var init_personalities = __esmMin((() => {
 	];
 	new Map(buttonPersonalities.map((p) => [p.id, p]));
 }));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
+var init_presets$2 = __esmMin((() => {
+	init_personalities();
+	buttonPersonalities.map((personality) => ({
+		id: personality.id,
+		name: personality.name,
+		description: personality.description,
+		category: presetCategory(personality),
+		buttonSystem: personality.buttonSystem,
+		compatibility: {
+			...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+			...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+		}
+	}));
+}));
 //#endregion
 //#region ../theme-core/src/buttons/effects/types.ts
 var init_types$15 = __esmMin((() => {}));
-var init_core$2 = __esmMin((() => {}));
+var init_core$2 = __esmMin((() => {
+	init_resolveButtonColourStates();
+	init_resolvedButtonCss();
+	init_types$17();
+}));
 //#endregion
 //#region ../theme-core/src/buttons/index.ts
 var init_buttons = __esmMin((() => {
 	init_types$17();
 	init_classNames();
 	init_generateButtonCss();
+	init_resolveButtonColourStates();
 	init_affordanceIcons();
 	init_generateDefaultButtonSystem();
 	init_constants$2();
-	init_presets$1();
+	init_presets$2();
 	init_personalities();
 	init_types$15();
 	init_registry$1();
@@ -3624,18 +4028,43 @@ init_buttons();
 //#region ../path-utils/src/index.ts
 const PATH_SEPARATOR_REGEX = /\./g;
 const BRACKET_ACCESS_REGEX = /\[([^\]]+)\]/g;
-function isRecord$19(value) {
+/**
+* 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$21(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isPathContainer(value) {
-	return Array.isArray(value) || isRecord$19(value);
+	return Array.isArray(value) || isRecord$21(value);
 }
 function getContainerValue(container, segment) {
 	if (typeof segment === "number") return Array.isArray(container) ? container[segment] : void 0;
 	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);
 	for (const raw of parts) {
@@ -3655,6 +4084,7 @@ function parsePath(path) {
 		}
 		if (baseMatch === null && !raw.includes("[")) segments.push(raw);
 	}
+	assertSafePathSegments(segments);
 	return segments;
 }
 function getAtPath(source, path) {
@@ -3930,7 +4360,7 @@ var init_event_pricing = __esmMin((() => {
 //#endregion
 //#region ../core/src/event-page-surface-subject.ts
 function parseEventPageSurfaceSubject(value) {
-	if (!isRecord$18(value)) return err$2({ kind: "notObject" });
+	if (!isRecord$20(value)) return err$2({ kind: "notObject" });
 	switch (value.kind) {
 		case "eventSeries": {
 			const eventSeriesId = parseEventSeriesId(value.eventSeriesId);
@@ -3973,7 +4403,7 @@ function parseEventPageSurfaceSubject(value) {
 		});
 	}
 }
-function isRecord$18(value) {
+function isRecord$20(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var init_event_page_surface_subject = __esmMin((() => {
@@ -4069,18 +4499,25 @@ var init_booking_instalments = __esmMin((() => {}));
 //#endregion
 //#region ../core/src/booking-date-time.ts
 function isValidTimeZone$1(timeZone) {
+	const cached = timeZoneValidityCache.get(timeZone);
+	if (cached !== void 0) return cached;
+	let isValid;
 	try {
 		new Intl.DateTimeFormat(DEFAULT_LOCALE, { timeZone }).format(/* @__PURE__ */ new Date());
-		return true;
+		isValid = true;
 	} catch {
-		return false;
+		isValid = false;
 	}
+	if (timeZoneValidityCache.size >= DATE_TIME_FORMATTER_CACHE_LIMIT) timeZoneValidityCache.clear();
+	timeZoneValidityCache.set(timeZone, isValid);
+	return isValid;
 }
 function getSafeTimeZone(timeZone) {
 	const normalized = typeof timeZone === "string" ? timeZone.trim() : "";
 	return normalized.length > 0 && isValidTimeZone$1(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone$1(normalized)) return null;
 	return normalized;
@@ -4093,10 +4530,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, {
@@ -4149,23 +4595,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,
@@ -4174,6 +4606,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);
@@ -4212,10 +4659,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",
@@ -4303,7 +4747,7 @@ function addLocalScheduleDays(date, days) {
 		day: utcDate.getUTCDate()
 	};
 }
-var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN;
+var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_DATE_PATTERN, DATE_TIME_FORMATTER_CACHE_LIMIT, dateTimeFormatterCache, timeZoneValidityCache;
 var init_booking_date_time = __esmMin((() => {
 	init_result();
 	DEFAULT_LOCALE = "en-US";
@@ -4316,6 +4760,9 @@ var init_booking_date_time = __esmMin((() => {
 		minute: "2-digit"
 	};
 	LOCAL_DATE_PATTERN = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/u;
+	DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+	dateTimeFormatterCache = /* @__PURE__ */ new Map();
+	timeZoneValidityCache = /* @__PURE__ */ new Map();
 })), init_dated_offering_settlement = __esmMin((() => {
 	init_result();
 }));
@@ -4367,6 +4814,26 @@ var init_participant_identity = __esmMin((() => {
 	init_assertNever();
 }));
 var init_public_url_validation = __esmMin((() => {}));
+var init_public_profile = __esmMin((() => {
+	init_public_url_validation();
+	init_result();
+}));
+var sectionKinds;
+var init_footer_composition = __esmMin((() => {
+	init_result();
+	sectionKinds = [
+		"brand",
+		"supporting-text",
+		"social-links",
+		"navigation",
+		"business-address",
+		"contact",
+		"opening-hours",
+		"legal-navigation",
+		"legal"
+	];
+	new Map(sectionKinds.map((kind, index) => [kind, index]));
+}));
 var init_number_input = __esmMin((() => {}));
 var init_field_errors = __esmMin((() => {})), init_form_submission_preview = __esmMin((() => {
 	init_string();
@@ -4401,7 +4868,7 @@ function sortStableJsonValue(value) {
 	if (typeof value === "object") {
 		const prototype = Object.getPrototypeOf(value);
 		if (prototype !== Object.prototype && prototype !== null) throw new TypeError("Stable JSON only supports plain objects");
-		return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, child]) => [key, sortStableJsonValue(child)]));
+		return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, child]) => [key, sortStableJsonValue(child)]));
 	}
 	throw new TypeError(`Stable JSON does not support ${typeof value}`);
 }
@@ -4464,6 +4931,8 @@ var init_src$3 = __esmMin((() => {
 	init_participants();
 	init_participant_identity();
 	init_public_url_validation();
+	init_public_profile();
+	init_footer_composition();
 	init_number_input();
 	init_field_errors();
 	init_form_submission_preview();
@@ -4589,7 +5058,8 @@ function validateRelativeStoragePath(value) {
 	if (value.startsWith("sites/")) return fail({ tag: "SITE_SCOPED_PATH" });
 	if (value.startsWith("/")) return fail({ tag: "LEADING_SLASH" });
 	if (value.includes("//")) return fail({ tag: "DOUBLE_SLASH" });
-	if (value.split("/").some((segment) => segment === "..")) return fail({ tag: "TRAVERSAL" });
+	if (value.includes("%")) return fail({ tag: "PERCENT_ENCODING" });
+	if (value.split("/").some((segment) => segment === "." || segment === "..")) return fail({ tag: "TRAVERSAL" });
 	return ok$1(value);
 }
 function brandRelativeStoragePath(value) {
@@ -7376,12 +7846,65 @@ function getSemanticIconComponent(name) {
 	return SEMANTIC_ICON_COMPONENTS[name] ?? null;
 }
 var ICON_PICKER_PRESETS;
-var init_presets = __esmMin((() => {
+var init_presets$1 = __esmMin((() => {
 	ICON_PICKER_PRESETS = ["cta", "feature"];
 }));
 //#endregion
+//#region ../blocks/src/system/icons/social.tsx
+init_presets$1();
+init_svg();
+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
-init_presets();
 function buildSearchText(parts) {
 	return parts.map((part) => part.trim()).filter(Boolean).join(" ");
 }
@@ -7410,7 +7933,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
@@ -8092,7 +8615,7 @@ function shouldReserveFeatureCardIconZone(cards) {
 }
 //#endregion
 //#region ../blocks/src/system/icons/index.ts
-init_presets();
+init_presets$1();
 init_svg();
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/feature-card-icon.tsx
@@ -9155,7 +9678,6 @@ const HeaderSectionNode$1 = ({ blockId, children, className, "data-preview-site-
 	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),
@@ -9170,7 +9692,6 @@ const HeaderSectionNode$1 = ({ blockId, children, className, "data-preview-site-
 			as: asProp,
 			style: styleProp,
 			background: backgroundProp ?? "background",
-			allowOverflow: allowOverflowProp,
 			"data-slot": dataSlotProp,
 			className: sectionClasses || void 0,
 			children
@@ -11769,7 +12290,7 @@ function resolveEventCta(event, buttonText) {
 	};
 }
 var COLUMN_CLASSES;
-var init_utils$5 = __esmMin((() => {
+var init_utils$6 = __esmMin((() => {
 	init_src$3();
 	init_src$1();
 	init_eventCapacity();
@@ -11805,7 +12326,7 @@ function DateTimeTile({ startsAt, endsAt, timeZone }) {
 	});
 }
 var init_DateTimeTile = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 }));
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-details/CoursePricingDisplay.tsx
@@ -12016,7 +12537,7 @@ var init_view$2 = __esmMin((() => {
 	init_src$3();
 	init_shared$5();
 	init_pricing();
-	init_utils$5();
+	init_utils$6();
 	init_DateTimeTile();
 	init_CoursePricingDisplay();
 }));
@@ -12749,95 +13270,6 @@ function CourseDetailsSSR({ courses, contentEntry, entrySubrouteContext, subject
 	});
 }
 //#endregion
-//#region ../theme-core/src/palette/utils/colorConversion.ts
-function hexToRgb$1(hex) {
-	const h = hex.replace(/^#/, "");
-	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
-	if (m.length !== 6) throw new Error("Bad hex");
-	const int = parseInt(m, 16);
-	return {
-		r: int >> 16 & 255,
-		g: int >> 8 & 255,
-		b: int & 255
-	};
-}
-function srgbToLinear(u) {
-	const x = u / 255;
-	return x <= .04045 ? x / 12.92 : Math.pow((x + .055) / 1.055, 2.4);
-}
-function linearToSrgb(x) {
-	const y = x <= .0031308 ? 12.92 * x : 1.055 * Math.pow(x, 1 / 2.4) - .055;
-	return clamp01$2(y) * 255;
-}
-var clamp01$2, mod, deg;
-var init_colorConversion = __esmMin((() => {
-	clamp01$2 = (x) => Math.max(0, Math.min(1, x));
-	mod = (a, n) => (a % n + n) % n;
-	deg = (x) => mod(x, 360);
-}));
-//#endregion
-//#region ../theme-core/src/palette/utils/contrast.ts
-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$1(hex1);
-	const { r: r2, g: g2, b: b2 } = hexToRgb$1(hex2);
-	const L1 = relativeLuminance(r1, g1, b1);
-	const L2 = relativeLuminance(r2, g2, b2);
-	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
-	return (hi + .05) / (lo + .05);
-}
-var init_contrast$1 = __esmMin((() => {
-	init_colorConversion();
-}));
-//#endregion
-//#region ../theme-core/src/palette/utils/textColor.ts
-/**
-* Pick the better of black/white text for a given background using actual
-* contrast ratios, not a simple luminance cutoff.
-*
-* @param background - Background color in hex or rgb/rgba format (e.g., '#FFFFFF' or 'rgb(255, 255, 255)')
-* @param minContrast - Preferred minimum contrast ratio for body-sized text
-* @returns '#000000' for light backgrounds, '#FFFFFF' for dark backgrounds
-*/
-function pickBlackOrWhiteTextColor(background, minContrast = 4.5) {
-	const { r, g, b } = parseColorToRgb(background);
-	const luminance = relativeLuminance(r, g, b);
-	const blackContrast = (luminance + .05) / .05;
-	const whiteContrast = 1.05 / (luminance + .05);
-	if (blackContrast >= minContrast && whiteContrast < minContrast) return "#000000";
-	if (whiteContrast >= minContrast && blackContrast < minContrast) return "#FFFFFF";
-	return blackContrast >= whiteContrast ? "#000000" : "#FFFFFF";
-}
-/**
-* Backwards-compatible alias for callers that want the best black/white text
-* color for a background.
-*/
-function getTextColorForBackground(background) {
-	return pickBlackOrWhiteTextColor(background);
-}
-function parseColorToRgb(input) {
-	const trimmed = input.trim();
-	if (trimmed.startsWith("#")) return hexToRgb$1(trimmed);
-	const rgbMatch = trimmed.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})(?:\s*,\s*(?:0|1|0?\.\d+))?\s*\)$/i);
-	if (rgbMatch?.[1] && rgbMatch[2] && rgbMatch[3]) return {
-		r: clamp255(Number(rgbMatch[1])),
-		g: clamp255(Number(rgbMatch[2])),
-		b: clamp255(Number(rgbMatch[3]))
-	};
-	throw new Error("Unsupported color format");
-}
-function clamp255(value) {
-	if (Number.isNaN(value)) return 0;
-	return Math.max(0, Math.min(255, value));
-}
-var init_textColor = __esmMin((() => {
-	init_colorConversion();
-	init_contrast$1();
-}));
-//#endregion
 //#region ../theme-core/src/utils/tokenOrColor.ts
 function isCssColorLiteral(value) {
 	const trimmed = value.trim();
@@ -13181,7 +13613,7 @@ var init_EventCard = __esmMin((() => {
 	init_media$2();
 	init_EventCardIcons();
 	init_eventCapacity();
-	init_utils$5();
+	init_utils$6();
 	init_buttons();
 	EventCard = ({ event, cardVariant = "default", buttonVariant = "primary", buttonText, showVenue = true, showMap = true, mapSlot, allowMap = true, showCapacity = true, showImage = true, showCategory = true, showSummary = true, orientation = "vertical" }) => {
 		const timeZone = event.timeZone ?? null;
@@ -13296,7 +13728,7 @@ var EventCompactRow;
 var init_EventCompactRow = __esmMin((() => {
 	init_buttons();
 	init_svg();
-	init_utils$5();
+	init_utils$6();
 	init_EventCardIcons();
 	EventCompactRow = ({ event, buttonVariant = "primary", buttonText }) => {
 		const timeZone = event.timeZone ?? null;
@@ -13402,7 +13834,7 @@ var init_EmptyState = __esmMin((() => {
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/events/shared/index.ts
 var init_shared$4 = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_EventCard();
 	init_EventCompactRow();
 	init_EmptyState();
@@ -15334,7 +15766,7 @@ init_src$3();
 init_buttons();
 init_cards();
 init_shared$4();
-init_utils$5();
+init_utils$6();
 init_shared$5();
 init_svg();
 function OfferingsPreviewNode(props) {
@@ -15746,7 +16178,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"
 	};
@@ -16060,6 +16492,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:
@@ -16134,8 +16594,10 @@ function createBackgroundOverlayNode(path, className = "background-overlay rb-ab
 		} }
 	});
 }
+var BACKGROUND_FRAME_BASE_CLASS;
 var init_backgroundLayer = __esmMin((() => {
 	init_builder$2();
+	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";
 }));
 //#endregion
 //#region ../blocks/src/system/node/fragments/styledSection.ts
@@ -16146,7 +16608,7 @@ var init_backgroundLayer = __esmMin((() => {
 * - 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.
@@ -16182,8 +16644,8 @@ var init_backgroundLayer = __esmMin((() => {
 * });
 */
 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,
@@ -16206,13 +16668,8 @@ function styledSection(config) {
 					fullWidthPath
 				}
 			}]
-		} },
-		allowOverflow: allowOverflow ? true : { $bind: {
-			from: `${bindFrom}.background`,
-			transforms: [{ id: "background.resolveAllowOverflow" }],
-			fallback: false
 		} }
-	}, [...renderedBackgroundNodes, ...childrenArray]);
+	}, [renderedBackgroundNode, ...childrenArray]);
 }
 var init_styledSection = __esmMin((() => {
 	init_builder$2();
@@ -16318,8 +16775,8 @@ var init_sectionContainer = __esmMin((() => {
 *     - 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, {
@@ -16342,7 +16799,7 @@ function styledContainer(config) {
 			}],
 			fallback: constrainWidth ? `${baseClassName} rb-container` : baseClassName
 		} }
-	}, [...backgroundNodes, ...childrenArray]);
+	}, [backgroundNode, ...childrenArray]);
 }
 var init_styledContainer = __esmMin((() => {
 	init_builder$2();
@@ -16425,12 +16882,6 @@ var init_footerNav = __esmMin((() => {
 	init_builder$2();
 }));
 var init_core = __esmMin((() => {}));
-//#endregion
-//#region ../theme-core/src/palette/utils/onColor.ts
-function onColorTokenName(backgroundToken) {
-	return `on${backgroundToken.split("-").filter((part) => part.length > 0).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("")}`;
-}
-var init_onColor = __esmMin((() => {}));
 function expandForegroundCandidates(candidates, backgroundToken) {
 	const seen = /* @__PURE__ */ new Set();
 	const expanded = [];
@@ -17279,9 +17730,6 @@ var init_vibrant_creative = __esmMin((() => {}));
 var init_generateCssVars = __esmMin((() => {
 	init_colorConversion();
 }));
-var init_neutralScale = __esmMin((() => {
-	init_colorConversion();
-}));
 var init_colorPlacement = __esmMin((() => {
 	init_colorConversion();
 	init_contrast$1();
@@ -17290,42 +17738,42 @@ var init_backgroundGeneration = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_analogous_harmony = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 	init_colorConversion();
 }));
 var init_complementary_contrast = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_earthy_natural = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_high_contrast_modern = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_jewel_dark = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_minimal_monochrome = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_neon_pop = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_pastel_light = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 	init_colorConversion();
 }));
 var init_soft_modern = __esmMin((() => {
 	init_colorConversion();
 }));
 var init_split_complementary = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_tetradic = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 }));
 var init_triadic_balance = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 })), init_allRecipes = __esmMin((() => {
 	init_analogous_harmony();
 	init_complementary_contrast();
@@ -17368,7 +17816,7 @@ var init_legibility = __esmMin((() => {
 }));
 //#endregion
 //#region ../theme-core/src/palette/utils/index.ts
-var init_utils$4 = __esmMin((() => {
+var init_utils$5 = __esmMin((() => {
 	init_colorConversion();
 	init_contrast$1();
 	init_colorPlacement();
@@ -17382,21 +17830,11 @@ var init_utils$4 = __esmMin((() => {
 var init_paletteAccess = __esmMin((() => {
 	init_colorConversion();
 }));
-var init_generateShades = __esmMin((() => {
-	init_colorConversion();
-}));
-var init_expandPalette = __esmMin((() => {
-	init_generateShades();
-	init_neutralScale();
-	init_colorConversion();
-	init_textColor();
-	init_onColor();
-}));
 var init_swatch = __esmMin((() => {}));
 var init_PaletteCard = __esmMin((() => {
 	init_generateCssVars();
 	init_neutralScale();
-	init_utils$4();
+	init_utils$5();
 	init_paletteAccess();
 	init_expandPalette();
 	init_swatch();
@@ -17628,7 +18066,7 @@ function assignDeep(target, ...sources) {
 	});
 	return target;
 }
-var init_utils$3 = __esmMin((() => {}));
+var init_utils$4 = __esmMin((() => {}));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/options.js
 function buildProcessOptions(opts, override) {
@@ -17646,13 +18084,13 @@ function buildProcessOptions(opts, override) {
 	}, override);
 }
 var init_options = __esmMin((() => {
-	init_utils$3();
+	init_utils$4();
 }));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+core@4.0.4/node_modules/@vibrant/core/dist/esm/builder.js
 var Builder;
 var init_builder$1 = __esmMin((() => {
-	init_utils$3();
+	init_utils$4();
 	init_esm$2();
 	Builder = class {
 		/**
@@ -18014,7 +18452,7 @@ var init_esm$3 = __esmMin((() => {
 var init_client$1 = __esmMin((() => {
 	init_esm$4();
 	init_esm$3();
-	init_utils$3();
+	init_utils$4();
 }));
 var init_host = __esmMin((() => {
 	init_esm$4();
@@ -18025,7 +18463,7 @@ var _Vibrant, Vibrant;
 var init_esm$2 = __esmMin((() => {
 	init_options();
 	init_builder$1();
-	init_utils$3();
+	init_utils$4();
 	init_pipeline$1();
 	init_client$1();
 	init_host();
@@ -20072,12 +20510,8 @@ var init_sitePalettePersistence = __esmMin((() => {
 	init_colors();
 	init_selection();
 }));
-var init_themePaletteCompatibility = __esmMin((() => {
-	init_themeColorTokens();
-	init_colors();
-}));
 var init_fromVibrant = __esmMin((() => {
-	init_utils$4();
+	init_utils$5();
 })), init_palette$1 = __esmMin((() => {
 	init_all();
 	init_classifyColor();
@@ -20086,7 +20520,7 @@ var init_fromVibrant = __esmMin((() => {
 	init_generateShades();
 	init_neutralScale();
 	init_types$7();
-	init_utils$4();
+	init_utils$5();
 	init_paletteAccess();
 	init_extractPalette();
 	init_colors();
@@ -20096,7 +20530,6 @@ var init_fromVibrant = __esmMin((() => {
 	init_resolveSelection();
 	init_selection();
 	init_sitePalettePersistence();
-	init_themePaletteCompatibility();
 	init_fromVibrant();
 	init_suggestRecipes();
 	init_allRecipes();
@@ -20672,6 +21105,249 @@ var init_testimonialQuotePresets = __esmMin((() => {
 	serifDisplayQuote = { style: "serif-display" };
 	accentGlyphQuote = { style: "accent-glyph" };
 }));
+//#endregion
+//#region ../theme-core/src/gradients/types.ts
+/**
+* Gradient configuration types and schemas
+*/
+var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
+var init_types$5 = __esmMin((() => {
+	init_themeColorTokens();
+	gradientStopSchema = z$1.object({
+		color: themeColorTokenSchema,
+		position: z$1.number().min(0).max(100)
+	});
+	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+	gradientConfigSchema = z$1.object({
+		type: z$1.enum([
+			"linear",
+			"radial",
+			"conic"
+		]).default("linear"),
+		angle: z$1.number().min(0).max(360).optional(),
+		shape: radialGradientShapeSchema.optional(),
+		position: z$1.string().optional(),
+		stops: z$1.array(gradientStopSchema).min(2)
+	});
+}));
+//#endregion
+//#region ../theme-core/src/gradients/presets.ts
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+var rawGradientPresets, GRADIENT_PRESETS, GRADIENT_PRESET_IDS, gradientPresetIdSet;
+var init_presets = __esmMin((() => {
+	rawGradientPresets = [
+		{
+			id: "primary-secondary",
+			name: "Primary to Secondary",
+			description: "Blend your primary and secondary brand colors",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "secondary-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-accent",
+			name: "Primary to Accent",
+			description: "Energetic gradient from primary to accent",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-accent",
+			name: "Secondary to Accent",
+			description: "Vibrant secondary to accent blend",
+			type: "linear",
+			angle: 135,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "accent-500",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-light-dark",
+			name: "Primary Light to Dark",
+			description: "Subtle primary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-500",
+				position: 0
+			}, {
+				color: "primary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-dark-light",
+			name: "Primary Dark to Light",
+			description: "Reverse primary fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-50",
+				position: 100
+			}]
+		},
+		{
+			id: "secondary-light-dark",
+			name: "Secondary Light to Dark",
+			description: "Subtle secondary color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "secondary-500",
+				position: 0
+			}, {
+				color: "secondary-900",
+				position: 100
+			}]
+		},
+		{
+			id: "accent-light-dark",
+			name: "Accent Light to Dark",
+			description: "Accent color depth fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "accent-500",
+				position: 0
+			}, {
+				color: "accent-900",
+				position: 100
+			}]
+		},
+		{
+			id: "background-surface",
+			name: "Background to Surface",
+			description: "Subtle depth using base colors",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "background",
+				position: 0
+			}, {
+				color: "surface",
+				position: 100
+			}]
+		},
+		{
+			id: "neutral-fade",
+			name: "Neutral Gradient",
+			description: "Elegant neutral color fade",
+			type: "linear",
+			angle: 180,
+			stops: [{
+				color: "neutral-900",
+				position: 0
+			}, {
+				color: "neutral-50",
+				position: 100
+			}]
+		},
+		{
+			id: "primary-glow",
+			name: "Primary glow",
+			description: "A soft top-centred glow using your primary palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "primary-900",
+				position: 0
+			}, {
+				color: "primary-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onPrimary900",
+				headingColor: "onPrimary900",
+				linkColor: "onPrimary900",
+				supportingColor: "onPrimary900"
+			}
+		},
+		{
+			id: "accent-glow",
+			name: "Accent glow",
+			description: "A soft top-centred glow using your accent palette",
+			type: "radial",
+			shape: "ellipse",
+			position: "top center",
+			stops: [{
+				color: "accent-900",
+				position: 0
+			}, {
+				color: "accent-950",
+				position: 100
+			}],
+			foreground: {
+				textColor: "onAccent900",
+				headingColor: "onAccent900",
+				linkColor: "onAccent900",
+				supportingColor: "onAccent900"
+			}
+		},
+		{
+			id: "primary-secondary-accent",
+			name: "Brand Trio",
+			description: "All three brand colors in harmony",
+			type: "linear",
+			angle: 135,
+			stops: [
+				{
+					color: "primary-500",
+					position: 0
+				},
+				{
+					color: "secondary-500",
+					position: 50
+				},
+				{
+					color: "accent-500",
+					position: 100
+				}
+			]
+		}
+	];
+	GRADIENT_PRESETS = rawGradientPresets.map((preset) => ({
+		...preset,
+		id: preset.id,
+		stops: preset.stops
+	}));
+	GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+	gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+	Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+}));
+var init_utils$3 = __esmMin((() => {}));
+//#endregion
+//#region ../theme-core/src/gradients/index.ts
+var init_gradients = __esmMin((() => {
+	init_types$5();
+	init_presets();
+	init_utils$3();
+}));
 var init_customizableSurfaces = __esmMin((() => {
 	init_types$12();
 })), logoTextConfidenceValues, logoAssetShapeValues, logoKindValues, logoDensityValues, logoContainsTextSchema, logoAnalysisSourceSchema, brandDisplayModeValues, logoAccommodationPatternValues, logoSizePolicyValues;
@@ -20782,7 +21458,7 @@ function asHeaderStyleId(value) {
 * 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: {
@@ -21404,6 +22080,17 @@ var init_headerLooks = __esmMin((() => {
 			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",
@@ -21497,6 +22184,7 @@ var init_headerLooks = __esmMin((() => {
 			"brand-bar",
 			"brand-underline",
 			"brand-pill",
+			"brand-capsule",
 			"serif-line",
 			"flat-tabs"
 		])],
@@ -21531,6 +22219,11 @@ var init_headerLooks = __esmMin((() => {
 		"brand-pill",
 		"brand-bar",
 		"minimal"
+	]), headerStyleRepairChain([
+		"brand-capsule",
+		"brand-pill",
+		"brand-bar",
+		"minimal"
 	]), headerStyleRepairChain([
 		"pill-nav",
 		"soft-bar",
@@ -22723,7 +23416,7 @@ var init_media = __esmMin((() => {
 		transform: transformSchema.optional()
 	});
 })), inputSystemSchema;
-var init_types$5 = __esmMin((() => {
+var init_types$4 = __esmMin((() => {
 	init_themeColorTokens();
 	inputSystemSchema = z$1.object({
 		base: z$1.object({
@@ -22818,31 +23511,6 @@ var init_types$5 = __esmMin((() => {
 	});
 }));
 //#endregion
-//#region ../theme-core/src/gradients/types.ts
-/**
-* Gradient configuration types and schemas
-*/
-var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
-var init_types$4 = __esmMin((() => {
-	init_themeColorTokens();
-	gradientStopSchema = z$1.object({
-		color: themeColorTokenSchema,
-		position: z$1.number().min(0).max(100)
-	});
-	radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
-	gradientConfigSchema = z$1.object({
-		type: z$1.enum([
-			"linear",
-			"radial",
-			"conic"
-		]).default("linear"),
-		angle: z$1.number().min(0).max(360).optional(),
-		shape: radialGradientShapeSchema.optional(),
-		position: z$1.string().optional(),
-		stops: z$1.array(gradientStopSchema).min(2)
-	});
-}));
-//#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
 /**
 * Shared Base Schemas for Interactive Elements
@@ -23162,14 +23830,31 @@ var init_rawStyleFields = __esmMin((() => {
 	[...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
 	pageDesignEditorBackgroundOverrideOwner = "page-design-editor";
 	siteChromeBackgroundOverrideOwner = "site-chrome-editor";
-})), axesSchema, colourHexString, paletteColorSchema, paletteMetaSchema, paletteSchema, typographyStyleSchema, bodyTypographyStyleSchema, headingSizeSchema, headingTypographyOverridesSchema, headingTypographyStyleSchema, proseLinkUnderlineStyleSchema, proseLinkUnderlineThicknessSchema, proseLinkUnderlineOffsetSchema, proseLinkStyleSchema, semanticSpacingSchema, boxRoundedSchema, boxBackgroundOverlaySchema, boxBackgroundSchema, noHeadingDecorationSchema, visibleHeadingDecorationSchema, headingDecorationSchema, headingDecorationOverrideSchema, accordionIconTreatmentSchema, sectionStylesOverrideSchema, containerStylesOverrideSchema, cardBorderOverrideSchema, cardStylesOverrideSchema, blockStyleOverridesSchema, blockThemeOverrideSchema, typographyScaleSchema, eyebrowTypographyStyleSchema, typographySchema, spaceSchema, corners, shadow, border, motion, inputStyle$1, headerVariant, headerPositioning, headerNavStyle, navFontWeight, headerMaxWidth, headerContainerSchema, headerBorderSchema, logoStyleSchema, headerLogoTextSchema, navEffectsSchema, dropdownStyleSchema, headerCtaGapSchema, headerCtaTreatmentSchema, navContainerSchema, headerBackgroundSchema, headerSchema, footerVariant, footerMaxWidth, footerMode, footerNavLayoutMode, footerNavLayoutAlign, footerSpacing, footerLogoPlacement, footerLogoSize, footerLogoMaxHeight, footerBottomTextLinkStyleSchema, footerBottomBarSchema, footerNavLayoutSchema, footerLogoSchema, footerSchema, containerPaddingPresetSchema, layoutSchema, heroTypographySizeSchema, heroTypographyLineHeightSchema, heroResponsiveTypographySchema, heroTypographySchema, heroSchema, bodyTextIntroTypographySizeSchema, bodyTextSchema, gradientsSchema, testimonialQuoteTreatmentSchema, themeSchema;
+}));
+//#endregion
+//#region ../theme-core/src/schema.ts
+/**
+* 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;
+}
+var axesSchema, colourHexString, paletteColorSchema, paletteMetaSchema, paletteSchema, typographyStyleSchema, bodyTypographyStyleSchema, headingSizeSchema, headingTypographyOverridesSchema, headingTypographyStyleSchema, proseLinkUnderlineStyleSchema, proseLinkUnderlineThicknessSchema, proseLinkUnderlineOffsetSchema, proseLinkStyleSchema, semanticSpacingSchema, boxRoundedSchema, boxBackgroundOverlaySchema, boxBackgroundSchema, noHeadingDecorationSchema, visibleHeadingDecorationSchema, headingDecorationSchema, headingDecorationOverrideSchema, accordionIconTreatmentSchema, sectionStylesOverrideSchema, containerStylesOverrideSchema, cardBorderOverrideSchema, cardStylesOverrideSchema, blockStyleOverridesSchema, blockThemeOverrideSchema, typographyScaleSchema, eyebrowTypographyStyleSchema, typographySchema, spaceSchema, corners, shadow, border, motion, inputStyle$1, headerVariant, headerPositioning, headerNavStyle, navFontWeight, headerMaxWidth, headerBarFrame, headerContainerSchema, headerBorderSchema, logoStyleSchema, headerLogoTextSchema, navEffectsSchema, dropdownStyleSchema, headerCtaGapSchema, headerCtaTreatmentSchema, navContainerSchema, headerBackgroundSchema, headerSchema, footerVariant, footerMaxWidth, footerMode, footerNavLayoutMode, footerNavLayoutAlign, footerSpacing, footerLogoPlacement, footerLogoSize, footerLogoMaxHeight, footerBottomTextLinkStyleSchema, footerBottomBarSchema, footerNavLayoutSchema, footerLogoSchema, footerSchema, containerPaddingPresetSchema, layoutSchema, heroTypographySizeSchema, heroTypographyLineHeightSchema, heroResponsiveTypographySchema, heroTypographySchema, heroSchema, bodyTextIntroTypographySizeSchema, bodyTextSchema, gradientsSchema, testimonialQuoteTreatmentSchema, themeSchema;
 var init_schema$1 = __esmMin((() => {
 	init_media();
 	init_buttons();
 	init_cards();
 	init_types$13();
-	init_types$5();
 	init_types$4();
+	init_types$5();
 	init_types$3();
 	init_validation$2();
 	init_atRuleValidation();
@@ -23595,6 +24280,7 @@ var init_schema$1 = __esmMin((() => {
 		"bold"
 	]);
 	headerMaxWidth = z$1.enum(["container", "full"]);
+	headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
 	headerContainerSchema = z$1.object({
 		rounded: z$1.enum([
 			"none",
@@ -23735,6 +24421,7 @@ var init_schema$1 = __esmMin((() => {
 		positioning: headerPositioning,
 		shrinkOnScroll: z$1.boolean(),
 		maxWidth: headerMaxWidth,
+		barFrame: headerBarFrame.optional(),
 		logoOverride: mediaSchema.nullable().optional(),
 		background: headerBackgroundSchema.default({
 			type: "color",
@@ -23744,6 +24431,7 @@ var init_schema$1 = __esmMin((() => {
 		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(),
@@ -23759,7 +24447,7 @@ var init_schema$1 = __esmMin((() => {
 		ctaTreatment: headerCtaTreatmentSchema.optional(),
 		ctaVariant: z$1.string().min(1).optional(),
 		dropdownStyle: dropdownStyleSchema
-	});
+	}).transform(normaliseHeaderNavFontRole);
 	footerVariant = z$1.enum([
 		"simple",
 		"columns",
@@ -24171,6 +24859,21 @@ var init_designState = __esmMin((() => {
 		styleAuthorities: z$1.array(blockRuntimeStyleAuthoritySchema)
 	}).strict();
 }));
+//#endregion
+//#region ../theme-core/src/site-styles/runtimeCompiler.ts
+function defineSectionForegroundRuntimeTokens(input) {
+	return {
+		textColor: requireThemeColorToken(input.textColor),
+		headingColor: requireThemeColorToken(input.headingColor),
+		linkColor: requireThemeColorToken(input.linkColor),
+		supportingColor: requireThemeColorToken(input.supportingColor)
+	};
+}
+function requireThemeColorToken(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) throw new Error(`Invalid section foreground Theme color token: ${String(value)}`);
+	return token;
+}
 function defineDesignRuntimeRules(rules) {
 	return rules;
 }
@@ -24196,6 +24899,8 @@ var init_runtimeCompiler = __esmMin((() => {
 	init_types$12();
 	init_accessibleSurfaces();
 	init_sectionTransitions();
+	init_tokens();
+	init_gradients();
 	defaultDesignRuntimeRules = defineDesignRuntimeRules({
 		sectionSurfaces: {
 			base: {},
@@ -24591,13 +25296,14 @@ function inferHeaderCurationFromLegacyLooks(lookIds, recipes) {
 		recommendedHeaderStyleChoicesByLayout: stylesByLayout
 	};
 }
-var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles;
+var SOFT_EARTH_SITE_STYLE_ID_VALUE, SOFT_EARTH_SITE_STYLE_ID, curatedSiteStyleIdValues, quietBudget, accentLedQuietBudget, balancedBudget, expressiveBudget, kirtanOrnateDesignRuntimeRules, primaryGlowGradientPresetId, fulcrumDesignRuntimeRules, expressiveUnderlineInputs, ornateDarkInputs, generatedContentFrameKinds, curatedSiteStyles;
 var init_curatedSiteStyles = __esmMin((() => {
 	init_personalities();
 	init_curated();
 	init_siteStyleDefaults$1();
 	init_siteStyleDefaults();
 	init_testimonialQuotePresets();
+	init_gradients();
 	init_headerLooks();
 	init_footerLooks();
 	init_curatedChoices();
@@ -24665,24 +25371,24 @@ var init_curatedSiteStyles = __esmMin((() => {
 					type: "color",
 					color: "muted"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"brand-depth-band": {
 				background: {
 					type: "color",
 					color: "primary-800"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
 			},
 			"hero-image": {
 				background: {
@@ -24690,12 +25396,32 @@ var init_curatedSiteStyles = __esmMin((() => {
 					opacity: 1,
 					position: "center center"
 				},
-				foreground: {
+				foreground: defineSectionForegroundRuntimeTokens({
 					textColor: "text",
 					headingColor: "primary",
 					linkColor: "primary",
 					supportingColor: "text"
-				}
+				})
+			}
+		}
+	});
+	primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+	if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+	fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+		...defaultDesignRuntimeRules,
+		sectionSurfaces: {
+			...defaultDesignRuntimeRules.sectionSurfaces,
+			"accent-band": {
+				background: {
+					type: "gradient",
+					gradientPresetId: primaryGlowGradientPresetId
+				},
+				foreground: defineSectionForegroundRuntimeTokens({
+					textColor: "primaryForeground",
+					headingColor: "primaryForeground",
+					linkColor: "primaryForeground",
+					supportingColor: "primaryForeground"
+				})
 			}
 		}
 	});
@@ -24808,6 +25534,7 @@ var init_curatedSiteStyles = __esmMin((() => {
 			],
 			buttonPersonalityChoices: [
 				buttonChoice("soft-pill"),
+				buttonChoice("two-tone-pill"),
 				buttonChoice("pebble"),
 				buttonChoice("editorial-link"),
 				buttonChoice("brushed-wash")
@@ -25871,6 +26598,8 @@ var init_curatedSiteStyles = __esmMin((() => {
 			},
 			compositionBudget: quietBudget,
 			typography: fulcrumTypography,
+			designRuntimeRules: fulcrumDesignRuntimeRules,
+			recommendedAppearancePresetIds: ["cta-accent-band"],
 			themeOverrides: {
 				shadow: { colorToken: "primary" },
 				accordions: {
@@ -25987,6 +26716,7 @@ var init_curatedSiteStyles = __esmMin((() => {
 			],
 			buttonPersonalityChoices: [
 				buttonChoice("quiet-arrow"),
+				buttonChoice("two-tone-pill"),
 				buttonChoice("flat-ink"),
 				buttonChoice("editorial-link")
 			],
@@ -27433,7 +28163,7 @@ var init_validation_constants = __esmMin((() => {
 		"media.fromUrl",
 		"background.resolveStyle",
 		"background.resolveColorsStyle",
-		"background.resolveAllowOverflow",
+		"background.resolveFrameClassName",
 		"background.resolveImageStyle",
 		"background.resolveImageClassName",
 		"background.resolveOverlayStyle",
@@ -27569,12 +28299,12 @@ function createSiteOptionSelectField(input) {
 		}
 	}));
 }
-var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens, colorTokens, spacingTokens, radiusTokens, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum;
+var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens, colorTokens, spacingTokens, radiusTokens, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum, blockContentSourceKinds, blockContentSourceSchema;
 var init_schema = __esmMin((() => {
 	init_src$2();
 	init_node();
 	init_repeaterGrid();
-	init_presets();
+	init_presets$1();
 	visibilityLevels = [
 		"admin",
 		"designer",
@@ -28100,6 +28830,21 @@ var init_schema = __esmMin((() => {
 		"layout",
 		"interactive"
 	]);
+	blockContentSourceKinds = [
+		"inline",
+		"entries",
+		"mixed"
+	];
+	blockContentSourceSchema = z$1.object({
+		kind: z$1.enum(blockContentSourceKinds),
+		contentType: z$1.string().min(1).optional()
+	}).superRefine((value, ctx) => {
+		if (value.kind === "inline" && value.contentType) ctx.addIssue({
+			code: z$1.ZodIssueCode.custom,
+			path: ["contentType"],
+			message: "contentType is not allowed when contentSource.kind is \"inline\""
+		});
+	});
 	z$1.object({
 		name: z$1.string().min(1),
 		version: z$1.string().min(1),
@@ -28130,6 +28875,12 @@ var init_schema = __esmMin((() => {
 		}).optional()).optional(),
 		category: blockCategoryEnum.optional(),
 		contentTypes: z$1.array(z$1.string()).optional(),
+		/**
+		* Explicit content-source classification (inline / entries / mixed). Optional at the
+		* schema level for backward compatibility with SDK-defined custom blocks, but every
+		* registered SYSTEM block must declare it (enforced by a registry-wide test).
+		*/
+		contentSource: blockContentSourceSchema.optional(),
 		tags: z$1.array(z$1.string()).optional(),
 		icon: z$1.string().optional()
 	});
@@ -28525,9 +29276,15 @@ var init_heroCopy = __esmMin((() => {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -28536,11 +29293,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 var init_ctas = __esmMin((() => {
@@ -28602,6 +29356,7 @@ var init_heroCtaRow = __esmMin((() => {
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -28680,7 +29435,7 @@ var init_ctaCopy = __esmMin((() => {
 			eyebrowPath: "content.eyebrow",
 			titlePath: "content.title",
 			className: "cta-heading"
-		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+		}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 	});
 }));
 //#endregion
@@ -29320,7 +30075,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"
 						}
 					}]
 				},
@@ -30851,6 +31606,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,
@@ -31896,6 +32652,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -31987,6 +32744,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -32262,6 +33020,7 @@ var init_course_registration_interactive = __esmMin((() => {
 init_builder$2();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared$5();
 init_defineBlock();
@@ -32274,6 +33033,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -32387,15 +33147,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"
@@ -32408,9 +33162,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -32682,6 +33435,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -33066,6 +33820,7 @@ var init_event_registration_interactive = __esmMin((() => {
 init_builder$2();
 init_styledSection();
 init_fragments$1();
+init_button();
 init_api_bindings();
 init_shared$3();
 init_shop_shared();
@@ -33080,6 +33835,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -33186,15 +33942,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"
@@ -33207,9 +33957,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -33462,7 +34211,7 @@ const copyLayout = fragmentLayoutNode(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(formEmbedFragment.layout)
 });
 function createFormLayout(variant) {
@@ -33527,6 +34276,7 @@ const formBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"form",
 			"contact",
@@ -34685,6 +35435,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -35190,6 +35941,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -35649,6 +36401,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -35787,6 +36540,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -35964,6 +36718,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -36236,6 +36991,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -36947,7 +37703,7 @@ var init_EventListing_view = __esmMin((() => {
 var AgendaEventCard;
 var init_AgendaEventCard = __esmMin((() => {
 	init_eventCapacity();
-	init_utils$5();
+	init_utils$6();
 	AgendaEventCard = ({ event, showCapacity, onClick }) => {
 		const eventLinkProps = resolveEventLinkProps(event);
 		const categoryColor = event.eventCategory?.color || "rgb(var(--tb-accent))";
@@ -37036,7 +37792,7 @@ function formatAgendaDayHeader(date) {
 var FULL_DAY_NAMES$1, WeekAgendaView;
 var init_WeekAgendaView = __esmMin((() => {
 	init_AgendaEventCard();
-	init_utils$5();
+	init_utils$6();
 	FULL_DAY_NAMES$1 = [
 		"Sunday",
 		"Monday",
@@ -37103,7 +37859,7 @@ var init_WeekBoardView = __esmMin((() => {
 	init_clsx();
 	init_buttons();
 	init_eventCapacity();
-	init_utils$5();
+	init_utils$6();
 	SHORT_DAY_NAMES = [
 		"Sun",
 		"Mon",
@@ -37310,7 +38066,7 @@ var DEFAULT_EVENT_CELL_COLOR, FULL_DAY_NAMES;
 var init_timetableModel = __esmMin((() => {
 	init_src$1();
 	init_eventCapacity();
-	init_utils$5();
+	init_utils$6();
 	DEFAULT_EVENT_CELL_COLOR = "rgb(var(--tb-accent))";
 	FULL_DAY_NAMES = [
 		"Sunday",
@@ -37329,7 +38085,7 @@ init_EventListing_view();
 init_EventCalendar_interactive();
 init_WeekAgendaView();
 init_WeekBoardView();
-init_utils$5();
+init_utils$6();
 init_timetableModel();
 init_buttons();
 function assertNeverDisplayMode(value) {
@@ -103888,7 +104644,7 @@ var init_EventRegistrationWizard = __esmMin((() => {
 	init_EventRegistrationSummaryBar();
 	init_EventSelectionStep();
 	init_useEventRegistrationWizard();
-	init_utils$5();
+	init_utils$6();
 	init_themePortalRoot();
 	init_ModalShell();
 	init_MagicLinkForm();
@@ -111684,7 +112440,6 @@ const HeaderSectionNode = ({ blockId, blockKind, blockContent, fragmentRegistry,
 	const asProp = restProps.as;
 	const styleProp = restProps.style;
 	const backgroundProp = typeof restProps.background === "string" ? restProps.background : void 0;
-	const allowOverflowProp = typeof restProps.allowOverflow === "boolean" ? restProps.allowOverflow : void 0;
 	const dataSlotProp = typeof restProps["data-slot"] === "string" ? restProps["data-slot"] : void 0;
 	return /* @__PURE__ */ jsx("nav", {
 		ref: (el) => {
@@ -111706,7 +112461,6 @@ const HeaderSectionNode = ({ blockId, blockKind, blockContent, fragmentRegistry,
 			as: asProp,
 			style: styleProp,
 			background: backgroundProp ?? "background",
-			allowOverflow: allowOverflowProp,
 			"data-slot": dataSlotProp,
 			className: sectionClasses || void 0,
 			children
@@ -112838,7 +113592,7 @@ function useCalendarEvents({ siteId: _siteId, initialEvents = [], view = "month"
 }
 var CALENDAR_FETCH_LIMIT;
 var init_useCalendarEvents = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_api();
 	init_listOptions();
 	init_useCalendarEvents_state();
@@ -112897,7 +113651,7 @@ var init_EventModalContext = __esmMin((() => {
 //#region ../blocks/src/system/runtime/nodes/events/shared/CalendarDayCell.tsx
 var CalendarDayCell;
 var init_CalendarDayCell = __esmMin((() => {
-	init_utils$5();
+	init_utils$6();
 	init_EventModalContext();
 	CalendarDayCell = ({ date, events, isCurrentMonth }) => {
 		const { openEventModal, openDayModal } = useEventModal();
@@ -113077,7 +113831,7 @@ function DayEventsModal({ date, events, showCapacity, onClose, onSelectEvent, po
 }
 var init_DayEventsModal = __esmMin((() => {
 	init_AgendaEventCard();
-	init_utils$5();
+	init_utils$6();
 	init_ModalShell();
 }));
 //#endregion
@@ -113211,7 +113965,7 @@ var init_EventCombined_client = __esmMin((() => {
 	init_WeekAgendaView();
 	init_EventModalContext();
 	init_EventModals();
-	init_utils$5();
+	init_utils$6();
 	init_buttons();
 	init_listOptions();
 	init_calendarViewOptions();
@@ -113697,7 +114451,7 @@ var init_EventCalendar_client = __esmMin((() => {
 	init_useEventFilters();
 	init_CalendarDayCell();
 	init_EventFilters();
-	init_utils$5();
+	init_utils$6();
 	init_EventModalContext();
 	init_EventModals();
 	init_WeekAgendaView();
@@ -114820,7 +115574,7 @@ init_surfaces();
 init_curatedSiteStyles();
 //#endregion
 //#region ../theme-core/src/inputs/generateInputCss.ts
-init_types$5();
+init_types$4();
 init_constants$2();
 init_colorStyles();
 //#endregion
@@ -115718,6 +116472,7 @@ var init_event_details = __esmMin((() => {
 		titleSource: "heading",
 		description: "Date/time, venue, map, and other dates for an event",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"venue",