@riverbankcms/sdk 0.143.0 → 0.145.0

package/dist/client/hooks.mjs

@@ -2257,6 +2257,8 @@ const buttonSystemSchema = z.strictObject({
 //#endregion
 //#region ../theme-core/src/palette/utils/colorConversion.ts
 const clamp01 = (x) => Math.max(0, Math.min(1, x));
+const mod = (a, n) => (a % n + n) % n;
+const deg = (x) => mod(x, 360);
 function hexToRgb(hex) {
 	const h = hex.replace(/^#/, "");
 	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
@@ -2279,6 +2281,45 @@ function srgbToLinear(u) {
 function linearToSrgb(x) {
 	return clamp01(x <= .0031308 ? 12.92 * x : 1.055 * Math.pow(x, 1 / 2.4) - .055) * 255;
 }
+function rgbToHsl(r, g, b) {
+	const R = r / 255, G = g / 255, B = b / 255;
+	const max = Math.max(R, G, B), min = Math.min(R, G, B);
+	const d = max - min;
+	let h = 0;
+	if (d !== 0) {
+		switch (max) {
+			case R:
+				h = (G - B) / d + (G < B ? 6 : 0);
+				break;
+			case G:
+				h = (B - R) / d + 2;
+				break;
+			case B:
+				h = (R - G) / d + 4;
+				break;
+		}
+		h *= 60;
+	}
+	const l = (max + min) / 2;
+	const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));
+	return {
+		h,
+		s,
+		l
+	};
+}
+function srgbToOklab(r, g, b) {
+	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
+	const l = .4122214708 * R + .5363325363 * G + .0514459929 * B;
+	const m = .2119034982 * R + .6806995451 * G + .1073969566 * B;
+	const s = .0883024619 * R + .2817188376 * G + .6299787005 * B;
+	const l_ = Math.cbrt(l), m_ = Math.cbrt(m), s_ = Math.cbrt(s);
+	return {
+		L: .2104542553 * l_ + .793617785 * m_ - .0040720468 * s_,
+		a: 1.9779984951 * l_ - 2.428592205 * m_ + .4505937099 * s_,
+		b: .0259040371 * l_ + .7827717662 * m_ - .808675766 * s_
+	};
+}
 function oklabToSrgb(L, a, b) {
 	const l_ = Math.pow(L + .3963377774 * a + .2158037573 * b, 3);
 	const m_ = Math.pow(L - .1055613458 * a - .0638541728 * b, 3);
@@ -2292,6 +2333,14 @@ function oklabToSrgb(L, a, b) {
 		b: linearToSrgb(B)
 	};
 }
+function oklabToOklch(L, a, b) {
+	const C = Math.sqrt(a * a + b * b);
+	return {
+		L,
+		C,
+		h: C < 1e-7 ? 0 : deg(Math.atan2(b, a) * 180 / Math.PI)
+	};
+}
 function oklchToOklab(L, C, h) {
 	const hr = h * Math.PI / 180;
 	return {
@@ -2300,6 +2349,27 @@ function oklchToOklab(L, C, h) {
 		b: C * Math.sin(hr)
 	};
 }
+function featuresFromHex(hex) {
+	const { r, g, b } = hexToRgb(hex);
+	const { h, s, l } = rgbToHsl(r, g, b);
+	const { L, a, b: b2 } = srgbToOklab(r, g, b);
+	const { L: okL, C: okC, h: okH } = oklabToOklch(L, a, b2);
+	return {
+		r,
+		g,
+		b,
+		h,
+		s,
+		l,
+		v: Math.max(r, g, b) / 255,
+		Y: .2126 * srgbToLinear(r) + .7152 * srgbToLinear(g) + .0722 * srgbToLinear(b),
+		chroma: s,
+		okL,
+		okC,
+		okH,
+		hex
+	};
+}
 function relativeLuminance(r, g, b) {
 	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
 	return .2126 * R + .7152 * G + .0722 * B;
@@ -3349,6 +3419,36 @@ 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-";
 function parseToken(source) {
@@ -3400,16 +3500,28 @@ function backgroundColorStyle(token) {
 	return { backgroundColor: rgbColorValue(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 CSS color value
+*/
+function textColorValue(token) {
+	const parsed = parseToken(token);
+	const surfaceRole = parsed.raw ? null : surfaceRoleForTextToken(parsed.token);
+	if (!surfaceRole) return rgbColorValue(token);
+	return parsed.opacityPercent === void 0 ? 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) {
-	const parsed = parseToken(token);
-	const surfaceRole = parsed.raw ? null : surfaceRoleForTextToken(parsed.token);
-	if (surfaceRole) return { color: parsed.opacityPercent === void 0 ? surfaceForegroundValue(surfaceRole) : surfaceForegroundValueWithOpacity(surfaceRole, parsed.opacityPercent) };
-	return { color: rgbColorValue(token) };
+	return { color: textColorValue(token) };
 }
 /**
 * Creates a border color style object from a theme token.
@@ -6593,6 +6705,15 @@ function asSiteStyleId(value) {
 function asDesignSystemTemplateId(value) {
 	return brandNonEmptyString(value, "DesignSystemTemplateId");
 }
+function toNonEmptyReadonlyArray(values) {
+	const [first, ...rest] = values;
+	return first === void 0 ? null : [first, ...rest];
+}
+function requireNonEmptyReadonlyArray(values, message = "Expected a non-empty array.") {
+	const result = toNonEmptyReadonlyArray(values);
+	if (!result) throw new Error(message);
+	return result;
+}
 function makeBoundaryId(previousBlockId, nextBlockId) {
 	return asDesignBoundaryId(`boundary:${encodeURIComponent(previousBlockId)}:${encodeURIComponent(nextBlockId)}`);
 }
@@ -6795,16 +6916,18 @@ const themeV2RuntimeStyleFieldNames = [
 	"_frameStyles",
 	"_sectionStyles",
 	"_containerStyles",
-	"_cardStyles",
-	"_transitionStyles",
-	"styleGroup"
+	"_cardStyles"
 ];
 const themeV2BlockSpecificRawStyleFieldNames = [
 	"_contentCardStyles",
 	"_heroLayoutStyles",
 	"_textCardStyles"
 ];
-const themeV2NormalEditorRawStyleFieldNames = [...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
+const themeV2NormalEditorRawStyleFieldNames = [
+	...themeV2RuntimeStyleFieldNames,
+	...themeV2BlockSpecificRawStyleFieldNames,
+	"styleGroup"
+];
 new Set(themeV2NormalEditorRawStyleFieldNames);
 [...themeV2RuntimeStyleFieldNames, ...themeV2BlockSpecificRawStyleFieldNames];
 const pageDesignEditorBackgroundOverrideOwner = "page-design-editor";
@@ -8313,6 +8436,33 @@ function normalizeEventCalendarDisplayMode$1(input) {
 	if (isEventCalendarDisplayMode(input.variant)) return input.variant;
 	return isEventCalendarDisplayMode(input.displayMode) ? input.displayMode : void 0;
 }
+/** One closed authority for the projections required by each rendered mode. */
+function resolveEventCalendarReadPlan(input) {
+	const mode = normalizeEventCalendarDisplayMode$1(input) ?? "combined";
+	switch (mode) {
+		case "combined": return {
+			mode,
+			jobs: "both",
+			readProfile: "listing-card"
+		};
+		case "list": return {
+			mode,
+			jobs: "list",
+			readProfile: "listing-card"
+		};
+		case "calendar": return {
+			mode,
+			jobs: "calendar",
+			readProfile: "listing-card"
+		};
+		case "timetable":
+		case "week-board": return {
+			mode,
+			jobs: "calendar",
+			readProfile: "timetable"
+		};
+	}
+}
 function isEventCalendarDefaultView(value) {
 	return typeof value === "string" && eventCalendarDefaultViewValues.includes(value);
 }
@@ -8322,8 +8472,7 @@ function isEventCalendarListLayout(value) {
 //#endregion
 //#region ../blocks/src/system/blocks/events/shared/calendarWindow.ts
 function resolveCalendarReadProfile(content) {
-	const mode = normalizeEventCalendarDisplayMode$1(content);
-	return mode === "timetable" || mode === "week-board" ? "timetable" : "listing-card";
+	return resolveEventCalendarReadPlan(content).readProfile;
 }
 /** Runtime picker sentinels and bound loader IDs must describe the same query. */
 function normalizeCalendarFilterId(value) {
@@ -8412,6 +8561,75 @@ const calendarWindowPageSchema = z.discriminatedUnion("kind", [z.object({
 	nextCursor: calendarSourceCursorSchema
 })]);
 //#endregion
+//#region ../api/src/defineEndpointDefinitions.ts
+/**
+* Validates extracted endpoint descriptors while preserving each literal path,
+* method, and parameter contract for the typed URL builders.
+*/
+function defineEndpointDefinitions(definitions) {
+	return definitions;
+}
+//#endregion
+//#region ../api/src/publicNewsletterEndpointDefinitions.ts
+const PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	subscribeNewsletter: {
+		path: "/public/sites/{siteId}/newsletter/subscribe",
+		method: "POST",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "json"
+	},
+	confirmNewsletter: {
+		path: "/public/sites/{siteId}/newsletter/confirm/{token}",
+		method: "GET",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	unsubscribeNewsletter: {
+		path: "/public/sites/{siteId}/newsletter/unsubscribe/{token}",
+		method: "GET",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	unsubscribeNewsletterPost: {
+		path: "/public/sites/{siteId}/newsletter/unsubscribe/{token}",
+		method: "POST",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	confirmNewsletterPost: {
+		path: "/public/sites/{siteId}/newsletter/confirm/{token}",
+		method: "POST",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	getNewsletterPreferences: {
+		path: "/public/sites/{siteId}/newsletter/preferences/{token}",
+		method: "GET",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	saveNewsletterPreferences: {
+		path: "/public/sites/{siteId}/newsletter/preferences/{token}",
+		method: "POST",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	},
+	getNewsletterArchive: {
+		path: "/public/sites/{siteId}/newsletter/archive/{token}",
+		method: "GET",
+		tags: ["public-newsletter-{siteId}"],
+		auth: "public",
+		responseKind: "text"
+	}
+});
+//#endregion
 //#region ../api/src/apiEndpointTypes.ts
 function allowedDemoMutationPolicy() {
 	return {
@@ -8503,17 +8721,85 @@ const SDK_ENTRY_READ_ENDPOINTS = {
 	}
 };
 //#endregion
-//#region ../api/src/defineEndpointDefinitions.ts
-/**
-* Validates extracted endpoint descriptors while preserving each literal path,
-* method, and parameter contract for the typed URL builders.
-*/
-function defineEndpointDefinitions(definitions) {
-	return definitions;
-}
-//#endregion
 //#region ../api/src/appointmentEndpointDefinitions.ts
 const APPOINTMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	...defineEndpointDefinitions({
+		listGroupedAppointmentServices: {
+			path: "/sites/{siteId}/bookings/services/grouped",
+			method: "GET",
+			auth: "user",
+			responseKind: "json",
+			errors: ["server:internal_error"]
+		},
+		reorderAppointmentServices: {
+			path: "/sites/{siteId}/bookings/services/order",
+			method: "PUT",
+			auth: "user",
+			responseKind: "json",
+			errors: [
+				"validation:invalid_input",
+				"auth:forbidden",
+				"resource:not_found",
+				"resource:conflict",
+				"server:internal_error"
+			]
+		},
+		listAppointmentServiceCategories: {
+			path: "/sites/{siteId}/bookings/service-categories",
+			method: "GET",
+			auth: "user",
+			responseKind: "json",
+			errors: ["server:internal_error"]
+		},
+		createAppointmentServiceCategory: {
+			path: "/sites/{siteId}/bookings/service-categories",
+			method: "POST",
+			auth: "user",
+			responseKind: "json",
+			errors: [
+				"validation:invalid_input",
+				"auth:forbidden",
+				"resource:conflict",
+				"server:internal_error"
+			]
+		},
+		updateAppointmentServiceCategory: {
+			path: "/sites/{siteId}/bookings/service-categories/{categoryId}",
+			method: "PUT",
+			auth: "user",
+			responseKind: "json",
+			errors: [
+				"validation:invalid_input",
+				"auth:forbidden",
+				"resource:not_found",
+				"resource:conflict",
+				"server:internal_error"
+			]
+		},
+		deleteAppointmentServiceCategory: {
+			path: "/sites/{siteId}/bookings/service-categories/{categoryId}",
+			method: "DELETE",
+			auth: "user",
+			responseKind: "json",
+			errors: [
+				"auth:forbidden",
+				"resource:not_found",
+				"server:internal_error"
+			]
+		},
+		reorderAppointmentServiceCategories: {
+			path: "/sites/{siteId}/bookings/service-categories/order",
+			method: "PUT",
+			auth: "user",
+			responseKind: "json",
+			errors: [
+				"validation:invalid_input",
+				"auth:forbidden",
+				"resource:conflict",
+				"server:internal_error"
+			]
+		}
+	}),
 	listAppointmentResources: {
 		path: "/sites/{siteId}/bookings/resources",
 		method: "GET",
@@ -9661,39 +9947,6 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		auth: "user",
 		responseKind: "json",
 		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
-	},
-	listNewsletterSendJobs: {
-		path: "/sites/{siteId}/newsletter/jobs",
-		method: "GET",
-		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
-		auth: "user",
-		responseKind: "json"
-	},
-	retryNewsletterSendJob: {
-		path: "/sites/{siteId}/newsletter/jobs/{jobId}/retry",
-		method: "POST",
-		errors: [
-			"validation:invalid_input",
-			"resource:not_found",
-			"auth:forbidden",
-			"server:internal_error"
-		],
-		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
-		auth: "user",
-		responseKind: "json"
-	},
-	cancelNewsletterSendJob: {
-		path: "/sites/{siteId}/newsletter/jobs/{jobId}/cancel",
-		method: "POST",
-		errors: [
-			"validation:invalid_input",
-			"resource:not_found",
-			"auth:forbidden",
-			"server:internal_error"
-		],
-		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
-		auth: "user",
-		responseKind: "json"
 	}
 });
 //#endregion
@@ -10459,6 +10712,7 @@ const BILLING_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 ({
+	...PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS,
 	...ACCOUNT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_EVENT_ENDPOINT_DEFINITIONS,
@@ -12819,11 +13073,260 @@ function cardRoleFromLegacyVocabulary(value) {
 */
 const cardRoleWithLegacyAliasSchema = z.preprocess((value) => cardRoleFromLegacyVocabulary(value) ?? value, cardRoleSchema);
 //#endregion
-//#region ../theme-core/src/site-styles/compilationPlan.ts
-const defaultHeaderBrandPreferences = {
-	brandDisplay: "auto",
-	logoSize: "auto"
-};
+//#region ../theme-core/src/site-styles/transitionCatalogue.ts
+/**
+* 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.
+*/
+const transitionCatalogueFamilies = [
+	{
+		id: "gradient",
+		label: "Gradient"
+	},
+	{
+		id: "wave",
+		label: "Wave"
+	},
+	{
+		id: "angle",
+		label: "Angle"
+	}
+];
+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
+			}
+		}
+	},
+	{
+		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
+			}
+		}
+	},
+	{
+		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
+			}
+		}
+	}
+]);
 //#endregion
 //#region ../theme-core/src/site-styles/sectionTransitions.ts
 function boundaryRuntimeMetrics(family, size, heightExpression) {
@@ -12834,42 +13337,106 @@ function boundaryRuntimeMetrics(family, size, heightExpression) {
 		reserveCss: `calc((${heightExpression}) / 2)`
 	};
 }
-boundaryRuntimeMetrics("gradient", "medium", "6rem + 2px"), boundaryRuntimeMetrics("gradient", "spacious", "10rem"), boundaryRuntimeMetrics("gradient", "expansive", "14rem"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("wave", "large", "7rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("angle", "large", "7rem + 2px");
+new Map(transitionCatalogueEntries.map((entry) => [entry.intent, entry]));
+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 === void 0) throw new Error(`Transition catalogue has no entry for ${intent}`);
+	return value;
+}
 const noneBoundaryOption = {
 	id: asBoundaryOptionId("break:none"),
 	label: "None",
 	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 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");
+boundaryOptionForTransitionIntent("soft-fade-expansive");
+boundaryOptionForTransitionIntent("wave-edge");
+boundaryOptionForTransitionIntent("wave-edge-balanced");
+boundaryOptionForTransitionIntent("wave-edge-gentle");
+boundaryOptionForTransitionIntent("wave-edge-bold");
+boundaryOptionForTransitionIntent("wave-edge-drift");
+boundaryOptionForTransitionIntent("angle-edge-subtle");
+boundaryOptionForTransitionIntent("angle-edge");
+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 spaciousBoundaryOption = {
-	id: asBoundaryOptionId("break:spacious"),
-	label: "Spacious",
-	transitionAfter: "soft-fade-long",
-	treatment: {
-		kind: "soft-fade",
-		height: "large",
-		curve: "spacious"
-	}
+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.`)
+}))];
+new Map(boundaryOptions.map((option) => [option.id, option]));
+new Map(boundaryOptions.map((option) => [stableTreatmentKey(option.treatment), option]));
+new Map(sectionTransitionFamilies.flatMap((family) => family.variants.map((variant) => [variant.boundaryOption.id, variant])));
+new Map(sectionTransitionFamilies.map((family) => [family.id, family]));
+function stableTreatmentKey(treatment) {
+	switch (treatment.kind) {
+		case "none": return "none";
+		case "soft-fade": return `${treatment.kind}:${treatment.height}:${treatment.curve}`;
+		case "wave-edge": return [
+			treatment.kind,
+			treatment.height,
+			treatment.amplitude,
+			treatment.rhythm,
+			treatment.symmetry
+		].join(":");
+		case "angle-edge": return [
+			treatment.kind,
+			treatment.height,
+			treatment.slope,
+			treatment.direction
+		].join(":");
+		case "legacy-unsupported": return `${treatment.kind}:${treatment.boundaryOptionId}`;
+	}
+}
+requireThemeColorToken$1("background");
+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/compilationPlan.ts
+const defaultHeaderBrandPreferences = {
+	brandDisplay: "auto",
+	logoSize: "auto"
 };
-asBoundaryOptionId("break:expansive");
-asBoundaryOptionId("break:wave");
-asBoundaryOptionId("break:wave-balanced");
-asBoundaryOptionId("break:wave-gentle");
-asBoundaryOptionId("break:wave-bold");
-asBoundaryOptionId("break:wave-drift");
-asBoundaryOptionId("break:angle-subtle");
-asBoundaryOptionId("break:angle-balanced");
-asBoundaryOptionId("break:angle-steep");
 asBoundaryOptionId("break:unknown");
 const pageDesignUserPinnedAppearanceChoiceSchema = z.object({
 	kind: z.literal("user-pinned"),
@@ -12996,14 +13563,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/accordions/siteStyleDefaults.ts
 /**
@@ -14631,6 +15195,13 @@ z.object({
 	fields: nonEmptyRuntimeStyleFieldNamesSchema,
 	authority: styleAuthoritySchema
 }).strict();
+asPageFlowPresetId("flow:quiet"), noneBoundaryOption.id, asPageFlowPresetId("flow:balanced"), softBoundaryOption.id, asPageFlowPresetId("flow:expressive"), spaciousBoundaryOption.id;
+asPageFlowPresetId("generated-default");
+asSiteStyleId("site-style:south-west-twerk-school");
+asAppearancePresetId("hero-brand-scrim-fixed-frame");
+asLayoutVariantKey("classic");
+asLayoutVariantKey("micro");
+asBoundaryOptionId("break:wave");
 //#endregion
 //#region ../theme-core/src/site-styles/runtimeCompiler.ts
 function defineSectionForegroundRuntimeTokens(input) {
@@ -14654,7 +15225,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: {
@@ -14689,8 +15260,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
@@ -16425,19 +16995,11 @@ const curatedSiteStyles = [
 	})
 ];
 new Map(curatedSiteStyles.map((style) => [style.id, style]));
-asPageFlowPresetId("generated-default");
-asSiteStyleId("site-style:south-west-twerk-school");
-asAppearancePresetId("hero-brand-scrim-fixed-frame");
-asLayoutVariantKey("classic");
-asLayoutVariantKey("micro");
-asBoundaryOptionId("break:wave");
-asPageFlowPresetId("flow:quiet"), noneBoundaryOption.id, asPageFlowPresetId("flow:balanced"), softBoundaryOption.id, asPageFlowPresetId("flow:expressive"), spaciousBoundaryOption.id;
 //#endregion
 //#region ../theme-core/src/site-styles/resolver.ts
 const blockDesignFallback = {
 	sectionSurface: "base",
 	contentFrame: plainFrame,
-	transitionAfter: "none",
 	sectionHeight: "default",
 	heroLegibility: "none",
 	imageSurfaceTreatment: { kind: "none" },
@@ -16448,7 +17010,7 @@ const blockDesignFallback = {
 	accordionIconTreatment: null,
 	composition: null
 };
-blockDesignFallback.sectionSurface, blockDesignFallback.contentFrame, blockDesignFallback.transitionAfter, blockDesignFallback.sectionHeight, blockDesignFallback.heroLegibility, blockDesignFallback.imageSurfaceTreatment, blockDesignFallback.imageSurfaceMotion, blockDesignFallback.tileTreatment, blockDesignFallback.eventListTreatment, blockDesignFallback.eyebrowTreatment, blockDesignFallback.accordionIconTreatment, blockDesignFallback.composition;
+blockDesignFallback.sectionSurface, blockDesignFallback.contentFrame, blockDesignFallback.sectionHeight, blockDesignFallback.heroLegibility, blockDesignFallback.imageSurfaceTreatment, blockDesignFallback.imageSurfaceMotion, blockDesignFallback.tileTreatment, blockDesignFallback.eventListTreatment, blockDesignFallback.eyebrowTreatment, blockDesignFallback.accordionIconTreatment, blockDesignFallback.composition;
 //#endregion
 //#region ../theme-core/src/site-styles/siteChromeBackgrounds.ts
 const siteChromeBackgroundColorTokens = toSiteChromeBackgroundColorTokens(backgroundAppearanceColorTokenNames);
@@ -17041,7 +17603,8 @@ const siteOptionSources = [
 	"eventCategories",
 	"eventSeries",
 	"venues",
-	"staffMembers"
+	"staffMembers",
+	"appointmentServiceCategories"
 ];
 const mediaDeliverySchema = z.object({
 	sizes: z.string().optional(),
@@ -21119,9 +21682,7 @@ function navRow(opts) {
 		rel: { $bind: { from: `${childItemName}.rel` } },
 		"data-active": { $bind: { from: `${childItemName}.active` } }
 	}, [text({ as: "span" }, bind(`${childItemName}.label`))], repeat(`${itemName}.children`, childItemName));
-	const dropdown = el("div", { className: "nav-dropdown rb-relative" }, [button({
-		type: "button",
-		variantId: "",
+	const dropdown = el("div", { className: "nav-dropdown rb-relative" }, [el("headerControl", {
 		className: prependClassName("nav-dropdown-trigger", linkClassName),
 		"aria-haspopup": "menu",
 		"aria-expanded": "false",
@@ -21189,9 +21750,7 @@ function navColumn(opts) {
 	const dropdown = el("div", {
 		className: "nav-mobile-dropdown",
 		"data-nav-mobile-dropdown": "true"
-	}, [button({
-		type: "button",
-		variantId: "",
+	}, [el("headerControl", {
 		className: triggerClassName,
 		"aria-expanded": "false",
 		"aria-controls": childrenId,
@@ -27503,6 +28062,49 @@ const layoutTransforms = [
 	footerLogoMediaClassTransform,
 	footerLogoTextVisibleTransform
 ];
+//#endregion
+//#region ../blocks/src/system/transforms/registry/chromeLogo.ts
+const chromeLogoSchema = z.object({ surface: z.enum([
+	"header-root",
+	"header-mobile-panel",
+	"footer-root"
+]) });
+/** The brand foreground shares the logo's surface; navigation may own a separate capsule. */
+function chromeSurfaceTextToken(surface, theme, palette) {
+	switch (surface) {
+		case "header-root": {
+			const header = theme.header;
+			const foreground = resolveHeaderRootForeground(header, palette, resolveHeaderVisualStyles(header).isTransparent);
+			return foreground.kind === "known" ? foreground.roles.text : resolveHeaderLeafTextColor(header);
+		}
+		case "header-mobile-panel": return theme.header?.dropdownStyle?.textColor ?? "text";
+		case "footer-root": {
+			const foreground = resolveFooterRootForeground(theme.footer, palette);
+			return foreground.kind === "known" ? foreground.roles.text : void 0;
+		}
+	}
+}
+function readChromeTheme(viewModel) {
+	return asPartialObject(asPartialObject(viewModel?.["$root"])?.theme) ?? {};
+}
+function resolveChromeSurfaceTone(surface, context) {
+	return surfaceToneFromForegroundToken(context.theme.palette, chromeSurfaceTextToken(surface, readChromeTheme(context.viewModel), context.theme.palette));
+}
+const chromeLogoTransforms = [{
+	id: "layout.chromeLogo",
+	kind: "formatter",
+	summary: "Select the light- or dark-background site logo for a header or footer surface",
+	schema: chromeLogoSchema,
+	run: (value, options, context) => {
+		const content = asPartialObject(value);
+		const variants = asPartialObject(content?.logoVariants);
+		if (!variants) return content?.logo ?? null;
+		return selectLogoVariant(resolveChromeSurfaceTone(options.surface, context), {
+			forLightBackgrounds: variants.forLightBackgrounds ?? null,
+			forDarkBackgrounds: variants.forDarkBackgrounds ?? null
+		});
+	}
+}];
 const headerRuntimeTransforms = [{
 	id: "layout.headerRuntimeContract",
 	kind: "formatter",
@@ -27702,46 +28304,42 @@ const whenTransformed = (from, transformId, equals = true) => (node) => ({
 		equals
 	}
 });
-const logoRow = link({
+/** Draw whichever site logo suits the surface this row sits on. */
+const bindChromeLogo = (surface) => bind("content", { transforms: [{
+	id: "layout.chromeLogo",
+	options: { surface }
+}] });
+/**
+* The brand link. The logo is chosen per surface because the open mobile menu
+* paints its own background, which may be the opposite tone to the header.
+*/
+const createLogoRow = (surface) => link({
 	href: "/",
 	className: bindProp("$root.theme.header.logo", {
 		transforms: pipe(tx("layout.headerLogoClass")),
 		fallback: "header-logo rb-flex rb-min-w-0 rb-items-center rb-gap-3 rb-no-underline rb-transition-opacity rb-hover-opacity-80"
 	})
-}, [
-	media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("content.logo"), bind("content.logo")),
-	stack({ className: "rb-contents" }, [media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-	text({
-		as: "strong",
-		className: "header-logo-text rb-truncate"
-	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-]);
+}, [media({ className: bindProp("$root.theme.header.logo", {
+	transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
+	fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
+}) }, when("content.logo"), bindChromeLogo(surface)), text({
+	as: "strong",
+	className: "header-logo-text rb-truncate"
+}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))]);
+const logoRow = createLogoRow("header-root");
 const centeredLogoRow = link({
 	href: "/",
 	className: bindProp("$root.theme.header.logo", {
 		transforms: pipe(tx("layout.headerLogoClass", { base: "header-logo rb-flex rb-items-center rb-justify-center rb-gap-3 rb-text-center rb-no-underline rb-transition-opacity rb-hover-opacity-80" })),
 		fallback: "header-logo rb-flex rb-items-center rb-justify-center rb-gap-3 rb-text-center rb-no-underline rb-transition-opacity rb-hover-opacity-80"
 	})
-}, [
-	media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("content.logo"), bind("content.logo")),
-	stack({ className: "rb-contents" }, [media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-	text({
-		as: "strong",
-		className: "header-logo-text"
-	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-]);
+}, [media({ className: bindProp("$root.theme.header.logo", {
+	transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
+	fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
+}) }, when("content.logo"), bindChromeLogo("header-root")), text({
+	as: "strong",
+	className: "header-logo-text"
+}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))]);
 const createNavRow = (className, align = "end") => navRow({
 	className: `${className} header-nav-row`,
 	align,
@@ -27781,10 +28379,8 @@ const mobileToggleIcon = stack({
 	}
 ]);
 const mobileToggleButton = {
-	type: "button",
+	type: "headerControl",
 	props: {
-		type: "button",
-		variantId: "",
 		className: `nav-mobile-toggle ${mobileOnlyDisplay("inline-flex")} rb-h-10 rb-w-10 rb-items-center rb-justify-center rb-rounded-md transition-theme-standard`,
 		"aria-label": "Open menu",
 		"aria-expanded": "false",
@@ -27794,10 +28390,8 @@ const mobileToggleButton = {
 	children: [mobileToggleIcon]
 };
 const mobileOverlayToggleButton = {
-	type: "button",
+	type: "headerControl",
 	props: {
-		type: "button",
-		variantId: "",
 		className: "nav-mobile-toggle rb-inline-flex rb-h-10 rb-w-10 rb-items-center rb-justify-center rb-rounded-md transition-theme-standard",
 		"aria-label": "Open menu",
 		"aria-expanded": "false",
@@ -27821,7 +28415,7 @@ const mobileOverlayHeader = inline({
 	align: "center",
 	justify: "between",
 	style: borderColorStyle("border")
-}, [logoRow, mobileOverlayToggleButton]);
+}, [createLogoRow("header-mobile-panel"), mobileOverlayToggleButton]);
 const mobileOverlayBody = stack({
 	className: "rb-flex-1 rb-px-6 rb-py-6",
 	gap: "md",
@@ -28008,7 +28602,10 @@ const brandLogo = link({
 		options: { base: "rb-h-10 rb-w-auto" }
 	}],
 	fallback: "rb-h-10 rb-w-auto"
-} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content.logo")), text({
+} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content", { transforms: [{
+	id: "layout.chromeLogo",
+	options: { surface: "footer-root" }
+}] })), text({
 	as: "strong",
 	className: "footer-logo-text rb-nav-text"
 }, when("module.showTitle", { equals: true }), bind("site.title", { fallback: "Your Site" }))], when("module.kind", { equals: "brand" }));
@@ -29701,6 +30298,15 @@ const appointmentServicesBlockDefinition = {
 				required: false,
 				ui: { intent: "content" }
 			},
+			createSiteOptionSelectField({
+				id: "categoryId",
+				label: "Category",
+				description: "Show one category (with its heading and intro), or leave it on All categories to show everything grouped.",
+				required: false,
+				multiple: false,
+				optionSource: "appointmentServiceCategories",
+				ui: { intent: "content" }
+			}),
 			sectionStylesField({
 				id: "_sectionStyles",
 				label: "Section styles",
@@ -29735,6 +30341,7 @@ const appointmentServicesBlockDefinition = {
 				richText({ className: "rb-prose rb-max-w-none" }, bind("content.description"), when("content.description")),
 				el("appointment-services", {
 					sectionHeading: { $bind: { from: "content.heading" } },
+					categoryId: { $bind: { from: "content.categoryId" } },
 					services: { $bind: { from: "data.services" } },
 					pathname: { $bind: { from: "$root.pathname" } },
 					servicePathPrefix: { $bind: { from: "$root.appointmentServicePathPrefix" } }
@@ -30209,6 +30816,12 @@ const occurrenceContextSchema = z.object({
 	capacityOverride: z.number().nullable().optional(),
 	overrides: z.record(z.string(), z.unknown()).nullable().optional()
 }).nullable();
+//#endregion
+//#region ../blocks/src/system/runtime/api/readAuthority.ts
+const browserReadAuthoritySchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("published") }).strict(), z.object({
+	kind: z.literal("preview"),
+	token: z.string().min(1)
+}).strict()]);
 const unsupportedEventRegistrationPageSurfaceSubjectSchema = z.object({
 	kind: z.literal("unsupported"),
 	reason: z.enum([
@@ -30471,6 +31084,7 @@ const eventRegistrationSourceSchema = z.object({
 	apiBaseUrl: z.string().optional(),
 	portalToken: z.string().nullable().optional(),
 	previewToken: z.string().nullable().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	...eventRegistrationHydrationSchemaShape,
 	events: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
 	wholeSeriesRunEvents: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
@@ -30508,6 +31122,7 @@ z.object({
 	apiBaseUrl: z.string().optional(),
 	portalToken: z.string().nullable().optional(),
 	previewToken: z.string().nullable().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 function buildEventRegistrationDisplayFromScopedEvents(source, scopedSourceEvents) {
@@ -30766,6 +31381,7 @@ const eventRegistrationBlockDefinition = {
 				text({ as: "h2" }, bind("content.heading"), when("content.heading")),
 				richText({ className: "rb-prose rb-max-w-none" }, bind("content.description"), when("content.description")),
 				eventRegistration(withApiBindings({
+					readAuthority: { $bind: { from: "$root.readAuthority" } },
 					occurrenceContext: { $bind: { from: "$root.occurrenceContext" } },
 					subject: { $bind: { from: "$root.subject" } },
 					portalToken: { $bind: {
@@ -31417,6 +32033,7 @@ const eventCollectionSourceSchemaShape = {
 	events: z.array(publicEventSchema).nullable().optional(),
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional(),
 	listLayout: eventLayoutSchema.optional(),
 	listColumns: columnOptionSchema.optional(),
@@ -31469,7 +32086,6 @@ const eventCollectionDisplaySchemaShape = {
 const eventCollectionHydrationSchema = z.object({
 	siteId: z.string(),
 	calendarWindow: calendarWindowPageSchema.optional(),
-	stage: previewStageSchema.optional(),
 	prefetchedEvents: z.boolean(),
 	eventSurface: eventSurfaceScopeSchema$1,
 	filterEventPresets: z.string().nullable(),
@@ -31544,7 +32160,6 @@ function buildEventCollectionHydration(source, now = /* @__PURE__ */ new Date())
 	return {
 		calendarWindow: source.calendarWindow ?? void 0,
 		siteId: source.siteId,
-		stage: source.stage,
 		prefetchedEvents: source.events != null,
 		eventSurface: selected ? "all" : normalizeEventSurfaceScope(source.eventSurface),
 		filterEventPresets: selected ? null : normalizeEventSurfacePresetsCsv(source.filterEventPresets),
@@ -31564,6 +32179,7 @@ const eventListingSourceSchema = z.object({
 	events: z.array(publicEventSchema).nullable().optional(),
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional(),
 	layout: eventLayoutSchema.optional(),
 	columns: columnOptionSchema.optional(),
@@ -31604,7 +32220,6 @@ const eventListingDisplaySchema = z.object({
 });
 const eventListingHydrationSchema = z.object({
 	siteId: z.string(),
-	stage: previewStageSchema.optional(),
 	eventsPerPage: eventPageSizeSchema,
 	paginationAction: eventListPaginationActionSchema,
 	showFilters: z.boolean(),
@@ -31627,6 +32242,7 @@ const eventListingRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const eventListingBlockRuntime = defineProgressiveBlockRuntime({
@@ -31661,7 +32277,6 @@ const eventListingBlockRuntime = defineProgressiveBlockRuntime({
 			},
 			hydration: {
 				siteId: source.siteId,
-				stage: source.stage,
 				eventsPerPage: pageSize,
 				paginationAction: resolveEventListPaginationAction({
 					paginationMode: source.paginationMode,
@@ -31943,6 +32558,7 @@ const eventListingBlockDefinition = {
 				rootType: "stack",
 				rootProps: { gap: "lg" },
 				children: [...eventSectionHeaderLayoutNodes(), el("event-listing", withApiBindings({
+					readAuthority: { $bind: { from: "$root.readAuthority" } },
 					events: { $bind: { from: "data.events" } },
 					stage: { $bind: {
 						from: "$root.previewStage",
@@ -32140,6 +32756,7 @@ const eventCalendarRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 /**
@@ -32161,7 +32778,7 @@ function buildEventCalendarDisplay(source) {
 			listColumns: source.listColumns ?? source.columns
 		}),
 		kind: "event-calendar",
-		displayMode: normalizeEventCalendarDisplayMode$1(source) ?? "combined",
+		displayMode: resolveEventCalendarReadPlan(source).mode,
 		className: source.className ?? null,
 		events: (source.events ?? []).slice().sort((left, right) => new Date(left.startsAt).getTime() - new Date(right.startsAt).getTime()),
 		boardTitle: normalizeOptionalText(source.boardTitle),
@@ -32178,13 +32795,16 @@ const eventCalendarBlockRuntime = defineProgressiveBlockRuntime({
 		source: createZodCodec(eventCalendarSourceSchema),
 		render: createZodCodec(eventCalendarRenderSchema)
 	},
-	buildRender: (source) => ({
-		display: buildEventCalendarDisplay(source.calendarWindow && (source.variant ?? source.displayMode ?? "combined") !== "combined" && (source.variant ?? source.displayMode) !== "list" ? {
-			...source,
-			events: source.calendarWindow.events
-		} : source),
-		hydration: buildEventCollectionHydration(source)
-	})
+	buildRender: (source) => {
+		const plan = resolveEventCalendarReadPlan(source);
+		return {
+			display: buildEventCalendarDisplay(source.calendarWindow && plan.jobs === "calendar" ? {
+				...source,
+				events: source.calendarWindow.events
+			} : source),
+			hydration: buildEventCollectionHydration(source)
+		};
+	}
 });
 //#endregion
 //#region ../blocks/src/system/blocks/events/eventCalendarDataLoaders.ts
@@ -32334,6 +32954,7 @@ const eventCalendarLayout = [styledSection({
 		rootType: "stack",
 		rootProps: { gap: "lg" },
 		children: [...eventSectionHeaderLayoutNodes({ splitClassName: "event-section-head event-section-head--split" }), el("event-calendar", withApiBindings({
+			readAuthority: { $bind: { from: "$root.readAuthority" } },
 			events: { $bind: { from: "data.events" } },
 			calendarWindow: { $bind: { from: "data.calendarWindow" } },
 			stage: { $bind: {
@@ -36121,6 +36742,7 @@ const shopSourceSchema = z.object({
 	products: z.array(publicProductSchema).nullable().optional(),
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const productVariantOptionDisplaySchema = z.object({
@@ -36288,6 +36910,7 @@ function resolveShowPricePerCredit(source) {
 z.object({
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const shopBlockRuntime = defineProgressiveBlockRuntime({
@@ -36628,6 +37251,7 @@ const shopBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([shop(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "passes-memberships",
 				showPasses: { $bind: {
 					from: "content.showPasses",
@@ -36826,6 +37450,7 @@ const productListBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productList(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-list",
 				heading: { $bind: {
 					from: "content.heading",
@@ -36968,6 +37593,7 @@ const productDetailBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productDetail(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-detail",
 				heading: { $bind: {
 					from: "content.heading",
@@ -37084,6 +37710,7 @@ const cartBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([cart(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "cart",
 				heading: { $bind: {
 					from: "content.heading",
@@ -37167,6 +37794,7 @@ const checkoutBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([checkout(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "checkout",
 				heading: { $bind: {
 					from: "content.heading",
@@ -39839,8 +40467,8 @@ const defaultTransforms = createTransformRegistry([
 		summary: "Choose the read projection required by the calendar display mode",
 		schema: z.object({ job: z.enum(["list", "calendar"]) }),
 		run(value, options) {
-			const mode = normalizeEventCalendarDisplayMode$1(asPartialObject(value) ?? {}) ?? "combined";
-			return options.job === "calendar" ? mode !== "list" : mode === "list" || mode === "combined";
+			const plan = resolveEventCalendarReadPlan(asPartialObject(value) ?? {});
+			return plan.jobs === "both" || plan.jobs === options.job;
 		}
 	},
 	{
@@ -39853,6 +40481,7 @@ const defaultTransforms = createTransformRegistry([
 	},
 	...formattingTransforms,
 	...layoutTransforms,
+	...chromeLogoTransforms,
 	...uiTransforms,
 	...mediaTransforms,
 	...backgroundTransforms,
@@ -40185,6 +40814,17 @@ function coerceToString(value) {
 	return "";
 }
 /**
+* The appointment-services catalogue (issue 1403) pairs the services with the
+* site's ordered categories. Both are needed to group them, so that response
+* is passed through whole; any other `{ services }` wrapper is unwrapped.
+*/
+function coerceServicesPayload(record) {
+	return Array.isArray(record.services) && Array.isArray(record.categories) ? {
+		services: record.services,
+		categories: record.categories
+	} : record.services;
+}
+/**
 * Extract data from API response.
 * Unwraps common response wrappers: { data }, { form }, { entries }, { services }, { teamMembers }
 *
@@ -40199,7 +40839,7 @@ function coercePayload(payload) {
 		if ("data" in record && typeof record.data !== "function") return record.data;
 		if ("form" in record && typeof record.form !== "function") return record.form;
 		if ("entries" in record && typeof record.entries !== "function") return record.entries;
-		if ("services" in record && typeof record.services !== "function") return record.services;
+		if ("services" in record && typeof record.services !== "function") return coerceServicesPayload(record);
 		if ("teamMembers" in record && typeof record.teamMembers !== "function") return record.teamMembers;
 	}
 	return payload;
@@ -41101,7 +41741,12 @@ const appointmentSetupServiceDraftSchema = z.object({
 	venue: appointmentSetupVenueChoiceSchema,
 	timezone: z.string().trim().min(1).nullable(),
 	payment: appointmentSetupPaymentDraftSchema,
-	assignment: appointmentSetupServiceAssignmentDraftSchema
+	assignment: appointmentSetupServiceAssignmentDraftSchema,
+	/**
+	* The service's category, or null for "Other" (issue 1403). Omitted leaves
+	* an existing service's category alone and puts a new one in "Other".
+	*/
+	categoryId: z.string().uuid().nullable().optional()
 }).superRefine((service, ctx) => {
 	if (service.payment.kind !== "free" && (service.priceAmount === null || service.priceAmount <= 0)) ctx.addIssue({
 		code: "custom",
@@ -42037,7 +42682,7 @@ function usePage(params) {
 					loading: false,
 					error: null,
 					page: pageOutline,
-					runtimeBoundaries: pageData.runtimeBoundaries,
+					runtimeJoins: pageData.runtimeJoins,
 					theme: requireSdkTheme(site.theme, siteId),
 					siteId,
 					resolvedData,