@riverbankcms/sdk 0.145.0 → 0.147.0

package/dist/server/config-validation.mjs

@@ -18,6 +18,64 @@ function defineEndpointDefinitions(definitions) {
 	return definitions;
 }
 //#endregion
+//#region ../api/src/apiEndpointTypes.ts
+function allowedDemoMutationPolicy() {
+	return {
+		classification: "allowed",
+		publicMessage: ""
+	};
+}
+function blockedDemoMutationPolicy(classification, publicMessage) {
+	if (publicMessage.trim() === "") throw new Error(`Demo mutation policy ${classification} requires publicMessage.`);
+	return {
+		classification,
+		publicMessage
+	};
+}
+//#endregion
+//#region ../api/src/demoMutationPolicies.ts
+const DEMO_MUTATION_BLOCKED_HIDDEN = blockedDemoMutationPolicy("blocked-hidden", "This action is not available in demo sites.");
+const DEMO_MUTATION_BLOCKED_DISABLED = blockedDemoMutationPolicy("blocked-disabled", "This setting is disabled in demo sites.");
+blockedDemoMutationPolicy("internal-only", "This internal operation is not available in demo sites.");
+const DEMO_MUTATION_ALLOWED = allowedDemoMutationPolicy();
+//#endregion
+//#region ../api/src/siteLifecycleEndpoints.ts
+const SITE_LIFECYCLE_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	createSite: {
+		path: "/sites/manage",
+		method: "POST",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json",
+		errors: []
+	},
+	createSiteManual: {
+		path: "/sites/manual",
+		method: "POST",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json",
+		errors: []
+	},
+	updateSite: {
+		path: "/sites/manage",
+		method: "PUT",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json",
+		errors: []
+	},
+	deleteSite: {
+		path: "/sites/{siteId}",
+		method: "DELETE",
+		tags: ["site", "site-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: [],
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	}
+});
+//#endregion
 //#region ../api/src/publicNewsletterEndpointDefinitions.ts
 const PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	subscribeNewsletter: {
@@ -78,27 +136,6 @@ const PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
-//#region ../api/src/apiEndpointTypes.ts
-function allowedDemoMutationPolicy() {
-	return {
-		classification: "allowed",
-		publicMessage: ""
-	};
-}
-function blockedDemoMutationPolicy(classification, publicMessage) {
-	if (publicMessage.trim() === "") throw new Error(`Demo mutation policy ${classification} requires publicMessage.`);
-	return {
-		classification,
-		publicMessage
-	};
-}
-//#endregion
-//#region ../api/src/demoMutationPolicies.ts
-const DEMO_MUTATION_BLOCKED_HIDDEN = blockedDemoMutationPolicy("blocked-hidden", "This action is not available in demo sites.");
-const DEMO_MUTATION_BLOCKED_DISABLED = blockedDemoMutationPolicy("blocked-disabled", "This setting is disabled in demo sites.");
-blockedDemoMutationPolicy("internal-only", "This internal operation is not available in demo sites.");
-const DEMO_MUTATION_ALLOWED = allowedDemoMutationPolicy();
-//#endregion
 //#region ../api/src/cache-tags.ts
 /**
 * Tag templates for endpoint definitions (support `{param}` placeholders).
@@ -958,6 +995,13 @@ const EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS = defineEndpointDefinitions
 		errors: [],
 		responseKind: "blob"
 	},
+	exportEventOfferingRegistrationsCsv: {
+		path: "/sites/{siteId}/bookings/event-offerings/{eventOfferingId}/registrations/export.csv",
+		method: "GET",
+		auth: "user",
+		errors: [],
+		responseKind: "blob"
+	},
 	updateEventSeriesRegistration: {
 		path: "/sites/{siteId}/bookings/event-series/{seriesId}/registrations/{registrationId}",
 		method: "PATCH",
@@ -968,6 +1012,19 @@ const EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS = defineEndpointDefinitions
 			"resource:not_found",
 			"server:internal_error"
 		]
+	},
+	saveEventSeriesRegistrationAnswers: {
+		path: "/sites/{siteId}/bookings/event-series/{seriesId}/registrations/{registrationId}/answers",
+		method: "PUT",
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"auth:forbidden",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
 	}
 });
 //#endregion
@@ -1105,6 +1162,20 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json",
 		errors: ["auth:forbidden", "server:internal_error"]
 	},
+	setMailingListBookingOptIn: {
+		path: "/sites/{siteId}/mailing-list/setup/booking-opt-in",
+		method: "PUT",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_DISABLED,
+		errors: [
+			"auth:forbidden",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	getMailingListAuthoringContext: {
 		path: "/sites/{siteId}/mailing-list/authoring-context",
 		method: "GET",
@@ -1388,6 +1459,30 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json",
 		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
 	},
+	scheduleNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/schedule",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	},
+	unscheduleNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/unschedule",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	},
+	stopNewsletterCampaign: {
+		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/stop",
+		method: "POST",
+		tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteNewsletter],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	},
 	testSendNewsletterCampaign: {
 		path: "/sites/{siteId}/newsletter/campaigns/{campaignId}/test-send",
 		method: "POST",
@@ -1398,6 +1493,154 @@ const NEWSLETTER_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
+//#region ../api/src/sdkEventEndpointDefinitions.ts
+/**
+* The SDK's Event graph: the Events themselves and the occurrences of one run.
+* Extracted from `endpoints.ts` so this family can be read, and added to, on
+* its own. New entries here must declare `errors`; the
+* require-api-endpoint-errors lint enforces that here as in endpoints.ts.
+*/
+const SDK_EVENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	sdkListEvents: {
+		path: "/sdk/{siteId}/events",
+		method: "GET",
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkUpsertEvent: {
+		path: "/sdk/{siteId}/events",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"billing:plan_limit_exceeded",
+			"server:internal_error"
+		]
+	},
+	sdkGetEvent: {
+		path: "/sdk/{siteId}/events/{identifier}",
+		method: "GET",
+		auth: "service",
+		responseKind: "json"
+	},
+	sdkDeleteEvent: {
+		path: "/sdk/{siteId}/events/{identifier}",
+		method: "DELETE",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkTakeEventOffline: {
+		path: "/sdk/{siteId}/events/{identifier}/lifecycle",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkListEventOccurrences: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences",
+		method: "GET",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"server:internal_error"
+		]
+	},
+	sdkAddEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkUpdateEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}",
+		method: "PATCH",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkCancelEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}/cancel",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkDeleteEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}",
+		method: "DELETE",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	}
+});
+//#endregion
+//#region ../api/src/sdkPageDesignEndpointDefinitions.ts
+/**
+* SDK management endpoints for a page's draft design (issue 1497), spread into
+* `ENDPOINT_DEFINITIONS` like the other endpoint-definition modules. New
+* entries here must declare `errors`, which the require-api-endpoint-errors
+* lint enforces.
+*/
+const SDK_PAGE_DESIGN_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	sdkGetPageDesign: {
+		path: "/sdk/{siteId}/pages/{identifier}/design",
+		method: "GET",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"server:internal_error"
+		]
+	},
+	sdkSavePageDesign: {
+		path: "/sdk/{siteId}/pages/{identifier}/design",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	}
+});
+//#endregion
 //#region ../core/src/result.ts
 function ok(value) {
 	return {
@@ -2058,17 +2301,35 @@ function parseMailingListRuntimeContext(value) {
 	if (!isRecord$8(value)) return invalidRuntimeContext();
 	if (value.tag === "not_configured") return ok({ tag: "not_configured" });
 	if (value.tag !== "configured") return invalidRuntimeContext();
+	return parseConfiguredRuntimeContext(value);
+}
+function parseConfiguredRuntimeContext(value) {
 	const revision = parseMailingListSetupRevision(value.revision);
 	const form = parseMailingListGlobalForm(value.form);
 	const provider = parseRuntimeProvider(value.provider);
-	if (revision === null || !form.ok || provider === null) return invalidRuntimeContext();
+	const bookingSignup = parseBookingSignupOffer(value.bookingSignup);
+	if (revision === null || !form.ok || provider === null || bookingSignup === null) return invalidRuntimeContext();
 	return ok({
 		tag: "configured",
 		revision,
+		bookingSignup,
 		form: form.value,
 		provider
 	});
 }
+function parseBookingSignupOffer(value) {
+	if (value === void 0) return {
+		tag: "unavailable",
+		reason: "disabled"
+	};
+	if (!isRecord$8(value)) return null;
+	if (value.tag === "offered") return { tag: "offered" };
+	if (value.tag === "unavailable" && (value.reason === "disabled" || value.reason === "fields" || value.reason === "destination")) return {
+		tag: "unavailable",
+		reason: value.reason
+	};
+	return null;
+}
 function parseRuntimeProvider(value) {
 	if (!isRecord$8(value)) return null;
 	switch (value.provider) {
@@ -2295,15 +2556,6 @@ function parseMailingListContentVersionId(value) {
 	const parsed = parseContentVersionId(value);
 	return parsed.ok ? parsed.value : null;
 }
-function buildMailingListSignupBlockSourceRef(blockId, contentVersionId) {
-	const parsedBlockId = parseMailingListBlockId(blockId);
-	const parsedContentVersionId = parseMailingListContentVersionId(contentVersionId);
-	return parsedBlockId !== null && parsedContentVersionId !== null ? {
-		tag: "block_ref",
-		blockId: parsedBlockId,
-		contentVersionId: parsedContentVersionId
-	} : null;
-}
 //#endregion
 //#region ../core/src/secret.ts
 /**
@@ -2952,6 +3204,45 @@ const SITE_API_KEY_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	}
 });
 //#endregion
+//#region ../api/src/siteManagementEndpointDefinitions.ts
+const SITE_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	createSite: {
+		path: "/sites/manage",
+		method: "POST",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json"
+	},
+	updateSite: {
+		path: "/sites/manage",
+		method: "PUT",
+		tags: ["site"],
+		auth: "user",
+		responseKind: "json"
+	},
+	changeSiteAddress: {
+		path: "/sites/{siteId}/address",
+		method: "PUT",
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_DISABLED
+	},
+	getSiteAddressAvailability: {
+		path: "/sites/{siteId}/address/availability",
+		method: "GET",
+		auth: "user",
+		responseKind: "json"
+	},
+	deleteSite: {
+		path: "/sites/{siteId}",
+		method: "DELETE",
+		tags: ["site", "site-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		demoMutation: DEMO_MUTATION_BLOCKED_HIDDEN
+	}
+});
+//#endregion
 //#region ../api/src/eventManagementEndpointDefinitions.ts
 const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 	listEvents: {
@@ -2999,6 +3290,28 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"server:internal_error"
 		]
 	},
+	/**
+	* The web address of an event's own page. A course page belongs to the
+	* event itself, so its address is written here rather than through a run.
+	*/
+	updateEventAddress: {
+		path: "/sites/{siteId}/bookings/events/{eventId}/address",
+		method: "PATCH",
+		tags: [
+			"site-{siteId}",
+			"event-series-{siteId}",
+			TAG_TEMPLATES.siteRoutableContent,
+			TAG_TEMPLATES.siteRedirects
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	createWholeSeriesRun: {
 		path: "/sites/{siteId}/bookings/events/{eventId}/runs",
 		method: "POST",
@@ -3025,6 +3338,20 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"server:internal_error"
 		]
 	},
+	updateCourseBookingSettings: {
+		path: "/sites/{siteId}/bookings/events/{eventId}/booking-settings",
+		method: "PATCH",
+		tags: ["site-{siteId}", "event-series-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"validation:invalid_input",
+			"auth:forbidden",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	cancelWholeSeriesRun: {
 		path: "/sites/{siteId}/bookings/events/{eventId}/runs/{runId}/cancellation",
 		method: "POST",
@@ -3037,6 +3364,28 @@ const EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 			"resource:conflict",
 			"server:internal_error"
 		]
+	},
+	/**
+	* The Content tab's one write: the short introduction, image and
+	* description of an event's page, published without its layout.
+	*/
+	saveEventPageWords: {
+		path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/words",
+		method: "PUT",
+		tags: [
+			TAG_TEMPLATES.siteCollection,
+			TAG_TEMPLATES.siteRoutableContent,
+			TAG_TEMPLATES.pageSurfaceById
+		],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"auth:forbidden",
+			"validation:invalid_input",
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
 	}
 });
 //#endregion
@@ -3469,19 +3818,105 @@ const BILLING_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
 		responseKind: "json"
 	}
 });
+//#endregion
+//#region ../api/src/bookingPeopleEndpointDefinitions.ts
+/**
+* People endpoints (#1356): the People list, its CSV export, and deleting a
+* person when nothing is attached to them.
+*/
+const BOOKING_PEOPLE_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({
+	listPeople: {
+		path: "/sites/{siteId}/bookings/people",
+		method: "GET",
+		tags: ["site-{siteId}", "customers-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: ["server:internal_error"]
+	},
+	exportPeopleCsv: {
+		path: "/sites/{siteId}/bookings/people/export.csv",
+		method: "GET",
+		tags: ["site-{siteId}", "customers-{siteId}"],
+		auth: "user",
+		errors: [],
+		responseKind: "blob"
+	},
+	checkPersonDeletion: {
+		path: "/sites/{siteId}/bookings/people/{personId}/deletion-check",
+		method: "GET",
+		tags: ["site-{siteId}", "customers-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"auth:forbidden",
+			"resource:not_found",
+			"server:internal_error"
+		]
+	},
+	deletePerson: {
+		path: "/sites/{siteId}/bookings/people/{personId}",
+		method: "DELETE",
+		tags: ["site-{siteId}", "customers-{siteId}"],
+		auth: "user",
+		responseKind: "json",
+		errors: [
+			"auth:forbidden",
+			"resource:not_found",
+			"server:internal_error"
+		]
+	}
+});
+//#endregion
+//#region ../api/src/clientErrorReporting.ts
+const CLIENT_ERROR_REPORT_ENDPOINT_DEFINITIONS = defineEndpointDefinitions({ reportClientError: {
+	path: "/client/error-report",
+	method: "POST",
+	auth: "user",
+	errors: [],
+	responseKind: "json"
+} });
+const CLIENT_ERROR_REPORT_LIMITS = {
+	pathname: 1024,
+	name: 120,
+	message: 2e3,
+	stack: 8e3,
+	digest: 128,
+	componentStack: 8e3,
+	sourceLocation: 1024
+};
+const clientErrorEventSchema = z.enum([
+	"dashboard:route-error",
+	"dashboard:app-error",
+	"client:error-boundary",
+	"client:window-error",
+	"client:unhandled-rejection"
+]);
+z.object({
+	event: clientErrorEventSchema,
+	pathname: z.string().startsWith("/").max(CLIENT_ERROR_REPORT_LIMITS.pathname),
+	name: z.string().max(CLIENT_ERROR_REPORT_LIMITS.name),
+	message: z.string().max(CLIENT_ERROR_REPORT_LIMITS.message),
+	stack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.stack).nullable(),
+	digest: z.string().max(CLIENT_ERROR_REPORT_LIMITS.digest).nullable(),
+	componentStack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.componentStack).nullable(),
+	sourceLocation: z.string().max(CLIENT_ERROR_REPORT_LIMITS.sourceLocation).nullable()
+}).strict();
 ({
+	...SITE_LIFECYCLE_ENDPOINT_DEFINITIONS,
+	...CLIENT_ERROR_REPORT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_NEWSLETTER_ENDPOINT_DEFINITIONS,
 	...ACCOUNT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS,
 	...PUBLIC_EVENT_ENDPOINT_DEFINITIONS,
 	...GIFTING_ENDPOINT_DEFINITIONS,
 	...PUBLIC_READ_ENDPOINT_DEFINITIONS,
-	...BILLING_ENDPOINT_DEFINITIONS
+	...BILLING_ENDPOINT_DEFINITIONS,
+	...SITE_MANAGEMENT_ENDPOINT_DEFINITIONS
 }), TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, { ...SITE_API_KEY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteBookingSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteEmailSettings, {
 	...NEWSLETTER_ENDPOINT_DEFINITIONS,
 	...APPOINTMENT_ENDPOINT_DEFINITIONS,
 	...EVENT_SERIES_REGISTRATION_ENDPOINT_DEFINITIONS
-}, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicBookingServices, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, { ...PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, { ...PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, { ...EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS }, { ...SDK_MEDIA_ENDPOINT_DEFINITIONS }, { ...SDK_ENDPOINT_DEFINITIONS }, { ...SDK_ENTRY_READ_ENDPOINTS };
+}, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteById, TAG_TEMPLATES.siteBySlug, TAG_TEMPLATES.siteByDomain, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.workflowRunById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.routeById, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.site, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.navigationItemById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteNavigation, TAG_TEMPLATES.navigationMenuById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteSettings, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicBookingServices, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.siteTheme, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteCollection, TAG_TEMPLATES.pageSurfaceById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteRedirects, TAG_TEMPLATES.siteRouteOutcomes, TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug, TAG_TEMPLATES.siteForms, { ...PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEventFilters, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicShop, TAG_TEMPLATES.publicCheckout, TAG_TEMPLATES.siteRoutableContent, { ...PUBLIC_EVENT_CHECKOUT_ENDPOINT_DEFINITIONS }, TAG_TEMPLATES.publicEvents, TAG_TEMPLATES.publicEvents, { ...EVENT_MANAGEMENT_ENDPOINT_DEFINITIONS }, { ...BOOKING_PEOPLE_ENDPOINT_DEFINITIONS }, { ...SDK_MEDIA_ENDPOINT_DEFINITIONS }, { ...SDK_ENDPOINT_DEFINITIONS }, { ...SDK_PAGE_DESIGN_ENDPOINT_DEFINITIONS }, { ...SDK_EVENT_ENDPOINT_DEFINITIONS }, { ...SDK_ENTRY_READ_ENDPOINTS };
 z.object({ refreshToken: z.string().min(1).max(4096) }).strict();
 z.object({
 	accessToken: z.string().min(1).max(4096),
@@ -5982,13 +6417,16 @@ const SURFACE_FOREGROUND_CSS_VARS = {
 	text: "--rb-surface-text-color",
 	heading: "--rb-surface-heading-color",
 	link: "--rb-surface-link-color",
+	linkHover: "--rb-surface-link-hover-color",
 	supporting: "--rb-surface-supporting-color"
 };
 const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+const DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
 const DEFAULT_ROLE_FALLBACKS = {
 	text: DEFAULT_SURFACE_TEXT_COLOR,
 	heading: DEFAULT_SURFACE_TEXT_COLOR,
-	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
+	link: DEFAULT_SURFACE_LINK_COLOR,
+	linkHover: DEFAULT_SURFACE_LINK_COLOR,
 	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
 };
 function requireSurfaceColorValue(role, value) {
@@ -5998,10 +6436,12 @@ function requireSurfaceColorValue(role, value) {
 }
 function completeSurfaceForegrounds(input) {
 	const text = requireSurfaceColorValue("text", input.text);
+	const link = input.link === void 0 ? text : requireSurfaceColorValue("link", input.link);
 	return {
 		text,
 		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		link,
+		linkHover: input.linkHover === void 0 ? link : requireSurfaceColorValue("linkHover", input.linkHover),
 		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
 	};
 }
@@ -6009,6 +6449,7 @@ function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FAL
 	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
 	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
 	if (role === "text") return `var(${roleVariable}, ${fallback})`;
+	if (role === "linkHover") return `var(${roleVariable}, ${surfaceForegroundValue("link", fallback)})`;
 	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
 }
 function surfaceForegroundValueWithOpacity(role, opacityPercent) {
@@ -6022,9 +6463,25 @@ function surfaceForegroundStyle(input) {
 		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
 		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
 		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
-		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting
+		[SURFACE_FOREGROUND_CSS_VARS.linkHover]: foregrounds.linkHover,
+		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting,
+		"--rb-surface-link-hover-decoration": hoverDecoration(input)
 	};
 }
+function surfaceForegroundInputFromResolved(foreground, color) {
+	const { roles } = foreground;
+	return {
+		text: color(roles.text),
+		heading: color(roles.heading),
+		link: color(roles.link),
+		linkHover: color(roles.linkHover),
+		supporting: color(roles.supporting),
+		hoverDecoration: foreground.hoverDecoration
+	};
+}
+function hoverDecoration(input) {
+	return input.hoverDecoration ?? "underline";
+}
 //#endregion
 //#region ../theme-core/src/buttons/constants.ts
 /**
@@ -6779,6 +7236,64 @@ function parseAlpha(source) {
 function isRgbChannel(value) {
 	return Number.isFinite(value) && value >= 0 && value <= 255;
 }
+/**
+* Derive the hover foreground that belongs with a resolved resting foreground.
+*
+* A resting foreground is chosen to be legible against a known surface. A hover
+* state derived from it stays within a bounded distance of that colour, so it
+* inherits most of the resting colour's contrast margin instead of asserting
+* an unrelated brand colour that no one checked against the surface.
+*
+* That bounded-distance property is what lets this be used on a transparent
+* overlay header, where the backdrop is only partly knowable: the scrolled
+* state composites a 60% glass tint over arbitrary page content, so no
+* compile-time contrast proof is available there. Staying near a colour that
+* is already trusted in both states is a weaker claim than a contrast proof,
+* and it is one this function can actually keep.
+*
+* Returns `null` when the resting token is not a plain palette token — an
+* already-faded or raw value has no well-defined softening, and the caller
+* should leave hover alone rather than guess.
+*/
+function deriveForegroundHoverToken(restingToken) {
+	const parts = parseColorTokenParts(restingToken);
+	if (parts.kind !== "token") return null;
+	if (parts.opacityPercent !== null) return null;
+	return parseThemeColorToken(`${parts.token}/85`);
+}
+/**
+* Prefer an authored hover that survives every measured backdrop, then a
+* checked softening of the resting colour. A null backdrop set represents a
+* trusted treatment: only an explicit authored hover may change the colour.
+* When neither option works, retain the resting colour and underline it.
+*/
+function planForegroundHover(input) {
+	const { restingToken, candidate, palette, backdrops } = input;
+	if (candidate && candidate !== restingToken) {
+		if (backdrops === null || survivesEveryBackdrop(candidate, palette, backdrops)) return {
+			kind: "candidate",
+			token: candidate,
+			decoration: "initial"
+		};
+	}
+	const softened = deriveForegroundHoverToken(restingToken);
+	if (softened && backdrops && survivesEveryBackdrop(softened, palette, backdrops)) return {
+		kind: "softened",
+		token: softened,
+		decoration: "initial"
+	};
+	return {
+		kind: "resting",
+		token: restingToken,
+		decoration: "underline"
+	};
+}
+function survivesEveryBackdrop(token, palette, backdrops) {
+	return backdrops.length > 0 && backdrops.every((backdrop) => {
+		const foreground = resolveOpaqueSurfaceHex(token, palette, backdrop);
+		return foreground !== null && contrastRatio(foreground, backdrop) >= 4.5;
+	});
+}
 //#endregion
 //#region ../theme-core/src/surfaces/resolveSurfaceForeground.ts
 const FALLBACK_TEXT_TOKENS = [
@@ -6825,12 +7340,16 @@ function resolveSurfaceForeground(background, palette, candidates = {}, options
 }
 function foregroundCandidates(background, overrides) {
 	return {
-		text: overrides.text ?? background?.textColor ?? null,
-		heading: overrides.heading ?? background?.headingColor ?? null,
-		link: overrides.link ?? background?.linkColor ?? null,
-		supporting: overrides.supporting ?? background?.supportingColor ?? null
+		text: candidateOrBackground(overrides.text, background?.textColor),
+		heading: candidateOrBackground(overrides.heading, background?.headingColor),
+		link: candidateOrBackground(overrides.link, background?.linkColor),
+		linkHover: candidateOrBackground(overrides.linkHover),
+		supporting: candidateOrBackground(overrides.supporting, background?.supportingColor)
 	};
 }
+function candidateOrBackground(candidate, backgroundValue) {
+	return candidate ?? backgroundValue ?? null;
+}
 function resolveDeterministicForeground(backgroundReference, candidates, palette, compositeBase) {
 	const backgroundHex = resolveOpaqueSurfaceHex(backgroundReference, palette, compositeBase);
 	if (!backgroundHex) return resolveTrustedTreatmentForeground(candidates, palette);
@@ -6842,29 +7361,51 @@ function resolveDeterministicForeground(backgroundReference, candidates, palette
 		...FALLBACK_TEXT_TOKENS
 	], backgroundHex, palette, derivedOnToken ? [derivedOnToken] : []);
 	if (!text) return { kind: "unknown" };
-	return {
-		kind: "known",
-		roles: {
-			text,
-			heading: safeTokenOr(candidates.heading, text, backgroundHex, palette),
-			link: safeTokenOr(candidates.link, text, backgroundHex, palette),
-			supporting: safeTokenOr(candidates.supporting, text, backgroundHex, palette)
-		}
-	};
+	return knownForeground({
+		text,
+		heading: safeTokenOr(candidates.heading, text, backgroundHex, palette),
+		link: safeTokenOr(candidates.link, text, backgroundHex, palette),
+		supporting: safeTokenOr(candidates.supporting, text, backgroundHex, palette)
+	}, {
+		kind: "measured",
+		backdropHex: backgroundHex
+	}, candidates.linkHover, palette);
 }
 function resolveTrustedTreatmentForeground(candidates, palette) {
 	const text = canonicalToken(candidates.text, palette);
 	if (!text) return { kind: "unknown" };
+	return knownForeground({
+		text,
+		heading: canonicalToken(candidates.heading, palette) ?? text,
+		link: canonicalToken(candidates.link, palette) ?? text,
+		supporting: canonicalToken(candidates.supporting, palette) ?? text
+	}, { kind: "trusted-treatment" }, candidates.linkHover, palette);
+}
+function knownForeground(roles, provenance, hoverCandidate, palette) {
+	const hover = planForegroundHover({
+		restingToken: roles.link,
+		candidate: canonicalHoverToken(hoverCandidate, palette),
+		palette,
+		backdrops: provenance.kind === "measured" ? [provenance.backdropHex] : null
+	});
 	return {
 		kind: "known",
+		provenance,
 		roles: {
-			text,
-			heading: canonicalToken(candidates.heading, palette) ?? text,
-			link: canonicalToken(candidates.link, palette) ?? text,
-			supporting: canonicalToken(candidates.supporting, palette) ?? text
-		}
+			...roles,
+			linkHover: hover.token
+		},
+		hoverDecoration: hover.decoration
 	};
 }
+function canonicalHoverToken(reference, palette) {
+	const token = parseThemeColorToken(reference);
+	if (token) {
+		const parts = parseColorTokenParts(token);
+		if (parts.kind === "token" && resolveConcreteColorHex(parts.token, palette)) return token;
+	}
+	return canonicalToken(reference, palette);
+}
 function safeTokenOr(candidate, fallback, backgroundHex, palette) {
 	return firstSafeToken([candidate], backgroundHex, palette) ?? fallback;
 }
@@ -9804,6 +10345,43 @@ const effectCompositionSchema = z.object({
 	/** Effects applied on focus */
 	focus: z.array(effectApplicationSchema).optional()
 });
+const policiesById = {
+	"darken-background": "other",
+	"lighten-background": "other",
+	"fade-background": "other",
+	"opacity-reduce": "other",
+	"animated-gradient": "other",
+	"background-on-hover": "paired-hover",
+	"background-on-hover-alpha": "paired-hover",
+	"border-glow": "other",
+	"drop-shadow": "other",
+	"inner-shadow": "other",
+	"neumorphic-shadow": "other",
+	"outer-glow": "other",
+	"retro-3d-shadow": "other",
+	"scale-up": "other",
+	"scale-down": "other",
+	lift: "other",
+	"press-down": "other",
+	pop: "other",
+	"aurora-glow": "other",
+	"cosmic-stardust": "other",
+	"gradient-border-fill": "other",
+	"animated-gradient-border-fill": "other",
+	"border-bottom-grow": "other",
+	"gradient-text": "other",
+	"text-color-change": "text-colour",
+	"border-color-change": "other",
+	"sketchy-border": "other",
+	"pulse-animation": "other",
+	"nav-underline": "underline",
+	"nav-frosted-base": "other",
+	"nav-frosted-hover": "other",
+	"nav-frosted-active": "other"
+};
+function navEffectPolicy(effectId) {
+	return policiesById[effectId] ?? null;
+}
 //#endregion
 //#region ../theme-core/src/navigation/types.ts
 /**
@@ -9892,6 +10470,16 @@ const navLinkStyleSchema = z.object({
 	/** Composable effects */
 	effects: effectCompositionSchema.optional()
 });
+function navLinkHoverColorCandidate(style) {
+	const effect = style?.effects?.hover?.find((item) => navEffectPolicy(item.effectId) === "text-colour");
+	return parseThemeColorToken(effect?.options?.hoverColorToken ?? style?.hoverColorToken);
+}
+function navLinkOwnsHoverForeground(style) {
+	return style?.effects?.hover?.some((effect) => navEffectPolicy(effect.effectId) === "paired-hover") ?? false;
+}
+function navLinkOwnsUnderline(style) {
+	return style?.effects?.hover?.some((effect) => navEffectPolicy(effect.effectId) === "underline") ?? false;
+}
 //#endregion
 //#region ../theme-core/src/customCss/validation.ts
 /**
@@ -16080,6 +16668,14 @@ const blockDesignFallback = {
 };
 blockDesignFallback.sectionSurface, blockDesignFallback.contentFrame, blockDesignFallback.sectionHeight, blockDesignFallback.heroLegibility, blockDesignFallback.imageSurfaceTreatment, blockDesignFallback.imageSurfaceMotion, blockDesignFallback.tileTreatment, blockDesignFallback.eventListTreatment, blockDesignFallback.eyebrowTreatment, blockDesignFallback.accordionIconTreatment, blockDesignFallback.composition;
 //#endregion
+//#region ../theme-core/src/header/rootPaint.ts
+/** The nav container takes precedence when a floating header also has one. */
+function headerRootPaint(header) {
+	const navContainerType = header?.navContainer?.type ?? "none";
+	if (navContainerType === "glass" || navContainerType === "pill") return "contained-nav";
+	return header?.variant === "floating" ? "overlay" : "own-surface";
+}
+//#endregion
 //#region ../theme-core/src/site-styles/siteChromeBackgrounds.ts
 const siteChromeBackgroundColorTokens = toSiteChromeBackgroundColorTokens(backgroundAppearanceColorTokenNames);
 const quickSiteChromeBackgroundColorTokens = toSiteChromeBackgroundColorTokens(backgroundAppearanceQuickColorTokenNames);
@@ -16259,6 +16855,259 @@ z.object(headerPreferencesShape).omit({
 	structure: true
 }).strict();
 //#endregion
+//#region ../theme-core/src/navigation/presets.ts
+/**
+* Built-in nav link style presets
+*
+* Each preset uses composable effects to achieve its look.
+*/
+const NAV_LINK_PRESETS = {
+	/**
+	* Minimal - subtle color change on hover
+	*/
+	minimal: {
+		name: "Minimal",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		hoverColorToken: "primary",
+		padding: "none",
+		borderRadius: "none",
+		effects: { hover: [{
+			effectId: "text-color-change",
+			options: { hoverColorToken: "primary" }
+		}] }
+	},
+	/**
+	* Underline - static underline appears on hover
+	*/
+	underline: {
+		name: "Underline",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "none",
+		borderRadius: "none",
+		effects: { hover: [{
+			effectId: "nav-underline",
+			options: { style: "static" }
+		}] }
+	},
+	/**
+	* Underline Grow - animated underline grows from center on hover
+	*/
+	"underline-grow": {
+		name: "Underline Grow",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "none",
+		borderRadius: "none",
+		effects: { hover: [{
+			effectId: "nav-underline",
+			options: { style: "grow" }
+		}] }
+	},
+	/**
+	* Capsule - pill-shaped background on hover
+	*/
+	capsule: {
+		name: "Capsule",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "compact",
+		borderRadius: "full",
+		effects: {
+			hover: [{
+				effectId: "background-on-hover-alpha",
+				options: {
+					colorToken: "primary",
+					opacity: 10
+				}
+			}],
+			active: [{
+				effectId: "background-on-hover-alpha",
+				options: {
+					colorToken: "primary",
+					opacity: 15
+				}
+			}]
+		}
+	},
+	/**
+	* Solid - solid background color on hover
+	*/
+	solid: {
+		name: "Solid",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "compact",
+		borderRadius: "none",
+		effects: {
+			hover: [{
+				effectId: "background-on-hover",
+				options: {
+					colorToken: "primary",
+					textColorToken: "primaryForeground"
+				}
+			}],
+			active: [{
+				effectId: "background-on-hover",
+				options: {
+					colorToken: "primary",
+					textColorToken: "primaryForeground"
+				}
+			}]
+		}
+	},
+	/**
+	* Scale - gentle scale-up on hover
+	*/
+	scale: {
+		name: "Scale",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "none",
+		borderRadius: "none",
+		effects: { hover: [{
+			effectId: "scale-up",
+			options: { scale: 1.05 }
+		}] }
+	},
+	/**
+	* Frosted - semi-transparent glass-like background
+	*/
+	frosted: {
+		name: "Frosted",
+		typography: "body",
+		fontWeight: "medium",
+		textTransform: "none",
+		italic: false,
+		colorToken: "text",
+		padding: "compact",
+		borderRadius: "md",
+		effects: {
+			base: [{ effectId: "nav-frosted-base" }],
+			hover: [{ effectId: "nav-frosted-hover" }],
+			active: [{ effectId: "nav-frosted-active" }]
+		}
+	}
+};
+/**
+* Get a nav link style preset by ID
+*/
+function getNavLinkPreset(presetId) {
+	return NAV_LINK_PRESETS[presetId];
+}
+Object.keys(NAV_LINK_PRESETS);
+//#endregion
+//#region ../theme-core/src/header/legacyNavLinkStyle.ts
+function buildLegacyHeaderNavLinkStyle(header, contrastTreatment, navTextSize) {
+	const navStyle = header.navStyle ?? "minimal";
+	const basePreset = getNavLinkPreset(navStyle);
+	if (!basePreset) return null;
+	const style = {
+		...basePreset,
+		fontWeight: header.navWeight ?? basePreset.fontWeight,
+		colorToken: (header.navColor ?? header.textColor)?.trim() || basePreset.colorToken,
+		...contrastTreatment ? { contrastTreatment } : {},
+		...navTextSize ? { textSize: navTextSize } : {}
+	};
+	if (header.navWeight === "bold" && navStyle === "solid") style.textTransform = "uppercase";
+	applyLegacyGlassTreatment(style, header, navStyle);
+	return style;
+}
+function applyLegacyGlassTreatment(style, header, navStyle) {
+	if (header.navContainer?.type !== "glass" || navStyle !== "minimal") return;
+	style.borderRadius = "full";
+	style.effects = {
+		...style.effects,
+		hover: glassStateEffects(10),
+		active: glassStateEffects(18)
+	};
+}
+function glassStateEffects(opacity) {
+	return [{
+		effectId: "background-on-hover-alpha",
+		options: {
+			colorToken: "neutral-50",
+			opacity
+		}
+	}, {
+		effectId: "text-color-change",
+		options: { hoverColorToken: "neutral-50" }
+	}];
+}
+//#endregion
+//#region ../theme-core/src/header/openingForegroundProjection.ts
+function readOpeningForegroundProjection(header) {
+	return header?.__runtimeOpeningForeground ?? null;
+}
+//#endregion
+//#region ../theme-core/src/header/effectiveNavLinkStyle.ts
+function effectiveHeaderNavLinkStyle(header, contrastTreatment = null, navTextSize = null) {
+	if (!header) return null;
+	if (!header.navLinkStyle) return buildLegacyHeaderNavLinkStyle(header, contrastTreatment, navTextSize);
+	return {
+		...header.navLinkStyle,
+		...contrastTreatment ? { contrastTreatment } : {},
+		...navTextSize ? { textSize: navTextSize } : {}
+	};
+}
+function headerForegroundCandidates(header) {
+	if (!header) return {};
+	const style = effectiveHeaderNavLinkStyle(header);
+	return {
+		text: header.textColor ?? header.background?.textColor,
+		link: style?.colorToken ?? header.navColor ?? header.textColor,
+		linkHover: navLinkHoverColorCandidate(style)
+	};
+}
+function headerLeafTextColor(header) {
+	if (!header) return "text";
+	return header.textColor ?? header.navColor ?? header.background?.textColor ?? header.navLinkStyle?.colorToken ?? "text";
+}
+/** Transparent chrome must reset the whole contract on its own root. */
+function transparentHeaderForegroundInput(header, palette) {
+	const projection = readOpeningForegroundProjection(header);
+	if (projection?.kind === "known") return surfaceForegroundInputFromResolved(projection, rgbColorValue);
+	return authoredTransparentHeaderForegroundInput(header, palette);
+}
+function authoredTransparentHeaderForegroundInput(header, palette) {
+	const text = headerLeafTextColor(header);
+	const style = effectiveHeaderNavLinkStyle(header);
+	const link = style?.colorToken ?? text;
+	const restingToken = parseThemeColorToken(link) ?? parseThemeColorToken("text");
+	if (!restingToken) throw new Error("Built-in text colour token is invalid");
+	const hover = planForegroundHover({
+		restingToken,
+		candidate: navLinkOwnsHoverForeground(style) ? null : navLinkHoverColorCandidate(style),
+		palette,
+		backdrops: null
+	});
+	return {
+		text: rgbColorValue(text),
+		link: rgbColorValue(link),
+		linkHover: rgbColorValue(hover.token),
+		hoverDecoration: navLinkOwnsUnderline(style) ? "initial" : hover.decoration
+	};
+}
+//#endregion
 //#region ../theme-core/src/site-styles/pageDesignAuthority.ts
 const nonEmptyStringSchema = z.string().min(1);
 const blockContentVersionIdSchema = nonEmptyStringSchema.transform(asBlockContentVersionId);
@@ -16411,6 +17260,28 @@ z.object({
 	motion: z.enum(themeTokenRecipeOptions.motion)
 });
 //#endregion
+//#region ../theme-core/src/footer/effectiveNavLinkStyle.ts
+function effectiveFooterNavLinkStyle(footer) {
+	if (!footer) return null;
+	if (footer.navLinkStyle) return footer.navLinkStyle;
+	const basePreset = getNavLinkPreset(footer.navStyle ?? "minimal");
+	if (!basePreset) return null;
+	return {
+		...basePreset,
+		fontWeight: footer.navWeight ?? basePreset.fontWeight,
+		colorToken: footer.navColor?.trim() || basePreset.colorToken
+	};
+}
+function footerForegroundCandidates(footer, proseHoverCandidate) {
+	if (!footer) return {};
+	const style = effectiveFooterNavLinkStyle(footer);
+	return {
+		text: footer.background?.textColor,
+		link: style?.colorToken ?? footer.navColor ?? footer.background?.textColor,
+		linkHover: navLinkOwnsHoverForeground(style) ? proseHoverCandidate : navLinkHoverColorCandidate(style)
+	};
+}
+//#endregion
 //#region ../theme-core/src/siteChromeOverlayClearance.ts
 const SITE_CHROME_VISIBLE_HEADER_ATTR = "data-site-chrome-visible-header";
 //#endregion
@@ -19384,33 +20255,28 @@ function resolveBackgroundColorValue(value, context) {
 //#endregion
 //#region ../blocks/src/system/transforms/registry/_utils/surfaceForegroundStyles.ts
 const contextualButtonStylesCache = /* @__PURE__ */ new WeakMap();
-function resolveHeaderLeafTextColor(header) {
-	return header?.textColor ?? header?.navColor ?? header?.background?.textColor ?? header?.navLinkStyle?.colorToken ?? "text";
-}
 function resolveHeaderRootForeground(header, palette, isTransparent) {
-	if (isTransparent) return { kind: "unknown" };
+	if (isTransparent) return readOpeningForegroundProjection(header) ?? { kind: "unknown" };
 	const background = header?.background;
 	return resolveSurfaceForeground(background ?? {
 		type: "color",
 		color: "surface"
-	}, palette, {
-		text: header?.textColor ?? background?.textColor,
-		link: header?.navLinkStyle?.colorToken ?? header?.navColor ?? header?.textColor
-	});
+	}, palette, headerForegroundCandidates(header));
+}
+function resolveFooterRootForeground(footer, palette, proseHoverCandidate) {
+	return resolveSurfaceForeground(footer?.background ?? {
+		type: "color",
+		color: "surface"
+	}, palette, footerForegroundCandidates(footer, proseHoverCandidate), { compositeBase: "background" });
 }
 function resolveSurfaceForegroundStyles(value, context, options) {
 	const input = parseBackgroundContent(value);
-	const foreground = input ? resolveSurfaceForeground(input, context.theme.palette, {}, { compositeBase: options?.fallbackToken }) : { kind: "unknown" };
+	const foreground = input ? resolveSurfaceForeground(input, context.theme.palette, { linkHover: context.proseHoverCandidate }, { compositeBase: options?.fallbackToken }) : { kind: "unknown" };
 	const buttonStyles = resolveContextualButtonStyles(input, foreground, context, options);
 	if (foreground.kind === "unknown") return buttonStyles;
 	return {
 		...buttonStyles,
-		...surfaceForegroundStyle({
-			text: resolveBackgroundColorValue(foreground.roles.text, context),
-			heading: resolveBackgroundColorValue(foreground.roles.heading, context),
-			link: resolveBackgroundColorValue(foreground.roles.link, context),
-			supporting: resolveBackgroundColorValue(foreground.roles.supporting, context)
-		})
+		...surfaceForegroundStyle(surfaceForegroundInputFromResolved(foreground, (token) => resolveBackgroundColorValue(token, context)))
 	};
 }
 function resolveContextualButtonStyles(background, foreground, context, options) {
@@ -25226,10 +26092,7 @@ function resolveBackgroundVisualStyles(backgroundColor, defaultToken = "surface"
 	};
 }
 function resolveHeaderVisualStyles(header) {
-	const navContainerType = header?.navContainer?.type ?? "none";
-	const hasContainedNav = navContainerType === "glass" || navContainerType === "pill";
-	const hasOverlayVariant = header?.variant === "floating";
-	if (hasContainedNav || hasOverlayVariant) return {
+	if (headerRootPaint(header) !== "own-surface") return {
 		backgroundToken: "transparent",
 		isTransparent: true
 	};
@@ -25240,23 +26103,7 @@ function resolveHeaderVisualStyles(header) {
 }
 function resolvedForegroundStyle(foreground) {
 	if (foreground.kind === "unknown") return void 0;
-	const { roles } = foreground;
-	return surfaceForegroundStyle({
-		text: rgbColorValue(roles.text),
-		heading: rgbColorValue(roles.heading),
-		link: rgbColorValue(roles.link),
-		supporting: rgbColorValue(roles.supporting)
-	});
-}
-function resolveFooterRootForeground(footer, palette) {
-	const background = footer?.background;
-	return resolveSurfaceForeground(background ?? {
-		type: "color",
-		color: "surface"
-	}, palette, {
-		text: background?.textColor,
-		link: footer?.navLinkStyle?.colorToken ?? footer?.navColor ?? background?.textColor
-	});
+	return surfaceForegroundStyle(surfaceForegroundInputFromResolved(foreground, rgbColorValue));
 }
 function footerBottomBarBorderWidthStyle(width) {
 	if (!width) return void 0;
@@ -25283,8 +26130,7 @@ const headerRootClassTransform = {
 		const placement = planSiteChromePlacement(parseHeaderPositioning(content.positioning));
 		const header = asPartialObject(value);
 		const visuals = resolveHeaderVisualStyles(header);
-		const navContainerType = header?.navContainer?.type ?? "none";
-		const hasContainedNav = navContainerType === "glass" || navContainerType === "pill";
+		const hasContainedNav = headerRootPaint(header) === "contained-nav";
 		const backgroundClass = visuals.isTransparent || hasContainedNav ? "rb-bg-transparent" : null;
 		const classes = [config.base, backgroundClass];
 		if (!hasContainedNav) {
@@ -25327,7 +26173,7 @@ const headerRootStyleTransform = {
 	run: (value, _options, context) => {
 		const header = asPartialObject(value);
 		const visuals = resolveHeaderVisualStyles(header);
-		return mergeStyles(resolvedForegroundStyle(resolveHeaderRootForeground(header, context.theme.palette, visuals.isTransparent)) ?? { color: rgbColorValue(resolveHeaderLeafTextColor(header)) }, borderColorStyle(header?.border?.colorToken ?? "border"));
+		return mergeStyles(resolvedForegroundStyle(resolveHeaderRootForeground(header, context.theme.palette, visuals.isTransparent)) ?? (visuals.isTransparent ? surfaceForegroundStyle(transparentHeaderForegroundInput(header, context.theme.palette)) : { color: rgbColorValue(headerLeafTextColor(header)) }), borderColorStyle(header?.border?.colorToken ?? "border"));
 	}
 };
 const headerSectionBackgroundTransform = {
@@ -25335,9 +26181,7 @@ const headerSectionBackgroundTransform = {
 	kind: "string",
 	summary: "Resolve the inner site-header section background token",
 	run: (value) => {
-		const header = asPartialObject(value);
-		const navContainerType = header?.navContainer?.type ?? "none";
-		return header?.variant === "floating" || navContainerType === "glass" || navContainerType === "pill" ? "raw:transparent" : "background";
+		return headerRootPaint(asPartialObject(value)) !== "own-surface" ? "raw:transparent" : "background";
 	}
 };
 const footerRootStyleTransform = {
@@ -25355,7 +26199,7 @@ const footerRootStyleTransform = {
 				styleParts.push(backgroundColorStyle(token));
 			}
 		}
-		styleParts.push(resolvedForegroundStyle(resolveFooterRootForeground(footer, context.theme.palette)));
+		styleParts.push(resolvedForegroundStyle(resolveFooterRootForeground(footer, context.theme.palette, context.proseHoverCandidate)));
 		styleParts.push(borderColorStyle("border"));
 		return mergeStyles(...styleParts);
 	}
@@ -25417,22 +26261,28 @@ const footerBottomBarStyleTransform = {
 	run: (value, _options, context) => {
 		const footer = asPartialObject(value);
 		const bottomBar = footer?.bottomBar;
-		const styleParts = [];
-		const background = bottomBar?.background;
-		if (background?.type === "color") styleParts.push(backgroundColorStyle(background.color ?? "surface"));
-		styleParts.push(borderColorStyle(bottomBar?.borderTop?.colorToken ?? "border"), footerBottomBarBorderWidthStyle(bottomBar?.borderTop?.width));
-		const foreground = resolveSurfaceForeground(background?.type === "color" ? background : {
-			type: "color",
-			color: "transparent"
-		}, context.theme.palette, {
-			text: bottomBar?.textColor,
-			link: footer?.bottomTextLinkStyle?.colorToken ?? bottomBar?.textColor
-		});
-		if (background?.type === "color") styleParts.push(resolvedForegroundStyle(foreground));
-		else if (bottomBar?.textColor) styleParts.push(textColorStyle(bottomBar.textColor));
-		return mergeStyles(...styleParts);
+		return mergeStyles(bottomBar?.background?.type === "color" ? backgroundColorStyle(bottomBar.background.color ?? "surface") : void 0, borderColorStyle(bottomBar?.borderTop?.colorToken ?? "border"), footerBottomBarBorderWidthStyle(bottomBar?.borderTop?.width), footerBottomBarForegroundStyle(footer, context.theme.palette));
 	}
 };
+function footerBottomBarForegroundStyle(footer, palette) {
+	if (!footer?.bottomBar) return void 0;
+	const bar = footer.bottomBar;
+	if (bar.background?.type !== "color") return backgroundlessBottomBarForegroundStyle(footer);
+	return resolvedForegroundStyle(resolveSurfaceForeground(bar.background, palette, {
+		text: bar.textColor,
+		link: footer.bottomTextLinkStyle?.colorToken ?? bar.textColor,
+		linkHover: footer.bottomTextLinkStyle?.hoverColorToken
+	}, { compositeBase: measuredFooterBackdrop(footer, palette) }));
+}
+function backgroundlessBottomBarForegroundStyle(footer) {
+	if (footer.background?.contentOwner === "site-chrome-editor") return;
+	const textColor = footer.bottomBar?.textColor;
+	return textColor ? textColorStyle(textColor) : void 0;
+}
+function measuredFooterBackdrop(footer, palette) {
+	const foreground = resolveFooterRootForeground(footer, palette);
+	return foreground.kind === "known" && foreground.provenance.kind === "measured" ? foreground.provenance.backdropHex : null;
+}
 const footerSplitMainClassTransform = {
 	id: "layout.footerSplitMainClass",
 	kind: "string",
@@ -25528,7 +26378,7 @@ function chromeSurfaceTextToken(surface, theme, palette) {
 		case "header-root": {
 			const header = theme.header;
 			const foreground = resolveHeaderRootForeground(header, palette, resolveHeaderVisualStyles(header).isTransparent);
-			return foreground.kind === "known" ? foreground.roles.text : resolveHeaderLeafTextColor(header);
+			return foreground.kind === "known" ? foreground.roles.text : headerLeafTextColor(header);
 		}
 		case "header-mobile-panel": return theme.header?.dropdownStyle?.textColor ?? "text";
 		case "footer-root": {
@@ -26112,13 +26962,13 @@ const hours = stack({
 	as: "p",
 	className: "rb-caption rb-opacity-70"
 }, bind("module.timeZone"), when("module.timeZone"))], when("module.kind", { equals: "opening-hours" }));
-const socials = inline({ className: "rb-flex rb-flex-wrap rb-gap-x-5 rb-gap-y-3" }, [link({
+const socials = inline({ className: "rb-footer-socials" }, [link({
 	href: { $bind: { from: "social.href" } },
 	target: "_blank",
 	rel: "noreferrer noopener",
 	"aria-label": { $bind: { from: "social.label" } },
-	className: "rb-nav-text transition-theme-standard"
-}, [icon({ className: "rb-h-5 rb-w-5" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
+	className: "rb-footer-social-link rb-nav-text transition-theme-standard"
+}, [icon({ className: "rb-footer-social-icon" }, bind("social.icon"), when("social.icon")), text({ as: "span" }, bind("social.label"), when("social.icon", { equals: null }))], repeat("module.socialLinks", "social"))], when("module.kind", { equals: "social-links" }));
 const authoredCopy = richText({
 	className: "rb-prose rb-prose-sm rb-max-w-none",
 	style: textColorStyle("text/80")
@@ -27615,7 +28465,9 @@ const bookingWizard = bookingForm(withApiBindings({
 	} },
 	formId: { $bind: { from: "content.formId" } },
 	form: { $bind: { from: "data.form" } },
-	services: { $bind: { from: "data.services" } }
+	services: { $bind: { from: "data.services" } },
+	mailingList: { $bind: { from: "$root.mailingList" } },
+	siteName: { $bind: { from: "$root.siteName" } }
 }));
 /** Both variants sit in the same section shell; only the inner layout differs. */
 function bookingSection(children) {
@@ -28203,6 +29055,7 @@ const publicEventLoaderQuerySchemaShape = {
 	seriesSlug: z.string().optional(),
 	includeOccurrenceId: z.string().optional(),
 	readIntent: z.string().optional(),
+	detailAdmission: z.string().optional(),
 	detailLevel: z.string().optional(),
 	readProfile: z.string().optional()
 };
@@ -28369,11 +29222,11 @@ const publicEventBookingAvailabilitySchema = z.discriminatedUnion("kind", [z.obj
 		"series_archived",
 		"parent_archived",
 		"parent_inconsistent",
-		"not_public",
 		"already_started",
 		"enrollment_closed"
 	])
 })]);
+const publicEventBookingClosedDetailSchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("opensSoon") }), z.object({ kind: z.literal("paused") })]);
 const publicRunSessionSchema = z.object({
 	occurrenceId: z.string(),
 	startsAt: z.string(),
@@ -28418,6 +29271,7 @@ const publicEventBaseSchema = z.object({
 	destination: publicEventDestinationSchema,
 	requiresRegistration: z.boolean(),
 	bookingAvailability: publicEventBookingAvailabilitySchema,
+	bookingClosedDetail: publicEventBookingClosedDetailSchema.optional(),
 	deliveryMode: z.enum([
 		"in_person",
 		"online",
@@ -29115,7 +29969,13 @@ const eventRegistrationHydrationSchemaShape = {
 	spamProtectionEnabled: z.boolean().optional(),
 	supportEmail: z.string().optional(),
 	sitePasses: publicPassProductCollectionSchema.nullable().optional(),
-	siteMemberships: publicMembershipProductCollectionSchema.nullable().optional()
+	siteMemberships: publicMembershipProductCollectionSchema.nullable().optional(),
+	mailingList: z.unknown().transform((value) => {
+		if (value === void 0) return void 0;
+		const parsed = parseMailingListRuntimeContext(value);
+		return parsed.ok ? parsed.value : void 0;
+	}),
+	siteName: z.string().optional()
 };
 const eventRegistrationEventSourceSchema = z.discriminatedUnion("kind", [z.object({
 	kind: z.literal("loaded"),
@@ -29287,7 +30147,9 @@ const eventRegistrationBlockRuntime = defineClientOwnedBlockRuntime({
 				spamProtectionEnabled: source.spamProtectionEnabled,
 				supportEmail: source.supportEmail,
 				sitePasses: source.sitePasses ?? null,
-				siteMemberships: source.siteMemberships ?? null
+				siteMemberships: source.siteMemberships ?? null,
+				mailingList: source.mailingList,
+				siteName: source.siteName
 			}
 		};
 	}
@@ -29455,6 +30317,8 @@ const eventRegistrationBlockDefinition = {
 					events: { $bind: { from: "data.events" } },
 					wholeSeriesRunEvents: { $bind: { from: "data.wholeSeriesRunEvents" } },
 					loaderFailures: { $bind: { from: "$root.loaderFailures" } },
+					mailingList: { $bind: { from: "$root.mailingList" } },
+					siteName: { $bind: { from: "$root.siteName" } },
 					sitePasses: { $bind: { from: "data.sitePasses" } },
 					siteMemberships: { $bind: { from: "data.siteMemberships" } },
 					stage: { $bind: {
@@ -36081,6 +36945,11 @@ const mailingListContentVersionIdSchema = z.string().transform((value, ctx) => {
 	});
 	return z.NEVER;
 });
+const mailingListSignupBlockSourceRefSchema = z.object({
+	tag: z.literal("block_ref"),
+	blockId: mailingListSignupBlockIdSchema,
+	contentVersionId: mailingListContentVersionIdSchema
+});
 const signedMailingListSourceTokenSchema = z.string().trim().min(1).transform(parseRequiredMailingListSignedSourceToken);
 const newsletterSourceCommonSchema = z.object({
 	siteId: z.string().optional(),
@@ -36095,7 +36964,15 @@ const newsletterSourceSchema = z.discriminatedUnion("source", [
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("block"),
 		blockId: z.string().nullable().optional(),
-		contentVersionId: z.string().nullable().optional()
+		newsletterBlockSubmission: z.discriminatedUnion("tag", [
+			z.object({
+				tag: z.literal("ready"),
+				sourceRef: mailingListSignupBlockSourceRefSchema
+			}),
+			z.object({ tag: z.literal("unpublished-form") }),
+			z.object({ tag: z.literal("unpublished-settings") }),
+			z.object({ tag: z.literal("unavailable") })
+		])
 	}),
 	newsletterSourceCommonSchema.extend({
 		source: z.literal("signed-footer"),
@@ -36124,11 +37001,7 @@ const newsletterHydrationSchema = z.object({
 	target: z.discriminatedUnion("tag", [
 		z.object({
 			tag: z.literal("block-source"),
-			sourceRef: z.object({
-				tag: z.literal("block_ref"),
-				blockId: mailingListSignupBlockIdSchema,
-				contentVersionId: mailingListContentVersionIdSchema
-			}).nullable()
+			sourceRef: mailingListSignupBlockSourceRefSchema.nullable()
 		}),
 		z.object({
 			tag: z.literal("signed-footer-source"),
@@ -36137,7 +37010,11 @@ const newsletterHydrationSchema = z.object({
 				token: signedMailingListSourceTokenSchema
 			})
 		}),
-		z.object({ tag: z.literal("preview") })
+		z.object({ tag: z.literal("preview") }),
+		z.object({
+			tag: z.literal("unpublished-preview"),
+			reason: z.enum(["unpublished-form", "unpublished-settings"])
+		})
 	]),
 	setupRevision: z.number().int().positive().nullable(),
 	choiceProvider: z.enum([
@@ -36206,16 +37083,21 @@ const newsletterFormBlockRuntime = defineProgressiveBlockRuntime({
 });
 function projectNewsletterFormHydrationTarget(source) {
 	switch (source.source) {
-		case "block": {
-			const sourceRef = buildMailingListSignupBlockSourceRef(source.blockId, source.contentVersionId);
-			if (sourceRef?.tag === "block_ref") return {
+		case "block": switch (source.newsletterBlockSubmission.tag) {
+			case "unpublished-form":
+			case "unpublished-settings": return {
+				tag: "unpublished-preview",
+				reason: source.newsletterBlockSubmission.tag
+			};
+			case "ready": return {
 				tag: "block-source",
-				sourceRef
+				sourceRef: source.newsletterBlockSubmission.sourceRef
 			};
-			return {
+			case "unavailable": return {
 				tag: "block-source",
 				sourceRef: null
 			};
+			default: return assertNever$2(source.newsletterBlockSubmission);
 		}
 		case "signed-footer": return {
 			tag: "signed-footer-source",
@@ -36320,65 +37202,67 @@ const editorialSplitLayout = styledSection({
 	spacing: "comfortable",
 	background: "surface"
 });
-const newsletterSignupBlockDefinition = {
-	manifest: createBlockManifest({
-		id: "block.newsletter-signup",
-		title: "Newsletter Signup",
-		titleSource: "title",
-		description: "Newsletter subscription form with configurable field presets.",
-		category: "interactive",
-		contentSource: { kind: "inline" },
-		fragments: [{
-			fragment: newsletterCopyFragment,
-			fieldPriority: 0
-		}, {
-			fragment: newsletterFormFragment,
-			fieldPriority: 1
-		}],
-		layout: stackedLayout,
-		variants: {
-			stacked: stackedLayout,
-			inline: inlineLayout,
-			"editorial-split": editorialSplitLayout
-		},
-		defaultVariant: "stacked",
-		variantOptions: {
-			stacked: {
-				label: "Stacked",
-				description: "Vertical layout with fields stacked"
-			},
-			inline: {
-				label: "Inline",
-				description: "Horizontal layout (email + button side by side)"
-			},
-			"editorial-split": {
-				label: "Editorial split",
-				description: "Copy and form in balanced side-by-side columns, stacked on mobile."
-			}
-		},
-		styleTokens: {
-			background: "surface",
-			typography: "body",
-			spacing: "md"
+const newsletterSignupManifest = createBlockManifest({
+	id: "block.newsletter-signup",
+	title: "Newsletter Signup",
+	titleSource: "title",
+	description: "Newsletter subscription form with configurable field presets.",
+	category: "interactive",
+	contentSource: { kind: "inline" },
+	fragments: [{
+		fragment: newsletterCopyFragment,
+		fieldPriority: 0
+	}, {
+		fragment: newsletterFormFragment,
+		fieldPriority: 1
+	}],
+	layout: stackedLayout,
+	variants: {
+		stacked: stackedLayout,
+		inline: inlineLayout,
+		"editorial-split": editorialSplitLayout
+	},
+	defaultVariant: "stacked",
+	variantOptions: {
+		stacked: {
+			label: "Stacked",
+			description: "Vertical layout with fields stacked"
 		},
-		behaviours: {
-			supportsThemeSwitching: true,
-			inlineEditing: false,
-			animation: false,
-			paletteHidden: false
+		inline: {
+			label: "Inline",
+			description: "Horizontal layout (email + button side by side)"
 		},
-		tags: [
-			"newsletter",
-			"signup",
-			"email",
-			"subscribe",
-			"subscription",
-			"mailchimp",
-			"marketing",
-			"lead-capture"
-		],
-		icon: "Mail"
-	}),
+		"editorial-split": {
+			label: "Editorial split",
+			description: "Copy and form in balanced side-by-side columns, stacked on mobile."
+		}
+	},
+	styleTokens: {
+		background: "surface",
+		typography: "body",
+		spacing: "md"
+	},
+	behaviours: {
+		supportsThemeSwitching: true,
+		inlineEditing: false,
+		animation: false,
+		paletteHidden: false
+	},
+	tags: [
+		"newsletter",
+		"signup",
+		"email",
+		"subscribe",
+		"subscription",
+		"mailchimp",
+		"marketing",
+		"lead-capture"
+	],
+	icon: "Mail"
+});
+[...(newsletterSignupManifest.fields ?? []).map((field) => field.id)];
+const newsletterSignupBlockDefinition = {
+	manifest: newsletterSignupManifest,
 	runtime: newsletterFormBlockRuntime
 };
 //#endregion
@@ -38420,7 +39304,8 @@ const BOOKING_FORM_DATA_RESERVED_KEYS = /* @__PURE__ */ new Set([
 	"discountCode",
 	"selectedSlidingAmountInput",
 	"selectedCollectionOptionKind",
-	"selectedAppointmentPackageId"
+	"selectedAppointmentPackageId",
+	"mailingListOptIn"
 ]);
 function isBookingFormDataReservedKey(value) {
 	return BOOKING_FORM_DATA_RESERVED_KEYS.has(value);
@@ -38768,6 +39653,46 @@ z.object({ acceptExtraSiteCharge: z.boolean().optional() });
 //#region ../surfaces/src/index.ts
 const SURFACE_IDS = ["core", "macadamia"];
 const DEFAULT_SURFACE_ID = "core";
+/**
+* Root hosts for each surface, keyed by deployment tier. The tier-keyed shape
+* makes it impossible to mis-order entries: callers like
+* `buildSurfaceAwareDashboardOriginForSurfaceId` look up by tier directly
+* rather than relying on positional alignment between arrays.
+*/
+const SURFACE_ROOT_HOSTS = {
+	core: {
+		local: "localhost",
+		prod: "riverbankcms.com"
+	},
+	macadamia: {
+		local: "macadamia.localhost",
+		prod: "macadamia.studio"
+	}
+};
+const SURFACE_SITE_ROOT_HOSTS = {
+	core: {
+		local: "localhost",
+		prod: "riverbanksites.com"
+	},
+	macadamia: {
+		local: "macadamia.localhost",
+		prod: "macadamia.studio"
+	}
+};
+const SURFACE_SITE_ROOT_HOST_ALIASES = { core: { prod: ["preview.riverbanksites.com"] } };
+function surfaceHostTableValues(table) {
+	return Object.values(table).flatMap((byTier) => Object.values(byTier).flat());
+}
+function siteSlugLabelUnderRoot(host, siteRootHost) {
+	if (!host.endsWith(`.${siteRootHost}`)) return [];
+	return host.slice(0, host.length - siteRootHost.length - 1).split(".").slice(-1);
+}
+function deriveSurfaceOwnedSiteSlugs() {
+	const siteRootHosts = [...surfaceHostTableValues(SURFACE_SITE_ROOT_HOSTS), ...surfaceHostTableValues(SURFACE_SITE_ROOT_HOST_ALIASES)];
+	const labels = [...surfaceHostTableValues(SURFACE_ROOT_HOSTS), ...siteRootHosts].flatMap((host) => siteRootHosts.flatMap((root) => siteSlugLabelUnderRoot(host, root)));
+	return [...new Set(labels)].sort();
+}
+deriveSurfaceOwnedSiteSlugs();
 [...SURFACE_IDS.filter((surfaceId) => surfaceId !== DEFAULT_SURFACE_ID)];
 //#endregion
 //#region ../api/src/accountApi.ts
@@ -39369,6 +40294,7 @@ function collectText(node) {
 	if (node.type === "text") return node.text ?? "";
 	return (node.content ?? []).map(collectText).join("");
 }
+z.enum(["public", "unlisted"], { error: "visibility must be 'public' or 'unlisted'" });
 //#endregion
 //#region ../api/src/bookingPaymentTermSchemas.ts
 const bookingDepositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);