@riverbankcms/sdk 0.126.0 → 0.127.0

package/dist/server/components.mjs

@@ -3594,6 +3594,99 @@ function createRichTextDoc(paragraphs) {
 		} : { type: "paragraph" })
 	};
 }
+const PUBLIC_DOWNLOAD_MEDIA_TYPES = [
+	"document",
+	"spreadsheet",
+	"archive",
+	"audio"
+];
+const hotspotSchema$1 = z.object({
+	x: z.number().min(0).max(1),
+	y: z.number().min(0).max(1),
+	radius: z.number().optional()
+});
+const rotationSchema$1 = z.union([
+	z.literal(0),
+	z.literal(90),
+	z.literal(180),
+	z.literal(270)
+]);
+const rectSchema$1 = z.tuple([
+	z.number(),
+	z.number(),
+	z.number(),
+	z.number()
+]);
+const aspectCropSchema$1 = z.object({
+	aspect: z.preprocess((value) => value == null ? void 0 : value, z.string().optional()),
+	rect: z.preprocess((value) => value == null ? void 0 : value, rectSchema$1.optional()),
+	hotspot: z.preprocess((value) => value == null ? void 0 : value, hotspotSchema$1.optional()),
+	rotation: z.preprocess((value) => value == null ? void 0 : value, rotationSchema$1.optional())
+});
+const transformSchema$1 = z.object({
+	aspectCrops: z.preprocess((value) => {
+		if (!value || typeof value !== "object" || Array.isArray(value)) return;
+		return value;
+	}, z.record(z.string(), aspectCropSchema$1.catch({}))).optional(),
+	rect: rectSchema$1.optional(),
+	hotspot: hotspotSchema$1.optional(),
+	rotation: rotationSchema$1.optional()
+});
+const mediaPosterSchema = z.discriminatedUnion("tag", [z.object({
+	tag: z.literal("storage"),
+	assetId: z.string().optional(),
+	storageBucket: z.string().min(1),
+	storagePath: z.string().min(1)
+}), z.object({
+	tag: z.literal("external-src"),
+	assetId: z.string().optional(),
+	src: z.string().url()
+})]);
+const mediaBaseSchema = z.object({
+	purpose: z.string().optional(),
+	placeholder: z.boolean().default(true).optional(),
+	assetId: z.string().optional(),
+	identifier: z.string().optional(),
+	src: z.string().optional(),
+	alt: z.string().optional(),
+	filename: z.string().optional(),
+	mimeType: z.string().optional(),
+	width: z.number().optional(),
+	height: z.number().optional(),
+	storageBucket: z.string().optional(),
+	storagePath: z.string().optional(),
+	poster: mediaPosterSchema.optional(),
+	transform: transformSchema$1.optional()
+});
+/**
+* Canonical identifier carried by media values that are safe to persist.
+* Parsing trims boundary input so downstream writers cannot retain whitespace-only
+* identifiers or independently disagree about normalization.
+*/
+const mediaIdentifierSchema = z.string().trim().min(1).brand();
+const imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
+const videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
+const audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
+const documentMediaSchema = mediaBaseSchema.extend({ type: z.literal("document") });
+const spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z.literal("spreadsheet") });
+const archiveMediaSchema = mediaBaseSchema.extend({ type: z.literal("archive") });
+const mediaSchema$1 = z.discriminatedUnion("type", [
+	imageMediaSchema,
+	videoMediaSchema,
+	audioMediaSchema,
+	documentMediaSchema,
+	spreadsheetMediaSchema,
+	archiveMediaSchema
+]);
+const persistableMediaBaseSchema = mediaBaseSchema.extend({ identifier: mediaIdentifierSchema });
+z.discriminatedUnion("type", [
+	persistableMediaBaseSchema.extend({ type: z.literal("image") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("video") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("audio") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("document") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("spreadsheet") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("archive") })
+]);
 //#endregion
 //#region ../blocks/src/system/manifest/fieldValidation/index.ts
 const TEL_RE = /^[+()0-9\s-]{3,}$/;
@@ -3883,7 +3976,7 @@ function canonicalizeFieldValueForWrite(plan, value) {
 		case "media": {
 			if (!isPlainObject$5(value)) return value;
 			const canonical = { ...value };
-			if (typeof canonical.identifier === "string" && canonical.identifier.trim().length > 0) deleteEnvSpecificKeys(canonical);
+			if (mediaIdentifierSchema.safeParse(canonical.identifier).success) deleteEnvSpecificKeys(canonical);
 			return canonical;
 		}
 		case "group": return canonicalizeObjectForWrite(selectedGroupChildPlans(plan, value), value);
@@ -3978,7 +4071,7 @@ function normalizeObjectChildren(children, value, ctx) {
 function normalizeInlineTextFallbacks(plans, values, ctx) {
 	for (const plan of plans) {
 		if (plan.kind !== "inlineText" || !plan.plainTextFallbackPath) continue;
-		if (!isMissingForPlan(plan, values[plan.fieldId])) continue;
+		if (!isMissingForPlan(plan, values[plan.fieldId]) && !(ctx.allowIncomplete && !parseInlineTextFromUnknown(values[plan.fieldId]).ok)) continue;
 		const fallback = getAtFieldPath(values, plan.plainTextFallbackPath);
 		if (typeof fallback !== "string" || fallback.trim().length === 0) continue;
 		values[plan.fieldId] = normalizeFieldValue(plan, plainTextToInlineText(fallback), ctx);
@@ -4019,7 +4112,7 @@ function validateNormalizedFieldValue(plan, value, ctx) {
 		case "select": return validateSelectPlan(plan, value);
 		case "richText": return isValidRichTextDoc(value) ? [] : [issue(plan, "invalidRichText")];
 		case "inlineText": return validateInlineTextPlan(plan, value);
-		case "media": return isPlainObject$5(value) && typeof value.identifier === "string" && value.identifier.trim().length > 0 && (value.type === void 0 || typeof value.type === "string" && plan.allowedMediaTypes.includes(value.type)) ? [] : [issue(plan, "invalidMedia")];
+		case "media": return isPlainObject$5(value) && mediaIdentifierSchema.safeParse(value.identifier).success && (value.type === void 0 || typeof value.type === "string" && plan.allowedMediaTypes.includes(value.type)) ? [] : [issue(plan, "invalidMedia")];
 		case "link": return linkSchema.safeParse(value).success ? [] : [issue(plan, "invalidLink")];
 		case "repeater": return validateRepeaterPlan(plan, value, ctx);
 		case "group": return validateGroupPlan(plan, value, ctx);
@@ -4738,6 +4831,17 @@ function asAccessibleSurfaceToken(token) {
 	return token;
 }
 //#endregion
+//#region ../theme-core/src/site-styles/lookOptionGroups.ts
+function defineLookOptionGroup(group) {
+	defaultOption(group);
+	return group;
+}
+function defaultOption(group) {
+	const option = group.options.find((candidate) => candidate.id === group.defaultOptionId);
+	if (option) return option;
+	throw new Error(`Look option group "${group.id}" defaults to missing option "${group.defaultOptionId}".`);
+}
+//#endregion
 //#region ../theme-core/src/site-styles/types.ts
 /**
 * Defines a literal-preserving catalog while rejecting top-level extra keys on
@@ -4883,767 +4987,655 @@ function defineBlockDesignCapability(capability) {
 //#region ../theme-core/src/site-styles/appearancePresetResolution.ts
 function assertValidOptionGroups(preset) {
 	preset.optionGroups?.forEach((group) => {
-		if (!group.options.find((option) => option.id === group.selectedOptionId)) throw new Error(`Appearance preset "${preset.id}" option group "${group.id}" selects missing option "${group.selectedOptionId}".`);
+		defineLookOptionGroup(group);
 	});
 }
 function defineBlockAppearancePreset(preset) {
 	assertValidOptionGroups(preset);
 	return preset;
 }
-[...[
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-immersive-image",
-		target: "hero",
-		label: "Immersive image hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		layoutPatches: [{
-			constraints: { layoutVariantKeys: ["micro"] },
-			designPatch: {
-				sectionHeight: "banner",
-				heroTypographyScale: "display"
-			}
-		}],
-		design: {
-			sectionSurface: "hero-image",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			sectionHeight: "hero",
-			heroComposition: "center",
-			heroTypographyScale: "display",
-			imageSurfaceTreatment: { kind: "neutral-wash" }
+//#endregion
+//#region ../theme-core/src/site-styles/blockAppearancePresets.ts
+const brandScrimOptionGroups = [{
+	id: "image-surface-treatment",
+	label: "Treatment",
+	defaultOptionId: "brand-scrim-primary",
+	options: [{
+		id: "brand-scrim-primary",
+		label: "Brand scrim",
+		designPatch: { imageSurfaceTreatment: {
+			kind: "brand-scrim",
+			token: "primary"
+		} }
+	}, {
+		id: "neutral-scrim",
+		label: "Neutral scrim",
+		designPatch: { imageSurfaceTreatment: { kind: "neutral-scrim" } }
+	}]
+}];
+const microBannerLayoutPatches = [{
+	constraints: { layoutVariantKeys: ["micro"] },
+	designPatch: { sectionHeight: "banner" }
+}];
+defineBlockAppearancePreset({
+	id: "hero-immersive-image",
+	target: "hero",
+	label: "Immersive image hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	layoutPatches: [{
+		constraints: { layoutVariantKeys: ["micro"] },
+		designPatch: {
+			sectionHeight: "banner",
+			heroTypographyScale: "display"
 		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-bottom-left-panel",
-		target: "hero",
-		label: "Bottom-left panel hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		optionGroups: [{
-			id: "image-surface-treatment",
-			label: "Treatment",
-			selectedOptionId: "neutral-scrim",
-			options: [{
-				id: "neutral-scrim",
-				label: "Neutral scrim",
-				designPatch: { imageSurfaceTreatment: {
-					kind: "neutral-scrim",
-					intensity: "balanced"
-				} }
-			}, {
-				id: "brand-scrim-primary",
-				label: "Brand scrim",
-				designPatch: { imageSurfaceTreatment: {
-					kind: "brand-scrim",
-					token: "primary",
-					intensity: "balanced"
-				} }
-			}]
-		}],
-		layoutPatches: [{
-			constraints: { layoutVariantKeys: ["micro"] },
-			designPatch: {
-				sectionHeight: "banner",
-				heroTypographyScale: "editorial"
-			}
-		}],
-		design: {
-			sectionSurface: "hero-image",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "none",
-			sectionHeight: "immersive",
-			heroComposition: "bottom-left",
-			heroTypographyScale: "display",
-			imageSurfaceTreatment: {
+	}],
+	design: {
+		sectionSurface: "hero-image",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		sectionHeight: "hero",
+		heroComposition: "center",
+		heroTypographyScale: "display",
+		imageSurfaceTreatment: { kind: "neutral-wash" }
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-bottom-left-panel",
+	target: "hero",
+	label: "Bottom-left panel hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	optionGroups: [{
+		id: "image-surface-treatment",
+		label: "Treatment",
+		defaultOptionId: "neutral-scrim",
+		options: [{
+			id: "neutral-scrim",
+			label: "Neutral scrim",
+			designPatch: { imageSurfaceTreatment: {
 				kind: "neutral-scrim",
 				intensity: "balanced"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-poster-image",
-		target: "hero",
-		label: "Poster image hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		layoutPatches: [{
-			constraints: { layoutVariantKeys: ["micro"] },
-			designPatch: {
-				sectionHeight: "banner",
-				heroTypographyScale: "display"
-			}
-		}],
-		design: {
-			sectionSurface: "hero-image",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			sectionHeight: "immersive",
-			heroComposition: "center",
-			heroTypographyScale: "poster",
-			imageSurfaceTreatment: {
+			} }
+		}, {
+			id: "brand-scrim-primary",
+			label: "Brand scrim",
+			designPatch: { imageSurfaceTreatment: {
 				kind: "brand-scrim",
 				token: "primary",
-				intensity: "strong"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-brand-scrim",
-		target: "hero",
-		label: "Brand scrim image hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		optionGroups: [{
-			id: "image-surface-treatment",
-			label: "Treatment",
-			selectedOptionId: "brand-scrim-primary",
-			options: [{
-				id: "brand-scrim-primary",
-				label: "Brand scrim",
-				designPatch: { imageSurfaceTreatment: {
-					kind: "brand-scrim",
-					token: "primary"
-				} }
-			}, {
-				id: "neutral-scrim",
-				label: "Neutral scrim",
-				designPatch: { imageSurfaceTreatment: { kind: "neutral-scrim" } }
-			}]
-		}],
-		layoutPatches: [{
-			constraints: { layoutVariantKeys: ["micro"] },
-			designPatch: { sectionHeight: "banner" }
-		}],
-		design: {
-			sectionSurface: "hero-image",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			sectionHeight: "immersive",
-			heroComposition: "center",
-			heroTypographyScale: "display",
-			imageSurfaceTreatment: {
-				kind: "brand-scrim",
-				token: "primary"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-brand-scrim-fixed-frame",
-		target: "hero",
-		label: "Fixed-frame brand scrim hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		optionGroups: [{
-			id: "image-surface-treatment",
-			label: "Treatment",
-			selectedOptionId: "brand-scrim-primary",
-			options: [{
-				id: "brand-scrim-primary",
-				label: "Brand scrim",
-				designPatch: { imageSurfaceTreatment: {
-					kind: "brand-scrim",
-					token: "primary"
-				} }
-			}, {
-				id: "neutral-scrim",
-				label: "Neutral scrim",
-				designPatch: { imageSurfaceTreatment: { kind: "neutral-scrim" } }
-			}]
-		}],
-		layoutPatches: [{
-			constraints: { layoutVariantKeys: ["micro"] },
-			designPatch: { sectionHeight: "banner" }
-		}],
-		design: {
-			sectionSurface: "hero-image",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			sectionHeight: "immersive",
-			heroComposition: "center",
-			heroTypographyScale: "display",
-			imageSurfaceTreatment: {
-				kind: "brand-scrim",
-				token: "primary"
-			},
-			imageSurfaceMotion: "fixed-frame",
-			eyebrowTreatment: "accent-pill-bounce"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-brand-depth-expressive",
-		target: "hero",
-		label: "Expressive brand-depth hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["centered", "compact"] },
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			heroComposition: "center",
-			heroTypographyScale: "editorial",
-			eyebrowTreatment: "accent-pill-bounce"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-contained-intro",
-		target: "hero",
-		label: "Contained intro hero",
-		blockKinds: ["block.hero"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: panelFrame("inset"),
-			itemSurface: "none",
-			heroComposition: "center",
-			heroTypographyScale: "editorial"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-split-editorial",
-		target: "hero",
-		label: "Editorial split hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["split"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			heroTypographyScale: "editorial"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-split-brand",
-		target: "hero",
-		label: "Brand split hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["split"] },
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			heroTypographyScale: "display",
-			eyebrowTreatment: "accent-pill-bounce"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-split-soft-panel",
-		target: "hero",
-		label: "Soft panel split hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["split"] },
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "none",
+				intensity: "balanced"
+			} }
+		}]
+	}],
+	layoutPatches: [{
+		constraints: { layoutVariantKeys: ["micro"] },
+		designPatch: {
+			sectionHeight: "banner",
 			heroTypographyScale: "editorial"
 		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "hero-split-accent",
-		target: "hero",
-		label: "Accent split hero",
-		blockKinds: ["block.hero"],
-		constraints: { layoutFamilies: ["split"] },
-		design: {
-			sectionSurface: "accent-band",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "none",
+	}],
+	design: {
+		sectionSurface: "hero-image",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "none",
+		sectionHeight: "immersive",
+		heroComposition: "bottom-left",
+		heroTypographyScale: "display",
+		imageSurfaceTreatment: {
+			kind: "neutral-scrim",
+			intensity: "balanced"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-poster-image",
+	target: "hero",
+	label: "Poster image hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	layoutPatches: [{
+		constraints: { layoutVariantKeys: ["micro"] },
+		designPatch: {
+			sectionHeight: "banner",
 			heroTypographyScale: "display"
 		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "intro-editorial-statement",
-		target: "intro",
-		label: "Editorial intro statement",
-		blockKinds: ["block.intro"],
-		constraints: { layoutVariantKeys: ["centered-copy", "statement-copy"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			composition: {
-				kind: "intro",
-				treatment: "editorial-statement"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "intro-portrait-bio",
-		target: "intro",
-		label: "Portrait and bio",
-		blockKinds: ["block.intro"],
-		constraints: { layoutVariantKeys: ["media-copy"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			composition: {
-				kind: "intro",
-				treatment: "portrait-bio"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-default-cards",
-		target: "offerings",
-		label: "Default offering cards",
-		blockKinds: ["block.offerings-preview"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "default"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-secondary-cards",
-		target: "offerings",
-		label: "Secondary offering cards",
-		blockKinds: ["block.offerings-preview"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: plainFrame,
-			itemSurface: "inset"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-non-carded",
-		target: "offerings",
-		label: "Non-carded offerings",
-		blockKinds: ["block.offerings-preview"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: plainFrame,
-			itemSurface: "editorial"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-paired-feature-cards",
-		target: "offerings",
-		label: "Paired feature cards",
-		blockKinds: ["block.offerings-preview"],
-		constraints: { layoutVariantKeys: ["cards"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-open-editorial-columns",
-		target: "offerings",
-		label: "Open editorial columns",
-		blockKinds: ["block.offerings-preview"],
-		constraints: { layoutVariantKeys: ["cards"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "offerings-preview-joined-programme-panel",
-		target: "offerings",
-		label: "Joined programme panel",
-		blockKinds: ["block.offerings-preview"],
-		constraints: { layoutVariantKeys: ["cards"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-raised-rule",
-		target: "feature-cards",
-		label: "Raised cards with rule",
-		blockKinds: ["block.feature-cards"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "raised"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-bold-colors",
-		target: "feature-cards",
-		label: "Bold colour-blocked cards",
-		blockKinds: ["block.feature-cards"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "color-blocked"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-editorial-columns",
-		target: "feature-cards",
-		label: "Editorial open columns",
-		blockKinds: ["block.feature-cards"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "editorial"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-asymmetric-emphasis",
-		target: "feature-cards",
-		label: "Asymmetric emphasis pair",
-		blockKinds: ["block.feature-cards"],
-		constraints: { layoutFamilies: ["grid"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			composition: {
-				kind: "feature-cards",
-				treatment: "asymmetric-emphasis"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-framed-programme",
-		target: "feature-cards",
-		label: "Framed programme cards",
-		blockKinds: ["block.feature-cards"],
-		constraints: { layoutFamilies: ["grid"] },
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "inset",
-			composition: {
-				kind: "feature-cards",
-				treatment: "framed-programme"
-			}
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-soft-panels",
-		target: "feature-cards",
-		label: "Soft tinted panels",
-		blockKinds: ["block.feature-cards"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "inset"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-editorial-diptych",
-		target: "feature-cards",
-		label: "Editorial diptych",
-		blockKinds: ["block.feature-cards"],
-		constraints: { layoutVariantKeys: ["editorial-diptych"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "flat"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-editorial-pathways",
-		target: "feature-cards",
-		label: "Editorial pathways",
-		blockKinds: ["block.feature-cards"],
-		constraints: { layoutVariantKeys: ["editorial-pathways"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "flat"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "feature-cards-photo-tiles",
-		target: "feature-cards",
-		label: "Photo tiles",
-		blockKinds: ["block.feature-cards"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "raised"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "events-lined-panel",
-		target: "events",
-		label: "Raised event panel",
-		blockKinds: ["block.event-calendar", "block.event-listing"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "events-ruled-register",
-		target: "events",
-		label: "Ruled event register",
-		blockKinds: ["block.event-calendar", "block.event-listing"],
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			eventListTreatment: "ruled-register"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "events-editorial-register",
-		target: "events",
-		label: "Editorial event register",
-		blockKinds: ["block.event-calendar", "block.event-listing"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			eventListTreatment: "editorial-register"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "events-dense-index",
-		target: "events",
-		label: "Dense event index",
-		blockKinds: ["block.event-calendar", "block.event-listing"],
-		design: {
-			sectionSurface: "accent-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			eventListTreatment: "dense-index"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "schedule-details-brand-depth",
-		target: "events",
-		label: "Brand-depth schedule details",
-		blockKinds: ["block.event-details", "block.course-details"],
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			tileTreatment: "brand-depth"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "media-text-flush-feature",
-		target: "media-text",
-		label: "Flush media feature",
-		blockKinds: ["block.media-text"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: flushPanelFrame({ bleed: "start" }),
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-simple-cards",
-		target: "testimonials",
-		label: "Simple testimonial cards",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "default"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-raised-panel",
-		target: "testimonials",
-		label: "Raised testimonial panel",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "raised"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-accent-panel",
-		target: "testimonials",
-		label: "Accent testimonial panel",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "accent-band",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "raised"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-default-cards",
-		target: "testimonials",
-		label: "Default cards",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			testimonialCardTreatment: "default"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-statement-cards",
-		target: "testimonials",
-		label: "Statement cards",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "accent-band",
-			contentFrame: plainFrame,
-			itemSurface: "raised",
-			testimonialCardTreatment: "statement"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-brand-statement-cards",
-		target: "testimonials",
-		label: "Brand statement cards",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "brand-depth-band",
-			contentFrame: plainFrame,
-			itemSurface: "raised",
-			testimonialCardTreatment: "statement"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-non-carded",
-		target: "testimonials",
-		label: "Non-carded",
-		blockKinds: ["block.testimonials"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			testimonialCardTreatment: "non-carded"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-evergreen-lead",
-		target: "testimonials",
-		label: "Evergreen lead",
-		blockKinds: ["block.testimonials"],
-		constraints: { layoutVariantKeys: ["featured-editorial"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-room-and-response",
-		target: "testimonials",
-		label: "Room and response",
-		blockKinds: ["block.testimonials"],
-		constraints: { layoutVariantKeys: ["featured-editorial"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "testimonials-open-floor",
-		target: "testimonials",
-		label: "Open floor",
-		blockKinds: ["block.testimonials"],
-		constraints: { layoutVariantKeys: ["featured-editorial"] },
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "faq-base-accordion",
-		target: "faq",
-		label: "Base accordion FAQ",
-		blockKinds: ["block.faq"],
-		design: {
-			sectionSurface: "base",
-			contentFrame: plainFrame,
-			itemSurface: "default"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "faq-contained-help",
-		target: "faq",
-		label: "Contained help panel",
-		blockKinds: ["block.faq"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: panelFrame("inset"),
-			itemSurface: "default"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "contact-form-panel",
-		target: "contact-form",
-		label: "Raised form panel",
-		blockKinds: ["block.form"],
-		design: {
-			sectionSurface: "muted-band",
-			contentFrame: panelFrame("raised"),
-			itemSurface: "none"
-		}
-	}),
-	defineBlockAppearancePreset({
-		kind: "block-design",
-		id: "cta-accent-band",
-		target: "cta",
-		label: "Accent CTA band",
-		blockKinds: ["block.cta-full"],
-		design: {
-			sectionSurface: "accent-band",
-			contentFrame: plainFrame,
-			itemSurface: "none",
-			eyebrowTreatment: "accent"
-		}
-	})
-]];
+	}],
+	design: {
+		sectionSurface: "hero-image",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		sectionHeight: "immersive",
+		heroComposition: "center",
+		heroTypographyScale: "poster",
+		imageSurfaceTreatment: {
+			kind: "brand-scrim",
+			token: "primary",
+			intensity: "strong"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-brand-scrim",
+	target: "hero",
+	label: "Brand scrim image hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	optionGroups: brandScrimOptionGroups,
+	layoutPatches: microBannerLayoutPatches,
+	design: {
+		sectionSurface: "hero-image",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		sectionHeight: "immersive",
+		heroComposition: "center",
+		heroTypographyScale: "display",
+		imageSurfaceTreatment: {
+			kind: "brand-scrim",
+			token: "primary"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-brand-scrim-fixed-frame",
+	target: "hero",
+	label: "Fixed-frame brand scrim hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	optionGroups: brandScrimOptionGroups,
+	layoutPatches: microBannerLayoutPatches,
+	design: {
+		sectionSurface: "hero-image",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		sectionHeight: "immersive",
+		heroComposition: "center",
+		heroTypographyScale: "display",
+		imageSurfaceTreatment: {
+			kind: "brand-scrim",
+			token: "primary"
+		},
+		imageSurfaceMotion: "fixed-frame",
+		eyebrowTreatment: "accent-pill-bounce"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-brand-depth-expressive",
+	target: "hero",
+	label: "Expressive brand-depth hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["centered", "compact"] },
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		heroComposition: "center",
+		heroTypographyScale: "editorial",
+		eyebrowTreatment: "accent-pill-bounce"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-contained-intro",
+	target: "hero",
+	label: "Contained intro hero",
+	blockKinds: ["block.hero"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: panelFrame("inset"),
+		itemSurface: "none",
+		heroComposition: "center",
+		heroTypographyScale: "editorial"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-split-editorial",
+	target: "hero",
+	label: "Editorial split hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["split"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		heroTypographyScale: "editorial"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-split-brand",
+	target: "hero",
+	label: "Brand split hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["split"] },
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		heroTypographyScale: "display",
+		eyebrowTreatment: "accent-pill-bounce"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-split-soft-panel",
+	target: "hero",
+	label: "Soft panel split hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["split"] },
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "none",
+		heroTypographyScale: "editorial"
+	}
+}), defineBlockAppearancePreset({
+	id: "hero-split-accent",
+	target: "hero",
+	label: "Accent split hero",
+	blockKinds: ["block.hero"],
+	constraints: { layoutFamilies: ["split"] },
+	design: {
+		sectionSurface: "accent-band",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "none",
+		heroTypographyScale: "display"
+	}
+}), defineBlockAppearancePreset({
+	id: "intro-editorial-statement",
+	target: "intro",
+	label: "Editorial intro statement",
+	blockKinds: ["block.intro"],
+	constraints: { layoutVariantKeys: ["centered-copy", "statement-copy"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		composition: {
+			kind: "intro",
+			treatment: "editorial-statement"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "intro-portrait-bio",
+	target: "intro",
+	label: "Portrait and bio",
+	blockKinds: ["block.intro"],
+	constraints: { layoutVariantKeys: ["media-copy"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		composition: {
+			kind: "intro",
+			treatment: "portrait-bio"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-default-cards",
+	target: "offerings",
+	label: "Default offering cards",
+	blockKinds: ["block.offerings-preview"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "default"
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-secondary-cards",
+	target: "offerings",
+	label: "Secondary offering cards",
+	blockKinds: ["block.offerings-preview"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: plainFrame,
+		itemSurface: "inset"
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-non-carded",
+	target: "offerings",
+	label: "Non-carded offerings",
+	blockKinds: ["block.offerings-preview"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: plainFrame,
+		itemSurface: "editorial"
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-paired-feature-cards",
+	target: "offerings",
+	label: "Paired feature cards",
+	blockKinds: ["block.offerings-preview"],
+	constraints: { layoutVariantKeys: ["cards"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-open-editorial-columns",
+	target: "offerings",
+	label: "Open editorial columns",
+	blockKinds: ["block.offerings-preview"],
+	constraints: { layoutVariantKeys: ["cards"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "offerings-preview-joined-programme-panel",
+	target: "offerings",
+	label: "Joined programme panel",
+	blockKinds: ["block.offerings-preview"],
+	constraints: { layoutVariantKeys: ["cards"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-raised-rule",
+	target: "feature-cards",
+	label: "Raised cards with rule",
+	blockKinds: ["block.feature-cards"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "raised"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-bold-colors",
+	target: "feature-cards",
+	label: "Bold colour-blocked cards",
+	blockKinds: ["block.feature-cards"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "color-blocked"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-editorial-columns",
+	target: "feature-cards",
+	label: "Editorial open columns",
+	blockKinds: ["block.feature-cards"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "editorial"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-asymmetric-emphasis",
+	target: "feature-cards",
+	label: "Asymmetric emphasis pair",
+	blockKinds: ["block.feature-cards"],
+	constraints: { layoutFamilies: ["grid"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		composition: {
+			kind: "feature-cards",
+			treatment: "asymmetric-emphasis"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-framed-programme",
+	target: "feature-cards",
+	label: "Framed programme cards",
+	blockKinds: ["block.feature-cards"],
+	constraints: { layoutFamilies: ["grid"] },
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "inset",
+		composition: {
+			kind: "feature-cards",
+			treatment: "framed-programme"
+		}
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-soft-panels",
+	target: "feature-cards",
+	label: "Soft tinted panels",
+	blockKinds: ["block.feature-cards"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "inset"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-editorial-diptych",
+	target: "feature-cards",
+	label: "Editorial diptych",
+	blockKinds: ["block.feature-cards"],
+	constraints: { layoutVariantKeys: ["editorial-diptych"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "flat"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-editorial-pathways",
+	target: "feature-cards",
+	label: "Editorial pathways",
+	blockKinds: ["block.feature-cards"],
+	constraints: { layoutVariantKeys: ["editorial-pathways"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "flat"
+	}
+}), defineBlockAppearancePreset({
+	id: "feature-cards-photo-tiles",
+	target: "feature-cards",
+	label: "Photo tiles",
+	blockKinds: ["block.feature-cards"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "raised"
+	}
+}), defineBlockAppearancePreset({
+	id: "events-lined-panel",
+	target: "events",
+	label: "Raised event panel",
+	blockKinds: ["block.event-calendar", "block.event-listing"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "events-ruled-register",
+	target: "events",
+	label: "Ruled event register",
+	blockKinds: ["block.event-calendar", "block.event-listing"],
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		eventListTreatment: "ruled-register"
+	}
+}), defineBlockAppearancePreset({
+	id: "events-editorial-register",
+	target: "events",
+	label: "Editorial event register",
+	blockKinds: ["block.event-calendar", "block.event-listing"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		eventListTreatment: "editorial-register"
+	}
+}), defineBlockAppearancePreset({
+	id: "events-dense-index",
+	target: "events",
+	label: "Dense event index",
+	blockKinds: ["block.event-calendar", "block.event-listing"],
+	design: {
+		sectionSurface: "accent-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		eventListTreatment: "dense-index"
+	}
+}), defineBlockAppearancePreset({
+	id: "schedule-details-brand-depth",
+	target: "events",
+	label: "Brand-depth schedule details",
+	blockKinds: ["block.event-details", "block.course-details"],
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		tileTreatment: "brand-depth"
+	}
+}), defineBlockAppearancePreset({
+	id: "media-text-flush-feature",
+	target: "media-text",
+	label: "Flush media feature",
+	blockKinds: ["block.media-text"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: flushPanelFrame({ bleed: "start" }),
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-simple-cards",
+	target: "testimonials",
+	label: "Simple testimonial cards",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "default"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-raised-panel",
+	target: "testimonials",
+	label: "Raised testimonial panel",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "raised"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-accent-panel",
+	target: "testimonials",
+	label: "Accent testimonial panel",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "accent-band",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "raised"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-default-cards",
+	target: "testimonials",
+	label: "Default cards",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		testimonialCardTreatment: "default"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-statement-cards",
+	target: "testimonials",
+	label: "Statement cards",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "accent-band",
+		contentFrame: plainFrame,
+		itemSurface: "raised",
+		testimonialCardTreatment: "statement"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-brand-statement-cards",
+	target: "testimonials",
+	label: "Brand statement cards",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "brand-depth-band",
+		contentFrame: plainFrame,
+		itemSurface: "raised",
+		testimonialCardTreatment: "statement"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-non-carded",
+	target: "testimonials",
+	label: "Non-carded",
+	blockKinds: ["block.testimonials"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		testimonialCardTreatment: "non-carded"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-evergreen-lead",
+	target: "testimonials",
+	label: "Evergreen lead",
+	blockKinds: ["block.testimonials"],
+	constraints: { layoutVariantKeys: ["featured-editorial"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-room-and-response",
+	target: "testimonials",
+	label: "Room and response",
+	blockKinds: ["block.testimonials"],
+	constraints: { layoutVariantKeys: ["featured-editorial"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "testimonials-open-floor",
+	target: "testimonials",
+	label: "Open floor",
+	blockKinds: ["block.testimonials"],
+	constraints: { layoutVariantKeys: ["featured-editorial"] },
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "faq-base-accordion",
+	target: "faq",
+	label: "Base accordion FAQ",
+	blockKinds: ["block.faq"],
+	design: {
+		sectionSurface: "base",
+		contentFrame: plainFrame,
+		itemSurface: "default"
+	}
+}), defineBlockAppearancePreset({
+	id: "faq-contained-help",
+	target: "faq",
+	label: "Contained help panel",
+	blockKinds: ["block.faq"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: panelFrame("inset"),
+		itemSurface: "default"
+	}
+}), defineBlockAppearancePreset({
+	id: "contact-form-panel",
+	target: "contact-form",
+	label: "Raised form panel",
+	blockKinds: ["block.form"],
+	design: {
+		sectionSurface: "muted-band",
+		contentFrame: panelFrame("raised"),
+		itemSurface: "none"
+	}
+}), defineBlockAppearancePreset({
+	id: "cta-accent-band",
+	target: "cta",
+	label: "Accent CTA band",
+	blockKinds: ["block.cta-full"],
+	design: {
+		sectionSurface: "accent-band",
+		contentFrame: plainFrame,
+		itemSurface: "none",
+		eyebrowTreatment: "accent"
+	}
+});
 //#endregion
 //#region ../theme-core/src/site-styles/headerCtaVariants.ts
 function hasButtonVariant(theme, variantId) {
@@ -7157,7 +7149,7 @@ function canonicalPaletteHashInput(colors, mode) {
 	return `${mode}|${paletteColorFingerprint(colors)}`;
 }
 /**
-* The shared TypeScript/SQL protocol. Do not reorder roles: the order comes
+* Stable curated-catalogue identity. Do not reorder roles: the order comes
 * from PALETTE_TOKEN_NAMES through canonicalPaletteHashInput.
 */
 function paletteValueKey(colors, mode) {
@@ -8727,6 +8719,32 @@ function parseBackgroundAppearanceColorToken(value) {
 function uniqueStrings(values) {
 	return Array.from(new Set(values));
 }
+const headerInteractionPaletteSchema = z$1.enum([
+	"primary",
+	"secondary",
+	"accent"
+]);
+//#endregion
+//#region ../theme-core/src/site-styles/headerInteractionPalette.ts
+const clearSplitInteractionPalette = defineLookOptionGroup({
+	id: "interaction-palette",
+	label: "Hover colour",
+	defaultOptionId: "accent",
+	options: [
+		{
+			id: "accent",
+			label: "Accent"
+		},
+		{
+			id: "primary",
+			label: "Primary"
+		},
+		{
+			id: "secondary",
+			label: "Secondary"
+		}
+	]
+});
 //#endregion
 //#region ../theme-core/src/site-styles/logoBranding.ts
 const logoTextConfidenceValues = [
@@ -8949,7 +8967,7 @@ const overlayLogoAccommodations = [
 * optional nested styling fields that would otherwise leak from another Look.
 */
 function baseHeader(theme) {
-	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;
+	const { navLinkStyle: _navLinkStyle, navFontRole: _navFontRole, navTypography: _navTypography, navTextSize: _navTextSize, interactionPalette: _interactionPalette, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
 	return {
 		...header,
 		navContainer: {
@@ -8964,7 +8982,6 @@ const headerLayoutCatalog = defineExactCatalog()([
 		id: asHeaderLayoutId("classic"),
 		label: "Classic",
 		description: "Logo and navigation in one practical horizontal row.",
-		structure: "inline-classic",
 		variant: "classic",
 		defaultPositioning: "sticky",
 		shrinkOnScroll: false
@@ -8973,7 +8990,6 @@ const headerLayoutCatalog = defineExactCatalog()([
 		id: asHeaderLayoutId("centered"),
 		label: "Centered",
 		description: "Logo centered above a balanced navigation row.",
-		structure: "centered-stack",
 		variant: "centered",
 		defaultPositioning: "static",
 		shrinkOnScroll: false,
@@ -8989,7 +9005,6 @@ const headerLayoutCatalog = defineExactCatalog()([
 		id: asHeaderLayoutId("floating"),
 		label: "Floating",
 		description: "Detached header chrome that sits over the opening section.",
-		structure: "floating-shell",
 		variant: "floating",
 		defaultPositioning: "sticky",
 		shrinkOnScroll: true,
@@ -9151,10 +9166,13 @@ const headerStyleCatalog = defineExactCatalog()([
 		label: "Clear Split",
 		description: "Floating logo with transparent navigation and no shared shell.",
 		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "color-change",
+		navInteraction: "pill-background",
 		surface: "floating",
-		defaultDepth: "none",
+		defaultDepth: "line",
 		navTypography: "plain",
+		openingForegroundTarget: "all",
+		scrollTreatment: "contrast-glass",
+		interactionPalette: clearSplitInteractionPalette,
 		moods: ["editorial", "calm"]
 	},
 	{
@@ -9177,6 +9195,7 @@ const headerStyleCatalog = defineExactCatalog()([
 		surface: "floating",
 		defaultDepth: "shadow",
 		navTypography: "quiet-caps",
+		openingForegroundTarget: "brand-only",
 		moods: ["expressive"]
 	},
 	{
@@ -9188,6 +9207,7 @@ const headerStyleCatalog = defineExactCatalog()([
 		surface: "floating",
 		defaultDepth: "shadow",
 		navTypography: "heading",
+		openingForegroundTarget: "brand-only",
 		moods: ["calm", "editorial"]
 	}
 ]);
@@ -9689,13 +9709,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("clean-base"),
 		label: "Clean base",
-		visualTreatment: "solid-neutral",
-		layoutBehavior: "sticky",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "solid-neutral",
-			behavior: "sticky"
-		},
 		openingRequirement: "none",
 		logoAccommodations: inlineClassicLogoAccommodations,
 		compile: cleanBaseHeader
@@ -9703,13 +9716,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("classic-centered-nav"),
 		label: "Centered nav",
-		visualTreatment: "solid-neutral",
-		layoutBehavior: "sticky",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "solid-neutral",
-			behavior: "sticky"
-		},
 		openingRequirement: "none",
 		maxRecommendedNavItems: 6,
 		logoAccommodations: inlineClassicLogoAccommodations,
@@ -9718,13 +9724,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("brand-solid"),
 		label: "Brand solid",
-		visualTreatment: "solid-brand",
-		layoutBehavior: "sticky-shrink",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "solid-brand",
-			behavior: "sticky-shrink"
-		},
 		openingRequirement: "none",
 		logoAccommodations: inlineClassicLogoAccommodations,
 		compile: solidBrandHeader
@@ -9732,13 +9731,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("serif-line"),
 		label: "Serif line",
-		visualTreatment: "light-serif",
-		layoutBehavior: "sticky",
-		configuration: {
-			structure: "centered-stack",
-			treatment: "light-serif",
-			behavior: "sticky"
-		},
 		openingRequirement: "none",
 		maxRecommendedNavItems: 6,
 		logoAccommodations: centeredLogoAccommodations,
@@ -9747,13 +9739,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("centered-calm"),
 		label: "Centered calm",
-		visualTreatment: "light-serif",
-		layoutBehavior: "normal-flow",
-		configuration: {
-			structure: "centered-stack",
-			treatment: "light-serif",
-			behavior: "normal-flow"
-		},
 		openingRequirement: "none",
 		maxRecommendedNavItems: 5,
 		logoAccommodations: centeredLogoAccommodations,
@@ -9762,13 +9747,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("practical-utility"),
 		label: "Practical utility",
-		visualTreatment: "solid-neutral",
-		layoutBehavior: "sticky-shrink",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "solid-neutral",
-			behavior: "sticky-shrink"
-		},
 		openingRequirement: "none",
 		requiresProminentCta: true,
 		logoAccommodations: inlineClassicLogoAccommodations,
@@ -9777,13 +9755,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("minimal-transparent"),
 		label: "Minimal transparent",
-		visualTreatment: "minimal-transparent",
-		layoutBehavior: "normal-flow",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "minimal-transparent",
-			behavior: "normal-flow"
-		},
 		openingRequirement: "reserved-space-ok",
 		logoAccommodations: inlineClassicLogoAccommodations,
 		compile: minimalTransparentHeader
@@ -9791,13 +9762,6 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("transparent-overlay"),
 		label: "Transparent overlay",
-		visualTreatment: "transparent-overlay",
-		layoutBehavior: "fixed-overlay",
-		configuration: {
-			structure: "inline-classic",
-			treatment: "transparent-overlay",
-			behavior: "fixed-overlay"
-		},
 		openingRequirement: "requires-image-hero-with-contrast-overlay",
 		maxRecommendedNavItems: 5,
 		logoAccommodations: overlayLogoAccommodations,
@@ -9806,24 +9770,13 @@ const headerLookCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLookId("floating-glass"),
 		label: "Floating glass",
-		visualTreatment: "floating-glass",
-		layoutBehavior: "fixed-floating",
-		configuration: {
-			structure: "floating-shell",
-			treatment: "floating-glass",
-			behavior: "fixed-floating"
-		},
 		openingRequirement: "requires-image-hero-with-contrast-overlay",
 		maxRecommendedNavItems: 5,
 		logoAccommodations: overlayLogoAccommodations,
 		compile: floatingGlassHeader
 	}
 ]);
-new Set(headerLookCatalog.map((look) => headerConfigurationKey(look.configuration)));
 new Map(headerLookCatalog.map((look) => [look.id, look]));
-function headerConfigurationKey(configuration) {
-	return `${configuration.structure}:${configuration.treatment}:${configuration.behavior}`;
-}
 //#endregion
 //#region ../theme-core/src/site-styles/sectionTransitions.ts
 function boundaryRuntimeMetrics(family, size, heightExpression) {
@@ -10027,8 +9980,6 @@ const VARIANT_ROLES = [
 	"secondary",
 	"outline",
 	"ghost",
-	"link",
-	"tertiary",
 	"accent"
 ];
 function isVariantRole(value) {
@@ -10040,7 +9991,7 @@ function isVariantRole(value) {
 * IDs become class selectors, so keep the contract deliberately narrower than
 * an arbitrary string and shared with every authoring/runtime boundary.
 */
-const buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only");
+const buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only").refine((value) => value !== "link" && value !== "tertiary", { message: "Retired button role IDs are not valid variant IDs" });
 function asSpecialVariantId(value) {
 	const parsed = buttonVariantIdSchema.safeParse(value);
 	if (!parsed.success) throw new Error("SpecialVariantId must be a CSS-safe button variant ID");
@@ -13231,39 +13182,39 @@ function defaultTypographyForRecipe(recipe) {
 }
 //#endregion
 //#region ../theme-core/src/lib/media.ts
-const hotspotSchema$1 = z.object({
+const hotspotSchema = z.object({
 	x: z.number().min(0).max(1),
 	y: z.number().min(0).max(1),
 	radius: z.number().optional()
 });
-const rotationSchema$1 = z.union([
+const rotationSchema = z.union([
 	z.literal(0),
 	z.literal(90),
 	z.literal(180),
 	z.literal(270)
 ]);
-const rectSchema$1 = z.tuple([
+const rectSchema = z.tuple([
 	z.number(),
 	z.number(),
 	z.number(),
 	z.number()
 ]);
-const aspectCropSchema$1 = z.object({
+const aspectCropSchema = z.object({
 	aspect: z.preprocess((value) => value == null ? void 0 : value, z.string().optional()),
-	rect: z.preprocess((value) => value == null ? void 0 : value, rectSchema$1.optional()),
-	hotspot: z.preprocess((value) => value == null ? void 0 : value, hotspotSchema$1.optional()),
-	rotation: z.preprocess((value) => value == null ? void 0 : value, rotationSchema$1.optional())
+	rect: z.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
+	hotspot: z.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
+	rotation: z.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
 });
-const transformSchema$1 = z.object({
+const transformSchema = z.object({
 	aspectCrops: z.preprocess((value) => {
 		if (!value || typeof value !== "object" || Array.isArray(value)) return;
 		return value;
-	}, z.record(z.string(), aspectCropSchema$1.catch({}))).optional(),
-	rect: rectSchema$1.optional(),
-	hotspot: hotspotSchema$1.optional(),
-	rotation: rotationSchema$1.optional()
+	}, z.record(z.string(), aspectCropSchema.catch({}))).optional(),
+	rect: rectSchema.optional(),
+	hotspot: hotspotSchema.optional(),
+	rotation: rotationSchema.optional()
 });
-const mediaSchema$1 = z.object({
+const mediaSchema = z.object({
 	type: z.enum([
 		"image",
 		"video",
@@ -13284,7 +13235,7 @@ const mediaSchema$1 = z.object({
 	height: z.number().optional(),
 	storageBucket: z.string().optional(),
 	storagePath: z.string().optional(),
-	transform: transformSchema$1.optional()
+	transform: transformSchema.optional()
 });
 //#endregion
 //#region ../theme-core/src/palette/schema.ts
@@ -14117,264 +14068,6 @@ function generateInteractiveChildInheritanceCSS(selector) {
 	return `\n${selector} * {\n  font-family: inherit;\n  font-weight: inherit;\n  font-style: inherit;\n  letter-spacing: inherit;\n  text-transform: inherit;\n  color: inherit;\n}\n`;
 }
 //#endregion
-//#region ../theme-core/src/buttons/effects/presets/background.ts
-/**
-* Darken background on hover
-*
-* Works with solid backgrounds only. Darkens the background color by adjusting the shade.
-*/
-const darkenBackgroundEffect = {
-	id: "darken-background",
-	name: "Darken on Hover",
-	description: "Darkens the background color on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["button"],
-	customizableOption: {
-		name: "amount",
-		type: "select",
-		label: "Darken Amount (shade step)",
-		default: 100,
-		options: [
-			0,
-			100,
-			200,
-			300,
-			400,
-			500,
-			600,
-			700,
-			800,
-			900
-		]
-	},
-	isApplicable: (buttonConfig) => {
-		return buttonConfig.background.type === "solid";
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options, tokens, buttonConfig } = ctx;
-		if (buttonConfig.background.type !== "solid") return "";
-		const amount = options.amount || 100;
-		const baseToken = buttonConfig.background.colorToken ?? "primary-500";
-		const darkerToken = tokens.adjustShade(baseToken, amount);
-		return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${tokens.getColor(darkerToken)};
-      }
-    `;
-	}
-};
-/**
-* Lighten background on hover
-*
-* Works with solid backgrounds only. Lightens the background color by adjusting the shade.
-*/
-const lightenBackgroundEffect = {
-	id: "lighten-background",
-	name: "Lighten on Hover",
-	description: "Lightens the background color on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["button"],
-	customizableOption: {
-		name: "amount",
-		type: "select",
-		label: "Lighten Amount (shade step)",
-		default: 100,
-		options: [
-			0,
-			100,
-			200,
-			300,
-			400,
-			500,
-			600,
-			700,
-			800,
-			900
-		]
-	},
-	isApplicable: (buttonConfig) => {
-		return buttonConfig.background.type === "solid";
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options, tokens, buttonConfig } = ctx;
-		if (buttonConfig.background.type !== "solid") return "";
-		const amount = options.amount || 100;
-		const baseToken = buttonConfig.background.colorToken ?? "primary-500";
-		const lighterToken = tokens.adjustShade(baseToken, -amount);
-		return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${tokens.getColor(lighterToken)};
-      }
-    `;
-	}
-};
-/**
-* Fade background on hover (reduce opacity)
-*
-* Works with all background types.
-*/
-const fadeBackgroundEffect = {
-	id: "fade-background",
-	name: "Fade on Hover",
-	description: "Reduces background opacity on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["nav-link"],
-	customizableOption: {
-		name: "opacity",
-		type: "percentage",
-		label: "Hover Opacity",
-		default: 80
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options } = ctx;
-		return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        opacity: ${(options.opacity || 80) / 100};
-      }
-    `;
-	}
-};
-/**
-* Reduce opacity on hover (simple opacity reduction)
-*
-* Navigation-link effect that reduces opacity by a percentage (default 15%).
-*/
-const opacityReduceEffect = {
-	id: "opacity-reduce",
-	name: "Reduce Opacity",
-	description: "Reduces navigation-link opacity on hover by a percentage",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["nav-link"],
-	customizableOption: {
-		name: "reduction",
-		type: "percentage",
-		label: "Opacity Reduction",
-		default: 15
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options } = ctx;
-		return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        opacity: ${1 - (options.reduction || 15) / 100};
-      }
-    `;
-	}
-};
-/**
-* Animated gradient background
-*
-* Animates a gradient background by shifting its position on hover.
-* Works with gradient backgrounds only.
-*
-* Sets background-size to 200% and animates background-position from left to right.
-*/
-const animatedGradientEffect = {
-	id: "animated-gradient",
-	name: "Animated Gradient",
-	description: "Animates gradient position on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["button"],
-	customizableOption: {
-		name: "direction",
-		type: "select",
-		label: "Animation Direction",
-		default: "horizontal",
-		options: ["horizontal", "vertical"]
-	},
-	isApplicable: (buttonConfig) => {
-		return buttonConfig.background.type === "gradient";
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options, buttonConfig } = ctx;
-		if (buttonConfig.background.type !== "gradient") return "";
-		const direction = options.direction || "horizontal";
-		return `
-      /* Setup animated gradient */
-      :where([data-theme-scope="${themeId}"]) .${variantId} {
-        background-size: ${direction === "horizontal" ? "200% auto" : "auto 200%"};
-        background-position: left center;
-        transition: background-position 0.3s ease;
-      }
-
-      /* Animate gradient on hover */
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-position: ${direction === "horizontal" ? "right center" : "center bottom"};
-      }
-    `;
-	}
-};
-/**
-* Add background color on hover
-*
-* Works best with transparent backgrounds. Adds a solid background color on hover.
-*/
-const backgroundOnHoverEffect = {
-	id: "background-on-hover",
-	name: "Background on Hover",
-	description: "Adds background color on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["button", "nav-link"],
-	customizableOption: {
-		name: "colorToken",
-		type: "select",
-		label: "Background Color",
-		default: "neutral-800",
-		options: [
-			"neutral-700",
-			"neutral-800",
-			"neutral-900",
-			"primary"
-		]
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, options, tokens, buttonConfig } = ctx;
-		const colorToken = options.colorToken || "neutral-800";
-		return `
-      /* Add background on hover */
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${tokens.getColor(colorToken)};${"textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : ""}
-      }
-    `;
-	}
-};
-/**
-* Add semi-transparent background color on hover
-*
-* Adds a background with opacity/alpha channel. Perfect for retro/arcade styles.
-*/
-const backgroundOnHoverAlphaEffect = {
-	id: "background-on-hover-alpha",
-	name: "Background on Hover (Transparent)",
-	description: "Adds semi-transparent background on hover",
-	category: "background",
-	pseudoElement: "none",
-	applicableTo: ["nav-link"],
-	customizableOption: {
-		name: "opacity",
-		type: "percentage",
-		label: "Opacity",
-		default: 50
-	},
-	generateCSS: (ctx) => {
-		const { themeId, variantId, stateGroup, options } = ctx;
-		const rawOpacity = options.opacity;
-		const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
-		const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
-		return `
-      /* Add semi-transparent background (${stateGroup}) */
-      :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
-        background-color: rgb(${cssVar} / ${clampedOpacity}%);
-      }
-    `;
-	}
-};
-//#endregion
 //#region ../theme-core/src/buttons/effects/cssUtils.ts
 /**
 * CSS Utilities for Effect Presets
@@ -14426,6 +14119,71 @@ function generateStateCSS(themeId, variantId, state, cssProperties) {
   `;
 }
 //#endregion
+//#region ../theme-core/src/buttons/effects/presets/background.ts
+/**
+* Darken background on hover
+*
+* Works with solid backgrounds only. Darkens the background color by adjusting the shade.
+*/
+const darkenBackgroundEffect = shadeBackgroundEffect({
+	id: "darken-background",
+	name: "Darken on Hover",
+	description: "Darkens the background color on hover",
+	label: "Darken Amount (shade step)",
+	shadeDirection: 1
+});
+/**
+* Lighten background on hover
+*
+* Works with solid backgrounds only. Lightens the background color by adjusting the shade.
+*/
+const lightenBackgroundEffect = shadeBackgroundEffect({
+	id: "lighten-background",
+	name: "Lighten on Hover",
+	description: "Lightens the background color on hover",
+	label: "Lighten Amount (shade step)",
+	shadeDirection: -1
+});
+function shadeBackgroundEffect(config) {
+	return {
+		id: config.id,
+		name: config.name,
+		description: config.description,
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["button"],
+		customizableOption: {
+			name: "amount",
+			type: "select",
+			label: config.label,
+			default: 100,
+			options: [
+				0,
+				100,
+				200,
+				300,
+				400,
+				500,
+				600,
+				700,
+				800,
+				900
+			]
+		},
+		isApplicable: (buttonConfig) => buttonConfig.background.type === "solid",
+		generateCSS: ({ themeId, variantId, options, tokens, buttonConfig }) => {
+			if (buttonConfig.background.type !== "solid") return "";
+			const amount = (options.amount || 100) * config.shadeDirection;
+			const baseToken = buttonConfig.background.colorToken ?? "primary-500";
+			return `
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        background-color: ${tokens.getColor(tokens.adjustShade(baseToken, amount))};
+      }
+    `;
+		}
+	};
+}
+//#endregion
 //#region ../theme-core/src/buttons/effects/registry.ts
 /**
 * Registry of all available effect presets
@@ -14433,11 +14191,144 @@ function generateStateCSS(themeId, variantId, state, cssProperties) {
 const EFFECT_PRESETS = [
 	darkenBackgroundEffect,
 	lightenBackgroundEffect,
-	fadeBackgroundEffect,
-	opacityReduceEffect,
-	animatedGradientEffect,
-	backgroundOnHoverEffect,
-	backgroundOnHoverAlphaEffect,
+	{
+		id: "fade-background",
+		name: "Fade on Hover",
+		description: "Reduces background opacity on hover",
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["nav-link"],
+		customizableOption: {
+			name: "opacity",
+			type: "percentage",
+			label: "Hover Opacity",
+			default: 80
+		},
+		generateCSS: (ctx) => {
+			const { themeId, variantId, options } = ctx;
+			return `
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        opacity: ${(options.opacity || 80) / 100};
+      }
+    `;
+		}
+	},
+	{
+		id: "opacity-reduce",
+		name: "Reduce Opacity",
+		description: "Reduces navigation-link opacity on hover by a percentage",
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["nav-link"],
+		customizableOption: {
+			name: "reduction",
+			type: "percentage",
+			label: "Opacity Reduction",
+			default: 15
+		},
+		generateCSS: (ctx) => {
+			const { themeId, variantId, options } = ctx;
+			return `
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        opacity: ${1 - (options.reduction || 15) / 100};
+      }
+    `;
+		}
+	},
+	{
+		id: "animated-gradient",
+		name: "Animated Gradient",
+		description: "Animates gradient position on hover",
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["button"],
+		customizableOption: {
+			name: "direction",
+			type: "select",
+			label: "Animation Direction",
+			default: "horizontal",
+			options: ["horizontal", "vertical"]
+		},
+		isApplicable: (buttonConfig) => {
+			return buttonConfig.background.type === "gradient";
+		},
+		generateCSS: (ctx) => {
+			const { themeId, variantId, options, buttonConfig } = ctx;
+			if (buttonConfig.background.type !== "gradient") return "";
+			const direction = options.direction || "horizontal";
+			return `
+      /* Setup animated gradient */
+      :where([data-theme-scope="${themeId}"]) .${variantId} {
+        background-size: ${direction === "horizontal" ? "200% auto" : "auto 200%"};
+        background-position: left center;
+        transition: background-position 0.3s ease;
+      }
+
+      /* Animate gradient on hover */
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        background-position: ${direction === "horizontal" ? "right center" : "center bottom"};
+      }
+    `;
+		}
+	},
+	{
+		id: "background-on-hover",
+		name: "Background on Hover",
+		description: "Adds background color on hover",
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["button", "nav-link"],
+		customizableOption: {
+			name: "colorToken",
+			type: "select",
+			label: "Background Color",
+			default: "neutral-800",
+			options: [
+				"neutral-700",
+				"neutral-800",
+				"neutral-900",
+				"primary"
+			]
+		},
+		generateCSS: (ctx) => {
+			const { themeId, variantId, stateGroup, options, tokens, buttonConfig } = ctx;
+			const colorToken = options.colorToken || "neutral-800";
+			const color = tokens.getColor(colorToken);
+			const navForeground = "textColorToken" in buttonConfig && typeof options.textColorToken === "string" ? `\n        color: ${tokens.getColor(options.textColorToken)};` : "";
+			return `
+      /* Add background on hover */
+      ${getStateSelector(themeId, variantId, stateGroup)} {
+        background-color: ${color};${navForeground}
+      }
+    `;
+		}
+	},
+	{
+		id: "background-on-hover-alpha",
+		name: "Background on Hover (Transparent)",
+		description: "Adds semi-transparent background on hover",
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["nav-link"],
+		customizableOption: {
+			name: "opacity",
+			type: "percentage",
+			label: "Opacity",
+			default: 50
+		},
+		generateCSS: (ctx) => {
+			const { themeId, variantId, stateGroup, options } = ctx;
+			const rawOpacity = options.opacity;
+			const clampedOpacity = Math.max(0, Math.min(100, typeof rawOpacity === "number" && !Number.isNaN(rawOpacity) ? rawOpacity : 50));
+			const cssVar = `var(--tb-${options.colorToken || "neutral-800"})`;
+			return `
+      /* Add semi-transparent background (${stateGroup}) */
+      :where([data-theme-scope="${themeId}"]) .${variantId}${stateGroup === "base" ? "" : `:${stateGroup}`} {
+        background-color: rgb(${cssVar} / ${clampedOpacity}%);
+      }
+    `;
+		}
+	},
 	{
 		id: "border-glow",
 		name: "Border Glow",
@@ -17376,6 +17267,147 @@ function resolveOnColorForThemeToken(token) {
 	return shade <= 400 ? "#000000" : "#FFFFFF";
 }
 //#endregion
+//#region ../theme-core/src/header/paintTargets.ts
+/** Resolve the element that owns the visible header surface for each layout. */
+function getHeaderPaintTargets(variant, themeId, state = "base") {
+	const scope = `:where([data-theme-scope="${themeId}"])`;
+	const scrolledRoot = state === "scrolled" ? ".header-root.header-scrolled " : "";
+	if (variant === "floating") {
+		if (state === "scrolled") {
+			const desktopOwner = `${scope} ${scrolledRoot}.header-floating-container`;
+			const mobileOwner = `${scope} ${scrolledRoot}.header-mobile-bar`;
+			return [{
+				kind: "viewport-band",
+				clipSelector: `${scope}:has(.header-root.header-scrolled)`,
+				ownerSelector: desktopOwner,
+				selector: `${desktopOwner}::before`,
+				mediaQuery: MQ_MD_UP,
+				topExtension: {
+					customProperty: "--rb-header-floating-top-gap",
+					value: "1rem",
+					ownerProperty: "top"
+				},
+				ownerNeedsPositioning: false
+			}, {
+				kind: "viewport-band",
+				clipSelector: `${scope}:has(.header-root.header-scrolled)`,
+				ownerSelector: mobileOwner,
+				selector: `${mobileOwner}::before`,
+				mediaQuery: MQ_MD_DOWN,
+				topExtension: {
+					customProperty: "--rb-header-floating-top-gap",
+					value: "0.75rem",
+					ownerProperty: "margin-top"
+				},
+				ownerNeedsPositioning: true
+			}];
+		}
+		return [{
+			kind: "element-box",
+			selector: `${scope} ${scrolledRoot}.header-floating-container`,
+			mediaQuery: MQ_MD_UP
+		}, {
+			kind: "element-box",
+			selector: `${scope} ${scrolledRoot}.header-mobile-bar`,
+			mediaQuery: MQ_MD_DOWN
+		}];
+	}
+	return [{
+		kind: "element-box",
+		selector: `${scope} .header-root${state === "scrolled" ? ".header-scrolled" : ""}::before`,
+		pseudoElement: "inset"
+	}];
+}
+function renderHeaderPaintTargetRules(targets, rules) {
+	return targets.map((target) => {
+		const block = renderHeaderPaintTargetRule(target, rules);
+		return target.mediaQuery ? `@media ${target.mediaQuery} {\n${block}\n}` : block;
+	}).join("\n");
+}
+function renderHeaderPaintTargetRule(target, rules) {
+	switch (target.kind) {
+		case "element-box": {
+			const pseudoElementSetup = target.pseudoElement === "inset" ? [
+				"content: \"\";",
+				"position: absolute;",
+				"inset: 0;",
+				"pointer-events: none;",
+				"border-radius: inherit;",
+				"z-index: -1;"
+			] : [];
+			return `${target.selector} {\n  ${[...pseudoElementSetup, ...rules].join("\n  ")}\n}`;
+		}
+		case "viewport-band": {
+			const gap = target.topExtension;
+			const ownerRules = [
+				`${gap.customProperty}: ${gap.value};`,
+				`${gap.ownerProperty}: var(${gap.customProperty});`,
+				...target.ownerNeedsPositioning ? ["position: relative;"] : [],
+				"isolation: isolate;",
+				"background: none;",
+				"backdrop-filter: none;",
+				"-webkit-backdrop-filter: none;",
+				"border: 0;",
+				"box-shadow: none;"
+			];
+			const bandRules = [
+				"content: \"\";",
+				"position: absolute;",
+				`top: calc(-1 * var(${gap.customProperty}));`,
+				"bottom: 0;",
+				"left: 50%;",
+				"width: 100vw;",
+				"transform: translateX(-50%);",
+				"pointer-events: none;",
+				"border-radius: 0;",
+				"z-index: -1;",
+				...rules
+			];
+			return `${target.clipSelector} {\n  overflow-x: clip;\n}\n${target.ownerSelector} {\n  ${ownerRules.join("\n  ")}\n}\n${target.selector} {\n  ${bandRules.join("\n  ")}\n}`;
+		}
+	}
+}
+//#endregion
+//#region ../theme-core/src/header/scrollTreatment.ts
+const headerScrollTreatmentSchema = z$1.discriminatedUnion("kind", [z$1.object({
+	kind: z$1.literal("contrast-glass"),
+	backgroundTone: z$1.enum(["light", "dark"])
+})]).optional();
+function generateMobileOverlayBackdropFilterFix(themeId, variant) {
+	const root = `:where([data-theme-scope="${themeId}"]) .header-root:has([data-nav-mobile-overlay][aria-hidden="false"])`;
+	return `\n${(variant === "floating" ? [`${root} .header-mobile-bar`, `${root} .header-mobile-bar::before`] : [`${root}::before`]).join(",\n")} {\n  backdrop-filter: none !important;\n  -webkit-backdrop-filter: none !important;\n}\n`;
+}
+function generateHeaderScrollTreatmentStyles(treatment, themeId, variant, surfaceRules = []) {
+	if (!treatment) return "";
+	switch (treatment.kind) {
+		case "contrast-glass": {
+			const backgroundChannels = treatment.backgroundTone === "dark" ? "0 0 0" : "255 255 255";
+			return renderHeaderPaintTargetRules(getHeaderPaintTargets(variant, themeId, "scrolled"), [`background-color: rgb(${backgroundChannels} / 0.60);`, ...surfaceRules]);
+		}
+	}
+}
+//#endregion
+//#region ../theme-core/src/header/containerSchema.ts
+const headerContainerSchema = z$1.object({
+	rounded: z$1.enum([
+		"none",
+		"sm",
+		"md",
+		"lg",
+		"xl",
+		"2xl"
+	]).default("xl"),
+	border: z$1.boolean().default(true),
+	shadow: z$1.boolean().default(true),
+	padding: z$1.enum([
+		"sm",
+		"md",
+		"lg"
+	]).default("md"),
+	tint: z$1.string().nullable().optional(),
+	opacity: z$1.number().min(0).max(1).default(.12)
+}).optional();
+//#endregion
 //#region ../theme-core/src/schema.ts
 const axesSchema = z$1.object({
 	tone: z$1.enum([
@@ -17536,7 +17568,7 @@ const boxBackgroundSchema = z$1.object({
 	color: tokenOrCssColorValueSchema.nullable().optional(),
 	gradient: z$1.string().nullable().optional(),
 	gradientPresetId: z$1.string().min(1).nullable().optional(),
-	image: mediaSchema$1.nullable().optional(),
+	image: mediaSchema.nullable().optional(),
 	objectFit: z$1.enum([
 		"fill",
 		"fit",
@@ -17784,25 +17816,6 @@ const navFontWeight = z$1.enum([
 ]);
 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",
-		"sm",
-		"md",
-		"lg",
-		"xl",
-		"2xl"
-	]).default("xl"),
-	border: z$1.boolean().default(true),
-	shadow: z$1.boolean().default(true),
-	padding: z$1.enum([
-		"sm",
-		"md",
-		"lg"
-	]).default("md"),
-	tint: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).default(.12)
-}).optional();
 const headerBorderSchema = componentBorderSchema.extend({ position: z$1.enum([
 	"bottom",
 	"top",
@@ -17920,7 +17933,7 @@ const headerBackgroundSchema = z$1.object({
 	contentOwner: z$1.literal(siteChromeBackgroundOverrideOwner).optional(),
 	color: tokenOrCssColorValueSchema.nullable().optional(),
 	gradient: gradientConfigSchema.nullable().optional(),
-	image: mediaSchema$1.nullable().optional(),
+	image: mediaSchema.nullable().optional(),
 	textColor: tokenOrCssColorValueSchema.nullable().optional()
 });
 const headerSchema = z$1.object({
@@ -17929,7 +17942,8 @@ const headerSchema = z$1.object({
 	shrinkOnScroll: z$1.boolean(),
 	maxWidth: headerMaxWidth,
 	barFrame: headerBarFrame.optional(),
-	logoOverride: mediaSchema$1.nullable().optional(),
+	scrollTreatment: headerScrollTreatmentSchema,
+	logoOverride: mediaSchema.nullable().optional(),
 	background: headerBackgroundSchema.default({
 		type: "color",
 		color: "surface"
@@ -17941,6 +17955,7 @@ const headerSchema = z$1.object({
 	navFontRole: z$1.enum(["body", "heading"]).optional(),
 	navTypography: z$1.enum(["body", "heading"]).optional(),
 	navTextSize: navLinkStyleSchema.shape.textSize,
+	interactionPalette: headerInteractionPaletteSchema.optional(),
 	navPlacement: z$1.enum(["end", "center"]).optional(),
 	container: headerContainerSchema,
 	border: headerBorderSchema,
@@ -23417,15 +23432,6 @@ const heroCopyFragment = defineFragment({
 */
 const BLOCK_BUTTON_ROLES = PUBLIC_BUTTON_ROLES;
 const blockButtonRoleSchema = z$1.enum(BLOCK_BUTTON_ROLES);
-/**
-* Temporary rollout boundary for persisted content written before issue #1220.
-* Authoring remains strict through `blockButtonRoleSchema`; this parser exists
-* only until the post-deploy role rewrite has been audited in production.
-*/
-function canonicalizePersistedBlockButtonRole(value) {
-	return value === "link" || value === "tertiary" ? "ghost" : value;
-}
-const persistedBlockButtonRoleSchema = z$1.preprocess((value) => typeof value === "string" ? canonicalizePersistedBlockButtonRole(value) : value, blockButtonRoleSchema);
 const BLOCK_BUTTON_ROLE_LABELS = {
 	primary: "Primary",
 	secondary: "Secondary",
@@ -31199,84 +31205,6 @@ const weeklySlotAvailabilityBlockDefinition = {
 		mode: "server"
 	} }
 };
-const PUBLIC_DOWNLOAD_MEDIA_TYPES = [
-	"document",
-	"spreadsheet",
-	"archive",
-	"audio"
-];
-const hotspotSchema = z.object({
-	x: z.number().min(0).max(1),
-	y: z.number().min(0).max(1),
-	radius: z.number().optional()
-});
-const rotationSchema = z.union([
-	z.literal(0),
-	z.literal(90),
-	z.literal(180),
-	z.literal(270)
-]);
-const rectSchema = z.tuple([
-	z.number(),
-	z.number(),
-	z.number(),
-	z.number()
-]);
-const aspectCropSchema = z.object({
-	aspect: z.preprocess((value) => value == null ? void 0 : value, z.string().optional()),
-	rect: z.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
-	hotspot: z.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
-	rotation: z.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
-});
-const transformSchema = z.object({
-	aspectCrops: z.preprocess((value) => {
-		if (!value || typeof value !== "object" || Array.isArray(value)) return;
-		return value;
-	}, z.record(z.string(), aspectCropSchema.catch({}))).optional(),
-	rect: rectSchema.optional(),
-	hotspot: hotspotSchema.optional(),
-	rotation: rotationSchema.optional()
-});
-const mediaPosterSchema = z.discriminatedUnion("tag", [z.object({
-	tag: z.literal("storage"),
-	assetId: z.string().optional(),
-	storageBucket: z.string().min(1),
-	storagePath: z.string().min(1)
-}), z.object({
-	tag: z.literal("external-src"),
-	assetId: z.string().optional(),
-	src: z.string().url()
-})]);
-const mediaBaseSchema = z.object({
-	purpose: z.string().optional(),
-	placeholder: z.boolean().default(true).optional(),
-	assetId: z.string().optional(),
-	identifier: z.string().optional(),
-	src: z.string().optional(),
-	alt: z.string().optional(),
-	filename: z.string().optional(),
-	mimeType: z.string().optional(),
-	width: z.number().optional(),
-	height: z.number().optional(),
-	storageBucket: z.string().optional(),
-	storagePath: z.string().optional(),
-	poster: mediaPosterSchema.optional(),
-	transform: transformSchema.optional()
-});
-const imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
-const videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
-const audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
-const documentMediaSchema = mediaBaseSchema.extend({ type: z.literal("document") });
-const spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z.literal("spreadsheet") });
-const archiveMediaSchema = mediaBaseSchema.extend({ type: z.literal("archive") });
-const mediaSchema = z.discriminatedUnion("type", [
-	imageMediaSchema,
-	videoMediaSchema,
-	audioMediaSchema,
-	documentMediaSchema,
-	spreadsheetMediaSchema,
-	archiveMediaSchema
-]);
 //#endregion
 //#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
 const bookingDepositRefundPolicySchema = z$1.enum(["refundable", "non_refundable"]);
@@ -31716,7 +31644,7 @@ const publicEventSchema = z$1.object({
 	presentation: z$1.object({
 		cardTitleOverride: z$1.string().nullable().optional(),
 		summary: z$1.string().nullable().optional(),
-		image: mediaSchema.nullable().optional()
+		image: mediaSchema$1.nullable().optional()
 	}).optional(),
 	slug: z$1.string(),
 	path: z$1.string().nullable(),
@@ -32342,7 +32270,7 @@ function isEventCalendarListLayout(value) {
 //#region ../blocks/src/system/runtime/nodes/shared/contract-schemas.ts
 const previewStageSchema = z$1.enum(["preview", "published"]);
 const registrationButtonVariantSchema = blockButtonRoleSchema;
-const eventButtonVariantSchema = persistedBlockButtonRoleSchema;
+const eventButtonVariantSchema = blockButtonRoleSchema;
 const eventLayoutSchema = z$1.enum(eventCalendarListLayoutValues);
 const eventCalendarDisplayModeSchema = z$1.enum(eventCalendarDisplayModeValues);
 const eventCalendarDefaultViewSchema = z$1.enum(eventCalendarDefaultViewValues);
@@ -42336,7 +42264,7 @@ const newsletterSignupBlockDefinition = {
 //#endregion
 //#region ../blocks/src/system/blocks/team-members.ts
 const ITEM_NAME = "member";
-const teamMemberPhotoSchema = mediaSchema.refine((media) => media.type === "image", { message: "Team member photos must be image media" }).nullable();
+const teamMemberPhotoSchema = mediaSchema$1.refine((media) => media.type === "image", { message: "Team member photos must be image media" }).nullable();
 const teamMemberDataSchema = z$1.object({
 	_type: z$1.literal("teamMember"),
 	id: z$1.string(),
@@ -43911,7 +43839,7 @@ function getBlockDefinition(name) {
 //#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
 function resolveBackgroundMedia(input) {
-	const parsedMedia = mediaSchema.safeParse(input.image);
+	const parsedMedia = mediaSchema$1.safeParse(input.image);
 	if (!parsedMedia.success) return null;
 	switch (parsedMedia.data.type) {
 		case "image":
@@ -45142,6 +45070,9 @@ function renderTrailingAffordanceIcon(affordance) {
 		className: "rb-ml-2 rb-h-4 rb-w-4 rb-inline-block"
 	});
 }
+function isMissingRequiredLink(linkRequired, resolvedHref) {
+	return linkRequired && resolvedHref.length === 0;
+}
 const ButtonNode = ({ value, children, href, variantId = "primary", size = "md", disabled, type = "button", target, rel, linkRequired = false, trailingIcon, blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, className, ...rest }) => {
 	const content = value ?? children;
 	if (!content) {
@@ -45150,12 +45081,16 @@ const ButtonNode = ({ value, children, href, variantId = "primary", size = "md",
 	}
 	const affordanceIcon = renderTrailingAffordanceIcon(resolveButtonAffordance({ trailingIcon }));
 	const resolvedHref = typeof href === "string" ? href.trim() : "";
-	if (linkRequired && resolvedHref.length === 0) {
+	if (isMissingRequiredLink(linkRequired, resolvedHref)) {
 		if (process.env.NODE_ENV === "development") console.warn("[ButtonNode] Missing href for link-required button");
 		return null;
 	}
 	const extraClassName = affordanceIcon ? [className, AFFORDANCE_SUPPRESS_CLASS].filter(Boolean).join(" ") : className;
-	const resolvedVariantId = parseThemeButtonVariantId(canonicalizePersistedBlockButtonRole(variantId));
+	const resolvedVariantId = parseThemeButtonVariantId(variantId);
+	if (variantId && !resolvedVariantId) {
+		console.error("[ButtonNode] Invalid button variant", { variantId });
+		return null;
+	}
 	const combinedClassName = resolvedVariantId ? themeButtonClassName({
 		variant: resolvedVariantId,
 		size,
@@ -45284,8 +45219,9 @@ function iconForMediaType(type) {
 		});
 	}
 }
-function normalizeButtonVariant(value) {
-	return isBlockButtonRole(value) ? value : "primary";
+function parseButtonVariant(value) {
+	if (value === null || value === void 0) return "primary";
+	return isBlockButtonRole(value) ? value : null;
 }
 function FileDownloadNode({ value, title, description, buttonLabel, buttonVariant, className }) {
 	if (!value || !isDownloadableMediaType(value.type)) return null;
@@ -45295,7 +45231,11 @@ function FileDownloadNode({ value, title, description, buttonLabel, buttonVarian
 	const heading = title?.trim() || filename;
 	const body = description?.trim();
 	const label = buttonLabel?.trim() || "Download";
-	const variant = normalizeButtonVariant(buttonVariant);
+	const variant = parseButtonVariant(buttonVariant);
+	if (!variant) {
+		console.error("[FileDownloadNode] Invalid button variant", { buttonVariant });
+		return null;
+	}
 	return /* @__PURE__ */ jsx("div", {
 		className,
 		children: /* @__PURE__ */ jsxs("div", {
@@ -52216,6 +52156,41 @@ function resolveColorTokenHex(theme, colorToken) {
 	if (colorToken === "transparent") return null;
 	return expandPalette(theme.palette)[colorToken] ?? null;
 }
+const NAV_DROPDOWN_CONTAINER_RAIL_CSS_RULES = [
+	`min-width: 12rem;`,
+	`width: max-content;`,
+	`max-width: min(22rem, calc(100vw - 2rem));`,
+	`transform: translateX(var(--nav-dropdown-shift-x, 0px));`
+];
+//#endregion
+//#region ../theme-core/src/header/surfaceRules.ts
+/** Compile the visual surface declarations independently of paint geometry. */
+function buildHeaderSurfaceRules(header, tokens, blur) {
+	const base = [];
+	const scrolled = [];
+	const background = header.background;
+	if (background.type === "color") base.push(`background-color: ${tokens.getColor(background.color || "surface")};`);
+	else if (background.type === "gradient" && background.gradient) {
+		const stops = background.gradient.stops.map((stop) => tokens.getColor(stop.color)).join(", ");
+		base.push(`background-image: linear-gradient(${background.gradient.angle ?? 180}deg, ${stops});`);
+	}
+	const blurRules = [`backdrop-filter: ${blur};`, `-webkit-backdrop-filter: ${blur};`];
+	base.push(...blurRules);
+	scrolled.push(...blurRules);
+	const borderWidth = getComponentBorderWidthPx(header.border?.width ?? "none");
+	if (!header.border || borderWidth === "0") return {
+		base,
+		scrolled,
+		border: []
+	};
+	const color = rgbColorValue(header.border.colorToken?.trim() || "border");
+	const style = header.border.style === "dashed" ? "dashed" : "solid";
+	return {
+		base,
+		scrolled,
+		border: header.border.position === "both" ? [`border-top: ${borderWidth} ${style} ${color};`, `border-bottom: ${borderWidth} ${style} ${color};`] : [`border-${header.border.position}: ${borderWidth} ${style} ${color};`]
+	};
+}
 //#endregion
 //#region ../theme-core/src/navigation/presets.ts
 /**
@@ -52377,12 +52352,71 @@ function getNavLinkPreset(presetId) {
 	return NAV_LINK_PRESETS[presetId];
 }
 Object.keys(NAV_LINK_PRESETS);
-const NAV_DROPDOWN_CONTAINER_RAIL_CSS_RULES = [
-	`min-width: 12rem;`,
-	`width: max-content;`,
-	`max-width: min(22rem, calc(100vw - 2rem));`,
-	`transform: translateX(var(--nav-dropdown-shift-x, 0px));`
-];
+//#endregion
+//#region ../theme-core/src/header/legacyNavLinkStyle.ts
+function buildLegacyHeaderNavLinkStyle(header, contrastTreatment, navTextSize) {
+	const navStyle = header.navStyle ?? "minimal";
+	const basePreset = getNavLinkPreset(navStyle);
+	if (!basePreset) return null;
+	const style = {
+		...basePreset,
+		fontWeight: header.navWeight ?? basePreset.fontWeight,
+		colorToken: (header.navColor ?? header.textColor)?.trim() || basePreset.colorToken,
+		...contrastTreatment ? { contrastTreatment } : {},
+		...navTextSize ? { textSize: navTextSize } : {}
+	};
+	if (header.navWeight === "bold" && navStyle === "solid") style.textTransform = "uppercase";
+	applyLegacyNavEffects(style, header);
+	applyLegacyGlassTreatment(style, header, navStyle);
+	return style;
+}
+function applyLegacyNavEffects(style, header) {
+	if (!header.navEffects) return;
+	const effects = style.effects = {
+		...style.effects,
+		hover: [...style.effects?.hover ?? []],
+		active: [...style.effects?.active ?? []]
+	};
+	if (header.navEffects.glow) effects.hover.push({
+		effectId: "outer-glow",
+		options: { spread: 5 }
+	});
+	if (header.navEffects.neumorphic) {
+		effects.hover.push({
+			effectId: "neumorphic-shadow",
+			options: { mode: "pressed" }
+		});
+		effects.hover.push({
+			effectId: "text-color-change",
+			options: { hoverColorToken: "primary" }
+		});
+	}
+	if (header.navEffects.underlineGradient) effects.hover.push({
+		effectId: "border-bottom-grow",
+		options: { origin: "center" }
+	});
+}
+function applyLegacyGlassTreatment(style, header, navStyle) {
+	if (header.navContainer?.type !== "glass" || navStyle !== "minimal") return;
+	style.borderRadius = "full";
+	style.effects = {
+		...style.effects,
+		hover: glassStateEffects(10),
+		active: glassStateEffects(18)
+	};
+}
+function glassStateEffects(opacity) {
+	return [{
+		effectId: "background-on-hover-alpha",
+		options: {
+			colorToken: "neutral-50",
+			opacity
+		}
+	}, {
+		effectId: "text-color-change",
+		options: { hoverColorToken: "neutral-50" }
+	}];
+}
 //#endregion
 //#region ../theme-core/src/header/generateHeaderCss.ts
 const HEADER_BLUR = "blur(12px)";
@@ -52412,8 +52446,8 @@ function generateHeaderCss(options) {
 	const cssChunks = [];
 	const headerContrastTreatment = resolveHeaderContrastTreatment(header);
 	const headerNavTextSize = resolveHeaderNavTextSize(header);
-	cssChunks.push(generateHeaderRootStyles(header, themeId, tokens, theme));
-	cssChunks.push(generateMobileOverlayBackdropFilterFix(themeId));
+	cssChunks.push(generateHeaderRootStyles(header, themeId, tokens));
+	cssChunks.push(generateMobileOverlayBackdropFilterFix(themeId, header.variant));
 	cssChunks.push(generateLogoStyles({
 		logo: header.logo,
 		themeId,
@@ -52451,56 +52485,34 @@ function isClearSplitHeaderShape(header) {
 function isDetachedFloatingHeaderShape(header) {
 	return header.variant === "floating" && !header.container;
 }
-function generateMobileOverlayBackdropFilterFix(themeId) {
-	return `\n${`:where([data-theme-scope="${themeId}"]) .header-root:has([data-nav-mobile-overlay][aria-hidden="false"])::before`} {\n  backdrop-filter: none !important;\n  -webkit-backdrop-filter: none !important;\n}\n`;
-}
 /**
 * Generate root header container styles
 */
-function generateHeaderRootStyles(header, themeId, tokens, _theme) {
+function generateHeaderRootStyles(header, themeId, tokens) {
 	const selector = `:where([data-theme-scope="${themeId}"]) .header-root`;
-	const backgroundSelector = `:where([data-theme-scope="${themeId}"]) .header-root::before`;
 	const rules = [];
-	const backgroundRules = [];
 	const navContainerType = header.navContainer?.type ?? "none";
 	const isContainedNav = navContainerType === "pill" || navContainerType === "glass";
 	rules.push("position: relative;");
 	rules.push("isolation: isolate;");
-	if (!isContainedNav) {
-		const bg = header.background;
-		if (bg.type === "color") {
-			const bgColor = tokens.getColor(bg.color || "surface");
-			backgroundRules.push(`background-color: ${bgColor};`);
-		} else if (bg.type === "gradient" && bg.gradient) {
-			const stops = bg.gradient.stops.map((s) => tokens.getColor(s.color)).join(", ");
-			const angle = bg.gradient.angle ?? 180;
-			backgroundRules.push(`background-image: linear-gradient(${angle}deg, ${stops});`);
-		}
-		backgroundRules.push(`backdrop-filter: ${HEADER_BLUR};`);
-		backgroundRules.push(`-webkit-backdrop-filter: ${HEADER_BLUR};`);
-		if (header.border) {
-			const borderWidth = getComponentBorderWidthPx(header.border.width);
-			if (borderWidth !== "0") {
-				const borderToken = header.border?.colorToken?.trim() || "border";
-				const borderColor = tokens.getColor(borderToken);
-				const borderStyle = header.border.style === "dashed" ? "dashed" : "solid";
-				if (header.border.position === "bottom") rules.push(`border-bottom: ${borderWidth} ${borderStyle} ${borderColor};`);
-				else if (header.border.position === "top") rules.push(`border-top: ${borderWidth} ${borderStyle} ${borderColor};`);
-				else if (header.border.position === "both") {
-					rules.push(`border-top: ${borderWidth} ${borderStyle} ${borderColor};`);
-					rules.push(`border-bottom: ${borderWidth} ${borderStyle} ${borderColor};`);
-				}
-			}
-		}
-	}
+	const surfaceRules = isContainedNav ? {
+		base: [],
+		scrolled: [],
+		border: []
+	} : buildHeaderSurfaceRules(header, tokens, HEADER_BLUR);
+	const floatingSurfaceBorder = header.variant === "floating";
+	if (!floatingSurfaceBorder) rules.push(...surfaceRules.border);
+	const basePaintRules = floatingSurfaceBorder ? [...surfaceRules.base, ...surfaceRules.border] : surfaceRules.base;
+	const scrolledPaintRules = floatingSurfaceBorder ? [...surfaceRules.scrolled, ...surfaceRules.border] : surfaceRules.scrolled;
 	if (header.positioning === "sticky" || header.positioning === "fixed") {
 		const shadowVar = getComponentShadowVar(header.shadow?.elevation ?? "none");
 		if (shadowVar) rules.push(`box-shadow: ${shadowVar};`);
 	}
 	const baseBlock = `\n${selector} {\n  ${rules.join("\n  ")}\n}\n`;
 	const overlayFix = `\n${`${selector}:has([data-nav-mobile-overlay][aria-hidden="false"])`} {\n  backdrop-filter: none !important;\n  -webkit-backdrop-filter: none !important;\n}\n`;
-	if (isContainedNav || backgroundRules.length === 0) return `${baseBlock}\n${overlayFix}`;
-	return `${baseBlock}\n${`\n${backgroundSelector} {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  pointer-events: none;\n  border-radius: inherit;\n  z-index: -1;\n  ${backgroundRules.join("\n  ")}\n}\n`}\n${overlayFix}${usesInsetShell(header) ? generateInsetShellStyles(header, themeId) : ""}`;
+	const scrollTreatmentStyles = generateHeaderScrollTreatmentStyles(header.scrollTreatment, themeId, header.variant, scrolledPaintRules);
+	if (isContainedNav || basePaintRules.length === 0) return `${baseBlock}\n${overlayFix}${scrollTreatmentStyles}`;
+	return `${baseBlock}\n${renderHeaderPaintTargetRules(getHeaderPaintTargets(header.variant, themeId), basePaintRules)}\n${overlayFix}${usesInsetShell(header) ? generateInsetShellStyles(header, themeId) : ""}${scrollTreatmentStyles}`;
 }
 /**
 * Reshapes the full-bleed header paint layer into a contained brand capsule at
@@ -52545,10 +52557,10 @@ function generateLogoStyles(input) {
 	else rules.push(`font-family: var(--font-heading);`);
 	if (logo) {
 		if (logo.letterSpacing && logo.letterSpacing !== "normal") rules.push(`letter-spacing: ${{
-			"normal": "0em",
-			"wide": "0.05em",
-			"wider": "0.1em",
-			"widest": "0.15em"
+			normal: "0em",
+			wide: "0.05em",
+			wider: "0.1em",
+			widest: "0.15em"
 		}[logo.letterSpacing]};`);
 		if (logo.gradient) {
 			rules.push(`background: linear-gradient(to right, ${primaryColor}, ${accentColor});`);
@@ -52621,71 +52633,11 @@ function generateNavLinkStyles(header, themeId, tokens, theme, contrastTreatment
 		} : header.navLinkStyle, navPreferences),
 		className: "header-nav-link"
 	});
-	const navStyle = header.navStyle ?? "minimal";
-	const basePreset = getNavLinkPreset(navStyle);
-	if (!basePreset) {
-		console.warn(`[generateHeaderCss] Nav link preset not found: ${navStyle}`);
+	const mergedStyle = buildLegacyHeaderNavLinkStyle(header, contrastTreatment, navTextSize);
+	if (!mergedStyle) {
+		console.warn(`[generateHeaderCss] Nav link preset not found: ${header.navStyle}`);
 		return "";
 	}
-	const mergedStyle = {
-		...basePreset,
-		fontWeight: header.navWeight ?? basePreset.fontWeight,
-		colorToken: (header.navColor ?? header.textColor)?.trim() || basePreset.colorToken,
-		...contrastTreatment ? { contrastTreatment } : {},
-		...navTextSize ? { textSize: navTextSize } : {}
-	};
-	if (header.navWeight === "bold" && navStyle === "solid") mergedStyle.textTransform = "uppercase";
-	if (header.navEffects) {
-		const effects = mergedStyle.effects = {
-			...mergedStyle.effects,
-			hover: [...mergedStyle.effects?.hover || []],
-			active: [...mergedStyle.effects?.active || []]
-		};
-		if (header.navEffects.glow) effects.hover.push({
-			effectId: "outer-glow",
-			options: { spread: 5 }
-		});
-		if (header.navEffects.neumorphic) {
-			effects.hover.push({
-				effectId: "neumorphic-shadow",
-				options: { mode: "pressed" }
-			});
-			effects.hover.push({
-				effectId: "text-color-change",
-				options: { hoverColorToken: "primary" }
-			});
-		}
-		if (header.navEffects.underlineGradient) effects.hover.push({
-			effectId: "border-bottom-grow",
-			options: { origin: "center" }
-		});
-	}
-	if ((header.navContainer?.type ?? "none") === "glass" && navStyle === "minimal") {
-		mergedStyle.borderRadius = "full";
-		mergedStyle.effects = {
-			...mergedStyle.effects,
-			hover: [{
-				effectId: "background-on-hover-alpha",
-				options: {
-					colorToken: "neutral-50",
-					opacity: 10
-				}
-			}, {
-				effectId: "text-color-change",
-				options: { hoverColorToken: "neutral-50" }
-			}],
-			active: [{
-				effectId: "background-on-hover-alpha",
-				options: {
-					colorToken: "neutral-50",
-					opacity: 18
-				}
-			}, {
-				effectId: "text-color-change",
-				options: { hoverColorToken: "neutral-50" }
-			}]
-		};
-	}
 	return generateNavLinkCSS({
 		themeId,
 		tokens,
@@ -52713,10 +52665,10 @@ function generateDropdownContainerStyles(header, themeId, tokens) {
 	if (shadowVar) rules.push(`box-shadow: ${shadowVar};`);
 	const borderRadius = dropdownStyle?.borderRadius ?? "md";
 	rules.push(`border-radius: ${{
-		"none": "0",
-		"sm": "0.25rem",
-		"md": "0.5rem",
-		"lg": "0.75rem"
+		none: "0",
+		sm: "0.25rem",
+		md: "0.5rem",
+		lg: "0.75rem"
 	}[borderRadius]};`);
 	rules.push(`padding: 0.5rem 0;`);
 	return `\n${selector} {\n  ${rules.join("\n  ")}\n}\n`;
@@ -52771,16 +52723,16 @@ function generateDropdownLinkStyles(header, themeId, tokens, theme) {
 	const additionalRules = [];
 	const letterSpacing = configuredDropdownStyle?.letterSpacing ?? "normal";
 	if (letterSpacing !== "normal") additionalRules.push(`letter-spacing: ${{
-		"normal": "0em",
-		"wide": "0.05em",
-		"wider": "0.1em"
+		normal: "0em",
+		wide: "0.05em",
+		wider: "0.1em"
 	}[letterSpacing]};`);
 	const textSize = configuredDropdownStyle?.textSize ?? "sm";
 	additionalRules.push(`font-size: ${{
-		"xs": "0.75rem",
-		"sm": "0.875rem",
-		"base": "1rem",
-		"lg": "1.125rem"
+		xs: "0.75rem",
+		sm: "0.875rem",
+		base: "1rem",
+		lg: "1.125rem"
 	}[textSize]};`);
 	if (additionalRules.length > 0) return baseCSS + `\n${`:where([data-theme-scope="${themeId}"]) .nav-dropdown-link`} {\n  ${additionalRules.join("\n  ")}\n}\n`;
 	return baseCSS;
@@ -52876,18 +52828,18 @@ function generateFloatingContainerStyles(header, themeId, tokens) {
 	rules.push(`-webkit-backdrop-filter: ${FLOATING_BLUR};`);
 	if (container.border) rules.push(`border: 1px solid rgb(255 255 255 / 0.2);`);
 	rules.push(`border-radius: ${{
-		"none": "0",
-		"sm": "0.375rem",
-		"md": "0.5rem",
-		"lg": "0.75rem",
-		"xl": "1rem",
+		none: "0",
+		sm: "0.375rem",
+		md: "0.5rem",
+		lg: "0.75rem",
+		xl: "1rem",
 		"2xl": "1.5rem"
 	}[container.rounded]};`);
 	if (container.shadow) rules.push(`box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);`);
 	rules.push(`padding: ${{
-		"sm": "1rem 1.5rem",
-		"md": "1.5rem 2rem",
-		"lg": "2rem 2.5rem"
+		sm: "1rem 1.5rem",
+		md: "1.5rem 2rem",
+		lg: "2rem 2.5rem"
 	}[container.padding]};`);
 	return `\n${selector} {\n  ${rules.join("\n  ")}\n}\n`;
 }