@riverbankcms/sdk 0.149.0 → 0.150.0

package/dist/server/page-converter.mjs

@@ -1,5 +1,5 @@
-import "react/jsx-runtime";
 import { z } from "zod";
+import "react/jsx-runtime";
 import "react";
 import * as fs from "fs/promises";
 import * as path from "path";
@@ -5060,6 +5060,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 {
@@ -5144,6 +5156,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"],
@@ -5156,6 +5169,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 = [
@@ -5434,12 +5451,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"),
@@ -6237,6 +6264,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",
@@ -6621,16 +6659,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",
@@ -6642,27 +6670,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",
@@ -6751,16 +6758,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",
@@ -10215,9 +10212,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"
@@ -10861,8 +10856,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",
@@ -13206,6 +13200,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",
@@ -19973,6 +19995,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",
@@ -20002,6 +20038,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"));
@@ -22938,14 +22975,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
@@ -23064,6 +23105,7 @@ const EVENT_REGISTRATION_SHELL_STEP_LABELS = [
 	"Date",
 	"Tickets",
 	"Details",
+	"Payment options",
 	"Payment"
 ];
 const eventRegistrationPublicEventSchema = z.preprocess(normalizeEventRegistrationEventInput, publicEventSchema);
@@ -23206,12 +23248,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":
@@ -23223,7 +23266,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.";
 }
@@ -25173,7 +25216,8 @@ const eventCalendarLayout = [styledSection({
 				fallback: false
 			} },
 			banded: { $bind: {
-				from: "content.banded",
+				from: "content",
+				transforms: [{ id: "events.calendarBanded" }],
 				fallback: false
 			} }
 		}))]
@@ -31390,7 +31434,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,

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.149.0";
+const SDK_VERSION = "0.150.0";
 //#endregion
 //#region src/constants.ts
 /**