riverbankcms 0.8.0 → 0.10.0

package/dist/{sdk-event-upsert-Bf6wAl4s.mjs → sdk-event-upsert-DhdlT2ko.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as parseFooterCompositionV1, Ht as ok, K as parseUtcIsoDateTimeString, M as isCanonicalRichTextDoc, P as isPresent, Vt as err, X as parseBookingTimeZone, b as stableJsonStringify, k as footerNavigationLayouts, l as EVENT_PRESET_VALUES, lt as assertNever, s as resolveSiteVerticalBookingConfig, t as NAVIGATION_LOCATIONS, u as ORDINARY_EVENT_PRESET_VALUES } from "./src-B8fOSKJ6.mjs";
+import { A as parseFooterCompositionV1, Ht as err, M as isCanonicalRichTextDoc, P as isPresent, Ut as ok, Z as parseBookingTimeZone, b as stableJsonStringify, k as footerNavigationLayouts, l as EVENT_PRESET_VALUES, n as NAVIGATION_LOCATIONS, q as parseUtcIsoDateTimeString, s as resolveSiteVerticalBookingConfig, u as ORDINARY_EVENT_PRESET_VALUES, ut as assertNever } from "./src-DIAVNRwo.mjs";
 import "node:module";
 import { z } from "zod";
 
@@ -61,41 +61,6 @@ function siteCommandResourceResult(ref, resourceId, effect) {
 	};
 }
 
-//#endregion
-//#region ../site-commands/src/capabilityGaps.ts
-const staticExecutionGapCodes = [
-	"event_occurrence_required",
-	"event_occurrence_invalid",
-	"event_occurrence_venue_mapping_unsupported",
-	"event_booking_offer_invalid",
-	"event_ticket_single_occurrence_scope_unsupported",
-	"event_manual_payment_unsupported",
-	"event_external_payment_unsupported",
-	"event_waitlist_requires_waitlist_adapter",
-	"event_media_content_requires_media_adapter",
-	"event_linked_content_requires_content_adapter",
-	"event_delivery_mode_requires_booking_surface_adapter",
-	"event_whole_series_page_fields_unsupported",
-	"event_whole_series_passes_unsupported",
-	"event_whole_series_pricing_unsupported",
-	"event_whole_series_schedule_update_unsupported",
-	"event_whole_series_staff_update_unsupported"
-];
-const plannerCapabilityGapCodes = ["command_metadata_support_gap"];
-const adapterCapabilityGapCodes = [
-	"demo_recipe_adapter_missing",
-	"media_manifest_storage_resolution_missing",
-	"navigation_content_entry_refs_unsupported",
-	"staff_site_user_requires_dashboard_user",
-	"team_member_profile_requires_dashboard_user",
-	"generated_navigation_command_unsupported"
-];
-const siteCommandCapabilityGapCodes = [
-	...staticExecutionGapCodes,
-	...plannerCapabilityGapCodes,
-	...adapterCapabilityGapCodes
-];
-
 //#endregion
 //#region ../site-commands/src/refs.ts
 const resourceKinds = [
@@ -123,6 +88,7 @@ const resourceKinds = [
 	"pass-redemption",
 	"order",
 	"appointment-service",
+	"appointment-service-category",
 	"appointment-resource",
 	"availability"
 ];
@@ -167,6 +133,9 @@ function createVenueRef(parts) {
 function createEventCategoryRef(parts) {
 	return `event-category:${joinRefSlugParts(parts)}`;
 }
+function createAppointmentServiceCategoryRef(parts) {
+	return `appointment-service-category:${joinRefSlugParts(parts)}`;
+}
 function createEventSeriesRef(parts) {
 	return `event:${joinRefSlugParts(parts)}`;
 }
@@ -245,6 +214,118 @@ function isValidIanaTimezone(value) {
 	}
 }
 
+//#endregion
+//#region ../site-commands/src/appointmentServiceCategoryCommands.ts
+const appointmentServiceCategoryRefSchema = resourceRefSchema("appointment-service-category");
+/**
+* Creates or updates one appointment-service category (issue 1403).
+*
+* The category's `identifier` is its stable key: it never changes after the
+* category is created, so a rename in the dashboard doesn't break a rerun.
+* When a command leaves it out, the identifier is the ref's slug, which keeps
+* reruns of the same command pointed at the same category.
+*
+* `description` and `sortOrder` describe the wanted state. An omitted
+* description means no description. An omitted `sortOrder` puts a new
+* category last and leaves an existing one where it is.
+*/
+const upsertAppointmentServiceCategoryCommandSchema = z.object({
+	type: z.literal("upsertAppointmentServiceCategory"),
+	ref: appointmentServiceCategoryRefSchema,
+	input: z.object({
+		identifier: recipeIdentifierSchema.optional(),
+		name: z.string().trim().min(1),
+		description: z.string().trim().nullable().optional(),
+		sortOrder: nonNegativeIntegerSchema.optional()
+	}).strict()
+}).strict();
+/**
+* The three ways a service can be placed among the categories. Each variant
+* forbids the other key, so a command naming both a `categoryRef` and a
+* `categoryIdentifier` can't be represented.
+*/
+const noAppointmentServiceCategoryFields = {
+	categoryRef: z.undefined().optional(),
+	categoryIdentifier: z.undefined().optional()
+};
+const appointmentServiceCategoryRefFields = {
+	categoryRef: appointmentServiceCategoryRefSchema,
+	categoryIdentifier: z.undefined().optional()
+};
+const appointmentServiceCategoryIdentifierFields = {
+	categoryRef: z.undefined().optional(),
+	categoryIdentifier: recipeIdentifierSchema
+};
+/**
+* Rejects a command that names both category keys with one clear message,
+* before the union reports that no variant matched.
+*/
+function rejectBothAppointmentServiceCategoryKeys(value, ctx) {
+	if (typeof value !== "object" || value === null || !("categoryRef" in value) || !("categoryIdentifier" in value) || value.categoryRef === undefined || value.categoryIdentifier === undefined) {
+		return;
+	}
+	ctx.addIssue({
+		code: "custom",
+		path: ["categoryIdentifier"],
+		message: "Use categoryRef for a category upserted in this batch, or categoryIdentifier for one that already exists, not both."
+	});
+}
+/** Where an `upsertAppointmentService` command puts the service. */
+function appointmentServiceCategoryPlacement(input) {
+	if (input.categoryRef !== undefined) {
+		return {
+			kind: "batch_ref",
+			categoryRef: input.categoryRef
+		};
+	}
+	if (input.categoryIdentifier !== undefined) {
+		return {
+			kind: "identifier",
+			identifier: input.categoryIdentifier
+		};
+	}
+	return { kind: "uncategorized" };
+}
+/** The stable key an `upsertAppointmentServiceCategory` command writes to. */
+function appointmentServiceCategoryIdentifierForCommand(command) {
+	return command.input.identifier ?? refSlug(command.ref);
+}
+
+//#endregion
+//#region ../site-commands/src/capabilityGaps.ts
+const staticExecutionGapCodes = [
+	"event_occurrence_required",
+	"event_occurrence_invalid",
+	"event_occurrence_venue_mapping_unsupported",
+	"event_booking_offer_invalid",
+	"event_ticket_single_occurrence_scope_unsupported",
+	"event_manual_payment_unsupported",
+	"event_external_payment_unsupported",
+	"event_waitlist_requires_waitlist_adapter",
+	"event_media_content_requires_media_adapter",
+	"event_linked_content_requires_content_adapter",
+	"event_delivery_mode_requires_booking_surface_adapter",
+	"event_whole_series_page_fields_unsupported",
+	"event_whole_series_passes_unsupported",
+	"event_whole_series_pricing_unsupported",
+	"event_whole_series_schedule_update_unsupported",
+	"event_whole_series_staff_update_unsupported"
+];
+const plannerCapabilityGapCodes = ["command_metadata_support_gap"];
+const adapterCapabilityGapCodes = [
+	"demo_recipe_adapter_missing",
+	"media_manifest_storage_resolution_missing",
+	"navigation_content_entry_refs_unsupported",
+	"staff_site_user_requires_dashboard_user",
+	"team_member_profile_requires_dashboard_user",
+	"generated_navigation_command_unsupported"
+];
+const siteCommandCapabilityGapCodes = [
+	...staticExecutionGapCodes,
+	...plannerCapabilityGapCodes,
+	...adapterCapabilityGapCodes
+];
+
 //#endregion
 //#region ../site-commands/src/bookingCommandValues.ts
 const bookingPassProductUseCases = ["event_pass", "appointment_package"];
@@ -2449,8 +2530,8 @@ const BACKGROUND_ROLE_NAMES = new Set([
 	"muted",
 	"neutral"
 ]);
-function onColorTokenName(backgroundToken) {
-	return `on${backgroundToken.split("-").filter((part) => part.length > 0).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("")}`;
+function onColorTokenName(backgroundToken$1) {
+	return `on${backgroundToken$1.split("-").filter((part) => part.length > 0).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("")}`;
 }
 function isOnColorBackgroundCandidateToken(token) {
 	const role = token.match(/^(.*?)(?:-\d{2,3})?$/)?.[1] ?? token;
@@ -2584,8 +2665,8 @@ function resolveDeterministicForeground(backgroundReference, candidates, palette
 	if (!backgroundHex) {
 		return resolveTrustedTreatmentForeground(candidates, palette);
 	}
-	const backgroundToken = paletteToken(backgroundReference);
-	const derivedOnToken = backgroundToken ? onColorTokenName(backgroundToken) : null;
+	const backgroundToken$1 = paletteToken(backgroundReference);
+	const derivedOnToken = backgroundToken$1 ? onColorTokenName(backgroundToken$1) : null;
 	const text = firstSafeToken([
 		candidates.text,
 		derivedOnToken,
@@ -2658,6 +2739,37 @@ function normalizedReference(value) {
 	return normalized.length > 0 ? normalized : null;
 }
 
+//#endregion
+//#region ../theme-core/src/surfaces/logoVariant.ts
+/** Concrete hex behind a plain, opaque palette token, or null otherwise. */
+function opaquePaletteHexForToken(expandedPalette, token) {
+	if (!token) return null;
+	const parts = parseColorTokenParts(token);
+	if (parts.kind !== "token" || parts.opacityPercent !== null) return null;
+	return expandedPalette[parts.token] ?? null;
+}
+/**
+* Tone of the surface a foreground token was resolved for.
+*
+* A token with opacity has no known underlay to composite against, and a raw
+* or unrecognised token has no palette hex, so both are `unknown` rather than
+* a guess.
+*/
+function surfaceToneFromForegroundToken(expandedPalette, foregroundToken) {
+	const hex = opaquePaletteHexForToken(expandedPalette, foregroundToken);
+	if (!hex) return "unknown";
+	return featuresFromHex(hex).Y >= .5 ? "dark" : "light";
+}
+/**
+* The logo to draw on a surface of the given tone. A missing variant falls
+* back to the other one, and an unknown tone uses the light-backgrounds logo,
+* which is what every site rendered before variants existed.
+*/
+function selectLogoVariant(tone, variants) {
+	const { forLightBackgrounds, forDarkBackgrounds } = variants;
+	return tone === "dark" ? forDarkBackgrounds ?? forLightBackgrounds : forLightBackgrounds ?? forDarkBackgrounds;
+}
+
 //#endregion
 //#region ../theme-core/src/utils/colorStyles.ts
 const COLOR_VAR_PREFIX = "--tb-";
@@ -2733,18 +2845,30 @@ function backgroundColorStyle(token) {
 	return { backgroundColor: rgbColorValue(token) };
 }
 /**
-* Creates a text color style object from a theme token.
+* Converts a text color token to a CSS color value that follows the enclosing
+* surface. The semantic text tokens (`text`, `heading`, `mutedText`) resolve
+* to the surface foreground variables, so text adapts when a section's
+* background changes; any other token is a fixed theme color.
 *
 * @param token - Theme color token
-* @returns CSSProperties with color
+* @returns CSS color value
 */
-function textColorStyle(token) {
+function textColorValue(token) {
 	const parsed = parseToken(token);
 	const surfaceRole = parsed.raw ? null : surfaceRoleForTextToken(parsed.token);
-	if (surfaceRole) {
-		return { color: parsed.opacityPercent === undefined ? surfaceForegroundValue(surfaceRole) : surfaceForegroundValueWithOpacity(surfaceRole, parsed.opacityPercent) };
+	if (!surfaceRole) {
+		return rgbColorValue(token);
 	}
-	return { color: rgbColorValue(token) };
+	return parsed.opacityPercent === undefined ? surfaceForegroundValue(surfaceRole) : surfaceForegroundValueWithOpacity(surfaceRole, parsed.opacityPercent);
+}
+/**
+* Creates a text color style object from a theme token.
+*
+* @param token - Theme color token
+* @returns CSSProperties with color
+*/
+function textColorStyle(token) {
+	return { color: textColorValue(token) };
 }
 /**
 * Creates a border color style object from a theme token.
@@ -4573,16 +4697,18 @@ const themeV2RuntimeStyleFieldNames = [
 	"_frameStyles",
 	"_sectionStyles",
 	"_containerStyles",
-	"_cardStyles",
-	"_transitionStyles",
-	"styleGroup"
+	"_cardStyles"
 ];
 const themeV2BlockSpecificRawStyleFieldNames = [
 	"_contentCardStyles",
 	"_heroLayoutStyles",
 	"_textCardStyles"
 ];
-const themeV2NormalEditorRawStyleFieldNames = [...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
+const themeV2NormalEditorRawStyleFieldNames = [
+	...themeV2RuntimeStyleFieldNames,
+	...themeV2BlockSpecificRawStyleFieldNames,
+	"styleGroup"
+];
 const themeV2NormalEditorRawStyleFieldNameSet = new Set(themeV2NormalEditorRawStyleFieldNames);
 const themeV2CompilerOwnedFieldNames = [...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
 const pageDesignEditorBackgroundOverrideOwner = "page-design-editor";
@@ -4594,6 +4720,21 @@ function isThemeV2NormalEditorRawStylePath(fieldPath) {
 	const rootField = fieldPath.split(".")[0] ?? "";
 	return isThemeV2NormalEditorRawStyleFieldName(rootField);
 }
+const staleTransitionStyleGroupPrefix = "site-style-transition-";
+/**
+* A `styleGroup` in the retired `site-style-transition-*` namespace is residue
+* from the old per-block transition path (issue 1422). Any other value is
+* authored and must survive.
+*/
+function isStaleTransitionStyleGroup(value) {
+	return typeof value === "string" && value.startsWith(staleTransitionStyleGroupPrefix);
+}
+/** Drops a stale transition `styleGroup`, leaving authored values untouched. */
+function stripStaleTransitionStyleGroup(content) {
+	if (!isStaleTransitionStyleGroup(content.styleGroup)) return { ...content };
+	const { styleGroup: _stale, ...rest } = content;
+	return rest;
+}
 
 //#endregion
 //#region ../theme-core/src/utils/tokenOrColor.ts
@@ -6657,10 +6798,10 @@ function resolveFocusIndicator(colour) {
 		};
 	}
 }
-function resolveSolid(input, backgroundToken) {
-	const backgroundHex = paletteHex(input, backgroundToken);
+function resolveSolid(input, backgroundToken$1) {
+	const backgroundHex = paletteHex(input, backgroundToken$1);
 	if (!backgroundHex.ok) return backgroundHex;
-	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
+	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken$1));
 	const foregroundHex = input.palette[foregroundToken];
 	if (typeof foregroundHex !== "string") {
 		return {
@@ -6669,14 +6810,14 @@ function resolveSolid(input, backgroundToken) {
 				tag: "missing_on_colour",
 				variantId: input.variantId,
 				state: input.state,
-				backgroundToken,
+				backgroundToken: backgroundToken$1,
 				foregroundToken
 			}
 		};
 	}
 	const contrast = validateButtonTextContrast({
 		...input,
-		background: backgroundToken,
+		background: backgroundToken$1,
 		backgroundHex: backgroundHex.hex,
 		foreground: foregroundToken,
 		foregroundHex
@@ -6694,9 +6835,9 @@ function resolveSolid(input, backgroundToken) {
 		ok: true,
 		colour: {
 			kind: "solid",
-			backgroundToken,
+			backgroundToken: backgroundToken$1,
 			foregroundToken,
-			backgroundCss: tokenCss(backgroundToken),
+			backgroundCss: tokenCss(backgroundToken$1),
 			foregroundCss: tokenCss(foregroundToken)
 		}
 	};
@@ -6930,7 +7071,7 @@ function parseThemeForPersistence(value) {
 * overriding the twelve styles that deliberately declare none. Whether a button
 * carries a trailing affordance is the style's decision; the only caller that
 * legitimately opts out is the authored-button renderer, which reaches it
-* through `themeButtonClassNameWithTrailingIcon`.
+* through `themeButtonExtraClassesWithTrailingIcon`.
 */
 const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 
@@ -6970,19 +7111,10 @@ function themeButtonSelector(variant, size) {
 	}
 	return `${baseSelector}.${themeButtonSizeClassName(size)}`;
 }
-function themeButtonClassName(spec) {
-	const classes = [
-		...themeButtonVariantClassNames(spec.variant),
-		themeButtonSizeClassName(spec.size),
-		spec.extraClassName
-	];
-	return classes.filter(Boolean).join(" ");
-}
 /**
-* Button classes for an authored button that renders its own trailing icon.
+* Extra classes for an authored button that renders its own trailing icon.
 *
-* A separate function rather than a flag on `themeButtonClassName`, because
-* there is exactly one caller and it should stay visible in a diff. The name
+* This intent-named function has exactly one caller. The name
 * states what the caller knows to be true of its own markup — that it renders a
 * trailing icon — rather than what the theme does about it. The consequence is
 * the theme's to decide and to change; a caller naming the consequence would be
@@ -6993,11 +7125,8 @@ function themeButtonClassName(spec) {
 * affordance is declared by the button style, and a block overriding that is the
 * defect this replaced.
 */
-function themeButtonClassNameWithTrailingIcon(spec) {
-	return themeButtonClassName({
-		...spec,
-		extraClassName: [spec.extraClassName, AFFORDANCE_SUPPRESS_CLASS].filter(Boolean).join(" ")
-	});
+function themeButtonExtraClassesWithTrailingIcon() {
+	return AFFORDANCE_SUPPRESS_CLASS;
 }
 
 //#endregion
@@ -13407,11 +13536,11 @@ const TEXT_CONTRAST_THRESHOLD = 3;
 * @param palette - Palette with color tokens (either ExpandedPalette or simple Record<string, string>)
 * @returns Array of text color token names that meet contrast threshold (3:1)
 */
-function getLegibleTextColors(backgroundToken, palette) {
-	if (!backgroundToken) {
+function getLegibleTextColors(backgroundToken$1, palette) {
+	if (!backgroundToken$1) {
 		return getAllColorTokens(palette);
 	}
-	const bgHex = palette[backgroundToken];
+	const bgHex = palette[backgroundToken$1];
 	if (!bgHex || typeof bgHex !== "string") {
 		return getAllColorTokens(palette);
 	}
@@ -15300,12 +15429,12 @@ function resolveAccessibleSurface(input) {
 	const rejectedCandidates = [];
 	const recipe = surfaceRecipes[input.surface];
 	const threshold = contrastThresholdByPolicy[input.policy ?? "body-aa"];
-	for (const backgroundToken of recipe.backgroundCandidates) {
-		const backgroundHex = readPaletteHex(input.palette, backgroundToken);
+	for (const backgroundToken$1 of recipe.backgroundCandidates) {
+		const backgroundHex = readPaletteHex(input.palette, backgroundToken$1);
 		if (!backgroundHex) {
 			rejectedCandidates.push({
 				kind: "background-candidate",
-				token: backgroundToken,
+				token: backgroundToken$1,
 				reason: "missing-token"
 			});
 			continue;
@@ -15313,7 +15442,7 @@ function resolveAccessibleSurface(input) {
 		const heading = resolveRequiredForeground({
 			role: "heading",
 			candidates: recipe.headingCandidates,
-			backgroundToken,
+			backgroundToken: backgroundToken$1,
 			backgroundHex,
 			palette: input.palette,
 			threshold,
@@ -15322,7 +15451,7 @@ function resolveAccessibleSurface(input) {
 		const text = resolveRequiredForeground({
 			role: "text",
 			candidates: recipe.textCandidates,
-			backgroundToken,
+			backgroundToken: backgroundToken$1,
 			backgroundHex,
 			palette: input.palette,
 			threshold,
@@ -15331,7 +15460,7 @@ function resolveAccessibleSurface(input) {
 		const link = resolveRequiredForeground({
 			role: "link",
 			candidates: recipe.linkCandidates,
-			backgroundToken,
+			backgroundToken: backgroundToken$1,
 			backgroundHex,
 			palette: input.palette,
 			threshold,
@@ -15340,7 +15469,7 @@ function resolveAccessibleSurface(input) {
 		if (!heading || !text || !link) continue;
 		const supporting = resolveSupportingForeground({
 			candidates: recipe.supportingCandidates,
-			backgroundToken,
+			backgroundToken: backgroundToken$1,
 			backgroundHex,
 			text,
 			palette: input.palette,
@@ -15351,7 +15480,7 @@ function resolveAccessibleSurface(input) {
 			kind: "resolved-accessible-surface",
 			surface: input.surface,
 			background: {
-				token: asAccessibleSurfaceToken(backgroundToken),
+				token: asAccessibleSurfaceToken(backgroundToken$1),
 				hex: backgroundHex,
 				inherited: recipe.inheritedBackground
 			},
@@ -15450,23 +15579,23 @@ function resolveSafeToken(input) {
 	}
 	return null;
 }
-function expandForegroundCandidates(candidates, backgroundToken) {
+function expandForegroundCandidates(candidates, backgroundToken$1) {
 	const seen = new Set();
 	const expanded = [];
 	for (const candidate$1 of candidates) {
-		const token = expandForegroundCandidate(candidate$1, backgroundToken);
+		const token = expandForegroundCandidate(candidate$1, backgroundToken$1);
 		if (seen.has(token)) continue;
 		seen.add(token);
 		expanded.push(token);
 	}
 	return expanded;
 }
-function expandForegroundCandidate(candidate$1, backgroundToken) {
+function expandForegroundCandidate(candidate$1, backgroundToken$1) {
 	if (typeof candidate$1 === "string") {
 		return candidate$1;
 	}
 	switch (candidate$1.kind) {
-		case "on-background": return onColorTokenName(backgroundToken);
+		case "on-background": return onColorTokenName(backgroundToken$1);
 	}
 }
 function readPaletteHex(palette, token) {
@@ -15600,7 +15729,6 @@ function blockDesignPlanFromAppearancePreset(preset, input) {
 	return {
 		...planInput,
 		appearancePresetId: asAppearancePresetId(preset.id),
-		transitionAfter: "none",
 		emphasis: "medium",
 		...resolveBlockAppearancePresetDesign(preset, layoutProfile ?? null)
 	};
@@ -16475,235 +16603,339 @@ function cardRoleFromLegacyVocabulary(value) {
 const cardRoleWithLegacyAliasSchema = z.preprocess((value) => cardRoleFromLegacyVocabulary(value) ?? value, cardRoleSchema);
 
 //#endregion
-//#region ../theme-core/src/site-styles/compositionBudget.ts
-const repairActionsByRatioIssueKind = {
-	"accent-density-exceeded": ["reduce-accent-density"],
-	"panel-density-exceeded": ["reduce-panel-density"],
-	"transition-mix-exceeded": ["reduce-transition-mix"],
-	"media-density-exceeded": ["reduce-media-density"],
-	"decorative-repetition-exceeded": ["reduce-decorative-repetition"]
-};
-function issueMetadata(policy, allowedRepairActions) {
-	return {
-		policy,
-		severity: designIssueSeverityForPolicy(policy),
-		allowedRepairActions
+//#region ../theme-core/src/site-styles/runtimeBackgroundResolution.ts
+function parseCanonicalRuntimeBackground(content) {
+	const sectionStyles = readRecord(content._sectionStyles);
+	const background = readRecord(sectionStyles?.background);
+	if (!background) return { kind: "none" };
+	const parsed = boxBackgroundSchema.safeParse(background);
+	if (!parsed.success) return { kind: "none" };
+	return parsed.data.contentOwner === pageDesignEditorBackgroundOverrideOwner ? {
+		kind: "page-design-override",
+		background: parsed.data
+	} : {
+		kind: "block-authored",
+		background: parsed.data
 	};
 }
-/** Returns the fraction of page blocks selected by a budget check. */
-function ratio(count, total) {
-	return total === 0 ? 0 : count / total;
-}
-function maxCompositionItemsWithinRatio(totalItems, allowedRatio) {
-	return Math.floor((allowedRatio + Number.EPSILON) * totalItems);
-}
-function isRatioExceeded(actualCount, totalItems, allowedRatio) {
-	return actualCount > maxCompositionItemsWithinRatio(totalItems, allowedRatio);
-}
-function issueWhenRatioExceeded(input) {
-	const actualRatio = ratio(input.blockIds.length, input.totalBlocks);
-	if (!isRatioExceeded(input.blockIds.length, input.totalBlocks, input.allowedRatio)) {
-		return null;
+function resolveSectionBackground(source, lookDefault) {
+	if (source.kind === "page-design-override") {
+		return {
+			kind: "page-design-override",
+			background: source.background
+		};
 	}
-	return {
-		kind: input.kind,
-		budget: input.budget,
-		actualRatio,
-		allowedRatio: input.allowedRatio,
-		blockIds: input.blockIds,
-		...issueMetadata(input.policy, repairActionsByRatioIssueKind[input.kind])
-	};
+	if (lookDefault) {
+		if (source.kind === "block-authored" && (source.background.type === "image" || source.background.type === "video")) {
+			return {
+				kind: "block-authored",
+				background: mergeLookForegroundWithAuthoredMedia(lookDefault, source.background)
+			};
+		}
+		return {
+			kind: "look-default",
+			background: lookDefault
+		};
+	}
+	if (source.kind === "block-authored" && (source.background.type === "image" || source.background.type === "video")) {
+		return {
+			kind: "block-authored",
+			background: source.background
+		};
+	}
+	return source.kind === "block-authored" ? {
+		kind: "block-authored",
+		background: source.background
+	} : { kind: "none" };
 }
-/** Checks whether block framing or a card surface contributes panel mass. */
-function hasPanelFrameOrCardSurface(block) {
-	return block.appliedContentFrame.kind !== "plain" || block.appliedCardRole != null && block.appliedCardRole !== "none";
+function resolveSectionForeground(background, palette) {
+	return resolveSurfaceForeground(background.kind === "none" ? null : background.background, palette, {}, { compositeBase: "background" });
 }
-/** Checks explicit decorative annotations; transitions are budgeted separately. */
-function hasDecorativeAnnotation(context) {
-	return context?.decorativeIntent === "supporting" || context?.decorativeIntent === "feature";
+/**
+* Read foreground authority from post-compiler block content. The preview
+* compiler has already materialized any Look-owned background into
+* `_sectionStyles`; raw authored content must be composed with its Look through
+* `resolveSectionBackground` instead.
+*/
+function resolveCompiledSectionForegroundFromContent(content, palette) {
+	if (!content) return resolveSurfaceForeground(null, palette);
+	return resolveSectionForeground(resolveSectionBackground(parseCanonicalRuntimeBackground(content), null), palette);
 }
-/** Checks whether a block annotation says media contributes visual weight. */
-function hasMediaAnnotation(context) {
-	return context?.mediaIntent === "supporting" || context?.mediaIntent === "dominant";
+function mergeLookForegroundWithAuthoredMedia(lookDefault, authored) {
+	const merged = boxBackgroundSchema.safeParse({
+		...lookDefault,
+		type: authored.type,
+		image: authored.image,
+		objectFit: authored.objectFit,
+		scale: authored.scale,
+		position: authored.position
+	});
+	return merged.success ? merged.data : authored;
 }
-function validateCompositionBudget(input) {
-	const { budget, policy, resolved } = input;
-	const totalBlocks = resolved.blocks.length;
-	const knownBlockIds = new Set(resolved.blocks.map((block) => block.blockId));
-	const blockContexts = input.blockContexts ?? [];
-	const unknownContextBlockIds = blockContexts.filter((context) => !knownBlockIds.has(context.blockId)).map((context) => context.blockId);
-	const knownBlockContexts = blockContexts.filter((context) => knownBlockIds.has(context.blockId));
-	const contextsByBlockId = new Map(knownBlockContexts.map((context) => [context.blockId, context]));
-	const issues = [];
-	if (unknownContextBlockIds.length > 0) {
-		issues.push({
-			kind: "unknown-composition-context-block",
-			blockIds: unknownContextBlockIds,
-			...issueMetadata(policy, [])
-		});
-	}
-	const accentBlockIds = resolved.blocks.filter((block) => block.appliedSectionSurface === "accent-band" || block.appliedSectionSurface === "brand-depth-band").map((block) => block.blockId);
-	const accentIssue = issueWhenRatioExceeded({
-		kind: "accent-density-exceeded",
-		policy,
-		budget: budget.accentDensity,
-		blockIds: accentBlockIds,
-		totalBlocks,
-		allowedRatio: compositionDensityRatioLimits[budget.accentDensity]
-	});
-	if (accentIssue) {
-		issues.push(accentIssue);
-	}
-	const panelBlockIds = resolved.blocks.filter(hasPanelFrameOrCardSurface).map((block) => block.blockId);
-	const panelIssue = issueWhenRatioExceeded({
-		kind: "panel-density-exceeded",
-		policy,
-		budget: budget.panelDensity,
-		blockIds: panelBlockIds,
-		totalBlocks,
-		allowedRatio: compositionDensityRatioLimits[budget.panelDensity]
-	});
-	if (panelIssue) {
-		issues.push(panelIssue);
-	}
-	const transitionBlockIds = resolved.blocks.filter((block) => block.appliedTransitionAfter !== "none").map((block) => block.blockId);
-	const transitionIssue = issueWhenRatioExceeded({
-		kind: "transition-mix-exceeded",
-		policy,
-		budget: budget.transitionMix,
-		blockIds: transitionBlockIds,
-		totalBlocks,
-		allowedRatio: compositionTransitionMixRatioLimits[budget.transitionMix]
-	});
-	if (transitionIssue) {
-		issues.push(transitionIssue);
-	}
-	const ctaContexts = knownBlockContexts.filter((context) => (context.primaryCtaCount ?? 0) > 0);
-	const actualPrimaryCtaCount = ctaContexts.reduce((sum, context) => sum + (context.primaryCtaCount ?? 0), 0);
-	if (actualPrimaryCtaCount > budget.primaryCtaLimit) {
-		issues.push({
-			kind: "primary-cta-limit-exceeded",
-			actualCount: actualPrimaryCtaCount,
-			allowedCount: budget.primaryCtaLimit,
-			blockIds: ctaContexts.map((context) => context.blockId),
-			...issueMetadata(policy, ["reduce-primary-ctas"])
-		});
-	}
-	const mediaBlockIds = resolved.blocks.filter((block) => hasMediaAnnotation(contextsByBlockId.get(block.blockId))).map((block) => block.blockId);
-	const mediaIssue = issueWhenRatioExceeded({
-		kind: "media-density-exceeded",
-		policy,
-		budget: budget.mediaDensity,
-		blockIds: mediaBlockIds,
-		totalBlocks,
-		allowedRatio: compositionDensityRatioLimits[budget.mediaDensity]
-	});
-	if (mediaIssue) {
-		issues.push(mediaIssue);
-	}
-	const decorativeBlockIds = resolved.blocks.filter((block) => hasDecorativeAnnotation(contextsByBlockId.get(block.blockId))).map((block) => block.blockId);
-	const decorativeIssue = issueWhenRatioExceeded({
-		kind: "decorative-repetition-exceeded",
-		policy,
-		budget: budget.decorativeRepetition,
-		blockIds: decorativeBlockIds,
-		totalBlocks,
-		allowedRatio: compositionDensityRatioLimits[budget.decorativeRepetition]
-	});
-	if (decorativeIssue) {
-		issues.push(decorativeIssue);
-	}
-	return issues;
+function readRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 
 //#endregion
-//#region ../theme-core/src/site-styles/compilationPlan.ts
-const defaultHeaderBrandPreferences = {
-	brandDisplay: "auto",
-	logoSize: "auto"
-};
-function headerBrandPreferencesFromTheme(theme) {
-	return {
-		brandDisplay: theme?.header.logo?.brandDisplay ?? defaultHeaderBrandPreferences.brandDisplay,
-		logoSize: theme?.header.logo?.size ?? defaultHeaderBrandPreferences.logoSize
-	};
-}
-function replaceSiteStyleCompilationPlan(input) {
-	return {
-		kind: "replace-site-style",
-		buttons: {
-			kind: "recompile",
-			selection: input.buttonStyleSelection ?? null,
-			reason: "site-style-replacement"
-		},
-		header: {
-			kind: "recompile",
-			selection: input.headerSelection,
-			brandPresentation: input.headerLogo === undefined ? { kind: "use-compiled-defaults" } : {
-				kind: "apply-logo-context",
-				logo: input.headerLogo
-			}
-		},
-		footerLookId: input.footerLookId ?? null
-	};
-}
+//#region ../theme-core/src/site-styles/transitionCatalogue.ts
 /**
-* Writes the brand display / logo size preference onto the header's logo style.
-*
-* Moved here from preview-next in #1318 Phase 4a so the header preference
-* pipeline can be composed once, in theme-core, rather than half in the client.
+* Family order for pickers. Entries below are listed family by family in this
+* same order, so the flat option list and the grouped families agree.
 */
-function withHeaderBrandThemePreferences(theme, preferences) {
-	const currentLogo = theme.header.logo;
-	if (!currentLogo && preferences.brandDisplay === defaultHeaderBrandPreferences.brandDisplay && preferences.logoSize === defaultHeaderBrandPreferences.logoSize) {
-		return theme;
+const transitionCatalogueFamilies = [
+	{
+		id: "gradient",
+		label: "Gradient"
+	},
+	{
+		id: "wave",
+		label: "Wave"
+	},
+	{
+		id: "angle",
+		label: "Angle"
 	}
-	return {
-		...theme,
-		header: {
-			...theme.header,
-			logo: {
-				fontFamily: currentLogo?.fontFamily ?? "heading",
-				letterSpacing: currentLogo?.letterSpacing ?? "normal",
-				gradient: currentLogo?.gradient ?? false,
-				...currentLogo ?? {},
-				brandDisplay: preferences.brandDisplay,
-				size: preferences.logoSize
+];
+const mediumHeight = "6rem + 2px";
+const compactHeight = "4.5rem + 2px";
+const largeHeight = "7rem + 2px";
+/**
+* The single source of transition vocabulary. Order is significant: it is the
+* order of `boundaryOptions` (after `none`) and of each family's variants,
+* which persisted pins, page-flow presets and the editor picker all rely on.
+*
+* Shapes match what `generateLayoutCss` draws today. Structured
+* amplitude/frequency treatments (issue 826) extend this list later.
+*/
+const transitionCatalogueEntries = defineExactCatalog()([
+	{
+		intent: "soft-fade-short",
+		optionId: asBoundaryOptionId("break:soft"),
+		family: "gradient",
+		variantId: "soft",
+		label: "Soft",
+		variantLabel: "Soft",
+		treatment: {
+			kind: "soft-fade",
+			height: "medium",
+			curve: "soft"
+		},
+		size: "medium",
+		heightExpression: mediumHeight,
+		shape: { kind: "fade" }
+	},
+	{
+		intent: "soft-fade-long",
+		optionId: asBoundaryOptionId("break:spacious"),
+		family: "gradient",
+		variantId: "spacious",
+		label: "Spacious",
+		variantLabel: "Spacious",
+		treatment: {
+			kind: "soft-fade",
+			height: "large",
+			curve: "spacious"
+		},
+		size: "spacious",
+		heightExpression: "10rem",
+		shape: { kind: "fade" }
+	},
+	{
+		intent: "soft-fade-expansive",
+		optionId: asBoundaryOptionId("break:expansive"),
+		family: "gradient",
+		variantId: "expansive",
+		label: "Expansive",
+		variantLabel: "Expansive",
+		treatment: {
+			kind: "soft-fade",
+			height: "expansive",
+			curve: "expansive"
+		},
+		size: "expansive",
+		heightExpression: "14rem",
+		shape: { kind: "fade" }
+	},
+	{
+		intent: "wave-edge-balanced",
+		optionId: asBoundaryOptionId("break:wave-balanced"),
+		family: "wave",
+		variantId: "balanced",
+		label: "Balanced wave",
+		variantLabel: "Balanced",
+		treatment: {
+			kind: "wave-edge",
+			height: "medium",
+			amplitude: "balanced",
+			rhythm: "double",
+			symmetry: "symmetrical"
+		},
+		size: "medium",
+		heightExpression: mediumHeight,
+		shape: {
+			kind: "wave",
+			mask: "balanced"
+		}
+	},
+	{
+		intent: "wave-edge",
+		optionId: asBoundaryOptionId("break:wave"),
+		family: "wave",
+		variantId: "classic",
+		label: "Classic wave",
+		variantLabel: "Classic",
+		treatment: {
+			kind: "wave-edge",
+			height: "medium",
+			amplitude: "balanced",
+			rhythm: "double",
+			symmetry: "asymmetrical"
+		},
+		size: "medium",
+		heightExpression: mediumHeight,
+		shape: {
+			kind: "wave",
+			mask: "classic"
+		}
+	},
+	{
+		intent: "wave-edge-gentle",
+		optionId: asBoundaryOptionId("break:wave-gentle"),
+		family: "wave",
+		variantId: "gentle",
+		label: "Gentle wave",
+		variantLabel: "Gentle",
+		treatment: {
+			kind: "wave-edge",
+			height: "compact",
+			amplitude: "subtle",
+			rhythm: "single",
+			symmetry: "symmetrical"
+		},
+		size: "compact",
+		heightExpression: compactHeight,
+		shape: {
+			kind: "wave",
+			mask: "gentle"
+		}
+	},
+	{
+		intent: "wave-edge-bold",
+		optionId: asBoundaryOptionId("break:wave-bold"),
+		family: "wave",
+		variantId: "bold",
+		label: "Bold wave",
+		variantLabel: "Bold",
+		treatment: {
+			kind: "wave-edge",
+			height: "large",
+			amplitude: "bold",
+			rhythm: "double",
+			symmetry: "symmetrical"
+		},
+		size: "large",
+		heightExpression: largeHeight,
+		shape: {
+			kind: "wave",
+			mask: "bold"
+		}
+	},
+	{
+		intent: "wave-edge-drift",
+		optionId: asBoundaryOptionId("break:wave-drift"),
+		family: "wave",
+		variantId: "drift",
+		label: "Drift wave",
+		variantLabel: "Drift",
+		treatment: {
+			kind: "wave-edge",
+			height: "medium",
+			amplitude: "balanced",
+			rhythm: "double",
+			symmetry: "drift"
+		},
+		size: "medium",
+		heightExpression: mediumHeight,
+		shape: {
+			kind: "wave",
+			mask: "drift"
+		}
+	},
+	{
+		intent: "angle-edge-subtle",
+		optionId: asBoundaryOptionId("break:angle-subtle"),
+		family: "angle",
+		variantId: "subtle",
+		label: "Subtle angle",
+		variantLabel: "Subtle",
+		treatment: {
+			kind: "angle-edge",
+			height: "compact",
+			slope: "subtle",
+			direction: "forward"
+		},
+		size: "compact",
+		heightExpression: compactHeight,
+		shape: {
+			kind: "angle",
+			polygon: {
+				startTopPercent: 34,
+				endTopPercent: 18
 			}
 		}
-	};
-}
-
-//#endregion
-//#region ../theme-core/src/site-styles/schemaVersionedJson.ts
-function parseSchemaVersionedJson(input) {
-	if (input.value == null) {
-		return { kind: "absent" };
-	}
-	if (typeof input.value === "object" && input.value !== null && "schemaVersion" in input.value && input.value.schemaVersion !== input.expectedSchemaVersion) {
-		return {
-			kind: "invalid",
-			issue: {
-				kind: "unsupported-schema-version",
-				message: input.unsupportedSchemaVersionMessage
+	},
+	{
+		intent: "angle-edge",
+		optionId: asBoundaryOptionId("break:angle-balanced"),
+		family: "angle",
+		variantId: "balanced",
+		label: "Balanced angle",
+		variantLabel: "Balanced",
+		treatment: {
+			kind: "angle-edge",
+			height: "medium",
+			slope: "balanced",
+			direction: "forward"
+		},
+		size: "medium",
+		heightExpression: mediumHeight,
+		shape: {
+			kind: "angle",
+			polygon: {
+				startTopPercent: 42,
+				endTopPercent: 8
 			}
-		};
-	}
-	const parsed = input.schema.safeParse(input.value);
-	if (!parsed.success) {
-		const firstIssue = parsed.error.issues[0];
-		return {
-			kind: "invalid",
-			issue: {
-				kind: "invalid-json-shape",
-				message: firstIssue?.message ?? input.invalidShapeMessage
+		}
+	},
+	{
+		intent: "angle-edge-steep",
+		optionId: asBoundaryOptionId("break:angle-steep"),
+		family: "angle",
+		variantId: "steep",
+		label: "Steep angle",
+		variantLabel: "Steep",
+		treatment: {
+			kind: "angle-edge",
+			height: "large",
+			slope: "steep",
+			direction: "forward"
+		},
+		size: "large",
+		heightExpression: largeHeight,
+		shape: {
+			kind: "angle",
+			polygon: {
+				startTopPercent: 54,
+				endTopPercent: 0
 			}
-		};
+		}
 	}
-	return {
-		kind: "parsed",
-		value: parsed.data
-	};
+]);
+const transitionCatalogueCoversEveryIntentOnce = true;
+void transitionCatalogueCoversEveryIntentOnce;
+/** CSS `clip-path` value for an angle shape, as `generateLayoutCss` draws it. */
+function anglePolygonCss(polygon) {
+	return `polygon(0 ${polygon.startTopPercent}%, 100% ${polygon.endTopPercent}%, 100% 100%, 0 100%)`;
 }
 
 //#endregion
@@ -16716,22 +16948,27 @@ function boundaryRuntimeMetrics(family, size, heightExpression) {
 		reserveCss: `calc((${heightExpression}) / 2)`
 	};
 }
-const sectionBoundaryRuntimeMetricsByTransition = {
-	none: null,
-	"soft-fade-short": boundaryRuntimeMetrics("gradient", "medium", "6rem + 2px"),
-	"soft-fade-long": boundaryRuntimeMetrics("gradient", "spacious", "10rem"),
-	"soft-fade-expansive": boundaryRuntimeMetrics("gradient", "expansive", "14rem"),
-	"wave-edge": boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"),
-	"wave-edge-balanced": boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"),
-	"wave-edge-gentle": boundaryRuntimeMetrics("wave", "compact", "4.5rem + 2px"),
-	"wave-edge-bold": boundaryRuntimeMetrics("wave", "large", "7rem + 2px"),
-	"wave-edge-drift": boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"),
-	"angle-edge": boundaryRuntimeMetrics("angle", "medium", "6rem + 2px"),
-	"angle-edge-subtle": boundaryRuntimeMetrics("angle", "compact", "4.5rem + 2px"),
-	"angle-edge-steep": boundaryRuntimeMetrics("angle", "large", "7rem + 2px")
-};
-function boundaryRuntimeMetricsForTransition(transition) {
-	return sectionBoundaryRuntimeMetricsByTransition[transition];
+const catalogueEntryByIntent = new Map(transitionCatalogueEntries.map((entry) => [entry.intent, entry]));
+const metricsByIntent = new Map(transitionCatalogueEntries.map((entry) => [entry.intent, boundaryRuntimeMetrics(entry.family, entry.size, entry.heightExpression)]));
+/**
+* The catalogue's compile-time coverage check guarantees an entry per
+* decorative intent, so a miss here is a broken invariant, not bad input.
+*/
+function requireCatalogueValue(values, intent) {
+	const value = values.get(intent);
+	if (value === undefined) {
+		throw new Error(`Transition catalogue has no entry for ${intent}`);
+	}
+	return value;
+}
+function transitionCatalogueEntryForIntent(intent) {
+	return requireCatalogueValue(catalogueEntryByIntent, intent);
+}
+function isDecorativeTransitionIntent(transition) {
+	return transition !== "none";
+}
+function boundaryRuntimeMetricsForDecorativeTransition(transition) {
+	return requireCatalogueValue(metricsByIntent, transition);
 }
 const noneBoundaryOption = {
 	id: asBoundaryOptionId("break:none"),
@@ -16739,264 +16976,63 @@ const noneBoundaryOption = {
 	transitionAfter: "none",
 	treatment: { kind: "none" }
 };
-const softBoundaryOption = {
-	id: asBoundaryOptionId("break:soft"),
-	label: "Soft",
-	transitionAfter: "soft-fade-short",
-	treatment: {
-		kind: "soft-fade",
-		height: "medium",
-		curve: "soft"
-	}
-};
-const spaciousBoundaryOption = {
-	id: asBoundaryOptionId("break:spacious"),
-	label: "Spacious",
-	transitionAfter: "soft-fade-long",
-	treatment: {
-		kind: "soft-fade",
-		height: "large",
-		curve: "spacious"
-	}
-};
-const expansiveBoundaryOption = {
-	id: asBoundaryOptionId("break:expansive"),
-	label: "Expansive",
-	transitionAfter: "soft-fade-expansive",
-	treatment: {
-		kind: "soft-fade",
-		height: "expansive",
-		curve: "expansive"
-	}
-};
-const waveBoundaryOption = {
-	id: asBoundaryOptionId("break:wave"),
-	label: "Classic wave",
-	transitionAfter: "wave-edge",
-	treatment: {
-		kind: "wave-edge",
-		height: "medium",
-		amplitude: "balanced",
-		rhythm: "double",
-		symmetry: "asymmetrical"
-	}
-};
-const balancedWaveBoundaryOption = {
-	id: asBoundaryOptionId("break:wave-balanced"),
-	label: "Balanced wave",
-	transitionAfter: "wave-edge-balanced",
-	treatment: {
-		kind: "wave-edge",
-		height: "medium",
-		amplitude: "balanced",
-		rhythm: "double",
-		symmetry: "symmetrical"
-	}
-};
-const gentleWaveBoundaryOption = {
-	id: asBoundaryOptionId("break:wave-gentle"),
-	label: "Gentle wave",
-	transitionAfter: "wave-edge-gentle",
-	treatment: {
-		kind: "wave-edge",
-		height: "compact",
-		amplitude: "subtle",
-		rhythm: "single",
-		symmetry: "symmetrical"
-	}
-};
-const boldWaveBoundaryOption = {
-	id: asBoundaryOptionId("break:wave-bold"),
-	label: "Bold wave",
-	transitionAfter: "wave-edge-bold",
-	treatment: {
-		kind: "wave-edge",
-		height: "large",
-		amplitude: "bold",
-		rhythm: "double",
-		symmetry: "symmetrical"
-	}
-};
-const driftWaveBoundaryOption = {
-	id: asBoundaryOptionId("break:wave-drift"),
-	label: "Drift wave",
-	transitionAfter: "wave-edge-drift",
-	treatment: {
-		kind: "wave-edge",
-		height: "medium",
-		amplitude: "balanced",
-		rhythm: "double",
-		symmetry: "drift"
-	}
-};
-const subtleAngleBoundaryOption = {
-	id: asBoundaryOptionId("break:angle-subtle"),
-	label: "Subtle angle",
-	transitionAfter: "angle-edge-subtle",
-	treatment: {
-		kind: "angle-edge",
-		height: "compact",
-		slope: "subtle",
-		direction: "forward"
-	}
-};
-const balancedAngleBoundaryOption = {
-	id: asBoundaryOptionId("break:angle-balanced"),
-	label: "Balanced angle",
-	transitionAfter: "angle-edge",
-	treatment: {
-		kind: "angle-edge",
-		height: "medium",
-		slope: "balanced",
-		direction: "forward"
-	}
-};
-const steepAngleBoundaryOption = {
-	id: asBoundaryOptionId("break:angle-steep"),
-	label: "Steep angle",
-	transitionAfter: "angle-edge-steep",
-	treatment: {
-		kind: "angle-edge",
-		height: "large",
-		slope: "steep",
-		direction: "forward"
-	}
-};
+const boundaryOptionByIntent = new Map(transitionCatalogueEntries.map((entry) => [entry.intent, {
+	id: entry.optionId,
+	label: entry.label,
+	transitionAfter: entry.intent,
+	treatment: entry.treatment
+}]));
+function boundaryOptionForTransitionIntent(intent) {
+	return requireCatalogueValue(boundaryOptionByIntent, intent);
+}
+const softBoundaryOption = boundaryOptionForTransitionIntent("soft-fade-short");
+const spaciousBoundaryOption = boundaryOptionForTransitionIntent("soft-fade-long");
+const expansiveBoundaryOption = boundaryOptionForTransitionIntent("soft-fade-expansive");
+const waveBoundaryOption = boundaryOptionForTransitionIntent("wave-edge");
+const balancedWaveBoundaryOption = boundaryOptionForTransitionIntent("wave-edge-balanced");
+const gentleWaveBoundaryOption = boundaryOptionForTransitionIntent("wave-edge-gentle");
+const boldWaveBoundaryOption = boundaryOptionForTransitionIntent("wave-edge-bold");
+const driftWaveBoundaryOption = boundaryOptionForTransitionIntent("wave-edge-drift");
+const subtleAngleBoundaryOption = boundaryOptionForTransitionIntent("angle-edge-subtle");
+const balancedAngleBoundaryOption = boundaryOptionForTransitionIntent("angle-edge");
+const steepAngleBoundaryOption = boundaryOptionForTransitionIntent("angle-edge-steep");
+/**
+* Must remain non-empty; downstream code indexes `[0]` as the documented default.
+*/
+const boundaryOptions = [noneBoundaryOption, ...transitionCatalogueEntries.map((entry) => boundaryOptionForTransitionIntent(entry.intent))];
 const noneTransitionVariant = {
 	familyId: "none",
 	variantId: "none",
 	label: "None",
 	boundaryOption: noneBoundaryOption
 };
-const softGradientTransitionVariant = {
-	familyId: "gradient",
-	variantId: "soft",
-	label: "Soft",
-	boundaryOption: softBoundaryOption
-};
-const spaciousGradientTransitionVariant = {
-	familyId: "gradient",
-	variantId: "spacious",
-	label: "Spacious",
-	boundaryOption: spaciousBoundaryOption
-};
-const expansiveGradientTransitionVariant = {
-	familyId: "gradient",
-	variantId: "expansive",
-	label: "Expansive",
-	boundaryOption: expansiveBoundaryOption
-};
-const balancedWaveTransitionVariant = {
-	familyId: "wave",
-	variantId: "balanced",
-	label: "Balanced",
-	boundaryOption: balancedWaveBoundaryOption
-};
-const classicWaveTransitionVariant = {
-	familyId: "wave",
-	variantId: "classic",
-	label: "Classic",
-	boundaryOption: waveBoundaryOption
-};
-const gentleWaveTransitionVariant = {
-	familyId: "wave",
-	variantId: "gentle",
-	label: "Gentle",
-	boundaryOption: gentleWaveBoundaryOption
-};
-const boldWaveTransitionVariant = {
-	familyId: "wave",
-	variantId: "bold",
-	label: "Bold",
-	boundaryOption: boldWaveBoundaryOption
-};
-const driftWaveTransitionVariant = {
-	familyId: "wave",
-	variantId: "drift",
-	label: "Drift",
-	boundaryOption: driftWaveBoundaryOption
-};
-const subtleAngleTransitionVariant = {
-	familyId: "angle",
-	variantId: "subtle",
-	label: "Subtle",
-	boundaryOption: subtleAngleBoundaryOption
-};
-const balancedAngleTransitionVariant = {
-	familyId: "angle",
-	variantId: "balanced",
-	label: "Balanced",
-	boundaryOption: balancedAngleBoundaryOption
-};
-const steepAngleTransitionVariant = {
-	familyId: "angle",
-	variantId: "steep",
-	label: "Steep",
-	boundaryOption: steepAngleBoundaryOption
-};
-const sectionTransitionFamilies = [
-	{
-		id: "none",
-		label: "None",
-		variants: [noneTransitionVariant]
-	},
-	{
-		id: "gradient",
-		label: "Gradient",
-		variants: [
-			softGradientTransitionVariant,
-			spaciousGradientTransitionVariant,
-			expansiveGradientTransitionVariant
-		]
-	},
-	{
-		id: "wave",
-		label: "Wave",
-		variants: [
-			balancedWaveTransitionVariant,
-			classicWaveTransitionVariant,
-			gentleWaveTransitionVariant,
-			boldWaveTransitionVariant,
-			driftWaveTransitionVariant
-		]
-	},
-	{
-		id: "angle",
-		label: "Angle",
-		variants: [
-			subtleAngleTransitionVariant,
-			balancedAngleTransitionVariant,
-			steepAngleTransitionVariant
-		]
-	}
-];
-/**
-* Must remain non-empty; downstream code indexes `[0]` as the documented default.
-*/
-const boundaryOptions = [
-	noneBoundaryOption,
-	softBoundaryOption,
-	spaciousBoundaryOption,
-	expansiveBoundaryOption,
-	balancedWaveBoundaryOption,
-	waveBoundaryOption,
-	gentleWaveBoundaryOption,
-	boldWaveBoundaryOption,
-	driftWaveBoundaryOption,
-	subtleAngleBoundaryOption,
-	balancedAngleBoundaryOption,
-	steepAngleBoundaryOption
-];
+function transitionVariantForEntry(entry) {
+	return {
+		familyId: entry.family,
+		variantId: entry.variantId,
+		label: entry.variantLabel,
+		boundaryOption: boundaryOptionForTransitionIntent(entry.intent)
+	};
+}
+const sectionTransitionFamilies = [{
+	id: "none",
+	label: "None",
+	variants: [noneTransitionVariant]
+}, ...transitionCatalogueFamilies.map((family) => ({
+	id: family.id,
+	label: family.label,
+	variants: requireNonEmptyReadonlyArray(transitionCatalogueEntries.filter((entry) => entry.family === family.id).map(transitionVariantForEntry), `Transition family ${family.id} has no catalogue entries.`)
+}))];
+const boundaryOptionById = new Map(boundaryOptions.map((option) => [option.id, option]));
+const boundaryOptionByTreatmentKey = new Map(boundaryOptions.map((option) => [stableTreatmentKey(option.treatment), option]));
+const transitionVariantByBoundaryOptionId = new Map(sectionTransitionFamilies.flatMap((family) => family.variants.map((variant) => [variant.boundaryOption.id, variant])));
+const transitionFamilyById = new Map(sectionTransitionFamilies.map((family) => [family.id, family]));
 function sectionTransitionVariantForBoundaryOptionId(boundaryOptionId) {
 	if (!boundaryOptionId) return null;
-	for (const family of sectionTransitionFamilies) {
-		const variant = family.variants.find((candidate$1) => candidate$1.boundaryOption.id === boundaryOptionId);
-		if (variant) return variant;
-	}
-	return null;
+	return transitionVariantByBoundaryOptionId.get(boundaryOptionId) ?? null;
 }
 function boundaryTreatmentForBoundaryOptionId(boundaryOptionId) {
-	return boundaryOptions.find((option) => option.id === boundaryOptionId)?.treatment ?? {
+	return boundaryOptionById.get(boundaryOptionId)?.treatment ?? {
 		kind: "legacy-unsupported",
 		boundaryOptionId
 	};
@@ -17005,11 +17041,19 @@ function boundaryOptionForTreatment(treatment) {
 	if (treatment.kind === "legacy-unsupported") {
 		return null;
 	}
-	return boundaryOptions.find((option) => sectionBoundaryTreatmentsEqual(option.treatment, treatment)) ?? null;
+	return boundaryOptionByTreatmentKey.get(stableTreatmentKey(treatment)) ?? null;
 }
 function boundaryOptionIdForTreatment(treatment) {
 	return boundaryOptionForTreatment(treatment)?.id ?? (treatment.kind === "legacy-unsupported" ? treatment.boundaryOptionId : null);
 }
+/**
+* Supported decorative intent for a structured treatment, or null for `none`,
+* legacy-unsupported pins and structured treatments the catalogue lacks.
+*/
+function transitionIntentForTreatment(treatment) {
+	const transition = boundaryOptionForTreatment(treatment)?.transitionAfter;
+	return transition && isDecorativeTransitionIntent(transition) ? transition : null;
+}
 function sectionBoundaryTreatmentsEqual(left, right) {
 	return stableTreatmentKey(left) === stableTreatmentKey(right);
 }
@@ -17036,10 +17080,10 @@ function stableTreatmentKey(treatment) {
 function sectionTransitionFamilyForBoundaryOptionId(boundaryOptionId) {
 	const variant = sectionTransitionVariantForBoundaryOptionId(boundaryOptionId);
 	if (!variant) return null;
-	return sectionTransitionFamilies.find((family) => family.id === variant.familyId) ?? null;
+	return transitionFamilyById.get(variant.familyId) ?? null;
 }
 function defaultSectionTransitionVariantForFamily(familyId) {
-	const family = sectionTransitionFamilies.find((candidate$1) => candidate$1.id === familyId);
+	const family = transitionFamilyById.get(familyId);
 	if (!family) {
 		throw new Error(`Unknown section transition family: ${familyId}`);
 	}
@@ -17047,409 +17091,807 @@ function defaultSectionTransitionVariantForFamily(familyId) {
 }
 
 //#endregion
-//#region ../theme-core/src/site-styles/pageDesignIntent.ts
-const pageDesignIntentSchemaVersion = 2;
-const legacyPageDesignIntentSchemaVersion = 1;
-const unknownBoundaryOptionId = asBoundaryOptionId("break:unknown");
+//#region ../theme-core/src/site-styles/sectionBoundaryComposition.ts
+const backgroundToken = requireThemeColorToken$1("background");
+/**
+* Classifies a section from its final render content. `_sectionStyles`
+* already holds the effective background (Look default, page-design override
+* and block-authored media merged by `resolveSectionBackground`), so this only
+* reads it and never re-decides precedence. A missing or unparseable
+* background is the page background, as it is for the renderer.
+*/
+function boundaryEndpointForSectionContent(content) {
+	const background = parseCanonicalRuntimeBackground(content);
+	if (background.kind === "none") {
+		return {
+			kind: "paint",
+			token: backgroundToken
+		};
+	}
+	const effective = background.background;
+	switch (effective.type) {
+		case "color": {
+			if (effective.color === null || effective.color === undefined) {
+				return {
+					kind: "paint",
+					token: backgroundToken
+				};
+			}
+			const token = parseThemeColorToken(effective.color);
+			return token ? {
+				kind: "paint",
+				token
+			} : {
+				kind: "unpainted",
+				reason: "literal-color"
+			};
+		}
+		case "gradient": return {
+			kind: "unpainted",
+			reason: "gradient"
+		};
+		case "image":
+		case "video": return {
+			kind: "unpainted",
+			reason: "media"
+		};
+		default: return assertNever$1(effective, "Unhandled section background type");
+	}
+}
 /**
-* Site style is site-owned authority. Page design snapshots retain pins and
-* flow choices, but must not keep resolving against a superseded site style.
+* Reads both facts from final render content in one place. `_frameStyles` is
+* the compiled frame; content without one (no page design, an SDK block)
+* draws a plain frame.
 */
-function rebasePageDesignIntentToSiteStyle(intent, siteStyleId) {
-	return intent.siteStyleId === siteStyleId ? intent : {
-		...intent,
-		siteStyleId
+function sectionFactsForContent(content) {
+	return {
+		endpoint: boundaryEndpointForSectionContent(content),
+		frame: frameKindForContent(content)
 	};
 }
-const pageDesignUserPinnedAppearanceChoiceSchema = z.object({
-	kind: z.literal("user-pinned"),
-	value: z.string().min(1).transform(asAppearancePresetId)
-}).strict();
-const pageDesignUserPinnedBoundaryChoiceSchema = z.object({
-	kind: z.literal("user-pinned"),
-	value: z.string().min(1).transform(asBoundaryOptionId)
-}).strict();
-const pageDesignBoundaryTreatmentSchema = z.discriminatedUnion("kind", [
-	z.object({ kind: z.literal("none") }).strict(),
-	z.object({
-		kind: z.literal("soft-fade"),
-		height: z.enum([
-			"compact",
-			"medium",
-			"large",
-			"expansive"
-		]),
-		curve: z.enum([
-			"soft",
-			"spacious",
-			"expansive"
-		])
-	}).strict(),
-	z.object({
-		kind: z.literal("wave-edge"),
-		height: z.enum([
-			"compact",
-			"medium",
-			"large"
-		]),
-		amplitude: z.enum([
-			"subtle",
-			"balanced",
-			"bold"
-		]),
-		rhythm: z.enum(["single", "double"]),
-		symmetry: z.enum([
-			"symmetrical",
-			"asymmetrical",
-			"drift"
-		])
-	}).strict(),
-	z.object({
-		kind: z.literal("angle-edge"),
-		height: z.enum([
-			"compact",
-			"medium",
-			"large"
-		]),
-		slope: z.enum([
-			"subtle",
-			"balanced",
-			"steep"
-		]),
-		direction: z.enum(["forward", "reverse"])
-	}).strict(),
-	z.object({
-		kind: z.literal("legacy-unsupported"),
-		boundaryOptionId: z.string().min(1).transform(asBoundaryOptionId)
-	}).strict()
-]);
-const pageDesignUserPinnedBoundaryTreatmentChoiceSchema = z.object({
-	kind: z.literal("user-pinned"),
-	value: pageDesignBoundaryTreatmentSchema
-}).strict();
-const pageDesignBlockLookPinSchema = z.object({
-	blockId: z.string().min(1).transform(asDesignBlockId),
-	blockKind: z.string().min(1),
-	choice: pageDesignUserPinnedAppearanceChoiceSchema
-}).strict();
-const pageDesignBoundaryPinSchema = z.object({
-	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
-	previousBlockId: z.string().min(1).transform(asDesignBlockId),
-	nextBlockId: z.string().min(1).transform(asDesignBlockId),
-	choice: pageDesignUserPinnedBoundaryTreatmentChoiceSchema
-}).strict().superRefine(validateBoundaryPinIdMatchesBlocks);
-const legacyPageDesignBoundaryPinSchema = z.object({
-	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
-	previousBlockId: z.string().min(1).transform(asDesignBlockId),
-	nextBlockId: z.string().min(1).transform(asDesignBlockId),
-	choice: pageDesignUserPinnedBoundaryChoiceSchema
-}).strict().superRefine(validateBoundaryPinIdMatchesBlocks);
+function frameKindForContent(content) {
+	const frameStyles = content._frameStyles;
+	const kind = typeof frameStyles === "object" && frameStyles !== null && "kind" in frameStyles ? frameStyles.kind : null;
+	return kind === "panel" || kind === "flush-panel" ? kind : "plain";
+}
 /**
-* Persisted editor intent stores only user-pinned block Looks and boundary choices.
-* Missing pins mean `auto`; block-kind/preset compatibility is enforced by resolution,
-* not by this JSON parse boundary.
+* The frame rule: a flush panel owns the edge it runs to, so no break is
+* drawn next to one. The single home for this rule; the generated
+* pipeline's budget and the site-style lab ask it with their plan frames.
 */
-const pageDesignIntentV1Schema = z.object({
-	schemaVersion: z.literal(legacyPageDesignIntentSchemaVersion),
-	siteStyleId: z.string().min(1).transform(asSiteStyleId),
-	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
-	blockLookPins: z.array(pageDesignBlockLookPinSchema),
-	boundaryPins: z.array(legacyPageDesignBoundaryPinSchema)
-}).strict().superRefine(validateUniquePageDesignPins);
-const pageDesignIntentV2Schema = z.object({
-	schemaVersion: z.literal(pageDesignIntentSchemaVersion),
-	siteStyleId: z.string().min(1).transform(asSiteStyleId),
-	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
-	blockLookPins: z.array(pageDesignBlockLookPinSchema),
-	boundaryPins: z.array(pageDesignBoundaryPinSchema)
-}).strict().superRefine(validateUniquePageDesignPins);
-function parsePageDesignIntent(value, options = {}) {
-	if (isLegacyPageDesignIntentCandidate(value)) {
-		const legacyParsed = parseSchemaVersionedJson({
-			value,
-			schema: pageDesignIntentV1Schema,
-			expectedSchemaVersion: legacyPageDesignIntentSchemaVersion,
-			unsupportedSchemaVersionMessage: options.unsupportedSchemaVersionMessage ?? "Unsupported Theme V2 page design intent schemaVersion.",
-			invalidShapeMessage: options.invalidShapeMessage ?? "Invalid Theme V2 page design intent shape."
-		});
-		switch (legacyParsed.kind) {
-			case "absent": return legacyParsed;
-			case "parsed": return {
-				kind: "parsed",
-				intent: normalizeLegacyPageDesignIntent(legacyParsed.value)
-			};
-			case "invalid": return legacyParsed;
-			default: return assertNever$1(legacyParsed, "Unhandled legacy page design intent JSON parse result");
-		}
+function frameNotShownReason(previous, next) {
+	return previous === "flush-panel" || next === "flush-panel" ? "flush-panel" : null;
+}
+/**
+* Decides whether and how a join draws. The frame rule wins before paint is
+* considered; two unpainted sides show nothing.
+*/
+function composeBoundary(previous, next) {
+	const frameReason = frameNotShownReason(previous.frame, next.frame);
+	if (frameReason) {
+		return {
+			kind: "not-shown",
+			reason: frameReason
+		};
 	}
-	const parsed = parseSchemaVersionedJson({
-		value,
-		schema: pageDesignIntentV2Schema,
-		expectedSchemaVersion: pageDesignIntentSchemaVersion,
-		unsupportedSchemaVersionMessage: options.unsupportedSchemaVersionMessage ?? "Unsupported Theme V2 page design intent schemaVersion.",
-		invalidShapeMessage: options.invalidShapeMessage ?? "Invalid Theme V2 page design intent shape."
-	});
-	switch (parsed.kind) {
-		case "absent": return parsed;
-		case "parsed": return {
-			kind: "parsed",
-			intent: parsed.value
+	const from = previous.endpoint;
+	const to = next.endpoint;
+	if (from.kind === "paint") {
+		return {
+			kind: "shown",
+			composition: to.kind === "paint" ? {
+				kind: "paint-to-paint",
+				from: from.token,
+				to: to.token
+			} : {
+				kind: "paint-to-unpainted",
+				from: from.token
+			}
 		};
-		case "invalid": return parsed;
-		default: return assertNever$1(parsed, "Unhandled page design intent JSON parse result");
 	}
+	return to.kind === "paint" ? {
+		kind: "shown",
+		composition: {
+			kind: "unpainted-to-paint",
+			to: to.token
+		}
+	} : {
+		kind: "not-shown",
+		reason: "both-unpainted"
+	};
 }
-function isLegacyPageDesignIntentCandidate(value) {
-	return typeof value === "object" && value !== null && "schemaVersion" in value && value.schemaVersion === legacyPageDesignIntentSchemaVersion;
+/**
+* Placement, reserves and paint for a shown boundary, derived from the
+* composition and the catalogue's metrics for the treatment.
+*/
+function boundaryLayout(intent, composition) {
+	const metrics = boundaryRuntimeMetricsForDecorativeTransition(intent);
+	switch (composition.kind) {
+		case "paint-to-paint": return {
+			placement: "centred",
+			reserves: {
+				before: metrics.reserveCss,
+				after: metrics.reserveCss
+			},
+			paint: {
+				band: composition.from,
+				shape: composition.to
+			}
+		};
+		case "unpainted-to-paint": return {
+			placement: "previous",
+			reserves: {
+				before: metrics.heightCss,
+				after: null
+			},
+			paint: {
+				band: null,
+				shape: composition.to
+			}
+		};
+		case "paint-to-unpainted": return {
+			placement: "next",
+			reserves: {
+				before: null,
+				after: metrics.heightCss
+			},
+			paint: {
+				band: null,
+				shape: composition.from
+			}
+		};
+		default: return assertNever$1(composition, "Unhandled boundary composition");
+	}
 }
-function normalizeLegacyPageDesignIntent(intent) {
+function requireThemeColorToken$1(value) {
+	const token = parseThemeColorToken(value);
+	if (!token) {
+		throw new Error(`Expected a theme color token. Received: ${value}`);
+	}
+	return token;
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/compositionBudget.ts
+const repairActionsByRatioIssueKind = {
+	"accent-density-exceeded": ["reduce-accent-density"],
+	"panel-density-exceeded": ["reduce-panel-density"],
+	"transition-mix-exceeded": ["reduce-transition-mix"],
+	"media-density-exceeded": ["reduce-media-density"],
+	"decorative-repetition-exceeded": ["reduce-decorative-repetition"]
+};
+function issueMetadata(policy, allowedRepairActions) {
 	return {
-		schemaVersion: pageDesignIntentSchemaVersion,
-		siteStyleId: intent.siteStyleId,
-		pageFlowPresetId: intent.pageFlowPresetId,
-		blockLookPins: intent.blockLookPins,
-		boundaryPins: intent.boundaryPins.map((pin) => ({
-			boundaryId: pin.boundaryId,
-			previousBlockId: pin.previousBlockId,
-			nextBlockId: pin.nextBlockId,
-			choice: userPinnedDesignChoice(boundaryTreatmentForBoundaryOptionId(pin.choice.value))
-		}))
+		policy,
+		severity: designIssueSeverityForPolicy(policy),
+		allowedRepairActions
 	};
 }
-function autoDesignChoice() {
-	return { kind: "auto" };
+/** Returns the fraction of page blocks selected by a budget check. */
+function ratio(count, total) {
+	return total === 0 ? 0 : count / total;
 }
-function userPinnedDesignChoice(value) {
+function maxCompositionItemsWithinRatio(totalItems, allowedRatio) {
+	return Math.floor((allowedRatio + Number.EPSILON) * totalItems);
+}
+function isRatioExceeded(actualCount, totalItems, allowedRatio) {
+	return actualCount > maxCompositionItemsWithinRatio(totalItems, allowedRatio);
+}
+function issueWhenRatioExceeded(input) {
+	const actualRatio = ratio(input.blockIds.length, input.totalBlocks);
+	if (!isRatioExceeded(input.blockIds.length, input.totalBlocks, input.allowedRatio)) {
+		return null;
+	}
 	return {
-		kind: "user-pinned",
-		value
+		kind: input.kind,
+		budget: input.budget,
+		actualRatio,
+		allowedRatio: input.allowedRatio,
+		blockIds: input.blockIds,
+		...issueMetadata(input.policy, repairActionsByRatioIssueKind[input.kind])
 	};
 }
-function resolvePageDesignBlockLookChoice(intent, blockId) {
-	return intent.blockLookPins.find((pin) => pin.blockId === blockId)?.choice ?? autoDesignChoice();
+/** Checks whether block framing or a card surface contributes panel mass. */
+function hasPanelFrameOrCardSurface(block) {
+	return block.appliedContentFrame.kind !== "plain" || block.appliedCardRole != null && block.appliedCardRole !== "none";
 }
-function resolvePageDesignBoundaryChoice(intent, previousBlockId, nextBlockId) {
-	return intent.boundaryPins.find((pin) => pin.previousBlockId === previousBlockId && pin.nextBlockId === nextBlockId)?.choice ?? autoDesignChoice();
+/** Checks explicit decorative annotations; transitions are budgeted separately. */
+function hasDecorativeAnnotation(context) {
+	return context?.decorativeIntent === "supporting" || context?.decorativeIntent === "feature";
 }
-function buildBoundaryPin(previousBlockId, nextBlockId, choice) {
-	return {
-		boundaryId: makeBoundaryId(previousBlockId, nextBlockId),
-		previousBlockId,
-		nextBlockId,
-		choice
-	};
+/** Checks whether a block annotation says media contributes visual weight. */
+function hasMediaAnnotation(context) {
+	return context?.mediaIntent === "supporting" || context?.mediaIntent === "dominant";
 }
-function reducePageDesignIntentForStructureEvent(intent, event) {
-	switch (event.kind) {
-		case "block-added": return {
-			intent,
-			issues: []
-		};
-		case "block-removed": return removeBlockFromPageDesignIntent(intent, event.blockId);
-		case "blocks-reordered": return pruneBoundaryPinsForOrder(intent, event.orderedBlockIds);
-		case "block-kind-changed": return changeBlockKindInPageDesignIntent(intent, event);
-		case "block-duplicated": return duplicateBlockInPageDesignIntent(intent, event);
-		default: return assertNever$1(event, "Unhandled page design structure event");
+function validateCompositionBudget(input) {
+	const { budget, policy, resolved } = input;
+	const totalBlocks = resolved.blocks.length;
+	const knownBlockIds = new Set(resolved.blocks.map((block) => block.blockId));
+	const blockContexts = input.blockContexts ?? [];
+	const unknownContextBlockIds = blockContexts.filter((context) => !knownBlockIds.has(context.blockId)).map((context) => context.blockId);
+	const knownBlockContexts = blockContexts.filter((context) => knownBlockIds.has(context.blockId));
+	const contextsByBlockId = new Map(knownBlockContexts.map((context) => [context.blockId, context]));
+	const issues = [];
+	if (unknownContextBlockIds.length > 0) {
+		issues.push({
+			kind: "unknown-composition-context-block",
+			blockIds: unknownContextBlockIds,
+			...issueMetadata(policy, [])
+		});
 	}
-}
-function reducePageDesignIntentForUserAction(intent, action) {
-	switch (action.kind) {
-		case "set-page-flow": return {
-			...intent,
-			pageFlowPresetId: action.pageFlowPresetId
-		};
-		case "set-block-look": return setBlockLookChoice(intent, action.block, action.choice);
-		case "set-boundary": return setBoundaryChoice(intent, action.previousBlockId, action.nextBlockId, action.choice);
-		default: return assertNever$1(action, "Unhandled page design user action");
+	const accentBlockIds = resolved.blocks.filter((block) => block.appliedSectionSurface === "accent-band" || block.appliedSectionSurface === "brand-depth-band").map((block) => block.blockId);
+	const accentIssue = issueWhenRatioExceeded({
+		kind: "accent-density-exceeded",
+		policy,
+		budget: budget.accentDensity,
+		blockIds: accentBlockIds,
+		totalBlocks,
+		allowedRatio: compositionDensityRatioLimits[budget.accentDensity]
+	});
+	if (accentIssue) {
+		issues.push(accentIssue);
 	}
-}
-function remapPageDesignIntentForDuplicate(intent, input) {
-	const targetBySourceId = new Map(input.blockMappings.map((mapping) => [mapping.sourceBlockId, {
-		blockId: mapping.targetBlockId,
-		blockKind: mapping.targetBlockKind
-	}]));
-	const targetBlockOrder = input.blockMappings.map((mapping) => mapping.targetBlockId);
-	const adjacentTargetPairs = adjacentPairKeySet(targetBlockOrder);
-	const blockLookPins = intent.blockLookPins.flatMap((pin) => {
-		const target = targetBySourceId.get(pin.blockId);
-		return target ? [{
-			blockId: target.blockId,
-			blockKind: target.blockKind,
-			choice: pin.choice
-		}] : [];
+	const panelBlockIds = resolved.blocks.filter(hasPanelFrameOrCardSurface).map((block) => block.blockId);
+	const panelIssue = issueWhenRatioExceeded({
+		kind: "panel-density-exceeded",
+		policy,
+		budget: budget.panelDensity,
+		blockIds: panelBlockIds,
+		totalBlocks,
+		allowedRatio: compositionDensityRatioLimits[budget.panelDensity]
 	});
-	const boundaryPins = intent.boundaryPins.flatMap((pin) => {
-		const targetPrevious = targetBySourceId.get(pin.previousBlockId);
-		const targetNext = targetBySourceId.get(pin.nextBlockId);
-		if (!targetPrevious || !targetNext) {
-			return [];
-		}
-		if (!adjacentTargetPairs.has(boundaryKey(targetPrevious.blockId, targetNext.blockId))) {
-			return [];
-		}
-		return [buildBoundaryPin(targetPrevious.blockId, targetNext.blockId, pin.choice)];
+	if (panelIssue) {
+		issues.push(panelIssue);
+	}
+	const frameByBlockId = new Map(input.resolved.blocks.map((block) => [block.blockId, block.appliedContentFrame.kind]));
+	const transitionBlockIds = input.joins.filter((join) => {
+		const previous = frameByBlockId.get(join.previousBlockId);
+		const next = frameByBlockId.get(join.nextBlockId);
+		return previous !== undefined && next !== undefined && frameNotShownReason(previous, next) === null;
+	}).map((join) => join.previousBlockId);
+	const transitionIssue = issueWhenRatioExceeded({
+		kind: "transition-mix-exceeded",
+		policy,
+		budget: budget.transitionMix,
+		blockIds: transitionBlockIds,
+		totalBlocks,
+		allowedRatio: compositionTransitionMixRatioLimits[budget.transitionMix]
+	});
+	if (transitionIssue) {
+		issues.push(transitionIssue);
+	}
+	const ctaContexts = knownBlockContexts.filter((context) => (context.primaryCtaCount ?? 0) > 0);
+	const actualPrimaryCtaCount = ctaContexts.reduce((sum, context) => sum + (context.primaryCtaCount ?? 0), 0);
+	if (actualPrimaryCtaCount > budget.primaryCtaLimit) {
+		issues.push({
+			kind: "primary-cta-limit-exceeded",
+			actualCount: actualPrimaryCtaCount,
+			allowedCount: budget.primaryCtaLimit,
+			blockIds: ctaContexts.map((context) => context.blockId),
+			...issueMetadata(policy, ["reduce-primary-ctas"])
+		});
+	}
+	const mediaBlockIds = resolved.blocks.filter((block) => hasMediaAnnotation(contextsByBlockId.get(block.blockId))).map((block) => block.blockId);
+	const mediaIssue = issueWhenRatioExceeded({
+		kind: "media-density-exceeded",
+		policy,
+		budget: budget.mediaDensity,
+		blockIds: mediaBlockIds,
+		totalBlocks,
+		allowedRatio: compositionDensityRatioLimits[budget.mediaDensity]
+	});
+	if (mediaIssue) {
+		issues.push(mediaIssue);
+	}
+	const decorativeBlockIds = resolved.blocks.filter((block) => hasDecorativeAnnotation(contextsByBlockId.get(block.blockId))).map((block) => block.blockId);
+	const decorativeIssue = issueWhenRatioExceeded({
+		kind: "decorative-repetition-exceeded",
+		policy,
+		budget: budget.decorativeRepetition,
+		blockIds: decorativeBlockIds,
+		totalBlocks,
+		allowedRatio: compositionDensityRatioLimits[budget.decorativeRepetition]
 	});
+	if (decorativeIssue) {
+		issues.push(decorativeIssue);
+	}
+	return issues;
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/compilationPlan.ts
+const defaultHeaderBrandPreferences = {
+	brandDisplay: "auto",
+	logoSize: "auto"
+};
+function headerBrandPreferencesFromTheme(theme) {
 	return {
-		intent: {
-			...intent,
-			blockLookPins,
-			boundaryPins
+		brandDisplay: theme?.header.logo?.brandDisplay ?? defaultHeaderBrandPreferences.brandDisplay,
+		logoSize: theme?.header.logo?.size ?? defaultHeaderBrandPreferences.logoSize
+	};
+}
+function replaceSiteStyleCompilationPlan(input) {
+	return {
+		kind: "replace-site-style",
+		buttons: {
+			kind: "recompile",
+			selection: input.buttonStyleSelection ?? null,
+			reason: "site-style-replacement"
 		},
-		issues: []
+		header: {
+			kind: "recompile",
+			selection: input.headerSelection,
+			brandPresentation: input.headerLogo === undefined ? { kind: "use-compiled-defaults" } : {
+				kind: "apply-logo-context",
+				logo: input.headerLogo
+			}
+		},
+		footerLookId: input.footerLookId ?? null
 	};
 }
-function setBlockLookChoice(intent, block, choice) {
-	const withoutBlock = intent.blockLookPins.filter((pin) => pin.blockId !== block.blockId);
-	if (choice.kind === "auto") {
-		return {
-			...intent,
-			blockLookPins: withoutBlock
-		};
+/**
+* Writes the brand display / logo size preference onto the header's logo style.
+*
+* Moved here from preview-next in #1318 Phase 4a so the header preference
+* pipeline can be composed once, in theme-core, rather than half in the client.
+*/
+function withHeaderBrandThemePreferences(theme, preferences) {
+	const currentLogo = theme.header.logo;
+	if (!currentLogo && preferences.brandDisplay === defaultHeaderBrandPreferences.brandDisplay && preferences.logoSize === defaultHeaderBrandPreferences.logoSize) {
+		return theme;
 	}
 	return {
-		...intent,
-		blockLookPins: [...withoutBlock, {
-			blockId: block.blockId,
-			blockKind: block.blockKind,
-			choice
-		}]
+		...theme,
+		header: {
+			...theme.header,
+			logo: {
+				fontFamily: currentLogo?.fontFamily ?? "heading",
+				letterSpacing: currentLogo?.letterSpacing ?? "normal",
+				gradient: currentLogo?.gradient ?? false,
+				...currentLogo ?? {},
+				brandDisplay: preferences.brandDisplay,
+				size: preferences.logoSize
+			}
+		}
 	};
 }
-function setBoundaryChoice(intent, previousBlockId, nextBlockId, choice) {
-	const withoutBoundary = intent.boundaryPins.filter((pin) => pin.previousBlockId !== previousBlockId || pin.nextBlockId !== nextBlockId);
-	if (choice.kind === "auto") {
+
+//#endregion
+//#region ../theme-core/src/site-styles/schemaVersionedJson.ts
+function parseSchemaVersionedJson(input) {
+	if (input.value == null) {
+		return { kind: "absent" };
+	}
+	if (typeof input.value === "object" && input.value !== null && "schemaVersion" in input.value && input.value.schemaVersion !== input.expectedSchemaVersion) {
 		return {
-			...intent,
-			boundaryPins: withoutBoundary
+			kind: "invalid",
+			issue: {
+				kind: "unsupported-schema-version",
+				message: input.unsupportedSchemaVersionMessage
+			}
+		};
+	}
+	const parsed = input.schema.safeParse(input.value);
+	if (!parsed.success) {
+		const firstIssue = parsed.error.issues[0];
+		return {
+			kind: "invalid",
+			issue: {
+				kind: "invalid-json-shape",
+				message: firstIssue?.message ?? input.invalidShapeMessage
+			}
 		};
 	}
 	return {
-		...intent,
-		boundaryPins: [...withoutBoundary, buildBoundaryPin(previousBlockId, nextBlockId, choice)]
-	};
-}
-function removeBlockFromPageDesignIntent(intent, blockId) {
-	const removedLookIssues = intent.blockLookPins.flatMap((pin) => pin.blockId === blockId ? [{
-		kind: "removed-look-pin-for-deleted-block",
-		blockId,
-		presetId: pin.choice.value,
-		feedback: "debug"
-	}] : []);
-	const removedBoundaryIssues = intent.boundaryPins.flatMap((pin) => pin.previousBlockId === blockId || pin.nextBlockId === blockId ? [{
-		kind: "removed-boundary-pin-for-broken-adjacency",
-		boundaryId: pin.boundaryId,
-		previousBlockId: pin.previousBlockId,
-		nextBlockId: pin.nextBlockId,
-		presetId: boundaryIssuePresetId(pin.choice.value),
-		feedback: "debug"
-	}] : []);
-	return {
-		intent: {
-			...intent,
-			blockLookPins: intent.blockLookPins.filter((pin) => pin.blockId !== blockId),
-			boundaryPins: intent.boundaryPins.filter((pin) => pin.previousBlockId !== blockId && pin.nextBlockId !== blockId)
-		},
-		issues: [...removedLookIssues, ...removedBoundaryIssues]
-	};
-}
-function pruneBoundaryPinsForOrder(intent, orderedBlockIds) {
-	const adjacentPairs = adjacentPairKeySet(orderedBlockIds);
-	const removedBoundaryIssues = intent.boundaryPins.flatMap((pin) => adjacentPairs.has(boundaryKey(pin.previousBlockId, pin.nextBlockId)) ? [] : [{
-		kind: "removed-boundary-pin-for-broken-adjacency",
-		boundaryId: pin.boundaryId,
-		previousBlockId: pin.previousBlockId,
-		nextBlockId: pin.nextBlockId,
-		presetId: boundaryIssuePresetId(pin.choice.value),
-		feedback: "debug"
-	}]);
-	return {
-		intent: {
-			...intent,
-			boundaryPins: intent.boundaryPins.filter((pin) => adjacentPairs.has(boundaryKey(pin.previousBlockId, pin.nextBlockId)))
-		},
-		issues: removedBoundaryIssues
+		kind: "parsed",
+		value: parsed.data
 	};
 }
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageDesignIntent.ts
+const pageDesignIntentSchemaVersion = 2;
+const legacyPageDesignIntentSchemaVersion = 1;
+const unknownBoundaryOptionId = asBoundaryOptionId("break:unknown");
 /**
-* A block-kind change updates the pin's current block kind so future resolution sees
-* the current tree. If the pinned Look is incompatible, the pin remains stored and
-* the resolver must render a safe auto fallback while the user-facing issue is open.
+* Site style is site-owned authority. Page design snapshots retain pins and
+* flow choices, but must not keep resolving against a superseded site style.
 */
-function changeBlockKindInPageDesignIntent(intent, event) {
-	const blockLookPins = intent.blockLookPins.map((pin) => pin.blockId === event.blockId ? {
-		...pin,
-		blockKind: event.nextBlockKind
-	} : pin);
-	const changed = intent.blockLookPins.find((pin) => pin.blockId === event.blockId);
-	const incompatiblePinnedLook = changed && !event.compatiblePinnedLookPresetIds.includes(changed.choice.value) ? changed : null;
-	return {
-		intent: {
-			...intent,
-			blockLookPins
-		},
-		issues: incompatiblePinnedLook ? [{
-			kind: "pinned-look-incompatible-with-block-kind",
-			blockId: event.blockId,
-			presetId: incompatiblePinnedLook.choice.value,
-			previousBlockKind: incompatiblePinnedLook.blockKind,
-			nextBlockKind: event.nextBlockKind,
-			feedback: "user-facing"
-		}] : []
+function rebasePageDesignIntentToSiteStyle(intent, siteStyleId) {
+	return intent.siteStyleId === siteStyleId ? intent : {
+		...intent,
+		siteStyleId
 	};
 }
-function boundaryIssuePresetId(treatment) {
-	if (typeof treatment === "string") return treatment;
-	return boundaryOptionIdForTreatment(treatment) ?? unknownBoundaryOptionId;
-}
+const pageDesignUserPinnedAppearanceChoiceSchema = z.object({
+	kind: z.literal("user-pinned"),
+	value: z.string().min(1).transform(asAppearancePresetId)
+}).strict();
+const pageDesignUserPinnedBoundaryChoiceSchema = z.object({
+	kind: z.literal("user-pinned"),
+	value: z.string().min(1).transform(asBoundaryOptionId)
+}).strict();
+const pageDesignBoundaryTreatmentSchema = z.discriminatedUnion("kind", [
+	z.object({ kind: z.literal("none") }).strict(),
+	z.object({
+		kind: z.literal("soft-fade"),
+		height: z.enum([
+			"compact",
+			"medium",
+			"large",
+			"expansive"
+		]),
+		curve: z.enum([
+			"soft",
+			"spacious",
+			"expansive"
+		])
+	}).strict(),
+	z.object({
+		kind: z.literal("wave-edge"),
+		height: z.enum([
+			"compact",
+			"medium",
+			"large"
+		]),
+		amplitude: z.enum([
+			"subtle",
+			"balanced",
+			"bold"
+		]),
+		rhythm: z.enum(["single", "double"]),
+		symmetry: z.enum([
+			"symmetrical",
+			"asymmetrical",
+			"drift"
+		])
+	}).strict(),
+	z.object({
+		kind: z.literal("angle-edge"),
+		height: z.enum([
+			"compact",
+			"medium",
+			"large"
+		]),
+		slope: z.enum([
+			"subtle",
+			"balanced",
+			"steep"
+		]),
+		direction: z.enum(["forward", "reverse"])
+	}).strict(),
+	z.object({
+		kind: z.literal("legacy-unsupported"),
+		boundaryOptionId: z.string().min(1).transform(asBoundaryOptionId)
+	}).strict()
+]);
+const pageDesignUserPinnedBoundaryTreatmentChoiceSchema = z.object({
+	kind: z.literal("user-pinned"),
+	value: pageDesignBoundaryTreatmentSchema
+}).strict();
+const pageDesignBlockLookPinSchema = z.object({
+	blockId: z.string().min(1).transform(asDesignBlockId),
+	blockKind: z.string().min(1),
+	choice: pageDesignUserPinnedAppearanceChoiceSchema
+}).strict();
+const pageDesignBoundaryPinSchema = z.object({
+	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
+	previousBlockId: z.string().min(1).transform(asDesignBlockId),
+	nextBlockId: z.string().min(1).transform(asDesignBlockId),
+	choice: pageDesignUserPinnedBoundaryTreatmentChoiceSchema
+}).strict().superRefine(validateBoundaryPinIdMatchesBlocks);
+const legacyPageDesignBoundaryPinSchema = z.object({
+	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
+	previousBlockId: z.string().min(1).transform(asDesignBlockId),
+	nextBlockId: z.string().min(1).transform(asDesignBlockId),
+	choice: pageDesignUserPinnedBoundaryChoiceSchema
+}).strict().superRefine(validateBoundaryPinIdMatchesBlocks);
 /**
-* Ordinary block duplication does not copy boundary pins. Boundary pins represent
-* exact adjacent pairs, so duplicated blocks start with automatic surrounding breaks.
+* Persisted editor intent stores only user-pinned block Looks and boundary choices.
+* Missing pins mean `auto`; block-kind/preset compatibility is enforced by resolution,
+* not by this JSON parse boundary.
 */
-function duplicateBlockInPageDesignIntent(intent, event) {
-	const sourcePin = intent.blockLookPins.find((pin) => pin.blockId === event.sourceBlockId);
-	if (!event.copyPinnedLook) {
-		return {
-			intent,
-			issues: []
-		};
+const pageDesignIntentV1Schema = z.object({
+	schemaVersion: z.literal(legacyPageDesignIntentSchemaVersion),
+	siteStyleId: z.string().min(1).transform(asSiteStyleId),
+	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
+	blockLookPins: z.array(pageDesignBlockLookPinSchema),
+	boundaryPins: z.array(legacyPageDesignBoundaryPinSchema)
+}).strict().superRefine(validateUniquePageDesignPins);
+const pageDesignIntentV2Schema = z.object({
+	schemaVersion: z.literal(pageDesignIntentSchemaVersion),
+	siteStyleId: z.string().min(1).transform(asSiteStyleId),
+	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
+	blockLookPins: z.array(pageDesignBlockLookPinSchema),
+	boundaryPins: z.array(pageDesignBoundaryPinSchema)
+}).strict().superRefine(validateUniquePageDesignPins);
+function parsePageDesignIntent(value, options = {}) {
+	if (isLegacyPageDesignIntentCandidate(value)) {
+		const legacyParsed = parseSchemaVersionedJson({
+			value,
+			schema: pageDesignIntentV1Schema,
+			expectedSchemaVersion: legacyPageDesignIntentSchemaVersion,
+			unsupportedSchemaVersionMessage: options.unsupportedSchemaVersionMessage ?? "Unsupported Theme V2 page design intent schemaVersion.",
+			invalidShapeMessage: options.invalidShapeMessage ?? "Invalid Theme V2 page design intent shape."
+		});
+		switch (legacyParsed.kind) {
+			case "absent": return legacyParsed;
+			case "parsed": return {
+				kind: "parsed",
+				intent: normalizeLegacyPageDesignIntent(legacyParsed.value)
+			};
+			case "invalid": return legacyParsed;
+			default: return assertNever$1(legacyParsed, "Unhandled legacy page design intent JSON parse result");
+		}
 	}
-	if (!sourcePin) {
-		return {
-			intent,
-			issues: [{
-				kind: "missing-look-pin-to-copy-on-duplicate",
-				sourceBlockId: event.sourceBlockId,
-				duplicatedBlockId: event.block.blockId,
-				feedback: "debug"
-			}]
+	const parsed = parseSchemaVersionedJson({
+		value,
+		schema: pageDesignIntentV2Schema,
+		expectedSchemaVersion: pageDesignIntentSchemaVersion,
+		unsupportedSchemaVersionMessage: options.unsupportedSchemaVersionMessage ?? "Unsupported Theme V2 page design intent schemaVersion.",
+		invalidShapeMessage: options.invalidShapeMessage ?? "Invalid Theme V2 page design intent shape."
+	});
+	switch (parsed.kind) {
+		case "absent": return parsed;
+		case "parsed": return {
+			kind: "parsed",
+			intent: parsed.value
 		};
+		case "invalid": return parsed;
+		default: return assertNever$1(parsed, "Unhandled page design intent JSON parse result");
 	}
+}
+function isLegacyPageDesignIntentCandidate(value) {
+	return typeof value === "object" && value !== null && "schemaVersion" in value && value.schemaVersion === legacyPageDesignIntentSchemaVersion;
+}
+function normalizeLegacyPageDesignIntent(intent) {
 	return {
-		intent: {
-			...intent,
-			blockLookPins: [...intent.blockLookPins, {
-				blockId: event.block.blockId,
-				blockKind: event.block.blockKind,
-				choice: sourcePin.choice
-			}]
-		},
-		issues: []
+		schemaVersion: pageDesignIntentSchemaVersion,
+		siteStyleId: intent.siteStyleId,
+		pageFlowPresetId: intent.pageFlowPresetId,
+		blockLookPins: intent.blockLookPins,
+		boundaryPins: intent.boundaryPins.map((pin) => ({
+			boundaryId: pin.boundaryId,
+			previousBlockId: pin.previousBlockId,
+			nextBlockId: pin.nextBlockId,
+			choice: userPinnedDesignChoice(boundaryTreatmentForBoundaryOptionId(pin.choice.value))
+		}))
 	};
 }
-function adjacentPairKeySet(orderedBlockIds) {
-	const pairs = new Set();
-	const [first, ...rest] = orderedBlockIds;
-	if (!first) {
-		return pairs;
-	}
-	let previousBlockId = first;
-	for (const nextBlockId of rest) {
-		pairs.add(boundaryKey(previousBlockId, nextBlockId));
-		previousBlockId = nextBlockId;
-	}
-	return pairs;
+function autoDesignChoice() {
+	return { kind: "auto" };
 }
-function addDuplicateStringIssues(ctx, input) {
+function userPinnedDesignChoice(value) {
+	return {
+		kind: "user-pinned",
+		value
+	};
+}
+function resolvePageDesignBlockLookChoice(intent, blockId) {
+	return intent.blockLookPins.find((pin) => pin.blockId === blockId)?.choice ?? autoDesignChoice();
+}
+function resolvePageDesignBoundaryChoice(intent, previousBlockId, nextBlockId) {
+	return intent.boundaryPins.find((pin) => pin.previousBlockId === previousBlockId && pin.nextBlockId === nextBlockId)?.choice ?? autoDesignChoice();
+}
+function buildBoundaryPin(previousBlockId, nextBlockId, choice) {
+	return {
+		boundaryId: makeBoundaryId(previousBlockId, nextBlockId),
+		previousBlockId,
+		nextBlockId,
+		choice
+	};
+}
+function reducePageDesignIntentForStructureEvent(intent, event) {
+	switch (event.kind) {
+		case "block-added": return {
+			intent,
+			issues: []
+		};
+		case "block-removed": return removeBlockFromPageDesignIntent(intent, event.blockId);
+		case "blocks-reordered": return pruneBoundaryPinsForOrder(intent, event.orderedBlockIds);
+		case "block-kind-changed": return changeBlockKindInPageDesignIntent(intent, event);
+		case "block-duplicated": return duplicateBlockInPageDesignIntent(intent, event);
+		default: return assertNever$1(event, "Unhandled page design structure event");
+	}
+}
+function reducePageDesignIntentForUserAction(intent, action) {
+	switch (action.kind) {
+		case "set-page-flow": return {
+			...intent,
+			pageFlowPresetId: action.pageFlowPresetId
+		};
+		case "set-block-look": return setBlockLookChoice(intent, action.block, action.choice);
+		case "set-boundary": return setBoundaryChoice(intent, action.previousBlockId, action.nextBlockId, action.choice);
+		default: return assertNever$1(action, "Unhandled page design user action");
+	}
+}
+function remapPageDesignIntentForDuplicate(intent, input) {
+	const targetBySourceId = new Map(input.blockMappings.map((mapping) => [mapping.sourceBlockId, {
+		blockId: mapping.targetBlockId,
+		blockKind: mapping.targetBlockKind
+	}]));
+	const targetBlockOrder = input.blockMappings.map((mapping) => mapping.targetBlockId);
+	const adjacentTargetPairs = adjacentPairKeySet(targetBlockOrder);
+	const blockLookPins = intent.blockLookPins.flatMap((pin) => {
+		const target = targetBySourceId.get(pin.blockId);
+		return target ? [{
+			blockId: target.blockId,
+			blockKind: target.blockKind,
+			choice: pin.choice
+		}] : [];
+	});
+	const boundaryPins = intent.boundaryPins.flatMap((pin) => {
+		const targetPrevious = targetBySourceId.get(pin.previousBlockId);
+		const targetNext = targetBySourceId.get(pin.nextBlockId);
+		if (!targetPrevious || !targetNext) {
+			return [];
+		}
+		if (!adjacentTargetPairs.has(makeBoundaryId(targetPrevious.blockId, targetNext.blockId))) {
+			return [];
+		}
+		return [buildBoundaryPin(targetPrevious.blockId, targetNext.blockId, pin.choice)];
+	});
+	return {
+		intent: {
+			...intent,
+			blockLookPins,
+			boundaryPins
+		},
+		issues: []
+	};
+}
+function setBlockLookChoice(intent, block, choice) {
+	const withoutBlock = intent.blockLookPins.filter((pin) => pin.blockId !== block.blockId);
+	if (choice.kind === "auto") {
+		return {
+			...intent,
+			blockLookPins: withoutBlock
+		};
+	}
+	return {
+		...intent,
+		blockLookPins: [...withoutBlock, {
+			blockId: block.blockId,
+			blockKind: block.blockKind,
+			choice
+		}]
+	};
+}
+function setBoundaryChoice(intent, previousBlockId, nextBlockId, choice) {
+	const withoutBoundary = intent.boundaryPins.filter((pin) => pin.previousBlockId !== previousBlockId || pin.nextBlockId !== nextBlockId);
+	if (choice.kind === "auto") {
+		return {
+			...intent,
+			boundaryPins: withoutBoundary
+		};
+	}
+	return {
+		...intent,
+		boundaryPins: [...withoutBoundary, buildBoundaryPin(previousBlockId, nextBlockId, choice)]
+	};
+}
+function removeBlockFromPageDesignIntent(intent, blockId) {
+	const removedLookIssues = intent.blockLookPins.flatMap((pin) => pin.blockId === blockId ? [{
+		kind: "removed-look-pin-for-deleted-block",
+		blockId,
+		presetId: pin.choice.value,
+		feedback: "debug"
+	}] : []);
+	const removedBoundaryIssues = intent.boundaryPins.flatMap((pin) => pin.previousBlockId === blockId || pin.nextBlockId === blockId ? [{
+		kind: "removed-boundary-pin-for-broken-adjacency",
+		boundaryId: pin.boundaryId,
+		previousBlockId: pin.previousBlockId,
+		nextBlockId: pin.nextBlockId,
+		presetId: boundaryIssuePresetId(pin.choice.value),
+		feedback: "debug"
+	}] : []);
+	return {
+		intent: {
+			...intent,
+			blockLookPins: intent.blockLookPins.filter((pin) => pin.blockId !== blockId),
+			boundaryPins: intent.boundaryPins.filter((pin) => pin.previousBlockId !== blockId && pin.nextBlockId !== blockId)
+		},
+		issues: [...removedLookIssues, ...removedBoundaryIssues]
+	};
+}
+function pruneBoundaryPinsForOrder(intent, orderedBlockIds) {
+	const adjacentPairs = adjacentPairKeySet(orderedBlockIds);
+	const removedBoundaryIssues = intent.boundaryPins.flatMap((pin) => adjacentPairs.has(makeBoundaryId(pin.previousBlockId, pin.nextBlockId)) ? [] : [{
+		kind: "removed-boundary-pin-for-broken-adjacency",
+		boundaryId: pin.boundaryId,
+		previousBlockId: pin.previousBlockId,
+		nextBlockId: pin.nextBlockId,
+		presetId: boundaryIssuePresetId(pin.choice.value),
+		feedback: "debug"
+	}]);
+	return {
+		intent: {
+			...intent,
+			boundaryPins: intent.boundaryPins.filter((pin) => adjacentPairs.has(makeBoundaryId(pin.previousBlockId, pin.nextBlockId)))
+		},
+		issues: removedBoundaryIssues
+	};
+}
+/**
+* A block-kind change updates the pin's current block kind so future resolution sees
+* the current tree. If the pinned Look is incompatible, the pin remains stored and
+* the resolver must render a safe auto fallback while the user-facing issue is open.
+*/
+function changeBlockKindInPageDesignIntent(intent, event) {
+	const blockLookPins = intent.blockLookPins.map((pin) => pin.blockId === event.blockId ? {
+		...pin,
+		blockKind: event.nextBlockKind
+	} : pin);
+	const changed = intent.blockLookPins.find((pin) => pin.blockId === event.blockId);
+	const incompatiblePinnedLook = changed && !event.compatiblePinnedLookPresetIds.includes(changed.choice.value) ? changed : null;
+	return {
+		intent: {
+			...intent,
+			blockLookPins
+		},
+		issues: incompatiblePinnedLook ? [{
+			kind: "pinned-look-incompatible-with-block-kind",
+			blockId: event.blockId,
+			presetId: incompatiblePinnedLook.choice.value,
+			previousBlockKind: incompatiblePinnedLook.blockKind,
+			nextBlockKind: event.nextBlockKind,
+			feedback: "user-facing"
+		}] : []
+	};
+}
+function boundaryIssuePresetId(treatment) {
+	if (typeof treatment === "string") return treatment;
+	return boundaryOptionIdForTreatment(treatment) ?? unknownBoundaryOptionId;
+}
+/**
+* Ordinary block duplication does not copy boundary pins. Boundary pins represent
+* exact adjacent pairs, so duplicated blocks start with automatic surrounding breaks.
+*/
+function duplicateBlockInPageDesignIntent(intent, event) {
+	const sourcePin = intent.blockLookPins.find((pin) => pin.blockId === event.sourceBlockId);
+	if (!event.copyPinnedLook) {
+		return {
+			intent,
+			issues: []
+		};
+	}
+	if (!sourcePin) {
+		return {
+			intent,
+			issues: [{
+				kind: "missing-look-pin-to-copy-on-duplicate",
+				sourceBlockId: event.sourceBlockId,
+				duplicatedBlockId: event.block.blockId,
+				feedback: "debug"
+			}]
+		};
+	}
+	return {
+		intent: {
+			...intent,
+			blockLookPins: [...intent.blockLookPins, {
+				blockId: event.block.blockId,
+				blockKind: event.block.blockKind,
+				choice: sourcePin.choice
+			}]
+		},
+		issues: []
+	};
+}
+function adjacentPairKeySet(orderedBlockIds) {
+	const pairs = new Set();
+	const [first, ...rest] = orderedBlockIds;
+	if (!first) {
+		return pairs;
+	}
+	let previousBlockId = first;
+	for (const nextBlockId of rest) {
+		pairs.add(makeBoundaryId(previousBlockId, nextBlockId));
+		previousBlockId = nextBlockId;
+	}
+	return pairs;
+}
+function addDuplicateStringIssues(ctx, input) {
 	const seen = new Set();
 	const duplicates = new Set();
 	for (const value of input.values) {
@@ -17483,14 +17925,11 @@ function validateUniquePageDesignPins(intent, ctx) {
 		label: "block Look pin"
 	});
 	addDuplicateStringIssues(ctx, {
-		values: intent.boundaryPins.map((pin) => boundaryKey(pin.previousBlockId, pin.nextBlockId)),
+		values: intent.boundaryPins.map((pin) => makeBoundaryId(pin.previousBlockId, pin.nextBlockId)),
 		path: ["boundaryPins"],
 		label: "boundary pin"
 	});
 }
-function boundaryKey(previousBlockId, nextBlockId) {
-	return makeBoundaryId(previousBlockId, nextBlockId);
-}
 
 //#endregion
 //#region ../theme-core/src/site-styles/contentTemplateDesignIntent.ts
@@ -20855,7 +21294,7 @@ function underlineNavLinkStyle(colorToken, underlineColorToken, typography = "pl
 		}] }
 	}, typography);
 }
-function pillNavLinkStyle(colorToken, backgroundToken = "primary", opacity = 10, typography = "plain") {
+function pillNavLinkStyle(colorToken, backgroundToken$1 = "primary", opacity = 10, typography = "plain") {
 	return applyNavTypography({
 		name: "Pill",
 		typography: "body",
@@ -20869,14 +21308,14 @@ function pillNavLinkStyle(colorToken, backgroundToken = "primary", opacity = 10,
 			hover: [{
 				effectId: "background-on-hover-alpha",
 				options: {
-					colorToken: backgroundToken,
+					colorToken: backgroundToken$1,
 					opacity
 				}
 			}],
 			active: [{
 				effectId: "background-on-hover-alpha",
 				options: {
-					colorToken: backgroundToken,
+					colorToken: backgroundToken$1,
 					opacity: opacity + 5
 				}
 			}]
@@ -21930,151 +22369,650 @@ function classifyRuntimeStyleFields(input) {
 			fields: []
 		};
 	}
-	if (!input.authority) {
-		return {
-			kind: "unsupported-manual-review",
-			fields
-		};
+	if (!input.authority) {
+		return {
+			kind: "unsupported-manual-review",
+			fields
+		};
+	}
+	switch (input.authority.kind) {
+		case "theme-v2": return {
+			kind: "interpretable-override",
+			fields,
+			authority: input.authority
+		};
+		case "advanced-detached": return {
+			kind: "advanced-detached",
+			fields,
+			authority: input.authority
+		};
+		case "legacy-raw": return {
+			kind: "unsupported-manual-review",
+			fields,
+			authority: input.authority
+		};
+		default: return assertNever$1(input.authority);
+	}
+}
+function canWriteThemeV2RuntimeFields(authority) {
+	return authority?.kind === "theme-v2";
+}
+function blockReasonForAuthority(authority) {
+	if (!authority) {
+		return "missing-theme-v2-authority";
+	}
+	switch (authority?.kind) {
+		case "advanced-detached": return "advanced-detached";
+		case "legacy-raw": return "legacy-raw";
+		default: return assertNever$1(authority);
+	}
+}
+/**
+* Replace every compiler-owned field on a block's content with a fresh compiled
+* set — the one primitive both writers of compiled output share.
+*
+* Replacement rather than merge is the whole point: a field the new
+* compilation does not produce must *go*, or a recompile onto a Look that asks
+* for no card leaves the old `_cardStyles` sitting there claiming a surface
+* nobody asked for. Every writer that discovers compiler ownership for itself
+* eventually forgets one of these names, so nobody does.
+*
+* Pure, and deliberately free of authority checks — those belong to the
+* persistence wrapper, not to the shape of the content.
+*/
+function withCompiledRuntimeStyleFields(input) {
+	const authored = Object.fromEntries(Object.entries(stripStaleTransitionStyleGroup(input.content)).filter(([fieldName]) => !themeV2CompilerOwnedFieldNames.includes(fieldName)));
+	return {
+		...authored,
+		...input.fields
+	};
+}
+/**
+* Persisted Theme V2 output is compile-at-write: once a block has Theme V2
+* authority, compiler-owned runtime fields are replaced in the same content
+* version. Preview-only compile-at-read callers should use compileBlockRuntimeFields
+* and avoid persisting these fields.
+*/
+function replaceCompiledRuntimeStyleFields(input) {
+	if (!canWriteThemeV2RuntimeFields(input.authority)) {
+		return {
+			kind: "blocked",
+			reason: blockReasonForAuthority(input.authority),
+			content: input.content
+		};
+	}
+	return {
+		kind: "applied",
+		content: withCompiledRuntimeStyleFields(input)
+	};
+}
+function uniqueBlockIds(values) {
+	return [...new Set(values)];
+}
+function collectPageStyleAuthorityBuckets(styleAuthorities) {
+	const themeV2BlockIds = [];
+	const legacyRawBlockIds = [];
+	const advancedDetachedBlockIds = [];
+	for (const entry of styleAuthorities) {
+		switch (entry.authority.kind) {
+			case "theme-v2":
+				themeV2BlockIds.push(entry.blockId);
+				break;
+			case "legacy-raw":
+				legacyRawBlockIds.push(entry.blockId);
+				break;
+			case "advanced-detached":
+				advancedDetachedBlockIds.push(entry.blockId);
+				break;
+			default: assertNever$1(entry.authority);
+		}
+	}
+	return {
+		themeV2BlockIds: uniqueBlockIds(themeV2BlockIds),
+		legacyRawBlockIds: uniqueBlockIds(legacyRawBlockIds),
+		advancedDetachedBlockIds: uniqueBlockIds(advancedDetachedBlockIds)
+	};
+}
+function summarizePageStyleAuthorities(state) {
+	const { themeV2BlockIds, legacyRawBlockIds, advancedDetachedBlockIds } = collectPageStyleAuthorityBuckets(state.styleAuthorities);
+	if (themeV2BlockIds.length === 0 && legacyRawBlockIds.length === 0 && advancedDetachedBlockIds.length === 0) {
+		return {
+			kind: "no-runtime-authority",
+			themeV2BlockIds: [],
+			legacyRawBlockIds: [],
+			advancedDetachedBlockIds: []
+		};
+	}
+	if (legacyRawBlockIds.length > 0) {
+		return {
+			kind: "manual-review-required",
+			themeV2BlockIds,
+			legacyRawBlockIds,
+			advancedDetachedBlockIds
+		};
+	}
+	if (themeV2BlockIds.length === 0) {
+		return {
+			kind: "advanced-detached-only",
+			themeV2BlockIds: [],
+			legacyRawBlockIds: [],
+			advancedDetachedBlockIds
+		};
+	}
+	if (advancedDetachedBlockIds.length > 0) {
+		return {
+			kind: "mixed-authority",
+			themeV2BlockIds,
+			legacyRawBlockIds: [],
+			advancedDetachedBlockIds
+		};
+	}
+	return {
+		kind: "theme-v2-only",
+		themeV2BlockIds,
+		legacyRawBlockIds: [],
+		advancedDetachedBlockIds: []
+	};
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageFlowPresets.ts
+/**
+* Must remain non-empty; downstream code indexes `[0]` as the documented default.
+*/
+const pageFlowPresets = [
+	{
+		id: asPageFlowPresetId("flow:quiet"),
+		label: "Quiet",
+		boundaryStrategy: "quiet",
+		defaultBoundaryOptionId: noneBoundaryOption.id
+	},
+	{
+		id: asPageFlowPresetId("flow:balanced"),
+		label: "Balanced",
+		boundaryStrategy: "balanced",
+		defaultBoundaryOptionId: softBoundaryOption.id
+	},
+	{
+		id: asPageFlowPresetId("flow:expressive"),
+		label: "Expressive",
+		boundaryStrategy: "expressive",
+		defaultBoundaryOptionId: spaciousBoundaryOption.id
+	}
+];
+/**
+* The break a join gets when nothing more specific applies. An unknown preset
+* id (a stale or policy-owned one) falls back to the first boundary option,
+* and `preset` is null so callers can tell the two apart.
+*/
+function pageFlowDefaultBoundary(pageFlowPresetId) {
+	const preset = pageFlowPresets.find((candidate$1) => candidate$1.id === pageFlowPresetId) ?? null;
+	return {
+		preset,
+		boundaryOptionId: preset?.defaultBoundaryOptionId ?? boundaryOptions[0].id
+	};
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/lookResolution.ts
+function blockAppearancePresetSupportsBlockKind(preset, blockKind) {
+	return preset.blockKinds.some((candidate$1) => candidate$1 === blockKind);
+}
+function preferredAppearanceTargetForBlockKind(blockKind) {
+	switch (blockKind) {
+		case "block.event-calendar":
+		case "block.event-listing": return "events";
+		default: return null;
+	}
+}
+function sortCompatibleBlockAppearancePresets(blockKind, options) {
+	const preferredTarget = preferredAppearanceTargetForBlockKind(blockKind);
+	if (!preferredTarget) {
+		return options;
+	}
+	return [...options].sort((left, right) => {
+		const leftPreset = appearancePresets.find((preset) => preset.id === left.id);
+		const rightPreset = appearancePresets.find((preset) => preset.id === right.id);
+		const leftPreferred = leftPreset?.target === preferredTarget;
+		const rightPreferred = rightPreset?.target === preferredTarget;
+		if (leftPreferred === rightPreferred) {
+			return 0;
+		}
+		return leftPreferred ? -1 : 1;
+	});
+}
+function blockAppearancePresetSupportsLayoutProfile(preset, profile, input = {}) {
+	const constraints = preset.constraints;
+	if (!constraints || !constraints.layoutFamilies && !constraints.layoutVariantKeys) {
+		return true;
+	}
+	if (!profile) {
+		return input.allowLayoutConstrainedPresetWithoutProfile ?? true;
+	}
+	return layoutProfileSupportsConstraints(profile, constraints);
+}
+function resolveBlockAppearancePreset(preset, layoutProfile = null) {
+	return {
+		id: asAppearancePresetId(preset.id),
+		label: preset.label,
+		design: resolveBlockAppearancePresetDesign(preset, layoutProfile)
+	};
+}
+function getCompatibleBlockAppearancePresets(input) {
+	const options = appearancePresets.flatMap((preset) => {
+		if (!blockAppearancePresetSupportsBlockKind(preset, input.blockKind) || !blockAppearancePresetSupportsLayoutProfile(preset, input.layoutProfile ?? null, { allowLayoutConstrainedPresetWithoutProfile: input.allowLayoutConstrainedPresetWithoutProfile })) {
+			return [];
+		}
+		return [resolveBlockAppearancePreset(preset, input.layoutProfile ?? null)];
+	});
+	const sortedOptions = sortCompatibleBlockAppearancePresets(input.blockKind, options);
+	const recommendedIds = input.siteStyle?.recommendedAppearancePresetIds ?? [];
+	if (recommendedIds.length === 0) {
+		return sortedOptions;
+	}
+	const recommended = recommendedIds.flatMap((presetId) => sortedOptions.find((option) => option.id === presetId) ?? []);
+	const alreadyIncludedIds = new Set(recommended.map((option) => option.id));
+	return [...recommended, ...sortedOptions.filter((option) => !alreadyIncludedIds.has(option.id))];
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/siteStyleBlockPolicies.ts
+const defaultPolicyPageFlowPresetId = asPageFlowPresetId("generated-default");
+const southWestTwerkSchoolSiteStyleId = asSiteStyleId("site-style:south-west-twerk-school");
+const heroBrandScrimFixedFrameLookId = asAppearancePresetId("hero-brand-scrim-fixed-frame");
+const classicHeroLayoutVariantKey = asLayoutVariantKey("classic");
+const microHeroLayoutVariantKey = asLayoutVariantKey("micro");
+const waveBoundaryOptionId = asBoundaryOptionId("break:wave");
+const registeredSiteStyleBlockPolicies = [{
+	siteStyleId: southWestTwerkSchoolSiteStyleId,
+	kind: "locked-look-and-layouts",
+	blockKind: "block.hero",
+	lookId: heroBrandScrimFixedFrameLookId,
+	allowedLayoutVariantKeys: [classicHeroLayoutVariantKey, microHeroLayoutVariantKey],
+	defaultLayoutVariantKey: classicHeroLayoutVariantKey,
+	defaultBoundaryAfter: {
+		optionId: waveBoundaryOptionId,
+		mode: "default-only"
+	},
+	customize: {
+		hideDisallowedLooks: true,
+		hideDisallowedLayouts: true
+	}
+}];
+function siteStyleBlockPolicies() {
+	return registeredSiteStyleBlockPolicies;
+}
+function buildInitialPolicyPageDesignIntent(siteStyleId) {
+	return {
+		schemaVersion: pageDesignIntentSchemaVersion,
+		siteStyleId,
+		pageFlowPresetId: defaultPolicyPageFlowPresetId,
+		blockLookPins: [],
+		boundaryPins: []
+	};
+}
+function deriveSiteStyleBlockPolicy(input) {
+	return registeredSiteStyleBlockPolicies.find((policy) => policy.siteStyleId === input.siteStyleId && policy.blockKind === input.blockKind) ?? { kind: "open" };
+}
+function isLayoutVariantAllowedByPolicy(policy, layoutVariantKey) {
+	switch (policy.kind) {
+		case "open": return true;
+		case "locked-look-and-layouts": return policy.allowedLayoutVariantKeys.includes(layoutVariantKey);
+		default: return assertNever$1(policy, "Unhandled site style block policy");
 	}
-	switch (input.authority.kind) {
-		case "theme-v2": return {
-			kind: "interpretable-override",
-			fields,
-			authority: input.authority
-		};
-		case "advanced-detached": return {
-			kind: "advanced-detached",
-			fields,
-			authority: input.authority
-		};
-		case "legacy-raw": return {
-			kind: "unsupported-manual-review",
-			fields,
-			authority: input.authority
-		};
-		default: return assertNever$1(input.authority);
+}
+function normalizeLayoutVariantForPolicy(policy, layoutVariantKey) {
+	switch (policy.kind) {
+		case "open": return layoutVariantKey ?? null;
+		case "locked-look-and-layouts": return layoutVariantKey && isLayoutVariantAllowedByPolicy(policy, layoutVariantKey) ? layoutVariantKey : policy.defaultLayoutVariantKey;
+		default: return assertNever$1(policy, "Unhandled site style block policy");
 	}
 }
-function canWriteThemeV2RuntimeFields(authority) {
-	return authority?.kind === "theme-v2";
+function filterLayoutProfilesForPolicy(policy, layoutProfiles) {
+	switch (policy.kind) {
+		case "open": return layoutProfiles;
+		case "locked-look-and-layouts": return layoutProfiles.filter((profile) => isLayoutVariantAllowedByPolicy(policy, profile.variantKey));
+		default: return assertNever$1(policy, "Unhandled site style block policy");
+	}
 }
-function blockReasonForAuthority(authority) {
-	if (!authority) {
-		return "missing-theme-v2-authority";
+function isLookAllowedByPolicy(policy, lookId) {
+	switch (policy.kind) {
+		case "open": return true;
+		case "locked-look-and-layouts": return lookId === policy.lookId;
+		default: return assertNever$1(policy, "Unhandled site style block policy");
 	}
-	switch (authority?.kind) {
-		case "advanced-detached": return "advanced-detached";
-		case "legacy-raw": return "legacy-raw";
-		default: return assertNever$1(authority);
+}
+function filterLookIdsForPolicy(policy, looks) {
+	switch (policy.kind) {
+		case "open": return looks;
+		case "locked-look-and-layouts": return looks.filter((look) => look.id === policy.lookId);
+		default: return assertNever$1(policy, "Unhandled site style block policy");
 	}
 }
-/**
-* Replace every compiler-owned field on a block's content with a fresh compiled
-* set — the one primitive both writers of compiled output share.
-*
-* Replacement rather than merge is the whole point: a field the new
-* compilation does not produce must *go*, or a recompile onto a Look that asks
-* for no card leaves the old `_cardStyles` sitting there claiming a surface
-* nobody asked for. Every writer that discovers compiler ownership for itself
-* eventually forgets one of these names, so nobody does.
-*
-* Pure, and deliberately free of authority checks — those belong to the
-* persistence wrapper, not to the shape of the content.
-*/
-function withCompiledRuntimeStyleFields(input) {
-	const authored = Object.fromEntries(Object.entries(input.content).filter(([fieldName]) => !themeV2CompilerOwnedFieldNames.includes(fieldName)));
+function requiredLookChoice(lookId) {
 	return {
-		...authored,
-		...input.fields
+		kind: "user-pinned",
+		value: lookId
 	};
 }
 /**
-* Persisted Theme V2 output is compile-at-write: once a block has Theme V2
-* authority, compiler-owned runtime fields are replaced in the same content
-* version. Preview-only compile-at-read callers should use compileBlockRuntimeFields
-* and avoid persisting these fields.
+* Writes the look pins a locked-look site style requires.
+*
+* Boundary pins are never written: a site style's default break after a block
+* is resolved at read time by `resolveJoinTreatment`, so it shows as a default
+* and follows later changes to the style (issue 1422). Pins already stored,
+* including ones an earlier version wrote on the style's behalf, are left as
+* they are.
 */
-function replaceCompiledRuntimeStyleFields(input) {
-	if (!canWriteThemeV2RuntimeFields(input.authority)) {
-		return {
-			kind: "blocked",
-			reason: blockReasonForAuthority(input.authority),
-			content: input.content
-		};
+function applySiteStyleBlockPoliciesToPageDesignIntent(intent, blocks) {
+	const policyLookPins = blocks.flatMap((block) => {
+		const policy = deriveSiteStyleBlockPolicy({
+			siteStyleId: intent.siteStyleId,
+			blockKind: block.blockKind
+		});
+		switch (policy.kind) {
+			case "open": return [];
+			case "locked-look-and-layouts": return [{
+				blockId: block.blockId,
+				blockKind: block.blockKind,
+				choice: requiredLookChoice(policy.lookId)
+			}];
+			default: return assertNever$1(policy, "Unhandled site style block policy");
+		}
+	});
+	if (policyLookPins.length === 0) {
+		return intent;
 	}
+	const policyPinBlockIds = new Set(policyLookPins.map((pin) => pin.blockId));
 	return {
-		kind: "applied",
-		content: withCompiledRuntimeStyleFields(input)
+		...intent,
+		blockLookPins: [...intent.blockLookPins.filter((pin) => !policyPinBlockIds.has(pin.blockId)), ...policyLookPins]
 	};
 }
-function uniqueBlockIds(values) {
-	return [...new Set(values)];
+function planBlockContentVariantPolicyUpdate(input) {
+	switch (input.policy.kind) {
+		case "open": return { kind: "unchanged" };
+		case "locked-look-and-layouts": {
+			const currentVariant = typeof input.content.variant === "string" ? asLayoutVariantKey(input.content.variant) : null;
+			return currentVariant && isLayoutVariantAllowedByPolicy(input.policy, currentVariant) ? { kind: "unchanged" } : {
+				kind: "set-variant",
+				variantKey: input.policy.defaultLayoutVariantKey
+			};
+		}
+		default: return assertNever$1(input.policy, "Unhandled site style block policy");
+	}
 }
-function collectPageStyleAuthorityBuckets(styleAuthorities) {
-	const themeV2BlockIds = [];
-	const legacyRawBlockIds = [];
-	const advancedDetachedBlockIds = [];
-	for (const entry of styleAuthorities) {
-		switch (entry.authority.kind) {
-			case "theme-v2":
-				themeV2BlockIds.push(entry.blockId);
-				break;
-			case "legacy-raw":
-				legacyRawBlockIds.push(entry.blockId);
-				break;
-			case "advanced-detached":
-				advancedDetachedBlockIds.push(entry.blockId);
-				break;
-			default: assertNever$1(entry.authority);
+function applyBlockContentVariantPolicy(input) {
+	const plan = planBlockContentVariantPolicyUpdate(input);
+	switch (plan.kind) {
+		case "unchanged": return input.content;
+		case "set-variant": return {
+			...input.content,
+			variant: plan.variantKey
+		};
+		default: return assertNever$1(plan, "Unhandled block content variant policy plan");
+	}
+}
+function auditPageDesignIntentPolicy(input) {
+	return input.blocks.flatMap((block) => {
+		const policy = deriveSiteStyleBlockPolicy({
+			siteStyleId: input.intent.siteStyleId,
+			blockKind: block.blockKind
+		});
+		switch (policy.kind) {
+			case "open": return [];
+			case "locked-look-and-layouts": {
+				const choice = resolvePageDesignBlockLookChoice(input.intent, block.blockId);
+				const lookIssue = choice.kind === "auto" ? {
+					kind: "missing-required-look-pin",
+					blockId: block.blockId,
+					blockKind: block.blockKind,
+					requiredLookId: policy.lookId
+				} : choice.value === policy.lookId ? null : {
+					kind: "unsupported-look-pin",
+					blockId: block.blockId,
+					blockKind: block.blockKind,
+					actualLookId: choice.value,
+					requiredLookId: policy.lookId
+				};
+				const layoutIssue = block.currentLayoutVariantKey && !isLayoutVariantAllowedByPolicy(policy, block.currentLayoutVariantKey) ? {
+					kind: "unsupported-layout-variant",
+					blockId: block.blockId,
+					blockKind: block.blockKind,
+					actualLayoutVariantKey: block.currentLayoutVariantKey,
+					defaultLayoutVariantKey: policy.defaultLayoutVariantKey
+				} : null;
+				const issues = [];
+				if (lookIssue) {
+					issues.push(lookIssue);
+				}
+				if (layoutIssue) {
+					issues.push(layoutIssue);
+				}
+				return issues;
+			}
+			default: return assertNever$1(policy, "Unhandled site style block policy");
+		}
+	});
+}
+function auditPageDesignAuthorityPolicy(input) {
+	if (input.intent) {
+		return auditPageDesignIntentPolicy({
+			intent: input.intent,
+			blocks: input.blocks
+		});
+	}
+	const policyBlockCount = input.blocks.filter((block) => deriveSiteStyleBlockPolicy({
+		siteStyleId: input.siteStyleId,
+		blockKind: block.blockKind
+	}).kind !== "open").length;
+	return policyBlockCount === 0 ? [] : [{
+		kind: "missing-page-design-authority",
+		siteStyleId: input.siteStyleId,
+		policyBlockCount
+	}];
+}
+function assertRegisteredSiteStyleBlockPoliciesAreValid() {
+	registeredSiteStyleBlockPolicies.forEach((policy) => {
+		if (!policy.allowedLayoutVariantKeys.includes(policy.defaultLayoutVariantKey)) {
+			throw new Error(`Site style block policy for ${policy.siteStyleId} ${policy.blockKind} has a default layout outside its allowed layouts.`);
+		}
+		const preset = appearancePresets.find((candidate$1) => candidate$1.id === policy.lookId && blockAppearancePresetSupportsBlockKind(candidate$1, policy.blockKind));
+		if (!preset) {
+			throw new Error(`Site style block policy for ${policy.siteStyleId} ${policy.blockKind} references an unavailable Look ${policy.lookId}.`);
 		}
+	});
+}
+function autoChoiceAllowedByPolicy(policy) {
+	switch (policy.kind) {
+		case "open": return autoDesignChoice();
+		case "locked-look-and-layouts": return requiredLookChoice(policy.lookId);
+		default: return assertNever$1(policy, "Unhandled site style block policy");
 	}
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/joinTreatment.ts
+/** Narrows any join (a resolved intent included) to its public, intent-only form. */
+function toPageRuntimeJoin(join) {
 	return {
-		themeV2BlockIds: uniqueBlockIds(themeV2BlockIds),
-		legacyRawBlockIds: uniqueBlockIds(legacyRawBlockIds),
-		advancedDetachedBlockIds: uniqueBlockIds(advancedDetachedBlockIds)
+		previousBlockId: join.previousBlockId,
+		nextBlockId: join.nextBlockId,
+		treatment: join.treatment
 	};
 }
-function summarizePageStyleAuthorities(state) {
-	const { themeV2BlockIds, legacyRawBlockIds, advancedDetachedBlockIds } = collectPageStyleAuthorityBuckets(state.styleAuthorities);
-	if (themeV2BlockIds.length === 0 && legacyRawBlockIds.length === 0 && advancedDetachedBlockIds.length === 0) {
+/**
+* The single rule set for which treatment a join gets. Candidates arrive in
+* priority order; the first supported one wins.
+*
+* - `none` ends the search and yields no join.
+* - An unsupported candidate (a legacy option id, or a structured treatment the
+*   catalogue lacks) falls through to the next one. When it was the user's
+*   pin, the pin is reported unsupported and the existing
+*   `pinned-boundary-option-unavailable` issue is raised.
+*/
+function resolveJoinTreatment(input) {
+	const boundaryId = makeBoundaryId(input.previousBlockId, input.nextBlockId);
+	const selection = selectCandidate(input.candidates);
+	const selectedOutcome = selection.kind === "selected" ? selection.outcome : { kind: "none" };
+	const pin = pinStatus(input.candidates, selectedOutcome);
+	const issues = pin.kind === "unsupported" ? [{
+		kind: "pinned-boundary-option-unavailable",
+		boundaryId,
+		presetId: pin.optionId,
+		feedback: "user-facing"
+	}] : [];
+	if (selection.kind === "exhausted") {
 		return {
-			kind: "no-runtime-authority",
-			themeV2BlockIds: [],
-			legacyRawBlockIds: [],
-			advancedDetachedBlockIds: []
+			join: null,
+			selectedSource: null,
+			pin,
+			issues
 		};
 	}
-	if (legacyRawBlockIds.length > 0) {
+	if (selection.outcome.kind === "none") {
 		return {
-			kind: "manual-review-required",
-			themeV2BlockIds,
-			legacyRawBlockIds,
-			advancedDetachedBlockIds
+			join: null,
+			selectedSource: selection.candidate.source,
+			pin,
+			issues
 		};
 	}
-	if (themeV2BlockIds.length === 0) {
-		return {
-			kind: "advanced-detached-only",
-			themeV2BlockIds: [],
-			legacyRawBlockIds: [],
-			advancedDetachedBlockIds
-		};
+	return {
+		selectedSource: selection.candidate.source,
+		join: {
+			boundaryId,
+			previousBlockId: input.previousBlockId,
+			nextBlockId: input.nextBlockId,
+			treatment: selection.outcome.treatment,
+			source: selection.candidate.source
+		},
+		pin,
+		issues
+	};
+}
+function pinStatus(candidates, selectedOutcome) {
+	const pinned = candidates.find((candidate$1) => candidate$1.source.kind === "user-pinned");
+	if (!pinned) return { kind: "none" };
+	const outcome = candidateOutcome(pinned.treatment);
+	return outcome.kind === "unsupported" ? {
+		kind: "unsupported",
+		optionId: outcome.boundaryOptionId ?? fallbackOptionId(selectedOutcome)
+	} : { kind: "supported" };
+}
+function selectCandidate(candidates) {
+	for (const candidate$1 of candidates) {
+		const outcome = candidateOutcome(candidate$1.treatment);
+		switch (outcome.kind) {
+			case "decorative":
+			case "none": return {
+				kind: "selected",
+				candidate: candidate$1,
+				outcome
+			};
+			case "unsupported": continue;
+			default: return assertNever$1(outcome, "Unhandled join candidate outcome");
+		}
 	}
-	if (advancedDetachedBlockIds.length > 0) {
-		return {
-			kind: "mixed-authority",
-			themeV2BlockIds,
-			legacyRawBlockIds: [],
-			advancedDetachedBlockIds
-		};
+	return { kind: "exhausted" };
+}
+function candidateOutcome(treatment) {
+	if (treatment.kind === "none") return { kind: "none" };
+	const intent = transitionIntentForTreatment(treatment);
+	return intent ? {
+		kind: "decorative",
+		treatment: intent
+	} : {
+		kind: "unsupported",
+		boundaryOptionId: boundaryOptionIdForTreatment(treatment)
+	};
+}
+/**
+* Matches the editor's existing issue payload: the pin's own option id when
+* it has one, otherwise the option the join fell back to.
+*/
+function fallbackOptionId(outcome) {
+	switch (outcome.kind) {
+		case "decorative": return boundaryOptionForTransitionIntent(outcome.treatment).id;
+		case "none": return noneBoundaryOption.id;
+		default: return assertNever$1(outcome, "Unhandled join fallback outcome");
 	}
+}
+/**
+* The page-design defaults for a join, in priority order: the site style's
+* default break after the previous block, then the page-flow default, which
+* is always last.
+*/
+function pageDesignDefaultJoinCandidates(input) {
+	const policy = deriveSiteStyleBlockPolicy({
+		siteStyleId: input.siteStyleId,
+		blockKind: input.previousBlockKind
+	});
+	const siteStyleDefault = policy.kind === "locked-look-and-layouts" && policy.defaultBoundaryAfter ? [{
+		source: {
+			kind: "site-style-default",
+			siteStyleId: input.siteStyleId
+		},
+		treatment: boundaryTreatmentForBoundaryOptionId(policy.defaultBoundaryAfter.optionId)
+	}] : [];
+	return [...siteStyleDefault, pageFlowDefaultJoinCandidate(input.pageFlowPresetId)];
+}
+/** The last-resort page-design default, also the source of a fully unsupported join. */
+function pageFlowDefaultJoinCandidate(pageFlowPresetId) {
+	const pageFlow = pageFlowDefaultBoundary(pageFlowPresetId);
 	return {
-		kind: "theme-v2-only",
-		themeV2BlockIds,
-		legacyRawBlockIds: [],
-		advancedDetachedBlockIds: []
+		source: {
+			kind: "page-flow-default",
+			pageFlowPresetId: pageFlow.preset?.id ?? null
+		},
+		treatment: boundaryTreatmentForBoundaryOptionId(pageFlow.boundaryOptionId)
 	};
 }
+/**
+* Page-design source adapter. Priority: the user's pin, then the defaults.
+* The pin is offered even when unsupported so the rule function can report it.
+*/
+function joinCandidatesFromPageDesign(intent, siteStyleId, previous, next) {
+	const choice = resolvePageDesignBoundaryChoice(intent, previous.blockId, next.blockId);
+	return [...choice.kind === "user-pinned" ? [{
+		source: { kind: "user-pinned" },
+		treatment: choice.value
+	}] : [], ...pageDesignDefaultJoinCandidates({
+		siteStyleId,
+		pageFlowPresetId: intent.pageFlowPresetId,
+		previousBlockKind: previous.blockKind
+	})];
+}
+/**
+* Generated-design source adapter. Mirrors today's materialisation: the
+* boundary intent's explicit choice, then the block design's explicit choice,
+* then the automatic default of no break.
+*/
+function joinCandidatesFromGeneratedIntent(block) {
+	return [
+		...explicitGeneratedCandidate(block.boundaryIntent.transitionAfter, "boundary-intent"),
+		...explicitGeneratedCandidate(block.design.transitionAfter, "block-design"),
+		{
+			source: {
+				kind: "generated",
+				origin: "automatic"
+			},
+			treatment: { kind: "none" }
+		}
+	];
+}
+function explicitGeneratedCandidate(choice, origin) {
+	return choice.kind === "explicit" ? [{
+		source: {
+			kind: "generated",
+			origin
+		},
+		treatment: treatmentForTransitionIntent(choice.value)
+	}] : [];
+}
+function treatmentForTransitionIntent(transition) {
+	return transition === "none" ? { kind: "none" } : transitionCatalogueEntryForIntent(transition).treatment;
+}
 
 //#endregion
 //#region ../theme-core/src/site-styles/imageSurfaceBackground.ts
@@ -22188,13 +23126,15 @@ const compiledRuntimeStyleFieldNames = [
 	"_contentCardStyles",
 	"_heroLayoutStyles",
 	"_cardStyles",
-	"_transitionStyles",
 	"blockLook",
-	"blockComposition",
-	"styleGroup"
+	"blockComposition"
 ];
+/**
+* Removes every compiler-owned field, plus a stale transition `styleGroup`.
+* An authored `styleGroup` is content and survives.
+*/
 function stripCompiledRuntimeStyleFields(content) {
-	return Object.fromEntries(Object.entries(content).filter(([fieldName]) => !compiledRuntimeStyleFieldNames.includes(fieldName)));
+	return Object.fromEntries(Object.entries(stripStaleTransitionStyleGroup(content)).filter(([fieldName]) => !compiledRuntimeStyleFieldNames.includes(fieldName)));
 }
 function surfaceResolutionContextFromPalette(palette) {
 	return {
@@ -22213,7 +23153,7 @@ function defineComponentRuntimeRules(rules) {
 }
 /**
 * Default design rules translate semantic page-level choices into the current
-* runtime's section background and transition style-group vocabulary.
+* runtime's section background vocabulary.
 */
 const defaultDesignRuntimeRules = defineDesignRuntimeRules({
 	sectionSurfaces: {
@@ -22248,8 +23188,7 @@ const defaultDesignRuntimeRules = defineDesignRuntimeRules({
 			color: "surface",
 			opacity: .88
 		}
-	},
-	transitionClassName: (transition, fromSurface, toSurface) => transition === "none" ? null : `site-style-transition-${transition}-from-${fromSurface}-to-${toSurface}`
+	}
 });
 /**
 * Default component rules translate frame and item-surface semantics into the
@@ -22475,26 +23414,6 @@ function compileCardStyles(input) {
 	if (!role) return undefined;
 	return cardStylesOverrideSchema.parse({ role });
 }
-function sectionAdjacencyForBlock(input) {
-	if (input.sectionAdjacency) {
-		return input.sectionAdjacency;
-	}
-	if (input.nextSectionSurface) {
-		return {
-			kind: "next-section",
-			surface: input.nextSectionSurface
-		};
-	}
-	return { kind: "page-end" };
-}
-function transitionTargetSurfaceForAdjacency(adjacency) {
-	switch (adjacency.kind) {
-		case "next-section":
-		case "terminal-surface": return adjacency.surface;
-		case "page-end": return null;
-		default: return assertNever$1(adjacency);
-	}
-}
 function resolveEyebrowTreatmentForRuntime(block, rules) {
 	return block.eyebrowTreatment ?? rules.defaultEyebrowTreatment ?? block.appliedEyebrowTreatment;
 }
@@ -22512,19 +23431,6 @@ function compileBlockRuntimeFields(input) {
 	});
 	const shouldSuppressContainerFrame = shouldMoveFrameToHeroContentCard(input.block);
 	const cardStyles = compileCardStyles({ cardRole: input.block.appliedCardRole });
-	const transitionTargetSurface = transitionTargetSurfaceForAdjacency(sectionAdjacencyForBlock(input));
-	const transitionClassName = transitionTargetSurface ? designRules.transitionClassName(input.block.appliedTransitionAfter, visualSectionSurface, transitionTargetSurface) : null;
-	const transitionRuntime = transitionTargetSurface && transitionClassName ? compileTransitionRuntime({
-		treatment: input.block.appliedTransitionAfter,
-		from: {
-			kind: "surface",
-			surface: visualSectionSurface
-		},
-		to: {
-			kind: "surface",
-			surface: transitionTargetSurface
-		}
-	}) : null;
 	return {
 		blockId: input.block.blockId,
 		visualSectionSurface,
@@ -22549,72 +23455,10 @@ function compileBlockRuntimeFields(input) {
 			...cardStyles ? { _cardStyles: cardStyles } : {},
 			...heroRuntimeFields,
 			...input.block.appearancePresetId ? { blockLook: input.block.appearancePresetId } : {},
-			...input.block.appliedComposition ? { blockComposition: input.block.appliedComposition } : {},
-			...transitionRuntime ? { _transitionStyles: transitionRuntime } : {},
-			...transitionClassName ? { styleGroup: transitionClassName } : {}
-		}
-	};
-}
-function compileTransitionRuntime(input) {
-	return {
-		treatment: input.treatment,
-		from: input.from,
-		to: input.to,
-		cssVars: {
-			from: input.from.kind === "surface" && input.from.surface === "hero-image" ? "transparent" : transitionEndpointCssValue(input.from),
-			to: transitionEndpointCssValue(input.to)
-		}
-	};
-}
-function compileBoundaryRuntime(input) {
-	const rules = input.rules ?? defaultDesignRuntimeRules;
-	const styleGroup = rules.transitionClassName(input.treatment, input.fromSurface, input.toSurface);
-	if (!styleGroup) return null;
-	const metrics = boundaryRuntimeMetricsForTransition(input.treatment);
-	if (!metrics) return null;
-	const transition = compileTransitionRuntime({
-		treatment: input.treatment,
-		from: {
-			kind: "surface",
-			surface: input.fromSurface
-		},
-		to: {
-			kind: "surface",
-			surface: input.toSurface
+			...input.block.appliedComposition ? { blockComposition: input.block.appliedComposition } : {}
 		}
-	});
-	return {
-		boundaryId: input.boundaryId,
-		previousBlockId: input.previousBlockId,
-		nextBlockId: input.nextBlockId,
-		treatment: transition.treatment,
-		metrics,
-		from: transition.from,
-		to: transition.to,
-		cssVars: transition.cssVars,
-		styleGroup
 	};
 }
-function transitionEndpointCssValue(endpoint) {
-	switch (endpoint.kind) {
-		case "color-token": return themeColorTokenCssValue(endpoint.token);
-		case "surface": return themeColorTokenCssValue(tokenForTransitionSurface(endpoint.surface));
-		default: return assertNever$1(endpoint);
-	}
-}
-function tokenForTransitionSurface(surface$1) {
-	switch (surface$1) {
-		case "base":
-		case "hero-image": return "background";
-		case "muted-band": return "muted";
-		case "accent-band": return "accent";
-		case "brand-depth-band": return "primary-800";
-		default: return assertNever$1(surface$1);
-	}
-}
-function themeColorTokenCssValue(token) {
-	return `rgb(var(--tb-${token}))`;
-}
 /**
 * Compiles block runtime fields and writes them into content only when Theme V2
 * owns that block's runtime-style fields.
@@ -22627,58 +23471,30 @@ function compileBlockRuntimeFieldsIntoContent(input) {
 		authority: input.authority
 	});
 }
-/** Compiles a resolved page plan into legacy runtime fields for each resolved block. */
+/**
+* Compiles a resolved page plan into legacy runtime fields for each resolved
+* block, plus the public runtime joins between them.
+*
+* Joins come from `resolveJoinTreatment`; plans no longer carry a treatment.
+* Only joins whose two blocks were compiled are kept, and they leave as intent
+* only: the blocks renderer composes each one from final content after
+* omission, including whether it draws at all (issue 1422).
+*/
 function compilePageRuntimeFields(input) {
-	const visualSurfaces = input.resolved.blocks.map(resolveVisualSectionSurfaceForBlock);
-	const terminalSectionAdjacency = input.terminalSectionAdjacency ?? { kind: "page-end" };
-	const designRules = input.designRules ?? defaultDesignRuntimeRules;
-	const blocks = input.resolved.blocks.map((block, index) => {
-		const nextSurface = visualSurfaces[index + 1];
-		const compiled = compileBlockRuntimeFields({
-			block,
-			surfaceResolutionContext: input.surfaceResolutionContext,
-			designRules: input.designRules,
-			componentRules: input.componentRules,
-			sectionSpacing: input.sectionSpacing,
-			sectionAdjacency: nextSurface ? {
-				kind: "next-section",
-				surface: nextSurface
-			} : terminalSectionAdjacency
-		});
-		return {
-			...compiled,
-			fields: stripPageLevelTransitionFields(compiled.fields)
-		};
-	});
-	const boundaries = input.resolved.blocks.flatMap((block, index) => {
-		const nextBlock = input.resolved.blocks[index + 1];
-		const fromSurface = visualSurfaces[index];
-		const toSurface = visualSurfaces[index + 1];
-		if (!nextBlock || !fromSurface || !toSurface) {
-			return [];
-		}
-		const boundary = compileBoundaryRuntime({
-			boundaryId: `boundary:${block.blockId}:${nextBlock.blockId}`,
-			previousBlockId: block.blockId,
-			nextBlockId: nextBlock.blockId,
-			treatment: block.appliedTransitionAfter,
-			fromSurface,
-			toSurface,
-			rules: designRules
-		});
-		return boundary ? [boundary] : [];
-	});
+	const blocks = input.resolved.blocks.map((block) => compileBlockRuntimeFields({
+		block,
+		surfaceResolutionContext: input.surfaceResolutionContext,
+		designRules: input.designRules,
+		componentRules: input.componentRules,
+		sectionSpacing: input.sectionSpacing
+	}));
+	const compiledIds = new Set(blocks.map((block) => block.blockId));
+	const joins = input.joins.filter((join) => compiledIds.has(join.previousBlockId) && compiledIds.has(join.nextBlockId)).map(toPageRuntimeJoin);
 	return {
 		blocks,
-		boundaries
+		joins
 	};
 }
-function stripPageLevelTransitionFields(fields) {
-	const { _transitionStyles, styleGroup, ...rest } = fields;
-	void _transitionStyles;
-	void styleGroup;
-	return rest;
-}
 const paletteByRecipe = {
 	"brand-led": [
 		{
@@ -24738,371 +25554,173 @@ const curatedSiteStylesById = new Map(curatedSiteStyles.map((style) => [style.id
 * only to the compiler.
 */
 function headerStyleRecipeForTheme(theme, styleId) {
-	const siteStyle = theme?.siteStyleId ? getCuratedSiteStyle(theme.siteStyleId) : null;
-	return resolveHeaderStyleRecipe(siteStyle, styleId);
-}
-function getCuratedSiteStyle(id) {
-	return curatedSiteStylesById.get(id) ?? null;
-}
-function designRuntimeRulesForSiteStyle(siteStyle) {
-	return siteStyle?.designRuntimeRules ?? defaultDesignRuntimeRules;
-}
-function designRuntimeRulesForTheme(theme) {
-	const siteStyleId = theme?.siteStyleId;
-	if (!siteStyleId) return defaultDesignRuntimeRules;
-	return designRuntimeRulesForSiteStyle(curatedSiteStylesById.get(asSiteStyleId(siteStyleId)) ?? null);
-}
-function componentRuntimeRulesForSiteStyle(siteStyle) {
-	return siteStyle?.componentRuntimeRules ?? defaultComponentRuntimeRules;
-}
-function componentRuntimeRulesForTheme(theme) {
-	const siteStyleId = theme?.siteStyleId;
-	if (!siteStyleId) return defaultComponentRuntimeRules;
-	return componentRuntimeRulesForSiteStyle(curatedSiteStylesById.get(asSiteStyleId(siteStyleId)) ?? null);
-}
-function defaultBlockVariantForSiteStyle(siteStyle, blockKind) {
-	return siteStyle.defaultBlockVariants?.[blockKind] ?? null;
-}
-
-//#endregion
-//#region ../theme-core/src/site-styles/pageDesignEditorCapabilities.ts
-function cardRoleCapabilityOf(capability) {
-	return capability?.kind === "designed" ? capability.cardRoles : "unsupported";
-}
-function backgroundSupportForCapability(capability) {
-	if (capability === null) {
-		return {
-			kind: "unsupported",
-			reason: "missing-design-capability"
-		};
-	}
-	if (capability.kind === "not-designed") {
-		return {
-			kind: "unsupported",
-			reason: capability.reason
-		};
-	}
-	return capability.sectionSurfaces === "supported" ? {
-		kind: "supported",
-		richBackgrounds: capability.richBackgrounds ?? "unsupported"
-	} : {
-		kind: "unsupported",
-		reason: "section-surfaces-unsupported"
-	};
-}
-/**
-* The capability-derived half of a block's editor read model, in one call so
-* the read-model builder does not grow a projection per axis.
-*/
-function capabilitySupportFor(capability) {
-	return {
-		backgroundSupport: backgroundSupportForCapability(capability),
-		cardRoles: cardRoleCapabilityOf(capability)
-	};
-}
-
-//#endregion
-//#region ../theme-core/src/site-styles/lookResolution.ts
-function blockAppearancePresetSupportsBlockKind(preset, blockKind) {
-	return preset.blockKinds.some((candidate$1) => candidate$1 === blockKind);
-}
-function preferredAppearanceTargetForBlockKind(blockKind) {
-	switch (blockKind) {
-		case "block.event-calendar":
-		case "block.event-listing": return "events";
-		default: return null;
-	}
-}
-function sortCompatibleBlockAppearancePresets(blockKind, options) {
-	const preferredTarget = preferredAppearanceTargetForBlockKind(blockKind);
-	if (!preferredTarget) {
-		return options;
-	}
-	return [...options].sort((left, right) => {
-		const leftPreset = appearancePresets.find((preset) => preset.id === left.id);
-		const rightPreset = appearancePresets.find((preset) => preset.id === right.id);
-		const leftPreferred = leftPreset?.target === preferredTarget;
-		const rightPreferred = rightPreset?.target === preferredTarget;
-		if (leftPreferred === rightPreferred) {
-			return 0;
-		}
-		return leftPreferred ? -1 : 1;
-	});
-}
-function blockAppearancePresetSupportsLayoutProfile(preset, profile, input = {}) {
-	const constraints = preset.constraints;
-	if (!constraints || !constraints.layoutFamilies && !constraints.layoutVariantKeys) {
-		return true;
-	}
-	if (!profile) {
-		return input.allowLayoutConstrainedPresetWithoutProfile ?? true;
-	}
-	return layoutProfileSupportsConstraints(profile, constraints);
-}
-function resolveBlockAppearancePreset(preset, layoutProfile = null) {
-	return {
-		id: asAppearancePresetId(preset.id),
-		label: preset.label,
-		design: resolveBlockAppearancePresetDesign(preset, layoutProfile)
-	};
-}
-function getCompatibleBlockAppearancePresets(input) {
-	const options = appearancePresets.flatMap((preset) => {
-		if (!blockAppearancePresetSupportsBlockKind(preset, input.blockKind) || !blockAppearancePresetSupportsLayoutProfile(preset, input.layoutProfile ?? null, { allowLayoutConstrainedPresetWithoutProfile: input.allowLayoutConstrainedPresetWithoutProfile })) {
-			return [];
-		}
-		return [resolveBlockAppearancePreset(preset, input.layoutProfile ?? null)];
-	});
-	const sortedOptions = sortCompatibleBlockAppearancePresets(input.blockKind, options);
-	const recommendedIds = input.siteStyle?.recommendedAppearancePresetIds ?? [];
-	if (recommendedIds.length === 0) {
-		return sortedOptions;
-	}
-	const recommended = recommendedIds.flatMap((presetId) => sortedOptions.find((option) => option.id === presetId) ?? []);
-	const alreadyIncludedIds = new Set(recommended.map((option) => option.id));
-	return [...recommended, ...sortedOptions.filter((option) => !alreadyIncludedIds.has(option.id))];
+	const siteStyle = theme?.siteStyleId ? getCuratedSiteStyle(theme.siteStyleId) : null;
+	return resolveHeaderStyleRecipe(siteStyle, styleId);
 }
-
-//#endregion
-//#region ../theme-core/src/site-styles/siteStyleBlockPolicies.ts
-const defaultPolicyPageFlowPresetId = asPageFlowPresetId("generated-default");
-const southWestTwerkSchoolSiteStyleId = asSiteStyleId("site-style:south-west-twerk-school");
-const heroBrandScrimFixedFrameLookId = asAppearancePresetId("hero-brand-scrim-fixed-frame");
-const classicHeroLayoutVariantKey = asLayoutVariantKey("classic");
-const microHeroLayoutVariantKey = asLayoutVariantKey("micro");
-const waveBoundaryOptionId = asBoundaryOptionId("break:wave");
-const registeredSiteStyleBlockPolicies = [{
-	siteStyleId: southWestTwerkSchoolSiteStyleId,
-	kind: "locked-look-and-layouts",
-	blockKind: "block.hero",
-	lookId: heroBrandScrimFixedFrameLookId,
-	allowedLayoutVariantKeys: [classicHeroLayoutVariantKey, microHeroLayoutVariantKey],
-	defaultLayoutVariantKey: classicHeroLayoutVariantKey,
-	defaultBoundaryAfter: {
-		optionId: waveBoundaryOptionId,
-		mode: "default-only"
-	},
-	customize: {
-		hideDisallowedLooks: true,
-		hideDisallowedLayouts: true
-	}
-}];
-function siteStyleBlockPolicies() {
-	return registeredSiteStyleBlockPolicies;
+function getCuratedSiteStyle(id) {
+	return curatedSiteStylesById.get(id) ?? null;
 }
-function buildInitialPolicyPageDesignIntent(siteStyleId) {
-	return {
-		schemaVersion: pageDesignIntentSchemaVersion,
-		siteStyleId,
-		pageFlowPresetId: defaultPolicyPageFlowPresetId,
-		blockLookPins: [],
-		boundaryPins: []
-	};
+function designRuntimeRulesForSiteStyle(siteStyle) {
+	return siteStyle?.designRuntimeRules ?? defaultDesignRuntimeRules;
 }
-function hasPolicyForBlocks(input) {
-	return input.blocks.some((block) => deriveSiteStyleBlockPolicy({
-		siteStyleId: input.siteStyleId,
-		blockKind: block.blockKind
-	}).kind !== "open");
+function designRuntimeRulesForTheme(theme) {
+	const siteStyleId = theme?.siteStyleId;
+	if (!siteStyleId) return defaultDesignRuntimeRules;
+	return designRuntimeRulesForSiteStyle(curatedSiteStylesById.get(asSiteStyleId(siteStyleId)) ?? null);
 }
-function deriveSiteStyleBlockPolicy(input) {
-	return registeredSiteStyleBlockPolicies.find((policy) => policy.siteStyleId === input.siteStyleId && policy.blockKind === input.blockKind) ?? { kind: "open" };
+function componentRuntimeRulesForSiteStyle(siteStyle) {
+	return siteStyle?.componentRuntimeRules ?? defaultComponentRuntimeRules;
 }
-function isLayoutVariantAllowedByPolicy(policy, layoutVariantKey) {
-	switch (policy.kind) {
-		case "open": return true;
-		case "locked-look-and-layouts": return policy.allowedLayoutVariantKeys.includes(layoutVariantKey);
-		default: return assertNever$1(policy, "Unhandled site style block policy");
-	}
+function componentRuntimeRulesForTheme(theme) {
+	const siteStyleId = theme?.siteStyleId;
+	if (!siteStyleId) return defaultComponentRuntimeRules;
+	return componentRuntimeRulesForSiteStyle(curatedSiteStylesById.get(asSiteStyleId(siteStyleId)) ?? null);
 }
-function normalizeLayoutVariantForPolicy(policy, layoutVariantKey) {
-	switch (policy.kind) {
-		case "open": return layoutVariantKey ?? null;
-		case "locked-look-and-layouts": return layoutVariantKey && isLayoutVariantAllowedByPolicy(policy, layoutVariantKey) ? layoutVariantKey : policy.defaultLayoutVariantKey;
-		default: return assertNever$1(policy, "Unhandled site style block policy");
-	}
+function defaultBlockVariantForSiteStyle(siteStyle, blockKind) {
+	return siteStyle.defaultBlockVariants?.[blockKind] ?? null;
 }
-function filterLayoutProfilesForPolicy(policy, layoutProfiles) {
-	switch (policy.kind) {
-		case "open": return layoutProfiles;
-		case "locked-look-and-layouts": return layoutProfiles.filter((profile) => isLayoutVariantAllowedByPolicy(policy, profile.variantKey));
-		default: return assertNever$1(policy, "Unhandled site style block policy");
-	}
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageDesignEditorCapabilities.ts
+function cardRoleCapabilityOf(capability) {
+	return capability?.kind === "designed" ? capability.cardRoles : "unsupported";
 }
-function isLookAllowedByPolicy(policy, lookId) {
-	switch (policy.kind) {
-		case "open": return true;
-		case "locked-look-and-layouts": return lookId === policy.lookId;
-		default: return assertNever$1(policy, "Unhandled site style block policy");
+function backgroundSupportForCapability(capability) {
+	if (capability === null) {
+		return {
+			kind: "unsupported",
+			reason: "missing-design-capability"
+		};
 	}
-}
-function filterLookIdsForPolicy(policy, looks) {
-	switch (policy.kind) {
-		case "open": return looks;
-		case "locked-look-and-layouts": return looks.filter((look) => look.id === policy.lookId);
-		default: return assertNever$1(policy, "Unhandled site style block policy");
+	if (capability.kind === "not-designed") {
+		return {
+			kind: "unsupported",
+			reason: capability.reason
+		};
 	}
-}
-function requiredLookChoice(lookId) {
-	return {
-		kind: "user-pinned",
-		value: lookId
+	return capability.sectionSurfaces === "supported" ? {
+		kind: "supported",
+		richBackgrounds: capability.richBackgrounds ?? "unsupported"
+	} : {
+		kind: "unsupported",
+		reason: "section-surfaces-unsupported"
 	};
 }
-function requiredBoundaryChoice(optionId) {
+/**
+* The capability-derived half of a block's editor read model, in one call so
+* the read-model builder does not grow a projection per axis.
+*/
+function capabilitySupportFor(capability) {
 	return {
-		kind: "user-pinned",
-		value: boundaryTreatmentForBoundaryOptionId(optionId)
+		backgroundSupport: backgroundSupportForCapability(capability),
+		cardRoles: cardRoleCapabilityOf(capability)
 	};
 }
-function applySiteStyleBlockPoliciesToPageDesignIntent(intent, blocks) {
-	const policyLookPins = blocks.flatMap((block) => {
-		const policy = deriveSiteStyleBlockPolicy({
-			siteStyleId: intent.siteStyleId,
-			blockKind: block.blockKind
-		});
-		switch (policy.kind) {
-			case "open": return [];
-			case "locked-look-and-layouts": return [{
-				blockId: block.blockId,
-				blockKind: block.blockKind,
-				choice: requiredLookChoice(policy.lookId)
-			}];
-			default: return assertNever$1(policy, "Unhandled site style block policy");
-		}
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageDesignEditorBoundaries.ts
+function buildBoundaryReadModels(input) {
+	return input.blocks.flatMap((previousBlock, index) => {
+		const nextBlock = input.blocks[index + 1];
+		return nextBlock ? [buildBoundaryReadModel({
+			siteStyleId: input.siteStyleId,
+			pageFlowPresetId: input.intent.pageFlowPresetId,
+			pin: resolvePageDesignBoundaryChoice(input.intent, previousBlock.blockId, nextBlock.blockId),
+			previousBlock,
+			nextBlock
+		})] : [];
 	});
-	const policyBoundaryPins = blocks.flatMap((block, index) => {
-		const nextBlock = blocks[index + 1];
-		if (!nextBlock) {
-			return [];
-		}
-		const policy = deriveSiteStyleBlockPolicy({
-			siteStyleId: intent.siteStyleId,
-			blockKind: block.blockKind
-		});
-		switch (policy.kind) {
-			case "open": return [];
-			case "locked-look-and-layouts": {
-				const defaultBoundary = policy.defaultBoundaryAfter;
-				if (!defaultBoundary) {
-					return [];
-				}
-				const currentChoice = resolvePageDesignBoundaryChoice(intent, block.blockId, nextBlock.blockId);
-				return currentChoice.kind === "auto" ? [buildBoundaryPin(block.blockId, nextBlock.blockId, requiredBoundaryChoice(defaultBoundary.optionId))] : [];
-			}
-			default: return assertNever$1(policy, "Unhandled site style block policy");
-		}
+}
+function buildBoundaryReadModel(input) {
+	const previousBlockId = input.previousBlock.blockId;
+	const nextBlockId = input.nextBlock.blockId;
+	const defaults = pageDesignDefaultJoinCandidates({
+		siteStyleId: input.siteStyleId,
+		pageFlowPresetId: input.pageFlowPresetId,
+		previousBlockKind: input.previousBlock.blockKind
 	});
-	if (policyLookPins.length === 0 && policyBoundaryPins.length === 0) {
-		return intent;
-	}
-	const policyPinBlockIds = new Set(policyLookPins.map((pin) => pin.blockId));
+	const projection = input.pin.kind === "user-pinned" ? pinnedBreakChoice(resolveJoinTreatment({
+		candidates: [{
+			source: { kind: "user-pinned" },
+			treatment: input.pin.value
+		}, ...defaults],
+		previousBlockId,
+		nextBlockId
+	})) : autoBreakChoice(resolveJoinTreatment({
+		candidates: defaults,
+		previousBlockId,
+		nextBlockId
+	}), input.pageFlowPresetId);
 	return {
-		...intent,
-		blockLookPins: [...intent.blockLookPins.filter((pin) => !policyPinBlockIds.has(pin.blockId)), ...policyLookPins],
-		boundaryPins: [...intent.boundaryPins, ...policyBoundaryPins]
+		boundary: {
+			boundaryId: makeBoundaryId(previousBlockId, nextBlockId),
+			previousBlockId,
+			nextBlockId,
+			breakChoice: projection.breakChoice,
+			availableBreaks: boundaryOptions
+		},
+		issues: projection.issues
 	};
 }
-function planBlockContentVariantPolicyUpdate(input) {
-	switch (input.policy.kind) {
-		case "open": return { kind: "unchanged" };
-		case "locked-look-and-layouts": {
-			const currentVariant = typeof input.content.variant === "string" ? asLayoutVariantKey(input.content.variant) : null;
-			return currentVariant && isLayoutVariantAllowedByPolicy(input.policy, currentVariant) ? { kind: "unchanged" } : {
-				kind: "set-variant",
-				variantKey: input.policy.defaultLayoutVariantKey
-			};
-		}
-		default: return assertNever$1(input.policy, "Unhandled site style block policy");
-	}
-}
-function applyBlockContentVariantPolicy(input) {
-	const plan = planBlockContentVariantPolicyUpdate(input);
-	switch (plan.kind) {
-		case "unchanged": return input.content;
-		case "set-variant": return {
-			...input.content,
-			variant: plan.variantKey
-		};
-		default: return assertNever$1(plan, "Unhandled block content variant policy plan");
-	}
-}
-function auditPageDesignIntentPolicy(input) {
-	return input.blocks.flatMap((block) => {
-		const policy = deriveSiteStyleBlockPolicy({
-			siteStyleId: input.intent.siteStyleId,
-			blockKind: block.blockKind
-		});
-		switch (policy.kind) {
-			case "open": return [];
-			case "locked-look-and-layouts": {
-				const choice = resolvePageDesignBlockLookChoice(input.intent, block.blockId);
-				const lookIssue = choice.kind === "auto" ? {
-					kind: "missing-required-look-pin",
-					blockId: block.blockId,
-					blockKind: block.blockKind,
-					requiredLookId: policy.lookId
-				} : choice.value === policy.lookId ? null : {
-					kind: "unsupported-look-pin",
-					blockId: block.blockId,
-					blockKind: block.blockKind,
-					actualLookId: choice.value,
-					requiredLookId: policy.lookId
-				};
-				const layoutIssue = block.currentLayoutVariantKey && !isLayoutVariantAllowedByPolicy(policy, block.currentLayoutVariantKey) ? {
-					kind: "unsupported-layout-variant",
-					blockId: block.blockId,
-					blockKind: block.blockKind,
-					actualLayoutVariantKey: block.currentLayoutVariantKey,
-					defaultLayoutVariantKey: policy.defaultLayoutVariantKey
-				} : null;
-				const issues = [];
-				if (lookIssue) {
-					issues.push(lookIssue);
-				}
-				if (layoutIssue) {
-					issues.push(layoutIssue);
-				}
-				return issues;
-			}
-			default: return assertNever$1(policy, "Unhandled site style block policy");
-		}
-	});
-}
-function auditPageDesignAuthorityPolicy(input) {
-	if (input.intent) {
-		return auditPageDesignIntentPolicy({
-			intent: input.intent,
-			blocks: input.blocks
-		});
-	}
-	const policyBlockCount = input.blocks.filter((block) => deriveSiteStyleBlockPolicy({
-		siteStyleId: input.siteStyleId,
-		blockKind: block.blockKind
-	}).kind !== "open").length;
-	return policyBlockCount === 0 ? [] : [{
-		kind: "missing-page-design-authority",
-		siteStyleId: input.siteStyleId,
-		policyBlockCount
-	}];
-}
-function assertRegisteredSiteStyleBlockPoliciesAreValid() {
-	registeredSiteStyleBlockPolicies.forEach((policy) => {
-		if (!policy.allowedLayoutVariantKeys.includes(policy.defaultLayoutVariantKey)) {
-			throw new Error(`Site style block policy for ${policy.siteStyleId} ${policy.blockKind} has a default layout outside its allowed layouts.`);
-		}
-		const preset = appearancePresets.find((candidate$1) => candidate$1.id === policy.lookId && blockAppearancePresetSupportsBlockKind(candidate$1, policy.blockKind));
-		if (!preset) {
-			throw new Error(`Site style block policy for ${policy.siteStyleId} ${policy.blockKind} references an unavailable Look ${policy.lookId}.`);
-		}
-	});
+function autoBreakChoice(resolution, pageFlowPresetId) {
+	return {
+		breakChoice: {
+			kind: "auto",
+			source: resolution.selectedSource ?? pageFlowDefaultJoinCandidate(pageFlowPresetId).source,
+			effectiveValue: effectiveBreak(resolution)
+		},
+		issues: resolution.issues
+	};
 }
-function autoChoiceAllowedByPolicy(policy) {
-	switch (policy.kind) {
-		case "open": return autoDesignChoice();
-		case "locked-look-and-layouts": return requiredLookChoice(policy.lookId);
-		default: return assertNever$1(policy, "Unhandled site style block policy");
+function pinnedBreakChoice(resolution) {
+	const effectiveValue = effectiveBreak(resolution);
+	switch (resolution.pin.kind) {
+		case "unsupported": return {
+			breakChoice: {
+				kind: "user-pinned",
+				value: resolution.pin.optionId,
+				status: "unsupported",
+				effectiveValue
+			},
+			issues: resolution.issues
+		};
+		case "supported":
+		case "none": return {
+			breakChoice: {
+				kind: "user-pinned",
+				value: effectiveValue ?? noneBoundaryOption.id,
+				status: "supported",
+				effectiveValue
+			},
+			issues: resolution.issues
+		};
+		default: return assertNever$1(resolution.pin, "Unhandled join pin status");
+	}
+}
+/** The effective break as the option the editor shows; null when nothing was usable. */
+function effectiveBreak(resolution) {
+	if (resolution.join) {
+		return boundaryOptionForTransitionIntent(resolution.join.treatment).id;
 	}
+	return resolution.selectedSource ? noneBoundaryOption.id : null;
+}
+/**
+* Re-resolves one boundary of an editor model for a changed break choice,
+* through the same rules the model was built with. The preview uses it for
+* optimistic updates, so a reset lands on whichever default the rules pick
+* (site style or Page Flow). Null when either block is not in the model.
+*/
+function resolvePageDesignEditorBoundaryForChoice(input) {
+	const previousBlock = input.editorModel.blocks.find((block) => block.blockId === input.previousBlockId);
+	const nextBlock = input.editorModel.blocks.find((block) => block.blockId === input.nextBlockId);
+	if (!previousBlock || !nextBlock) return null;
+	return buildBoundaryReadModel({
+		siteStyleId: input.editorModel.siteStyleId,
+		pageFlowPresetId: input.editorModel.pageFlow.value,
+		pin: input.choice,
+		previousBlock,
+		nextBlock
+	}).boundary;
 }
 
 //#endregion
@@ -25129,29 +25747,6 @@ const backgroundImagePromotedFieldPath = "_sectionStyles.background.image";
 * Look/Layout semantics support them.
 */
 const normalEditorCuratedPromotedFieldPaths = [backgroundImagePromotedFieldPath];
-/**
-* Must remain non-empty; downstream code indexes `[0]` as the documented default.
-*/
-const pageFlowPresets = [
-	{
-		id: asPageFlowPresetId("flow:quiet"),
-		label: "Quiet",
-		boundaryStrategy: "quiet",
-		defaultBoundaryOptionId: noneBoundaryOption.id
-	},
-	{
-		id: asPageFlowPresetId("flow:balanced"),
-		label: "Balanced",
-		boundaryStrategy: "balanced",
-		defaultBoundaryOptionId: softBoundaryOption.id
-	},
-	{
-		id: asPageFlowPresetId("flow:expressive"),
-		label: "Expressive",
-		boundaryStrategy: "expressive",
-		defaultBoundaryOptionId: spaciousBoundaryOption.id
-	}
-];
 function buildPageDesignEditorReadModel(input) {
 	const defaultPageFlow = pageFlowPresets[0];
 	const currentPageFlow = pageFlowPresets.find((preset) => preset.id === input.intent.pageFlowPresetId) ?? null;
@@ -25239,8 +25834,8 @@ function buildPageDesignEditorReadModel(input) {
 		};
 	});
 	const boundaryResults = buildBoundaryReadModels({
-		intent: input.intent,
-		blocks: input.blocks
+		...input,
+		blocks: blockResults.map((result) => result.block)
 	});
 	return {
 		siteStyleId: input.siteStyleId,
@@ -25484,62 +26079,6 @@ function editorChoiceForLook(input) {
 		})
 	});
 }
-function buildBoundaryReadModels(input) {
-	return input.blocks.flatMap((previous, index) => {
-		const next = input.blocks[index + 1];
-		if (!next) {
-			return [];
-		}
-		const boundaryId = makeBoundaryId(previous.blockId, next.blockId);
-		const choice = resolvePageDesignBoundaryChoice(input.intent, previous.blockId, next.blockId);
-		const breakResult = boundaryEditorChoiceFromResolvedChoice({
-			choice,
-			defaultValue: autoBoundaryOptionForIntent(input.intent),
-			unsupportedIssue: (presetId) => ({
-				kind: "pinned-boundary-option-unavailable",
-				boundaryId,
-				presetId,
-				feedback: "user-facing"
-			})
-		});
-		return {
-			boundary: {
-				boundaryId,
-				previousBlockId: previous.blockId,
-				nextBlockId: next.blockId,
-				breakChoice: breakResult.choice,
-				availableBreaks: boundaryOptions
-			},
-			issues: compactIssues([breakResult.issue])
-		};
-	});
-}
-function boundaryEditorChoiceFromResolvedChoice(input) {
-	switch (input.choice.kind) {
-		case "auto": return {
-			choice: {
-				kind: "auto",
-				effectiveValue: input.defaultValue
-			},
-			issue: null
-		};
-		case "user-pinned": {
-			const option = boundaryOptionForTreatment(input.choice.value);
-			const fallbackValue = boundaryOptionIdForTreatment(input.choice.value);
-			const issueValue = fallbackValue ?? input.defaultValue ?? noneBoundaryOption.id;
-			return {
-				choice: {
-					kind: "user-pinned",
-					value: issueValue,
-					status: option ? "supported" : "unsupported",
-					effectiveValue: option?.id ?? input.defaultValue
-				},
-				issue: option ? null : input.unsupportedIssue(issueValue)
-			};
-		}
-		default: return assertNever$1(input.choice, "Unhandled boundary design choice");
-	}
-}
 function editorChoiceFromResolvedChoice(input) {
 	switch (input.choice.kind) {
 		case "auto": return {
@@ -25564,10 +26103,6 @@ function editorChoiceFromResolvedChoice(input) {
 		default: return assertNever$1(input.choice, "Unhandled page design choice");
 	}
 }
-function autoBoundaryOptionForIntent(intent) {
-	const pageFlow = pageFlowPresets.find((preset) => preset.id === intent.pageFlowPresetId);
-	return pageFlow?.defaultBoundaryOptionId ?? boundaryOptions[0].id;
-}
 function compactIssues(issues) {
 	return issues.filter((issue$1) => issue$1 !== null);
 }
@@ -25618,7 +26153,6 @@ const repairActionsByIssueKind = {
 	"image-surface-treatment-without-image-surface": ["fallback-image-surface-treatment"],
 	"image-surface-motion-without-image-surface": ["fallback-image-surface-motion"],
 	"hero-legibility-overridden-by-image-surface-treatment": ["remove-hero-legibility"],
-	"removed-transition-for-flush-frame": ["remove-transition"],
 	"hero-image-without-legibility": ["fallback-hero-legibility"]
 };
 function repairActionsForIssue(issueKind) {
@@ -25706,11 +26240,6 @@ function repairDesignIssue(issue$1) {
 			issue: issue$1,
 			action: issue$1.allowedRepairActions[0]
 		};
-		case "removed-transition-for-flush-frame": return {
-			kind: "repaired",
-			issue: issue$1,
-			action: issue$1.allowedRepairActions[0]
-		};
 		case "hero-image-without-legibility": return {
 			kind: "fallbackApplied",
 			issue: issue$1,
@@ -25753,13 +26282,9 @@ function supportsBlockComposition(capability, composition) {
 		default: return assertNever$1(composition);
 	}
 }
-function isDecorativeTransition(transition) {
-	return transition !== "none";
-}
 const blockDesignFallback = {
 	sectionSurface: "base",
 	contentFrame: plainFrame,
-	transitionAfter: "none",
 	sectionHeight: "default",
 	heroLegibility: "none",
 	imageSurfaceTreatment: { kind: "none" },
@@ -25775,7 +26300,6 @@ const appliedBlockDesignFallback = {
 	appliedSectionSurface: blockDesignFallback.sectionSurface,
 	appliedContentFrame: blockDesignFallback.contentFrame,
 	appliedCardRole: null,
-	appliedTransitionAfter: blockDesignFallback.transitionAfter,
 	appliedSectionHeight: blockDesignFallback.sectionHeight,
 	appliedHeroLegibility: blockDesignFallback.heroLegibility,
 	appliedImageSurfaceTreatment: blockDesignFallback.imageSurfaceTreatment,
@@ -25801,7 +26325,6 @@ function blockDesignRequest(block) {
 		sectionSurface: block.sectionSurface,
 		contentFrame: block.contentFrame,
 		...block.cardRole ? { cardRole: block.cardRole } : {},
-		transitionAfter: block.transitionAfter,
 		sectionHeight: block.sectionHeight,
 		heroLegibility: block.heroLegibility,
 		imageSurfaceTreatment: block.imageSurfaceTreatment,
@@ -25820,7 +26343,6 @@ function resolveBlockDesignPlan(input) {
 		let appliedSectionSurface = block.sectionSurface;
 		let appliedContentFrame = block.contentFrame;
 		const appliedCardRole = appliedCardRoleFor(block, capability);
-		let appliedTransitionAfter = block.transitionAfter;
 		let appliedSectionHeight = block.sectionHeight ?? "default";
 		let appliedHeroLegibility = block.heroLegibility ?? "none";
 		let appliedImageSurfaceTreatment = block.imageSurfaceTreatment ?? { kind: "none" };
@@ -26085,7 +26607,6 @@ function resolveBlockDesignPlan(input) {
 			appliedSectionSurface,
 			appliedContentFrame,
 			appliedCardRole,
-			appliedTransitionAfter,
 			appliedSectionHeight,
 			appliedHeroLegibility,
 			appliedImageSurfaceTreatment,
@@ -26097,29 +26618,8 @@ function resolveBlockDesignPlan(input) {
 			appliedComposition
 		};
 	});
-	const transitionSafeBlocks = blocks.map((block, index) => {
-		const nextBlock = blocks[index + 1];
-		if (!nextBlock || !isDecorativeTransition(block.appliedTransitionAfter) || block.appliedContentFrame.kind !== "flush-panel" && nextBlock.appliedContentFrame.kind !== "flush-panel") {
-			return block;
-		}
-		issues.push({
-			kind: "removed-transition-for-flush-frame",
-			blockId: block.blockId,
-			blockKind: block.blockKind,
-			purpose: block.purpose,
-			requested: block.appliedTransitionAfter,
-			fallback: "none",
-			policy: input.policy,
-			severity: designIssueSeverityForPolicy(input.policy),
-			allowedRepairActions: repairActionsForIssue("removed-transition-for-flush-frame")
-		});
-		return {
-			...block,
-			appliedTransitionAfter: "none"
-		};
-	});
 	return {
-		blocks: transitionSafeBlocks,
+		blocks,
 		issues
 	};
 }
@@ -27006,80 +27506,6 @@ function recompileSiteChromeHeaderFromPersistedIntent(theme, siteStyle, requeste
 	};
 }
 
-//#endregion
-//#region ../theme-core/src/site-styles/runtimeBackgroundResolution.ts
-function parseCanonicalRuntimeBackground(content) {
-	const sectionStyles = readRecord$1(content._sectionStyles);
-	const background = readRecord$1(sectionStyles?.background);
-	if (!background) return { kind: "none" };
-	const parsed = boxBackgroundSchema.safeParse(background);
-	if (!parsed.success) return { kind: "none" };
-	return parsed.data.contentOwner === pageDesignEditorBackgroundOverrideOwner ? {
-		kind: "page-design-override",
-		background: parsed.data
-	} : {
-		kind: "block-authored",
-		background: parsed.data
-	};
-}
-function resolveSectionBackground(source, lookDefault) {
-	if (source.kind === "page-design-override") {
-		return {
-			kind: "page-design-override",
-			background: source.background
-		};
-	}
-	if (lookDefault) {
-		if (source.kind === "block-authored" && (source.background.type === "image" || source.background.type === "video")) {
-			return {
-				kind: "block-authored",
-				background: mergeLookForegroundWithAuthoredMedia(lookDefault, source.background)
-			};
-		}
-		return {
-			kind: "look-default",
-			background: lookDefault
-		};
-	}
-	if (source.kind === "block-authored" && (source.background.type === "image" || source.background.type === "video")) {
-		return {
-			kind: "block-authored",
-			background: source.background
-		};
-	}
-	return source.kind === "block-authored" ? {
-		kind: "block-authored",
-		background: source.background
-	} : { kind: "none" };
-}
-function resolveSectionForeground(background, palette) {
-	return resolveSurfaceForeground(background.kind === "none" ? null : background.background, palette, {}, { compositeBase: "background" });
-}
-/**
-* Read foreground authority from post-compiler block content. The preview
-* compiler has already materialized any Look-owned background into
-* `_sectionStyles`; raw authored content must be composed with its Look through
-* `resolveSectionBackground` instead.
-*/
-function resolveCompiledSectionForegroundFromContent(content, palette) {
-	if (!content) return resolveSurfaceForeground(null, palette);
-	return resolveSectionForeground(resolveSectionBackground(parseCanonicalRuntimeBackground(content), null), palette);
-}
-function mergeLookForegroundWithAuthoredMedia(lookDefault, authored) {
-	const merged = boxBackgroundSchema.safeParse({
-		...lookDefault,
-		type: authored.type,
-		image: authored.image,
-		objectFit: authored.objectFit,
-		scale: authored.scale,
-		position: authored.position
-	});
-	return merged.success ? merged.data : authored;
-}
-function readRecord$1(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
-}
-
 //#endregion
 //#region ../theme-core/src/site-styles/previewRuntimeCapabilities.ts
 function cardRoleCapabilitiesByBlockKind(blocks) {
@@ -27555,7 +27981,6 @@ function compileEditorModelRuntime(input) {
 			blockKind: block.blockKind,
 			purpose: previewCustomizePurpose,
 			...look ? { appearancePresetId: look.id } : {},
-			transitionAfter: "none",
 			emphasis: "medium",
 			sectionSurface: "base",
 			contentFrame: { kind: "plain" },
@@ -27565,30 +27990,31 @@ function compileEditorModelRuntime(input) {
 	if (blocks.length === 0) {
 		return {
 			blocks: [],
-			boundaries: []
+			joins: []
 		};
 	}
-	const fallbackTransitionAfterByBlockId = new Map(blocks.map((block) => [block.blockId, block.transitionAfter]));
-	const compiled = compilePageRuntimeFields({
+	return compilePageRuntimeFields({
 		resolved: resolveBlockDesignPlan({
 			policy: "user",
 			blocks,
 			capabilities: runtimeCapabilitiesForBlocks(blocks, cardRoleCapabilitiesByBlockKind(input.editorModel.blocks))
 		}),
+		joins: input.editorModel.boundaries.flatMap(runtimeJoinForEditorBoundary),
 		surfaceResolutionContext: input.surfaceResolutionContext,
 		designRules: input.designRules,
 		componentRules: input.componentRules,
 		sectionSpacing: input.sectionSpacing
 	});
-	return {
-		blocks: compiled.blocks,
-		boundaries: compileEditorBoundaryRuntime({
-			boundaries: input.editorModel.boundaries,
-			blocks: compiled.blocks,
-			fallbackTransitionAfterByPreviousBlockId: fallbackTransitionAfterByBlockId,
-			designRules: input.designRules
-		})
-	};
+}
+/** The editor boundary's effective break as an intent-only join; none for no break. */
+function runtimeJoinForEditorBoundary(boundary) {
+	const option = boundary.availableBreaks.find((candidate$1) => candidate$1.id === boundary.breakChoice.effectiveValue);
+	const treatment = option?.transitionAfter;
+	return treatment && isDecorativeTransitionIntent(treatment) ? [{
+		previousBlockId: boundary.previousBlockId,
+		nextBlockId: boundary.nextBlockId,
+		treatment
+	}] : [];
 }
 function buildCompiledRuntimeFieldsByBlockId(compiled) {
 	return new Map(compiled.blocks.map((block) => [block.blockId, block.fields]));
@@ -27596,31 +28022,6 @@ function buildCompiledRuntimeFieldsByBlockId(compiled) {
 function buildEditorModelRuntimeFieldsByBlockId(input) {
 	return buildCompiledRuntimeFieldsByBlockId(compileEditorModelRuntime(input));
 }
-function buildEditorModelRuntimeBoundaries(input) {
-	return compileEditorModelRuntime(input).boundaries;
-}
-function compileEditorBoundaryRuntime(input) {
-	const blockById = new Map(input.blocks.map((block) => [block.blockId, block]));
-	return input.boundaries.flatMap((boundary) => {
-		const previousBlock = blockById.get(boundary.previousBlockId);
-		const nextBlock = blockById.get(boundary.nextBlockId);
-		const transitionAfter = transitionAfterForEditorBoundary(boundary) ?? input.fallbackTransitionAfterByPreviousBlockId.get(boundary.previousBlockId) ?? null;
-		if (!previousBlock || !nextBlock || !transitionAfter) return [];
-		const compiled = compileBoundaryRuntime({
-			boundaryId: boundary.boundaryId,
-			previousBlockId: boundary.previousBlockId,
-			nextBlockId: boundary.nextBlockId,
-			treatment: transitionAfter,
-			fromSurface: previousBlock.visualSectionSurface,
-			toSurface: nextBlock.visualSectionSurface,
-			rules: input.designRules
-		});
-		return compiled ? [compiled] : [];
-	});
-}
-function transitionAfterForEditorBoundary(boundary) {
-	return boundary.availableBreaks.find((candidate$1) => candidate$1.id === boundary.breakChoice.effectiveValue)?.transitionAfter ?? null;
-}
 function compileEditorModelRuntimeFieldsForBlock(input) {
 	return buildEditorModelRuntimeFieldsByBlockId(input).get(input.blockId) ?? null;
 }
@@ -27631,54 +28032,6 @@ function applyCompiledRuntimeFieldsToContent(content, fields) {
 		...runtimeFields
 	};
 }
-function retargetCompiledRuntimeFieldsForContentAdjacency(fields, adjacency) {
-	if (!fields?._transitionStyles) return fields;
-	const transition = fields._transitionStyles;
-	const fromSurface = contentOwnedBackgroundEndpoint(adjacency.currentContent) ?? transition.from;
-	const toSurface = contentOwnedBackgroundEndpoint(adjacency.nextContent) ?? transition.to;
-	if (fromSurface === transition.from && toSurface === transition.to) {
-		return fields;
-	}
-	return {
-		...fields,
-		_transitionStyles: compileTransitionRuntime({
-			treatment: transition.treatment,
-			from: fromSurface,
-			to: toSurface
-		})
-	};
-}
-function retargetCompiledBoundaryRuntimeForContentAdjacency(boundary, adjacency) {
-	const fromSurface = contentOwnedBackgroundEndpoint(adjacency.currentContent) ?? boundary.from;
-	const toSurface = contentOwnedBackgroundEndpoint(adjacency.nextContent) ?? boundary.to;
-	if (fromSurface === boundary.from && toSurface === boundary.to) {
-		return boundary;
-	}
-	const transition = compileTransitionRuntime({
-		treatment: boundary.treatment,
-		from: fromSurface,
-		to: toSurface
-	});
-	return {
-		...boundary,
-		from: transition.from,
-		to: transition.to,
-		cssVars: transition.cssVars
-	};
-}
-function contentOwnedBackgroundEndpoint(content) {
-	const sectionStyles = readRecord(content?._sectionStyles);
-	const background = readRecord(sectionStyles?.background);
-	if (background?.contentOwner !== pageDesignEditorBackgroundOverrideOwner || background.type !== "color") {
-		return null;
-	}
-	const token = parseThemeColorToken(background.color);
-	if (!token) return null;
-	return {
-		kind: "color-token",
-		token
-	};
-}
 function preserveContentOwnedBackgroundFields(content, fields) {
 	const source = parseCanonicalRuntimeBackground(content);
 	const resolved = resolveSectionBackground(source, fields._sectionStyles?.background);
@@ -27693,9 +28046,6 @@ function preserveContentOwnedBackgroundFields(content, fields) {
 		}
 	};
 }
-function readRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
-}
 function restoreCompiledRuntimeFieldsFromContent(currentContent, previousContent) {
 	const nextContent = stripCompiledRuntimeStyleFields(currentContent);
 	for (const fieldName of compiledRuntimeStyleFieldNames) {
@@ -27742,7 +28092,7 @@ function compileContentTemplateRuntimeFields(input) {
 	}));
 	return {
 		blocks,
-		boundaries: compiled.boundaries,
+		joins: compiled.joins,
 		fieldsByBlockId: new Map(blocks.map((block) => [block.blockId, block.fields])),
 		issues: editorModel.issues
 	};
@@ -28149,9 +28499,6 @@ function defaultContentFrame() {
 function cardIntentFor(design, lookDefaults) {
 	return { cardRole: valueOrLookDefault(design.cardRole, lookDefaults?.cardRole, "none") };
 }
-function defaultTransition() {
-	return "none";
-}
 function defaultEmphasis(block) {
 	return isHeroBlock(block) ? "high" : "medium";
 }
@@ -28176,8 +28523,24 @@ function isDefaultLookSafeForStyle(preset, siteStyle) {
 	}
 	return preset.design.contentFrame.kind === "plain" && preset.design.cardRole === "none";
 }
-function materializeBoundaryTransition(design, boundary, defaultValue) {
-	return valueOrDefault(boundary.transitionAfter, valueOrDefault(design.transitionAfter, defaultValue));
+/**
+* The generated pipeline's joins: candidates come from the generated intent
+* and `resolveJoinTreatment` decides. Joins that resolve to no break are
+* absent; whether one draws is composition's call.
+*/
+function resolveGeneratedJoins(input) {
+	const intentByBlockId = new Map(input.intent.blocks.map((block) => [block.blockId, block]));
+	return input.resolved.blocks.flatMap((block, index) => {
+		const next = input.resolved.blocks[index + 1];
+		const blockIntent = intentByBlockId.get(block.blockId);
+		if (!next || !blockIntent) return [];
+		const { join } = resolveJoinTreatment({
+			candidates: joinCandidatesFromGeneratedIntent(blockIntent),
+			previousBlockId: block.blockId,
+			nextBlockId: next.blockId
+		});
+		return join ? [join] : [];
+	});
 }
 function materializeBlockDesignPlan(block, siteStyle) {
 	const lookDefaults = defaultAppearanceDesignForBlock({
@@ -28194,7 +28557,6 @@ function materializeBlockDesignPlan(block, siteStyle) {
 		sectionSurface,
 		contentFrame: valueOrLookDefault(block.design.contentFrame, lookDefaults?.contentFrame, defaultContentFrame()),
 		...cardIntentFor(block.design, lookDefaults),
-		transitionAfter: materializeBoundaryTransition(block.design, block.boundaryIntent, defaultTransition()),
 		emphasis: valueOrDefault(block.design.emphasis, defaultEmphasis(block)),
 		heroLegibility: valueOrLookDefault(block.mediaIntent.heroLegibility, lookDefaults?.heroLegibility, defaultLegibility),
 		...lookDefaults?.sectionHeight ? { sectionHeight: lookDefaults.sectionHeight } : {},
@@ -28250,7 +28612,6 @@ function resolvedBlockToPlan(block) {
 		sectionSurface: block.appliedSectionSurface,
 		contentFrame: block.appliedContentFrame,
 		...block.appliedCardRole ? { cardRole: block.appliedCardRole } : {},
-		transitionAfter: block.appliedTransitionAfter,
 		emphasis: block.emphasis,
 		sectionHeight: block.appliedSectionHeight,
 		heroLegibility: block.appliedHeroLegibility,
@@ -28387,10 +28748,15 @@ function runGeneratedPageDesignPipeline(input) {
 			})
 		};
 	}
+	const joins = resolveGeneratedJoins({
+		intent,
+		resolved
+	});
 	const compositionIssues = validateCompositionBudget({
 		policy: "generated",
 		budget: input.siteStyle.template.compositionBudget,
 		resolved,
+		joins,
 		blockContexts: intent.blocks.map((block) => ({
 			blockId: block.blockId,
 			mediaIntent: block.mediaIntent.media,
@@ -28414,6 +28780,7 @@ function runGeneratedPageDesignPipeline(input) {
 	}
 	const compiledRuntime = compilePageRuntimeFields({
 		resolved,
+		joins,
 		surfaceResolutionContext: surfaceResolutionContextFromTheme(compileTokenRecipes(input.siteStyle.template.tokenRecipes)),
 		designRules: designRuntimeRulesForSiteStyle(input.siteStyle),
 		componentRules: componentRuntimeRulesForSiteStyle(input.siteStyle)
@@ -28432,6 +28799,7 @@ function runGeneratedPageDesignPipeline(input) {
 		intent,
 		plan,
 		resolved,
+		joins,
 		headerOpeningSectionContext: deriveHeaderOpeningSectionContext({ openingBlock: resolved.blocks[0] ?? null }),
 		headerOpeningSectionRepairs: headerOpeningSectionPlan.repairs,
 		repairs,
@@ -28678,9 +29046,7 @@ function isNavUnderlineEffect(effect) {
 }
 /** Concrete hex behind a plain palette token, or null when it is not one. */
 function paletteHexForToken(theme, token) {
-	const parts = parseColorTokenParts(token);
-	if (parts.kind !== "token" || parts.opacityPercent !== null) return null;
-	return expandPalette(theme.palette)[parts.token] ?? null;
+	return opaquePaletteHexForToken(expandPalette(theme.palette), token);
 }
 function compileHeaderScrollTreatment(theme, recipe, foregroundToken) {
 	if (recipe.scrollTreatment !== "contrast-glass") return undefined;
@@ -29822,14 +30188,26 @@ const paidOnlineServiceInputSchema = z.object({
 	priceAmount: z.number().int().positive(),
 	payment: z.object({ mode: z.literal("paid_online_intent") }).strict()
 }).strict();
+/**
+* A service input with one of the three category placements: none, a
+* `categoryRef` to a category upserted in the same batch, or the
+* `categoryIdentifier` of one that already exists (issue 1403).
+*/
+function withAppointmentServiceCategoryPlacement(schema) {
+	return z.union([
+		schema.extend(noAppointmentServiceCategoryFields),
+		schema.extend(appointmentServiceCategoryRefFields),
+		schema.extend(appointmentServiceCategoryIdentifierFields)
+	]);
+}
 const upsertAppointmentServiceCommandSchema = z.object({
 	type: z.literal("upsertAppointmentService"),
 	ref: appointmentServiceRefSchema,
-	input: z.union([
-		manualRequestServiceInputSchema,
-		freeServiceInputSchema,
-		paidOnlineServiceInputSchema
-	])
+	input: z.unknown().superRefine(rejectBothAppointmentServiceCategoryKeys).pipe(z.union([
+		withAppointmentServiceCategoryPlacement(manualRequestServiceInputSchema),
+		withAppointmentServiceCategoryPlacement(freeServiceInputSchema),
+		withAppointmentServiceCategoryPlacement(paidOnlineServiceInputSchema)
+	]))
 }).strict();
 const upsertBookableResourceCommandSchema = z.object({
 	type: z.literal("upsertBookableResource"),
@@ -29881,6 +30259,31 @@ function validatePortalOrder(input, ctx) {
 	});
 }
 
+//#endregion
+//#region ../site-commands/src/bookingCommandSchemaOptions.ts
+/**
+* The booking, entitlement and appointment command schemas, in the order the
+* site command union lists them. `configureBookingSettings` stays with the
+* site-level commands at the head of the union.
+*/
+const bookingCommandSchemaOptions = [
+	upsertBookingPassProductCommandSchema,
+	upsertBookingMembershipProductCommandSchema,
+	seedBookingCustomerCommandSchema,
+	grantCustomerPassCommandSchema,
+	grantCustomerMembershipCommandSchema,
+	seedAppointmentBookingCommandSchema,
+	seedEventSeriesRegistrationCommandSchema,
+	seedEventRegistrationCommandSchema,
+	seedPassRedemptionCommandSchema,
+	seedPortalOrderCommandSchema,
+	upsertAppointmentServiceCategoryCommandSchema,
+	upsertAppointmentServiceCommandSchema,
+	upsertBookableResourceCommandSchema,
+	assignAppointmentServiceResourcesCommandSchema,
+	configureAppointmentAvailabilityCommandSchema
+];
+
 //#endregion
 //#region ../site-commands/src/commands.ts
 const mediaRefSchema = resourceRefSchema("media");
@@ -30349,20 +30752,7 @@ const siteCommandSchema = z.discriminatedUnion("type", [
 	deleteEventCategoryCommandSchema,
 	upsertEventSeriesCommandSchema,
 	deleteEventSeriesCommandSchema,
-	upsertBookingPassProductCommandSchema,
-	upsertBookingMembershipProductCommandSchema,
-	seedBookingCustomerCommandSchema,
-	grantCustomerPassCommandSchema,
-	grantCustomerMembershipCommandSchema,
-	seedAppointmentBookingCommandSchema,
-	seedEventSeriesRegistrationCommandSchema,
-	seedEventRegistrationCommandSchema,
-	seedPassRedemptionCommandSchema,
-	seedPortalOrderCommandSchema,
-	upsertAppointmentServiceCommandSchema,
-	upsertBookableResourceCommandSchema,
-	assignAppointmentServiceResourcesCommandSchema,
-	configureAppointmentAvailabilityCommandSchema
+	...bookingCommandSchemaOptions
 ]);
 
 //#endregion
@@ -30484,6 +30874,7 @@ const commandScopes = [
 	"order",
 	"booking_settings",
 	"appointment_service",
+	"appointment_service_category",
 	"appointment_resource",
 	"appointment_availability",
 	"publish"
@@ -31112,6 +31503,19 @@ const siteCommandMetadata = {
 		capability: "commerce.orders.write",
 		support: "supported"
 	},
+	upsertAppointmentServiceCategory: {
+		scope: "appointment_service_category",
+		risk: "medium",
+		writeSemantics: "upsert",
+		lifecycleIntent: "mutation",
+		idempotencyStrategy: "natural_key",
+		conflictPolicy: "update_existing",
+		previewability: "dry_run_only",
+		allowedRuntimes: allRuntimes,
+		intendedExposure: recipeExposure,
+		capability: "bookings.appointment_service_categories.write",
+		support: "supported"
+	},
 	upsertAppointmentService: {
 		scope: "appointment_service",
 		risk: "medium",
@@ -31291,6 +31695,7 @@ const bookingRefCommandTypeValues = [
 	"seedEventRegistration",
 	"seedPassRedemption",
 	"seedPortalOrder",
+	"upsertAppointmentServiceCategory",
 	"upsertAppointmentService",
 	"upsertBookableResource",
 	"assignAppointmentServiceResources",
@@ -31304,8 +31709,12 @@ function bookingCommandRefContributions(command) {
 	switch (command.type) {
 		case "upsertBookingMembershipProduct":
 		case "seedBookingCustomer":
-		case "upsertAppointmentService":
+		case "upsertAppointmentServiceCategory":
 		case "upsertBookableResource": return provided(command.ref);
+		case "upsertAppointmentService": return providedWithRequirements(command.ref, command.input.categoryRef === undefined ? [] : [{
+			ref: command.input.categoryRef,
+			field: "input.categoryRef"
+		}]);
 		case "upsertBookingPassProduct": return {
 			...provided(command.ref),
 			requires: command.input.appointmentScope?.mode === "selected_services" ? command.input.appointmentScope.serviceRefs.map((ref, index) => ({
@@ -31838,7 +32247,8 @@ function matchSiteCommand(command, match) {
 		case "seedEventRegistration": return match(command);
 		case "seedPassRedemption": return match(command);
 		case "seedPortalOrder": return match(command);
-		case "upsertAppointmentService": return match(command);
+		case "upsertAppointmentServiceCategory":
+		case "upsertAppointmentService":
 		case "upsertBookableResource": return match(command);
 		case "assignAppointmentServiceResources": return match(command);
 		case "configureAppointmentAvailability": return match(command);
@@ -32848,4 +33258,4 @@ function parseSdkEventRunUpsertInput(input, runIndex, options) {
 }
 
 //#endregion
-export { generateBaseInteractiveCSS as $, createContentEntryRef as $n, NAV_LINK_LETTER_SPACING_MAP as $t, getGradientPreset as A, featuresFromHex as An, resolveTokenOrCssColorValue as At, generateCssVars as B, normalizeCardRole as Bn, featureCardCompositionTreatmentValues as Bt, retargetCompiledBoundaryRuntimeForContentAdjacency as C, resolveSurfaceForeground as Cn, MQ_SM_DOWN as Ct, compileTransitionRuntime as D, defaultThemeTokens as Dn, isCssColorLiteral as Dt, getCuratedSiteStyle as E, buildThemeTokens as En, headerVariantValues as Et, parseBackgroundAppearanceColorToken as F, surfaceForegroundStyle as Fn, defineBlockDesignCapability as Ft, resolvedButtonColourDeclarations as G, footerModeSchema as Gn, testimonialsCompositionTreatmentValues as Gt, PUBLIC_BUTTON_ROLES as H, mediaSchema as Hn, introCompositionTreatmentValues as Ht, defineBlockDesignMetadata as I, surfaceForegroundValue as In, defineFrameCapability as It, contextualButtonSurfaceStyles as J, unsafeAsOpaqueButtonColourToken as Jn, getComponentBorderWidthPx as Jt, resolvedButtonFocusDeclarations as K, VARIANT_ROLES as Kn, tileTreatmentValues as Kt, require_jsx_runtime as L, generateShadowValue$1 as Ln, defineNoBlockDesignCapability as Lt, boundaryRuntimeMetricsForTransition as M, oklchToHexGamut as Mn, asAppearancePresetId as Mt, backgroundAppearanceColorTokenNames as N, DEFAULT_SURFACE_TEXT_COLOR as Nn, asDesignBlockId as Nt, gradientToCss as O, ORDINARY_TEXT_MIN_CONTRAST_RATIO as On, resolveOnColorForThemeToken as Ot, backgroundAppearanceQuickColorTokenNames as P, surfaceForegroundDeclarations as Pn, assertNever$1 as Pt, generateEffectsCSS as Q, createCommandRef as Qn, NAV_LINK_BORDER_RADIUS_MAP as Qt, require_react as R, cardRoleSchema as Rn, eventListTreatmentValues as Rt, eventBookingOfferIntentSchema as S, textColorStyle as Sn, MQ_MD_DOWN as St, readHeaderNavFontSizePreference as T, onColorTokenName as Tn, MQ_TABLET_ONLY as Tt, generateButtonCss as U, mediaTypeDiscriminants as Un, makeBoundaryId as Ut, buttonStyleSelectionSchema as V, mediaIdentifierSchema as Vn, headingDecorationColorTokenValues as Vt, RESOLVED_BUTTON_DISABLED_DECLARATIONS as W, persistableMediaSchema as Wn, offeringsPreviewCompositionTreatmentValues as Wt, resolveContextualButtonRole as X, createBlockRef as Xn, parseBlockCustomCssRules as Xt, deriveButtonSurfaceContext as Y, parseBlockColorToken as Yn, getComponentShadowVar as Yt, generateDefaultButtonSystem as Z, createBlocksRef as Zn, parseCustomCssRules as Zt, entryIdentifierForCommand as _, backgroundColorStyle as _n, BREAKPOINT_LG as _t, classifySdkEventBookingOffer as a, INPUT_SPACING_MAP as an, createPageRef as ar, compileButtonColourStates as at, pagePathForCommand as b, mergeStyles as bn, BREAKPOINT_XL as bt, stableStringify as c, ACCORDION_SPACING_MAP as cn, refSlug as cr, expandPalette as ct, mapEventCommandContent as d, ICON_CONFIG as dn, boxBackgroundOverlaySchema as dt, NAV_LINK_PADDING_MAP as en, createEventCategoryRef as er, generateInteractiveChildInheritanceCSS as et, evaluateSiteCommandBatchExposure as f, ICON_SIZE_PX as fn, boxBackgroundSchema as ft, blockOrderIdentifiersForCommand as g, TokenResolver as gn, renderHeaderPaintTargetRules as gt, blockIdentifierForCommand as h, generateCardCss as hn, getHeaderPaintTargets as ht, classifySdkEventSchedule as i, INPUT_FONT_SIZE_MAP as in, createNavigationRef as ir, parseThemeForPersistence as it, parseGradientPresetId as j, hexToRgb as jn, pageDesignEditorBackgroundOverrideOwner as jt, GRADIENT_PRESET_IDS as k, contrastRatio as kn, resolveThemeColorReferenceValue as kt, createDryRunReport as l, ACCORDION_TRIGGER_FONT_SCALE as ln, slugPart as lr, getTextColorForBackground as lt, getSiteCommandMetadata as m, getDefaultCardVariants as mn, generateMobileOverlayBackdropFilterFix as mt, sdkEventOccurrenceInputSchema as n, NAV_LINK_TEXT_SIZE_MAP as nn, createFooterRef as nr, themeButtonClassName as nt, venueManagementFields as o, LABEL_FONT_SIZE_MAP as on, createSiteCommandSiteRef as or, formatButtonColourContractError as ot, evaluateSiteCommandExposure as p, generateCardCoreCss as pn, generateHeaderScrollTreatmentStyles as pt, contextualButtonSurfaceResetStyles as q, buttonVariantIdSchema as qn, visibleHeadingDecorationFamilyValues as qt, sdkEventUpsertOptionalFieldSchemas as r, FONT_WEIGHT_MAP$1 as rn, createFormRef as rr, themeButtonClassNameWithTrailingIcon as rt, sortRecord as s, ACCORDION_OPEN_ACCENT_THICKNESS as sn, createVenueRef as sr, generateShadowValue as st, classifySdkEventTiming as t, NAV_LINK_PADDING_X_MAP as tn, createEventSeriesRef as tr, parseThemeButtonVariantId as tt, parseAndPlanCommandBatchForTypes as u, ACCORDION_TRIGGER_LETTER_SPACING as un, __toESM as ur, themeSchema as ut, pageIdentifierForBlockCommand as v, borderColorStyle as vn, BREAKPOINT_MD as vt, mergeHeaderNavTypographyPreference as w, isOnColorBackgroundCandidateToken as wn, MQ_SM_UP as wt, hasConfiguredBookingVertical as x, rgbColorValue as xn, MQ_LG_UP as xt, pageIdentifierForCommand as y, cssVarValue as yn, BREAKPOINT_SM as yt, pickShadeTowardBackground as z, cardVariantRoleValues as zn, eyebrowTreatmentValues as zt };
+export { resolveContextualButtonRole as $, footerModeSchema as $n, getComponentBorderWidthPx as $t, boundaryLayout as A, surfaceToneFromForegroundToken as An, headerVariantValues as At, require_jsx_runtime as B, oklchToHexGamut as Bn, defineBlockDesignCapability as Bt, mergeHeaderNavTypographyPreference as C, borderColorStyle as Cn, BREAKPOINT_SM as Ct, GRADIENT_PRESET_IDS as D, textColorStyle as Dn, MQ_SM_DOWN as Dt, gradientToCss as E, rgbColorValue as En, MQ_MD_DOWN as Et, transitionCatalogueEntries as F, defaultThemeTokens as Fn, pageDesignEditorBackgroundOverrideOwner as Ft, PUBLIC_BUTTON_ROLES as G, generateShadowValue$1 as Gn, featureCardCompositionTreatmentValues as Gt, pickShadeTowardBackground as H, surfaceForegroundDeclarations as Hn, defineNoBlockDesignCapability as Ht, backgroundAppearanceColorTokenNames as I, ORDINARY_TEXT_MIN_CONTRAST_RATIO as In, stripStaleTransitionStyleGroup as It, resolvedButtonColourDeclarations as J, normalizeCardRole as Jn, makeBoundaryId as Jt, generateButtonCss as K, cardRoleSchema as Kn, headingDecorationColorTokenValues as Kt, backgroundAppearanceQuickColorTokenNames as L, contrastRatio as Ln, asAppearancePresetId as Lt, sectionFactsForContent as M, isOnColorBackgroundCandidateToken as Mn, resolveOnColorForThemeToken as Mt, boundaryRuntimeMetricsForDecorativeTransition as N, onColorTokenName as Nn, resolveThemeColorReferenceValue as Nt, getGradientPreset as O, textColorValue as On, MQ_SM_UP as Ot, anglePolygonCss as P, buildThemeTokens as Pn, resolveTokenOrCssColorValue as Pt, deriveButtonSurfaceContext as Q, persistableMediaSchema as Qn, visibleHeadingDecorationFamilyValues as Qt, parseBackgroundAppearanceColorToken as R, featuresFromHex as Rn, asDesignBlockId as Rt, eventBookingOfferIntentSchema as S, backgroundColorStyle as Sn, BREAKPOINT_MD as St, getCuratedSiteStyle as T, mergeStyles as Tn, MQ_LG_UP as Tt, generateCssVars as U, surfaceForegroundStyle as Un, eventListTreatmentValues as Ut, require_react as V, DEFAULT_SURFACE_TEXT_COLOR as Vn, defineFrameCapability as Vt, buttonStyleSelectionSchema as W, surfaceForegroundValue as Wn, eyebrowTreatmentValues as Wt, contextualButtonSurfaceResetStyles as X, mediaSchema as Xn, testimonialsCompositionTreatmentValues as Xt, resolvedButtonFocusDeclarations as Y, mediaIdentifierSchema as Yn, offeringsPreviewCompositionTreatmentValues as Yt, contextualButtonSurfaceStyles as Z, mediaTypeDiscriminants as Zn, tileTreatmentValues as Zt, entryIdentifierForCommand as _, ICON_SIZE_PX as _n, slugPart as _r, generateHeaderScrollTreatmentStyles as _t, classifySdkEventBookingOffer as a, NAV_LINK_PADDING_MAP as an, createBlocksRef as ar, themeButtonExtraClassesWithTrailingIcon as at, pagePathForCommand as b, generateCardCss as bn, renderHeaderPaintTargetRules as bt, stableStringify as c, FONT_WEIGHT_MAP$1 as cn, createEventCategoryRef as cr, parseThemeForPersistence as ct, mapEventCommandContent as d, LABEL_FONT_SIZE_MAP as dn, createFormRef as dr, generateShadowValue as dt, getComponentShadowVar as en, VARIANT_ROLES as er, generateDefaultButtonSystem as et, evaluateSiteCommandBatchExposure as f, ACCORDION_OPEN_ACCENT_THICKNESS as fn, createNavigationRef as fr, expandPalette as ft, blockOrderIdentifiersForCommand as g, ICON_CONFIG as gn, refSlug as gr, boxBackgroundSchema as gt, blockIdentifierForCommand as h, ACCORDION_TRIGGER_LETTER_SPACING as hn, createVenueRef as hr, boxBackgroundOverlaySchema as ht, classifySdkEventSchedule as i, NAV_LINK_LETTER_SPACING_MAP as in, createBlockRef as ir, parseThemeButtonVariantId as it, composeBoundary as j, resolveSurfaceForeground as jn, isCssColorLiteral as jt, parseGradientPresetId as k, selectLogoVariant as kn, MQ_TABLET_ONLY as kt, createDryRunReport as l, INPUT_FONT_SIZE_MAP as ln, createEventSeriesRef as lr, compileButtonColourStates as lt, getSiteCommandMetadata as m, ACCORDION_TRIGGER_FONT_SCALE as mn, createSiteCommandSiteRef as mr, themeSchema as mt, sdkEventOccurrenceInputSchema as n, parseCustomCssRules as nn, unsafeAsOpaqueButtonColourToken as nr, generateBaseInteractiveCSS as nt, venueManagementFields as o, NAV_LINK_PADDING_X_MAP as on, createCommandRef as or, themeButtonSizeClassName as ot, evaluateSiteCommandExposure as p, ACCORDION_SPACING_MAP as pn, createPageRef as pr, getTextColorForBackground as pt, RESOLVED_BUTTON_DISABLED_DECLARATIONS as q, cardVariantRoleValues as qn, introCompositionTreatmentValues as qt, sdkEventUpsertOptionalFieldSchemas as r, NAV_LINK_BORDER_RADIUS_MAP as rn, parseBlockColorToken as rr, generateInteractiveChildInheritanceCSS as rt, sortRecord as s, NAV_LINK_TEXT_SIZE_MAP as sn, createContentEntryRef as sr, themeButtonVariantClassNames as st, classifySdkEventTiming as t, parseBlockCustomCssRules as tn, buttonVariantIdSchema as tr, generateEffectsCSS as tt, parseAndPlanCommandBatchForTypes as u, INPUT_SPACING_MAP as un, createFooterRef as ur, formatButtonColourContractError as ut, pageIdentifierForBlockCommand as v, generateCardCoreCss as vn, __toESM as vr, generateMobileOverlayBackdropFilterFix as vt, readHeaderNavFontSizePreference as w, cssVarValue as wn, BREAKPOINT_XL as wt, hasConfiguredBookingVertical as x, TokenResolver as xn, BREAKPOINT_LG as xt, pageIdentifierForCommand as y, getDefaultCardVariants as yn, getHeaderPaintTargets as yt, defineBlockDesignMetadata as z, hexToRgb as zn, assertNever$1 as zt };