@riverbankcms/sdk 0.142.0 → 0.144.0

package/dist/server/page-converter.mjs

@@ -2238,16 +2238,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.
@@ -14353,9 +14365,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",
@@ -14423,9 +14433,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,
@@ -19221,46 +19229,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,
@@ -19300,10 +19304,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",
@@ -19313,10 +19315,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",
@@ -19340,7 +19340,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",
@@ -19527,7 +19527,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" }));
@@ -22313,6 +22316,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([
@@ -22423,6 +22432,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);
 }
@@ -22617,6 +22653,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(),
@@ -22654,6 +22691,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) {
@@ -22729,6 +22767,7 @@ function shellLabelForRegistrationStep(step, events) {
 		case "redirecting":
 		case "verifying-payment":
 		case "verifying-timeout":
+		case "payment-status":
 		case "payment-failed": return "Details";
 	}
 }
@@ -22911,6 +22950,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: {
@@ -23628,6 +23668,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(),
@@ -23680,7 +23721,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(),
@@ -23755,7 +23795,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),
@@ -23775,6 +23814,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(),
@@ -23815,7 +23855,6 @@ const eventListingDisplaySchema = z.object({
 });
 const eventListingHydrationSchema = z.object({
 	siteId: z.string(),
-	stage: previewStageSchema.optional(),
 	eventsPerPage: eventPageSizeSchema,
 	paginationAction: eventListPaginationActionSchema,
 	showFilters: z.boolean(),
@@ -23838,6 +23877,7 @@ const eventListingRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const eventListingBlockRuntime = defineProgressiveBlockRuntime({
@@ -23872,7 +23912,6 @@ const eventListingBlockRuntime = defineProgressiveBlockRuntime({
 			},
 			hydration: {
 				siteId: source.siteId,
-				stage: source.stage,
 				eventsPerPage: pageSize,
 				paginationAction: resolveEventListPaginationAction({
 					paginationMode: source.paginationMode,
@@ -24154,6 +24193,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",
@@ -24351,6 +24391,7 @@ const eventCalendarRenderSchema = z.object({
 z.object({
 	siteId: z.string(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 /**
@@ -24372,7 +24413,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),
@@ -24389,13 +24430,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
@@ -24545,6 +24589,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: {
@@ -28170,6 +28215,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({
@@ -28337,6 +28383,7 @@ function resolveShowPricePerCredit(source) {
 z.object({
 	siteId: z.string().optional(),
 	apiBaseUrl: z.string().optional(),
+	readAuthority: browserReadAuthoritySchema.optional(),
 	stage: previewStageSchema.optional()
 });
 const shopBlockRuntime = defineProgressiveBlockRuntime({
@@ -28677,6 +28724,7 @@ const shopBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([shop(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "passes-memberships",
 				showPasses: { $bind: {
 					from: "content.showPasses",
@@ -28875,6 +28923,7 @@ const productListBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productList(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-list",
 				heading: { $bind: {
 					from: "content.heading",
@@ -29017,6 +29066,7 @@ const productDetailBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([productDetail(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "product-detail",
 				heading: { $bind: {
 					from: "content.heading",
@@ -29133,6 +29183,7 @@ const cartBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([cart(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "cart",
 				heading: { $bind: {
 					from: "content.heading",
@@ -29216,6 +29267,7 @@ const checkoutBlockDefinition = {
 			baseClass: "",
 			spacing: "spacious",
 			children: sectionContainer([checkout(withApiBindings({
+				readAuthority: { $bind: { from: "$root.readAuthority" } },
 				mode: "checkout",
 				heading: { $bind: {
 					from: "content.heading",

package/dist/server/prebuild.mjs

@@ -12,7 +12,7 @@ import * as crypto from "crypto";
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.142.0";
+const SDK_VERSION = "0.144.0";
 //#endregion
 //#region src/constants.ts
 /**