@riverbankcms/sdk 0.143.0 → 0.144.0

package/dist/server/server.mjs

@@ -9539,7 +9539,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.143.0";
+const SDK_VERSION = "0.144.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;
@@ -10606,6 +10606,8 @@ const buttonSystemSchema = z.strictObject({
 //#endregion
 //#region ../theme-core/src/palette/utils/colorConversion.ts
 const clamp01 = (x) => Math.max(0, Math.min(1, x));
+const mod = (a, n) => (a % n + n) % n;
+const deg = (x) => mod(x, 360);
 function hexToRgb(hex) {
 	const h = hex.replace(/^#/, "");
 	const m = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
@@ -10628,6 +10630,45 @@ function srgbToLinear(u) {
 function linearToSrgb(x) {
 	return clamp01(x <= .0031308 ? 12.92 * x : 1.055 * Math.pow(x, 1 / 2.4) - .055) * 255;
 }
+function rgbToHsl(r, g, b) {
+	const R = r / 255, G = g / 255, B = b / 255;
+	const max = Math.max(R, G, B), min = Math.min(R, G, B);
+	const d = max - min;
+	let h = 0;
+	if (d !== 0) {
+		switch (max) {
+			case R:
+				h = (G - B) / d + (G < B ? 6 : 0);
+				break;
+			case G:
+				h = (B - R) / d + 2;
+				break;
+			case B:
+				h = (R - G) / d + 4;
+				break;
+		}
+		h *= 60;
+	}
+	const l = (max + min) / 2;
+	const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));
+	return {
+		h,
+		s,
+		l
+	};
+}
+function srgbToOklab(r, g, b) {
+	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
+	const l = .4122214708 * R + .5363325363 * G + .0514459929 * B;
+	const m = .2119034982 * R + .6806995451 * G + .1073969566 * B;
+	const s = .0883024619 * R + .2817188376 * G + .6299787005 * B;
+	const l_ = Math.cbrt(l), m_ = Math.cbrt(m), s_ = Math.cbrt(s);
+	return {
+		L: .2104542553 * l_ + .793617785 * m_ - .0040720468 * s_,
+		a: 1.9779984951 * l_ - 2.428592205 * m_ + .4505937099 * s_,
+		b: .0259040371 * l_ + .7827717662 * m_ - .808675766 * s_
+	};
+}
 function oklabToSrgb(L, a, b) {
 	const l_ = Math.pow(L + .3963377774 * a + .2158037573 * b, 3);
 	const m_ = Math.pow(L - .1055613458 * a - .0638541728 * b, 3);
@@ -10641,6 +10682,14 @@ function oklabToSrgb(L, a, b) {
 		b: linearToSrgb(B)
 	};
 }
+function oklabToOklch(L, a, b) {
+	const C = Math.sqrt(a * a + b * b);
+	return {
+		L,
+		C,
+		h: C < 1e-7 ? 0 : deg(Math.atan2(b, a) * 180 / Math.PI)
+	};
+}
 function oklchToOklab(L, C, h) {
 	const hr = h * Math.PI / 180;
 	return {
@@ -10649,6 +10698,27 @@ function oklchToOklab(L, C, h) {
 		b: C * Math.sin(hr)
 	};
 }
+function featuresFromHex(hex) {
+	const { r, g, b } = hexToRgb(hex);
+	const { h, s, l } = rgbToHsl(r, g, b);
+	const { L, a, b: b2 } = srgbToOklab(r, g, b);
+	const { L: okL, C: okC, h: okH } = oklabToOklch(L, a, b2);
+	return {
+		r,
+		g,
+		b,
+		h,
+		s,
+		l,
+		v: Math.max(r, g, b) / 255,
+		Y: .2126 * srgbToLinear(r) + .7152 * srgbToLinear(g) + .0722 * srgbToLinear(b),
+		chroma: s,
+		okL,
+		okC,
+		okH,
+		hex
+	};
+}
 function relativeLuminance(r, g, b) {
 	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
 	return .2126 * R + .7152 * G + .0722 * B;
@@ -11698,6 +11768,36 @@ function normalizedReference(value) {
 	return normalized.length > 0 ? normalized : null;
 }
 //#endregion
+//#region ../theme-core/src/surfaces/logoVariant.ts
+/** Concrete hex behind a plain, opaque palette token, or null otherwise. */
+function opaquePaletteHexForToken(expandedPalette, token) {
+	if (!token) return null;
+	const parts = parseColorTokenParts(token);
+	if (parts.kind !== "token" || parts.opacityPercent !== null) return null;
+	return expandedPalette[parts.token] ?? null;
+}
+/**
+* Tone of the surface a foreground token was resolved for.
+*
+* A token with opacity has no known underlay to composite against, and a raw
+* or unrecognised token has no palette hex, so both are `unknown` rather than
+* a guess.
+*/
+function surfaceToneFromForegroundToken(expandedPalette, foregroundToken) {
+	const hex = opaquePaletteHexForToken(expandedPalette, foregroundToken);
+	if (!hex) return "unknown";
+	return featuresFromHex(hex).Y >= .5 ? "dark" : "light";
+}
+/**
+* The logo to draw on a surface of the given tone. A missing variant falls
+* back to the other one, and an unknown tone uses the light-backgrounds logo,
+* which is what every site rendered before variants existed.
+*/
+function selectLogoVariant(tone, variants) {
+	const { forLightBackgrounds, forDarkBackgrounds } = variants;
+	return tone === "dark" ? forDarkBackgrounds ?? forLightBackgrounds : forLightBackgrounds ?? forDarkBackgrounds;
+}
+//#endregion
 //#region ../theme-core/src/utils/colorStyles.ts
 const COLOR_VAR_PREFIX = "--tb-";
 function parseToken(source) {
@@ -11749,16 +11849,28 @@ function backgroundColorStyle(token) {
 	return { backgroundColor: rgbColorValue(token) };
 }
 /**
+* Converts a text color token to a CSS color value that follows the enclosing
+* surface. The semantic text tokens (`text`, `heading`, `mutedText`) resolve
+* to the surface foreground variables, so text adapts when a section's
+* background changes; any other token is a fixed theme color.
+*
+* @param token - Theme color token
+* @returns CSS color value
+*/
+function textColorValue(token) {
+	const parsed = parseToken(token);
+	const surfaceRole = parsed.raw ? null : surfaceRoleForTextToken(parsed.token);
+	if (!surfaceRole) return rgbColorValue(token);
+	return parsed.opacityPercent === void 0 ? surfaceForegroundValue(surfaceRole) : surfaceForegroundValueWithOpacity(surfaceRole, parsed.opacityPercent);
+}
+/**
 * Creates a text color style object from a theme token.
 *
 * @param token - Theme color token
 * @returns CSSProperties with color
 */
 function textColorStyle(token) {
-	const parsed = parseToken(token);
-	const surfaceRole = parsed.raw ? null : surfaceRoleForTextToken(parsed.token);
-	if (surfaceRole) return { color: parsed.opacityPercent === void 0 ? surfaceForegroundValue(surfaceRole) : surfaceForegroundValueWithOpacity(surfaceRole, parsed.opacityPercent) };
-	return { color: rgbColorValue(token) };
+	return { color: textColorValue(token) };
 }
 /**
 * Creates a border color style object from a theme token.
@@ -26703,9 +26815,7 @@ function navRow(opts) {
 		rel: { $bind: { from: `${childItemName}.rel` } },
 		"data-active": { $bind: { from: `${childItemName}.active` } }
 	}, [text({ as: "span" }, bind(`${childItemName}.label`))], repeat(`${itemName}.children`, childItemName));
-	const dropdown = el("div", { className: "nav-dropdown rb-relative" }, [button({
-		type: "button",
-		variantId: "",
+	const dropdown = el("div", { className: "nav-dropdown rb-relative" }, [el("headerControl", {
 		className: prependClassName("nav-dropdown-trigger", linkClassName),
 		"aria-haspopup": "menu",
 		"aria-expanded": "false",
@@ -26773,9 +26883,7 @@ function navColumn(opts) {
 	const dropdown = el("div", {
 		className: "nav-mobile-dropdown",
 		"data-nav-mobile-dropdown": "true"
-	}, [button({
-		type: "button",
-		variantId: "",
+	}, [el("headerControl", {
 		className: triggerClassName,
 		"aria-expanded": "false",
 		"aria-controls": childrenId,
@@ -33124,6 +33232,49 @@ const layoutTransforms = [
 	footerLogoMediaClassTransform,
 	footerLogoTextVisibleTransform
 ];
+//#endregion
+//#region ../blocks/src/system/transforms/registry/chromeLogo.ts
+const chromeLogoSchema = z.object({ surface: z.enum([
+	"header-root",
+	"header-mobile-panel",
+	"footer-root"
+]) });
+/** The brand foreground shares the logo's surface; navigation may own a separate capsule. */
+function chromeSurfaceTextToken(surface, theme, palette) {
+	switch (surface) {
+		case "header-root": {
+			const header = theme.header;
+			const foreground = resolveHeaderRootForeground(header, palette, resolveHeaderVisualStyles(header).isTransparent);
+			return foreground.kind === "known" ? foreground.roles.text : resolveHeaderLeafTextColor(header);
+		}
+		case "header-mobile-panel": return theme.header?.dropdownStyle?.textColor ?? "text";
+		case "footer-root": {
+			const foreground = resolveFooterRootForeground(theme.footer, palette);
+			return foreground.kind === "known" ? foreground.roles.text : void 0;
+		}
+	}
+}
+function readChromeTheme(viewModel) {
+	return asPartialObject(asPartialObject(viewModel?.["$root"])?.theme) ?? {};
+}
+function resolveChromeSurfaceTone(surface, context) {
+	return surfaceToneFromForegroundToken(context.theme.palette, chromeSurfaceTextToken(surface, readChromeTheme(context.viewModel), context.theme.palette));
+}
+const chromeLogoTransforms = [{
+	id: "layout.chromeLogo",
+	kind: "formatter",
+	summary: "Select the light- or dark-background site logo for a header or footer surface",
+	schema: chromeLogoSchema,
+	run: (value, options, context) => {
+		const content = asPartialObject(value);
+		const variants = asPartialObject(content?.logoVariants);
+		if (!variants) return content?.logo ?? null;
+		return selectLogoVariant(resolveChromeSurfaceTone(options.surface, context), {
+			forLightBackgrounds: variants.forLightBackgrounds ?? null,
+			forDarkBackgrounds: variants.forDarkBackgrounds ?? null
+		});
+	}
+}];
 const headerRuntimeTransforms = [{
 	id: "layout.headerRuntimeContract",
 	kind: "formatter",
@@ -33326,46 +33477,42 @@ const whenTransformed = (from, transformId, equals = true) => (node) => ({
 		equals
 	}
 });
-const logoRow = link({
+/** Draw whichever site logo suits the surface this row sits on. */
+const bindChromeLogo = (surface) => bind("content", { transforms: [{
+	id: "layout.chromeLogo",
+	options: { surface }
+}] });
+/**
+* The brand link. The logo is chosen per surface because the open mobile menu
+* paints its own background, which may be the opposite tone to the header.
+*/
+const createLogoRow = (surface) => link({
 	href: "/",
 	className: bindProp("$root.theme.header.logo", {
 		transforms: pipe(tx("layout.headerLogoClass")),
 		fallback: "header-logo rb-flex rb-min-w-0 rb-items-center rb-gap-3 rb-no-underline rb-transition-opacity rb-hover-opacity-80"
 	})
-}, [
-	media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("content.logo"), bind("content.logo")),
-	stack({ className: "rb-contents" }, [media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-	text({
-		as: "strong",
-		className: "header-logo-text rb-truncate"
-	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-]);
+}, [media({ className: bindProp("$root.theme.header.logo", {
+	transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300" })),
+	fallback: "rb-header-logo-sm rb-w-auto rb-transition-all rb-duration-300"
+}) }, when("content.logo"), bindChromeLogo(surface)), text({
+	as: "strong",
+	className: "header-logo-text rb-truncate"
+}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))]);
+const logoRow = createLogoRow("header-root");
 const centeredLogoRow = link({
 	href: "/",
 	className: bindProp("$root.theme.header.logo", {
 		transforms: pipe(tx("layout.headerLogoClass", { base: "header-logo rb-flex rb-items-center rb-justify-center rb-gap-3 rb-text-center rb-no-underline rb-transition-opacity rb-hover-opacity-80" })),
 		fallback: "header-logo rb-flex rb-items-center rb-justify-center rb-gap-3 rb-text-center rb-no-underline rb-transition-opacity rb-hover-opacity-80"
 	})
-}, [
-	media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("content.logo"), bind("content.logo")),
-	stack({ className: "rb-contents" }, [media({ className: bindProp("$root.theme.header.logo", {
-		transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
-		fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
-	}) }, when("site.logo"), bind("site.logo"))], when("content.logo", { not: true })),
-	text({
-		as: "strong",
-		className: "header-logo-text"
-	}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))
-]);
+}, [media({ className: bindProp("$root.theme.header.logo", {
+	transforms: pipe(tx("layout.headerLogoMediaClass", { base: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300" })),
+	fallback: "rb-header-logo-lg rb-w-auto rb-transition-all rb-duration-300"
+}) }, when("content.logo"), bindChromeLogo("header-root")), text({
+	as: "strong",
+	className: "header-logo-text"
+}, whenTransformed("$root.theme.header.logo", "layout.headerLogoTextVisible"), bind("site.title", { fallback: "Your Site" }))]);
 const createNavRow = (className, align = "end") => navRow({
 	className: `${className} header-nav-row`,
 	align,
@@ -33405,10 +33552,8 @@ const mobileToggleIcon = stack({
 	}
 ]);
 const mobileToggleButton = {
-	type: "button",
+	type: "headerControl",
 	props: {
-		type: "button",
-		variantId: "",
 		className: `nav-mobile-toggle ${mobileOnlyDisplay("inline-flex")} rb-h-10 rb-w-10 rb-items-center rb-justify-center rb-rounded-md transition-theme-standard`,
 		"aria-label": "Open menu",
 		"aria-expanded": "false",
@@ -33418,10 +33563,8 @@ const mobileToggleButton = {
 	children: [mobileToggleIcon]
 };
 const mobileOverlayToggleButton = {
-	type: "button",
+	type: "headerControl",
 	props: {
-		type: "button",
-		variantId: "",
 		className: "nav-mobile-toggle rb-inline-flex rb-h-10 rb-w-10 rb-items-center rb-justify-center rb-rounded-md transition-theme-standard",
 		"aria-label": "Open menu",
 		"aria-expanded": "false",
@@ -33445,7 +33588,7 @@ const mobileOverlayHeader = inline({
 	align: "center",
 	justify: "between",
 	style: borderColorStyle("border")
-}, [logoRow, mobileOverlayToggleButton]);
+}, [createLogoRow("header-mobile-panel"), mobileOverlayToggleButton]);
 const mobileOverlayBody = stack({
 	className: "rb-flex-1 rb-px-6 rb-py-6",
 	gap: "md",
@@ -33632,7 +33775,10 @@ const brandLogo = link({
 		options: { base: "rb-h-10 rb-w-auto" }
 	}],
 	fallback: "rb-h-10 rb-w-auto"
-} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content.logo")), text({
+} } }, when("module.showLogo", { equals: true }), when("content.logo"), bind("content", { transforms: [{
+	id: "layout.chromeLogo",
+	options: { surface: "footer-root" }
+}] })), text({
 	as: "strong",
 	className: "footer-logo-text rb-nav-text"
 }, when("module.showTitle", { equals: true }), bind("site.title", { fallback: "Your Site" }))], when("module.kind", { equals: "brand" }));
@@ -36271,6 +36417,12 @@ const occurrenceContextSchema = z.object({
 	capacityOverride: z.number().nullable().optional(),
 	overrides: z.record(z.string(), z.unknown()).nullable().optional()
 }).nullable();
+//#endregion
+//#region ../blocks/src/system/runtime/api/readAuthority.ts
+const browserReadAuthoritySchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("published") }).strict(), z.object({
+	kind: z.literal("preview"),
+	token: z.string().min(1)
+}).strict()]);
 const unsupportedEventRegistrationPageSurfaceSubjectSchema = z.object({
 	kind: z.literal("unsupported"),
 	reason: z.enum([
@@ -36381,6 +36533,33 @@ function normalizeEventCalendarDisplayMode$1(input) {
 	if (isEventCalendarDisplayMode(input.variant)) return input.variant;
 	return isEventCalendarDisplayMode(input.displayMode) ? input.displayMode : void 0;
 }
+/** One closed authority for the projections required by each rendered mode. */
+function resolveEventCalendarReadPlan(input) {
+	const mode = normalizeEventCalendarDisplayMode$1(input) ?? "combined";
+	switch (mode) {
+		case "combined": return {
+			mode,
+			jobs: "both",
+			readProfile: "listing-card"
+		};
+		case "list": return {
+			mode,
+			jobs: "list",
+			readProfile: "listing-card"
+		};
+		case "calendar": return {
+			mode,
+			jobs: "calendar",
+			readProfile: "listing-card"
+		};
+		case "timetable":
+		case "week-board": return {
+			mode,
+			jobs: "calendar",
+			readProfile: "timetable"
+		};
+	}
+}
 function isEventCalendarDefaultView(value) {
 	return typeof value === "string" && eventCalendarDefaultViewValues.includes(value);
 }
@@ -36575,6 +36754,7 @@ const eventRegistrationSourceSchema = z.object({
 	apiBaseUrl: z.string().optional(),
 	portalToken: z.string().nullable().optional(),
 	previewToken: z.string().nullable().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	...eventRegistrationHydrationSchemaShape,
 	events: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
 	wholeSeriesRunEvents: z.array(eventRegistrationPublicEventSchema).nullable().optional(),
@@ -36612,6 +36792,7 @@ z.object({
 	apiBaseUrl: z.string().optional(),
 	portalToken: z.string().nullable().optional(),
 	previewToken: z.string().nullable().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 function buildEventRegistrationDisplayFromScopedEvents(source, scopedSourceEvents) {
@@ -36870,6 +37051,7 @@ const eventRegistrationBlockDefinition = {
 				text({ as: "h2" }, bind("content.heading"), when("content.heading")),
 				richText({ className: "rb-prose rb-max-w-none" }, bind("content.description"), when("content.description")),
 				eventRegistration(withApiBindings({
+					readAuthority: { $bind: { from: "$root.readAuthority" } },
 					occurrenceContext: { $bind: { from: "$root.occurrenceContext" } },
 					subject: { $bind: { from: "$root.subject" } },
 					portalToken: { $bind: {
@@ -37502,8 +37684,7 @@ function resolveEventListPaginationAction(input) {
 //#endregion
 //#region ../blocks/src/system/blocks/events/shared/calendarWindow.ts
 function resolveCalendarReadProfile(content) {
-	const mode = normalizeEventCalendarDisplayMode$1(content);
-	return mode === "timetable" || mode === "week-board" ? "timetable" : "listing-card";
+	return resolveEventCalendarReadPlan(content).readProfile;
 }
 /** Runtime picker sentinels and bound loader IDs must describe the same query. */
 function normalizeCalendarFilterId(value) {
@@ -37613,6 +37794,7 @@ const eventCollectionSourceSchemaShape = {
 	events: z.array(publicEventSchema).nullable().optional(),
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional(),
 	listLayout: eventLayoutSchema.optional(),
 	listColumns: columnOptionSchema.optional(),
@@ -37665,7 +37847,6 @@ const eventCollectionDisplaySchemaShape = {
 const eventCollectionHydrationSchema = z.object({
 	siteId: z.string(),
 	calendarWindow: calendarWindowPageSchema.optional(),
-	stage: previewStageSchema.optional(),
 	prefetchedEvents: z.boolean(),
 	eventSurface: eventSurfaceScopeSchema$1,
 	filterEventPresets: z.string().nullable(),
@@ -37740,7 +37921,6 @@ function buildEventCollectionHydration(source, now = /* @__PURE__ */ new Date())
 	return {
 		calendarWindow: source.calendarWindow ?? void 0,
 		siteId: source.siteId,
-		stage: source.stage,
 		prefetchedEvents: source.events != null,
 		eventSurface: selected ? "all" : normalizeEventSurfaceScope(source.eventSurface),
 		filterEventPresets: selected ? null : normalizeEventSurfacePresetsCsv(source.filterEventPresets),
@@ -37760,6 +37940,7 @@ const eventListingSourceSchema = z.object({
 	events: z.array(publicEventSchema).nullable().optional(),
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional(),
 	layout: eventLayoutSchema.optional(),
 	columns: columnOptionSchema.optional(),
@@ -37800,7 +37981,6 @@ const eventListingDisplaySchema = z.object({
 });
 const eventListingHydrationSchema = z.object({
 	siteId: z.string(),
-	stage: previewStageSchema.optional(),
 	eventsPerPage: eventPageSizeSchema,
 	paginationAction: eventListPaginationActionSchema,
 	showFilters: z.boolean(),
@@ -37823,6 +38003,7 @@ const eventListingRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const eventListingBlockRuntime = defineProgressiveBlockRuntime({
@@ -37857,7 +38038,6 @@ const eventListingBlockRuntime = defineProgressiveBlockRuntime({
 			},
 			hydration: {
 				siteId: source.siteId,
-				stage: source.stage,
 				eventsPerPage: pageSize,
 				paginationAction: resolveEventListPaginationAction({
 					paginationMode: source.paginationMode,
@@ -38139,6 +38319,7 @@ const eventListingBlockDefinition = {
 				rootType: "stack",
 				rootProps: { gap: "lg" },
 				children: [...eventSectionHeaderLayoutNodes(), el("event-listing", withApiBindings({
+					readAuthority: { $bind: { from: "$root.readAuthority" } },
 					events: { $bind: { from: "data.events" } },
 					stage: { $bind: {
 						from: "$root.previewStage",
@@ -38336,6 +38517,7 @@ const eventCalendarRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 /**
@@ -38357,7 +38539,7 @@ function buildEventCalendarDisplay(source) {
 			listColumns: source.listColumns ?? source.columns
 		}),
 		kind: "event-calendar",
-		displayMode: normalizeEventCalendarDisplayMode$1(source) ?? "combined",
+		displayMode: resolveEventCalendarReadPlan(source).mode,
 		className: source.className ?? null,
 		events: (source.events ?? []).slice().sort((left, right) => new Date(left.startsAt).getTime() - new Date(right.startsAt).getTime()),
 		boardTitle: normalizeOptionalText(source.boardTitle),
@@ -38374,13 +38556,16 @@ const eventCalendarBlockRuntime = defineProgressiveBlockRuntime({
 		source: createZodCodec(eventCalendarSourceSchema),
 		render: createZodCodec(eventCalendarRenderSchema)
 	},
-	buildRender: (source) => ({
-		display: buildEventCalendarDisplay(source.calendarWindow && (source.variant ?? source.displayMode ?? "combined") !== "combined" && (source.variant ?? source.displayMode) !== "list" ? {
-			...source,
-			events: source.calendarWindow.events
-		} : source),
-		hydration: buildEventCollectionHydration(source)
-	})
+	buildRender: (source) => {
+		const plan = resolveEventCalendarReadPlan(source);
+		return {
+			display: buildEventCalendarDisplay(source.calendarWindow && plan.jobs === "calendar" ? {
+				...source,
+				events: source.calendarWindow.events
+			} : source),
+			hydration: buildEventCollectionHydration(source)
+		};
+	}
 });
 //#endregion
 //#region ../blocks/src/system/blocks/events/eventCalendarDataLoaders.ts
@@ -38530,6 +38715,7 @@ const eventCalendarLayout = [styledSection({
 		rootType: "stack",
 		rootProps: { gap: "lg" },
 		children: [...eventSectionHeaderLayoutNodes({ splitClassName: "event-section-head event-section-head--split" }), el("event-calendar", withApiBindings({
+			readAuthority: { $bind: { from: "$root.readAuthority" } },
 			events: { $bind: { from: "data.events" } },
 			calendarWindow: { $bind: { from: "data.calendarWindow" } },
 			stage: { $bind: {
@@ -42317,6 +42503,7 @@ const shopSourceSchema = z.object({
 	products: z.array(publicProductSchema).nullable().optional(),
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const productVariantOptionDisplaySchema = z.object({
@@ -42484,6 +42671,7 @@ function resolveShowPricePerCredit(source) {
 z.object({
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const shopBlockRuntime = defineProgressiveBlockRuntime({
@@ -42824,6 +43012,7 @@ const shopBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([shop(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "passes-memberships",
 				showPasses: { $bind: {
 					from: "content.showPasses",
@@ -43022,6 +43211,7 @@ const productListBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productList(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-list",
 				heading: { $bind: {
 					from: "content.heading",
@@ -43164,6 +43354,7 @@ const productDetailBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productDetail(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-detail",
 				heading: { $bind: {
 					from: "content.heading",
@@ -43280,6 +43471,7 @@ const cartBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([cart(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "cart",
 				heading: { $bind: {
 					from: "content.heading",
@@ -43363,6 +43555,7 @@ const checkoutBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([checkout(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "checkout",
 				heading: { $bind: {
 					from: "content.heading",
@@ -46035,8 +46228,8 @@ const defaultTransforms = createTransformRegistry([
 		summary: "Choose the read projection required by the calendar display mode",
 		schema: z.object({ job: z.enum(["list", "calendar"]) }),
 		run(value, options) {
-			const mode = normalizeEventCalendarDisplayMode$1(asPartialObject(value) ?? {}) ?? "combined";
-			return options.job === "calendar" ? mode !== "list" : mode === "list" || mode === "combined";
+			const plan = resolveEventCalendarReadPlan(asPartialObject(value) ?? {});
+			return plan.jobs === "both" || plan.jobs === options.job;
 		}
 	},
 	{
@@ -46049,6 +46242,7 @@ const defaultTransforms = createTransformRegistry([
 	},
 	...formattingTransforms,
 	...layoutTransforms,
+	...chromeLogoTransforms,
 	...uiTransforms,
 	...mediaTransforms,
 	...backgroundTransforms,
@@ -47237,20 +47431,24 @@ function createPublicAppointmentReadOperations(deps) {
 //#region src/client/publicEventReadOperations.ts
 function createPublicEventReadOperations(deps) {
 	async function resolveEventSubroute(params, kind) {
-		const { siteId, subject, segment, signal } = params;
+		const { siteId, subject, segment, signal, preview = false } = params;
 		if (!siteId || !segment) throw new Error(`${kind === "event-run" ? "resolveEventRun" : "resolveEventOccurrence"}() requires siteId, subject, and segment`);
 		const subjectId = subject.kind === "eventOffering" ? subject.eventOfferingId : subject.eventSeriesId;
-		return deps.resilientFetchData("resolveEventSubroute", `${kind}:${siteId}:${subject.kind}:${subjectId}:${segment}`, (requestSignal) => deps.apiClient({
+		return deps.resilientFetchData("resolveEventSubroute", `${kind}:${siteId}:${subject.kind}:${subjectId}:${segment}:${preview ? "preview" : "published"}`, (requestSignal) => deps.apiClient({
 			endpoint: "resolveEventSubroute",
 			params: {
 				siteId,
 				kind,
 				subjectKind: subject.kind,
 				subjectId,
-				segment
+				segment,
+				stage: preview ? "preview" : "published"
 			},
 			options: { signal: requestSignal }
-		}), { signal });
+		}), {
+			signal,
+			preview
+		});
 	}
 	return {
 		async listPublicEventCalendarWindow({ signal, ...params }) {