@riverbankcms/sdk 0.139.0 → 0.141.0

package/dist/client/hooks.mjs

@@ -30,10 +30,12 @@ const unsafeAsApiKeyId = (id) => id;
 const unsafeAsEventOfferingId = (id) => id;
 const unsafeAsEventSeriesId = (id) => id;
 const unsafeAsUserId = (id) => id;
+const unsafeAsContentVersionId = (id) => id;
 const parseSiteId = (value) => parseUuidBrand(value, unsafeAsSiteId);
 const parseApiKeyId = (value) => parseUuidBrand(value, unsafeAsApiKeyId);
 const parseEventOfferingId = (value) => parseUuidBrand(value, unsafeAsEventOfferingId);
 const parseUserId = (value) => parseUuidBrand(value, unsafeAsUserId);
+const parseContentVersionId = (value) => parseUuidBrand(value, unsafeAsContentVersionId);
 const parseEventSeriesId = (value) => parseUuidBrand(value, unsafeAsEventSeriesId);
 //#endregion
 //#region ../core/src/assert-never.ts
@@ -267,7 +269,7 @@ function parseEventPageSurfaceDestinationMode(value) {
 	return value === "cms-managed" || value === "system-managed" ? value : void 0;
 }
 function parseEventPageSurfaceSubject(value) {
-	if (!isRecord$15(value)) return err({ kind: "notObject" });
+	if (!isRecord$16(value)) return err({ kind: "notObject" });
 	switch (value.kind) {
 		case "eventSeries": {
 			const eventSeriesId = parseEventSeriesId(value.eventSeriesId);
@@ -322,7 +324,7 @@ function parseEventSeriesIdList(values) {
 	}
 	return ok(parsed);
 }
-function isRecord$15(value) {
+function isRecord$16(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 //#endregion
@@ -506,16 +508,47 @@ function parsePositiveInteger(value) {
 function parseNewsletterListId(value) {
 	return parseTrimmedMatchingString(value, UUID_PATTERN);
 }
+function parseMailchimpAccountId(value) {
+	return parseTrimmedMatchingString(value, OPAQUE_ID_PATTERN);
+}
 function parseMailchimpAudienceId(value) {
 	return parseTrimmedMatchingString(value, OPAQUE_ID_PATTERN);
 }
 function parseMailchimpInterestId(value) {
 	return parseTrimmedMatchingString(value, OPAQUE_ID_PATTERN);
 }
+function parseBrevoAccountId(value) {
+	return parseTrimmedMatchingString(value, OPAQUE_ID_PATTERN);
+}
 function parseBrevoListId(value) {
 	return parsePositiveInteger(value);
 }
 //#endregion
+//#region ../core/src/mailing-list-setup.ts
+function isRecord$15(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+const DEFAULT_MAILING_LIST_SUCCESS_MESSAGE = "Thanks — you're on the list.";
+function parseMailingListProviderScope(value) {
+	if (!isRecord$15(value)) return err("invalid_mailing_list_provider_scope");
+	if (value.provider === "native") return ok({ provider: "native" });
+	if (value.provider === "brevo") {
+		const accountId = parseBrevoAccountId(value.accountId);
+		return accountId !== null ? ok({
+			provider: "brevo",
+			accountId
+		}) : err("invalid_mailing_list_provider_scope");
+	}
+	if (value.provider === "mailchimp") {
+		const accountId = parseMailchimpAccountId(value.accountId);
+		return accountId !== null ? ok({
+			provider: "mailchimp",
+			accountId
+		}) : err("invalid_mailing_list_provider_scope");
+	}
+	return err("invalid_mailing_list_provider_scope");
+}
+//#endregion
 //#region ../core/src/mailing-list-setup-parser.ts
 function parseMailingListGlobalForm(value) {
 	if (!isRecord$14(value)) return formError("shape");
@@ -524,12 +557,15 @@ function parseMailingListGlobalForm(value) {
 	if (typeof value.includeOptionalPhone !== "boolean") return formError("includeOptionalPhone");
 	const buttonLabel = parseRequiredString(value.buttonLabel);
 	if (buttonLabel === null) return formError("buttonLabel");
+	const successMessage = parseRequiredString(value.successMessage);
+	if (successMessage === null) return formError("successMessage");
 	const privacyNote = parseOptionalString(value.privacyNote);
 	if (privacyNote === void 0) return formError("privacyNote");
 	return ok({
 		fields,
 		includeOptionalPhone: value.includeOptionalPhone,
 		buttonLabel,
+		successMessage,
 		privacyNote
 	});
 }
@@ -859,11 +895,17 @@ function parseMailingListSignedSourceToken(value) {
 	const parsed = typeof value === "string" ? value.trim() : "";
 	return /^[A-Za-z0-9._~-]{16,1000}$/u.test(parsed) ? parsed : null;
 }
-function buildMailingListSignupBlockSourceRef(blockId) {
-	const parsed = parseMailingListBlockId(blockId);
-	return parsed !== null ? {
+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: parsed
+		blockId: parsedBlockId,
+		contentVersionId: parsedContentVersionId
 	} : null;
 }
 //#endregion
@@ -2482,7 +2524,7 @@ const BUTTON_CONTRAST_POLICY = {
 	nonTextMinimumRatio: 3,
 	gradientSamplesPerSegment: 20,
 	alphaBackgrounds: "reject-without-known-surface",
-	disabled: "retain-full-colour-contract"
+	disabled: "validated-colour-pair-with-muted-control-opacity"
 };
 function validateButtonSurfaceContrast(input) {
 	const ratio = contrastRatio(input.buttonPaint, input.surfaceHex);
@@ -3008,59 +3050,108 @@ function interpolateHex(startHex, endHex, position) {
 	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
 	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
 }
-shadeBackgroundEffect({
-	id: "darken-background",
-	name: "Darken on Hover",
-	description: "Darkens the background color on hover",
-	label: "Darken Amount (shade step)",
-	shadeDirection: 1
-});
-shadeBackgroundEffect({
-	id: "lighten-background",
-	name: "Lighten on Hover",
-	description: "Lightens the background color on hover",
-	label: "Lighten Amount (shade step)",
-	shadeDirection: -1
-});
-function shadeBackgroundEffect(config) {
-	return {
-		id: config.id,
-		name: config.name,
-		description: config.description,
-		category: "background",
-		pseudoElement: "none",
-		applicableTo: ["button"],
-		customizableOption: {
-			name: "amount",
-			type: "select",
-			label: config.label,
-			default: 100,
-			options: [
-				0,
-				100,
-				200,
-				300,
-				400,
-				500,
-				600,
-				700,
-				800,
-				900
-			]
+//#endregion
+//#region ../theme-core/src/tokens/tokens.ts
+const defaultThemeTokens = {
+	color: {
+		"background/base": "#ffffff",
+		"background/elevated": "#f5f5f5",
+		"surface/base": "#ffffff",
+		"surface/subtle": "#f9f9fb",
+		"surface/inverted": "#111111",
+		"content/primary": "#111111",
+		"content/secondary": "#3f3f46",
+		"accent/primary": "#2563eb",
+		"accent/secondary": "#1d4ed8",
+		"border/base": "#e5e7eb"
+	},
+	typography: {
+		"display/hero": {
+			fontSize: "clamp(48px, 8vw, 96px)",
+			lineHeight: "1.05",
+			fontWeight: "700"
 		},
-		isApplicable: (buttonConfig) => buttonConfig.background.type === "solid",
-		generateCSS: ({ themeId, variantId, options, tokens, buttonConfig }) => {
-			if (buttonConfig.background.type !== "solid") return "";
-			const amount = (options.amount || 100) * config.shadeDirection;
-			const baseToken = buttonConfig.background.colorToken ?? "primary-500";
-			return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        background-color: ${tokens.getColor(tokens.adjustShade(baseToken, amount))};
-      }
-    `;
+		"display/section": {
+			fontSize: "clamp(40px, 6vw, 72px)",
+			lineHeight: "1.1",
+			fontWeight: "700"
+		},
+		"heading/large": {
+			fontSize: "clamp(32px, 4vw, 48px)",
+			lineHeight: "1.2",
+			fontWeight: "600"
+		},
+		"heading/medium": {
+			fontSize: "clamp(24px, 3vw, 32px)",
+			lineHeight: "1.25",
+			fontWeight: "600"
+		},
+		"heading/small": {
+			fontSize: "20px",
+			lineHeight: "1.3",
+			fontWeight: "600"
+		},
+		"body/normal": {
+			fontSize: "16px",
+			lineHeight: "1.6",
+			fontWeight: "400"
+		},
+		"body/small": {
+			fontSize: "14px",
+			lineHeight: "1.5",
+			fontWeight: "400"
+		},
+		caption: {
+			fontSize: "12px",
+			lineHeight: "1.4",
+			fontWeight: "500"
 		}
-	};
-}
+	},
+	spacing: {
+		none: "0px",
+		"3xs": "4px",
+		"2xs": "8px",
+		xs: "12px",
+		sm: "16px",
+		md: "24px",
+		lg: "32px",
+		xl: "40px",
+		"2xl": "56px",
+		"3xl": "72px"
+	},
+	radius: {
+		none: "0px",
+		xs: "2px",
+		sm: "4px",
+		md: "8px",
+		lg: "12px",
+		pill: "999px",
+		full: "9999px"
+	},
+	shadow: {
+		none: "none",
+		soft: "0px 2px 8px rgba(15, 23, 42, 0.08)",
+		medium: "0px 6px 18px rgba(15, 23, 42, 0.12)",
+		strong: "0px 12px 36px rgba(15, 23, 42, 0.16)"
+	},
+	palette: {
+		surface: "#ffffff",
+		"neutral-50": "#f9fafb",
+		"neutral-900": "#111827",
+		primary: "#2563eb",
+		"primary-50": "#eff6ff",
+		"primary-500": "#2563eb",
+		"primary-900": "#1d4ed8",
+		secondary: "#9333ea",
+		"secondary-50": "#f3e8ff",
+		"secondary-500": "#9333ea",
+		"secondary-900": "#4c1d95",
+		accent: "#f97316",
+		"accent-50": "#fff7ed",
+		"accent-500": "#f97316",
+		"accent-900": "#7c2d12"
+	}
+};
 //#endregion
 //#region ../theme-core/src/palette/utils/opaqueSurfaceColor.ts
 /** Resolve an opaque colour, compositing alpha against an explicit underlay. */
@@ -3345,6 +3436,59 @@ function mergeStyles(...styles) {
 	}
 	return Object.keys(merged).length ? merged : void 0;
 }
+shadeBackgroundEffect({
+	id: "darken-background",
+	name: "Darken on Hover",
+	description: "Darkens the background color on hover",
+	label: "Darken Amount (shade step)",
+	shadeDirection: 1
+});
+shadeBackgroundEffect({
+	id: "lighten-background",
+	name: "Lighten on Hover",
+	description: "Lightens the background color on hover",
+	label: "Lighten Amount (shade step)",
+	shadeDirection: -1
+});
+function shadeBackgroundEffect(config) {
+	return {
+		id: config.id,
+		name: config.name,
+		description: config.description,
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["button"],
+		customizableOption: {
+			name: "amount",
+			type: "select",
+			label: config.label,
+			default: 100,
+			options: [
+				0,
+				100,
+				200,
+				300,
+				400,
+				500,
+				600,
+				700,
+				800,
+				900
+			]
+		},
+		isApplicable: (buttonConfig) => buttonConfig.background.type === "solid",
+		generateCSS: ({ themeId, variantId, options, tokens, buttonConfig }) => {
+			if (buttonConfig.background.type !== "solid") return "";
+			const amount = (options.amount || 100) * config.shadeDirection;
+			const baseToken = buttonConfig.background.colorToken ?? "primary-500";
+			return `
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        background-color: ${tokens.getColor(tokens.adjustShade(baseToken, amount))};
+      }
+    `;
+		}
+	};
+}
 //#endregion
 //#region ../theme-core/src/utils/tokenOrColor.ts
 /**
@@ -6766,8 +6910,14 @@ const headerInteractionPillPaletteValues = [
 	"accent"
 ];
 /**
-* "No pill": the nav link keeps whatever hover treatment its recipe compiled,
-* and the palette step writes nothing at all (#1318 Phase 4c decision 2).
+* "No pill": a colour change on hover rather than a filled background.
+*
+* The palette step writes nothing (#1318 Phase 4c decision 2), but on a
+* foreground-adaptive style that is not the end of the story: the hover colour
+* is derived from the resolved opening foreground at render time, paired with
+* the resting colour, so `quiet` resolves to a definite colour rather than to
+* whatever brand token the recipe happened to name. See
+* `applyOpeningForeground`.
 *
 * It exists because "a colour change on hover, no filled background" was not
 * expressible in the vocabulary, and it is what
@@ -7769,6 +7919,28 @@ const bookingRequirementConsentFieldSchema = z.object({
 z.union([blockBookingConsentSchema, bookingRequirementConsentFieldSchema]);
 //#endregion
 //#region ../blocks/src/system/blocks/events/shared/schemas.ts
+const publicEventLoaderQuerySchemaShape = {
+	limit: z.string().optional(),
+	from: z.string().optional(),
+	to: z.string().optional(),
+	afterStartsAt: z.string().optional(),
+	afterId: z.string().optional(),
+	categoryIds: z.string().optional(),
+	venueId: z.string().optional(),
+	staffMemberId: z.string().optional(),
+	eventSurface: z.string().optional(),
+	eventPresets: z.string().optional(),
+	scheduleScope: z.string().optional(),
+	seriesId: z.string().optional(),
+	seriesIds: z.string().optional(),
+	runSeriesId: z.string().optional(),
+	seriesSlug: z.string().optional(),
+	includeOccurrenceId: z.string().optional(),
+	readIntent: z.string().optional(),
+	detailLevel: z.string().optional(),
+	readProfile: z.string().optional()
+};
+z.object(publicEventLoaderQuerySchemaShape);
 const eventPresetSchema = z.enum([
 	"event",
 	"class",
@@ -8177,6 +8349,7 @@ const calendarWindowQuerySchema = z.object({
 	eventSurface: z.enum(eventSurfaceScopeValues).optional(),
 	eventPresets: z.string().optional(),
 	scheduleScope: z.enum(eventScheduleScopeValues).optional(),
+	seriesIds: z.string().optional(),
 	categoryIds: z.string().optional(),
 	venueId: z.string().transform(normalizeCalendarFilterId).optional(),
 	staffMemberId: z.string().transform(normalizeCalendarFilterId).optional()
@@ -9611,6 +9784,14 @@ const PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS = defineEndpointDefinitio
 		auth: "public",
 		responseKind: "json"
 	},
+	getPublicBookingServiceBySlug: {
+		path: "/public/bookings/services/by-slug/{slug}",
+		method: "GET",
+		revalidate: publicReadFreshnessSeconds("getPublicBookingService"),
+		tags: [TAG_TEMPLATES.publicBookingServices],
+		auth: "public",
+		responseKind: "json"
+	},
 	getPublicBookingResourcesReference: {
 		path: "/public/bookings/resources/reference",
 		method: "GET",
@@ -10163,16 +10344,110 @@ const PUBLIC_READ_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json"
 	}
 });
+//#endregion
+//#region ../api/src/publicOnboardingAttemptEndpointDefinitions.ts
+/**
+* The anonymous onboarding attempt, addressed by its opaque resume token.
+*
+* Every route here is reached before there is an account, so none of them can
+* be scoped to a site or a user: the token is the whole credential. They are
+* kept together so that stays obvious.
+*/
+const PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	createPublicOnboardingAttempt: {
+		path: "/public/onboarding/attempts",
+		method: "POST",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	createPublicOnboardingLogoUploadUrl: {
+		path: "/public/onboarding/attempts/{attemptToken}/logo-upload-url",
+		method: "POST",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	uploadPublicOnboardingLogo: {
+		path: "/public/onboarding/attempts/{attemptToken}/logo",
+		method: "POST",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	getPublicOnboardingAttempt: {
+		path: "/public/onboarding/attempts/{attemptToken}",
+		method: "GET",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	getPublicOnboardingAttemptProgress: {
+		path: "/public/onboarding/attempts/{attemptToken}/status",
+		method: "GET",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	updatePublicOnboardingAttempt: {
+		path: "/public/onboarding/attempts/{attemptToken}",
+		method: "PATCH",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	runPublicOnboardingAttempt: {
+		path: "/public/onboarding/attempts/{attemptToken}/run",
+		method: "POST",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	},
+	resendPublicOnboardingAttemptConfirmation: {
+		path: "/public/onboarding/attempts/{attemptToken}/resend-confirmation",
+		method: "POST",
+		auth: "public",
+		errors: [],
+		responseKind: "json"
+	}
+});
+//#endregion
+//#region ../api/src/billingEndpointDefinitions.ts
+const BILLING_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	adminChangePlan: {
+		path: "/admin/billing/plan",
+		method: "POST",
+		tags: ["admin", "billing"],
+		auth: "admin",
+		responseKind: "json"
+	},
+	changePlan: {
+		path: "/billing/plan/change",
+		method: "POST",
+		tags: ["billing"],
+		auth: "user",
+		responseKind: "json"
+	},
+	createBillingPortalSession: {
+		path: "/billing/portal/session",
+		method: "POST",
+		tags: ["billing"],
+		auth: "user",
+		responseKind: "json"
+	}
+});
 ({
 	...ACCOUNT_ENDPOINT_DEFINITIONS,
+	...PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_EVENT_ENDPOINT_DEFINITIONS,
 	...GIFTING_ENDPOINT_DEFINITIONS,
-	...PUBLIC_READ_ENDPOINT_DEFINITIONS
+	...PUBLIC_READ_ENDPOINT_DEFINITIONS,
+	...BILLING_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.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_ENTRY_READ_ENDPOINTS };
 z.object({ refreshToken: z.string().min(1).max(4096) }).strict();
 z.object({
 	accessToken: z.string().min(1).max(4096),
@@ -12441,108 +12716,6 @@ function assertUniqueLayoutProfileKeys(profiles) {
 	if (duplicates.length > 0) throw new Error(`Duplicate block layout design profiles: ${duplicates.join(", ")}`);
 }
 //#endregion
-//#region ../theme-core/src/tokens/tokens.ts
-const defaultThemeTokens = {
-	color: {
-		"background/base": "#ffffff",
-		"background/elevated": "#f5f5f5",
-		"surface/base": "#ffffff",
-		"surface/subtle": "#f9f9fb",
-		"surface/inverted": "#111111",
-		"content/primary": "#111111",
-		"content/secondary": "#3f3f46",
-		"accent/primary": "#2563eb",
-		"accent/secondary": "#1d4ed8",
-		"border/base": "#e5e7eb"
-	},
-	typography: {
-		"display/hero": {
-			fontSize: "clamp(48px, 8vw, 96px)",
-			lineHeight: "1.05",
-			fontWeight: "700"
-		},
-		"display/section": {
-			fontSize: "clamp(40px, 6vw, 72px)",
-			lineHeight: "1.1",
-			fontWeight: "700"
-		},
-		"heading/large": {
-			fontSize: "clamp(32px, 4vw, 48px)",
-			lineHeight: "1.2",
-			fontWeight: "600"
-		},
-		"heading/medium": {
-			fontSize: "clamp(24px, 3vw, 32px)",
-			lineHeight: "1.25",
-			fontWeight: "600"
-		},
-		"heading/small": {
-			fontSize: "20px",
-			lineHeight: "1.3",
-			fontWeight: "600"
-		},
-		"body/normal": {
-			fontSize: "16px",
-			lineHeight: "1.6",
-			fontWeight: "400"
-		},
-		"body/small": {
-			fontSize: "14px",
-			lineHeight: "1.5",
-			fontWeight: "400"
-		},
-		caption: {
-			fontSize: "12px",
-			lineHeight: "1.4",
-			fontWeight: "500"
-		}
-	},
-	spacing: {
-		none: "0px",
-		"3xs": "4px",
-		"2xs": "8px",
-		xs: "12px",
-		sm: "16px",
-		md: "24px",
-		lg: "32px",
-		xl: "40px",
-		"2xl": "56px",
-		"3xl": "72px"
-	},
-	radius: {
-		none: "0px",
-		xs: "2px",
-		sm: "4px",
-		md: "8px",
-		lg: "12px",
-		pill: "999px",
-		full: "9999px"
-	},
-	shadow: {
-		none: "none",
-		soft: "0px 2px 8px rgba(15, 23, 42, 0.08)",
-		medium: "0px 6px 18px rgba(15, 23, 42, 0.12)",
-		strong: "0px 12px 36px rgba(15, 23, 42, 0.16)"
-	},
-	palette: {
-		surface: "#ffffff",
-		"neutral-50": "#f9fafb",
-		"neutral-900": "#111827",
-		primary: "#2563eb",
-		"primary-50": "#eff6ff",
-		"primary-500": "#2563eb",
-		"primary-900": "#1d4ed8",
-		secondary: "#9333ea",
-		"secondary-50": "#f3e8ff",
-		"secondary-500": "#9333ea",
-		"secondary-900": "#4c1d95",
-		accent: "#f97316",
-		"accent-50": "#fff7ed",
-		"accent-500": "#f97316",
-		"accent-900": "#7c2d12"
-	}
-};
-//#endregion
 //#region ../theme-core/src/site-styles/backgroundAppearance.ts
 const backgroundAppearanceQuickColorTokenNames = [
 	"background",
@@ -16844,6 +17017,7 @@ function isDisplayMediaKind(kind) {
 }
 const siteOptionSources = [
 	"eventCategories",
+	"eventSeries",
 	"venues",
 	"staffMembers"
 ];
@@ -29540,7 +29714,8 @@ const appointmentServicesBlockDefinition = {
 				el("appointment-services", {
 					sectionHeading: { $bind: { from: "content.heading" } },
 					services: { $bind: { from: "data.services" } },
-					pathname: { $bind: { from: "$root.pathname" } }
+					pathname: { $bind: { from: "$root.pathname" } },
+					servicePathPrefix: { $bind: { from: "$root.appointmentServicePathPrefix" } }
 				})
 			], { gap: "lg" })
 		})]
@@ -30196,6 +30371,44 @@ function toWholeSeriesRegistrationEvents(events) {
 	return groupPublicEventsByRun(events).map(toWholeSeriesRegistrationEvent).filter((event) => event !== null);
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/eventSourceRecovery.ts
+const { limit: _rawLimit, eventSurface: _rawEventSurface, scheduleScope: _rawScheduleScope, detailLevel: _rawDetailLevel, ...stringEventQueryShape } = publicEventLoaderQuerySchemaShape;
+const eventRecoveryRequestSchema = z.object({
+	...stringEventQueryShape,
+	limit: z.coerce.number().int().positive().optional(),
+	eventSurface: z.enum(eventSurfaceScopeValues).optional(),
+	scheduleScope: z.enum(eventScheduleScopeValues).optional(),
+	detailLevel: z.enum(["full", "listing"]).optional(),
+	stage: z.enum(["preview", "published"]).optional()
+});
+function resolveEventRegistrationEventSource(input) {
+	if (input.wholeSeriesRunEvents != null) return {
+		kind: "loaded",
+		events: input.wholeSeriesRunEvents
+	};
+	if (input.events != null) return {
+		kind: "loaded",
+		events: input.events
+	};
+	return {
+		kind: "unresolved",
+		request: parseEventLoaderRecoveryRequest(input.failures?.wholeSeriesRunEvents ?? input.failures?.events)
+	};
+}
+const eventLoaderFailureSchema = z.object({
+	endpoint: z.literal("listPublicEvents"),
+	params: eventRecoveryRequestSchema.extend({ siteId: z.string().optional() })
+});
+function parseEventLoaderRecoveryRequest(value) {
+	const parsed = eventLoaderFailureSchema.safeParse(value);
+	if (!parsed.success) return null;
+	const { siteId: _siteId, stage, ...params } = parsed.data.params;
+	return {
+		...params,
+		stage: stage ?? "published"
+	};
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration.interactive.ts
 const EVENT_REGISTRATION_GENERIC_SHELL_STEP_LABELS = [
 	"Date",
@@ -30213,8 +30426,6 @@ const eventRegistrationPublicEventSchema = z.preprocess(normalizeEventRegistrati
 const eventRegistrationHydrationSchemaShape = {
 	occurrenceContext: occurrenceContextSchema.optional(),
 	subject: eventRegistrationPageSurfaceSubjectSchema.nullable().optional(),
-	events: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
-	wholeSeriesRunEvents: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
 	maxTickets: z.string().optional(),
 	showVenue: z.boolean().optional(),
 	showCapacity: z.boolean().optional(),
@@ -30226,12 +30437,22 @@ const eventRegistrationHydrationSchemaShape = {
 	sitePasses: publicPassProductCollectionSchema.nullable().optional(),
 	siteMemberships: publicMembershipProductCollectionSchema.nullable().optional()
 };
+const eventRegistrationEventSourceSchema = z.discriminatedUnion("kind", [z.object({
+	kind: z.literal("loaded"),
+	events: z.array(eventRegistrationPublicEventSchema)
+}), z.object({
+	kind: z.literal("unresolved"),
+	request: eventRecoveryRequestSchema.nullable()
+})]);
 const eventRegistrationSourceSchema = z.object({
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
 	portalToken: z.string().nullable().optional(),
 	previewToken: z.string().nullable().optional(),
 	...eventRegistrationHydrationSchemaShape,
+	events: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
+	wholeSeriesRunEvents: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
+	eventLoaderFailures: z.record(z.string(), z.unknown()).nullable().optional(),
 	className: z.string().nullable().optional(),
 	buttonText: z.string().nullable().optional(),
 	maxTickets: z.string().nullable().optional(),
@@ -30252,7 +30473,10 @@ const eventRegistrationDisplaySchema = z.discriminatedUnion("state", [z.object({
 	titleText: z.string(),
 	bodyText: z.string()
 })]);
-const eventRegistrationHydrationSchema = z.object(eventRegistrationHydrationSchemaShape);
+const eventRegistrationHydrationSchema = z.object({
+	...eventRegistrationHydrationSchemaShape,
+	eventSource: eventRegistrationEventSourceSchema
+});
 const eventRegistrationRenderSchema = z.object({
 	display: eventRegistrationDisplaySchema,
 	hydration: eventRegistrationHydrationSchema
@@ -30311,16 +30535,12 @@ function buildEventRegistrationShellStepLabels(source, scopedSourceEvents) {
 function toScopedEventRegistrationEvents(scopedSourceEvents) {
 	return [...toRegistrationEvents(scopedSourceEvents), ...toWholeSeriesRegistrationEvents(scopedSourceEvents)];
 }
-function scopeEventRegistrationSourceEvents(source) {
-	return resolveEventRegistrationScopedEvents(source.wholeSeriesRunEvents ?? source.events ?? [], {
+function scopeEventRegistrationSourceEvents(source, eventSource) {
+	return resolveEventRegistrationScopedEvents(eventSource.kind === "loaded" ? eventSource.events : [], {
 		occurrenceContext: source.occurrenceContext,
 		subject: source.subject
 	});
 }
-function resolveLoadedEventRegistrationSourceEvents(source, scopedSourceEvents) {
-	if (source.events == null && source.wholeSeriesRunEvents == null) return null;
-	return [...scopedSourceEvents];
-}
 /**
 * The one run this surface is registering for, when the scoped events describe
 * exactly one. More than one run means the visitor still has to choose.
@@ -30360,14 +30580,21 @@ const eventRegistrationBlockRuntime = defineClientOwnedBlockRuntime({
 		render: createZodCodec(eventRegistrationRenderSchema)
 	},
 	buildRender: (source) => {
-		const scopedSourceEvents = scopeEventRegistrationSourceEvents(source);
-		const events = resolveLoadedEventRegistrationSourceEvents(source, scopedSourceEvents);
+		const eventSource = resolveEventRegistrationEventSource({
+			events: source.events,
+			wholeSeriesRunEvents: source.wholeSeriesRunEvents,
+			failures: source.eventLoaderFailures
+		});
+		const scopedSourceEvents = scopeEventRegistrationSourceEvents(source, eventSource);
 		return {
 			display: buildEventRegistrationDisplayFromScopedEvents(source, scopedSourceEvents),
 			hydration: {
 				occurrenceContext: source.occurrenceContext ?? null,
 				subject: source.subject ?? null,
-				events,
+				eventSource: eventSource.kind === "loaded" ? {
+					...eventSource,
+					events: [...scopedSourceEvents]
+				} : eventSource,
 				maxTickets: source.maxTickets ?? void 0,
 				showVenue: source.showVenue,
 				showCapacity: source.showCapacity,
@@ -30543,6 +30770,7 @@ const eventRegistrationBlockDefinition = {
 					} },
 					events: { $bind: { from: "data.events" } },
 					wholeSeriesRunEvents: { $bind: { from: "data.wholeSeriesRunEvents" } },
+					loaderFailures: { $bind: { from: "$root.loaderFailures" } },
 					sitePasses: { $bind: { from: "data.sitePasses" } },
 					siteMemberships: { $bind: { from: "data.siteMemberships" } },
 					stage: { $bind: {
@@ -31028,6 +31256,35 @@ const eventSpotlightBlockDefinition = {
 	} }
 };
 //#endregion
+//#region ../blocks/src/system/blocks/events/shared/eventSelection.ts
+/** Invalid saved selections fail closed rather than widening discovery. */
+function resolveEventSelection(mode, value) {
+	if (mode !== "selected") return { kind: "matching" };
+	const candidates = Array.isArray(value) ? value : typeof value === "string" ? value.split(",").filter(Boolean) : [];
+	const ids = [];
+	for (const candidate of candidates) {
+		if (typeof candidate !== "string") return {
+			kind: "selected",
+			seriesIds: []
+		};
+		const parsed = parseEventSeriesId(candidate.trim());
+		if (!parsed.ok) return {
+			kind: "selected",
+			seriesIds: []
+		};
+		ids.push(parsed.value);
+	}
+	return {
+		kind: "selected",
+		seriesIds: [...new Set(ids)].sort()
+	};
+}
+/** Undefined means discovery; an empty string is an explicitly empty selection. */
+function eventSeriesScopeCsv(value) {
+	if (value == null) return void 0;
+	return typeof value === "string" ? value : value.join(",");
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/events/shared/listingLayout.ts
 /**
 * Layout classes for event listing containers and cards. Presentation
@@ -31127,6 +31384,7 @@ const eventCollectionFilterSourceSchemaShape = {
 	eventSurface: eventSurfaceScopeSchema$1.nullable().optional(),
 	filterEventPresets: z.union([z.string(), z.array(z.string())]).nullable().optional(),
 	scheduleScope: eventScheduleScopeSchema$1.nullable().optional(),
+	seriesIds: z.union([z.string(), z.array(z.string())]).nullable().optional(),
 	filterCategoryIds: z.union([z.string(), z.array(z.string())]).nullable().optional(),
 	filterStaffMemberId: z.string().nullable().optional(),
 	filterVenueId: z.string().nullable().optional()
@@ -31173,6 +31431,7 @@ const eventCollectionDisplaySchemaShape = {
 	eventSurface: eventSurfaceScopeSchema$1,
 	filterEventPresets: z.string().nullable(),
 	scheduleScope: eventScheduleScopeSchema$1,
+	seriesIds: z.string().nullable().optional(),
 	filterCategoryIds: z.string().nullable(),
 	filterStaffMemberId: z.string().nullable(),
 	filterVenueId: z.string().nullable(),
@@ -31220,11 +31479,15 @@ function buildEventCollectionDisplay(source) {
 	};
 }
 function buildEventCollectionFilterDisplay(source) {
-	return {
-		showFilters: source.showFilters ?? true,
-		showCategoryFilter: source.showCategoryFilter ?? "auto",
-		showVenueFilter: source.showVenueFilter ?? false,
-		showStaffFilter: source.showStaffFilter ?? true,
+	const selected = source.seriesIds != null;
+	const matchingFilters = selected ? {
+		eventSurface: "all",
+		filterEventPresets: null,
+		scheduleScope: "any",
+		filterCategoryIds: null,
+		filterStaffMemberId: null,
+		filterVenueId: null
+	} : {
 		eventSurface: normalizeEventSurfaceScope(source.eventSurface),
 		filterEventPresets: normalizeEventSurfacePresetsCsv(source.filterEventPresets),
 		scheduleScope: normalizeEventScheduleScope(source.scheduleScope),
@@ -31232,6 +31495,14 @@ function buildEventCollectionFilterDisplay(source) {
 		filterStaffMemberId: normalizeEventStaffMemberId(source.filterStaffMemberId),
 		filterVenueId: normalizeEventVenueId(source.filterVenueId)
 	};
+	return {
+		seriesIds: eventSeriesScopeCsv(source.seriesIds),
+		showFilters: selected ? false : source.showFilters ?? true,
+		showCategoryFilter: source.showCategoryFilter ?? "auto",
+		showVenueFilter: source.showVenueFilter ?? false,
+		showStaffFilter: source.showStaffFilter ?? true,
+		...matchingFilters
+	};
 }
 function buildEventCollectionPresentationDisplay(source) {
 	return {
@@ -31246,14 +31517,15 @@ function buildEventCollectionPresentationDisplay(source) {
 }
 function buildEventCollectionHydration(source, now = /* @__PURE__ */ new Date()) {
 	const timeZone = source.calendarWindow?.scope.timeZone ?? toBookingTimeZone(source.bookingTimeZone);
+	const selected = source.seriesIds != null;
 	return {
 		calendarWindow: source.calendarWindow ?? void 0,
 		siteId: source.siteId,
 		stage: source.stage,
 		prefetchedEvents: source.events != null,
-		eventSurface: normalizeEventSurfaceScope(source.eventSurface),
-		filterEventPresets: normalizeEventSurfacePresetsCsv(source.filterEventPresets),
-		scheduleScope: normalizeEventScheduleScope(source.scheduleScope),
+		eventSurface: selected ? "all" : normalizeEventSurfaceScope(source.eventSurface),
+		filterEventPresets: selected ? null : normalizeEventSurfacePresetsCsv(source.filterEventPresets),
+		scheduleScope: selected ? "any" : normalizeEventScheduleScope(source.scheduleScope),
 		calendarContext: {
 			timeZone,
 			initialToday: source.calendarWindow?.initialToday ?? getLocalScheduleDate(now, timeZone)
@@ -31319,6 +31591,7 @@ const eventListingHydrationSchema = z.object({
 	eventSurface: eventSurfaceScopeSchema,
 	filterEventPresets: z.string().nullable(),
 	scheduleScope: eventScheduleScopeSchema,
+	seriesIds: z.string().nullable().optional(),
 	filterCategoryIds: z.string().nullable().optional(),
 	filterStaffMemberId: z.string().nullable().optional(),
 	filterVenueId: z.string().nullable().optional(),
@@ -31379,6 +31652,7 @@ const eventListingBlockRuntime = defineProgressiveBlockRuntime({
 				eventSurface: normalizeEventSurfaceScope(source.eventSurface),
 				filterEventPresets: normalizeEventSurfacePresetsCsv(source.filterEventPresets),
 				scheduleScope: normalizeEventScheduleScope(source.scheduleScope),
+				seriesIds: eventSeriesScopeCsv(source.seriesIds),
 				filterCategoryIds: normalizeEventCategoryIdsCsv(source.filterCategoryIds),
 				filterStaffMemberId: normalizeEventStaffMemberId(source.filterStaffMemberId),
 				filterVenueId: normalizeEventVenueId(source.filterVenueId),
@@ -31752,6 +32026,65 @@ const eventListingBlockDefinition = {
 	} }
 };
 //#endregion
+//#region ../blocks/src/system/blocks/events/eventSelectionFields.ts
+const eventSelectionFields = [{
+	id: "eventSelection",
+	type: "select",
+	label: "Events to show",
+	required: false,
+	multiple: false,
+	defaultValue: "matching",
+	options: [{
+		value: "matching",
+		label: "All matching events"
+	}, {
+		value: "selected",
+		label: "Selected events"
+	}],
+	ui: { intent: "behavior" }
+}, createSiteOptionSelectField({
+	id: "selectedEventSeriesIds",
+	label: "Selected events",
+	description: "Show upcoming dates for these events. Other event filters do not apply.",
+	required: false,
+	multiple: true,
+	defaultValue: [],
+	optionSource: "eventSeries",
+	ui: {
+		intent: "behavior",
+		searchThreshold: 1,
+		visibleWhen: {
+			field: "eventSelection",
+			equals: "selected"
+		}
+	}
+})];
+function withEventSelectionVisibility(field) {
+	if (![
+		"eventSurface",
+		"filterEventPresets",
+		"scheduleScope",
+		"filterCategoryIds",
+		"filterStaffMemberId",
+		"filterVenueId",
+		"showFilters",
+		"showCategoryFilter",
+		"showVenueFilter",
+		"showStaffFilter"
+	].includes(field.id)) return field;
+	const visibleWhen = field.ui?.visibleWhen;
+	return {
+		...field,
+		ui: {
+			...field.ui,
+			visibleWhen: { allOf: [{
+				field: "eventSelection",
+				notEquals: "selected"
+			}, ...visibleWhen ? [visibleWhen] : []] }
+		}
+	};
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/events/EventCalendar.interactive.ts
 const eventCalendarSourceSchema = z.object({
 	...eventCollectionSourceSchemaShape,
@@ -31834,19 +32167,59 @@ const eventCalendarBlockRuntime = defineProgressiveBlockRuntime({
 //#region ../blocks/src/system/blocks/events/eventCalendarDataLoaders.ts
 const scopeParams = {
 	siteId: { $bind: { from: "$root.siteId" } },
+	seriesIds: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "seriesIds" }
+		}]
+	} },
 	stage: { $bind: {
 		from: "$root.previewStage",
 		fallback: "published"
 	} },
-	eventSurface: { $bind: { from: "content.eventSurface" } },
+	eventSurface: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "eventSurface" }
+		}, { id: "value.csv" }]
+	} },
 	eventPresets: { $bind: {
-		from: "content.filterEventPresets",
-		transforms: [{ id: "value.csv" }]
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "filterEventPresets" }
+		}, { id: "value.csv" }]
 	} },
-	scheduleScope: { $bind: { from: "content.scheduleScope" } },
-	categoryIds: { $bind: { from: "content.filterCategoryIds" } },
-	staffMemberId: { $bind: { from: "content.filterStaffMemberId" } },
-	venueId: { $bind: { from: "content.filterVenueId" } }
+	scheduleScope: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "scheduleScope" }
+		}, { id: "value.csv" }]
+	} },
+	categoryIds: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "filterCategoryIds" }
+		}, { id: "value.csv" }]
+	} },
+	staffMemberId: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "filterStaffMemberId" }
+		}, { id: "value.csv" }]
+	} },
+	venueId: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "filterVenueId" }
+		}, { id: "value.csv" }]
+	} }
 };
 /** Combined renders two jobs; calendar-only variants never pay for the list seed. */
 const eventCalendarDataLoaders = {
@@ -31976,6 +32349,13 @@ const eventCalendarLayout = [styledSection({
 				from: "content.defaultCalendarView",
 				fallback: "month"
 			} },
+			seriesIds: { $bind: {
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "seriesIds" }
+				}]
+			} },
 			showFilters: { $bind: {
 				from: "content.showFilters",
 				fallback: true
@@ -31997,17 +32377,47 @@ const eventCalendarLayout = [styledSection({
 				fallback: true
 			} },
 			eventSurface: { $bind: {
-				from: "content.eventSurface",
-				fallback: "all"
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "eventSurface" }
+				}]
+			} },
+			filterEventPresets: { $bind: {
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "filterEventPresets" }
+				}]
 			} },
-			filterEventPresets: { $bind: { from: "content.filterEventPresets" } },
 			scheduleScope: { $bind: {
-				from: "content.scheduleScope",
-				fallback: "any"
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "scheduleScope" }
+				}]
+			} },
+			filterCategoryIds: { $bind: {
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "filterCategoryIds" }
+				}]
+			} },
+			filterStaffMemberId: { $bind: {
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "filterStaffMemberId" }
+				}]
+			} },
+			filterVenueId: { $bind: {
+				from: "content",
+				transforms: [{
+					id: "events.calendarSelectionParam",
+					options: { key: "filterVenueId" }
+				}]
 			} },
-			filterCategoryIds: { $bind: { from: "content.filterCategoryIds" } },
-			filterStaffMemberId: { $bind: { from: "content.filterStaffMemberId" } },
-			filterVenueId: { $bind: { from: "content.filterVenueId" } },
 			cardRole: { $bind: {
 				from: "content._cardStyles.role",
 				fallback: "default"
@@ -32511,6 +32921,7 @@ const eventCalendarAdditionalFields = [
 			}
 		}
 	},
+	...eventSelectionFields,
 	{
 		id: "eventSurface",
 		type: "select",
@@ -32720,7 +33131,7 @@ const eventCalendarBlockDefinition = {
 		titleSource: "heading",
 		description: "Display events with calendar, list, or combined views with filtering",
 		skipSectionStyles: true,
-		additionalFields: eventCalendarAdditionalFields,
+		additionalFields: eventCalendarAdditionalFields.map(withEventSelectionVisibility),
 		styleTokens: {
 			background: "surface",
 			typography: "body",
@@ -37098,6 +37509,15 @@ const newsletterFieldSchema = z.object({
 	placeholder: z.string().optional()
 });
 const mailingListSignupBlockIdSchema = z.string().trim().min(1).transform(parseRequiredMailingListSignupBlockId);
+const mailingListContentVersionIdSchema = z.string().transform((value, ctx) => {
+	const parsed = parseMailingListContentVersionId(value);
+	if (parsed) return parsed;
+	ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		message: "Invalid mailing-list content version ID"
+	});
+	return z.NEVER;
+});
 const signedMailingListSourceTokenSchema = z.string().trim().min(1).transform(parseRequiredMailingListSignedSourceToken);
 const newsletterSourceCommonSchema = z.object({
 	siteId: z.string().optional(),
@@ -37111,7 +37531,8 @@ const newsletterSourceCommonSchema = z.object({
 const newsletterSourceSchema = z.discriminatedUnion("source", [
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("block"),
-		blockId: z.string().nullable().optional()
+		blockId: z.string().nullable().optional(),
+		contentVersionId: z.string().nullable().optional()
 	}),
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("signed-footer"),
@@ -37127,6 +37548,7 @@ const newsletterDisplaySchema = z.object({
 	availability: z.enum(["ready", "unavailable"]),
 	className: z.string().nullable(),
 	buttonLabel: z.string(),
+	successMessage: z.string(),
 	buttonVariant: newsletterButtonVariantSchema,
 	privacyNote: z.string().nullable(),
 	fields: z.array(newsletterFieldSchema),
@@ -37141,7 +37563,8 @@ const newsletterHydrationSchema = z.object({
 			tag: z.literal("block-source"),
 			sourceRef: z.object({
 				tag: z.literal("block_ref"),
-				blockId: mailingListSignupBlockIdSchema
+				blockId: mailingListSignupBlockIdSchema,
+				contentVersionId: mailingListContentVersionIdSchema
 			}).nullable()
 		}),
 		z.object({
@@ -37180,6 +37603,7 @@ function buildNewsletterDisplay(source) {
 		fields: { preset: "emailOnly" },
 		includeOptionalPhone: false,
 		buttonLabel: "Subscribe",
+		successMessage: DEFAULT_MAILING_LIST_SUCCESS_MESSAGE,
 		privacyNote: null
 	};
 	const targeting = source.targeting ?? { mode: "default" };
@@ -37189,6 +37613,7 @@ function buildNewsletterDisplay(source) {
 		availability: runtimeTargetingIsAvailable(context, targeting, choices) ? "ready" : "unavailable",
 		className: source.className ?? null,
 		buttonLabel: form.buttonLabel,
+		successMessage: form.successMessage,
 		buttonVariant: source.buttonVariant ?? "primary",
 		privacyNote: form.privacyNote,
 		fields: getGlobalFormFields(form),
@@ -37219,7 +37644,7 @@ const newsletterFormBlockRuntime = defineProgressiveBlockRuntime({
 function projectNewsletterFormHydrationTarget(source) {
 	switch (source.source) {
 		case "block": {
-			const sourceRef = buildMailingListSignupBlockSourceRef(source.blockId);
+			const sourceRef = buildMailingListSignupBlockSourceRef(source.blockId, source.contentVersionId);
 			if (sourceRef?.tag === "block_ref") return {
 				tag: "block-source",
 				sourceRef
@@ -39365,6 +39790,26 @@ const linksTransforms = [{
 	}
 }];
 const defaultTransforms = createTransformRegistry([
+	{
+		id: "events.calendarSelectionParam",
+		kind: "formatter",
+		summary: "Resolve selected events instead of discovery filters",
+		schema: z.object({ key: z.enum([
+			"seriesIds",
+			"eventSurface",
+			"filterEventPresets",
+			"scheduleScope",
+			"filterCategoryIds",
+			"filterStaffMemberId",
+			"filterVenueId"
+		]) }),
+		run(value, { key }) {
+			const content = asPartialObject(value) ?? {};
+			const selection = resolveEventSelection(content.eventSelection, content.selectedEventSeriesIds);
+			if (selection.kind === "selected") return key === "seriesIds" ? selection.seriesIds : void 0;
+			return key === "seriesIds" ? void 0 : content[key];
+		}
+	},
 	{
 		id: "events.calendarReadEnabled",
 		kind: "formatter",
@@ -39679,12 +40124,12 @@ function normalizeContent(block) {
 }
 /**
 * Normalize params for API calls.
-* Converts all values to strings.
+* Converts supplied values to strings, preserving absent versus explicitly empty params.
 */
 function normalizeParams(input) {
 	if (!input || typeof input !== "object") return {};
 	const output = {};
-	for (const [key, value] of Object.entries(input)) output[key] = coerceToString(value);
+	for (const [key, value] of Object.entries(input)) if (value !== void 0 && value !== null) output[key] = coerceToString(value);
 	return output;
 }
 function isNonArrayObject(value) {
@@ -39748,6 +40193,14 @@ function coercePayload(payload) {
 * - Frontend: provide internal API client
 * - SDK: provide SDK client with endpoint mapping
 */
+function projectDataLoaders(loaders, shouldLoad, blockId, blockKind) {
+	if (!shouldLoad) return [...loaders];
+	return loaders.filter(({ key }) => shouldLoad({
+		blockId,
+		blockKind,
+		loaderKey: key
+	}));
+}
 function shouldSkipResolvedLoader(input) {
 	if (input.loader.requiredParams?.some((param) => !input.params[param]?.trim())) return true;
 	return Boolean(input.isValidEndpoint && !input.isValidEndpoint(input.endpoint));
@@ -39773,8 +40226,12 @@ function shouldSkipResolvedLoader(input) {
 * ```
 */
 async function prefetchBlockData$1(page, context, options) {
-	const { apiClient, isValidEndpoint, onError, getCustomBlockLoaders, getBlockDefinition: getBlockDefinition$1 = getBlockDefinition, resolveParamsBindings: resolveParamsBindings$1 = resolveParamsBindings } = options;
+	return (await prefetchBlockDataWithFailures(page, context, options)).resolvedData;
+}
+async function prefetchBlockDataWithFailures(page, context, options) {
+	const { apiClient, isValidEndpoint, onError, getCustomBlockLoaders, getBlockDefinition: getBlockDefinition$1 = getBlockDefinition, resolveParamsBindings: resolveParamsBindings$1 = resolveParamsBindings, shouldLoad } = options;
 	const results = {};
+	const loaderFailures = {};
 	const tasks = [];
 	for (const block of page.blocks) {
 		const blockId = block.id;
@@ -39789,6 +40246,7 @@ async function prefetchBlockData$1(page, context, options) {
 				loader
 			})) : [];
 		} else loaders = [];
+		loaders = projectDataLoaders(loaders, shouldLoad, blockId, block.kind);
 		if (loaders.length === 0) continue;
 		const root = {
 			...context.root ?? {},
@@ -39822,6 +40280,11 @@ async function prefetchBlockData$1(page, context, options) {
 					const blockResults = results[blockId] ?? (results[blockId] = {});
 					blockResults[key] = data;
 				} catch (error) {
+					const blockFailures = loaderFailures[blockId] ?? (loaderFailures[blockId] = {});
+					blockFailures[key] = {
+						endpoint,
+						params
+					};
 					if (onError) onError(error, {
 						block: block.kind,
 						loader: key
@@ -39831,7 +40294,10 @@ async function prefetchBlockData$1(page, context, options) {
 		}
 	}
 	if (tasks.length > 0) await Promise.all(tasks);
-	return results;
+	return {
+		resolvedData: results,
+		loaderFailures
+	};
 }
 //#endregion
 //#region ../blocks/src/system/data/loaderEndpoints.ts
@@ -39859,8 +40325,8 @@ function toStringParams(value) {
 	for (const [k, v] of Object.entries(value)) if (typeof v === "string") out[k] = v;
 	return out;
 }
-function stripEmptyStringValues(params) {
-	for (const [key, value] of Object.entries(params)) if (value === "") delete params[key];
+function stripEmptyStringValues(params, endpoint) {
+	for (const [key, value] of Object.entries(params)) if (value === "" && !(key === "seriesIds" && (endpoint === "listPublicEvents" || endpoint === "listPublicEventCalendarWindow"))) delete params[key];
 }
 function ensureSiteId(params, context) {
 	if (!params.siteId && typeof context.siteId === "string" && context.siteId) params.siteId = context.siteId;
@@ -39873,7 +40339,7 @@ function ensureSiteId(params, context) {
 */
 function normalizeLoaderParams(endpoint, params, context) {
 	const out = toStringParams(params);
-	stripEmptyStringValues(out);
+	stripEmptyStringValues(out, endpoint);
 	if (endpoint === "getPublicFormById") {
 		ensureSiteId(out, context);
 		if (!out.formId && out.formSlug) {
@@ -40181,7 +40647,17 @@ const riverbankSiteConfigInputSchema = z.object({
 z.object({
 	config: riverbankSiteConfigInputSchema,
 	forceContentTypes: z.boolean().optional(),
-	mode: z.enum(["apply", "preview"]).optional()
+	mode: z.enum(["apply", "preview"]).optional(),
+	expectedMailingListProviderScope: z.unknown().transform((value, ctx) => {
+		if (value === void 0) return void 0;
+		const parsed = parseMailingListProviderScope(value);
+		if (parsed.ok) return parsed.value;
+		ctx.addIssue({
+			code: "custom",
+			message: "Invalid mailing-list provider scope"
+		});
+		return z.NEVER;
+	}).optional()
 }).strict();
 //#endregion
 //#region ../api/src/sdkThemeWire.ts
@@ -41315,9 +41791,11 @@ function convertPageResponseBlock(block) {
 	if (typeof block.id !== "string" && block.id !== null) throw new Error(`Invalid block id in page: expected string or null, got ${typeof block.id}`);
 	if (typeof block.kind !== "string") throw new Error(`Invalid block kind in page: expected string, got ${typeof block.kind}`);
 	if (typeof block.purpose !== "string") throw new Error(`Invalid block purpose in page: expected string, got ${typeof block.purpose}`);
+	if (block.contentVersionId !== void 0 && block.contentVersionId !== null && typeof block.contentVersionId !== "string") throw new Error(`Invalid content version id in page: expected string or null, got ${typeof block.contentVersionId}`);
 	const admission = readInvalidBlockAdmission(block.admission);
 	return {
 		id: block.id,
+		...block.contentVersionId !== void 0 ? { contentVersionId: block.contentVersionId } : {},
 		kind: block.kind,
 		purpose: block.purpose,
 		content: sanitizeSdkRuntimeBlockContent(block.kind, readContentRecord(block.content) ?? {}),
@@ -41350,6 +41828,7 @@ function projectRenderablePageOutline(page) {
 		...page,
 		blocks: page.blocks.flatMap((block) => block.admission.kind === "renderable" ? [{
 			id: block.id,
+			...block.contentVersionId !== void 0 ? { contentVersionId: block.contentVersionId } : {},
 			kind: block.kind,
 			purpose: block.purpose,
 			content: block.admission.content,
@@ -41360,6 +41839,7 @@ function projectRenderablePageOutline(page) {
 function admitSdkRuntimePageBlock(block, customBlocks) {
 	const base = {
 		id: block.id,
+		...block.contentVersionId !== void 0 ? { contentVersionId: block.contentVersionId } : {},
 		kind: block.kind,
 		purpose: block.purpose,
 		...block.bindings ? { bindings: block.bindings } : {}