@riverbankcms/sdk 0.144.0 → 0.146.0

package/dist/server/data.mjs

@@ -898,15 +898,6 @@ function parseMailingListContentVersionId(value) {
 	const parsed = parseContentVersionId(value);
 	return parsed.ok ? parsed.value : null;
 }
-function buildMailingListSignupBlockSourceRef(blockId, contentVersionId) {
-	const parsedBlockId = parseMailingListBlockId(blockId);
-	const parsedContentVersionId = parseMailingListContentVersionId(contentVersionId);
-	return parsedBlockId !== null && parsedContentVersionId !== null ? {
-		tag: "block_ref",
-		blockId: parsedBlockId,
-		contentVersionId: parsedContentVersionId
-	} : null;
-}
 //#endregion
 //#region ../core/src/secret.ts
 /**
@@ -6669,6 +6660,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)}`);
 }
@@ -6871,16 +6871,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";
@@ -8005,6 +8007,7 @@ const publicEventLoaderQuerySchemaShape = {
 	seriesSlug: z.string().optional(),
 	includeOccurrenceId: z.string().optional(),
 	readIntent: z.string().optional(),
+	detailAdmission: z.string().optional(),
 	detailLevel: z.string().optional(),
 	readProfile: z.string().optional()
 };
@@ -8171,11 +8174,11 @@ const publicEventBookingAvailabilitySchema = z.discriminatedUnion("kind", [z.obj
 		"series_archived",
 		"parent_archived",
 		"parent_inconsistent",
-		"not_public",
 		"already_started",
 		"enrollment_closed"
 	])
 })]);
+const publicEventBookingClosedDetailSchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("opensSoon") }), z.object({ kind: z.literal("paused") })]);
 const publicRunSessionSchema = z.object({
 	occurrenceId: z.string(),
 	startsAt: z.string(),
@@ -8220,6 +8223,7 @@ const publicEventBaseSchema = z.object({
 	destination: publicEventDestinationSchema,
 	requiresRegistration: z.boolean(),
 	bookingAvailability: publicEventBookingAvailabilitySchema,
+	bookingClosedDetail: publicEventBookingClosedDetailSchema.optional(),
 	deliveryMode: z.enum([
 		"in_person",
 		"online",
@@ -8504,6 +8508,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 {
@@ -8595,17 +8668,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",
@@ -9316,6 +9457,13 @@ const EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS = defineEndpointDefinitions
 		errors: [],
 		responseKind: "blob"
 	},
+	exportEventOfferingRegistrationsCsv: {
+		path: "/sites/{siteId}/bookings/event-offerings/{eventOfferingId}/registrations/export.csv",
+		method: "GET",
+		auth: "user",
+		errors: [],
+		responseKind: "blob"
+	},
 	updateEventSeriesRegistration: {
 		path: "/sites/{siteId}/bookings/event-series/{seriesId}/registrations/{registrationId}",
 		method: "PATCH",
@@ -9326,6 +9474,19 @@ const EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS = defineEndpointDefinitions
 			"resource:not_found",
 			"server:internal_error"
 		]
+	},
+	saveEventSeriesRegistrationAnswers: {
+		path: "/sites/{siteId}/bookings/event-series/{seriesId}/registrations/{registrationId}/answers",
+		method: "PUT",
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"auth:forbidden",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
 	}
 });
 //#endregion
@@ -9746,46 +9907,185 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json",
 		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
 	},
-	testSendNewsletterCampaign: {
-		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/test-send",
+	scheduleNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/schedule",
 		method: "POST",
 		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
 		auth: "user",
 		responseKind: "json",
 		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
 	},
-	listNewsletterSendJobs: {
-		path: "/sites/{siteId}/newsletter/jobs",
-		method: "GET",
+	unscheduleNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/unschedule",
+		method: "POST",
 		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
 		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	},
+	stopNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/stop",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	},
+	testSendNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/test-send",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	}
+});
+//#endregion
+//#region ../api/src/sdkEventEndpointDefinitions.ts
+/**
+* The SDK's Event graph: the Events themselves and the occurrences of one run.
+* Extracted from `endpoints.ts` so this family can be read, and added to, on
+* its own. New entries here must declare `errors`; the
+* require-api-endpoint-errors lint enforces that here as in endpoints.ts.
+*/
+const SDK_EVENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	sdkListEvents: {
+		path: "/sdk/{siteId}/events",
+		method: "GET",
+		auth: "service",
 		responseKind: "json"
 	},
-	retryNewsletterSendJob: {
-		path: "/sites/{siteId}/newsletter/jobs/{jobId}/retry",
+	sdkUpsertEvent: {
+		path: "/sdk/{siteId}/events",
 		method: "POST",
+		auth: "service",
+		responseKind: "json",
 		errors: [
 			"validation:invalid_input",
 			"resource:not_found",
-			"auth:forbidden",
+			"resource:conflict",
+			"billing:plan_limit_exceeded",
 			"server:internal_error"
-		],
-		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
-		auth: "user",
+		]
+	},
+	sdkGetEvent: {
+		path: "/sdk/{siteId}/events/{identifier}",
+		method: "GET",
+		auth: "service",
 		responseKind: "json"
 	},
-	cancelNewsletterSendJob: {
-		path: "/sites/{siteId}/newsletter/jobs/{jobId}/cancel",
+	sdkDeleteEvent: {
+		path: "/sdk/{siteId}/events/{identifier}",
+		method: "DELETE",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkTakeEventOffline: {
+		path: "/sdk/{siteId}/events/{identifier}/lifecycle",
 		method: "POST",
+		auth: "service",
+		responseKind: "json",
 		errors: [
+			"resource:not_found",
 			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkListEventOccurrences: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences",
+		method: "GET",
+		auth: "service",
+		responseKind: "json",
+		errors: [
 			"resource:not_found",
-			"auth:forbidden",
+			"validation:invalid_input",
 			"server:internal_error"
-		],
-		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
-		auth: "user",
-		responseKind: "json"
+		]
+	},
+	sdkAddEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkUpdateEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}",
+		method: "PATCH",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkCancelEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}/cancel",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkDeleteEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}",
+		method: "DELETE",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	}
+});
+//#endregion
+//#region ../api/src/sdkPageDesignEndpointDefinitions.ts
+/**
+* SDK management endpoints for a page's draft design (issue 1497), spread into
+* `ENDPOINT_DEFINITIONS` like the other endpoint-definition modules. New
+* entries here must declare `errors`, which the require-api-endpoint-errors
+* lint enforces.
+*/
+const SDK_PAGE_DESIGN_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	sdkGetPageDesign: {
+		path: "/sdk/{siteId}/pages/{identifier}/design",
+		method: "GET",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"server:internal_error"
+		]
+	},
+	sdkSavePageDesign: {
+		path: "/sdk/{siteId}/pages/{identifier}/design",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
 	}
 });
 //#endregion
@@ -10033,6 +10333,45 @@ const SITE_API_KEY_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
+//#region ../api/src/siteManagementEndpointDefinitions.ts
+const SITE_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	createSite: {
+		path: "/sites/manage",
+		method: "POST",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json"
+	},
+	updateSite: {
+		path: "/sites/manage",
+		method: "PUT",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json"
+	},
+	changeSiteAddress: {
+		path: "/sites/{siteId}/address",
+		method: "PUT",
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_DISABLED
+	},
+	getSiteAddressAvailability: {
+		path: "/sites/{siteId}/address/availability",
+		method: "GET",
+		auth: "user",
+		responseKind: "json"
+	},
+	deleteSite: {
+		path: "/sites/{siteId}",
+		method: "DELETE",
+		tags: ["site", "site-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	}
+});
+//#endregion
 //#region ../api/src/eventManagementEndpointDefinitions.ts
 const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	listEvents: {
@@ -10080,6 +10419,28 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"server:internal_error"
 		]
 	},
+	/**
+	* The web address of an event's own page. A course page belongs to the
+	* event itself, so its address is written here rather than through a run.
+	*/
+	updateEventAddress: {
+		path: "/sites/{siteId}/bookings/events/{eventId}/address",
+		method: "PATCH",
+		tags: [
+			"site-{siteId}",
+			"event-series-{siteId}",
+			TAG_TEMPLATES.siteRoutableContent,
+			TAG_TEMPLATES.siteRedirects
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	createWholeSeriesRun: {
 		path: "/sites/{siteId}/bookings/events/{eventId}/runs",
 		method: "POST",
@@ -10106,6 +10467,20 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"server:internal_error"
 		]
 	},
+	updateCourseBookingSettings: {
+		path: "/sites/{siteId}/bookings/events/{eventId}/booking-settings",
+		method: "PATCH",
+		tags: ["site-{siteId}", "event-series-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"auth:forbidden",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	cancelWholeSeriesRun: {
 		path: "/sites/{siteId}/bookings/events/{eventId}/runs/{runId}/cancellation",
 		method: "POST",
@@ -10118,6 +10493,28 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"resource:conflict",
 			"server:internal_error"
 		]
+	},
+	/**
+	* The Content tab's one write: the short introduction, image and
+	* description of an event's page, published without its layout.
+	*/
+	saveEventPageWords: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/words",
+		method: "PUT",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.siteRoutableContent,
+			TAG_TEMPLATES.pageSurfaceById
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"auth:forbidden",
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
 	}
 });
 //#endregion
@@ -10550,18 +10947,56 @@ const BILLING_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json"
 	}
 });
+//#endregion
+//#region ../api/src/clientErrorReporting.ts
+const CLIENT_ERROR_REPORT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({ reportClientError: {
+	path: "/client/error-report",
+	method: "POST",
+	auth: "user",
+	errors: [],
+	responseKind: "json"
+} });
+const CLIENT_ERROR_REPORT_LIMITS = {
+	pathname: 1024,
+	name: 120,
+	message: 2e3,
+	stack: 8e3,
+	digest: 128,
+	componentStack: 8e3,
+	sourceLocation: 1024
+};
+const clientErrorEventSchema = z.enum([
+	"dashboard:route-error",
+	"dashboard:app-error",
+	"client:error-boundary",
+	"client:window-error",
+	"client:unhandled-rejection"
+]);
+z.object({
+	event: clientErrorEventSchema,
+	pathname: z.string().startsWith("/").max(CLIENT_ERROR_REPORT_LIMITS.pathname),
+	name: z.string().max(CLIENT_ERROR_REPORT_LIMITS.name),
+	message: z.string().max(CLIENT_ERROR_REPORT_LIMITS.message),
+	stack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.stack).nullable(),
+	digest: z.string().max(CLIENT_ERROR_REPORT_LIMITS.digest).nullable(),
+	componentStack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.componentStack).nullable(),
+	sourceLocation: z.string().max(CLIENT_ERROR_REPORT_LIMITS.sourceLocation).nullable()
+}).strict();
 ({
+	...CLIENT_ERROR_REPORT_ENDPOINT_DEFINITIONS,
+	...PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS,
 	...ACCOUNT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_EVENT_ENDPOINT_DEFINITIONS,
 	...GIFTING_ENDPOINT_DEFINITIONS,
 	...PUBLIC_READ_ENDPOINT_DEFINITIONS,
-	...BILLING_ENDPOINT_DEFINITIONS
+	...BILLING_ENDPOINT_DEFINITIONS,
+	...SITE_MANAGEMENT_ENDPOINT_DEFINITIONS
 }), TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, { ...SITE_API_KEY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, {
 	...NEWSLETTER_ENDPOINT_DEFINITIONS,
 	...APPOINTMENT_ENDPOINT_DEFINITIONS,
 	...EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS
-}, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicBookingServices, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, { ...PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, { ...PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, { ...EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS }, { ...SDK_MEDIA_ENDPOINT_DEFINITIONS }, { ...SDK_ENDPOINT_DEFINITIONS }, { ...SDK_ENTRY_READ_ENDPOINTS };
+}, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicBookingServices, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, { ...PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, { ...PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, { ...EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS }, { ...SDK_MEDIA_ENDPOINT_DEFINITIONS }, { ...SDK_ENDPOINT_DEFINITIONS }, { ...SDK_PAGE_DESIGN_ENDPOINT_DEFINITIONS }, { ...SDK_EVENT_ENDPOINT_DEFINITIONS }, { ...SDK_ENTRY_READ_ENDPOINTS };
 z.object({ refreshToken: z.string().min(1).max(4096) }).strict();
 z.object({
 	accessToken: z.string().min(1).max(4096),
@@ -12911,11 +13346,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) {
@@ -12926,42 +13610,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"),
@@ -13088,14 +13836,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
 /**
@@ -14723,6 +15468,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) {
@@ -14746,7 +15498,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: {
@@ -14781,8 +15533,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
@@ -16517,19 +17268,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" },
@@ -16540,7 +17283,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);
@@ -17143,7 +17886,8 @@ const siteOptionSources = [
 	"eventCategories",
 	"eventSeries",
 	"venues",
-	"staffMembers"
+	"staffMembers",
+	"appointmentServiceCategories"
 ];
 const mediaDeliverySchema = z.object({
 	sizes: z.string().optional(),
@@ -26365,13 +27109,13 @@ const hours = stack({
 	as: "p",
 	className: "rb-caption rb-opacity-70"
 }, bind("module.timeZone"), when("module.timeZone"))], when("module.kind", { equals: "opening-hours" }));
-const socials = inline({ className: "rb-flex rb-flex-wrap rb-gap-x-5 rb-gap-y-3" }, [link({
+const socials = inline({ className: "rb-footer-socials" }, [link({
 	href: { $bind: { from: "social.href" } },
 	target: "_blank",
 	rel: "noreferrer noopener",
 	"aria-label": { $bind: { from: "social.label" } },
-	className: "rb-nav-text transition-theme-standard"
-}, [icon({ className: "rb-h-5 rb-w-5" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
+	className: "rb-footer-social-link rb-nav-text transition-theme-standard"
+}, [icon({ className: "rb-footer-social-icon" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
 const authoredCopy = richText({
 	className: "rb-prose rb-prose-sm rb-max-w-none",
 	style: textColorStyle("text/80")
@@ -28012,6 +28756,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",
@@ -28046,6 +28799,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" } }
@@ -35873,6 +36627,11 @@ const mailingListContentVersionIdSchema = z.string().transform((value, ctx) => {
 	});
 	return z.NEVER;
 });
+const mailingListSignupBlockSourceRefSchema = z.object({
+	tag: z.literal("block_ref"),
+	blockId: mailingListSignupBlockIdSchema,
+	contentVersionId: mailingListContentVersionIdSchema
+});
 const signedMailingListSourceTokenSchema = z.string().trim().min(1).transform(parseRequiredMailingListSignedSourceToken);
 const newsletterSourceCommonSchema = z.object({
 	siteId: z.string().optional(),
@@ -35887,7 +36646,15 @@ const newsletterSourceSchema = z.discriminatedUnion("source", [
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("block"),
 		blockId: z.string().nullable().optional(),
-		contentVersionId: z.string().nullable().optional()
+		newsletterBlockSubmission: z.discriminatedUnion("tag", [
+			z.object({
+				tag: z.literal("ready"),
+				sourceRef: mailingListSignupBlockSourceRefSchema
+			}),
+			z.object({ tag: z.literal("unpublished-form") }),
+			z.object({ tag: z.literal("unpublished-settings") }),
+			z.object({ tag: z.literal("unavailable") })
+		])
 	}),
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("signed-footer"),
@@ -35916,11 +36683,7 @@ const newsletterHydrationSchema = z.object({
 	target: z.discriminatedUnion("tag", [
 		z.object({
 			tag: z.literal("block-source"),
-			sourceRef: z.object({
-				tag: z.literal("block_ref"),
-				blockId: mailingListSignupBlockIdSchema,
-				contentVersionId: mailingListContentVersionIdSchema
-			}).nullable()
+			sourceRef: mailingListSignupBlockSourceRefSchema.nullable()
 		}),
 		z.object({
 			tag: z.literal("signed-footer-source"),
@@ -35929,7 +36692,11 @@ const newsletterHydrationSchema = z.object({
 				token: signedMailingListSourceTokenSchema
 			})
 		}),
-		z.object({ tag: z.literal("preview") })
+		z.object({ tag: z.literal("preview") }),
+		z.object({
+			tag: z.literal("unpublished-preview"),
+			reason: z.enum(["unpublished-form", "unpublished-settings"])
+		})
 	]),
 	setupRevision: z.number().int().positive().nullable(),
 	choiceProvider: z.enum([
@@ -35998,16 +36765,21 @@ const newsletterFormBlockRuntime = defineProgressiveBlockRuntime({
 });
 function projectNewsletterFormHydrationTarget(source) {
 	switch (source.source) {
-		case "block": {
-			const sourceRef = buildMailingListSignupBlockSourceRef(source.blockId, source.contentVersionId);
-			if (sourceRef?.tag === "block_ref") return {
+		case "block": switch (source.newsletterBlockSubmission.tag) {
+			case "unpublished-form":
+			case "unpublished-settings": return {
+				tag: "unpublished-preview",
+				reason: source.newsletterBlockSubmission.tag
+			};
+			case "ready": return {
 				tag: "block-source",
-				sourceRef
+				sourceRef: source.newsletterBlockSubmission.sourceRef
 			};
-			return {
+			case "unavailable": return {
 				tag: "block-source",
 				sourceRef: null
 			};
+			default: return assertNever$3(source.newsletterBlockSubmission);
 		}
 		case "signed-footer": return {
 			tag: "signed-footer-source",
@@ -38504,6 +39276,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 }
 *
@@ -38518,7 +39301,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;
@@ -39038,6 +39821,46 @@ z.object({ acceptExtraSiteCharge: z.boolean().optional() });
 //#region ../surfaces/src/index.ts
 const SURFACE_IDS = ["core", "macadamia"];
 const DEFAULT_SURFACE_ID = "core";
+/**
+* Root hosts for each surface, keyed by deployment tier. The tier-keyed shape
+* makes it impossible to mis-order entries: callers like
+* `buildSurfaceAwareDashboardOriginForSurfaceId` look up by tier directly
+* rather than relying on positional alignment between arrays.
+*/
+const SURFACE_ROOT_HOSTS = {
+	core: {
+		local: "localhost",
+		prod: "riverbankcms.com"
+	},
+	macadamia: {
+		local: "macadamia.localhost",
+		prod: "macadamia.studio"
+	}
+};
+const SURFACE_SITE_ROOT_HOSTS = {
+	core: {
+		local: "localhost",
+		prod: "riverbanksites.com"
+	},
+	macadamia: {
+		local: "macadamia.localhost",
+		prod: "macadamia.studio"
+	}
+};
+const SURFACE_SITE_ROOT_HOST_ALIASES = { core: { prod: ["preview.riverbanksites.com"] } };
+function surfaceHostTableValues(table) {
+	return Object.values(table).flatMap((byTier) => Object.values(byTier).flat());
+}
+function siteSlugLabelUnderRoot(host, siteRootHost) {
+	if (!host.endsWith(`.${siteRootHost}`)) return [];
+	return host.slice(0, host.length - siteRootHost.length - 1).split(".").slice(-1);
+}
+function deriveSurfaceOwnedSiteSlugs() {
+	const siteRootHosts = [...surfaceHostTableValues(SURFACE_SITE_ROOT_HOSTS), ...surfaceHostTableValues(SURFACE_SITE_ROOT_HOST_ALIASES)];
+	const labels = [...surfaceHostTableValues(SURFACE_ROOT_HOSTS), ...siteRootHosts].flatMap((host) => siteRootHosts.flatMap((root) => siteSlugLabelUnderRoot(host, root)));
+	return [...new Set(labels)].sort();
+}
+deriveSurfaceOwnedSiteSlugs();
 [...SURFACE_IDS.filter((surfaceId) => surfaceId !== DEFAULT_SURFACE_ID)];
 //#endregion
 //#region ../api/src/accountApi.ts
@@ -39420,7 +40243,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",
@@ -39661,6 +40489,7 @@ function parsePublicProductCategorySelector(value) {
 		productCategoryEntryId: record.productCategoryEntryId
 	};
 }
+z.enum(["public", "unlisted"], { error: "visibility must be 'public' or 'unlisted'" });
 //#endregion
 //#region ../api/src/bookingPaymentTermSchemas.ts
 const bookingDepositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);