@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/server/server.mjs

@@ -44,6 +44,12 @@ function parsePublicProductCategorySelector(value) {
 }
 //#endregion
 //#region ../api/src/apiEndpointTypes.ts
+function allowedDemoMutationPolicy() {
+	return {
+		classification: "allowed",
+		publicMessage: ""
+	};
+}
 function blockedDemoMutationPolicy(classification, publicMessage) {
 	if (publicMessage.trim() === "") throw new Error(`Demo mutation policy ${classification} requires publicMessage.`);
 	return {
@@ -71,6 +77,7 @@ const TAG_TEMPLATES = {
 	siteRouteOutcomes: "riverbank:site:{siteId}:route-outcomes",
 	routeById: "riverbank:route:{routeId}",
 	pageById: "riverbank:page:{pageId}",
+	pageSurfaceById: "riverbank:page-surface:{pageSurfaceId}",
 	workflowRunById: "riverbank:workflow-run:{runId}",
 	siteForms: "riverbank:site:{siteId}:forms",
 	formById: "riverbank:form:{formId}",
@@ -96,6 +103,7 @@ const TAG_TEMPLATES = {
 const DEMO_MUTATION_BLOCKED_HIDDEN = blockedDemoMutationPolicy("blocked-hidden", "This action is not available in demo sites.");
 const DEMO_MUTATION_BLOCKED_DISABLED = blockedDemoMutationPolicy("blocked-disabled", "This setting is disabled in demo sites.");
 const DEMO_MUTATION_INTERNAL_ONLY = blockedDemoMutationPolicy("internal-only", "This internal operation is not available in demo sites.");
+const DEMO_MUTATION_ALLOWED = allowedDemoMutationPolicy();
 const API_ENDPOINTS$1 = {
 	aiContentUpdateChat: {
 		path: "/ai/content-update-chat",
@@ -2234,6 +2242,49 @@ const API_ENDPOINTS$1 = {
 		auth: "user",
 		responseKind: "json"
 	},
+	updatePageSurfaceDraftContent: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/content",
+		method: "PUT",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		],
+		tags: [TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById],
+		auth: "user",
+		responseKind: "json"
+	},
+	discardPageSurfaceDraftContent: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/content/draft",
+		method: "DELETE",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		],
+		tags: [TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById],
+		auth: "user",
+		responseKind: "json"
+	},
+	updatePageSurfaceRouteMetadata: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/metadata",
+		method: "PATCH",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		],
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.siteRoutableContent,
+			TAG_TEMPLATES.pageSurfaceById
+		],
+		auth: "user",
+		responseKind: "json"
+	},
 	runSdkWorkflow: {
 		path: "/sites/{siteId}/content/{type}/{entryId}/workflows/{workflowId}/run",
 		method: "POST",
@@ -2614,6 +2665,50 @@ const API_ENDPOINTS$1 = {
 		errors: [],
 		responseKind: "json"
 	},
+	getFooterComposition: {
+		path: "/sites/{siteId}/settings/footer-composition",
+		method: "GET",
+		revalidate: 120,
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+		auth: "user",
+		errors: ["resource:not_found", "server:internal_error"],
+		responseKind: "json"
+	},
+	updateFooterComposition: {
+		path: "/sites/{siteId}/settings/footer-composition",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+		auth: "user",
+		demoMutation: DEMO_MUTATION_ALLOWED,
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"server:internal_error"
+		],
+		responseKind: "json"
+	},
+	getPublicProfile: {
+		path: "/sites/{siteId}/settings/public-profile",
+		method: "GET",
+		revalidate: 120,
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+		auth: "user",
+		errors: ["resource:not_found", "server:internal_error"],
+		responseKind: "json"
+	},
+	updatePublicProfile: {
+		path: "/sites/{siteId}/settings/public-profile",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+		auth: "user",
+		demoMutation: DEMO_MUTATION_ALLOWED,
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"server:internal_error"
+		],
+		responseKind: "json"
+	},
 	updateSiteLayoutSettings: {
 		path: "/sites/{siteId}/settings/layout",
 		method: "POST",
@@ -3686,6 +3781,76 @@ const API_ENDPOINTS$1 = {
 		responseKind: "json",
 		errors: ["resource:not_found"]
 	},
+	listPageSurfaceContentSlots: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots",
+		method: "GET",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.pageSurfaceById,
+			"surface-slots",
+			"blocks"
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	createPageSurfaceSlotBlock: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks",
+		method: "POST",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.pageSurfaceById,
+			"surface-slot-{slotKey}",
+			"blocks"
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	reorderPageSurfaceSlotBlocks: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks/reorder",
+		method: "POST",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.pageSurfaceById,
+			"surface-slot-{slotKey}",
+			"blocks"
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	deletePageSurfaceSlotBlock: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks/{blockId}",
+		method: "DELETE",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.pageSurfaceById,
+			"surface-slot-{slotKey}",
+			"blocks"
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	createBlock: {
 		path: "/sites/{siteId}/pages/{pageId}/blocks",
 		method: "POST",
@@ -6169,6 +6334,41 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
+	sdkCatalogTheme: {
+		path: "/sdk/{siteId}/catalog/theme",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCatalogBlocks: {
+		path: "/sdk/{siteId}/catalog/blocks",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCatalogContentTypes: {
+		path: "/sdk/{siteId}/catalog/content-types",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkCapabilities: {
+		path: "/sdk/{siteId}/capabilities",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkListDemoContent: {
+		path: "/sdk/{siteId}/demo-content",
+		method: "GET",
+		errors: ["server:internal_error"],
+		auth: "service",
+		responseKind: "json"
+	},
 	sdkPullPages: {
 		path: "/sdk/{siteId}/pull/pages",
 		method: "GET",
@@ -6298,6 +6498,19 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
+	sdkPatchPageBlock: {
+		path: "/sdk/{siteId}/pages/{identifier}/blocks/{blockIdentifier}",
+		method: "PATCH",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"billing:plan_limit_exceeded",
+			"server:internal_error"
+		],
+		auth: "service",
+		responseKind: "json"
+	},
 	sdkReorderPageBlocks: {
 		path: "/sdk/{siteId}/pages/{identifier}/blocks/reorder",
 		method: "POST",
@@ -7190,17 +7403,17 @@ function buildEndpointURL(baseURL, endpoint) {
 function isFormDataBody(value) {
 	return typeof FormData !== "undefined" && value instanceof FormData;
 }
-function isUnknownArray(value) {
+function isUnknownArray$1(value) {
 	return Array.isArray(value);
 }
 function appendQueryParam(queryParams, key, value) {
 	if (value === void 0 || value === null) return;
-	if (isUnknownArray(value)) {
+	if (isUnknownArray$1(value)) {
 		const stack = [...value].reverse();
 		while (stack.length > 0) {
 			const item = stack.pop();
 			if (item === void 0 || item === null) continue;
-			if (isUnknownArray(item)) {
+			if (isUnknownArray$1(item)) {
 				stack.push(...[...item].reverse());
 				continue;
 			}
@@ -7573,7 +7786,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.107.0";
+const SDK_VERSION = "0.109.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;
@@ -10174,19 +10387,29 @@ function isRecord$12(value) {
 //#region ../core/src/booking-date-time.ts
 const DEFAULT_LOCALE = "en-US";
 const FALLBACK_TIMEZONE = "UTC";
+const DATE_TIME_FORMATTER_CACHE_LIMIT = 100;
+const dateTimeFormatterCache = /* @__PURE__ */ new Map();
+const timeZoneValidityCache = /* @__PURE__ */ new Map();
 function isValidTimeZone(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(normalized) ? normalized : FALLBACK_TIMEZONE;
 }
 function parseStrictBookingTimeZone(timeZone) {
+	if (typeof timeZone !== "string") return null;
 	const normalized = timeZone.trim();
 	if (normalized.length === 0 || !isValidTimeZone(normalized)) return null;
 	return normalized;
@@ -10199,10 +10422,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, {
@@ -10245,23 +10477,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,
@@ -10270,6 +10488,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 toScheduledBookingDateTime(input) {
 	const result = parseScheduledBookingDateTime(input);
@@ -13399,6 +13632,111 @@ const mediaSchema$1 = z.object({
 	transform: transformSchema$1.optional()
 });
 //#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+/**
+* Exhaustive live policy for every registered effect id.
+*
+* The resolver consumes the transition payload directly, so adding an effect
+* cannot update classification without also defining its runtime behavior.
+*/
+const BUTTON_EFFECT_POLICIES = {
+	"darken-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "darker"
+		}
+	},
+	"lighten-background": {
+		classification: "colour-transition",
+		transition: {
+			kind: "adjust-shade",
+			direction: "lighter"
+		}
+	},
+	"background-on-hover": {
+		classification: "colour-transition",
+		transition: { kind: "replace-background" }
+	},
+	"background-on-hover-alpha": {
+		classification: "unsupported-colour",
+		reason: "alpha_requires_surface"
+	},
+	"fade-background": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"opacity-reduce": {
+		classification: "unsupported-colour",
+		reason: "changes_element_opacity"
+	},
+	"gradient-text": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"text-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_foreground"
+	},
+	"border-color-change": {
+		classification: "unsupported-colour",
+		reason: "changes_border"
+	},
+	"aurora-glow": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"cosmic-stardust": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"animated-gradient-border-fill": {
+		classification: "unsupported-background-overlay",
+		reason: "unresolved_background_overlay"
+	},
+	"nav-underline": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-base": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-hover": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"nav-frosted-active": {
+		classification: "not-button",
+		reason: "not_button_effect"
+	},
+	"animated-gradient": { classification: "non-colour" },
+	"border-glow": { classification: "non-colour" },
+	"drop-shadow": { classification: "non-colour" },
+	"inner-shadow": { classification: "non-colour" },
+	"neumorphic-shadow": { classification: "non-colour" },
+	"outer-glow": { classification: "non-colour" },
+	"retro-3d-shadow": { classification: "non-colour" },
+	"scale-up": { classification: "non-colour" },
+	"scale-down": { classification: "non-colour" },
+	lift: { classification: "non-colour" },
+	"press-down": { classification: "non-colour" },
+	pop: { classification: "non-colour" },
+	"border-bottom-grow": { classification: "non-colour" },
+	"sketchy-border": { classification: "non-colour" },
+	"pulse-animation": { classification: "non-colour" }
+};
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+function classifyButtonEffectId(effectId) {
+	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
+}
+//#endregion
 //#region ../theme-core/src/buttons/types.ts
 /**
 * Standard semantic variant roles a theme exposes.
@@ -13415,6 +13753,20 @@ const VARIANT_ROLES = [
 	"tertiary",
 	"accent"
 ];
+function parseOpaqueButtonColourToken(value) {
+	const token = parseThemeColorToken(value);
+	if (token === null) return null;
+	const parts = parseColorTokenParts(token);
+	return parts.kind === "token" && parts.opacityPercent === null ? token : null;
+}
+function unsafeAsOpaqueButtonColourToken(value) {
+	return value;
+}
+const opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
+	const token = parseOpaqueButtonColourToken(value);
+	if (token === null) throw new Error("Invariant: opaque button token passed its schema");
+	return token;
+});
 const cornerStyleSchema = z$1.enum([
 	"square",
 	"rounded",
@@ -13516,7 +13868,7 @@ const buttonSizesSchema = z$1.object({
 	lg,
 	xl: xl ?? lg
 }));
-const buttonGlobalSettingsSchema = z$1.object({
+const canonicalButtonGlobalSettingsSchema = z$1.object({
 	cornerStyle: cornerStyleSchema,
 	cornerRadius: z$1.number().min(0).max(24).optional(),
 	/**
@@ -13547,11 +13899,12 @@ const buttonGlobalSettingsSchema = z$1.object({
 	paddingPreset: buttonPaddingPresetSchema.optional(),
 	hoverTransform: hoverTransformSchema,
 	hoverColor: hoverColorSchema,
-	hoverColorToken: themeColorTokenSchema.optional(),
+	hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 	gradientStyle: gradientStyleSchema.optional(),
 	gradientAngle: z$1.number().min(0).max(360).optional(),
 	gradientSharpness: gradientSharpnessSchema.optional()
 });
+const buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
 const gradientDirectionSchema$1 = z$1.enum([
 	"to-r",
 	"to-l",
@@ -13565,27 +13918,33 @@ const gradientDirectionSchema$1 = z$1.enum([
 const buttonBackgroundSchema = z$1.discriminatedUnion("type", [
 	z$1.object({
 		type: z$1.literal("solid"),
-		colorToken: themeColorTokenSchema
+		colorToken: opaqueButtonColourTokenSchema
 	}),
 	z$1.object({
 		type: z$1.literal("gradient"),
-		stops: z$1.array(themeColorTokenSchema).min(2),
-		direction: gradientDirectionSchema$1
+		stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+			const [first, second, ...rest] = stops;
+			if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
+			return [
+				first,
+				second,
+				...rest
+			];
+		}),
+		direction: gradientDirectionSchema$1,
+		foregroundToken: opaqueButtonColourTokenSchema
 	}),
-	z$1.object({ type: z$1.literal("transparent") })
+	z$1.object({
+		type: z$1.literal("surface"),
+		role: z$1.literal("link")
+	})
 ]);
 const effectApplicationSchema$1 = z$1.object({
 	effectId: z$1.string(),
-	options: z$1.record(z$1.string(), z$1.any()).optional()
-});
-const buttonBorderSchema = z$1.object({
-	widthClass: z$1.string(),
-	colorToken: themeColorTokenSchema
-});
-const buttonVariantAffordanceSchema = z$1.object({
-	iconId: z$1.string().min(1),
-	colorToken: themeColorTokenSchema.optional()
+	options: z$1.record(z$1.string(), z$1.json()).optional()
 });
+const buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
+const buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
 const variantShadowSchema = z$1.object({
 	elevation: z$1.enum([
 		"none",
@@ -13626,27 +13985,170 @@ const variantSizeOverridesSchema = z$1.object({
 * default (e.g. link-style variants declaring zero horizontal padding at
 * every size).
 */
-const buttonVariantSchema = z$1.object({
+const canonicalButtonVariantSchema = z$1.object({
 	id: z$1.string(),
 	name: z$1.string().min(1).max(20),
 	enabled: z$1.boolean(),
 	priority: prioritySchema,
 	background: buttonBackgroundSchema,
-	textColorToken: themeColorTokenSchema,
 	/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
 	borderRadius: z$1.string().optional(),
 	shadow: variantShadowSchema.optional(),
 	border: buttonBorderSchema.optional(),
-	hoverBackgroundToken: z$1.string().optional(),
+	hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
 	effects: variantEffectsSchema.optional(),
 	sizes: variantSizeOverridesSchema.optional(),
 	affordance: buttonVariantAffordanceSchema.optional()
 });
+/**
+* Temporary persisted-theme admission boundary for issue #1206.
+*
+* Production inventory on 2026-07-22 found 22 rows using the old independent
+* `textColorToken`/border colour shape. New source and all downstream code use
+* only the canonical relationship. Delete this preprocessor after the reviewed
+* production rewrite reports zero legacy rows.
+*/
+const buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
 const buttonSystemSchema = z$1.object({
 	global: buttonGlobalSettingsSchema,
 	variants: z$1.array(buttonVariantSchema).min(1).max(6),
 	sizes: buttonSizesSchema.optional()
 });
+function normalizeLegacyButtonVariantInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const background = input.background;
+	if (!isUnknownRecord(background)) return input;
+	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
+	const { textColorToken, ...withoutLegacyText } = input;
+	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
+	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
+	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
+	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
+	if (background.type === "transparent") return {
+		...withoutLegacyText,
+		background: {
+			type: "surface",
+			role: "link"
+		},
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+	if (background.type === "gradient") {
+		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
+		return {
+			...withoutLegacyText,
+			background: {
+				...background,
+				stops,
+				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
+			},
+			border: normalizedBorder,
+			affordance: normalizedAffordance,
+			effects: normalizedEffects,
+			hoverBackgroundToken
+		};
+	}
+	return {
+		...withoutLegacyText,
+		background: background.type === "solid" ? {
+			...background,
+			colorToken: stripLegacyTokenAlpha(background.colorToken)
+		} : background,
+		border: normalizedBorder,
+		affordance: normalizedAffordance,
+		effects: normalizedEffects,
+		hoverBackgroundToken
+	};
+}
+function normalizeLegacyButtonGlobalInput(input) {
+	if (!isUnknownRecord(input)) return input;
+	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
+	return hoverColorToken === input.hoverColorToken ? input : {
+		...input,
+		hoverColorToken
+	};
+}
+function hasLegacyAlphaToken(input, background) {
+	const stops = isUnknownArray(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(value) {
+	return Array.isArray(value);
+}
 buttonSizeNameSchema.options;
 //#endregion
 //#region ../theme-core/src/buttons/personalities/types.ts
@@ -13673,7 +14175,7 @@ function defineButtonPersonality(input) {
 		name: input.name,
 		description: input.description,
 		tags: input.tags,
-		buttonSystem: input.buttonSystem
+		buttonSystem: buttonSystemSchema.parse(input.buttonSystem)
 	};
 }
 //#endregion
@@ -13726,19 +14228,15 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["primary", "accent"],
-					direction: "to-r"
+					direction: "to-r",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "secondary",
@@ -13748,32 +14246,27 @@ const brushedWash = defineButtonPersonality({
 				background: {
 					type: "gradient",
 					stops: ["secondary", "accent"],
-					direction: "to-br"
+					direction: "to-br",
+					foregroundToken: "primaryForeground"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
 				shadow: {
 					elevation: "low",
 					softness: "soft",
 					position: "bottom"
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -15 }
-				}] }
+				}
 			},
 			{
 				id: "outline",
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -13784,8 +14277,10 @@ const brushedWash = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-lg",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -13831,7 +14326,6 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				shadow: {
 					elevation: "medium",
@@ -13841,7 +14335,7 @@ const confidentChip = defineButtonPersonality({
 				effects: {
 					hover: [{
 						effectId: "darken-background",
-						options: { amount: 60 }
+						options: { amount: 100 }
 					}],
 					active: [{
 						effectId: "scale-down",
@@ -13858,12 +14352,8 @@ const confidentChip = defineButtonPersonality({
 					type: "solid",
 					colorToken: "surface"
 				},
-				textColorToken: "text",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -13874,13 +14364,12 @@ const confidentChip = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -13891,8 +14380,10 @@ const confidentChip = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-md",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -13955,7 +14446,6 @@ const earthPill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "low",
@@ -13981,13 +14471,12 @@ const earthPill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -13998,13 +14487,12 @@ const earthPill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surfaceAlt" }
@@ -14015,8 +14503,10 @@ const earthPill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				shadow: {
 					elevation: "none",
@@ -14037,11 +14527,7 @@ const earthPill = defineButtonPersonality({
 						padding: "0.625rem 0",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 25 }
-				}] }
+				}
 			}
 		]
 	}
@@ -14077,8 +14563,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Primary",
 				enabled: true,
 				priority: 1,
-				background: { type: "transparent" },
-				textColorToken: "text",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -14100,8 +14588,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -14123,8 +14613,10 @@ const editorialLink = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
@@ -14146,19 +14638,17 @@ const editorialLink = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "mutedText",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: { padding: "0.25rem 0" },
 					md: { padding: "0.5rem 0" },
 					lg: { padding: "0.625rem 0" },
 					xl: { padding: "0.75rem 0" }
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: -20 }
-				}] }
+				}
 			}
 		]
 	}
@@ -14220,12 +14710,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accent"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -14239,13 +14725,12 @@ const flatInk = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-lg",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-lg",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -14263,12 +14748,8 @@ const flatInk = defineButtonPersonality({
 					type: "solid",
 					colorToken: "accent"
 				},
-				textColorToken: "accentForeground",
 				borderRadius: "rounded-lg",
-				affordance: {
-					iconId: "ArrowRight",
-					colorToken: "accentForeground"
-				},
+				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "lift",
 					options: { translateY: "-2px" }
@@ -14331,7 +14812,6 @@ const inkStamp = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
 				effects: {
 					hover: [{
@@ -14352,13 +14832,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -14369,13 +14848,12 @@ const inkStamp = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border-2",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -14386,8 +14864,10 @@ const inkStamp = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -14480,7 +14960,6 @@ const joyStamp = defineButtonPersonality({
 				type: "solid",
 				colorToken: "primary"
 			},
-			textColorToken: "primaryForeground",
 			borderRadius: "rounded-full",
 			shadow: {
 				elevation: "high",
@@ -14494,13 +14973,12 @@ const joyStamp = defineButtonPersonality({
 			name: "Secondary",
 			enabled: true,
 			priority: 2,
-			background: { type: "transparent" },
-			textColorToken: "text",
-			borderRadius: "rounded-full",
-			border: {
-				widthClass: "border-2",
-				colorToken: "text"
+			background: {
+				type: "surface",
+				role: "link"
 			},
+			borderRadius: "rounded-full",
+			border: { widthClass: "border-2" },
 			shadow: {
 				elevation: "high",
 				softness: "hard",
@@ -14565,12 +15043,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: {
 					hover: [{
 						effectId: "background-on-hover",
@@ -14591,12 +15065,8 @@ const ornateRitual = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -14607,13 +15077,12 @@ const ornateRitual = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-md",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-md",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "muted" }
@@ -14624,8 +15093,10 @@ const ornateRitual = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "accent",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-none",
 				sizes: {
 					sm: {
@@ -14707,14 +15178,10 @@ const pebble = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-full",
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 88
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -14722,13 +15189,12 @@ const pebble = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "accent"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "accent" }
@@ -14739,13 +15205,12 @@ const pebble = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "text",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border",
-					colorToken: "border"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -14756,8 +15221,10 @@ const pebble = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				sizes: {
 					sm: {
@@ -14773,11 +15240,7 @@ const pebble = defineButtonPersonality({
 						padding: "0.75rem 1.5rem",
 						fontSize: "text-xl"
 					}
-				},
-				effects: { hover: [{
-					effectId: "opacity-reduce",
-					options: { reduction: 30 }
-				}] }
+				}
 			}
 		]
 	}
@@ -14839,15 +15302,11 @@ const quietArrow = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "primaryForeground",
 				borderRadius: "rounded-xl",
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
-					effectId: "background-on-hover-alpha",
-					options: {
-						colorToken: "primary",
-						opacity: 90
-					}
+					effectId: "darken-background",
+					options: { amount: 100 }
 				}] }
 			},
 			{
@@ -14855,13 +15314,12 @@ const quietArrow = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-xl",
+				border: { widthClass: "border" },
 				affordance: { iconId: "ArrowRight" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -14873,21 +15331,22 @@ const quietArrow = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl",
-				border: {
-					widthClass: "border",
-					colorToken: "primary"
-				}
+				border: { widthClass: "border" }
 			},
 			{
 				id: "ghost",
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-xl"
 			}
 		]
@@ -14951,7 +15410,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "primary"
 				},
-				textColorToken: "background",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -14960,13 +15418,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Secondary",
 				enabled: true,
 				priority: 2,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{ effectId: "pop" }] }
 			},
 			{
@@ -14978,7 +15435,6 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "secondary"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
 				effects: { hover: [{ effectId: "pop" }] }
 			},
@@ -14991,12 +15447,8 @@ const showtimePill = defineButtonPersonality({
 					type: "solid",
 					colorToken: "background"
 				},
-				textColorToken: "primary",
 				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
-				},
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "surface" }
@@ -15007,13 +15459,12 @@ const showtimePill = defineButtonPersonality({
 				name: "Outline",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
-				borderRadius: "rounded-full",
-				border: {
-					widthClass: "border-2",
-					colorToken: "primary"
+				background: {
+					type: "surface",
+					role: "link"
 				},
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
 				effects: { hover: [{
 					effectId: "background-on-hover",
 					options: { colorToken: "background" }
@@ -15024,8 +15475,10 @@ const showtimePill = defineButtonPersonality({
 				name: "Ghost",
 				enabled: true,
 				priority: 3,
-				background: { type: "transparent" },
-				textColorToken: "primary",
+				background: {
+					type: "surface",
+					role: "link"
+				},
 				borderRadius: "rounded-full",
 				effects: { hover: [{
 					effectId: "background-on-hover",
@@ -15036,104 +15489,151 @@ const showtimePill = defineButtonPersonality({
 	}
 });
 //#endregion
-//#region ../theme-core/src/buttons/personalities/index.ts
-const buttonPersonalities = [
-	defineButtonPersonality({
-		id: "soft-pill",
-		name: "Soft Pill",
-		description: "Rounded pills with a gentle lift on hover. Quietly modern.",
-		tags: {
-			tone: "classic",
-			energy: "calm",
-			motion: "subtle",
-			era: "organic"
+//#region ../theme-core/src/buttons/personalities/soft-pill.ts
+/**
+* Soft Pill — rounded-full pill buttons with a hover lift. The default for
+* Calm Studio and Modern Wellness; reads as quietly modern and welcoming.
+*/
+const softPill = defineButtonPersonality({
+	id: "soft-pill",
+	name: "Soft Pill",
+	description: "Rounded pills with a gentle lift on hover. Quietly modern.",
+	tags: {
+		tone: "classic",
+		energy: "calm",
+		motion: "subtle",
+		era: "organic"
+	},
+	buttonSystem: {
+		global: {
+			cornerStyle: "pill",
+			shadow: "low",
+			textTransform: "none",
+			fontWeight: 500,
+			borderWidth: 2,
+			hoverTransform: "lift",
+			hoverColor: "none"
 		},
-		buttonSystem: {
-			global: {
-				cornerStyle: "pill",
-				shadow: "low",
-				textTransform: "none",
-				fontWeight: 500,
-				borderWidth: 2,
-				hoverTransform: "lift",
-				hoverColor: "none"
+		variants: [
+			{
+				id: "primary",
+				name: "Primary",
+				enabled: true,
+				priority: 1,
+				background: {
+					type: "solid",
+					colorToken: "primary"
+				},
+				borderRadius: "rounded-full",
+				shadow: {
+					elevation: "low",
+					softness: "soft",
+					position: "bottom"
+				},
+				effects: {
+					hover: [{
+						effectId: "lift",
+						options: { translateY: "-1px" }
+					}],
+					active: [{
+						effectId: "scale-down",
+						options: { scale: "0.98" }
+					}]
+				}
 			},
-			variants: [
-				{
-					id: "primary",
-					name: "Primary",
-					enabled: true,
-					priority: 1,
-					background: {
-						type: "solid",
-						colorToken: "primary"
-					},
-					textColorToken: "primaryForeground",
-					borderRadius: "rounded-full",
-					shadow: {
-						elevation: "low",
-						softness: "soft",
-						position: "bottom"
-					},
-					effects: {
-						hover: [{
-							effectId: "lift",
-							options: { translateY: "-1px" }
-						}],
-						active: [{
-							effectId: "scale-down",
-							options: { scale: "0.98" }
-						}]
-					}
+			{
+				id: "secondary",
+				name: "Secondary",
+				enabled: true,
+				priority: 2,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "secondary",
-					name: "Secondary",
-					enabled: true,
-					priority: 2,
-					background: { type: "transparent" },
-					textColorToken: "primary",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border-2",
-						colorToken: "primary"
-					},
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
+				borderRadius: "rounded-full",
+				border: { widthClass: "border-2" },
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			},
+			{
+				id: "outline",
+				name: "Outline",
+				enabled: true,
+				priority: 3,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "outline",
-					name: "Outline",
-					enabled: true,
-					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					border: {
-						widthClass: "border",
-						colorToken: "border"
-					},
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
+				borderRadius: "rounded-full",
+				border: { widthClass: "border" },
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			},
+			{
+				id: "ghost",
+				name: "Ghost",
+				enabled: true,
+				priority: 3,
+				background: {
+					type: "surface",
+					role: "link"
 				},
-				{
-					id: "ghost",
-					name: "Ghost",
-					enabled: true,
-					priority: 3,
-					background: { type: "transparent" },
-					textColorToken: "text",
-					borderRadius: "rounded-full",
-					effects: { hover: [{
-						effectId: "background-on-hover",
-						options: { colorToken: "surface" }
-					}] }
-				}
-			]
+				borderRadius: "rounded-full",
+				effects: { hover: [{
+					effectId: "background-on-hover",
+					options: { colorToken: "surface" }
+				}] }
+			}
+		]
+	}
+});
+//#endregion
+//#region ../theme-core/src/buttons/personalities/two-tone-pill.ts
+const solidSecondary = {
+	id: "secondary",
+	name: "Secondary",
+	enabled: true,
+	priority: 2,
+	background: {
+		type: "solid",
+		colorToken: unsafeAsOpaqueButtonColourToken("secondary")
+	},
+	borderRadius: "rounded-full",
+	shadow: {
+		elevation: "none",
+		softness: null,
+		position: "bottom"
+	},
+	effects: {
+		hover: [{
+			effectId: "background-on-hover-alpha",
+			options: {
+				colorToken: "secondary",
+				opacity: 88
+			}
+		}],
+		active: [{
+			effectId: "scale-down",
+			options: { scale: "0.98" }
+		}]
+	}
+};
+//#endregion
+//#region ../theme-core/src/buttons/personalities/index.ts
+const buttonPersonalities = [
+	softPill,
+	defineButtonPersonality({
+		id: "two-tone-pill",
+		name: "Two-tone Pill",
+		description: "Rounded pills with distinct solid primary and secondary brand colours.",
+		tags: softPill.tags,
+		buttonSystem: {
+			...softPill.buttonSystem,
+			variants: softPill.buttonSystem.variants.map((variant) => variant.id === "secondary" ? solidSecondary : variant)
 		}
 	}),
 	earthPill,
@@ -15149,6 +15649,27 @@ const buttonPersonalities = [
 	quietArrow
 ];
 new Map(buttonPersonalities.map((p) => [p.id, p]));
+buttonPersonalities.map((personality) => ({
+	id: personality.id,
+	name: personality.name,
+	description: personality.description,
+	category: presetCategory(personality),
+	buttonSystem: personality.buttonSystem,
+	compatibility: {
+		...personality.tags.tone ? { tones: [personality.tags.tone] } : {},
+		...personality.tags.energy ? { energies: [personality.tags.energy] } : {}
+	}
+}));
+function presetCategory(personality) {
+	switch (personality.tags.era) {
+		case "retro": return "retro";
+		case "editorial": return "minimal";
+		case "organic": return "artistic";
+		case "modern": return personality.tags.tone === "bold" ? "modern" : "technical";
+		case "technical": return "technical";
+		case void 0: return "modern";
+	}
+}
 //#endregion
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
@@ -16667,6 +17188,7 @@ const navFontWeight = z$1.enum([
 	"bold"
 ]);
 const headerMaxWidth = z$1.enum(["container", "full"]);
+const headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
 const headerContainerSchema = z$1.object({
 	rounded: z$1.enum([
 		"none",
@@ -16811,6 +17333,7 @@ const headerSchema = z$1.object({
 	positioning: headerPositioning,
 	shrinkOnScroll: z$1.boolean(),
 	maxWidth: headerMaxWidth,
+	barFrame: headerBarFrame.optional(),
 	logoOverride: mediaSchema$1.nullable().optional(),
 	background: headerBackgroundSchema.default({
 		type: "color",
@@ -16820,6 +17343,7 @@ const headerSchema = z$1.object({
 	navStyle: headerNavStyle,
 	navColor: themeColorTokenSchema.nullable().optional(),
 	navWeight: navFontWeight.default("medium"),
+	navFontRole: z$1.enum(["body", "heading"]).optional(),
 	navTypography: z$1.enum(["body", "heading"]).optional(),
 	navTextSize: navLinkStyleSchema.shape.textSize,
 	navPlacement: z$1.enum(["end", "center"]).optional(),
@@ -16835,7 +17359,21 @@ const headerSchema = z$1.object({
 	ctaTreatment: headerCtaTreatmentSchema.optional(),
 	ctaVariant: z$1.string().min(1).optional(),
 	dropdownStyle: dropdownStyleSchema
-});
+}).transform(normaliseHeaderNavFontRole);
+/**
+* Normalises the legacy `navTypography` font-role alias into the canonical
+* `navFontRole` field so persisted themes migrate at the parse boundary without
+* a data migration. `navFontRole` always wins when both are present; the legacy
+* field is dropped so we never carry a dual write forward.
+*/
+function normaliseHeaderNavFontRole(header) {
+	if (header.navTypography === void 0) return header;
+	const { navTypography, ...rest } = header;
+	return header.navFontRole === void 0 ? {
+		...rest,
+		navFontRole: navTypography
+	} : rest;
+}
 const footerVariant = z$1.enum([
 	"simple",
 	"columns",
@@ -18609,6 +19147,241 @@ const originalJoyCardSystem = { variants: [{
 const serifDisplayQuote = { style: "serif-display" };
 /** Punchy quotation mark in the secondary accent colour. Bold / accent styles. */
 const accentGlyphQuote = { style: "accent-glyph" };
+/**
+* Curated library of gradient presets.
+* All gradients use theme color tokens, so they adapt to the site's palette.
+*/
+const GRADIENT_PRESETS = [
+	{
+		id: "primary-secondary",
+		name: "Primary to Secondary",
+		description: "Blend your primary and secondary brand colors",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "secondary-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-accent",
+		name: "Primary to Accent",
+		description: "Energetic gradient from primary to accent",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-accent",
+		name: "Secondary to Accent",
+		description: "Vibrant secondary to accent blend",
+		type: "linear",
+		angle: 135,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "accent-500",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-light-dark",
+		name: "Primary Light to Dark",
+		description: "Subtle primary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-500",
+			position: 0
+		}, {
+			color: "primary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-dark-light",
+		name: "Primary Dark to Light",
+		description: "Reverse primary fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-50",
+			position: 100
+		}]
+	},
+	{
+		id: "secondary-light-dark",
+		name: "Secondary Light to Dark",
+		description: "Subtle secondary color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "secondary-500",
+			position: 0
+		}, {
+			color: "secondary-900",
+			position: 100
+		}]
+	},
+	{
+		id: "accent-light-dark",
+		name: "Accent Light to Dark",
+		description: "Accent color depth fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "accent-500",
+			position: 0
+		}, {
+			color: "accent-900",
+			position: 100
+		}]
+	},
+	{
+		id: "background-surface",
+		name: "Background to Surface",
+		description: "Subtle depth using base colors",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "background",
+			position: 0
+		}, {
+			color: "surface",
+			position: 100
+		}]
+	},
+	{
+		id: "neutral-fade",
+		name: "Neutral Gradient",
+		description: "Elegant neutral color fade",
+		type: "linear",
+		angle: 180,
+		stops: [{
+			color: "neutral-900",
+			position: 0
+		}, {
+			color: "neutral-50",
+			position: 100
+		}]
+	},
+	{
+		id: "primary-glow",
+		name: "Primary glow",
+		description: "A soft top-centred glow using your primary palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "primary-900",
+			position: 0
+		}, {
+			color: "primary-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onPrimary900",
+			headingColor: "onPrimary900",
+			linkColor: "onPrimary900",
+			supportingColor: "onPrimary900"
+		}
+	},
+	{
+		id: "accent-glow",
+		name: "Accent glow",
+		description: "A soft top-centred glow using your accent palette",
+		type: "radial",
+		shape: "ellipse",
+		position: "top center",
+		stops: [{
+			color: "accent-900",
+			position: 0
+		}, {
+			color: "accent-950",
+			position: 100
+		}],
+		foreground: {
+			textColor: "onAccent900",
+			headingColor: "onAccent900",
+			linkColor: "onAccent900",
+			supportingColor: "onAccent900"
+		}
+	},
+	{
+		id: "primary-secondary-accent",
+		name: "Brand Trio",
+		description: "All three brand colors in harmony",
+		type: "linear",
+		angle: 135,
+		stops: [
+			{
+				color: "primary-500",
+				position: 0
+			},
+			{
+				color: "secondary-500",
+				position: 50
+			},
+			{
+				color: "accent-500",
+				position: 100
+			}
+		]
+	}
+].map((preset) => ({
+	...preset,
+	id: preset.id,
+	stops: preset.stops
+}));
+const GRADIENT_PRESET_IDS = GRADIENT_PRESETS.map((preset) => preset.id);
+const gradientPresetIdSet = new Set(GRADIENT_PRESET_IDS);
+const gradientPresetById = Object.fromEntries(GRADIENT_PRESETS.map((preset) => [preset.id, preset]));
+function parseGradientPresetId(value) {
+	if (typeof value !== "string") return null;
+	const normalized = value.trim();
+	if (!gradientPresetIdSet.has(normalized)) return null;
+	return normalized;
+}
+function getGradientPreset(id) {
+	return gradientPresetById[id];
+}
+//#endregion
+//#region ../theme-core/src/gradients/utils.ts
+/**
+* Convert a GradientConfig to a CSS gradient string
+*
+* @param config - The gradient configuration using theme tokens
+* @param tokens - Map of theme color tokens to hex values
+* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
+*/
+function gradientToCss(config, tokens) {
+	const stops = config.stops.map((stop) => {
+		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
+	}).join(", ");
+	const type = config.type ?? "linear";
+	if (type === "radial") {
+		const position = config.position ?? "center";
+		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
+	}
+	if (type === "conic") {
+		const position = config.position ?? "center";
+		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
+	}
+	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
+}
 //#endregion
 //#region ../theme-core/src/site-styles/headerLooks.ts
 function asHeaderLookId(value) {
@@ -18743,7 +19516,7 @@ const overlayLogoAccommodations = [
 * optional nested styling fields that would otherwise leak from another Look.
 */
 function baseHeader(theme) {
-	const { navLinkStyle: _navLinkStyle, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
+	const { navLinkStyle: _navLinkStyle, navFontRole: _navFontRole, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
 	return {
 		...header,
 		navContainer: {
@@ -18892,6 +19665,17 @@ const headerStyleCatalog = defineExactCatalog()([
 		navTypography: "brand-caps",
 		moods: ["expressive"]
 	},
+	{
+		id: asHeaderStyleId("brand-capsule"),
+		label: "Brand Capsule",
+		description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.",
+		supportedLayoutIds: supportedLayouts(["classic"]),
+		navInteraction: "pill-background",
+		surface: "brand-solid",
+		defaultDepth: "shadow",
+		navTypography: "quiet-caps",
+		moods: ["expressive", "professional"]
+	},
 	{
 		id: asHeaderStyleId("serif-line"),
 		label: "Serif Line",
@@ -18985,6 +19769,7 @@ const headerStyleCompatibilityOrder = /* @__PURE__ */ new Map([
 		"brand-bar",
 		"brand-underline",
 		"brand-pill",
+		"brand-capsule",
 		"serif-line",
 		"flat-tabs"
 	])],
@@ -19022,6 +19807,11 @@ headerStyleRepairChain([
 	"brand-pill",
 	"brand-bar",
 	"minimal"
+]), headerStyleRepairChain([
+	"brand-capsule",
+	"brand-pill",
+	"brand-bar",
+	"minimal"
 ]), headerStyleRepairChain([
 	"pill-nav",
 	"soft-bar",
@@ -20635,6 +21425,19 @@ z$1.object({
 }).strict();
 //#endregion
 //#region ../theme-core/src/site-styles/runtimeCompiler.ts
+function defineSectionForegroundRuntimeTokens(input) {
+	return {
+		textColor: requireThemeColorToken(input.textColor),
+		headingColor: requireThemeColorToken(input.headingColor),
+		linkColor: requireThemeColorToken(input.linkColor),
+		supportingColor: requireThemeColorToken(input.supportingColor)
+	};
+}
+function requireThemeColorToken(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) throw new Error(`Invalid section foreground Theme color token: ${String(value)}`);
+	return token;
+}
 function defineDesignRuntimeRules(rules) {
 	return rules;
 }
@@ -20905,24 +21708,24 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				type: "color",
 				color: "muted"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"brand-depth-band": {
 			background: {
 				type: "color",
 				color: "primary-800"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
 		},
 		"hero-image": {
 			background: {
@@ -20930,12 +21733,32 @@ const kirtanOrnateDesignRuntimeRules = defineDesignRuntimeRules({
 				opacity: 1,
 				position: "center center"
 			},
-			foreground: {
+			foreground: defineSectionForegroundRuntimeTokens({
 				textColor: "text",
 				headingColor: "primary",
 				linkColor: "primary",
 				supportingColor: "text"
-			}
+			})
+		}
+	}
+});
+const primaryGlowGradientPresetId = parseGradientPresetId("primary-glow");
+if (!primaryGlowGradientPresetId) throw new Error("Expected primary-glow in the Theme Core gradient catalog");
+const fulcrumDesignRuntimeRules = defineDesignRuntimeRules({
+	...defaultDesignRuntimeRules,
+	sectionSurfaces: {
+		...defaultDesignRuntimeRules.sectionSurfaces,
+		"accent-band": {
+			background: {
+				type: "gradient",
+				gradientPresetId: primaryGlowGradientPresetId
+			},
+			foreground: defineSectionForegroundRuntimeTokens({
+				textColor: "primaryForeground",
+				headingColor: "primaryForeground",
+				linkColor: "primaryForeground",
+				supportingColor: "primaryForeground"
+			})
 		}
 	}
 });
@@ -21259,6 +22082,7 @@ const curatedSiteStyles = [
 		],
 		buttonPersonalityChoices: [
 			buttonChoice("soft-pill"),
+			buttonChoice("two-tone-pill"),
 			buttonChoice("pebble"),
 			buttonChoice("editorial-link"),
 			buttonChoice("brushed-wash")
@@ -22322,6 +23146,8 @@ const curatedSiteStyles = [
 		},
 		compositionBudget: quietBudget,
 		typography: fulcrumTypography,
+		designRuntimeRules: fulcrumDesignRuntimeRules,
+		recommendedAppearancePresetIds: ["cta-accent-band"],
 		themeOverrides: {
 			shadow: { colorToken: "primary" },
 			accordions: {
@@ -22438,6 +23264,7 @@ const curatedSiteStyles = [
 		],
 		buttonPersonalityChoices: [
 			buttonChoice("quiet-arrow"),
+			buttonChoice("two-tone-pill"),
 			buttonChoice("flat-ink"),
 			buttonChoice("editorial-link")
 		],
@@ -22693,213 +23520,6 @@ z$1.object({
 	spacing: z$1.enum(themeTokenRecipeOptions.spacing),
 	motion: z$1.enum(themeTokenRecipeOptions.motion)
 });
-//#endregion
-//#region ../theme-core/src/gradients/presets.ts
-/**
-* Curated library of gradient presets
-* All gradients use theme color tokens, so they adapt to the site's palette
-*/
-const GRADIENT_PRESETS = [
-	{
-		id: "primary-secondary",
-		name: "Primary to Secondary",
-		description: "Blend your primary and secondary brand colors",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "secondary-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-accent",
-		name: "Primary to Accent",
-		description: "Energetic gradient from primary to accent",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-accent",
-		name: "Secondary to Accent",
-		description: "Vibrant secondary to accent blend",
-		type: "linear",
-		angle: 135,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "accent-500",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-light-dark",
-		name: "Primary Light to Dark",
-		description: "Subtle primary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-dark-light",
-		name: "Primary Dark to Light",
-		description: "Reverse primary fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "primary-900",
-			position: 0
-		}, {
-			color: "primary-50",
-			position: 100
-		}]
-	},
-	{
-		id: "secondary-light-dark",
-		name: "Secondary Light to Dark",
-		description: "Subtle secondary color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "secondary-500",
-			position: 0
-		}, {
-			color: "secondary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-light-dark",
-		name: "Accent Light to Dark",
-		description: "Accent color depth fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "background-surface",
-		name: "Background to Surface",
-		description: "Subtle depth using base colors",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "background",
-			position: 0
-		}, {
-			color: "surface",
-			position: 100
-		}]
-	},
-	{
-		id: "neutral-fade",
-		name: "Neutral Gradient",
-		description: "Elegant neutral color fade",
-		type: "linear",
-		angle: 180,
-		stops: [{
-			color: "neutral-900",
-			position: 0
-		}, {
-			color: "neutral-50",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-radial",
-		name: "Primary Spotlight",
-		description: "Radial primary gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "primary-500",
-			position: 0
-		}, {
-			color: "primary-900",
-			position: 100
-		}]
-	},
-	{
-		id: "accent-radial",
-		name: "Accent Spotlight",
-		description: "Radial accent gradient from center",
-		type: "radial",
-		position: "center",
-		stops: [{
-			color: "accent-500",
-			position: 0
-		}, {
-			color: "accent-900",
-			position: 100
-		}]
-	},
-	{
-		id: "primary-secondary-accent",
-		name: "Brand Trio",
-		description: "All three brand colors in harmony",
-		type: "linear",
-		angle: 135,
-		stops: [
-			{
-				color: "primary-500",
-				position: 0
-			},
-			{
-				color: "secondary-500",
-				position: 50
-			},
-			{
-				color: "accent-500",
-				position: 100
-			}
-		]
-	}
-];
-//#endregion
-//#region ../theme-core/src/gradients/utils.ts
-/**
-* Convert a GradientConfig to a CSS gradient string
-*
-* @param config - The gradient configuration using theme tokens
-* @param tokens - Map of theme color tokens to hex values
-* @returns CSS gradient string (e.g., "linear-gradient(180deg, #3b82f6 0%, #f59e0b 100%)")
-*/
-function gradientToCss(config, tokens) {
-	const stops = config.stops.map((stop) => {
-		return `${tokens[stop.color] ?? "#000000"} ${stop.position}%`;
-	}).join(", ");
-	const type = config.type ?? "linear";
-	if (type === "radial") {
-		const position = config.position ?? "center";
-		return `radial-gradient(${config.shape ?? "circle"} at ${position}, ${stops})`;
-	}
-	if (type === "conic") {
-		const position = config.position ?? "center";
-		return `conic-gradient(from ${config.angle ?? 0}deg at ${position}, ${stops})`;
-	}
-	return `linear-gradient(${config.angle ?? 180}deg, ${stops})`;
-}
 const BREAKPOINT_LG = 1024;
 const BREAKPOINT_XL = 1280;
 const BREAKPOINT_LG_DOWN = BREAKPOINT_LG - 1;
@@ -23866,6 +24486,20 @@ const blockCategoryEnum = z$1.enum([
 	"layout",
 	"interactive"
 ]);
+const blockContentSourceSchema = z$1.object({
+	kind: z$1.enum([
+		"inline",
+		"entries",
+		"mixed"
+	]),
+	contentType: z$1.string().min(1).optional()
+}).superRefine((value, ctx) => {
+	if (value.kind === "inline" && value.contentType) ctx.addIssue({
+		code: z$1.ZodIssueCode.custom,
+		path: ["contentType"],
+		message: "contentType is not allowed when contentSource.kind is \"inline\""
+	});
+});
 z$1.object({
 	name: z$1.string().min(1),
 	version: z$1.string().min(1),
@@ -23896,6 +24530,12 @@ z$1.object({
 	}).optional()).optional(),
 	category: blockCategoryEnum.optional(),
 	contentTypes: z$1.array(z$1.string()).optional(),
+	/**
+	* Explicit content-source classification (inline / entries / mixed). Optional at the
+	* schema level for backward compatibility with SDK-defined custom blocks, but every
+	* registered SYSTEM block must declare it (enforced by a registry-wide test).
+	*/
+	contentSource: blockContentSourceSchema.optional(),
 	tags: z$1.array(z$1.string()).optional(),
 	icon: z$1.string().optional()
 });
@@ -24872,6 +25512,7 @@ function devValidate(node) {
 }
 //#endregion
 //#region ../blocks/src/system/node/fragments/backgroundLayer.ts
+const BACKGROUND_FRAME_BASE_CLASS = "rb-background-frame rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-isolate rb-pointer-events-none";
 /**
 * Creates background layer nodes for rendering backgrounds from field data.
 *
@@ -24937,6 +25578,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:
@@ -25098,8 +25767,8 @@ function sectionContainer(children, opts) {
 *     - content
 */
 function styledContainer(config) {
-	const { children, rootType = "div", rootProps, bindFrom = "_containerStyles", baseClassName = "rb-relative rb-isolate rb-overflow-hidden", imageClassName = "rb-absolute rb-z-neg-10", constrainWidth = true } = config;
-	const backgroundNodes = backgroundLayer(`${bindFrom}.background`, { imageClassName });
+	const { children, rootType = "div", rootProps, bindFrom = "_containerStyles", baseClassName = "rb-relative rb-isolate rb-overflow-visible", imageClassName = "rb-absolute rb-z-0", constrainWidth = true } = config;
+	const backgroundNode = backgroundFrame(`${bindFrom}.background`, { imageClassName });
 	const childrenArray = Array.isArray(children) ? children : [children];
 	const { className: _ignoredClassName, style: _ignoredStyle, ...safeRootProps } = rootProps ?? {};
 	return el(rootType, {
@@ -25122,7 +25791,7 @@ function styledContainer(config) {
 			}],
 			fallback: constrainWidth ? `${baseClassName} rb-container` : baseClassName
 		} }
-	}, [...backgroundNodes, ...childrenArray]);
+	}, [backgroundNode, ...childrenArray]);
 }
 //#endregion
 //#region ../blocks/src/system/spacing.ts
@@ -25255,7 +25924,7 @@ const DEFAULT_SECTION_SPACING = "medium";
 * - Creating a section wrapper with background theme
 * - Adding background color/gradient/image layers
 * - Binding className to section styles with transform
-* - Binding allowOverflow for background positioning
+* - Keeping foreground overflow visible while decorative backgrounds clip independently
 * - Wrapping content children
 *
 * Use this helper to eliminate 25+ lines of boilerplate section setup code.
@@ -25291,8 +25960,8 @@ const DEFAULT_SECTION_SPACING = "medium";
 * });
 */
 function styledSection(config) {
-	const { children, baseClass = "rb-px-6", spacing = DEFAULT_SECTION_SPACING, background = "background", bindFrom = "_sectionStyles", imageClassName = "rb-absolute rb-z-neg-10", renderBackgroundImage = true, backgroundImageLoading, backgroundImageFetchPriority, allowOverflow = false, fullWidthPath } = config;
-	const renderedBackgroundNodes = backgroundLayer(`${bindFrom}.background`, {
+	const { children, baseClass = "rb-px-6", spacing = DEFAULT_SECTION_SPACING, background = "background", bindFrom = "_sectionStyles", imageClassName = "rb-absolute rb-z-0", renderBackgroundImage = true, backgroundImageLoading, backgroundImageFetchPriority, fullWidthPath } = config;
+	const renderedBackgroundNode = backgroundFrame(`${bindFrom}.background`, {
 		imageClassName,
 		fallbackToken: background,
 		omitImageLayer: !renderBackgroundImage,
@@ -25315,13 +25984,8 @@ function styledSection(config) {
 					fullWidthPath
 				}
 			}]
-		} },
-		allowOverflow: allowOverflow ? true : { $bind: {
-			from: `${bindFrom}.background`,
-			transforms: [{ id: "background.resolveAllowOverflow" }],
-			fallback: false
 		} }
-	}, [...renderedBackgroundNodes, ...childrenArray]);
+	}, [renderedBackgroundNode, ...childrenArray]);
 }
 //#endregion
 //#region ../blocks/src/system/node/fragments/ctaButton.ts
@@ -26182,9 +26846,12 @@ function responsiveTwoColumn({ image, text, ratioFrom, imagePositionFrom, gapCla
 //#endregion
 //#region ../blocks/src/system/node/fragments/styledCard.ts
 function styledCard(children, opts, ...mods) {
-	const baseClassName = opts.baseClassName ?? "rb-relative rb-isolate rb-overflow-hidden rb-border";
-	const defaultBackgroundLayer = el("div", { className: "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-pointer-events-none rb-bg-surface" });
-	const backgroundNodes = backgroundLayer(opts.backgroundFrom);
+	const baseClassName = opts.baseClassName ?? "rb-relative rb-isolate rb-overflow-visible rb-border";
+	const defaultBackgroundLayer = el("div", {
+		className: "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-pointer-events-none rb-bg-surface",
+		style: { borderRadius: "inherit" }
+	});
+	const backgroundNode = backgroundFrame(opts.backgroundFrom);
 	const style = {
 		...opts.style ?? {},
 		borderColor: { $bind: {
@@ -26211,7 +26878,7 @@ function styledCard(children, opts, ...mods) {
 		...style ? { style } : {}
 	}, [
 		defaultBackgroundLayer,
-		...backgroundNodes,
+		backgroundNode,
 		...children
 	], ...mods);
 }
@@ -26991,9 +27658,15 @@ function createButtonGroup(options = {}) {
 //#endregion
 //#region ../blocks/src/system/fields/ctas.ts
 function createCtasRepeater(options = {}) {
-	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button } = options;
+	const { id = "ctas", label = "Calls to action", itemLabel = "CTA", minItems = 0, maxItems, button, defaultValue } = options;
+	const fieldId = id;
+	const buttonField = createButtonGroup({
+		showGroupLabel: false,
+		...button ?? {},
+		flattenInRepeater: true
+	});
 	return {
-		id,
+		id: fieldId,
 		type: "repeater",
 		label,
 		itemLabel,
@@ -27002,11 +27675,8 @@ function createCtasRepeater(options = {}) {
 		maxItems,
 		required: false,
 		allowConversion: true,
-		schema: { fields: [createButtonGroup({
-			showGroupLabel: false,
-			...button ?? {},
-			flattenInRepeater: true
-		})] }
+		...defaultValue !== void 0 ? { defaultValue: [...defaultValue] } : {},
+		schema: { fields: [buttonField] }
 	};
 }
 //#endregion
@@ -27056,6 +27726,7 @@ const heroCtaRowFragment = defineFragment({
 		label: "Calls to action",
 		itemLabel: "CTA",
 		maxItems: 3,
+		defaultValue: [],
 		button: {
 			variants: [
 				{
@@ -27123,7 +27794,7 @@ const ctaCopyFragment = defineFragment({
 		eyebrowPath: "content.eyebrow",
 		titlePath: "content.title",
 		className: "cta-heading"
-	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content.content"), bind("content.content"))]
+	}), richText({ className: "cta-content rb-prose rb-mx-auto rb-max-w-none" }, when("content"), bind("content"))]
 });
 //#endregion
 //#region ../blocks/src/system/fragments/library/testimonialsHeading.ts
@@ -27220,7 +27891,7 @@ function buildTestimonialCard(...mods) {
 	}, props({ value: "“" })), richText({ className: "rb-prose rb-max-w-none" }, bind("testimonial.content.body"), when("testimonial.content.body"))]), el("div", { className: "rb-testimonial-attribution" }, buildAttributionNodes())])], {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-testimonial-card rb-relative rb-isolate rb-flex rb-h-full rb-flex-col rb-overflow-hidden rb-p-8"
+		baseClassName: "rb-testimonial-card rb-relative rb-isolate rb-flex rb-h-full rb-flex-col rb-overflow-visible rb-p-8"
 	}, ...mods);
 }
 /**
@@ -27692,39 +28363,6 @@ const formEmbedFragment = defineFragment({
 	}
 });
 //#endregion
-//#region ../blocks/src/system/fragments/library/footerBottomText.ts
-const footerBottomTextFragment = defineFragment({
-	id: "footerBottomText",
-	title: "Footer Text",
-	description: "Rich text content for the main footer body and optional bottom bar.",
-	fields: [{
-		id: "bodyText",
-		type: "richText",
-		label: "Body text",
-		description: "Appears in the main footer area.",
-		ui: { variant: "limited" }
-	}, {
-		id: "bottomText",
-		type: "richText",
-		label: "Bottom bar text",
-		description: "Appears in the optional footer bottom bar.",
-		ui: { variant: "limited" }
-	}],
-	layout: [richText({
-		className: "rb-prose rb-prose-sm rb-mx-auto rb-max-w-3xl rb-text-center",
-		style: textColorStyle("text/80")
-	}, when("bodyText"), bind("bodyText", { transforms: [{
-		id: "content.interpolateRichTextTokens",
-		options: { tokens: ["year", "site_name"] }
-	}] })), richText({
-		className: "rb-prose rb-prose-sm rb-mx-auto rb-max-w-3xl rb-text-center",
-		style: textColorStyle("text/80")
-	}, when("bottomText"), bind("bottomText", { transforms: [{
-		id: "content.interpolateRichTextTokens",
-		options: { tokens: ["year", "site_name"] }
-	}] }))]
-});
-//#endregion
 //#region ../blocks/src/system/fragments/library/singleButton.ts
 const singleButtonFragment = defineFragment({
 	id: "singleButton",
@@ -27897,7 +28535,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"
 						}
 					}]
 				},
@@ -28888,6 +29526,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,
@@ -29021,7 +29660,6 @@ function splitLayoutWith(children) {
 			}
 		}),
 		renderBackgroundImage: false,
-		allowOverflow: true,
 		baseClass: ""
 	});
 }
@@ -29034,6 +29672,7 @@ const heroBlockDefinition = { manifest: createBlockManifest({
 	title: "Hero",
 	titleSource: "headline",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	promotedFields: ["_sectionStyles.background.image"],
 	fragments: [
@@ -29307,6 +29946,7 @@ const introBlockDefinition = { manifest: createBlockManifest({
 	id: "block.intro",
 	title: "Intro",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -29492,6 +30132,7 @@ const bodyTextBlockDefinition = { manifest: createBlockManifest({
 	title: "Body Text",
 	titleSource: "heading",
 	category: "content",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: bodyCopyFragment,
 		fieldPriority: 0
@@ -29548,6 +30189,10 @@ const blogPostBlockDefinition = {
 		description: "Highlights a single blog post with title, image, and excerpt.",
 		category: "blog",
 		contentTypes: ["post"],
+		contentSource: {
+			kind: "entries",
+			contentType: "post"
+		},
 		tags: [
 			"blog",
 			"post",
@@ -29649,7 +30294,7 @@ function postCard(children, ...mods) {
 	return styledCard(children, {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border rb-flex rb-flex-col rb-h-full"
+		baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border rb-flex rb-flex-col rb-h-full"
 	}, ...mods);
 }
 const gridPostCard = postCard([postImageLink("rb-h-48 rb-w-full rb-object-cover rb-transition-transform rb-hover-scale-105", {
@@ -29685,7 +30330,7 @@ const stackPostCard = styledCard([inline({
 ])])], {
 	stylesFrom: "content._cardStyles",
 	backgroundFrom: "content._cardStyles.background",
-	baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border"
+	baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border"
 }, repeat("data.posts", "post"));
 const emptyState$2 = {
 	...styledCard([text({
@@ -29694,7 +30339,7 @@ const emptyState$2 = {
 	}, bind("content.emptyMessage", { fallback: "No posts published yet." }))], {
 		stylesFrom: "content._cardStyles",
 		backgroundFrom: "content._cardStyles.background",
-		baseClassName: "rb-relative rb-isolate rb-overflow-hidden rb-border rb-border-dashed rb-p-8 rb-text-center"
+		baseClassName: "rb-relative rb-isolate rb-overflow-visible rb-border rb-border-dashed rb-p-8 rb-text-center"
 	}),
 	$when: {
 		when: { from: "data.posts[0]" },
@@ -29704,7 +30349,7 @@ const emptyState$2 = {
 function blogListingShell(children) {
 	return styledSection({
 		children: styledContainer({
-			baseClassName: "rb-relative rb-isolate rb-overflow-hidden",
+			baseClassName: "rb-relative rb-isolate rb-overflow-visible",
 			children
 		}),
 		baseClass: ""
@@ -29845,6 +30490,10 @@ const blogListingManifest = createBlockManifest({
 	],
 	description: "Display a collection of blog posts in grid or stack layout.",
 	contentTypes: ["post"],
+	contentSource: {
+		kind: "entries",
+		contentType: "post"
+	},
 	tags: [
 		"blog",
 		"posts",
@@ -29887,6 +30536,7 @@ const ctaFullBlockDefinition = { manifest: createBlockManifest({
 	id: "block.cta-full",
 	title: "Full-width CTA",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: ctaCopyFragment,
 		fieldPriority: 0
@@ -29920,6 +30570,7 @@ const singleButtonBlockDefinition = { manifest: createBlockManifest({
 	id: "block.single-button",
 	title: "Single Button",
 	category: "marketing",
+	contentSource: { kind: "inline" },
 	fragments: [{
 		fragment: singleButtonFragment,
 		fieldPriority: 0
@@ -30116,7 +30767,7 @@ const copyLayout = fragmentLayoutNode$1(formCopyFragment.layout);
 const formSurface = styledContainer({
 	bindFrom: "_containerStyles",
 	constrainWidth: false,
-	baseClassName: "rb-form-surface rb-relative rb-isolate rb-overflow-hidden",
+	baseClassName: "rb-form-surface rb-relative rb-isolate rb-overflow-visible",
 	children: fragmentLayoutNode$1(formEmbedFragment.layout)
 });
 function createFormLayout(variant) {
@@ -30180,6 +30831,7 @@ const formManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"form",
 		"contact",
@@ -30242,6 +30894,7 @@ const contactNewsletterBlockDefinition = {
 		titleSource: "contactTitle",
 		description: "Two-column newsletter signup and contact form section.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		layout: contactNewsletterLayout,
 		defaultVariant: "default",
 		variants: { default: contactNewsletterLayout },
@@ -30445,6 +31098,7 @@ const faqBlockDefinition = { manifest: createBlockManifest({
 	title: "FAQ",
 	titleSource: "title",
 	category: "content",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	fragments: [{
 		fragment: faqHeadingFragment,
@@ -31333,6 +31987,7 @@ const headerRootClassTransform = {
 		];
 		const variant = header?.variant;
 		if (variant && VALID_VARIANTS.includes(variant)) classes.push(`header-variant-${variant}`);
+		if (header?.barFrame === "inset-shell" && variant === "classic") classes.push("header-bar-frame-inset-shell");
 		return joinClasses(classes);
 	}
 };
@@ -31856,7 +32511,7 @@ function desktopOnlyDisplay(display) {
 }
 //#endregion
 //#region ../blocks/src/system/blocks/site-header.ts
-const whenTransformed$1 = (from, transformId, equals = true) => (node) => ({
+const whenTransformed = (from, transformId, equals = true) => (node) => ({
 	...node,
 	$when: {
 		when: {
@@ -31884,7 +32539,7 @@ const logoRow = link({
 	text({
 		as: "strong",
 		className: "header-logo-text rb-truncate"
-	}, whenTransformed$1("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
+	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
 ]);
 const centeredLogoRow = link({
 	href: "/",
@@ -31904,7 +32559,7 @@ const centeredLogoRow = link({
 	text({
 		as: "strong",
 		className: "header-logo-text"
-	}, whenTransformed$1("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
+	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
 ]);
 const createNavRow = (className, align = "end") => navRow({
 	className: `${className} header-nav-row`,
@@ -32036,7 +32691,7 @@ const classicLayout = inline({
 	logoRow,
 	createNavRow(`rb-ml-auto ${desktopOnlyDisplay("flex")} rb-gap-6`),
 	headerCta
-], whenTransformed$1("$root.theme.header", "layout.classicNavMode", "inline"));
+], whenTransformed("$root.theme.header", "layout.classicNavMode", "inline"));
 const classicCenteredNavLayout = inline({
 	className: bindProp("$root.theme.header.maxWidth", {
 		transforms: pipe(tx("layout.maxWidthClass", { base: `rb-header-layout ${desktopOnlyDisplay("flex")} rb-w-full rb-items-center rb-gap-6` })),
@@ -32047,7 +32702,7 @@ const classicCenteredNavLayout = inline({
 	logoRow,
 	createNavRow(`rb-flex-1 rb-justify-center ${desktopOnlyDisplay("flex")} rb-gap-6`, "center"),
 	headerCta
-], whenTransformed$1("$root.theme.header", "layout.classicNavMode", "centered"));
+], whenTransformed("$root.theme.header", "layout.classicNavMode", "centered"));
 const centeredLayout = stack({
 	gap: "md",
 	align: "center",
@@ -32087,6 +32742,7 @@ const siteHeaderBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-header",
 	title: "Site Header",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [{
 		id: "mode",
 		type: "select",
@@ -32110,7 +32766,6 @@ const siteHeaderBlockDefinition = { manifest: createBlockManifest({
 			transforms: pipe(tx("layout.headerSectionBackground")),
 			fallback: "background"
 		}),
-		allowOverflow: true,
 		className: bindProp("$root.theme.header", {
 			transforms: pipe(tx("layout.headerRootClass")),
 			fallback: "header-root rb-z-40 rb-w-full transition-theme"
@@ -32160,218 +32815,155 @@ const footerNavGroupsLayout = stack({
 	linkRequired: true,
 	target: { $bind: { from: "entry.target" } },
 	rel: { $bind: { from: "entry.rel" } }
-}, [text({ as: "span" }, bind("entry.label"))], repeat("group.children", "entry"))])], repeat("footerMenu.groups", "group"))], when("footerMenu.groups"));
+}, [text({ as: "span" }, bind("entry.label"))], repeat("group.children", "entry"))])], repeat("footerMenu.groups", "group"))], whenCollectionHasItems("footerMenu.groups"));
 //#endregion
 //#region ../blocks/src/system/blocks/site-footer.ts
-const footerTextLayout = () => materializeFragment({ fragment: footerBottomTextFragment }).layout;
-const whenTransformed = (from, transformId, equals = true) => (node) => ({
-	...node,
-	$when: {
-		when: {
-			from,
-			transforms: [{ id: transformId }]
-		},
-		equals
-	}
-});
-const bottomBarTextLayout = () => {
-	const bottomTextNode = footerTextLayout()[1];
-	return bottomTextNode ? [bottomTextNode] : [];
-};
-const bodyTextLayout = () => {
-	const bodyTextNode = footerTextLayout()[0];
-	return bodyTextNode ? [bodyTextNode] : [];
-};
-const businessAddressLayout = () => [text({
-	as: "p",
-	className: "rb-caption rb-opacity-80"
-}, bind("site.businessAddress.displayAddress"), when("content.showBusinessAddress", { equals: true }))];
-const inlineBottomTextLayout = () => {
-	const bottomTextNode = footerTextLayout()[1];
-	if (!bottomTextNode) return [];
-	return [when("$root.theme.footer.bottomBar.enabled", {
-		equals: true,
-		not: true
-	})(bottomTextNode)];
-};
-const simpleFooterLayout = stack({
-	gap: "md",
-	align: "start",
-	className: { $bind: {
-		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerSimpleRootClass" }],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-items-start rb-gap-4 rb-py-10 rb-text-left"
-	} }
-}, [
-	link({
-		href: "/",
-		className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{
-				id: "layout.footerLogoClass",
-				options: { requireExplicitShow: true }
-			}],
-			fallback: "rb-hidden"
-		} }
-	}, [
-		media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("content.logo"), bind("content.logo")),
-		stack({ className: "rb-contents" }, [media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-		text({
-			as: "strong",
-			className: "footer-logo-text rb-nav-text"
-		}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-	]),
-	footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "flatten",
-		className: { $bind: {
-			from: "$root.theme.footer.navLayout",
-			transforms: [{ id: "layout.footerSimpleNavClass" }],
-			fallback: "footer-nav rb-flex rb-flex-wrap rb-justify-start rb-gap-x-6 rb-gap-y-3"
-		} },
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-px-4 rb-py-2 rb-nav-text transition-theme-standard"
-	}),
-	...bodyTextLayout(),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "simple" }));
-const columnsFooterLayout = stack({
-	gap: "xl",
-	align: "start",
+const brandLogo = link({
+	href: "/",
 	className: { $bind: {
-		from: "$root.theme.footer.maxWidth",
+		from: "$root.theme.footer.logo",
 		transforms: [{
-			id: "layout.maxWidthClass",
-			options: { base: "rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12" }
+			id: "layout.footerLogoClass",
+			options: { base: "footer-logo rb-inline-flex rb-items-center rb-gap-3 rb-no-underline" }
 		}],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12"
+		fallback: "footer-logo rb-inline-flex rb-items-center rb-gap-3 rb-no-underline"
 	} }
-}, [
-	footerNavGroupsLayout,
-	inline({ className: "rb-flex rb-w-full rb-flex-wrap rb-items-center rb-justify-between rb-gap-4" }, [text({
-		as: "strong",
-		className: "rb-block rb-nav-text",
-		style: textColorStyle("text")
-	}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" })), footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "links-only",
-		className: "rb-flex rb-flex-wrap rb-justify-end rb-gap-x-6 rb-gap-y-3",
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-px-4 rb-py-2 rb-nav-text transition-theme-standard"
-	})]),
-	...bodyTextLayout(),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "columns" }));
-const splitFooterLayout = stack({
-	gap: "xl",
-	align: "start",
+}, [media({ className: { $bind: {
+	from: "$root.theme.footer.logo",
+	transforms: [{
+		id: "layout.footerLogoMediaClass",
+		options: { base: "rb-h-10 rb-w-auto" }
+	}],
+	fallback: "rb-h-10 rb-w-auto"
+} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content.logo")), text({
+	as: "strong",
+	className: "footer-logo-text rb-nav-text"
+}, when("module.showTitle", { equals: true }), bind("site.title", { fallback: "Your Site" }))], when("module.kind", { equals: "brand" }));
+const navigation = stack({
+	gap: "md",
+	className: "rb-w-full"
+}, [footerNavGroupsLayout, footerNav({
+	collectionPath: "footerMenu.items",
+	mode: "links-only",
 	className: { $bind: {
-		from: "$root.theme.footer.maxWidth",
-		transforms: [{
-			id: "layout.maxWidthClass",
-			options: { base: "rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12" }
-		}],
-		fallback: "rb-container rb-flex rb-w-full rb-flex-col rb-gap-10 rb-py-12"
-	} }
+		from: "module.navigationClassName",
+		fallback: "footer-nav rb-flex rb-flex-wrap rb-gap-x-6 rb-gap-y-3"
+	} },
+	linkClassName: "footer-nav-link rb-nav-text transition-theme-standard"
+})], when("module.kind", { equals: "navigation" }));
+const legalNavigation = footerNav({
+	collectionPath: "legalFooterMenu.items",
+	mode: "links-only",
+	className: "rb-flex rb-flex-wrap rb-gap-x-4 rb-gap-y-2",
+	linkClassName: "footer-nav-link rb-caption transition-theme-standard"
+});
+const address = text({
+	as: "address",
+	className: "rb-not-italic rb-opacity-80"
+}, when("module.kind", { equals: "business-address" }), bind("module.address"));
+const contact = stack({
+	gap: "sm",
+	className: "rb-items-start"
+}, [link({
+	href: { $bind: { from: "contactLink.href" } },
+	className: "rb-nav-text rb-break-words transition-theme-standard"
+}, [text({ as: "span" }, bind("contactLink.label"))], repeat("module.contactLinks", "contactLink"))], when("module.kind", { equals: "contact" }));
+const hours = stack({
+	gap: "sm",
+	className: "rb-w-full"
+}, [inline({ className: "rb-flex rb-w-full rb-justify-between rb-gap-4" }, [text({
+	as: "span",
+	className: "rb-label"
+}, bind("hoursDay.weekday")), text({
+	as: "span",
+	className: "rb-caption rb-opacity-80"
+}, bind("hoursDay.hours"))], repeat("module.openingHours", "hoursDay")), text({
+	as: "p",
+	className: "rb-caption rb-opacity-70"
+}, bind("module.timeZone"), when("module.timeZone"))], when("module.kind", { equals: "opening-hours" }));
+const socials = inline({ className: "rb-flex rb-flex-wrap rb-gap-x-5 rb-gap-y-3" }, [link({
+	href: { $bind: { from: "social.href" } },
+	target: "_blank",
+	rel: "noreferrer noopener",
+	"aria-label": { $bind: { from: "social.label" } },
+	className: "rb-nav-text transition-theme-standard"
+}, [icon({ className: "rb-h-5 rb-w-5" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
+const authoredCopy = richText({
+	className: "rb-prose rb-prose-sm rb-max-w-none",
+	style: textColorStyle("text/80")
+}, when("module.content"), bind("module.content", { transforms: [{
+	id: "content.interpolateRichTextTokens",
+	options: { tokens: ["year", "site_name"] }
+}] }));
+const footerGroup = stack({
+	gap: "md",
+	align: "stretch",
+	className: "rb-min-w-0",
+	"data-footer-group": { $bind: { from: "group.kind" } }
+}, [stack({
+	gap: "md",
+	align: "start",
+	"data-preview-footer-module-id": { $bind: { from: "module.id" } }
 }, [
-	inline({ className: { $bind: {
-		from: "$root.theme.footer.logo",
-		transforms: [{ id: "layout.footerSplitMainClass" }],
-		fallback: "rb-flex rb-w-full rb-flex-col rb-items-start rb-justify-between rb-gap-8 rb-md-flex-row rb-md-items-end"
-	} } }, [stack({}, [footerNav({
-		collectionPath: "footerMenu.items",
-		mode: "flatten",
-		className: { $bind: {
-			from: "$root.theme.footer.navLayout",
-			transforms: [{ id: "layout.footerSplitNavSingleClass" }],
-			fallback: "rb-w-full rb-space-y-3 rb-text-left"
-		} },
-		linkClassName: "footer-nav-link rb-inline-flex rb-items-center rb-whitespace-nowrap rb-nav-text transition-theme-standard"
-	})]), link({
-		href: "/",
-		className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoClass" }],
-			fallback: "footer-logo rb-inline-flex rb-items-center rb-justify-end rb-gap-3 rb-self-end rb-no-underline rb-text-right rb-transition-opacity rb-hover-opacity-80"
-		} }
-	}, [
-		media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("content.logo"), bind("content.logo")),
-		stack({ className: "rb-contents" }, [media({ className: { $bind: {
-			from: "$root.theme.footer.logo",
-			transforms: [{ id: "layout.footerLogoMediaClass" }],
-			fallback: "rb-w-auto"
-		} } }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-		text({
-			as: "strong",
-			className: "footer-logo-text rb-nav-text"
-		}, whenTransformed("$root.theme.footer", "layout.footerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-	])]),
-	...businessAddressLayout(),
-	...inlineBottomTextLayout()
-], when("$root.theme.footer.variant", { equals: "split" }));
-const footerLayout = section({
-	background: "background",
+	text({
+		as: "h2",
+		className: "rb-label",
+		style: textColorStyle("text/70")
+	}, bind("module.heading"), when("module.heading")),
+	brandLogo,
+	navigation,
+	stack({
+		gap: "sm",
+		className: "rb-w-full"
+	}, [legalNavigation], when("module.kind", { equals: "legal-navigation" })),
+	address,
+	contact,
+	hours,
+	socials,
+	stack({ className: "rb-w-full" }, [authoredCopy], when("module.kind", { equals: "supporting-text" })),
+	stack({ className: "rb-w-full rb-lg-col-span-3" }, [authoredCopy], when("module.kind", { equals: "legal" }))
+], repeat("group.modules", "module"))], repeat("region.groups", "group"));
+const footerMainRegion = stack({
+	className: { $bind: { from: "region.className" } },
+	"data-footer-region": { $bind: { from: "region.kind" } }
+}, [footerGroup], when("region.kind", { equals: "main" }), repeat("content.footerRuntime.regions", "region"));
+const footerBottomRegion = stack({ className: { $bind: {
+	from: "$root.theme.footer",
+	transforms: [{ id: "layout.footerBottomBarContainerClass" }],
+	fallback: "rb-w-full"
+} } }, [stack({
 	className: { $bind: {
 		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerRootClass" }],
-		fallback: "rb-w-full rb-border-t transition-theme"
+		transforms: [{ id: "layout.footerBottomBarClass" }],
+		fallback: "rb-w-full rb-border-t rb-px-6 rb-py-6 rb-text-center"
 	} },
 	style: { $bind: {
 		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerRootStyle" }],
-		fallback: mergeStyles(backgroundColorStyle("surface"), surfaceForegroundStyle({ text: "rgb(var(--tb-text))" }), borderColorStyle("border"))
-	} }
-}, [
-	simpleFooterLayout,
-	columnsFooterLayout,
-	splitFooterLayout,
-	stack({
-		className: { $bind: {
-			from: "$root.theme.footer",
-			transforms: [{ id: "layout.footerBottomBarClass" }],
-			fallback: "rb-w-full rb-border-t rb-py-5"
-		} },
-		style: { $bind: {
-			from: "$root.theme.footer",
-			transforms: [{ id: "layout.footerBottomBarStyle" }]
-		} }
-	}, [stack({ className: { $bind: {
-		from: "$root.theme.footer",
-		transforms: [{ id: "layout.footerBottomBarContainerClass" }],
-		fallback: "rb-container"
-	} } }, [...bottomBarTextLayout()])], when("$root.theme.footer.bottomBar.enabled", { equals: true }))
-]);
+		transforms: [{ id: "layout.footerBottomBarStyle" }]
+	} },
+	"data-footer-region": "bottom"
+}, [footerGroup])], when("region.kind", { equals: "bottom" }), repeat("content.footerRuntime.regions", "region"));
 const siteFooterBlockDefinition = { manifest: createBlockManifest({
 	id: "block.site-footer",
 	title: "Site Footer",
 	category: "layout",
-	fragments: [{
-		fragment: footerBottomTextFragment,
-		fieldPriority: 0
-	}],
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
-	additionalFields: [{
-		id: "showBusinessAddress",
-		type: "boolean",
-		label: "Add business address to site footer?",
-		required: false,
-		defaultValue: false,
-		ui: { intent: "content" }
-	}],
-	layout: footerLayout,
-	description: "Site-wide footer with navigation links and optional columns.",
+	layout: section({
+		background: "background",
+		className: { $bind: {
+			from: "$root.theme.footer",
+			transforms: [{ id: "layout.footerRootClass" }],
+			fallback: "rb-w-full rb-border-t transition-theme"
+		} },
+		style: { $bind: {
+			from: "$root.theme.footer",
+			transforms: [{ id: "layout.footerRootStyle" }],
+			fallback: mergeStyles(backgroundColorStyle("surface"), surfaceForegroundStyle({ text: "rgb(var(--tb-text))" }), borderColorStyle("border"))
+		} },
+		"data-footer-membership": { $bind: { from: "content.footerRuntime.membershipKey" } }
+	}, [footerMainRegion, footerBottomRegion]),
+	description: "Site-wide composed footer with canonical shared details.",
 	styleTokens: { spacing: "md" },
 	paletteHidden: true
 }) };
@@ -32505,6 +33097,7 @@ const testimonialsBlockDefinition = {
 		id: "block.testimonials",
 		title: "Testimonials",
 		category: "marketing",
+		contentSource: { kind: "inline" },
 		includeContainerStyles: true,
 		previewCustomize: { quickFieldPriority: [
 			"avatarLayout",
@@ -32663,6 +33256,7 @@ const columnsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.columns",
 	title: "Columns",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "equalHeight",
@@ -32849,7 +33443,7 @@ const repeatedItemsNode = repeaterFragmentLayout({
 				id: "boxStyles.all",
 				options: {
 					axis: "all",
-					baseClass: "rb-collection-item rb-relative rb-isolate rb-overflow-hidden rb-border"
+					baseClass: "rb-collection-item rb-relative rb-isolate rb-overflow-visible rb-border"
 				}
 			}]
 		},
@@ -32896,6 +33490,7 @@ const collectionBlockDefinition = { manifest: createBlockManifest({
 	id: "block.collection",
 	title: "Collection",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	additionalFields: [
 		parseFieldDefinition({
 			id: "layout",
@@ -33132,6 +33727,7 @@ const featureCardsBlockDefinition = { manifest: createBlockManifest({
 	id: "block.feature-cards",
 	title: "Feature Cards",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	additionalFields: [
@@ -33515,6 +34111,7 @@ const mediaTextBlockDefinition = { manifest: createBlockManifest({
 	id: "block.media-text",
 	title: "Media and Text",
 	category: "layout",
+	contentSource: { kind: "inline" },
 	includeContainerStyles: true,
 	titleSource: "title",
 	previewCustomize: { quickFieldPriority: [
@@ -33915,6 +34512,7 @@ const appointmentBookingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"booking",
 			"appointment",
@@ -34079,6 +34677,7 @@ const weeklySlotAvailabilityManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "interactive",
+	contentSource: { kind: "inline" },
 	tags: [
 		"booking",
 		"appointment",
@@ -35671,6 +36270,7 @@ const eventRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Multi-step event registration form",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"events",
 			"registration",
@@ -35777,15 +36377,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"
@@ -35798,9 +36392,8 @@ const eventRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -35993,6 +36586,7 @@ const courseRegistrationBlockDefinition = {
 		titleSource: "heading",
 		description: "Enrollment form for multi-session courses",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"courses",
 			"enrollment",
@@ -36106,15 +36700,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"
@@ -36127,9 +36715,8 @@ const courseRegistrationBlockDefinition = {
 						value: "outline",
 						label: "Outline"
 					}
-				],
-				ui: { intent: "style" }
-			}
+				]
+			})
 		],
 		layout: [styledSection({
 			baseClass: "",
@@ -36209,6 +36796,7 @@ const eventDetailsManifest = createBlockManifest({
 	titleSource: "heading",
 	description: "Date/time, venue, map, and other dates for an event",
 	category: "content",
+	contentSource: { kind: "entries" },
 	tags: [
 		"events",
 		"venue",
@@ -36414,6 +37002,7 @@ const courseDetailsBlockDefinition = {
 		titleSource: "heading",
 		description: "Schedule, venue, price, and enrollment status for a course",
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"courses",
 			"schedule",
@@ -36705,6 +37294,7 @@ const eventSpotlightBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "content",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"featured",
@@ -37251,6 +37841,7 @@ const eventListingBlockDefinition = {
 			paletteHidden: true
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"listing",
@@ -38423,6 +39014,7 @@ const eventCalendarBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"events",
 			"calendar",
@@ -38820,6 +39412,7 @@ const recurringScheduleBlockDefinition = {
 		titleSource: "heading",
 		description: "A compact weekly schedule with one row per recurring series.",
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		icon: "CalendarDays",
 		tags: [
 			"schedule",
@@ -39237,7 +39830,10 @@ const offeringsPreviewFields = [
 				label: "Link"
 			}
 		],
-		ui: { intent: "display" }
+		ui: {
+			intent: "display",
+			widget: "buttonVariant"
+		}
 	},
 	{
 		id: "buttonText",
@@ -39290,6 +39886,7 @@ const offeringsPreviewManifest = createBlockManifest({
 		paletteHidden: false
 	},
 	category: "content",
+	contentSource: { kind: "mixed" },
 	tags: [
 		"offerings",
 		"events",
@@ -39458,6 +40055,7 @@ const embedManifest = createBlockManifest({
 	id: "block.embed",
 	title: "Embed Content",
 	category: "content",
+	contentSource: { kind: "entries" },
 	titleSource: "heading",
 	additionalFields: [
 		parseFieldDefinition({
@@ -39945,6 +40543,7 @@ const imageGalleryBlockDefinition = { manifest: createBlockManifest({
 	id: "block.image-gallery",
 	title: "Image Gallery",
 	category: "content",
+	contentSource: { kind: "inline" },
 	previewCustomize: { quickFieldPriority: [
 		"aspectRatio",
 		"slidesToShow",
@@ -40597,6 +41196,7 @@ const videoGridBlockDefinition = { manifest: createBlockManifest({
 	id: "block.video-grid",
 	title: "Video Grid",
 	category: "media",
+	contentSource: { kind: "inline" },
 	skipSectionStyles: true,
 	additionalFields: parseFieldDefinitions([
 		{
@@ -40767,6 +41367,7 @@ const audioPlayerBlockDefinition = { manifest: createBlockManifest({
 	title: "Audio Player",
 	titleSource: "title",
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a branded audio player for a single track.",
 	tags: [
 		"audio",
@@ -40878,6 +41479,7 @@ const fileDownloadBlockDefinition = { manifest: createBlockManifest({
 	title: "File Download",
 	titleSource: ["title", "file.filename"],
 	category: "media",
+	contentSource: { kind: "inline" },
 	description: "Add a simple public download link for a document, ZIP, or audio file.",
 	tags: [
 		"file",
@@ -41822,6 +42424,7 @@ const shopBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"passes",
@@ -42021,6 +42624,7 @@ const productListBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"products",
@@ -42162,6 +42766,7 @@ const productDetailBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"shop",
 			"product",
@@ -42278,6 +42883,7 @@ const cartBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"cart",
@@ -42360,6 +42966,7 @@ const checkoutBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		tags: [
 			"shop",
 			"checkout",
@@ -42563,6 +43170,7 @@ const giftingBlockDefinition = {
 			paletteHidden: false
 		},
 		category: "interactive",
+		contentSource: { kind: "entries" },
 		tags: [
 			"gifting",
 			"gift cards",
@@ -42926,6 +43534,7 @@ const newsletterSignupBlockDefinition = {
 		titleSource: "title",
 		description: "Newsletter subscription form with configurable field presets.",
 		category: "interactive",
+		contentSource: { kind: "inline" },
 		fragments: [{
 			fragment: newsletterCopyFragment,
 			fieldPriority: 0
@@ -43107,6 +43716,7 @@ const teamMembersBlockDefinition = {
 		id: "block.team-members",
 		title: "Team Members",
 		category: "content",
+		contentSource: { kind: "mixed" },
 		titleSource: "heading",
 		additionalFields: [
 			parseFieldDefinition({
@@ -43527,6 +44137,7 @@ const locationMapBlockDefinition = {
 		titleSource: "heading",
 		description: "Show a business location with an interactive map and directions link.",
 		category: "content",
+		contentSource: { kind: "inline" },
 		tags: [
 			"map",
 			"location",
@@ -44642,9 +45253,9 @@ function appendBackgroundMediaClasses(baseClassName, input) {
 	].filter(Boolean).join(" ");
 }
 function gradientPresetCss(value) {
-	if (!isString(value)) return null;
-	const preset = GRADIENT_PRESETS.find((candidate) => candidate.id === value.trim());
-	if (!preset) return null;
+	const presetId = parseGradientPresetId(value);
+	if (!presetId) return null;
+	const preset = getGradientPreset(presetId);
 	return gradientToCss(preset, Object.fromEntries(preset.stops.map((stop) => [stop.color, `rgb(var(--tb-${stop.color}))`])));
 }
 const backgroundTransforms = [
@@ -44683,16 +45294,17 @@ const backgroundTransforms = [
 		run: (value, _options, context) => resolveSurfaceForegroundStyles(value, context)
 	},
 	{
-		id: "background.resolveAllowOverflow",
+		id: "background.resolveFrameClassName",
 		kind: "formatter",
-		summary: "Resolve allowOverflow from background config (explicit overflow or scaled image)",
-		run: (value) => {
-			if (!value || typeof value !== "object") return false;
+		summary: "Resolve clipping on a decorative background frame without clipping foreground content",
+		run: (value, options) => {
+			const baseClass = options?.baseClass?.trim() ?? "";
+			if (!value || typeof value !== "object") return `${baseClass} rb-overflow-hidden`.trim();
 			const input = value;
-			if (input.overflow === true) return true;
+			if (input.overflow === true) return `${baseClass} rb-overflow-visible`.trim();
 			const objectFit = isString(input.objectFit) ? input.objectFit.trim() : null;
 			const scale = isString(input.scale) ? input.scale.trim() : isNumber(input.scale) ? String(input.scale) : null;
-			return Boolean((objectFit === "custom" || objectFit === "original") && scale && scale.trim().length > 0);
+			return `${baseClass} ${Boolean((objectFit === "custom" || objectFit === "original") && scale && scale.trim().length > 0) ? "rb-overflow-visible" : "rb-overflow-hidden"}`.trim();
 		}
 	},
 	{
@@ -45760,6 +46372,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"already_refunded",
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
+		"idempotency_receipt_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -45772,7 +46385,12 @@ const CANONICAL_ADMIN_REFUND_FAILURE_CODES = [
 	"payment_intent_not_found",
 	"stripe_error",
 	"stale_pending_missing_context",
-	"non_refundable_deposit_remaining"
+	"non_refundable_deposit_remaining",
+	"deposit_refund_override_required",
+	"refund_revoke_requires_full_line_refund",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 [...CANONICAL_REFUND_PLANNER_ERROR_CODES];
 //#endregion
@@ -45785,7 +46403,10 @@ const STANDARD_LINE_ITEM_REFUND_INVALID_CODES = [
 	"missing_credit_customer",
 	"deposit_refund_override_required",
 	"refund_revoke_requires_full_line_refund",
-	"unified_order_link_required"
+	"unified_order_link_required",
+	"payment_receipt_not_found",
+	"payment_receipt_not_refundable",
+	"payment_receipt_attribution_required"
 ];
 const EVENT_ATTENDEE_REFUND_INVALID_CODES = ["manual_booking_not_refundable", ...STANDARD_LINE_ITEM_REFUND_INVALID_CODES];
 [...CANONICAL_ADMIN_REFUND_FAILURE_CODES];