@riverbankcms/sdk 0.149.0 → 0.150.0

package/dist/server/config-validation.mjs

@@ -4748,6 +4748,68 @@ const paletteValueKeySchema = z.string().transform((value, ctx) => {
 	return z.NEVER;
 });
 //#endregion
+//#region ../theme-core/src/palette/utils/opaqueSurfaceColor.ts
+/** Resolve an opaque colour, compositing alpha against an explicit underlay. */
+function resolveOpaqueSurfaceHex(reference, palette, underlayReference) {
+	const opaque = resolveConcreteColorHex(reference, palette);
+	if (opaque) return opaque;
+	if (!underlayReference) return null;
+	const underlayHex = resolveConcreteColorHex(underlayReference, palette);
+	if (!underlayHex) return null;
+	const parts = parseColorTokenParts(reference);
+	if (parts.kind === "token" && parts.opacityPercent !== null) {
+		const foregroundHex = normalizePaletteHex(palette[parts.token] ?? "");
+		return foregroundHex ? compositeHex(foregroundHex, underlayHex, parts.opacityPercent / 100) : null;
+	}
+	const rgba = parseRgba(parts.kind === "raw" ? parts.value : reference);
+	return rgba ? compositeHex(rgbToHex(rgba.r, rgba.g, rgba.b), underlayHex, rgba.alpha) : null;
+}
+/** Resolve a colour reference only when it is already fully opaque. */
+function resolveConcreteColorHex(reference, palette) {
+	const literalHex = normalizePaletteHex(reference);
+	if (literalHex) return literalHex;
+	const parts = parseColorTokenParts(reference);
+	if (parts.kind === "token") {
+		if (parts.opacityPercent !== null) return null;
+		return normalizePaletteHex(palette[parts.token] ?? "");
+	}
+	const literal = parts.kind === "raw" ? parts.value : reference;
+	if (literal.toLowerCase() === "black") return "#000000";
+	if (literal.toLowerCase() === "white") return "#ffffff";
+	return normalizePaletteHex(literal);
+}
+function compositeHex(foregroundHex, underlayHex, alpha) {
+	const foreground = hexToRgb(foregroundHex);
+	const underlay = hexToRgb(underlayHex);
+	const channel = (foregroundValue, underlayValue) => Math.round(foregroundValue * alpha + underlayValue * (1 - alpha));
+	return rgbToHex(channel(foreground.r, underlay.r), channel(foreground.g, underlay.g), channel(foreground.b, underlay.b));
+}
+function parseRgba(value) {
+	const match = value.trim().match(/^rgba?\(\s*([\d.]+)(?:\s*,\s*|\s+)([\d.]+)(?:\s*,\s*|\s+)([\d.]+)(?:\s*(?:,|\/)\s*([\d.]+%?))?\s*\)$/i);
+	if (!match) return null;
+	const [, rSource, gSource, bSource] = match;
+	if (!rSource || !gSource || !bSource) return null;
+	const r = Number(rSource);
+	const g = Number(gSource);
+	const b = Number(bSource);
+	const alpha = parseAlpha(match[4]);
+	if (alpha === null || !isRgbChannel(r) || !isRgbChannel(g) || !isRgbChannel(b)) return null;
+	return {
+		r,
+		g,
+		b,
+		alpha
+	};
+}
+function parseAlpha(source) {
+	if (!source) return 1;
+	const value = source.endsWith("%") ? Number(source.slice(0, -1)) / 100 : Number(source);
+	return Number.isFinite(value) && value >= 0 && value <= 1 ? value : null;
+}
+function isRgbChannel(value) {
+	return Number.isFinite(value) && value >= 0 && value <= 255;
+}
+//#endregion
 //#region ../theme-core/src/site-styles/styleTags.ts
 /**
 * Descriptive style-axis metadata for button personalities and palette
@@ -7356,68 +7418,6 @@ function interpolateHex(startHex, endHex, position) {
 	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
 	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
 }
-//#endregion
-//#region ../theme-core/src/palette/utils/opaqueSurfaceColor.ts
-/** Resolve an opaque colour, compositing alpha against an explicit underlay. */
-function resolveOpaqueSurfaceHex(reference, palette, underlayReference) {
-	const opaque = resolveConcreteColorHex(reference, palette);
-	if (opaque) return opaque;
-	if (!underlayReference) return null;
-	const underlayHex = resolveConcreteColorHex(underlayReference, palette);
-	if (!underlayHex) return null;
-	const parts = parseColorTokenParts(reference);
-	if (parts.kind === "token" && parts.opacityPercent !== null) {
-		const foregroundHex = normalizePaletteHex(palette[parts.token] ?? "");
-		return foregroundHex ? compositeHex(foregroundHex, underlayHex, parts.opacityPercent / 100) : null;
-	}
-	const rgba = parseRgba(parts.kind === "raw" ? parts.value : reference);
-	return rgba ? compositeHex(rgbToHex(rgba.r, rgba.g, rgba.b), underlayHex, rgba.alpha) : null;
-}
-/** Resolve a colour reference only when it is already fully opaque. */
-function resolveConcreteColorHex(reference, palette) {
-	const literalHex = normalizePaletteHex(reference);
-	if (literalHex) return literalHex;
-	const parts = parseColorTokenParts(reference);
-	if (parts.kind === "token") {
-		if (parts.opacityPercent !== null) return null;
-		return normalizePaletteHex(palette[parts.token] ?? "");
-	}
-	const literal = parts.kind === "raw" ? parts.value : reference;
-	if (literal.toLowerCase() === "black") return "#000000";
-	if (literal.toLowerCase() === "white") return "#ffffff";
-	return normalizePaletteHex(literal);
-}
-function compositeHex(foregroundHex, underlayHex, alpha) {
-	const foreground = hexToRgb(foregroundHex);
-	const underlay = hexToRgb(underlayHex);
-	const channel = (foregroundValue, underlayValue) => Math.round(foregroundValue * alpha + underlayValue * (1 - alpha));
-	return rgbToHex(channel(foreground.r, underlay.r), channel(foreground.g, underlay.g), channel(foreground.b, underlay.b));
-}
-function parseRgba(value) {
-	const match = value.trim().match(/^rgba?\(\s*([\d.]+)(?:\s*,\s*|\s+)([\d.]+)(?:\s*,\s*|\s+)([\d.]+)(?:\s*(?:,|\/)\s*([\d.]+%?))?\s*\)$/i);
-	if (!match) return null;
-	const [, rSource, gSource, bSource] = match;
-	if (!rSource || !gSource || !bSource) return null;
-	const r = Number(rSource);
-	const g = Number(gSource);
-	const b = Number(bSource);
-	const alpha = parseAlpha(match[4]);
-	if (alpha === null || !isRgbChannel(r) || !isRgbChannel(g) || !isRgbChannel(b)) return null;
-	return {
-		r,
-		g,
-		b,
-		alpha
-	};
-}
-function parseAlpha(source) {
-	if (!source) return 1;
-	const value = source.endsWith("%") ? Number(source.slice(0, -1)) / 100 : Number(source);
-	return Number.isFinite(value) && value >= 0 && value <= 1 ? value : null;
-}
-function isRgbChannel(value) {
-	return Number.isFinite(value) && value >= 0 && value <= 255;
-}
 /**
 * Derive the hover foreground that belongs with a resolved resting foreground.
 *
@@ -7983,6 +7983,15 @@ function fallbackBackground(fallbackToken, palette) {
 		reason: "unresolvable-colour"
 	};
 }
+/** Every role's contextual styles against one proven solid surface. */
+function knownSurfaceButtonContextStyles(input) {
+	return Object.fromEntries(VARIANT_ROLES.flatMap((role) => Object.entries(contextualButtonSurfaceStyles(resolveContextualButtonRole({
+		role,
+		buttonSystem: input.buttonSystem,
+		palette: input.palette,
+		surface: input.surface
+	})))));
+}
 function resolveContextualButtonRole(input) {
 	const requested = findVariant(input.buttonSystem, input.role);
 	if (!requested) return {
@@ -10982,6 +10991,18 @@ function brandNonEmptyString(value, label) {
 	if (value.length === 0) throw new Error(`${label} must be a non-empty string.`);
 	return value;
 }
+/**
+* What a block's own section background field admits, read from its manifest.
+* A site style's surface rule may paint a gradient or a photo; a block whose
+* `_sectionStyles.background` refuses that paint would be dropped at render
+* admission, so the runtime compiler paints the surface's colour equivalent
+* instead (see `compileSectionBackground`).
+*/
+const sectionBackgroundPaintValues = [
+	"color",
+	"gradient",
+	"image"
+];
 const plainFrame = { kind: "plain" };
 function panelFrame(treatment) {
 	return {
@@ -11066,6 +11087,7 @@ function defineBlockDesignCapability(capability) {
 		...capability,
 		kind: "designed",
 		looks: capability.looks ?? "not-applicable",
+		sectionBackgroundPaints: admittedSectionBackgroundPaints(capability.sectionBackgroundPaints),
 		sectionHeights: capability.sectionHeights ?? ["default"],
 		imageSurfaceTreatments: capability.imageSurfaceTreatments ?? ["none"],
 		imageSurfaceMotions: capability.imageSurfaceMotions ?? ["static"],
@@ -11078,6 +11100,10 @@ function defineBlockDesignCapability(capability) {
 		...capability.accordionIconSets ? { accordionIconSets: capability.accordionIconSets } : {}
 	};
 }
+/** Absent means the block admits every section background paint. */
+function admittedSectionBackgroundPaints(paints) {
+	return paints ?? sectionBackgroundPaintValues;
+}
 //#endregion
 //#region ../theme-core/src/site-styles/logoBranding.ts
 const logoTextConfidenceValues = [
@@ -11356,12 +11382,22 @@ const mediaPresentationSchema = commonSchema.extend({
 const boxBackgroundSchema = z.discriminatedUnion("type", [
 	commonSchema.extend({
 		type: z.literal("color"),
-		color: tokenOrCssColorValueSchema.nullable().optional()
+		color: tokenOrCssColorValueSchema.nullable().optional(),
+		/**
+		* Compiler-owned. The scrim a site-style colour surface lays over media
+		* that replaces it (a Look's band meeting an authored photo), sized so the
+		* surface's foreground stays legible over any pixel. A colour background
+		* never draws it itself; `resolveSectionBackground` moves it onto the
+		* merged media background as its overlay.
+		*/
+		mediaScrim: boxBackgroundOverlaySchema.nullable().optional()
 	}),
 	commonSchema.extend({
 		type: z.literal("gradient"),
 		gradient: z.string().nullable().optional(),
-		gradientPresetId: z.string().min(1).nullable().optional()
+		gradientPresetId: z.string().min(1).nullable().optional(),
+		/** Compiler-owned; see the colour branch. */
+		mediaScrim: boxBackgroundOverlaySchema.nullable().optional()
 	}),
 	mediaPresentationSchema.extend({
 		type: z.literal("image"),
@@ -12159,6 +12195,17 @@ function defineBlockAppearancePreset(preset) {
 * (`defineBlockAppearancePreset` defaults it to `none`) — the block's own
 * composition still governs how its items look. The per-Look rationale for the card-bearing ones lives
 * in `.project/plans/1297-card-role-contract-site-styles-own-card-surfaces/mapping-table.md`.
+*
+* A Look asking for the `alternative` or `open` role is offered only where the
+* site style defines that role (`siteStyleSupportsLookDesign`), so two Looks
+* that differ only in role are distinct wherever both are offered.
+*
+* Retiring a Look is removing its entry. A stored pin to a retired id reads as
+* an unsupported pin in the page design editor model and renders the block's
+* auto Look, the same path an unavailable Look takes. Duplicates retired in
+* the 2026-09 Look audit: `feature-cards-soft-panels`,
+* `feature-cards-photo-tiles`, `feature-cards-editorial-pathways`,
+* `testimonials-default-cards`.
 */
 const brandScrimOptionGroups = [{
 	id: "image-surface-treatment",
@@ -12543,16 +12590,6 @@ defineBlockAppearancePreset({
 			treatment: "framed-programme"
 		}
 	}
-}), defineBlockAppearancePreset({
-	id: "feature-cards-soft-panels",
-	target: "feature-cards",
-	label: "Soft tinted panels",
-	blockKinds: ["block.feature-cards"],
-	design: {
-		sectionSurface: "base",
-		contentFrame: plainFrame,
-		cardRole: "alternative"
-	}
 }), defineBlockAppearancePreset({
 	id: "feature-cards-editorial-diptych",
 	target: "feature-cards",
@@ -12564,27 +12601,6 @@ defineBlockAppearancePreset({
 		contentFrame: plainFrame,
 		cardRole: "default"
 	}
-}), defineBlockAppearancePreset({
-	id: "feature-cards-editorial-pathways",
-	target: "feature-cards",
-	label: "Editorial pathways",
-	blockKinds: ["block.feature-cards"],
-	constraints: { layoutVariantKeys: ["editorial-pathways"] },
-	design: {
-		sectionSurface: "base",
-		contentFrame: plainFrame,
-		cardRole: "default"
-	}
-}), defineBlockAppearancePreset({
-	id: "feature-cards-photo-tiles",
-	target: "feature-cards",
-	label: "Photo tiles",
-	blockKinds: ["block.feature-cards"],
-	design: {
-		sectionSurface: "base",
-		contentFrame: plainFrame,
-		cardRole: "default"
-	}
 }), defineBlockAppearancePreset({
 	id: "events-lined-panel",
 	target: "events",
@@ -12673,16 +12689,6 @@ defineBlockAppearancePreset({
 		contentFrame: panelFrame("raised"),
 		cardRole: "default"
 	}
-}), defineBlockAppearancePreset({
-	id: "testimonials-default-cards",
-	target: "testimonials",
-	label: "Default cards",
-	blockKinds: ["block.testimonials"],
-	design: {
-		sectionSurface: "base",
-		contentFrame: plainFrame,
-		cardRole: "default"
-	}
 }), defineBlockAppearancePreset({
 	id: "testimonials-statement-cards",
 	target: "testimonials",
@@ -16164,9 +16170,7 @@ const curatedSiteStyles = [
 		recommendedAppearancePresetIds: [
 			"hero-split-editorial",
 			"intro-portrait-bio",
-			"feature-cards-soft-panels",
-			"feature-cards-editorial-columns",
-			"feature-cards-photo-tiles",
+			"feature-cards-bold-colors",
 			"testimonials-non-carded",
 			"faq-contained-help",
 			"contact-form-panel"
@@ -16810,8 +16814,7 @@ const curatedSiteStyles = [
 			"intro-portrait-bio",
 			"feature-cards-editorial-columns",
 			"feature-cards-editorial-diptych",
-			"feature-cards-editorial-pathways",
-			"feature-cards-soft-panels",
+			"feature-cards-bold-colors",
 			"events-lined-panel",
 			"testimonials-non-carded",
 			"faq-base-accordion",
@@ -18617,6 +18620,34 @@ function withLookCapability(declaration) {
 		}
 	};
 }
+/**
+* The section background paints a block's own `_sectionStyles.background`
+* field admits, read from its manifest so the design capability cannot drift
+* from what render admission accepts. A block without the field admits none.
+*/
+function sectionBackgroundPaintsOfFields(fields) {
+	const sectionStyles = fields.find((field) => field.id === "_sectionStyles");
+	if (!sectionStyles || sectionStyles.type !== "modal") return [];
+	const background = sectionStyles.schema.fields.find((field) => field.id === "background");
+	if (!background || background.type !== "tabGroup") return [];
+	const tabIds = new Set(background.tabs.map((tab) => tab.id));
+	return [
+		"color",
+		"gradient",
+		"image"
+	].filter((paint) => tabIds.has(paint));
+}
+/** Pins a designed capability's section background paints to the block's manifest. */
+function withManifestSectionBackgroundPaints(declaration, fields) {
+	if (declaration.kind !== "capability") return declaration;
+	return {
+		kind: "capability",
+		capability: {
+			...declaration.capability,
+			sectionBackgroundPaints: sectionBackgroundPaintsOfFields(fields)
+		}
+	};
+}
 function declareNoBlockDesignCapability(reason) {
 	return {
 		kind: "none",
@@ -20479,15 +20510,11 @@ function resolveContextualButtonStyles(background, foreground, context, options)
 	if (!paletteCache.has(palette)) paletteCache.set(palette, surfaceCache);
 	const cached = surfaceCache.get(cacheKey);
 	if (cached) return cached;
-	const styles = Object.fromEntries(VARIANT_ROLES.flatMap((role) => {
-		const resolution = resolveContextualButtonRole({
-			role,
-			buttonSystem,
-			palette,
-			surface: surface.surface
-		});
-		return Object.entries(contextualButtonSurfaceStyles(resolution));
-	}));
+	const styles = knownSurfaceButtonContextStyles({
+		surface: surface.surface,
+		palette,
+		buttonSystem
+	});
 	surfaceCache.set(cacheKey, styles);
 	return styles;
 }
@@ -27175,6 +27202,20 @@ const footerEngagement = stack({
 		...footerSpamProtectionBinding
 	}), [], when("module.engagement.kind", { equals: "mailing-list" }))
 ], when("module.kind", { equals: "engagement" }));
+const platformAttribution = el("div", {
+	className: "rb-caption",
+	"data-site-attribution": "macadamia"
+}, [
+	text({ as: "span" }, bind("module.lead")),
+	text({
+		as: "span",
+		value: " "
+	}),
+	link({
+		href: { $bind: { from: "module.link.href" } },
+		className: "footer-nav-link rb-caption transition-theme-standard"
+	}, [text({ as: "span" }, bind("module.link.label"))])
+], when("module.kind", { equals: "attribution" }));
 const footerGroup = stack({
 	gap: "md",
 	align: "stretch",
@@ -27204,6 +27245,7 @@ const footerGroup = stack({
 	hours,
 	socials,
 	footerEngagement,
+	platformAttribution,
 	stack({ className: "rb-w-full" }, [authoredCopy], when("module.kind", { equals: "supporting-text" })),
 	stack({ className: "rb-w-full rb-lg-col-span-3" }, [authoredCopy], when("module.kind", { equals: "legal" }))
 ], repeat("group.modules", "module"))], repeat("region.groups", "group"));
@@ -30070,14 +30112,18 @@ const calendarTabViewsSchema = z.enum([
 * @param needsPaymentStep - Whether user must complete payment method selection
 * @returns Array of wizard steps to display
 */
-function getWizardStepsForContext(hasPreSelectedContext, needsPaymentStep) {
+function getWizardStepsForContext(hasPreSelectedContext, needsPaymentStep, paymentActive = false) {
 	const baseSteps = hasPreSelectedContext ? ["select-tickets", "enter-details"] : [
 		"select-event",
 		"select-tickets",
 		"enter-details"
 	];
 	if (!needsPaymentStep) return baseSteps;
-	return [...baseSteps, "select-payment"];
+	return paymentActive ? [
+		...baseSteps,
+		"select-payment",
+		"payment"
+	] : [...baseSteps, "select-payment"];
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/registrationDerivations.ts
@@ -30196,6 +30242,7 @@ const EVENT_REGISTRATION_SHELL_STEP_LABELS = [
 	"Date",
 	"Tickets",
 	"Details",
+	"Payment options",
 	"Payment"
 ];
 const eventRegistrationPublicEventSchema = z.preprocess(normalizeEventRegistrationEventInput, publicEventSchema);
@@ -30338,12 +30385,13 @@ function shellLabelForRegistrationStep(step, events) {
 	switch (step) {
 		case "select-event": return isDateSelection(events) ? "Date" : "Event";
 		case "select-tickets": return "Tickets";
+		case "fully-booked":
 		case "enter-details": return "Details";
-		case "select-payment": return "Payment";
+		case "select-payment": return "Payment options";
+		case "payment": return "Payment";
 		case "error":
 		case "success":
 		case "submitting":
-		case "redirecting":
 		case "verifying-payment":
 		case "verifying-timeout":
 		case "payment-status":
@@ -30355,7 +30403,7 @@ function isDateSelection(events) {
 	return Boolean(events.length > 1 && firstSeriesId && events.every((event) => event.seriesId === firstSeriesId));
 }
 function buildEventRegistrationShellBodyText(stepLabels) {
-	if (stepLabels.includes("Payment")) return "Preparing tickets, details, and payment options.";
+	if (stepLabels.includes("Payment options")) return "Preparing tickets, details, and payment options.";
 	if (stepLabels[0] === "Tickets") return "Preparing tickets and booking details.";
 	return "Preparing dates, tickets, and booking details.";
 }
@@ -32330,7 +32378,8 @@ const eventCalendarLayout = [styledSection({
 				fallback: false
 			} },
 			banded: { $bind: {
-				from: "content.banded",
+				from: "content",
+				transforms: [{ id: "events.calendarBanded" }],
 				fallback: false
 			} }
 		}))]
@@ -38485,7 +38534,7 @@ function withDesignCapability(blockKind, definition, designCapability, designMet
 	if (definition.manifest.name !== blockKind) throw new Error(`System block kind mismatch: expected ${blockKind}, received ${definition.manifest.name}.`);
 	return {
 		...definition,
-		designCapability,
+		designCapability: withManifestSectionBackgroundPaints(designCapability, definition.manifest.fields),
 		designMetadata,
 		manifest: {
 			...definition.manifest,
@@ -39538,6 +39587,16 @@ const builtinTransformDefinitions = [
 			return resolveCalendarReadProfile(asPartialObject(value) ?? {});
 		}
 	},
+	{
+		id: "events.calendarBanded",
+		kind: "formatter",
+		summary: "Paint the week-board band only on a section with no background of its own",
+		run(value) {
+			const content = asPartialObject(value) ?? {};
+			const sectionStyles = asPartialObject(content._sectionStyles);
+			return content.banded === true && parseBackgroundContent(sectionStyles?.background) === null;
+		}
+	},
 	...formattingTransforms,
 	...layoutTransforms,
 	...chromeLogoTransforms,