@riverbankcms/sdk 0.140.0 → 0.142.0

package/dist/server/rendering.mjs

@@ -2461,6 +2461,7 @@ function isDisplayMediaKind$2(kind) {
 }
 const siteOptionSources = [
 	"eventCategories",
+	"eventSeries",
 	"venues",
 	"staffMembers"
 ];
@@ -7186,14 +7187,12 @@ function generateVariantCSS(variant, themeId, cardClasses, tokens, theme) {
 		const shadowValue = generateShadowValue$1(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}`,
@@ -12663,6 +12662,54 @@ function defaultTypographyForRecipe(recipe) {
 		case "classic-serif": return classicSerifTypography;
 	}
 }
+//#endregion
+//#region ../theme-core/src/footer/mode.ts
+const footerModeSchema = z$1.enum([
+	"default",
+	"blocks",
+	"default+blocks",
+	"none"
+]);
+/** Reads only SDK footer intent; unrelated config and theme fields are not authorities. */
+function resolveSdkFooterMode(config) {
+	const parsed = z$1.object({ layout: z$1.object({ footerMode: footerModeSchema.optional() }).optional() }).safeParse(config);
+	return parsed.success ? parsed.data.layout?.footerMode ?? "default" : "default";
+}
+/**
+* Resolve what to render for the footer given the current mode and whether the
+* site is SDK-managed.
+*
+* Backwards compatible: missing/undefined mode is treated as 'default'.
+*/
+function resolveFooterRenderPlan(params) {
+	if (!params.isSdkSite) return {
+		mode: "default",
+		renderDefaultFooter: true,
+		renderFooterBlocks: false
+	};
+	switch (params.mode ?? "default") {
+		case "blocks": return {
+			mode: "blocks",
+			renderDefaultFooter: false,
+			renderFooterBlocks: true
+		};
+		case "default+blocks": return {
+			mode: "default+blocks",
+			renderDefaultFooter: true,
+			renderFooterBlocks: true
+		};
+		case "none": return {
+			mode: "none",
+			renderDefaultFooter: false,
+			renderFooterBlocks: false
+		};
+		default: return {
+			mode: "default",
+			renderDefaultFooter: true,
+			renderFooterBlocks: false
+		};
+	}
+}
 const hotspotSchema = z$1.object({
 	x: z$1.number().min(0).max(1),
 	y: z$1.number().min(0).max(1),
@@ -13224,7 +13271,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) {
@@ -13812,6 +13859,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
@@ -13844,6 +13910,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(" ")
+	});
+}
 //#endregion
 //#region ../theme-core/src/interactive/generateBaseCSS.ts
 /**
@@ -15756,26 +15843,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.
@@ -17748,12 +17828,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",
@@ -17842,9 +17916,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(),
@@ -28078,6 +28152,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()),
@@ -28208,6 +28291,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()
@@ -28258,7 +28342,56 @@ const calendarWindowPageSchema = z$1.discriminatedUnion("kind", [z$1.object({
 	kind: z$1.literal("partial"),
 	nextCursor: calendarSourceCursorSchema
 })]);
+//#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(",");
+}
 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",
@@ -30012,17 +30145,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,
@@ -31294,6 +31426,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(),
@@ -31370,7 +31503,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,
@@ -31381,7 +31514,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) {
@@ -31400,13 +31534,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";
@@ -31437,7 +31572,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",
@@ -33944,12 +34082,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 })
 				})]
 			})]
 		})]
@@ -35042,6 +35180,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()
@@ -35088,6 +35227,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(),
@@ -35135,11 +35275,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),
@@ -35147,6 +35291,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 {
@@ -35161,14 +35313,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)
@@ -35738,13 +35891,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
 						]
@@ -38689,6 +38839,65 @@ 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/runtime/nodes/events/EventCalendar.interactive.ts
 const eventCalendarSourceSchema = z$1.object({
 	...eventCollectionSourceSchemaShape,
@@ -38786,19 +38995,59 @@ function buildEventCalendarInteractiveIslandProps(props) {
 //#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 = {
@@ -38928,6 +39177,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
@@ -38949,17 +39205,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"
@@ -39463,6 +39749,7 @@ const eventCalendarAdditionalFields = [
 			}
 		}
 	},
+	...eventSelectionFields,
 	{
 		id: "eventSurface",
 		type: "select",
@@ -39672,7 +39959,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",
@@ -39781,6 +40068,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(),
@@ -39841,6 +40129,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),
@@ -45198,9 +45487,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)";
@@ -48333,7 +48669,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,
@@ -48343,6 +48679,7 @@ function buildPageRendererRootRuntime(dataContext) {
 		apiBaseUrl,
 		portalToken,
 		bookingOfferingPresets,
+		appointmentServicePathPrefix,
 		mailingList,
 		eventRegistrationOverlayEnabled,
 		loaderFailures
@@ -53085,7 +53422,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" })
 		})]
@@ -59779,10 +60117,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(
@@ -70139,6 +70486,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));
@@ -72405,41 +72769,6 @@ function ThemeScope$1({ theme, children, themeId = "theme-default", responsiveMo
 		children
 	});
 }
-/**
-* Resolve what to render for the footer given the current mode and whether the
-* site is SDK-managed.
-*
-* Backwards compatible: missing/undefined mode is treated as 'default'.
-*/
-function resolveFooterRenderPlan(params) {
-	if (!params.isSdkSite) return {
-		mode: "default",
-		renderDefaultFooter: true,
-		renderFooterBlocks: false
-	};
-	switch (params.mode ?? "default") {
-		case "blocks": return {
-			mode: "blocks",
-			renderDefaultFooter: false,
-			renderFooterBlocks: true
-		};
-		case "default+blocks": return {
-			mode: "default+blocks",
-			renderDefaultFooter: true,
-			renderFooterBlocks: true
-		};
-		case "none": return {
-			mode: "none",
-			renderDefaultFooter: false,
-			renderFooterBlocks: false
-		};
-		default: return {
-			mode: "default",
-			renderDefaultFooter: true,
-			renderFooterBlocks: false
-		};
-	}
-}
 //#endregion
 //#region ../theme-core/src/ResponsiveScope.tsx
 /**
@@ -72507,6 +72836,15 @@ z$1.object({
 	}).optional(),
 	overrides: z$1.record(z$1.string(), z$1.string()).optional()
 }).passthrough();
+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) {
@@ -74461,12 +74799,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) {
@@ -74530,6 +74868,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));
@@ -74558,7 +74904,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 = [];
@@ -74575,6 +74921,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 ?? {},
@@ -74672,8 +75019,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;
@@ -74686,7 +75033,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) {
@@ -75114,7 +75461,7 @@ async function Layout(props) {
 	if (footer === true) {
 		const footerPlan = resolveFooterRenderPlan({
 			isSdkSite: Boolean(site.is_sdk_site),
-			mode: theme.footer?.mode
+			mode: resolveSdkFooterMode(siteData.sdkConfig)
 		});
 		const footerBlocksElement = footerPlan.renderFooterBlocks && footerBlocks.length > 0 ? /* @__PURE__ */ jsx(PageRenderer, {
 			theme,
@@ -77735,11 +78082,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()