@riverbankcms/sdk 0.126.0 → 0.127.0

package/dist/cli/index.mjs

@@ -13716,8 +13716,7 @@ function createRichTextDocFromMarkdown(markdown) {
 		})
 	};
 }
-var TipTapMarkSchema, TipTapNodeSchema, RichTextDocSchema;
-var init_richTextSchema = __esmMin((() => {
+var TipTapMarkSchema, TipTapNodeSchema, RichTextDocSchema, init_richTextSchema = __esmMin((() => {
 	init_typeGuards();
 	TipTapMarkSchema = z$1.object({
 		type: z$1.string().min(1),
@@ -13758,11 +13757,103 @@ var init_richTextSchema = __esmMin((() => {
 		type: z$1.literal("doc"),
 		content: z$1.array(TipTapNodeSchema)
 	}).strict();
+})), PUBLIC_DOWNLOAD_MEDIA_TYPES, hotspotSchema$1, rotationSchema$1, rectSchema$1, aspectCropSchema$1, transformSchema$1, mediaPosterSchema, mediaBaseSchema, mediaIdentifierSchema, imageMediaSchema, videoMediaSchema, audioMediaSchema, documentMediaSchema, spreadsheetMediaSchema, archiveMediaSchema, mediaSchema$1, persistableMediaBaseSchema;
+var init_media$2 = __esmMin((() => {
+	init_src$2();
+	PUBLIC_DOWNLOAD_MEDIA_TYPES = [
+		"document",
+		"spreadsheet",
+		"archive",
+		"audio"
+	];
+	hotspotSchema$1 = z.object({
+		x: z.number().min(0).max(1),
+		y: z.number().min(0).max(1),
+		radius: z.number().optional()
+	});
+	rotationSchema$1 = z.union([
+		z.literal(0),
+		z.literal(90),
+		z.literal(180),
+		z.literal(270)
+	]);
+	rectSchema$1 = z.tuple([
+		z.number(),
+		z.number(),
+		z.number(),
+		z.number()
+	]);
+	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())
+	});
+	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()
+	});
+	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()
+	})]);
+	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()
+	});
+	mediaIdentifierSchema = z.string().trim().min(1).brand();
+	imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
+	videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
+	audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
+	documentMediaSchema = mediaBaseSchema.extend({ type: z.literal("document") });
+	spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z.literal("spreadsheet") });
+	archiveMediaSchema = mediaBaseSchema.extend({ type: z.literal("archive") });
+	mediaSchema$1 = z.discriminatedUnion("type", [
+		imageMediaSchema,
+		videoMediaSchema,
+		audioMediaSchema,
+		documentMediaSchema,
+		spreadsheetMediaSchema,
+		archiveMediaSchema
+	]);
+	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
 init_src$2();
 init_richTextSchema();
+init_media$2();
 const TEL_RE = /^[+()0-9\s-]{3,}$/;
 const SLUG_PATTERN = /^(?:[a-z0-9]+(?:-[a-z0-9]+)*)(?:\/(?:[a-z0-9]+(?:-[a-z0-9]+)*))*$/;
 const ALLOWED_URL_PROTOCOLS = ["http:", "https:"];
@@ -14050,7 +14141,7 @@ function canonicalizeFieldValueForWrite(plan, value) {
 		case "media": {
 			if (!isPlainObject$6(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);
@@ -14145,7 +14236,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);
@@ -14186,7 +14277,7 @@ function validateNormalizedFieldValue(plan, value, ctx) {
 		case "select": return validateSelectPlan(plan, value);
 		case "richText": return isValidRichTextDoc(value) ? [] : [issue$3(plan, "invalidRichText")];
 		case "inlineText": return validateInlineTextPlan(plan, value);
-		case "media": return isPlainObject$6(value) && typeof value.identifier === "string" && value.identifier.trim().length > 0 && (value.type === void 0 || typeof value.type === "string" && plan.allowedMediaTypes.includes(value.type)) ? [] : [issue$3(plan, "invalidMedia")];
+		case "media": return isPlainObject$6(value) && mediaIdentifierSchema.safeParse(value.identifier).success && (value.type === void 0 || typeof value.type === "string" && plan.allowedMediaTypes.includes(value.type)) ? [] : [issue$3(plan, "invalidMedia")];
 		case "link": return linkSchema.safeParse(value).success ? [] : [issue$3(plan, "invalidLink")];
 		case "repeater": return validateRepeaterPlan(plan, value, ctx);
 		case "group": return validateGroupPlan(plan, value, ctx);
@@ -14959,6 +15050,18 @@ var init_accessibleSurfaces = __esmMin((() => {
 	init_onColor();
 }));
 //#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}".`);
+}
+var init_lookOptionGroups = __esmMin((() => {}));
+//#endregion
 //#region ../theme-core/src/site-styles/types.ts
 /**
 * Defines a literal-preserving catalog while rejecting top-level extra keys on
@@ -15107,7 +15210,7 @@ var init_types$15 = __esmMin((() => {
 //#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) {
@@ -15115,772 +15218,655 @@ function defineBlockAppearancePreset(preset) {
 	return preset;
 }
 var init_appearancePresetResolution = __esmMin((() => {
+	init_lookOptionGroups();
 	init_types$15();
-}));
-//#endregion
-//#region ../theme-core/src/site-styles/blockAppearancePresets.ts
-var blockAppearancePresets;
+})), brandScrimOptionGroups, microBannerLayoutPatches;
 var init_blockAppearancePresets = __esmMin((() => {
 	init_appearancePresetResolution();
 	init_types$15();
-	blockAppearancePresets = [
-		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" }
+	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" } }
+		}]
+	}];
+	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"
+		}
+	});
 }));
 var init_appearancePresetCatalog = __esmMin((() => {
 	init_blockAppearancePresets();
-	[...blockAppearancePresets];
 }));
 var init_appearancePresetTypes = __esmMin((() => {}));
 //#endregion
@@ -17595,7 +17581,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) {
@@ -19197,6 +19183,47 @@ var init_backgroundAppearance = __esmMin((() => {
 var init_compositionBudget = __esmMin((() => {
 	init_types$15();
 }));
+var init_headerStyleParts = __esmMin((() => {}));
+var headerInteractionPaletteValues, headerInteractionPaletteSchema;
+var init_interactionPalette = __esmMin((() => {
+	headerInteractionPaletteValues = [
+		"primary",
+		"secondary",
+		"accent"
+	];
+	headerInteractionPaletteSchema = z$1.enum(headerInteractionPaletteValues);
+}));
+var clearSplitInteractionPalette;
+var init_headerInteractionPalette = __esmMin((() => {
+	init_interactionPalette();
+	init_lookOptionGroups();
+	clearSplitInteractionPalette = defineLookOptionGroup({
+		id: "interaction-palette",
+		label: "Hover colour",
+		defaultOptionId: "accent",
+		options: [
+			{
+				id: "accent",
+				label: "Accent"
+			},
+			{
+				id: "primary",
+				label: "Primary"
+			},
+			{
+				id: "secondary",
+				label: "Secondary"
+			}
+		]
+	});
+}));
+var init_headerOpeningForeground = __esmMin((() => {
+	init_expandPalette();
+	init_colorConversion();
+	init_tokens();
+	init_colorTokenParts();
+	init_types$15();
+}));
 var init_customizableSurfaces = __esmMin((() => {
 	init_types$15();
 })), logoTextConfidenceValues, logoAssetShapeValues, logoKindValues, logoDensityValues, logoContainsTextSchema, logoAnalysisSourceSchema, brandDisplayModeValues, logoAccommodationPatternValues, logoSizePolicyValues;
@@ -19307,7 +19334,7 @@ function asHeaderStyleId(value) {
 * 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: {
@@ -19672,15 +19699,15 @@ function floatingGlassHeader(theme) {
 		}
 	};
 }
-function headerConfigurationKey(configuration) {
-	return `${configuration.structure}:${configuration.treatment}:${configuration.behavior}`;
-}
 function findHeaderLook(id) {
 	return headerLooksById.get(id);
 }
 var titleOnlyLogoAccommodation, inlineWordmarkLogoAccommodation, inlineMarkWithTitleLogoAccommodation, logoPlateAccommodation, centeredBadgeAccommodation, popoutBadgeAccommodation, centeredMastheadAccommodation, unbackedOverlayLogoAccommodation, inlineClassicLogoAccommodations, centeredLogoAccommodations, overlayLogoAccommodations, headerLayoutCatalog, headerStyleCatalog, headerLayoutsById, headerStylesById, headerStyleCompatibilityOrder, legacyHeaderLookAliases, legacyHeaderLookAliasesById, headerLookCatalog, guaranteedFallbackHeaderLayoutId, guaranteedFallbackHeaderStyleId, headerLooksById;
 var init_headerLooks = __esmMin((() => {
 	init_headerCtaVariants();
+	init_headerStyleParts();
+	init_headerInteractionPalette();
+	init_headerOpeningForeground();
 	init_customizableSurfaces();
 	init_logoBranding();
 	init_types$15();
@@ -19807,7 +19834,6 @@ var init_headerLooks = __esmMin((() => {
 			id: asHeaderLayoutId("classic"),
 			label: "Classic",
 			description: "Logo and navigation in one practical horizontal row.",
-			structure: "inline-classic",
 			variant: "classic",
 			defaultPositioning: "sticky",
 			shrinkOnScroll: false
@@ -19816,7 +19842,6 @@ var init_headerLooks = __esmMin((() => {
 			id: asHeaderLayoutId("centered"),
 			label: "Centered",
 			description: "Logo centered above a balanced navigation row.",
-			structure: "centered-stack",
 			variant: "centered",
 			defaultPositioning: "static",
 			shrinkOnScroll: false,
@@ -19832,7 +19857,6 @@ var init_headerLooks = __esmMin((() => {
 			id: asHeaderLayoutId("floating"),
 			label: "Floating",
 			description: "Detached header chrome that sits over the opening section.",
-			structure: "floating-shell",
 			variant: "floating",
 			defaultPositioning: "sticky",
 			shrinkOnScroll: true,
@@ -19991,10 +20015,13 @@ var init_headerLooks = __esmMin((() => {
 			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"]
 		},
 		{
@@ -20017,6 +20044,7 @@ var init_headerLooks = __esmMin((() => {
 			surface: "floating",
 			defaultDepth: "shadow",
 			navTypography: "quiet-caps",
+			openingForegroundTarget: "brand-only",
 			moods: ["expressive"]
 		},
 		{
@@ -20028,6 +20056,7 @@ var init_headerLooks = __esmMin((() => {
 			surface: "floating",
 			defaultDepth: "shadow",
 			navTypography: "heading",
+			openingForegroundTarget: "brand-only",
 			moods: ["calm", "editorial"]
 		}
 	]);
@@ -20183,13 +20212,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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
@@ -20197,13 +20219,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20212,13 +20227,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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
@@ -20226,13 +20234,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20241,13 +20242,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20256,13 +20250,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20271,13 +20258,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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
@@ -20285,13 +20265,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20300,13 +20273,6 @@ var init_headerLooks = __esmMin((() => {
 		{
 			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,
@@ -20315,7 +20281,6 @@ var init_headerLooks = __esmMin((() => {
 	]);
 	guaranteedFallbackHeaderLayoutId = asHeaderLayoutId("classic");
 	guaranteedFallbackHeaderStyleId = asHeaderStyleId("minimal");
-	new Set(headerLookCatalog.map((look) => headerConfigurationKey(look.configuration)));
 	headerLooksById = new Map(headerLookCatalog.map((look) => [look.id, look]));
 }));
 var init_compilationPlan = __esmMin((() => {
@@ -20545,11 +20510,9 @@ var init_types$12 = __esmMin((() => {
 		"secondary",
 		"outline",
 		"ghost",
-		"link",
-		"tertiary",
 		"accent"
 	];
-	buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only");
+	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" });
 	DEFAULT_VARIANT_ALIAS_ID = "default";
 	opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
 		const token = parseOpaqueButtonColourToken(value);
@@ -23685,41 +23648,41 @@ var init_siteStyleTypography = __esmMin((() => {
 }));
 //#endregion
 //#region ../theme-core/src/lib/media.ts
-var hotspotSchema$1, rotationSchema$1, rectSchema$1, aspectCropSchema$1, transformSchema$1, mediaSchema$1;
-var init_media$2 = __esmMin((() => {
-	hotspotSchema$1 = z.object({
+var hotspotSchema, rotationSchema, rectSchema, aspectCropSchema, transformSchema, mediaSchema;
+var init_media$1 = __esmMin((() => {
+	hotspotSchema = z.object({
 		x: z.number().min(0).max(1),
 		y: z.number().min(0).max(1),
 		radius: z.number().optional()
 	});
-	rotationSchema$1 = z.union([
+	rotationSchema = z.union([
 		z.literal(0),
 		z.literal(90),
 		z.literal(180),
 		z.literal(270)
 	]);
-	rectSchema$1 = z.tuple([
+	rectSchema = z.tuple([
 		z.number(),
 		z.number(),
 		z.number(),
 		z.number()
 	]);
-	aspectCropSchema$1 = z.object({
+	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())
 	});
-	transformSchema$1 = z.object({
+	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()
 	});
-	mediaSchema$1 = z.object({
+	mediaSchema = z.object({
 		type: z.enum([
 			"image",
 			"video",
@@ -23740,7 +23703,7 @@ var init_media$2 = __esmMin((() => {
 		height: z.number().optional(),
 		storageBucket: z.string().optional(),
 		storagePath: z.string().optional(),
-		transform: transformSchema$1.optional()
+		transform: transformSchema.optional()
 	});
 }));
 //#endregion
@@ -24408,20 +24371,61 @@ var init_classNames = __esmMin((() => {
 }));
 var init_generateBaseCSS = __esmMin((() => {}));
 //#endregion
+//#region ../theme-core/src/buttons/effects/cssUtils.ts
+/**
+* Generate CSS selector for a state with dual support for hover
+*
+* @param themeId - Theme scope ID
+* @param variantId - Variant class name
+* @param state - State group (hover, active, focus, base)
+* @returns CSS selector string
+*/
+function getStateSelector(themeId, variantId, state) {
+	const stateSelector = STATE_SELECTORS[state];
+	if (state === "base") return `:where([data-theme-scope="${themeId}"]) .${variantId}`;
+	if (state === "hover") return `:where([data-theme-scope="${themeId}"]) .${variantId}:hover,
+      :where([data-theme-scope="${themeId}"]) .${variantId}[data-force-hover="true"]`;
+	return `:where([data-theme-scope="${themeId}"]) .${variantId}${stateSelector}`;
+}
+/**
+* Generate CSS rule block for a state
+*
+* @param themeId - Theme scope ID
+* @param variantId - Variant class name
+* @param state - State group
+* @param cssProperties - CSS properties string (e.g., "transform: scale(1.05);")
+* @returns Complete CSS rule block
+*/
+function generateStateCSS(themeId, variantId, state, cssProperties) {
+	return `
+    ${getStateSelector(themeId, variantId, state)} {
+      ${cssProperties}
+    }
+  `;
+}
+var STATE_SELECTORS;
+var init_cssUtils = __esmMin((() => {
+	STATE_SELECTORS = {
+		hover: ":hover, [data-force-hover=\"true\"]",
+		active: ":active",
+		focus: ":focus-visible",
+		base: ""
+	};
+}));
+//#endregion
 //#region ../theme-core/src/buttons/effects/presets/background.ts
-var darkenBackgroundEffect, lightenBackgroundEffect, fadeBackgroundEffect, opacityReduceEffect, animatedGradientEffect, backgroundOnHoverEffect, backgroundOnHoverAlphaEffect;
-var init_background$2 = __esmMin((() => {
-	darkenBackgroundEffect = {
-		id: "darken-background",
-		name: "Darken on Hover",
-		description: "Darkens the background color on hover",
+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: "Darken Amount (shade step)",
+			label: config.label,
 			default: 100,
 			options: [
 				0,
@@ -24436,63 +24440,36 @@ var init_background$2 = __esmMin((() => {
 				900
 			]
 		},
-		isApplicable: (buttonConfig) => {
-			return buttonConfig.background.type === "solid";
-		},
-		generateCSS: (ctx) => {
-			const { themeId, variantId, options, tokens, buttonConfig } = ctx;
+		isApplicable: (buttonConfig) => buttonConfig.background.type === "solid",
+		generateCSS: ({ themeId, variantId, options, tokens, buttonConfig }) => {
 			if (buttonConfig.background.type !== "solid") return "";
-			const amount = options.amount || 100;
+			const amount = (options.amount || 100) * config.shadeDirection;
 			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)};
+        background-color: ${tokens.getColor(tokens.adjustShade(baseToken, amount))};
       }
     `;
 		}
 	};
-	lightenBackgroundEffect = {
+}
+var darkenBackgroundEffect, lightenBackgroundEffect, fadeBackgroundEffect, opacityReduceEffect, animatedGradientEffect, backgroundOnHoverEffect, backgroundOnHoverAlphaEffect;
+var init_background$2 = __esmMin((() => {
+	init_cssUtils();
+	darkenBackgroundEffect = shadeBackgroundEffect({
+		id: "darken-background",
+		name: "Darken on Hover",
+		description: "Darkens the background color on hover",
+		label: "Darken Amount (shade step)",
+		shadeDirection: 1
+	});
+	lightenBackgroundEffect = shadeBackgroundEffect({
 		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)};
-      }
-    `;
-		}
-	};
+		label: "Lighten Amount (shade step)",
+		shadeDirection: -1
+	});
 	fadeBackgroundEffect = {
 		id: "fade-background",
 		name: "Fade on Hover",
@@ -24593,12 +24570,14 @@ var init_background$2 = __esmMin((() => {
 			]
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, options, tokens, buttonConfig } = 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 */
-      :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)};` : ""}
+      ${getStateSelector(themeId, variantId, stateGroup)} {
+        background-color: ${color};${navForeground}
       }
     `;
 		}
@@ -24631,48 +24610,6 @@ var init_background$2 = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region ../theme-core/src/buttons/effects/cssUtils.ts
-/**
-* Generate CSS selector for a state with dual support for hover
-*
-* @param themeId - Theme scope ID
-* @param variantId - Variant class name
-* @param state - State group (hover, active, focus, base)
-* @returns CSS selector string
-*/
-function getStateSelector(themeId, variantId, state) {
-	const stateSelector = STATE_SELECTORS[state];
-	if (state === "base") return `:where([data-theme-scope="${themeId}"]) .${variantId}`;
-	if (state === "hover") return `:where([data-theme-scope="${themeId}"]) .${variantId}:hover,
-      :where([data-theme-scope="${themeId}"]) .${variantId}[data-force-hover="true"]`;
-	return `:where([data-theme-scope="${themeId}"]) .${variantId}${stateSelector}`;
-}
-/**
-* Generate CSS rule block for a state
-*
-* @param themeId - Theme scope ID
-* @param variantId - Variant class name
-* @param state - State group
-* @param cssProperties - CSS properties string (e.g., "transform: scale(1.05);")
-* @returns Complete CSS rule block
-*/
-function generateStateCSS(themeId, variantId, state, cssProperties) {
-	return `
-    ${getStateSelector(themeId, variantId, state)} {
-      ${cssProperties}
-    }
-  `;
-}
-var STATE_SELECTORS;
-var init_cssUtils = __esmMin((() => {
-	STATE_SELECTORS = {
-		hover: ":hover, [data-force-hover=\"true\"]",
-		active: ":active",
-		focus: ":focus-visible",
-		base: ""
-	};
-}));
-//#endregion
 //#region ../theme-core/src/buttons/effects/presets/shadow.ts
 var borderGlowEffect, dropShadowEffect, innerShadowEffect, neumorphicShadowEffect, outerGlowEffect, retro3DShadowEffect;
 var init_shadow = __esmMin((() => {
@@ -26620,6 +26557,41 @@ var init_tokenOrColor = __esmMin((() => {
 		"yellow"
 	]);
 }));
+var init_paintTargets = __esmMin((() => {
+	init_breakpoints();
+}));
+var headerScrollTreatmentSchema;
+var init_scrollTreatment = __esmMin((() => {
+	init_paintTargets();
+	headerScrollTreatmentSchema = z$1.discriminatedUnion("kind", [z$1.object({
+		kind: z$1.literal("contrast-glass"),
+		backgroundTone: z$1.enum(["light", "dark"])
+	})]).optional();
+}));
+//#endregion
+//#region ../theme-core/src/header/containerSchema.ts
+var headerContainerSchema;
+var init_containerSchema = __esmMin((() => {
+	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
 /**
@@ -26636,9 +26608,9 @@ function normaliseHeaderNavFontRole(header) {
 		navFontRole: navTypography
 	} : rest;
 }
-var axesSchema, typographyStyleSchema, bodyTypographyStyleSchema, headingSizeSchema, headingTypographyOverridesSchema, headingTypographyStyleSchema, proseLinkUnderlineStyleSchema, proseLinkUnderlineThicknessSchema, proseLinkUnderlineOffsetSchema, proseLinkStyleSchema, semanticSpacingSchema, boxRoundedSchema, boxBackgroundOverlaySchema, boxBackgroundSchema, noHeadingDecorationSchema, visibleHeadingDecorationSchema, headingDecorationSchema, headingDecorationOverrideSchema, accordionIconTreatmentSchema, sectionStylesOverrideSchema, containerStylesOverrideSchema, cardBorderOverrideSchema, cardStylesOverrideSchema, blockStyleOverridesSchema, blockThemeOverrideSchema, typographyScaleSchema, eyebrowTypographyStyleSchema, typographySchema, spaceSchema, corners, shadow, border, motion, inputStyle, headerVariant, headerPositioning, headerNavStyle, navFontWeight, headerMaxWidth, headerBarFrame, headerContainerSchema, headerBorderSchema, logoStyleSchema, headerLogoTextSchema, navEffectsSchema, dropdownStyleSchema, headerCtaGapSchema, headerCtaTreatmentSchema, navContainerSchema, headerBackgroundSchema, headerSchema, footerVariant, footerMaxWidth, footerMode, footerNavLayoutMode, footerNavLayoutAlign, footerSpacing, footerLogoPlacement, footerLogoSize, footerLogoMaxHeight, footerBottomTextLinkStyleSchema, footerBottomBarSchema, footerNavLayoutSchema, footerLogoSchema, footerSchema, containerPaddingPresetSchema, layoutSchema, heroTypographySizeSchema, heroTypographyLineHeightSchema, heroResponsiveTypographySchema, heroTypographySchema, heroSchema, bodyTextIntroTypographySizeSchema, bodyTextSchema, gradientsSchema, testimonialQuoteTreatmentSchema, themeSchema;
+var axesSchema, typographyStyleSchema, bodyTypographyStyleSchema, headingSizeSchema, headingTypographyOverridesSchema, headingTypographyStyleSchema, proseLinkUnderlineStyleSchema, proseLinkUnderlineThicknessSchema, proseLinkUnderlineOffsetSchema, proseLinkStyleSchema, semanticSpacingSchema, boxRoundedSchema, boxBackgroundOverlaySchema, boxBackgroundSchema, noHeadingDecorationSchema, visibleHeadingDecorationSchema, headingDecorationSchema, headingDecorationOverrideSchema, accordionIconTreatmentSchema, sectionStylesOverrideSchema, containerStylesOverrideSchema, cardBorderOverrideSchema, cardStylesOverrideSchema, blockStyleOverridesSchema, blockThemeOverrideSchema, typographyScaleSchema, eyebrowTypographyStyleSchema, typographySchema, spaceSchema, corners, shadow, border, motion, inputStyle, headerVariant, headerPositioning, headerNavStyle, navFontWeight, headerMaxWidth, headerBarFrame, headerBorderSchema, logoStyleSchema, headerLogoTextSchema, navEffectsSchema, dropdownStyleSchema, headerCtaGapSchema, headerCtaTreatmentSchema, navContainerSchema, headerBackgroundSchema, headerSchema, footerVariant, footerMaxWidth, footerMode, footerNavLayoutMode, footerNavLayoutAlign, footerSpacing, footerLogoPlacement, footerLogoSize, footerLogoMaxHeight, footerBottomTextLinkStyleSchema, footerBottomBarSchema, footerNavLayoutSchema, footerLogoSchema, footerSchema, containerPaddingPresetSchema, layoutSchema, heroTypographySizeSchema, heroTypographyLineHeightSchema, heroResponsiveTypographySchema, heroTypographySchema, heroSchema, bodyTextIntroTypographySizeSchema, bodyTextSchema, gradientsSchema, testimonialQuoteTreatmentSchema, themeSchema;
 var init_schema = __esmMin((() => {
-	init_media$2();
+	init_media$1();
 	init_schema$1();
 	init_buttons();
 	init_cards();
@@ -26654,6 +26626,9 @@ var init_schema = __esmMin((() => {
 	init_rawStyleFields();
 	init_themeColorTokens();
 	init_tokenOrColor();
+	init_scrollTreatment();
+	init_containerSchema();
+	init_interactionPalette();
 	axesSchema = z$1.object({
 		tone: z$1.enum([
 			"minimal",
@@ -26813,7 +26788,7 @@ var init_schema = __esmMin((() => {
 		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",
@@ -27061,25 +27036,6 @@ var init_schema = __esmMin((() => {
 	]);
 	headerMaxWidth = z$1.enum(["container", "full"]);
 	headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
-	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();
 	headerBorderSchema = componentBorderSchema.extend({ position: z$1.enum([
 		"bottom",
 		"top",
@@ -27193,7 +27149,7 @@ var init_schema = __esmMin((() => {
 		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()
 	});
 	headerSchema = z$1.object({
@@ -27202,7 +27158,8 @@ var init_schema = __esmMin((() => {
 		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"
@@ -27214,6 +27171,7 @@ var init_schema = __esmMin((() => {
 		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,
@@ -29658,6 +29616,7 @@ var init_records = __esmMin((() => {}));
 var init_headerOpeningSection = __esmMin((() => {
 	init_headerLooks();
 	init_records();
+	init_tokens();
 }));
 var init_generatedDesignPipeline = __esmMin((() => {
 	init_compositionBudget();
@@ -29953,8 +29912,11 @@ var init_site_styles = __esmMin((() => {
 	init_generatedSchemas();
 	init_generatedDesignPipeline();
 	init_headerLooks();
+	init_headerInteractionPalette();
+	init_headerOpeningForeground();
 	init_headerOpeningSection();
 	init_lookResolution();
+	init_lookOptionGroups();
 	init_logoBranding();
 	init_pageDesignAuthority();
 	init_pageDesignEditorErrors();
@@ -32813,23 +32775,14 @@ var init_heroCopy = __esmMin((() => {
 }));
 //#endregion
 //#region ../blocks/src/system/constants/buttonRoles.ts
-/**
-* 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;
-}
 function isBlockButtonRole(value) {
 	return blockButtonRoleSchema.safeParse(value).success;
 }
-var BLOCK_BUTTON_ROLES, blockButtonRoleSchema, persistedBlockButtonRoleSchema, BLOCK_BUTTON_ROLE_LABELS, BLOCK_BUTTON_ROLE_OPTIONS;
+var BLOCK_BUTTON_ROLES, blockButtonRoleSchema, BLOCK_BUTTON_ROLE_LABELS, BLOCK_BUTTON_ROLE_OPTIONS;
 var init_buttonRoles = __esmMin((() => {
 	init_buttons();
 	BLOCK_BUTTON_ROLES = PUBLIC_BUTTON_ROLES;
 	blockButtonRoleSchema = z$1.enum(BLOCK_BUTTON_ROLES);
-	persistedBlockButtonRoleSchema = z$1.preprocess((value) => typeof value === "string" ? canonicalizePersistedBlockButtonRole(value) : value, blockButtonRoleSchema);
 	BLOCK_BUTTON_ROLE_LABELS = {
 		primary: "Primary",
 		secondary: "Secondary",
@@ -41039,88 +40992,7 @@ const weeklySlotAvailabilityBlockDefinition = {
 };
 //#endregion
 //#region ../blocks/src/system/blocks/events/shared/types.ts
-var init_types$4 = __esmMin((() => {})), PUBLIC_DOWNLOAD_MEDIA_TYPES, hotspotSchema, rotationSchema, rectSchema, aspectCropSchema, transformSchema, mediaPosterSchema, mediaBaseSchema, imageMediaSchema, videoMediaSchema, audioMediaSchema, documentMediaSchema, spreadsheetMediaSchema, archiveMediaSchema, mediaSchema;
-var init_media$1 = __esmMin((() => {
-	init_src$2();
-	PUBLIC_DOWNLOAD_MEDIA_TYPES = [
-		"document",
-		"spreadsheet",
-		"archive",
-		"audio"
-	];
-	hotspotSchema = z.object({
-		x: z.number().min(0).max(1),
-		y: z.number().min(0).max(1),
-		radius: z.number().optional()
-	});
-	rotationSchema = z.union([
-		z.literal(0),
-		z.literal(90),
-		z.literal(180),
-		z.literal(270)
-	]);
-	rectSchema = z.tuple([
-		z.number(),
-		z.number(),
-		z.number(),
-		z.number()
-	]);
-	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())
-	});
-	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()
-	});
-	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()
-	})]);
-	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()
-	});
-	imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
-	videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
-	audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
-	documentMediaSchema = mediaBaseSchema.extend({ type: z.literal("document") });
-	spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z.literal("spreadsheet") });
-	archiveMediaSchema = mediaBaseSchema.extend({ type: z.literal("archive") });
-	mediaSchema = z.discriminatedUnion("type", [
-		imageMediaSchema,
-		videoMediaSchema,
-		audioMediaSchema,
-		documentMediaSchema,
-		spreadsheetMediaSchema,
-		archiveMediaSchema
-	]);
-}));
+var init_types$4 = __esmMin((() => {}));
 //#endregion
 //#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
 var bookingDepositRefundPolicySchema, bookingInstalmentPlanSchema, bookingFlexibleBalanceDueDateRuleSchema, bookingFlexibleBalanceConfigSchema, blockBookingPaymentCollectionOptionSchema, blockBookingPaymentTermsSchema;
@@ -41273,7 +41145,7 @@ var init_schemas$1 = __esmMin((() => {
 	publicCoursesArraySchema = publicWholeSeriesOfferingsArraySchema;
 })), eventPresetSchema, eventScheduleScopeSchema$2, publicEventRecurrenceSchema, eventDestinationModeSchema$1, publicEventDestinationSchema, eventVenueSchema, eventCategorySchema, accessRestrictionSchema, publicCoursePriceDisplaySchema, publicEventTicketTypePriceDisplaySchema, publicEventAttendanceModeSchema, publicEventAttendanceModeAvailabilitySchema, publicEventTicketTypeAvailabilitySchema, publicEventTicketTypeSchema, publicEventPricingSchema, publicTeamMemberSummarySchema, publicEventSchema, publicEventsArraySchema;
 var init_schemas = __esmMin((() => {
-	init_media$1();
+	init_media$2();
 	init_richTextSchema();
 	init_bookingPaymentTerms();
 	init_schemas$1();
@@ -41549,7 +41421,7 @@ var init_schemas = __esmMin((() => {
 		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(),
@@ -42197,7 +42069,7 @@ var init_contract_schemas = __esmMin((() => {
 	init_buttonRoles();
 	previewStageSchema = z$1.enum(["preview", "published"]);
 	registrationButtonVariantSchema = blockButtonRoleSchema;
-	eventButtonVariantSchema = persistedBlockButtonRoleSchema;
+	eventButtonVariantSchema = blockButtonRoleSchema;
 	eventLayoutSchema = z$1.enum(eventCalendarListLayoutValues);
 	eventCalendarDisplayModeSchema = z$1.enum(eventCalendarDisplayModeValues);
 	eventCalendarDefaultViewSchema = z$1.enum(eventCalendarDefaultViewValues);
@@ -50319,7 +50191,7 @@ const audioPlayerBlockDefinition = { manifest: createBlockManifest({
 }) };
 //#endregion
 //#region ../blocks/src/system/blocks/file-download.ts
-init_media$1();
+init_media$2();
 init_defineBlock();
 init_button();
 init_builder$1();
@@ -52818,9 +52690,9 @@ init_schema$2();
 init_defineBlock();
 init_builder$1();
 init_fragments$1();
-init_media$1();
+init_media$2();
 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(),
@@ -54412,9 +54284,9 @@ function listBlockDefinitions() {
 init_tokens();
 //#endregion
 //#region ../blocks/src/system/helpers/backgroundMedia.ts
-init_media$1();
+init_media$2();
 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":
@@ -55650,7 +55522,6 @@ function renderMark(mark, key, child) {
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/basic.tsx
 init_buttons();
-init_buttonRoles();
 const TextNode = ({ value, children, blockId: _blockId, blockKind: _blockKind, blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, inlineTextFallbackPath, ...rest }) => {
 	const inlineText = parseInlineTextFromUnknown(value);
 	if (inlineText.ok && !isInlineTextEmpty(inlineText.value)) return /* @__PURE__ */ jsx(Text$2, {
@@ -55690,6 +55561,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) {
@@ -55698,12 +55572,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,
@@ -55808,7 +55686,7 @@ const FeatureCardIconNode = ({ value, treatment, generatedIconSizePx, className,
 //#region ../blocks/src/system/runtime/nodes/file-download.tsx
 init_svg();
 init_colorStyles();
-init_media$1();
+init_media$2();
 init_buttons();
 init_media();
 init_buttonRoles();
@@ -55842,8 +55720,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;
@@ -55853,7 +55732,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", {
@@ -62679,12 +62562,18 @@ var init_navDropdownSizing = __esmMin((() => {
 	`${NAV_DROPDOWN_MAX_WIDTH_CSS}`, `${NAV_DROPDOWN_SHIFT_PROPERTY}`;
 }));
 //#endregion
+//#region ../theme-core/src/header/surfaceRules.ts
+init_navDropdownSizing();
+init_shared$5();
+init_colorStyles();
+//#endregion
 //#region ../theme-core/src/header/generateHeaderCss.ts
 init_resolver$1();
 init_siteChromeNavPreferences();
 init_shared$5();
 init_breakpoints();
-init_navDropdownSizing();
+init_scrollTreatment();
+init_paintTargets();
 //#endregion
 //#region ../theme-core/src/footer/generateFooterCss.ts
 init_resolver$1();
@@ -64211,6 +64100,9 @@ init_typeGuards();
 //#region ../blocks/src/primitives/content/primitives.tsx
 init_RichText();
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/mergeResolveImageUrlContexts.ts
+init_src$2();
+//#endregion
 //#region ../blocks/src/system/helpers/resolveBackground.tsx
 /**
 * Helper utilities for resolving background data in custom block components.
@@ -64285,7 +64177,7 @@ init_tokens();
 init_gradients();
 init_richTextSchema();
 init_media();
-init_media$1();
+init_media$2();
 init_slotContracts();
 init_typeGuards();
 init_booking_form_reserved_fields();
@@ -152871,7 +152763,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.126.0";
+const SDK_VERSION = "0.127.0";
 //#endregion
 //#region src/client/error.ts
 /**