@riverbankcms/sdk 0.129.0 → 0.130.0

package/dist/server/theme-bridge.mjs

@@ -1,5 +1,5 @@
 import * as React from "react";
-import z, { z as z$1 } from "zod";
+import { z } from "zod";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region ../theme-core/src/lib/media.ts
 const hotspotSchema = z.object({
@@ -34,15 +34,17 @@ const transformSchema = z.object({
 	hotspot: hotspotSchema.optional(),
 	rotation: rotationSchema.optional()
 });
-const mediaSchema = z.object({
-	type: z.enum([
-		"image",
-		"video",
-		"audio",
-		"document",
-		"spreadsheet",
-		"archive"
-	]),
+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(),
@@ -55,8 +57,33 @@ const mediaSchema = z.object({
 	height: z.number().optional(),
 	storageBucket: z.string().optional(),
 	storagePath: z.string().optional(),
+	poster: mediaPosterSchema.optional(),
 	transform: transformSchema.optional()
 });
+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 = 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 ../theme-core/src/tokens/colorTokenParts.ts
 function parseOpacityPercent(source) {
@@ -148,7 +175,7 @@ const PALETTE_TOKEN_NAMES = [
 	"text",
 	"border"
 ];
-const paletteTokenNameSchema = z$1.enum(PALETTE_TOKEN_NAMES);
+const paletteTokenNameSchema = z.enum(PALETTE_TOKEN_NAMES);
 const themeColorBaseTokenNames = [
 	...PALETTE_TOKEN_NAMES,
 	...blockColorTokenNames,
@@ -193,7 +220,7 @@ function parseThemeColorToken(value) {
 	if (!isThemeColorToken(value)) return null;
 	return value.trim();
 }
-const themeColorTokenSchema = z$1.string().min(1).refine((value) => Boolean(isThemeColorToken(value)), "Expected a known Theme V2 color token");
+const themeColorTokenSchema = z.string().min(1).refine((value) => Boolean(isThemeColorToken(value)), "Expected a known Theme V2 color token");
 //#endregion
 //#region ../theme-core/src/palette/colors.ts
 const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/;
@@ -213,11 +240,11 @@ const THEME_PALETTE_COLOR_ORDER = [
 	"primaryForeground",
 	"border"
 ];
-const hexColorSchema = z$1.string().regex(HEX_COLOR_REGEX, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
-const paletteModeSchema = z$1.enum(["light", "dark"]);
+const hexColorSchema = z.string().regex(HEX_COLOR_REGEX, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
+const paletteModeSchema = z.enum(["light", "dark"]);
 const PALETTE_VALUE_KEY_PREFIX = "palette-value:v1|";
-z$1.string().regex(/^[0-9a-f]{64}$/, "Palette hash must be a lowercase SHA-256 value").transform((value) => value);
-const paletteColorsSchema = z$1.object({
+z.string().regex(/^[0-9a-f]{64}$/, "Palette hash must be a lowercase SHA-256 value").transform((value) => value);
+const paletteColorsSchema = z.object({
 	primary: hexColorSchema,
 	primaryForeground: hexColorSchema,
 	secondary: hexColorSchema,
@@ -328,25 +355,25 @@ function parsePaletteValueKey(value) {
 	if (!colors.ok || paletteValueKey(colors.colors, mode.data) !== value) return null;
 	return value;
 }
-const paletteValueKeySchema = z$1.string().transform((value, ctx) => {
+const paletteValueKeySchema = z.string().transform((value, ctx) => {
 	const parsed = parsePaletteValueKey(value);
 	if (parsed) return parsed;
 	ctx.addIssue({
 		code: "custom",
 		message: "Invalid canonical palette value key"
 	});
-	return z$1.NEVER;
+	return z.NEVER;
 });
 //#endregion
 //#region ../theme-core/src/palette/schema.ts
-const colourHexString = z$1.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
-const paletteColorSchema = z$1.object({
-	name: z$1.string().min(1),
+const colourHexString = z.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
+const paletteColorSchema = z.object({
+	name: z.string().min(1),
 	hex: colourHexString
 });
-const paletteMetaSchema = z$1.object({ mode: z$1.enum(["light", "dark"]) });
-const paletteSchema = z$1.object({
-	colors: z$1.array(paletteColorSchema),
+const paletteMetaSchema = z.object({ mode: z.enum(["light", "dark"]) });
+const paletteSchema = z.object({
+	colors: z.array(paletteColorSchema),
 	meta: paletteMetaSchema
 }).transform((palette, ctx) => {
 	const colors = paletteColorsFromEntries(palette.colors);
@@ -355,7 +382,7 @@ const paletteSchema = z$1.object({
 			code: "custom",
 			message: `Invalid complete palette: ${colors.error.kind}`
 		});
-		return z$1.NEVER;
+		return z.NEVER;
 	}
 	return {
 		colors: paletteColorEntries(colors.colors).map(({ name, hex }) => ({
@@ -386,7 +413,7 @@ const VARIANT_ROLES = [
 * 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").refine((value) => value !== "link" && value !== "tertiary", { message: "Retired button role IDs are not valid variant IDs" });
+const buttonVariantIdSchema = z.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 parseOpaqueButtonColourToken(value) {
 	const token = parseThemeColorToken(value);
 	if (token === null) return null;
@@ -401,8 +428,8 @@ const opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => pa
 	if (token === null) throw new Error("Invariant: opaque button token passed its schema");
 	return token;
 });
-const buttonShadeAmountSchema = z$1.number().finite().min(0).max(900).multipleOf(100);
-const buttonShadowIntensitySchema = z$1.enum([
+const buttonShadeAmountSchema = z.number().finite().min(0).max(900).multipleOf(100);
+const buttonShadowIntensitySchema = z.enum([
 	"subtle",
 	"medium",
 	"strong"
@@ -414,153 +441,176 @@ const buttonShadowIntensitySchema = z$1.enum([
 * this closed union so unsupported effect IDs, unknown option keys, and unsafe
 * CSS values cannot become representable after the schema boundary.
 */
-const buttonEffectApplicationSchema = z$1.discriminatedUnion("effectId", [
-	z$1.strictObject({
-		effectId: z$1.literal("darken-background"),
-		options: z$1.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
+const buttonEffectApplicationSchema = z.discriminatedUnion("effectId", [
+	z.strictObject({
+		effectId: z.literal("darken-background"),
+		options: z.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("lighten-background"),
-		options: z$1.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
+	z.strictObject({
+		effectId: z.literal("lighten-background"),
+		options: z.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("background-on-hover"),
-		options: z$1.strictObject({ colorToken: opaqueButtonColourTokenSchema.optional() }).optional()
+	z.strictObject({
+		effectId: z.literal("background-on-hover"),
+		options: z.strictObject({ colorToken: opaqueButtonColourTokenSchema.optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("animated-gradient"),
-		options: z$1.strictObject({ direction: z$1.enum(["horizontal", "vertical"]).optional() }).optional()
+	z.strictObject({
+		effectId: z.literal("animated-gradient"),
+		options: z.strictObject({ direction: z.enum(["horizontal", "vertical"]).optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("drop-shadow"),
-		options: z$1.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
+	z.strictObject({
+		effectId: z.literal("drop-shadow"),
+		options: z.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("inner-shadow"),
-		options: z$1.strictObject({}).optional()
+	z.strictObject({
+		effectId: z.literal("inner-shadow"),
+		options: z.strictObject({}).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("neumorphic-shadow"),
-		options: z$1.strictObject({
-			mode: z$1.enum(["raised", "pressed"]).optional(),
+	z.strictObject({
+		effectId: z.literal("neumorphic-shadow"),
+		options: z.strictObject({
+			mode: z.enum(["raised", "pressed"]).optional(),
 			intensity: buttonShadowIntensitySchema.optional()
 		}).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("retro-3d-shadow"),
-		options: z$1.strictObject({}).optional()
+	z.strictObject({
+		effectId: z.literal("retro-3d-shadow"),
+		options: z.strictObject({}).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("scale-up"),
-		options: z$1.strictObject({ scale: z$1.enum([
+	z.strictObject({
+		effectId: z.literal("scale-up"),
+		options: z.strictObject({ scale: z.enum([
 			"1.02",
 			"1.03",
 			"1.05",
 			"1.10"
 		]).optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("scale-down"),
-		options: z$1.strictObject({ scale: z$1.enum([
+	z.strictObject({
+		effectId: z.literal("scale-down"),
+		options: z.strictObject({ scale: z.enum([
 			"0.90",
 			"0.95",
 			"0.97",
 			"0.98"
 		]).optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("lift"),
-		options: z$1.strictObject({ amount: z$1.enum([
+	z.strictObject({
+		effectId: z.literal("lift"),
+		options: z.strictObject({ amount: z.enum([
 			"0.25",
 			"0.5",
 			"1"
 		]).optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("press-down"),
-		options: z$1.strictObject({}).optional()
+	z.strictObject({
+		effectId: z.literal("press-down"),
+		options: z.strictObject({}).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("pop"),
-		options: z$1.strictObject({ intensity: z$1.enum([
+	z.strictObject({
+		effectId: z.literal("pop"),
+		options: z.strictObject({ intensity: z.enum([
 			"subtle",
 			"medium",
 			"dramatic"
 		]).optional() }).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("border-bottom-grow"),
-		options: z$1.strictObject({
-			height: z$1.union([z$1.literal(1), z$1.literal(2)]).optional(),
-			origin: z$1.enum([
+	z.strictObject({
+		effectId: z.literal("border-bottom-grow"),
+		options: z.strictObject({
+			height: z.union([z.literal(1), z.literal(2)]).optional(),
+			origin: z.enum([
 				"left",
 				"center",
 				"right"
 			]).optional()
 		}).optional()
 	}),
-	z$1.strictObject({
-		effectId: z$1.literal("sketchy-border"),
-		options: z$1.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
+	z.strictObject({
+		effectId: z.literal("sketchy-border"),
+		options: z.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
 	})
 ]);
-const cornerStyleSchema = z$1.enum([
+const cornerStyleSchema = z.enum([
 	"square",
 	"rounded",
 	"pill"
 ]);
-const shadowSizeSchema = z$1.enum([
+const shadowSizeSchema = z.enum([
 	"none",
 	"low",
 	"medium",
 	"high"
 ]);
-const textTransformSchema = z$1.enum([
+const textTransformSchema = z.enum([
 	"none",
 	"uppercase",
 	"lowercase",
 	"capitalize"
 ]);
-const fontWeightSchema = z$1.union([
-	z$1.literal(500),
-	z$1.literal(600),
-	z$1.literal(700)
+const fontWeightSchema = z.union([
+	z.literal(500),
+	z.literal(600),
+	z.literal(700)
 ]);
-const buttonTypographySchema = z$1.enum(["body", "heading"]);
-const letterSpacingSchema = z$1.enum([
+const buttonTypographySchema = z.enum(["body", "heading"]);
+const letterSpacingSchema = z.enum([
 	"tight",
 	"normal",
 	"loose"
 ]);
-const hoverTransformSchema = z$1.enum([
+const hoverTransformSchema = z.enum([
 	"none",
 	"lift",
 	"scale",
 	"press"
 ]);
-z$1.enum(["none", "token"]);
-const buttonPaddingPresetSchema = z$1.enum([
+z.enum(["none", "token"]);
+const buttonPaddingPresetSchema = z.enum([
 	"compact",
 	"default",
 	"spacious"
 ]);
-const gradientStyleSchema = z$1.enum([
+const gradientStyleSchema = z.enum([
 	"linear",
 	"radial",
 	"conic"
 ]);
-const gradientSharpnessSchema = z$1.enum([
+const gradientSharpnessSchema = z.enum([
 	"smooth",
 	"medium",
 	"hard"
 ]);
-const prioritySchema = z$1.union([
-	z$1.literal(1),
-	z$1.literal(2),
-	z$1.literal(3)
+const prioritySchema = z.union([
+	z.literal(1),
+	z.literal(2),
+	z.literal(3)
 ]);
-z$1.enum(VARIANT_ROLES);
-const buttonSizeNameSchema = z$1.enum([
+const variantRoleSchema = z.enum(VARIANT_ROLES);
+const buttonSurfaceFallbackSchema = z.discriminatedUnion("kind", [z.strictObject({ kind: z.literal("surface-outline") }), z.strictObject({
+	kind: z.literal("variant"),
+	role: variantRoleSchema
+})]);
+const standardButtonSurfacePolicy = {
+	primary: [{ kind: "surface-outline" }],
+	secondary: [{ kind: "surface-outline" }, {
+		kind: "variant",
+		role: "primary"
+	}],
+	outline: [{ kind: "surface-outline" }],
+	ghost: [{ kind: "surface-outline" }],
+	accent: [{ kind: "surface-outline" }, {
+		kind: "variant",
+		role: "primary"
+	}]
+};
+const STANDARD_BUTTON_SURFACE_POLICY = Object.freeze(Object.fromEntries(VARIANT_ROLES.map((role) => [role, Object.freeze([...standardButtonSurfacePolicy[role]])])));
+function createStandardButtonSurfacePolicy() {
+	return Object.fromEntries(VARIANT_ROLES.map((role) => [role, [...STANDARD_BUTTON_SURFACE_POLICY[role]]]));
+}
+const buttonSurfacePolicyShape = Object.fromEntries(VARIANT_ROLES.map((role) => [role, z.array(buttonSurfaceFallbackSchema).max(VARIANT_ROLES.length)]));
+const buttonSurfacePolicySchema = z.strictObject(buttonSurfacePolicyShape);
+const buttonSizeNameSchema = z.enum([
 	"sm",
 	"md",
 	"lg",
@@ -574,13 +624,13 @@ const buttonSizeNameSchema = z$1.enum([
 * generator trust the shape rather than defensively defaulting downstream.
 */
 const PADDING_TOKEN_PATTERN = /^(?:0|\d+(?:\.\d+)?(?:rem|em|px|%))$/;
-const paddingShorthandSchema = z$1.string().refine((value) => {
+const paddingShorthandSchema = z.string().refine((value) => {
 	const parts = value.split(/\s+/).filter(Boolean);
 	return parts.length === 2 && parts.every((token) => PADDING_TOKEN_PATTERN.test(token));
 }, { message: "Padding must be two space-separated CSS length tokens (e.g. \"0.5rem 1rem\"). Use `0` for zero." });
-const buttonSizeConfigSchema = z$1.object({
+const buttonSizeConfigSchema = z.object({
 	padding: paddingShorthandSchema,
-	fontSize: z$1.string().optional()
+	fontSize: z.string().optional()
 });
 /**
 * `xl` is optional on the wire so themes persisted before the `xl` size was
@@ -588,7 +638,7 @@ const buttonSizeConfigSchema = z$1.object({
 * backfills it from `lg`, keeping `ButtonSizes` a complete `sm/md/lg/xl` map
 * downstream — generators never need to deal with an undefined `xl`.
 */
-const buttonSizesSchema = z$1.object({
+const buttonSizesSchema = z.object({
 	sm: buttonSizeConfigSchema,
 	md: buttonSizeConfigSchema,
 	lg: buttonSizeConfigSchema,
@@ -599,9 +649,9 @@ const buttonSizesSchema = z$1.object({
 	lg,
 	xl: xl ?? lg
 }));
-const buttonGlobalSettingsBaseSchema = z$1.strictObject({
+const buttonGlobalSettingsBaseSchema = z.strictObject({
 	cornerStyle: cornerStyleSchema,
-	cornerRadius: z$1.number().min(0).max(24).optional(),
+	cornerRadius: z.number().min(0).max(24).optional(),
 	/**
 	* Family-level shadow inherited by variants that don't set their own.
 	* Optional and flat-by-default: when omitted, buttons carry no drop shadow
@@ -613,23 +663,23 @@ const buttonGlobalSettingsBaseSchema = z$1.strictObject({
 	textTransform: textTransformSchema,
 	fontWeight: fontWeightSchema,
 	typography: buttonTypographySchema.optional(),
-	fontSize: z$1.string().optional(),
+	fontSize: z.string().optional(),
 	letterSpacing: letterSpacingSchema.optional(),
-	italic: z$1.boolean().optional(),
+	italic: z.boolean().optional(),
 	paddingPreset: buttonPaddingPresetSchema.optional(),
 	hoverTransform: hoverTransformSchema,
 	gradientStyle: gradientStyleSchema.optional(),
-	gradientAngle: z$1.number().min(0).max(360).optional(),
+	gradientAngle: z.number().min(0).max(360).optional(),
 	gradientSharpness: gradientSharpnessSchema.optional()
 });
-const buttonGlobalSettingsSchema = z$1.discriminatedUnion("hoverColor", [buttonGlobalSettingsBaseSchema.extend({
-	hoverColor: z$1.literal("none"),
-	hoverColorToken: z$1.never().optional()
+const buttonGlobalSettingsSchema = z.discriminatedUnion("hoverColor", [buttonGlobalSettingsBaseSchema.extend({
+	hoverColor: z.literal("none"),
+	hoverColorToken: z.never().optional()
 }), buttonGlobalSettingsBaseSchema.extend({
-	hoverColor: z$1.literal("token"),
+	hoverColor: z.literal("token"),
 	hoverColorToken: opaqueButtonColourTokenSchema
 })]);
-const gradientDirectionSchema$1 = z$1.enum([
+const gradientDirectionSchema$1 = z.enum([
 	"to-r",
 	"to-l",
 	"to-t",
@@ -639,14 +689,14 @@ const gradientDirectionSchema$1 = z$1.enum([
 	"to-br",
 	"to-bl"
 ]);
-const buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
-	z$1.strictObject({
-		type: z$1.literal("solid"),
+const buttonColourTreatmentSchema = z.discriminatedUnion("type", [
+	z.strictObject({
+		type: z.literal("solid"),
 		colorToken: opaqueButtonColourTokenSchema
 	}),
-	z$1.strictObject({
-		type: z$1.literal("gradient"),
-		stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
+	z.strictObject({
+		type: z.literal("gradient"),
+		stops: z.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
 			const [first, second, ...rest] = stops;
 			if (first === void 0 || second === void 0) throw new Error("Invariant: gradient stops passed the minimum length schema");
 			return [
@@ -658,34 +708,34 @@ const buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
 		direction: gradientDirectionSchema$1,
 		foregroundToken: opaqueButtonColourTokenSchema
 	}),
-	z$1.strictObject({
-		type: z$1.literal("surface"),
-		role: z$1.literal("link")
+	z.strictObject({
+		type: z.literal("surface"),
+		role: z.literal("link")
 	})
 ]);
 const buttonBackgroundSchema = buttonColourTreatmentSchema;
-const buttonBorderSchema = z$1.strictObject({ widthClass: z$1.string() });
-const buttonVariantAffordanceSchema = z$1.strictObject({ iconId: z$1.string().min(1) });
-const variantShadowSchema = z$1.strictObject({
-	elevation: z$1.enum([
+const buttonBorderSchema = z.strictObject({ widthClass: z.string() });
+const buttonVariantAffordanceSchema = z.strictObject({ iconId: z.string().min(1) });
+const variantShadowSchema = z.strictObject({
+	elevation: z.enum([
 		"none",
 		"low",
 		"medium",
 		"high"
 	]),
-	softness: z$1.enum([
+	softness: z.enum([
 		"crisp",
 		"soft",
 		"hard"
 	]).nullable(),
-	position: z$1.enum(["bottom", "bottom-right"]).default("bottom"),
+	position: z.enum(["bottom", "bottom-right"]).default("bottom"),
 	colorToken: opaqueButtonColourTokenSchema.optional()
 });
-const variantEffectsSchema = z$1.strictObject({
-	base: z$1.array(buttonEffectApplicationSchema).optional(),
-	hover: z$1.array(buttonEffectApplicationSchema).optional(),
-	active: z$1.array(buttonEffectApplicationSchema).optional(),
-	focus: z$1.array(buttonEffectApplicationSchema).optional()
+const variantEffectsSchema = z.strictObject({
+	base: z.array(buttonEffectApplicationSchema).optional(),
+	hover: z.array(buttonEffectApplicationSchema).optional(),
+	active: z.array(buttonEffectApplicationSchema).optional(),
+	focus: z.array(buttonEffectApplicationSchema).optional()
 });
 /**
 * Per-variant size overrides schema — every entry is optional.
@@ -694,7 +744,7 @@ const variantEffectsSchema = z$1.strictObject({
 * for that size on this variant. Missing sizes fall through to theme.sizes,
 * then system defaults.
 */
-const variantSizeOverridesSchema = z$1.object({
+const variantSizeOverridesSchema = z.object({
 	sm: buttonSizeConfigSchema.optional(),
 	md: buttonSizeConfigSchema.optional(),
 	lg: buttonSizeConfigSchema.optional(),
@@ -706,14 +756,14 @@ const variantSizeOverridesSchema = z$1.object({
 * default (e.g. link-style variants declaring zero horizontal padding at
 * every size).
 */
-const buttonVariantSchema = z$1.strictObject({
+const buttonVariantSchema = z.strictObject({
 	id: buttonVariantIdSchema,
-	name: z$1.string().min(1).max(20),
-	enabled: z$1.boolean(),
+	name: z.string().min(1).max(20),
+	enabled: z.boolean(),
 	priority: prioritySchema,
 	background: buttonBackgroundSchema,
 	/** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
-	borderRadius: z$1.string().optional(),
+	borderRadius: z.string().optional(),
 	shadow: variantShadowSchema.optional(),
 	border: buttonBorderSchema.optional(),
 	hoverBackgroundToken: opaqueButtonColourTokenSchema.optional(),
@@ -721,10 +771,11 @@ const buttonVariantSchema = z$1.strictObject({
 	sizes: variantSizeOverridesSchema.optional(),
 	affordance: buttonVariantAffordanceSchema.optional()
 });
-const buttonSystemSchema = z$1.strictObject({
+const buttonSystemSchema = z.strictObject({
 	global: buttonGlobalSettingsSchema,
-	variants: z$1.array(buttonVariantSchema).min(1).max(6),
-	sizes: buttonSizesSchema.optional()
+	variants: z.array(buttonVariantSchema).min(1).max(6),
+	sizes: buttonSizesSchema.optional(),
+	surfacePolicy: buttonSurfacePolicySchema.optional()
 }).superRefine((system, ctx) => {
 	const seen = /* @__PURE__ */ new Set();
 	system.variants.forEach((variant, index) => {
@@ -1025,7 +1076,7 @@ function getButtonEffectPolicy(effectId) {
 	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
 }
 //#endregion
-//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+//#region ../theme-core/src/buttons/buttonColourContract.ts
 const BUTTON_VISUAL_STATES = [
 	"base",
 	"hover",
@@ -1040,6 +1091,50 @@ const BUTTON_CONTRAST_POLICY = {
 	alphaBackgrounds: "reject-without-known-surface",
 	disabled: "retain-full-colour-contract"
 };
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "insufficient_surface_contrast": return `Button "${error.variantId}" ${error.state} state is indistinguishable from its surface at ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function validateButtonSurfaceContrast(input) {
+	const ratio = contrastRatio(input.buttonPaint, input.surfaceHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_surface_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			buttonPaint: input.buttonPaint,
+			surface: input.surfaceHex,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+		}
+	};
+}
+function validateButtonTextContrast(input) {
+	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			background: input.background,
+			foreground: input.foreground,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		}
+	};
+}
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
 function compileButtonColourStates(input) {
 	const baseTransition = applyColourEffects({
 		variantId: input.variant.id,
@@ -1079,7 +1174,9 @@ function compileButtonColourStates(input) {
 			variantId: input.variant.id,
 			state,
 			treatment: stateTreatments[state],
-			palette: input.palette
+			palette: input.palette,
+			surface: input.surface,
+			hasBoundary: input.variant.border !== void 0
 		});
 		if (!result.ok) return result;
 		resolved[state] = result.colour;
@@ -1091,17 +1188,6 @@ function compileButtonColourStates(input) {
 		nonColourEffects
 	};
 }
-function formatButtonColourContractError(error) {
-	switch (error.tag) {
-		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
-		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
-		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
-		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
-		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
-		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
-		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
-	}
-}
 function hoverTreatment(variant, global, fallback) {
 	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
 	return token === void 0 ? fallback : {
@@ -1158,22 +1244,42 @@ function applyColourEffects(input) {
 function resolveTreatment(input) {
 	const treatment = input.treatment;
 	switch (treatment.type) {
-		case "surface": return {
-			ok: true,
-			colour: {
-				kind: "surface",
-				role: treatment.role,
-				backgroundCss: "transparent",
-				foregroundCss: surfaceForegroundValue(treatment.role)
+		case "surface":
+			if (input.surface) {
+				const foreground = validateButtonTextContrast({
+					...input,
+					background: "surface",
+					backgroundHex: input.surface.backgroundHex,
+					foreground: "surface-foreground",
+					foregroundHex: input.surface.foregroundHex
+				});
+				if (!foreground.ok) return foreground;
 			}
-		};
+			if (input.surface && input.hasBoundary) {
+				const boundary = validateButtonSurfaceContrast({
+					...input,
+					buttonPaint: input.surface.foregroundHex,
+					surfaceHex: input.surface.backgroundHex
+				});
+				if (!boundary.ok) return boundary;
+			}
+			return {
+				ok: true,
+				colour: {
+					kind: "surface",
+					role: treatment.role,
+					backgroundCss: "transparent",
+					foregroundCss: input.surface?.foregroundCss ?? surfaceForegroundValue(treatment.role)
+				}
+			};
 		case "solid": return resolveSolid(input, treatment.colorToken);
 		case "gradient": return resolveGradient(input, treatment);
 	}
 }
 function resolveFocusIndicator(colour) {
 	switch (colour.kind) {
-		case "solid": return {
+		case "solid":
+		case "known-solid": return {
 			kind: "two-tone",
 			innerCss: colour.foregroundCss,
 			outerCss: colour.backgroundCss,
@@ -1207,7 +1313,7 @@ function resolveSolid(input, backgroundToken) {
 			foregroundToken
 		}
 	};
-	const contrast = validateContrast({
+	const contrast = validateButtonTextContrast({
 		...input,
 		background: backgroundToken,
 		backgroundHex: backgroundHex.hex,
@@ -1215,6 +1321,14 @@ function resolveSolid(input, backgroundToken) {
 		foregroundHex
 	});
 	if (!contrast.ok) return contrast;
+	if (input.surface) {
+		const boundary = validateButtonSurfaceContrast({
+			...input,
+			buttonPaint: backgroundHex.hex,
+			surfaceHex: input.surface.backgroundHex
+		});
+		if (!boundary.ok) return boundary;
+	}
 	return {
 		ok: true,
 		colour: {
@@ -1244,7 +1358,7 @@ function resolveGradient(input, treatment) {
 		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
 			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
 			const sampleHex = interpolateHex(start, end, position);
-			const contrast = validateContrast({
+			const contrast = validateButtonTextContrast({
 				...input,
 				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
 				backgroundHex: sampleHex,
@@ -1252,6 +1366,14 @@ function resolveGradient(input, treatment) {
 				foregroundHex: foregroundHex.hex
 			});
 			if (!contrast.ok) return contrast;
+			if (input.surface) {
+				const boundary = validateButtonSurfaceContrast({
+					...input,
+					buttonPaint: sampleHex,
+					surfaceHex: input.surface.backgroundHex
+				});
+				if (!boundary.ok) return boundary;
+			}
 		}
 	}
 	const direction = GRADIENT_DIRECTION_MAP$1[treatment.direction] ?? "to right";
@@ -1281,21 +1403,6 @@ function paletteHex(input, token) {
 		}
 	};
 }
-function validateContrast(input) {
-	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
-	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
-		ok: false,
-		error: {
-			tag: "insufficient_contrast",
-			variantId: input.variantId,
-			state: input.state,
-			background: input.background,
-			foreground: input.foreground,
-			ratio,
-			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
-		}
-	};
-}
 function tokenCss(token) {
 	return `rgb(var(--tb-${token}))`;
 }
@@ -1440,37 +1547,105 @@ function shadeBackgroundEffect(config) {
 	};
 }
 //#endregion
+//#region ../theme-core/src/utils/colorStyles.ts
+const COLOR_VAR_PREFIX = "--tb-";
+function parseToken(source) {
+	const parts = parseColorTokenParts(source);
+	if (parts.kind === "raw") return {
+		token: source,
+		raw: parts.value
+	};
+	if (parts.kind === "invalid") return { token: source };
+	return {
+		token: parts.token,
+		opacityPercent: parts.opacityPercent === null ? void 0 : parts.opacityPercent
+	};
+}
+/**
+* Converts a theme color token to a CSS rgb value.
+* This is the primary function for applying theme colors to CSS properties.
+*
+* @param token - Theme color token (semantic, with opacity, or raw)
+* @returns CSS color value (rgb with optional alpha, or raw CSS value)
+*
+* @example
+* rgbColorValue('primary') // => 'rgb(var(--tb-primary))'
+* rgbColorValue('surface/95') // => 'rgb(var(--tb-surface) / 0.95)'
+* rgbColorValue('raw:transparent') // => 'transparent'
+*/
+function rgbColorValue(token) {
+	const { token: baseToken, opacityPercent, raw } = parseToken(token);
+	if (raw) return raw;
+	const cssVar = `${COLOR_VAR_PREFIX}${baseToken}`;
+	if (opacityPercent === void 0) return `rgb(var(${cssVar}))`;
+	return `rgb(var(${cssVar}) / ${opacityPercent / 100})`;
+}
+/**
+* Converts a theme color token to a CSS variable reference.
+* Note: This returns the base variable without rgb() wrapper, ignoring opacity.
+*
+* @param token - Theme color token
+* @returns CSS variable reference
+*
+* @example
+* cssVarValue('primary') // => 'var(--tb-primary)'
+* cssVarValue('surface/95') // => 'var(--tb-surface)' (opacity ignored)
+*/
+function cssVarValue(token) {
+	const { token: baseToken } = parseToken(token);
+	return `var(${COLOR_VAR_PREFIX}${baseToken})`;
+}
+//#endregion
+//#region ../theme-core/src/utils/tokenOrColor.ts
+/**
+* Runtime color-reference fields intentionally accept any string, including
+* the legacy empty-string "no color" sentinel. Semantic validation needs
+* palette context and happens in `parseThemeColorReference`.
+*/
+const tokenOrCssColorValueSchema = z.string();
+//#endregion
+//#region ../theme-core/src/buttons/buttonSurfaceContext.ts
+function actionVariableName(role, state, property) {
+	return `--rb-action-${role}-${state}-${property}`;
+}
+function actionVariableFallback(role, state, property, fallback) {
+	return `var(${actionVariableName(role, state, property)}, ${fallback})`;
+}
+//#endregion
 //#region ../theme-core/src/buttons/resolvedButtonCss.ts
 /**
 * Canonical colour declaration mapping shared by full themes and ThemeBridge.
 * Both background properties are always emitted so transitions cannot retain
 * a stale gradient or solid layer.
 */
-function resolvedButtonColourDeclarations(colour) {
+function resolvedButtonColourDeclarations(colour, action) {
+	const value = (property, fallback) => action ? actionVariableFallback(action.role, action.state, property, fallback) : fallback;
 	switch (colour.kind) {
-		case "solid": return [
-			["background-color", colour.backgroundCss],
-			["background-image", "none"],
-			["color", colour.foregroundCss]
+		case "solid":
+		case "known-solid": return [
+			["background-color", value("background-color", colour.backgroundCss)],
+			["background-image", value("background-image", "none")],
+			["color", value("color", colour.foregroundCss)]
 		];
 		case "gradient": return [
-			["background-color", "transparent"],
-			["background-image", colour.backgroundCss],
-			["color", colour.foregroundCss]
+			["background-color", value("background-color", "transparent")],
+			["background-image", value("background-image", colour.backgroundCss)],
+			["color", value("color", colour.foregroundCss)]
 		];
 		case "surface": return [
-			["background-color", colour.backgroundCss],
-			["background-image", "none"],
-			["color", colour.foregroundCss]
+			["background-color", value("background-color", colour.backgroundCss)],
+			["background-image", value("background-image", "none")],
+			["color", value("color", colour.foregroundCss)]
 		];
 	}
 }
-function resolvedButtonFocusDeclarations(indicator) {
+function resolvedButtonFocusDeclarations(indicator, role) {
+	const value = (property, fallback) => role ? actionVariableFallback(role, "focus", property, fallback) : fallback;
 	return indicator.kind === "two-tone" ? [
-		["outline", `2px solid ${indicator.innerCss}`],
-		["outline-offset", "2px"],
-		["box-shadow", `0 0 0 4px ${indicator.outerCss}`]
-	] : [["outline", `3px solid ${indicator.colorCss}`], ["outline-offset", "3px"]];
+		["outline", value("outline", `2px solid ${indicator.innerCss}`)],
+		["outline-offset", value("outline-offset", "2px")],
+		["box-shadow", value("box-shadow", `0 0 0 4px ${indicator.outerCss}`)]
+	] : [["outline", value("outline", `3px solid ${indicator.colorCss}`)], ["outline-offset", value("outline-offset", "3px")]];
 }
 /**
 * Disabled buttons retain their validated colour pair and add a non-layout
@@ -1528,6 +1703,7 @@ function resolveButtonStyleRecipe(recipe, parameters) {
 	const buttonSystem = {
 		global: definition.global,
 		variants: PUBLIC_BUTTON_ROLES.map((role) => roles[role]),
+		surfacePolicy: definition.surfacePolicy ?? createStandardButtonSurfacePolicy(),
 		...definition.sizes ? { sizes: definition.sizes } : {}
 	};
 	const parsedButtonSystem = buttonSystemSchema.safeParse(buttonSystem);
@@ -1588,15 +1764,15 @@ const BUTTON_STYLE_IDS = [
 	"ornate-ritual",
 	"quiet-arrow"
 ];
-const quietArrowParametersSchema = z$1.object({ secondaryTreatment: z$1.enum(["outlined", "solid-accent"]) }).strict();
-const emptyParametersSchema$1 = z$1.object({}).strict();
+const quietArrowParametersSchema = z.object({ secondaryTreatment: z.enum(["outlined", "solid-accent"]) }).strict();
+const emptyParametersSchema$1 = z.object({}).strict();
 function selectionBranch(styleId, parameters) {
-	return z$1.object({
-		styleId: z$1.literal(styleId),
+	return z.object({
+		styleId: z.literal(styleId),
 		parameters
 	}).strict();
 }
-const buttonStyleSelectionSchema = z$1.discriminatedUnion("styleId", [
+const buttonStyleSelectionSchema = z.discriminatedUnion("styleId", [
 	selectionBranch("soft-pill", emptyParametersSchema$1),
 	selectionBranch("earth-pill", emptyParametersSchema$1),
 	selectionBranch("confident-chip", emptyParametersSchema$1),
@@ -1741,7 +1917,7 @@ const quietArrowRecipe = defineButtonStyleRecipe({
 });
 //#endregion
 //#region ../theme-core/src/buttons/styles/recipes/defineStaticButtonStyleRecipe.ts
-const emptyParametersSchema = z$1.object({}).strict();
+const emptyParametersSchema = z.object({}).strict();
 function defineStaticButtonStyleRecipe(input) {
 	const system = normalizeSystem(input.system);
 	return defineButtonStyleRecipe({
@@ -3107,7 +3283,7 @@ function presetCategory(recipe) {
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
 const boxlessCardVariantValue = "none";
-const cardSpacingSchema = z$1.enum([
+const cardSpacingSchema = z.enum([
 	"none",
 	"compact",
 	"cozy",
@@ -3115,7 +3291,7 @@ const cardSpacingSchema = z$1.enum([
 	"comfortable",
 	"spacious"
 ]);
-const gradientDirectionSchema = z$1.enum([
+const gradientDirectionSchema = z.enum([
 	"to-r",
 	"to-l",
 	"to-t",
@@ -3125,27 +3301,27 @@ const gradientDirectionSchema = z$1.enum([
 	"to-br",
 	"to-bl"
 ]);
-z$1.enum(cardVariantRoleValues);
-const boxStylesCardVariantSchema = z$1.enum([...cardVariantRoleValues, boxlessCardVariantValue]);
-const cardBackgroundSchema = z$1.discriminatedUnion("type", [
-	z$1.object({
-		type: z$1.literal("solid"),
+z.enum(cardVariantRoleValues);
+const boxStylesCardVariantSchema = z.enum([...cardVariantRoleValues, boxlessCardVariantValue]);
+const cardBackgroundSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("solid"),
 		colorToken: themeColorTokenSchema
 	}),
-	z$1.object({
-		type: z$1.literal("gradient"),
+	z.object({
+		type: z.literal("gradient"),
 		fromToken: themeColorTokenSchema,
 		toToken: themeColorTokenSchema,
 		direction: gradientDirectionSchema
 	}),
-	z$1.object({ type: z$1.literal("transparent") })
+	z.object({ type: z.literal("transparent") })
 ]);
-const cardBorderSchema = z$1.object({
-	widthClass: z$1.string(),
+const cardBorderSchema = z.object({
+	widthClass: z.string(),
 	colorToken: themeColorTokenSchema
 });
 /** Per-corner radius value. `expressive` is a large block-radius multiple. */
-const cardCornerValueSchema = z$1.enum([
+const cardCornerValueSchema = z.enum([
 	"square",
 	"soft",
 	"rounded",
@@ -3156,54 +3332,54 @@ const cardCornerValueSchema = z$1.enum([
 * A single accented card edge (e.g. a left accent bar). When set, it replaces
 * the full `border` so the card reads as edge-accented rather than outlined.
 */
-const cardAccentEdgeSchema = z$1.object({
-	edge: z$1.enum([
+const cardAccentEdgeSchema = z.object({
+	edge: z.enum([
 		"left",
 		"top",
 		"right",
 		"bottom"
 	]),
 	colorToken: themeColorTokenSchema,
-	width: z$1.enum([
+	width: z.enum([
 		"thin",
 		"medium",
 		"thick",
 		"heavy"
 	])
 });
-const cardCornerRadiiSchema = z$1.object({
+const cardCornerRadiiSchema = z.object({
 	topLeft: cardCornerValueSchema.optional(),
 	topRight: cardCornerValueSchema.optional(),
 	bottomLeft: cardCornerValueSchema.optional(),
 	bottomRight: cardCornerValueSchema.optional()
 });
-const cardVariantSchema = z$1.object({
-	id: z$1.string(),
-	name: z$1.string().min(1).max(20),
-	enabled: z$1.boolean(),
-	priority: z$1.union([
-		z$1.literal(1),
-		z$1.literal(2),
-		z$1.literal(3)
+const cardVariantSchema = z.object({
+	id: z.string(),
+	name: z.string().min(1).max(20),
+	enabled: z.boolean(),
+	priority: z.union([
+		z.literal(1),
+		z.literal(2),
+		z.literal(3)
 	]),
 	background: cardBackgroundSchema,
 	spacing: cardSpacingSchema,
 	foregroundToken: themeColorTokenSchema.optional(),
-	shadow: z$1.object({
-		elevation: z$1.enum([
+	shadow: z.object({
+		elevation: z.enum([
 			"none",
 			"low",
 			"medium",
 			"high"
 		]),
-		softness: z$1.enum([
+		softness: z.enum([
 			"crisp",
 			"soft",
 			"hard"
 		]).nullable(),
-		position: z$1.enum(["bottom", "bottom-right"]).default("bottom")
+		position: z.enum(["bottom", "bottom-right"]).default("bottom")
 	}).optional(),
-	corners: z$1.enum([
+	corners: z.enum([
 		"square",
 		"soft",
 		"rounded",
@@ -3213,7 +3389,7 @@ const cardVariantSchema = z$1.object({
 	border: cardBorderSchema.optional(),
 	accentEdge: cardAccentEdgeSchema.optional()
 });
-const cardSystemSchema = z$1.object({ variants: z$1.array(cardVariantSchema).min(1).max(3) });
+const cardSystemSchema = z.object({ variants: z.array(cardVariantSchema).min(1).max(3) });
 //#endregion
 //#region ../theme-core/src/cards/core.ts
 /**
@@ -3387,7 +3563,7 @@ function getDefaultCardVariants() {
 /**
 * Accordion icon styles for expand/collapse indicators
 */
-const accordionIconSchema = z$1.enum([
+const accordionIconSchema = z.enum([
 	"plus-minus",
 	"chevron",
 	"caret",
@@ -3398,12 +3574,12 @@ const accordionIconSchema = z$1.enum([
 * Accordion configuration for a theme
 * Single style per theme (no variants needed)
 */
-const accordionSystemSchema = z$1.object({
-	background: z$1.object({
-		type: z$1.literal("solid"),
+const accordionSystemSchema = z.object({
+	background: z.object({
+		type: z.literal("solid"),
 		colorToken: themeColorTokenSchema
 	}).nullable(),
-	spacing: z$1.enum([
+	spacing: z.enum([
 		"none",
 		"compact",
 		"cozy",
@@ -3411,84 +3587,84 @@ const accordionSystemSchema = z$1.object({
 		"comfortable",
 		"spacious"
 	]),
-	corners: z$1.enum([
+	corners: z.enum([
 		"square",
 		"soft",
 		"rounded",
 		"pill"
 	]).nullable(),
-	border: z$1.object({
-		widthClass: z$1.string(),
+	border: z.object({
+		widthClass: z.string(),
 		colorToken: themeColorTokenSchema
 	}).nullable(),
-	shadow: z$1.object({
-		elevation: z$1.enum([
+	shadow: z.object({
+		elevation: z.enum([
 			"none",
 			"low",
 			"medium",
 			"high"
 		]),
-		softness: z$1.enum([
+		softness: z.enum([
 			"soft",
 			"crisp",
 			"hard"
 		]).nullable(),
-		position: z$1.enum(["bottom", "bottom-right"])
+		position: z.enum(["bottom", "bottom-right"])
 	}).nullable(),
-	icon: z$1.object({
+	icon: z.object({
 		style: accordionIconSchema,
-		position: z$1.enum(["left", "right"]),
-		size: z$1.enum([
+		position: z.enum(["left", "right"]),
+		size: z.enum([
 			"sm",
 			"md",
 			"lg"
 		]),
 		colorToken: themeColorTokenSchema.optional()
 	}),
-	trigger: z$1.object({
+	trigger: z.object({
 		textColorToken: themeColorTokenSchema,
-		fontWeight: z$1.enum([
+		fontWeight: z.enum([
 			"regular",
 			"medium",
 			"semibold",
 			"bold"
 		]).nullable(),
-		fontFamily: z$1.enum(["body", "heading"]).optional(),
-		fontScale: z$1.enum([
+		fontFamily: z.enum(["body", "heading"]).optional(),
+		fontScale: z.enum([
 			"body",
 			"md",
 			"lg"
 		]).optional(),
-		letterSpacing: z$1.enum([
+		letterSpacing: z.enum([
 			"normal",
 			"tight",
 			"wide"
 		]).optional(),
-		textTransform: z$1.enum(["none", "uppercase"]).optional()
+		textTransform: z.enum(["none", "uppercase"]).optional()
 	}),
-	hover: z$1.object({
+	hover: z.object({
 		backgroundColorToken: themeColorTokenSchema.optional(),
 		textColorToken: themeColorTokenSchema.optional(),
 		borderColorToken: themeColorTokenSchema.optional()
 	}),
-	openState: z$1.object({
+	openState: z.object({
 		backgroundColorToken: themeColorTokenSchema.optional(),
 		triggerColorToken: themeColorTokenSchema.optional(),
-		accent: z$1.object({
-			edge: z$1.enum([
+		accent: z.object({
+			edge: z.enum([
 				"left",
 				"top",
 				"bottom"
 			]),
 			colorToken: themeColorTokenSchema,
-			thickness: z$1.enum([
+			thickness: z.enum([
 				"thin",
 				"medium",
 				"thick"
 			])
 		}).optional()
 	}).optional(),
-	content: z$1.object({ textColorToken: themeColorTokenSchema })
+	content: z.object({ textColorToken: themeColorTokenSchema })
 });
 //#endregion
 //#region ../theme-core/src/inputs/types.ts
@@ -3502,80 +3678,80 @@ const accordionSystemSchema = z$1.object({
 *
 * Single configuration per theme (no variants needed for inputs)
 */
-const inputSystemSchema = z$1.object({
-	base: z$1.object({
-		background: z$1.union([z$1.object({
-			type: z$1.literal("solid"),
+const inputSystemSchema = z.object({
+	base: z.object({
+		background: z.union([z.object({
+			type: z.literal("solid"),
 			colorToken: themeColorTokenSchema
-		}), z$1.object({ type: z$1.literal("transparent") })]),
+		}), z.object({ type: z.literal("transparent") })]),
 		textColorToken: themeColorTokenSchema,
-		border: z$1.object({
-			widthClass: z$1.string(),
+		border: z.object({
+			widthClass: z.string(),
 			colorToken: themeColorTokenSchema,
-			style: z$1.enum(["all", "underline"]).optional()
+			style: z.enum(["all", "underline"]).optional()
 		}),
-		corners: z$1.enum([
+		corners: z.enum([
 			"square",
 			"soft",
 			"rounded",
 			"pill"
 		]).nullable(),
-		shadow: z$1.object({
-			elevation: z$1.enum([
+		shadow: z.object({
+			elevation: z.enum([
 				"none",
 				"low",
 				"medium"
 			]),
-			softness: z$1.enum([
+			softness: z.enum([
 				"soft",
 				"crisp",
 				"hard"
 			]).nullable()
 		}).nullable(),
-		spacing: z$1.enum([
+		spacing: z.enum([
 			"compact",
 			"cozy",
 			"medium",
 			"comfortable"
 		]),
-		fontSize: z$1.enum([
+		fontSize: z.enum([
 			"sm",
 			"base",
 			"lg"
 		])
 	}),
-	label: z$1.object({
+	label: z.object({
 		textColorToken: themeColorTokenSchema,
-		fontWeight: z$1.enum([
+		fontWeight: z.enum([
 			"regular",
 			"medium",
 			"semibold",
 			"bold",
 			"black"
 		]),
-		fontSize: z$1.enum([
+		fontSize: z.enum([
 			"2xs",
 			"xs",
 			"sm",
 			"base"
 		]),
-		textTransform: z$1.enum([
+		textTransform: z.enum([
 			"none",
 			"uppercase",
 			"lowercase",
 			"capitalize"
 		]).optional(),
-		letterSpacing: z$1.enum([
+		letterSpacing: z.enum([
 			"normal",
 			"wide",
 			"wider",
 			"widest"
 		]).optional(),
-		opacity: z$1.number().min(.2).max(1).optional()
+		opacity: z.number().min(.2).max(1).optional()
 	}),
-	focus: z$1.object({
+	focus: z.object({
 		ringColorToken: themeColorTokenSchema,
-		ringWidth: z$1.enum([
+		ringWidth: z.enum([
 			"0",
 			"1",
 			"2",
@@ -3583,14 +3759,14 @@ const inputSystemSchema = z$1.object({
 		]),
 		borderColorToken: themeColorTokenSchema.optional()
 	}),
-	error: z$1.object({
+	error: z.object({
 		borderColorToken: themeColorTokenSchema,
 		textColorToken: themeColorTokenSchema
 	}),
-	disabled: z$1.object({
+	disabled: z.object({
 		backgroundColorToken: themeColorTokenSchema,
 		textColorToken: themeColorTokenSchema,
-		opacity: z$1.number().min(.3).max(.7)
+		opacity: z.number().min(.3).max(.7)
 	})
 });
 //#endregion
@@ -3601,9 +3777,9 @@ const inputSystemSchema = z$1.object({
 /**
 * Gradient color stop
 */
-const gradientStopSchema = z$1.object({
+const gradientStopSchema = z.object({
 	color: themeColorTokenSchema,
-	position: z$1.number().min(0).max(100)
+	position: z.number().min(0).max(100)
 });
 /**
 * Radial gradient shape. Optional; defaults to `circle` (the historical shape)
@@ -3612,7 +3788,7 @@ const gradientStopSchema = z$1.object({
 * Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
 * `GradientShape` (which names the gradient *kind*: linear/radial/conic).
 */
-const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
+const radialGradientShapeSchema = z.enum(["circle", "ellipse"]);
 /**
 * Gradient configuration.
 *
@@ -3623,16 +3799,16 @@ const radialGradientShapeSchema = z$1.enum(["circle", "ellipse"]);
 *   - radial: optional `shape` (circle/ellipse) + `position`
 *   - conic:  optional `angle` (from-angle, degrees) + `position`
 */
-const gradientConfigSchema = z$1.object({
-	type: z$1.enum([
+const gradientConfigSchema = z.object({
+	type: z.enum([
 		"linear",
 		"radial",
 		"conic"
 	]).default("linear"),
-	angle: z$1.number().min(0).max(360).optional(),
+	angle: z.number().min(0).max(360).optional(),
 	shape: radialGradientShapeSchema.optional(),
-	position: z$1.string().optional(),
-	stops: z$1.array(gradientStopSchema).min(2)
+	position: z.string().optional(),
+	stops: z.array(gradientStopSchema).min(2)
 });
 //#endregion
 //#region ../theme-core/src/interactive/baseSchema.ts
@@ -3644,46 +3820,46 @@ const gradientConfigSchema = z$1.object({
 /**
 * Typography settings shared by buttons and nav links
 */
-const interactiveTypographySchema = z$1.object({
+const interactiveTypographySchema = z.object({
 	/** Font family source */
-	typography: z$1.enum(["body", "heading"]).default("body"),
+	typography: z.enum(["body", "heading"]).default("body"),
 	/** Font weight */
-	fontWeight: z$1.enum([
+	fontWeight: z.enum([
 		"regular",
 		"medium",
 		"semibold",
 		"bold"
 	]).default("medium"),
 	/** Text transform */
-	textTransform: z$1.enum([
+	textTransform: z.enum([
 		"none",
 		"uppercase",
 		"capitalize"
 	]).default("none"),
 	/** Italic style */
-	italic: z$1.boolean().default(false)
+	italic: z.boolean().default(false)
 });
 /**
 * Effect application reference (shared between buttons and nav)
 */
-const effectApplicationSchema = z$1.object({
+const effectApplicationSchema = z.object({
 	/** Effect preset ID */
-	effectId: z$1.string(),
+	effectId: z.string(),
 	/** User-provided customization options */
-	options: z$1.record(z$1.string(), z$1.any()).optional()
+	options: z.record(z.string(), z.any()).optional()
 });
 /**
 * Effect composition by state (shared pattern)
 */
-const effectCompositionSchema = z$1.object({
+const effectCompositionSchema = z.object({
 	/** Effects always applied */
-	base: z$1.array(effectApplicationSchema).optional(),
+	base: z.array(effectApplicationSchema).optional(),
 	/** Effects applied on hover */
-	hover: z$1.array(effectApplicationSchema).optional(),
+	hover: z.array(effectApplicationSchema).optional(),
 	/** Effects applied on active/pressed */
-	active: z$1.array(effectApplicationSchema).optional(),
+	active: z.array(effectApplicationSchema).optional(),
 	/** Effects applied on focus */
-	focus: z$1.array(effectApplicationSchema).optional()
+	focus: z.array(effectApplicationSchema).optional()
 });
 //#endregion
 //#region ../theme-core/src/navigation/types.ts
@@ -3695,7 +3871,7 @@ const effectCompositionSchema = z$1.object({
 /**
 * Padding preset options for nav links
 */
-const navLinkPaddingSchema = z$1.enum([
+const navLinkPaddingSchema = z.enum([
 	"none",
 	"compact",
 	"default"
@@ -3704,7 +3880,7 @@ const navLinkPaddingSchema = z$1.enum([
 * Horizontal padding override for nav links.
 * When set, overrides only the horizontal component of the `padding` preset.
 */
-const navLinkPaddingXSchema = z$1.enum([
+const navLinkPaddingXSchema = z.enum([
 	"none",
 	"tight",
 	"compact",
@@ -3715,7 +3891,7 @@ const navLinkPaddingXSchema = z$1.enum([
 /**
 * Border radius options for nav links
 */
-const navLinkBorderRadiusSchema = z$1.enum([
+const navLinkBorderRadiusSchema = z.enum([
 	"none",
 	"sm",
 	"md",
@@ -3724,7 +3900,7 @@ const navLinkBorderRadiusSchema = z$1.enum([
 /**
 * Typography size options for nav links.
 */
-const navLinkTextSizeSchema = z$1.enum([
+const navLinkTextSizeSchema = z.enum([
 	"xs",
 	"sm",
 	"base",
@@ -3734,7 +3910,7 @@ const navLinkTextSizeSchema = z$1.enum([
 /**
 * Letter spacing options for nav links.
 */
-const navLinkLetterSpacingSchema = z$1.enum([
+const navLinkLetterSpacingSchema = z.enum([
 	"normal",
 	"wide",
 	"wider",
@@ -3743,15 +3919,15 @@ const navLinkLetterSpacingSchema = z$1.enum([
 /**
 * Optional legibility aid for nav text that floats over uncertain imagery or color.
 */
-const navLinkContrastTreatmentSchema = z$1.enum(["none", "soft-glow"]);
+const navLinkContrastTreatmentSchema = z.enum(["none", "soft-glow"]);
 /**
 * Nav link style schema
 *
 * Extends interactive typography base with nav-specific settings.
 */
-const navLinkStyleSchema = z$1.object({
+const navLinkStyleSchema = z.object({
 	/** Display name for the style */
-	name: z$1.string().min(1).max(30).optional(),
+	name: z.string().min(1).max(30).optional(),
 	/** Typography settings (inherited from interactive base) */
 	...interactiveTypographySchema.shape,
 	/** Text color token */
@@ -3836,7 +4012,7 @@ function containsForbiddenSelector(selector) {
 /**
 * Validates a CSS selector for safety.
 */
-const selectorSchema = z$1.string().min(1, "Selector cannot be empty").max(200, "Selector too long (max 200 characters)").refine((s) => !containsForbiddenSelector(s), { message: "Global selectors (:root, html, body, *) are not allowed" });
+const selectorSchema = z.string().min(1, "Selector cannot be empty").max(200, "Selector too long (max 200 characters)").refine((s) => !containsForbiddenSelector(s), { message: "Global selectors (:root, html, body, *) are not allowed" });
 /**
 * Check if a CSS value contains a remote URL.
 */
@@ -3854,31 +4030,31 @@ function containsJavascriptUrl(value) {
 * Allows: url(#id), url(data:...), url(/path), var(--)
 * Forbids: url(http...), url(//...), javascript:
 */
-const declarationValueSchema = z$1.string().max(500, "Declaration value too long (max 500 characters)").refine((v) => !containsRemoteUrl(v), { message: "Remote url() references are not allowed. Use local paths, data URIs, or fragment IDs." }).refine((v) => !containsJavascriptUrl(v), { message: "javascript: URLs are not allowed" });
+const declarationValueSchema = z.string().max(500, "Declaration value too long (max 500 characters)").refine((v) => !containsRemoteUrl(v), { message: "Remote url() references are not allowed. Use local paths, data URIs, or fragment IDs." }).refine((v) => !containsJavascriptUrl(v), { message: "javascript: URLs are not allowed" });
 /**
 * Schema for CSS declarations object (property -> value map).
 */
-const declarationsSchema = z$1.record(z$1.string().min(1).max(100), declarationValueSchema);
+const declarationsSchema = z.record(z.string().min(1).max(100), declarationValueSchema);
 /**
 * Schema for a single custom CSS rule.
 */
-const customCssRuleSchema = z$1.object({
-	id: z$1.string().min(1, "Rule ID is required").max(50, "Rule ID too long"),
+const customCssRuleSchema = z.object({
+	id: z.string().min(1, "Rule ID is required").max(50, "Rule ID too long"),
 	selector: selectorSchema,
 	declarations: declarationsSchema
 });
 /**
 * Schema for block-specific CSS rule.
 */
-const blockCustomCssRuleSchema = customCssRuleSchema.extend({ blockKind: z$1.string().min(1, "Block kind is required").max(50, "Block kind too long") });
+const blockCustomCssRuleSchema = customCssRuleSchema.extend({ blockKind: z.string().min(1, "Block kind is required").max(50, "Block kind too long") });
 /**
 * Array of custom CSS rules for theme-level styling.
 */
-const customCssRulesSchema = z$1.array(customCssRuleSchema).optional();
+const customCssRulesSchema = z.array(customCssRuleSchema).optional();
 /**
 * Array of block-specific CSS rules.
 */
-const blockCustomCssRulesSchema = z$1.array(blockCustomCssRuleSchema).optional();
+const blockCustomCssRulesSchema = z.array(blockCustomCssRuleSchema).optional();
 function toValidatedCssSelector(value) {
 	return value;
 }
@@ -3916,9 +4092,9 @@ const BLOCKED_AT_RULES = ["@import", "@charset"];
 /** Pattern to detect blocked at-rules */
 const BLOCKED_AT_RULE_PATTERN = /@(?:import|charset)\b/i;
 /** Rule ID schema - reused from main validation */
-const ruleIdSchema = z$1.string().min(1, "Rule ID is required").max(50, "Rule ID too long");
+const ruleIdSchema = z.string().min(1, "Rule ID is required").max(50, "Rule ID too long");
 /** Nested rule schema for @media and @supports */
-const nestedRuleSchema = z$1.object({
+const nestedRuleSchema = z.object({
 	selector: selectorSchema,
 	declarations: declarationsSchema
 });
@@ -3935,46 +4111,46 @@ function isValidKeyframeOffset(offset) {
 	return value >= 0 && value <= 100;
 }
 /** Keyframe offset validation (0%, 50%, 100%, from, to) */
-const keyframeOffsetSchema = z$1.string().transform((offset) => offset.trim()).refine((offset) => KEYFRAME_OFFSET_PATTERN.test(offset), { message: "Invalid keyframe offset. Use percentages (0%, 50%, 100%) or \"from\"/\"to\"" }).refine(isValidKeyframeOffset, { message: "Keyframe offset must be between 0% and 100%" });
+const keyframeOffsetSchema = z.string().transform((offset) => offset.trim()).refine((offset) => KEYFRAME_OFFSET_PATTERN.test(offset), { message: "Invalid keyframe offset. Use percentages (0%, 50%, 100%) or \"from\"/\"to\"" }).refine(isValidKeyframeOffset, { message: "Keyframe offset must be between 0% and 100%" });
 /** Animation name validation (CSS identifier) */
-const animationNameSchema = z$1.string().min(1, "Animation name is required").max(50, "Animation name too long").refine((name) => ANIMATION_NAME_PATTERN.test(name), { message: "Invalid animation name. Use letters, numbers, dashes, underscores (start with letter, dash, or underscore)" });
+const animationNameSchema = z.string().min(1, "Animation name is required").max(50, "Animation name too long").refine((name) => ANIMATION_NAME_PATTERN.test(name), { message: "Invalid animation name. Use letters, numbers, dashes, underscores (start with letter, dash, or underscore)" });
 /** Single keyframe (offset + declarations) */
-const keyframeSchema = z$1.object({
+const keyframeSchema = z.object({
 	offset: keyframeOffsetSchema,
 	declarations: declarationsSchema
 });
 /** @keyframes rule schema */
-const keyframesAtRuleSchema = z$1.object({
+const keyframesAtRuleSchema = z.object({
 	id: ruleIdSchema,
-	type: z$1.literal("keyframes"),
+	type: z.literal("keyframes"),
 	name: animationNameSchema,
-	frames: z$1.array(keyframeSchema).min(1, "At least one keyframe is required")
+	frames: z.array(keyframeSchema).min(1, "At least one keyframe is required")
 });
 /** Font-face declarations - uses standard declarations but with font-specific validation */
-const fontFaceDeclarationsSchema = z$1.record(z$1.string().min(1).max(100), declarationValueSchema).refine((decls) => "fontFamily" in decls || "font-family" in decls, { message: "font-family is required in @font-face" });
+const fontFaceDeclarationsSchema = z.record(z.string().min(1).max(100), declarationValueSchema).refine((decls) => "fontFamily" in decls || "font-family" in decls, { message: "font-family is required in @font-face" });
 /** @font-face rule schema */
-const fontFaceAtRuleSchema = z$1.object({
+const fontFaceAtRuleSchema = z.object({
 	id: ruleIdSchema,
-	type: z$1.literal("font-face"),
+	type: z.literal("font-face"),
 	declarations: fontFaceDeclarationsSchema
 });
 /** Media query string validation */
-const mediaQuerySchema = z$1.string().min(1, "Media query is required").max(200, "Media query too long");
+const mediaQuerySchema = z.string().min(1, "Media query is required").max(200, "Media query too long");
 /** @media rule schema */
-const mediaAtRuleSchema = z$1.object({
+const mediaAtRuleSchema = z.object({
 	id: ruleIdSchema,
-	type: z$1.literal("media"),
+	type: z.literal("media"),
 	query: mediaQuerySchema,
-	rules: z$1.array(nestedRuleSchema).min(1, "At least one rule is required")
+	rules: z.array(nestedRuleSchema).min(1, "At least one rule is required")
 });
 /** Supports condition string validation */
-const supportsConditionSchema = z$1.string().min(1, "Supports condition is required").max(200, "Supports condition too long");
+const supportsConditionSchema = z.string().min(1, "Supports condition is required").max(200, "Supports condition too long");
 /** @supports rule schema */
-const supportsAtRuleSchema = z$1.object({
+const supportsAtRuleSchema = z.object({
 	id: ruleIdSchema,
-	type: z$1.literal("supports"),
+	type: z.literal("supports"),
 	condition: supportsConditionSchema,
-	rules: z$1.array(nestedRuleSchema).min(1, "At least one rule is required")
+	rules: z.array(nestedRuleSchema).min(1, "At least one rule is required")
 });
 /**
 * Check if raw CSS contains blocked at-rules.
@@ -3983,17 +4159,17 @@ function containsBlockedAtRule(css) {
 	return BLOCKED_AT_RULE_PATTERN.test(css);
 }
 /** Raw CSS validation - blocks @import, @charset, must start with @ */
-const rawCssSchema = z$1.string().min(1, "CSS is required").max(5e3, "Raw CSS too long (max 5000 characters)").refine((css) => css.trim().startsWith("@"), { message: "Raw at-rule must start with @" }).refine((css) => !containsBlockedAtRule(css), { message: `Blocked at-rules: ${BLOCKED_AT_RULES.join(", ")}. Use typed at-rules or local assets instead.` });
+const rawCssSchema = z.string().min(1, "CSS is required").max(5e3, "Raw CSS too long (max 5000 characters)").refine((css) => css.trim().startsWith("@"), { message: "Raw at-rule must start with @" }).refine((css) => !containsBlockedAtRule(css), { message: `Blocked at-rules: ${BLOCKED_AT_RULES.join(", ")}. Use typed at-rules or local assets instead.` });
 /** Raw at-rule schema */
-const rawAtRuleSchema = z$1.object({
+const rawAtRuleSchema = z.object({
 	id: ruleIdSchema,
-	type: z$1.literal("raw"),
+	type: z.literal("raw"),
 	css: rawCssSchema
 });
 /**
 * Discriminated union schema for all at-rule types.
 */
-const customCssAtRuleSchema = z$1.discriminatedUnion("type", [
+const customCssAtRuleSchema = z.discriminatedUnion("type", [
 	keyframesAtRuleSchema,
 	fontFaceAtRuleSchema,
 	mediaAtRuleSchema,
@@ -4003,7 +4179,7 @@ const customCssAtRuleSchema = z$1.discriminatedUnion("type", [
 /**
 * Array of at-rules for theme-level styling.
 */
-const customCssAtRulesSchema = z$1.array(customCssAtRuleSchema).optional();
+const customCssAtRulesSchema = z.array(customCssAtRuleSchema).optional();
 //#endregion
 //#region ../theme-core/src/shared/componentStyles.ts
 /**
@@ -4021,22 +4197,22 @@ const customCssAtRulesSchema = z$1.array(customCssAtRuleSchema).optional();
 * Shared border schema for themed components.
 * Position is excluded - each component determines its own border position.
 */
-const componentBorderSchema = z$1.object({
-	width: z$1.enum([
+const componentBorderSchema = z.object({
+	width: z.enum([
 		"none",
 		"hairline",
 		"thin",
 		"medium",
 		"thick"
 	]).default("none"),
-	style: z$1.enum(["solid", "dashed"]).default("solid"),
+	style: z.enum(["solid", "dashed"]).default("solid"),
 	colorToken: themeColorTokenSchema.optional()
 });
 /**
 * Shared shadow schema for themed components.
 * Softness is inherited from global theme, not configurable per-component.
 */
-const componentShadowSchema = z$1.object({ elevation: z$1.enum([
+const componentShadowSchema = z.object({ elevation: z.enum([
 	"none",
 	"sm",
 	"md",
@@ -4070,9 +4246,6 @@ function asSiteStyleId(value) {
 function asDesignSystemTemplateId(value) {
 	return brandNonEmptyString(value, "DesignSystemTemplateId");
 }
-function assertNever(value, message = "Unhandled Theme V2 variant") {
-	throw new Error(`${message}: ${String(value)}`);
-}
 function brandNonEmptyString(value, label) {
 	if (value.length === 0) throw new Error(`${label} must be a non-empty string.`);
 	return value;
@@ -4168,43 +4341,43 @@ const logoDensityValues = [
 	"detailed",
 	"unknown"
 ];
-const logoContainsTextSchema = z$1.discriminatedUnion("kind", [
-	z$1.object({
-		kind: z$1.literal("contains-text"),
-		confidence: z$1.enum(logoTextConfidenceValues),
-		text: z$1.string().trim().min(1).max(200).optional()
+const logoContainsTextSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("contains-text"),
+		confidence: z.enum(logoTextConfidenceValues),
+		text: z.string().trim().min(1).max(200).optional()
 	}),
-	z$1.object({
-		kind: z$1.literal("no-text"),
-		confidence: z$1.enum(logoTextConfidenceValues)
+	z.object({
+		kind: z.literal("no-text"),
+		confidence: z.enum(logoTextConfidenceValues)
 	}),
-	z$1.object({
-		kind: z$1.literal("unknown"),
-		reason: z$1.enum([
+	z.object({
+		kind: z.literal("unknown"),
+		reason: z.enum([
 			"analysis-unavailable",
 			"unsupported-file",
 			"low-confidence"
 		])
 	})
 ]);
-const logoAnalysisSourceSchema = z$1.discriminatedUnion("kind", [
-	z$1.object({ kind: z$1.literal("none") }),
-	z$1.object({
-		kind: z$1.literal("deterministic"),
-		reason: z$1.enum(["dimensions", "fallback"])
+const logoAnalysisSourceSchema = z.discriminatedUnion("kind", [
+	z.object({ kind: z.literal("none") }),
+	z.object({
+		kind: z.literal("deterministic"),
+		reason: z.enum(["dimensions", "fallback"])
 	}),
-	z$1.object({
-		kind: z$1.literal("llm"),
-		model: z$1.literal("gpt-5.4-mini"),
-		analyzedAt: z$1.string().trim().min(1).max(80).optional()
+	z.object({
+		kind: z.literal("llm"),
+		model: z.literal("gpt-5.4-mini"),
+		analyzedAt: z.string().trim().min(1).max(80).optional()
 	}),
-	z$1.object({ kind: z$1.literal("manual-override") })
+	z.object({ kind: z.literal("manual-override") })
 ]);
-z$1.object({
-	shape: z$1.enum(logoAssetShapeValues),
+z.object({
+	shape: z.enum(logoAssetShapeValues),
 	containsText: logoContainsTextSchema,
-	kind: z$1.enum(logoKindValues),
-	density: z$1.enum(logoDensityValues),
+	kind: z.enum(logoKindValues),
+	density: z.enum(logoDensityValues),
 	source: logoAnalysisSourceSchema
 });
 const brandDisplayModeValues = [
@@ -4251,63 +4424,6 @@ new Set(themeV2NormalEditorRawStyleFieldNames);
 [...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
 const pageDesignEditorBackgroundOverrideOwner = "page-design-editor";
 const siteChromeBackgroundOverrideOwner = "site-chrome-editor";
-//#endregion
-//#region ../theme-core/src/utils/colorStyles.ts
-const COLOR_VAR_PREFIX = "--tb-";
-function parseToken(source) {
-	const parts = parseColorTokenParts(source);
-	if (parts.kind === "raw") return {
-		token: source,
-		raw: parts.value
-	};
-	if (parts.kind === "invalid") return { token: source };
-	return {
-		token: parts.token,
-		opacityPercent: parts.opacityPercent === null ? void 0 : parts.opacityPercent
-	};
-}
-/**
-* Converts a theme color token to a CSS rgb value.
-* This is the primary function for applying theme colors to CSS properties.
-*
-* @param token - Theme color token (semantic, with opacity, or raw)
-* @returns CSS color value (rgb with optional alpha, or raw CSS value)
-*
-* @example
-* rgbColorValue('primary') // => 'rgb(var(--tb-primary))'
-* rgbColorValue('surface/95') // => 'rgb(var(--tb-surface) / 0.95)'
-* rgbColorValue('raw:transparent') // => 'transparent'
-*/
-function rgbColorValue(token) {
-	const { token: baseToken, opacityPercent, raw } = parseToken(token);
-	if (raw) return raw;
-	const cssVar = `${COLOR_VAR_PREFIX}${baseToken}`;
-	if (opacityPercent === void 0) return `rgb(var(${cssVar}))`;
-	return `rgb(var(${cssVar}) / ${opacityPercent / 100})`;
-}
-/**
-* Converts a theme color token to a CSS variable reference.
-* Note: This returns the base variable without rgb() wrapper, ignoring opacity.
-*
-* @param token - Theme color token
-* @returns CSS variable reference
-*
-* @example
-* cssVarValue('primary') // => 'var(--tb-primary)'
-* cssVarValue('surface/95') // => 'var(--tb-surface)' (opacity ignored)
-*/
-function cssVarValue(token) {
-	const { token: baseToken } = parseToken(token);
-	return `var(${COLOR_VAR_PREFIX}${baseToken})`;
-}
-//#endregion
-//#region ../theme-core/src/utils/tokenOrColor.ts
-/**
-* Runtime color-reference fields intentionally accept any string, including
-* the legacy empty-string "no color" sentinel. Semantic validation needs
-* palette context and happens in `parseThemeColorReference`.
-*/
-const tokenOrCssColorValueSchema = z$1.string();
 const BREAKPOINT_LG = 1024;
 const BREAKPOINT_XL = 1280;
 const BREAKPOINT_LG_DOWN = BREAKPOINT_LG - 1;
@@ -4332,14 +4448,14 @@ mqDown(640);
 mqDown(768);
 //#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"])
+const headerScrollTreatmentSchema = z.discriminatedUnion("kind", [z.object({
+	kind: z.literal("contrast-glass"),
+	backgroundTone: z.enum(["light", "dark"])
 })]).optional();
 //#endregion
 //#region ../theme-core/src/header/containerSchema.ts
-const headerContainerSchema = z$1.object({
-	rounded: z$1.enum([
+const headerContainerSchema = z.object({
+	rounded: z.enum([
 		"none",
 		"sm",
 		"md",
@@ -4347,77 +4463,146 @@ const headerContainerSchema = z$1.object({
 		"xl",
 		"2xl"
 	]).default("xl"),
-	border: z$1.boolean().default(true),
-	shadow: z$1.boolean().default(true),
-	padding: z$1.enum([
+	border: z.boolean().default(true),
+	shadow: z.boolean().default(true),
+	padding: z.enum([
 		"sm",
 		"md",
 		"lg"
 	]).default("md"),
-	tint: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).default(.12)
+	tint: z.string().nullable().optional(),
+	opacity: z.number().min(0).max(1).default(.12)
 }).optional();
-const headerInteractionPaletteSchema = z$1.enum([
+const headerInteractionPaletteSchema = z.enum([
 	"primary",
 	"secondary",
 	"accent"
 ]);
 //#endregion
+//#region ../theme-core/src/boxBackgroundSchema.ts
+const boxBackgroundOverlaySchema = z.preprocess(normalizeAuthoringOpacity, z.discriminatedUnion("type", [
+	z.object({ type: z.literal("none") }),
+	z.object({
+		type: z.literal("color"),
+		color: tokenOrCssColorValueSchema.nullable().optional(),
+		opacity: z.number().min(0).max(1).nullable().optional()
+	}),
+	z.object({
+		type: z.literal("gradient"),
+		gradient: z.string().nullable().optional(),
+		opacity: z.number().min(0).max(1).nullable().optional()
+	})
+]));
+const commonSchema = z.object({
+	contentOwner: z.literal(pageDesignEditorBackgroundOverrideOwner).optional(),
+	textColor: tokenOrCssColorValueSchema.nullable().optional(),
+	headingColor: tokenOrCssColorValueSchema.nullable().optional(),
+	linkColor: tokenOrCssColorValueSchema.nullable().optional(),
+	supportingColor: tokenOrCssColorValueSchema.nullable().optional()
+});
+const mediaPresentationSchema = commonSchema.extend({
+	opacity: z.preprocess(normalizeOpacity, z.number().min(0).max(1).nullable()).optional(),
+	objectFit: z.enum([
+		"fill",
+		"fit",
+		"original",
+		"custom"
+	]).nullable().optional(),
+	scale: z.string().nullable().optional(),
+	position: z.string().nullable().optional(),
+	motion: z.enum(["static", "fixed-frame"]).nullable().optional(),
+	overflow: z.boolean().nullable().optional(),
+	overlay: boxBackgroundOverlaySchema.nullable().optional()
+});
+const boxBackgroundSchema = z.discriminatedUnion("type", [
+	commonSchema.extend({
+		type: z.literal("color"),
+		color: tokenOrCssColorValueSchema.nullable().optional()
+	}),
+	commonSchema.extend({
+		type: z.literal("gradient"),
+		gradient: z.string().nullable().optional(),
+		gradientPresetId: z.string().min(1).nullable().optional()
+	}),
+	mediaPresentationSchema.extend({
+		type: z.literal("image"),
+		image: imageMediaSchema.nullable().optional()
+	}),
+	mediaPresentationSchema.extend({
+		type: z.literal("video"),
+		image: videoMediaSchema.nullable().optional(),
+		showVideoOnMobile: z.boolean().nullable().optional()
+	})
+]);
+function normalizeAuthoringOpacity(value) {
+	if (!isRecord(value)) return value;
+	return {
+		...value,
+		opacity: normalizeOpacity(value.opacity)
+	};
+}
+function normalizeOpacity(value) {
+	return typeof value === "number" && value > 1 && value <= 100 ? value / 100 : value;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region ../theme-core/src/schema.ts
-const axesSchema = z$1.object({
-	tone: z$1.enum([
+const axesSchema = z.object({
+	tone: z.enum([
 		"minimal",
 		"classic",
 		"bold"
 	]),
-	energy: z$1.enum(["calm", "vibrant"]),
-	density: z$1.enum([
+	energy: z.enum(["calm", "vibrant"]),
+	density: z.enum([
 		"airy",
 		"regular",
 		"compact"
 	]),
-	mediaBias: z$1.enum([
+	mediaBias: z.enum([
 		"text",
 		"media",
 		"mixed"
 	]),
-	conversionBias: z$1.enum([
+	conversionBias: z.enum([
 		"low",
 		"med",
 		"high"
 	]),
-	motion: z$1.enum([
+	motion: z.enum([
 		"subtle",
 		"standard",
 		"expressive"
 	])
 });
-const typographyStyleSchema = z$1.object({
-	family: z$1.string().min(1),
-	weight: z$1.enum([
+const typographyStyleSchema = z.object({
+	family: z.string().min(1),
+	weight: z.enum([
 		"light",
 		"regular",
 		"medium",
 		"semibold",
 		"bold"
 	]),
-	letterSpacing: z$1.enum([
+	letterSpacing: z.enum([
 		"tight",
 		"normal",
 		"loose"
 	]),
-	lineHeight: z$1.enum([
+	lineHeight: z.enum([
 		"normal",
 		"relaxed",
 		"loose"
 	])
 });
-const bodyTypographyStyleSchema = typographyStyleSchema.extend({ size: z$1.enum([
+const bodyTypographyStyleSchema = typographyStyleSchema.extend({ size: z.enum([
 	"md",
 	"lg",
 	"xl"
 ]) });
-const headingSizeSchema = z$1.enum([
+const headingSizeSchema = z.enum([
 	"xs",
 	"sm",
 	"md",
@@ -4425,68 +4610,68 @@ const headingSizeSchema = z$1.enum([
 	"xl",
 	"2xl"
 ]);
-const headingTypographyOverridesSchema = z$1.object({
-	weight: z$1.enum([
+const headingTypographyOverridesSchema = z.object({
+	weight: z.enum([
 		"light",
 		"regular",
 		"medium",
 		"semibold",
 		"bold"
 	]).nullable().optional(),
-	letterSpacing: z$1.enum([
+	letterSpacing: z.enum([
 		"tight",
 		"normal",
 		"loose"
 	]).nullable().optional(),
 	size: headingSizeSchema.nullable().optional(),
-	lineHeight: z$1.enum([
+	lineHeight: z.enum([
 		"tight",
 		"snug",
 		"normal",
 		"relaxed",
 		"loose"
 	]).nullable().optional(),
-	italic: z$1.boolean().nullable().optional(),
+	italic: z.boolean().nullable().optional(),
 	colorToken: themeColorTokenSchema.nullable().optional()
 });
 const headingTypographyStyleSchema = typographyStyleSchema.extend({
-	case: z$1.enum([
+	case: z.enum([
 		"uppercase",
 		"normal",
 		"smallCaps"
 	]).nullable(),
-	italic: z$1.boolean().nullable(),
+	italic: z.boolean().nullable(),
 	colorToken: themeColorTokenSchema.nullable().optional()
 });
-const proseLinkUnderlineStyleSchema = z$1.enum([
+const proseLinkUnderlineStyleSchema = z.enum([
 	"solid",
 	"dotted",
 	"dashed"
 ]);
-const proseLinkUnderlineThicknessSchema = z$1.enum([
+const proseLinkUnderlineThicknessSchema = z.enum([
 	"auto",
 	"fromFont",
 	"thin",
 	"medium",
 	"thick"
 ]);
-const proseLinkUnderlineOffsetSchema = z$1.enum([
+const proseLinkUnderlineOffsetSchema = z.enum([
 	"auto",
 	"tight",
 	"normal",
 	"loose"
 ]);
-const proseLinkStyleSchema = z$1.object({
+const proseLinkStyleSchema = z.object({
 	colorToken: themeColorTokenSchema.optional(),
 	hoverColorToken: themeColorTokenSchema.optional(),
-	underline: z$1.boolean().optional(),
+	underline: z.boolean().optional(),
 	decorationColorToken: themeColorTokenSchema.optional(),
 	hoverDecorationColorToken: themeColorTokenSchema.optional(),
 	underlineStyle: proseLinkUnderlineStyleSchema.optional(),
 	underlineThickness: proseLinkUnderlineThicknessSchema.optional(),
 	underlineOffset: proseLinkUnderlineOffsetSchema.optional()
 });
-const semanticSpacingSchema = z$1.enum([
+const semanticSpacingSchema = z.enum([
 	"none",
 	"compact",
 	"cozy",
@@ -4494,7 +4679,7 @@ const semanticSpacingSchema = z$1.enum([
 	"comfortable",
 	"spacious"
 ]);
-const boxRoundedSchema = z$1.enum([
+const boxRoundedSchema = z.enum([
 	"none",
 	"sm",
 	"md",
@@ -4503,82 +4688,45 @@ const boxRoundedSchema = z$1.enum([
 	"2xl",
 	"full"
 ]);
-const boxBackgroundOverlaySchema = z$1.object({
-	type: z$1.enum([
-		"none",
-		"color",
-		"gradient"
-	]).nullable().optional(),
-	color: tokenOrCssColorValueSchema.nullable().optional(),
-	gradient: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).nullable().optional()
-});
-const boxBackgroundSchema = z$1.object({
-	type: z$1.enum([
-		"color",
-		"gradient",
-		"image"
-	]).optional(),
-	contentOwner: z$1.literal(pageDesignEditorBackgroundOverrideOwner).optional(),
-	color: tokenOrCssColorValueSchema.nullable().optional(),
-	gradient: z$1.string().nullable().optional(),
-	gradientPresetId: z$1.string().min(1).nullable().optional(),
-	image: mediaSchema.nullable().optional(),
-	objectFit: z$1.enum([
-		"fill",
-		"fit",
-		"original",
-		"custom"
-	]).nullable().optional(),
-	scale: z$1.string().nullable().optional(),
-	position: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).nullable().optional(),
-	motion: z$1.enum(["static", "fixed-frame"]).nullable().optional(),
-	overlay: boxBackgroundOverlaySchema.nullable().optional(),
-	textColor: tokenOrCssColorValueSchema.nullable().optional(),
-	headingColor: tokenOrCssColorValueSchema.nullable().optional(),
-	linkColor: tokenOrCssColorValueSchema.nullable().optional(),
-	supportingColor: tokenOrCssColorValueSchema.nullable().optional()
-});
-const noHeadingDecorationSchema = z$1.object({ family: z$1.literal("none") });
-const visibleHeadingDecorationSchema = z$1.object({
-	family: z$1.enum(visibleHeadingDecorationFamilyValues),
-	colorToken: z$1.enum(headingDecorationColorTokenValues).optional()
+const noHeadingDecorationSchema = z.object({ family: z.literal("none") });
+const visibleHeadingDecorationSchema = z.object({
+	family: z.enum(visibleHeadingDecorationFamilyValues),
+	colorToken: z.enum(headingDecorationColorTokenValues).optional()
 });
-const headingDecorationSchema = z$1.union([noHeadingDecorationSchema, visibleHeadingDecorationSchema]);
-const headingDecorationOverrideSchema = z$1.union([z$1.enum(headingDecorationOverrideValues), z$1.literal("on").transform(() => "site-default")]);
-const accordionIconTreatmentSchema = z$1.object({
-	iconSet: z$1.enum(accordionIconSetValues),
-	colorToken: z$1.enum(accordionIconColorTokenValues),
-	openColorToken: z$1.enum(accordionIconColorTokenValues).optional(),
-	motion: z$1.enum(accordionIconMotionValues)
+const headingDecorationSchema = z.union([noHeadingDecorationSchema, visibleHeadingDecorationSchema]);
+const headingDecorationOverrideSchema = z.union([z.enum(headingDecorationOverrideValues), z.literal("on").transform(() => "site-default")]);
+const accordionIconTreatmentSchema = z.object({
+	iconSet: z.enum(accordionIconSetValues),
+	colorToken: z.enum(accordionIconColorTokenValues),
+	openColorToken: z.enum(accordionIconColorTokenValues).optional(),
+	motion: z.enum(accordionIconMotionValues)
 });
-const sectionStylesOverrideSchema = z$1.object({
+const sectionStylesOverrideSchema = z.object({
 	background: boxBackgroundSchema.nullable().optional(),
 	spacing: semanticSpacingSchema.nullable().optional(),
-	minHeight: z$1.enum([
+	minHeight: z.enum([
 		"none",
 		"banner",
 		"hero",
 		"immersive"
 	]).nullable().optional(),
-	tileTreatment: z$1.enum(tileTreatmentValues).nullable().optional(),
-	eventListTreatment: z$1.enum(eventListTreatmentValues).nullable().optional(),
-	eyebrowTreatment: z$1.enum(eyebrowTreatmentValues).nullable().optional(),
+	tileTreatment: z.enum(tileTreatmentValues).nullable().optional(),
+	eventListTreatment: z.enum(eventListTreatmentValues).nullable().optional(),
+	eyebrowTreatment: z.enum(eyebrowTreatmentValues).nullable().optional(),
 	headingDecoration: headingDecorationSchema.nullable().optional(),
 	headingDecorationOverride: headingDecorationOverrideSchema.nullable().optional(),
 	accordionIconTreatment: accordionIconTreatmentSchema.nullable().optional()
 });
-const containerStylesOverrideSchema = z$1.object({
+const containerStylesOverrideSchema = z.object({
 	background: boxBackgroundSchema.nullable().optional(),
 	spacing: semanticSpacingSchema.nullable().optional(),
-	raised: z$1.boolean().nullable().optional(),
+	raised: z.boolean().nullable().optional(),
 	rounded: boxRoundedSchema.nullable().optional(),
-	fullWidth: z$1.boolean().nullable().optional()
+	fullWidth: z.boolean().nullable().optional()
 });
-const cardBorderOverrideSchema = z$1.object({
-	enabled: z$1.boolean().nullable().optional(),
-	width: z$1.enum([
+const cardBorderOverrideSchema = z.object({
+	enabled: z.boolean().nullable().optional(),
+	width: z.enum([
 		"none",
 		"1",
 		"2",
@@ -4586,13 +4734,13 @@ const cardBorderOverrideSchema = z$1.object({
 	]).nullable().optional(),
 	colorToken: themeColorTokenSchema.nullable().optional()
 });
-const cardStylesOverrideSchema = z$1.object({
+const cardStylesOverrideSchema = z.object({
 	background: boxBackgroundSchema.nullable().optional(),
 	border: cardBorderOverrideSchema.nullable().optional(),
 	spacing: semanticSpacingSchema.nullable().optional(),
-	raised: z$1.boolean().nullable().optional(),
+	raised: z.boolean().nullable().optional(),
 	rounded: boxRoundedSchema.nullable().optional(),
-	treatment: z$1.enum([
+	treatment: z.enum([
 		"accent-quote",
 		"editorial-rule",
 		"soft-panel",
@@ -4602,16 +4750,16 @@ const cardStylesOverrideSchema = z$1.object({
 	]).nullable().optional(),
 	cardVariant: boxStylesCardVariantSchema.nullable().optional()
 });
-const blockStyleOverridesSchema = z$1.object({
+const blockStyleOverridesSchema = z.object({
 	sectionStyles: sectionStylesOverrideSchema.nullable().optional(),
 	containerStyles: containerStylesOverrideSchema.nullable().optional(),
 	cardStyles: cardStylesOverrideSchema.nullable().optional()
 });
-const blockThemeOverrideSchema = z$1.object({
-	typography: z$1.object({ proseLinkStyle: proseLinkStyleSchema.optional() }).optional(),
+const blockThemeOverrideSchema = z.object({
+	typography: z.object({ proseLinkStyle: proseLinkStyleSchema.optional() }).optional(),
 	styles: blockStyleOverridesSchema.optional()
 });
-const typographyScaleSchema = z$1.enum([
+const typographyScaleSchema = z.enum([
 	"compact",
 	"balanced",
 	"spacious",
@@ -4619,31 +4767,31 @@ const typographyScaleSchema = z$1.enum([
 	"majorThird",
 	"perfectFourth"
 ]);
-const eyebrowTypographyStyleSchema = z$1.object({
-	family: z$1.string().min(1),
-	size: z$1.enum([
+const eyebrowTypographyStyleSchema = z.object({
+	family: z.string().min(1),
+	size: z.enum([
 		"sm",
 		"md",
 		"lg"
 	]).optional(),
-	weight: z$1.enum([
+	weight: z.enum([
 		"light",
 		"regular",
 		"medium",
 		"semibold",
 		"bold"
 	]).optional(),
-	letterSpacing: z$1.enum([
+	letterSpacing: z.enum([
 		"tight",
 		"normal",
 		"loose",
 		"wide"
 	]).optional(),
-	case: z$1.enum(["uppercase", "normal"]).optional()
+	case: z.enum(["uppercase", "normal"]).optional()
 });
-const typographySchema = z$1.object({
+const typographySchema = z.object({
 	body: bodyTypographyStyleSchema,
-	headings: z$1.object({
+	headings: z.object({
 		default: headingTypographyStyleSchema,
 		h1: headingTypographyOverridesSchema,
 		h2: headingTypographyOverridesSchema,
@@ -4656,105 +4804,105 @@ const typographySchema = z$1.object({
 	proseLinkStyle: proseLinkStyleSchema.optional(),
 	eyebrow: eyebrowTypographyStyleSchema.optional()
 });
-const spaceSchema = z$1.enum([
+const spaceSchema = z.enum([
 	"comfortable",
 	"standard",
 	"dense"
 ]);
-const corners = z$1.enum([
+const corners = z.enum([
 	"square",
 	"soft",
 	"rounded",
 	"pill"
 ]);
-const shadow = z$1.object({
-	elevation: z$1.enum([
+const shadow = z.object({
+	elevation: z.enum([
 		"none",
 		"low",
 		"medium",
 		"high"
 	]),
-	softness: z$1.enum([
+	softness: z.enum([
 		"crisp",
 		"soft",
 		"hard"
 	]).nullable(),
-	position: z$1.enum(["bottom", "bottom-right"]).default("bottom"),
+	position: z.enum(["bottom", "bottom-right"]).default("bottom"),
 	colorToken: themeColorTokenSchema.optional()
 });
-const border = z$1.object({
-	width: z$1.enum([
+const border = z.object({
+	width: z.enum([
 		"none",
 		"hairline",
 		"thin",
 		"thick"
 	]),
-	style: z$1.enum(["solid", "dashed"])
+	style: z.enum(["solid", "dashed"])
 });
-const motion = z$1.object({
-	level: z$1.enum([
+const motion = z.object({
+	level: z.enum([
 		"off",
 		"low",
 		"medium",
 		"high"
 	]),
-	easing: z$1.enum([
+	easing: z.enum([
 		"standard",
 		"snappy",
 		"gentle"
 	]).nullable()
 });
-z$1.object({ shape: corners });
-z$1.object({
-	elevation: z$1.enum([
+z.object({ shape: corners });
+z.object({
+	elevation: z.enum([
 		"none",
 		"low",
 		"medium",
 		"high"
 	]),
-	border: z$1.enum([
+	border: z.enum([
 		"none",
 		"subtle",
 		"defined"
 	]),
 	shape: corners,
-	headerStyle: z$1.enum([
+	headerStyle: z.enum([
 		"plain",
 		"accentBar",
 		"subtleBg"
 	]).nullable(),
-	mediaTreatment: z$1.enum([
+	mediaTreatment: z.enum([
 		"square",
 		"rounded",
 		"bleed"
 	]).nullable()
 });
-const inputStyle = z$1.object({
+const inputStyle = z.object({
 	shape: corners,
-	border: z$1.enum([
+	border: z.enum([
 		"subtle",
 		"defined",
 		"underline"
 	]),
-	focus: z$1.enum([
+	focus: z.enum([
 		"glow",
 		"ring",
 		"underline"
 	]),
-	label: z$1.enum(["inside", "above"])
+	label: z.enum(["inside", "above"])
 });
-const headerVariant = z$1.enum([
+const headerVariant = z.enum([
 	"classic",
 	"centered",
 	"transparent",
 	"floating"
 ]);
-const headerPositioning = z$1.enum([
+const headerPositioning = z.enum([
 	"static",
 	"sticky",
 	"fixed"
 ]);
-const headerNavStyle = z$1.enum([
+const headerNavStyle = z.enum([
 	"minimal",
 	"underline",
 	"underline-grow",
@@ -4763,59 +4911,59 @@ const headerNavStyle = z$1.enum([
 	"frosted",
 	"solid"
 ]);
-const navFontWeight = z$1.enum([
+const navFontWeight = z.enum([
 	"regular",
 	"medium",
 	"semibold",
 	"bold"
 ]);
-const headerMaxWidth = z$1.enum(["container", "full"]);
-const headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
-const headerBorderSchema = componentBorderSchema.extend({ position: z$1.enum([
+const headerMaxWidth = z.enum(["container", "full"]);
+const headerBarFrame = z.enum(["full-bleed", "inset-shell"]);
+const headerBorderSchema = componentBorderSchema.extend({ position: z.enum([
 	"bottom",
 	"top",
 	"both",
 	"none"
 ]).default("bottom") }).optional();
-const logoStyleSchema = z$1.object({
-	fontFamily: z$1.enum(["heading", "body"]).default("heading"),
-	letterSpacing: z$1.enum([
+const logoStyleSchema = z.object({
+	fontFamily: z.enum(["heading", "body"]).default("heading"),
+	letterSpacing: z.enum([
 		"normal",
 		"wide",
 		"wider",
 		"widest"
 	]).default("normal"),
-	gradient: z$1.boolean().default(false),
-	brandDisplay: z$1.enum(brandDisplayModeValues).optional(),
-	size: z$1.enum(logoSizePolicyValues).optional(),
-	accommodation: z$1.enum(logoAccommodationPatternValues).optional()
+	gradient: z.boolean().default(false),
+	brandDisplay: z.enum(brandDisplayModeValues).optional(),
+	size: z.enum(logoSizePolicyValues).optional(),
+	accommodation: z.enum(logoAccommodationPatternValues).optional()
 }).optional();
-const headerLogoTextSchema = z$1.object({
-	mobileWrapLines: z$1.union([z$1.literal(1), z$1.literal(2)]).optional(),
-	mobileMaxWidth: z$1.enum([
+const headerLogoTextSchema = z.object({
+	mobileWrapLines: z.union([z.literal(1), z.literal(2)]).optional(),
+	mobileMaxWidth: z.enum([
 		"xs",
 		"sm",
 		"md"
 	]).optional(),
-	hideOnShrink: z$1.boolean().optional()
+	hideOnShrink: z.boolean().optional()
 }).optional();
-const navEffectsSchema = z$1.object({
-	underlineGradient: z$1.boolean().default(false),
-	glow: z$1.boolean().default(false),
-	glowColor: z$1.string().optional(),
-	neumorphic: z$1.boolean().default(false)
+const navEffectsSchema = z.object({
+	underlineGradient: z.boolean().default(false),
+	glow: z.boolean().default(false),
+	glowColor: z.string().optional(),
+	neumorphic: z.boolean().default(false)
 }).optional();
-const dropdownStyleSchema = z$1.object({
+const dropdownStyleSchema = z.object({
 	background: themeColorTokenSchema.default("surface"),
 	textColor: themeColorTokenSchema.default("text"),
 	borderColor: themeColorTokenSchema.nullable().default("border"),
-	shadow: z$1.enum([
+	shadow: z.enum([
 		"none",
 		"sm",
 		"md",
 		"lg"
 	]).default("md"),
-	borderRadius: z$1.enum([
+	borderRadius: z.enum([
 		"none",
 		"sm",
 		"md",
@@ -4823,23 +4971,23 @@ const dropdownStyleSchema = z$1.object({
 	]).default("md"),
 	hoverBackground: themeColorTokenSchema.nullable().optional(),
 	hoverTextColor: themeColorTokenSchema.nullable().optional(),
-	textTransform: z$1.enum([
+	textTransform: z.enum([
 		"none",
 		"uppercase",
 		"capitalize"
 	]).default("none"),
-	letterSpacing: z$1.enum([
+	letterSpacing: z.enum([
 		"normal",
 		"wide",
 		"wider"
 	]).default("normal"),
-	fontWeight: z$1.enum([
+	fontWeight: z.enum([
 		"regular",
 		"medium",
 		"semibold",
 		"bold"
 	]).optional(),
-	textSize: z$1.enum([
+	textSize: z.enum([
 		"xs",
 		"sm",
 		"base",
@@ -4850,7 +4998,7 @@ const dropdownStyleSchema = z$1.object({
 * CTA button gap (left margin) for desktop header.
 * Controls the spacing between nav links and the CTA button.
 */
-const headerCtaGapSchema = z$1.enum([
+const headerCtaGapSchema = z.enum([
 	"none",
 	"tight",
 	"compact",
@@ -4858,7 +5006,7 @@ const headerCtaGapSchema = z$1.enum([
 	"relaxed",
 	"spacious"
 ]);
-const headerCtaTreatmentSchema = z$1.enum([
+const headerCtaTreatmentSchema = z.enum([
 	"default",
 	"primary",
 	"secondary",
@@ -4866,35 +5014,35 @@ const headerCtaTreatmentSchema = z$1.enum([
 	"outline",
 	"ghost"
 ]);
-const navContainerSchema = z$1.object({
-	type: z$1.enum([
+const navContainerSchema = z.object({
+	type: z.enum([
 		"none",
 		"pill",
 		"glass"
 	]).default("none"),
-	tint: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).default(.15)
+	tint: z.string().nullable().optional(),
+	opacity: z.number().min(0).max(1).default(.15)
 }).default({
 	type: "none",
 	tint: null,
 	opacity: .15
 });
-const headerBackgroundSchema = z$1.object({
-	type: z$1.enum([
+const headerBackgroundSchema = z.object({
+	type: z.enum([
 		"color",
 		"gradient",
 		"image"
 	]),
-	contentOwner: z$1.literal(siteChromeBackgroundOverrideOwner).optional(),
+	contentOwner: z.literal(siteChromeBackgroundOverrideOwner).optional(),
 	color: tokenOrCssColorValueSchema.nullable().optional(),
 	gradient: gradientConfigSchema.nullable().optional(),
 	image: mediaSchema.nullable().optional(),
 	textColor: tokenOrCssColorValueSchema.nullable().optional()
 });
-const headerSchema = z$1.object({
+const headerSchema = z.object({
 	variant: headerVariant,
 	positioning: headerPositioning,
-	shrinkOnScroll: z$1.boolean(),
+	shrinkOnScroll: z.boolean(),
 	maxWidth: headerMaxWidth,
 	barFrame: headerBarFrame.optional(),
 	scrollTreatment: headerScrollTreatmentSchema,
@@ -4907,11 +5055,10 @@ const headerSchema = z$1.object({
 	navStyle: headerNavStyle,
 	navColor: themeColorTokenSchema.nullable().optional(),
 	navWeight: navFontWeight.default("medium"),
-	navFontRole: z$1.enum(["body", "heading"]).optional(),
-	navTypography: z$1.enum(["body", "heading"]).optional(),
+	navFontRole: z.enum(["body", "heading"]).optional(),
 	navTextSize: navLinkStyleSchema.shape.textSize,
 	interactionPalette: headerInteractionPaletteSchema.optional(),
-	navPlacement: z$1.enum(["end", "center"]).optional(),
+	navPlacement: z.enum(["end", "center"]).optional(),
 	container: headerContainerSchema,
 	border: headerBorderSchema,
 	shadow: componentShadowSchema.optional(),
@@ -4922,47 +5069,33 @@ const headerSchema = z$1.object({
 	navLinkStyle: navLinkStyleSchema.optional(),
 	ctaGap: headerCtaGapSchema.optional(),
 	ctaTreatment: headerCtaTreatmentSchema.optional(),
-	ctaVariant: z$1.string().min(1).optional(),
+	ctaVariant: z.string().min(1).optional(),
 	dropdownStyle: dropdownStyleSchema
-}).transform(normaliseHeaderNavFontRole);
-/**
-* Normalises the legacy `navTypography` font-role alias into the canonical
-* `navFontRole` field so persisted themes migrate at the parse boundary without
-* a data migration. `navFontRole` always wins when both are present; the legacy
-* field is dropped so we never carry a dual write forward.
-*/
-function normaliseHeaderNavFontRole(header) {
-	if (header.navTypography === void 0) return header;
-	const { navTypography, ...rest } = header;
-	return header.navFontRole === void 0 ? {
-		...rest,
-		navFontRole: navTypography
-	} : rest;
-}
-const footerVariant = z$1.enum([
+});
+const footerVariant = z.enum([
 	"simple",
 	"columns",
 	"split"
 ]);
-const footerMaxWidth = z$1.enum(["container", "full"]);
-const footerMode = z$1.enum([
+const footerMaxWidth = z.enum(["container", "full"]);
+const footerMode = z.enum([
 	"default",
 	"blocks",
 	"default+blocks",
 	"none"
 ]);
-const footerNavLayoutMode = z$1.enum([
+const footerNavLayoutMode = z.enum([
 	"stack",
 	"inline",
 	"inline-wrap"
 ]);
-const footerNavLayoutAlign = z$1.enum([
+const footerNavLayoutAlign = z.enum([
 	"start",
 	"center",
 	"end",
 	"space-between"
 ]);
-const footerSpacing = z$1.enum([
+const footerSpacing = z.enum([
 	"none",
 	"tight",
 	"compact",
@@ -4970,45 +5103,45 @@ const footerSpacing = z$1.enum([
 	"relaxed",
 	"spacious"
 ]);
-const footerLogoPlacement = z$1.enum([
+const footerLogoPlacement = z.enum([
 	"left",
 	"right",
 	"above",
 	"below"
 ]);
-const footerLogoSize = z$1.enum([
+const footerLogoSize = z.enum([
 	"sm",
 	"md",
 	"lg",
 	"xl"
 ]);
-const footerLogoMaxHeight = z$1.enum([
+const footerLogoMaxHeight = z.enum([
 	"sm",
 	"md",
 	"lg",
 	"xl"
 ]);
-const footerBottomTextLinkStyleSchema = z$1.object({
+const footerBottomTextLinkStyleSchema = z.object({
 	colorToken: themeColorTokenSchema.optional(),
 	hoverColorToken: themeColorTokenSchema.nullable().optional(),
 	decorationColorToken: themeColorTokenSchema.nullable().optional(),
-	underline: z$1.boolean().optional()
+	underline: z.boolean().optional()
 });
-const footerBottomBarSchema = z$1.object({
-	enabled: z$1.boolean().optional(),
-	fullBleed: z$1.boolean().optional(),
+const footerBottomBarSchema = z.object({
+	enabled: z.boolean().optional(),
+	fullBleed: z.boolean().optional(),
 	background: headerBackgroundSchema.optional(),
 	textColor: themeColorTokenSchema.nullable().optional(),
-	textAlign: z$1.enum([
+	textAlign: z.enum([
 		"left",
 		"center",
 		"right"
 	]).optional(),
 	paddingY: footerSpacing.optional(),
 	paddingX: footerSpacing.optional(),
-	borderTop: z$1.object({
+	borderTop: z.object({
 		colorToken: themeColorTokenSchema.nullable().optional(),
-		width: z$1.enum([
+		width: z.enum([
 			"none",
 			"thin",
 			"medium",
@@ -5016,26 +5149,26 @@ const footerBottomBarSchema = z$1.object({
 		]).optional()
 	}).optional()
 });
-const footerNavLayoutSchema = z$1.object({
+const footerNavLayoutSchema = z.object({
 	layout: footerNavLayoutMode.optional(),
 	align: footerNavLayoutAlign.optional(),
 	gapX: footerSpacing.optional(),
 	gapY: footerSpacing.optional(),
-	columns: z$1.number().int().min(1).max(6).optional()
+	columns: z.number().int().min(1).max(6).optional()
 });
-const footerLogoSchema = z$1.object({
-	showLogo: z$1.boolean().default(true),
-	showLogoText: z$1.boolean().optional(),
+const footerLogoSchema = z.object({
+	showLogo: z.boolean().default(true),
+	showLogoText: z.boolean().optional(),
 	placement: footerLogoPlacement.optional(),
 	size: footerLogoSize.optional(),
 	maxHeight: footerLogoMaxHeight.optional(),
-	align: z$1.enum([
+	align: z.enum([
 		"start",
 		"center",
 		"end"
 	]).optional()
 });
-const footerSchema = z$1.object({
+const footerSchema = z.object({
 	/**
 	* SDK-only footer rendering mode.
 	*
@@ -5044,7 +5177,7 @@ const footerSchema = z$1.object({
 	mode: footerMode.optional(),
 	variant: footerVariant,
 	maxWidth: footerMaxWidth,
-	showLogoText: z$1.boolean().optional(),
+	showLogoText: z.boolean().optional(),
 	background: headerBackgroundSchema.default({
 		type: "color",
 		color: "surface"
@@ -5058,18 +5191,18 @@ const footerSchema = z$1.object({
 	logo: footerLogoSchema.optional(),
 	bottomBar: footerBottomBarSchema.optional()
 });
-const containerPaddingPresetSchema = z$1.enum([
+const containerPaddingPresetSchema = z.enum([
 	"tight",
 	"compact",
 	"default",
 	"relaxed"
 ]);
-const layoutSchema = z$1.object({ containerPadding: z$1.object({
+const layoutSchema = z.object({ containerPadding: z.object({
 	mobile: containerPaddingPresetSchema.optional(),
 	tablet: containerPaddingPresetSchema.optional(),
 	desktop: containerPaddingPresetSchema.optional()
 }).optional() }).optional();
-const heroTypographySizeSchema = z$1.enum([
+const heroTypographySizeSchema = z.enum([
 	"sm",
 	"base",
 	"lg",
@@ -5081,19 +5214,19 @@ const heroTypographySizeSchema = z$1.enum([
 	"6xl",
 	"editorial"
 ]);
-const heroTypographyLineHeightSchema = z$1.enum([
+const heroTypographyLineHeightSchema = z.enum([
 	"tight",
 	"snug",
 	"normal",
 	"relaxed"
 ]);
-const heroResponsiveTypographySchema = z$1.object({
+const heroResponsiveTypographySchema = z.object({
 	headlineSize: heroTypographySizeSchema.optional(),
 	headlineLineHeight: heroTypographyLineHeightSchema.optional(),
 	subheadlineSize: heroTypographySizeSchema.optional(),
 	subheadlineLineHeight: heroTypographyLineHeightSchema.optional()
 });
-const heroTypographySchema = z$1.object({
+const heroTypographySchema = z.object({
 	headlineSize: heroTypographySizeSchema.optional(),
 	headlineLineHeight: heroTypographyLineHeightSchema.optional(),
 	subheadlineSize: heroTypographySizeSchema.optional(),
@@ -5102,21 +5235,21 @@ const heroTypographySchema = z$1.object({
 	microHeadlineLineHeight: heroTypographyLineHeightSchema.optional(),
 	microSubheadlineSize: heroTypographySizeSchema.optional(),
 	microSubheadlineLineHeight: heroTypographyLineHeightSchema.optional(),
-	responsive: z$1.object({
+	responsive: z.object({
 		tablet: heroResponsiveTypographySchema.optional(),
 		mobile: heroResponsiveTypographySchema.optional()
 	}).optional()
 });
-const heroSchema = z$1.object({ typography: heroTypographySchema.optional() }).optional();
-const bodyTextIntroTypographySizeSchema = z$1.enum(["default", "editorial"]);
-const bodyTextSchema = z$1.object({ intro: z$1.object({
+const heroSchema = z.object({ typography: heroTypographySchema.optional() }).optional();
+const bodyTextIntroTypographySizeSchema = z.enum(["default", "editorial"]);
+const bodyTextSchema = z.object({ intro: z.object({
 	paragraphSize: bodyTextIntroTypographySizeSchema.optional(),
 	headingSize: bodyTextIntroTypographySizeSchema.optional()
 }).optional() }).optional();
-const gradientsSchema = z$1.object({
-	button: z$1.string().min(1).nullable().optional(),
-	hero: z$1.string().min(1).nullable().optional(),
-	background: z$1.string().min(1).nullable().optional()
+const gradientsSchema = z.object({
+	button: z.string().min(1).nullable().optional(),
+	hero: z.string().min(1).nullable().optional(),
+	background: z.string().min(1).nullable().optional()
 });
 /**
 * Testimonial quote-mark treatment, owned by the site style (analogous to the
@@ -5124,27 +5257,27 @@ const gradientsSchema = z$1.object({
 * it. `none` hides the mark. The block renders the mark; the site style decides
 * its character; a look may still hide it.
 */
-const testimonialQuoteTreatmentSchema = z$1.object({
-	style: z$1.enum([
+const testimonialQuoteTreatmentSchema = z.object({
+	style: z.enum([
 		"serif-display",
 		"accent-glyph",
 		"none"
 	]),
-	fontFamily: z$1.enum(["heading", "body"]).optional(),
-	scale: z$1.enum([
+	fontFamily: z.enum(["heading", "body"]).optional(),
+	scale: z.enum([
 		"sm",
 		"md",
 		"lg",
 		"xl"
 	]).optional(),
 	colorToken: themeColorTokenSchema.optional(),
-	opacity: z$1.number().min(0).max(1).optional()
+	opacity: z.number().min(0).max(1).optional()
 });
-const themeSchema = z$1.object({
-	name: z$1.string().min(1).max(30),
-	description: z$1.string().min(1).max(400),
-	rationale: z$1.string().min(1).max(400),
-	siteStyleId: z$1.string().min(1).transform((value) => asSiteStyleId(value)).optional(),
+const themeSchema = z.object({
+	name: z.string().min(1).max(30),
+	description: z.string().min(1).max(400),
+	rationale: z.string().min(1).max(400),
+	siteStyleId: z.string().min(1).transform((value) => asSiteStyleId(value)).optional(),
 	axes: axesSchema,
 	palette: paletteSchema,
 	typography: typographySchema,
@@ -5165,8 +5298,8 @@ const themeSchema = z$1.object({
 	testimonialQuote: testimonialQuoteTreatmentSchema.optional(),
 	inputs: inputSystemSchema.optional(),
 	inputStyle: inputStyle.optional(),
-	blockCustomVars: z$1.record(z$1.string(), z$1.record(z$1.string(), z$1.string())).optional(),
-	blockOverrides: z$1.record(z$1.string(), blockThemeOverrideSchema).optional(),
+	blockCustomVars: z.record(z.string(), z.record(z.string(), z.string())).optional(),
+	blockOverrides: z.record(z.string(), blockThemeOverrideSchema).optional(),
 	headingDecoration: headingDecorationSchema.optional(),
 	customCssRules: customCssRulesSchema,
 	blockCustomCssRules: blockCustomCssRulesSchema,
@@ -5196,11 +5329,11 @@ const themeSchema = z$1.object({
 	* }
 	* ```
 	*/
-	styleGroups: z$1.record(z$1.string(), z$1.array(z$1.string())).optional()
+	styleGroups: z.record(z.string(), z.array(z.string())).optional()
 });
-z$1.object({
-	message: z$1.string().min(1),
-	themes: z$1.array(themeSchema).length(3)
+z.object({
+	message: z.string().min(1),
+	themes: z.array(themeSchema).length(3)
 });
 //#endregion
 //#region ../theme-core/src/styles/shadow.ts
@@ -5305,11 +5438,11 @@ const STYLE_AXIS_VALUES = {
 		"retro"
 	]
 };
-const styleTagsSchema = z$1.object({
-	tone: z$1.enum(STYLE_AXIS_VALUES.tone).optional(),
-	energy: z$1.enum(STYLE_AXIS_VALUES.energy).optional(),
-	motion: z$1.enum(STYLE_AXIS_VALUES.motion).optional(),
-	era: z$1.enum(STYLE_AXIS_VALUES.era).optional()
+const styleTagsSchema = z.object({
+	tone: z.enum(STYLE_AXIS_VALUES.tone).optional(),
+	energy: z.enum(STYLE_AXIS_VALUES.energy).optional(),
+	motion: z.enum(STYLE_AXIS_VALUES.motion).optional(),
+	era: z.enum(STYLE_AXIS_VALUES.era).optional()
 });
 //#endregion
 //#region ../theme-core/src/palette/curated/types.ts
@@ -5317,12 +5450,12 @@ function asCuratedPaletteAuthoringKey(value) {
 	if (value.length === 0) throw new Error("CuratedPaletteAuthoringKey must be a non-empty string");
 	return value;
 }
-const curatedPaletteAuthoringKeySchema = z$1.string().min(1).transform((value) => asCuratedPaletteAuthoringKey(value));
-z$1.object({
+const curatedPaletteAuthoringKeySchema = z.string().min(1).transform((value) => asCuratedPaletteAuthoringKey(value));
+z.object({
 	authoringKey: curatedPaletteAuthoringKeySchema,
 	valueKey: paletteValueKeySchema,
-	name: z$1.string().min(1),
-	description: z$1.string().min(1),
+	name: z.string().min(1),
+	description: z.string().min(1),
 	tags: styleTagsSchema,
 	mode: paletteModeSchema,
 	colors: paletteColorsSchema
@@ -5346,7 +5479,7 @@ function defineCuratedPalette(input) {
 		colors
 	};
 }
-z$1.object({
+z.object({
 	primary: hexColorSchema.optional(),
 	primaryForeground: hexColorSchema.optional(),
 	secondary: hexColorSchema.optional(),
@@ -7199,23 +7332,12 @@ function parseGradientPresetId(value) {
 	return normalized;
 }
 //#endregion
-//#region ../theme-core/src/site-styles/headerCtaVariants.ts
-function hasButtonVariant(theme, variantId) {
-	return theme.buttons?.variants.some((variant) => variant.enabled && variant.id === variantId) ?? false;
-}
-function resolveHeaderCtaVariant(theme, treatment) {
-	switch (treatment) {
-		case "default": return;
-		case "primary": return "primary";
-		case "secondary": return hasButtonVariant(theme, "secondary") ? "secondary" : "primary";
-		case "inverted":
-			if (hasButtonVariant(theme, "header")) return "header";
-			if (hasButtonVariant(theme, "secondary")) return "secondary";
-			if (hasButtonVariant(theme, "outline")) return "outline";
-			return "primary";
-		case "outline": return hasButtonVariant(theme, "outline") ? "outline" : "secondary";
-		case "ghost": return hasButtonVariant(theme, "ghost") ? "ghost" : "secondary";
-	}
+//#region ../theme-core/src/site-styles/headerLayoutTypes.ts
+function asHeaderLayoutId(value) {
+	return value;
+}
+function asHeaderStyleId(value) {
+	return value;
 }
 //#endregion
 //#region ../theme-core/src/site-styles/lookOptionGroups.ts
@@ -7250,16 +7372,7 @@ const clearSplitInteractionPalette = defineLookOptionGroup({
 	]
 });
 //#endregion
-//#region ../theme-core/src/site-styles/headerLooks.ts
-function asHeaderLookId(value) {
-	return value;
-}
-function asHeaderLayoutId(value) {
-	return value;
-}
-function asHeaderStyleId(value) {
-	return value;
-}
+//#region ../theme-core/src/site-styles/headerLayoutCatalog.ts
 const titleOnlyLogoAccommodation = {
 	pattern: "title-only",
 	supportedShapes: [
@@ -7378,21 +7491,6 @@ const overlayLogoAccommodations = [
 	inlineMarkWithTitleLogoAccommodation,
 	unbackedOverlayLogoAccommodation
 ];
-/**
-* Starts every Look from the generated theme's header branch, then clears
-* optional nested styling fields that would otherwise leak from another Look.
-*/
-function baseHeader(theme) {
-	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: {
-			type: "none",
-			tint: null,
-			opacity: .15
-		}
-	};
-}
 const headerLayoutCatalog = defineExactCatalog()([
 	{
 		id: asHeaderLayoutId("classic"),
@@ -7400,7 +7498,9 @@ const headerLayoutCatalog = defineExactCatalog()([
 		description: "Logo and navigation in one practical horizontal row.",
 		variant: "classic",
 		defaultPositioning: "sticky",
-		shrinkOnScroll: false
+		shrinkOnScroll: false,
+		logoAccommodations: inlineClassicLogoAccommodations,
+		openingRequirement: "none"
 	},
 	{
 		id: asHeaderLayoutId("centered"),
@@ -7409,790 +7509,141 @@ const headerLayoutCatalog = defineExactCatalog()([
 		variant: "centered",
 		defaultPositioning: "static",
 		shrinkOnScroll: false,
-		maxRecommendedNavItems: 5,
-		allowedLogoShapes: [
-			"none",
-			"text-only",
-			"horizontal",
-			"square"
-		]
-	},
-	{
-		id: asHeaderLayoutId("floating"),
-		label: "Floating",
-		description: "Detached header chrome that sits over the opening section.",
-		variant: "floating",
-		defaultPositioning: "sticky",
-		shrinkOnScroll: true,
-		maxRecommendedNavItems: 5,
-		allowedLogoShapes: [
-			"none",
-			"text-only",
-			"horizontal"
-		]
-	}
-]);
-function supportedLayouts(ids) {
-	return ids.map(asHeaderLayoutId);
-}
-const headerStyleCatalog = defineExactCatalog()([
-	{
-		id: asHeaderStyleId("minimal"),
-		label: "Minimal",
-		description: "Quiet surface with simple color-change navigation.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "color-change",
-		surface: "neutral",
-		defaultDepth: "none",
-		navTypography: "plain",
-		moods: [
-			"calm",
-			"professional",
-			"editorial"
-		]
-	},
-	{
-		id: asHeaderStyleId("fine-line"),
-		label: "Seamless",
-		description: "Borderless surface with underline hover for a quieter page transition.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "underline-grow",
-		surface: "neutral",
-		defaultDepth: "none",
-		navTypography: "plain",
-		moods: [
-			"calm",
-			"professional",
-			"editorial"
-		]
-	},
-	{
-		id: asHeaderStyleId("soft-bar"),
-		label: "Soft Bar",
-		description: "Soft tinted surface with gentle pill hover states.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "pill-background",
-		surface: "soft",
-		defaultDepth: "line",
-		navTypography: "plain",
-		moods: ["calm", "professional"]
-	},
-	{
-		id: asHeaderStyleId("pill-nav"),
-		label: "Pill Nav",
-		description: "A calm pill navigation rail over a neutral header.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "pill-background",
-		surface: "soft",
-		defaultDepth: "none",
-		navTypography: "plain",
-		moods: ["calm"]
-	},
-	{
-		id: asHeaderStyleId("brand-bar"),
-		label: "Brand Bar",
-		description: "Solid brand surface with high-contrast navigation.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "color-change",
-		surface: "brand-solid",
-		defaultDepth: "none",
-		navTypography: "brand-caps",
-		moods: [
-			"professional",
-			"expressive",
-			"utility"
-		]
-	},
-	{
-		id: asHeaderStyleId("brand-underline"),
-		label: "Brand Underline",
-		description: "Brand surface with underline-grow navigation.",
-		supportedLayoutIds: supportedLayouts(["classic"]),
-		navInteraction: "underline-grow",
-		surface: "brand-solid",
-		defaultDepth: "none",
-		navTypography: "brand-caps",
-		moods: ["expressive"]
-	},
-	{
-		id: asHeaderStyleId("brand-pill"),
-		label: "Brand Pill",
-		description: "Solid brand surface with rounded active and hover states.",
-		supportedLayoutIds: supportedLayouts([
-			"classic",
-			"centered",
-			"floating"
-		]),
-		navInteraction: "pill-background",
-		surface: "brand-solid",
-		defaultDepth: "none",
-		navTypography: "brand-caps",
-		moods: ["expressive"]
-	},
-	{
-		id: asHeaderStyleId("brand-capsule"),
-		label: "Brand Capsule",
-		description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.",
-		supportedLayoutIds: supportedLayouts(["classic"]),
-		navInteraction: "pill-background",
-		surface: "brand-solid",
-		defaultDepth: "shadow",
-		navTypography: "quiet-caps",
-		moods: ["expressive", "professional"]
-	},
-	{
-		id: asHeaderStyleId("serif-line"),
-		label: "Serif Line",
-		description: "Typographic logo treatment with understated underline navigation.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "underline-grow",
-		surface: "bordered",
-		defaultDepth: "line",
-		navTypography: "heading",
-		moods: ["editorial", "calm"]
-	},
-	{
-		id: asHeaderStyleId("flat-tabs"),
-		label: "Flat Tabs",
-		description: "Flat block hover and active states with a Swiss utility feel.",
-		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
-		navInteraction: "flat-block",
-		surface: "bordered",
-		defaultDepth: "shadow",
-		navTypography: "quiet-caps",
-		moods: [
-			"professional",
-			"utility",
-			"expressive"
-		]
-	},
-	{
-		id: asHeaderStyleId("glass"),
-		label: "Glass",
-		description: "Translucent chrome with frosted navigation backing.",
-		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "glass-backed",
-		surface: "floating",
-		defaultDepth: "shadow",
-		navTypography: "plain",
-		moods: ["expressive", "calm"]
-	},
-	{
-		id: asHeaderStyleId("minimal-surface"),
-		label: "Clear Split",
-		description: "Floating logo with transparent navigation and no shared shell.",
-		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "pill-background",
-		surface: "floating",
-		defaultDepth: "line",
-		navTypography: "plain",
-		openingForegroundTarget: "all",
-		scrollTreatment: "contrast-glass",
-		interactionPalette: clearSplitInteractionPalette,
-		moods: ["editorial", "calm"]
-	},
-	{
-		id: asHeaderStyleId("soft-shell"),
-		label: "Soft Shell",
-		description: "Floating rounded shell with soft pill navigation states.",
-		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "pill-background",
-		surface: "floating",
-		defaultDepth: "shadow",
-		navTypography: "plain",
-		moods: ["calm", "professional"]
-	},
-	{
-		id: asHeaderStyleId("split-glass"),
-		label: "Split Glass",
-		description: "Logo floats independently while the navigation sits in a glass rail.",
-		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "glass-backed",
-		surface: "floating",
-		defaultDepth: "shadow",
-		navTypography: "quiet-caps",
-		openingForegroundTarget: "brand-only",
-		moods: ["expressive"]
-	},
-	{
-		id: asHeaderStyleId("split-pill"),
-		label: "Split Pill",
-		description: "Logo floats independently with a soft pill-backed navigation rail.",
-		supportedLayoutIds: supportedLayouts(["floating"]),
-		navInteraction: "pill-background",
-		surface: "floating",
-		defaultDepth: "shadow",
-		navTypography: "heading",
-		openingForegroundTarget: "brand-only",
-		moods: ["calm", "editorial"]
-	}
-]);
-new Map(headerLayoutCatalog.map((layout) => [layout.id, layout]));
-const headerStylesById = new Map(headerStyleCatalog.map((style) => [style.id, style]));
-const headerStyleCompatibilityOrder = /* @__PURE__ */ new Map([
-	[asHeaderLayoutId("classic"), headerStyleRepairChain([
-		"minimal",
-		"fine-line",
-		"soft-bar",
-		"pill-nav",
-		"brand-bar",
-		"brand-underline",
-		"brand-pill",
-		"brand-capsule",
-		"serif-line",
-		"flat-tabs"
-	])],
-	[asHeaderLayoutId("centered"), headerStyleRepairChain([
-		"minimal",
-		"fine-line",
-		"soft-bar",
-		"pill-nav",
-		"brand-bar",
-		"brand-pill",
-		"serif-line",
-		"flat-tabs"
-	])],
-	[asHeaderLayoutId("floating"), headerStyleRepairChain([
-		"glass",
-		"minimal-surface",
-		"split-glass",
-		"split-pill",
-		"soft-shell",
-		"brand-pill"
-	])]
-]);
-function headerStyleRepairChain(values) {
-	return values.map(asHeaderStyleId);
-}
-headerStyleRepairChain([
-	"brand-bar",
-	"brand-pill",
-	"minimal"
-]), headerStyleRepairChain([
-	"serif-line",
-	"fine-line",
-	"minimal"
-]), headerStyleRepairChain([
-	"brand-pill",
-	"brand-bar",
-	"minimal"
-]), headerStyleRepairChain([
-	"brand-capsule",
-	"brand-pill",
-	"brand-bar",
-	"minimal"
-]), headerStyleRepairChain([
-	"pill-nav",
-	"soft-bar",
-	"minimal"
-]), headerStyleRepairChain([
-	"flat-tabs",
-	"pill-nav",
-	"minimal"
-]), headerStyleRepairChain([
-	"serif-line",
-	"fine-line",
-	"minimal"
-]), headerStyleRepairChain([
-	"glass",
-	"soft-shell",
-	"fine-line",
-	"minimal-surface",
-	"minimal"
-]), headerStyleRepairChain([
-	"soft-shell",
-	"soft-bar",
-	"minimal"
-]), headerStyleRepairChain(["minimal-surface", "minimal"]), headerStyleRepairChain([
-	"split-glass",
-	"glass",
-	"minimal-surface"
-]), headerStyleRepairChain([
-	"split-pill",
-	"soft-shell",
-	"brand-pill"
-]), headerStyleRepairChain(["fine-line", "minimal"]), headerStyleRepairChain(["soft-bar", "minimal"]), headerStyleRepairChain(["minimal"]);
-const legacyHeaderLookAliases = defineExactCatalog()([
-	{
-		lookId: asHeaderLookId("clean-base"),
-		selection: {
-			layoutId: asHeaderLayoutId("classic"),
-			styleId: asHeaderStyleId("minimal")
-		}
-	},
-	{
-		lookId: asHeaderLookId("classic-centered-nav"),
-		selection: {
-			layoutId: asHeaderLayoutId("classic"),
-			styleId: asHeaderStyleId("fine-line")
-		}
-	},
-	{
-		lookId: asHeaderLookId("brand-solid"),
-		selection: {
-			layoutId: asHeaderLayoutId("classic"),
-			styleId: asHeaderStyleId("brand-bar")
-		}
-	},
-	{
-		lookId: asHeaderLookId("serif-line"),
-		selection: {
-			layoutId: asHeaderLayoutId("centered"),
-			styleId: asHeaderStyleId("serif-line")
-		}
-	},
-	{
-		lookId: asHeaderLookId("centered-calm"),
-		selection: {
-			layoutId: asHeaderLayoutId("centered"),
-			styleId: asHeaderStyleId("minimal")
-		}
-	},
-	{
-		lookId: asHeaderLookId("practical-utility"),
-		selection: {
-			layoutId: asHeaderLayoutId("classic"),
-			styleId: asHeaderStyleId("flat-tabs")
-		}
-	},
-	{
-		lookId: asHeaderLookId("minimal-transparent"),
-		selection: {
-			layoutId: asHeaderLayoutId("classic"),
-			styleId: asHeaderStyleId("minimal")
-		}
-	},
-	{
-		lookId: asHeaderLookId("transparent-overlay"),
-		selection: {
-			layoutId: asHeaderLayoutId("floating"),
-			styleId: asHeaderStyleId("glass")
-		}
+		logoAccommodations: centeredLogoAccommodations,
+		openingRequirement: "none"
 	},
-	{
-		lookId: asHeaderLookId("floating-glass"),
-		selection: {
-			layoutId: asHeaderLayoutId("floating"),
-			styleId: asHeaderStyleId("glass")
-		}
-	}
-]);
-const legacyHeaderLookAliasesById = new Map(legacyHeaderLookAliases.map((alias) => [alias.lookId, alias]));
-function getHeaderStyle(id) {
-	return headerStylesById.get(id) ?? null;
-}
-function isHeaderStyleCompatibleWithLayout(style, layoutId) {
-	return style.supportedLayoutIds.includes(layoutId);
-}
-function getHeaderStyleOrThrow(id) {
-	const style = getHeaderStyle(id);
-	if (!style) throw new Error(`Unknown Theme V2 header style: ${id}`);
-	return style;
-}
-function resolveLegacyHeaderLookAlias(lookId) {
-	return legacyHeaderLookAliasesById.get(lookId)?.selection ?? null;
-}
-function getCompatibleHeaderStyleIds(layoutId) {
-	return (headerStyleCompatibilityOrder.get(layoutId) ?? []).filter((styleId) => {
-		return isHeaderStyleCompatibleWithLayout(getHeaderStyleOrThrow(styleId), layoutId);
-	});
-}
-function applyNavTypography(style, typography) {
-	switch (typography) {
-		case "plain": return style;
-		case "heading": return {
-			...style,
-			typography: "heading",
-			fontWeight: "medium",
-			letterSpacing: "wide"
-		};
-		case "quiet-caps": return {
-			...style,
-			textTransform: "uppercase",
-			textSize: "sm",
-			letterSpacing: "wide"
-		};
-		case "brand-caps": return {
-			...style,
-			textTransform: "uppercase",
-			textSize: "sm",
-			letterSpacing: "wider"
-		};
-		default: return assertNever(typography, "Unhandled header nav typography");
-	}
-}
-function underlineNavLinkStyle(colorToken, underlineColorToken, typography = "plain") {
-	return applyNavTypography({
-		name: "Underline grow",
-		typography: "body",
-		fontWeight: "medium",
-		textTransform: "none",
-		italic: false,
-		colorToken,
-		padding: "compact",
-		paddingX: "compact",
-		borderRadius: "none",
-		effects: { hover: [{
-			effectId: "nav-underline",
-			options: {
-				style: "grow",
-				...underlineColorToken ? { colorToken: underlineColorToken } : {}
-			}
-		}] }
-	}, typography);
-}
-function themedHeaderShadow(theme) {
-	switch (theme.shadow.elevation) {
-		case "none": return;
-		case "low": return { elevation: "sm" };
-		case "medium": return { elevation: "md" };
-		case "high": return { elevation: "lg" };
-		default: return assertNever(theme.shadow.elevation, "Unhandled theme shadow elevation");
-	}
-}
-function solidBrandHeader(theme) {
-	const ctaVariant = resolveHeaderCtaVariant(theme, "inverted");
-	return {
-		...baseHeader(theme),
-		variant: "classic",
-		positioning: "sticky",
-		shrinkOnScroll: true,
-		background: {
-			type: "color",
-			color: "primary"
-		},
-		textColor: "primaryForeground",
-		navColor: "primaryForeground",
-		navStyle: "underline-grow",
-		navWeight: "bold",
-		navLinkStyle: {
-			typography: "body",
-			fontWeight: "bold",
-			textTransform: "uppercase",
-			italic: false,
-			colorToken: "primaryForeground",
-			hoverColorToken: "secondary",
-			textSize: "sm",
-			letterSpacing: "wider",
-			padding: "compact",
-			paddingX: "compact",
-			borderRadius: "none",
-			effects: { hover: [{
-				effectId: "text-color-change",
-				options: { hoverColorToken: "secondary" }
-			}, {
-				effectId: "nav-underline",
-				options: {
-					style: "grow",
-					colorToken: "secondary"
-				}
-			}] }
-		},
-		dropdownStyle: {
-			background: "primary-700",
-			textColor: "primaryForeground",
-			borderColor: null,
-			shadow: "md",
-			borderRadius: "md",
-			hoverBackground: "primary-900",
-			hoverTextColor: "secondary",
-			textTransform: "uppercase",
-			letterSpacing: "wider",
-			fontWeight: "bold",
-			textSize: "sm"
-		},
-		border: {
-			style: "solid",
-			width: "none",
-			position: "none"
-		},
-		logoText: {
-			hideOnShrink: true,
-			mobileMaxWidth: "sm",
-			mobileWrapLines: 2
-		},
-		ctaGap: "compact",
-		ctaTreatment: "inverted",
-		...ctaVariant ? { ctaVariant } : {}
-	};
-}
-function cleanBaseHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "classic",
-		positioning: "sticky",
-		shrinkOnScroll: false,
-		background: {
-			type: "color",
-			color: "surface"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "minimal",
-		navWeight: "medium",
-		border: {
-			style: "solid",
-			width: "thin",
-			position: "bottom",
-			colorToken: "border"
-		},
-		ctaTreatment: "default",
-		ctaGap: "default"
-	};
-}
-function classicCenteredNavHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "classic",
-		navPlacement: "center",
-		positioning: "sticky",
-		shrinkOnScroll: false,
-		background: {
-			type: "color",
-			color: "surface"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "underline-grow",
-		navWeight: "medium",
-		navLinkStyle: underlineNavLinkStyle("text", "accent"),
-		border: {
-			style: "solid",
-			width: "thin",
-			position: "bottom",
-			colorToken: "border"
-		},
-		ctaTreatment: "primary",
-		ctaVariant: resolveHeaderCtaVariant(theme, "primary"),
-		ctaGap: "default",
-		logoText: {
-			mobileMaxWidth: "sm",
-			mobileWrapLines: 1,
-			hideOnShrink: false
-		}
-	};
-}
-function serifLineHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "centered",
-		positioning: "sticky",
-		shrinkOnScroll: false,
-		background: {
-			type: "color",
-			color: "background"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "underline-grow",
-		navWeight: "medium",
-		logo: {
-			fontFamily: "heading",
-			letterSpacing: "wide",
-			gradient: false
-		},
-		border: {
-			style: "solid",
-			width: "none",
-			position: "none"
-		},
-		shadow: { elevation: "none" },
-		ctaTreatment: "outline",
-		ctaVariant: resolveHeaderCtaVariant(theme, "outline"),
-		ctaGap: "relaxed"
-	};
-}
-function centeredCalmHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "centered",
-		positioning: "static",
-		shrinkOnScroll: false,
-		background: {
-			type: "color",
-			color: "surface"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "minimal",
-		navWeight: "medium",
-		ctaTreatment: "ghost",
-		ctaVariant: resolveHeaderCtaVariant(theme, "ghost"),
-		ctaGap: "none"
-	};
-}
-function practicalUtilityHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "classic",
-		positioning: "sticky",
-		shrinkOnScroll: true,
-		background: {
-			type: "color",
-			color: "surface"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "solid",
-		navWeight: "semibold",
-		shadow: themedHeaderShadow(theme),
-		border: {
-			style: "solid",
-			width: "thin",
-			position: "bottom",
-			colorToken: "border"
-		},
-		ctaTreatment: "primary",
-		ctaVariant: resolveHeaderCtaVariant(theme, "primary"),
-		ctaGap: "compact",
-		logoText: {
-			mobileMaxWidth: "sm",
-			mobileWrapLines: 1,
-			hideOnShrink: false
-		}
-	};
-}
-function minimalTransparentHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "classic",
-		positioning: "static",
-		shrinkOnScroll: false,
-		background: {
-			type: "color",
-			color: "transparent"
-		},
-		textColor: "text",
-		navColor: "text",
-		navStyle: "underline",
-		navWeight: "medium",
-		border: {
-			style: "solid",
-			width: "none",
-			position: "none"
-		},
-		ctaTreatment: "outline",
-		ctaVariant: resolveHeaderCtaVariant(theme, "outline"),
-		ctaGap: "default"
-	};
-}
-function transparentOverlayHeader(theme) {
-	return {
-		...baseHeader(theme),
-		variant: "transparent",
-		positioning: "fixed",
-		shrinkOnScroll: true,
-		background: {
-			type: "color",
-			color: "transparent"
-		},
-		textColor: "background",
-		navColor: "background",
-		navStyle: "frosted",
-		navWeight: "semibold",
-		border: {
-			style: "solid",
-			width: "none",
-			position: "none"
-		},
-		ctaTreatment: "inverted",
-		ctaVariant: resolveHeaderCtaVariant(theme, "inverted"),
-		ctaGap: "compact"
-	};
-}
-function floatingGlassHeader(theme) {
-	return {
-		...transparentOverlayHeader(theme),
+	{
+		id: asHeaderLayoutId("floating"),
+		label: "Floating",
+		description: "Detached header chrome that sits over the opening section.",
 		variant: "floating",
-		positioning: "sticky",
-		navStyle: "frosted",
-		navContainer: {
-			type: "glass",
-			tint: "text",
-			opacity: .16
-		},
-		container: {
-			rounded: "2xl",
-			border: true,
-			shadow: true,
-			padding: "sm",
-			tint: "background",
-			opacity: .12
-		}
-	};
+		defaultPositioning: "sticky",
+		shrinkOnScroll: true,
+		logoAccommodations: overlayLogoAccommodations,
+		openingRequirement: "requires-image-hero-with-contrast-overlay"
+	}
+]);
+function supportedLayouts(ids) {
+	return ids.map(asHeaderLayoutId);
 }
-const headerLookCatalog = defineExactCatalog()([
+const headerStyleCatalog = defineExactCatalog()([
 	{
-		id: asHeaderLookId("clean-base"),
-		label: "Clean base",
-		openingRequirement: "none",
-		logoAccommodations: inlineClassicLogoAccommodations,
-		compile: cleanBaseHeader
+		id: asHeaderStyleId("minimal"),
+		label: "Minimal",
+		description: "Quiet surface with simple color-change navigation.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "plain"
 	},
 	{
-		id: asHeaderLookId("classic-centered-nav"),
-		label: "Centered nav",
-		openingRequirement: "none",
-		maxRecommendedNavItems: 6,
-		logoAccommodations: inlineClassicLogoAccommodations,
-		compile: classicCenteredNavHeader
+		id: asHeaderStyleId("fine-line"),
+		label: "Seamless",
+		description: "Borderless surface with underline hover for a quieter page transition.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "plain"
 	},
 	{
-		id: asHeaderLookId("brand-solid"),
-		label: "Brand solid",
-		openingRequirement: "none",
-		logoAccommodations: inlineClassicLogoAccommodations,
-		compile: solidBrandHeader
+		id: asHeaderStyleId("soft-bar"),
+		label: "Soft Bar",
+		description: "Soft tinted surface with gentle pill hover states.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "plain"
 	},
 	{
-		id: asHeaderLookId("serif-line"),
-		label: "Serif line",
-		openingRequirement: "none",
-		maxRecommendedNavItems: 6,
-		logoAccommodations: centeredLogoAccommodations,
-		compile: serifLineHeader
+		id: asHeaderStyleId("pill-nav"),
+		label: "Pill Nav",
+		description: "A calm pill navigation rail over a neutral header.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "plain"
 	},
 	{
-		id: asHeaderLookId("centered-calm"),
-		label: "Centered calm",
-		openingRequirement: "none",
-		maxRecommendedNavItems: 5,
-		logoAccommodations: centeredLogoAccommodations,
-		compile: centeredCalmHeader
+		id: asHeaderStyleId("brand-bar"),
+		label: "Brand Bar",
+		description: "Solid brand surface with high-contrast navigation.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "brand-caps"
 	},
 	{
-		id: asHeaderLookId("practical-utility"),
-		label: "Practical utility",
-		openingRequirement: "none",
-		requiresProminentCta: true,
-		logoAccommodations: inlineClassicLogoAccommodations,
-		compile: practicalUtilityHeader
+		id: asHeaderStyleId("brand-underline"),
+		label: "Brand Underline",
+		description: "Brand surface with underline-grow navigation.",
+		supportedLayoutIds: supportedLayouts(["classic"]),
+		navTypography: "brand-caps"
 	},
 	{
-		id: asHeaderLookId("minimal-transparent"),
-		label: "Minimal transparent",
-		openingRequirement: "reserved-space-ok",
-		logoAccommodations: inlineClassicLogoAccommodations,
-		compile: minimalTransparentHeader
+		id: asHeaderStyleId("brand-pill"),
+		label: "Brand Pill",
+		description: "Solid brand surface with rounded active and hover states.",
+		supportedLayoutIds: supportedLayouts([
+			"classic",
+			"centered",
+			"floating"
+		]),
+		navTypography: "brand-caps"
 	},
 	{
-		id: asHeaderLookId("transparent-overlay"),
-		label: "Transparent overlay",
-		openingRequirement: "requires-image-hero-with-contrast-overlay",
-		maxRecommendedNavItems: 5,
-		logoAccommodations: overlayLogoAccommodations,
-		compile: transparentOverlayHeader
+		id: asHeaderStyleId("brand-capsule"),
+		label: "Brand Capsule",
+		description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.",
+		supportedLayoutIds: supportedLayouts(["classic"]),
+		navTypography: "quiet-caps"
 	},
 	{
-		id: asHeaderLookId("floating-glass"),
-		label: "Floating glass",
-		openingRequirement: "requires-image-hero-with-contrast-overlay",
-		maxRecommendedNavItems: 5,
-		logoAccommodations: overlayLogoAccommodations,
-		compile: floatingGlassHeader
+		id: asHeaderStyleId("serif-line"),
+		label: "Serif Line",
+		description: "Typographic logo treatment with understated underline navigation.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "heading"
+	},
+	{
+		id: asHeaderStyleId("flat-tabs"),
+		label: "Flat Tabs",
+		description: "Flat block hover and active states with a Swiss utility feel.",
+		supportedLayoutIds: supportedLayouts(["classic", "centered"]),
+		navTypography: "quiet-caps"
+	},
+	{
+		id: asHeaderStyleId("glass"),
+		label: "Glass",
+		description: "Translucent chrome with frosted navigation backing.",
+		supportedLayoutIds: supportedLayouts(["floating"]),
+		navTypography: "plain"
+	},
+	{
+		id: asHeaderStyleId("minimal-surface"),
+		label: "Clear Split",
+		description: "Floating logo with transparent navigation and no shared shell.",
+		supportedLayoutIds: supportedLayouts(["floating"]),
+		navTypography: "plain",
+		openingForegroundTarget: "all",
+		scrollTreatment: "contrast-glass",
+		interactionPalette: clearSplitInteractionPalette
+	},
+	{
+		id: asHeaderStyleId("soft-shell"),
+		label: "Soft Shell",
+		description: "Floating rounded shell with soft pill navigation states.",
+		supportedLayoutIds: supportedLayouts(["floating"]),
+		navTypography: "plain"
+	},
+	{
+		id: asHeaderStyleId("split-glass"),
+		label: "Split Glass",
+		description: "Logo floats independently while the navigation sits in a glass rail.",
+		supportedLayoutIds: supportedLayouts(["floating"]),
+		navTypography: "quiet-caps",
+		openingForegroundTarget: "brand-only"
+	},
+	{
+		id: asHeaderStyleId("split-pill"),
+		label: "Split Pill",
+		description: "Logo floats independently with a soft pill-backed navigation rail.",
+		supportedLayoutIds: supportedLayouts(["floating"]),
+		navTypography: "heading",
+		openingForegroundTarget: "brand-only"
 	}
 ]);
-new Map(headerLookCatalog.map((look) => [look.id, look]));
+new Map(headerLayoutCatalog.map((layout) => [layout.id, layout]));
+new Map(headerStyleCatalog.map((style) => [style.id, style]));
 //#endregion
 //#region ../theme-core/src/site-styles/footerLooks.ts
 function asFooterLookId(value) {
@@ -8767,75 +8218,75 @@ function defaultTypographyForRecipe(recipe) {
 		case "classic-serif": return classicSerifTypography;
 	}
 }
-const designResolutionPolicySchema = z$1.enum([
+const designResolutionPolicySchema = z.enum([
 	"generated",
 	"user",
 	"admin",
 	"sdk"
 ]);
-const runtimeStyleFieldNameSchema = z$1.enum(themeV2RuntimeStyleFieldNames);
-const nonEmptyRuntimeStyleFieldNamesSchema = z$1.array(runtimeStyleFieldNameSchema).min(1).transform((fields) => [fields[0], ...fields.slice(1)]);
-const heroLegibilityStrategySchema = z$1.enum([
+const runtimeStyleFieldNameSchema = z.enum(themeV2RuntimeStyleFieldNames);
+const nonEmptyRuntimeStyleFieldNamesSchema = z.array(runtimeStyleFieldNameSchema).min(1).transform((fields) => [fields[0], ...fields.slice(1)]);
+const heroLegibilityStrategySchema = z.enum([
 	"none",
 	"scrim-gradient",
 	"solid-panel"
 ]);
-const heroCompositionIntentSchema = z$1.enum(["center", "bottom-left"]);
-const heroTypographyScaleIntentSchema = z$1.enum([
+const heroCompositionIntentSchema = z.enum(["center", "bottom-left"]);
+const heroTypographyScaleIntentSchema = z.enum([
 	"quiet",
 	"editorial",
 	"display",
 	"poster"
 ]);
-const sectionHeightIntentSchema = z$1.enum([
+const sectionHeightIntentSchema = z.enum([
 	"default",
 	"banner",
 	"hero",
 	"immersive"
 ]);
-const imageSurfaceTreatmentIntensitySchema = z$1.enum([
+const imageSurfaceTreatmentIntensitySchema = z.enum([
 	"soft",
 	"balanced",
 	"strong"
 ]);
-const imageSurfaceMotionSchema = z$1.enum(["static", "fixed-frame"]);
-const imageSurfaceTreatmentSchema = z$1.discriminatedUnion("kind", [
-	z$1.object({ kind: z$1.literal("none") }).strict(),
-	z$1.object({
-		kind: z$1.literal("brand-scrim"),
-		token: z$1.enum([
+const imageSurfaceMotionSchema = z.enum(["static", "fixed-frame"]);
+const imageSurfaceTreatmentSchema = z.discriminatedUnion("kind", [
+	z.object({ kind: z.literal("none") }).strict(),
+	z.object({
+		kind: z.literal("brand-scrim"),
+		token: z.enum([
 			"primary",
 			"secondary",
 			"accent"
 		]),
 		intensity: imageSurfaceTreatmentIntensitySchema.optional()
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("brand-wash"),
-		token: z$1.enum([
+	z.object({
+		kind: z.literal("brand-wash"),
+		token: z.enum([
 			"primary",
 			"secondary",
 			"accent"
 		]),
 		intensity: imageSurfaceTreatmentIntensitySchema.optional()
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("neutral-scrim"),
+	z.object({
+		kind: z.literal("neutral-scrim"),
 		intensity: imageSurfaceTreatmentIntensitySchema.optional()
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("neutral-wash"),
+	z.object({
+		kind: z.literal("neutral-wash"),
 		intensity: imageSurfaceTreatmentIntensitySchema.optional()
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("solid-panel"),
+	z.object({
+		kind: z.literal("solid-panel"),
 		intensity: imageSurfaceTreatmentIntensitySchema.optional()
 	}).strict()
 ]);
-const testimonialCardTreatmentSchema = z$1.enum(["default", "accent-quote"]);
-const tileTreatmentSchema = z$1.enum(tileTreatmentValues);
-const eventListTreatmentSchema = z$1.enum(eventListTreatmentValues);
-const eyebrowTreatmentSchema = z$1.enum(eyebrowTreatmentValues);
+const testimonialCardTreatmentSchema = z.enum(["default", "accent-quote"]);
+const tileTreatmentSchema = z.enum(tileTreatmentValues);
+const eventListTreatmentSchema = z.enum(eventListTreatmentValues);
+const eyebrowTreatmentSchema = z.enum(eyebrowTreatmentValues);
 function uniqueNonEmpty(values) {
 	const uniqueValues = [...new Set(values)];
 	const firstValue = uniqueValues[0];
@@ -8845,27 +8296,27 @@ function uniqueNonEmpty(values) {
 const userPanelTreatments = uniqueNonEmpty(userDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "panel").map((frame) => frame.treatment));
 const userFlushTreatments = uniqueNonEmpty(userDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "flush-panel").map((frame) => frame.treatment));
 const userFlushBleeds = uniqueNonEmpty(userDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "flush-panel").map((frame) => frame.bleed));
-const contentFrameIntentSchema = z$1.discriminatedUnion("kind", [
-	z$1.object({ kind: z$1.literal("plain") }).strict(),
-	z$1.object({
-		kind: z$1.literal("panel"),
-		treatment: z$1.enum(userPanelTreatments)
+const contentFrameIntentSchema = z.discriminatedUnion("kind", [
+	z.object({ kind: z.literal("plain") }).strict(),
+	z.object({
+		kind: z.literal("panel"),
+		treatment: z.enum(userPanelTreatments)
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("flush-panel"),
-		treatment: z$1.enum(userFlushTreatments),
-		bleed: z$1.enum(userFlushBleeds)
+	z.object({
+		kind: z.literal("flush-panel"),
+		treatment: z.enum(userFlushTreatments),
+		bleed: z.enum(userFlushBleeds)
 	}).strict()
 ]);
-const blockDesignPlanSchema = z$1.object({
-	blockId: z$1.string().min(1).transform(asDesignBlockId),
-	blockKind: z$1.string().min(1),
-	purpose: z$1.string().min(1),
-	sectionSurface: z$1.enum(userDesignOptionCatalog.sectionSurfaces),
+const blockDesignPlanSchema = z.object({
+	blockId: z.string().min(1).transform(asDesignBlockId),
+	blockKind: z.string().min(1),
+	purpose: z.string().min(1),
+	sectionSurface: z.enum(userDesignOptionCatalog.sectionSurfaces),
 	contentFrame: contentFrameIntentSchema,
-	itemSurface: z$1.enum(userDesignOptionCatalog.itemSurfaces),
-	transitionAfter: z$1.enum(userDesignOptionCatalog.transitions),
-	emphasis: z$1.enum(userDesignOptionCatalog.emphases),
+	itemSurface: z.enum(userDesignOptionCatalog.itemSurfaces),
+	transitionAfter: z.enum(userDesignOptionCatalog.transitions),
+	emphasis: z.enum(userDesignOptionCatalog.emphases),
 	sectionHeight: sectionHeightIntentSchema.optional(),
 	heroLegibility: heroLegibilityStrategySchema.optional(),
 	heroComposition: heroCompositionIntentSchema.optional(),
@@ -8877,39 +8328,39 @@ const blockDesignPlanSchema = z$1.object({
 	eventListTreatment: eventListTreatmentSchema.optional(),
 	eyebrowTreatment: eyebrowTreatmentSchema.optional()
 }).strict();
-const styleAuthoritySchema = z$1.discriminatedUnion("kind", [
-	z$1.object({
-		kind: z$1.literal("theme-v2"),
+const styleAuthoritySchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("theme-v2"),
 		source: designResolutionPolicySchema,
-		siteStyleId: z$1.string().min(1).transform(asSiteStyleId),
-		templateId: z$1.string().min(1).transform(asDesignSystemTemplateId),
-		templateVersion: z$1.number().int().nonnegative(),
-		resolverVersion: z$1.number().int().nonnegative()
+		siteStyleId: z.string().min(1).transform(asSiteStyleId),
+		templateId: z.string().min(1).transform(asDesignSystemTemplateId),
+		templateVersion: z.number().int().nonnegative(),
+		resolverVersion: z.number().int().nonnegative()
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("legacy-raw"),
-		reason: z$1.enum(["pre-theme-v2", "manual-runtime-fields"])
+	z.object({
+		kind: z.literal("legacy-raw"),
+		reason: z.enum(["pre-theme-v2", "manual-runtime-fields"])
 	}).strict(),
-	z$1.object({
-		kind: z$1.literal("advanced-detached"),
-		reason: z$1.literal("detached-custom-runtime-fields")
+	z.object({
+		kind: z.literal("advanced-detached"),
+		reason: z.literal("detached-custom-runtime-fields")
 	}).strict()
 ]);
-const blockRuntimeStyleAuthoritySchema = z$1.object({
-	unit: z$1.literal("block-runtime-fields"),
-	blockId: z$1.string().min(1).transform(asDesignBlockId),
+const blockRuntimeStyleAuthoritySchema = z.object({
+	unit: z.literal("block-runtime-fields"),
+	blockId: z.string().min(1).transform(asDesignBlockId),
 	fields: nonEmptyRuntimeStyleFieldNamesSchema,
 	authority: styleAuthoritySchema
 }).strict();
-z$1.object({
-	schemaVersion: z$1.literal(1),
-	siteStyleId: z$1.string().min(1).transform(asSiteStyleId),
-	templateId: z$1.string().min(1).transform(asDesignSystemTemplateId),
-	templateVersion: z$1.number().int().nonnegative(),
-	resolverVersion: z$1.number().int().nonnegative(),
-	rhythmPresetId: z$1.string().min(1),
-	blocks: z$1.array(blockDesignPlanSchema),
-	styleAuthorities: z$1.array(blockRuntimeStyleAuthoritySchema)
+z.object({
+	schemaVersion: z.literal(1),
+	siteStyleId: z.string().min(1).transform(asSiteStyleId),
+	templateId: z.string().min(1).transform(asDesignSystemTemplateId),
+	templateVersion: z.number().int().nonnegative(),
+	resolverVersion: z.number().int().nonnegative(),
+	rhythmPresetId: z.string().min(1),
+	blocks: z.array(blockDesignPlanSchema),
+	styleAuthorities: z.array(blockRuntimeStyleAuthoritySchema)
 }).strict();
 //#endregion
 //#region ../theme-core/src/site-styles/sectionTransitions.ts
@@ -9101,7 +8552,10 @@ function uniformSectionForeground(token) {
 		supportingColor: token
 	};
 }
-const SOFT_EARTH_SITE_STYLE_ID = asSiteStyleId("site-style:soft-earth");
+//#endregion
+//#region ../theme-core/src/site-styles/curatedSiteStyles.ts
+const SOFT_EARTH_SITE_STYLE_ID_VALUE = "site-style:soft-earth";
+asSiteStyleId(SOFT_EARTH_SITE_STYLE_ID_VALUE);
 const quietBudget = {
 	accentDensity: "low",
 	panelDensity: "medium",
@@ -9334,9 +8788,290 @@ function uniqueContentFrameKinds() {
 	return [firstKind, ...kinds.slice(1)];
 }
 const generatedContentFrameKinds = uniqueContentFrameKinds();
+function defineHeaderCuration(input) {
+	const toEntry = ({ layoutId, styleIds }) => {
+		const [firstStyleId, ...remainingStyleIds] = styleIds;
+		return {
+			layout: { id: asHeaderLayoutId(layoutId) },
+			styles: [{ id: asHeaderStyleId(firstStyleId) }, ...remainingStyleIds.map((styleId) => ({ id: asHeaderStyleId(styleId) }))]
+		};
+	};
+	const [first, ...remaining] = input;
+	return [toEntry(first), ...remaining.map(toEntry)];
+}
+const headerCurationBySiteStyle = {
+	"site-style:calm-studio": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"fine-line",
+			"soft-bar",
+			"brand-bar"
+		]
+	}]),
+	"site-style:clear-professional": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"flat-tabs",
+			"brand-bar",
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:warm-editorial": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"serif-line",
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:bright-community": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"brand-bar",
+			"flat-tabs",
+			"minimal",
+			"brand-underline",
+			"brand-pill",
+			"fine-line"
+		]
+	}]),
+	"site-style:quiet-luxury": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "centered",
+		styleIds: [
+			"serif-line",
+			"fine-line",
+			"minimal",
+			"soft-bar"
+		]
+	}]),
+	"site-style:practical-services": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"flat-tabs",
+			"brand-bar",
+			"minimal",
+			"brand-underline",
+			"brand-pill",
+			"fine-line"
+		]
+	}]),
+	"site-style:modern-wellness": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"minimal",
+			"soft-bar",
+			"pill-nav",
+			"fine-line"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"soft-bar",
+			"pill-nav",
+			"fine-line"
+		]
+	}]),
+	"site-style:quiet-practice": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"flat-tabs",
+			"minimal",
+			"fine-line",
+			"soft-bar",
+			"brand-bar"
+		]
+	}, {
+		layoutId: "centered",
+		styleIds: [
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:clarity-zen-blue": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:personal-retreat-journal": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"serif-line",
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:tactile-workshop": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"brand-bar",
+			"flat-tabs",
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:soft-earth": defineHeaderCuration([{
+		layoutId: "centered",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"minimal",
+			"serif-line",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:bold-launch": defineHeaderCuration([{
+		layoutId: "floating",
+		styleIds: [
+			"glass",
+			"split-glass",
+			"brand-pill",
+			"soft-shell"
+		]
+	}, {
+		layoutId: "classic",
+		styleIds: [
+			"brand-bar",
+			"brand-underline",
+			"flat-tabs",
+			"brand-pill",
+			"fine-line"
+		]
+	}]),
+	"site-style:south-west-twerk-school": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"brand-bar",
+			"flat-tabs",
+			"brand-underline",
+			"brand-pill",
+			"fine-line"
+		]
+	}, {
+		layoutId: "floating",
+		styleIds: [
+			"glass",
+			"split-glass",
+			"brand-pill",
+			"soft-shell"
+		]
+	}]),
+	"site-style:kirtan-ornate": defineHeaderCuration([{
+		layoutId: "floating",
+		styleIds: [
+			"minimal-surface",
+			"split-glass",
+			"glass"
+		]
+	}]),
+	"site-style:original-joy": defineHeaderCuration([{
+		layoutId: "floating",
+		styleIds: [
+			"minimal-surface",
+			"split-glass",
+			"glass"
+		]
+	}]),
+	"site-style:fulcrum": defineHeaderCuration([{
+		layoutId: "classic",
+		styleIds: [
+			"fine-line",
+			"minimal",
+			"serif-line",
+			"soft-bar"
+		]
+	}, {
+		layoutId: "centered",
+		styleIds: [
+			"serif-line",
+			"minimal",
+			"fine-line",
+			"soft-bar"
+		]
+	}]),
+	"site-style:grounded-practice": defineHeaderCuration([
+		{
+			layoutId: "classic",
+			styleIds: [
+				"minimal",
+				"serif-line",
+				"fine-line",
+				"soft-bar"
+			]
+		},
+		{
+			layoutId: "centered",
+			styleIds: [
+				"serif-line",
+				"fine-line",
+				"minimal",
+				"soft-bar"
+			]
+		},
+		{
+			layoutId: "floating",
+			styleIds: ["minimal-surface", "glass"]
+		}
+	])
+};
 function defineCuratedSiteStyle(input) {
-	const legacyHeaderLookIds = input.recommendedHeaderLookIds ?? ["clean-base"];
-	const inferredHeaderCuration = inferHeaderCurationFromLegacyLooks(legacyHeaderLookIds, input.tokenRecipes);
 	return {
 		id: asSiteStyleId(input.id),
 		name: input.name,
@@ -9361,17 +9096,7 @@ function defineCuratedSiteStyle(input) {
 		componentRuntimeRules: input.componentRuntimeRules ?? componentRuntimeRulesForTokenRecipes(input.tokenRecipes),
 		...input.defaultBlockVariants ? { defaultBlockVariants: input.defaultBlockVariants } : {},
 		recommendedAppearancePresetIds: (input.recommendedAppearancePresetIds ?? []).map(asAppearancePresetId),
-		defaultHeaderSelection: input.defaultHeaderSelection ? {
-			layoutId: asHeaderLayoutId(input.defaultHeaderSelection.layoutId),
-			styleId: asHeaderStyleId(input.defaultHeaderSelection.styleId)
-		} : inferredHeaderCuration.defaultHeaderSelection,
-		recommendedHeaderLayoutChoices: input.recommendedHeaderLayoutChoices ?? inferredHeaderCuration.recommendedHeaderLayoutChoices,
-		recommendedHeaderStyleChoicesByLayout: input.recommendedHeaderStyleChoicesByLayout ?? inferredHeaderCuration.recommendedHeaderStyleChoicesByLayout,
-		discouragedHeaderSelections: input.discouragedHeaderSelections?.map((selection) => ({
-			layoutId: asHeaderLayoutId(selection.layoutId),
-			styleId: asHeaderStyleId(selection.styleId)
-		})),
-		recommendedHeaderLookIds: legacyHeaderLookIds.map(asHeaderLookId),
+		headerCuration: headerCurationBySiteStyle[input.id],
 		recommendedFooterLookIds: (input.recommendedFooterLookIds ?? []).map(asFooterLookId),
 		buttonStyleChoices: input.buttonStyleChoices,
 		paletteRecommendations: input.paletteRecommendations,
@@ -9396,148 +9121,6 @@ function paletteRecommendation(authoringKey, note) {
 		note
 	} : { id: valueKey };
 }
-function headerLayoutChoice(id, note) {
-	return note ? {
-		id: asHeaderLayoutId(id),
-		note
-	} : { id: asHeaderLayoutId(id) };
-}
-function headerStyleChoice(id, note) {
-	return note ? {
-		id: asHeaderStyleId(id),
-		note
-	} : { id: asHeaderStyleId(id) };
-}
-function unbrandHeaderLayoutId(id) {
-	return id;
-}
-function uniqueHeaderLayoutChoices(choices) {
-	const seen = /* @__PURE__ */ new Set();
-	const unique = choices.filter((choice) => {
-		if (seen.has(choice.id)) return false;
-		seen.add(choice.id);
-		return true;
-	});
-	const first = unique[0];
-	if (!first) throw new Error("Expected at least one curated header layout choice.");
-	return [first, ...unique.slice(1)];
-}
-function nonEmptyHeaderStyleChoices(choices, fallbackLayoutId) {
-	return [choices[0] ?? { id: getCompatibleHeaderStyleIds(fallbackLayoutId)[0] ?? asHeaderStyleId("minimal") }, ...choices.slice(1)];
-}
-function uniqueCompatibleHeaderStyleChoices(choices, fallbackLayoutId) {
-	const compatible = new Set(getCompatibleHeaderStyleIds(fallbackLayoutId));
-	const seen = /* @__PURE__ */ new Set();
-	return nonEmptyHeaderStyleChoices(choices.filter((choice) => {
-		if (!compatible.has(choice.id)) return false;
-		if (seen.has(choice.id)) return false;
-		seen.add(choice.id);
-		return true;
-	}), fallbackLayoutId);
-}
-function inferredHeaderStyleValuesForRecipes(layoutId, recipes) {
-	switch (layoutId) {
-		case "classic":
-			if (isExpressiveRecipe(recipes)) return [
-				"brand-bar",
-				"brand-underline",
-				"flat-tabs",
-				"brand-pill",
-				"fine-line"
-			];
-			if (recipes.spacing === "compact") return [
-				"flat-tabs",
-				"fine-line",
-				"minimal",
-				"brand-bar"
-			];
-			if (isSerifTypographyRecipe(recipes)) return [
-				"serif-line",
-				"fine-line",
-				"minimal",
-				"soft-bar"
-			];
-			if (recipes.radius === "rounded" || recipes.radius === "pill") return [
-				"soft-bar",
-				"pill-nav",
-				"fine-line",
-				"minimal"
-			];
-			return [
-				"fine-line",
-				"minimal",
-				"soft-bar",
-				"brand-bar"
-			];
-		case "centered":
-			if (isSerifTypographyRecipe(recipes)) return [
-				"serif-line",
-				"fine-line",
-				"minimal",
-				"soft-bar"
-			];
-			if (isExpressiveRecipe(recipes)) return [
-				"brand-pill",
-				"flat-tabs",
-				"brand-bar",
-				"fine-line"
-			];
-			if (recipes.radius === "rounded" || recipes.radius === "pill") return [
-				"soft-bar",
-				"pill-nav",
-				"fine-line",
-				"minimal"
-			];
-			return [
-				"minimal",
-				"fine-line",
-				"soft-bar"
-			];
-		case "floating":
-			if (isExpressiveRecipe(recipes)) return [
-				"glass",
-				"split-glass",
-				"brand-pill",
-				"soft-shell"
-			];
-			if (isSerifTypographyRecipe(recipes)) return [
-				"split-pill",
-				"minimal-surface",
-				"soft-shell"
-			];
-			return [
-				"soft-shell",
-				"minimal-surface",
-				"glass"
-			];
-		default: return [];
-	}
-}
-function isExpressiveRecipe(recipes) {
-	return recipes.contrast === "maximum" || recipes.shadow === "layered" || recipes.motion === "expressive";
-}
-function isSerifTypographyRecipe(recipes) {
-	return recipes.typography === "serif-editorial" || recipes.typography === "classic-serif";
-}
-function inferHeaderCurationFromLegacyLooks(lookIds, recipes) {
-	const selections = lookIds.map((lookId) => resolveLegacyHeaderLookAlias(asHeaderLookId(lookId))).filter((selection) => Boolean(selection));
-	const defaultHeaderSelection = selections[0] ?? {
-		layoutId: asHeaderLayoutId("classic"),
-		styleId: asHeaderStyleId("minimal")
-	};
-	const layoutChoices = uniqueHeaderLayoutChoices(selections.map((selection) => headerLayoutChoice(selection.layoutId)));
-	const stylesByLayout = {};
-	for (const layoutChoice of layoutChoices) {
-		const legacyStyleChoices = selections.filter((selection) => selection.layoutId === layoutChoice.id).map((selection) => headerStyleChoice(selection.styleId));
-		const inferredStyleChoices = inferredHeaderStyleValuesForRecipes(layoutChoice.id, recipes).map((styleId) => headerStyleChoice(styleId));
-		stylesByLayout[unbrandHeaderLayoutId(layoutChoice.id)] = uniqueCompatibleHeaderStyleChoices([...legacyStyleChoices, ...inferredStyleChoices], layoutChoice.id);
-	}
-	return {
-		defaultHeaderSelection,
-		recommendedHeaderLayoutChoices: layoutChoices,
-		recommendedHeaderStyleChoicesByLayout: stylesByLayout
-	};
-}
 /**
 * V1 generated site styles are curated product presets, not AI-authored design
 * systems. Generators choose one of these bounded entries, then downstream
@@ -9567,11 +9150,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: quietBudget,
-		recommendedHeaderLookIds: [
-			"centered-calm",
-			"minimal-transparent",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("soft-pill"),
 			buttonChoice("pebble"),
@@ -9604,11 +9182,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"practical-utility",
-			"brand-solid",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("confident-chip"),
 			buttonChoice("soft-pill"),
@@ -9643,11 +9216,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"serif-line",
-			"minimal-transparent",
-			"centered-calm"
-		],
 		buttonStyleChoices: [
 			buttonChoice("editorial-link"),
 			buttonChoice("soft-pill"),
@@ -9683,11 +9251,6 @@ const curatedSiteStyles = [
 			motion: "expressive"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"brand-solid",
-			"practical-utility",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("pebble"),
 			buttonChoice("brushed-wash"),
@@ -9744,11 +9307,6 @@ const curatedSiteStyles = [
 			motion: "none"
 		},
 		compositionBudget: quietBudget,
-		recommendedHeaderLookIds: [
-			"minimal-transparent",
-			"serif-line",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("editorial-link"),
 			buttonChoice("confident-chip"),
@@ -9806,11 +9364,6 @@ const curatedSiteStyles = [
 			motion: "none"
 		},
 		compositionBudget: quietBudget,
-		recommendedHeaderLookIds: [
-			"practical-utility",
-			"brand-solid",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("confident-chip"),
 			buttonChoice("pebble"),
@@ -9845,11 +9398,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"centered-calm",
-			"minimal-transparent",
-			"clean-base"
-		],
 		buttonStyleChoices: [
 			buttonChoice("soft-pill"),
 			buttonChoice("pebble"),
@@ -9918,11 +9466,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: quietBudget,
-		recommendedHeaderLookIds: [
-			"practical-utility",
-			"clean-base",
-			"centered-calm"
-		],
 		buttonStyleChoices: [
 			buttonChoice("pebble"),
 			buttonChoice("soft-pill"),
@@ -10037,11 +9580,6 @@ const curatedSiteStyles = [
 			"faq-contained-help",
 			"contact-form-panel"
 		],
-		recommendedHeaderLookIds: [
-			"centered-calm",
-			"serif-line",
-			"minimal-transparent"
-		],
 		recommendedFooterLookIds: ["footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("soft-pill"),
@@ -10112,11 +9650,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"serif-line",
-			"centered-calm",
-			"minimal-transparent"
-		],
 		buttonStyleChoices: [
 			buttonChoice("editorial-link"),
 			buttonChoice("soft-pill"),
@@ -10185,11 +9718,6 @@ const curatedSiteStyles = [
 			motion: "subtle"
 		},
 		compositionBudget: balancedBudget,
-		recommendedHeaderLookIds: [
-			"brand-solid",
-			"practical-utility",
-			"clean-base"
-		],
 		recommendedFooterLookIds: ["footer-links-emphasized", "footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("pebble"),
@@ -10205,7 +9733,7 @@ const curatedSiteStyles = [
 		]
 	}),
 	defineCuratedSiteStyle({
-		id: SOFT_EARTH_SITE_STYLE_ID,
+		id: SOFT_EARTH_SITE_STYLE_ID_VALUE,
 		name: "Soft Earth",
 		headingDecoration: {
 			family: "organic-squiggle",
@@ -10307,11 +9835,6 @@ const curatedSiteStyles = [
 			"testimonials-non-carded",
 			"contact-form-panel"
 		],
-		recommendedHeaderLookIds: [
-			"centered-calm",
-			"minimal-transparent",
-			"serif-line"
-		],
 		recommendedFooterLookIds: ["footer-links-quiet", "footer-links-emphasized"],
 		buttonStyleChoices: [
 			buttonChoice("earth-pill"),
@@ -10379,11 +9902,6 @@ const curatedSiteStyles = [
 			motion: "expressive"
 		},
 		compositionBudget: expressiveBudget,
-		recommendedHeaderLookIds: [
-			"transparent-overlay",
-			"floating-glass",
-			"brand-solid"
-		],
 		buttonStyleChoices: [
 			buttonChoice("ink-stamp"),
 			buttonChoice("confident-chip"),
@@ -10434,11 +9952,6 @@ const curatedSiteStyles = [
 			"testimonials-brand-statement-cards",
 			"contact-form-panel"
 		],
-		recommendedHeaderLookIds: [
-			"brand-solid",
-			"transparent-overlay",
-			"practical-utility"
-		],
 		recommendedFooterLookIds: ["footer-links-emphasized", "footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("showtime-pill"),
@@ -10510,17 +10023,6 @@ const curatedSiteStyles = [
 			"testimonials-statement-cards",
 			"contact-form-panel"
 		],
-		defaultHeaderSelection: {
-			layoutId: "floating",
-			styleId: "minimal-surface"
-		},
-		recommendedHeaderLayoutChoices: [headerLayoutChoice("floating")],
-		recommendedHeaderStyleChoicesByLayout: { floating: [
-			headerStyleChoice("minimal-surface"),
-			headerStyleChoice("split-glass"),
-			headerStyleChoice("glass")
-		] },
-		recommendedHeaderLookIds: ["minimal-transparent"],
 		recommendedFooterLookIds: ["footer-links-emphasized", "footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("ornate-ritual"),
@@ -10564,17 +10066,6 @@ const curatedSiteStyles = [
 			} }
 		},
 		recommendedAppearancePresetIds: ["feature-cards-bold-colors", "testimonials-statement-cards"],
-		defaultHeaderSelection: {
-			layoutId: "floating",
-			styleId: "minimal-surface"
-		},
-		recommendedHeaderLayoutChoices: [headerLayoutChoice("floating")],
-		recommendedHeaderStyleChoicesByLayout: { floating: [
-			headerStyleChoice("minimal-surface"),
-			headerStyleChoice("split-glass"),
-			headerStyleChoice("glass")
-		] },
-		recommendedHeaderLookIds: ["minimal-transparent"],
 		recommendedFooterLookIds: ["footer-links-emphasized", "footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("joy-stamp"),
@@ -10660,12 +10151,6 @@ const curatedSiteStyles = [
 			},
 			testimonialQuote: serifDisplayQuote
 		},
-		recommendedHeaderLookIds: [
-			"classic-centered-nav",
-			"serif-line",
-			"centered-calm",
-			"clean-base"
-		],
 		recommendedFooterLookIds: ["footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("flat-ink"),
@@ -10739,11 +10224,6 @@ const curatedSiteStyles = [
 			"testimonials-non-carded",
 			"faq-base-accordion"
 		],
-		recommendedHeaderLookIds: [
-			"minimal-transparent",
-			"serif-line",
-			"clean-base"
-		],
 		recommendedFooterLookIds: ["footer-links-quiet"],
 		buttonStyleChoices: [
 			buttonChoice("quiet-arrow", void 0, { secondaryTreatment: "solid-accent" }),
@@ -12253,6 +11733,9 @@ const containerResponsiveThemeCss = `/*
       .rb-md-grid-cols-4 {
         grid-template-columns: repeat(4, minmax(0, 1fr));
       }
+      .rb-md-col-span-2 {
+        grid-column: span 2 / span 2;
+      }
     }
 
 }
@@ -12268,6 +11751,9 @@ const containerResponsiveThemeCss = `/*
       .rb-lg-grid-cols-4 {
         grid-template-columns: repeat(4, minmax(0, 1fr));
       }
+      .rb-lg-grid-cols-5 {
+        grid-template-columns: repeat(5, minmax(0, 1fr));
+      }
       .rb-lg-w-3\\/4 {
         width: 75%;
       }
@@ -12283,6 +11769,9 @@ const containerResponsiveThemeCss = `/*
       .rb-lg-col-span-4 {
         grid-column: span 4 / span 4;
       }
+      .rb-lg-col-span-5 {
+        grid-column: span 5 / span 5;
+      }
     }
 
 }
@@ -19753,7 +19242,8 @@ const containerResponsiveThemeCss = `/*
 :where(.theme-scope) .shop--register .shop__card-name,
 :where(.theme-scope) .shop--register .shop__card-price,
 :where(.theme-scope) .shop--register .shop__card-details,
-:where(.theme-scope) .shop--register .shop__cta {
+:where(.theme-scope) .shop--register .shop__cta,
+:where(.theme-scope) .shop--register .shop__purchase-unavailable {
   margin: 0;
 }
 
@@ -19789,7 +19279,8 @@ const containerResponsiveThemeCss = `/*
   font-size: 0.86rem;
 }
 
-:where(.theme-scope) .shop--register .shop__cta {
+:where(.theme-scope) .shop--register .shop__cta,
+:where(.theme-scope) .shop--register .shop__purchase-unavailable {
   grid-column: 4;
   grid-row: 1;
   align-self: center;
@@ -19821,7 +19312,8 @@ const containerResponsiveThemeCss = `/*
     grid-row: 2;
   }
 
-  :where(.theme-scope) .shop--register .shop__cta {
+  :where(.theme-scope) .shop--register .shop__cta,
+  :where(.theme-scope) .shop--register .shop__purchase-unavailable {
     grid-column: 1 / -1;
     grid-row: 3;
     justify-self: start;
@@ -19914,6 +19406,13 @@ const containerResponsiveThemeCss = `/*
   align-self: flex-start;
 }
 
+:where(.theme-scope) .shop__purchase-unavailable {
+  margin: auto 0 0;
+  color: var(--rb-surface-supporting-color, rgb(var(--tb-mutedText)));
+  font-size: 0.875rem;
+  line-height: 1.4;
+}
+
 /* Responsive grid */
 @container rb-site (max-width: 768px) {
 @scope ([data-rb-responsive-mode="container"]) to (:scope [data-rb-responsive-mode]) {
@@ -24756,13 +24255,25 @@ function generateVariantCss(scopeId, variant, settings, palette) {
 			"justify-content: center;",
 			`border-radius: ${CORNER_RADIUS_MAP$1[settings.corners]};`,
 			`box-shadow: ${SHADOW_VALUES$1[settings.shadow]};`,
-			...declarationStrings(resolvedButtonColourDeclarations(result.states.base)),
+			...declarationStrings(resolvedButtonColourDeclarations(result.states.base, {
+				role: variant.id,
+				state: "base"
+			})),
 			borderWidth === "0" ? "border: none;" : `border: ${borderWidth} solid currentColor;`
 		]),
-		rule(`${selector}:hover`, declarationStrings(resolvedButtonColourDeclarations(result.states.hover))),
-		rule(`${selector}:active`, [...declarationStrings(resolvedButtonColourDeclarations(result.states.active)), "transform: scale(0.98);"]),
-		rule(`${selector}:focus-visible`, declarationStrings(resolvedButtonFocusDeclarations(result.focusIndicator))),
-		rule(`${selector}:disabled,\n${selector}:disabled:hover,\n${selector}:disabled:active`, [...declarationStrings(resolvedButtonColourDeclarations(result.states.disabled)), ...declarationStrings(RESOLVED_BUTTON_DISABLED_DECLARATIONS)])
+		rule(`${selector}:hover`, declarationStrings(resolvedButtonColourDeclarations(result.states.hover, {
+			role: variant.id,
+			state: "hover"
+		}))),
+		rule(`${selector}:active`, [...declarationStrings(resolvedButtonColourDeclarations(result.states.active, {
+			role: variant.id,
+			state: "active"
+		})), "transform: scale(0.98);"]),
+		rule(`${selector}:focus-visible`, declarationStrings(resolvedButtonFocusDeclarations(result.focusIndicator, variant.id))),
+		rule(`${selector}:disabled,\n${selector}:disabled:hover,\n${selector}:disabled:active`, [...declarationStrings(resolvedButtonColourDeclarations(result.states.disabled, {
+			role: variant.id,
+			state: "disabled"
+		})), ...declarationStrings(RESOLVED_BUTTON_DISABLED_DECLARATIONS)])
 	].join("\n\n");
 }
 function declarationStrings(declarations) {
@@ -25035,46 +24546,46 @@ const CSS_DECLARATION_PROPERTY_PATTERN = /^(?:-[a-zA-Z][a-zA-Z0-9-]*|[a-zA-Z][a-
 const UNSAFE_CSS_MARKUP_PATTERN = /[{}<>]|<\/|<script/i;
 const EXTERNAL_URL_PATTERN = /url\s*\(\s*['"]?(?:https?:|\/\/)/i;
 const JAVASCRIPT_URL_PATTERN = /javascript\s*:/i;
-const themeBridgeConfigSchema = z$1.object({
-	tokens: z$1.record(z$1.string(), z$1.string()),
-	typography: z$1.object({
-		headingFamily: z$1.string().optional(),
-		bodyFamily: z$1.string().optional(),
-		headingWeight: z$1.number().optional(),
-		bodyWeight: z$1.number().optional()
+const themeBridgeConfigSchema = z.object({
+	tokens: z.record(z.string(), z.string()),
+	typography: z.object({
+		headingFamily: z.string().optional(),
+		bodyFamily: z.string().optional(),
+		headingWeight: z.number().optional(),
+		bodyWeight: z.number().optional()
 	}).optional(),
-	spacing: z$1.enum([
+	spacing: z.enum([
 		"comfortable",
 		"standard",
 		"dense"
 	]).optional(),
-	corners: z$1.enum([
+	corners: z.enum([
 		"square",
 		"soft",
 		"rounded",
 		"pill"
 	]).optional(),
-	shadows: z$1.enum([
+	shadows: z.enum([
 		"none",
 		"low",
 		"medium",
 		"high"
 	]).optional(),
-	components: z$1.object({
-		buttons: z$1.union([z$1.boolean(), z$1.object({ variants: z$1.array(z$1.enum([
+	components: z.object({
+		buttons: z.union([z.boolean(), z.object({ variants: z.array(z.enum([
 			"primary",
 			"secondary",
 			"outline",
 			"ghost"
 		])).optional() })]).optional(),
-		cards: z$1.union([z$1.boolean(), z$1.object({ variants: z$1.array(z$1.enum([
+		cards: z.union([z.boolean(), z.object({ variants: z.array(z.enum([
 			"default",
 			"elevated",
 			"outlined"
 		])).optional() })]).optional(),
-		inputs: z$1.boolean().optional()
+		inputs: z.boolean().optional()
 	}).optional(),
-	overrides: z$1.record(z$1.string(), z$1.string()).optional()
+	overrides: z.record(z.string(), z.string()).optional()
 }).passthrough();
 const TOKEN_ALIASES = [
 	{