@riverbankcms/sdk 0.148.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",
@@ -11644,6 +11638,16 @@ function isRecord$8(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 //#endregion
+//#region ../core/src/booking-payment-options.ts
+/** Automatic instalments and a flexible balance cannot share one booking offer. */
+function validateBookingPaymentOptionKinds(kinds) {
+	if (kinds.length === 0) return err("no_options");
+	const uniqueKinds = new Set(kinds);
+	if (uniqueKinds.size !== kinds.length) return err("duplicate_kind");
+	if (uniqueKinds.has("instalment_plan") && uniqueKinds.has("flexible_balance")) return err("incompatible_collection_options");
+	return ok(void 0);
+}
+//#endregion
 //#region ../core/src/booking-time-zone.ts
 const TIME_ZONE_VALIDITY_CACHE_LIMIT = 100;
 const timeZoneValidityCache = /* @__PURE__ */ new Map();
@@ -13196,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",
@@ -19963,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",
@@ -19992,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"));
@@ -22000,68 +22047,115 @@ function createRichTextDocFromMarkdown(markdown) {
 	};
 }
 //#endregion
-//#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
-const bookingDepositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);
-const bookingInstalmentPlanSchema = z.union([
-	z.object({
-		kind: z.literal("deposit_plus_one_remainder"),
-		depositAmountCents: z.number().int().min(0),
-		depositRefundability: bookingDepositRefundPolicySchema,
-		remainderDueCount: z.number().int().positive(),
-		intervalUnit: z.enum([
-			"day",
-			"week",
-			"month"
-		])
-	}),
-	z.object({
-		kind: z.literal("deposit_plus_scheduled_instalments"),
-		depositAmountCents: z.number().int().min(0),
-		depositRefundability: bookingDepositRefundPolicySchema,
-		instalmentCount: z.number().int().positive(),
-		intervalCount: z.number().int().positive(),
-		intervalUnit: z.enum([
-			"day",
-			"week",
-			"month"
-		])
-	}),
-	z.object({
-		kind: z.literal("equal_scheduled_instalments"),
-		instalmentCount: z.number().int().positive(),
-		intervalCount: z.number().int().positive(),
-		intervalUnit: z.enum([
-			"day",
-			"week",
-			"month"
-		])
-	})
+//#region ../core/src/booking-payment-schemas.ts
+const stripObject = (shape) => z.object(shape);
+const strictObject = (shape) => z.strictObject(shape);
+const depositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);
+const intervalUnitSchema = z.enum([
+	"day",
+	"week",
+	"month"
 ]);
-const bookingFlexibleBalanceDueDateRuleSchema = z.union([z.object({
-	kind: z.literal("relative_to_start_date"),
-	daysBeforeStart: z.number().int().positive()
-}), z.object({
-	kind: z.literal("fixed_calendar_date"),
-	dueAt: z.string().datetime()
-})]);
-const bookingFlexibleBalanceConfigSchema = z.object({
-	upfrontAmountCents: z.number().int().min(0),
-	dueDateRule: bookingFlexibleBalanceDueDateRuleSchema,
-	depositRefundability: bookingDepositRefundPolicySchema
-});
-const blockBookingPaymentCollectionOptionSchema = z.union([
-	z.object({ kind: z.literal("upfront") }),
-	z.object({ kind: z.literal("deferred_manual") }),
-	z.object({
-		kind: z.literal("instalment_plan"),
-		plan: bookingInstalmentPlanSchema
-	}),
-	z.object({
-		kind: z.literal("flexible_balance"),
-		config: bookingFlexibleBalanceConfigSchema
-	})
-]);
-const blockBookingPaymentTermsSchema = z.object({ allowedOptions: z.array(blockBookingPaymentCollectionOptionSchema).min(1) });
+const nonNegativeIntegerSchema = z.number().int().nonnegative();
+const positiveIntegerSchema = z.number().int().positive();
+function createInstalmentPlanSchema(object) {
+	return z.discriminatedUnion("kind", [
+		object({
+			kind: z.literal("deposit_plus_one_remainder"),
+			depositAmountCents: nonNegativeIntegerSchema,
+			depositRefundability: depositRefundPolicySchema,
+			remainderDueCount: positiveIntegerSchema,
+			intervalUnit: intervalUnitSchema
+		}),
+		object({
+			kind: z.literal("deposit_plus_scheduled_instalments"),
+			depositAmountCents: nonNegativeIntegerSchema,
+			depositRefundability: depositRefundPolicySchema,
+			instalmentCount: positiveIntegerSchema,
+			intervalCount: positiveIntegerSchema,
+			intervalUnit: intervalUnitSchema
+		}),
+		object({
+			kind: z.literal("equal_scheduled_instalments"),
+			instalmentCount: positiveIntegerSchema,
+			intervalCount: positiveIntegerSchema,
+			intervalUnit: intervalUnitSchema
+		})
+	]);
+}
+function createFlexibleBalanceSchemas(object) {
+	const dueDateRule = z.discriminatedUnion("kind", [object({
+		kind: z.literal("relative_to_start_date"),
+		daysBeforeStart: positiveIntegerSchema
+	}), object({
+		kind: z.literal("fixed_calendar_date"),
+		dueAt: z.string().datetime()
+	})]);
+	return {
+		dueDateRule,
+		config: object({
+			upfrontAmountCents: nonNegativeIntegerSchema,
+			dueDateRule,
+			depositRefundability: depositRefundPolicySchema
+		})
+	};
+}
+const paymentOptionKindsMessages = {
+	no_options: "Choose at least one way for customers to pay.",
+	duplicate_kind: "Choose each payment option only once.",
+	incompatible_collection_options: "Offer instalments or a deposit with the rest paid later, but not both."
+};
+function buildBookingPaymentOptionSchemas(object) {
+	const instalmentPlan = createInstalmentPlanSchema(object);
+	const flexibleBalance = createFlexibleBalanceSchemas(object);
+	const paymentCollectionOption = z.discriminatedUnion("kind", [
+		object({ kind: z.literal("upfront") }),
+		object({ kind: z.literal("deferred_manual") }),
+		object({
+			kind: z.literal("instalment_plan"),
+			plan: instalmentPlan
+		}),
+		object({
+			kind: z.literal("flexible_balance"),
+			config: flexibleBalance.config
+		})
+	]);
+	const paymentTerms = object({ allowedOptions: z.array(paymentCollectionOption) }).superRefine(({ allowedOptions }, ctx) => {
+		const result = validateBookingPaymentOptionKinds(allowedOptions.map(({ kind }) => kind));
+		if (!result.ok) ctx.addIssue({
+			code: "custom",
+			path: ["allowedOptions"],
+			message: paymentOptionKindsMessages[result.error]
+		});
+	});
+	const paymentOptionsChoice = z.discriminatedUnion("source", [z.strictObject({ source: z.literal("default") }), z.strictObject({
+		source: z.literal("custom"),
+		paymentTerms
+	})]);
+	return {
+		depositRefundPolicy: depositRefundPolicySchema,
+		instalmentPlan,
+		flexibleBalanceDueDateRule: flexibleBalance.dueDateRule,
+		flexibleBalanceConfig: flexibleBalance.config,
+		paymentCollectionOption,
+		paymentTerms,
+		paymentOptionsChoice
+	};
+}
+function createBookingPaymentOptionSchemas(mode) {
+	return mode === "strict" ? buildBookingPaymentOptionSchemas(strictObject) : buildBookingPaymentOptionSchemas(stripObject);
+}
+const bookingPaymentOptionSchemas = createBookingPaymentOptionSchemas("strip");
+bookingPaymentOptionSchemas.depositRefundPolicy;
+bookingPaymentOptionSchemas.instalmentPlan;
+bookingPaymentOptionSchemas.flexibleBalanceDueDateRule;
+bookingPaymentOptionSchemas.flexibleBalanceConfig;
+bookingPaymentOptionSchemas.paymentCollectionOption;
+const bookingPaymentTermsSchema = bookingPaymentOptionSchemas.paymentTerms;
+bookingPaymentOptionSchemas.paymentOptionsChoice;
+//#endregion
+//#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
+const blockBookingPaymentTermsSchema = bookingPaymentTermsSchema;
 //#endregion
 //#region ../blocks/src/system/blocks/shared/bookingConsent.ts
 const blockBookingConsentSchema = z.object({
@@ -22663,7 +22757,7 @@ const publicPassProductCollectionSchema = z.object({ passes: z.array(publicPassP
 /**
 * Public membership product for shop display
 */
-const publicMembershipProductSchema = z.object({
+const publicMembershipProductFields = {
 	id: z.string(),
 	name: z.string(),
 	description: z.string().nullable(),
@@ -22672,7 +22766,16 @@ const publicMembershipProductSchema = z.object({
 	billingInterval: z.enum(["month", "year"]),
 	eligibleCategoryIds: z.array(z.string()),
 	eligibleCategoryNames: z.array(z.string())
+};
+const purchasablePublicMembershipProductSchema = z.object({
+	...publicMembershipProductFields,
+	purchaseAvailability: z.literal("purchasable")
 });
+const publicMembershipProductSchema = z.discriminatedUnion("purchaseAvailability", [purchasablePublicMembershipProductSchema, z.object({
+	...publicMembershipProductFields,
+	purchaseAvailability: z.literal("display_only"),
+	unavailabilityReason: z.literal("online_payments_unavailable")
+})]);
 const publicMembershipProductCollectionSchema = z.object({ memberships: z.array(publicMembershipProductSchema) });
 //#endregion
 //#region ../blocks/src/system/blocks/event-registration.shared.ts
@@ -22872,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
@@ -22998,6 +23105,7 @@ const EVENT_REGISTRATION_SHELL_STEP_LABELS = [
 	"Date",
 	"Tickets",
 	"Details",
+	"Payment options",
 	"Payment"
 ];
 const eventRegistrationPublicEventSchema = z.preprocess(normalizeEventRegistrationEventInput, publicEventSchema);
@@ -23140,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":
@@ -23157,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.";
 }
@@ -25107,7 +25216,8 @@ const eventCalendarLayout = [styledSection({
 				fallback: false
 			} },
 			banded: { $bind: {
-				from: "content.banded",
+				from: "content",
+				transforms: [{ id: "events.calendarBanded" }],
 				fallback: false
 			} }
 		}))]
@@ -28442,7 +28552,7 @@ function buildPassesMembershipsDisplay(options) {
 				product: pass
 			} : {
 				kind: "unavailable",
-				label: "Online purchasing coming soon."
+				label: "Online purchasing is unavailable."
 			}
 		};
 	});
@@ -28452,7 +28562,14 @@ function buildPassesMembershipsDisplay(options) {
 		description: options.showDescriptions ? membership.description : null,
 		priceLabel: formatCommercePrice(membership.price, membership.currency),
 		intervalLabel: formatInterval(membership.billingInterval),
-		actionLabel: options.membershipActionLabel
+		action: membership.purchaseAvailability === "purchasable" ? {
+			kind: "purchase",
+			label: options.membershipActionLabel,
+			product: membership
+		} : {
+			kind: "unavailable",
+			label: "Online purchasing is unavailable."
+		}
 	}));
 	return {
 		kind: "passes-memberships",
@@ -28672,7 +28789,14 @@ const membershipCardDisplaySchema = z.object({
 	description: z.string().nullable(),
 	priceLabel: z.string(),
 	intervalLabel: z.string(),
-	actionLabel: z.string()
+	action: z.discriminatedUnion("kind", [z.object({
+		kind: z.literal("purchase"),
+		label: z.string(),
+		product: purchasablePublicMembershipProductSchema
+	}), z.object({
+		kind: z.literal("unavailable"),
+		label: z.string()
+	})])
 });
 const passesMembershipsDisplaySchema = z.object({
 	kind: z.literal("passes-memberships"),
@@ -31310,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.148.0";
+const SDK_VERSION = "0.150.0";
 //#endregion
 //#region src/constants.ts
 /**