@riverbankcms/sdk 0.140.0 → 0.141.0

package/dist/server/routing.mjs

@@ -3646,7 +3646,7 @@ var init_buttonColourContract = __esmMin((() => {
 		nonTextMinimumRatio: 3,
 		gradientSamplesPerSegment: 20,
 		alphaBackgrounds: "reject-without-known-surface",
-		disabled: "retain-full-colour-contract"
+		disabled: "validated-colour-pair-with-muted-control-opacity"
 	};
 }));
 //#endregion
@@ -9511,6 +9511,7 @@ var init_calendarWindow = __esmMin((() => {
 		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()
@@ -21021,6 +21022,7 @@ var init_schema = __esmMin((() => {
 	];
 	siteOptionSources = [
 		"eventCategories",
+		"eventSeries",
 		"venues",
 		"staffMembers"
 	];
@@ -34505,7 +34507,8 @@ var init_appointment_services = __esmMin((() => {
 				el$1("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" })
 		})]
@@ -36171,6 +36174,38 @@ var init_event_spotlight = __esmMin((() => {
 	};
 }));
 //#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(",");
+}
+var init_eventSelection = __esmMin((() => {
+	init_src$4();
+}));
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/events/shared/listingLayout.ts
 /**
 * Build container class based on layout mode
@@ -36284,11 +36319,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),
@@ -36296,6 +36335,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 {
@@ -36310,14 +36357,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)
@@ -36325,6 +36373,7 @@ function buildEventCollectionHydration(source, now = /* @__PURE__ */ new Date())
 	};
 }
 var eventSurfaceScopeSchema$1, eventScheduleScopeSchema$1, eventCollectionFilterSourceSchemaShape, eventCollectionSourceSchemaShape, eventCollectionDisplaySchemaShape, eventCollectionHydrationSchema, init_eventCollectionContract = __esmMin((() => {
+	init_eventSelection();
 	init_calendarWindow();
 	init_cards();
 	init_src$4();
@@ -36342,6 +36391,7 @@ var eventSurfaceScopeSchema$1, eventScheduleScopeSchema$1, eventCollectionFilter
 		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()
@@ -36388,6 +36438,7 @@ var eventSurfaceScopeSchema$1, eventScheduleScopeSchema$1, eventCollectionFilter
 		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(),
@@ -36418,6 +36469,7 @@ var eventSurfaceScopeSchema$1, eventScheduleScopeSchema$1, eventCollectionFilter
 	});
 })), cardOrientationSchema, eventSurfaceScopeSchema, eventScheduleScopeSchema, eventListingSourceSchema, eventListingDisplaySchema, eventListingHydrationSchema, eventListingRenderSchema, eventListingBlockRuntime;
 var init_EventListing_interactive = __esmMin((() => {
+	init_eventSelection();
 	init_cards();
 	init_schemas();
 	init_shared$2();
@@ -36484,6 +36536,7 @@ var init_EventListing_interactive = __esmMin((() => {
 		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(),
@@ -36544,6 +36597,7 @@ var init_EventListing_interactive = __esmMin((() => {
 					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),
@@ -36936,6 +36990,69 @@ var init_event_listing = __esmMin((() => {
 	};
 }));
 //#endregion
+//#region ../blocks/src/system/blocks/events/eventSelectionFields.ts
+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] : []] }
+		}
+	};
+}
+var eventSelectionFields;
+var init_eventSelectionFields = __esmMin((() => {
+	init_schema();
+	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"
+			}
+		}
+	})];
+}));
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/events/EventCalendar.interactive.ts
 /**
 * Collapse an optional/blank string to `undefined` so downstream week-board
@@ -37029,19 +37146,59 @@ var init_eventCalendarDataLoaders = __esmMin((() => {
 	init_calendarWindow();
 	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" }]
+		} }
 	};
 	eventCalendarDataLoaders = {
 		events: {
@@ -37112,6 +37269,7 @@ function normalizeEventCalendarDefaultView(value) {
 }
 var eventCalendarLayout, eventCalendarAdditionalFields, eventCalendarVariants, eventCalendarContentShape, eventCalendarConfig, eventCalendarManifest, eventCalendarBlockDefinition;
 var init_event_calendar = __esmMin((() => {
+	init_eventSelectionFields();
 	init_schema();
 	init_builder$1();
 	init_styledSection();
@@ -37167,6 +37325,13 @@ var init_event_calendar = __esmMin((() => {
 					from: "content.defaultCalendarView",
 					fallback: "month"
 				} },
+				seriesIds: { $bind: {
+					from: "content",
+					transforms: [{
+						id: "events.calendarSelectionParam",
+						options: { key: "seriesIds" }
+					}]
+				} },
 				showFilters: { $bind: {
 					from: "content.showFilters",
 					fallback: true
@@ -37188,17 +37353,47 @@ var init_event_calendar = __esmMin((() => {
 					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"
@@ -37702,6 +37897,7 @@ var init_event_calendar = __esmMin((() => {
 				}
 			}
 		},
+		...eventSelectionFields,
 		{
 			id: "eventSurface",
 			type: "select",
@@ -37910,7 +38106,7 @@ var init_event_calendar = __esmMin((() => {
 		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",
@@ -44948,11 +45144,33 @@ var init_links = __esmMin((() => {
 }));
 //#endregion
 //#region ../blocks/src/system/transforms/registry/eventCalendar.ts
-var readJobSchema, eventCalendarReadProfile, eventCalendarReadEnabled;
+var selectionParamSchema, eventCalendarSelectionParam, readJobSchema, eventCalendarReadProfile, eventCalendarReadEnabled;
 var init_eventCalendar = __esmMin((() => {
 	init_events$1();
 	init_core();
 	init_calendarWindow();
+	init_eventSelection();
+	selectionParamSchema = z.object({ key: z.enum([
+		"seriesIds",
+		"eventSurface",
+		"filterEventPresets",
+		"scheduleScope",
+		"filterCategoryIds",
+		"filterStaffMemberId",
+		"filterVenueId"
+	]) });
+	eventCalendarSelectionParam = {
+		id: "events.calendarSelectionParam",
+		kind: "formatter",
+		summary: "Resolve selected events instead of discovery filters",
+		schema: selectionParamSchema,
+		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];
+		}
+	};
 	readJobSchema = z.object({ job: z.enum(["list", "calendar"]) });
 	eventCalendarReadProfile = {
 		id: "events.calendarReadProfile",
@@ -44990,6 +45208,7 @@ var init_registry$2 = __esmMin((() => {
 	init_eventCalendar();
 	init_boxStyleClassNames();
 	builtinTransformDefinitions = [
+		eventCalendarSelectionParam,
 		eventCalendarReadEnabled,
 		eventCalendarReadProfile,
 		...formattingTransforms,
@@ -45448,12 +45667,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) {
@@ -45511,6 +45730,14 @@ var init_utils = __esmMin((() => {
 }));
 //#endregion
 //#region ../blocks/src/system/data/prefetchBlockData.ts
+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));
@@ -45539,7 +45766,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 = [];
@@ -45556,6 +45783,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 ?? {},
@@ -45642,8 +45870,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;
@@ -45656,7 +45884,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) {