@riverbankcms/sdk 0.140.0 → 0.141.0

package/dist/server/server.mjs

@@ -9565,7 +9565,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.140.0";
+const SDK_VERSION = "0.141.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;
@@ -10899,7 +10899,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);
@@ -16457,6 +16457,7 @@ function isDisplayMediaKind(kind) {
 }
 const siteOptionSources = [
 	"eventCategories",
+	"eventSeries",
 	"venues",
 	"staffMembers"
 ];
@@ -35383,7 +35384,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" })
 		})]
@@ -37395,6 +37397,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
@@ -37523,6 +37554,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()
@@ -37585,6 +37617,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()
@@ -37631,6 +37664,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(),
@@ -37678,11 +37712,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),
@@ -37690,6 +37728,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 {
@@ -37704,14 +37750,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)
@@ -37777,6 +37824,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(),
@@ -37837,6 +37885,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),
@@ -38210,6 +38259,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,
@@ -38292,19 +38400,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",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "scheduleScope" }
+		}, { id: "value.csv" }]
+	} },
+	categoryIds: { $bind: {
+		from: "content",
+		transforms: [{
+			id: "events.calendarSelectionParam",
+			options: { key: "filterCategoryIds" }
+		}, { id: "value.csv" }]
 	} },
-	scheduleScope: { $bind: { from: "content.scheduleScope" } },
-	categoryIds: { $bind: { from: "content.filterCategoryIds" } },
-	staffMemberId: { $bind: { from: "content.filterStaffMemberId" } },
-	venueId: { $bind: { from: "content.filterVenueId" } }
+	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 = {
@@ -38434,6 +38582,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
@@ -38455,17 +38610,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"
@@ -38969,6 +39154,7 @@ const eventCalendarAdditionalFields = [
 			}
 		}
 	},
+	...eventSelectionFields,
 	{
 		id: "eventSurface",
 		type: "select",
@@ -39178,7 +39364,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",
@@ -45837,6 +46023,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",
@@ -46151,12 +46357,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) {
@@ -46220,6 +46426,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));
@@ -46248,7 +46462,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 = [];
@@ -46265,6 +46479,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 ?? {},
@@ -46346,8 +46561,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;
@@ -46360,7 +46575,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) {

package/dist/server/theme-bridge.mjs

@@ -1096,7 +1096,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) {
@@ -1789,17 +1789,16 @@ 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"]
 ];
 buttonSizeNameSchema.options;
 //#endregion
@@ -12509,10 +12508,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(
@@ -22869,6 +22877,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));
@@ -25528,14 +25553,11 @@ function normalizeTokenValue(value) {
 	if (trimmedValue.startsWith("#")) return hexToRgbChannels(trimmedValue);
 	return trimmedValue;
 }
-function buildThemeRuntimeFromBridge(config) {
-	validateThemeBridgeConfig(config);
-	return buildBridgeCssVars(config);
-}
 function buildThemeBridgeRuntime(config) {
-	const cssVars = buildThemeRuntimeFromBridge(config);
+	const validatedConfig = validateThemeBridgeConfig(config);
+	const cssVars = buildBridgeCssVars(validatedConfig);
 	const themeId = "sdk";
-	const corners = config.corners ?? "rounded";
+	const corners = validatedConfig.corners ?? "rounded";
 	const generatorTheme = buildBridgeGeneratorTheme(corners);
 	return {
 		themeId,
@@ -25694,6 +25716,7 @@ function validateThemeBridgeConfig(config) {
 	}
 	validateBridgeTokens(config.tokens);
 	if (config.overrides !== void 0) parseBridgeOverrideRules(config.overrides);
+	return config;
 }
 function resolveBridgeTokens(tokens) {
 	const resolved = {};
@@ -25872,6 +25895,15 @@ function buildBridgeGeneratorTheme(corners) {
 		}
 	};
 }
+z.object({
+	palette: paletteColorsSchema,
+	paletteMode: paletteModeSchema,
+	typography: z.object({
+		headingFamily: z.string().trim().min(1),
+		bodyFamily: z.string().trim().min(1)
+	}).strict(),
+	corners
+}).strict();
 //#endregion
 //#region src/theme-bridge/generateCssVars.ts
 /**

package/dist/server/theme.mjs

@@ -1335,7 +1335,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);

package/dist/styles/index.css

@@ -792,10 +792,19 @@
     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(
@@ -11094,6 +11103,23 @@
   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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riverbankcms/sdk",
-  "version": "0.140.0",
+  "version": "0.141.0",
   "description": "Riverbank CMS SDK for headless content consumption",
   "main": "./dist/server/index.mjs",
   "module": "./dist/server/index.mjs",