@riverbankcms/sdk 0.125.0 → 0.127.0

package/dist/cli/init-docs/content/cli-reference.md

@@ -953,9 +953,12 @@ calendar date is never accepted as an identity.
   Cancellation preserves registrations and is idempotent. Deletion requires
   zero registrations and confirmation (`--yes` for remote or JSON use).
 
-Occurrence collections are deliberately imperative. `pull events` and
-`push events` only manage the event-series schedule and never reconcile,
-create, or delete individual occurrence rows.
+`pull events` writes the complete non-cancelled occurrence schedule into each
+portable event file. `push events` creates those rows for a new series and
+accepts an exact replay for an existing series. It deliberately rejects
+existing-series additions, removals, or retiming; use the imperative occurrence
+commands for those operational changes. Cancelled occurrence tombstones remain
+in the CMS and are omitted from portable authored content.
 
 ### verify
 

package/dist/cli/init-docs/content/content-management.md

@@ -630,15 +630,23 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
   "path": "/events/yoga-class",
   "status": "active",
   "visibility": "public",
+  "preset": "class",
+  "bookingScope": "single_occurrence",
+  "occurrences": [
+    {
+      "startsAt": "2026-01-05T15:00:00.000Z",
+      "endsAt": "2026-01-05T16:00:00.000Z",
+      "timeZone": "America/Los_Angeles"
+    },
+    {
+      "startsAt": "2026-01-12T15:00:00.000Z",
+      "endsAt": "2026-01-12T16:00:00.000Z",
+      "timeZone": "America/Los_Angeles"
+    }
+  ],
   "venueRef": "main-hall",
   "categoryRef": "workshop",
   "capacity": 30,
-  "schedule": {
-    "recurrenceRule": "FREQ=WEEKLY;BYDAY=MO",
-    "startDate": "2026-01-05",
-    "defaultStartTime": "07:00:00",
-    "durationMinutes": 60
-  },
   "pricing": {
     "requiresPayment": true,
     "priceAmount": 2500,
@@ -674,8 +682,10 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
 **Event field notes:**
 
 - `priceAmount` is in cents (2500 = $25.00)
-- `recurrenceRule` uses iCal RRULE format
-- `startDate` is `YYYY-MM-DD`; for one-off events use `recurrenceRule: null` plus `startDate`
+- `preset` controls the event's presentation defaults; `bookingScope` controls
+  whether a registration selects one occurrence or the complete series.
+- `occurrences` is the complete authored schedule. Instants use canonical UTC
+  ISO datetimes and every item carries the event's IANA timezone.
 - `venueRef` and `categoryRef` reference slugs/identifiers from venues and event-categories
 - `status`: "draft", "active", "completed", "cancelled", or "archived"
 - `visibility`: "private", "public", or "unlisted"
@@ -688,11 +698,12 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
 
 See `cli-reference.md` for event-related CLI commands: `riverbankcms push/pull venues|event-categories|events`.
 
-Individual bookable dates are managed separately with
-`riverbankcms event occurrence list|add|update|cancel|delete`. They are not
-written to `content/events/*.json`, and event pull/push never reconciles the
-occurrence collection. See the `event` section in `cli-reference.md` for
-timezone, DST, recurrence, cancellation, and deletion rules.
+`riverbankcms pull events` writes every non-cancelled occurrence to the event
+file. Pushing a new event creates that explicit schedule, and pushing an
+unchanged existing schedule is safe. Existing-series additions, removals, or
+retiming remain an explicit capability gap; use `riverbankcms event occurrence
+list|add|update|cancel|delete` for those operational changes. Cancelled rows are
+operational tombstones and are not recreated from portable content.
 
 ---
 

package/dist/client/{DiscountCodeDisclosure-CyPpekBp.mjs → DiscountCodeDisclosure-BDFRp8Y7.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { X as themeButtonClassName } from "./propsDecoder-CIR5DQ1l.mjs";
+import { X as themeButtonClassName } from "./propsDecoder-BF7i6Ijg.mjs";
 import { useId } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/api/types/discounts.ts

package/dist/client/{EventCombined.client-zywit-60.mjs → EventCombined.client-DJgF1_lf.mjs}

@@ -1,7 +1,7 @@
 "use client";
 import { t as clsx } from "./clsx-DgIEfj3H.mjs";
-import { A as formatDate, E as getEventRuntimeFiltersKey, F as formatEventTeacherLine, I as formatTime, L as getCardOrientation, N as formatEventPrice, R as getContainerClass, T as buildEventRuntimeFilters, U as getEventAvailability, V as resolveEventLinkProps, X as themeButtonClassName, yt as assertNever, z as groupEventsByDate } from "./propsDecoder-CIR5DQ1l.mjs";
-import { a as EventCardClient, i as EventPaginatedListView, n as useEventPagination, o as EventFilters, r as toError, t as useEventFilters } from "./useEventFilters-C8OOJ3el.mjs";
+import { A as formatDate, E as getEventRuntimeFiltersKey, F as formatEventTeacherLine, I as formatTime, L as getCardOrientation, N as formatEventPrice, R as getContainerClass, T as buildEventRuntimeFilters, U as getEventAvailability, V as resolveEventLinkProps, X as themeButtonClassName, yt as assertNever, z as groupEventsByDate } from "./propsDecoder-BF7i6Ijg.mjs";
+import { a as EventCardClient, i as EventPaginatedListView, n as useEventPagination, o as EventFilters, r as toError, t as useEventFilters } from "./useEventFilters-rc8VLeLV.mjs";
 import { n as useBlockApi } from "./context-CJz1Vlsz.mjs";
 import { t as createBodyThemePortalRoot } from "./themePortalRoot-AGs4cE7t.mjs";
 import { t as ModalShell } from "./ModalShell-CqkBvBIC.mjs";

package/dist/client/{EventListing.client-J2nLhkKT.mjs → EventListing.client-CnWGNjOr.mjs}

@@ -1,6 +1,6 @@
 "use client";
-import { T as buildEventRuntimeFilters } from "./propsDecoder-CIR5DQ1l.mjs";
-import { i as EventPaginatedListView, n as useEventPagination, o as EventFilters, t as useEventFilters } from "./useEventFilters-C8OOJ3el.mjs";
+import { T as buildEventRuntimeFilters } from "./propsDecoder-BF7i6Ijg.mjs";
+import { i as EventPaginatedListView, n as useEventPagination, o as EventFilters, t as useEventFilters } from "./useEventFilters-rc8VLeLV.mjs";
 import { useId, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/nodes/events/EventListing.client.tsx

package/dist/client/{LeafletStaticMap-CSubXWt6.mjs → LeafletStaticMap-BISs9Bl7.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { J as isRecord } from "./propsDecoder-CIR5DQ1l.mjs";
+import { J as isRecord } from "./propsDecoder-BF7i6Ijg.mjs";
 import { useEffect, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/nodes/shared/LeafletStaticMap.tsx

package/dist/client/{MagicLinkForm-DDLIfiq9.mjs → MagicLinkForm-b5E_HoG9.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { X as themeButtonClassName, yt as assertNever } from "./propsDecoder-CIR5DQ1l.mjs";
+import { X as themeButtonClassName, yt as assertNever } from "./propsDecoder-BF7i6Ijg.mjs";
 import { n as useBlockApi } from "./context-CJz1Vlsz.mjs";
 import { useEffect, useReducer, useState, useSyncExternalStore } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";

package/dist/client/{StepIndicator-DE8EvHIp.mjs → StepIndicator-D8gVYkK-.mjs}

@@ -1,6 +1,6 @@
 import { t as clsx } from "./clsx-DgIEfj3H.mjs";
-import { Wt as formatCurrencyAmount } from "./propsDecoder-CIR5DQ1l.mjs";
-import { i as CheckIcon } from "./useDiscountCodeUi-Bcyh4508.mjs";
+import { Wt as formatCurrencyAmount } from "./propsDecoder-BF7i6Ijg.mjs";
+import { a as CheckIcon } from "./scrollToBlock-D_7t8yWb.mjs";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/shared/utils/formatting.ts

package/dist/client/{accordion-Ct5T5NiA.mjs → accordion-DFDajgDz.mjs}

@@ -1,4 +1,4 @@
-import { t as defineIslandPropsDecoder } from "./propsDecoder-CIR5DQ1l.mjs";
+import { t as defineIslandPropsDecoder } from "./propsDecoder-BF7i6Ijg.mjs";
 //#region src/rendering/islands/enhancers/accordion.ts
 const decode = defineIslandPropsDecoder("accordion");
 function parseDefaultValues(value) {

package/dist/client/{bookingForm-DMxtLPxw.mjs → bookingForm-Bdqj9-52.mjs}

@@ -1,16 +1,15 @@
 "use client";
 import { d as unsafeAsAppointmentResourceId, f as unsafeAsAppointmentServiceId, g as unsafeAsPassId, m as unsafeAsFormId, p as unsafeAsCustomerPassId } from "./colorStyles-BWpj_h4C.mjs";
-import { n as buildBookingPaymentSelectionViewModel, t as usePolling } from "./usePolling-CyJVo9kF.mjs";
-import { Ct as okWith, Et as addLocalScheduleDays, Nt as parseBookingLocalDate, Pt as resolveBookingTimeZoneId, Tt as reportWorkflowSuccess, Wt as formatCurrencyAmount, X as themeButtonClassName, _t as toSelectedCollectionOptionKind, at as formatBookingCentsAsCurrencyInput, bt as clearWorkflowFeedback, ct as getBookingServiceSlidingScale, dt as parseBookingCurrencyInputToCents, ft as prepareBookingSubmission, gt as resolveDefaultBookingServiceId, ht as resolveBookingSiteId, it as deriveBookingFormViewState, jt as formatLocalScheduleDate, kt as formatBookingInstant, lt as getBookingSuccessMessage, mt as resolveBookingPaymentStep, ot as formatBookingSubmissionPreparationError, pt as resolveAppointmentCheckoutVerificationState, rt as logger, st as getBookingRedirectStateFromLocation, t as defineIslandPropsDecoder, ut as isBookingServiceSlidingAmountInRange, vt as BOOKING_FORM_DATA_RESERVED_KEYS, wt as reportWorkflowError, xt as err, yt as assertNever } from "./propsDecoder-CIR5DQ1l.mjs";
+import { n as buildBookingPaymentSelectionViewModel, t as usePolling } from "./usePolling-1ncrfd4S.mjs";
+import { Ct as okWith, Et as addLocalScheduleDays, Nt as parseBookingLocalDate, Pt as resolveBookingTimeZoneId, Tt as reportWorkflowSuccess, Wt as formatCurrencyAmount, X as themeButtonClassName, _t as toSelectedCollectionOptionKind, at as formatBookingCentsAsCurrencyInput, bt as clearWorkflowFeedback, ct as getBookingServiceSlidingScale, dt as parseBookingCurrencyInputToCents, ft as prepareBookingSubmission, gt as resolveDefaultBookingServiceId, ht as resolveBookingSiteId, it as deriveBookingFormViewState, jt as formatLocalScheduleDate, kt as formatBookingInstant, lt as getBookingSuccessMessage, mt as resolveBookingPaymentStep, ot as formatBookingSubmissionPreparationError, pt as resolveAppointmentCheckoutVerificationState, rt as logger, st as getBookingRedirectStateFromLocation, t as defineIslandPropsDecoder, ut as isBookingServiceSlidingAmountInRange, vt as BOOKING_FORM_DATA_RESERVED_KEYS, wt as reportWorkflowError, xt as err, yt as assertNever } from "./propsDecoder-BF7i6Ijg.mjs";
 import { n as useBlockApi, t as BlockApiProvider } from "./context-CJz1Vlsz.mjs";
 import { n as isSpamProtectionEnabled, r as AltchaWidget, t as getChallengeUrl } from "./src-B833rYRr.mjs";
-import { i as CheckIcon, n as TerminalPanel, r as StateIcon, t as useDiscountCodeUi } from "./useDiscountCodeUi-Bcyh4508.mjs";
-import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-CyPpekBp.mjs";
-import { n as SpinnerNode, t as StepIndicator } from "./StepIndicator-DE8EvHIp.mjs";
+import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-D_7t8yWb.mjs";
+import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-BDFRp8Y7.mjs";
+import { n as SpinnerNode, t as StepIndicator } from "./StepIndicator-D8gVYkK-.mjs";
 import { t as FeedbackMessage } from "./FeedbackMessage-ByMrs3cr.mjs";
 import { n as getFieldValidationControlProps, t as FieldValidationMessage } from "./FieldValidationMessage-AYanWFb-.mjs";
 import { t as buildCheckoutReturnUrls } from "./checkoutUrls-Ct8Mxna3.mjs";
-import { t as scrollToBlock } from "./scrollToBlock-C86BYkyV.mjs";
 import { t as mountReactIsland } from "./reactMount-SY8AVRof.mjs";
 import { t as buildRouteIslandApiConfig } from "./routeIslandApiConfig-UNsfPcYq.mjs";
 import React, { useCallback, useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState } from "react";

package/dist/client/bookings.mjs

@@ -7416,7 +7416,7 @@ const PALETTE_TOKEN_NAMES = [
 	"text",
 	"border"
 ];
-z$1.enum(PALETTE_TOKEN_NAMES);
+const paletteTokenNameSchema = z$1.enum(PALETTE_TOKEN_NAMES);
 const themeColorBaseTokenNames = [
 	...PALETTE_TOKEN_NAMES,
 	...blockColorTokenNames,
@@ -7475,8 +7475,6 @@ const VARIANT_ROLES = [
 	"secondary",
 	"outline",
 	"ghost",
-	"link",
-	"tertiary",
 	"accent"
 ];
 /**
@@ -7485,7 +7483,7 @@ const VARIANT_ROLES = [
 * IDs become class selectors, so keep the contract deliberately narrower than
 * an arbitrary string and shared with every authoring/runtime boundary.
 */
-const buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only");
+const buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only").refine((value) => value !== "link" && value !== "tertiary", { message: "Retired button role IDs are not valid variant IDs" });
 function parseOpaqueButtonColourToken(value) {
 	const token = parseThemeColorToken(value);
 	if (token === null) return null;
@@ -7897,6 +7895,172 @@ const mediaSchema$1 = z.object({
 	transform: transformSchema$1.optional()
 });
 //#endregion
+//#region ../theme-core/src/palette/colors.ts
+const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/;
+const NORMALIZABLE_HEX_REGEX = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
+const THEME_PALETTE_COLOR_ORDER = [
+	"primary",
+	"secondary",
+	"accent",
+	"success",
+	"warning",
+	"destructive",
+	"background",
+	"surface",
+	"surfaceAlt",
+	"muted",
+	"text",
+	"primaryForeground",
+	"border"
+];
+const hexColorSchema = z$1.string().regex(HEX_COLOR_REGEX, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
+const paletteModeSchema = z$1.enum(["light", "dark"]);
+const PALETTE_VALUE_KEY_PREFIX = "palette-value:v1|";
+z$1.string().regex(/^[0-9a-f]{64}$/, "Palette hash must be a lowercase SHA-256 value").transform((value) => value);
+const paletteColorsSchema = z$1.object({
+	primary: hexColorSchema,
+	primaryForeground: hexColorSchema,
+	secondary: hexColorSchema,
+	accent: hexColorSchema,
+	success: hexColorSchema,
+	warning: hexColorSchema,
+	destructive: hexColorSchema,
+	background: hexColorSchema,
+	surface: hexColorSchema,
+	surfaceAlt: hexColorSchema,
+	muted: hexColorSchema,
+	text: hexColorSchema,
+	border: hexColorSchema
+}).strict().transform((value) => value);
+function normalizePaletteHex(value) {
+	if (!NORMALIZABLE_HEX_REGEX.test(value)) return null;
+	const normalized = value.toLowerCase();
+	if (normalized.length === 7) return normalized;
+	const triplet = normalized.slice(1);
+	const red = triplet.charAt(0);
+	const green = triplet.charAt(1);
+	const blue = triplet.charAt(2);
+	return `#${red}${red}${green}${green}${blue}${blue}`;
+}
+function paletteColorsFromEntries(entries) {
+	const values = {};
+	for (const entry of entries) {
+		const parsedRole = paletteTokenNameSchema.safeParse(entry.name);
+		if (!parsedRole.success) return {
+			ok: false,
+			error: {
+				kind: "unknown-role",
+				role: entry.name
+			}
+		};
+		const role = parsedRole.data;
+		if (values[role] !== void 0) return {
+			ok: false,
+			error: {
+				kind: "duplicate-role",
+				role
+			}
+		};
+		const hex = normalizePaletteHex(entry.hex);
+		if (!hex) return {
+			ok: false,
+			error: {
+				kind: "invalid-color",
+				role,
+				value: entry.hex
+			}
+		};
+		values[role] = hex;
+	}
+	const missing = PALETTE_TOKEN_NAMES.filter((role) => values[role] === void 0);
+	if (missing.length > 0) return {
+		ok: false,
+		error: {
+			kind: "missing-roles",
+			roles: missing
+		}
+	};
+	return {
+		ok: true,
+		colors: paletteColorsSchema.parse(values)
+	};
+}
+function paletteColorEntries(colors) {
+	return THEME_PALETTE_COLOR_ORDER.map((name) => ({
+		name,
+		hex: colors[name]
+	}));
+}
+function paletteColorFingerprint(colors) {
+	return PALETTE_TOKEN_NAMES.map((name) => `${name}:${colors[name]}`).join("|");
+}
+function canonicalPaletteHashInput(colors, mode) {
+	return `${mode}|${paletteColorFingerprint(colors)}`;
+}
+/**
+* Stable curated-catalogue identity. Do not reorder roles: the order comes
+* from PALETTE_TOKEN_NAMES through canonicalPaletteHashInput.
+*/
+function paletteValueKey(colors, mode) {
+	return `${PALETTE_VALUE_KEY_PREFIX}${canonicalPaletteHashInput(colors, mode)}`;
+}
+/** Parses only the exact v1 canonical form emitted by paletteValueKey. */
+function parsePaletteValueKey(value) {
+	if (typeof value !== "string" || !value.startsWith(PALETTE_VALUE_KEY_PREFIX)) return null;
+	const [rawMode, ...rawRoles] = value.slice(17).split("|");
+	const mode = paletteModeSchema.safeParse(rawMode);
+	if (!mode.success || rawRoles.length !== PALETTE_TOKEN_NAMES.length) return null;
+	const colors = paletteColorsFromEntries(rawRoles.map((roleValue) => {
+		const separator = roleValue.indexOf(":");
+		return separator === -1 ? {
+			name: "",
+			hex: ""
+		} : {
+			name: roleValue.slice(0, separator),
+			hex: roleValue.slice(separator + 1)
+		};
+	}));
+	if (!colors.ok || paletteValueKey(colors.colors, mode.data) !== value) return null;
+	return value;
+}
+z$1.string().transform((value, ctx) => {
+	const parsed = parsePaletteValueKey(value);
+	if (parsed) return parsed;
+	ctx.addIssue({
+		code: "custom",
+		message: "Invalid canonical palette value key"
+	});
+	return z$1.NEVER;
+});
+//#endregion
+//#region ../theme-core/src/palette/schema.ts
+const colourHexString = z$1.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
+const paletteColorSchema = z$1.object({
+	name: z$1.string().min(1),
+	hex: colourHexString
+});
+const paletteMetaSchema = z$1.object({ mode: z$1.enum(["light", "dark"]) });
+const paletteSchema = z$1.object({
+	colors: z$1.array(paletteColorSchema),
+	meta: paletteMetaSchema
+}).transform((palette, ctx) => {
+	const colors = paletteColorsFromEntries(palette.colors);
+	if (!colors.ok) {
+		ctx.addIssue({
+			code: "custom",
+			message: `Invalid complete palette: ${colors.error.kind}`
+		});
+		return z$1.NEVER;
+	}
+	return {
+		colors: paletteColorEntries(colors.colors).map(({ name, hex }) => ({
+			name: String(name),
+			hex: String(hex)
+		})),
+		meta: palette.meta
+	};
+});
+//#endregion
 //#region ../theme-core/src/cards/types.ts
 const cardVariantRoleValues = ["default", "alternative"];
 const boxlessCardVariantValue = "none";
@@ -8827,6 +8991,60 @@ const siteChromeBackgroundOverrideOwner = "site-chrome-editor";
 * palette context and happens in `parseThemeColorReference`.
 */
 const tokenOrCssColorValueSchema = z$1.string();
+const BREAKPOINT_LG = 1024;
+const BREAKPOINT_XL = 1280;
+const BREAKPOINT_LG_DOWN = BREAKPOINT_LG - 1;
+function mqUp(px) {
+	return `(min-width: ${px}px)`;
+}
+function mqDown(px) {
+	return `(max-width: ${px}px)`;
+}
+function mqBetween(minPx, maxPx) {
+	return `${mqUp(minPx)} and ${mqDown(maxPx)}`;
+}
+mqUp(640);
+mqUp(768);
+mqUp(BREAKPOINT_LG);
+mqUp(BREAKPOINT_XL);
+mqDown(639);
+mqDown(767);
+mqDown(BREAKPOINT_LG_DOWN);
+mqBetween(640, BREAKPOINT_LG_DOWN);
+mqDown(640);
+mqDown(768);
+//#endregion
+//#region ../theme-core/src/header/scrollTreatment.ts
+const headerScrollTreatmentSchema = z$1.discriminatedUnion("kind", [z$1.object({
+	kind: z$1.literal("contrast-glass"),
+	backgroundTone: z$1.enum(["light", "dark"])
+})]).optional();
+//#endregion
+//#region ../theme-core/src/header/containerSchema.ts
+const headerContainerSchema = z$1.object({
+	rounded: z$1.enum([
+		"none",
+		"sm",
+		"md",
+		"lg",
+		"xl",
+		"2xl"
+	]).default("xl"),
+	border: z$1.boolean().default(true),
+	shadow: z$1.boolean().default(true),
+	padding: z$1.enum([
+		"sm",
+		"md",
+		"lg"
+	]).default("md"),
+	tint: z$1.string().nullable().optional(),
+	opacity: z$1.number().min(0).max(1).default(.12)
+}).optional();
+const headerInteractionPaletteSchema = z$1.enum([
+	"primary",
+	"secondary",
+	"accent"
+]);
 //#endregion
 //#region ../theme-core/src/schema.ts
 const axesSchema = z$1.object({
@@ -8857,16 +9075,6 @@ const axesSchema = z$1.object({
 		"expressive"
 	])
 });
-const colourHexString = z$1.string().regex(/^#([0-9A-Fa-f]{3}){1,2}$/);
-const paletteColorSchema = z$1.object({
-	name: z$1.string().min(1),
-	hex: colourHexString
-});
-const paletteMetaSchema = z$1.object({ mode: z$1.enum(["light", "dark"]) });
-const paletteSchema = z$1.object({
-	colors: z$1.array(paletteColorSchema),
-	meta: paletteMetaSchema
-});
 const typographyStyleSchema = z$1.object({
 	family: z$1.string().min(1),
 	weight: z$1.enum([
@@ -9246,25 +9454,6 @@ const navFontWeight = z$1.enum([
 ]);
 const headerMaxWidth = z$1.enum(["container", "full"]);
 const headerBarFrame = z$1.enum(["full-bleed", "inset-shell"]);
-const headerContainerSchema = z$1.object({
-	rounded: z$1.enum([
-		"none",
-		"sm",
-		"md",
-		"lg",
-		"xl",
-		"2xl"
-	]).default("xl"),
-	border: z$1.boolean().default(true),
-	shadow: z$1.boolean().default(true),
-	padding: z$1.enum([
-		"sm",
-		"md",
-		"lg"
-	]).default("md"),
-	tint: z$1.string().nullable().optional(),
-	opacity: z$1.number().min(0).max(1).default(.12)
-}).optional();
 const headerBorderSchema = componentBorderSchema.extend({ position: z$1.enum([
 	"bottom",
 	"top",
@@ -9391,6 +9580,7 @@ const headerSchema = z$1.object({
 	shrinkOnScroll: z$1.boolean(),
 	maxWidth: headerMaxWidth,
 	barFrame: headerBarFrame.optional(),
+	scrollTreatment: headerScrollTreatmentSchema,
 	logoOverride: mediaSchema$1.nullable().optional(),
 	background: headerBackgroundSchema.default({
 		type: "color",
@@ -9403,6 +9593,7 @@ const headerSchema = z$1.object({
 	navFontRole: z$1.enum(["body", "heading"]).optional(),
 	navTypography: z$1.enum(["body", "heading"]).optional(),
 	navTextSize: navLinkStyleSchema.shape.textSize,
+	interactionPalette: headerInteractionPaletteSchema.optional(),
 	navPlacement: z$1.enum(["end", "center"]).optional(),
 	container: headerContainerSchema,
 	border: headerBorderSchema,
@@ -9710,6 +9901,59 @@ function themeButtonClassName(spec) {
 		spec.extraClassName
 	].filter(Boolean).join(" ");
 }
+shadeBackgroundEffect({
+	id: "darken-background",
+	name: "Darken on Hover",
+	description: "Darkens the background color on hover",
+	label: "Darken Amount (shade step)",
+	shadeDirection: 1
+});
+shadeBackgroundEffect({
+	id: "lighten-background",
+	name: "Lighten on Hover",
+	description: "Lightens the background color on hover",
+	label: "Lighten Amount (shade step)",
+	shadeDirection: -1
+});
+function shadeBackgroundEffect(config) {
+	return {
+		id: config.id,
+		name: config.name,
+		description: config.description,
+		category: "background",
+		pseudoElement: "none",
+		applicableTo: ["button"],
+		customizableOption: {
+			name: "amount",
+			type: "select",
+			label: config.label,
+			default: 100,
+			options: [
+				0,
+				100,
+				200,
+				300,
+				400,
+				500,
+				600,
+				700,
+				800,
+				900
+			]
+		},
+		isApplicable: (buttonConfig) => buttonConfig.background.type === "solid",
+		generateCSS: ({ themeId, variantId, options, tokens, buttonConfig }) => {
+			if (buttonConfig.background.type !== "solid") return "";
+			const amount = (options.amount || 100) * config.shadeDirection;
+			const baseToken = buttonConfig.background.colorToken ?? "primary-500";
+			return `
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        background-color: ${tokens.getColor(tokens.adjustShade(baseToken, amount))};
+      }
+    `;
+		}
+	};
+}
 buttonSizeNameSchema.options;
 //#endregion
 //#region ../theme-core/src/buttons/styles/domain.ts
@@ -13634,6 +13878,9 @@ function usePaymentVerificationWithDeps(config, deps) {
 	};
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/constants.ts
+const EVENT_REGISTRATION_ANCHOR_ID = "event-registration";
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/sessionStorage.ts
 const STORAGE_PREFIX = "riverbank:event-registration:";
 const STALE_THRESHOLD_MS = 1440 * 60 * 1e3;
@@ -13810,16 +14057,29 @@ function cleanupStaleRegistrations() {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/useEventRegistrationStripeReturn.ts
+const eventRegistrationStripeReturnDeps = {
+	usePaymentVerification,
+	consumeSearchParam,
+	scrollToBlock,
+	cleanupStaleRegistrations,
+	clearPendingRegistration,
+	getPendingRegistration
+};
 function useEventRegistrationStripeReturn(options) {
+	return useEventRegistrationStripeReturnWithDeps(options, eventRegistrationStripeReturnDeps);
+}
+function useEventRegistrationStripeReturnWithDeps(options, deps) {
 	const { api, events, occurrenceId, pendingAttendeeId, setErrorMessage, setFormData, setPaymentSelection, setPendingAttendeeId, setRegistrationResult, setSelectedEvent, setSelectedAttendanceMode, setTicketSelections, setStep, setTicketsCount, step } = options;
-	const verification = usePaymentVerification(useMemo(() => step === "verifying-payment" && pendingAttendeeId ? { transactionId: pendingAttendeeId } : null, [step, pendingAttendeeId]));
+	const verificationConfig = useMemo(() => step === "verifying-payment" && pendingAttendeeId ? { transactionId: pendingAttendeeId } : null, [step, pendingAttendeeId]);
+	const verification = deps.usePaymentVerification(verificationConfig);
 	useEffect(() => {
-		cleanupStaleRegistrations();
-		const registrationStatus = consumeSearchParam("registration");
-		if (!registrationStatus) return;
+		deps.cleanupStaleRegistrations();
+		const registrationStatus = deps.consumeSearchParam("registration");
+		if (registrationStatus !== "cancelled" && registrationStatus !== "success") return;
+		deps.scrollToBlock(EVENT_REGISTRATION_ANCHOR_ID);
 		const siteId = api.config.siteId;
 		if (!siteId) return;
-		const pending = getPendingRegistration(siteId, occurrenceId || void 0);
+		const pending = deps.getPendingRegistration(siteId, occurrenceId || void 0);
 		if (!pending) return;
 		setFormData(pending.formData);
 		setTicketSelections(pending.ticketSelections);
@@ -13839,7 +14099,7 @@ function useEventRegistrationStripeReturn(options) {
 	useEffect(() => {
 		if (verification.status === "completed") {
 			const siteId = api.config.siteId;
-			if (siteId && occurrenceId) clearPendingRegistration(siteId, occurrenceId);
+			if (siteId && occurrenceId) deps.clearPendingRegistration(siteId, occurrenceId);
 			setRegistrationResult({ status: "confirmed" });
 			setStep("success");
 		} else if (verification.status === "failed") {
@@ -13950,13 +14210,7 @@ function useEventRegistrationSubmitWithDeps(options, deps) {
 			if (!result.alreadyRegistered && result.status === "confirmed" && result.pendingPayment && (method === "stripe" || method === "pass_bundle" || method === "membership_bundle")) {
 				options.setPendingAttendeeId(result.attendeeId);
 				options.setStep("redirecting");
-				const currentUrl = new URL(window.location.href);
-				const successParams = new URLSearchParams(currentUrl.search);
-				successParams.set("registration", "success");
-				const successUrl = `${currentUrl.origin}${currentUrl.pathname}?${successParams.toString()}${currentUrl.hash}`;
-				const cancelParams = new URLSearchParams(currentUrl.search);
-				cancelParams.set("registration", "cancelled");
-				const cancelUrl = `${currentUrl.origin}${currentUrl.pathname}?${cancelParams.toString()}${currentUrl.hash}`;
+				const { successUrl, cancelUrl } = buildCheckoutReturnUrls("registration", EVENT_REGISTRATION_ANCHOR_ID);
 				const checkoutType = method === "pass_bundle" ? "pass_bundle" : method === "membership_bundle" ? "membership_bundle" : "event";
 				const checkoutResult = await options.api.createEventCheckout({
 					attendeeId: result.attendeeId,
@@ -14221,6 +14475,12 @@ const mediaBaseSchema = z.object({
 	poster: mediaPosterSchema.optional(),
 	transform: transformSchema.optional()
 });
+/**
+* Canonical identifier carried by media values that are safe to persist.
+* Parsing trims boundary input so downstream writers cannot retain whitespace-only
+* identifiers or independently disagree about normalization.
+*/
+const mediaIdentifierSchema = z.string().trim().min(1).brand();
 const imageMediaSchema = mediaBaseSchema.extend({ type: z.literal("image") });
 const videoMediaSchema = mediaBaseSchema.extend({ type: z.literal("video") });
 const audioMediaSchema = mediaBaseSchema.extend({ type: z.literal("audio") });
@@ -14235,6 +14495,15 @@ const mediaSchema = z.discriminatedUnion("type", [
 	spreadsheetMediaSchema,
 	archiveMediaSchema
 ]);
+const persistableMediaBaseSchema = mediaBaseSchema.extend({ identifier: mediaIdentifierSchema });
+z.discriminatedUnion("type", [
+	persistableMediaBaseSchema.extend({ type: z.literal("image") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("video") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("audio") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("document") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("spreadsheet") }),
+	persistableMediaBaseSchema.extend({ type: z.literal("archive") })
+]);
 //#endregion
 //#region ../blocks/src/system/manifest/richTextSchema.ts
 /**

package/dist/client/{carousel--FMqgvob.mjs → carousel-Cvqf-kN8.mjs}

@@ -1,4 +1,4 @@
-import { t as defineIslandPropsDecoder } from "./propsDecoder-CIR5DQ1l.mjs";
+import { t as defineIslandPropsDecoder } from "./propsDecoder-BF7i6Ijg.mjs";
 import { t as mountReactIsland } from "./reactMount-SY8AVRof.mjs";
 import { n as normalizeCarouselProps, t as CarouselNodeClient } from "./carousel.client-CpwTUhIo.mjs";
 import "react";

package/dist/client/{cart-BKX1bWiU.mjs → cart-CuH2TJXP.mjs}

@@ -1,6 +1,6 @@
-import { t as defineIslandPropsDecoder } from "./propsDecoder-CIR5DQ1l.mjs";
-import { t as CartController } from "./shop-commerce-XO-XMFEt.mjs";
-import { t as mountShopBlockIsland } from "./shopShared-Bbq39mwr.mjs";
+import { t as defineIslandPropsDecoder } from "./propsDecoder-BF7i6Ijg.mjs";
+import { t as CartController } from "./shop-commerce-DA7_Rq5p.mjs";
+import { t as mountShopBlockIsland } from "./shopShared-WL-E1znM.mjs";
 import "react";
 import { jsx } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/nodes/cart.client.tsx