@riverbankcms/sdk 0.148.0 → 0.150.0

package/dist/server/config-validation.mjs

@@ -1984,6 +1984,16 @@ function isRecord$11(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();
@@ -4041,7 +4051,8 @@ const CLIENT_ERROR_REPORT_LIMITS = {
 	stack: 8e3,
 	digest: 128,
 	componentStack: 8e3,
-	sourceLocation: 1024
+	sourceLocation: 1024,
+	navigationAgeMs: 6e4
 };
 const clientErrorEventSchema = z.enum([
 	"dashboard:route-error",
@@ -4058,7 +4069,17 @@ z.object({
 	stack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.stack).nullable(),
 	digest: z.string().max(CLIENT_ERROR_REPORT_LIMITS.digest).nullable(),
 	componentStack: z.string().max(CLIENT_ERROR_REPORT_LIMITS.componentStack).nullable(),
-	sourceLocation: z.string().max(CLIENT_ERROR_REPORT_LIMITS.sourceLocation).nullable()
+	sourceLocation: z.string().max(CLIENT_ERROR_REPORT_LIMITS.sourceLocation).nullable(),
+	navigation: z.object({
+		fromPathname: z.string().regex(/^\/[^?#]*$/).max(CLIENT_ERROR_REPORT_LIMITS.pathname),
+		toPathname: z.string().regex(/^\/[^?#]*$/).max(CLIENT_ERROR_REPORT_LIMITS.pathname),
+		type: z.enum([
+			"push",
+			"replace",
+			"traverse"
+		]),
+		ageMs: z.number().int().min(0).max(CLIENT_ERROR_REPORT_LIMITS.navigationAgeMs)
+	}).strict().nullable().optional()
 }).strict();
 ({
 	...SITE_LIFECYCLE_ENDPOINT_DEFINITIONS,
@@ -4727,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
@@ -7335,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.
 *
@@ -7962,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 {
@@ -10961,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 {
@@ -11045,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"],
@@ -11057,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 = [
@@ -11335,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"),
@@ -12138,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",
@@ -12522,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",
@@ -12543,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",
@@ -12652,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",
@@ -16143,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"
@@ -16789,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",
@@ -18596,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",
@@ -20458,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;
 }
@@ -27154,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",
@@ -27183,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"));
@@ -29121,68 +29184,115 @@ const RichTextDocSchema = z.object({
 	content: z.array(TipTapNodeSchema)
 }).strict();
 //#endregion
-//#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
-const bookingDepositRefundPolicySchema$1 = z.enum(["refundable", "non_refundable"]);
-const bookingInstalmentPlanSchema$1 = z.union([
-	z.object({
-		kind: z.literal("deposit_plus_one_remainder"),
-		depositAmountCents: z.number().int().min(0),
-		depositRefundability: bookingDepositRefundPolicySchema$1,
-		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$1,
-		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$1 = 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$1 = z.object({
-	upfrontAmountCents: z.number().int().min(0),
-	dueDateRule: bookingFlexibleBalanceDueDateRuleSchema$1,
-	depositRefundability: bookingDepositRefundPolicySchema$1
-});
-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$1
-	}),
-	z.object({
-		kind: z.literal("flexible_balance"),
-		config: bookingFlexibleBalanceConfigSchema$1
-	})
-]);
-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({
@@ -29784,7 +29894,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(),
@@ -29793,7 +29903,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
@@ -29993,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
@@ -30119,6 +30242,7 @@ const EVENT_REGISTRATION_SHELL_STEP_LABELS = [
 	"Date",
 	"Tickets",
 	"Details",
+	"Payment options",
 	"Payment"
 ];
 const eventRegistrationPublicEventSchema = z.preprocess(normalizeEventRegistrationEventInput, publicEventSchema);
@@ -30261,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":
@@ -30278,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.";
 }
@@ -32253,7 +32378,8 @@ const eventCalendarLayout = [styledSection({
 				fallback: false
 			} },
 			banded: { $bind: {
-				from: "content.banded",
+				from: "content",
+				transforms: [{ id: "events.calendarBanded" }],
 				fallback: false
 			} }
 		}))]
@@ -35526,7 +35652,7 @@ function buildPassesMembershipsDisplay(options) {
 				product: pass
 			} : {
 				kind: "unavailable",
-				label: "Online purchasing coming soon."
+				label: "Online purchasing is unavailable."
 			}
 		};
 	});
@@ -35536,7 +35662,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",
@@ -35756,7 +35889,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"),
@@ -38394,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,
@@ -39447,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,
@@ -40103,6 +40253,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 	"refund_failed"
 ];
 const CANONICAL_ADMIN_REFUND_FAILURE_CODES = [
+	"refund_blocked_by_live_payment_terms",
 	...CANONICAL_REFUND_PLANNER_ERROR_CODES,
 	"payment_intent_not_found",
 	"stripe_error",
@@ -40118,6 +40269,7 @@ const CANONICAL_ADMIN_REFUND_FAILURE_CODES = [
 //#endregion
 //#region ../api/src/bookingRefundOutcomes.ts
 const STANDARD_LINE_ITEM_REFUND_INVALID_CODES = [
+	"refund_blocked_by_live_payment_terms",
 	"missing_amount",
 	"invalid_amount",
 	"amount_exceeds_remaining",
@@ -40480,68 +40632,6 @@ function collectText(node) {
 }
 z.enum(["public", "unlisted"], { error: "visibility must be 'public' or 'unlisted'" });
 //#endregion
-//#region ../api/src/bookingPaymentTermSchemas.ts
-const bookingDepositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);
-const bookingInstalmentPlanSchema = z.discriminatedUnion("kind", [
-	z.object({
-		kind: z.literal("deposit_plus_one_remainder"),
-		depositAmountCents: z.number().int().nonnegative(),
-		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().nonnegative(),
-		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"
-		])
-	})
-]);
-const bookingFlexibleBalanceDueDateRuleSchema = z.discriminatedUnion("kind", [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().nonnegative(),
-	dueDateRule: bookingFlexibleBalanceDueDateRuleSchema,
-	depositRefundability: bookingDepositRefundPolicySchema
-});
-z.discriminatedUnion("kind", [
-	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
-	})
-]);
-//#endregion
 //#region ../api/src/navigationMenuValidation.ts
 function hasChildren(item) {
 	return Array.isArray(item.children) && item.children.length > 0;