riverbankcms 0.22.2 → 0.23.0

package/dist/{sdk-event-upsert-zWw5VolM.mjs → sdk-event-upsert-BnBxyTR6.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $t as assertNever, An as unsafeAsPositiveSeconds, B as parseWeeklyOpeningHours, Bn as unsafeAsUploadSessionId, C as stableJsonStringify, Dn as unsafeAsOriginalFilename, Fn as unsafeAsSiteId, H as isPresent, Hn as err, Ht as mapNonEmptyArray, In as unsafeAsSiteScopedStoragePath, L as isCanonicalRichTextDoc, M as parseFooterCompositionV1, Mn as unsafeAsProductId, N as footerNavigationLayouts, Nn as unsafeAsSafeDownloadFilename, Pn as unsafeAsSiteFontId, Rn as unsafeAsStorageBucketName, Tn as unsafeAsMediaAssetId, Un as ok, Ut as mapReadonlyNonEmptyArray, Vn as unsafeAsUserId, Vt as fromArray, _n as unsafeAsDeclaredMimeType, _t as validateBookingPaymentOptionKinds, bn as unsafeAsEntitlementId, c as resolveSiteVerticalBookingConfig, d as ORDINARY_EVENT_PRESET_VALUES, gt as parseBookingTimeZone, hn as unsafeAsBookingSessionId, kn as unsafeAsPositiveByteCount, mn as unsafeAsBookingRequirementId, on as parseMediaAssetId, r as NAVIGATION_LOCATIONS, st as localScheduleTimePattern, u as EVENT_PRESET_VALUES, un as parseSiteId, ut as parseUtcIsoDateTimeString, wn as unsafeAsFileChecksumSha256, yn as unsafeAsDetectedMimeType, z as parsePublicContactDetails, zn as unsafeAsStoragePath } from "./src-ZACBG29u.mjs";
+import { An as unsafeAsPositiveByteCount, B as parsePublicContactDetails, Bn as unsafeAsStoragePath, En as unsafeAsMediaAssetId, Fn as unsafeAsSiteFontId, G as isPresent, Hn as unsafeAsUserId, Ht as fromArray, In as unsafeAsSiteId, Ln as unsafeAsSiteScopedStoragePath, N as parseFooterCompositionV1, Nn as unsafeAsProductId, On as unsafeAsOriginalFilename, P as footerNavigationLayouts, Pn as unsafeAsSafeDownloadFilename, R as isCanonicalRichTextDoc, Tn as unsafeAsFileChecksumSha256, Un as err, Ut as mapNonEmptyArray, V as parseWeeklyOpeningHours, Vn as unsafeAsUploadSessionId, Wn as ok, Wt as mapReadonlyNonEmptyArray, _t as parseBookingTimeZone, bn as unsafeAsDetectedMimeType, ct as localScheduleTimePattern, d as EVENT_PRESET_VALUES, dn as parseSiteId, dt as parseUtcIsoDateTimeString, en as assertNever, f as ORDINARY_EVENT_PRESET_VALUES, gn as unsafeAsBookingSessionId, hn as unsafeAsBookingRequirementId, i as NAVIGATION_LOCATIONS, jn as unsafeAsPositiveSeconds, l as resolveSiteVerticalBookingConfig, sn as parseMediaAssetId, t as authoredValuesEqual, vn as unsafeAsDeclaredMimeType, vt as validateBookingPaymentOptionKinds, w as stableJsonStringify, xn as unsafeAsEntitlementId, zn as unsafeAsStorageBucketName } from "./src-BPh_OivC.mjs";
 import "node:module";
 import { z } from "zod";
 
@@ -30,6 +30,21 @@ var __toESM = (mod$1, isNodeMode, target) => (target = mod$1 != null ? __create(
 	enumerable: true
 }) : target, mod$1));
 
+//#endregion
+//#region ../theme-core/src/site-styles/ownedThemeSnapshot.ts
+/** Copy before freezing: the editor still owns its source data. */
+function ownedThemeSnapshot(input) {
+	return freezeOwnedThemeValue(structuredClone(input));
+}
+/** Only freshly owned data belongs here; no caller-owned object is frozen. */
+function freezeOwnedThemeValue(value) {
+	if (typeof value === "object" && value !== null) {
+		Object.values(value).forEach(freezeOwnedThemeValue);
+		Object.freeze(value);
+	}
+	return value;
+}
+
 //#endregion
 //#region ../theme-core/src/palette/utils/colorConversion.ts
 const clamp01$2 = (x) => Math.max(0, Math.min(1, x));
@@ -593,11 +608,33 @@ function relativeLuminance(r, g, b) {
 	const R = srgbToLinear(r), G = srgbToLinear(g), B = srgbToLinear(b);
 	return .2126 * R + .7152 * G + .0722 * B;
 }
-function contrastRatio(hex1, hex2) {
-	const { r: r1, g: g1, b: b1 } = hexToRgb(hex1);
-	const { r: r2, g: g2, b: b2 } = hexToRgb(hex2);
-	const L1 = relativeLuminance(r1, g1, b1);
-	const L2 = relativeLuminance(r2, g2, b2);
+function preparePaletteColourIndex(palette) {
+	const colours = [...new Set([
+		...Object.values(palette),
+		"#000000",
+		"#ffffff",
+		"#FFFFFF"
+	])];
+	return Object.freeze(Object.fromEntries(colours.flatMap(colourIndexEntry)));
+}
+/** An unused unsupported colour must not turn preparation into an eager validation failure. */
+function colourIndexEntry(hex) {
+	try {
+		return [[hex, colourLuminance(hex)]];
+	} catch {
+		return [];
+	}
+}
+function colourLuminance(hex) {
+	const { r, g, b } = hexToRgb(hex);
+	return relativeLuminance(r, g, b);
+}
+function indexedLuminance(hex, index) {
+	return (index && Object.prototype.hasOwnProperty.call(index, hex) ? index[hex] : undefined) ?? colourLuminance(hex);
+}
+function contrastRatio(hex1, hex2, index) {
+	const L1 = indexedLuminance(hex1, index);
+	const L2 = indexedLuminance(hex2, index);
 	const [hi, lo] = L1 >= L2 ? [L1, L2] : [L2, L1];
 	return (hi + .05) / (lo + .05);
 }
@@ -1719,6 +1756,7 @@ function defineButtonStyleRecipe(recipe) {
 }
 function mapButtonVisualAppearances(states$1, transform) {
 	return {
+		...states$1,
 		base: transform(states$1.base, "base"),
 		hover: transform(states$1.hover, "hover"),
 		focus: transform(states$1.focus, "focus"),
@@ -2593,7 +2631,7 @@ function formatButtonColourContractError(error) {
 	}
 }
 function validateButtonSurfaceContrast(input) {
-	const ratio$1 = contrastRatio(input.buttonPaint, input.surfaceHex);
+	const ratio$1 = contrastRatio(input.buttonPaint, input.surfaceHex, input.colourIndex);
 	return ratio$1 >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio ? { ok: true } : {
 		ok: false,
 		error: {
@@ -2608,7 +2646,7 @@ function validateButtonSurfaceContrast(input) {
 	};
 }
 function validateButtonTextContrast(input) {
-	const ratio$1 = contrastRatio(input.backgroundHex, input.foregroundHex);
+	const ratio$1 = contrastRatio(input.backgroundHex, input.foregroundHex, input.colourIndex);
 	return ratio$1 >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
 		ok: false,
 		error: {
@@ -2631,7 +2669,7 @@ function solidForegroundToken(backgroundToken$1) {
 //#region ../theme-core/src/buttons/contextualHover.ts
 function resolveContextualHoverPreference(input) {
 	const preferred = input.instruction.preferredToken;
-	if (preferred && isSafeCandidate(preferred, input.palette, input.surface)) {
+	if (preferred && isSafeCandidate(preferred, input.palette, input.surface, input.colourIndex)) {
 		return {
 			kind: "resolved",
 			token: preferred,
@@ -2663,7 +2701,7 @@ function resolveContextualHover(input) {
 			reason: "no-distinct-shade"
 		};
 	}
-	const textSafe = candidates.filter((candidate$1) => hasSafeTextContrast(candidate$1.token, input.palette));
+	const textSafe = candidates.filter((candidate$1) => hasSafeTextContrast(candidate$1.token, input.palette, input.colourIndex));
 	if (textSafe.length === 0) {
 		return {
 			kind: "unavailable",
@@ -2682,18 +2720,12 @@ function resolveContextualHover(input) {
 			reason: "no-text-safe-candidate"
 		};
 	}
-	const surfaceSafe = textSafe.map((candidate$1) => ({
-		...candidate$1,
-		surfaceContrast: contrastRatio(input.palette[candidate$1.token] ?? "", input.surface?.backgroundHex ?? "")
-	})).filter((candidate$1) => candidate$1.surfaceContrast !== null && candidate$1.surfaceContrast >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio).sort((left, right) => {
-		const distanceDifference = left.distance - right.distance;
-		if (distanceDifference !== 0) return distanceDifference;
-		const contrastDifference = (right.surfaceContrast ?? 0) - (left.surfaceContrast ?? 0);
-		if (contrastDifference !== 0) return contrastDifference;
-		if (left.direction === right.direction) return left.token.localeCompare(right.token);
-		return left.direction === input.instruction.fallbackDirection ? -1 : 1;
+	const selected = selectSurfaceSafeHover(textSafe, {
+		palette: input.palette,
+		surface: input.surface,
+		colourIndex: input.colourIndex,
+		fallbackDirection: input.instruction.fallbackDirection
 	});
-	const selected = surfaceSafe[0];
 	return selected ? {
 		kind: "resolved",
 		token: selected.token,
@@ -2704,6 +2736,21 @@ function resolveContextualHover(input) {
 		reason: "no-surface-safe-candidate"
 	};
 }
+/** Rank the proven-surface candidates without mixing selection with fallback policy. */
+function selectSurfaceSafeHover(candidates, input) {
+	const surfaceSafe = candidates.map((candidate$1) => ({
+		...candidate$1,
+		surfaceContrast: contrastRatio(input.palette[candidate$1.token] ?? "", input.surface.backgroundHex, input.colourIndex)
+	})).filter((candidate$1) => candidate$1.surfaceContrast !== null && candidate$1.surfaceContrast >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio).sort((left, right) => {
+		const distanceDifference = left.distance - right.distance;
+		if (distanceDifference !== 0) return distanceDifference;
+		const contrastDifference = (right.surfaceContrast ?? 0) - (left.surfaceContrast ?? 0);
+		if (contrastDifference !== 0) return contrastDifference;
+		if (left.direction === right.direction) return left.token.localeCompare(right.token);
+		return left.direction === input.fallbackDirection ? -1 : 1;
+	});
+	return surfaceSafe[0];
+}
 function shadeCandidates(seedToken, palette) {
 	const match = String(seedToken).match(/^(.*?)(?:-(\d{2,3}))?$/);
 	const family = match?.[1] ?? String(seedToken);
@@ -2729,14 +2776,14 @@ function candidate(family, shade, currentShade, direction, seedHex, palette) {
 		surfaceContrast: null
 	};
 }
-function hasSafeTextContrast(token, palette) {
+function hasSafeTextContrast(token, palette, colourIndex) {
 	const background = palette[token];
 	const foreground = palette[solidForegroundToken(token)];
-	return typeof background === "string" && typeof foreground === "string" && contrastRatio(background, foreground) >= BUTTON_CONTRAST_POLICY.textMinimumRatio;
+	return typeof background === "string" && typeof foreground === "string" && contrastRatio(background, foreground, colourIndex) >= BUTTON_CONTRAST_POLICY.textMinimumRatio;
 }
-function isSafeCandidate(token, palette, surface$1) {
-	if (!hasSafeTextContrast(token, palette)) return false;
-	return surface$1 ? contrastRatio(palette[token] ?? "", surface$1.backgroundHex) >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio : true;
+function isSafeCandidate(token, palette, surface$1, colourIndex) {
+	if (!hasSafeTextContrast(token, palette, colourIndex)) return false;
+	return surface$1 ? contrastRatio(palette[token] ?? "", surface$1.backgroundHex, colourIndex) >= BUTTON_CONTRAST_POLICY.nonTextMinimumRatio : true;
 }
 function escapeRegExp(value) {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -2749,6 +2796,7 @@ function resolveButtonHoverTreatment(input) {
 		const contextual = resolveContextualHoverPreference({
 			instruction: input.variant.contextualHover,
 			palette: input.palette,
+			colourIndex: input.colourIndex,
 			surface: input.surface
 		});
 		if (contextual.kind === "resolved") {
@@ -2803,7 +2851,8 @@ function compileButtonColourStates(input) {
 		global: input.global,
 		fallback: base.treatment,
 		palette: input.palette,
-		surface: input.surface
+		surface: input.surface,
+		colourIndex: input.colourIndex
 	});
 	const edge = buttonEdge(input.variant);
 	const results = mapVisualStates((state) => compileVisualState(input, state, state === "hover" ? hover.treatment : base.treatment, edge, base.nonColourEffects));
@@ -2863,6 +2912,7 @@ function compileDeclaredVisualState(input, states$1, state, treatment) {
 		treatment: transition.treatment,
 		palette: input.palette,
 		surface: input.surface,
+		colourIndex: input.colourIndex,
 		edge
 	});
 	return resolved.ok ? {
@@ -2890,6 +2940,7 @@ function compileVisualState(input, state, treatment, edge, baseEffects) {
 		treatment: transition.treatment,
 		palette: input.palette,
 		surface: input.surface,
+		colourIndex: input.colourIndex,
 		edge
 	});
 	return resolved.ok ? {
@@ -3113,11 +3164,11 @@ function interpolateHex(startHex, endHex, position) {
 * Derive only what the rendered section can honestly prove about its backing.
 * Images, gradients, alpha/composite layers and arbitrary CSS remain unknown.
 */
-function deriveButtonSurfaceContext(input, palette, fallbackToken) {
+function deriveButtonSurfaceContext(input, palette, fallbackToken, colourIndex) {
 	const background = deriveKnownBackground(input, palette, fallbackToken);
 	if (background.kind === "unknown") return background;
 	const explicitForeground = resolveKnownColour(input.kind === "solid" || input.kind === "inherit" ? input.foreground ?? "" : "", palette);
-	const foreground = explicitForeground && contrastRatio(background.colour.hex, explicitForeground.hex) >= ORDINARY_TEXT_MIN_CONTRAST_RATIO ? explicitForeground : safestBlackOrWhite(background.colour.hex);
+	const foreground = explicitForeground && contrastRatio(background.colour.hex, explicitForeground.hex, colourIndex) >= ORDINARY_TEXT_MIN_CONTRAST_RATIO ? explicitForeground : safestBlackOrWhite(background.colour.hex, colourIndex);
 	return {
 		kind: "known-solid",
 		source: background.source,
@@ -3202,7 +3253,7 @@ function resolveSurfaceButtonContext(input) {
 		kind: "inherit",
 		styles: {}
 	};
-	const context = deriveButtonSurfaceContext(input.surface, input.palette, input.fallbackToken);
+	const context = deriveButtonSurfaceContext(input.surface, input.palette, input.fallbackToken, input.colourIndex);
 	if (context.kind !== "known-solid") {
 		return context.reason === "missing-background" ? {
 			kind: "inherit",
@@ -3217,6 +3268,7 @@ function resolveSurfaceButtonContext(input) {
 		styles: knownSurfaceButtonContextStyles({
 			surface: context.surface,
 			palette: input.palette,
+			colourIndex: input.colourIndex,
 			buttonSystem: surfaceButtonSystem(input.buttonSystem, input.primaryToken)
 		})
 	};
@@ -3227,6 +3279,7 @@ function knownSurfaceButtonContextStyles(input) {
 		role,
 		buttonSystem: input.buttonSystem,
 		palette: input.palette,
+		colourIndex: input.colourIndex,
 		surface: input.surface
 	})))));
 }
@@ -3237,59 +3290,54 @@ function resolveContextualButtonRole(input) {
 		requestedRole: input.role,
 		rejectedCandidates: []
 	};
-	const rejected$1 = [];
-	const preferred = compileCandidate(requested, input.buttonSystem, input.palette, input.surface);
-	if (preferred.ok) {
-		if (preferred.contextualHoverRepair) {
-			return {
-				kind: "repaired",
-				requestedRole: input.role,
-				candidate: "contextual-hover",
-				states: preferred.states,
-				focusIndicator: preferred.focusIndicator,
-				boundary: boundaryForVariant(requested),
-				rejectedCandidates: []
-			};
-		}
-		return {
-			kind: "preferred",
-			requestedRole: input.role,
-			states: preferred.states,
-			focusIndicator: preferred.focusIndicator,
-			boundary: boundaryForVariant(requested)
-		};
-	}
-	rejected$1.push({
+	const preferred = compileCandidate(requested, input);
+	if (preferred.ok) return preferredButtonResolution(requested, preferred, input.role);
+	const policy = input.buttonSystem.surfacePolicy ?? STANDARD_BUTTON_SURFACE_POLICY;
+	return resolveFallbackButtonRole(input, requested, policy[input.role], [{
 		candidate: "preferred",
 		error: preferred.error
-	});
-	const policy = input.buttonSystem.surfacePolicy ?? STANDARD_BUTTON_SURFACE_POLICY;
-	for (const fallback of policy[input.role]) {
-		const candidate$1 = candidateVariant(fallback, requested, input.buttonSystem);
-		if (!candidate$1) continue;
-		const compiled = compileCandidate(candidate$1.variant, input.buttonSystem, input.palette, input.surface);
-		if (!compiled.ok) {
-			rejected$1.push({
-				candidate: candidate$1.name,
-				error: compiled.error
-			});
-			continue;
-		}
-		return {
-			kind: "repaired",
-			requestedRole: input.role,
-			candidate: candidate$1.name,
-			states: candidate$1.name === "surface-outline" ? withSurfaceInversion(compiled.states, input.surface) : compiled.states,
-			focusIndicator: compiled.focusIndicator,
-			boundary: candidate$1.boundary,
-			rejectedCandidates: rejected$1
-		};
-	}
-	return {
+	}]);
+}
+function preferredButtonResolution(requested, compiled, role) {
+	const appearance = {
+		requestedRole: role,
+		states: compiled.states,
+		focusIndicator: compiled.focusIndicator,
+		boundary: boundaryForVariant(requested)
+	};
+	return compiled.contextualHoverRepair ? {
+		...appearance,
+		kind: "repaired",
+		candidate: "contextual-hover",
+		rejectedCandidates: []
+	} : {
+		...appearance,
+		kind: "preferred"
+	};
+}
+/** Ordered, lazy fallback selection; the rejected evidence belongs to this decision. */
+function resolveFallbackButtonRole(input, requested, fallbacks, rejected$1) {
+	const [fallback, ...remaining] = fallbacks;
+	if (!fallback) return {
 		kind: "unresolved",
 		requestedRole: input.role,
 		rejectedCandidates: rejected$1
 	};
+	const candidate$1 = candidateVariant(fallback, requested, input.buttonSystem);
+	if (!candidate$1) return resolveFallbackButtonRole(input, requested, remaining, rejected$1);
+	const compiled = compileCandidate(candidate$1.variant, input);
+	return compiled.ok ? {
+		kind: "repaired",
+		requestedRole: input.role,
+		candidate: candidate$1.name,
+		states: candidate$1.name === "surface-outline" ? withSurfaceInversion(compiled.states, input.surface) : compiled.states,
+		focusIndicator: compiled.focusIndicator,
+		boundary: candidate$1.boundary,
+		rejectedCandidates: rejected$1
+	} : resolveFallbackButtonRole(input, requested, remaining, [...rejected$1, {
+		candidate: candidate$1.name,
+		error: compiled.error
+	}]);
 }
 function contextualButtonSurfaceStyles(resolution) {
 	if (resolution.kind === "unresolved") {
@@ -3362,12 +3410,13 @@ function actionVariableFallback(role, state, property, fallback) {
 function actionVariablePrefix(role, state) {
 	return `--rb-action-${role}-${state}`;
 }
-function compileCandidate(variant, system, palette, surface$1) {
+function compileCandidate(variant, context) {
 	return compileButtonColourStates({
 		variant,
-		global: system.global,
-		palette,
-		surface: surface$1
+		global: context.buttonSystem.global,
+		palette: context.palette,
+		surface: context.surface,
+		colourIndex: context.colourIndex
 	});
 }
 function candidateVariant(fallback, requested, system) {
@@ -3491,8 +3540,8 @@ function normalizeOpaqueHex(value) {
 	const digits = match[1].length === 3 ? match[1].split("").map((digit) => `${digit}${digit}`).join("") : match[1];
 	return `#${digits.toLowerCase()}`;
 }
-function safestBlackOrWhite(backgroundHex) {
-	return contrastRatio(backgroundHex, "#000000") >= contrastRatio(backgroundHex, "#ffffff") ? {
+function safestBlackOrWhite(backgroundHex, colourIndex) {
+	return contrastRatio(backgroundHex, "#000000", colourIndex) >= contrastRatio(backgroundHex, "#ffffff", colourIndex) ? {
 		hex: "#000000",
 		css: "#000000",
 		source: "literal-css"
@@ -3519,8 +3568,10 @@ function contextualBoundaryStyles(boundary) {
 //#endregion
 //#region ../theme-core/src/surfaces/opaqueSurface.ts
 function opaqueSurfaceContextFromTheme(theme) {
+	const palette = expandPalette(theme.palette);
 	return {
-		palette: expandPalette(theme.palette),
+		palette,
+		colourIndex: preparePaletteColourIndex(palette),
 		buttonSystem: theme.buttons,
 		linkHoverToken: theme.typography.proseLinkStyle?.hoverColorToken
 	};
@@ -4451,8 +4502,82 @@ function assertNeverSurface(value) {
 	throw new Error(`Unhandled Theme V2 surface intent: ${String(value)}`);
 }
 function resolveSurface(spec, context) {
+	return spec.kind === "section" ? resolveSectionSurface(spec.background, context) : preparedSurfaceValue(spec, context) ?? resolveSurfaceSpec(spec, context);
+}
+/** Own one theme revision; derive its surface decisions without copying its inputs again. */
+function prepareThemeSurfaceRevision(inputTheme, selectSurfaces = () => []) {
+	const theme = structuredClone(inputTheme);
+	const snapshot = freezeOwnedThemeValue(theme);
+	const declarations = ownedThemeSnapshot(selectSurfaces(snapshot));
+	const palette = freezeOwnedThemeValue(expandPalette(snapshot.palette, {
+		arrangement: snapshot.skin !== undefined,
+		marksFrom: snapshot.skinMarks
+	}));
+	const context = Object.freeze({
+		kind: "concrete-palette",
+		palette,
+		colourIndex: preparePaletteColourIndex(palette),
+		buttonSystem: snapshot.buttons
+	});
+	const preparedSurfaces = declarations.length === 0 ? undefined : surfaceIndexFromOwnedInputs(declarations, context);
+	return Object.freeze({
+		theme,
+		context: Object.freeze({
+			...context,
+			preparedSurfaces
+		})
+	});
+}
+function prepareSurfaceIndex(specs, context) {
+	const snapshot = ownedThemeSnapshot({
+		palette: context.palette,
+		buttonSystem: context.buttonSystem,
+		colourIndex: context.colourIndex,
+		linkHoverToken: context.linkHoverToken,
+		foreground: context.foreground,
+		compositeBase: context.compositeBase,
+		buttonContext: context.buttonContext
+	});
+	return surfaceIndexFromOwnedInputs(ownedThemeSnapshot(specs), snapshot);
+}
+/** Private construction path: both entry points above own and freeze these inputs. */
+function surfaceIndexFromOwnedInputs(specs, context) {
+	const unique = new Map(specs.map((spec) => [surfaceResolutionKey(spec, context), spec]));
+	const entries = [...unique].flatMap(([key, spec]) => preparedSurfaceEntry(key, spec, context));
+	return Object.freeze({
+		palette: context.palette,
+		buttonSystem: context.buttonSystem,
+		colourIndex: context.colourIndex,
+		values: freezeOwnedThemeValue(Object.fromEntries(entries))
+	});
+}
+function preparedSurfaceEntry(key, spec, context) {
+	try {
+		return [[key, resolveSurfaceSpec(spec, context)]];
+	} catch {
+		return [];
+	}
+}
+function preparedSurfaceValue(spec, context) {
+	const index = context.preparedSurfaces;
+	if (!index || index.palette !== context.palette || index.buttonSystem !== context.buttonSystem || index.colourIndex !== context.colourIndex) return undefined;
+	return index.values[surfaceResolutionKey(spec, context)];
+}
+function surfaceResolutionKey(spec, context) {
+	const declaration = spec.kind === "tint" ? {
+		...spec,
+		opacity: String(spec.opacity)
+	} : spec;
+	return JSON.stringify([
+		declaration,
+		context.linkHoverToken,
+		context.foreground,
+		context.compositeBase,
+		context.buttonContext
+	]);
+}
+function resolveSurfaceSpec(spec, context) {
 	switch (spec.kind) {
-		case "section": return resolveSectionSurface(spec.background, context);
 		case "recipe": return resolveRecipeSurface(spec.intent, context);
 		case "paint": return spec.paint.kind === "transparent" ? { kind: "inherit" } : resolveOwnedSurface(spec.paint, context);
 		case "token": return resolveOwnedSurface({
@@ -4533,7 +4658,7 @@ function resolveOwnedSurface(paint, context) {
 		decorations: surfaceDecorationColors(resolved, context.palette),
 		hoverDecoration: resolved.kind === "known" ? resolved.hoverDecoration : "underline",
 		buttonContext: resolveSurfaceButtons(paint, resolved, context),
-		contrast: surfaceContrast(resolved, context.palette)
+		contrast: surfaceContrast(resolved, context.palette, context.colourIndex)
 	};
 }
 /** Unprovable legacy paint retains its declared foreground instead of inventing one. */
@@ -4558,15 +4683,16 @@ function resolveSurfaceButtons(paint, foreground, context) {
 			foreground: foreground.kind === "known" ? foreground.roles.link : undefined
 		} : { kind: "gradient" },
 		palette: context.palette,
+		colourIndex: context.colourIndex,
 		buttonSystem: context.buttonSystem,
 		primaryToken: context.buttonContext?.primary ?? (paint.kind === "solid" ? context.buttonSystem?.surfaceContexts?.[paint.token]?.primary : undefined),
 		withoutButtonSystem: "reset"
 	});
 }
-function surfaceContrast(foreground, palette) {
+function surfaceContrast(foreground, palette, colourIndex) {
 	if (foreground.kind !== "known" || foreground.provenance.kind !== "measured") return { kind: "unmeasured" };
 	const backdrop = foreground.provenance.backdropHex;
-	const ratio$1 = (token) => contrastRatio(resolveConcreteColorHex(token, palette) ?? backdrop, backdrop);
+	const ratio$1 = (token) => contrastRatio(resolveConcreteColorHex(token, palette) ?? backdrop, backdrop, colourIndex);
 	const ratios = {
 		text: ratio$1(foreground.roles.text),
 		heading: ratio$1(foreground.roles.heading),
@@ -4598,6 +4724,7 @@ function resolveSectionSurface(background, context) {
 		buttonStyles: resolveSurfaceButtonContext({
 			surface: surface$1,
 			palette: context.palette,
+			colourIndex: context.colourIndex,
 			buttonSystem: context.buttonSystem,
 			primaryToken: sectionPrimaryButtonToken(background, context),
 			fallbackToken: context.compositeBase,
@@ -4617,10 +4744,11 @@ function surfaceDecorationColors(foreground, palette) {
 }
 /** Composite the declared palette tint before checking every foreground role. */
 function resolveTintSurface(spec, context) {
-	const base = resolveOwnedSurface({
-		kind: "solid",
+	const base = resolveSurface({
+		kind: "token",
 		token: spec.base
 	}, context);
+	if (base.kind !== "owned") throw new Error(`Cannot derive tint on ${spec.base}`);
 	const source = spec.source === "text" ? base.foreground.text : base.decorations?.mark;
 	const token = source ? resolveOpaqueSurfaceHex(`${source}/${spec.opacity}`, context.palette, spec.base) : null;
 	const hex = source ? resolveConcreteColorHex(source, context.palette) : null;
@@ -4971,7 +5099,7 @@ const lookKnobBlocks = {
 	smallCaption: "block.hero",
 	candleGlow: "block.hero",
 	columnGuides: "block.hero",
-	showPhotos: cardListFamilyBlocks,
+	showPhotos: cardListKnobBlocks,
 	cardMarker: cardListFamilyBlocks,
 	dates: "block.offerings-preview",
 	showCapacity: "block.event-calendar",
@@ -6086,7 +6214,7 @@ const blockAppearancePresets = [
 	}),
 	defineArrangementLook("event-calendar-ruled-rows", "event-calendar", "Ruled rows", "ledger", ["showCapacity"]),
 	defineArrangementLook("event-calendar-grouped-by-day", "event-calendar", "Grouped by day", "day-groups", ["showCapacity"], { styleFallback: [id$1("event-calendar-ruled-rows")] }),
-	defineArrangementLook("event-calendar-session-cards", "event-calendar", "Session cards", "grid", ["showCapacity"], {
+	defineArrangementLook("event-calendar-session-cards", "event-calendar", "Session cards", "grid", ["showCapacity", "showPhotos"], {
 		itemRoles: { items: "card" },
 		slotRoles: { date: "highlight" },
 		styleFallback: [id$1("event-calendar-ruled-rows")]
@@ -6095,6 +6223,22 @@ const blockAppearancePresets = [
 		itemRoles: { container: "card" },
 		styleFallback: [id$1("event-calendar-ruled-rows")]
 	}),
+	defineArrangementLook("events-spotlight", "event-calendar", "Event spotlight", "grid", ["showCapacity", "showPhotos"], {
+		itemRoles: { items: "card" },
+		slotRoles: { date: "highlight" },
+		styleFallback: [id$1("event-calendar-session-cards")]
+	}),
+	{
+		...defineArrangementLook("events-recurring-week", "event-calendar", "Weekly schedule", "ledger", []),
+		structure: {
+			kind: "arrangement",
+			byMode: { week: "ledger" },
+			knobs: [],
+			itemRoles: {},
+			whenMissing: [],
+			styleFallback: []
+		}
+	},
 	defineArrangementLook("hero-framed-title", "hero", "Title framed between two photos", "copy-over-gallery", ["titleSize", "smallCaption"], { styleFallback: [id$1("hero-copy-over-gallery")] }),
 	defineArrangementLook("testimonials-lead-quote", "testimonials", "Big quote with others beside", "lead-rest", ["quoteCount"], { knobDescriptions: { quoteCount: "Shows your chosen quotes: the first one large, the rest beside it." } }),
 	defineArrangementLook("testimonials-quote-cards", "testimonials", "Quote cards", "columns", ["quoteCount"], {
@@ -15242,13 +15386,13 @@ const pageDesignBlockLookPinSchema = z.object({
 	choice: pageDesignUserPinnedAppearanceChoiceSchema
 }).strict();
 const pageDesignBoundaryPinSchema = z.object({
-	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
+	boundaryId: z.string().min(1).startsWith("boundary:", { error: "DesignBoundaryId must start with \"boundary:\"." }).transform(asDesignBoundaryId),
 	previousBlockId: z.string().min(1).transform(asDesignBlockId),
 	nextBlockId: z.string().min(1).transform(asDesignBlockId),
 	choice: pageDesignUserPinnedBoundaryTreatmentChoiceSchema
 }).strict().superRefine(validateBoundaryPinIdMatchesBlocks);
 const legacyPageDesignBoundaryPinSchema = z.object({
-	boundaryId: z.string().min(1).transform(asDesignBoundaryId),
+	boundaryId: z.string().min(1).startsWith("boundary:", { error: "DesignBoundaryId must start with \"boundary:\"." }).transform(asDesignBoundaryId),
 	previousBlockId: z.string().min(1).transform(asDesignBlockId),
 	nextBlockId: z.string().min(1).transform(asDesignBlockId),
 	choice: pageDesignUserPinnedBoundaryChoiceSchema
@@ -15260,18 +15404,18 @@ const legacyPageDesignBoundaryPinSchema = z.object({
 */
 const pageDesignIntentV1Schema = z.object({
 	schemaVersion: z.literal(legacyPageDesignIntentSchemaVersion),
-	siteStyleId: z.string().min(1).transform(asSiteStyleId),
+	siteStyleId: z.string().min(1).startsWith("site-style:", { error: "SiteStyleId must start with \"site-style:\"." }).transform(asSiteStyleId),
 	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
 	blockLookPins: z.array(pageDesignBlockLookPinSchema),
 	boundaryPins: z.array(legacyPageDesignBoundaryPinSchema)
 }).strict().superRefine(validateUniquePageDesignPins);
-const pageDesignIntentV2Schema = z.object({
+const pageDesignDecisionsV2Schema = z.object({
 	schemaVersion: z.literal(pageDesignIntentSchemaVersion),
-	siteStyleId: z.string().min(1).transform(asSiteStyleId),
 	pageFlowPresetId: z.string().min(1).transform(asPageFlowPresetId),
 	blockLookPins: z.array(pageDesignBlockLookPinSchema),
 	boundaryPins: z.array(pageDesignBoundaryPinSchema)
 }).strict().superRefine(validateUniquePageDesignPins);
+const pageDesignIntentV2Schema = pageDesignDecisionsV2Schema.safeExtend({ siteStyleId: z.string().min(1).startsWith("site-style:", { error: "SiteStyleId must start with \"site-style:\"." }).transform(asSiteStyleId) });
 function parsePageDesignIntent(value, options = {}) {
 	if (isLegacyPageDesignIntentCandidate(value)) {
 		const legacyParsed = parseSchemaVersionedJson({
@@ -15806,6 +15950,15 @@ function followStyleFallback(look, options, catalogue, mode, chain, visited) {
 }
 /** Design-stage serialisable payload; content-dependent choices stay downstream. */
 function compileArrangementLookRuntime(input) {
+	const surfaceContext = {
+		palette: input.context.palette,
+		buttonSystem: input.context.buttonSystem,
+		colourIndex: input.context.colourIndex
+	};
+	const resolutionContext = {
+		...surfaceContext,
+		preparedSurfaces: input.context.preparedSurfaces
+	};
 	const available = input.looks.flatMap((look) => {
 		const offer = input.style.offers.find((candidate$1) => candidate$1.id === look.id);
 		if (!offer) return [];
@@ -15813,10 +15966,7 @@ function compileArrangementLookRuntime(input) {
 		const surfaceStyle = {
 			roleMap: offer.roleMap,
 			surfaces: input.style.surfaces,
-			context: {
-				palette: input.context.palette,
-				buttonSystem: input.context.buttonSystem
-			}
+			context: resolutionContext
 		};
 		const itemSurfaces = resolveLookSlotSurfaces(look, roles, {
 			card: resolveItemSurface("card", "light", surfaceStyle),
@@ -15839,10 +15989,7 @@ function compileArrangementLookRuntime(input) {
 	return {
 		available,
 		surfaces: input.style.surfaces,
-		surfaceContext: {
-			palette: input.context.palette,
-			buttonSystem: input.context.buttonSystem
-		},
+		surfaceContext,
 		byMode: Object.fromEntries(Object.entries(input.selected).flatMap(([mode, look]) => {
 			const compiled = available.find((candidate$1) => candidate$1.look.id === look.id);
 			return compiled ? [[mode, compiled]] : [];
@@ -15850,10 +15997,7 @@ function compileArrangementLookRuntime(input) {
 		rhythm: (input.style.rhythm?.[input.flowPreset] ?? []).flatMap((surfaceName) => {
 			const spec = input.style.surfaces[surfaceName];
 			if (!spec) throw new Error(`Undeclared rhythm surface ${surfaceName}`);
-			const surface$1 = resolveSurface(spec, {
-				palette: input.context.palette,
-				buttonSystem: input.context.buttonSystem
-			});
+			const surface$1 = resolveSurface(spec, resolutionContext);
 			return surface$1.kind === "owned" && surface$1.paint.kind === "solid" ? [{
 				type: "color",
 				color: surface$1.paint.token,
@@ -17493,7 +17637,7 @@ const gradientTextEffect = {
 	customizableOption: {
 		name: "solidOnHover",
 		type: "select",
-		label: "Hover Behavior",
+		label: "Hover behaviour",
 		default: "false",
 		options: ["false", "true"]
 	},
@@ -32779,19 +32923,21 @@ function stripCompiledRuntimeStyleFields(content) {
 	return Object.fromEntries(Object.entries(stripStaleTransitionStyleGroup(content)).filter(([fieldName]) => !compiledRuntimeStyleFieldNames.includes(fieldName)));
 }
 function surfaceResolutionContextFromPalette(palette) {
-	return {
+	const snapshot = ownedThemeSnapshot(palette);
+	return Object.freeze({
 		kind: "concrete-palette",
-		palette
-	};
+		palette: snapshot,
+		colourIndex: preparePaletteColourIndex(snapshot),
+		buttonSystem: undefined
+	});
 }
-function surfaceResolutionContextFromTheme(theme) {
-	return {
-		...surfaceResolutionContextFromPalette(expandPalette(theme.palette, {
-			arrangement: theme.skin !== undefined,
-			marksFrom: theme.skinMarks
-		})),
-		buttonSystem: theme.buttons
-	};
+function surfaceResolutionContextFromTheme(theme, declaredSurfaces = []) {
+	return prepareThemeSurfaceRevision({
+		palette: theme.palette,
+		buttons: theme.buttons,
+		skin: theme.skin,
+		skinMarks: theme.skinMarks
+	}, () => declaredSurfaces).context;
 }
 function defineDesignRuntimeRules(rules) {
 	return rules;
@@ -34083,6 +34229,16 @@ const folioLooks = {
 			treatment: "calendar-compact",
 			roleMap: folioRoles
 		},
+		{
+			id: id("events-spotlight"),
+			treatment: "calendar-spotlight",
+			roleMap: folioRoles
+		},
+		{
+			id: id("events-recurring-week"),
+			treatment: "calendar-recurring-week",
+			roleMap: folioRoles
+		},
 		{
 			id: id("event-calendar-month-grid"),
 			treatment: "calendar-month",
@@ -34317,6 +34473,16 @@ const fulcrumOffers = [
 		treatment: "compact",
 		roleMap: fulcrumRoles
 	},
+	{
+		id: id("events-spotlight"),
+		treatment: "calendar-spotlight",
+		roleMap: fulcrumRoles
+	},
+	{
+		id: id("events-recurring-week"),
+		treatment: "calendar-recurring-week",
+		roleMap: fulcrumRoles
+	},
 	{
 		id: id("event-calendar-month-grid"),
 		treatment: "sheet",
@@ -34647,6 +34813,16 @@ const posterOffers = [
 		treatment: "compact",
 		roleMap: posterRoles
 	},
+	{
+		id: id("events-spotlight"),
+		treatment: "calendar-spotlight",
+		roleMap: posterRoles
+	},
+	{
+		id: id("events-recurring-week"),
+		treatment: "calendar-recurring-week",
+		roleMap: posterRoles
+	},
 	{
 		id: id("event-calendar-month-grid"),
 		treatment: "heavy",
@@ -35040,6 +35216,16 @@ const lanternOffers = [
 		treatment: "compact",
 		roleMap: lanternRoles
 	},
+	{
+		id: id("events-spotlight"),
+		treatment: "calendar-spotlight",
+		roleMap: lanternRoles
+	},
+	{
+		id: id("events-recurring-week"),
+		treatment: "calendar-recurring-week",
+		roleMap: lanternRoles
+	},
 	{
 		id: id("event-calendar-month-grid"),
 		treatment: "lit",
@@ -35332,6 +35518,16 @@ const measureOffers = [
 		treatment: "compact",
 		roleMap: measureRuledPanelRoles
 	},
+	{
+		id: id("events-spotlight"),
+		treatment: "calendar-spotlight",
+		roleMap: measureRoles
+	},
+	{
+		id: id("events-recurring-week"),
+		treatment: "calendar-recurring-week",
+		roleMap: measureRoles
+	},
 	{
 		id: id("event-calendar-month-grid"),
 		treatment: "fill",
@@ -36933,7 +37129,13 @@ function lookOptionsForBlock(input) {
 function lookOptionsByLayoutForBlock(input) {
 	return input.availableLayouts.map((layout) => {
 		const availableLooks = lookOptionsForBlock({
-			block: input.block,
+			block: input.block.variantMeaning?.kind === "mode" ? {
+				...input.block,
+				storedVariant: {
+					kind: "explicit",
+					key: layout.id
+				}
+			} : input.block,
 			effectiveLayoutProfile: layout.profile,
 			siteStyle: input.siteStyle,
 			policy: input.policy
@@ -40770,6 +40972,168 @@ function isCanonicalObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+//#endregion
+//#region ../theme-core/src/page-document/pageAuthoredComparison.ts
+function projectPageAuthoredMetadata(value) {
+	return {
+		title: value.title,
+		path: value.path,
+		metaTitle: value.metaTitle,
+		metaDescription: value.metaDescription
+	};
+}
+/** Automatic is a valid authored document, even without a site style or stored version. */
+function projectPageAuthoredDesign(intent) {
+	return {
+		pageFlowPresetId: intent?.pageFlowPresetId ?? defaultPolicyPageFlowPresetId,
+		blockLookPins: (intent?.blockLookPins ?? []).map((pin) => ({
+			blockId: pin.blockId,
+			blockKind: pin.blockKind,
+			value: pin.choice.value
+		})).sort((a, b) => a.blockId.localeCompare(b.blockId)),
+		boundaryPins: (intent?.boundaryPins ?? []).map((pin) => ({
+			previousBlockId: pin.previousBlockId,
+			nextBlockId: pin.nextBlockId,
+			value: boundaryOptionIdForTreatment(pin.choice.value)
+		})).sort((a, b) => a.previousBlockId.localeCompare(b.previousBlockId) || a.nextBlockId.localeCompare(b.nextBlockId))
+	};
+}
+/** Editor choices project to the same meaning as persisted intent; effective auto choices are live. */
+function projectPageEditorAuthoredDesign(model) {
+	return {
+		pageFlowPresetId: model.pageFlow.value,
+		blockLookPins: model.blocks.flatMap((block) => block.look.kind === "user-pinned" ? [{
+			blockId: block.blockId,
+			blockKind: block.blockKind,
+			value: block.look.value
+		}] : []).sort((a, b) => a.blockId.localeCompare(b.blockId)),
+		boundaryPins: model.boundaries.flatMap((boundary) => boundary.breakChoice.kind === "user-pinned" ? [{
+			previousBlockId: boundary.previousBlockId,
+			nextBlockId: boundary.nextBlockId,
+			value: boundary.breakChoice.value
+		}] : []).sort((a, b) => a.previousBlockId.localeCompare(b.previousBlockId) || a.nextBlockId.localeCompare(b.nextBlockId))
+	};
+}
+function pageAuthoredBlockContentEqual(before, after) {
+	return before.blockKind === after.blockKind && authoredValuesEqual(before.content, after.content);
+}
+/** Inputs are authored projections, never storage records. */
+function comparePageAuthoredDocuments(draft, published) {
+	const scopes = {
+		metadata: !authoredValuesEqual(draft.metadata, published.metadata),
+		blocks: !authoredValuesEqual(draft.blocks, published.blocks),
+		design: !authoredValuesEqual(draft.design, published.design)
+	};
+	return {
+		scopes,
+		hasUnpublishedChanges: Object.values(scopes).some(Boolean)
+	};
+}
+function pageDesignHasUnpublishedChanges(model, published) {
+	return !authoredValuesEqual(projectPageEditorAuthoredDesign(model), projectPageAuthoredDesign(published));
+}
+
+//#endregion
+//#region ../theme-core/src/page-document/pageDocument.ts
+const revisionSchema = z.number().int().nonnegative().brand();
+const pageDocumentRevision = (value) => revisionSchema.parse(value);
+const nextPageDocumentRevision = (value) => pageDocumentRevision(value + 1);
+const automaticPageDocumentIntent = {
+	schemaVersion: 2,
+	pageFlowPresetId: defaultPolicyPageFlowPresetId,
+	blockLookPins: [],
+	boundaryPins: []
+};
+function pageDocumentPublishedBaseline(publication) {
+	switch (publication.kind) {
+		case "never-published": return null;
+		case "published": return publication.document;
+		case "unpublished": return publication.baseline;
+	}
+}
+/** Comparison only: never-published has an empty automatic baseline, with no stored row or metadata. */
+function pageDocumentComparisonBaseline(aggregate) {
+	return pageDocumentPublishedBaseline(aggregate.publication) ?? {
+		pageId: aggregate.pageId,
+		stage: "published",
+		blocks: [],
+		metadata: {
+			title: null,
+			path: null,
+			metaTitle: null,
+			metaDescription: null
+		},
+		intent: automaticPageDocumentIntent
+	};
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageDocumentCheckpoint.ts
+/** Owned by edit admission. Installing schema never activates document authority. */
+const pageDocumentCheckpointSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("legacy"),
+		pauseAnnouncedAt: z.string().datetime({ offset: true }).optional()
+	}).strict(),
+	z.object({
+		kind: z.literal("paused"),
+		authority: z.enum(["legacy", "document"]),
+		checkpointId: z.string().uuid(),
+		pausedAt: z.string().datetime({ offset: true })
+	}).strict(),
+	z.object({
+		kind: z.literal("document"),
+		checkpointId: z.string().uuid(),
+		activatedAt: z.string().datetime({ offset: true })
+	}).strict()
+]);
+/** Admission identity is kind plus checkpoint ID; notice/activation timestamps are descriptive.
+* SQL uses private.page_document_checkpoint_identity; integration tests enforce parity. */
+function pageDocumentCheckpointsEqual(left, right) {
+	const first = pageDocumentCheckpointSchema.parse(left);
+	const second = pageDocumentCheckpointSchema.parse(right);
+	switch (first.kind) {
+		case "legacy": return second.kind === "legacy";
+		case "paused": return second.kind === "paused" && first.checkpointId === second.checkpointId;
+		case "document": return second.kind === "document" && first.checkpointId === second.checkpointId;
+		default: return assertNever$1(first);
+	}
+}
+function pageDocumentAdmissionState(checkpoint) {
+	return checkpoint.kind;
+}
+function pageDocumentReadAuthority(checkpoint) {
+	switch (checkpoint.kind) {
+		case "legacy": return "legacy";
+		case "paused": return checkpoint.authority;
+		case "document": return "document";
+		default: return assertNever$1(checkpoint);
+	}
+}
+
+//#endregion
+//#region ../theme-core/src/site-styles/pageDesignVersionIntent.ts
+function taggedStyledIntent(intent) {
+	const { siteStyleId, ...decisions } = intent;
+	return {
+		kind: "legacy-styled",
+		siteStyleId,
+		decisions
+	};
+}
+const decodedPageDesignIntentSchema = z.union([
+	z.nullish(z.never()).transform(() => ({ kind: "automatic" })),
+	pageDesignDecisionsV2Schema.transform((decisions) => ({
+		kind: "decisions",
+		decisions
+	})),
+	pageDesignIntentV2Schema.transform(taggedStyledIntent),
+	pageDesignIntentV1Schema.transform((intent) => taggedStyledIntent(normalizeLegacyPageDesignIntent(intent)))
+], { error: (issue$1) => {
+	const value = issue$1.input;
+	return typeof value === "object" && value !== null && "schemaVersion" in value && value.schemaVersion !== 1 && value.schemaVersion !== 2 ? "Unsupported Theme V2 page design intent schemaVersion." : "Invalid Theme V2 page design intent shape.";
+} });
+
 //#endregion
 //#region ../site-commands/src/application.ts
 const commandEffectKinds = [