@riverbankcms/sdk 0.140.0 → 0.142.0

package/dist/server/next.mjs

@@ -3259,6 +3259,14 @@ function adaptFields(rawFields, flattenRepeaterGroups = false, defaultFileKinds
 		}];
 	}));
 }
+//#endregion
+//#region ../theme-core/src/footer/mode.ts
+const footerModeSchema = z$1.enum([
+	"default",
+	"blocks",
+	"default+blocks",
+	"none"
+]);
 const hotspotSchema = z$1.object({
 	x: z$1.number().min(0).max(1),
 	y: z$1.number().min(0).max(1),
@@ -4760,7 +4768,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 formatButtonColourContractError(error) {
 	switch (error.tag) {
@@ -5348,6 +5356,25 @@ function parseThemeForPersistence(value) {
 	};
 }
 //#endregion
+//#region ../theme-core/src/buttons/affordanceSuppression.ts
+/**
+* Internal: the opt-out the generated affordance rule is written against.
+*
+* A button style may declare a trailing `affordance`, which the theme renders as
+* a CSS `::after` on every button of that variant. An authored button that
+* renders its own trailing icon must not also receive the theme's, or it shows
+* two.
+*
+* Deliberately not exported from `./index`. This used to be public, and two
+* block components reached past the theme to draw arrows of their own — one of
+* them doubling up on the styles that declare an affordance, both of them
+* overriding the twelve styles that deliberately declare none. Whether a button
+* carries a trailing affordance is the style's decision; the only caller that
+* legitimately opts out is the authored-button renderer, which reaches it
+* through `themeButtonClassNameWithTrailingIcon`.
+*/
+const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
+//#endregion
 //#region ../theme-core/src/buttons/classNames.ts
 /**
 * Parse content/runtime variant identifiers into the closed theme-button class
@@ -5380,6 +5407,27 @@ function themeButtonClassName(spec) {
 		spec.extraClassName
 	].filter(Boolean).join(" ");
 }
+/**
+* Button classes for an authored button that renders its own trailing icon.
+*
+* A separate function rather than a flag on `themeButtonClassName`, because
+* there is exactly one caller and it should stay visible in a diff. The name
+* states what the caller knows to be true of its own markup — that it renders a
+* trailing icon — rather than what the theme does about it. The consequence is
+* the theme's to decide and to change; a caller naming the consequence would be
+* asserting a policy it does not own, and would quietly become a lie the moment
+* that policy moved.
+*
+* Do not reach for this to remove an arrow you simply do not want. A trailing
+* affordance is declared by the button style, and a block overriding that is the
+* defect this replaced.
+*/
+function themeButtonClassNameWithTrailingIcon(spec) {
+	return themeButtonClassName({
+		...spec,
+		extraClassName: [spec.extraClassName, AFFORDANCE_SUPPRESS_CLASS].filter(Boolean).join(" ")
+	});
+}
 const defaultThemeTokens = {
 	color: {
 		"background/base": "#ffffff",
@@ -7798,26 +7846,19 @@ function resolvedButtonFocusDeclarations(indicator, role) {
 	] : [["outline", value("outline", `3px solid ${indicator.colorCss}`)], ["outline-offset", value("outline-offset", "3px")]];
 }
 /**
-* Disabled buttons retain their validated colour pair and add a non-layout
-* visual affordance. `currentColor` keeps the cue inside the same contrast
-* relationship, while retaining pointer events lets the not-allowed cursor
-* remain observable.
+* Disabled buttons are deliberately muted as unavailable controls. Native
+* disabled controls are exempt from active-control contrast requirements;
+* opacity distinguishes the state without introducing a focus-like outline.
+* Retaining pointer events lets the not-allowed cursor remain observable.
 */
 const RESOLVED_BUTTON_DISABLED_DECLARATIONS = [
 	["cursor", "not-allowed"],
 	["transform", "none"],
 	["box-shadow", "none"],
-	["outline", "2px dashed currentColor"],
-	["outline-offset", "-4px"]
+	["opacity", "0.55"]
 ];
 //#endregion
 //#region ../theme-core/src/buttons/generateButtonCss.ts
-/**
-* Class the `button` runtime node adds when it renders its own trailing icon,
-* so a node-level icon suppresses the theme's CSS `::after` affordance.
-* Shared so generator and renderer can't drift.
-*/
-const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";
 const BUTTON_SIZE_NAMES = buttonSizeNameSchema.options;
 /**
 * Letter spacing token → CSS value.
@@ -10611,14 +10652,12 @@ function generateVariantCSS(variant, themeId, cardClasses, tokens, theme) {
 		const shadowValue = generateShadowValue(shadow);
 		rules.push(`box-shadow: ${shadowValue}`);
 	}
-	rules.push(`display: flex`);
-	rules.push(`flex-direction: column`);
-	rules.push(`position: relative`);
-	rules.push(`overflow: visible`);
+	const structureSelector = cardClasses.map((cardClass) => `:where([data-theme-scope="${themeId}"]) :where(.${cardClass})`).join(",\n");
 	const mediaRadius = MEDIA_CORNER_MAP[corners];
 	const mediaRules = [`border-top-left-radius: ${mediaRadius}`, `border-top-right-radius: ${mediaRadius}`];
 	const contentRules = [`padding: ${resolveContentPadding(variant)}`];
 	return [
+		`${structureSelector} {\n  display: flex;\n  flex-direction: column;\n  position: relative;\n  overflow: visible;\n}`,
 		`${containerSelector} {\n  ${rules.join(";\n  ")};\n}`,
 		...cardDecorationPseudoRules(containerSelectors, variant.decorations, resolveColor),
 		`${fallbackBackgroundSelector} {\n  background: transparent;\n}`,
@@ -12580,12 +12619,6 @@ const footerVariant = z$1.enum([
 	"split"
 ]);
 const footerMaxWidth = z$1.enum(["container", "full"]);
-const footerMode = z$1.enum([
-	"default",
-	"blocks",
-	"default+blocks",
-	"none"
-]);
 const footerNavLayoutMode = z$1.enum([
 	"stack",
 	"inline",
@@ -12674,9 +12707,9 @@ const footerSchema = z$1.object({
 	/**
 	* SDK-only footer rendering mode.
 	*
-	* Backwards compatible: missing/undefined behaves as 'default'.
+	* Historical persisted field; SDK rendering mode now lives in layout.footerMode.
 	*/
-	mode: footerMode.optional(),
+	mode: footerModeSchema.optional(),
 	variant: footerVariant,
 	maxWidth: footerMaxWidth,
 	showLogoText: z$1.boolean().optional(),
@@ -13299,6 +13332,15 @@ const publicEventBaseSchema = z$1.object({
 	timeZone: z$1.string(),
 	pricing: publicEventPricingSchema,
 	paymentTerms: blockBookingPaymentTermsSchema,
+	cancellationPolicy: z$1.object({ refunds: z$1.object({
+		mode: z$1.enum([
+			"never",
+			"always",
+			"cutoff"
+		]),
+		cutoffHours: z$1.number(),
+		method: z$1.enum(["original_payment_method", "site_credit"])
+	}) }),
 	consent: blockBookingConsentSchema.nullable(),
 	accessRestriction: accessRestrictionSchema,
 	allowedCategoryIds: z$1.array(z$1.string()),
@@ -13470,6 +13512,7 @@ const calendarWindowQuerySchema = z$1.object({
 	eventSurface: z$1.enum(eventSurfaceScopeValues).optional(),
 	eventPresets: z$1.string().optional(),
 	scheduleScope: z$1.enum(eventScheduleScopeValues).optional(),
+	seriesIds: z$1.string().optional(),
 	categoryIds: z$1.string().optional(),
 	venueId: z$1.string().transform(normalizeCalendarFilterId).optional(),
 	staffMemberId: z$1.string().transform(normalizeCalendarFilterId).optional()
@@ -23298,6 +23341,7 @@ function isDisplayMediaKind$2(kind) {
 }
 const siteOptionSources = [
 	"eventCategories",
+	"eventSeries",
 	"venues",
 	"staffMembers"
 ];
@@ -27666,6 +27710,35 @@ function buildBookingFormInteractiveIslandProps(props) {
 	});
 }
 //#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/domain/capacity.ts
 /**
 * Compute remaining spots for an event from `availableSpots` with a fallback
@@ -30285,12 +30358,12 @@ const EventCompactRow = ({ event, buttonVariant = "primary", buttonText }) => {
 				}), cta.hidden ? /* @__PURE__ */ jsx("span", {
 					className: "event-compact-row-status",
 					children: cta.label
-				}) : /* @__PURE__ */ jsxs("a", {
+				}) : /* @__PURE__ */ jsx("a", {
 					href: cta.href,
 					target: cta.external ? "_blank" : void 0,
 					rel: cta.external ? "noopener noreferrer" : void 0,
 					className: `${buttonClass} event-compact-row-cta`,
-					children: [/* @__PURE__ */ jsx("span", { children: cta.label }), /* @__PURE__ */ jsx(ArrowRightIcon, { "aria-hidden": "true" })]
+					children: /* @__PURE__ */ jsx("span", { children: cta.label })
 				})]
 			})]
 		})]
@@ -30582,6 +30655,7 @@ const eventCollectionFilterSourceSchemaShape = {
 	eventSurface: eventSurfaceScopeSchema$1.nullable().optional(),
 	filterEventPresets: z$1.union([z$1.string(), z$1.array(z$1.string())]).nullable().optional(),
 	scheduleScope: eventScheduleScopeSchema$1.nullable().optional(),
+	seriesIds: z$1.union([z$1.string(), z$1.array(z$1.string())]).nullable().optional(),
 	filterCategoryIds: z$1.union([z$1.string(), z$1.array(z$1.string())]).nullable().optional(),
 	filterStaffMemberId: z$1.string().nullable().optional(),
 	filterVenueId: z$1.string().nullable().optional()
@@ -30628,6 +30702,7 @@ const eventCollectionDisplaySchemaShape = {
 	eventSurface: eventSurfaceScopeSchema$1,
 	filterEventPresets: z$1.string().nullable(),
 	scheduleScope: eventScheduleScopeSchema$1,
+	seriesIds: z$1.string().nullable().optional(),
 	filterCategoryIds: z$1.string().nullable(),
 	filterStaffMemberId: z$1.string().nullable(),
 	filterVenueId: z$1.string().nullable(),
@@ -30675,11 +30750,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),
@@ -30687,6 +30766,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 {
@@ -30701,14 +30788,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)
@@ -30794,6 +30882,7 @@ const eventListingHydrationSchema = z$1.object({
 	eventSurface: eventSurfaceScopeSchema,
 	filterEventPresets: z$1.string().nullable(),
 	scheduleScope: eventScheduleScopeSchema,
+	seriesIds: z$1.string().nullable().optional(),
 	filterCategoryIds: z$1.string().nullable().optional(),
 	filterStaffMemberId: z$1.string().nullable().optional(),
 	filterVenueId: z$1.string().nullable().optional(),
@@ -30854,6 +30943,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),
@@ -39472,13 +39562,6 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
-	sdkCatalogTheme: {
-		path: "/sdk/{siteId}/catalog/theme",
-		method: "GET",
-		errors: ["server:internal_error"],
-		auth: "service",
-		responseKind: "json"
-	},
 	sdkCatalogBlocks: {
 		path: "/sdk/{siteId}/catalog/blocks",
 		method: "GET",
@@ -39539,12 +39622,6 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
-	sdkPullTheme: {
-		path: "/sdk/{siteId}/pull/theme",
-		method: "GET",
-		auth: "service",
-		responseKind: "json"
-	},
 	sdkPullFooter: {
 		path: "/sdk/{siteId}/pull/footer",
 		method: "GET",
@@ -39651,30 +39728,6 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
-	sdkUpsertTheme: {
-		path: "/sdk/{siteId}/theme",
-		method: "POST",
-		auth: "service",
-		responseKind: "json",
-		errors: [
-			"validation:invalid_input",
-			"resource:not_found",
-			"resource:conflict",
-			"server:internal_error"
-		]
-	},
-	sdkApplySiteStyleSelection: {
-		path: "/sdk/{siteId}/theme/style-selection/apply",
-		method: "POST",
-		auth: "service",
-		responseKind: "json",
-		errors: [
-			"validation:invalid_input",
-			"resource:not_found",
-			"resource:conflict",
-			"server:internal_error"
-		]
-	},
 	sdkUpsertFooter: {
 		path: "/sdk/{siteId}/footer",
 		method: "POST",
@@ -42715,6 +42768,26 @@ const headerRuntimeTransforms = [{
 	run: resolveHeaderChromeRuntimeContract
 }];
 const defaultTransforms = createTransformRegistry([
+	{
+		id: "events.calendarSelectionParam",
+		kind: "formatter",
+		summary: "Resolve selected events instead of discovery filters",
+		schema: z$1.object({ key: z$1.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",
@@ -43892,17 +43965,16 @@ const ButtonNode = ({ value, children, href, variantId = "primary", size = "md",
 		if (process.env.NODE_ENV === "development") console.warn("[ButtonNode] Missing href for link-required button");
 		return null;
 	}
-	const extraClassName = affordanceIcon ? [className, AFFORDANCE_SUPPRESS_CLASS].filter(Boolean).join(" ") : className;
 	const resolvedVariantId = parseThemeButtonVariantId(variantId);
 	if (variantId && !resolvedVariantId) {
 		console.error("[ButtonNode] Invalid button variant", { variantId });
 		return null;
 	}
-	const combinedClassName = resolvedVariantId ? themeButtonClassName({
+	const combinedClassName = resolvedVariantId ? (affordanceIcon ? themeButtonClassNameWithTrailingIcon : themeButtonClassName)({
 		variant: resolvedVariantId,
 		size,
-		extraClassName
-	}) : extraClassName;
+		extraClassName: className
+	}) : className;
 	if (resolvedHref) return /* @__PURE__ */ jsxs("a", {
 		href: resolvedHref,
 		target,
@@ -45089,6 +45161,7 @@ const publicPricingSchema = z$1.object({
 });
 const publicAppointmentServiceSchema = z$1.object({
 	id: z$1.string().min(1),
+	slug: z$1.string().min(1).optional(),
 	title: z$1.string(),
 	description: z$1.string().nullable().optional(),
 	durationMinutes: z$1.number().int().positive(),
@@ -45165,7 +45238,7 @@ function formatAmountOrFree(amount, currency) {
 		currency
 	}, { decimals: "auto" });
 }
-function buildRows(services, pathname) {
+function buildRows(services, pathname, servicePathPrefix) {
 	return services.map((service) => ({
 		id: service.id,
 		title: service.title,
@@ -45176,7 +45249,8 @@ function buildRows(services, pathname) {
 		href: resolveDedicatedBookingHref(pathname, {
 			kind: "appointment_service",
 			serviceId: service.id
-		})
+		}),
+		detailsHref: servicePathPrefix && service.slug ? `${servicePathPrefix.replace(/\/$/, "")}/${encodeURIComponent(service.slug)}` : null
 	}));
 }
 function buildAppointmentServicesView(input) {
@@ -45195,13 +45269,14 @@ function buildAppointmentServicesView(input) {
 	};
 	return {
 		kind: "items",
-		rows: buildRows(parsed.services, input.pathname)
+		rows: buildRows(parsed.services, input.pathname, input.servicePathPrefix ?? null)
 	};
 }
-function AppointmentServicesNode({ sectionHeading, services, pathname, className }) {
+function AppointmentServicesNode({ sectionHeading, services, pathname, servicePathPrefix, className }) {
 	const view = buildAppointmentServicesView({
 		services,
-		pathname: typeof pathname === "string" ? pathname : void 0
+		pathname: typeof pathname === "string" ? pathname : void 0,
+		servicePathPrefix: typeof servicePathPrefix === "string" ? servicePathPrefix : null
 	});
 	const rootClassName = `appointment-services ${className ?? ""}`.trim();
 	const RowTitle = sectionHeading ? "h3" : "h2";
@@ -45232,7 +45307,10 @@ function AppointmentServicesNode({ sectionHeading, services, pathname, className
 						children: [
 							/* @__PURE__ */ jsx(RowTitle, {
 								className: "appointment-services-row-title rb-text-lg rb-font-medium rb-leading-tight",
-								children: row.title
+								children: row.detailsHref ? /* @__PURE__ */ jsx("a", {
+									href: row.detailsHref,
+									children: row.title
+								}) : row.title
 							}),
 							row.description ? /* @__PURE__ */ jsx("p", {
 								className: "appointment-services-row-description rb-text-sm rb-leading-6 status-muted",
@@ -46762,13 +46840,10 @@ function OfferingsPreviewContent(props) {
 							}),
 							groupCta ? /* @__PURE__ */ jsx("footer", {
 								className: "offerings-preview-card-footer rb-mt-auto rb-flex",
-								children: /* @__PURE__ */ jsxs("a", {
+								children: /* @__PURE__ */ jsx("a", {
 									className: groupLinkClass,
 									href: groupCta.href,
-									children: [/* @__PURE__ */ jsx("span", { children: groupCta.label }), /* @__PURE__ */ jsx(ArrowRightIcon, {
-										"aria-hidden": "true",
-										className: "offerings-preview-link-icon rb-h-4 rb-w-4"
-									})]
+									children: /* @__PURE__ */ jsx("span", { children: groupCta.label })
 								})
 							}) : null
 						]
@@ -48130,22 +48205,121 @@ const formBlockDefinition = {
 	runtime: formBlockRuntime
 };
 //#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/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",
+		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" }]
 	} },
-	scheduleScope: { $bind: { from: "content.scheduleScope" } },
-	categoryIds: { $bind: { from: "content.filterCategoryIds" } },
-	staffMemberId: { $bind: { from: "content.filterStaffMemberId" } },
-	venueId: { $bind: { from: "content.filterVenueId" } }
+	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 = {
@@ -48275,6 +48449,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
@@ -48296,17 +48477,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"
@@ -48810,6 +49021,7 @@ const eventCalendarAdditionalFields = [
 			}
 		}
 	},
+	...eventSelectionFields,
 	{
 		id: "eventSurface",
 		type: "select",
@@ -49019,7 +49231,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",
@@ -54051,9 +54263,56 @@ function generateNavLinkCSS(options) {
 	if (baseRules.length > 0) cssChunks.unshift(`\n${selector} {\n  ${baseRules.join("\n  ")}\n}\n`);
 	if (hoverRules.length > 0) cssChunks.push(`\n${hoverSelector} {\n  ${hoverRules.join("\n  ")}\n}\n`);
 	if (activeRules.length > 0) cssChunks.push(`\n${activeSelector} {\n  ${activeRules.join("\n  ")}\n}\n`);
+	cssChunks.push(navLinkFocusVisibleCss(selector, style, theme, tokens));
 	cssChunks.push(generateInteractiveChildInheritanceCSS(selector));
 	return cssChunks.join("");
 }
+/**
+* Keyboard focus indicator for nav links, in the header, the footer and header
+* dropdown menus — the three surfaces `generateNavLinkCSS` serves.
+*
+* Emitted unconditionally rather than as an effect, because focus visibility is
+* a floor rather than a style choice. Only the interaction-palette pill ever
+* wrote an `effects.focus` group, so every other nav — every `quiet` palette,
+* every footer, every dropdown — previously fell back to whatever outline the
+* browser drew.
+*
+* The outline takes the link's own resolved colour, so on a header that adapts
+* to the section it floats over it moves with the adaptation instead of
+* asserting a brand colour against an unknown backdrop.
+*
+* Where the style asks for `soft-glow`, the same halo goes on the outline. That
+* treatment exists because the theme has already conceded the resolved colour
+* alone is not reliable over an unpredictable backdrop — a hero photograph with
+* mixed luminance. Without it the text would stay legible by its halo while the
+* focus ring, which is the part with a contrast requirement of its own, would
+* not.
+*
+* A style that also paints a focus pill keeps it: this adds an outline around
+* that pill rather than replacing it.
+*/
+function navLinkFocusVisibleCss(selector, style, theme, tokens) {
+	const color = tokens.getColor(style.colorToken);
+	const halo = buildTextContrastShadow({
+		theme,
+		colorToken: style.colorToken,
+		treatment: style.contrastTreatment
+	});
+	return `
+${selector}:focus-visible {
+  outline: 2px solid ${color};
+  outline-offset: ${focusOutlineOffset(selector)};${halo ? `\n  box-shadow: ${halo};` : ""}
+}
+`;
+}
+/**
+* Dropdown items are full-width inside a panel with no horizontal padding, so
+* an outset outline would paint over and past the panel's own border. Keeping
+* it flush is the only way it reads as belonging to the item.
+*/
+function focusOutlineOffset(selector) {
+	return selector.includes("nav-dropdown-link") ? "-2px" : "3px";
+}
 function buildTextContrastShadow(input) {
 	if (input.treatment !== "soft-glow") return null;
 	return isLikelyLightColorToken(input.theme, input.colorToken) ? "0 1px 3px rgb(0 0 0 / 0.55), 0 0 18px rgb(0 0 0 / 0.38)" : "0 1px 3px rgb(255 255 255 / 0.72), 0 0 18px rgb(255 255 255 / 0.5)";
@@ -57186,7 +57445,7 @@ function pageBlockPosition(index, blockCount) {
 //#endregion
 //#region ../blocks/src/pageRendererContracts.ts
 function buildPageRendererRootRuntime(dataContext) {
-	const { siteId = null, pageId = null, pathname = null, bookingTimeZone, previewStage = "published", apiBaseUrl = null, portalToken = null, bookingOfferingPresets = [], mailingList = { tag: "not_configured" }, eventRegistrationOverlayEnabled = false, loaderFailures = {} } = dataContext ?? {};
+	const { siteId = null, pageId = null, pathname = null, bookingTimeZone, previewStage = "published", apiBaseUrl = null, portalToken = null, bookingOfferingPresets = [], appointmentServicePathPrefix = null, mailingList = { tag: "not_configured" }, eventRegistrationOverlayEnabled = false, loaderFailures = {} } = dataContext ?? {};
 	return {
 		siteId,
 		pageId,
@@ -57196,6 +57455,7 @@ function buildPageRendererRootRuntime(dataContext) {
 		apiBaseUrl,
 		portalToken,
 		bookingOfferingPresets,
+		appointmentServicePathPrefix,
 		mailingList,
 		eventRegistrationOverlayEnabled,
 		loaderFailures
@@ -61874,7 +62134,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" })
 		})]
@@ -69312,10 +69573,19 @@ const containerResponsiveThemeCss = `/*
     padding-top: 2.5rem;
     padding-bottom: 2.5rem;
   }
+  /* Clearance for a surface that is not an authored block page.
+     An authored page gets this through its opening block's container (see the
+     overlay-clearance rule in styles.css). A reserved surface or a system
+     destination page has no such block, so it consumes the same variable here.
+     Marked with one class rather than per-surface selectors, because the last
+     two additions to this family were both missed and shipped overlapping. */
   :where(.theme-scope)
     [data-site-document-layout-mode="header-overlay"]
-    [data-rb-reserved-surface].rb-reserved-surface-main {
-    padding-top: calc(var(--rb-reserved-surface-header-offset, 5.5rem) + 2.5rem);
+    .rb-overlay-clearance-surface {
+    padding-top: calc(
+      var(--site-overlay-header-clearance, 5.5rem) +
+        var(--site-overlay-opening-content-extra-pad, clamp(1rem, 2vw, 1.75rem))
+    );
   }
   .rb-preview-editor-offset {
     padding-bottom: calc(
@@ -79672,6 +79942,23 @@ const containerResponsiveThemeCss = `/*
   gap: 0.5rem;
 }
 
+/* Error panel and field notes. The form block scopes these to its own
+   data-block, so the newsletter form (which also renders in the footer)
+   needs its own copy of the treatment. */
+:where(.theme-scope) .newsletter-form .fb-error:not([data-field-validation-message]) {
+  background-color: var(--fb-error-bg);
+  color: var(--fb-error-text);
+  border: 1px solid var(--fb-error-border);
+  border-radius: var(--rb-block-radius);
+  padding: 1rem;
+  font-size: 0.875rem;
+}
+
+:where(.theme-scope) .newsletter-form [data-field-validation-message] {
+  font-size: 0.875rem;
+  color: var(--fb-error-text);
+}
+
 /* Required indicator */
 :where(.theme-scope) .newsletter-required {
   color: rgb(var(--tb-primary));
@@ -82143,12 +82430,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) {
@@ -82212,6 +82499,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));
@@ -82240,7 +82535,7 @@ async function prefetchBlockData$1(page, context, 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 } = options;
+	const { apiClient, isValidEndpoint, onError, getCustomBlockLoaders, getBlockDefinition: getBlockDefinition$1 = getBlockDefinition, resolveParamsBindings: resolveParamsBindings$1 = resolveParamsBindings, shouldLoad } = options;
 	const results = {};
 	const loaderFailures = {};
 	const tasks = [];
@@ -82257,6 +82552,7 @@ async function prefetchBlockDataWithFailures(page, context, options) {
 				loader
 			})) : [];
 		} else loaders = [];
+		loaders = projectDataLoaders(loaders, shouldLoad, blockId, block.kind);
 		if (loaders.length === 0) continue;
 		const root = {
 			...context.root ?? {},
@@ -82357,8 +82653,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;
@@ -82371,7 +82667,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) {
@@ -82627,11 +82923,14 @@ const sdkSiteStyleConfigSchema = z$1.object({
 	sectionOptions: sdkSectionOptionsConfigSchema.optional(),
 	containerOptions: sdkContainerOptionsConfigSchema.optional()
 });
-const sdkSiteLayoutConfigSchema = z$1.object({ footerBlocks: z$1.array(z$1.object({
-	id: z$1.string().min(1).optional(),
-	kind: z$1.string().min(1),
-	content: z$1.record(z$1.string(), z$1.unknown()).optional()
-})).optional() });
+const sdkSiteLayoutConfigSchema = z$1.object({
+	footerMode: footerModeSchema.optional(),
+	footerBlocks: z$1.array(z$1.object({
+		id: z$1.string().min(1).optional(),
+		kind: z$1.string().min(1),
+		content: z$1.record(z$1.string(), z$1.unknown()).optional()
+	})).optional()
+});
 const sdkFieldSelectOptionSchema = z$1.object({
 	value: z$1.string(),
 	label: z$1.string()
@@ -87533,6 +87832,15 @@ function isEntryResponse(response) {
 function isPageSurfaceResponse(response) {
 	return response.type === "pageSurface";
 }
+z$1.object({
+	palette: paletteColorsSchema,
+	paletteMode: paletteModeSchema,
+	typography: z$1.object({
+		headingFamily: z$1.string().trim().min(1),
+		bodyFamily: z$1.string().trim().min(1)
+	}).strict(),
+	corners
+}).strict();
 //#endregion
 //#region src/rendering/blocks-theme-runtime.ts
 function parseBlocksTheme(theme) {
@@ -88909,7 +89217,7 @@ var CircuitOpenError = class extends Error {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.140.0";
+const SDK_VERSION = "0.142.0";
 //#endregion
 //#region src/next/content-load-failure.ts
 const SdkContentLoadError = RiverbankContentLoadError;